@aws/agentcore 0.3.0-preview.6.1 → 0.3.0-preview.8.0

package/README.md

@@ -17,18 +17,20 @@ AgentCore with minimal configuration.
 
 ## Installation
 
-```bash
-npm install -g @aws/agentcore
-```
-
-> **Public Preview**: If you previously used the
-> [Bedrock AgentCore Starter Toolkit](https://github.com/aws/bedrock-agentcore-starter-toolkit), uninstall it before
-> using this CLI:
+> **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
+> 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
 > ```
 
+```bash
+npm install -g @aws/agentcore
+```
+
 ## Quick Start
 
 Use the terminal UI to walk through all commands interactively, or run each command individually:
@@ -96,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,
       });
     }
 
@@ -374,6 +381,10 @@ test('AgentCoreStack synthesizes with empty spec', () => {
       credentials: [],
       evaluators: [],
       onlineEvalConfigs: [],
+      policyEngines: [],
+      agentCoreGateways: [],
+      mcpRuntimeTools: [],
+      unassignedTargets: [],
     },
   });
   const template = Template.fromStack(stack);
@@ -4265,7 +4276,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
 

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
 

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

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