Skip to content

Showcase: AI-domain examples (agent/tool/skill) deferred — cloud/MCP-only per ADR-0063 #2610

Description

@os-zhuang

The showcase README previously claimed an AI capability chain ("an agent wired to a tool and a skill", with a src/agents/ directory in the layout diagram) that was never implemented. The showcase-redesign PR removes the false claims (Prime Directive #10: never advertise a capability the runtime doesn't deliver) and records the AI metadata kinds as explicit waivers in the registry-driven coverage manifest (src/coverage.tsKIND_COVERAGE).

Why waived rather than demonstrated now:

  • agent — per ADR-0063, agents are platform-owned; the kernel ships exactly two (ask / build) and third parties never author *.agent.ts. Additionally, cloud ADR-0025 moved the in-UI AI runtime (service-ai) to the cloud/Enterprise distribution — the open framework exposes AI only via @objectstack/mcp (BYO-AI). An agent example in this repo would demo something the open runtime cannot execute.
  • tool / skill — these ARE the third-party AI extension primitives (ADR-0063), so the showcase should eventually demonstrate them, consumed through the MCP surface. That needs a worked-out BYO-AI verification story (what a CI-checkable "demonstrated" looks like without an in-product chat runtime) before it can honor the showcase's coverage bar.

Done means: tool + skill examples on the showcase backbone, exercised via @objectstack/mcp with a test proving registration/exposure, and the KIND_COVERAGE entries flipped from waived to demonstrated. agent stays waived permanently (platform-owned) with this issue as the paper trail.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions