Skip to content

refactor(consumers): remove legacy Agent Bundle APIs - #808

Merged
ScriptedAlchemy merged 4 commits into
mainfrom
chore/migrate-consumer-legacy-apis
Sep 16, 2026
Merged

ScriptedAlchemy merged 4 commits into
mainfrom
chore/migrate-consumer-legacy-apis

Conversation

@ScriptedAlchemy

@ScriptedAlchemy ScriptedAlchemy commented Sep 16, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • move example release identity from deprecated plugin.version declarations to canonical package.json.version
  • migrate the RSC runtime example from Mcp.* / lowerMcpResult to Agent Documents and documentToCallToolResult, deleting the dead raw-render helper and legacy lowerer tests
  • refresh scaffolded consumer pins to React 19.3.0, @types/react 19.3.0, and @types/node 26.5.1 while retaining the required Zod 4.5.4 peer floor

Framework worker handoff

  • The consumer migration removes the last example dependency on the runtime Mcp elements, lowerMcpResult, and exported NativePostToolUseOutput; the sibling framework cleanup can delete those APIs without retaining an example compatibility path.
  • Please drop overlapping edits under examples/** from /fast/tmp/ab-legacy; this PR owns the consumer side.
  • packages/agent-bundle/tests/packed-small-plugin.test.ts copies examples/skills-starter and replaces its canonical package.json; with plugin.version gone the synthetic consumers hit AB4013, so this PR gives both synthetic manifests version: '1.0.0' (same shape as the amp fixture). examples-contract.test.ts now asserts the resolved 1.0.0 identity for Skills Starter instead of the development fallback. No framework-side follow-up remains for these two tests.

Verification

  • pnpm build — pass
  • pnpm typecheck — pass
  • pnpm lint — pass
  • pnpm test:unit — pass
  • pnpm examples:check — pass
  • pnpm docs:site:build — pass, language parity clean
  • pnpm test:packed packages/agent-bundle/tests/packed-small-plugin.test.ts — pass after the fixture version fix (CI run 35077250965 had Release gates and integration-1 red on exactly these two tests)
  • AGENT_BUNDLE_*_PREBUILT=1 rstest --config rstest.integration.config.ts packages/agent-bundle/tests/examples-contract.test.ts — 5/5 pass

No Workbench or MCP App UI behavior changed, so no new browser capture was required; existing RSC transport and invocation suites prove the populated text/image/structured output after projection.

Review

Independent change-risk-reviewer (Sol) on head 48c4e75: one blocking finding — packed-small-plugin.test.ts overwrote the copied skills-starter manifest without a version, so with plugin.version removed the packed pool (test:packed, run by the PR Release gates job via check:release:ci) failed AB4013. Fixed in e87ac03 together with the sibling examples-contract.test.ts assertion that still expected the development-fallback label. Everything else clean: the RSC example imports only the public @agent-bundle/runtime root (AgentDocument, documentToCallToolResult); text/image/structured output and document limits remain covered by dev-invocation.integration.test.ts and mcp-transports.integration.test.ts; docs already describe plugin.version as deprecated and do not pin template versions; changeset names only create-agent-bundle (patch).

@changeset-bot

changeset-bot Bot commented Sep 16, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: e87ac03

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
create-agent-bundle Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 16, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-16T08:39:40.142115Z a438076 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a438076abd

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@@ -1,5 +1,6 @@
{
"name": "@agent-bundle-example/skills-starter",
"version": "1.0.0",

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Keep packed skills fixtures release-versioned

When packed-small-plugin.test.ts copies skills-starter, it replaces this manifest with { private, type } (lines 119–129), so after removing plugin.version the copied projects have no release identity and agent-bundle build fails with AB4013. Update those synthetic manifests to retain a semantic version in this change; otherwise the required packed-release gate remains red.

AGENTS.md reference: AGENTS.md:L32-L36

Useful? React with 👍 / 👎.

@pkg-pr-new

pkg-pr-new Bot commented Sep 16, 2026 •

Copy link
Copy Markdown
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle@808
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle/create-agent-bundle@808
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle/rsc-markdown-stream@808
npm i https://pkg.pr.new/ScriptedAlchemy/agent-bundle/@agent-bundle/runtime@808

commit: e87ac03

…ge.json

The example now declares its version in package.json, so the synthetic
packed consumers need a semantic version to clear AB4013 and the examples
contract asserts the resolved 1.0.0 label instead of the dev fallback.
@ScriptedAlchemy
ScriptedAlchemy merged commit e57c0ac into main Sep 16, 2026
19 checks passed
@github-actions github-actions Bot mentioned this pull request Sep 16, 2026
@ScriptedAlchemy
ScriptedAlchemy deleted the chore/migrate-consumer-legacy-apis branch September 25, 2026 20:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant