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

package/dist/assets/templates/harness/harness.yaml

@@ -0,0 +1,157 @@
+# Optional settings are shown with example values.
+
+{{yaml.name}}
+
+# Instructions come from system-prompt.md unless systemPrompt is set inline.
+# systemPrompt: You are a helpful assistant.
+
+# Model
+{{yaml.model}}
+{{#if modelMaxTokensExample}}
+  # Output tokens per model call, rather than across the whole invocation.
+  # maxTokens: 4096
+{{/if}}
+
+# Tools
+# Code Interpreter and Browser use built-in resources when no ARN is specified.
+# awsIam uses the harness execution role, which must allow Gateway invocation.
+# https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html
+{{#if tools.length}}
+{{yaml.tools}}
+{{else}}
+# tools:
+#   - name: code_interpreter
+#     type: agentcore_code_interpreter
+#   - name: browser
+#     type: agentcore_browser
+#   - name: research
+#     type: remote_mcp
+#     config:
+#       remoteMcp:
+#         url: https://mcp.example.com/mcp
+#   - name: company_tools
+#     type: agentcore_gateway
+#     config:
+#       agentCoreGateway:
+#         gatewayArn: arn:aws:bedrock-agentcore:us-west-2:123456789012:gateway/example-1234567890
+#         outboundAuth:
+#           awsIam: {}
+{{/if}}
+
+# Tool patterns: @<server-name>/<tool-name> or @builtin.
+# This controls agent tool selection, not IAM permissions.
+{{#if yaml.allowedTools}}
+{{yaml.allowedTools}}
+{{else}}
+# allowedTools:
+#   - "@builtin"
+#   - "@research/search"
+{{/if}}
+
+# Skill path sources refer to files already present in the runtime container.
+{{#if skills.length}}
+{{yaml.skills}}
+{{else}}
+# skills:
+#   - s3Uri: s3://your-skills-bucket/skills/research/
+#   - gitUrl: https://github.com/your-org/agent-skills.git
+#     path: skills/research
+#   - path: /opt/skills/research
+{{/if}}
+
+# Memory
+# https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/memory.html
+# Alternatives: existing (name or ARN), disabled.
+{{yaml.memory}}
+{{#if (eq memory.mode "managed")}}
+{{#if (or memoryExamples.strategies memoryExamples.eventExpiryDuration)}}
+  # Managed-memory settings. Absent values use service defaults.
+  # Event retention is in days.
+{{#if memoryExamples.strategies}}
+  # strategies:
+  #   - SEMANTIC
+  #   - SUMMARIZATION
+{{/if}}
+{{#if memoryExamples.eventExpiryDuration}}
+  # eventExpiryDuration: 30
+{{/if}}
+{{/if}}
+{{/if}}
+{{#if (or memoryExamples.name memoryExamples.arn)}}
+  # Existing-memory reference: project resource name or external ARN.
+{{#if memoryExamples.name}}
+  # name: ConversationMemory
+{{/if}}
+{{#if memoryExamples.arn}}
+  # arn: arn:aws:bedrock-agentcore:us-west-2:123456789012:memory/example-1234567890
+{{/if}}
+{{/if}}
+
+# Execution limits apply per invocation, across all model calls.
+{{#if yaml.maxIterations}}
+{{yaml.maxIterations}}
+{{else}}
+# maxIterations: 15
+{{/if}}
+{{#if yaml.maxTokens}}
+{{yaml.maxTokens}}
+{{else}}
+# maxTokens: 20000
+{{/if}}
+{{#if yaml.timeoutSeconds}}
+{{yaml.timeoutSeconds}}
+{{else}}
+# timeoutSeconds: 300
+{{/if}}
+
+# Truncation changes the context sent to the model, not the saved memory.
+{{#if yaml.truncation}}
+{{yaml.truncation}}
+{{else}}
+# truncation:
+#   strategy: sliding_window
+#   config:
+#     slidingWindow:
+#       messagesCount: 40
+{{/if}}
+
+# dockerfile and containerUri are mutually exclusive. With neither set, the
+# service-provided environment is used. Dockerfile paths are relative to this directory.
+{{#if yaml.dockerfile}}
+{{yaml.dockerfile}}
+{{else}}
+# dockerfile: Dockerfile
+{{/if}}
+{{#if yaml.containerUri}}
+{{yaml.containerUri}}
+{{else}}
+# containerUri: 123456789012.dkr.ecr.us-west-2.amazonaws.com/my-harness:latest
+{{/if}}
+
+# Environment values are stored in plaintext.
+{{#if yaml.environmentVariables}}
+{{yaml.environmentVariables}}
+{{else}}
+# environmentVariables:
+#   LOG_LEVEL: info
+{{/if}}
+
+# Deployment creates a role when executionRoleArn is absent.
+{{#if yaml.executionRoleArn}}
+{{yaml.executionRoleArn}}
+{{else}}
+# executionRoleArn: arn:aws:iam::123456789012:role/MyHarnessRole
+{{/if}}
+
+# Tags
+{{#if yaml.tags}}
+{{yaml.tags}}
+{{else}}
+# tags:
+#   team: support
+#   environment: development
+{{/if}}
+{{#each additionalSettings}}
+
+{{this}}
+{{/each}}

package/dist/assets/templates/mcp-python-fastmcp/README.md

@@ -0,0 +1,32 @@
+# {{ name }}
+
+An MCP (Model Context Protocol) server deployed on Amazon Bedrock AgentCore.
+
+## Overview
+
+This project implements an MCP server using FastMCP. MCP servers expose tools that can be
+consumed by MCP clients (other agents or applications). The server speaks Streamable HTTP
+transport at `/mcp`, matching the AgentCore Runtime MCP service contract.
+
+## Adding Tools
+
+Define tools using the `@mcp.tool()` decorator in `main.py`:
+
+```python
+@mcp.tool()
+def my_tool(param: str) -> str:
+    """Description of what the tool does."""
+    return f"Result: {param}"
+```
+
+## Developing locally
+
+If installation was successful, a virtual environment is already created with dependencies installed.
+
+`agentcore project dev` starts the server locally on `0.0.0.0:8000`. List and call tools by
+sending JSON-RPC to `http://127.0.0.1:8000/mcp`.
+
+## Deployment
+
+`agentcore project deploy` deploys the server into Amazon Bedrock AgentCore. Invoke it with
+`agentcore project invoke runtime`, supplying an MCP JSON-RPC payload (e.g. `tools/list`, `tools/call`).

package/dist/assets/templates/mcp-python-fastmcp/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

package/dist/assets/templates/mcp-python-fastmcp/main.py

@@ -0,0 +1,83 @@
+{{#if needsOs}}
+import os
+{{/if}}
+from mcp.server.fastmcp import FastMCP
+
+mcp = FastMCP("{{ name }}", host="0.0.0.0", stateless_http=True)
+
+{{#if needsOs}}
+_MOUNT_PATHS = [
+    {{#if sessionStorageMountPath}}"{{sessionStorageMountPath}}",{{/if}}
+    {{#each efsMounts}}"{{mountPath}}",{{/each}}
+    {{#each s3Mounts}}"{{mountPath}}",{{/each}}
+]
+
+def _safe_resolve(path: str) -> str:
+    resolved = os.path.realpath(path)
+    if not any(resolved == os.path.realpath(m) or resolved.startswith(os.path.realpath(m) + os.sep) for m in _MOUNT_PATHS):
+        raise ValueError(f"Path '{path}' is not within any configured mount ({', '.join(_MOUNT_PATHS)})")
+    return resolved
+
+@mcp.tool()
+def file_read(path: str) -> str:
+    """Read a file from a mounted filesystem. Use the absolute path (e.g. /mnt/tools/data.txt)."""
+    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}"
+
+@mcp.tool()
+def file_write(path: str, content: str) -> str:
+    """Write a file to a mounted filesystem. Use the absolute path (e.g. /mnt/tools/data.txt)."""
+    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}"
+
+@mcp.tool()
+def list_files(path: str) -> str:
+    """List files in a mounted filesystem directory. Use the absolute path (e.g. /mnt/tools)."""
+    try:
+        full_path = _safe_resolve(path)
+        entries = os.listdir(full_path)
+        return "\n".join(entries) if entries else "(empty directory)"
+    except ValueError as e:
+        return str(e)
+    except OSError as e:
+        return f"Error listing '{path}': {e.strerror}"
+
+{{/if}}
+
+
+@mcp.tool()
+def add_numbers(a: int, b: int) -> int:
+    """Add two numbers together"""
+    return a + b
+
+
+@mcp.tool()
+def multiply_numbers(a: int, b: int) -> int:
+    """Multiply two numbers together"""
+    return a * b
+
+
+@mcp.tool()
+def greet_user(name: str) -> str:
+    """Greet a user by name"""
+    return f"Hello, {name}! Nice to meet you."
+
+
+if __name__ == "__main__":
+    mcp.run(transport="streamable-http")

package/dist/assets/{python/mcp/standalone/base → templates/mcp-python-fastmcp}/pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling ~= 1.27.0"]
 build-backend = "hatchling.build"
 
 [project]
@@ -9,7 +9,8 @@ description = "AgentCore MCP Server"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "mcp >= 1.19.0",
+    "aws-opentelemetry-distro ~= 0.18.0",
+    "mcp ~= 1.24.0",
 ]
 
 [tool.hatch.build.targets.wheel]

package/dist/assets/templates/shared/env.local.template

@@ -0,0 +1,11 @@
+# Environment variables for local development.
+# `agentcore project dev` loads this file into your agent's process. Values here
+# override injected values except PORT, FASTMCP_PORT, and LOCAL_DEV, which the
+# CLI owns. While trace collection is on (the default), the CLI also owns the
+# OTEL_* and AGENT_OBSERVABILITY_ENABLED variables so traces reach its local
+# collector — pass --no-traces (or set instrumentation.enableOtel to false in
+# agentcore.json) to disable collection and set your own.
+# This file is gitignored — keep secrets out of version control.
+#
+# Example:
+# MY_API_KEY=...

package/dist/assets/templates/shared/gitignore.template

@@ -0,0 +1,19 @@
+# Local environment (loaded by `agentcore dev`; never commit secrets)
+.env.local
+.env*.local
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+
+# Node
+node_modules/
+
+# AgentCore CLI state (ignore local scratch like traces/logs, but commit the
+# deployed-state binding so a target's stack + credential ARNs are shared)
+agentcore/.cli/*
+!agentcore/.cli/deployed-state.json
+
+# CDK
+agentcore/cdk/cdk.out/

package/dist/index.js

@@ -1,27 +1,4 @@
-"use strict";
-/**
- * Main entry point for the agentcore package.
- * Exports public APIs from schema and lib modules.
- *
- * For CDK constructs, use @aws/agentcore-cdk package.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-// Schema exports (types, constants, errors)
-__exportStar(require("./schema"), exports);
-// Lib exports (utilities, packaging, config I/O)
-__exportStar(require("./lib"), exports);
-//# sourceMappingURL=index.js.map
+#!/usr/bin/env node
+import module from "node:module";
+module.enableCompileCache?.();
+await import("./main.js");