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

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

@@ -1,123 +0,0 @@
-{{#if (eq modelProvider "Bedrock")}}
-from langchain_aws import ChatBedrock
-
-# Uses global inference profile for Claude Sonnet 4.5
-# https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html
-MODEL_ID = "global.anthropic.claude-sonnet-4-5-20250929-v1:0"
-
-
-def load_model() -> ChatBedrock:
-    """Get Bedrock model client using IAM credentials."""
-    return ChatBedrock(model_id=MODEL_ID)
-{{/if}}
-{{#if (eq modelProvider "Anthropic")}}
-import os
-from langchain_anthropic import ChatAnthropic
-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() -> ChatAnthropic:
-    """Get authenticated Anthropic model client."""
-    return ChatAnthropic(
-        model="claude-sonnet-4-5-20250929",
-        api_key=_get_api_key()
-    )
-{{/if}}
-{{#if (eq modelProvider "OpenAI")}}
-import os
-from langchain_openai import ChatOpenAI
-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() -> ChatOpenAI:
-    """Get authenticated OpenAI model client."""
-    return ChatOpenAI(
-        model="gpt-4.1",
-        api_key=_get_api_key()
-    )
-{{/if}}
-{{#if (eq modelProvider "Gemini")}}
-import os
-from langchain_google_genai import ChatGoogleGenerativeAI
-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() -> ChatGoogleGenerativeAI:
-    """Get authenticated Gemini model client."""
-    return ChatGoogleGenerativeAI(
-        model="gemini-2.5-flash",
-        api_key=_get_api_key()
-    )
-{{/if}}

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

@@ -1,30 +0,0 @@
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-[project]
-name = "{{ name }}"
-version = "0.1.0"
-description = "AgentCore AG-UI Agent using LangChain + LangGraph"
-readme = "README.md"
-requires-python = ">=3.10"
-dependencies = [
-    "ag-ui-langgraph >= 0.0.31",
-    "ag-ui-protocol >= 0.1.10",
-    {{#if (eq modelProvider "Anthropic")}}"langchain-anthropic >= 0.3.0",
-    {{/if}}{{#if (eq modelProvider "Bedrock")}}"langchain-aws >= 0.2.0",
-    {{/if}}{{#if (eq modelProvider "Gemini")}}"langchain-google-genai >= 2.0.0",
-    {{/if}}{{#if (eq modelProvider "OpenAI")}}"langchain-openai >= 0.2.0",
-    {{/if}}"aws-opentelemetry-distro",
-    "opentelemetry-instrumentation-langchain >= 0.59.0",
-    "bedrock-agentcore >= 1.0.3",
-    "botocore[crt] >= 1.35.0",
-    "langgraph >= 0.3.25",
-    "langchain >= 0.3.0",
-    "langchain-core >= 0.3.0",
-    "fastapi >= 0.115.12",
-    "uvicorn >= 0.34.3",
-]
-
-[tool.hatch.build.targets.wheel]
-packages = ["."]

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

@@ -1,22 +0,0 @@
-# {{ name }}
-
-An AG-UI agent deployed on Amazon Bedrock AgentCore using Strands SDK.
-
-## Overview
-
-This agent implements the AG-UI protocol, enabling streaming agent-to-UI communication. The agent exposes an `/invocations` endpoint that accepts AG-UI protocol requests and streams responses back to the client.
-
-## 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/strands/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/strands/base/model/__init__.py

@@ -1 +0,0 @@
-# Package marker

package/dist/assets/python/agui/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/agui/strands/base/pyproject.toml

@@ -1,27 +0,0 @@
-[build-system]
-requires = ["hatchling"]
-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 = [
-    {{#if (eq modelProvider "Anthropic")}}"anthropic >= 0.30.0",
-    {{/if}}"ag-ui-strands >= 0.1.7",
-    "ag-ui-protocol >= 0.1.10",
-    "aws-opentelemetry-distro",
-    "bedrock-agentcore >= 1.0.3",
-    "botocore[crt] >= 1.35.0",
-    "fastapi >= 0.115.12",
-    {{#if (eq modelProvider "Gemini")}}"google-genai >= 1.0.0",
-    {{/if}}{{#if (eq modelProvider "OpenAI")}}"openai >= 1.0.0",
-    {{/if}}"strands-agents >= 1.15.0",
-    "strands-agents-tools >= 0.2.14",
-    "uvicorn >= 0.34.3",
-]
-
-[tool.hatch.build.targets.wheel]
-packages = ["."]

package/dist/assets/python/agui/strands/capabilities/memory/__init__.py

@@ -1 +0,0 @@
-# Package marker

package/dist/assets/python/agui/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/http/autogen/base/README.md

@@ -1,39 +0,0 @@
-This is a project generated by the agentcore create CLI tool!
-
-# 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.py`. Using the AgentCore SDK `@app.entrypoint` decorator, this
-file defines a Starlette ASGI app with the AutoGen framework running within.
-
-`model/load.py` instantiates your chosen model provider.
-
-## Environment Variables
-
-| Variable | Required | Description |
-| --- | --- | --- |
-{{#if hasIdentity}}| `{{identityProviders.[0].envVarName}}` | Yes | {{modelProvider}} API key (local) or Identity provider name (deployed) |
-{{/if}}| `LOCAL_DEV` | No | Set to `1` to use `.env.local` instead of AgentCore Identity |
-
-# Developing locally
-
-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.
-
-In a new terminal, you can invoke that server with:
-
-`agentcore invoke --dev "What can you do"`
-
-# Deployment
-
-After providing credentials, `agentcore deploy` will deploy your project into Amazon Bedrock AgentCore.
-
-Use `agentcore invoke` to invoke your deployed agent.

package/dist/assets/python/http/autogen/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/http/autogen/base/main.py

@@ -1,112 +0,0 @@
-import os
-from autogen_agentchat.agents import AssistantAgent
-from autogen_core.tools import FunctionTool
-from bedrock_agentcore.runtime import BedrockAgentCoreApp
-from model.load import load_model
-from mcp_client.client import get_streamable_http_mcp_tools
-
-app = BedrockAgentCoreApp()
-log = app.logger
-
-
-# Define a simple function tool
-def add_numbers(a: int, b: int) -> int:
-    """Return the sum of two numbers"""
-    return a + b
-
-
-add_numbers_tool = FunctionTool(
-    add_numbers, description="Return the sum of two numbers"
-)
-
-# Define a collection of tools used by the model
-tools = [add_numbers_tool]
-
-{{#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
-
-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}"
-
-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}"
-
-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([
-    FunctionTool(file_read, description="Read a file from persistent storage. The path is relative to the storage root."),
-    FunctionTool(file_write, description="Write content to a file in persistent storage. The path is relative to the storage root."),
-    FunctionTool(list_files, description="List files in persistent storage. The directory is relative to the storage root."),
-])
-{{/if}}
-
-SYSTEM_MESSAGE = """
-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}}
-"""
-
-@app.entrypoint
-async def invoke(payload, context):
-    log.info("Invoking Agent.....")
-
-    # Get MCP Tools
-    mcp_tools = await get_streamable_http_mcp_tools()
-
-    # Define an AssistantAgent with the model and tools
-    agent = AssistantAgent(
-        name="{{ name }}",
-        model_client=load_model(),
-        tools=tools + mcp_tools,
-        system_message=SYSTEM_MESSAGE,
-    )
-
-    # Process the user prompt
-    prompt = payload.get("prompt", "What can you help me with?")
-
-    # Run the agent
-    result = await agent.run(task=prompt)
-
-    # Return result
-    return {"result": result.messages[-1].content}
-
-
-if __name__ == "__main__":
-    app.run()

package/dist/assets/python/http/autogen/base/mcp_client/__init__.py

@@ -1 +0,0 @@
-# Package marker

package/dist/assets/python/http/autogen/base/mcp_client/client.py

@@ -1,28 +0,0 @@
-from typing import List
-{{#if isVpc}}
-# VPC mode: external MCP endpoints are not reachable without a NAT gateway.
-# Add an AgentCore Gateway with `agentcore add gateway`, or configure your own endpoint below.
-
-
-async def get_streamable_http_mcp_tools() -> List:
-    """No MCP server configured. Add a gateway with `agentcore add gateway`."""
-    return []
-{{else}}
-from autogen_ext.tools.mcp import (
-    StreamableHttpMcpToolAdapter,
-    StreamableHttpServerParams,
-    mcp_server_tools,
-)
-
-# ExaAI provides information about code through web searches, crawling and code context searches through their platform. Requires no authentication
-EXAMPLE_MCP_ENDPOINT = "https://mcp.exa.ai/mcp"
-
-
-async def get_streamable_http_mcp_tools() -> List[StreamableHttpMcpToolAdapter]:
-    """
-    Returns MCP Tools compatible with AutoGen.
-    """
-    # to use an MCP server that supports bearer authentication, add headers={"Authorization": f"Bearer {access_token}"}
-    server_params = StreamableHttpServerParams(url=EXAMPLE_MCP_ENDPOINT)
-    return await mcp_server_tools(server_params)
-{{/if}}

package/dist/assets/python/http/autogen/base/model/__init__.py

@@ -1 +0,0 @@
-# Package marker