@cdklabs/cdk-appmod-catalog-blueprints 1.9.0 → 1.9.1

package/.jsii

@@ -4424,6 +4424,62 @@
       ],
       "symbolId": "use-cases/framework/foundation/access-log:AccessLogProps"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.AclConfiguration": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "When enabled, retrieval queries will be filtered based on user identity\ncontext, ensuring users only retrieve documents they have permission to access.",
+        "stability": "experimental",
+        "summary": "Configuration for Access Control List (ACL) based filtering."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AclConfiguration",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+        "line": 39
+      },
+      "name": "AclConfiguration",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "When true, the retrieval tool will require user context and apply\nmetadata filters based on user permissions.",
+            "stability": "experimental",
+            "summary": "Enable ACL-based filtering for retrieval queries."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 48
+          },
+          "name": "enabled",
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'group'",
+            "remarks": "This field in the document metadata should contain the group or\npermission identifier that controls access. The retrieval tool\nwill filter results where this field matches the user's permissions.",
+            "stability": "experimental",
+            "summary": "Metadata field containing access permissions."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 59
+          },
+          "name": "metadataField",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/knowledge-base/knowledge-base-props:AclConfiguration"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.AdditionalDistributionProps": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
@@ -4521,7 +4577,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/base-agent.ts",
-        "line": 25
+        "line": 30
       },
       "name": "AgentDefinitionProps",
       "properties": [
@@ -4534,7 +4590,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 29
+            "line": 34
           },
           "name": "bedrockModel",
           "type": {
@@ -4550,13 +4606,37 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 35
+            "line": 40
           },
           "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": 84
+          },
+          "name": "additionalPolicyStatementsForKnowledgeBases",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
+              },
+              "kind": "array"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4566,7 +4646,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 53
+            "line": 58
           },
           "name": "additionalPolicyStatementsForTools",
           "optional": true,
@@ -4579,6 +4659,30 @@
             }
           }
         },
+        {
+          "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": 72
+          },
+          "name": "knowledgeBases",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase"
+              },
+              "kind": "array"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4588,7 +4692,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 47
+            "line": 52
           },
           "name": "lambdaLayers",
           "optional": true,
@@ -4611,7 +4715,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 42
+            "line": 47
           },
           "name": "tools",
           "optional": true,
@@ -4637,7 +4741,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/base-agent.ts",
-        "line": 15
+        "line": 20
       },
       "name": "AgentToolsLocationDefinition",
       "properties": [
@@ -4649,7 +4753,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 16
+            "line": 21
           },
           "name": "bucketName",
           "type": {
@@ -4664,7 +4768,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 18
+            "line": 23
           },
           "name": "isFile",
           "type": {
@@ -4679,7 +4783,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 19
+            "line": 24
           },
           "name": "isZipArchive",
           "type": {
@@ -4694,7 +4798,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 17
+            "line": 22
           },
           "name": "key",
           "type": {
@@ -5022,7 +5126,10 @@
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "base": "constructs.Construct",
       "docs": {
-        "stability": "experimental"
+        "remarks": "Provides common infrastructure for AI agents including:\n- IAM role and permissions management\n- Encryption key for environment variables\n- Tool integration and S3 asset management\n- Knowledge base integration for RAG (Retrieval-Augmented Generation)\n- Observability configuration (Lambda Powertools + AgentCore)\n\nSubclasses must implement the agent-specific Lambda function creation.\n\n**Observability**: When `enableObservability: true`, BaseAgent configures both\nLambda Powertools (function-level) and AWS Bedrock AgentCore (agent-level)\nobservability. Both systems work together to provide complete visibility:\n- Lambda Powertools captures function execution, logs, and custom metrics\n- AgentCore captures agent reasoning, tool usage, and token consumption\n- Both publish to CloudWatch with correlated service names for unified monitoring\n\nThe observability integration includes:\n- Automatic IAM permission grants for CloudWatch Logs and X-Ray\n- Environment variable configuration for OpenTelemetry\n- ADOT Lambda Layer attachment (handled by concrete implementations)",
+        "see": "https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/observability-configure.html",
+        "stability": "experimental",
+        "summary": "Base class for all agent types in the framework."
       },
       "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
       "initializer": {
@@ -5031,7 +5138,7 @@
         },
         "locationInModule": {
           "filename": "use-cases/framework/agents/base-agent.ts",
-          "line": 107
+          "line": 218
         },
         "parameters": [
           {
@@ -5057,8 +5164,32 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/framework/agents/base-agent.ts",
-        "line": 98
+        "line": 186
       },
+      "methods": [
+        {
+          "docs": {
+            "custom": {
+              "throws": "Error if the region is not supported"
+            },
+            "remarks": "The ADOT layer provides automatic instrumentation for observability.\nLayer versions vary by region - some regions have newer versions with\nbetter Python 3.13 support. If you encounter compatibility issues,\nthe layer ARNs can be found at:\nhttps://aws-otel.github.io/docs/getting-started/lambda#adot-lambda-layer-arns",
+            "returns": "The ADOT Lambda Layer for the current region",
+            "stability": "experimental",
+            "summary": "Creates the AWS Distro for OpenTelemetry (ADOT) Lambda Layer."
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 369
+          },
+          "name": "createADOTLayer",
+          "protected": true,
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_lambda.ILayerVersion"
+            }
+          }
+        }
+      ],
       "name": "BaseAgent",
       "properties": [
         {
@@ -5069,11 +5200,11 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 99
+            "line": 187
           },
           "name": "agentFunction",
           "type": {
-            "fqn": "aws-cdk-lib.aws_lambda.IFunction"
+            "fqn": "@aws-cdk/aws-lambda-python-alpha.PythonFunction"
           }
         },
         {
@@ -5083,7 +5214,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 101
+            "line": 189
           },
           "name": "agentRole",
           "type": {
@@ -5097,7 +5228,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 105
+            "line": 193
           },
           "name": "agentToolsLocationDefinitions",
           "protected": true,
@@ -5117,13 +5248,57 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 102
+            "line": 190
           },
           "name": "encryptionKey",
           "type": {
             "fqn": "aws-cdk-lib.aws_kms.Key"
           }
         },
+        {
+          "docs": {
+            "remarks": "This array contains the exported configurations from all configured\nknowledge bases. Subclasses use this to set the KNOWLEDGE_BASES_CONFIG\nenvironment variable on the agent Lambda function.",
+            "stability": "experimental",
+            "summary": "Knowledge base configurations for runtime use."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 201
+          },
+          "name": "knowledgeBaseConfigs",
+          "protected": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.KnowledgeBaseRuntimeConfig"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "This array contains Lambda layers from all configured knowledge bases.\nSubclasses should add these layers to the agent Lambda function to\nensure retrieval tools have access to required dependencies.",
+            "stability": "experimental",
+            "summary": "Lambda layers required by knowledge base retrieval tools."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 216
+          },
+          "name": "knowledgeBaseLayers",
+          "protected": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "aws-cdk-lib.aws_lambda.LayerVersion"
+              },
+              "kind": "array"
+            }
+          }
+        },
         {
           "docs": {
             "stability": "experimental",
@@ -5132,7 +5307,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 104
+            "line": 192
           },
           "name": "logGroupDataProtection",
           "protected": true,
@@ -5147,13 +5322,31 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 100
+            "line": 188
           },
           "name": "bedrockModel",
           "optional": true,
           "type": {
             "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockModelProps"
           }
+        },
+        {
+          "docs": {
+            "remarks": "This is automatically created when knowledge bases are configured.\nThe asset is added to the agent's tools and granted read access.",
+            "stability": "experimental",
+            "summary": "Asset containing the knowledge base retrieval tool."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 208
+          },
+          "name": "knowledgeBaseToolAsset",
+          "optional": true,
+          "protected": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
+          }
         }
       ],
       "symbolId": "use-cases/framework/agents/base-agent:BaseAgent"
@@ -5171,7 +5364,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/framework/agents/base-agent.ts",
-        "line": 56
+        "line": 87
       },
       "name": "BaseAgentProps",
       "properties": [
@@ -5184,7 +5377,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 66
+            "line": 97
           },
           "name": "agentDefinition",
           "type": {
@@ -5200,24 +5393,44 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 61
+            "line": 92
           },
           "name": "agentName",
           "type": {
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "Architecture.ARM_64",
+            "stability": "experimental",
+            "summary": "The architecture used by the Lambda function where the agent is hosted."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/base-agent.ts",
+            "line": 157
+          },
+          "name": "agentArchitecture",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.Architecture"
+          }
+        },
         {
           "abstract": true,
           "docs": {
             "default": "false",
+            "remarks": "When enabled, configures both Lambda Powertools and AWS Bedrock AgentCore observability:\n- **Lambda Powertools**: Provides function-level observability including structured logging,\n  distributed tracing with X-Ray, and custom metrics\n- **AgentCore Observability**: Provides agent-specific observability including agent invocations,\n  reasoning steps, tool usage, token consumption, and agent latency\n\nBoth systems publish to Amazon CloudWatch and use the same service name and namespace\nfor correlation. This provides complete visibility at both function and agent levels.\n\n**Environment Variables Set** (AgentCore):\n- `AGENT_OBSERVABILITY_ENABLED`: Enables AgentCore observability\n- `OTEL_RESOURCE_ATTRIBUTES`: Service identification for OpenTelemetry\n- `OTEL_EXPORTER_OTLP_LOGS_HEADERS`: Agent identification headers\n- `AWS_LAMBDA_EXEC_WRAPPER`: ADOT wrapper for automatic instrumentation\n\n**IAM Permissions Granted** (AgentCore):\n- CloudWatch Logs: `logs:CreateLogGroup`, `logs:CreateLogStream`, `logs:PutLogEvents`\n- X-Ray: `xray:PutTraceSegments`, `xray:PutTelemetryRecords`\n\n**Additional Requirements**:\n- BatchAgent automatically adds ADOT (AWS Distro for OpenTelemetry) Lambda Layer",
+            "see": "https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/observability-configure.html",
             "stability": "experimental",
-            "summary": "Enable observability."
+            "summary": "Enable observability for the agent."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 73
+            "line": 127
           },
           "name": "enableObservability",
           "optional": true,
@@ -5235,7 +5448,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 87
+            "line": 141
           },
           "name": "encryptionKey",
           "optional": true,
@@ -5253,7 +5466,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 80
+            "line": 134
           },
           "name": "network",
           "optional": true,
@@ -5271,7 +5484,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/base-agent.ts",
-            "line": 95
+            "line": 149
           },
           "name": "removalPolicy",
           "optional": true,
@@ -5891,93 +6104,438 @@
       ],
       "symbolId": "use-cases/document-processing/base-document-processing:BaseDocumentProcessingProps"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.BatchAgent": {
+    "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBase": {
+      "abstract": true,
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "base": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
+      "base": "constructs.Construct",
       "docs": {
-        "stability": "experimental"
+        "remarks": "This class provides common functionality for all knowledge base implementations,\nincluding configuration management, validation, and default behaviors. Concrete\nimplementations (like BedrockKnowledgeBase) extend this class and implement\nthe abstract methods.\n\nThe base class handles:\n- Props validation (name and description are required)\n- Default retrieval configuration (numberOfResults defaults to 5)\n- ACL configuration storage\n- Base runtime configuration export\n\nSubclasses must implement:\n- `generateIamPermissions()`: Return IAM permissions specific to the KB type",
+        "stability": "experimental",
+        "summary": "Abstract base class for knowledge base implementations."
       },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BatchAgent",
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBase",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "custom": {
+            "throws": "Error if description is empty or not provided"
+          },
+          "stability": "experimental",
+          "summary": "Creates a new BaseKnowledgeBase instance."
         },
         "locationInModule": {
-          "filename": "use-cases/framework/agents/batch-agent.ts",
-          "line": 23
+          "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+          "line": 75
         },
         "parameters": [
           {
+            "docs": {
+              "summary": "- The scope in which to define this construct."
+            },
             "name": "scope",
             "type": {
               "fqn": "constructs.Construct"
             }
           },
           {
+            "docs": {
+              "summary": "- The scoped construct ID."
+            },
             "name": "id",
             "type": {
               "primitive": "string"
             }
           },
           {
+            "docs": {
+              "summary": "- Configuration properties for the knowledge base."
+            },
             "name": "props",
             "type": {
-              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BatchAgentProps"
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBaseProps"
             }
           }
         ]
       },
+      "interfaces": [
+        "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase"
+      ],
       "kind": "class",
       "locationInModule": {
-        "filename": "use-cases/framework/agents/batch-agent.ts",
-        "line": 20
+        "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+        "line": 33
       },
-      "name": "BatchAgent",
-      "properties": [
+      "methods": [
         {
           "docs": {
-            "stability": "experimental"
+            "remarks": "Returns a configuration object containing the base knowledge base\nsettings. Subclasses should override this method to add implementation-\nspecific configuration, calling super.exportConfiguration() to include\nthe base configuration.",
+            "returns": "Runtime configuration object for the retrieval tool",
+            "stability": "experimental",
+            "summary": "Export configuration for runtime use by the retrieval tool."
           },
-          "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/batch-agent.ts",
-            "line": 21
+            "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+            "line": 126
           },
-          "name": "agentFunction",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
-          "type": {
-            "fqn": "@aws-cdk/aws-lambda-python-alpha.PythonFunction"
+          "name": "exportConfiguration",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase",
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.KnowledgeBaseRuntimeConfig"
+            }
           }
-        }
-      ],
-      "symbolId": "use-cases/framework/agents/batch-agent:BatchAgent"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.BatchAgentProps": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "datatype": true,
-      "docs": {
-        "stability": "experimental"
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BatchAgentProps",
-      "interfaces": [
-        "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgentProps"
-      ],
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/batch-agent.ts",
-        "line": 15
-      },
-      "name": "BatchAgentProps",
-      "properties": [
+        },
         {
           "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "remarks": "This abstract method must be implemented by subclasses to return the\nspecific IAM permissions needed for their knowledge base type.",
+            "returns": "Array of IAM PolicyStatement objects granting necessary permissions",
+            "stability": "experimental",
+            "summary": "Generate IAM policy statements required for accessing this knowledge base."
           },
-          "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/batch-agent.ts",
-            "line": 16
+            "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+            "line": 114
+          },
+          "name": "generateIamPermissions",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase",
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
+                },
+                "kind": "array"
+              }
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "By default, returns undefined to use the framework's default retrieval\ntool. Subclasses can override this method to provide a custom retrieval\ntool implementation.",
+            "returns": "undefined to use the default retrieval tool",
+            "stability": "experimental",
+            "summary": "Provide the retrieval tool asset for this knowledge base type."
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+            "line": 144
+          },
+          "name": "retrievalToolAsset",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase",
+          "returns": {
+            "optional": true,
+            "type": {
+              "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "By default, returns undefined indicating no additional layers are needed.\nSubclasses can override this method to provide Lambda layers containing\ndependencies required by their retrieval tool.",
+            "returns": "undefined indicating no additional layers needed",
+            "stability": "experimental",
+            "summary": "Provide Lambda layers required by the retrieval tool."
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+            "line": 157
+          },
+          "name": "retrievalToolLayers",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase",
+          "returns": {
+            "optional": true,
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "fqn": "aws-cdk-lib.aws_lambda.LayerVersion"
+                },
+                "kind": "array"
+              }
+            }
+          }
+        },
+        {
+          "docs": {
+            "custom": {
+              "throws": "Error if description is empty or not provided"
+            },
+            "remarks": "Ensures that required fields (name and description) are provided\nand not empty. Subclasses can override this method to add additional\nvalidation, but should call super.validateProps() first.",
+            "stability": "experimental",
+            "summary": "Validates the provided props at construction time."
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+            "line": 97
+          },
+          "name": "validateProps",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "- The props to validate."
+              },
+              "name": "props",
+              "type": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBaseProps"
+              }
+            }
+          ],
+          "protected": true
+        }
+      ],
+      "name": "BaseKnowledgeBase",
+      "properties": [
+        {
+          "docs": {
+            "remarks": "This description is included in the agent's system prompt to help\nthe agent decide when to query this knowledge base.",
+            "stability": "experimental",
+            "summary": "Human-readable description of what this knowledge base contains."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+            "line": 48
+          },
+          "name": "description",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "remarks": "This name is used for logging, display purposes, and to help the agent\nidentify which knowledge base to query.",
+            "stability": "experimental",
+            "summary": "Human-readable name for this knowledge base."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+            "line": 40
+          },
+          "name": "name",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "remarks": "Contains settings like numberOfResults and optional metadata filters.\nDefaults to { numberOfResults: 5 } if not provided.",
+            "stability": "experimental",
+            "summary": "Retrieval configuration for this knowledge base."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+            "line": 56
+          },
+          "name": "retrievalConfig",
+          "protected": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.RetrievalConfiguration"
+          }
+        },
+        {
+          "docs": {
+            "remarks": "When enabled, retrieval queries will be filtered based on user\nidentity context.",
+            "stability": "experimental",
+            "summary": "ACL configuration for identity-aware retrieval."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/base-knowledge-base.ts",
+            "line": 64
+          },
+          "name": "aclConfig",
+          "optional": true,
+          "protected": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AclConfiguration"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/knowledge-base/base-knowledge-base:BaseKnowledgeBase"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBaseProps": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "This interface defines the common properties shared by all knowledge\nbase types. Specific implementations (like BedrockKnowledgeBase) extend\nthis with additional properties.",
+        "stability": "experimental",
+        "summary": "Base configuration for all knowledge base implementations."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBaseProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+        "line": 210
+      },
+      "name": "BaseKnowledgeBaseProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "example": "'Contains product documentation, user guides, and FAQs. Use when answering questions about product features or troubleshooting.'",
+            "remarks": "This description is shown to the agent in its system prompt to help\nit decide when to query this knowledge base. Be specific about the\ntype of information contained and appropriate use cases.",
+            "stability": "experimental",
+            "summary": "Description of what this knowledge base contains and when to use it."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 231
+          },
+          "name": "description",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "example": "'product-documentation'",
+            "remarks": "Used for logging, display purposes, and to help the agent identify\nwhich knowledge base to query. Should be unique within the set of\nknowledge bases configured for an agent.",
+            "stability": "experimental",
+            "summary": "Human-readable name/identifier for this knowledge base."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 220
+          },
+          "name": "name",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- ACL disabled",
+            "remarks": "When enabled, retrieval queries will be filtered based on user\nidentity context to ensure users only access permitted documents.",
+            "stability": "experimental",
+            "summary": "Access control configuration for identity-aware retrieval."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 250
+          },
+          "name": "acl",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AclConfiguration"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "{ numberOfResults: 5 }",
+            "remarks": "Controls the number of results returned and optional metadata filtering.",
+            "stability": "experimental",
+            "summary": "Retrieval configuration options."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 240
+          },
+          "name": "retrieval",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.RetrievalConfiguration"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/knowledge-base/knowledge-base-props:BaseKnowledgeBaseProps"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.BatchAgent": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "base": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BatchAgent",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "use-cases/framework/agents/batch-agent.ts",
+          "line": 77
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BatchAgentProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/batch-agent.ts",
+        "line": 74
+      },
+      "name": "BatchAgent",
+      "properties": [
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/batch-agent.ts",
+            "line": 75
+          },
+          "name": "agentFunction",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
+          "type": {
+            "fqn": "@aws-cdk/aws-lambda-python-alpha.PythonFunction"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/batch-agent:BatchAgent"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.BatchAgentProps": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BatchAgentProps",
+      "interfaces": [
+        "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgentProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/batch-agent.ts",
+        "line": 18
+      },
+      "name": "BatchAgentProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/batch-agent.ts",
+            "line": 19
           },
           "name": "prompt",
           "type": {
@@ -5992,13 +6550,32 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/agents/batch-agent.ts",
-            "line": 17
+            "line": 20
           },
           "name": "expectJson",
           "optional": true,
           "type": {
             "primitive": "boolean"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "InvokeType.BATCH",
+            "remarks": "Defines how the agent is invoked and what processing mode to use.",
+            "stability": "experimental",
+            "summary": "Agent invocation type."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/batch-agent.ts",
+            "line": 29
+          },
+          "name": "invokeType",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.InvokeType"
+          }
         }
       ],
       "symbolId": "use-cases/framework/agents/batch-agent:BatchAgentProps"
@@ -6627,6 +7204,278 @@
       ],
       "symbolId": "use-cases/document-processing/bedrock-document-processing:BedrockDocumentProcessingProps"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.BedrockKnowledgeBase": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "base": "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBase",
+      "docs": {
+        "remarks": "This class provides integration with Amazon Bedrock Knowledge Bases,\nwhich use vector stores (S3 Vectors by default) for semantic search.\nIt is the default knowledge base implementation when none is specified.\n\nThe implementation handles:\n- ARN construction from knowledge base ID (if ARN not provided)\n- IAM permission generation for Bedrock Retrieve and RetrieveAndGenerate APIs\n- Optional guardrail configuration for content filtering\n- Runtime configuration export for the retrieval tool",
+        "stability": "experimental",
+        "summary": "Amazon Bedrock Knowledge Base implementation."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockKnowledgeBase",
+      "initializer": {
+        "docs": {
+          "custom": {
+            "throws": "Error if knowledgeBaseId is empty or not provided"
+          },
+          "stability": "experimental",
+          "summary": "Creates a new BedrockKnowledgeBase instance."
+        },
+        "locationInModule": {
+          "filename": "use-cases/framework/agents/knowledge-base/bedrock-knowledge-base.ts",
+          "line": 92
+        },
+        "parameters": [
+          {
+            "docs": {
+              "summary": "- The scope in which to define this construct."
+            },
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "docs": {
+              "summary": "- The scoped construct ID."
+            },
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "docs": {
+              "summary": "- Configuration properties for the Bedrock Knowledge Base."
+            },
+            "name": "props",
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockKnowledgeBaseProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/knowledge-base/bedrock-knowledge-base.ts",
+        "line": 31
+      },
+      "methods": [
+        {
+          "docs": {
+            "remarks": "Returns a configuration object containing all Bedrock-specific\nsettings needed to query the knowledge base at runtime, including:\n- Base configuration (name, description, retrieval, acl)\n- Knowledge base type ('bedrock')\n- Knowledge base ID and ARN\n- Vector store configuration\n- Guardrail configuration (if present)",
+            "returns": "Runtime configuration object for the retrieval tool",
+            "stability": "experimental",
+            "summary": "Export configuration for runtime use by the retrieval tool."
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/bedrock-knowledge-base.ts",
+            "line": 237
+          },
+          "name": "exportConfiguration",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBase",
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.KnowledgeBaseRuntimeConfig"
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "Returns permissions for:\n- bedrock:Retrieve - Query the knowledge base\n- bedrock:RetrieveAndGenerate - Query and generate responses\n- bedrock:ApplyGuardrail - Apply guardrail (if configured)\n- s3:GetObject - Access S3 vectors (if using S3 Vectors with custom bucket)\n- s3:GetObject - Access data source bucket (if create config provided)\n\nAll permissions are scoped to the specific knowledge base ARN\nfollowing the principle of least privilege.",
+            "returns": "Array of IAM PolicyStatement objects granting necessary permissions",
+            "stability": "experimental",
+            "summary": "Generate IAM policy statements required for accessing this Bedrock Knowledge Base."
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/bedrock-knowledge-base.ts",
+            "line": 170
+          },
+          "name": "generateIamPermissions",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBase",
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
+                },
+                "kind": "array"
+              }
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "Returns an Asset containing the Python retrieval tool that uses\nthe Amazon Bedrock Agent Runtime API to query knowledge bases.\nThis tool is automatically added to agents that use Bedrock\nknowledge bases.",
+            "returns": "Asset containing the Bedrock retrieval tool",
+            "stability": "experimental",
+            "summary": "Provide the Bedrock-specific retrieval tool asset."
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/bedrock-knowledge-base.ts",
+            "line": 258
+          },
+          "name": "retrievalToolAsset",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBase",
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
+            }
+          }
+        }
+      ],
+      "name": "BedrockKnowledgeBase",
+      "properties": [
+        {
+          "docs": {
+            "remarks": "If not provided in props, this is constructed from the knowledgeBaseId\nusing the current region and account.",
+            "stability": "experimental",
+            "summary": "The ARN of the Bedrock Knowledge Base."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/bedrock-knowledge-base.ts",
+            "line": 45
+          },
+          "name": "knowledgeBaseArn",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "docs": {
+            "remarks": "This is the ID assigned by Bedrock when the knowledge base was created.",
+            "stability": "experimental",
+            "summary": "The unique identifier for the Bedrock Knowledge Base."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/bedrock-knowledge-base.ts",
+            "line": 37
+          },
+          "name": "knowledgeBaseId",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/knowledge-base/bedrock-knowledge-base:BedrockKnowledgeBase"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.BedrockKnowledgeBaseProps": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "This interface extends the base configuration with Bedrock-specific\nproperties for connecting to an existing Bedrock Knowledge Base.",
+        "stability": "experimental",
+        "summary": "Configuration for Amazon Bedrock Knowledge Base."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockKnowledgeBaseProps",
+      "interfaces": [
+        "@cdklabs/cdk-appmod-catalog-blueprints.BaseKnowledgeBaseProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+        "line": 259
+      },
+      "name": "BedrockKnowledgeBaseProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "This is the ID assigned by Bedrock when the knowledge base was created.\nYou can find this in the Bedrock console or via the AWS CLI.\n\nRequired when referencing an existing knowledge base.\nNot required when using the `create` property to create a new KB.",
+            "stability": "experimental",
+            "summary": "Unique identifier for the Bedrock Knowledge Base."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 269
+          },
+          "name": "knowledgeBaseId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- Reference existing KB only (no creation)",
+            "remarks": "When provided, a new Bedrock Knowledge Base will be created with\nthe specified data source and embedding configuration.\n\nNote: This is an advanced feature that creates AWS resources.\nFor most use cases, referencing an existing knowledge base by ID\nis recommended.",
+            "stability": "experimental",
+            "summary": "Configuration for creating a new knowledge base."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 314
+          },
+          "name": "create",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.CreateKnowledgeBaseConfiguration"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No guardrail applied",
+            "remarks": "When configured, the guardrail will be applied during retrieval\noperations to filter inappropriate or sensitive content.",
+            "stability": "experimental",
+            "summary": "Guardrail configuration for content filtering."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 300
+          },
+          "name": "guardrail",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.GuardrailConfiguration"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- Constructed from knowledgeBaseId",
+            "remarks": "If not provided, the ARN will be constructed from the knowledgeBaseId\nusing the current region and account.",
+            "stability": "experimental",
+            "summary": "ARN of the Bedrock Knowledge Base."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 279
+          },
+          "name": "knowledgeBaseArn",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- S3 Vectors (type: 's3-vectors')",
+            "remarks": "Defines the type of vector store used by this knowledge base.\nThis is informational and used for generating appropriate IAM\npermissions when needed.",
+            "stability": "experimental",
+            "summary": "Vector store configuration."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 290
+          },
+          "name": "vectorStore",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.VectorStoreConfiguration"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/knowledge-base/knowledge-base-props:BedrockKnowledgeBaseProps"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.BedrockModelProps": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
@@ -7986,6 +8835,108 @@
       ],
       "symbolId": "use-cases/document-processing/chunking-config:CleanupResponse"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.CloudWatchTransactionSearch": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "base": "constructs.Construct",
+      "docs": {
+        "remarks": "This construct configures account-level settings to enable cost-effective\ncollection of all X-Ray spans through CloudWatch Logs. It performs three steps:\n\n1. Creates a CloudWatch Logs resource-based policy allowing X-Ray to send traces\n2. Configures X-Ray to send trace segments to CloudWatch Logs\n3. Sets the sampling percentage for span indexing (default 1%)\n\nThe construct checks if Transaction Search is already enabled and only applies\nconfiguration if needed. It's idempotent and safe to deploy multiple times.\n\n## Benefits\n- Cost-effective: Uses CloudWatch Logs pricing instead of X-Ray pricing\n- Full visibility: All spans are collected and searchable\n- Automatic indexing: 1% of spans indexed by default for trace summaries\n\n## Usage\n```typescript\nnew CloudWatchTransactionSearch(this, 'TransactionSearch', {\n  samplingPercentage: 1  // Optional: 1% is default\n});\n```",
+        "see": "https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Enable-TransactionSearch.html",
+        "stability": "experimental",
+        "summary": "Enables CloudWatch Transaction Search for X-Ray traces."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.CloudWatchTransactionSearch",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        },
+        "locationInModule": {
+          "filename": "use-cases/utilities/observability/cloudwatch-transaction-search.ts",
+          "line": 58
+        },
+        "parameters": [
+          {
+            "name": "scope",
+            "type": {
+              "fqn": "constructs.Construct"
+            }
+          },
+          {
+            "name": "id",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "name": "props",
+            "optional": true,
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.CloudWatchTransactionSearchProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/utilities/observability/cloudwatch-transaction-search.ts",
+        "line": 57
+      },
+      "name": "CloudWatchTransactionSearch",
+      "symbolId": "use-cases/utilities/observability/cloudwatch-transaction-search:CloudWatchTransactionSearch"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.CloudWatchTransactionSearchProps": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Configuration properties for CloudWatch Transaction Search."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.CloudWatchTransactionSearchProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/utilities/observability/cloudwatch-transaction-search.ts",
+        "line": 14
+      },
+      "name": "CloudWatchTransactionSearchProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'TransactionSearchXRayAccess'",
+            "stability": "experimental",
+            "summary": "Name of the CloudWatch Logs resource policy."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/utilities/observability/cloudwatch-transaction-search.ts",
+            "line": 27
+          },
+          "name": "policyName",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "1 (1% of spans indexed)",
+            "stability": "experimental",
+            "summary": "Sampling percentage for span indexing."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/utilities/observability/cloudwatch-transaction-search.ts",
+            "line": 20
+          },
+          "name": "samplingPercentage",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "use-cases/utilities/observability/cloudwatch-transaction-search:CloudWatchTransactionSearchProps"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.CloudfrontDistributionObservabilityPropertyInjector": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
@@ -8063,193 +9014,136 @@
       ],
       "symbolId": "use-cases/utilities/observability/cloudfront-distribution-observability-property-injector:CloudfrontDistributionObservabilityPropertyInjector"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.CognitoAuthenticator": {
+    "@cdklabs/cdk-appmod-catalog-blueprints.CreateKnowledgeBaseConfiguration": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
       "docs": {
-        "remarks": "Creates a Cognito User Pool and integrates with API Gateway REST API\nusing the native COGNITO_USER_POOLS authorizer type. Clients send\nJWT tokens in the Authorization header.\n\n## Features\n\n- **Native JWT Validation**: API Gateway validates tokens without custom Lambda\n- **User Management**: Built-in user registration and management\n- **Password Policies**: Enforces strong password requirements\n- **Account Recovery**: Email-based account recovery\n\n## Usage\n\n```typescript\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\nimport { RemovalPolicy } from 'aws-cdk-lib';\nimport { InteractiveAgent, CognitoAuthenticator } from '@cdklabs/cdk-appmod-catalog-blueprints';\n\nconst myPrompt = new Asset(this, 'Prompt', { path: './prompt.txt' });\nconst authenticator = new CognitoAuthenticator({\n  removalPolicy: RemovalPolicy.RETAIN\n});\n\nconst agent = new InteractiveAgent(this, 'Agent', {\n  agentName: 'ChatAgent',\n  agentDefinition: { bedrockModel: {}, systemPrompt: myPrompt },\n  authenticator\n});\n```",
+        "remarks": "When provided to BedrockKnowledgeBase, a new knowledge base will be\ncreated with the specified data source and embedding configuration.\n\nNote: This is an advanced feature. For most use cases, referencing\nan existing knowledge base by ID is recommended.",
         "stability": "experimental",
-        "summary": "Cognito-based authenticator for securing REST API endpoints."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.CognitoAuthenticator",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        },
-        "locationInModule": {
-          "filename": "use-cases/framework/agents/interactive-agent.ts",
-          "line": 601
-        },
-        "parameters": [
-          {
-            "name": "props",
-            "optional": true,
-            "type": {
-              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.CognitoAuthenticatorProps"
-            }
-          }
-        ]
+        "summary": "Configuration for creating a new Bedrock Knowledge Base."
       },
-      "interfaces": [
-        "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator"
-      ],
-      "kind": "class",
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.CreateKnowledgeBaseConfiguration",
+      "kind": "interface",
       "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 587
+        "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+        "line": 147
       },
-      "methods": [
+      "name": "CreateKnowledgeBaseConfiguration",
+      "properties": [
         {
+          "abstract": true,
           "docs": {
+            "remarks": "The bucket must exist and contain the documents to be indexed.",
             "stability": "experimental",
-            "summary": "Get environment variables for Lambda configuration."
+            "summary": "S3 bucket name containing source documents."
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 635
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 153
           },
-          "name": "environmentVariables",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
-          "returns": {
-            "type": {
-              "collection": {
-                "elementtype": {
-                  "primitive": "string"
-                },
-                "kind": "map"
-              }
-            }
+          "name": "dataSourceBucketName",
+          "type": {
+            "primitive": "string"
           }
         },
         {
+          "abstract": true,
           "docs": {
-            "remarks": "Grants permissions to verify Cognito tokens.",
-            "stability": "experimental",
-            "summary": "Grant authentication permissions to a Lambda function."
-          },
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 611
-          },
-          "name": "grantAuthenticate",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
-          "parameters": [
-            {
-              "name": "lambdaFunction",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_lambda.IFunction"
-              }
-            }
-          ]
-        }
-      ],
-      "name": "CognitoAuthenticator",
-      "properties": [
-        {
-          "docs": {
+            "default": "'fixed-size'",
+            "remarks": "- 'fixed-size': Split documents into fixed-size chunks\n- 'semantic': Use semantic boundaries for chunking\n- 'none': No chunking (use entire documents)",
             "stability": "experimental",
-            "summary": "The Cognito User Pool."
+            "summary": "Chunking strategy for document processing."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 591
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 182
           },
-          "name": "userPool",
+          "name": "chunkingStrategy",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_cognito.UserPool"
+            "primitive": "string"
           }
         },
         {
+          "abstract": true,
           "docs": {
+            "default": "- Root of bucket (all documents)",
+            "remarks": "Only documents under this prefix will be indexed.",
             "stability": "experimental",
-            "summary": "The Cognito User Pool Client."
+            "summary": "S3 prefix for source documents within the bucket."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 596
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 162
           },
-          "name": "userPoolClient",
+          "name": "dataSourcePrefix",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_cognito.UserPoolClient"
+            "primitive": "string"
           }
-        }
-      ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:CognitoAuthenticator"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.CognitoAuthenticatorProps": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "datatype": true,
-      "docs": {
-        "stability": "experimental",
-        "summary": "Configuration properties for CognitoAuthenticator."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.CognitoAuthenticatorProps",
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 531
-      },
-      "name": "CognitoAuthenticatorProps",
-      "properties": [
+        },
         {
           "abstract": true,
           "docs": {
-            "default": "RemovalPolicy.DESTROY",
+            "default": "'amazon.titan-embed-text-v2:0'",
+            "remarks": "Must be a valid Bedrock embedding model ID.",
             "stability": "experimental",
-            "summary": "Removal policy for Cognito resources."
+            "summary": "Embedding model to use for vectorization."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 551
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 171
           },
-          "name": "removalPolicy",
+          "name": "embeddingModelId",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.RemovalPolicy"
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "Auto-created User Pool with secure defaults",
+            "default": "300",
+            "remarks": "Only used when chunkingStrategy is 'fixed-size'.",
             "stability": "experimental",
-            "summary": "Cognito User Pool for authentication."
+            "summary": "Maximum chunk size in tokens (for fixed-size chunking)."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 537
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 191
           },
-          "name": "userPool",
+          "name": "maxTokens",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_cognito.UserPool"
+            "primitive": "number"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "Auto-created client with appropriate auth flows",
+            "default": "20",
+            "remarks": "Only used when chunkingStrategy is 'fixed-size'.",
             "stability": "experimental",
-            "summary": "Cognito User Pool Client."
+            "summary": "Overlap between chunks in tokens (for fixed-size chunking)."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 544
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 200
           },
-          "name": "userPoolClient",
+          "name": "overlapTokens",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_cognito.UserPoolClient"
+            "primitive": "number"
           }
         }
       ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:CognitoAuthenticatorProps"
+      "symbolId": "use-cases/framework/agents/knowledge-base/knowledge-base-props:CreateKnowledgeBaseConfiguration"
     },
     "@cdklabs/cdk-appmod-catalog-blueprints.CustomDomainConfig": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
@@ -9863,6 +10757,61 @@
       ],
       "symbolId": "use-cases/webapp/frontend-construct:FrontendProps"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.GuardrailConfiguration": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Guardrails filter content during retrieval operations to prevent\ninappropriate or sensitive content from being returned.",
+        "stability": "experimental",
+        "summary": "Configuration for Bedrock Guardrails."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.GuardrailConfiguration",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+        "line": 68
+      },
+      "name": "GuardrailConfiguration",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "The guardrail must exist in the same region as the knowledge base.",
+            "stability": "experimental",
+            "summary": "ID of the Bedrock Guardrail to apply."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 74
+          },
+          "name": "guardrailId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'DRAFT'",
+            "remarks": "Use 'DRAFT' for testing or a specific version number for production.",
+            "stability": "experimental",
+            "summary": "Version of the guardrail to use."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 83
+          },
+          "name": "guardrailVersion",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/knowledge-base/knowledge-base-props:GuardrailConfiguration"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.HybridConfig": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
@@ -10208,170 +11157,149 @@
       "name": "IAdapter",
       "symbolId": "use-cases/document-processing/adapter/adapter:IAdapter"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator": {
+    "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
-        "remarks": "Authenticators control how API endpoints are secured.\nDifferent implementations support various authentication methods.",
+        "remarks": "This interface defines the contract that all knowledge base implementations must satisfy,\nallowing different KB backends (Bedrock KB, OpenSearch, custom) to be used interchangeably\nwith the agent framework.\n\nImplementations of this interface are responsible for:\n- Providing metadata about the knowledge base (name, description)\n- Generating the IAM permissions required for the agent to access the KB\n- Exporting runtime configuration for the retrieval tool\n- Optionally providing a custom retrieval tool implementation",
         "stability": "experimental",
-        "summary": "Strategy interface for authentication mechanisms."
+        "summary": "Interface for knowledge base implementations."
       },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase",
       "kind": "interface",
       "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 516
+        "filename": "use-cases/framework/agents/knowledge-base/i-knowledge-base.ts",
+        "line": 22
       },
       "methods": [
         {
           "abstract": true,
           "docs": {
+            "remarks": "This method returns a configuration object that will be serialized\nand passed to the retrieval tool via environment variables. The\nconfiguration includes all information needed to query the KB at runtime.",
+            "returns": "Runtime configuration object for the retrieval tool",
             "stability": "experimental",
-            "summary": "Get environment variables for Lambda configuration."
+            "summary": "Export configuration for runtime use by the retrieval tool."
           },
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 525
+            "filename": "use-cases/framework/agents/knowledge-base/i-knowledge-base.ts",
+            "line": 66
           },
-          "name": "environmentVariables",
+          "name": "exportConfiguration",
           "returns": {
             "type": {
-              "collection": {
-                "elementtype": {
-                  "primitive": "string"
-                },
-                "kind": "map"
-              }
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.KnowledgeBaseRuntimeConfig"
             }
           }
         },
         {
           "abstract": true,
           "docs": {
+            "remarks": "This method returns the IAM permissions that the agent's Lambda function\nrole needs to query this knowledge base. The permissions should follow\nthe principle of least privilege, scoped to the specific resources.",
+            "returns": "Array of IAM PolicyStatement objects granting necessary permissions",
             "stability": "experimental",
-            "summary": "Grant authentication permissions to a Lambda function."
+            "summary": "Generate IAM policy statements required for accessing this knowledge base."
           },
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 520
+            "filename": "use-cases/framework/agents/knowledge-base/i-knowledge-base.ts",
+            "line": 55
           },
-          "name": "grantAuthenticate",
-          "parameters": [
-            {
-              "name": "lambdaFunction",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_lambda.IFunction"
+          "name": "generateIamPermissions",
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
+                },
+                "kind": "array"
               }
             }
-          ]
-        }
-      ],
-      "name": "IAuthenticator",
-      "symbolId": "use-cases/framework/agents/interactive-agent:IAuthenticator"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "docs": {
-        "remarks": "Default implementation is StreamingHttpAdapter (API Gateway REST API with response streaming).",
-        "stability": "experimental",
-        "summary": "Strategy interface for pluggable communication mechanisms."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter",
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 32
-      },
-      "methods": [
+          }
+        },
         {
           "abstract": true,
           "docs": {
-            "remarks": "Returns the public endpoint URL for client connections.",
+            "remarks": "This optional method allows knowledge base implementations to provide\na custom retrieval tool. If not implemented or returns undefined,\nthe framework's default retrieval tool will be used.",
+            "returns": "S3 Asset containing the retrieval tool code, or undefined to use the default",
             "stability": "experimental",
-            "summary": "Attach the adapter to a Lambda function and create communication infrastructure."
+            "summary": "Provide the retrieval tool asset for this knowledge base type."
           },
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 37
+            "filename": "use-cases/framework/agents/knowledge-base/i-knowledge-base.ts",
+            "line": 77
           },
-          "name": "attachToFunction",
-          "parameters": [
-            {
-              "name": "lambdaFunction",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_lambda.IFunction"
-              }
-            }
-          ],
+          "name": "retrievalToolAsset",
           "returns": {
+            "optional": true,
             "type": {
-              "primitive": "string"
+              "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
             }
           }
         },
         {
           "abstract": true,
           "docs": {
+            "remarks": "This optional method allows knowledge base implementations to provide\nLambda layers containing dependencies needed by their retrieval tool.\nFor example, a knowledge base might need specific boto3 versions,\ncustom libraries, or SDK extensions.\n\nThe layers will be added to the agent's Lambda function, making the\ndependencies available to the retrieval tool at runtime.",
+            "returns": "Array of Lambda LayerVersion objects, or undefined if no layers needed",
             "stability": "experimental",
-            "summary": "Grant the Lambda function permission to send responses back to clients."
+            "summary": "Provide Lambda layers required by the retrieval tool."
           },
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 42
+            "filename": "use-cases/framework/agents/knowledge-base/i-knowledge-base.ts",
+            "line": 92
           },
-          "name": "grantInvoke",
-          "parameters": [
-            {
-              "name": "lambdaFunction",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_lambda.IFunction"
+          "name": "retrievalToolLayers",
+          "returns": {
+            "optional": true,
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "fqn": "aws-cdk-lib.aws_lambda.LayerVersion"
+                },
+                "kind": "array"
               }
             }
-          ]
+          }
         }
       ],
-      "name": "ICommunicationAdapter",
-      "symbolId": "use-cases/framework/agents/interactive-agent:ICommunicationAdapter"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "docs": {
-        "remarks": "Context strategies control how conversation history is maintained and provided\nto the agent. Different strategies enable different conversation patterns.",
-        "stability": "experimental",
-        "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": 421
-      },
-      "methods": [
+      "name": "IKnowledgeBase",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "example": "'Contains product documentation, user guides, and FAQs. Use when answering questions about product features or troubleshooting.'",
+            "remarks": "This description is included in the agent's system prompt to help\nthe agent decide when to query this knowledge base. It should clearly\nindicate what type of information the KB contains and when it should\nbe used.",
+            "stability": "experimental",
+            "summary": "Human-readable description of what this knowledge base contains."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/i-knowledge-base.ts",
+            "line": 44
+          },
+          "name": "description",
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
-            "returns": "Environment variables to configure the context manager",
+            "example": "'product-documentation'",
+            "remarks": "This name is used for logging, display purposes, and to help the agent\nidentify which knowledge base to query. It should be unique within\nthe set of knowledge bases configured for an agent.",
             "stability": "experimental",
-            "summary": "Get environment variables for Lambda configuration."
+            "summary": "Human-readable name for this knowledge base."
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 427
+            "filename": "use-cases/framework/agents/knowledge-base/i-knowledge-base.ts",
+            "line": 32
           },
-          "name": "environmentVariables",
-          "returns": {
-            "type": {
-              "collection": {
-                "elementtype": {
-                  "primitive": "string"
-                },
-                "kind": "map"
-              }
-            }
+          "name": "name",
+          "type": {
+            "primitive": "string"
           }
         }
       ],
-      "name": "IContextStrategy",
-      "symbolId": "use-cases/framework/agents/interactive-agent:IContextStrategy"
+      "symbolId": "use-cases/framework/agents/knowledge-base/i-knowledge-base:IKnowledgeBase"
     },
     "@cdklabs/cdk-appmod-catalog-blueprints.IObservable": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
@@ -10458,440 +11386,242 @@
       ],
       "symbolId": "use-cases/utilities/observability/observable:IObservable"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore": {
+    "@cdklabs/cdk-appmod-catalog-blueprints.InvokeType": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
-        "remarks": "Session stores manage conversation state persistence across HTTP requests.\nThe default implementation (S3SessionManager) uses S3 for durable storage.",
+        "remarks": "Defines the processing mode for the agent.\nMust match the Python InvokeType enum in batch.py.",
         "stability": "experimental",
-        "summary": "Strategy interface for session persistence."
+        "summary": "Agent invocation type enumeration."
       },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore",
-      "kind": "interface",
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.InvokeType",
+      "kind": "enum",
       "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 283
+        "filename": "use-cases/framework/agents/invoke-type.ts",
+        "line": 10
       },
-      "methods": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "experimental",
-            "summary": "Grant read/write permissions to a Lambda function."
-          },
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 294
-          },
-          "name": "grantReadWrite",
-          "parameters": [
-            {
-              "docs": {
-                "summary": "- The Lambda function that needs access to the session store."
-              },
-              "name": "lambdaFunction",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_lambda.IFunction"
-              }
-            }
-          ]
-        }
-      ],
-      "name": "ISessionStore",
-      "properties": [
+      "members": [
         {
-          "abstract": true,
           "docs": {
+            "remarks": "Default mode for most agent operations.",
             "stability": "experimental",
-            "summary": "The S3 bucket used for session storage (if S3-based)."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 287
-          },
-          "name": "sessionBucket",
-          "optional": true,
-          "type": {
-            "fqn": "aws-cdk-lib.aws_s3.IBucket"
-          }
-        }
-      ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:ISessionStore"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.InteractiveAgent": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "base": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
-      "docs": {
-        "remarks": "Creates a complete serverless infrastructure for interactive AI conversations\nusing API Gateway REST API with response streaming, Lambda Web Adapter,\nFastAPI, and standard Strands Agent.\n\n## Architecture\n\n```\nClient (fetch + ReadableStream)\n    ↓ POST /chat (Authorization: Bearer JWT)\nAPI Gateway REST API (responseTransferMode: STREAM)\n    ↓ InvokeWithResponseStream\nLambda (Python + Lambda Web Adapter + FastAPI)\n    ↓ strands.Agent streaming\nAmazon Bedrock (Claude)\n```\n\n## Features\n\n- **SSE Streaming**: Real-time token-by-token response streaming\n- **15-Minute Timeout**: Extended timeout for long conversations\n- **Session Management**: S3-based conversation persistence\n- **Context Windowing**: Sliding window conversation history\n- **Cognito Auth**: Native JWT validation on REST API\n- **Strategy Interfaces**: Pluggable adapters for all components\n- **Observability**: Lambda Powertools integration\n\n## Usage\n\n```typescript\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\nimport { InteractiveAgent } from '@cdklabs/cdk-appmod-catalog-blueprints';\n\nconst systemPrompt = new Asset(this, 'Prompt', { path: './prompt.txt' });\n\nconst agent = new InteractiveAgent(this, 'ChatAgent', {\n  agentName: 'MyChatbot',\n  agentDefinition: {\n    bedrockModel: { useCrossRegionInference: true },\n    systemPrompt: systemPrompt,\n  },\n});\n\n// Access outputs\nagent.apiEndpoint;       // REST API endpoint URL\nagent.sessionBucket;     // S3 session bucket\nagent.authenticator;     // Cognito authenticator (for User Pool info)\n```",
-        "stability": "experimental",
-        "summary": "Interactive Agent for real-time conversational AI with SSE streaming."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.InteractiveAgent",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        },
-        "locationInModule": {
-          "filename": "use-cases/framework/agents/interactive-agent.ts",
-          "line": 876
-        },
-        "parameters": [
-          {
-            "name": "scope",
-            "type": {
-              "fqn": "constructs.Construct"
-            }
-          },
-          {
-            "name": "id",
-            "type": {
-              "primitive": "string"
-            }
-          },
-          {
-            "name": "props",
-            "type": {
-              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.InteractiveAgentProps"
-            }
-          }
-        ]
-      },
-      "kind": "class",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 867
-      },
-      "name": "InteractiveAgent",
-      "properties": [
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 868
-          },
-          "name": "agentFunction",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
-          "type": {
-            "fqn": "aws-cdk-lib.aws_lambda.Function"
-          }
-        },
-        {
-          "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 873
+            "summary": "Batch processing mode - processes one document at a time."
           },
-          "name": "apiEndpoint",
-          "type": {
-            "primitive": "string"
-          }
+          "name": "BATCH"
         },
         {
           "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 869
+            "remarks": "For real-time chat and conversational interfaces.",
+            "stability": "experimental",
+            "summary": "Interactive conversation mode (future)."
           },
-          "name": "adapter",
-          "optional": true,
-          "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
-          }
+          "name": "INTERACTIVE"
         },
         {
           "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 872
+            "remarks": "Used for RAG applications, API endpoints, and direct agent calls.",
+            "stability": "experimental",
+            "summary": "Direct invocation mode."
           },
-          "name": "authenticator",
-          "optional": true,
-          "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator"
-          }
+          "name": "ATTACH_DIRECTLY"
         },
         {
           "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 871
+            "remarks": "Used in document processing workflows for classification phase.",
+            "stability": "experimental",
+            "summary": "Document classification step."
           },
-          "name": "contextStrategy",
-          "optional": true,
-          "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy"
-          }
+          "name": "CLASSIFICATION"
         },
         {
           "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 874
+            "remarks": "Used in document processing workflows for extraction/processing phase.",
+            "stability": "experimental",
+            "summary": "Document processing step."
           },
-          "name": "sessionBucket",
-          "optional": true,
-          "type": {
-            "fqn": "aws-cdk-lib.aws_s3.IBucket"
-          }
+          "name": "PROCESSING"
         },
         {
           "docs": {
-            "stability": "experimental"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 870
+            "remarks": "Used in document processing workflows for aggregating chunked results.",
+            "stability": "experimental",
+            "summary": "Document aggregation step."
           },
-          "name": "sessionStore",
-          "optional": true,
-          "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore"
-          }
+          "name": "AGGREGATION"
         }
       ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:InteractiveAgent"
+      "name": "InvokeType",
+      "symbolId": "use-cases/framework/agents/invoke-type:InvokeType"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.InteractiveAgentProps": {
+    "@cdklabs/cdk-appmod-catalog-blueprints.KnowledgeBaseRuntimeConfig": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
       "docs": {
-        "remarks": "Extends BaseAgentProps with communication, session, context, and authentication\nstrategy interfaces for building real-time conversational AI agents.",
+        "remarks": "This interface defines the structure of the configuration object\nthat is serialized and passed to the retrieval tool via environment\nvariables. It contains all information needed to query the knowledge\nbase at runtime.",
         "stability": "experimental",
-        "summary": "Configuration properties for InteractiveAgent."
+        "summary": "Runtime configuration exported for the retrieval tool."
       },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.InteractiveAgentProps",
-      "interfaces": [
-        "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgentProps"
-      ],
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.KnowledgeBaseRuntimeConfig",
       "kind": "interface",
       "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 733
+        "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+        "line": 325
       },
-      "name": "InteractiveAgentProps",
+      "name": "KnowledgeBaseRuntimeConfig",
       "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": 806
-          },
-          "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": 785
-          },
-          "name": "authenticator",
-          "optional": true,
-          "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "StreamingHttpAdapter with CognitoAuthenticator",
             "stability": "experimental",
-            "summary": "Communication adapter for client-agent interaction."
+            "summary": "Description of what this knowledge base contains."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 739
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 334
           },
-          "name": "communicationAdapter",
-          "optional": true,
+          "name": "description",
           "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "SlidingWindowConversationManager with 20 messages",
             "stability": "experimental",
-            "summary": "Context strategy for conversation history management."
+            "summary": "Human-readable name for this knowledge base."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 769
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 329
           },
-          "name": "contextStrategy",
-          "optional": true,
+          "name": "name",
           "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy"
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "1024",
             "stability": "experimental",
-            "summary": "Lambda function memory size in MB."
+            "summary": "Retrieval configuration."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 792
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 363
           },
-          "name": "memorySize",
-          "optional": true,
+          "name": "retrieval",
           "type": {
-            "primitive": "number"
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.RetrievalConfiguration"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "20",
-            "remarks": "Shorthand for SlidingWindowConversationManager windowSize.\nIgnored if contextStrategy is provided.",
             "stability": "experimental",
-            "summary": "Maximum number of messages to keep in conversation history."
+            "summary": "ACL configuration for identity-aware retrieval."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 778
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 368
           },
-          "name": "messageHistoryLimit",
+          "name": "acl",
           "optional": true,
           "type": {
-            "primitive": "number"
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AclConfiguration"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "No reserved concurrency",
             "stability": "experimental",
-            "summary": "Reserved concurrent executions for the Lambda function."
+            "summary": "Guardrail configuration (for Bedrock implementations)."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 813
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 373
           },
-          "name": "reservedConcurrentExecutions",
+          "name": "guardrail",
           "optional": true,
           "type": {
-            "primitive": "number"
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.GuardrailConfiguration"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "Auto-created bucket",
-            "remarks": "Ignored if sessionStore is provided.",
             "stability": "experimental",
-            "summary": "S3 bucket for session storage (shorthand for S3SessionManager)."
+            "summary": "Bedrock Knowledge Base ARN (for Bedrock implementations)."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 755
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 353
           },
-          "name": "sessionBucket",
+          "name": "knowledgeBaseArn",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.aws_s3.IBucket"
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "S3SessionManager with 24-hour TTL",
-            "remarks": "Set to undefined to disable session persistence (stateless mode).",
             "stability": "experimental",
-            "summary": "Session store for persisting conversation state."
+            "summary": "Bedrock Knowledge Base ID (for Bedrock implementations)."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 747
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 348
           },
-          "name": "sessionStore",
+          "name": "knowledgeBaseId",
           "optional": true,
           "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore"
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "Duration.hours(24)",
+            "example": "'bedrock'",
+            "remarks": "Used by the retrieval tool to determine how to query the KB.",
             "stability": "experimental",
-            "summary": "Time-to-live for sessions."
+            "summary": "Type of knowledge base implementation."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 762
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 343
           },
-          "name": "sessionTTL",
+          "name": "type",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.Duration"
+            "primitive": "string"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "Duration.minutes(15)",
             "stability": "experimental",
-            "summary": "Lambda function timeout."
+            "summary": "Vector store configuration (for Bedrock implementations)."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 799
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 358
           },
-          "name": "timeout",
+          "name": "vectorStore",
           "optional": true,
           "type": {
-            "fqn": "aws-cdk-lib.Duration"
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.VectorStoreConfiguration"
           }
         }
       ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:InteractiveAgentProps"
+      "symbolId": "use-cases/framework/agents/knowledge-base/knowledge-base-props:KnowledgeBaseRuntimeConfig"
     },
     "@cdklabs/cdk-appmod-catalog-blueprints.LambdaIamUtils": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
@@ -12154,83 +12884,15 @@
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
             "line": 14
-          },
-          "name": "vpcName",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        }
-      ],
-      "symbolId": "use-cases/framework/foundation/network:NetworkProps"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.NoAuthenticator": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "docs": {
-        "remarks": "Disables authentication entirely, allowing any client to connect\nwithout credentials. This should ONLY be used for development\nand testing environments.\n\n## Security Warning\n\nThis authenticator provides NO security. Never use in production.",
-        "stability": "experimental",
-        "summary": "No-authentication authenticator for development and testing."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.NoAuthenticator",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        }
-      },
-      "interfaces": [
-        "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator"
-      ],
-      "kind": "class",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 708
-      },
-      "methods": [
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Get environment variables for Lambda configuration."
-          },
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 719
-          },
-          "name": "environmentVariables",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
-          "returns": {
-            "type": {
-              "collection": {
-                "elementtype": {
-                  "primitive": "string"
-                },
-                "kind": "map"
-              }
-            }
-          }
-        },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "No-op for NoAuthenticator since no authentication is performed."
-          },
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 712
-          },
-          "name": "grantAuthenticate",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
-          "parameters": [
-            {
-              "name": "_lambdaFunction",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_lambda.IFunction"
-              }
-            }
-          ]
+          },
+          "name": "vpcName",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
-      "name": "NoAuthenticator",
-      "symbolId": "use-cases/framework/agents/interactive-agent:NoAuthenticator"
+      "symbolId": "use-cases/framework/foundation/network:NetworkProps"
     },
     "@cdklabs/cdk-appmod-catalog-blueprints.NoChunkingResponse": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
@@ -12316,54 +12978,6 @@
       ],
       "symbolId": "use-cases/document-processing/chunking-config:NoChunkingResponse"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.NullConversationManager": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "docs": {
-        "remarks": "Disables conversation history, treating each message as independent.\nUseful for stateless use cases where context is not needed.",
-        "stability": "experimental",
-        "summary": "Null conversation manager for stateless interactions."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.NullConversationManager",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        }
-      },
-      "interfaces": [
-        "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy"
-      ],
-      "kind": "class",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 498
-      },
-      "methods": [
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Get environment variables for Lambda configuration."
-          },
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 502
-          },
-          "name": "environmentVariables",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy",
-          "returns": {
-            "type": {
-              "collection": {
-                "elementtype": {
-                  "primitive": "string"
-                },
-                "kind": "map"
-              }
-            }
-          }
-        }
-      ],
-      "name": "NullConversationManager",
-      "symbolId": "use-cases/framework/agents/interactive-agent:NullConversationManager"
-    },
     "@cdklabs/cdk-appmod-catalog-blueprints.ObservableProps": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
@@ -12860,336 +13474,73 @@
           "name": "rawPrefix",
           "optional": true,
           "type": {
-            "primitive": "string"
-          }
-        }
-      ],
-      "symbolId": "use-cases/document-processing/adapter/queued-s3-adapter:QueuedS3AdapterProps"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManager": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "docs": {
-        "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",
-        "summary": "S3-based session manager for persisting conversation state."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManager",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        },
-        "locationInModule": {
-          "filename": "use-cases/framework/agents/interactive-agent.ts",
-          "line": 375
-        },
-        "parameters": [
-          {
-            "name": "scope",
-            "type": {
-              "fqn": "constructs.Construct"
-            }
-          },
-          {
-            "name": "id",
-            "type": {
-              "primitive": "string"
-            }
-          },
-          {
-            "name": "props",
-            "optional": true,
-            "type": {
-              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManagerProps"
-            }
-          }
-        ]
-      },
-      "interfaces": [
-        "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore"
-      ],
-      "kind": "class",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 364
-      },
-      "methods": [
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Grant read/write permissions to a Lambda function."
-          },
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 410
-          },
-          "name": "grantReadWrite",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore",
-          "parameters": [
-            {
-              "name": "lambdaFunction",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_lambda.IFunction"
-              }
-            }
-          ]
-        }
-      ],
-      "name": "S3SessionManager",
-      "properties": [
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "The S3 bucket used for session storage."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 368
-          },
-          "name": "bucket",
-          "type": {
-            "fqn": "aws-cdk-lib.aws_s3.IBucket"
-          }
-        },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "The session TTL duration."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 373
-          },
-          "name": "sessionTTL",
-          "type": {
-            "fqn": "aws-cdk-lib.Duration"
-          }
-        },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "The S3 bucket used for session storage (ISessionStore interface)."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 403
-          },
-          "name": "sessionBucket",
-          "optional": true,
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore",
-          "type": {
-            "fqn": "aws-cdk-lib.aws_s3.IBucket"
-          }
-        }
-      ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:S3SessionManager"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManagerProps": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "datatype": true,
-      "docs": {
-        "stability": "experimental",
-        "summary": "Configuration properties for S3SessionManager."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManagerProps",
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 300
-      },
-      "name": "S3SessionManagerProps",
-      "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "default": "Auto-created bucket with KMS encryption",
-            "stability": "experimental",
-            "summary": "S3 bucket for session storage."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 306
-          },
-          "name": "bucket",
-          "optional": true,
-          "type": {
-            "fqn": "aws-cdk-lib.aws_s3.IBucket"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "Auto-created KMS key with rotation enabled",
-            "stability": "experimental",
-            "summary": "KMS encryption key for the session bucket."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 321
-          },
-          "name": "encryptionKey",
-          "optional": true,
-          "type": {
-            "fqn": "aws-cdk-lib.aws_kms.IKey"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "RemovalPolicy.DESTROY",
-            "stability": "experimental",
-            "summary": "Removal policy for the session bucket."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 328
-          },
-          "name": "removalPolicy",
-          "optional": true,
-          "type": {
-            "fqn": "aws-cdk-lib.RemovalPolicy"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "Duration.hours(24)",
-            "remarks": "Sessions older than this duration will be automatically deleted.",
-            "stability": "experimental",
-            "summary": "Time-to-live for sessions."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 314
-          },
-          "name": "sessionTTL",
-          "optional": true,
-          "type": {
-            "fqn": "aws-cdk-lib.Duration"
-          }
-        }
-      ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:S3SessionManagerProps"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManager": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "docs": {
-        "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",
-        "summary": "Sliding window conversation manager for maintaining recent conversation history."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManager",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        },
-        "locationInModule": {
-          "filename": "use-cases/framework/agents/interactive-agent.ts",
-          "line": 470
-        },
-        "parameters": [
-          {
-            "name": "props",
-            "optional": true,
-            "type": {
-              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManagerProps"
-            }
-          }
-        ]
-      },
-      "interfaces": [
-        "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy"
-      ],
-      "kind": "class",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 464
-      },
-      "methods": [
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "Get environment variables for Lambda configuration."
-          },
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 483
-          },
-          "name": "environmentVariables",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy",
-          "returns": {
-            "type": {
-              "collection": {
-                "elementtype": {
-                  "primitive": "string"
-                },
-                "kind": "map"
-              }
-            }
-          }
-        }
-      ],
-      "name": "SlidingWindowConversationManager",
-      "properties": [
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "The window size (number of messages to keep)."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 468
-          },
-          "name": "windowSize",
-          "type": {
-            "primitive": "number"
+            "primitive": "string"
           }
         }
       ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:SlidingWindowConversationManager"
+      "symbolId": "use-cases/document-processing/adapter/queued-s3-adapter:QueuedS3AdapterProps"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManagerProps": {
+    "@cdklabs/cdk-appmod-catalog-blueprints.RetrievalConfiguration": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
       "docs": {
+        "remarks": "Controls how many results are returned and optional metadata filtering\napplied to all queries against the knowledge base.",
         "stability": "experimental",
-        "summary": "Configuration properties for SlidingWindowConversationManager."
+        "summary": "Configuration for retrieval operations."
       },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManagerProps",
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.RetrievalConfiguration",
       "kind": "interface",
       "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 433
+        "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+        "line": 10
       },
-      "name": "SlidingWindowConversationManagerProps",
+      "name": "RetrievalConfiguration",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "default": "20 messages",
+            "default": "5",
+            "remarks": "Higher values provide more context but increase token usage.\nLower values are faster but may miss relevant information.",
             "stability": "experimental",
-            "summary": "Maximum number of messages to keep in conversation history."
+            "summary": "Number of results to return per query."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 439
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 19
           },
-          "name": "windowSize",
+          "name": "numberOfResults",
           "optional": true,
           "type": {
             "primitive": "number"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No filter applied",
+            "remarks": "This filter is applied in addition to any ACL filters. Use this\nfor static filtering based on document metadata (e.g., document type,\ncategory, or date range).",
+            "stability": "experimental",
+            "summary": "Metadata filter to apply to all queries."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 30
+          },
+          "name": "retrievalFilter",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "any"
+              },
+              "kind": "map"
+            }
+          }
         }
       ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:SlidingWindowConversationManagerProps"
+      "symbolId": "use-cases/framework/agents/knowledge-base/knowledge-base-props:RetrievalConfiguration"
     },
     "@cdklabs/cdk-appmod-catalog-blueprints.StateMachineObservabilityPropertyInjector": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
@@ -13290,250 +13641,6 @@
       ],
       "symbolId": "use-cases/utilities/observability/state-machine-observability-property-injector:StateMachineObservabilityPropertyInjector"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.StreamingHttpAdapter": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "docs": {
-        "remarks": "This adapter creates an API Gateway REST API with response streaming enabled,\nallowing the Lambda function to stream SSE (Server-Sent Events) responses\nback to clients as the Strands Agent generates tokens.\n\n## Architecture\n\n```\nClient → POST /chat → API Gateway REST API (STREAM mode) → Lambda (FastAPI + LWA) → Bedrock\nClient ← SSE stream ← API Gateway ← Lambda response streaming ← Agent tokens\n```\n\n## Features\n\n- **Response Streaming**: Progressive SSE delivery via API Gateway response streaming\n- **15-Minute Timeout**: Extended timeout for long-running agent conversations\n- **Cognito Auth**: Native COGNITO_USER_POOLS authorizer on REST API\n- **CORS**: Built-in CORS support for browser clients\n- **Throttling**: Configurable rate and burst limits\n\n## Example\n\n```typescript\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\nimport { InteractiveAgent, StreamingHttpAdapter } from '@cdklabs/cdk-appmod-catalog-blueprints';\n\nconst myPrompt = new Asset(this, 'Prompt', { path: './prompt.txt' });\nconst adapter = new StreamingHttpAdapter({\n  stageName: 'prod',\n  throttle: { rateLimit: 100, burstLimit: 200 }\n});\n\nconst agent = new InteractiveAgent(this, 'Agent', {\n  agentName: 'ChatAgent',\n  agentDefinition: { bedrockModel: {}, systemPrompt: myPrompt },\n  communicationAdapter: adapter\n});\n```",
-        "stability": "experimental",
-        "summary": "Streaming HTTP adapter for real-time agent communication via SSE."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.StreamingHttpAdapter",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        },
-        "locationInModule": {
-          "filename": "use-cases/framework/agents/interactive-agent.ts",
-          "line": 141
-        },
-        "parameters": [
-          {
-            "name": "props",
-            "optional": true,
-            "type": {
-              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.StreamingHttpAdapterProps"
-            }
-          }
-        ]
-      },
-      "interfaces": [
-        "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
-      ],
-      "kind": "class",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 127
-      },
-      "methods": [
-        {
-          "docs": {
-            "remarks": "Creates API Gateway REST API with POST /chat endpoint and response streaming.",
-            "stability": "experimental",
-            "summary": "Attach the adapter to a Lambda function and create REST API infrastructure."
-          },
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 149
-          },
-          "name": "attachToFunction",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter",
-          "parameters": [
-            {
-              "name": "lambdaFunction",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_lambda.IFunction"
-              }
-            }
-          ],
-          "returns": {
-            "type": {
-              "primitive": "string"
-            }
-          }
-        },
-        {
-          "docs": {
-            "remarks": "For REST API streaming, no additional permissions are needed beyond the invoke permission.",
-            "stability": "experimental",
-            "summary": "Grant the Lambda function permissions for API Gateway integration."
-          },
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 261
-          },
-          "name": "grantInvoke",
-          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter",
-          "parameters": [
-            {
-              "name": "_lambdaFunction",
-              "type": {
-                "fqn": "aws-cdk-lib.aws_lambda.IFunction"
-              }
-            }
-          ]
-        }
-      ],
-      "name": "StreamingHttpAdapter",
-      "properties": [
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "The API endpoint URL."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 136
-          },
-          "name": "apiEndpoint",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "docs": {
-            "stability": "experimental",
-            "summary": "The REST API Gateway."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 131
-          },
-          "name": "restApi",
-          "optional": true,
-          "type": {
-            "fqn": "aws-cdk-lib.aws_apigateway.RestApi"
-          }
-        }
-      ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:StreamingHttpAdapter"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.StreamingHttpAdapterProps": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "datatype": true,
-      "docs": {
-        "stability": "experimental",
-        "summary": "Configuration properties for StreamingHttpAdapter."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.StreamingHttpAdapterProps",
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 63
-      },
-      "name": "StreamingHttpAdapterProps",
-      "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "default": "Uses authenticator from InteractiveAgent",
-            "stability": "experimental",
-            "summary": "Authenticator for securing API endpoints."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 83
-          },
-          "name": "authenticator",
-          "optional": true,
-          "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "'prod'",
-            "stability": "experimental",
-            "summary": "REST API stage name."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 69
-          },
-          "name": "stageName",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "default": "No throttling",
-            "stability": "experimental",
-            "summary": "Throttle settings for REST API."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 76
-          },
-          "name": "throttle",
-          "optional": true,
-          "type": {
-            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ThrottleSettings"
-          }
-        }
-      ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:StreamingHttpAdapterProps"
-    },
-    "@cdklabs/cdk-appmod-catalog-blueprints.ThrottleSettings": {
-      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
-      "datatype": true,
-      "docs": {
-        "stability": "experimental",
-        "summary": "Throttle settings for REST API."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ThrottleSettings",
-      "kind": "interface",
-      "locationInModule": {
-        "filename": "use-cases/framework/agents/interactive-agent.ts",
-        "line": 48
-      },
-      "name": "ThrottleSettings",
-      "properties": [
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "experimental",
-            "summary": "Burst limit (maximum concurrent requests)."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 57
-          },
-          "name": "burstLimit",
-          "optional": true,
-          "type": {
-            "primitive": "number"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "experimental",
-            "summary": "Rate limit (requests per second)."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "use-cases/framework/agents/interactive-agent.ts",
-            "line": 52
-          },
-          "name": "rateLimit",
-          "optional": true,
-          "type": {
-            "primitive": "number"
-          }
-        }
-      ],
-      "symbolId": "use-cases/framework/agents/interactive-agent:ThrottleSettings"
-    },
     "@cdklabs/cdk-appmod-catalog-blueprints.TokenAnalysis": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
@@ -13699,11 +13806,87 @@
         }
       ],
       "symbolId": "use-cases/document-processing/chunking-config:TokenBasedConfig"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.VectorStoreConfiguration": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Defines the type of vector store and any type-specific configuration.\nS3 Vectors is the default and recommended option for most use cases.",
+        "stability": "experimental",
+        "summary": "Configuration for vector store used by the knowledge base."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.VectorStoreConfiguration",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+        "line": 97
+      },
+      "name": "VectorStoreConfiguration",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- Uses Bedrock's default bucket",
+            "remarks": "Only used when type is 's3-vectors'. If not provided, the default\nbucket created by Bedrock will be used.",
+            "stability": "experimental",
+            "summary": "S3 bucket name for S3 Vectors storage."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 118
+          },
+          "name": "bucketName",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'vectors/'",
+            "remarks": "Only used when type is 's3-vectors'.",
+            "stability": "experimental",
+            "summary": "S3 prefix for vectors within the bucket."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 127
+          },
+          "name": "prefix",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'s3-vectors'",
+            "remarks": "- 's3-vectors': Amazon S3 vector storage (default, recommended)\n- 'opensearch-serverless': Amazon OpenSearch Serverless\n- 'pinecone': Pinecone vector database\n- 'rds': Amazon RDS with pgvector",
+            "stability": "experimental",
+            "summary": "Type of vector store."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/agents/knowledge-base/knowledge-base-props.ts",
+            "line": 108
+          },
+          "name": "type",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/agents/knowledge-base/knowledge-base-props:VectorStoreConfiguration"
     }
   },
   "usedFeatures": [
     "class-covariant-overrides"
   ],
-  "version": "1.9.0",
-  "fingerprint": "xvytGAelRs7B61M3lX1JU3Bw0PVw+64a/LGrLn40RpU="
+  "version": "1.9.1",
+  "fingerprint": "9RE/FPihNKHR67T/t6I+ksOFH1qmrIAt6OfKcaal5bs="
 }