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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions