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

package/dist/assets/python/a2a/strands/base/README.md

@@ -1,22 +0,0 @@
-# {{ name }}
-
-An A2A (Agent-to-Agent) agent deployed on Amazon Bedrock AgentCore using Strands SDK.
-
-## Overview
-
-This agent implements the A2A protocol, enabling agent-to-agent communication. Other agents can discover and interact with this agent via the `/.well-known/agent-card.json` endpoint.
-
-## Local Development
-
-```bash
-uv sync
-uv run python main.py
-```
-
-The agent starts on port 9000.
-
-## Deploy
-
-```bash
-agentcore deploy
-```

package/dist/assets/python/a2a/strands/base/main.py

@@ -1,107 +0,0 @@
-from strands import Agent, tool
-from strands.multiagent.a2a.executor import StrandsA2AExecutor
-from bedrock_agentcore.runtime import serve_a2a
-from model.load import load_model
-{{#if hasMemory}}
-from memory.session import get_memory_session_manager
-{{/if}}
-{{#if sessionStorageMountPath}}
-import os
-{{/if}}
-
-
-@tool
-def add_numbers(a: int, b: int) -> int:
-    """Return the sum of two numbers."""
-    return a + b
-
-
-tools = [add_numbers]
-
-{{#if sessionStorageMountPath}}
-SESSION_STORAGE_PATH = "{{sessionStorageMountPath}}"
-
-def _safe_resolve(path: str) -> str:
-    """Resolve path safely within the storage boundary."""
-    resolved = os.path.realpath(os.path.join(SESSION_STORAGE_PATH, path.lstrip("/")))
-    if not resolved.startswith(os.path.realpath(SESSION_STORAGE_PATH)):
-        raise ValueError(f"Path '{path}' is outside the storage boundary")
-    return resolved
-
-@tool
-def file_read(path: str) -> str:
-    """Read a file from persistent storage. The path is relative to the storage root."""
-    try:
-        full_path = _safe_resolve(path)
-        with open(full_path) as f:
-            return f.read()
-    except ValueError as e:
-        return str(e)
-    except OSError as e:
-        return f"Error reading '{path}': {e.strerror}"
-
-@tool
-def file_write(path: str, content: str) -> str:
-    """Write content to a file in persistent storage. The path is relative to the storage root."""
-    try:
-        full_path = _safe_resolve(path)
-        parent = os.path.dirname(full_path)
-        if parent:
-            os.makedirs(parent, exist_ok=True)
-        with open(full_path, "w") as f:
-            f.write(content)
-        return f"Written to {path}"
-    except ValueError as e:
-        return str(e)
-    except OSError as e:
-        return f"Error writing '{path}': {e.strerror}"
-
-@tool
-def list_files(directory: str = "") -> str:
-    """List files in persistent storage. The directory is relative to the storage root."""
-    try:
-        target = _safe_resolve(directory)
-        entries = os.listdir(target)
-        return "\n".join(entries) if entries else "(empty directory)"
-    except ValueError as e:
-        return str(e)
-    except OSError as e:
-        return f"Error listing '{directory}': {e.strerror}"
-
-tools.extend([file_read, file_write, list_files])
-{{/if}}
-
-SYSTEM_PROMPT = """
-You are a helpful assistant. Use tools when appropriate.
-{{#if sessionStorageMountPath}}
-You have persistent storage at {{sessionStorageMountPath}}. Use file tools to read and write files. Data persists across sessions.
-{{/if}}
-"""
-
-{{#if hasMemory}}
-def agent_factory():
-    cache = {}
-    def get_or_create_agent(session_id, user_id):
-        key = f"{session_id}/{user_id}"
-        if key not in cache:
-            cache[key] = Agent(
-                model=load_model(),
-                session_manager=get_memory_session_manager(session_id, user_id),
-                system_prompt=SYSTEM_PROMPT,
-                tools=tools,
-            )
-        return cache[key]
-    return get_or_create_agent
-
-get_or_create_agent = agent_factory()
-agent = get_or_create_agent("default-session", "default-user")
-{{else}}
-agent = Agent(
-    model=load_model(),
-    system_prompt=SYSTEM_PROMPT,
-    tools=tools,
-)
-{{/if}}
-
-if __name__ == "__main__":
-    serve_a2a(StrandsA2AExecutor(agent))

package/dist/assets/python/a2a/strands/base/model/load.py

@@ -1,123 +0,0 @@
-{{#if (eq modelProvider "Bedrock")}}
-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")
-{{/if}}
-{{#if (eq modelProvider "Anthropic")}}
-import os
-
-from strands.models.anthropic import AnthropicModel
-from bedrock_agentcore.identity.auth import requires_api_key
-
-IDENTITY_PROVIDER_NAME = "{{identityProviders.[0].name}}"
-IDENTITY_ENV_VAR = "{{identityProviders.[0].envVarName}}"
-
-
-@requires_api_key(provider_name=IDENTITY_PROVIDER_NAME)
-def _agentcore_identity_api_key_provider(api_key: str) -> str:
-    """Fetch API key from AgentCore Identity."""
-    return api_key
-
-
-def _get_api_key() -> str:
-    """
-    Uses AgentCore Identity for API key management in deployed environments.
-    For local development, run via 'agentcore dev' which loads agentcore/.env.
-    """
-    if os.getenv("LOCAL_DEV") == "1":
-        api_key = os.getenv(IDENTITY_ENV_VAR)
-        if not api_key:
-            raise RuntimeError(
-                f"{IDENTITY_ENV_VAR} not found. Add {IDENTITY_ENV_VAR}=your-key to .env.local"
-            )
-        return api_key
-    return _agentcore_identity_api_key_provider()
-
-
-def load_model() -> AnthropicModel:
-    """Get authenticated Anthropic model client."""
-    return AnthropicModel(
-        client_args={"api_key": _get_api_key()},
-        model_id="claude-sonnet-4-5-20250929",
-        max_tokens=5000,
-    )
-{{/if}}
-{{#if (eq modelProvider "OpenAI")}}
-import os
-
-from strands.models.openai import OpenAIModel
-from bedrock_agentcore.identity.auth import requires_api_key
-
-IDENTITY_PROVIDER_NAME = "{{identityProviders.[0].name}}"
-IDENTITY_ENV_VAR = "{{identityProviders.[0].envVarName}}"
-
-
-@requires_api_key(provider_name=IDENTITY_PROVIDER_NAME)
-def _agentcore_identity_api_key_provider(api_key: str) -> str:
-    """Fetch API key from AgentCore Identity."""
-    return api_key
-
-
-def _get_api_key() -> str:
-    """
-    Uses AgentCore Identity for API key management in deployed environments.
-    For local development, run via 'agentcore dev' which loads agentcore/.env.
-    """
-    if os.getenv("LOCAL_DEV") == "1":
-        api_key = os.getenv(IDENTITY_ENV_VAR)
-        if not api_key:
-            raise RuntimeError(
-                f"{IDENTITY_ENV_VAR} not found. Add {IDENTITY_ENV_VAR}=your-key to .env.local"
-            )
-        return api_key
-    return _agentcore_identity_api_key_provider()
-
-
-def load_model() -> OpenAIModel:
-    """Get authenticated OpenAI model client."""
-    return OpenAIModel(
-        client_args={"api_key": _get_api_key()},
-        model_id="gpt-4.1",
-    )
-{{/if}}
-{{#if (eq modelProvider "Gemini")}}
-import os
-
-from strands.models.gemini import GeminiModel
-from bedrock_agentcore.identity.auth import requires_api_key
-
-IDENTITY_PROVIDER_NAME = "{{identityProviders.[0].name}}"
-IDENTITY_ENV_VAR = "{{identityProviders.[0].envVarName}}"
-
-
-@requires_api_key(provider_name=IDENTITY_PROVIDER_NAME)
-def _agentcore_identity_api_key_provider(api_key: str) -> str:
-    """Fetch API key from AgentCore Identity."""
-    return api_key
-
-
-def _get_api_key() -> str:
-    """
-    Uses AgentCore Identity for API key management in deployed environments.
-    For local development, run via 'agentcore dev' which loads agentcore/.env.
-    """
-    if os.getenv("LOCAL_DEV") == "1":
-        api_key = os.getenv(IDENTITY_ENV_VAR)
-        if not api_key:
-            raise RuntimeError(
-                f"{IDENTITY_ENV_VAR} not found. Add {IDENTITY_ENV_VAR}=your-key to .env.local"
-            )
-        return api_key
-    return _agentcore_identity_api_key_provider()
-
-
-def load_model() -> GeminiModel:
-    """Get authenticated Gemini model client."""
-    return GeminiModel(
-        client_args={"api_key": _get_api_key()},
-        model_id="gemini-2.5-flash",
-    )
-{{/if}}

package/dist/assets/python/a2a/strands/base/pyproject.toml

@@ -1,23 +0,0 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "{{ name }}"
-version = "0.1.0"
-description = "AgentCore A2A Agent using Strands SDK"
-readme = "README.md"
-requires-python = ">=3.10"
-dependencies = [
-    {{#if (eq modelProvider "Anthropic")}}"anthropic >= 0.30.0",
-    {{/if}}"a2a-sdk[all] >= 0.2.0",
-    "aws-opentelemetry-distro",
-    "bedrock-agentcore[a2a] >= 1.0.3",
-    "botocore[crt] >= 1.35.0",
-    {{#if (eq modelProvider "Gemini")}}"google-genai >= 1.0.0",
-    {{/if}}{{#if (eq modelProvider "OpenAI")}}"openai >= 1.0.0",
-    {{/if}}"strands-agents >= 1.13.0",
-]
-
-[tool.hatch.build.targets.wheel]
-packages = ["."]

package/dist/assets/python/a2a/strands/capabilities/memory/session.py

@@ -1,43 +0,0 @@
-import os
-import uuid
-from typing import Optional
-
-from bedrock_agentcore.memory.integrations.strands.config import AgentCoreMemoryConfig{{#if memoryProviders.[0].strategies.length}}, RetrievalConfig{{/if}}
-from bedrock_agentcore.memory.integrations.strands.session_manager import AgentCoreMemorySessionManager
-
-MEMORY_ID = os.getenv("{{memoryProviders.[0].envVarName}}")
-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
-
-    # AgentCoreMemoryConfig rejects None; OAuth/CUSTOM_JWT callers can reach us
-    # without a runtime session header, so synthesize one when absent.
-    session_id = session_id or uuid.uuid4().hex
-
-{{#if memoryProviders.[0].strategies.length}}
-    retrieval_config = {
-{{#if (includes memoryProviders.[0].strategies "SEMANTIC")}}
-        f"/users/{actor_id}/facts": RetrievalConfig(top_k=3, relevance_score=0.5),
-{{/if}}
-{{#if (includes memoryProviders.[0].strategies "USER_PREFERENCE")}}
-        f"/users/{actor_id}/preferences": RetrievalConfig(top_k=3, relevance_score=0.5),
-{{/if}}
-{{#if (includes memoryProviders.[0].strategies "SUMMARIZATION")}}
-        f"/summaries/{actor_id}/{session_id}": RetrievalConfig(top_k=3, relevance_score=0.5),
-{{/if}}
-    }
-{{/if}}
-
-    return AgentCoreMemorySessionManager(
-        AgentCoreMemoryConfig(
-            memory_id=MEMORY_ID,
-            session_id=session_id,
-            actor_id=actor_id,
-{{#if memoryProviders.[0].strategies.length}}
-            retrieval_config=retrieval_config,
-{{/if}}
-        ),
-        REGION
-    )

package/dist/assets/python/agui/googleadk/base/README.md

@@ -1,30 +0,0 @@
-# {{ name }}
-
-An AG-UI agent deployed on Amazon Bedrock AgentCore using Google ADK.
-
-## Overview
-
-This agent implements the AG-UI protocol using Google's Agent Development Kit, enabling rich agent-user interaction via the AG-UI event stream.
-
-## Local Development
-
-```bash
-uv sync
-uv run python main.py
-```
-
-The agent starts on port 8080 and serves requests at `/invocations`.
-
-## Health Check
-
-```
-GET /ping
-```
-
-Returns `{"status": "healthy"}`.
-
-## Deploy
-
-```bash
-agentcore deploy
-```

package/dist/assets/python/agui/googleadk/base/gitignore.template

@@ -1,41 +0,0 @@
-# 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

package/dist/assets/python/agui/googleadk/base/main.py

@@ -1,31 +0,0 @@
-import os
-import uvicorn
-from google.adk.agents import LlmAgent
-from ag_ui_adk import ADKAgent, AGUIToolset, create_adk_app
-from model.load import load_model
-
-load_model()
-
-agent = LlmAgent(
-    name="{{ name }}",
-    model="gemini-2.5-flash",
-    instruction="You are a helpful assistant.",
-    tools=[AGUIToolset()],
-)
-
-adk_agent = ADKAgent(
-    adk_agent=agent,
-    app_name="{{ name }}",
-    use_in_memory_services=True,
-)
-
-app = create_adk_app(adk_agent, path="/invocations")
-
-
-@app.get("/ping")
-async def ping():
-    return {"status": "healthy"}
-
-
-if __name__ == "__main__":
-    uvicorn.run(app, host="0.0.0.0", port=int(os.environ.get("PORT", "8080")))

package/dist/assets/python/agui/googleadk/base/model/load.py

@@ -1,41 +0,0 @@
-import os
-from bedrock_agentcore.identity.auth import requires_api_key
-
-IDENTITY_PROVIDER_NAME = "{{identityProviders.[0].name}}"
-IDENTITY_ENV_VAR = "{{identityProviders.[0].envVarName}}"
-
-
-@requires_api_key(provider_name=IDENTITY_PROVIDER_NAME)
-def _agentcore_identity_api_key_provider(api_key: str) -> str:
-    """Fetch API key from AgentCore Identity."""
-    return api_key
-
-
-def _get_api_key() -> str:
-    """
-    Uses AgentCore Identity for API key management in deployed environments.
-    For local development, run via 'agentcore dev' which loads agentcore/.env.
-    """
-    if os.getenv("LOCAL_DEV") == "1":
-        api_key = os.getenv(IDENTITY_ENV_VAR)
-        if not api_key:
-            raise RuntimeError(
-                f"{IDENTITY_ENV_VAR} not found. Add {IDENTITY_ENV_VAR}=your-key to .env.local"
-            )
-        return api_key
-    return _agentcore_identity_api_key_provider()
-
-
-def load_model() -> None:
-    """
-    Set up Gemini API key authentication.
-    Uses AgentCore Identity for API key management in deployed environments,
-    and falls back to .env file for local development.
-    Sets the GOOGLE_API_KEY environment variable for the Google ADK.
-    """
-    api_key = _get_api_key()
-    # Use Google AI Studios API Key Authentication.
-    # https://google.github.io/adk-docs/agents/models/#google-ai-studio
-    os.environ["GOOGLE_API_KEY"] = api_key
-    # Set to TRUE is using Google Vertex AI, Set to FALSE for Google AI Studio
-    os.environ["GOOGLE_GENAI_USE_VERTEXAI"] = "FALSE"

package/dist/assets/python/agui/googleadk/base/pyproject.toml

@@ -1,24 +0,0 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "{{ name }}"
-version = "0.1.0"
-description = "AgentCore AG-UI Agent using Google ADK"
-readme = "README.md"
-requires-python = ">=3.10"
-dependencies = [
-    "ag-ui-adk >= 0.6.0",
-    "ag-ui-protocol >= 0.1.10",
-    "bedrock-agentcore >= 1.0.3",
-    "fastapi >= 0.115.12",
-    "google-adk >= 1.16.0",
-    "google-genai >= 1.0.0",
-    "opentelemetry-distro",
-    "opentelemetry-exporter-otlp",
-    "uvicorn >= 0.34.3",
-]
-
-[tool.hatch.build.targets.wheel]
-packages = ["."]

package/dist/assets/python/agui/langchain_langgraph/base/README.md

@@ -1,22 +0,0 @@
-# {{ name }}
-
-An AG-UI agent deployed on Amazon Bedrock AgentCore using LangChain + LangGraph.
-
-## Overview
-
-This agent implements the AG-UI protocol using LangGraph, enabling seamless frontend-to-agent communication with support for streaming, tool calls, and frontend-injected tools.
-
-## Local Development
-
-```bash
-uv sync
-uv run python main.py
-```
-
-The agent starts on port 8080.
-
-## Deploy
-
-```bash
-agentcore deploy
-```

package/dist/assets/python/agui/langchain_langgraph/base/gitignore.template

@@ -1,41 +0,0 @@
-# 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

package/dist/assets/python/agui/langchain_langgraph/base/main.py

@@ -1,74 +0,0 @@
-import os
-
-os.environ["LANGGRAPH_FAST_API"] = "true"
-
-import uvicorn
-from typing import Any, List
-from fastapi import FastAPI
-from fastapi.middleware.cors import CORSMiddleware
-from langgraph.graph import StateGraph, START
-from langgraph.graph.message import MessagesState
-from langgraph.checkpoint.memory import MemorySaver
-from langgraph.prebuilt import ToolNode, tools_condition
-from langchain_core.tools import tool
-from opentelemetry.instrumentation.langchain import LangchainInstrumentor
-from ag_ui_langgraph import LangGraphAgent, add_langgraph_fastapi_endpoint
-from model.load import load_model
-
-LangchainInstrumentor().instrument()
-
-
-@tool
-def add_numbers(a: int, b: int) -> int:
-    """Return the sum of two numbers."""
-    return a + b
-
-
-backend_tools = [add_numbers]
-model = load_model()
-
-
-class AgentState(MessagesState):
-    tools: List[Any]
-
-
-def chat_node(state: AgentState):
-    bound_model = model.bind_tools(
-        [*state.get("tools", []), *backend_tools],
-    )
-    response = bound_model.invoke(state["messages"])
-    return {"messages": [response]}
-
-
-builder = StateGraph(AgentState)
-builder.add_node("chat", chat_node)
-builder.add_node("tools", ToolNode(tools=backend_tools))
-builder.add_edge(START, "chat")
-builder.add_conditional_edges("chat", tools_condition)
-builder.add_edge("tools", "chat")
-graph = builder.compile(checkpointer=MemorySaver())
-
-agent = LangGraphAgent(
-    name="{{ name }}",
-    graph=graph,
-    description="A helpful assistant",
-)
-
-app = FastAPI()
-app.add_middleware(
-    CORSMiddleware,
-    allow_origins=["*"],
-    allow_methods=["*"],
-    allow_headers=["*"],
-)
-
-add_langgraph_fastapi_endpoint(app=app, agent=agent, path="/invocations")
-
-
-@app.get("/ping")
-async def ping():
-    return {"status": "healthy"}
-
-
-if __name__ == "__main__":
-    uvicorn.run(app, host="0.0.0.0", port=int(os.environ.get("PORT", "8080")))