@aws/agentcore 0.3.0-preview.7.0 → 0.3.0-preview.8.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);
@@ -4266,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

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