test: update snapshots for model changes

Author: aidandaly24

StrandsMemLifecycle/AGENTS.md

@@ -0,0 +1,118 @@
+# AgentCore Project
+
+This project contains configuration and infrastructure for an Amazon Bedrock AgentCore application.
+
+The `agentcore/` directory serves as a declarative model of an AgentCore project along with a concrete implementation
+through the `agentcore/cdk/` project which is modeled to take the configs as input. The project models Agents and MCP
+setups with their own overloaded constructs. Agents are first-class.
+
+## Mental Model
+
+A good mental model for how this project works is a directed graph. We have a set of nodes: agents, memories,
+identities, gateways, tools, mcp servers, and future resources supported. There are rules about which nodes can connect
+to others in what direction.
+
+For example, stand-alone memory or identity resources cannot be modeled--they need to be owned by an agent and can be
+used by other agents.
+
+Wiring nodes creates an infrastructure and trust relationship but is not enough to complete end-to-end functionality.
+For example, attaching agentB as a remote tool for agentA means that agentA has permission to invoke agentB and that
+agentA has the ARN for agentB as an environment variable with the name specified in the agentcore.json schema.
+
+To complete a functional connection, the application code in agentA needs to construct the appropriate call to
+`invoke_agent_runtime` which will succeed based on the wiring declared in the schema and implemented in the `cdk/`
+directory.
+
+## Critical Invariants
+
+1. **Schema-First Authority:** The `.json` files are the absolute source of truth. Do not attempt to modify agent
+   behavior by editing the generated CDK code in `cdk/`.
+2. **Resource Identity:** The `name` field in the schema determines the CloudFormation Logical ID.
+   - **Renaming** an agent, gateway, or target will **destroy and recreate** that resource.
+   - **Modifying** other fields (descriptions, prompts, runtime config) will update the resource **in-place**.
+3. **1:1 Validation:** The schema maps directly to valid CloudFormation. If your JSON conforms to the types in
+   `.llm-context/`, it will deploy successfully.
+
+## Directory Structure
+
+```
+myNewProject/
+├── AGENTS.md               # This file - AI coding assistant context
+├── agentcore/              # AgentCore configuration directory
+│   ├── agentcore.json      # Main workspace config (AgentCoreWorkspaceSpec)
+│   ├── mcp.json            # MCP gateways and tools (AgentCoreMcpSpec)
+│   ├── mcp-defs.json       # Tool definitions (AgentCoreCliMcpDefs)
+│   ├── .llm-context/       # TypeScript type definitions for AI coding assistants
+│   │   ├── README.md       # Guide to using the schema files
+│   │   ├── agentcore.ts    # AgentCoreWorkspaceSpec types
+│   │   ├── agent-env.ts    # AgentEnvSpec and runtime types
+│   │   ├── mcp.ts          # MCP gateway and tool types
+│   │   └── aws-targets.ts  # AWS deployment target types
+│   └── cdk/                # AWS CDK project for deployment
+└── ... (your application code)
+```
+
+## Schema Reference
+
+The `agentcore/.llm-context/` directory contains TypeScript type definitions optimized for AI coding assistants. Each
+file maps to a JSON config file and includes validation constraints as comments.
+
+| JSON Config                | Schema File                             | Root Type                |
+| -------------------------- | --------------------------------------- | ------------------------ |
+| `agentcore/agentcore.json` | `agentcore/.llm-context/agentcore.ts`   | `AgentCoreWorkspaceSpec` |
+| `agentcore/mcp.json`       | `agentcore/.llm-context/mcp.ts`         | `AgentCoreMcpSpec`       |
+| `agentcore/mcp-defs.json`  | `agentcore/.llm-context/mcp.ts`         | `AgentCoreCliMcpDefs`    |
+| (aws-targets)              | `agentcore/.llm-context/aws-targets.ts` | `AWSDeploymentTarget[]`  |
+
+### Key Types
+
+- **AgentEnvSpec**: Agent configuration (runtime, memory, identity, tools)
+- **Runtime**: Discriminated union of `CodeZipRuntime` | `ContainerImageRuntime`
+- **MemoryProvider**: `OwnedMemoryProvider` (creates memory) | `ReferencedMemoryProvider` (uses existing)
+- **AgentCoreGateway**: MCP gateway with tool targets
+- **ToolDefinition**: Tool name, description, input/output schemas
+
+### Common Enum Values
+
+- **ArtifactType**: `'CodeZip'` | `'ContainerImage'`
+- **NetworkMode**: `'PUBLIC'` | `'PRIVATE'`
+- **Relation**: `'own'` | `'use'` (for memory providers)
+- **ModelProvider**: `'Bedrock'` | `'Anthropic'` | `'OpenAI'` | `'Gemini'`
+- **ComputeHost**: `'Lambda'` | `'AgentCoreRuntime'`
+
+### Specific Context
+
+Directory pathing to local projects is required for runtimes and tools backed by a modeled compute. Only Python offers a
+zip based direct code deploy option. All other programming languages are required to be containerized and provide a path
+do a `Dockerfile` definition.
+
+MCP tools offer Lambda compute and AgentCore runtime compute. If something like a `FastMCP` server is desired, AgentCore
+runtime is a better fit. When using Lambda, the input schema needs to be modeled in `mcp-defs.json` and the lambda
+handler needs to be a traditional (context, event) style input shape.
+
+## Deployment
+
+The `agentcore/cdk/` subdirectory contains an AWS CDK node project.
+
+Deployments of this project are primarily intended to be orchestrated through the `agentcore deploy` command in the CLI.
+
+Alternatively, the project can be deployed directly as a traditional CDK project:
+
+```bash
+cd agentcore/cdk
+npm install
+npx cdk synth   # Preview CloudFormation template
+npx cdk deploy  # Deploy to AWS
+```
+
+Both CLI and direct deployment have the same source of truth and are safe to be substituted interchangeably.
+
+## Editing Schemas
+
+When modifying JSON config files:
+
+1. Read the corresponding `agentcore/.llm-context/*.ts` file for type definitions
+2. Check validation constraint comments (`@regex`, `@min`, `@max`)
+3. Use exact enum values as string literals
+4. Use CloudFormation-safe names (alphanumeric, start with letter)
+5. Run `agentcore validate` command to verify changes.

StrandsMemLifecycle/README.md

@@ -0,0 +1,69 @@
+# AgentCore Project
+
+This project was created with the [AgentCore CLI](https://github.com/aws/agentcore-cli).
+
+## Project Structure
+
+```
+.
+├── agentcore/              # AgentCore configuration directory
+│   ├── agentcore.json      # Main workspace config
+│   ├── mcp.json            # MCP gateways and tools
+│   ├── mcp-defs.json       # Tool definitions
+│   └── cdk/                # AWS CDK project for deployment
+├── app/                    # Application code (if agents were created)
+└── AGENTS.md               # AI coding assistant context
+```
+
+## Getting Started
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) (v18 or later)
+- [AWS CLI](https://aws.amazon.com/cli/) configured with credentials
+- [AgentCore CLI](https://github.com/awslabs/amazon-bedrock-agentcore) installed globally
+
+### Development
+
+Run your agent locally:
+
+```bash
+agentcore dev
+```
+
+### Deployment
+
+Deploy to AWS:
+
+```bash
+agentcore deploy
+```
+
+Or use CDK directly:
+
+```bash
+cd agentcore/cdk
+npx cdk deploy
+```
+
+## Configuration
+
+Edit the JSON files in `agentcore/` to configure your agents, memory, identity, and tools. See `agentcore/.llm-context/`
+for type definitions and validation constraints.
+
+## Commands
+
+| Command              | Description                         |
+| -------------------- | ----------------------------------- |
+| `agentcore dev`      | Run agent locally                   |
+| `agentcore deploy`   | Deploy to AWS                       |
+| `agentcore status`   | Show deployment status              |
+| `agentcore invoke`   | Invoke deployed agent               |
+| `agentcore add`      | Add agents, memory, identity, tools |
+| `agentcore remove`   | Remove resources                    |
+| `agentcore validate` | Validate configuration              |
+
+## Documentation
+
+- [AgentCore CLI Documentation](https://github.com/aws/agentcore-cli)
+- [Amazon Bedrock AgentCore](https://aws.amazon.com/bedrock/agentcore/)

StrandsMemLifecycle/agentcore/.cli/deployed-state.json

@@ -0,0 +1,3 @@
+{
+  "targets": {}
+}

StrandsMemLifecycle/agentcore/.gitignore

@@ -0,0 +1,15 @@
+# Secrets (local environment files are never committed)
+.env.local
+
+# CDK Build Artifacts
+cdk/cdk.out/
+cdk/node_modules/
+
+# CLI Internals
+.cli/*
+
+# Ephemeral Staging
+.cache/*
+
+# Exception: Commit the State
+!.cli/deployed-state.json

StrandsMemLifecycle/agentcore/.llm-context/README.md

@@ -0,0 +1,16 @@
+# LLM Context Files
+
+**DO NOT EDIT THESE FILES** - They are read-only reference for AI coding assistants.
+
+## Files
+
+| File             | JSON Config        | Purpose                              |
+| ---------------- | ------------------ | ------------------------------------ |
+| `agentcore.ts`   | `agentcore.json`   | Project and agent environment config |
+| `mcp.ts`         | `mcp.json`         | MCP gateways and tools               |
+| `aws-targets.ts` | `aws-targets.json` | Deployment targets                   |
+
+## Usage
+
+When editing schema JSON files, reference the corresponding `.ts` file here for type definitions and validation
+constraints (marked with `@regex`, `@min`, `@max`).

StrandsMemLifecycle/agentcore/.llm-context/agentcore.ts

@@ -0,0 +1,82 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/**
+ * READ-ONLY LLM CONTEXT - Do not edit this file.
+ *
+ * JSON File: agentcore/agentcore.json
+ * Purpose: Top-level project configuration with flat resource model
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// ROOT SCHEMA: AgentCoreProjectSpec
+// ─────────────────────────────────────────────────────────────────────────────
+
+interface AgentCoreProjectSpec {
+  name: string; // @regex ^[A-Za-z][A-Za-z0-9]{0,22}$ @max 23 - project name
+  version: number; // Schema version (integer)
+  agents: AgentEnvSpec[]; // Unique by name
+  memories: Memory[]; // Unique by name
+  credentials: Credential[]; // Unique by name
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// ENUMS
+// ─────────────────────────────────────────────────────────────────────────────
+
+type BuildType = 'CodeZip' | 'Container';
+type PythonRuntime = 'PYTHON_3_10' | 'PYTHON_3_11' | 'PYTHON_3_12' | 'PYTHON_3_13';
+type NodeRuntime = 'NODE_18' | 'NODE_20' | 'NODE_22';
+type RuntimeVersion = PythonRuntime | NodeRuntime;
+type NetworkMode = 'PUBLIC' | 'VPC';
+type MemoryStrategyType = 'SEMANTIC' | 'SUMMARIZATION' | 'USER_PREFERENCE' | 'CUSTOM';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// AGENT
+// ─────────────────────────────────────────────────────────────────────────────
+
+interface AgentEnvSpec {
+  type: 'AgentCoreRuntime';
+  name: string; // @regex ^[a-zA-Z][a-zA-Z0-9_]{0,47}$ @max 48
+  build: BuildType;
+  entrypoint: string; // @regex ^[a-zA-Z0-9_][a-zA-Z0-9_/.-]*\.(py|ts|js)(:[a-zA-Z_][a-zA-Z0-9_]*)?$ e.g. "main.py:handler" or "index.ts"
+  codeLocation: string; // Directory path
+  runtimeVersion: RuntimeVersion;
+  envVars?: EnvVar[];
+  networkMode?: NetworkMode; // default 'PUBLIC'
+  instrumentation?: Instrumentation; // OTel settings
+}
+
+interface Instrumentation {
+  enableOtel: boolean; // default true - wrap entrypoint with opentelemetry-instrument
+}
+
+interface EnvVar {
+  name: string; // @regex ^[A-Za-z_][A-Za-z0-9_]*$ @max 255
+  value: string;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// MEMORY
+// ─────────────────────────────────────────────────────────────────────────────
+
+interface Memory {
+  type: 'AgentCoreMemory';
+  name: string; // @regex ^[a-zA-Z][a-zA-Z0-9_]{0,47}$ @max 48
+  eventExpiryDuration: number; // @min 7 @max 365 (days)
+  strategies: MemoryStrategy[]; // @min 1, unique by type
+}
+
+interface MemoryStrategy {
+  type: MemoryStrategyType;
+  name?: string; // @regex ^[a-zA-Z][a-zA-Z0-9_]{0,47}$ @max 48
+  description?: string;
+  namespaces?: string[];
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// CREDENTIAL
+// ─────────────────────────────────────────────────────────────────────────────
+
+interface Credential {
+  type: 'ApiKeyCredentialProvider';
+  name: string; // @regex ^[A-Za-z0-9_.-]+$ @min 3 @max 255
+}

StrandsMemLifecycle/agentcore/.llm-context/aws-targets.ts

@@ -0,0 +1,37 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+/**
+ * READ-ONLY LLM CONTEXT - Do not edit this file.
+ *
+ * JSON File: agentcore/aws-targets.json
+ * Purpose: AWS deployment targets for AgentCore resources
+ */
+
+// ─────────────────────────────────────────────────────────────────────────────
+// ROOT SCHEMA: AwsDeploymentTargets (array)
+// ─────────────────────────────────────────────────────────────────────────────
+
+// The JSON file contains an array of deployment targets.
+// Target names must be unique within the array.
+type AwsDeploymentTargets = AwsDeploymentTarget[];
+
+interface AwsDeploymentTarget {
+  name: string; // @regex ^[a-zA-Z][a-zA-Z0-9_-]*$ @max 64 - unique identifier
+  description?: string; // @max 256
+  account: string; // @regex ^[0-9]{12}$ - AWS account ID (exactly 12 digits)
+  region: AgentCoreRegion;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// SUPPORTED REGIONS
+// ─────────────────────────────────────────────────────────────────────────────
+
+type AgentCoreRegion =
+  | 'ap-northeast-1'
+  | 'ap-south-1'
+  | 'ap-southeast-1'
+  | 'ap-southeast-2'
+  | 'eu-central-1'
+  | 'eu-west-1'
+  | 'us-east-1'
+  | 'us-east-2'
+  | 'us-west-2';