{"_id":"@agent-dispatch/adapter-aws-agentcore","_rev":"3-7d43d0882a356d24af197440f1599f67","name":"@agent-dispatch/adapter-aws-agentcore","dist-tags":{"latest":"0.1.5"},"versions":{"0.1.0":{"name":"@agent-dispatch/adapter-aws-agentcore","version":"0.1.0","license":"Apache-2.0","_id":"@agent-dispatch/adapter-aws-agentcore@0.1.0","maintainers":[{"name":"vamgan","email":"vamilg@gmail.com"}],"homepage":"https://github.com/agent-dispatch/adapter-aws-agentcore#readme","bugs":{"url":"https://github.com/agent-dispatch/adapter-aws-agentcore/issues"},"dist":{"shasum":"b0937745b694db06d8653c100c21c51d6a86f642","tarball":"https://registry.npmjs.org/@agent-dispatch/adapter-aws-agentcore/-/adapter-aws-agentcore-0.1.0.tgz","fileCount":5,"integrity":"sha512-Hf7maonk1mIlP1ywKnwKMWs9EAIyrttIyxk4Gqk/LqV6BIAK6OBCKVchZjNXv8AyK2FuLA6rCpPCNrWvOk4I8A==","signatures":[{"sig":"MEUCIGpfqz2C1nuqHqCO943mlDGrs8mNYmJvup7VA/VRgqnaAiEA/Ar6WEUfVaE3d5bff1ZWwdwJPgEtmnW0efPkIvl+FUg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21281},"type":"module","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"af027c11a8d79c8f7c74e6e0fd6221e488d4b8de","scripts":{"test":"vitest run","build":"tsup src/index.ts --format esm --dts --clean","typecheck":"tsc --noEmit"},"_npmUser":{"name":"vamgan","email":"vamilg@gmail.com"},"repository":{"url":"git+https://github.com/agent-dispatch/adapter-aws-agentcore.git","type":"git"},"_npmVersion":"10.9.4","description":"AWS Bedrock AgentCore backend adapter for AgentDispatch.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"@aws-sdk/client-bedrock-agentcore":"^3.1045.0","@aws-sdk/client-bedrock-agentcore-control":"^3.1045.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","typescript":"^5.7.3","@types/node":"^22.10.2","@agent-dispatch/core":"^0.1.0"},"peerDependencies":{"@agent-dispatch/core":"^0.1.0"},"_npmOperationalInternal":{"tmp":"tmp/adapter-aws-agentcore_0.1.0_1778458542884_0.8653835045384537","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agent-dispatch/adapter-aws-agentcore","version":"0.1.1","license":"Apache-2.0","_id":"@agent-dispatch/adapter-aws-agentcore@0.1.1","maintainers":[{"name":"vamgan","email":"vamilg@gmail.com"}],"homepage":"https://github.com/agent-dispatch/adapter-aws-agentcore#readme","bugs":{"url":"https://github.com/agent-dispatch/adapter-aws-agentcore/issues"},"dist":{"shasum":"275c46d6ff335a0c1250e99d0f0a90bc84d1fee0","tarball":"https://registry.npmjs.org/@agent-dispatch/adapter-aws-agentcore/-/adapter-aws-agentcore-0.1.1.tgz","fileCount":5,"integrity":"sha512-2uRixxy9ydVm6SX7ZcVJxq4M3ijF7xuZjomGAWccoslR/15J21v37NjwwsoYE0TSWR3qzmN+phRguXWsQCw8CQ==","signatures":[{"sig":"MEUCIAGj5xpbut91BGTJYdrBJe70Z9rs5KEDScWBwaona/1xAiEAuXDVbe6v3XoCQV5gzDg5OpFs9PBz0m0T7hZTID91Q8Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23919},"type":"module","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"8ddbca69d89f5034c20eee8c992561b337fd8676","scripts":{"test":"vitest run","build":"tsup src/index.ts --format esm --dts --clean","typecheck":"tsc --noEmit"},"_npmUser":{"name":"vamgan","email":"vamilg@gmail.com"},"repository":{"url":"git+https://github.com/agent-dispatch/adapter-aws-agentcore.git","type":"git"},"_npmVersion":"11.11.0","description":"AWS Bedrock AgentCore backend adapter for AgentDispatch.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"@aws-sdk/client-bedrock-agentcore":"^3.1045.0","@aws-sdk/client-bedrock-agentcore-control":"^3.1045.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.5","vitest":"^2.1.8","typescript":"^5.7.3","@types/node":"^22.10.2","@agent-dispatch/core":"^0.1.0"},"peerDependencies":{"@agent-dispatch/core":"^0.1.0"},"_npmOperationalInternal":{"tmp":"tmp/adapter-aws-agentcore_0.1.1_1778459812530_0.7891427308069583","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@agent-dispatch/adapter-aws-agentcore","version":"0.1.5","description":"AWS Bedrock AgentCore backend adapter for AgentDispatch.","keywords":["agentdispatch","aws","bedrock-agentcore","agentcore","mcp","cloud-agents","subagents","agent-orchestration"],"type":"module","license":"Apache-2.0","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsup src/index.ts --format esm --dts --clean","test":"vitest run","typecheck":"tsc --noEmit"},"peerDependencies":{"@agent-dispatch/core":"^0.1.0"},"dependencies":{"@aws-sdk/client-bedrock-agentcore":"^3.1045.0","@aws-sdk/client-bedrock-agentcore-control":"^3.1045.0"},"devDependencies":{"@agent-dispatch/core":"^0.1.0","@types/node":"^22.10.2","tsup":"^8.3.5","typescript":"^5.7.3","vitest":"^4.1.7"},"repository":{"type":"git","url":"git+https://github.com/agent-dispatch/adapter-aws-agentcore.git"},"bugs":{"url":"https://github.com/agent-dispatch/adapter-aws-agentcore/issues"},"homepage":"https://github.com/agent-dispatch/adapter-aws-agentcore#readme","publishConfig":{"access":"public"},"engines":{"node":">=20.19"},"gitHead":"9e3b6f34ecc0110c10c329932e4c977c6197137d","_id":"@agent-dispatch/adapter-aws-agentcore@0.1.5","_nodeVersion":"24.16.0","_npmVersion":"11.13.0","dist":{"integrity":"sha512-wFf4Wg7L2zCCFlvh+AU+HplfGONXH4Tr1ulgkjgHJuUsykUuAQKcNT2sXvG8Fa6csxYMFlzY5nPqLdTMB+SUvA==","shasum":"1eec848777c4571796f78569905603f53b5b2cf8","tarball":"https://registry.npmjs.org/@agent-dispatch/adapter-aws-agentcore/-/adapter-aws-agentcore-0.1.5.tgz","fileCount":5,"unpackedSize":43900,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@agent-dispatch%2fadapter-aws-agentcore@0.1.5","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDLfb7bqko/MkuhmUDThSEjN/mLCQ0RxTbRJyrA9WTN0QIgMKBPRXs7G1HV22ds1wXa34CMVxegFPC+Vz3YBsp8eGo="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7b3bc994-f6ef-4978-b7b6-731a9d93228c"}},"directories":{},"maintainers":[{"name":"vamgan","email":"vamilg@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/adapter-aws-agentcore_0.1.5_1780205515980_0.8180486667702183"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-11T00:15:42.775Z","modified":"2026-05-31T05:31:56.547Z","0.1.0":"2026-05-11T00:15:43.026Z","0.1.1":"2026-05-11T00:36:52.642Z","0.1.5":"2026-05-31T05:31:56.182Z"},"bugs":{"url":"https://github.com/agent-dispatch/adapter-aws-agentcore/issues"},"license":"Apache-2.0","homepage":"https://github.com/agent-dispatch/adapter-aws-agentcore#readme","repository":{"type":"git","url":"git+https://github.com/agent-dispatch/adapter-aws-agentcore.git"},"description":"AWS Bedrock AgentCore backend adapter for AgentDispatch.","maintainers":[{"name":"vamgan","email":"vamilg@gmail.com"}],"readme":"# @agent-dispatch/adapter-aws-agentcore\n\n[![npm](https://img.shields.io/npm/v/@agent-dispatch/adapter-aws-agentcore.svg)](https://www.npmjs.com/package/@agent-dispatch/adapter-aws-agentcore)\n[![CI](https://github.com/agent-dispatch/adapter-aws-agentcore/actions/workflows/ci.yml/badge.svg)](https://github.com/agent-dispatch/adapter-aws-agentcore/actions/workflows/ci.yml)\n[![license](https://img.shields.io/npm/l/@agent-dispatch/adapter-aws-agentcore.svg)](https://www.npmjs.com/package/@agent-dispatch/adapter-aws-agentcore)\n\n- `provider: \"aws\"`\n- `capability: \"agent-runtime\"`\n- `taskType: \"agent.run\"` through `InvokeAgentRuntime`\n- `taskType: \"command.run\"` through `InvokeAgentRuntimeCommand`\n- target modes `session` and `runtime`\n\nAWS AgentCore runtime adapter for AgentDispatch. This is the first production adapter: it lets a lead agent call one MCP tool, spawn an AWS-hosted cloud subagent, poll durable status, and continue interaction through returned runtime metadata.\n\n## Supported capabilities\n\n- Provider: `aws`\n- Capability: `agent-runtime`\n- Task types: `agent.run`, `command.run`\n- Target modes:\n  - `session` — invoke a configured AgentCore runtime ARN and create/use an isolated runtime session.\n  - `runtime` — create an AgentCore runtime from a prebuilt ECR image, run the task, and clean up by default.\n- Runtime protocols: `a2a`, `mcp`, `ag-ui`, `http`\n\n## How it maps to AgentCore\n\nAgentDispatch request | AWS AgentCore behavior\n--- | ---\n`agent.run` | Invokes the runtime with a structured agent instruction payload.\n`command.run` | Invokes the runtime with a command payload for worker-style tasks.\n`target.mode = \"session\"` | Uses an existing `runtimeArn` from adapter config or target details.\n`target.mode = \"runtime\"` | Creates runtime resources from `ecrImageUri` and `executionRoleArn`.\n`protocol = \"a2a\"` | Configures runtime protocol hints and maps the first agent message to JSON-RPC `message/send`.\n`get_task_logs` | Reads provider-neutral event mappings from AgentCore streaming chunks.\n\n## Configuration\n\nUse standard AWS credentials outside MCP, for example AWS SDK default credentials, SSO, environment variables, or role-based credentials.\n\n```json\n{\n  \"accounts\": {\n    \"dev-aws\": {\n      \"provider\": \"aws\",\n      \"region\": \"us-west-2\",\n      \"credentialSource\": \"aws-sdk-default\"\n    }\n  },\n  \"adapters\": {\n    \"aws-agentcore\": {\n      \"region\": \"us-west-2\",\n      \"runtimeArn\": \"arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/my-runtime\",\n      \"protocol\": \"a2a\"\n    }\n  }\n}\n```\n\nRuntime provisioning mode:\n\n```json\n{\n  \"adapters\": {\n    \"aws-agentcore\": {\n      \"region\": \"us-west-2\",\n      \"ecrImageUri\": \"123456789012.dkr.ecr.us-west-2.amazonaws.com/agentdispatch-worker:latest\",\n      \"executionRoleArn\": \"arn:aws:iam::123456789012:role/AgentDispatchAgentCoreRole\",\n      \"protocol\": \"a2a\"\n    }\n  }\n}\n```\n\n## Spawn from MCP\n\n```json\n{\n  \"provider\": \"aws\",\n  \"account_profile\": \"dev-aws\",\n  \"capability\": \"agent-runtime\",\n  \"task_type\": \"agent.run\",\n  \"target\": {\n    \"mode\": \"session\",\n    \"protocol\": \"a2a\"\n  },\n  \"input\": {\n    \"instruction\": \"Review this pull request and produce a risk report.\",\n    \"model\": {\n      \"id\": \"anthropic.claude-3-5-sonnet-20241022-v2:0\"\n    },\n    \"tools\": [\n      {\n        \"name\": \"repo_search\",\n        \"description\": \"Search indexed repository files.\"\n      }\n    ]\n  }\n}\n```\n\nThe response includes `cloud_agent` details such as protocol, provider, runtime session ID, runtime ARN, AgentCore invocation URL, A2A Agent Card URL, and the required session header. A lead agent can use that data to continue with A2A where supported by the runtime.\n\n## Continue With A2A\n\nUse `sendAwsAgentCoreA2AMessage` when you want the lead agent or application code to continue the same AgentCore runtime session after `spawn_cloud_agent` returns:\n\n```ts\nimport { sendAwsAgentCoreA2AMessage } from \"@agent-dispatch/adapter-aws-agentcore\";\n\nconst followUp = await sendAwsAgentCoreA2AMessage(task.cloudAgent!, {\n  text: \"Continue the investigation and focus on IAM findings.\"\n});\n\nconsole.log(followUp.text);\n```\n\nThe helper uses the AWS SDK default credential chain. It reads `agentRuntimeArn`, `runtimeSessionId`, `qualifier`, content type, and accept headers from `cloudAgent.invocation`, sends a JSON-RPC `message/send` payload through `InvokeAgentRuntime`, and returns normalized text plus metadata.\n\n## Worker image\n\nFor a ready reference runtime, use `@agent-dispatch/worker-agentcore`. It exposes health, Agent Card discovery, and A2A JSON-RPC `message/send` endpoints suitable for AgentCore runtime experiments.\n\n## Development\n\n```bash\nnpm install\nnpm run typecheck\nnpm test\nnpm run build\n```\n\nSee the [release workflow](https://github.com/agent-dispatch/adapter-aws-agentcore/blob/main/docs/release.md) for npm Trusted Publisher setup, provenance publishing, and upstream package order.\n","readmeFilename":"README.md","keywords":["agentdispatch","aws","bedrock-agentcore","agentcore","mcp","cloud-agents","subagents","agent-orchestration"]}