Bedrock AgentCore SDK for TypeScript

Deploy AI agents to AWS with VM-level isolation and zero infrastructure

--- ## Why AgentCore? - **Zero infrastructure** — No servers to provision, no containers to manage, no scaling to configure. - **Session isolation** — Each agent session runs in its own VM. No shared state, no noisy neighbors. - **Long-lived sessions** — Sessions persist across requests. Your agent maintains context without external storage. - **Managed tools** — Secure code execution and browser automation, ready to use. - **Credential management** — Centralized API keys and OAuth tokens, injected at runtime. ### Framework Compatibility The SDK is designed to work with any agent framework. Here's how: - **Runtime** — Deploy agents built with any framework. The `BedrockAgentCoreApp` accepts any request handler — plug in [Strands Agents](https://strandsagents.com), [Vercel AI SDK](https://ai-sdk.dev), [LangChain](https://js.langchain.com), or your own custom logic. - **Tools** — Code Interpreter and Browser tools include built-in integrations for [Strands Agents](https://strandsagents.com) and [Vercel AI SDK](https://ai-sdk.dev), so tools can be passed directly to those frameworks' agents. For other frameworks, use the core clients (`CodeInterpreter`, `PlaywrightBrowser`) directly and wire them into your own tool definitions. - **Identity** — Credential wrappers (`withAccessToken`, `withApiKey`) work with any async function, regardless of framework. --- ## Quick Start ```bash npm install bedrock-agentcore @strands-agents/sdk ``` ```typescript import { BedrockAgentCoreApp } from 'bedrock-agentcore/runtime' import { Agent, BedrockModel } from '@strands-agents/sdk' import { z } from 'zod' const agent = new Agent({ model: new BedrockModel({ modelId: 'global.amazon.nova-2-lite-v1:0' }), }) const app = new BedrockAgentCoreApp({ invocationHandler: { requestSchema: z.object({ prompt: z.string() }), process: async function* (request) { for await (const event of agent.stream(request.prompt)) { if (event.type === 'modelContentBlockDeltaEvent' && event.delta?.type === 'textDelta') { yield { event: 'message', data: { text: event.delta.text } } } } }, }, }) app.run() ``` Use `requestSchema` to validate agent entrypoint input. Keep user prompts typed as strings and pass only prompt text to the agent framework. `BedrockAgentCoreApp` creates an AgentCore Runtime-compliant server—handling request parsing, streaming responses, and session management for seamless deployment. --- ## Tools Give your agent secure code execution with three lines: ```typescript import { CodeInterpreterTools } from 'bedrock-agentcore/experimental/code-interpreter/strands' import { Agent, BedrockModel } from '@strands-agents/sdk' const codeInterpreter = new CodeInterpreterTools({ region: 'us-east-1' }) const agent = new Agent({ model: new BedrockModel({ modelId: 'global.amazon.nova-2-lite-v1:0' }), tools: codeInterpreter.tools, }) // Agent can now execute code in a secure sandboxed environment ``` --- ## Features - **Runtime** — Secure, session-isolated compute → [Examples](https://github.com/awslabs/bedrock-agentcore-samples-typescript/tree/main/primitives/runtime) - **Code Interpreter** — Execute Python/JS/TS in a sandbox → [Examples](https://github.com/awslabs/bedrock-agentcore-samples-typescript/tree/main/primitives/tools/code-interpreter) - **Browser** — Cloud-based web automation → [Examples](https://github.com/awslabs/bedrock-agentcore-samples-typescript/tree/main/primitives/tools/browser) - **Identity** — Manage API keys and OAuth tokens → [Examples](https://github.com/awslabs/bedrock-agentcore-samples-typescript/tree/main/primitives/identity) - **Memory** — Persistent knowledge across sessions → [Guide](docs/MEMORY.md) - **Gateway** — Transform APIs into MCP tools (coming soon) - **Observability** — OpenTelemetry tracing (coming soon) --- ## Installation ```bash npm install bedrock-agentcore ``` **Prerequisites:** Node.js 20+, [AWS credentials](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html), [AgentCore access](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/agentcore-regions.html) --- ## Deployment - [Sample Applications](https://github.com/awslabs/bedrock-agentcore-samples-typescript) — Working examples with deployment templates - [CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/AWS_BedrockAgentCore.html) — Infrastructure as code - [AWS CDK](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_bedrockagentcore-readme.html) — Infrastructure as code - [Deployment Guide](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/getting-started-custom.html) — Step-by-step walkthrough --- ## Resources - [AgentCore Documentation](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/what-is-bedrock-agentcore.html) - [Python SDK](https://github.com/aws/bedrock-agentcore-sdk-python) --- ## License Apache 2.0 — see [LICENSE](LICENSE) [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md)