@cdklabs/cdk-appmod-catalog-blueprints 1.11.0 → 1.12.0

package/.jsii

@@ -4114,7 +4114,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git",
-  "jsiiVersion": "5.9.28 (build cbad63d)",
+  "jsiiVersion": "5.9.26 (build f85d3df)",
   "keywords": [
     "cdk"
   ],
@@ -4566,6 +4566,276 @@
       ],
       "symbolId": "use-cases/webapp/frontend-construct:AdditionalDistributionProps"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreJwtAuthorizerConfig": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Custom JWT authorizer configuration for AgentCore Runtime."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreJwtAuthorizerConfig",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/interactive-agent.ts",
+        "line": 1063
+      },
+      "name": "AgentCoreJwtAuthorizerConfig",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "OIDC discovery URL."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1065
+          },
+          "name": "discoveryUrl",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Allowed audiences."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1067
+          },
+          "name": "allowedAudience",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Allowed client IDs."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1069
+          },
+          "name": "allowedClients",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/interactive-agent:AgentCoreJwtAuthorizerConfig"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreRuntimeHostingAdapter": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "docs": {
+        "remarks": "Deploys the agent as a container running on AgentCore Runtime (microVM).\nUses L1 constructs `CfnRuntime` and `CfnRuntimeEndpoint` from\n`aws-cdk-lib/aws-bedrockagentcore`.\n\n## Architecture\n\n```\nClient → AgentCore Runtime Endpoint → Container (FastAPI on port 8080) → Bedrock\n```\n\n## Features\n\n- **Session Isolation**: microVM provides per-session isolation (no S3 session bucket needed)\n- **Managed Infrastructure**: No Lambda cold starts or timeout limits\n- **Multiple Protocols**: HTTP, MCP, or A2A protocol support\n- **Container-Based**: Standard Docker image deployment\n\n## Usage\n\n```typescript\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\nimport { InteractiveAgent, AgentCoreRuntimeHostingAdapter } from '@cdklabs/cdk-appmod-catalog-blueprints';\n\ndeclare const myPrompt: Asset;\n\nnew InteractiveAgent(this, 'Agent', {\n  agentName: 'MyChatbot',\n  agentDefinition: { bedrockModel: {}, systemPrompt: myPrompt },\n  hostingAdapter: new AgentCoreRuntimeHostingAdapter({\n    networkMode: 'PUBLIC',\n  }),\n});\n```",
+        "stability": "experimental",
+        "summary": "AgentCore Runtime hosting adapter for InteractiveAgent."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreRuntimeHostingAdapter",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "use-cases/framework/agents/interactive-agent.ts",
+          "line": 1151
+        },
+        "parameters": [
+          {
+            "name": "props",
+            "optional": true,
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreRuntimeHostingAdapterProps"
+            }
+          }
+        ]
+      },
+      "interfaces": [
+        "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/interactive-agent.ts",
+        "line": 1148
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Deploy AgentCore Runtime hosting infrastructure."
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1160
+          },
+          "name": "deploy",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter",
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingConfig"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingResult"
+            }
+          }
+        }
+      ],
+      "name": "AgentCoreRuntimeHostingAdapter",
+      "properties": [
+        {
+          "docs": {
+            "remarks": "BaseAgent uses this to create the agent role with the correct trust policy.\nFor example, Lambda hosting requires `lambda.amazonaws.com` while AgentCore\nhosting requires `bedrock-agentcore.amazonaws.com`.",
+            "stability": "experimental",
+            "summary": "The IAM service principal that this hosting backend requires."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1155
+          },
+          "name": "servicePrincipal",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_iam.ServicePrincipal"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/interactive-agent:AgentCoreRuntimeHostingAdapter"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreRuntimeHostingAdapterProps": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Configuration properties for AgentCoreRuntimeHostingAdapter."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreRuntimeHostingAdapterProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/interactive-agent.ts",
+        "line": 1075
+      },
+      "name": "AgentCoreRuntimeHostingAdapterProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "Builds from agentcore-agent-handler directory",
+            "remarks": "If not provided, builds from the bundled handler source.",
+            "stability": "experimental",
+            "summary": "ECR container image URI."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1081
+          },
+          "name": "containerImageUri",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Omit for IAM-only auth.",
+            "stability": "experimental",
+            "summary": "Custom JWT authorizer configuration."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1094
+          },
+          "name": "customJwtAuthorizer",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreJwtAuthorizerConfig"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "Auto-generated from agent name",
+            "stability": "experimental",
+            "summary": "Runtime endpoint name."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1108
+          },
+          "name": "endpointName",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'PUBLIC'",
+            "stability": "experimental",
+            "summary": "Network mode: 'PUBLIC' or 'VPC'."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1088
+          },
+          "name": "networkMode",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'HTTP'",
+            "stability": "experimental",
+            "summary": "Protocol configuration: 'HTTP' | 'MCP' | 'A2A'."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1101
+          },
+          "name": "protocolConfiguration",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/interactive-agent:AgentCoreRuntimeHostingAdapterProps"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.AgentDefinitionProps": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
@@ -4608,128 +4878,544 @@
             "filename": "use-cases/framework/agents/base-agent.ts",
             "line": 39
           },
-          "name": "systemPrompt",
+          "name": "systemPrompt",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- Only auto-generated permissions from knowledge bases",
+            "remarks": "Use this when knowledge bases require permissions beyond what is\nautomatically generated by the IKnowledgeBase implementations.\nThese statements will be added to the agent's IAM role in addition\nto the auto-generated permissions.",
+            "stability": "experimental",
+            "summary": "Additional IAM policy statements for knowledge base access."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 83
+          },
+          "name": "additionalPolicyStatementsForKnowledgeBases",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "If tools need additional IAM permissions, these statements would be attached to the Agent's IAM role."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 57
+          },
+          "name": "additionalPolicyStatementsForTools",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No knowledge bases configured",
+            "remarks": "When configured, the agent will have access to a built-in retrieval tool\nthat can query these knowledge bases. The agent's system prompt will be\nautomatically augmented with information about available knowledge bases.\n\nEach knowledge base must implement the IKnowledgeBase interface, which\nhandles IAM permission generation and runtime configuration.",
+            "stability": "experimental",
+            "summary": "Knowledge bases available to the agent for Retrieval-Augmented Generation (RAG)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 71
+          },
+          "name": "knowledgeBases",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Any dependencies needed by the provided tools."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 51
+          },
+          "name": "lambdaLayers",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_lambda.LayerVersion"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "This tools would automatically\nbe loaded by the agent. You can also use this to incorporate other specialized\nagents as tools.",
+            "stability": "experimental",
+            "summary": "List of tools defined in python files."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 46
+          },
+          "name": "tools",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/base-agent:AgentDefinitionProps"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingConfig": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Configuration passed to a hosting adapter's deploy method."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingConfig",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/interactive-agent.ts",
+        "line": 758
+      },
+      "name": "AgentHostingConfig",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Agent name identifier."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 762
+          },
+          "name": "agentName",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "IAM role for the agent runtime."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 764
+          },
+          "name": "agentRole",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_iam.Role"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "KMS encryption key."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 768
+          },
+          "name": "encryptionKey",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_kms.Key"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Environment variables to set on the runtime."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 766
+          },
+          "name": "environment",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "CDK scope for creating resources."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 760
+          },
+          "name": "scope",
+          "type": {
+            "fqn": "constructs.Construct"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "System prompt S3 bucket name."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 788
+          },
+          "name": "systemPromptBucket",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "System prompt S3 key."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 790
+          },
+          "name": "systemPromptKey",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Agent tools location definitions (JSON serialized)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 786
+          },
+          "name": "toolsConfig",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Lambda architecture (Lambda hosting only)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 772
+          },
+          "name": "architecture",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.Architecture"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Whether observability is enabled."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 784
+          },
+          "name": "enableObservability",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Knowledge base configs (JSON serialized)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 792
+          },
+          "name": "knowledgeBaseConfigs",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Lambda layers from knowledge bases (Lambda hosting only)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 782
+          },
+          "name": "knowledgeBaseLayers",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_lambda.ILayerVersion"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Knowledge base system prompt addition."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 794
+          },
+          "name": "knowledgeBaseSystemPromptAddition",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Lambda layers from agent definition (Lambda hosting only)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 780
+          },
+          "name": "lambdaLayers",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_lambda.ILayerVersion"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Lambda memory size in MB (Lambda hosting only)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 774
+          },
+          "name": "memorySize",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Optional VPC network configuration."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 770
+          },
+          "name": "network",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.Network"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Removal policy for resources."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 796
+          },
+          "name": "removalPolicy",
+          "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
+            "fqn": "aws-cdk-lib.RemovalPolicy"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "- Only auto-generated permissions from knowledge bases",
-            "remarks": "Use this when knowledge bases require permissions beyond what is\nautomatically generated by the IKnowledgeBase implementations.\nThese statements will be added to the agent's IAM role in addition\nto the auto-generated permissions.",
             "stability": "experimental",
-            "summary": "Additional IAM policy statements for knowledge base access."
+            "summary": "Reserved concurrent executions (Lambda hosting only)."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 83
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 778
           },
-          "name": "additionalPolicyStatementsForKnowledgeBases",
+          "name": "reservedConcurrentExecutions",
           "optional": true,
           "type": {
-            "collection": {
-              "elementtype": {
-                "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
-              },
-              "kind": "array"
-            }
+            "primitive": "number"
           }
         },
         {
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "If tools need additional IAM permissions, these statements would be attached to the Agent's IAM role."
+            "summary": "Lambda timeout (Lambda hosting only)."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 57
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 776
           },
-          "name": "additionalPolicyStatementsForTools",
+          "name": "timeout",
           "optional": true,
           "type": {
-            "collection": {
-              "elementtype": {
-                "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
-              },
-              "kind": "array"
-            }
+            "fqn": "aws-cdk-lib.Duration"
           }
-        },
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/interactive-agent:AgentHostingConfig"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingResult": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Result returned by a hosting adapter's deploy method."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingResult",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/interactive-agent.ts",
+        "line": 802
+      },
+      "name": "AgentHostingResult",
+      "properties": [
         {
           "abstract": true,
           "docs": {
-            "default": "- No knowledge bases configured",
-            "remarks": "When configured, the agent will have access to a built-in retrieval tool\nthat can query these knowledge bases. The agent's system prompt will be\nautomatically augmented with information about available knowledge bases.\n\nEach knowledge base must implement the IKnowledgeBase interface, which\nhandles IAM permission generation and runtime configuration.",
             "stability": "experimental",
-            "summary": "Knowledge bases available to the agent for Retrieval-Augmented Generation (RAG)."
+            "summary": "The agent endpoint URL or ARN."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 71
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 804
           },
-          "name": "knowledgeBases",
-          "optional": true,
+          "name": "endpoint",
           "type": {
-            "collection": {
-              "elementtype": {
-                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase"
-              },
-              "kind": "array"
-            }
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "Any dependencies needed by the provided tools."
+            "summary": "The Lambda function (if Lambda-hosted)."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 51
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 806
           },
-          "name": "lambdaLayers",
+          "name": "agentFunction",
           "optional": true,
           "type": {
-            "collection": {
-              "elementtype": {
-                "fqn": "aws-cdk-lib.aws_lambda.LayerVersion"
-              },
-              "kind": "array"
-            }
+            "fqn": "aws-cdk-lib.aws_lambda.IFunction"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "remarks": "This tools would automatically\nbe loaded by the agent. You can also use this to incorporate other specialized\nagents as tools.",
             "stability": "experimental",
-            "summary": "List of tools defined in python files."
+            "summary": "The AgentCore CfnRuntime (if AgentCore-hosted)."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 46
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 808
           },
-          "name": "tools",
+          "name": "cfnRuntime",
           "optional": true,
           "type": {
-            "collection": {
-              "elementtype": {
-                "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
-              },
-              "kind": "array"
-            }
+            "fqn": "aws-cdk-lib.aws_bedrockagentcore.CfnRuntime"
           }
         }
       ],
-      "symbolId": "use-cases/framework/agents/base-agent:AgentDefinitionProps"
+      "symbolId": "use-cases/framework/agents/interactive-agent:AgentHostingResult"
     },
     "@cdklabs/cdk-appmod-catalog-blueprints.AgentToolsLocationDefinition": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
@@ -5138,7 +5824,7 @@
         },
         "locationInModule": {
           "filename": "use-cases/framework/agents/base-agent.ts",
-          "line": 217
+          "line": 231
         },
         "parameters": [
           {
@@ -5164,7 +5850,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/framework/agents/base-agent.ts",
-        "line": 185
+        "line": 195
       },
       "methods": [
         {
@@ -5179,7 +5865,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 368
+            "line": 382
           },
           "name": "createADOTLayer",
           "protected": true,
@@ -5192,21 +5878,6 @@
       ],
       "name": "BaseAgent",
       "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 186
-          },
-          "name": "agentFunction",
-          "type": {
-            "fqn": "aws-cdk-lib.aws_lambda.IFunction"
-          }
-        },
         {
           "docs": {
             "stability": "experimental"
@@ -5214,7 +5885,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 188
+            "line": 202
           },
           "name": "agentRole",
           "type": {
@@ -5228,7 +5899,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 192
+            "line": 206
           },
           "name": "agentToolsLocationDefinitions",
           "protected": true,
@@ -5248,7 +5919,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 189
+            "line": 203
           },
           "name": "encryptionKey",
           "type": {
@@ -5264,7 +5935,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 200
+            "line": 214
           },
           "name": "knowledgeBaseConfigs",
           "protected": true,
@@ -5286,7 +5957,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 215
+            "line": 229
           },
           "name": "knowledgeBaseLayers",
           "protected": true,
@@ -5307,7 +5978,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 191
+            "line": 205
           },
           "name": "logGroupDataProtection",
           "protected": true,
@@ -5315,6 +5986,24 @@
             "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.LogGroupDataProtectionProps"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "May be undefined for non-Lambda hosting backends (e.g. AgentCore Runtime).",
+            "stability": "experimental",
+            "summary": "The Lambda function for the agent (when using Lambda hosting)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 200
+          },
+          "name": "agentFunction",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.IFunction"
+          }
+        },
         {
           "docs": {
             "stability": "experimental"
@@ -5322,7 +6011,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 187
+            "line": 201
           },
           "name": "bedrockModel",
           "optional": true,
@@ -5339,7 +6028,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 207
+            "line": 221
           },
           "name": "knowledgeBaseToolAsset",
           "optional": true,
@@ -5377,7 +6066,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 96
+            "line": 106
           },
           "name": "agentDefinition",
           "type": {
@@ -5410,7 +6099,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 156
+            "line": 166
           },
           "name": "agentArchitecture",
           "optional": true,
@@ -5430,7 +6119,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 126
+            "line": 136
           },
           "name": "enableObservability",
           "optional": true,
@@ -5448,7 +6137,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 140
+            "line": 150
           },
           "name": "encryptionKey",
           "optional": true,
@@ -5466,7 +6155,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 133
+            "line": 143
           },
           "name": "network",
           "optional": true,
@@ -5484,13 +6173,32 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 148
+            "line": 158
           },
           "name": "removalPolicy",
           "optional": true,
           "type": {
             "fqn": "aws-cdk-lib.RemovalPolicy"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "ServicePrincipal('lambda.amazonaws.com')",
+            "remarks": "This is typically set by the hosting adapter (e.g., `lambda.amazonaws.com`\nfor Lambda hosting, `bedrock-agentcore.amazonaws.com` for AgentCore).",
+            "stability": "experimental",
+            "summary": "The IAM service principal for the agent role's trust policy."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 101
+          },
+          "name": "servicePrincipal",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_iam.ServicePrincipal"
+          }
         }
       ],
       "symbolId": "use-cases/framework/agents/base-agent:BaseAgentProps"
@@ -6494,7 +7202,9 @@
       "properties": [
         {
           "docs": {
-            "stability": "experimental"
+            "remarks": "May be undefined for non-Lambda hosting backends (e.g. AgentCore Runtime).",
+            "stability": "experimental",
+            "summary": "The Lambda function for the agent (when using Lambda hosting)."
           },
           "immutable": true,
           "locationInModule": {
@@ -6502,6 +7212,7 @@
             "line": 75
           },
           "name": "agentFunction",
+          "optional": true,
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
           "type": {
             "fqn": "aws-cdk-lib.aws_lambda.IFunction"
@@ -9028,7 +9739,7 @@
         },
         "locationInModule": {
           "filename": "use-cases/framework/agents/interactive-agent.ts",
-          "line": 602
+          "line": 629
         },
         "parameters": [
           {
@@ -9046,7 +9757,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 588
+        "line": 615
       },
       "methods": [
         {
@@ -9056,7 +9767,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 636
+            "line": 663
           },
           "name": "environmentVariables",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
@@ -9079,7 +9790,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 612
+            "line": 639
           },
           "name": "grantAuthenticate",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
@@ -9103,7 +9814,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 592
+            "line": 619
           },
           "name": "userPool",
           "optional": true,
@@ -9119,7 +9830,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 597
+            "line": 624
           },
           "name": "userPoolClient",
           "optional": true,
@@ -9141,7 +9852,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 532
+        "line": 559
       },
       "name": "CognitoAuthenticatorProps",
       "properties": [
@@ -9155,7 +9866,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 552
+            "line": 579
           },
           "name": "removalPolicy",
           "optional": true,
@@ -9173,7 +9884,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 538
+            "line": 565
           },
           "name": "userPool",
           "optional": true,
@@ -9191,7 +9902,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 545
+            "line": 572
           },
           "name": "userPoolClient",
           "optional": true,
@@ -11356,7 +12067,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 517
+        "line": 544
       },
       "methods": [
         {
@@ -11367,7 +12078,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 526
+            "line": 553
           },
           "name": "environmentVariables",
           "returns": {
@@ -11389,7 +12100,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 521
+            "line": 548
           },
           "name": "grantAuthenticate",
           "parameters": [
@@ -11416,7 +12127,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 33
+        "line": 36
       },
       "methods": [
         {
@@ -11428,7 +12139,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 38
+            "line": 41
           },
           "name": "attachToFunction",
           "parameters": [
@@ -11453,7 +12164,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 43
+            "line": 46
           },
           "name": "grantInvoke",
           "parameters": [
@@ -11472,27 +12183,28 @@
     "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
+        "deprecated": "Use Strands-native `SlidingWindowConversationManager` from\n`strands.agent.conversation_manager` instead. The Python handler now uses\nStrands-native conversation management automatically.",
         "remarks": "Context strategies control how conversation history is maintained and provided\nto the agent. Different strategies enable different conversation patterns.",
-        "stability": "experimental",
+        "stability": "deprecated",
         "summary": "Strategy interface for conversation history management."
       },
       "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy",
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 422
+        "line": 439
       },
       "methods": [
         {
           "abstract": true,
           "docs": {
             "returns": "Environment variables to configure the context manager",
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Get environment variables for Lambda configuration."
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 428
+            "line": 445
           },
           "name": "environmentVariables",
           "returns": {
@@ -11510,6 +12222,72 @@
       "name": "IContextStrategy",
       "symbolId": "use-cases/framework/agents/interactive-agent:IContextStrategy"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "docs": {
+        "remarks": "Hosting adapters encapsulate the infrastructure needed to run an agent.\nThe default implementation is `LambdaHostingAdapter` (Lambda + LWA + API Gateway).\n`AgentCoreRuntimeHostingAdapter` provides an alternative using AgentCore Runtime.",
+        "stability": "experimental",
+        "summary": "Strategy interface for pluggable hosting backends."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/interactive-agent.ts",
+        "line": 818
+      },
+      "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "returns": "The hosting result including endpoint and optional resources",
+            "stability": "experimental",
+            "summary": "Deploy the agent hosting infrastructure."
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 834
+          },
+          "name": "deploy",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "- Configuration for the agent hosting."
+              },
+              "name": "config",
+              "type": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingConfig"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingResult"
+            }
+          }
+        }
+      ],
+      "name": "IHostingAdapter",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "BaseAgent uses this to create the agent role with the correct trust policy.\nFor example, Lambda hosting requires `lambda.amazonaws.com` while AgentCore\nhosting requires `bedrock-agentcore.amazonaws.com`.",
+            "stability": "experimental",
+            "summary": "The IAM service principal that this hosting backend requires."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 826
+          },
+          "name": "servicePrincipal",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_iam.ServicePrincipal"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/interactive-agent:IHostingAdapter"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
@@ -11742,26 +12520,27 @@
     "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
+        "deprecated": "Use Strands-native `S3SessionManager` from `strands.session.s3_session_manager` instead.\nThe Python handler now uses Strands-native session management automatically.",
         "remarks": "Session stores manage conversation state persistence across HTTP requests.\nThe default implementation (S3SessionManager) uses S3 for durable storage.",
-        "stability": "experimental",
+        "stability": "deprecated",
         "summary": "Strategy interface for session persistence."
       },
       "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore",
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 284
+        "line": 290
       },
       "methods": [
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Grant read/write permissions to a Lambda function."
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 295
+            "line": 301
           },
           "name": "grantReadWrite",
           "parameters": [
@@ -11782,13 +12561,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "The S3 bucket used for session storage (if S3-based)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 288
+            "line": 294
           },
           "name": "sessionBucket",
           "optional": true,
@@ -11814,7 +12593,7 @@
         },
         "locationInModule": {
           "filename": "use-cases/framework/agents/interactive-agent.ts",
-          "line": 877
+          "line": 1486
         },
         "parameters": [
           {
@@ -11840,7 +12619,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 868
+        "line": 1476
       },
       "name": "InteractiveAgent",
       "properties": [
@@ -11851,12 +12630,11 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 869
+            "line": 1482
           },
-          "name": "agentFunction",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
+          "name": "apiEndpoint",
           "type": {
-            "fqn": "aws-cdk-lib.aws_lambda.IFunction"
+            "primitive": "string"
           }
         },
         {
@@ -11866,26 +12644,30 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 874
+            "line": 1478
           },
-          "name": "apiEndpoint",
+          "name": "adapter",
+          "optional": true,
           "type": {
-            "primitive": "string"
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
           }
         },
         {
           "docs": {
-            "stability": "experimental"
+            "remarks": "May be undefined for non-Lambda hosting backends (e.g. AgentCore Runtime).",
+            "stability": "experimental",
+            "summary": "The Lambda function for the agent (when using Lambda hosting)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 870
+            "line": 1477
           },
-          "name": "adapter",
+          "name": "agentFunction",
           "optional": true,
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
           "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
+            "fqn": "aws-cdk-lib.aws_lambda.IFunction"
           }
         },
         {
@@ -11895,7 +12677,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 873
+            "line": 1481
           },
           "name": "authenticator",
           "optional": true,
@@ -11910,7 +12692,22 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 872
+            "line": 1484
+          },
+          "name": "cfnRuntime",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_bedrockagentcore.CfnRuntime"
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1480
           },
           "name": "contextStrategy",
           "optional": true,
@@ -11925,7 +12722,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 875
+            "line": 1483
           },
           "name": "sessionBucket",
           "optional": true,
@@ -11940,7 +12737,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 871
+            "line": 1479
           },
           "name": "sessionStore",
           "optional": true,
@@ -11966,7 +12763,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 734
+        "line": 1323
       },
       "name": "InteractiveAgentProps",
       "properties": [
@@ -11980,7 +12777,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 807
+            "line": 1415
           },
           "name": "architecture",
           "optional": true,
@@ -11998,7 +12795,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 786
+            "line": 1394
           },
           "name": "authenticator",
           "optional": true,
@@ -12016,30 +12813,50 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 740
+            "line": 1342
           },
           "name": "communicationAdapter",
           "optional": true,
           "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "SlidingWindowConversationManager with 20 messages",
+            "deprecated": "Conversation management is now handled by Strands-native\n`SlidingWindowConversationManager` in the Python handler.",
+            "stability": "deprecated",
+            "summary": "Context strategy for conversation history management."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 1376
+          },
+          "name": "contextStrategy",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "SlidingWindowConversationManager with 20 messages",
+            "default": "LambdaHostingAdapter",
+            "remarks": "Use `LambdaHostingAdapter` for Lambda + API Gateway (default) or\n`AgentCoreRuntimeHostingAdapter` for AgentCore Runtime hosting.\n\nWhen provided, `communicationAdapter`, `authenticator`, `memorySize`,\n`timeout`, `architecture`, and `reservedConcurrentExecutions` props\nare ignored (configure them on the adapter directly).",
             "stability": "experimental",
-            "summary": "Context strategy for conversation history management."
+            "summary": "Hosting adapter for deploying the agent runtime."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 770
+            "line": 1336
           },
-          "name": "contextStrategy",
+          "name": "hostingAdapter",
           "optional": true,
           "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy"
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter"
           }
         },
         {
@@ -12052,7 +12869,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 793
+            "line": 1401
           },
           "name": "memorySize",
           "optional": true,
@@ -12064,14 +12881,15 @@
           "abstract": true,
           "docs": {
             "default": "20",
+            "deprecated": "Conversation windowing is now handled by Strands-native\n`SlidingWindowConversationManager` in the Python handler (default: 20).",
             "remarks": "Shorthand for SlidingWindowConversationManager windowSize.\nIgnored if contextStrategy is provided.",
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Maximum number of messages to keep in conversation history."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 779
+            "line": 1387
           },
           "name": "messageHistoryLimit",
           "optional": true,
@@ -12089,7 +12907,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 814
+            "line": 1422
           },
           "name": "reservedConcurrentExecutions",
           "optional": true,
@@ -12108,7 +12926,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 756
+            "line": 1360
           },
           "name": "sessionBucket",
           "optional": true,
@@ -12120,14 +12938,15 @@
           "abstract": true,
           "docs": {
             "default": "S3SessionManager with 24-hour TTL",
+            "deprecated": "Session management is now handled by Strands-native `S3SessionManager`.\nAn S3 bucket is always created and passed as `SESSION_BUCKET` env var.",
             "remarks": "Set to undefined to disable session persistence (stateless mode).",
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Session store for persisting conversation state."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 748
+            "line": 1352
           },
           "name": "sessionStore",
           "optional": true,
@@ -12145,7 +12964,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 763
+            "line": 1367
           },
           "name": "sessionTTL",
           "optional": true,
@@ -12163,7 +12982,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 800
+            "line": 1408
           },
           "name": "timeout",
           "optional": true,
@@ -12411,6 +13230,247 @@
       ],
       "symbolId": "use-cases/framework/agents/knowledge-base/knowledge-base-props:KnowledgeBaseRuntimeConfig"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.LambdaHostingAdapter": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "docs": {
+        "remarks": "Deploys the agent as a Lambda function behind Lambda Web Adapter and API Gateway\nREST API with response streaming. This is the default hosting backend.\n\n## Architecture\n\n```\nClient → POST /chat → API Gateway REST API (STREAM) → Lambda (FastAPI + LWA) → Bedrock\nClient ← SSE stream ← API Gateway ← Lambda response streaming ← Agent tokens\n```",
+        "stability": "experimental",
+        "summary": "Lambda hosting adapter for InteractiveAgent."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.LambdaHostingAdapter",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "use-cases/framework/agents/interactive-agent.ts",
+          "line": 905
+        },
+        "parameters": [
+          {
+            "name": "props",
+            "optional": true,
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.LambdaHostingAdapterProps"
+            }
+          }
+        ]
+      },
+      "interfaces": [
+        "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter"
+      ],
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/interactive-agent.ts",
+        "line": 897
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "Deploy Lambda + LWA + API Gateway hosting infrastructure."
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 914
+          },
+          "name": "deploy",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter",
+          "parameters": [
+            {
+              "name": "config",
+              "type": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingConfig"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingResult"
+            }
+          }
+        }
+      ],
+      "name": "LambdaHostingAdapter",
+      "properties": [
+        {
+          "docs": {
+            "remarks": "BaseAgent uses this to create the agent role with the correct trust policy.\nFor example, Lambda hosting requires `lambda.amazonaws.com` while AgentCore\nhosting requires `bedrock-agentcore.amazonaws.com`.",
+            "stability": "experimental",
+            "summary": "The IAM service principal that this hosting backend requires."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 909
+          },
+          "name": "servicePrincipal",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter",
+          "type": {
+            "fqn": "aws-cdk-lib.aws_iam.ServicePrincipal"
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The authenticator."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 901
+          },
+          "name": "authenticator",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator"
+          }
+        },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "The communication adapter."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 899
+          },
+          "name": "communicationAdapter",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/interactive-agent:LambdaHostingAdapter"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.LambdaHostingAdapterProps": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Configuration properties for LambdaHostingAdapter."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.LambdaHostingAdapterProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/interactive-agent.ts",
+        "line": 840
+      },
+      "name": "LambdaHostingAdapterProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "Architecture.X86_64",
+            "stability": "experimental",
+            "summary": "Lambda function architecture."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 874
+          },
+          "name": "architecture",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.Architecture"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "CognitoAuthenticator",
+            "stability": "experimental",
+            "summary": "Authenticator for securing API endpoints."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 853
+          },
+          "name": "authenticator",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "StreamingHttpAdapter",
+            "stability": "experimental",
+            "summary": "Communication adapter for client-agent interaction."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 846
+          },
+          "name": "communicationAdapter",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "1024",
+            "stability": "experimental",
+            "summary": "Lambda function memory size in MB."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 860
+          },
+          "name": "memorySize",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "No reserved concurrency",
+            "stability": "experimental",
+            "summary": "Reserved concurrent executions for the Lambda function."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 881
+          },
+          "name": "reservedConcurrentExecutions",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "Duration.minutes(15)",
+            "stability": "experimental",
+            "summary": "Lambda function timeout."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/interactive-agent.ts",
+            "line": 867
+          },
+          "name": "timeout",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.Duration"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/interactive-agent:LambdaHostingAdapterProps"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.LambdaIamUtils": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
@@ -13701,7 +14761,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 709
+        "line": 736
       },
       "methods": [
         {
@@ -13711,7 +14771,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 720
+            "line": 747
           },
           "name": "environmentVariables",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
@@ -13733,7 +14793,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 713
+            "line": 740
           },
           "name": "grantAuthenticate",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
@@ -13837,8 +14897,9 @@
     "@cdklabs/cdk-appmod-catalog-blueprints.NullConversationManager": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
+        "deprecated": "The Python handler now uses Strands-native conversation management.\nTo disable conversation history, omit the session bucket configuration.",
         "remarks": "Disables conversation history, treating each message as independent.\nUseful for stateless use cases where context is not needed.",
-        "stability": "experimental",
+        "stability": "deprecated",
         "summary": "Null conversation manager for stateless interactions."
       },
       "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.NullConversationManager",
@@ -13853,17 +14914,17 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 499
+        "line": 526
       },
       "methods": [
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Get environment variables for Lambda configuration."
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 503
+            "line": 530
           },
           "name": "environmentVariables",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy",
@@ -14449,18 +15510,19 @@
     "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManager": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
+        "deprecated": "Use Strands-native `S3SessionManager` from `strands.session.s3_session_manager` instead.\nThe Python handler now uses Strands-native session management automatically.\nAn S3 bucket is still created for the Strands session manager; this CDK class\nis no longer needed to configure session persistence.",
         "remarks": "Uses S3 for durable storage of session data with automatic expiration\nvia lifecycle policies. Each HTTP request loads/saves session state,\nenabling multi-turn conversations over stateless HTTP.\n\n## Features\n\n- **Durable Storage**: Sessions persisted to S3 survive Lambda restarts\n- **Automatic Expiration**: Lifecycle policy removes old sessions\n- **Encryption**: KMS encryption at rest\n- **Cost Optimization**: S3 Standard storage with lifecycle management\n\n## Usage\n\n```typescript\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\nimport { InteractiveAgent, S3SessionManager } from '@cdklabs/cdk-appmod-catalog-blueprints';\nimport { Duration } from 'aws-cdk-lib';\n\nconst myPrompt = new Asset(this, 'Prompt', { path: './prompt.txt' });\nconst sessionManager = new S3SessionManager(this, 'SessionManager', {\n  sessionTTL: Duration.hours(48)\n});\n\nconst agent = new InteractiveAgent(this, 'Agent', {\n  agentName: 'ChatAgent',\n  agentDefinition: { bedrockModel: {}, systemPrompt: myPrompt },\n  sessionStore: sessionManager\n});\n```",
-        "stability": "experimental",
+        "stability": "deprecated",
         "summary": "S3-based session manager for persisting conversation state."
       },
       "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManager",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "deprecated"
         },
         "locationInModule": {
           "filename": "use-cases/framework/agents/interactive-agent.ts",
-          "line": 376
+          "line": 389
         },
         "parameters": [
           {
@@ -14490,17 +15552,17 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 365
+        "line": 378
       },
       "methods": [
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Grant read/write permissions to a Lambda function."
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 411
+            "line": 424
           },
           "name": "grantReadWrite",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore",
@@ -14518,13 +15580,13 @@
       "properties": [
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "The S3 bucket used for session storage."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 369
+            "line": 382
           },
           "name": "bucket",
           "type": {
@@ -14533,13 +15595,13 @@
         },
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "The session TTL duration."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 374
+            "line": 387
           },
           "name": "sessionTTL",
           "type": {
@@ -14548,13 +15610,13 @@
         },
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "The S3 bucket used for session storage (ISessionStore interface)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 404
+            "line": 417
           },
           "name": "sessionBucket",
           "optional": true,
@@ -14570,14 +15632,15 @@
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
+        "deprecated": "Use Strands-native `S3SessionManager` from `strands.session.s3_session_manager` instead.",
+        "stability": "deprecated",
         "summary": "Configuration properties for S3SessionManager."
       },
       "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManagerProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 301
+        "line": 309
       },
       "name": "S3SessionManagerProps",
       "properties": [
@@ -14585,13 +15648,13 @@
           "abstract": true,
           "docs": {
             "default": "Auto-created bucket with KMS encryption",
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "S3 bucket for session storage."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 307
+            "line": 315
           },
           "name": "bucket",
           "optional": true,
@@ -14603,13 +15666,13 @@
           "abstract": true,
           "docs": {
             "default": "Auto-created KMS key with rotation enabled",
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "KMS encryption key for the session bucket."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 322
+            "line": 330
           },
           "name": "encryptionKey",
           "optional": true,
@@ -14621,13 +15684,13 @@
           "abstract": true,
           "docs": {
             "default": "RemovalPolicy.DESTROY",
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Removal policy for the session bucket."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 329
+            "line": 337
           },
           "name": "removalPolicy",
           "optional": true,
@@ -14640,13 +15703,13 @@
           "docs": {
             "default": "Duration.hours(24)",
             "remarks": "Sessions older than this duration will be automatically deleted.",
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Time-to-live for sessions."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 315
+            "line": 323
           },
           "name": "sessionTTL",
           "optional": true,
@@ -14660,18 +15723,19 @@
     "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManager": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
+        "deprecated": "Use Strands-native `SlidingWindowConversationManager` from\n`strands.agent.conversation_manager` instead. The Python handler now handles\nconversation windowing natively.",
         "remarks": "Keeps a fixed-size window of recent messages, automatically discarding older\nmessages as new ones arrive. Provides consistent context size for the agent.\n\n## Usage\n\n```typescript\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\nimport { InteractiveAgent, SlidingWindowConversationManager } from '@cdklabs/cdk-appmod-catalog-blueprints';\n\nconst myPrompt = new Asset(this, 'Prompt', { path: './prompt.txt' });\nconst contextManager = new SlidingWindowConversationManager({ windowSize: 30 });\n\nconst agent = new InteractiveAgent(this, 'Agent', {\n  agentName: 'ChatAgent',\n  agentDefinition: { bedrockModel: {}, systemPrompt: myPrompt },\n  contextStrategy: contextManager\n});\n```",
-        "stability": "experimental",
+        "stability": "deprecated",
         "summary": "Sliding window conversation manager for maintaining recent conversation history."
       },
       "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManager",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "deprecated"
         },
         "locationInModule": {
           "filename": "use-cases/framework/agents/interactive-agent.ts",
-          "line": 471
+          "line": 495
         },
         "parameters": [
           {
@@ -14689,17 +15753,17 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 465
+        "line": 489
       },
       "methods": [
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Get environment variables for Lambda configuration."
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 484
+            "line": 508
           },
           "name": "environmentVariables",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy",
@@ -14719,13 +15783,13 @@
       "properties": [
         {
           "docs": {
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "The window size (number of messages to keep)."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 469
+            "line": 493
           },
           "name": "windowSize",
           "type": {
@@ -14739,14 +15803,15 @@
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
       "docs": {
-        "stability": "experimental",
+        "deprecated": "Use Strands-native `SlidingWindowConversationManager` from\n`strands.agent.conversation_manager` instead.",
+        "stability": "deprecated",
         "summary": "Configuration properties for SlidingWindowConversationManager."
       },
       "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManagerProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 434
+        "line": 454
       },
       "name": "SlidingWindowConversationManagerProps",
       "properties": [
@@ -14754,13 +15819,13 @@
           "abstract": true,
           "docs": {
             "default": "20 messages",
-            "stability": "experimental",
+            "stability": "deprecated",
             "summary": "Maximum number of messages to keep in conversation history."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 440
+            "line": 460
           },
           "name": "windowSize",
           "optional": true,
@@ -14884,7 +15949,7 @@
         },
         "locationInModule": {
           "filename": "use-cases/framework/agents/interactive-agent.ts",
-          "line": 142
+          "line": 145
         },
         "parameters": [
           {
@@ -14902,7 +15967,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 128
+        "line": 131
       },
       "methods": [
         {
@@ -14913,7 +15978,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 150
+            "line": 153
           },
           "name": "attachToFunction",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter",
@@ -14939,7 +16004,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 262
+            "line": 265
           },
           "name": "grantInvoke",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter",
@@ -14963,7 +16028,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 137
+            "line": 140
           },
           "name": "apiEndpoint",
           "optional": true,
@@ -14979,7 +16044,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 132
+            "line": 135
           },
           "name": "restApi",
           "optional": true,
@@ -15001,7 +16066,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 64
+        "line": 67
       },
       "name": "StreamingHttpAdapterProps",
       "properties": [
@@ -15015,7 +16080,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 84
+            "line": 87
           },
           "name": "authenticator",
           "optional": true,
@@ -15033,7 +16098,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 70
+            "line": 73
           },
           "name": "stageName",
           "optional": true,
@@ -15051,7 +16116,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 77
+            "line": 80
           },
           "name": "throttle",
           "optional": true,
@@ -15073,7 +16138,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 49
+        "line": 52
       },
       "name": "ThrottleSettings",
       "properties": [
@@ -15086,7 +16151,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 58
+            "line": 61
           },
           "name": "burstLimit",
           "optional": true,
@@ -15103,7 +16168,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 53
+            "line": 56
           },
           "name": "rateLimit",
           "optional": true,
@@ -15360,6 +16425,6 @@
   "usedFeatures": [
     "class-covariant-overrides"
   ],
-  "version": "1.11.0",
-  "fingerprint": "k1Vy5Jvm+m+e5PxZUqAXlPE7jVmnognhWpmeymtqMWM="
+  "version": "1.12.0",
+  "fingerprint": "Y/Ai9a7YLNvJL02nNIXSCkGoH8w8rF7leVRXtbMLcNo="
 }