Add AWS CDK implementation for basic-runtime sample

.gitignore

@@ -226,6 +226,8 @@ pyrightconfig.json
 lambda.zip
 .kiro/
 
+### CDK artifacts
+cdk.out/
 ### Bedrock AgentCore ###
 .bedrock_agentcore/
 .bedrock_agentcore.yaml

04-infrastructure-as-code/README.md

@@ -1,16 +1,20 @@
-# CloudFormation Samples for Amazon Bedrock AgentCore
+# Infrastructure as Code Samples for Amazon Bedrock AgentCore
 
-CloudFormation templates for deploying Amazon Bedrock AgentCore resources.
+CloudFormation templates and AWS CDK stacks for deploying Amazon Bedrock AgentCore resources.
 
 ## Overview
 
-These CloudFormation templates enable you to:
+These Infrastructure as Code samples enable you to:
 - Deploy AgentCore resources consistently across environments
 - Automate infrastructure provisioning with Infrastructure as Code
 - Maintain version control of your infrastructure
 - Implement AWS best practices for security and monitoring
 
-## 📚 Available Samples
+Choose your preferred approach:
+- **[CloudFormation](./cloudformation/)** - YAML/JSON templates for declarative infrastructure
+- **[CDK](./cdk/)** - Python code for programmatic infrastructure
+
+## 📚 CloudFormation Samples
 
 ### 01. [Hosting MCP Server on AgentCore Runtime](./cloudformation/mcp-server-agentcore-runtime/)
 
@@ -133,6 +137,37 @@ aws cloudformation create-stack \
 
 ---
 
+## 📚 CDK Samples
+
+### 01. [Basic Agent Runtime](./cdk/basic-runtime/)
+
+Deploy a basic AgentCore Runtime with a simple Strands agent using AWS CDK - no additional tools or memory.
+
+**What it deploys:**
+- Docker image asset built from local code
+- IAM role with least-privilege policies for AgentCore  
+- Basic AgentCore Runtime with simple agent
+
+**Architecture highlights:**
+- Uses `DockerImageAsset` for container image building (no CodeBuild needed)
+- Separates IAM role into its own construct (`AgentCoreRole`)
+- Uses `CfnRuntime` directly from `aws_bedrockagentcore`
+- Much cleaner than the CloudFormation equivalent
+
+**Use case:** Simple agent deployment without memory, code interpreter, or browser tools
+
+**Deployment time:** ~5-10 minutes  
+**Estimated cost:** ~$50-100/month
+
+**Quick start:**
+```bash
+cd cdk/basic-runtime
+pip install -r requirements.txt
+cdk deploy
+```
+
+---
+
 ## Prerequisites
 
 Before deploying any CloudFormation template, ensure you have:
@@ -143,7 +178,12 @@ Before deploying any CloudFormation template, ensure you have:
    aws configure
    ```
 3. **Access to Amazon Bedrock AgentCore** (preview)
-4. **IAM Permissions** to create:
+4. **For CDK samples**: Python 3.8+, AWS CDK v2 installed, and **CDK version 2.218.0 or later** (for BedrockAgentCore support)
+   ```bash
+   npm install -g aws-cdk
+   pip install aws-cdk-lib==2.218.0 constructs>=10.0.79
+   ```
+5. **IAM Permissions** to create:
    - CloudFormation stacks
    - IAM roles and policies
    - ECR repositories
@@ -184,22 +224,36 @@ Default values:
 ```
 04-infrastructure-as-code/
 ├── README.md                                    # This file
-└── cloudformation/                              # CloudFormation samples
-    ├── mcp-server-agentcore-runtime/           # MCP Server sample
-    │   ├── deploy.sh                            # Deployment script
-    │   ├── test.sh                              # Testing script
-    │   ├── cleanup.sh                           # Cleanup script
-    │   ├── mcp-server-template.yaml             # CloudFormation template
-    │   ├── get_token.py                         # Authentication helper
-    │   ├── test_mcp_server.py                   # MCP client test
-    │   ├── README.md                            # Sample documentation
-    │   └── DETAILED_GUIDE.md                    # Technical deep-dive
-    ├── basic-runtime/                           # Basic agent sample
-    │   └── template.yaml                        # CloudFormation template
-    ├── multi-agent-runtime/                     # Multi-agent sample
-    │   └── template.yaml                        # CloudFormation template
-    └── end-to-end-weather-agent/                # Weather agent sample
-        └── end-to-end-weather-agent.yaml        # CloudFormation template
+├── cloudformation/                              # CloudFormation samples
+│   ├── mcp-server-agentcore-runtime/           # MCP Server sample
+│   │   ├── deploy.sh                            # Deployment script
+│   │   ├── test.sh                              # Testing script
+│   │   ├── cleanup.sh                           # Cleanup script
+│   │   ├── mcp-server-template.yaml             # CloudFormation template
+│   │   ├── get_token.py                         # Authentication helper
+│   │   ├── test_mcp_server.py                   # MCP client test
+│   │   ├── README.md                            # Sample documentation
+│   │   └── DETAILED_GUIDE.md                    # Technical deep-dive
+│   ├── basic-runtime/                           # Basic agent sample
+│   │   └── template.yaml                        # CloudFormation template
+│   ├── multi-agent-runtime/                     # Multi-agent sample
+│   │   └── template.yaml                        # CloudFormation template
+│   └── end-to-end-weather-agent/                # Weather agent sample
+│       └── end-to-end-weather-agent.yaml        # CloudFormation template
+└── cdk/                                         # CDK samples
+    └── basic-runtime/                           # Basic agent CDK sample
+        ├── app.py                               # CDK app entry point
+        ├── basic_runtime_stack.py               # Stack definition
+        ├── requirements.txt                     # Python dependencies
+        ├── cdk.json                             # CDK configuration
+        ├── README.md                            # Sample documentation
+        ├── infra-utils/                         # Infrastructure utilities
+        │   ├── agentcore_role.py                # Dedicated role construct
+        │   └── build_trigger_lambda.py          # Lambda function for CodeBuild trigger
+        └── agent-code/                          # Agent source code
+            ├── Dockerfile
+            ├── basic_agent.py
+            └── requirements.txt
 ```
 
 

04-infrastructure-as-code/cdk/basic-runtime/README.md

@@ -0,0 +1,252 @@
+# Basic AgentCore Runtime - CDK
+
+This CDK stack deploys a basic Amazon Bedrock AgentCore Runtime with a simple Strands agent. This is the simplest possible AgentCore deployment, perfect for getting started and understanding the core concepts without additional complexity.
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Architecture](#architecture)
+- [Prerequisites](#prerequisites)
+- [Deployment](#deployment)
+- [Testing](#testing)
+- [Sample Queries](#sample-queries)
+- [Cleanup](#cleanup)
+- [Troubleshooting](#troubleshooting)
+
+## Overview
+
+This CDK stack creates a minimal AgentCore deployment that includes:
+
+- **AgentCore Runtime**: Hosts a simple Strands agent
+- **ECR Repository**: Stores the Docker container image
+- **IAM Roles**: Provides necessary permissions
+- **CodeBuild Project**: Automatically builds the ARM64 Docker image
+- **Lambda Functions**: Custom resources for automation
+- **S3 Assets**: Source code packaging and deployment
+
+This makes it ideal for:
+- Learning AgentCore basics
+- Quick prototyping
+- Understanding the core deployment pattern
+- Building a foundation before adding complexity
+
+## Architecture
+
+The architecture consists of:
+
+- **User**: Sends questions to the agent and receives responses
+- **AWS CodeBuild**: Builds the ARM64 Docker container image with the agent code
+- **Amazon ECR Repository**: Stores the container image
+- **AgentCore Runtime**: Hosts the Basic Agent container
+  - **Basic Agent**: Simple Strands agent that processes user queries
+  - Invokes Amazon Bedrock LLMs to generate responses
+- **IAM Roles**: 
+  - IAM role for CodeBuild (builds and pushes images)
+  - IAM role for Agent Execution (runtime permissions)
+- **Amazon Bedrock LLMs**: Provides the AI model capabilities for the agent
+
+## Prerequisites
+
+### AWS Account Setup
+
+1. **AWS Account**: You need an active AWS account with appropriate permissions
+   - [Create AWS Account](https://aws.amazon.com/account/)
+   - [AWS Console Access](https://aws.amazon.com/console/)
+
+2. **AWS CLI**: Install and configure AWS CLI with your credentials
+   - [Install AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)
+   - [Configure AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html)
+
+   ```bash
+   aws configure
+   ```
+
+3. **Python 3.10+** and **AWS CDK v2** installed
+   ```bash
+   # Install CDK
+   npm install -g aws-cdk
+
+   # Verify installation
+   cdk --version
+   ```
+
+4. **CDK version 2.218.0 or later** (for BedrockAgentCore support)
+
+5. **Bedrock Model Access**: Enable access to Amazon Bedrock models in your AWS region
+   - [Bedrock Model Access Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html)
+
+6. **Required Permissions**: Your AWS user/role needs permissions for:
+   - CloudFormation stack operations
+   - ECR repository management
+   - IAM role creation
+   - Lambda function creation
+   - CodeBuild project creation
+   - BedrockAgentCore resource creation
+   - S3 bucket operations (for CDK assets)
+
+## Deployment
+
+### Option 1: Quick Deploy (Recommended)
+
+```bash
+# Install dependencies
+pip install -r requirements.txt
+
+# Bootstrap CDK (first time only)
+cdk bootstrap
+
+# Deploy
+cdk deploy
+```
+
+### Option 2: Step by Step
+
+```bash
+# 1. Create and activate Python virtual environment
+python3 -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+
+# 2. Install Python dependencies
+pip install -r requirements.txt
+
+# 2. Bootstrap CDK in your account/region (first time only)
+cdk bootstrap
+
+# 3. Synthesize the CloudFormation template (optional)
+cdk synth
+
+# 4. Deploy the stack
+cdk deploy --require-approval never
+
+# 5. Get outputs
+cdk list
+```
+
+### Deployment Time
+
+- **Expected Duration**: 3-5 minutes
+
+## Testing
+
+### Using AWS CLI
+
+```bash
+# Get the Runtime ARN from CDK outputs
+RUNTIME_ARN=$(aws cloudformation describe-stacks \
+  --stack-name BasicAgentDemo \
+  --region us-east-1 \
+  --query 'Stacks[0].Outputs[?OutputKey==`AgentRuntimeArn`].OutputValue' \
+  --output text)
+
+# Invoke the agent
+aws bedrock-agentcore invoke-agent-runtime \
+  --agent-runtime-arn $RUNTIME_ARN \
+  --qualifier DEFAULT \
+  --payload $(echo '{"prompt": "What is 2+2?"}' | base64) \
+  response.json
+
+# View the response
+cat response.json
+```
+
+### Using AWS Console
+
+1. Navigate to [Bedrock AgentCore Console](https://console.aws.amazon.com/bedrock-agentcore/)
+2. Go to "Runtimes" in the left navigation
+3. Find your runtime (name starts with `BasicAgentDemo_`)
+4. Click on the runtime name
+5. Click "Test" button
+6. Enter test payload:
+   ```json
+   {
+     "prompt": "What is 2+2?"
+   }
+   ```
+7. Click "Invoke"
+
+## Sample Queries
+
+Try these queries to test your basic agent:
+
+1. **Simple Math**:
+   ```json
+   {"prompt": "What is 2+2?"}
+   ```
+
+2. **General Knowledge**:
+   ```json
+   {"prompt": "What is the capital of France?"}
+   ```
+
+3. **Explanation Request**:
+   ```json
+   {"prompt": "Explain what Amazon Bedrock is in simple terms"}
+   ```
+
+4. **Creative Task**:
+   ```json
+   {"prompt": "Write a haiku about cloud computing"}
+   ```
+
+5. **Reasoning**:
+   ```json
+   {"prompt": "If I have 5 apples and give away 2, how many do I have left?"}
+   ```
+
+## Cleanup
+
+### Using CDK (Recommended)
+
+```bash
+cdk destroy
+```
+
+### Using AWS CLI
+
+```bash
+aws cloudformation delete-stack \
+  --stack-name BasicAgentDemo \
+  --region us-east-1
+
+# Wait for deletion to complete
+aws cloudformation wait stack-delete-complete \
+  --stack-name BasicAgentDemo \
+  --region us-east-1
+```
+
+### Using AWS Console
+
+1. Navigate to [CloudFormation Console](https://console.aws.amazon.com/cloudformation/)
+2. Select the `BasicAgentDemo` stack
+3. Click "Delete"
+4. Confirm deletion
+
+## Troubleshooting
+
+### CDK Bootstrap Required
+
+If you see bootstrap errors:
+```bash
+cdk bootstrap aws://ACCOUNT-NUMBER/REGION
+```
+
+### Permission Issues
+
+Ensure your IAM user/role has:
+- `CDKToolkit` permissions or equivalent
+- Permissions to create all resources in the stack
+- `iam:PassRole` for service roles
+
+### Python Dependencies
+
+Install dependencies in the project directory:
+```bash
+pip install -r requirements.txt
+```
+
+### Build Failures
+
+Check CodeBuild logs in the AWS Console:
+1. Go to CodeBuild console
+2. Find the build project (name contains "basic-agent-build")
+3. Check build history and logs