From b9d50cd69db5917f18a0dac8d9b5a3bc856e3cfb Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 12 Aug 2026 23:52:26 +0000 Subject: [PATCH 1/2] chore: version packages --- .changeset/pin-mcp-agent-handoff.md | 5 ----- .changeset/pin-mcp-readme.md | 5 ----- .changeset/qualify-claude-approval.md | 5 ----- .changeset/qualify-cline-auto-approval.md | 5 ----- .changeset/strict-host-config-validation.md | 5 ----- .changeset/tidy-hosts-connect.md | 5 ----- packages/mcp/package.json | 2 +- readme-standard-v1.json | 2 +- 8 files changed, 2 insertions(+), 32 deletions(-) delete mode 100644 .changeset/pin-mcp-agent-handoff.md delete mode 100644 .changeset/pin-mcp-readme.md delete mode 100644 .changeset/qualify-claude-approval.md delete mode 100644 .changeset/qualify-cline-auto-approval.md delete mode 100644 .changeset/strict-host-config-validation.md delete mode 100644 .changeset/tidy-hosts-connect.md diff --git a/.changeset/pin-mcp-agent-handoff.md b/.changeset/pin-mcp-agent-handoff.md deleted file mode 100644 index 7ffde668..00000000 --- a/.changeset/pin-mcp-agent-handoff.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@agentskit/mcp': patch ---- - -Pin the MCP agent handoff install and CLI commands to the published package version. diff --git a/.changeset/pin-mcp-readme.md b/.changeset/pin-mcp-readme.md deleted file mode 100644 index d3af15f0..00000000 --- a/.changeset/pin-mcp-readme.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@agentskit/mcp': patch ---- - -Pin the README quickstart and generic MCP wrapper to the published package version. diff --git a/.changeset/qualify-claude-approval.md b/.changeset/qualify-claude-approval.md deleted file mode 100644 index 782bd2ad..00000000 --- a/.changeset/qualify-claude-approval.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@agentskit/mcp': patch ---- - -Clarify that Claude Code project-server approval prompts apply to interactive sessions. diff --git a/.changeset/qualify-cline-auto-approval.md b/.changeset/qualify-cline-auto-approval.md deleted file mode 100644 index c11284c5..00000000 --- a/.changeset/qualify-cline-auto-approval.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@agentskit/mcp': patch ---- - -Document Cline CLI's default auto-approval and the explicit opt-out for reviewable MCP calls. diff --git a/.changeset/strict-host-config-validation.md b/.changeset/strict-host-config-validation.md deleted file mode 100644 index 496419d1..00000000 --- a/.changeset/strict-host-config-validation.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@agentskit/mcp': patch ---- - -Validate the pinned coding-agent MCP wrappers and reject malformed TOML, remote transport fields, credential drift, and unpinned CLI commands. diff --git a/.changeset/tidy-hosts-connect.md b/.changeset/tidy-hosts-connect.md deleted file mode 100644 index 1ebb28a4..00000000 --- a/.changeset/tidy-hosts-connect.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -'@agentskit/mcp': patch ---- - -Document and verify pinned MCP setup for Claude Desktop, Cline, and Continue, and add a smoke test for the published npm command. diff --git a/packages/mcp/package.json b/packages/mcp/package.json index 9c08f876..ada39045 100644 --- a/packages/mcp/package.json +++ b/packages/mcp/package.json @@ -1,6 +1,6 @@ { "name": "@agentskit/mcp", - "version": "0.3.4", + "version": "0.3.5", "description": "Expose AgentsKit tools as an MCP server — use them from Codex, Claude Code, Cursor, or any MCP host.", "keywords": [ "codex", diff --git a/readme-standard-v1.json b/readme-standard-v1.json index aad36d84..4d3832e4 100644 --- a/readme-standard-v1.json +++ b/readme-standard-v1.json @@ -919,7 +919,7 @@ "docs/STABILITY.md", "scripts/readme-fixtures.test.mjs" ], - "sourceHash": "sha256:60dd3eaef1138dfd77da94d75435ee93c562ae9203bea014d733805a94f64a00" + "sourceHash": "sha256:7f77045e962331b14f0055aa010a84e62f8191f03f804e435b99f5d353a9fcf6" }, "exceptions": [] }, From fa7c4c8c1bf07f102e8969c9e8021155b5da062d Mon Sep 17 00:00:00 2001 From: EmersonBraun Date: Wed, 12 Aug 2026 21:12:25 -0300 Subject: [PATCH 2/2] docs: sync MCP pins for 0.3.5 release --- .doc-bridge/capabilities.json | 2 +- .doc-bridge/index.json | 6 +++--- .../docs-next/content/docs/for-agents/mcp.mdx | 4 ++-- .../reference/recipes/coding-agent-mcp.mdx | 20 +++++++++---------- .../atoms/coding-agent-mcp/atom.json | 16 +++++++-------- .../coding-agent-mcp/carousel-storyboard.md | 2 +- .../atoms/coding-agent-mcp/community-post.md | 4 ++-- .../atoms/coding-agent-mcp/docs.mdx | 4 ++-- .../atoms/coding-agent-mcp/example.json | 4 ++-- .../atoms/coding-agent-mcp/social-thread.md | 4 ++-- .../recipes/coding-agent-mcp.json | 4 ++-- packages/mcp/README.md | 10 +++++----- packages/mcp/fixtures/coding-agent-hosts.ts | 18 ++++++++--------- .../run-published-coding-agent-hosts.mjs | 2 +- packages/mcp/tests/coding-agent-hosts.test.ts | 4 ++-- readme-standard-v1.json | 4 ++-- 16 files changed, 54 insertions(+), 54 deletions(-) diff --git a/.doc-bridge/capabilities.json b/.doc-bridge/capabilities.json index 7545f091..05fd3394 100644 --- a/.doc-bridge/capabilities.json +++ b/.doc-bridge/capabilities.json @@ -7,7 +7,7 @@ "name": "AgentsKit", "root": "." }, - "contentHash": "38a4b61ecbad8f1dfebda378eb40982e0a3a7415f05cb15030c1a998c2135d8e", + "contentHash": "c878f166fb291e94a157ccd5817b91568c86796330c4368cd27d22d3b3060d31", "artifacts": { "index": ".doc-bridge/index.json", "llmsTxt": "llms.txt" diff --git a/.doc-bridge/index.json b/.doc-bridge/index.json index ccfa405c..de6eb684 100644 --- a/.doc-bridge/index.json +++ b/.doc-bridge/index.json @@ -1,8 +1,8 @@ { "schemaVersion": 1, - "contentHash": "38a4b61ecbad8f1dfebda378eb40982e0a3a7415f05cb15030c1a998c2135d8e", + "contentHash": "c878f166fb291e94a157ccd5817b91568c86796330c4368cd27d22d3b3060d31", "contentHashAlgo": "sha256-normalized-v1", - "generatedAt": "2026-08-12T23:34:15.267Z", + "generatedAt": "2026-08-13T00:09:29.294Z", "project": { "name": "AgentsKit", "root": "." @@ -82,7 +82,7 @@ "title": "mcp", "path": "apps/docs-next/content/docs/for-agents/mcp.mdx", "description": "Serve AgentsKit tools to any MCP host. A thin bridge over `@agentskit/tools/mcp` (`createMcpServer` + `createStdioTransport`).", - "body": "Purpose Serve AgentsKit tools to any MCP host. A thin bridge over @agentskit/tools/mcp ( createMcpServer + createStdioTransport ). Install Primary exports - createAgentsKitMcpServer({ tools, serverInfo?, onEvent?, transport? }) — expose ToolDefinition[] as an MCP server. Defaults to stdio over the current process; pass transport to override (tests / custom hosts). - processStdio() — adapt the Node process into the StdioLikeProcess the transport expects (server receives on stdin, sends on stdout). - createAgentTool({ id, description, systemPrompt, adapter, maxSteps? }) — wrap a whole agent as one MCP tool. The host calls it with a task ; the agent runs server-side on the given adapter and returns the result (\"agents as MCP tools\"). - fetchAgentSkill(id, fetchImpl?) — fetch a registry agent's runnable skill (hosted index, raw-GitHub fallback); null for tool-composing agents. An optional third argument controls abort, timeout, and response-byte limits. Bin agentskit-mcp — npx -y @agentskit/mcp@0.3.4 --tools fetch,search . Expose whole agents with --agents --provider

` (any of ~20 providers + catalog OpenAI-compatible). Flags: `--tools`, `--fs-root`, `--sqlite`, `--allow-shell`, `--model`, `--max-steps`, `--api-key`, `--base-url`. Unknown, duplicate, or valueless flags fail closed. stdout is the diff --git a/apps/docs-next/content/docs/reference/recipes/coding-agent-mcp.mdx b/apps/docs-next/content/docs/reference/recipes/coding-agent-mcp.mdx index 78c898d5..38b2b0ed 100644 --- a/apps/docs-next/content/docs/reference/recipes/coding-agent-mcp.mdx +++ b/apps/docs-next/content/docs/reference/recipes/coding-agent-mcp.mdx @@ -35,7 +35,7 @@ host application's UI, login, or trust prompt. Add the server with the CLI: ```bash -codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search +codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search codex mcp list ``` @@ -44,7 +44,7 @@ Or commit a project-scoped `.codex/config.toml` in a trusted project: ```toml [mcp_servers.agentskit] command = "npx" -args = ["-y", "@agentskit/mcp@0.3.4", "--tools", "fetch,search"] +args = ["-y", "@agentskit/mcp@0.3.5", "--tools", "fetch,search"] default_tools_approval_mode = "prompt" ``` @@ -56,7 +56,7 @@ Use `/mcp` to inspect the connected server. Create a project-scoped server: ```bash -claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search +claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search claude mcp list ``` @@ -68,7 +68,7 @@ The equivalent `.mcp.json` is: "agentskit": { "type": "stdio", "command": "npx", - "args": ["-y", "@agentskit/mcp@0.3.4", "--tools", "fetch,search"] + "args": ["-y", "@agentskit/mcp@0.3.5", "--tools", "fetch,search"] } } } @@ -89,7 +89,7 @@ Create `.cursor/mcp.json`: "agentskit": { "type": "stdio", "command": "npx", - "args": ["-y", "@agentskit/mcp@0.3.4", "--tools", "fetch,search"] + "args": ["-y", "@agentskit/mcp@0.3.5", "--tools", "fetch,search"] } } } @@ -109,7 +109,7 @@ edits `%APPDATA%\Claude\claude_desktop_config.json`. "mcpServers": { "agentskit": { "command": "npx", - "args": ["-y", "@agentskit/mcp@0.3.4", "--tools", "fetch,search"] + "args": ["-y", "@agentskit/mcp@0.3.5", "--tools", "fetch,search"] } } } @@ -128,7 +128,7 @@ Open MCP Servers, choose Configure MCP Servers, and add: "mcpServers": { "agentskit": { "command": "npx", - "args": ["-y", "@agentskit/mcp@0.3.4", "--tools", "fetch,search"], + "args": ["-y", "@agentskit/mcp@0.3.5", "--tools", "fetch,search"], "env": {}, "disabled": false, "autoApprove": [] @@ -151,7 +151,7 @@ Create `.continue/mcpServers/agentskit.yaml`: ```yaml name: AgentsKit MCP -version: 0.3.4 +version: 0.3.5 schema: v1 mcpServers: - name: agentskit @@ -159,7 +159,7 @@ mcpServers: command: npx args: - "-y" - - "@agentskit/mcp@0.3.4" + - "@agentskit/mcp@0.3.5" - "--tools" - "fetch,search" ``` @@ -174,7 +174,7 @@ server arguments rather than changing host-specific code: ```bash OPENROUTER_API_KEY=your-key \ - npx -y @agentskit/mcp@0.3.4 \ + npx -y @agentskit/mcp@0.3.5 \ --tools fetch,search \ --agents code-review \ --provider openrouter \ diff --git a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/atom.json b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/atom.json index 470aa6e4..341ef197 100644 --- a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/atom.json +++ b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/atom.json @@ -37,8 +37,8 @@ "expectStdoutIncludes": "verified local MCP stdio protocol; cli tools: fetch_url, web_search" }, "commands": [ - "codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search", - "claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search", + "codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search", + "claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search", "pnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts", "pnpm --filter @agentskit/mcp smoke:published" ], @@ -167,22 +167,22 @@ } ], "variants": { - "docsPage": "---\ntitle: Connect AgentsKit to your coding agent\ndescription: Developers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host.\n---\n\n# Connect AgentsKit to your coding agent\n\nDevelopers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host.\n\n## Audience\n\nJavaScript and TypeScript developers using Codex, Claude Code or Desktop, Cursor, Cline, Continue, or another MCP-compatible host\n\n## Commands\n\n```bash\ncodex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search\nclaude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search\npnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts\npnpm --filter @agentskit/mcp smoke:published\n```\n\n## Verified claims\n\n- **agentskit/packages**: 22 packages (from ecosystem-claims.json)\n- **agentskit/integrations**: 50 integrations (from ecosystem-claims.json)\n\n## Citations\n\n- [coding-agent MCP host fixture](packages/mcp/fixtures/coding-agent-hosts.ts)\n- [coding-agent MCP recipe](/docs/reference/recipes/coding-agent-mcp)\n- [Codex MCP configuration](https://developers.openai.com/codex/mcp/)\n- [Claude Code MCP configuration](https://docs.anthropic.com/en/docs/claude-code/mcp)\n- [Cursor MCP configuration](https://cursor.com/docs/mcp)\n- [Cline MCP configuration](https://docs.cline.bot/mcp/mcp-overview)\n- [Continue MCP configuration](https://docs.continue.dev/customize/deep-dives/mcp)\n\n## Ecosystem next steps\n\n- [AgentsKit](https://www.agentskit.io/docs) — Build agents without gluing many libraries together.\n- [AgentsKit Registry](https://registry.agentskit.io/docs) — Copy ready-made agents and own the source.\n- [AgentsKit Chat](https://chat.agentskit.io/docs) — Define one agent experience and deliver it across interfaces.\n- [Agents Playbook](https://playbook.agentskit.io/docs) — Train coding agents to ship code your team would merge.\n- [Doc Bridge](https://doc-bridge.agentskit.io/) — Turn repository documentation into executable agent handoffs.\n- [AgentsKit Code Review](https://github.com/AgentsKit-io/code-review-cli#readme) — Run deep, low-noise review with the model already in use.\n- [AgentsKit OS](https://akos.agentskit.io/docs) — Run and govern agents in production.\n\n> Draft generated by the content pipeline. Human approval required before publishing.\n", + "docsPage": "---\ntitle: Connect AgentsKit to your coding agent\ndescription: Developers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host.\n---\n\n# Connect AgentsKit to your coding agent\n\nDevelopers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host.\n\n## Audience\n\nJavaScript and TypeScript developers using Codex, Claude Code or Desktop, Cursor, Cline, Continue, or another MCP-compatible host\n\n## Commands\n\n```bash\ncodex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search\nclaude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search\npnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts\npnpm --filter @agentskit/mcp smoke:published\n```\n\n## Verified claims\n\n- **agentskit/packages**: 22 packages (from ecosystem-claims.json)\n- **agentskit/integrations**: 50 integrations (from ecosystem-claims.json)\n\n## Citations\n\n- [coding-agent MCP host fixture](packages/mcp/fixtures/coding-agent-hosts.ts)\n- [coding-agent MCP recipe](/docs/reference/recipes/coding-agent-mcp)\n- [Codex MCP configuration](https://developers.openai.com/codex/mcp/)\n- [Claude Code MCP configuration](https://docs.anthropic.com/en/docs/claude-code/mcp)\n- [Cursor MCP configuration](https://cursor.com/docs/mcp)\n- [Cline MCP configuration](https://docs.cline.bot/mcp/mcp-overview)\n- [Continue MCP configuration](https://docs.continue.dev/customize/deep-dives/mcp)\n\n## Ecosystem next steps\n\n- [AgentsKit](https://www.agentskit.io/docs) — Build agents without gluing many libraries together.\n- [AgentsKit Registry](https://registry.agentskit.io/docs) — Copy ready-made agents and own the source.\n- [AgentsKit Chat](https://chat.agentskit.io/docs) — Define one agent experience and deliver it across interfaces.\n- [Agents Playbook](https://playbook.agentskit.io/docs) — Train coding agents to ship code your team would merge.\n- [Doc Bridge](https://doc-bridge.agentskit.io/) — Turn repository documentation into executable agent handoffs.\n- [AgentsKit Code Review](https://github.com/AgentsKit-io/code-review-cli#readme) — Run deep, low-noise review with the model already in use.\n- [AgentsKit OS](https://akos.agentskit.io/docs) — Run and govern agents in production.\n\n> Draft generated by the content pipeline. Human approval required before publishing.\n", "shortPost": "Connect AgentsKit to your coding agent.\n\n4 commands. No provider key.\n\n```bash\npnpm --filter @agentskit/mcp smoke:published\n```\n\nBuilt on AgentsKit (22 packages, 50 integrations).\n\nDocs + fixture linked in the atom. Human-reviewed drafts only.", - "thread": "1/ Connect AgentsKit to your coding agent\n\nWhy it exists: Developers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host.\n\n2/ The path:\n1. `codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search`\n2. `claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search`\n3. `pnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts`\n4. `pnpm --filter @agentskit/mcp smoke:published`\n\n3/ Claims (generated, not hand-typed):\n- 22 packages\n- 50 integrations\n\n4/ Next products:\n- AgentsKit: Build agents without gluing many libraries together.\n- AgentsKit Registry: Copy ready-made agents and own the source.\n- AgentsKit Chat: Define one agent experience and deliver it across interfaces.\n\n5/ This thread is a draft atom. Publishing requires explicit human approval.", - "communityPost": "## Connect AgentsKit to your coding agent\n\nDevelopers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host.\n\n### Try it\n\n```bash\ncodex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search\nclaude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search\npnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts\npnpm --filter @agentskit/mcp smoke:published\n```\n\n### Claims\n22 packages, 50 integrations\n\nSource fixture: `packages/mcp/fixtures/run-coding-agent-hosts.mjs`\n\nStatus: draft — awaiting human approval before community publish.", + "thread": "1/ Connect AgentsKit to your coding agent\n\nWhy it exists: Developers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host.\n\n2/ The path:\n1. `codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search`\n2. `claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search`\n3. `pnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts`\n4. `pnpm --filter @agentskit/mcp smoke:published`\n\n3/ Claims (generated, not hand-typed):\n- 22 packages\n- 50 integrations\n\n4/ Next products:\n- AgentsKit: Build agents without gluing many libraries together.\n- AgentsKit Registry: Copy ready-made agents and own the source.\n- AgentsKit Chat: Define one agent experience and deliver it across interfaces.\n\n5/ This thread is a draft atom. Publishing requires explicit human approval.", + "communityPost": "## Connect AgentsKit to your coding agent\n\nDevelopers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host.\n\n### Try it\n\n```bash\ncodex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search\nclaude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search\npnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts\npnpm --filter @agentskit/mcp smoke:published\n```\n\n### Claims\n22 packages, 50 integrations\n\nSource fixture: `packages/mcp/fixtures/run-coding-agent-hosts.mjs`\n\nStatus: draft — awaiting human approval before community publish.", "example": { "kind": "fixture-link", "path": "packages/mcp/fixtures/run-coding-agent-hosts.mjs", "commands": [ - "codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search", - "claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search", + "codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search", + "claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search", "pnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts", "pnpm --filter @agentskit/mcp smoke:published" ] } }, - "storyboard": "# Storyboard — Connect AgentsKit to your coding agent\n\nFormat: 5-frame carousel / 15s silent GIF\n\n1. **Hook** — \"Developers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host.\"\n2. **Install** — show `codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search`\n3. **Copy fixture** — show the agent.ts path\n4. **Run** — terminal output includes the expected ready line\n5. **Next step** — point to Registry / Playbook / Chat without inventing counts\n\nAccessibility: every frame needs alt text; prefer reduced-motion static frames.\nNo auto-publish — storyboard is a draft for human design review.\n", + "storyboard": "# Storyboard — Connect AgentsKit to your coding agent\n\nFormat: 5-frame carousel / 15s silent GIF\n\n1. **Hook** — \"Developers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host.\"\n2. **Install** — show `codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search`\n3. **Copy fixture** — show the agent.ts path\n4. **Run** — terminal output includes the expected ready line\n5. **Next step** — point to Registry / Playbook / Chat without inventing counts\n\nAccessibility: every frame needs alt text; prefer reduced-motion static frames.\nNo auto-publish — storyboard is a draft for human design review.\n", "publish": { "status": "blocked", "reason": "Human approval required before publish packaging", diff --git a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/carousel-storyboard.md b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/carousel-storyboard.md index ebded004..81528ab5 100644 --- a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/carousel-storyboard.md +++ b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/carousel-storyboard.md @@ -3,7 +3,7 @@ Format: 5-frame carousel / 15s silent GIF 1. **Hook** — "Developers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host." -2. **Install** — show `codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search` +2. **Install** — show `codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search` 3. **Copy fixture** — show the agent.ts path 4. **Run** — terminal output includes the expected ready line 5. **Next step** — point to Registry / Playbook / Chat without inventing counts diff --git a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/community-post.md b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/community-post.md index e697b924..5dc579a3 100644 --- a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/community-post.md +++ b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/community-post.md @@ -5,8 +5,8 @@ Developers should be able to use the same AgentsKit tools and agents inside thei ### Try it ```bash -codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search -claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search +codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search +claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search pnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts pnpm --filter @agentskit/mcp smoke:published ``` diff --git a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/docs.mdx b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/docs.mdx index 53cb808c..226b0c28 100644 --- a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/docs.mdx +++ b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/docs.mdx @@ -14,8 +14,8 @@ JavaScript and TypeScript developers using Codex, Claude Code or Desktop, Cursor ## Commands ```bash -codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search -claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search +codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search +claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search pnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts pnpm --filter @agentskit/mcp smoke:published ``` diff --git a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/example.json b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/example.json index c3d98cfe..bf06a8d1 100644 --- a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/example.json +++ b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/example.json @@ -2,8 +2,8 @@ "kind": "fixture-link", "path": "packages/mcp/fixtures/run-coding-agent-hosts.mjs", "commands": [ - "codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search", - "claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search", + "codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search", + "claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search", "pnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts", "pnpm --filter @agentskit/mcp smoke:published" ] diff --git a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/social-thread.md b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/social-thread.md index ad61bffa..07271813 100644 --- a/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/social-thread.md +++ b/docs/ecosystem/content-pipeline/atoms/coding-agent-mcp/social-thread.md @@ -3,8 +3,8 @@ Why it exists: Developers should be able to use the same AgentsKit tools and agents inside their existing coding agent without building or maintaining a separate integration for every host. 2/ The path: -1. `codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search` -2. `claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search` +1. `codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search` +2. `claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search` 3. `pnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts` 4. `pnpm --filter @agentskit/mcp smoke:published` diff --git a/docs/ecosystem/content-pipeline/recipes/coding-agent-mcp.json b/docs/ecosystem/content-pipeline/recipes/coding-agent-mcp.json index 877ec3b1..795a4ed1 100644 --- a/docs/ecosystem/content-pipeline/recipes/coding-agent-mcp.json +++ b/docs/ecosystem/content-pipeline/recipes/coding-agent-mcp.json @@ -21,8 +21,8 @@ "expectStdoutIncludes": "verified local MCP stdio protocol; cli tools: fetch_url, web_search" }, "commands": [ - "codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search", - "claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search", + "codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search", + "claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search", "pnpm --filter @agentskit/mcp exec vitest run tests/coding-agent-hosts.test.ts", "pnpm --filter @agentskit/mcp smoke:published" ], diff --git a/packages/mcp/README.md b/packages/mcp/README.md index f42f7420..9b7c4c41 100644 --- a/packages/mcp/README.md +++ b/packages/mcp/README.md @@ -31,7 +31,7 @@ Docs: [package guide](https://www.agentskit.io/docs/packages/mcp) · [agent hand ```bash -npx -y @agentskit/mcp@0.3.4 --tools fetch,search +npx -y @agentskit/mcp@0.3.5 --tools fetch,search ``` Then point your MCP host at the command. Example (generic JSON config): @@ -39,7 +39,7 @@ Then point your MCP host at the command. Example (generic JSON config): ```json { "mcpServers": { - "agentskit": { "command": "npx", "args": ["-y", "@agentskit/mcp@0.3.4", "--tools", "fetch,search"] } + "agentskit": { "command": "npx", "args": ["-y", "@agentskit/mcp@0.3.5", "--tools", "fetch,search"] } } } ``` @@ -51,10 +51,10 @@ changes: ```bash # Codex -codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search +codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search # Claude Code (shared project configuration) -claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search +claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search ``` Cursor, Cline, Claude Desktop, and Continue use the same pinned command with @@ -103,7 +103,7 @@ Run a registry agent server-side and expose it as a single MCP tool — the host delegates a specialized job instead of orchestrating primitives: ```bash -npx -y @agentskit/mcp@0.3.4 --agents legal-contract-reviewer,fintech-kyc-screener --provider openai +npx -y @agentskit/mcp@0.3.5 --agents legal-contract-reviewer,fintech-kyc-screener --provider openai ``` `--provider` covers the first-class adapters (openai, anthropic, gemini, ollama) diff --git a/packages/mcp/fixtures/coding-agent-hosts.ts b/packages/mcp/fixtures/coding-agent-hosts.ts index 61e921f8..17854f9f 100644 --- a/packages/mcp/fixtures/coding-agent-hosts.ts +++ b/packages/mcp/fixtures/coding-agent-hosts.ts @@ -3,14 +3,14 @@ import { createInMemoryTransportPair, createMcpClient } from '@agentskit/tools/m import { createAgentsKitMcpServer } from '../src/index' const command = 'npx' -const args = ['-y', '@agentskit/mcp@0.3.4', '--tools', 'fetch,search'] as const +const args = ['-y', '@agentskit/mcp@0.3.5', '--tools', 'fetch,search'] as const const stdioServer = { type: 'stdio', command, args } as const const desktopStdioServer = { command, args } as const export const codingAgentHostConfigs = { claude: { - cli: 'claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search', + cli: 'claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search', config: { mcpServers: { agentskit: stdioServer, @@ -30,7 +30,7 @@ export const codingAgentHostConfigs = { }, }, codex: { - cli: 'codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search', + cli: 'codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search', config: [ '[mcp_servers.agentskit]', `command = "${command}"`, @@ -63,7 +63,7 @@ export const codingAgentHostConfigs = { continue: { config: [ 'name: AgentsKit MCP', - 'version: 0.3.4', + 'version: 0.3.5', 'schema: v1', 'mcpServers:', ' - name: agentskit', @@ -83,9 +83,9 @@ export const codingAgentHostConfigs = { }, } as const -const expectedHostArgs = ['-y', '@agentskit/mcp@0.3.4', '--tools', 'fetch,search'] -const expectedClaudeCli = 'claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search' -const expectedCodexCli = 'codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.4 --tools fetch,search' +const expectedHostArgs = ['-y', '@agentskit/mcp@0.3.5', '--tools', 'fetch,search'] +const expectedClaudeCli = 'claude mcp add --scope project --transport stdio agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search' +const expectedCodexCli = 'codex mcp add agentskit -- npx -y @agentskit/mcp@0.3.5 --tools fetch,search' const isRecord = (value: unknown): value is Record => typeof value === 'object' && value !== null && !Array.isArray(value) @@ -137,7 +137,7 @@ const validateStdioServer = ( requireValue( Array.isArray(server.args) && server.args.every((arg): arg is string => typeof arg === 'string') && JSON.stringify(server.args) === JSON.stringify(expectedHostArgs), - `${host}.args must pin @agentskit/mcp@0.3.4 with fetch,search`, + `${host}.args must pin @agentskit/mcp@0.3.5 with fetch,search`, ) } @@ -195,7 +195,7 @@ const validateContinueYaml = (source: string): void => { const lines = source.split('\n') const metadata = [ 'name: AgentsKit MCP', - 'version: 0.3.4', + 'version: 0.3.5', 'schema: v1', 'mcpServers:', ' - name: agentskit', diff --git a/packages/mcp/fixtures/run-published-coding-agent-hosts.mjs b/packages/mcp/fixtures/run-published-coding-agent-hosts.mjs index 52575465..56e67c8f 100644 --- a/packages/mcp/fixtures/run-published-coding-agent-hosts.mjs +++ b/packages/mcp/fixtures/run-published-coding-agent-hosts.mjs @@ -2,7 +2,7 @@ import { spawn } from 'node:child_process' import { tmpdir } from 'node:os' import { createMcpClient, createStdioTransport } from '@agentskit/tools/mcp' -const packageSpec = '@agentskit/mcp@0.3.4' +const packageSpec = '@agentskit/mcp@0.3.5' const child = spawn('npx', ['-y', packageSpec, '--tools', 'fetch,search'], { cwd: tmpdir(), stdio: ['pipe', 'pipe', 'pipe'], diff --git a/packages/mcp/tests/coding-agent-hosts.test.ts b/packages/mcp/tests/coding-agent-hosts.test.ts index 9e606295..af3b353c 100644 --- a/packages/mcp/tests/coding-agent-hosts.test.ts +++ b/packages/mcp/tests/coding-agent-hosts.test.ts @@ -5,7 +5,7 @@ import { verifyMcpProtocol, } from '../fixtures/coding-agent-hosts' -const expectedArgs = ['-y', '@agentskit/mcp@0.3.4', '--tools', 'fetch,search'] +const expectedArgs = ['-y', '@agentskit/mcp@0.3.5', '--tools', 'fetch,search'] describe('coding-agent MCP host recipe', () => { it('validates every JSON, TOML, and YAML wrapper', () => { @@ -101,7 +101,7 @@ describe('coding-agent MCP host recipe', () => { const driftingCli = JSON.parse(JSON.stringify(codingAgentHostConfigs)) as Record const codex = driftingCli.codex as Record - codex.cli = String(codex.cli).replace('@agentskit/mcp@0.3.4', '@agentskit/mcp') + codex.cli = String(codex.cli).replace('@agentskit/mcp@0.3.5', '@agentskit/mcp') expect(() => validateCodingAgentHostConfigs(driftingCli)).toThrow(/Codex CLI command must remain version-pinned/) }) diff --git a/readme-standard-v1.json b/readme-standard-v1.json index 4d3832e4..d34dd34e 100644 --- a/readme-standard-v1.json +++ b/readme-standard-v1.json @@ -896,7 +896,7 @@ "commands": [ { "id": "install", - "command": "npx -y @agentskit/mcp@0.3.4 --tools fetch,search", + "command": "npx -y @agentskit/mcp@0.3.5 --tools fetch,search", "test": "packages/mcp/tests/server.test.ts", "testCommand": "pnpm --filter @agentskit/mcp test" } @@ -919,7 +919,7 @@ "docs/STABILITY.md", "scripts/readme-fixtures.test.mjs" ], - "sourceHash": "sha256:7f77045e962331b14f0055aa010a84e62f8191f03f804e435b99f5d353a9fcf6" + "sourceHash": "sha256:2d97834a2fbb3c87c87465d8d4486e9f296958d446df1745a9965b2f7f359f12" }, "exceptions": [] },