@aws/agentcore 1.0.0-preview.9 → 1.0.0-rc.3

package/dist/assets/templates/agent-typescript-strands/package.json.template

@@ -0,0 +1,28 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "description": "AgentCore Runtime Application using Strands TypeScript SDK",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/main.js",
+    "dev": "tsx watch main.ts"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "~1.9.0",
+    "@strands-agents/sdk": "~1.5.0",
+    "bedrock-agentcore": "~0.3.0",
+    "tsx": "~4.19.0",
+    "zod": "~4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "~22.0.0",
+    "typescript": "~5.6.0"
+  },
+  "overrides": {
+    "bedrock-agentcore": {
+      "@strands-agents/sdk": "$@strands-agents/sdk"
+    }
+  }
+}

package/dist/assets/templates/agent-typescript-strands/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": false,
+    "sourceMap": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "types": ["node"]
+  },
+  "include": ["**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/dist/assets/templates/agent-typescript-vercel/README.md

@@ -0,0 +1,22 @@
+This is a project generated by the AgentCore CLI!
+
+# Layout
+
+The generated application code lives at the agent root directory. At the root, there is a `.gitignore` file, an
+`agentcore/` folder which represents the configurations and state associated with this project. Other `agentcore`
+commands like `deploy`, `dev`, and `invoke` rely on the configuration stored here.
+
+## Agent Root
+
+The main entrypoint to your app is defined in `main.ts`. Using the AgentCore SDK `BedrockAgentCoreApp`, this file
+defines an HTTP server that streams tokens from Amazon Bedrock via the Vercel AI SDK's `streamText` API.
+
+# Developing locally
+
+If installation was successful, `node_modules/` is already populated with dependencies.
+
+`agentcore project dev` will start a local server using `tsx watch main.ts` for hot reload on 0.0.0.0:8080.
+
+# Deployment
+
+After providing credentials, `agentcore project deploy` will deploy your project into Amazon Bedrock AgentCore.

package/dist/assets/templates/agent-typescript-vercel/gitignore.template

@@ -0,0 +1,22 @@
+# Environment variables
+.env
+.env.*
+
+# Node
+node_modules/
+dist/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db

package/dist/assets/templates/agent-typescript-vercel/main.ts

@@ -0,0 +1,35 @@
+import { BedrockAgentCoreApp } from 'bedrock-agentcore/runtime';
+import { createAmazonBedrock } from '@ai-sdk/amazon-bedrock';
+import { fromNodeProviderChain } from '@aws-sdk/credential-providers';
+import { streamText } from 'ai';
+import { z } from 'zod';
+
+const SYSTEM_PROMPT = `You are a helpful assistant.`;
+
+const bedrock = createAmazonBedrock({
+  region: process.env.AWS_REGION ?? 'us-east-1',
+  credentialProvider: fromNodeProviderChain(),
+});
+
+const requestSchema = z.object({
+  prompt: z.string().default(''),
+});
+
+const app = new BedrockAgentCoreApp({
+  invocationHandler: {
+    requestSchema,
+    async *process(payload) {
+      const result = streamText({
+        model: bedrock('global.anthropic.claude-sonnet-4-5-20250929-v1:0'),
+        system: SYSTEM_PROMPT,
+        prompt: payload.prompt,
+      });
+
+      for await (const chunk of result.textStream) {
+        yield { data: chunk };
+      }
+    },
+  },
+});
+
+app.run({ port: parseInt(process.env.PORT ?? '8080') });

package/dist/assets/templates/agent-typescript-vercel/package.json.template

@@ -0,0 +1,24 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "description": "AgentCore Runtime Application using the Vercel AI SDK",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/main.js",
+    "dev": "tsx watch main.ts"
+  },
+  "dependencies": {
+    "@ai-sdk/amazon-bedrock": "~4.0.0",
+    "@aws-sdk/credential-providers": "~3.1126.0",
+    "ai": "~6.0.0",
+    "bedrock-agentcore": "~0.3.0",
+    "tsx": "~4.19.0",
+    "zod": "~4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "~22.0.0",
+    "typescript": "~5.6.0"
+  }
+}

package/dist/assets/templates/agent-typescript-vercel/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": false,
+    "sourceMap": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "types": ["node"]
+  },
+  "include": ["**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/dist/assets/templates/agui-python-strands/README.md

@@ -0,0 +1,39 @@
+# {{ name }}
+
+An AG-UI agent deployed on Amazon Bedrock AgentCore using the Strands SDK.
+
+## Overview
+
+This agent speaks the [AG-UI protocol](https://docs.ag-ui.com/introduction), which
+streams agent-to-UI events over HTTP. It exposes an `/invocations` endpoint that accepts
+an AG-UI `RunAgentInput` body and streams the response back as AG-UI server-sent events,
+matching the AgentCore Runtime HTTP service contract.
+
+## Adding Tools
+
+Define tools with the `@tool` decorator in `main.py` and add them to the agent's `tools` list:
+
+```python
+@tool
+def my_tool(param: str) -> str:
+    """Description of what the tool does."""
+    return f"Result: {param}"
+```
+
+## Developing locally
+
+`agentcore project dev` starts the agent locally on `0.0.0.0:8080`. Post an AG-UI
+`RunAgentInput` body to `http://127.0.0.1:8080/invocations` to invoke it, and check its
+health at `http://127.0.0.1:8080/ping`.
+
+## Deployment
+
+`agentcore project deploy` deploys the agent into Amazon Bedrock AgentCore. Invoke the deployed
+runtime with an AG-UI `RunAgentInput` payload:
+
+```bash
+agentcore project invoke runtime --name agui_python_strands \
+  --payload '{"threadId":"t1","runId":"r1","state":{},"messages":[{"id":"m1","role":"user","content":"Hello!"}],"tools":[],"context":[],"forwardedProps":{}}'
+```
+
+The response streams back as AG-UI server-sent events.

package/dist/assets/{python/a2a/strands/base → templates/agui-python-strands}/gitignore.template

@@ -38,4 +38,4 @@ env/
 
 # OS
 .DS_Store
-Thumbs.db
+Thumbs.db

package/dist/assets/{python/agui/strands/base → templates/agui-python-strands}/main.py

@@ -1,16 +1,10 @@
 import os
 
-# Suppress OpenTelemetry warnings during local development; remove for production
-if os.getenv("LOCAL_DEV") == "1":
-    os.environ["OTEL_SDK_DISABLED"] = "true"
-
 import uvicorn
 from strands import Agent, tool
 from ag_ui_strands import StrandsAgent, StrandsAgentConfig, create_strands_app
 from model.load import load_model
-{{#if hasMemory}}
 from memory.session import get_memory_session_manager
-{{/if}}
 
 
 @tool
@@ -19,24 +13,27 @@ def add_numbers(a: int, b: int) -> int:
     return a + b
 
 
-tools = [add_numbers]
-
 agent = Agent(
     model=load_model(),
     system_prompt="You are a helpful assistant. Use tools when appropriate.",
-    tools=tools,
+    tools=[add_numbers],
 )
 
-{{#if hasMemory}}
+# The AG-UI protocol carries a per-conversation thread_id; each thread gets its
+# own session manager so history is scoped to the conversation. Returns None
+# (in-process history only) until the deployed MEMORY_ID env var is set.
 def session_manager_provider(input_data):
     return get_memory_session_manager(input_data.thread_id, "default-user")
 
+
 config = StrandsAgentConfig(session_manager_provider=session_manager_provider)
-{{else}}
-config = StrandsAgentConfig()
-{{/if}}
 
-agui_agent = StrandsAgent(agent=agent, name="{{ name }}", description="A helpful assistant", config=config)
+agui_agent = StrandsAgent(
+    agent=agent, name="{{ name }}", description="A helpful assistant", config=config
+)
+
+# create_strands_app publishes the AG-UI endpoint at /invocations and a health
+# check at /ping, matching the AgentCore Runtime HTTP service contract on 8080.
 app = create_strands_app(agui_agent, path="/invocations", ping_path="/ping")
 
 if __name__ == "__main__":

package/dist/assets/templates/agui-python-strands/memory/session.py

@@ -0,0 +1,35 @@
+import os
+import uuid
+from typing import Optional
+
+from bedrock_agentcore.memory.integrations.strands.config import AgentCoreMemoryConfig, RetrievalConfig
+from bedrock_agentcore.memory.integrations.strands.session_manager import AgentCoreMemorySessionManager
+
+MEMORY_ID = os.getenv("{{memoryEnvVarName}}")
+REGION = os.getenv("AWS_REGION")
+
+
+def get_memory_session_manager(
+    session_id: Optional[str], actor_id: str
+) -> Optional[AgentCoreMemorySessionManager]:
+    if not MEMORY_ID:
+        return None
+
+    session_id = session_id or uuid.uuid4().hex
+
+    retrieval_config = {
+        f"/users/{actor_id}/facts": RetrievalConfig(top_k=3, relevance_score=0.5),
+        f"/users/{actor_id}/preferences": RetrievalConfig(top_k=3, relevance_score=0.5),
+        f"/episodes/{actor_id}/{session_id}": RetrievalConfig(top_k=5, relevance_score=0.5),
+        f"/summaries/{actor_id}": RetrievalConfig(top_k=3, relevance_score=0.5),
+    }
+
+    return AgentCoreMemorySessionManager(
+        AgentCoreMemoryConfig(
+            memory_id=MEMORY_ID,
+            session_id=session_id,
+            actor_id=actor_id,
+            retrieval_config=retrieval_config,
+        ),
+        REGION,
+    )

package/dist/assets/templates/agui-python-strands/model/load.py

@@ -0,0 +1,6 @@
+from strands.models.bedrock import BedrockModel
+
+
+def load_model() -> BedrockModel:
+    """Get Bedrock model client using IAM credentials."""
+    return BedrockModel(model_id="global.anthropic.claude-sonnet-4-5-20250929-v1:0")

package/dist/assets/templates/agui-python-strands/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling ~= 1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "{{ name }}"
+version = "0.1.0"
+description = "AgentCore AG-UI Agent using Strands SDK"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "ag-ui-strands >= 0.3.0, < 0.4.0",
+    "ag-ui-protocol >= 0.1.19, < 0.2.0",
+    "aws-opentelemetry-distro ~= 0.18.0",
+    "bedrock-agentcore ~= 1.9.1",
+    "botocore[crt] ~= 1.43.0",
+    "strands-agents ~= 1.15.0",
+    "uvicorn >= 0.34.3, < 1.0.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]

package/dist/assets/{python/http/strands/base → templates/export-harness-python}/README.md

@@ -13,6 +13,12 @@ file defines a Starlette ASGI app with the chosen Agent framework SDK running wi
 
 `model/load.py` instantiates your chosen model provider.
 
+## Input Validation
+
+Validate invocation input before forwarding it to Strands. Keep plain prompts typed as strings. If the app accepts a
+caller-supplied message history, retain `strip_trailing_tool_use()`, which normalizes the history tail before
+invoking the agent.
+
 ## Environment Variables
 
 | Variable | Required | Description |
@@ -24,16 +30,17 @@ file defines a Starlette ASGI app with the chosen Agent framework SDK running wi
 
 If installation was successful, a virtual environment is already created with dependencies installed.
 
-Run `source .venv/bin/activate` before developing.
-
-`agentcore dev` will start a local server on 0.0.0.0:8080.
+Activate the environment with `source .venv/bin/activate` on macOS/Linux, `.venv\Scripts\activate.bat` in Windows
+Command Prompt, or `.\.venv\Scripts\activate.ps1` in Windows PowerShell.
 
-In a new terminal, you can invoke that server with:
-
-`agentcore invoke --dev "What can you do"`
+`agentcore project dev` will start a local server on 0.0.0.0:8080.
 
 # Deployment
 
-After providing credentials, `agentcore deploy` will deploy your project into Amazon Bedrock AgentCore.
+After providing credentials, `agentcore project deploy` will deploy your project into Amazon Bedrock AgentCore.
+
+Invoke the deployed Runtime with its native payload:
 
-Use `agentcore invoke` to invoke your deployed agent.
+```bash
+agentcore project invoke runtime --payload '{"prompt":"Hello!"}'
+```

package/dist/assets/templates/export-harness-python/gitignore.template

@@ -0,0 +1,41 @@
+# Environment variables
+.env
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db