{"_id":"@ag-ui/claude-agent-sdk","_rev":"4-b556a0430f0164d175bcccfa85679284","name":"@ag-ui/claude-agent-sdk","dist-tags":{"canary":"0.0.2-canary.1777061096.0","latest":"0.0.4"},"versions":{"0.0.2-canary.1777061096.0":{"name":"@ag-ui/claude-agent-sdk","version":"0.0.2-canary.1777061096.0","_id":"@ag-ui/claude-agent-sdk@0.0.2-canary.1777061096.0","maintainers":[{"name":"_mme","email":"markus.ecker@gmail.com"},{"name":"copilotkit","email":"devops@copilotkit.ai"}],"dist":{"shasum":"383a79970ccf411e40aacdeca14f777f57a338d7","tarball":"https://registry.npmjs.org/@ag-ui/claude-agent-sdk/-/claude-agent-sdk-0.0.2-canary.1777061096.0.tgz","fileCount":9,"integrity":"sha512-Wd3iG6DR2QCnWsM7PgPTrsQvnVsTtcpvD85zHn56V9AT24GAbfKyHKUKRRe4hQ/FbObIgdG2SgxyCIMtULDlcA==","signatures":[{"sig":"MEUCIQDtfSWDBzHRf5nN5iRa27LLgUI6rCFg1y+R6SrWMWSGdAIgD9d6u/l2eg7pNMr00a46+TRApbXYVyHrjtsKH9X6/us=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":228866},"main":"./dist/index.js","_from":"file:ag-ui-claude-agent-sdk-0.0.2-canary.1777061096.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","private":false,"scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo node_modules","typecheck":"tsc --noEmit","link:global":"pnpm link --global","dev:examples":"tsx --env-file=.env --watch examples/server.ts","unlink:global":"pnpm unlink --global"},"_npmUser":{"name":"copilotkit","email":"devops@copilotkit.ai"},"_resolved":"/tmp/aa88edbaa1d4a2b667d2d2f71eb5ca90/ag-ui-claude-agent-sdk-0.0.2-canary.1777061096.0.tgz","_integrity":"sha512-Wd3iG6DR2QCnWsM7PgPTrsQvnVsTtcpvD85zHn56V9AT24GAbfKyHKUKRRe4hQ/FbObIgdG2SgxyCIMtULDlcA==","_npmVersion":"10.9.7","description":"AG-UI integration for Anthropic Claude Agent SDK","directories":{},"sideEffects":false,"_nodeVersion":"22.22.2","dependencies":{"rxjs":"7.8.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","tsup":"^8.0.2","vitest":"^4.0.18","typescript":"^5.9.3","@ag-ui/core":"0.0.52","@types/node":"^20.11.19","@ag-ui/client":"0.0.52","@anthropic-ai/claude-agent-sdk":"^0.2.58"},"peerDependencies":{"zod":">=3.0.0","@ag-ui/core":">=0.0.42","@ag-ui/client":">=0.0.42","@anthropic-ai/sdk":">=0.50.0","@anthropic-ai/claude-agent-sdk":"^0.2.58"},"_npmOperationalInternal":{"tmp":"tmp/claude-agent-sdk_0.0.2-canary.1777061096.0_1777061118432_0.8847901642928606","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@ag-ui/claude-agent-sdk","version":"0.0.2","_id":"@ag-ui/claude-agent-sdk@0.0.2","maintainers":[{"name":"_mme","email":"markus.ecker@gmail.com"},{"name":"copilotkit","email":"devops@copilotkit.ai"}],"dist":{"shasum":"2be25e26811b15c628b553356051baa36f111119","tarball":"https://registry.npmjs.org/@ag-ui/claude-agent-sdk/-/claude-agent-sdk-0.0.2.tgz","fileCount":9,"integrity":"sha512-QgsT1afuO+s/wMVfTSx9EA4Kx+efttm3BGfgths+x+fA9e0u1gFIXj1z8l9oW74WC74N3Lu4KYmshQ9q7G96xQ==","signatures":[{"sig":"MEUCIGX0BPNMIhWOiNzGlnXMtW0EEcnJkJFO3tqWODwi7hMtAiEAzNoBrlO5M/gUx89TlBnA+bpAGz6WfvMnQlPFHGS/TOY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":228846},"main":"./dist/index.js","_from":"file:ag-ui-claude-agent-sdk-0.0.2.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","private":false,"scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo node_modules","typecheck":"tsc --noEmit","link:global":"pnpm link --global","dev:examples":"tsx --env-file=.env --watch examples/server.ts","unlink:global":"pnpm unlink --global"},"_npmUser":{"name":"copilotkit","email":"devops@copilotkit.ai"},"_resolved":"/tmp/d64a8d5b21521785e47f9d9e0cf3eedf/ag-ui-claude-agent-sdk-0.0.2.tgz","_integrity":"sha512-QgsT1afuO+s/wMVfTSx9EA4Kx+efttm3BGfgths+x+fA9e0u1gFIXj1z8l9oW74WC74N3Lu4KYmshQ9q7G96xQ==","_npmVersion":"10.9.7","description":"AG-UI integration for Anthropic Claude Agent SDK","directories":{},"sideEffects":false,"_nodeVersion":"22.22.2","dependencies":{"rxjs":"7.8.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","tsup":"^8.0.2","vitest":"^4.0.18","typescript":"^5.9.3","@ag-ui/core":"0.0.52","@types/node":"^20.11.19","@ag-ui/client":"0.0.52","@anthropic-ai/claude-agent-sdk":"^0.2.58"},"peerDependencies":{"zod":">=3.0.0","@ag-ui/core":">=0.0.42","@ag-ui/client":">=0.0.42","@anthropic-ai/sdk":">=0.50.0","@anthropic-ai/claude-agent-sdk":"^0.2.58"},"_npmOperationalInternal":{"tmp":"tmp/claude-agent-sdk_0.0.2_1777062700226_0.09765533742536125","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@ag-ui/claude-agent-sdk","version":"0.0.3","_id":"@ag-ui/claude-agent-sdk@0.0.3","maintainers":[{"name":"_mme","email":"markus.ecker@gmail.com"},{"name":"copilotkit","email":"devops@copilotkit.ai"}],"homepage":"https://github.com/ag-ui-protocol/ag-ui#readme","bugs":{"url":"https://github.com/ag-ui-protocol/ag-ui/issues"},"dist":{"shasum":"0d3332d85bf7f3e2e7791a88cfc985061a4759d1","tarball":"https://registry.npmjs.org/@ag-ui/claude-agent-sdk/-/claude-agent-sdk-0.0.3.tgz","fileCount":9,"integrity":"sha512-pbekp9dROaRoJk/u2A0/gF6A05V6eYrOfXjnGAiT1tR6GOhXd9kAamJtFdZfWV2MaSmOxupIS7XphkxV9DC4xQ==","signatures":[{"sig":"MEYCIQC9UjOhG/P7Pg9j7gNQCFXk1PcVprWz+iRucKhX++AbeAIhAIqsC/lMFbYkToWb19gcMTFFGAZT25MOE3Agh+ltSEBI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ag-ui%2fclaude-agent-sdk@0.0.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":239001},"main":"./dist/index.js","_from":"file:ag-ui-claude-agent-sdk-0.0.3.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","private":false,"scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo node_modules","typecheck":"tsc --noEmit","link:global":"pnpm link --global","dev:examples":"tsx --env-file=.env --watch examples/server.ts","unlink:global":"pnpm unlink --global"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:723bdc9c-90f2-4fac-9c63-c5c16ceef67f"}},"_resolved":"/home/runner/work/ag-ui/ag-ui/integrations/claude-agent-sdk/typescript/ag-ui-claude-agent-sdk-0.0.3.tgz","_integrity":"sha512-pbekp9dROaRoJk/u2A0/gF6A05V6eYrOfXjnGAiT1tR6GOhXd9kAamJtFdZfWV2MaSmOxupIS7XphkxV9DC4xQ==","repository":{"url":"git+https://github.com/ag-ui-protocol/ag-ui.git","type":"git"},"_npmVersion":"11.15.0","description":"AG-UI integration for Anthropic Claude Agent SDK","directories":{},"sideEffects":false,"_nodeVersion":"22.22.3","dependencies":{"rxjs":"7.8.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","tsup":"^8.0.2","vitest":"^4.0.18","typescript":"^5.9.3","@ag-ui/core":"0.0.53","@types/node":"^20.11.19","@ag-ui/client":"0.0.53","@anthropic-ai/claude-agent-sdk":"^0.2.58"},"peerDependencies":{"zod":">=3.0.0","@ag-ui/core":">=0.0.42","@ag-ui/client":">=0.0.42","@anthropic-ai/sdk":">=0.50.0","@anthropic-ai/claude-agent-sdk":"^0.2.58"},"_npmOperationalInternal":{"tmp":"tmp/claude-agent-sdk_0.0.3_1779815372660_0.8615541383878809","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"_id":"@ag-ui/claude-agent-sdk@0.0.4","bugs":{"url":"https://github.com/ag-ui-protocol/ag-ui/issues"},"dist":{"shasum":"c60d61edb41c913c13e5ec583d9d0796f5346596","tarball":"https://registry.npmjs.org/@ag-ui/claude-agent-sdk/-/claude-agent-sdk-0.0.4.tgz","fileCount":9,"integrity":"sha512-119ssaOikM734u1J/FPUjzAy7gk/oIbagUHABGbQO8txLK2ddMiCUa/3GUrZk9/jYU34doRGnxYVsCT4kCJ+qA==","signatures":[{"sig":"MEYCIQCCAX8/v6N5hPK4eyqC02avzgu7xbpq/kBQKJPrN14WzAIhAL0o/R9BzQ4oVcwcb4IQ4CNqgbeqOCUin2EWqLbgX227","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIH+TH2qgRUrbpPYQKURtBBouQqMo76/Q4gdmASgb0DcEAiAE5sWsW547LDLKAF8rJ/5A4pSuFGr3NBdhDKOjUBsvwg=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ag-ui%2fclaude-agent-sdk@0.0.4","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":271104},"main":"./dist/index.js","name":"@ag-ui/claude-agent-sdk","_from":"file:ag-ui-claude-agent-sdk-0.0.4.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","license":"MIT","private":false,"scripts":{"dev":"tsup --watch","test":"vitest run","build":"tsup","clean":"rm -rf dist .turbo node_modules","typecheck":"tsc --noEmit","link:global":"pnpm link --global","dev:examples":"tsx --env-file=.env --watch examples/server.ts","unlink:global":"pnpm unlink --global"},"version":"0.0.4","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:723bdc9c-90f2-4fac-9c63-c5c16ceef67f"}},"homepage":"https://github.com/ag-ui-protocol/ag-ui#readme","_resolved":"/home/runner/work/ag-ui/ag-ui/integrations/claude-agent-sdk/typescript/ag-ui-claude-agent-sdk-0.0.4.tgz","_integrity":"sha512-119ssaOikM734u1J/FPUjzAy7gk/oIbagUHABGbQO8txLK2ddMiCUa/3GUrZk9/jYU34doRGnxYVsCT4kCJ+qA==","repository":{"url":"git+https://github.com/ag-ui-protocol/ag-ui.git","type":"git"},"_npmVersion":"11.15.0","description":"AG-UI integration for Anthropic Claude Agent SDK","directories":{},"maintainers":[{"name":"_mme","email":"markus.ecker@gmail.com"},{"name":"copilotkit","email":"devops@copilotkit.ai"}],"sideEffects":false,"_nodeVersion":"22.23.2","dependencies":{"rxjs":"7.8.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.6","tsup":"^8.0.2","vitest":"^4.0.18","typescript":"^5.9.3","@ag-ui/core":"0.0.59","@types/node":"^20.11.19","@ag-ui/client":"0.0.59","@anthropic-ai/claude-agent-sdk":"^0.2.58"},"peerDependencies":{"zod":">=3.0.0","@ag-ui/core":">=0.0.42","@ag-ui/client":">=0.0.42","@anthropic-ai/sdk":">=0.50.0","@anthropic-ai/claude-agent-sdk":"^0.2.58"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/claude-agent-sdk_0.0.4_1789614536223_0.4003953451580349"}}},"time":{"created":"2026-04-24T20:05:18.339Z","modified":"2026-09-17T03:08:56.641Z","0.0.2-canary.1777061096.0":"2026-04-24T20:05:18.572Z","0.0.2":"2026-04-24T20:31:40.405Z","0.0.3":"2026-05-26T17:09:32.808Z","0.0.4":"2026-09-17T03:08:56.309Z"},"bugs":{"url":"https://github.com/ag-ui-protocol/ag-ui/issues"},"homepage":"https://github.com/ag-ui-protocol/ag-ui#readme","repository":{"url":"git+https://github.com/ag-ui-protocol/ag-ui.git","type":"git"},"description":"AG-UI integration for Anthropic Claude Agent SDK","maintainers":[{"name":"_mme","email":"markus.ecker@gmail.com"},{"name":"copilotkit","email":"devops@copilotkit.ai"}],"readme":"# @ag-ui/claude-agent-sdk\n\nImplementation of the AG-UI protocol for the Anthropic Claude Agent SDK (TypeScript).\n\n## Installation\n\n```bash\nnpm install @ag-ui/claude-agent-sdk @anthropic-ai/claude-agent-sdk zod\n```\n\n## Usage\n\nThe adapter manages the SDK lifecycle internally — just call `adapter.run(input)`:\n\n```typescript\nimport { ClaudeAgentAdapter } from \"@ag-ui/claude-agent-sdk\";\n\nconst adapter = new ClaudeAgentAdapter({\n  agentId: \"my_agent\",\n  model: \"claude-haiku-4-5\",\n  systemPrompt: \"You are helpful\",\n});\n\nconst events$ = adapter.run(input);\nevents$.subscribe({\n  next: (event) => sendEvent(event),\n  complete: () => res.end(),\n});\n```\n\n## Features\n\n- **Full lifecycle management** - Handles message extraction, option building, and SDK querying internally\n- **Interrupt support** - Call `adapter.interrupt()` to stop a running query\n- **Dynamic frontend tools** - Client-provided tools automatically added as MCP server\n- **Frontend tool halting** - Streams pause after frontend tool calls for client-side execution (human-in-the-loop)\n- **Streaming tool arguments** - Real-time TOOL_CALL_ARGS emission as JSON arguments stream in\n- **Bidirectional state sync** - Shared state management via ag_ui_update_state tool\n- **Context injection** - Context and state injected into prompts for agent awareness\n- **Event cleanup** - Hanging events (tool calls, reasoning blocks) automatically closed on stream end\n- **Observable pattern** - RxJS Observable for event streaming\n- **Custom tools via MCP** - Define custom tools using Claude SDK's tool() function\n- **Forwarded props** - Per-run option overrides with security whitelist\n\n## Examples\n\nThe integration includes 5 example agents:\n\n| Route | Description | Features |\n|-------|-------------|----------|\n| `/agentic_chat` | Basic conversational assistant | Simple chat |\n| `/backend_tool_rendering` | Weather tool (backend MCP) | Backend tool execution, tool rendering |\n| `/shared_state` | Recipe collaboration | Bidirectional state sync, ag_ui_update_state |\n| `/human_in_the_loop` | Task planning with approval | Frontend tools, step tracking, approval workflow |\n| `/tool_based_generative_ui` | Frontend tool rendering | Dynamic frontend tools, generative UI |\n\n## Running the Examples\n\n```bash\n# Install dependencies\ncd integrations/claude-agent-sdk/typescript\npnpm install\n\n# Start server (port 8889)\nANTHROPIC_API_KEY=sk-ant-xxx npx tsx examples/server.ts\n\n# Start Dojo (in another terminal)\ncd apps/dojo\npnpm dev\n```\n\nVisit **http://localhost:3000** and select **\"Claude Agent SDK (Typescript)\"**\n\n## Links\n\n- [Claude Agent SDK](https://platform.claude.com/docs/en/agent-sdk/typescript)\n- [AG-UI Documentation](https://docs.ag-ui.com/)\n- [AG-UI State Management](https://docs.ag-ui.com/concepts/state)\n","readmeFilename":"README.md","license":"MIT"}