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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/.jsii +1276 -211
  2. package/lib/document-processing/adapter/queued-s3-adapter.js +1 -1
  3. package/lib/document-processing/agentic-document-processing.js +2 -2
  4. package/lib/document-processing/base-document-processing.js +1 -1
  5. package/lib/document-processing/bedrock-document-processing.js +1 -1
  6. package/lib/document-processing/default-document-processing-config.js +1 -1
  7. package/lib/framework/agents/base-agent.d.ts +15 -2
  8. package/lib/framework/agents/base-agent.js +3 -3
  9. package/lib/framework/agents/batch-agent.d.ts +1 -1
  10. package/lib/framework/agents/batch-agent.js +2 -2
  11. package/lib/framework/agents/default-agent-config.js +1 -1
  12. package/lib/framework/agents/interactive-agent.d.ts +286 -3
  13. package/lib/framework/agents/interactive-agent.js +412 -123
  14. package/lib/framework/agents/knowledge-base/base-knowledge-base.js +1 -1
  15. package/lib/framework/agents/knowledge-base/bedrock-knowledge-base.js +1 -1
  16. package/lib/framework/agents/resources/agentcore-agent-handler/Dockerfile +20 -0
  17. package/lib/framework/agents/resources/agentcore-agent-handler/main.py +224 -0
  18. package/lib/framework/agents/resources/agentcore-agent-handler/requirements.txt +5 -0
  19. package/lib/framework/agents/resources/interactive-agent-handler/index.py +16 -93
  20. package/lib/framework/agents/resources/interactive-agent-handler/test_handler.py +214 -413
  21. package/lib/framework/bedrock/bedrock.js +1 -1
  22. package/lib/framework/custom-resource/default-runtimes.js +1 -1
  23. package/lib/framework/foundation/access-log.js +1 -1
  24. package/lib/framework/foundation/eventbridge-broker.js +1 -1
  25. package/lib/framework/foundation/network.js +1 -1
  26. package/lib/framework/tests/interactive-agent-nag.test.js +56 -1
  27. package/lib/framework/tests/interactive-agent.test.js +257 -11
  28. package/lib/tsconfig.tsbuildinfo +1 -1
  29. package/lib/utilities/data-loader.js +1 -1
  30. package/lib/utilities/lambda-iam-utils.js +1 -1
  31. package/lib/utilities/observability/cloudfront-distribution-observability-property-injector.js +1 -1
  32. package/lib/utilities/observability/cloudwatch-transaction-search.js +1 -1
  33. package/lib/utilities/observability/default-observability-config.js +1 -1
  34. package/lib/utilities/observability/lambda-observability-property-injector.js +1 -1
  35. package/lib/utilities/observability/log-group-data-protection-utils.js +1 -1
  36. package/lib/utilities/observability/powertools-config.js +1 -1
  37. package/lib/utilities/observability/state-machine-observability-property-injector.js +1 -1
  38. package/lib/webapp/frontend-construct.js +1 -1
  39. package/package.json +2 -2
package/.jsii CHANGED
@@ -4566,6 +4566,276 @@
4566
4566
  ],
4567
4567
  "symbolId": "use-cases/webapp/frontend-construct:AdditionalDistributionProps"
4568
4568
  },
4569
+ "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreJwtAuthorizerConfig": {
4570
+ "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
4571
+ "datatype": true,
4572
+ "docs": {
4573
+ "stability": "experimental",
4574
+ "summary": "Custom JWT authorizer configuration for AgentCore Runtime."
4575
+ },
4576
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreJwtAuthorizerConfig",
4577
+ "kind": "interface",
4578
+ "locationInModule": {
4579
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4580
+ "line": 1063
4581
+ },
4582
+ "name": "AgentCoreJwtAuthorizerConfig",
4583
+ "properties": [
4584
+ {
4585
+ "abstract": true,
4586
+ "docs": {
4587
+ "stability": "experimental",
4588
+ "summary": "OIDC discovery URL."
4589
+ },
4590
+ "immutable": true,
4591
+ "locationInModule": {
4592
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4593
+ "line": 1065
4594
+ },
4595
+ "name": "discoveryUrl",
4596
+ "type": {
4597
+ "primitive": "string"
4598
+ }
4599
+ },
4600
+ {
4601
+ "abstract": true,
4602
+ "docs": {
4603
+ "stability": "experimental",
4604
+ "summary": "Allowed audiences."
4605
+ },
4606
+ "immutable": true,
4607
+ "locationInModule": {
4608
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4609
+ "line": 1067
4610
+ },
4611
+ "name": "allowedAudience",
4612
+ "optional": true,
4613
+ "type": {
4614
+ "collection": {
4615
+ "elementtype": {
4616
+ "primitive": "string"
4617
+ },
4618
+ "kind": "array"
4619
+ }
4620
+ }
4621
+ },
4622
+ {
4623
+ "abstract": true,
4624
+ "docs": {
4625
+ "stability": "experimental",
4626
+ "summary": "Allowed client IDs."
4627
+ },
4628
+ "immutable": true,
4629
+ "locationInModule": {
4630
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4631
+ "line": 1069
4632
+ },
4633
+ "name": "allowedClients",
4634
+ "optional": true,
4635
+ "type": {
4636
+ "collection": {
4637
+ "elementtype": {
4638
+ "primitive": "string"
4639
+ },
4640
+ "kind": "array"
4641
+ }
4642
+ }
4643
+ }
4644
+ ],
4645
+ "symbolId": "use-cases/framework/agents/interactive-agent:AgentCoreJwtAuthorizerConfig"
4646
+ },
4647
+ "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreRuntimeHostingAdapter": {
4648
+ "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
4649
+ "docs": {
4650
+ "remarks": "Deploys the agent as a container running on AgentCore Runtime (microVM).\nUses L1 constructs `CfnRuntime` and `CfnRuntimeEndpoint` from\n`aws-cdk-lib/aws-bedrockagentcore`.\n\n## Architecture\n\n```\nClient → AgentCore Runtime Endpoint → Container (FastAPI on port 8080) → Bedrock\n```\n\n## Features\n\n- **Session Isolation**: microVM provides per-session isolation (no S3 session bucket needed)\n- **Managed Infrastructure**: No Lambda cold starts or timeout limits\n- **Multiple Protocols**: HTTP, MCP, or A2A protocol support\n- **Container-Based**: Standard Docker image deployment\n\n## Usage\n\n```typescript\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\nimport { InteractiveAgent, AgentCoreRuntimeHostingAdapter } from '@cdklabs/cdk-appmod-catalog-blueprints';\n\ndeclare const myPrompt: Asset;\n\nnew InteractiveAgent(this, 'Agent', {\n agentName: 'MyChatbot',\n agentDefinition: { bedrockModel: {}, systemPrompt: myPrompt },\n hostingAdapter: new AgentCoreRuntimeHostingAdapter({\n networkMode: 'PUBLIC',\n }),\n});\n```",
4651
+ "stability": "experimental",
4652
+ "summary": "AgentCore Runtime hosting adapter for InteractiveAgent."
4653
+ },
4654
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreRuntimeHostingAdapter",
4655
+ "initializer": {
4656
+ "docs": {
4657
+ "stability": "experimental"
4658
+ },
4659
+ "locationInModule": {
4660
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4661
+ "line": 1151
4662
+ },
4663
+ "parameters": [
4664
+ {
4665
+ "name": "props",
4666
+ "optional": true,
4667
+ "type": {
4668
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreRuntimeHostingAdapterProps"
4669
+ }
4670
+ }
4671
+ ]
4672
+ },
4673
+ "interfaces": [
4674
+ "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter"
4675
+ ],
4676
+ "kind": "class",
4677
+ "locationInModule": {
4678
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4679
+ "line": 1148
4680
+ },
4681
+ "methods": [
4682
+ {
4683
+ "docs": {
4684
+ "stability": "experimental",
4685
+ "summary": "Deploy AgentCore Runtime hosting infrastructure."
4686
+ },
4687
+ "locationInModule": {
4688
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4689
+ "line": 1160
4690
+ },
4691
+ "name": "deploy",
4692
+ "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter",
4693
+ "parameters": [
4694
+ {
4695
+ "name": "config",
4696
+ "type": {
4697
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingConfig"
4698
+ }
4699
+ }
4700
+ ],
4701
+ "returns": {
4702
+ "type": {
4703
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingResult"
4704
+ }
4705
+ }
4706
+ }
4707
+ ],
4708
+ "name": "AgentCoreRuntimeHostingAdapter",
4709
+ "properties": [
4710
+ {
4711
+ "docs": {
4712
+ "remarks": "BaseAgent uses this to create the agent role with the correct trust policy.\nFor example, Lambda hosting requires `lambda.amazonaws.com` while AgentCore\nhosting requires `bedrock-agentcore.amazonaws.com`.",
4713
+ "stability": "experimental",
4714
+ "summary": "The IAM service principal that this hosting backend requires."
4715
+ },
4716
+ "immutable": true,
4717
+ "locationInModule": {
4718
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4719
+ "line": 1155
4720
+ },
4721
+ "name": "servicePrincipal",
4722
+ "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter",
4723
+ "type": {
4724
+ "fqn": "aws-cdk-lib.aws_iam.ServicePrincipal"
4725
+ }
4726
+ }
4727
+ ],
4728
+ "symbolId": "use-cases/framework/agents/interactive-agent:AgentCoreRuntimeHostingAdapter"
4729
+ },
4730
+ "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreRuntimeHostingAdapterProps": {
4731
+ "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
4732
+ "datatype": true,
4733
+ "docs": {
4734
+ "stability": "experimental",
4735
+ "summary": "Configuration properties for AgentCoreRuntimeHostingAdapter."
4736
+ },
4737
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreRuntimeHostingAdapterProps",
4738
+ "kind": "interface",
4739
+ "locationInModule": {
4740
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4741
+ "line": 1075
4742
+ },
4743
+ "name": "AgentCoreRuntimeHostingAdapterProps",
4744
+ "properties": [
4745
+ {
4746
+ "abstract": true,
4747
+ "docs": {
4748
+ "default": "Builds from agentcore-agent-handler directory",
4749
+ "remarks": "If not provided, builds from the bundled handler source.",
4750
+ "stability": "experimental",
4751
+ "summary": "ECR container image URI."
4752
+ },
4753
+ "immutable": true,
4754
+ "locationInModule": {
4755
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4756
+ "line": 1081
4757
+ },
4758
+ "name": "containerImageUri",
4759
+ "optional": true,
4760
+ "type": {
4761
+ "primitive": "string"
4762
+ }
4763
+ },
4764
+ {
4765
+ "abstract": true,
4766
+ "docs": {
4767
+ "remarks": "Omit for IAM-only auth.",
4768
+ "stability": "experimental",
4769
+ "summary": "Custom JWT authorizer configuration."
4770
+ },
4771
+ "immutable": true,
4772
+ "locationInModule": {
4773
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4774
+ "line": 1094
4775
+ },
4776
+ "name": "customJwtAuthorizer",
4777
+ "optional": true,
4778
+ "type": {
4779
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentCoreJwtAuthorizerConfig"
4780
+ }
4781
+ },
4782
+ {
4783
+ "abstract": true,
4784
+ "docs": {
4785
+ "default": "Auto-generated from agent name",
4786
+ "stability": "experimental",
4787
+ "summary": "Runtime endpoint name."
4788
+ },
4789
+ "immutable": true,
4790
+ "locationInModule": {
4791
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4792
+ "line": 1108
4793
+ },
4794
+ "name": "endpointName",
4795
+ "optional": true,
4796
+ "type": {
4797
+ "primitive": "string"
4798
+ }
4799
+ },
4800
+ {
4801
+ "abstract": true,
4802
+ "docs": {
4803
+ "default": "'PUBLIC'",
4804
+ "stability": "experimental",
4805
+ "summary": "Network mode: 'PUBLIC' or 'VPC'."
4806
+ },
4807
+ "immutable": true,
4808
+ "locationInModule": {
4809
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4810
+ "line": 1088
4811
+ },
4812
+ "name": "networkMode",
4813
+ "optional": true,
4814
+ "type": {
4815
+ "primitive": "string"
4816
+ }
4817
+ },
4818
+ {
4819
+ "abstract": true,
4820
+ "docs": {
4821
+ "default": "'HTTP'",
4822
+ "stability": "experimental",
4823
+ "summary": "Protocol configuration: 'HTTP' | 'MCP' | 'A2A'."
4824
+ },
4825
+ "immutable": true,
4826
+ "locationInModule": {
4827
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
4828
+ "line": 1101
4829
+ },
4830
+ "name": "protocolConfiguration",
4831
+ "optional": true,
4832
+ "type": {
4833
+ "primitive": "string"
4834
+ }
4835
+ }
4836
+ ],
4837
+ "symbolId": "use-cases/framework/agents/interactive-agent:AgentCoreRuntimeHostingAdapterProps"
4838
+ },
4569
4839
  "@cdklabs/cdk-appmod-catalog-blueprints.AgentDefinitionProps": {
4570
4840
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
4571
4841
  "datatype": true,
@@ -4608,128 +4878,544 @@
4608
4878
  "filename": "use-cases/framework/agents/base-agent.ts",
4609
4879
  "line": 39
4610
4880
  },
4611
- "name": "systemPrompt",
4881
+ "name": "systemPrompt",
4882
+ "type": {
4883
+ "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
4884
+ }
4885
+ },
4886
+ {
4887
+ "abstract": true,
4888
+ "docs": {
4889
+ "default": "- Only auto-generated permissions from knowledge bases",
4890
+ "remarks": "Use this when knowledge bases require permissions beyond what is\nautomatically generated by the IKnowledgeBase implementations.\nThese statements will be added to the agent's IAM role in addition\nto the auto-generated permissions.",
4891
+ "stability": "experimental",
4892
+ "summary": "Additional IAM policy statements for knowledge base access."
4893
+ },
4894
+ "immutable": true,
4895
+ "locationInModule": {
4896
+ "filename": "use-cases/framework/agents/base-agent.ts",
4897
+ "line": 83
4898
+ },
4899
+ "name": "additionalPolicyStatementsForKnowledgeBases",
4900
+ "optional": true,
4901
+ "type": {
4902
+ "collection": {
4903
+ "elementtype": {
4904
+ "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
4905
+ },
4906
+ "kind": "array"
4907
+ }
4908
+ }
4909
+ },
4910
+ {
4911
+ "abstract": true,
4912
+ "docs": {
4913
+ "stability": "experimental",
4914
+ "summary": "If tools need additional IAM permissions, these statements would be attached to the Agent's IAM role."
4915
+ },
4916
+ "immutable": true,
4917
+ "locationInModule": {
4918
+ "filename": "use-cases/framework/agents/base-agent.ts",
4919
+ "line": 57
4920
+ },
4921
+ "name": "additionalPolicyStatementsForTools",
4922
+ "optional": true,
4923
+ "type": {
4924
+ "collection": {
4925
+ "elementtype": {
4926
+ "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
4927
+ },
4928
+ "kind": "array"
4929
+ }
4930
+ }
4931
+ },
4932
+ {
4933
+ "abstract": true,
4934
+ "docs": {
4935
+ "default": "- No knowledge bases configured",
4936
+ "remarks": "When configured, the agent will have access to a built-in retrieval tool\nthat can query these knowledge bases. The agent's system prompt will be\nautomatically augmented with information about available knowledge bases.\n\nEach knowledge base must implement the IKnowledgeBase interface, which\nhandles IAM permission generation and runtime configuration.",
4937
+ "stability": "experimental",
4938
+ "summary": "Knowledge bases available to the agent for Retrieval-Augmented Generation (RAG)."
4939
+ },
4940
+ "immutable": true,
4941
+ "locationInModule": {
4942
+ "filename": "use-cases/framework/agents/base-agent.ts",
4943
+ "line": 71
4944
+ },
4945
+ "name": "knowledgeBases",
4946
+ "optional": true,
4947
+ "type": {
4948
+ "collection": {
4949
+ "elementtype": {
4950
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase"
4951
+ },
4952
+ "kind": "array"
4953
+ }
4954
+ }
4955
+ },
4956
+ {
4957
+ "abstract": true,
4958
+ "docs": {
4959
+ "stability": "experimental",
4960
+ "summary": "Any dependencies needed by the provided tools."
4961
+ },
4962
+ "immutable": true,
4963
+ "locationInModule": {
4964
+ "filename": "use-cases/framework/agents/base-agent.ts",
4965
+ "line": 51
4966
+ },
4967
+ "name": "lambdaLayers",
4968
+ "optional": true,
4969
+ "type": {
4970
+ "collection": {
4971
+ "elementtype": {
4972
+ "fqn": "aws-cdk-lib.aws_lambda.LayerVersion"
4973
+ },
4974
+ "kind": "array"
4975
+ }
4976
+ }
4977
+ },
4978
+ {
4979
+ "abstract": true,
4980
+ "docs": {
4981
+ "remarks": "This tools would automatically\nbe loaded by the agent. You can also use this to incorporate other specialized\nagents as tools.",
4982
+ "stability": "experimental",
4983
+ "summary": "List of tools defined in python files."
4984
+ },
4985
+ "immutable": true,
4986
+ "locationInModule": {
4987
+ "filename": "use-cases/framework/agents/base-agent.ts",
4988
+ "line": 46
4989
+ },
4990
+ "name": "tools",
4991
+ "optional": true,
4992
+ "type": {
4993
+ "collection": {
4994
+ "elementtype": {
4995
+ "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
4996
+ },
4997
+ "kind": "array"
4998
+ }
4999
+ }
5000
+ }
5001
+ ],
5002
+ "symbolId": "use-cases/framework/agents/base-agent:AgentDefinitionProps"
5003
+ },
5004
+ "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingConfig": {
5005
+ "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
5006
+ "datatype": true,
5007
+ "docs": {
5008
+ "stability": "experimental",
5009
+ "summary": "Configuration passed to a hosting adapter's deploy method."
5010
+ },
5011
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingConfig",
5012
+ "kind": "interface",
5013
+ "locationInModule": {
5014
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5015
+ "line": 758
5016
+ },
5017
+ "name": "AgentHostingConfig",
5018
+ "properties": [
5019
+ {
5020
+ "abstract": true,
5021
+ "docs": {
5022
+ "stability": "experimental",
5023
+ "summary": "Agent name identifier."
5024
+ },
5025
+ "immutable": true,
5026
+ "locationInModule": {
5027
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5028
+ "line": 762
5029
+ },
5030
+ "name": "agentName",
5031
+ "type": {
5032
+ "primitive": "string"
5033
+ }
5034
+ },
5035
+ {
5036
+ "abstract": true,
5037
+ "docs": {
5038
+ "stability": "experimental",
5039
+ "summary": "IAM role for the agent runtime."
5040
+ },
5041
+ "immutable": true,
5042
+ "locationInModule": {
5043
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5044
+ "line": 764
5045
+ },
5046
+ "name": "agentRole",
5047
+ "type": {
5048
+ "fqn": "aws-cdk-lib.aws_iam.Role"
5049
+ }
5050
+ },
5051
+ {
5052
+ "abstract": true,
5053
+ "docs": {
5054
+ "stability": "experimental",
5055
+ "summary": "KMS encryption key."
5056
+ },
5057
+ "immutable": true,
5058
+ "locationInModule": {
5059
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5060
+ "line": 768
5061
+ },
5062
+ "name": "encryptionKey",
5063
+ "type": {
5064
+ "fqn": "aws-cdk-lib.aws_kms.Key"
5065
+ }
5066
+ },
5067
+ {
5068
+ "abstract": true,
5069
+ "docs": {
5070
+ "stability": "experimental",
5071
+ "summary": "Environment variables to set on the runtime."
5072
+ },
5073
+ "immutable": true,
5074
+ "locationInModule": {
5075
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5076
+ "line": 766
5077
+ },
5078
+ "name": "environment",
5079
+ "type": {
5080
+ "collection": {
5081
+ "elementtype": {
5082
+ "primitive": "string"
5083
+ },
5084
+ "kind": "map"
5085
+ }
5086
+ }
5087
+ },
5088
+ {
5089
+ "abstract": true,
5090
+ "docs": {
5091
+ "stability": "experimental",
5092
+ "summary": "CDK scope for creating resources."
5093
+ },
5094
+ "immutable": true,
5095
+ "locationInModule": {
5096
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5097
+ "line": 760
5098
+ },
5099
+ "name": "scope",
5100
+ "type": {
5101
+ "fqn": "constructs.Construct"
5102
+ }
5103
+ },
5104
+ {
5105
+ "abstract": true,
5106
+ "docs": {
5107
+ "stability": "experimental",
5108
+ "summary": "System prompt S3 bucket name."
5109
+ },
5110
+ "immutable": true,
5111
+ "locationInModule": {
5112
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5113
+ "line": 788
5114
+ },
5115
+ "name": "systemPromptBucket",
5116
+ "type": {
5117
+ "primitive": "string"
5118
+ }
5119
+ },
5120
+ {
5121
+ "abstract": true,
5122
+ "docs": {
5123
+ "stability": "experimental",
5124
+ "summary": "System prompt S3 key."
5125
+ },
5126
+ "immutable": true,
5127
+ "locationInModule": {
5128
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5129
+ "line": 790
5130
+ },
5131
+ "name": "systemPromptKey",
5132
+ "type": {
5133
+ "primitive": "string"
5134
+ }
5135
+ },
5136
+ {
5137
+ "abstract": true,
5138
+ "docs": {
5139
+ "stability": "experimental",
5140
+ "summary": "Agent tools location definitions (JSON serialized)."
5141
+ },
5142
+ "immutable": true,
5143
+ "locationInModule": {
5144
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5145
+ "line": 786
5146
+ },
5147
+ "name": "toolsConfig",
5148
+ "type": {
5149
+ "primitive": "string"
5150
+ }
5151
+ },
5152
+ {
5153
+ "abstract": true,
5154
+ "docs": {
5155
+ "stability": "experimental",
5156
+ "summary": "Lambda architecture (Lambda hosting only)."
5157
+ },
5158
+ "immutable": true,
5159
+ "locationInModule": {
5160
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5161
+ "line": 772
5162
+ },
5163
+ "name": "architecture",
5164
+ "optional": true,
5165
+ "type": {
5166
+ "fqn": "aws-cdk-lib.aws_lambda.Architecture"
5167
+ }
5168
+ },
5169
+ {
5170
+ "abstract": true,
5171
+ "docs": {
5172
+ "stability": "experimental",
5173
+ "summary": "Whether observability is enabled."
5174
+ },
5175
+ "immutable": true,
5176
+ "locationInModule": {
5177
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5178
+ "line": 784
5179
+ },
5180
+ "name": "enableObservability",
5181
+ "optional": true,
5182
+ "type": {
5183
+ "primitive": "boolean"
5184
+ }
5185
+ },
5186
+ {
5187
+ "abstract": true,
5188
+ "docs": {
5189
+ "stability": "experimental",
5190
+ "summary": "Knowledge base configs (JSON serialized)."
5191
+ },
5192
+ "immutable": true,
5193
+ "locationInModule": {
5194
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5195
+ "line": 792
5196
+ },
5197
+ "name": "knowledgeBaseConfigs",
5198
+ "optional": true,
5199
+ "type": {
5200
+ "primitive": "string"
5201
+ }
5202
+ },
5203
+ {
5204
+ "abstract": true,
5205
+ "docs": {
5206
+ "stability": "experimental",
5207
+ "summary": "Lambda layers from knowledge bases (Lambda hosting only)."
5208
+ },
5209
+ "immutable": true,
5210
+ "locationInModule": {
5211
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5212
+ "line": 782
5213
+ },
5214
+ "name": "knowledgeBaseLayers",
5215
+ "optional": true,
5216
+ "type": {
5217
+ "collection": {
5218
+ "elementtype": {
5219
+ "fqn": "aws-cdk-lib.aws_lambda.ILayerVersion"
5220
+ },
5221
+ "kind": "array"
5222
+ }
5223
+ }
5224
+ },
5225
+ {
5226
+ "abstract": true,
5227
+ "docs": {
5228
+ "stability": "experimental",
5229
+ "summary": "Knowledge base system prompt addition."
5230
+ },
5231
+ "immutable": true,
5232
+ "locationInModule": {
5233
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5234
+ "line": 794
5235
+ },
5236
+ "name": "knowledgeBaseSystemPromptAddition",
5237
+ "optional": true,
5238
+ "type": {
5239
+ "primitive": "string"
5240
+ }
5241
+ },
5242
+ {
5243
+ "abstract": true,
5244
+ "docs": {
5245
+ "stability": "experimental",
5246
+ "summary": "Lambda layers from agent definition (Lambda hosting only)."
5247
+ },
5248
+ "immutable": true,
5249
+ "locationInModule": {
5250
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5251
+ "line": 780
5252
+ },
5253
+ "name": "lambdaLayers",
5254
+ "optional": true,
5255
+ "type": {
5256
+ "collection": {
5257
+ "elementtype": {
5258
+ "fqn": "aws-cdk-lib.aws_lambda.ILayerVersion"
5259
+ },
5260
+ "kind": "array"
5261
+ }
5262
+ }
5263
+ },
5264
+ {
5265
+ "abstract": true,
5266
+ "docs": {
5267
+ "stability": "experimental",
5268
+ "summary": "Lambda memory size in MB (Lambda hosting only)."
5269
+ },
5270
+ "immutable": true,
5271
+ "locationInModule": {
5272
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5273
+ "line": 774
5274
+ },
5275
+ "name": "memorySize",
5276
+ "optional": true,
5277
+ "type": {
5278
+ "primitive": "number"
5279
+ }
5280
+ },
5281
+ {
5282
+ "abstract": true,
5283
+ "docs": {
5284
+ "stability": "experimental",
5285
+ "summary": "Optional VPC network configuration."
5286
+ },
5287
+ "immutable": true,
5288
+ "locationInModule": {
5289
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5290
+ "line": 770
5291
+ },
5292
+ "name": "network",
5293
+ "optional": true,
5294
+ "type": {
5295
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.Network"
5296
+ }
5297
+ },
5298
+ {
5299
+ "abstract": true,
5300
+ "docs": {
5301
+ "stability": "experimental",
5302
+ "summary": "Removal policy for resources."
5303
+ },
5304
+ "immutable": true,
5305
+ "locationInModule": {
5306
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5307
+ "line": 796
5308
+ },
5309
+ "name": "removalPolicy",
5310
+ "optional": true,
4612
5311
  "type": {
4613
- "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
5312
+ "fqn": "aws-cdk-lib.RemovalPolicy"
4614
5313
  }
4615
5314
  },
4616
5315
  {
4617
5316
  "abstract": true,
4618
5317
  "docs": {
4619
- "default": "- Only auto-generated permissions from knowledge bases",
4620
- "remarks": "Use this when knowledge bases require permissions beyond what is\nautomatically generated by the IKnowledgeBase implementations.\nThese statements will be added to the agent's IAM role in addition\nto the auto-generated permissions.",
4621
5318
  "stability": "experimental",
4622
- "summary": "Additional IAM policy statements for knowledge base access."
5319
+ "summary": "Reserved concurrent executions (Lambda hosting only)."
4623
5320
  },
4624
5321
  "immutable": true,
4625
5322
  "locationInModule": {
4626
- "filename": "use-cases/framework/agents/base-agent.ts",
4627
- "line": 83
5323
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5324
+ "line": 778
4628
5325
  },
4629
- "name": "additionalPolicyStatementsForKnowledgeBases",
5326
+ "name": "reservedConcurrentExecutions",
4630
5327
  "optional": true,
4631
5328
  "type": {
4632
- "collection": {
4633
- "elementtype": {
4634
- "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
4635
- },
4636
- "kind": "array"
4637
- }
5329
+ "primitive": "number"
4638
5330
  }
4639
5331
  },
4640
5332
  {
4641
5333
  "abstract": true,
4642
5334
  "docs": {
4643
5335
  "stability": "experimental",
4644
- "summary": "If tools need additional IAM permissions, these statements would be attached to the Agent's IAM role."
5336
+ "summary": "Lambda timeout (Lambda hosting only)."
4645
5337
  },
4646
5338
  "immutable": true,
4647
5339
  "locationInModule": {
4648
- "filename": "use-cases/framework/agents/base-agent.ts",
4649
- "line": 57
5340
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5341
+ "line": 776
4650
5342
  },
4651
- "name": "additionalPolicyStatementsForTools",
5343
+ "name": "timeout",
4652
5344
  "optional": true,
4653
5345
  "type": {
4654
- "collection": {
4655
- "elementtype": {
4656
- "fqn": "aws-cdk-lib.aws_iam.PolicyStatement"
4657
- },
4658
- "kind": "array"
4659
- }
5346
+ "fqn": "aws-cdk-lib.Duration"
4660
5347
  }
4661
- },
5348
+ }
5349
+ ],
5350
+ "symbolId": "use-cases/framework/agents/interactive-agent:AgentHostingConfig"
5351
+ },
5352
+ "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingResult": {
5353
+ "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
5354
+ "datatype": true,
5355
+ "docs": {
5356
+ "stability": "experimental",
5357
+ "summary": "Result returned by a hosting adapter's deploy method."
5358
+ },
5359
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingResult",
5360
+ "kind": "interface",
5361
+ "locationInModule": {
5362
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5363
+ "line": 802
5364
+ },
5365
+ "name": "AgentHostingResult",
5366
+ "properties": [
4662
5367
  {
4663
5368
  "abstract": true,
4664
5369
  "docs": {
4665
- "default": "- No knowledge bases configured",
4666
- "remarks": "When configured, the agent will have access to a built-in retrieval tool\nthat can query these knowledge bases. The agent's system prompt will be\nautomatically augmented with information about available knowledge bases.\n\nEach knowledge base must implement the IKnowledgeBase interface, which\nhandles IAM permission generation and runtime configuration.",
4667
5370
  "stability": "experimental",
4668
- "summary": "Knowledge bases available to the agent for Retrieval-Augmented Generation (RAG)."
5371
+ "summary": "The agent endpoint URL or ARN."
4669
5372
  },
4670
5373
  "immutable": true,
4671
5374
  "locationInModule": {
4672
- "filename": "use-cases/framework/agents/base-agent.ts",
4673
- "line": 71
5375
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5376
+ "line": 804
4674
5377
  },
4675
- "name": "knowledgeBases",
4676
- "optional": true,
5378
+ "name": "endpoint",
4677
5379
  "type": {
4678
- "collection": {
4679
- "elementtype": {
4680
- "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase"
4681
- },
4682
- "kind": "array"
4683
- }
5380
+ "primitive": "string"
4684
5381
  }
4685
5382
  },
4686
5383
  {
4687
5384
  "abstract": true,
4688
5385
  "docs": {
4689
5386
  "stability": "experimental",
4690
- "summary": "Any dependencies needed by the provided tools."
5387
+ "summary": "The Lambda function (if Lambda-hosted)."
4691
5388
  },
4692
5389
  "immutable": true,
4693
5390
  "locationInModule": {
4694
- "filename": "use-cases/framework/agents/base-agent.ts",
4695
- "line": 51
5391
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5392
+ "line": 806
4696
5393
  },
4697
- "name": "lambdaLayers",
5394
+ "name": "agentFunction",
4698
5395
  "optional": true,
4699
5396
  "type": {
4700
- "collection": {
4701
- "elementtype": {
4702
- "fqn": "aws-cdk-lib.aws_lambda.LayerVersion"
4703
- },
4704
- "kind": "array"
4705
- }
5397
+ "fqn": "aws-cdk-lib.aws_lambda.IFunction"
4706
5398
  }
4707
5399
  },
4708
5400
  {
4709
5401
  "abstract": true,
4710
5402
  "docs": {
4711
- "remarks": "This tools would automatically\nbe loaded by the agent. You can also use this to incorporate other specialized\nagents as tools.",
4712
5403
  "stability": "experimental",
4713
- "summary": "List of tools defined in python files."
5404
+ "summary": "The AgentCore CfnRuntime (if AgentCore-hosted)."
4714
5405
  },
4715
5406
  "immutable": true,
4716
5407
  "locationInModule": {
4717
- "filename": "use-cases/framework/agents/base-agent.ts",
4718
- "line": 46
5408
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
5409
+ "line": 808
4719
5410
  },
4720
- "name": "tools",
5411
+ "name": "cfnRuntime",
4721
5412
  "optional": true,
4722
5413
  "type": {
4723
- "collection": {
4724
- "elementtype": {
4725
- "fqn": "aws-cdk-lib.aws_s3_assets.Asset"
4726
- },
4727
- "kind": "array"
4728
- }
5414
+ "fqn": "aws-cdk-lib.aws_bedrockagentcore.CfnRuntime"
4729
5415
  }
4730
5416
  }
4731
5417
  ],
4732
- "symbolId": "use-cases/framework/agents/base-agent:AgentDefinitionProps"
5418
+ "symbolId": "use-cases/framework/agents/interactive-agent:AgentHostingResult"
4733
5419
  },
4734
5420
  "@cdklabs/cdk-appmod-catalog-blueprints.AgentToolsLocationDefinition": {
4735
5421
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
@@ -5138,7 +5824,7 @@
5138
5824
  },
5139
5825
  "locationInModule": {
5140
5826
  "filename": "use-cases/framework/agents/base-agent.ts",
5141
- "line": 217
5827
+ "line": 231
5142
5828
  },
5143
5829
  "parameters": [
5144
5830
  {
@@ -5164,7 +5850,7 @@
5164
5850
  "kind": "class",
5165
5851
  "locationInModule": {
5166
5852
  "filename": "use-cases/framework/agents/base-agent.ts",
5167
- "line": 185
5853
+ "line": 195
5168
5854
  },
5169
5855
  "methods": [
5170
5856
  {
@@ -5179,7 +5865,7 @@
5179
5865
  },
5180
5866
  "locationInModule": {
5181
5867
  "filename": "use-cases/framework/agents/base-agent.ts",
5182
- "line": 368
5868
+ "line": 382
5183
5869
  },
5184
5870
  "name": "createADOTLayer",
5185
5871
  "protected": true,
@@ -5192,21 +5878,6 @@
5192
5878
  ],
5193
5879
  "name": "BaseAgent",
5194
5880
  "properties": [
5195
- {
5196
- "abstract": true,
5197
- "docs": {
5198
- "stability": "experimental"
5199
- },
5200
- "immutable": true,
5201
- "locationInModule": {
5202
- "filename": "use-cases/framework/agents/base-agent.ts",
5203
- "line": 186
5204
- },
5205
- "name": "agentFunction",
5206
- "type": {
5207
- "fqn": "aws-cdk-lib.aws_lambda.IFunction"
5208
- }
5209
- },
5210
5881
  {
5211
5882
  "docs": {
5212
5883
  "stability": "experimental"
@@ -5214,7 +5885,7 @@
5214
5885
  "immutable": true,
5215
5886
  "locationInModule": {
5216
5887
  "filename": "use-cases/framework/agents/base-agent.ts",
5217
- "line": 188
5888
+ "line": 202
5218
5889
  },
5219
5890
  "name": "agentRole",
5220
5891
  "type": {
@@ -5228,7 +5899,7 @@
5228
5899
  "immutable": true,
5229
5900
  "locationInModule": {
5230
5901
  "filename": "use-cases/framework/agents/base-agent.ts",
5231
- "line": 192
5902
+ "line": 206
5232
5903
  },
5233
5904
  "name": "agentToolsLocationDefinitions",
5234
5905
  "protected": true,
@@ -5248,7 +5919,7 @@
5248
5919
  "immutable": true,
5249
5920
  "locationInModule": {
5250
5921
  "filename": "use-cases/framework/agents/base-agent.ts",
5251
- "line": 189
5922
+ "line": 203
5252
5923
  },
5253
5924
  "name": "encryptionKey",
5254
5925
  "type": {
@@ -5264,7 +5935,7 @@
5264
5935
  "immutable": true,
5265
5936
  "locationInModule": {
5266
5937
  "filename": "use-cases/framework/agents/base-agent.ts",
5267
- "line": 200
5938
+ "line": 214
5268
5939
  },
5269
5940
  "name": "knowledgeBaseConfigs",
5270
5941
  "protected": true,
@@ -5286,7 +5957,7 @@
5286
5957
  "immutable": true,
5287
5958
  "locationInModule": {
5288
5959
  "filename": "use-cases/framework/agents/base-agent.ts",
5289
- "line": 215
5960
+ "line": 229
5290
5961
  },
5291
5962
  "name": "knowledgeBaseLayers",
5292
5963
  "protected": true,
@@ -5307,7 +5978,7 @@
5307
5978
  "immutable": true,
5308
5979
  "locationInModule": {
5309
5980
  "filename": "use-cases/framework/agents/base-agent.ts",
5310
- "line": 191
5981
+ "line": 205
5311
5982
  },
5312
5983
  "name": "logGroupDataProtection",
5313
5984
  "protected": true,
@@ -5315,6 +5986,24 @@
5315
5986
  "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.LogGroupDataProtectionProps"
5316
5987
  }
5317
5988
  },
5989
+ {
5990
+ "abstract": true,
5991
+ "docs": {
5992
+ "remarks": "May be undefined for non-Lambda hosting backends (e.g. AgentCore Runtime).",
5993
+ "stability": "experimental",
5994
+ "summary": "The Lambda function for the agent (when using Lambda hosting)."
5995
+ },
5996
+ "immutable": true,
5997
+ "locationInModule": {
5998
+ "filename": "use-cases/framework/agents/base-agent.ts",
5999
+ "line": 200
6000
+ },
6001
+ "name": "agentFunction",
6002
+ "optional": true,
6003
+ "type": {
6004
+ "fqn": "aws-cdk-lib.aws_lambda.IFunction"
6005
+ }
6006
+ },
5318
6007
  {
5319
6008
  "docs": {
5320
6009
  "stability": "experimental"
@@ -5322,7 +6011,7 @@
5322
6011
  "immutable": true,
5323
6012
  "locationInModule": {
5324
6013
  "filename": "use-cases/framework/agents/base-agent.ts",
5325
- "line": 187
6014
+ "line": 201
5326
6015
  },
5327
6016
  "name": "bedrockModel",
5328
6017
  "optional": true,
@@ -5339,7 +6028,7 @@
5339
6028
  "immutable": true,
5340
6029
  "locationInModule": {
5341
6030
  "filename": "use-cases/framework/agents/base-agent.ts",
5342
- "line": 207
6031
+ "line": 221
5343
6032
  },
5344
6033
  "name": "knowledgeBaseToolAsset",
5345
6034
  "optional": true,
@@ -5377,7 +6066,7 @@
5377
6066
  "immutable": true,
5378
6067
  "locationInModule": {
5379
6068
  "filename": "use-cases/framework/agents/base-agent.ts",
5380
- "line": 96
6069
+ "line": 106
5381
6070
  },
5382
6071
  "name": "agentDefinition",
5383
6072
  "type": {
@@ -5410,7 +6099,7 @@
5410
6099
  "immutable": true,
5411
6100
  "locationInModule": {
5412
6101
  "filename": "use-cases/framework/agents/base-agent.ts",
5413
- "line": 156
6102
+ "line": 166
5414
6103
  },
5415
6104
  "name": "agentArchitecture",
5416
6105
  "optional": true,
@@ -5430,7 +6119,7 @@
5430
6119
  "immutable": true,
5431
6120
  "locationInModule": {
5432
6121
  "filename": "use-cases/framework/agents/base-agent.ts",
5433
- "line": 126
6122
+ "line": 136
5434
6123
  },
5435
6124
  "name": "enableObservability",
5436
6125
  "optional": true,
@@ -5448,7 +6137,7 @@
5448
6137
  "immutable": true,
5449
6138
  "locationInModule": {
5450
6139
  "filename": "use-cases/framework/agents/base-agent.ts",
5451
- "line": 140
6140
+ "line": 150
5452
6141
  },
5453
6142
  "name": "encryptionKey",
5454
6143
  "optional": true,
@@ -5466,7 +6155,7 @@
5466
6155
  "immutable": true,
5467
6156
  "locationInModule": {
5468
6157
  "filename": "use-cases/framework/agents/base-agent.ts",
5469
- "line": 133
6158
+ "line": 143
5470
6159
  },
5471
6160
  "name": "network",
5472
6161
  "optional": true,
@@ -5484,13 +6173,32 @@
5484
6173
  "immutable": true,
5485
6174
  "locationInModule": {
5486
6175
  "filename": "use-cases/framework/agents/base-agent.ts",
5487
- "line": 148
6176
+ "line": 158
5488
6177
  },
5489
6178
  "name": "removalPolicy",
5490
6179
  "optional": true,
5491
6180
  "type": {
5492
6181
  "fqn": "aws-cdk-lib.RemovalPolicy"
5493
6182
  }
6183
+ },
6184
+ {
6185
+ "abstract": true,
6186
+ "docs": {
6187
+ "default": "ServicePrincipal('lambda.amazonaws.com')",
6188
+ "remarks": "This is typically set by the hosting adapter (e.g., `lambda.amazonaws.com`\nfor Lambda hosting, `bedrock-agentcore.amazonaws.com` for AgentCore).",
6189
+ "stability": "experimental",
6190
+ "summary": "The IAM service principal for the agent role's trust policy."
6191
+ },
6192
+ "immutable": true,
6193
+ "locationInModule": {
6194
+ "filename": "use-cases/framework/agents/base-agent.ts",
6195
+ "line": 101
6196
+ },
6197
+ "name": "servicePrincipal",
6198
+ "optional": true,
6199
+ "type": {
6200
+ "fqn": "aws-cdk-lib.aws_iam.ServicePrincipal"
6201
+ }
5494
6202
  }
5495
6203
  ],
5496
6204
  "symbolId": "use-cases/framework/agents/base-agent:BaseAgentProps"
@@ -6494,7 +7202,9 @@
6494
7202
  "properties": [
6495
7203
  {
6496
7204
  "docs": {
6497
- "stability": "experimental"
7205
+ "remarks": "May be undefined for non-Lambda hosting backends (e.g. AgentCore Runtime).",
7206
+ "stability": "experimental",
7207
+ "summary": "The Lambda function for the agent (when using Lambda hosting)."
6498
7208
  },
6499
7209
  "immutable": true,
6500
7210
  "locationInModule": {
@@ -6502,6 +7212,7 @@
6502
7212
  "line": 75
6503
7213
  },
6504
7214
  "name": "agentFunction",
7215
+ "optional": true,
6505
7216
  "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
6506
7217
  "type": {
6507
7218
  "fqn": "aws-cdk-lib.aws_lambda.IFunction"
@@ -9028,7 +9739,7 @@
9028
9739
  },
9029
9740
  "locationInModule": {
9030
9741
  "filename": "use-cases/framework/agents/interactive-agent.ts",
9031
- "line": 602
9742
+ "line": 629
9032
9743
  },
9033
9744
  "parameters": [
9034
9745
  {
@@ -9046,7 +9757,7 @@
9046
9757
  "kind": "class",
9047
9758
  "locationInModule": {
9048
9759
  "filename": "use-cases/framework/agents/interactive-agent.ts",
9049
- "line": 588
9760
+ "line": 615
9050
9761
  },
9051
9762
  "methods": [
9052
9763
  {
@@ -9056,7 +9767,7 @@
9056
9767
  },
9057
9768
  "locationInModule": {
9058
9769
  "filename": "use-cases/framework/agents/interactive-agent.ts",
9059
- "line": 636
9770
+ "line": 663
9060
9771
  },
9061
9772
  "name": "environmentVariables",
9062
9773
  "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
@@ -9079,7 +9790,7 @@
9079
9790
  },
9080
9791
  "locationInModule": {
9081
9792
  "filename": "use-cases/framework/agents/interactive-agent.ts",
9082
- "line": 612
9793
+ "line": 639
9083
9794
  },
9084
9795
  "name": "grantAuthenticate",
9085
9796
  "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
@@ -9103,7 +9814,7 @@
9103
9814
  "immutable": true,
9104
9815
  "locationInModule": {
9105
9816
  "filename": "use-cases/framework/agents/interactive-agent.ts",
9106
- "line": 592
9817
+ "line": 619
9107
9818
  },
9108
9819
  "name": "userPool",
9109
9820
  "optional": true,
@@ -9119,7 +9830,7 @@
9119
9830
  "immutable": true,
9120
9831
  "locationInModule": {
9121
9832
  "filename": "use-cases/framework/agents/interactive-agent.ts",
9122
- "line": 597
9833
+ "line": 624
9123
9834
  },
9124
9835
  "name": "userPoolClient",
9125
9836
  "optional": true,
@@ -9141,7 +9852,7 @@
9141
9852
  "kind": "interface",
9142
9853
  "locationInModule": {
9143
9854
  "filename": "use-cases/framework/agents/interactive-agent.ts",
9144
- "line": 532
9855
+ "line": 559
9145
9856
  },
9146
9857
  "name": "CognitoAuthenticatorProps",
9147
9858
  "properties": [
@@ -9155,7 +9866,7 @@
9155
9866
  "immutable": true,
9156
9867
  "locationInModule": {
9157
9868
  "filename": "use-cases/framework/agents/interactive-agent.ts",
9158
- "line": 552
9869
+ "line": 579
9159
9870
  },
9160
9871
  "name": "removalPolicy",
9161
9872
  "optional": true,
@@ -9173,7 +9884,7 @@
9173
9884
  "immutable": true,
9174
9885
  "locationInModule": {
9175
9886
  "filename": "use-cases/framework/agents/interactive-agent.ts",
9176
- "line": 538
9887
+ "line": 565
9177
9888
  },
9178
9889
  "name": "userPool",
9179
9890
  "optional": true,
@@ -9191,7 +9902,7 @@
9191
9902
  "immutable": true,
9192
9903
  "locationInModule": {
9193
9904
  "filename": "use-cases/framework/agents/interactive-agent.ts",
9194
- "line": 545
9905
+ "line": 572
9195
9906
  },
9196
9907
  "name": "userPoolClient",
9197
9908
  "optional": true,
@@ -11356,7 +12067,7 @@
11356
12067
  "kind": "interface",
11357
12068
  "locationInModule": {
11358
12069
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11359
- "line": 517
12070
+ "line": 544
11360
12071
  },
11361
12072
  "methods": [
11362
12073
  {
@@ -11367,7 +12078,7 @@
11367
12078
  },
11368
12079
  "locationInModule": {
11369
12080
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11370
- "line": 526
12081
+ "line": 553
11371
12082
  },
11372
12083
  "name": "environmentVariables",
11373
12084
  "returns": {
@@ -11389,7 +12100,7 @@
11389
12100
  },
11390
12101
  "locationInModule": {
11391
12102
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11392
- "line": 521
12103
+ "line": 548
11393
12104
  },
11394
12105
  "name": "grantAuthenticate",
11395
12106
  "parameters": [
@@ -11416,7 +12127,7 @@
11416
12127
  "kind": "interface",
11417
12128
  "locationInModule": {
11418
12129
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11419
- "line": 33
12130
+ "line": 36
11420
12131
  },
11421
12132
  "methods": [
11422
12133
  {
@@ -11428,7 +12139,7 @@
11428
12139
  },
11429
12140
  "locationInModule": {
11430
12141
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11431
- "line": 38
12142
+ "line": 41
11432
12143
  },
11433
12144
  "name": "attachToFunction",
11434
12145
  "parameters": [
@@ -11453,7 +12164,7 @@
11453
12164
  },
11454
12165
  "locationInModule": {
11455
12166
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11456
- "line": 43
12167
+ "line": 46
11457
12168
  },
11458
12169
  "name": "grantInvoke",
11459
12170
  "parameters": [
@@ -11472,27 +12183,28 @@
11472
12183
  "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy": {
11473
12184
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
11474
12185
  "docs": {
12186
+ "deprecated": "Use Strands-native `SlidingWindowConversationManager` from\n`strands.agent.conversation_manager` instead. The Python handler now uses\nStrands-native conversation management automatically.",
11475
12187
  "remarks": "Context strategies control how conversation history is maintained and provided\nto the agent. Different strategies enable different conversation patterns.",
11476
- "stability": "experimental",
12188
+ "stability": "deprecated",
11477
12189
  "summary": "Strategy interface for conversation history management."
11478
12190
  },
11479
12191
  "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy",
11480
12192
  "kind": "interface",
11481
12193
  "locationInModule": {
11482
12194
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11483
- "line": 422
12195
+ "line": 439
11484
12196
  },
11485
12197
  "methods": [
11486
12198
  {
11487
12199
  "abstract": true,
11488
12200
  "docs": {
11489
12201
  "returns": "Environment variables to configure the context manager",
11490
- "stability": "experimental",
12202
+ "stability": "deprecated",
11491
12203
  "summary": "Get environment variables for Lambda configuration."
11492
12204
  },
11493
12205
  "locationInModule": {
11494
12206
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11495
- "line": 428
12207
+ "line": 445
11496
12208
  },
11497
12209
  "name": "environmentVariables",
11498
12210
  "returns": {
@@ -11510,6 +12222,72 @@
11510
12222
  "name": "IContextStrategy",
11511
12223
  "symbolId": "use-cases/framework/agents/interactive-agent:IContextStrategy"
11512
12224
  },
12225
+ "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter": {
12226
+ "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
12227
+ "docs": {
12228
+ "remarks": "Hosting adapters encapsulate the infrastructure needed to run an agent.\nThe default implementation is `LambdaHostingAdapter` (Lambda + LWA + API Gateway).\n`AgentCoreRuntimeHostingAdapter` provides an alternative using AgentCore Runtime.",
12229
+ "stability": "experimental",
12230
+ "summary": "Strategy interface for pluggable hosting backends."
12231
+ },
12232
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter",
12233
+ "kind": "interface",
12234
+ "locationInModule": {
12235
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
12236
+ "line": 818
12237
+ },
12238
+ "methods": [
12239
+ {
12240
+ "abstract": true,
12241
+ "docs": {
12242
+ "returns": "The hosting result including endpoint and optional resources",
12243
+ "stability": "experimental",
12244
+ "summary": "Deploy the agent hosting infrastructure."
12245
+ },
12246
+ "locationInModule": {
12247
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
12248
+ "line": 834
12249
+ },
12250
+ "name": "deploy",
12251
+ "parameters": [
12252
+ {
12253
+ "docs": {
12254
+ "summary": "- Configuration for the agent hosting."
12255
+ },
12256
+ "name": "config",
12257
+ "type": {
12258
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingConfig"
12259
+ }
12260
+ }
12261
+ ],
12262
+ "returns": {
12263
+ "type": {
12264
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingResult"
12265
+ }
12266
+ }
12267
+ }
12268
+ ],
12269
+ "name": "IHostingAdapter",
12270
+ "properties": [
12271
+ {
12272
+ "abstract": true,
12273
+ "docs": {
12274
+ "remarks": "BaseAgent uses this to create the agent role with the correct trust policy.\nFor example, Lambda hosting requires `lambda.amazonaws.com` while AgentCore\nhosting requires `bedrock-agentcore.amazonaws.com`.",
12275
+ "stability": "experimental",
12276
+ "summary": "The IAM service principal that this hosting backend requires."
12277
+ },
12278
+ "immutable": true,
12279
+ "locationInModule": {
12280
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
12281
+ "line": 826
12282
+ },
12283
+ "name": "servicePrincipal",
12284
+ "type": {
12285
+ "fqn": "aws-cdk-lib.aws_iam.ServicePrincipal"
12286
+ }
12287
+ }
12288
+ ],
12289
+ "symbolId": "use-cases/framework/agents/interactive-agent:IHostingAdapter"
12290
+ },
11513
12291
  "@cdklabs/cdk-appmod-catalog-blueprints.IKnowledgeBase": {
11514
12292
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
11515
12293
  "docs": {
@@ -11742,26 +12520,27 @@
11742
12520
  "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore": {
11743
12521
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
11744
12522
  "docs": {
12523
+ "deprecated": "Use Strands-native `S3SessionManager` from `strands.session.s3_session_manager` instead.\nThe Python handler now uses Strands-native session management automatically.",
11745
12524
  "remarks": "Session stores manage conversation state persistence across HTTP requests.\nThe default implementation (S3SessionManager) uses S3 for durable storage.",
11746
- "stability": "experimental",
12525
+ "stability": "deprecated",
11747
12526
  "summary": "Strategy interface for session persistence."
11748
12527
  },
11749
12528
  "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore",
11750
12529
  "kind": "interface",
11751
12530
  "locationInModule": {
11752
12531
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11753
- "line": 284
12532
+ "line": 290
11754
12533
  },
11755
12534
  "methods": [
11756
12535
  {
11757
12536
  "abstract": true,
11758
12537
  "docs": {
11759
- "stability": "experimental",
12538
+ "stability": "deprecated",
11760
12539
  "summary": "Grant read/write permissions to a Lambda function."
11761
12540
  },
11762
12541
  "locationInModule": {
11763
12542
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11764
- "line": 295
12543
+ "line": 301
11765
12544
  },
11766
12545
  "name": "grantReadWrite",
11767
12546
  "parameters": [
@@ -11782,13 +12561,13 @@
11782
12561
  {
11783
12562
  "abstract": true,
11784
12563
  "docs": {
11785
- "stability": "experimental",
12564
+ "stability": "deprecated",
11786
12565
  "summary": "The S3 bucket used for session storage (if S3-based)."
11787
12566
  },
11788
12567
  "immutable": true,
11789
12568
  "locationInModule": {
11790
12569
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11791
- "line": 288
12570
+ "line": 294
11792
12571
  },
11793
12572
  "name": "sessionBucket",
11794
12573
  "optional": true,
@@ -11814,7 +12593,7 @@
11814
12593
  },
11815
12594
  "locationInModule": {
11816
12595
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11817
- "line": 877
12596
+ "line": 1486
11818
12597
  },
11819
12598
  "parameters": [
11820
12599
  {
@@ -11840,7 +12619,7 @@
11840
12619
  "kind": "class",
11841
12620
  "locationInModule": {
11842
12621
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11843
- "line": 868
12622
+ "line": 1476
11844
12623
  },
11845
12624
  "name": "InteractiveAgent",
11846
12625
  "properties": [
@@ -11851,12 +12630,11 @@
11851
12630
  "immutable": true,
11852
12631
  "locationInModule": {
11853
12632
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11854
- "line": 869
12633
+ "line": 1482
11855
12634
  },
11856
- "name": "agentFunction",
11857
- "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
12635
+ "name": "apiEndpoint",
11858
12636
  "type": {
11859
- "fqn": "aws-cdk-lib.aws_lambda.IFunction"
12637
+ "primitive": "string"
11860
12638
  }
11861
12639
  },
11862
12640
  {
@@ -11866,26 +12644,30 @@
11866
12644
  "immutable": true,
11867
12645
  "locationInModule": {
11868
12646
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11869
- "line": 874
12647
+ "line": 1478
11870
12648
  },
11871
- "name": "apiEndpoint",
12649
+ "name": "adapter",
12650
+ "optional": true,
11872
12651
  "type": {
11873
- "primitive": "string"
12652
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
11874
12653
  }
11875
12654
  },
11876
12655
  {
11877
12656
  "docs": {
11878
- "stability": "experimental"
12657
+ "remarks": "May be undefined for non-Lambda hosting backends (e.g. AgentCore Runtime).",
12658
+ "stability": "experimental",
12659
+ "summary": "The Lambda function for the agent (when using Lambda hosting)."
11879
12660
  },
11880
12661
  "immutable": true,
11881
12662
  "locationInModule": {
11882
12663
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11883
- "line": 870
12664
+ "line": 1477
11884
12665
  },
11885
- "name": "adapter",
12666
+ "name": "agentFunction",
11886
12667
  "optional": true,
12668
+ "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.BaseAgent",
11887
12669
  "type": {
11888
- "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
12670
+ "fqn": "aws-cdk-lib.aws_lambda.IFunction"
11889
12671
  }
11890
12672
  },
11891
12673
  {
@@ -11895,7 +12677,7 @@
11895
12677
  "immutable": true,
11896
12678
  "locationInModule": {
11897
12679
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11898
- "line": 873
12680
+ "line": 1481
11899
12681
  },
11900
12682
  "name": "authenticator",
11901
12683
  "optional": true,
@@ -11910,7 +12692,22 @@
11910
12692
  "immutable": true,
11911
12693
  "locationInModule": {
11912
12694
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11913
- "line": 872
12695
+ "line": 1484
12696
+ },
12697
+ "name": "cfnRuntime",
12698
+ "optional": true,
12699
+ "type": {
12700
+ "fqn": "aws-cdk-lib.aws_bedrockagentcore.CfnRuntime"
12701
+ }
12702
+ },
12703
+ {
12704
+ "docs": {
12705
+ "stability": "experimental"
12706
+ },
12707
+ "immutable": true,
12708
+ "locationInModule": {
12709
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
12710
+ "line": 1480
11914
12711
  },
11915
12712
  "name": "contextStrategy",
11916
12713
  "optional": true,
@@ -11925,7 +12722,7 @@
11925
12722
  "immutable": true,
11926
12723
  "locationInModule": {
11927
12724
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11928
- "line": 875
12725
+ "line": 1483
11929
12726
  },
11930
12727
  "name": "sessionBucket",
11931
12728
  "optional": true,
@@ -11940,7 +12737,7 @@
11940
12737
  "immutable": true,
11941
12738
  "locationInModule": {
11942
12739
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11943
- "line": 871
12740
+ "line": 1479
11944
12741
  },
11945
12742
  "name": "sessionStore",
11946
12743
  "optional": true,
@@ -11966,7 +12763,7 @@
11966
12763
  "kind": "interface",
11967
12764
  "locationInModule": {
11968
12765
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11969
- "line": 734
12766
+ "line": 1323
11970
12767
  },
11971
12768
  "name": "InteractiveAgentProps",
11972
12769
  "properties": [
@@ -11980,7 +12777,7 @@
11980
12777
  "immutable": true,
11981
12778
  "locationInModule": {
11982
12779
  "filename": "use-cases/framework/agents/interactive-agent.ts",
11983
- "line": 807
12780
+ "line": 1415
11984
12781
  },
11985
12782
  "name": "architecture",
11986
12783
  "optional": true,
@@ -11998,7 +12795,7 @@
11998
12795
  "immutable": true,
11999
12796
  "locationInModule": {
12000
12797
  "filename": "use-cases/framework/agents/interactive-agent.ts",
12001
- "line": 786
12798
+ "line": 1394
12002
12799
  },
12003
12800
  "name": "authenticator",
12004
12801
  "optional": true,
@@ -12016,30 +12813,50 @@
12016
12813
  "immutable": true,
12017
12814
  "locationInModule": {
12018
12815
  "filename": "use-cases/framework/agents/interactive-agent.ts",
12019
- "line": 740
12816
+ "line": 1342
12020
12817
  },
12021
12818
  "name": "communicationAdapter",
12022
12819
  "optional": true,
12023
12820
  "type": {
12024
- "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
12821
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
12822
+ }
12823
+ },
12824
+ {
12825
+ "abstract": true,
12826
+ "docs": {
12827
+ "default": "SlidingWindowConversationManager with 20 messages",
12828
+ "deprecated": "Conversation management is now handled by Strands-native\n`SlidingWindowConversationManager` in the Python handler.",
12829
+ "stability": "deprecated",
12830
+ "summary": "Context strategy for conversation history management."
12831
+ },
12832
+ "immutable": true,
12833
+ "locationInModule": {
12834
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
12835
+ "line": 1376
12836
+ },
12837
+ "name": "contextStrategy",
12838
+ "optional": true,
12839
+ "type": {
12840
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy"
12025
12841
  }
12026
12842
  },
12027
12843
  {
12028
12844
  "abstract": true,
12029
12845
  "docs": {
12030
- "default": "SlidingWindowConversationManager with 20 messages",
12846
+ "default": "LambdaHostingAdapter",
12847
+ "remarks": "Use `LambdaHostingAdapter` for Lambda + API Gateway (default) or\n`AgentCoreRuntimeHostingAdapter` for AgentCore Runtime hosting.\n\nWhen provided, `communicationAdapter`, `authenticator`, `memorySize`,\n`timeout`, `architecture`, and `reservedConcurrentExecutions` props\nare ignored (configure them on the adapter directly).",
12031
12848
  "stability": "experimental",
12032
- "summary": "Context strategy for conversation history management."
12849
+ "summary": "Hosting adapter for deploying the agent runtime."
12033
12850
  },
12034
12851
  "immutable": true,
12035
12852
  "locationInModule": {
12036
12853
  "filename": "use-cases/framework/agents/interactive-agent.ts",
12037
- "line": 770
12854
+ "line": 1336
12038
12855
  },
12039
- "name": "contextStrategy",
12856
+ "name": "hostingAdapter",
12040
12857
  "optional": true,
12041
12858
  "type": {
12042
- "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy"
12859
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter"
12043
12860
  }
12044
12861
  },
12045
12862
  {
@@ -12052,7 +12869,7 @@
12052
12869
  "immutable": true,
12053
12870
  "locationInModule": {
12054
12871
  "filename": "use-cases/framework/agents/interactive-agent.ts",
12055
- "line": 793
12872
+ "line": 1401
12056
12873
  },
12057
12874
  "name": "memorySize",
12058
12875
  "optional": true,
@@ -12064,14 +12881,15 @@
12064
12881
  "abstract": true,
12065
12882
  "docs": {
12066
12883
  "default": "20",
12884
+ "deprecated": "Conversation windowing is now handled by Strands-native\n`SlidingWindowConversationManager` in the Python handler (default: 20).",
12067
12885
  "remarks": "Shorthand for SlidingWindowConversationManager windowSize.\nIgnored if contextStrategy is provided.",
12068
- "stability": "experimental",
12886
+ "stability": "deprecated",
12069
12887
  "summary": "Maximum number of messages to keep in conversation history."
12070
12888
  },
12071
12889
  "immutable": true,
12072
12890
  "locationInModule": {
12073
12891
  "filename": "use-cases/framework/agents/interactive-agent.ts",
12074
- "line": 779
12892
+ "line": 1387
12075
12893
  },
12076
12894
  "name": "messageHistoryLimit",
12077
12895
  "optional": true,
@@ -12089,7 +12907,7 @@
12089
12907
  "immutable": true,
12090
12908
  "locationInModule": {
12091
12909
  "filename": "use-cases/framework/agents/interactive-agent.ts",
12092
- "line": 814
12910
+ "line": 1422
12093
12911
  },
12094
12912
  "name": "reservedConcurrentExecutions",
12095
12913
  "optional": true,
@@ -12108,7 +12926,7 @@
12108
12926
  "immutable": true,
12109
12927
  "locationInModule": {
12110
12928
  "filename": "use-cases/framework/agents/interactive-agent.ts",
12111
- "line": 756
12929
+ "line": 1360
12112
12930
  },
12113
12931
  "name": "sessionBucket",
12114
12932
  "optional": true,
@@ -12120,14 +12938,15 @@
12120
12938
  "abstract": true,
12121
12939
  "docs": {
12122
12940
  "default": "S3SessionManager with 24-hour TTL",
12941
+ "deprecated": "Session management is now handled by Strands-native `S3SessionManager`.\nAn S3 bucket is always created and passed as `SESSION_BUCKET` env var.",
12123
12942
  "remarks": "Set to undefined to disable session persistence (stateless mode).",
12124
- "stability": "experimental",
12943
+ "stability": "deprecated",
12125
12944
  "summary": "Session store for persisting conversation state."
12126
12945
  },
12127
12946
  "immutable": true,
12128
12947
  "locationInModule": {
12129
12948
  "filename": "use-cases/framework/agents/interactive-agent.ts",
12130
- "line": 748
12949
+ "line": 1352
12131
12950
  },
12132
12951
  "name": "sessionStore",
12133
12952
  "optional": true,
@@ -12145,7 +12964,7 @@
12145
12964
  "immutable": true,
12146
12965
  "locationInModule": {
12147
12966
  "filename": "use-cases/framework/agents/interactive-agent.ts",
12148
- "line": 763
12967
+ "line": 1367
12149
12968
  },
12150
12969
  "name": "sessionTTL",
12151
12970
  "optional": true,
@@ -12163,7 +12982,7 @@
12163
12982
  "immutable": true,
12164
12983
  "locationInModule": {
12165
12984
  "filename": "use-cases/framework/agents/interactive-agent.ts",
12166
- "line": 800
12985
+ "line": 1408
12167
12986
  },
12168
12987
  "name": "timeout",
12169
12988
  "optional": true,
@@ -12411,6 +13230,247 @@
12411
13230
  ],
12412
13231
  "symbolId": "use-cases/framework/agents/knowledge-base/knowledge-base-props:KnowledgeBaseRuntimeConfig"
12413
13232
  },
13233
+ "@cdklabs/cdk-appmod-catalog-blueprints.LambdaHostingAdapter": {
13234
+ "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
13235
+ "docs": {
13236
+ "remarks": "Deploys the agent as a Lambda function behind Lambda Web Adapter and API Gateway\nREST API with response streaming. This is the default hosting backend.\n\n## Architecture\n\n```\nClient → POST /chat → API Gateway REST API (STREAM) → Lambda (FastAPI + LWA) → Bedrock\nClient ← SSE stream ← API Gateway ← Lambda response streaming ← Agent tokens\n```",
13237
+ "stability": "experimental",
13238
+ "summary": "Lambda hosting adapter for InteractiveAgent."
13239
+ },
13240
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.LambdaHostingAdapter",
13241
+ "initializer": {
13242
+ "docs": {
13243
+ "stability": "experimental"
13244
+ },
13245
+ "locationInModule": {
13246
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13247
+ "line": 905
13248
+ },
13249
+ "parameters": [
13250
+ {
13251
+ "name": "props",
13252
+ "optional": true,
13253
+ "type": {
13254
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.LambdaHostingAdapterProps"
13255
+ }
13256
+ }
13257
+ ]
13258
+ },
13259
+ "interfaces": [
13260
+ "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter"
13261
+ ],
13262
+ "kind": "class",
13263
+ "locationInModule": {
13264
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13265
+ "line": 897
13266
+ },
13267
+ "methods": [
13268
+ {
13269
+ "docs": {
13270
+ "stability": "experimental",
13271
+ "summary": "Deploy Lambda + LWA + API Gateway hosting infrastructure."
13272
+ },
13273
+ "locationInModule": {
13274
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13275
+ "line": 914
13276
+ },
13277
+ "name": "deploy",
13278
+ "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter",
13279
+ "parameters": [
13280
+ {
13281
+ "name": "config",
13282
+ "type": {
13283
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingConfig"
13284
+ }
13285
+ }
13286
+ ],
13287
+ "returns": {
13288
+ "type": {
13289
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.AgentHostingResult"
13290
+ }
13291
+ }
13292
+ }
13293
+ ],
13294
+ "name": "LambdaHostingAdapter",
13295
+ "properties": [
13296
+ {
13297
+ "docs": {
13298
+ "remarks": "BaseAgent uses this to create the agent role with the correct trust policy.\nFor example, Lambda hosting requires `lambda.amazonaws.com` while AgentCore\nhosting requires `bedrock-agentcore.amazonaws.com`.",
13299
+ "stability": "experimental",
13300
+ "summary": "The IAM service principal that this hosting backend requires."
13301
+ },
13302
+ "immutable": true,
13303
+ "locationInModule": {
13304
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13305
+ "line": 909
13306
+ },
13307
+ "name": "servicePrincipal",
13308
+ "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IHostingAdapter",
13309
+ "type": {
13310
+ "fqn": "aws-cdk-lib.aws_iam.ServicePrincipal"
13311
+ }
13312
+ },
13313
+ {
13314
+ "docs": {
13315
+ "stability": "experimental",
13316
+ "summary": "The authenticator."
13317
+ },
13318
+ "immutable": true,
13319
+ "locationInModule": {
13320
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13321
+ "line": 901
13322
+ },
13323
+ "name": "authenticator",
13324
+ "optional": true,
13325
+ "type": {
13326
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator"
13327
+ }
13328
+ },
13329
+ {
13330
+ "docs": {
13331
+ "stability": "experimental",
13332
+ "summary": "The communication adapter."
13333
+ },
13334
+ "immutable": true,
13335
+ "locationInModule": {
13336
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13337
+ "line": 899
13338
+ },
13339
+ "name": "communicationAdapter",
13340
+ "optional": true,
13341
+ "type": {
13342
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
13343
+ }
13344
+ }
13345
+ ],
13346
+ "symbolId": "use-cases/framework/agents/interactive-agent:LambdaHostingAdapter"
13347
+ },
13348
+ "@cdklabs/cdk-appmod-catalog-blueprints.LambdaHostingAdapterProps": {
13349
+ "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
13350
+ "datatype": true,
13351
+ "docs": {
13352
+ "stability": "experimental",
13353
+ "summary": "Configuration properties for LambdaHostingAdapter."
13354
+ },
13355
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.LambdaHostingAdapterProps",
13356
+ "kind": "interface",
13357
+ "locationInModule": {
13358
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13359
+ "line": 840
13360
+ },
13361
+ "name": "LambdaHostingAdapterProps",
13362
+ "properties": [
13363
+ {
13364
+ "abstract": true,
13365
+ "docs": {
13366
+ "default": "Architecture.X86_64",
13367
+ "stability": "experimental",
13368
+ "summary": "Lambda function architecture."
13369
+ },
13370
+ "immutable": true,
13371
+ "locationInModule": {
13372
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13373
+ "line": 874
13374
+ },
13375
+ "name": "architecture",
13376
+ "optional": true,
13377
+ "type": {
13378
+ "fqn": "aws-cdk-lib.aws_lambda.Architecture"
13379
+ }
13380
+ },
13381
+ {
13382
+ "abstract": true,
13383
+ "docs": {
13384
+ "default": "CognitoAuthenticator",
13385
+ "stability": "experimental",
13386
+ "summary": "Authenticator for securing API endpoints."
13387
+ },
13388
+ "immutable": true,
13389
+ "locationInModule": {
13390
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13391
+ "line": 853
13392
+ },
13393
+ "name": "authenticator",
13394
+ "optional": true,
13395
+ "type": {
13396
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator"
13397
+ }
13398
+ },
13399
+ {
13400
+ "abstract": true,
13401
+ "docs": {
13402
+ "default": "StreamingHttpAdapter",
13403
+ "stability": "experimental",
13404
+ "summary": "Communication adapter for client-agent interaction."
13405
+ },
13406
+ "immutable": true,
13407
+ "locationInModule": {
13408
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13409
+ "line": 846
13410
+ },
13411
+ "name": "communicationAdapter",
13412
+ "optional": true,
13413
+ "type": {
13414
+ "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter"
13415
+ }
13416
+ },
13417
+ {
13418
+ "abstract": true,
13419
+ "docs": {
13420
+ "default": "1024",
13421
+ "stability": "experimental",
13422
+ "summary": "Lambda function memory size in MB."
13423
+ },
13424
+ "immutable": true,
13425
+ "locationInModule": {
13426
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13427
+ "line": 860
13428
+ },
13429
+ "name": "memorySize",
13430
+ "optional": true,
13431
+ "type": {
13432
+ "primitive": "number"
13433
+ }
13434
+ },
13435
+ {
13436
+ "abstract": true,
13437
+ "docs": {
13438
+ "default": "No reserved concurrency",
13439
+ "stability": "experimental",
13440
+ "summary": "Reserved concurrent executions for the Lambda function."
13441
+ },
13442
+ "immutable": true,
13443
+ "locationInModule": {
13444
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13445
+ "line": 881
13446
+ },
13447
+ "name": "reservedConcurrentExecutions",
13448
+ "optional": true,
13449
+ "type": {
13450
+ "primitive": "number"
13451
+ }
13452
+ },
13453
+ {
13454
+ "abstract": true,
13455
+ "docs": {
13456
+ "default": "Duration.minutes(15)",
13457
+ "stability": "experimental",
13458
+ "summary": "Lambda function timeout."
13459
+ },
13460
+ "immutable": true,
13461
+ "locationInModule": {
13462
+ "filename": "use-cases/framework/agents/interactive-agent.ts",
13463
+ "line": 867
13464
+ },
13465
+ "name": "timeout",
13466
+ "optional": true,
13467
+ "type": {
13468
+ "fqn": "aws-cdk-lib.Duration"
13469
+ }
13470
+ }
13471
+ ],
13472
+ "symbolId": "use-cases/framework/agents/interactive-agent:LambdaHostingAdapterProps"
13473
+ },
12414
13474
  "@cdklabs/cdk-appmod-catalog-blueprints.LambdaIamUtils": {
12415
13475
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
12416
13476
  "docs": {
@@ -13701,7 +14761,7 @@
13701
14761
  "kind": "class",
13702
14762
  "locationInModule": {
13703
14763
  "filename": "use-cases/framework/agents/interactive-agent.ts",
13704
- "line": 709
14764
+ "line": 736
13705
14765
  },
13706
14766
  "methods": [
13707
14767
  {
@@ -13711,7 +14771,7 @@
13711
14771
  },
13712
14772
  "locationInModule": {
13713
14773
  "filename": "use-cases/framework/agents/interactive-agent.ts",
13714
- "line": 720
14774
+ "line": 747
13715
14775
  },
13716
14776
  "name": "environmentVariables",
13717
14777
  "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
@@ -13733,7 +14793,7 @@
13733
14793
  },
13734
14794
  "locationInModule": {
13735
14795
  "filename": "use-cases/framework/agents/interactive-agent.ts",
13736
- "line": 713
14796
+ "line": 740
13737
14797
  },
13738
14798
  "name": "grantAuthenticate",
13739
14799
  "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IAuthenticator",
@@ -13837,8 +14897,9 @@
13837
14897
  "@cdklabs/cdk-appmod-catalog-blueprints.NullConversationManager": {
13838
14898
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
13839
14899
  "docs": {
14900
+ "deprecated": "The Python handler now uses Strands-native conversation management.\nTo disable conversation history, omit the session bucket configuration.",
13840
14901
  "remarks": "Disables conversation history, treating each message as independent.\nUseful for stateless use cases where context is not needed.",
13841
- "stability": "experimental",
14902
+ "stability": "deprecated",
13842
14903
  "summary": "Null conversation manager for stateless interactions."
13843
14904
  },
13844
14905
  "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.NullConversationManager",
@@ -13853,17 +14914,17 @@
13853
14914
  "kind": "class",
13854
14915
  "locationInModule": {
13855
14916
  "filename": "use-cases/framework/agents/interactive-agent.ts",
13856
- "line": 499
14917
+ "line": 526
13857
14918
  },
13858
14919
  "methods": [
13859
14920
  {
13860
14921
  "docs": {
13861
- "stability": "experimental",
14922
+ "stability": "deprecated",
13862
14923
  "summary": "Get environment variables for Lambda configuration."
13863
14924
  },
13864
14925
  "locationInModule": {
13865
14926
  "filename": "use-cases/framework/agents/interactive-agent.ts",
13866
- "line": 503
14927
+ "line": 530
13867
14928
  },
13868
14929
  "name": "environmentVariables",
13869
14930
  "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy",
@@ -14449,18 +15510,19 @@
14449
15510
  "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManager": {
14450
15511
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
14451
15512
  "docs": {
15513
+ "deprecated": "Use Strands-native `S3SessionManager` from `strands.session.s3_session_manager` instead.\nThe Python handler now uses Strands-native session management automatically.\nAn S3 bucket is still created for the Strands session manager; this CDK class\nis no longer needed to configure session persistence.",
14452
15514
  "remarks": "Uses S3 for durable storage of session data with automatic expiration\nvia lifecycle policies. Each HTTP request loads/saves session state,\nenabling multi-turn conversations over stateless HTTP.\n\n## Features\n\n- **Durable Storage**: Sessions persisted to S3 survive Lambda restarts\n- **Automatic Expiration**: Lifecycle policy removes old sessions\n- **Encryption**: KMS encryption at rest\n- **Cost Optimization**: S3 Standard storage with lifecycle management\n\n## Usage\n\n```typescript\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\nimport { InteractiveAgent, S3SessionManager } from '@cdklabs/cdk-appmod-catalog-blueprints';\nimport { Duration } from 'aws-cdk-lib';\n\nconst myPrompt = new Asset(this, 'Prompt', { path: './prompt.txt' });\nconst sessionManager = new S3SessionManager(this, 'SessionManager', {\n sessionTTL: Duration.hours(48)\n});\n\nconst agent = new InteractiveAgent(this, 'Agent', {\n agentName: 'ChatAgent',\n agentDefinition: { bedrockModel: {}, systemPrompt: myPrompt },\n sessionStore: sessionManager\n});\n```",
14453
- "stability": "experimental",
15515
+ "stability": "deprecated",
14454
15516
  "summary": "S3-based session manager for persisting conversation state."
14455
15517
  },
14456
15518
  "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManager",
14457
15519
  "initializer": {
14458
15520
  "docs": {
14459
- "stability": "experimental"
15521
+ "stability": "deprecated"
14460
15522
  },
14461
15523
  "locationInModule": {
14462
15524
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14463
- "line": 376
15525
+ "line": 389
14464
15526
  },
14465
15527
  "parameters": [
14466
15528
  {
@@ -14490,17 +15552,17 @@
14490
15552
  "kind": "class",
14491
15553
  "locationInModule": {
14492
15554
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14493
- "line": 365
15555
+ "line": 378
14494
15556
  },
14495
15557
  "methods": [
14496
15558
  {
14497
15559
  "docs": {
14498
- "stability": "experimental",
15560
+ "stability": "deprecated",
14499
15561
  "summary": "Grant read/write permissions to a Lambda function."
14500
15562
  },
14501
15563
  "locationInModule": {
14502
15564
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14503
- "line": 411
15565
+ "line": 424
14504
15566
  },
14505
15567
  "name": "grantReadWrite",
14506
15568
  "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.ISessionStore",
@@ -14518,13 +15580,13 @@
14518
15580
  "properties": [
14519
15581
  {
14520
15582
  "docs": {
14521
- "stability": "experimental",
15583
+ "stability": "deprecated",
14522
15584
  "summary": "The S3 bucket used for session storage."
14523
15585
  },
14524
15586
  "immutable": true,
14525
15587
  "locationInModule": {
14526
15588
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14527
- "line": 369
15589
+ "line": 382
14528
15590
  },
14529
15591
  "name": "bucket",
14530
15592
  "type": {
@@ -14533,13 +15595,13 @@
14533
15595
  },
14534
15596
  {
14535
15597
  "docs": {
14536
- "stability": "experimental",
15598
+ "stability": "deprecated",
14537
15599
  "summary": "The session TTL duration."
14538
15600
  },
14539
15601
  "immutable": true,
14540
15602
  "locationInModule": {
14541
15603
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14542
- "line": 374
15604
+ "line": 387
14543
15605
  },
14544
15606
  "name": "sessionTTL",
14545
15607
  "type": {
@@ -14548,13 +15610,13 @@
14548
15610
  },
14549
15611
  {
14550
15612
  "docs": {
14551
- "stability": "experimental",
15613
+ "stability": "deprecated",
14552
15614
  "summary": "The S3 bucket used for session storage (ISessionStore interface)."
14553
15615
  },
14554
15616
  "immutable": true,
14555
15617
  "locationInModule": {
14556
15618
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14557
- "line": 404
15619
+ "line": 417
14558
15620
  },
14559
15621
  "name": "sessionBucket",
14560
15622
  "optional": true,
@@ -14570,14 +15632,15 @@
14570
15632
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
14571
15633
  "datatype": true,
14572
15634
  "docs": {
14573
- "stability": "experimental",
15635
+ "deprecated": "Use Strands-native `S3SessionManager` from `strands.session.s3_session_manager` instead.",
15636
+ "stability": "deprecated",
14574
15637
  "summary": "Configuration properties for S3SessionManager."
14575
15638
  },
14576
15639
  "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.S3SessionManagerProps",
14577
15640
  "kind": "interface",
14578
15641
  "locationInModule": {
14579
15642
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14580
- "line": 301
15643
+ "line": 309
14581
15644
  },
14582
15645
  "name": "S3SessionManagerProps",
14583
15646
  "properties": [
@@ -14585,13 +15648,13 @@
14585
15648
  "abstract": true,
14586
15649
  "docs": {
14587
15650
  "default": "Auto-created bucket with KMS encryption",
14588
- "stability": "experimental",
15651
+ "stability": "deprecated",
14589
15652
  "summary": "S3 bucket for session storage."
14590
15653
  },
14591
15654
  "immutable": true,
14592
15655
  "locationInModule": {
14593
15656
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14594
- "line": 307
15657
+ "line": 315
14595
15658
  },
14596
15659
  "name": "bucket",
14597
15660
  "optional": true,
@@ -14603,13 +15666,13 @@
14603
15666
  "abstract": true,
14604
15667
  "docs": {
14605
15668
  "default": "Auto-created KMS key with rotation enabled",
14606
- "stability": "experimental",
15669
+ "stability": "deprecated",
14607
15670
  "summary": "KMS encryption key for the session bucket."
14608
15671
  },
14609
15672
  "immutable": true,
14610
15673
  "locationInModule": {
14611
15674
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14612
- "line": 322
15675
+ "line": 330
14613
15676
  },
14614
15677
  "name": "encryptionKey",
14615
15678
  "optional": true,
@@ -14621,13 +15684,13 @@
14621
15684
  "abstract": true,
14622
15685
  "docs": {
14623
15686
  "default": "RemovalPolicy.DESTROY",
14624
- "stability": "experimental",
15687
+ "stability": "deprecated",
14625
15688
  "summary": "Removal policy for the session bucket."
14626
15689
  },
14627
15690
  "immutable": true,
14628
15691
  "locationInModule": {
14629
15692
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14630
- "line": 329
15693
+ "line": 337
14631
15694
  },
14632
15695
  "name": "removalPolicy",
14633
15696
  "optional": true,
@@ -14640,13 +15703,13 @@
14640
15703
  "docs": {
14641
15704
  "default": "Duration.hours(24)",
14642
15705
  "remarks": "Sessions older than this duration will be automatically deleted.",
14643
- "stability": "experimental",
15706
+ "stability": "deprecated",
14644
15707
  "summary": "Time-to-live for sessions."
14645
15708
  },
14646
15709
  "immutable": true,
14647
15710
  "locationInModule": {
14648
15711
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14649
- "line": 315
15712
+ "line": 323
14650
15713
  },
14651
15714
  "name": "sessionTTL",
14652
15715
  "optional": true,
@@ -14660,18 +15723,19 @@
14660
15723
  "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManager": {
14661
15724
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
14662
15725
  "docs": {
15726
+ "deprecated": "Use Strands-native `SlidingWindowConversationManager` from\n`strands.agent.conversation_manager` instead. The Python handler now handles\nconversation windowing natively.",
14663
15727
  "remarks": "Keeps a fixed-size window of recent messages, automatically discarding older\nmessages as new ones arrive. Provides consistent context size for the agent.\n\n## Usage\n\n```typescript\nimport { Asset } from 'aws-cdk-lib/aws-s3-assets';\nimport { InteractiveAgent, SlidingWindowConversationManager } from '@cdklabs/cdk-appmod-catalog-blueprints';\n\nconst myPrompt = new Asset(this, 'Prompt', { path: './prompt.txt' });\nconst contextManager = new SlidingWindowConversationManager({ windowSize: 30 });\n\nconst agent = new InteractiveAgent(this, 'Agent', {\n agentName: 'ChatAgent',\n agentDefinition: { bedrockModel: {}, systemPrompt: myPrompt },\n contextStrategy: contextManager\n});\n```",
14664
- "stability": "experimental",
15728
+ "stability": "deprecated",
14665
15729
  "summary": "Sliding window conversation manager for maintaining recent conversation history."
14666
15730
  },
14667
15731
  "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManager",
14668
15732
  "initializer": {
14669
15733
  "docs": {
14670
- "stability": "experimental"
15734
+ "stability": "deprecated"
14671
15735
  },
14672
15736
  "locationInModule": {
14673
15737
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14674
- "line": 471
15738
+ "line": 495
14675
15739
  },
14676
15740
  "parameters": [
14677
15741
  {
@@ -14689,17 +15753,17 @@
14689
15753
  "kind": "class",
14690
15754
  "locationInModule": {
14691
15755
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14692
- "line": 465
15756
+ "line": 489
14693
15757
  },
14694
15758
  "methods": [
14695
15759
  {
14696
15760
  "docs": {
14697
- "stability": "experimental",
15761
+ "stability": "deprecated",
14698
15762
  "summary": "Get environment variables for Lambda configuration."
14699
15763
  },
14700
15764
  "locationInModule": {
14701
15765
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14702
- "line": 484
15766
+ "line": 508
14703
15767
  },
14704
15768
  "name": "environmentVariables",
14705
15769
  "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.IContextStrategy",
@@ -14719,13 +15783,13 @@
14719
15783
  "properties": [
14720
15784
  {
14721
15785
  "docs": {
14722
- "stability": "experimental",
15786
+ "stability": "deprecated",
14723
15787
  "summary": "The window size (number of messages to keep)."
14724
15788
  },
14725
15789
  "immutable": true,
14726
15790
  "locationInModule": {
14727
15791
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14728
- "line": 469
15792
+ "line": 493
14729
15793
  },
14730
15794
  "name": "windowSize",
14731
15795
  "type": {
@@ -14739,14 +15803,15 @@
14739
15803
  "assembly": "@cdklabs/cdk-appmod-catalog-blueprints",
14740
15804
  "datatype": true,
14741
15805
  "docs": {
14742
- "stability": "experimental",
15806
+ "deprecated": "Use Strands-native `SlidingWindowConversationManager` from\n`strands.agent.conversation_manager` instead.",
15807
+ "stability": "deprecated",
14743
15808
  "summary": "Configuration properties for SlidingWindowConversationManager."
14744
15809
  },
14745
15810
  "fqn": "@cdklabs/cdk-appmod-catalog-blueprints.SlidingWindowConversationManagerProps",
14746
15811
  "kind": "interface",
14747
15812
  "locationInModule": {
14748
15813
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14749
- "line": 434
15814
+ "line": 454
14750
15815
  },
14751
15816
  "name": "SlidingWindowConversationManagerProps",
14752
15817
  "properties": [
@@ -14754,13 +15819,13 @@
14754
15819
  "abstract": true,
14755
15820
  "docs": {
14756
15821
  "default": "20 messages",
14757
- "stability": "experimental",
15822
+ "stability": "deprecated",
14758
15823
  "summary": "Maximum number of messages to keep in conversation history."
14759
15824
  },
14760
15825
  "immutable": true,
14761
15826
  "locationInModule": {
14762
15827
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14763
- "line": 440
15828
+ "line": 460
14764
15829
  },
14765
15830
  "name": "windowSize",
14766
15831
  "optional": true,
@@ -14884,7 +15949,7 @@
14884
15949
  },
14885
15950
  "locationInModule": {
14886
15951
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14887
- "line": 142
15952
+ "line": 145
14888
15953
  },
14889
15954
  "parameters": [
14890
15955
  {
@@ -14902,7 +15967,7 @@
14902
15967
  "kind": "class",
14903
15968
  "locationInModule": {
14904
15969
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14905
- "line": 128
15970
+ "line": 131
14906
15971
  },
14907
15972
  "methods": [
14908
15973
  {
@@ -14913,7 +15978,7 @@
14913
15978
  },
14914
15979
  "locationInModule": {
14915
15980
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14916
- "line": 150
15981
+ "line": 153
14917
15982
  },
14918
15983
  "name": "attachToFunction",
14919
15984
  "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter",
@@ -14939,7 +16004,7 @@
14939
16004
  },
14940
16005
  "locationInModule": {
14941
16006
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14942
- "line": 262
16007
+ "line": 265
14943
16008
  },
14944
16009
  "name": "grantInvoke",
14945
16010
  "overrides": "@cdklabs/cdk-appmod-catalog-blueprints.ICommunicationAdapter",
@@ -14963,7 +16028,7 @@
14963
16028
  "immutable": true,
14964
16029
  "locationInModule": {
14965
16030
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14966
- "line": 137
16031
+ "line": 140
14967
16032
  },
14968
16033
  "name": "apiEndpoint",
14969
16034
  "optional": true,
@@ -14979,7 +16044,7 @@
14979
16044
  "immutable": true,
14980
16045
  "locationInModule": {
14981
16046
  "filename": "use-cases/framework/agents/interactive-agent.ts",
14982
- "line": 132
16047
+ "line": 135
14983
16048
  },
14984
16049
  "name": "restApi",
14985
16050
  "optional": true,
@@ -15001,7 +16066,7 @@
15001
16066
  "kind": "interface",
15002
16067
  "locationInModule": {
15003
16068
  "filename": "use-cases/framework/agents/interactive-agent.ts",
15004
- "line": 64
16069
+ "line": 67
15005
16070
  },
15006
16071
  "name": "StreamingHttpAdapterProps",
15007
16072
  "properties": [
@@ -15015,7 +16080,7 @@
15015
16080
  "immutable": true,
15016
16081
  "locationInModule": {
15017
16082
  "filename": "use-cases/framework/agents/interactive-agent.ts",
15018
- "line": 84
16083
+ "line": 87
15019
16084
  },
15020
16085
  "name": "authenticator",
15021
16086
  "optional": true,
@@ -15033,7 +16098,7 @@
15033
16098
  "immutable": true,
15034
16099
  "locationInModule": {
15035
16100
  "filename": "use-cases/framework/agents/interactive-agent.ts",
15036
- "line": 70
16101
+ "line": 73
15037
16102
  },
15038
16103
  "name": "stageName",
15039
16104
  "optional": true,
@@ -15051,7 +16116,7 @@
15051
16116
  "immutable": true,
15052
16117
  "locationInModule": {
15053
16118
  "filename": "use-cases/framework/agents/interactive-agent.ts",
15054
- "line": 77
16119
+ "line": 80
15055
16120
  },
15056
16121
  "name": "throttle",
15057
16122
  "optional": true,
@@ -15073,7 +16138,7 @@
15073
16138
  "kind": "interface",
15074
16139
  "locationInModule": {
15075
16140
  "filename": "use-cases/framework/agents/interactive-agent.ts",
15076
- "line": 49
16141
+ "line": 52
15077
16142
  },
15078
16143
  "name": "ThrottleSettings",
15079
16144
  "properties": [
@@ -15086,7 +16151,7 @@
15086
16151
  "immutable": true,
15087
16152
  "locationInModule": {
15088
16153
  "filename": "use-cases/framework/agents/interactive-agent.ts",
15089
- "line": 58
16154
+ "line": 61
15090
16155
  },
15091
16156
  "name": "burstLimit",
15092
16157
  "optional": true,
@@ -15103,7 +16168,7 @@
15103
16168
  "immutable": true,
15104
16169
  "locationInModule": {
15105
16170
  "filename": "use-cases/framework/agents/interactive-agent.ts",
15106
- "line": 53
16171
+ "line": 56
15107
16172
  },
15108
16173
  "name": "rateLimit",
15109
16174
  "optional": true,
@@ -15360,6 +16425,6 @@
15360
16425
  "usedFeatures": [
15361
16426
  "class-covariant-overrides"
15362
16427
  ],
15363
- "version": "1.10.0",
15364
- "fingerprint": "N/HnSNf4IrvIWXOZdrer4LQOabsCbNzcK9ee9BmxB04="
16428
+ "version": "1.12.0",
16429
+ "fingerprint": "Y/Ai9a7YLNvJL02nNIXSCkGoH8w8rF7leVRXtbMLcNo="
15365
16430
  }