@aws/agentcore 0.3.0-preview.7.0 → 0.3.0-preview.9.0

package/README.md

@@ -17,17 +17,15 @@ AgentCore with minimal configuration.
 
 ## Installation
 
-> **Upgrading from the Bedrock AgentCore Starter Toolkit?** The old Python CLI conflicts with this package. If it is
-> still installed, `npm install` will fail with an error telling you which package manager has it. Uninstall it first
-> using whichever tool you originally used:
+> **Upgrading from the Bedrock AgentCore Starter Toolkit?** If the old Python CLI is still installed, you'll see a
+> warning after install asking you to uninstall it. Both CLIs use the `agentcore` command name, so having both can cause
+> confusion. Uninstall the old one using whichever tool you originally used:
 >
 > ```bash
 > pip uninstall bedrock-agentcore-starter-toolkit    # if installed via pip
 > pipx uninstall bedrock-agentcore-starter-toolkit   # if installed via pipx
 > uv tool uninstall bedrock-agentcore-starter-toolkit # if installed via uv
 > ```
->
-> If you need to bypass the check (for example, in CI), set `AGENTCORE_SKIP_CONFLICT_CHECK=1` before installing.
 
 ```bash
 npm install -g @aws/agentcore
@@ -100,7 +98,7 @@ agentcore invoke
 | -------------------- | --------------------------------------------- |
 | `add evaluator`      | Add a custom LLM-as-a-Judge evaluator         |
 | `add online-eval`    | Add continuous evaluation for live traffic    |
-| `run evals`          | Run on-demand evaluation against agent traces |
+| `run eval`           | Run on-demand evaluation against agent traces |
 | `evals history`      | View past eval run results                    |
 | `pause online-eval`  | Pause a deployed online eval config           |
 | `resume online-eval` | Resume a paused online eval config            |

package/dist/assets/__tests__/__snapshots__/assets.snapshot.test.ts.snap

@@ -73,13 +73,19 @@ async function main() {
   const spec = await configIO.readProjectSpec();
   const targets = await configIO.readAWSDeploymentTargets();
 
-  // Read MCP configuration if it exists
-  let mcpSpec;
-  try {
-    mcpSpec = await configIO.readMcpSpec();
-  } catch {
-    // MCP config is optional
-  }
+  // Extract MCP configuration from project spec.
+  // Gateway fields are stored in agentcore.json but may not yet be on the
+  // AgentCoreProjectSpec type from @aws/agentcore-cdk, so we read them
+  // dynamically and cast the resulting object.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const specAny = spec as any;
+  const mcpSpec = specAny.agentCoreGateways?.length
+    ? {
+        agentCoreGateways: specAny.agentCoreGateways,
+        mcpRuntimeTools: specAny.mcpRuntimeTools,
+        unassignedTargets: specAny.unassignedTargets,
+      }
+    : undefined;
 
   // Read deployed state for credential ARNs (populated by pre-deploy identity setup)
   let deployedState: Record<string, unknown> | undefined;
@@ -301,6 +307,7 @@ export class AgentCoreStack extends Stack {
         mcpSpec,
         agentCoreApplication: this.application,
         credentials,
+        projectTags: spec.tags,
       });
     }
 
@@ -375,6 +382,9 @@ test('AgentCoreStack synthesizes with empty spec', () => {
       evaluators: [],
       onlineEvalConfigs: [],
       policyEngines: [],
+      agentCoreGateways: [],
+      mcpRuntimeTools: [],
+      unassignedTargets: [],
     },
   });
   const template = Template.fromStack(stack);
@@ -2894,12 +2904,15 @@ async def invoke(payload, context):
 
     # Process the user prompt
     prompt = payload.get("prompt", "What can you help me with?")
+    log.info(f"Agent input: {prompt}")
 
     # Run the agent
     result = await graph.ainvoke({"messages": [HumanMessage(content=prompt)]})
 
     # Return result
-    return {"result": result["messages"][-1].content}
+    output = result["messages"][-1].content
+    log.info(f"Agent output: {output}")
+    return {"result": output}
 
 
 if __name__ == "__main__":
@@ -3137,8 +3150,7 @@ description = "AgentCore Runtime Application using LangChain/LangGraph"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "opentelemetry-distro",
-    "opentelemetry-exporter-otlp",
+    "aws-opentelemetry-distro",
     "langgraph >= 1.0.2",
     "mcp >= 1.19.0",
     "langchain-mcp-adapters >= 0.1.11",
@@ -4266,7 +4278,7 @@ model** where agents, memories, and credentials are top-level arrays.
 The project uses a **flat resource model**. Agents, memories, and credentials are independent top-level arrays in
 \`agentcore.json\`. There is no binding or attachment between resources in the schema — each resource is provisioned
 independently. To use a memory or credential from an agent, the application code discovers the resource at runtime
-(e.g., via environment variables or SDK calls).
+(e.g., via environment variables or SDK calls). Tags defined in \`agentcore.json\` flow through to deployed CloudFormation resources.
 
 ## Critical Invariants
 
@@ -4318,7 +4330,7 @@ file maps to a JSON config file and includes validation constraints as comments.
 - **BuildType**: \`'CodeZip'\` | \`'Container'\`
 - **NetworkMode**: \`'PUBLIC'\`
 - **RuntimeVersion**: \`'PYTHON_3_10'\` | \`'PYTHON_3_11'\` | \`'PYTHON_3_12'\` | \`'PYTHON_3_13'\`
-- **MemoryStrategyType**: \`'SEMANTIC'\` | \`'SUMMARIZATION'\` | \`'USER_PREFERENCE'\`
+- **MemoryStrategyType**: \`'SEMANTIC'\` | \`'SUMMARIZATION'\` | \`'USER_PREFERENCE'\` | \`'EPISODIC'\`
 
 ### Build Types
 

package/dist/assets/agents/AGENTS.md

@@ -11,7 +11,7 @@ model** where agents, memories, and credentials are top-level arrays.
 The project uses a **flat resource model**. Agents, memories, and credentials are independent top-level arrays in
 `agentcore.json`. There is no binding or attachment between resources in the schema — each resource is provisioned
 independently. To use a memory or credential from an agent, the application code discovers the resource at runtime
-(e.g., via environment variables or SDK calls).
+(e.g., via environment variables or SDK calls). Tags defined in `agentcore.json` flow through to deployed CloudFormation resources.
 
 ## Critical Invariants
 
@@ -63,7 +63,7 @@ file maps to a JSON config file and includes validation constraints as comments.
 - **BuildType**: `'CodeZip'` | `'Container'`
 - **NetworkMode**: `'PUBLIC'`
 - **RuntimeVersion**: `'PYTHON_3_10'` | `'PYTHON_3_11'` | `'PYTHON_3_12'` | `'PYTHON_3_13'`
-- **MemoryStrategyType**: `'SEMANTIC'` | `'SUMMARIZATION'` | `'USER_PREFERENCE'`
+- **MemoryStrategyType**: `'SEMANTIC'` | `'SUMMARIZATION'` | `'USER_PREFERENCE'` | `'EPISODIC'`
 
 ### Build Types
 

package/dist/assets/cdk/bin/cdk.ts

@@ -28,13 +28,19 @@ async function main() {
   const spec = await configIO.readProjectSpec();
   const targets = await configIO.readAWSDeploymentTargets();
 
-  // Read MCP configuration if it exists
-  let mcpSpec;
-  try {
-    mcpSpec = await configIO.readMcpSpec();
-  } catch {
-    // MCP config is optional
-  }
+  // Extract MCP configuration from project spec.
+  // Gateway fields are stored in agentcore.json but may not yet be on the
+  // AgentCoreProjectSpec type from @aws/agentcore-cdk, so we read them
+  // dynamically and cast the resulting object.
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const specAny = spec as any;
+  const mcpSpec = specAny.agentCoreGateways?.length
+    ? {
+        agentCoreGateways: specAny.agentCoreGateways,
+        mcpRuntimeTools: specAny.mcpRuntimeTools,
+        unassignedTargets: specAny.unassignedTargets,
+      }
+    : undefined;
 
   // Read deployed state for credential ARNs (populated by pre-deploy identity setup)
   let deployedState: Record<string, unknown> | undefined;

package/dist/assets/cdk/lib/cdk-stack.ts

@@ -49,6 +49,7 @@ export class AgentCoreStack extends Stack {
         mcpSpec,
         agentCoreApplication: this.application,
         credentials,
+        projectTags: spec.tags,
       });
     }
 

package/dist/assets/cdk/test/cdk.test.ts

@@ -14,6 +14,9 @@ test('AgentCoreStack synthesizes with empty spec', () => {
       evaluators: [],
       onlineEvalConfigs: [],
       policyEngines: [],
+      agentCoreGateways: [],
+      mcpRuntimeTools: [],
+      unassignedTargets: [],
     },
   });
   const template = Template.fromStack(stack);

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

@@ -54,12 +54,15 @@ async def invoke(payload, context):
 
     # Process the user prompt
     prompt = payload.get("prompt", "What can you help me with?")
+    log.info(f"Agent input: {prompt}")
 
     # Run the agent
     result = await graph.ainvoke({"messages": [HumanMessage(content=prompt)]})
 
     # Return result
-    return {"result": result["messages"][-1].content}
+    output = result["messages"][-1].content
+    log.info(f"Agent output: {output}")
+    return {"result": output}
 
 
 if __name__ == "__main__":

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

@@ -9,8 +9,7 @@ description = "AgentCore Runtime Application using LangChain/LangGraph"
 readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
-    "opentelemetry-distro",
-    "opentelemetry-exporter-otlp",
+    "aws-opentelemetry-distro",
     "langgraph >= 1.0.2",
     "mcp >= 1.19.0",
     "langchain-mcp-adapters >= 0.1.11",