@cdklabs/cdk-appmod-catalog-blueprints 1.4.1 → 1.6.0

package/.jsii

@@ -4114,7 +4114,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/cdklabs/cdk-appmod-catalog-blueprints.git",
-  "jsiiVersion": "5.9.14 (build 9fc28bd)",
+  "jsiiVersion": "5.9.22 (build b81c634)",
   "keywords": [
     "cdk"
   ],
@@ -4717,7 +4717,7 @@
         },
         "locationInModule": {
           "filename": "use-cases/document-processing/agentic-document-processing.ts",
-          "line": 17
+          "line": 22
         },
         "parameters": [
           {
@@ -4751,13 +4751,13 @@
       "methods": [
         {
           "docs": {
-            "remarks": "Creates a Lambda function that invokes the configured Bedrock model to extract\nstructured data from the document. Uses the classification result from the\nprevious step to provide context for more accurate extraction.",
+            "remarks": "Creates a Lambda function that invokes the configured Bedrock model to extract\nstructured data from the document. Uses the classification result from the\nprevious step to provide context for more accurate extraction.\n\nThis method caches the Lambda function to avoid creating duplicate resources,\nbut creates a new LambdaInvoke task each time to allow proper state chaining.",
             "stability": "experimental",
             "summary": "Implements the document extraction step using Amazon Bedrock."
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/agentic-document-processing.ts",
-            "line": 21
+            "line": 26
           },
           "name": "processingStep",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockDocumentProcessing",
@@ -4820,6 +4820,203 @@
       ],
       "symbolId": "use-cases/document-processing/agentic-document-processing:AgenticDocumentProcessingProps"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.AggregatedResult": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Combines classification and extraction results into final output.",
+        "stability": "experimental",
+        "summary": "Aggregated result from processing all chunks."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AggregatedResult",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 637
+      },
+      "name": "AggregatedResult",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Summary of chunk processing results."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 664
+          },
+          "name": "chunksSummary",
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunksSummary"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Final document classification (from majority vote or other strategy)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 646
+          },
+          "name": "classification",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "For majority vote: (count of majority / total chunks)",
+            "stability": "experimental",
+            "summary": "Confidence score for the classification (0-1)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 652
+          },
+          "name": "classificationConfidence",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Document identifier."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 641
+          },
+          "name": "documentId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Entities without page numbers are deduplicated by (type, value).\nEntities with page numbers are preserved even if duplicated.",
+            "stability": "experimental",
+            "summary": "Deduplicated entities from all chunks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 659
+          },
+          "name": "entities",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.Entity"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "True if fewer than minSuccessThreshold chunks succeeded.",
+            "stability": "experimental",
+            "summary": "Indicates if result is partial due to chunk failures."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 670
+          },
+          "name": "partialResult",
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:AggregatedResult"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.AggregationRequest": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Contains results from all processed chunks.",
+        "stability": "experimental",
+        "summary": "Request payload for aggregation Lambda."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AggregationRequest",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 590
+      },
+      "name": "AggregationRequest",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Results from all processed chunks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 599
+          },
+          "name": "chunkResults",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkResult"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Document identifier."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 594
+          },
+          "name": "documentId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'majority-vote'",
+            "stability": "experimental",
+            "summary": "Strategy to use for aggregation."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 605
+          },
+          "name": "aggregationStrategy",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:AggregationRequest"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent": {
       "abstract": true,
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
@@ -5155,7 +5352,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 458
+            "line": 546
           },
           "name": "classificationStep",
           "protected": true,
@@ -5177,6 +5374,57 @@
             }
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Concrete implementations can customize this to handle preprocessing results.\nFor example, BedrockDocumentProcessing uses this to add conditional branching\nfor chunked vs non-chunked documents.\n\nImplementations can call `createStandardProcessingWorkflow()` to reuse the\nstandard processing flow (Classification → Processing → Enrichment → PostProcessing).",
+            "returns": "Step Functions chain for processing the document",
+            "stability": "experimental",
+            "summary": "Creates the processing workflow after preprocessing and initialization."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/base-document-processing.ts",
+            "line": 339
+          },
+          "name": "createProcessingWorkflow",
+          "protected": true,
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_stepfunctions.IChainable"
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "This is the existing workflow: Classification → Processing → Enrichment → PostProcessing\nConcrete classes can call this method to reuse the standard flow when they don't\nneed custom workflow branching.",
+            "returns": "Step Functions chain for standard processing",
+            "stability": "experimental",
+            "summary": "Creates the standard processing workflow (no preprocessing customization)."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/base-document-processing.ts",
+            "line": 351
+          },
+          "name": "createStandardProcessingWorkflow",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "Optional prefix for construct IDs to ensure uniqueness when called multiple times."
+              },
+              "name": "idPrefix",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
+            }
+          ],
+          "protected": true,
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_stepfunctions.IChainable"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -5187,7 +5435,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 478
+            "line": 566
           },
           "name": "enrichmentStep",
           "protected": true,
@@ -5240,7 +5488,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 446
+            "line": 289
           },
           "name": "metrics",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IObservable",
@@ -5265,7 +5513,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 488
+            "line": 576
           },
           "name": "postProcessingStep",
           "protected": true,
@@ -5288,6 +5536,64 @@
             }
           }
         },
+        {
+          "docs": {
+            "default": "{} (no additional metadata)",
+            "remarks": "This method is called during InitMetadata creation and allows subclasses to extend\nthe DynamoDB schema with their own fields without the base class knowing the details.\n\nThe base class provides the core document fields (DocumentId, ContentType, etc.),\nand subclasses can add their own fields (e.g., chunking metadata) by overriding this method.",
+            "returns": "Record of additional DynamoDB attribute values to include in InitMetadata",
+            "stability": "experimental",
+            "summary": "Hook for concrete implementations to add preprocessing-specific metadata to DynamoDB."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/base-document-processing.ts",
+            "line": 321
+          },
+          "name": "preprocessingMetadata",
+          "protected": true,
+          "returns": {
+            "type": {
+              "collection": {
+                "elementtype": {
+                  "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.DynamoAttributeValue"
+                },
+                "kind": "map"
+              }
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "This step runs BEFORE Init Metadata and can be used for:\n- Document chunking for large files\n- Document validation\n- Format conversion\n- Any other preprocessing needed before classification\n\nConcrete implementations can return undefined to skip preprocessing,\nmaintaining backward compatibility with existing workflows.",
+            "returns": "Step Functions task for preprocessing, or undefined to skip this step",
+            "stability": "experimental",
+            "summary": "Defines the optional preprocessing step of the workflow."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/base-document-processing.ts",
+            "line": 307
+          },
+          "name": "preprocessingStep",
+          "protected": true,
+          "returns": {
+            "optional": true,
+            "type": {
+              "union": {
+                "types": [
+                  {
+                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.LambdaInvoke"
+                  },
+                  {
+                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.BedrockInvokeModel"
+                  },
+                  {
+                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.StepFunctionsStartExecution"
+                  }
+                ]
+              }
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -5298,7 +5604,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/base-document-processing.ts",
-            "line": 468
+            "line": 556
           },
           "name": "processingStep",
           "protected": true,
@@ -5740,13 +6046,16 @@
       "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockDocumentProcessing",
       "initializer": {
         "docs": {
+          "custom": {
+            "throws": "Error if chunking configuration is invalid"
+          },
           "remarks": "Initializes the Bedrock-powered document processing pipeline with AI classification\nand extraction capabilities. Creates Lambda functions with appropriate IAM roles\nfor Bedrock model invocation and S3 access.",
           "stability": "experimental",
           "summary": "Creates a new BedrockDocumentProcessing construct."
         },
         "locationInModule": {
           "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-          "line": 140
+          "line": 255
         },
         "parameters": [
           {
@@ -5782,19 +6091,19 @@
       "kind": "class",
       "locationInModule": {
         "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-        "line": 92
+        "line": 164
       },
       "methods": [
         {
           "docs": {
-            "remarks": "Creates a Lambda function that invokes the configured Bedrock model to classify\nthe document type. The function reads the document from S3 and sends it to\nBedrock with the classification prompt.",
+            "remarks": "Creates a Lambda function that invokes the configured Bedrock model to classify\nthe document type. The function reads the document from S3 and sends it to\nBedrock with the classification prompt.\n\nThis method caches the Lambda function to avoid creating duplicate resources,\nbut creates a new LambdaInvoke task each time to allow proper state chaining.",
             "returns": "LambdaInvoke task configured for document classification",
             "stability": "experimental",
             "summary": "Implements the document classification step using Amazon Bedrock."
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 160
+            "line": 365
           },
           "name": "classificationStep",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessing",
@@ -5817,6 +6126,26 @@
             }
           }
         },
+        {
+          "docs": {
+            "remarks": "When chunking is enabled, creates a Choice State that:\n- Routes to chunked processing flow if document was chunked\n- Routes to standard processing flow if document was not chunked\n\nWhen chunking is disabled, returns the standard processing workflow.",
+            "returns": "Step Functions chain for processing the document",
+            "stability": "experimental",
+            "summary": "Creates the processing workflow with conditional branching for chunked documents."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/bedrock-document-processing.ts",
+            "line": 716
+          },
+          "name": "createProcessingWorkflow",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessing",
+          "protected": true,
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_stepfunctions.IChainable"
+            }
+          }
+        },
         {
           "docs": {
             "remarks": "If an enrichment Lambda function is provided in the props, creates a LambdaInvoke\ntask to perform additional processing on the extracted data. This step is useful\nfor data validation, transformation, or integration with external systems.",
@@ -5826,7 +6155,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 301
+            "line": 532
           },
           "name": "enrichmentStep",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessing",
@@ -5856,7 +6185,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 278
+            "line": 508
           },
           "name": "generateLambdaRoleForBedrock",
           "parameters": [
@@ -5890,7 +6219,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 321
+            "line": 557
           },
           "name": "postProcessingStep",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessing",
@@ -5916,31 +6245,89 @@
         },
         {
           "docs": {
-            "remarks": "Creates a Lambda function that invokes the configured Bedrock model to extract\nstructured data from the document. Uses the classification result from the\nprevious step to provide context for more accurate extraction.",
-            "returns": "LambdaInvoke task configured for document extraction",
+            "remarks": "When chunking is enabled, adds fields for:\n- ChunkingEnabled: string representation of boolean flag\n- ChunkingStrategy: strategy used (fixed-pages, token-based, hybrid)\n- TokenAnalysis: JSON string with token analysis results\n- ChunkMetadata: JSON string array with chunk information",
+            "returns": "Record of DynamoDB attribute values for chunking metadata",
             "stability": "experimental",
-            "summary": "Implements the document extraction step using Amazon Bedrock."
+            "summary": "Provides additional metadata fields for chunking to be stored in DynamoDB."
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 224
+            "line": 684
           },
-          "name": "processingStep",
+          "name": "preprocessingMetadata",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessing",
           "protected": true,
           "returns": {
             "type": {
-              "union": {
-                "types": [
-                  {
-                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.LambdaInvoke"
-                  },
-                  {
-                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.BedrockInvokeModel"
-                  },
-                  {
-                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.StepFunctionsStartExecution"
-                  }
+              "collection": {
+                "elementtype": {
+                  "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.DynamoAttributeValue"
+                },
+                "kind": "map"
+              }
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "When chunking is enabled, creates a Lambda function that analyzes PDFs and\nsplits large documents into manageable chunks. The function:\n1. Analyzes the PDF to determine page count and token estimates\n2. Decides if chunking is needed based on configured thresholds\n3. If chunking is needed, splits the PDF and uploads chunks to S3",
+            "returns": "LambdaInvoke task for PDF analysis and chunking, or undefined if chunking is disabled",
+            "stability": "experimental",
+            "summary": "Implements the optional preprocessing step for PDF chunking."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/bedrock-document-processing.ts",
+            "line": 585
+          },
+          "name": "preprocessingStep",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessing",
+          "protected": true,
+          "returns": {
+            "optional": true,
+            "type": {
+              "union": {
+                "types": [
+                  {
+                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.LambdaInvoke"
+                  },
+                  {
+                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.BedrockInvokeModel"
+                  },
+                  {
+                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.StepFunctionsStartExecution"
+                  }
+                ]
+              }
+            }
+          }
+        },
+        {
+          "docs": {
+            "remarks": "Creates a Lambda function that invokes the configured Bedrock model to extract\nstructured data from the document. Uses the classification result from the\nprevious step to provide context for more accurate extraction.\n\nThis method caches the Lambda function to avoid creating duplicate resources,\nbut creates a new LambdaInvoke task each time to allow proper state chaining.",
+            "returns": "LambdaInvoke task configured for document extraction",
+            "stability": "experimental",
+            "summary": "Implements the document extraction step using Amazon Bedrock."
+          },
+          "locationInModule": {
+            "filename": "use-cases/document-processing/bedrock-document-processing.ts",
+            "line": 443
+          },
+          "name": "processingStep",
+          "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseDocumentProcessing",
+          "protected": true,
+          "returns": {
+            "type": {
+              "union": {
+                "types": [
+                  {
+                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.LambdaInvoke"
+                  },
+                  {
+                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.BedrockInvokeModel"
+                  },
+                  {
+                    "fqn": "aws-cdk-lib.aws_stepfunctions_tasks.StepFunctionsStartExecution"
+                  }
                 ]
               }
             }
@@ -5957,7 +6344,24 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 93
+            "line": 196
+          },
+          "name": "DEFAULT_AGGREGATION_PROMPT",
+          "protected": true,
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/bedrock-document-processing.ts",
+            "line": 165
           },
           "name": "DEFAULT_CLASSIFICATION_PROMPT",
           "protected": true,
@@ -5974,7 +6378,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 104
+            "line": 176
           },
           "name": "DEFAULT_PROCESSING_PROMPT",
           "protected": true,
@@ -5991,7 +6395,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 125
+            "line": 220
           },
           "name": "bedrockDocumentProcessingProps",
           "protected": true,
@@ -6007,7 +6411,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 127
+            "line": 222
           },
           "name": "stateMachine",
           "type": {
@@ -6032,10 +6436,49 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-        "line": 23
+        "line": 24
       },
       "name": "BedrockDocumentProcessingProps",
       "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "DEFAULT_AGGREGATION_PROMPT",
+            "remarks": "Used when chunking is enabled to merge processing results from all chunks\ninto a single coherent result.\n\nThe prompt receives the concatenated processing results from all chunks\nand should instruct the model to synthesize them into a unified output.",
+            "stability": "experimental",
+            "summary": "Custom prompt template for aggregating results from multiple chunks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/bedrock-document-processing.ts",
+            "line": 72
+          },
+          "name": "aggregationPrompt",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "undefined (uses default configuration when enableChunking is true)",
+            "remarks": "Only applies when `enableChunking` is true. Allows customization of:\n- **Chunking strategy**: How documents are split (fixed-pages, token-based, or hybrid)\n- **Thresholds**: When to trigger chunking based on page count or token count\n- **Chunk size and overlap**: Control chunk boundaries and context preservation\n- **Processing mode**: Parallel (faster) or sequential (cost-optimized)\n- **Aggregation strategy**: How to combine results from multiple chunks\n\n## Default Configuration\n\nIf not provided, uses sensible defaults optimized for most use cases:\n- Strategy: `'hybrid'` (recommended - balances token and page limits)\n- Page threshold: 100 pages\n- Token threshold: 150,000 tokens\n- Processing mode: `'parallel'`\n- Max concurrency: 10\n- Aggregation strategy: `'majority-vote'`\n\n## Strategy Comparison\n\n| Strategy | Best For | Pros | Cons |\n|----------|----------|------|------|\n| `hybrid` | Most documents | Balances token/page limits | Slightly more complex |\n| `token-based` | Variable density | Respects model limits | Slower analysis |\n| `fixed-pages` | Uniform density | Simple, fast | May exceed token limits |",
+            "see": "{@link ChunkingConfig } for detailed configuration options",
+            "stability": "experimental",
+            "summary": "Configuration for PDF chunking behavior."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/bedrock-document-processing.ts",
+            "line": 131
+          },
+          "name": "chunkingConfig",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingConfig"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -6045,7 +6488,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 27
+            "line": 28
           },
           "name": "classificationBedrockModel",
           "optional": true,
@@ -6064,7 +6507,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 38
+            "line": 39
           },
           "name": "classificationPrompt",
           "optional": true,
@@ -6072,6 +6515,25 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "When enabled, documents exceeding configured thresholds will be automatically\nsplit into chunks, processed in parallel or sequentially, and results aggregated.\n\nThis feature is useful for:\n- Processing large PDFs (>100 pages)\n- Handling documents that exceed Bedrock token limits (~200K tokens)\n- Improving processing reliability for complex documents\n- Processing documents with variable content density\n\nThe chunking workflow:\n1. Analyzes PDF to determine page count and estimate token count\n2. Decides if chunking is needed based on configured thresholds\n3. If chunking is needed, splits PDF into chunks and uploads to S3\n4. Processes each chunk through classification and extraction\n5. Aggregates results using majority voting for classification\n6. Deduplicates entities across chunks\n7. Cleans up temporary chunk files from S3",
+            "stability": "experimental",
+            "summary": "Enable PDF chunking for large documents."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/bedrock-document-processing.ts",
+            "line": 97
+          },
+          "name": "enableChunking",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -6082,7 +6544,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 49
+            "line": 50
           },
           "name": "enrichmentLambdaFunction",
           "optional": true,
@@ -6100,7 +6562,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 54
+            "line": 55
           },
           "name": "postProcessingLambdaFunction",
           "optional": true,
@@ -6117,7 +6579,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 32
+            "line": 33
           },
           "name": "processingBedrockModel",
           "optional": true,
@@ -6136,7 +6598,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 44
+            "line": 45
           },
           "name": "processingPrompt",
           "optional": true,
@@ -6154,7 +6616,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/document-processing/bedrock-document-processing.ts",
-            "line": 59
+            "line": 60
           },
           "name": "stepTimeouts",
           "optional": true,
@@ -6210,110 +6672,1319 @@
             "filename": "use-cases/framework/bedrock/bedrock.ts",
             "line": 26
           },
-          "name": "fmModelId",
-          "optional": true,
+          "name": "fmModelId",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_bedrock.FoundationModelIdentifier"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "false",
+            "remarks": "When enabled, uses inference profiles instead of direct model invocation.",
+            "stability": "experimental",
+            "summary": "Enable cross-region inference for Bedrock models to improve availability and performance."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/bedrock/bedrock.ts",
+            "line": 33
+          },
+          "name": "useCrossRegionInference",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/bedrock/bedrock:BedrockModelProps"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.BedrockModelUtils": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "docs": {
+        "stability": "experimental"
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockModelUtils",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/framework/bedrock/bedrock.ts",
+        "line": 42
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/bedrock/bedrock.ts",
+            "line": 43
+          },
+          "name": "deriveActualModelId",
+          "parameters": [
+            {
+              "name": "props",
+              "optional": true,
+              "type": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockModelProps"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/bedrock/bedrock.ts",
+            "line": 48
+          },
+          "name": "generateModelIAMPermissions",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "props",
+              "optional": true,
+              "type": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockModelProps"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
+            }
+          },
+          "static": true
+        }
+      ],
+      "name": "BedrockModelUtils",
+      "symbolId": "use-cases/framework/bedrock/bedrock:BedrockModelUtils"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.ChunkClassificationResult": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Classification result for a chunk."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkClassificationResult",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 517
+      },
+      "name": "ChunkClassificationResult",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 518
+          },
+          "name": "documentClassification",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 519
+          },
+          "name": "confidence",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:ChunkClassificationResult"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.ChunkMetadata": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Contains information about the chunk's position, size, and S3 location.",
+        "stability": "experimental",
+        "summary": "Metadata about a single chunk of a document."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkMetadata",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 297
+      },
+      "name": "ChunkMetadata",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "S3 bucket containing the chunk file."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 338
+          },
+          "name": "bucket",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Format: {documentId}_chunk_{index}",
+            "stability": "experimental",
+            "summary": "Unique identifier for this chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 302
+          },
+          "name": "chunkId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Zero-based index of this chunk in the document."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 307
+          },
+          "name": "chunkIndex",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Ending page number (zero-based, inclusive) of this chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 322
+          },
+          "name": "endPage",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Based on word-count heuristic (1.3 tokens per word).",
+            "stability": "experimental",
+            "summary": "Estimated token count for this chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 333
+          },
+          "name": "estimatedTokens",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Typically in chunks/ prefix.",
+            "stability": "experimental",
+            "summary": "S3 key for the chunk file."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 344
+          },
+          "name": "key",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Number of pages in this chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 327
+          },
+          "name": "pageCount",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Starting page number (zero-based) of this chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 317
+          },
+          "name": "startPage",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Total number of chunks in the document."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 312
+          },
+          "name": "totalChunks",
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:ChunkMetadata"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.ChunkProcessingResult": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Processing result for a chunk."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkProcessingResult",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 525
+      },
+      "name": "ChunkProcessingResult",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 526
+          },
+          "name": "entities",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.Entity"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:ChunkProcessingResult"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.ChunkResult": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Contains classification and extraction results, or error information.",
+        "stability": "experimental",
+        "summary": "Result from processing a single chunk."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkResult",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 533
+      },
+      "name": "ChunkResult",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Chunk identifier."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 537
+          },
+          "name": "chunkId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Zero-based chunk index."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 542
+          },
+          "name": "chunkIndex",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Optional classification result for this chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 547
+          },
+          "name": "classificationResult",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkClassificationResult"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Error message if chunk processing failed."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 557
+          },
+          "name": "error",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Optional extraction result for this chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 552
+          },
+          "name": "processingResult",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkProcessingResult"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:ChunkResult"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingConfig": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "This interface provides fine-grained control over how large PDF documents are\nsplit into manageable chunks for processing. The chunking system supports three\nstrategies, each optimized for different document types and use cases.\n\n## Chunking Strategies\n\n### 1. Hybrid Strategy (RECOMMENDED)\nBalances both token count and page limits for optimal chunking. Best for most\ndocuments as it respects model token limits while preventing excessively large chunks.\n\n### 2. Token-Based Strategy\nSplits documents based on estimated token count. Best for documents with variable\ncontent density (e.g., mixed text and images, tables, charts).\n\n### 3. Fixed-Pages Strategy (Legacy)\nSimple page-based splitting. Fast but may exceed token limits for dense documents.\nUse only for documents with uniform content density.\n\n## Processing Modes\n\n- **parallel**: Process multiple chunks simultaneously (faster, higher cost)\n- **sequential**: Process chunks one at a time (slower, lower cost)\n\n## Aggregation Strategies\n\n- **majority-vote**: Most frequent classification wins (recommended)\n- **weighted-vote**: Early chunks weighted higher\n- **first-chunk**: Use first chunk's classification only\n\n## Default Values\n\n| Parameter | Default | Description |\n|-----------|---------|-------------|\n| strategy | 'hybrid' | Chunking strategy |\n| pageThreshold | 100 | Pages to trigger chunking |\n| tokenThreshold | 150000 | Tokens to trigger chunking |\n| chunkSize | 50 | Pages per chunk (fixed-pages) |\n| overlapPages | 5 | Overlap pages (fixed-pages) |\n| maxTokensPerChunk | 100000 | Max tokens per chunk (token-based) |\n| overlapTokens | 5000 | Overlap tokens (token-based, hybrid) |\n| targetTokensPerChunk | 80000 | Target tokens per chunk (hybrid) |\n| maxPagesPerChunk | 99 | Max pages per chunk (hybrid) |\n| processingMode | 'parallel' | Processing mode |\n| maxConcurrency | 10 | Max parallel chunks |\n| aggregationStrategy | 'majority-vote' | Result aggregation |\n| minSuccessThreshold | 0.5 | Min success rate for valid result |",
+        "stability": "experimental",
+        "summary": "Comprehensive configuration for PDF chunking behavior."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingConfig",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 189
+      },
+      "name": "ChunkingConfig",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'majority-vote'",
+            "remarks": "- **majority-vote**: Most frequent classification wins\n- **weighted-vote**: Early chunks weighted higher\n- **first-chunk**: Use first chunk's classification",
+            "stability": "experimental",
+            "summary": "Strategy for aggregating results from multiple chunks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 282
+          },
+          "name": "aggregationStrategy",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "50",
+            "stability": "experimental",
+            "summary": "Number of pages per chunk (fixed-pages strategy)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 212
+          },
+          "name": "chunkSize",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "10",
+            "remarks": "Higher values increase speed but also cost.",
+            "stability": "experimental",
+            "summary": "Maximum number of chunks to process concurrently (parallel mode only)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 271
+          },
+          "name": "maxConcurrency",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "99",
+            "remarks": "Note: Bedrock has a hard limit of 100 pages per PDF, so we default to 99\nto provide a safety margin.",
+            "stability": "experimental",
+            "summary": "Hard limit on pages per chunk (hybrid strategy)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 246
+          },
+          "name": "maxPagesPerChunk",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "100000",
+            "stability": "experimental",
+            "summary": "Maximum tokens per chunk (token-based strategy)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 231
+          },
+          "name": "maxTokensPerChunk",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "0.5 (50%)",
+            "remarks": "If fewer chunks succeed, the result is marked as partial failure.",
+            "stability": "experimental",
+            "summary": "Minimum percentage of chunks that must succeed for aggregation."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 290
+          },
+          "name": "minSuccessThreshold",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "5",
+            "stability": "experimental",
+            "summary": "Number of overlapping pages between chunks (fixed-pages strategy)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 218
+          },
+          "name": "overlapPages",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "5000",
+            "stability": "experimental",
+            "summary": "Number of overlapping tokens between chunks (token-based and hybrid strategies)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 237
+          },
+          "name": "overlapTokens",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "100",
+            "stability": "experimental",
+            "summary": "Threshold for triggering chunking based on page count (fixed-pages strategy)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 206
+          },
+          "name": "pageThreshold",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'parallel'",
+            "remarks": "- **parallel**: Process multiple chunks simultaneously (faster, higher cost)\n- **sequential**: Process chunks one at a time (slower, lower cost)",
+            "stability": "experimental",
+            "summary": "Processing mode for chunks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 263
+          },
+          "name": "processingMode",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "'hybrid'",
+            "remarks": "- **hybrid** (RECOMMENDED): Balances token count and page limits\n- **token-based**: Respects model token limits, good for variable density\n- **fixed-pages**: Simple page-based splitting (legacy, not recommended)",
+            "stability": "experimental",
+            "summary": "Chunking strategy to use."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 199
+          },
+          "name": "strategy",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "80000",
+            "stability": "experimental",
+            "summary": "Soft target for tokens per chunk (hybrid strategy)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 252
+          },
+          "name": "targetTokensPerChunk",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "150000",
+            "stability": "experimental",
+            "summary": "Threshold for triggering chunking based on token count (token-based strategy)."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 225
+          },
+          "name": "tokenThreshold",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:ChunkingConfig"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingConfigUsed": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Includes both user-provided and default values.",
+        "stability": "experimental",
+        "summary": "Chunking configuration used for processing."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingConfigUsed",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 458
+      },
+      "name": "ChunkingConfigUsed",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 459
+          },
+          "name": "strategy",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 460
+          },
+          "name": "totalPages",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 461
+          },
+          "name": "totalTokens",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 462
+          },
+          "name": "chunkSize",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 467
+          },
+          "name": "maxPagesPerChunk",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 464
+          },
+          "name": "maxTokensPerChunk",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 463
+          },
+          "name": "overlapPages",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 465
+          },
+          "name": "overlapTokens",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 468
+          },
+          "name": "processingMode",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 466
+          },
+          "name": "targetTokensPerChunk",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:ChunkingConfigUsed"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingRequest": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Contains document information and chunking configuration.",
+        "stability": "experimental",
+        "summary": "Request payload for PDF analysis and chunking Lambda."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingRequest",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 376
+      },
+      "name": "ChunkingRequest",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Document content location information."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 391
+          },
+          "name": "content",
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.DocumentContent"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Typically 'file' for S3-based documents.",
+            "stability": "experimental",
+            "summary": "Content type of the document."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 386
+          },
+          "name": "contentType",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Unique identifier for the document."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 380
+          },
+          "name": "documentId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "If not provided, uses default configuration.",
+            "stability": "experimental",
+            "summary": "Optional chunking configuration."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 397
+          },
+          "name": "config",
+          "optional": true,
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingConfig"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:ChunkingRequest"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingResponse": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Document exceeds thresholds and has been split into chunks.",
+        "stability": "experimental",
+        "summary": "Response when chunking IS required."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingResponse",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 475
+      },
+      "name": "ChunkingResponse",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Array of chunk metadata for all created chunks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 499
+          },
+          "name": "chunks",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkMetadata"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Includes both user-provided and default values.",
+            "stability": "experimental",
+            "summary": "Configuration used for chunking."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 505
+          },
+          "name": "config",
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkingConfigUsed"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Document identifier."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 479
+          },
+          "name": "documentId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Indicates chunking is required."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 484
+          },
+          "name": "requiresChunking",
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Strategy used for chunking."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 494
+          },
+          "name": "strategy",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Token analysis results with detailed per-page information."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 489
+          },
+          "name": "tokenAnalysis",
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.TokenAnalysis"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:ChunkingResponse"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.ChunksSummary": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Summary of chunk processing results."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunksSummary",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 611
+      },
+      "name": "ChunksSummary",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Number of chunks that failed processing."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 625
+          },
+          "name": "failedChunks",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Number of chunks that processed successfully."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 620
+          },
+          "name": "successfulChunks",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Total number of chunks created."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 615
+          },
+          "name": "totalChunks",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Optional total tokens processed across all chunks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 630
+          },
+          "name": "totalTokensProcessed",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:ChunksSummary"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.CleanupRequest": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Contains information about chunks to delete.",
+        "stability": "experimental",
+        "summary": "Request payload for cleanup Lambda."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.CleanupRequest",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 677
+      },
+      "name": "CleanupRequest",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Array of chunk metadata for chunks to delete."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 686
+          },
+          "name": "chunks",
           "type": {
-            "fqn": "aws-cdk-lib.aws_bedrock.FoundationModelIdentifier"
+            "collection": {
+              "elementtype": {
+                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ChunkMetadata"
+              },
+              "kind": "array"
+            }
           }
         },
         {
           "abstract": true,
           "docs": {
-            "default": "false",
-            "remarks": "When enabled, uses inference profiles instead of direct model invocation.",
             "stability": "experimental",
-            "summary": "Enable cross-region inference for Bedrock models to improve availability and performance."
+            "summary": "Document identifier."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/bedrock/bedrock.ts",
-            "line": 33
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 681
           },
-          "name": "useCrossRegionInference",
-          "optional": true,
+          "name": "documentId",
           "type": {
-            "primitive": "boolean"
+            "primitive": "string"
           }
         }
       ],
-      "symbolId": "use-cases/framework/bedrock/bedrock:BedrockModelProps"
+      "symbolId": "use-cases/document-processing/chunking-config:CleanupRequest"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.BedrockModelUtils": {
+    "@cdklabs/cdk-appmod-catalog-blueprints.CleanupResponse": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
       "docs": {
-        "stability": "experimental"
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockModelUtils",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        }
+        "remarks": "Reports success and any errors encountered.",
+        "stability": "experimental",
+        "summary": "Response from cleanup Lambda."
       },
-      "kind": "class",
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.CleanupResponse",
+      "kind": "interface",
       "locationInModule": {
-        "filename": "use-cases/framework/bedrock/bedrock.ts",
-        "line": 42
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 693
       },
-      "methods": [
+      "name": "CleanupResponse",
+      "properties": [
         {
+          "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Number of chunks successfully deleted."
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/bedrock/bedrock.ts",
-            "line": 43
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 702
           },
-          "name": "deriveActualModelId",
-          "parameters": [
-            {
-              "name": "props",
-              "optional": true,
-              "type": {
-                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockModelProps"
-              }
-            }
-          ],
-          "returns": {
-            "type": {
-              "primitive": "string"
-            }
+          "name": "deletedChunks",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Document identifier."
           },
-          "static": true
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 697
+          },
+          "name": "documentId",
+          "type": {
+            "primitive": "string"
+          }
         },
         {
+          "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "remarks": "Empty if all deletions succeeded.",
+            "stability": "experimental",
+            "summary": "Array of error messages for failed deletions."
           },
+          "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/bedrock/bedrock.ts",
-            "line": 48
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 708
           },
-          "name": "generateModelIAMPermissions",
-          "parameters": [
-            {
-              "name": "scope",
-              "type": {
-                "fqn": "constructs.Construct"
-              }
-            },
-            {
-              "name": "props",
-              "optional": true,
-              "type": {
-                "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.BedrockModelProps"
-              }
-            }
-          ],
-          "returns": {
-            "type": {
-              "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
+          "name": "errors",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "array"
             }
-          },
-          "static": true
+          }
         }
       ],
-      "name": "BedrockModelUtils",
-      "symbolId": "use-cases/framework/bedrock/bedrock:BedrockModelUtils"
+      "symbolId": "use-cases/document-processing/chunking-config:CleanupResponse"
     },
     "@cdklabs/cdk-appmod-catalog-blueprints.CloudfrontDistributionObservabilityPropertyInjector": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
@@ -6982,114 +8653,281 @@
       "name": "DefaultObservabilityConfig",
       "properties": [
         {
-          "const": true,
+          "const": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Default namespace for powertools."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/utilities/observability/default-observability-config.ts",
+            "line": 12
+          },
+          "name": "DEFAULT_METRIC_NAMESPACE",
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "use-cases/utilities/observability/default-observability-config:DefaultObservabilityConfig"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.DefaultRuntimes": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "docs": {
+        "remarks": "Updating of\nRuntime versions should be done here.",
+        "stability": "experimental",
+        "summary": "Contains default runtimes that would be referenced by Lambda functions in the various use cases."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.DefaultRuntimes",
+      "initializer": {
+        "docs": {
+          "stability": "experimental"
+        }
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/framework/custom-resource/default-runtimes.ts",
+        "line": 11
+      },
+      "name": "DefaultRuntimes",
+      "properties": [
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Default runtime for all Lambda functions in the use cases."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/custom-resource/default-runtimes.ts",
+            "line": 16
+          },
+          "name": "NODEJS",
+          "static": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.Runtime"
+          }
+        },
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Default runtime for Python based Lambda functions."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/custom-resource/default-runtimes.ts",
+            "line": 21
+          },
+          "name": "PYTHON",
+          "static": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_lambda.Runtime"
+          }
+        },
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/custom-resource/default-runtimes.ts",
+            "line": 33
+          },
+          "name": "PYTHON_BUNDLING_IMAGE",
+          "static": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "const": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Default bundling arguments for Python function."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/custom-resource/default-runtimes.ts",
+            "line": 26
+          },
+          "name": "PYTHON_FUNCTION_BUNDLING",
+          "static": true,
+          "type": {
+            "fqn": "@aws-cdk/aws-lambda-python-alpha.BundlingOptions"
+          }
+        }
+      ],
+      "symbolId": "use-cases/framework/custom-resource/default-runtimes:DefaultRuntimes"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.DocumentContent": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Document content location information."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.DocumentContent",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 350
+      },
+      "name": "DocumentContent",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "S3 bucket containing the document."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 359
+          },
+          "name": "bucket",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Original filename of the document."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 369
+          },
+          "name": "filename",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "S3 key for the document."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 364
+          },
+          "name": "key",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "Default namespace for powertools."
+            "summary": "Storage location type (e.g., 's3')."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/utilities/observability/default-observability-config.ts",
-            "line": 12
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 354
           },
-          "name": "DEFAULT_METRIC_NAMESPACE",
-          "static": true,
+          "name": "location",
           "type": {
             "primitive": "string"
           }
         }
       ],
-      "symbolId": "use-cases/utilities/observability/default-observability-config:DefaultObservabilityConfig"
+      "symbolId": "use-cases/document-processing/chunking-config:DocumentContent"
     },
-    "@cdklabs/cdk-appmod-catalog-blueprints.DefaultRuntimes": {
+    "@cdklabs/cdk-appmod-catalog-blueprints.Entity": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
       "docs": {
-        "remarks": "Updating of\nRuntime versions should be done here.",
         "stability": "experimental",
-        "summary": "Contains default runtimes that would be referenced by Lambda functions in the various use cases."
-      },
-      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.DefaultRuntimes",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        }
+        "summary": "Extracted entity from document processing."
       },
-      "kind": "class",
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.Entity",
+      "kind": "interface",
       "locationInModule": {
-        "filename": "use-cases/framework/custom-resource/default-runtimes.ts",
-        "line": 11
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 563
       },
-      "name": "DefaultRuntimes",
+      "name": "Entity",
       "properties": [
         {
-          "const": true,
+          "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "Default runtime for all Lambda functions in the use cases."
+            "summary": "Type of entity (e.g., 'NAME', 'DATE', 'AMOUNT', 'ADDRESS')."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/custom-resource/default-runtimes.ts",
-            "line": 16
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 567
           },
-          "name": "NODEJS",
-          "static": true,
+          "name": "type",
           "type": {
-            "fqn": "aws-cdk-lib.aws_lambda.Runtime"
+            "primitive": "string"
           }
         },
         {
-          "const": true,
+          "abstract": true,
           "docs": {
             "stability": "experimental",
-            "summary": "Default runtime for Python based Lambda functions."
+            "summary": "Value of the entity."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/custom-resource/default-runtimes.ts",
-            "line": 21
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 572
           },
-          "name": "PYTHON",
-          "static": true,
+          "name": "value",
           "type": {
-            "fqn": "aws-cdk-lib.aws_lambda.Runtime"
+            "primitive": "string"
           }
         },
         {
-          "const": true,
+          "abstract": true,
           "docs": {
-            "stability": "experimental"
+            "stability": "experimental",
+            "summary": "Optional chunk index where entity was found."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/custom-resource/default-runtimes.ts",
-            "line": 33
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 583
           },
-          "name": "PYTHON_BUNDLING_IMAGE",
-          "static": true,
+          "name": "chunkIndex",
+          "optional": true,
           "type": {
-            "primitive": "string"
+            "primitive": "number"
           }
         },
         {
-          "const": true,
+          "abstract": true,
           "docs": {
+            "remarks": "Entities with page numbers are preserved even if duplicated.",
             "stability": "experimental",
-            "summary": "Default bundling arguments for Python function."
+            "summary": "Optional page number where entity was found."
           },
           "immutable": true,
           "locationInModule": {
-            "filename": "use-cases/framework/custom-resource/default-runtimes.ts",
-            "line": 26
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 578
           },
-          "name": "PYTHON_FUNCTION_BUNDLING",
-          "static": true,
+          "name": "page",
+          "optional": true,
           "type": {
-            "fqn": "@aws-cdk/aws-lambda-python-alpha.BundlingOptions"
+            "primitive": "number"
           }
         }
       ],
-      "symbolId": "use-cases/framework/custom-resource/default-runtimes:DefaultRuntimes"
+      "symbolId": "use-cases/document-processing/chunking-config:Entity"
     },
     "@cdklabs/cdk-appmod-catalog-blueprints.EventbridgeBroker": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
@@ -7398,6 +9236,81 @@
       "name": "FileType",
       "symbolId": "use-cases/utilities/data-loader:FileType"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.FixedPagesConfig": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Splits documents by fixed page count (legacy approach).",
+        "stability": "experimental",
+        "summary": "Configuration for fixed-pages chunking strategy."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.FixedPagesConfig",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 47
+      },
+      "name": "FixedPagesConfig",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "50",
+            "stability": "experimental",
+            "summary": "Number of pages per chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 59
+          },
+          "name": "chunkSize",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "5",
+            "remarks": "Must be less than chunkSize.",
+            "stability": "experimental",
+            "summary": "Number of overlapping pages between consecutive chunks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 66
+          },
+          "name": "overlapPages",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "100",
+            "remarks": "Documents with pages > threshold will be chunked.",
+            "stability": "experimental",
+            "summary": "Threshold for triggering chunking based on page count."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 53
+          },
+          "name": "pageThreshold",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:FixedPagesConfig"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.Frontend": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "base": "constructs.Construct",
@@ -7762,6 +9675,120 @@
       ],
       "symbolId": "use-cases/webapp/frontend-construct:FrontendProps"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.HybridConfig": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Balances token count and page limits for optimal chunking.",
+        "stability": "experimental",
+        "summary": "Configuration for hybrid chunking strategy (RECOMMENDED)."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.HybridConfig",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 100
+      },
+      "name": "HybridConfig",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "99",
+            "remarks": "Prevents very large chunks even if token count is low.\nNote: Bedrock has a hard limit of 100 pages per PDF, so we default to 99\nto provide a safety margin.",
+            "stability": "experimental",
+            "summary": "Hard limit on pages per chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 108
+          },
+          "name": "maxPagesPerChunk",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "5000",
+            "remarks": "Provides context continuity across chunks.",
+            "stability": "experimental",
+            "summary": "Number of overlapping tokens between consecutive chunks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 136
+          },
+          "name": "overlapTokens",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "100",
+            "remarks": "Documents with pages > threshold will be chunked.",
+            "stability": "experimental",
+            "summary": "Threshold for triggering chunking based on page count."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 122
+          },
+          "name": "pageThreshold",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "80000",
+            "remarks": "Chunks aim for this token count but respect maxPagesPerChunk.",
+            "stability": "experimental",
+            "summary": "Soft target for tokens per chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 115
+          },
+          "name": "targetTokensPerChunk",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "150000",
+            "remarks": "Documents with tokens > threshold will be chunked.",
+            "stability": "experimental",
+            "summary": "Threshold for triggering chunking based on token count."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 129
+          },
+          "name": "tokenThreshold",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:HybridConfig"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "docs": {
@@ -7784,7 +9811,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/adapter/adapter.ts",
-            "line": 47
+            "line": 48
           },
           "name": "createFailedChain",
           "parameters": [
@@ -7796,6 +9823,16 @@
               "type": {
                 "fqn": "constructs.Construct"
               }
+            },
+            {
+              "docs": {
+                "summary": "Optional prefix for construct IDs to ensure uniqueness when called multiple times."
+              },
+              "name": "idPrefix",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
             }
           ],
           "returns": {
@@ -7866,7 +9903,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/adapter/adapter.ts",
-            "line": 54
+            "line": 56
           },
           "name": "createSuccessChain",
           "parameters": [
@@ -7878,6 +9915,16 @@
               "type": {
                 "fqn": "constructs.Construct"
               }
+            },
+            {
+              "docs": {
+                "summary": "Optional prefix for construct IDs to ensure uniqueness when called multiple times."
+              },
+              "name": "idPrefix",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
             }
           ],
           "returns": {
@@ -9026,7 +11073,7 @@
         },
         "locationInModule": {
           "filename": "use-cases/framework/foundation/network.ts",
-          "line": 21
+          "line": 30
         },
         "parameters": [
           {
@@ -9047,22 +11094,58 @@
             "type": {
               "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.NetworkProps"
             }
-          }
-        ]
-      },
-      "kind": "class",
-      "locationInModule": {
-        "filename": "use-cases/framework/foundation/network.ts",
-        "line": 17
-      },
-      "methods": [
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "use-cases/framework/foundation/network.ts",
+        "line": 18
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "experimental"
+          },
+          "locationInModule": {
+            "filename": "use-cases/framework/foundation/network.ts",
+            "line": 19
+          },
+          "name": "useExistingVPCFromLookup",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            },
+            {
+              "name": "id",
+              "type": {
+                "primitive": "string"
+              }
+            },
+            {
+              "name": "options",
+              "type": {
+                "fqn": "aws-cdk-lib.aws_ec2.VpcLookupOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.Network"
+            }
+          },
+          "static": true
+        },
         {
           "docs": {
             "stability": "experimental"
           },
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 89
+            "line": 102
           },
           "name": "applicationSubnetSelection",
           "returns": {
@@ -9077,7 +11160,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 68
+            "line": 81
           },
           "name": "createServiceEndpoint",
           "parameters": [
@@ -9117,11 +11200,11 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 18
+            "line": 27
           },
           "name": "vpc",
           "type": {
-            "fqn": "aws-cdk-lib.aws_ec2.Vpc"
+            "fqn": "aws-cdk-lib.aws_ec2.IVpc"
           }
         }
       ],
@@ -9149,7 +11232,23 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 8
+            "line": 7
+          },
+          "name": "existingVpc",
+          "optional": true,
+          "type": {
+            "fqn": "aws-cdk-lib.aws_ec2.IVpc"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/framework/foundation/network.ts",
+            "line": 9
           },
           "name": "ipAddresses",
           "optional": true,
@@ -9165,7 +11264,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 12
+            "line": 13
           },
           "name": "maxAzs",
           "optional": true,
@@ -9181,7 +11280,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 9
+            "line": 10
           },
           "name": "natGatewayProvider",
           "optional": true,
@@ -9197,7 +11296,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 11
+            "line": 12
           },
           "name": "natGateways",
           "optional": true,
@@ -9213,7 +11312,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 10
+            "line": 11
           },
           "name": "natGatewaySubnets",
           "optional": true,
@@ -9229,7 +11328,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 7
+            "line": 8
           },
           "name": "private",
           "optional": true,
@@ -9245,7 +11344,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 14
+            "line": 15
           },
           "name": "subnetConfiguration",
           "optional": true,
@@ -9266,7 +11365,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "use-cases/framework/foundation/network.ts",
-            "line": 13
+            "line": 14
           },
           "name": "vpcName",
           "optional": true,
@@ -9277,6 +11376,90 @@
       ],
       "symbolId": "use-cases/framework/foundation/network:NetworkProps"
     },
+    "@cdklabs/cdk-appmod-catalog-blueprints.NoChunkingResponse": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Document is below thresholds and will be processed without chunking.",
+        "stability": "experimental",
+        "summary": "Response when chunking is NOT required."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.NoChunkingResponse",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 431
+      },
+      "name": "NoChunkingResponse",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Document identifier."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 435
+          },
+          "name": "documentId",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Example: \"Document has 50 pages, below threshold of 100\"",
+            "stability": "experimental",
+            "summary": "Human-readable reason why chunking was not applied."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 451
+          },
+          "name": "reason",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Indicates chunking is not required."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 440
+          },
+          "name": "requiresChunking",
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Token analysis results."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 445
+          },
+          "name": "tokenAnalysis",
+          "type": {
+            "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.TokenAnalysis"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:NoChunkingResponse"
+    },
     "@cdklabs/cdk-appmod-catalog-blueprints.ObservableProps": {
       "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
       "datatype": true,
@@ -9368,15 +11551,20 @@
       "methods": [
         {
           "docs": {
-            "stability": "experimental"
+            "returns": "Record of environment variables for Lambda configuration",
+            "stability": "experimental",
+            "summary": "Generate default Lambda configuration for Powertools."
           },
           "locationInModule": {
             "filename": "use-cases/utilities/observability/powertools-config.ts",
-            "line": 2
+            "line": 11
           },
           "name": "generateDefaultLambdaConfig",
           "parameters": [
             {
+              "docs": {
+                "summary": "- Whether observability is enabled."
+              },
               "name": "enableObservability",
               "optional": true,
               "type": {
@@ -9384,6 +11572,9 @@
               }
             },
             {
+              "docs": {
+                "summary": "- CloudWatch metrics namespace."
+              },
               "name": "metricsNamespace",
               "optional": true,
               "type": {
@@ -9391,11 +11582,25 @@
               }
             },
             {
+              "docs": {
+                "summary": "- Service name for logging and metrics."
+              },
               "name": "serviceName",
               "optional": true,
               "type": {
                 "primitive": "string"
               }
+            },
+            {
+              "docs": {
+                "remarks": "Defaults to INFO.",
+                "summary": "- Log level (INFO, ERROR, DEBUG, WARNING)."
+              },
+              "name": "logLevel",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
             }
           ],
           "returns": {
@@ -9455,7 +11660,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
-            "line": 272
+            "line": 285
           },
           "name": "createFailedChain",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
@@ -9465,6 +11670,13 @@
               "type": {
                 "fqn": "constructs.Construct"
               }
+            },
+            {
+              "name": "idPrefix",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
             }
           ],
           "returns": {
@@ -9481,7 +11693,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
-            "line": 148
+            "line": 161
           },
           "name": "createIngressTrigger",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
@@ -9523,7 +11735,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
-            "line": 301
+            "line": 315
           },
           "name": "createSuccessChain",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
@@ -9533,6 +11745,13 @@
               "type": {
                 "fqn": "constructs.Construct"
               }
+            },
+            {
+              "name": "idPrefix",
+              "optional": true,
+              "type": {
+                "primitive": "string"
+              }
             }
           ],
           "returns": {
@@ -9548,7 +11767,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
-            "line": 235
+            "line": 248
           },
           "name": "generateAdapterIAMPolicies",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
@@ -9591,7 +11810,7 @@
           },
           "locationInModule": {
             "filename": "use-cases/document-processing/adapter/queued-s3-adapter.ts",
-            "line": 101
+            "line": 114
           },
           "name": "init",
           "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAdapter",
@@ -9841,8 +12060,174 @@
         }
       ],
       "symbolId": "use-cases/utilities/observability/state-machine-observability-property-injector:StateMachineObservabilityPropertyInjector"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.TokenAnalysis": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Provides information about document size and token distribution.",
+        "stability": "experimental",
+        "summary": "Token analysis results from PDF analysis."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.TokenAnalysis",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 404
+      },
+      "name": "TokenAnalysis",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Average tokens per page across the document."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 418
+          },
+          "name": "avgTokensPerPage",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Total number of pages in the document."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 413
+          },
+          "name": "totalPages",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "Total estimated tokens in the document."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 408
+          },
+          "name": "totalTokens",
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Used for token-based and hybrid chunking strategies.",
+            "stability": "experimental",
+            "summary": "Optional detailed token count for each page."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 424
+          },
+          "name": "tokensPerPage",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "number"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:TokenAnalysis"
+    },
+    "@cdklabs/cdk-appmod-catalog-blueprints.TokenBasedConfig": {
+      "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
+      "datatype": true,
+      "docs": {
+        "remarks": "Splits documents based on estimated token count to respect model limits.",
+        "stability": "experimental",
+        "summary": "Configuration for token-based chunking strategy."
+      },
+      "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.TokenBasedConfig",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "use-cases/document-processing/chunking-config.ts",
+        "line": 73
+      },
+      "name": "TokenBasedConfig",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "default": "100000",
+            "remarks": "Ensures no chunk exceeds model token limits.",
+            "stability": "experimental",
+            "summary": "Maximum tokens per chunk."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 86
+          },
+          "name": "maxTokensPerChunk",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "5000",
+            "remarks": "Provides context continuity across chunks.",
+            "stability": "experimental",
+            "summary": "Number of overlapping tokens between consecutive chunks."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 93
+          },
+          "name": "overlapTokens",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "150000",
+            "remarks": "Documents with tokens > threshold will be chunked.",
+            "stability": "experimental",
+            "summary": "Threshold for triggering chunking based on token count."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "use-cases/document-processing/chunking-config.ts",
+            "line": 79
+          },
+          "name": "tokenThreshold",
+          "optional": true,
+          "type": {
+            "primitive": "number"
+          }
+        }
+      ],
+      "symbolId": "use-cases/document-processing/chunking-config:TokenBasedConfig"
     }
   },
-  "version": "1.4.1",
-  "fingerprint": "YMoqjoSyxLeE4i0O8hTfbgkjfz/S2fY22EWcDdG21Cw="
+  "version": "1.6.0",
+  "fingerprint": "OFueXi+qz7VtZikZI7xIiECQ4G4YmwKdt5yPvDM79d4="
 }