@aws-cdk/aws-bedrock-agentcore-alpha 2.221.0-alpha.0 → 2.222.0-alpha.0

package/.warnings.jsii.js

@@ -1,3 +1,71 @@
+function _aws_cdk_aws_bedrock_agentcore_alpha_IMemory(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_MemoryBase(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_MemoryProps(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        if (p.memoryStrategies != null)
+            for (const o of p.memoryStrategies)
+                if (!visitedObjects.has(o))
+                    _aws_cdk_aws_bedrock_agentcore_alpha_IMemoryStrategy(o);
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_MemoryAttributes(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_Memory(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_OverrideConfig(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_ManagedStrategyProps(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        if (!visitedObjects.has(p.customConsolidation))
+            _aws_cdk_aws_bedrock_agentcore_alpha_OverrideConfig(p.customConsolidation);
+        if (!visitedObjects.has(p.customExtraction))
+            _aws_cdk_aws_bedrock_agentcore_alpha_OverrideConfig(p.customExtraction);
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_ManagedMemoryStrategy(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_TriggerConditions(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_InvocationConfiguration(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_SelfManagedStrategyProps(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        if (!visitedObjects.has(p.invocationConfiguration))
+            _aws_cdk_aws_bedrock_agentcore_alpha_InvocationConfiguration(p.invocationConfiguration);
+        if (!visitedObjects.has(p.triggerConditions))
+            _aws_cdk_aws_bedrock_agentcore_alpha_TriggerConditions(p.triggerConditions);
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_SelfManagedMemoryStrategy(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_MemoryStrategyType(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_MemoryStrategyCommonProps(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_IMemoryStrategy(p) {
+}
+function _aws_cdk_aws_bedrock_agentcore_alpha_MemoryStrategy(p) {
+}
 function _aws_cdk_aws_bedrock_agentcore_alpha_VpcConfigProps(p) {
     if (p == null)
         return;
@@ -180,4 +248,4 @@ class DeprecationError extends Error {
         });
     }
 }
-module.exports = { print, getPropertyDescriptor, DeprecationError, _aws_cdk_aws_bedrock_agentcore_alpha_VpcConfigProps, _aws_cdk_aws_bedrock_agentcore_alpha_NetworkConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_BrowserNetworkConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_CodeInterpreterNetworkConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeNetworkConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_ProtocolType, _aws_cdk_aws_bedrock_agentcore_alpha_IBedrockAgentRuntime, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeBase, _aws_cdk_aws_bedrock_agentcore_alpha_AgentRuntimeAttributes, _aws_cdk_aws_bedrock_agentcore_alpha_AgentRuntimeArtifact, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeAuthorizerConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_IRuntimeEndpoint, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeEndpointBase, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeEndpointAttributes, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeEndpointProps, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeEndpoint, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeProps, _aws_cdk_aws_bedrock_agentcore_alpha_AddEndpointOptions, _aws_cdk_aws_bedrock_agentcore_alpha_Runtime, _aws_cdk_aws_bedrock_agentcore_alpha_ICodeInterpreterCustom, _aws_cdk_aws_bedrock_agentcore_alpha_CodeInterpreterCustomBase, _aws_cdk_aws_bedrock_agentcore_alpha_CodeInterpreterCustomProps, _aws_cdk_aws_bedrock_agentcore_alpha_CodeInterpreterCustomAttributes, _aws_cdk_aws_bedrock_agentcore_alpha_CodeInterpreterCustom, _aws_cdk_aws_bedrock_agentcore_alpha_IBrowserCustom, _aws_cdk_aws_bedrock_agentcore_alpha_BrowserCustomBase, _aws_cdk_aws_bedrock_agentcore_alpha_RecordingConfig, _aws_cdk_aws_bedrock_agentcore_alpha_BrowserCustomProps, _aws_cdk_aws_bedrock_agentcore_alpha_BrowserCustomAttributes, _aws_cdk_aws_bedrock_agentcore_alpha_BrowserCustom };
+module.exports = { print, getPropertyDescriptor, DeprecationError, _aws_cdk_aws_bedrock_agentcore_alpha_IMemory, _aws_cdk_aws_bedrock_agentcore_alpha_MemoryBase, _aws_cdk_aws_bedrock_agentcore_alpha_MemoryProps, _aws_cdk_aws_bedrock_agentcore_alpha_MemoryAttributes, _aws_cdk_aws_bedrock_agentcore_alpha_Memory, _aws_cdk_aws_bedrock_agentcore_alpha_OverrideConfig, _aws_cdk_aws_bedrock_agentcore_alpha_ManagedStrategyProps, _aws_cdk_aws_bedrock_agentcore_alpha_ManagedMemoryStrategy, _aws_cdk_aws_bedrock_agentcore_alpha_TriggerConditions, _aws_cdk_aws_bedrock_agentcore_alpha_InvocationConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_SelfManagedStrategyProps, _aws_cdk_aws_bedrock_agentcore_alpha_SelfManagedMemoryStrategy, _aws_cdk_aws_bedrock_agentcore_alpha_MemoryStrategyType, _aws_cdk_aws_bedrock_agentcore_alpha_MemoryStrategyCommonProps, _aws_cdk_aws_bedrock_agentcore_alpha_IMemoryStrategy, _aws_cdk_aws_bedrock_agentcore_alpha_MemoryStrategy, _aws_cdk_aws_bedrock_agentcore_alpha_VpcConfigProps, _aws_cdk_aws_bedrock_agentcore_alpha_NetworkConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_BrowserNetworkConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_CodeInterpreterNetworkConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeNetworkConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_ProtocolType, _aws_cdk_aws_bedrock_agentcore_alpha_IBedrockAgentRuntime, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeBase, _aws_cdk_aws_bedrock_agentcore_alpha_AgentRuntimeAttributes, _aws_cdk_aws_bedrock_agentcore_alpha_AgentRuntimeArtifact, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeAuthorizerConfiguration, _aws_cdk_aws_bedrock_agentcore_alpha_IRuntimeEndpoint, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeEndpointBase, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeEndpointAttributes, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeEndpointProps, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeEndpoint, _aws_cdk_aws_bedrock_agentcore_alpha_RuntimeProps, _aws_cdk_aws_bedrock_agentcore_alpha_AddEndpointOptions, _aws_cdk_aws_bedrock_agentcore_alpha_Runtime, _aws_cdk_aws_bedrock_agentcore_alpha_ICodeInterpreterCustom, _aws_cdk_aws_bedrock_agentcore_alpha_CodeInterpreterCustomBase, _aws_cdk_aws_bedrock_agentcore_alpha_CodeInterpreterCustomProps, _aws_cdk_aws_bedrock_agentcore_alpha_CodeInterpreterCustomAttributes, _aws_cdk_aws_bedrock_agentcore_alpha_CodeInterpreterCustom, _aws_cdk_aws_bedrock_agentcore_alpha_IBrowserCustom, _aws_cdk_aws_bedrock_agentcore_alpha_BrowserCustomBase, _aws_cdk_aws_bedrock_agentcore_alpha_RecordingConfig, _aws_cdk_aws_bedrock_agentcore_alpha_BrowserCustomProps, _aws_cdk_aws_bedrock_agentcore_alpha_BrowserCustomAttributes, _aws_cdk_aws_bedrock_agentcore_alpha_BrowserCustom };

package/README.md

@@ -45,6 +45,11 @@ This construct library facilitates the deployment of Bedrock AgentCore primitive
   - [Code Interpreter Network Modes](#code-interpreter-network-modes)
   - [Basic Code Interpreter Creation](#basic-code-interpreter-creation)
   - [Code Interpreter IAM permissions](#code-interpreter-iam-permissions)
+- [Memory](#memory)
+  - [Memory properties](#memory-properties)
+  - [Basic Memory Creation](#basic-memory-creation)
+  - [LTM Memory Extraction Stategies](#ltm-memory-extraction-stategies)
+  - [Memory Strategy Methods](#memory-strategy-methods)
 
 
 ## AgentCore Runtime
@@ -115,9 +120,9 @@ const runtime = new agentcore.Runtime(this, "MyAgentRuntime", {
 
 To grant the runtime permission to invoke a Bedrock model or inference profile:
 
-```text
+```typescript fixture=default
 // Note: This example uses @aws-cdk/aws-bedrock-alpha which must be installed separately
-import * as bedrock from '@aws-cdk/aws-bedrock-alpha';
+declare const runtime: agentcore.Runtime;
 
 // Create a cross-region inference profile for Claude 3.7 Sonnet
 const inferenceProfile = bedrock.CrossRegionInferenceProfile.fromConfig({
@@ -298,6 +303,10 @@ IAM authentication is the default mode, when no authorizerConfiguration is set t
 To configure AWS Cognito User Pool authentication:
 
 ```typescript
+declare const userPool: cognito.UserPool;
+declare const userPoolClient: cognito.UserPoolClient;
+declare const anotherUserPoolClient: cognito.UserPoolClient;
+
 const repository = new ecr.Repository(this, "TestRepository", {
   repositoryName: "test-agent-runtime",
 });
@@ -307,9 +316,8 @@ const runtime = new agentcore.Runtime(this, "MyAgentRuntime", {
   runtimeName: "myAgent",
   agentRuntimeArtifact: agentRuntimeArtifact,
   authorizerConfiguration: agentcore.RuntimeAuthorizerConfiguration.usingCognito(
-    "us-west-2_ABC123",  // User Pool ID (required)
-    "client123",         // Client ID (required)
-    "us-west-2"         // Region (optional, defaults to stack region)
+    userPool, // User Pool (required)
+    [userPoolClient, anotherUserPoolClient], // User Pool Clients
   ),
 });
 ```
@@ -794,3 +802,317 @@ const codeInterpreter = new agentcore.CodeInterpreterCustom(this, "MyCodeInterpr
   },
 });
 ```
+
+## Memory
+
+Memory is a critical component of intelligence. While Large Language Models (LLMs) have impressive capabilities, they lack persistent memory across conversations. Amazon Bedrock AgentCore Memory addresses this limitation by providing a managed service that enables AI agents to maintain context over time, remember important facts, and deliver consistent, personalized experiences.
+
+AgentCore Memory operates on two levels:
+
+- **Short-Term Memory**: Immediate conversation context and session-based information that provides continuity within a single interaction or closely related sessions.
+- **Long-Term Memory**: Persistent information extracted and stored across multiple conversations, including facts, preferences, and summaries that enable personalized experiences over time.
+
+When you interact with the memory via the `CreateEvent` API, you store interactions in Short-Term Memory (STM) instantly. These interactions can include everything from user messages, assistant responses, to tool actions.
+
+To write to long-term memory, you need to configure extraction strategies which define how and where to store information from conversations for future use. These strategies are asynchronously processed from raw events after every few turns based on the strategy that was selected. You can't create long term memory records directly, as they are extracted asynchronously by AgentCore Memory.
+
+### Memory Properties
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `memoryName` | `string` | Yes | The name of the memory |
+| `expirationDuration` | `Duration` | No | Short-term memory expiration in days (between 7 and 365). Default: 90 days |
+| `description` | `string` | No | Optional description for the memory. Default: no description. |
+| `kmsKey` | `IKey` | No | Custom KMS key to use for encryption. Default: Your data is encrypted with a key that AWS owns and manages for you |
+| `memoryStrategies` | `MemoryStrategyBase[]` | No | Built-in extraction strategies to use for this memory. Default: No extraction strategies (short term memory only) |
+| `executionRole` | `iam.IRole` | No | The IAM role that provides permissions for the memory to access AWS services. Default: A new role will be created. |
+| `tags` | `{ [key: string]: string }` | No | Tags for memory. Default: no tags. |
+
+### Basic Memory Creation
+
+Below you can find how to configure a simple short-term memory (STM) with no long-term memory extraction strategies.
+Note how you set `expirationDuration`, which defines the time the events will be stored in the short-term memory before they expire.
+
+```typescript fixture=default
+
+// Create a basic memory with default settings, no LTM strategies
+const memory = new agentcore.Memory(this, "MyMemory", {
+  memoryName: "my_memory",
+  description: "A memory for storing user interactions for a period of 90 days",
+  expirationDuration: cdk.Duration.days(90),
+});
+```
+
+Basic Memory with Custom KMS Encryption
+
+```typescript fixture=default
+// Create a custom KMS key for encryption
+const encryptionKey = new kms.Key(this, "MemoryEncryptionKey", {
+  enableKeyRotation: true,
+  description: "KMS key for memory encryption",
+});
+
+// Create memory with custom encryption
+const memory = new agentcore.Memory(this, "MyMemory", {
+  memoryName: "my_encrypted_memory",
+  description: "Memory with custom KMS encryption",
+  expirationDuration: cdk.Duration.days(90),
+  kmsKey: encryptionKey,
+});
+```
+
+### LTM Memory Extraction Stategies
+
+If you need long-term memory for context recall across sessions, you can setup memory extraction strategies
+to extract the relevant memory from the raw events.
+
+Amazon Bedrock AgentCore Memory has different memory strategies for extracting and organizing information:
+
+- **Summarization**: to summarize interactions to preserve critical context and key insights.
+- **Semantic Memory**: to extract general factual knowledge, concepts and meanings from raw conversations using vector embeddings.
+This enables similarity-based retrieval of relevant facts and context.
+- **User Preferences**: to extract user behavior patterns from raw conversations.
+
+You can use built-in extraction strategies for quick setup, or create custom extraction strategies with specific models and prompt templates.
+
+### Memory with Built-in Strategies
+
+The library provides three built-in LTM strategies. These are default strategies for organizing and extracting memory data,
+each optimized for specific use cases.
+
+For example: An agent helps multiple users with cloud storage setup. From these conversations,
+see how each strategy processes users expressing confusion about account connection:
+
+1. **Summarization Strategy** (`MemoryStrategy.usingBuiltInSummarization()`)
+This strategy compresses conversations into concise overviews, preserving essential context and key insights for quick recall.
+Extracted memory example: Users confused by cloud setup during onboarding.
+
+   - Extracts concise summaries to preserve critical context and key insights
+   - Namespace: `/strategies/{memoryStrategyId}/actors/{actorId}/sessions/{sessionId}`
+
+2. **Semantic Memory Strategy** (`MemoryStrategy.usingBuiltInSemantic()`)
+Distills general facts, concepts, and underlying meanings from raw conversational data, presenting the information in a context-independent format.
+Extracted memory example: In-context learning = task-solving via examples, no training needed.
+
+   - Extracts general factual knowledge, concepts and meanings from raw conversations
+   - Namespace: `/strategies/{memoryStrategyId}/actors/{actorId}`
+
+3. **User Preference Strategy** (`MemoryStrategy.usingBuiltInUserPreference()`)
+Captures individual preferences, interaction patterns, and personalized settings to enhance future experiences.
+Extracted memory example: User needs clear guidance on cloud storage account connection during onboarding.
+
+   - Extracts user behavior patterns from raw conversations
+   - Namespace: `/strategies/{memoryStrategyId}/actors/{actorId}`
+
+```typescript fixture=default
+// Create memory with built-in strategies
+const memory = new agentcore.Memory(this, "MyMemory", {
+  memoryName: "my_memory",
+  description: "Memory with built-in strategies",
+  expirationDuration: cdk.Duration.days(90),
+  memoryStrategies: [
+    agentcore.MemoryStrategy.usingBuiltInSummarization(),
+    agentcore.MemoryStrategy.usingBuiltInSemantic(),
+    agentcore.MemoryStrategy.usingBuiltInUserPreference(),
+  ],
+});
+```
+
+The name generated for each built in memory strategy is as follows:
+
+- For Summarization: `summary_builtin_cdk001`
+- For Semantic:`semantic_builtin_cdk001>`
+- For User Preferences: `preference_builtin_cdk001`
+
+### Memory with custom Strategies
+
+With Long-Term Memory, organization is managed through Namespaces.
+
+An `actor` refers to entity such as end users or agent/user combinations. For example, in a coding support chatbot,
+the actor is usually the developer asking questions. Using the actor ID helps the system know which user the memory belongs to,
+keeping each user's data separate and organized.
+
+A `session` is usually a single conversation or interaction period between the user and the AI agent.
+It groups all related messages and events that happen during that conversation.
+
+A `namespace` is used to logically group and organize long-term memories. It ensures data stays neat, separate, and secure.
+
+With AgentCore Memory, you need to add a namespace when you define a memory strategy. This namespace helps define where the long-term memory
+will be logically grouped. Every time a new long-term memory is extracted using this memory strategy, it is saved under the namespace you set.
+This means that all long-term memories are scoped to their specific namespace, keeping them organized and preventing any mix-ups with other
+users or sessions. You should use a hierarchical format separated by forward slashes /. This helps keep memories organized clearly. As needed,
+you can choose to use the below pre-defined variables within braces in the namespace based on your applications' organization needs:
+
+- `actorId` – Identifies who the long-term memory belongs to, such as a user
+- `memoryStrategyId` – Shows which memory strategy is being used. This strategy identifier is auto-generated when you create a memory using CreateMemory operation.
+- `sessionId` – Identifies which session or conversation the memory is from.
+
+For example, if you define the following namespace as the input to your strategy in CreateMemory operation:
+
+```shell
+/strategy/{memoryStrategyId}/actor/{actorId}/session/{sessionId}
+```
+
+After memory creation, this namespace might look like:
+
+```shell
+/strategy/summarization-93483043//actor/actor-9830m2w3/session/session-9330sds8
+```
+
+You can customise the namespace, i.e. where the memories are stored by using the following methods:
+
+1. **Summarization Strategy** (`MemoryStrategy.usingSummarization(props)`)
+1. **Semantic Memory Strategy** (`MemoryStrategy.usingSemantic(props)`)
+1. **User Preference Strategy** (`MemoryStrategy.usingUserPreference(props)`)
+
+```typescript fixture=default
+// Create memory with built-in strategies
+const memory = new agentcore.Memory(this, "MyMemory", {
+  memoryName: "my_memory",
+  description: "Memory with built-in strategies",
+  expirationDuration: cdk.Duration.days(90),
+  memoryStrategies: [
+    agentcore.MemoryStrategy.usingUserPreference({
+        name: "CustomerPreferences",
+        namespaces: ["support/customer/{actorId}/preferences"]
+    }),
+    agentcore.MemoryStrategy.usingSemantic({
+        name: "CustomerSupportSemantic",
+        namespaces: ["support/customer/{actorId}/semantic"]
+    }),
+  ],
+});
+```
+
+Custom memory strategies let you tailor memory extraction and consolidation to your specific domain or use case.
+You can override the prompts for extracting and consolidating semantic, summary, or user preferences.
+You can also choose the model that you want to use for extraction and consolidation.
+
+The custom prompts you create are appended to a non-editable system prompt.
+
+Since a custom strategy requires you to invoke certain FMs, you need a role with appropriate permissions. For that, you can:
+
+- Let the L2 construct create a minimum permission role for you when use L2 Bedrock Foundation Models.
+- Use a custom role with the overly permissive `AmazonBedrockAgentCoreMemoryBedrockModelInferenceExecutionRolePolicy` managed policy.
+- Use a custom role with your own custom policies.
+
+#### Memory with Custom Execution Role
+
+Keep in mind that memories that **do not** use custom strategies do not require a service role.
+So even if you provide it, it will be ignored as it will never be used.
+
+```typescript fixture=default
+// Create a custom execution role
+const executionRole = new iam.Role(this, "MemoryExecutionRole", {
+  assumedBy: new iam.ServicePrincipal("bedrock-agentcore.amazonaws.com"),
+  managedPolicies: [
+    iam.ManagedPolicy.fromAwsManagedPolicyName(
+      "AmazonBedrockAgentCoreMemoryBedrockModelInferenceExecutionRolePolicy"
+    ),
+  ],
+});
+
+// Create memory with custom execution role
+const memory = new agentcore.Memory(this, "MyMemory", {
+  memoryName: "my_memory",
+  description: "Memory with custom execution role",
+  expirationDuration: cdk.Duration.days(90),
+  executionRole: executionRole,
+});
+```
+
+In customConsolidation and customExtraction, the model property uses the [@aws-cdk/aws-bedrock-alph](https://www.npmjs.com/package/@aws-cdk/aws-bedrock-alpha) library which must be installed separately.
+
+```typescript fixture=default
+// Create a custom semantic memory strategy
+const customSemanticStrategy = agentcore.MemoryStrategy.usingSemantic({
+  name: "customSemanticStrategy",
+  description: "Custom semantic memory strategy",
+  namespaces: ["/custom/strategies/{memoryStrategyId}/actors/{actorId}"],
+  customConsolidation: {
+    model: bedrock.BedrockFoundationModel.ANTHROPIC_CLAUDE_3_5_SONNET_V1_0,
+    appendToPrompt: "Custom consolidation prompt for semantic memory",
+  },
+  customExtraction: {
+    model: bedrock.BedrockFoundationModel.ANTHROPIC_CLAUDE_3_5_SONNET_V1_0,
+    appendToPrompt: "Custom extraction prompt for semantic memory",
+  },
+});
+
+// Create memory with custom strategy
+const memory = new agentcore.Memory(this, "MyMemory", {
+  memoryName: "my-custom-memory",
+  description: "Memory with custom strategy",
+  expirationDuration: cdk.Duration.days(90),
+  memoryStrategies: [customSemanticStrategy],
+});
+```
+
+### Memory with self-managed Strategies
+
+A self-managed strategy in Amazon Bedrock AgentCore Memory gives you complete control over your memory extraction and consolidation pipelines. 
+With a self-managed strategy, you can build custom memory processing workflows while leveraging Amazon Bedrock AgentCore for storage and retrieval.
+
+For additional information, you can refer to the [developer guide for self managed strategies](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/memory-self-managed-strategies.html).
+
+Create the required AWS resources including:
+
+- an S3 bucket in your account where Amazon Bedrock AgentCore will deliver batched event payloads.
+- an SNS topic for job notifications. Use FIFO topics if processing order within sessions is important for your use case.
+
+The construct will apply the correct permissions to the memory execution role to access these resources.
+
+```typescript fixture=default
+
+const bucket = new s3.Bucket(this, 'memoryBucket', {
+  bucketName: 'test-memory',
+  removalPolicy: cdk.RemovalPolicy.DESTROY,
+  autoDeleteObjects: true,
+});
+
+const topic = new sns.Topic(this, 'topic');
+
+// Create a custom semantic memory strategy
+const selfManagedStrategy = agentcore.MemoryStrategy.usingSelfManaged({
+  name: "selfManagedStrategy",
+  description: "self managed memory strategy",
+  historicalContextWindowSize: 5,
+  invocationConfiguration: {
+    topic: topic,
+    s3Location: {
+      bucketName: bucket.bucketName,
+      objectKey: 'memory/',
+    }
+  },
+  triggerConditions: {
+    messageBasedTrigger: 1,
+    timeBasedTrigger: cdk.Duration.seconds(10),
+    tokenBasedTrigger: 100
+  }
+});
+
+// Create memory with custom strategy
+const memory = new agentcore.Memory(this, "MyMemory", {
+  memoryName: "my-custom-memory",
+  description: "Memory with custom strategy",
+  expirationDuration: cdk.Duration.days(90),
+  memoryStrategies: [selfManagedStrategy],
+});
+```
+
+### Memory Strategy Methods
+
+You can add new memory strategies to the memory construct using the `addMemoryStrategy()` method, for instance:
+
+```typescript fixture=default
+// Create memory without initial strategies
+const memory = new agentcore.Memory(this, "test-memory", {
+  memoryName: "test_memory_add_strategy",
+  description: "A test memory for testing addMemoryStrategy method",
+  expirationDuration: cdk.Duration.days(90),
+});
+
+// Add strategies after instantiation
+memory.addMemoryStrategy(agentcore.MemoryStrategy.usingBuiltInSummarization());
+memory.addMemoryStrategy(agentcore.MemoryStrategy.usingBuiltInSemantic());
+```

package/agentcore/index.d.ts

@@ -1,3 +1,7 @@
+export * from './memory/memory';
+export * from './memory/strategies/managed-strategy';
+export * from './memory/strategies/self-managed-strategy';
+export * from './memory/memory-strategy';
 export * from './network/network-configuration';
 export * from './runtime/perms';
 export * from './runtime/types';

package/agentcore/index.js

@@ -14,6 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./memory/memory"), exports);
+__exportStar(require("./memory/strategies/managed-strategy"), exports);
+__exportStar(require("./memory/strategies/self-managed-strategy"), exports);
+__exportStar(require("./memory/memory-strategy"), exports);
 // ===================================
 // Network Configuration
 // ===================================
@@ -33,4 +37,4 @@ __exportStar(require("./runtime/runtime"), exports);
 // ===================================
 __exportStar(require("./tools/code-interpreter"), exports);
 __exportStar(require("./tools/browser"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsc0NBQXNDO0FBQ3RDLHdCQUF3QjtBQUN4QixzQ0FBc0M7QUFDdEMsa0VBQWdEO0FBRWhELHNDQUFzQztBQUN0QyxVQUFVO0FBQ1Ysc0NBQXNDO0FBQ3RDLGtEQUFnQztBQUNoQyxrREFBZ0M7QUFDaEMseURBQXVDO0FBQ3ZDLDZEQUEyQztBQUMzQyw2RUFBMkQ7QUFDM0Qsa0VBQWdEO0FBQ2hELDZEQUEyQztBQUMzQyxvREFBa0M7QUFDbEMsUUFBUTtBQUNSLHNDQUFzQztBQUN0QywyREFBeUM7QUFDekMsa0RBQWdDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIE5ldHdvcmsgQ29uZmlndXJhdGlvblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbmV4cG9ydCAqIGZyb20gJy4vbmV0d29yay9uZXR3b3JrLWNvbmZpZ3VyYXRpb24nO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gUnVudGltZVxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbmV4cG9ydCAqIGZyb20gJy4vcnVudGltZS9wZXJtcyc7XG5leHBvcnQgKiBmcm9tICcuL3J1bnRpbWUvdHlwZXMnO1xuZXhwb3J0ICogZnJvbSAnLi9ydW50aW1lL3J1bnRpbWUtYmFzZSc7XG5leHBvcnQgKiBmcm9tICcuL3J1bnRpbWUvcnVudGltZS1hcnRpZmFjdCc7XG5leHBvcnQgKiBmcm9tICcuL3J1bnRpbWUvcnVudGltZS1hdXRob3JpemVyLWNvbmZpZ3VyYXRpb24nO1xuZXhwb3J0ICogZnJvbSAnLi9ydW50aW1lL3J1bnRpbWUtZW5kcG9pbnQtYmFzZSc7XG5leHBvcnQgKiBmcm9tICcuL3J1bnRpbWUvcnVudGltZS1lbmRwb2ludCc7XG5leHBvcnQgKiBmcm9tICcuL3J1bnRpbWUvcnVudGltZSc7XG4vLyBUb29sc1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbmV4cG9ydCAqIGZyb20gJy4vdG9vbHMvY29kZS1pbnRlcnByZXRlcic7XG5leHBvcnQgKiBmcm9tICcuL3Rvb2xzL2Jyb3dzZXInO1xuIl19
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJpbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsa0RBQWdDO0FBQ2hDLHVFQUFxRDtBQUNyRCw0RUFBMEQ7QUFDMUQsMkRBQXlDO0FBQ3pDLHNDQUFzQztBQUN0Qyx3QkFBd0I7QUFDeEIsc0NBQXNDO0FBQ3RDLGtFQUFnRDtBQUVoRCxzQ0FBc0M7QUFDdEMsVUFBVTtBQUNWLHNDQUFzQztBQUN0QyxrREFBZ0M7QUFDaEMsa0RBQWdDO0FBQ2hDLHlEQUF1QztBQUN2Qyw2REFBMkM7QUFDM0MsNkVBQTJEO0FBQzNELGtFQUFnRDtBQUNoRCw2REFBMkM7QUFDM0Msb0RBQWtDO0FBQ2xDLFFBQVE7QUFDUixzQ0FBc0M7QUFDdEMsMkRBQXlDO0FBQ3pDLGtEQUFnQyIsInNvdXJjZXNDb250ZW50IjpbImV4cG9ydCAqIGZyb20gJy4vbWVtb3J5L21lbW9yeSc7XG5leHBvcnQgKiBmcm9tICcuL21lbW9yeS9zdHJhdGVnaWVzL21hbmFnZWQtc3RyYXRlZ3knO1xuZXhwb3J0ICogZnJvbSAnLi9tZW1vcnkvc3RyYXRlZ2llcy9zZWxmLW1hbmFnZWQtc3RyYXRlZ3knO1xuZXhwb3J0ICogZnJvbSAnLi9tZW1vcnkvbWVtb3J5LXN0cmF0ZWd5Jztcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBOZXR3b3JrIENvbmZpZ3VyYXRpb25cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5leHBvcnQgKiBmcm9tICcuL25ldHdvcmsvbmV0d29yay1jb25maWd1cmF0aW9uJztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFJ1bnRpbWVcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5leHBvcnQgKiBmcm9tICcuL3J1bnRpbWUvcGVybXMnO1xuZXhwb3J0ICogZnJvbSAnLi9ydW50aW1lL3R5cGVzJztcbmV4cG9ydCAqIGZyb20gJy4vcnVudGltZS9ydW50aW1lLWJhc2UnO1xuZXhwb3J0ICogZnJvbSAnLi9ydW50aW1lL3J1bnRpbWUtYXJ0aWZhY3QnO1xuZXhwb3J0ICogZnJvbSAnLi9ydW50aW1lL3J1bnRpbWUtYXV0aG9yaXplci1jb25maWd1cmF0aW9uJztcbmV4cG9ydCAqIGZyb20gJy4vcnVudGltZS9ydW50aW1lLWVuZHBvaW50LWJhc2UnO1xuZXhwb3J0ICogZnJvbSAnLi9ydW50aW1lL3J1bnRpbWUtZW5kcG9pbnQnO1xuZXhwb3J0ICogZnJvbSAnLi9ydW50aW1lL3J1bnRpbWUnO1xuLy8gVG9vbHNcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5leHBvcnQgKiBmcm9tICcuL3Rvb2xzL2NvZGUtaW50ZXJwcmV0ZXInO1xuZXhwb3J0ICogZnJvbSAnLi90b29scy9icm93c2VyJztcbiJdfQ==

package/agentcore/memory/memory-strategy.d.ts

@@ -0,0 +1,164 @@
+/**
+ *  Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
+ *  with the License. A copy of the License is located at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
+ *  OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
+ *  and limitations under the License.
+ */
+import * as bedrockagentcore from 'aws-cdk-lib/aws-bedrockagentcore';
+import * as iam from 'aws-cdk-lib/aws-iam';
+import { ManagedMemoryStrategy, ManagedStrategyProps } from './strategies/managed-strategy';
+import { SelfManagedMemoryStrategy, SelfManagedStrategyProps } from './strategies/self-managed-strategy';
+/******************************************************************************
+ *                              CONSTANTS
+ *****************************************************************************/
+/**
+ * Minimum length for memory strategy name
+ * @internal
+ */
+export declare const MEMORY_NAME_MIN_LENGTH = 1;
+/**
+ * Maximum length for memory strategy name
+ * @internal
+ */
+export declare const MEMORY_NAME_MAX_LENGTH = 48;
+/**
+ * Long-term memory extraction strategy types.
+ */
+export declare enum MemoryStrategyType {
+    /**
+     * Summarization strategy - extracts concise summaries to preserve critical context and key insights
+     */
+    SUMMARIZATION = "SUMMARIZATION",
+    /**
+     * Semantic memory strategy - extracts general factual knowledge, concepts and meanings from raw conversations
+     * using vector embeddings for similarity search.
+     */
+    SEMANTIC = "SEMANTIC",
+    /**
+     * User preferences strategy - extracts user behavior patterns from raw conversations.
+     */
+    USER_PREFERENCE = "USER_PREFERENCE",
+    /**
+     * Customize memory processing through custom foundation model and prompt templates.
+     */
+    CUSTOM = "CUSTOM"
+}
+/******************************************************************************
+ *                                 Common
+ *****************************************************************************/
+/**
+ * Configuration parameters common for any memory strategy
+ */
+export interface MemoryStrategyCommonProps {
+    /**
+     * The name for the strategy
+     * @required - Yes
+     */
+    readonly name: string;
+    /**
+     * The description of the strategy
+     * @default No description
+     * @required - No
+     */
+    readonly description?: string;
+}
+/******************************************************************************
+ *                                 Interface
+ *****************************************************************************/
+/**
+ * Interface for Memory strategies
+ */
+export interface IMemoryStrategy {
+    /**
+     * The name of the memory strategy
+     */
+    readonly name: string;
+    /**
+     * The description of the memory strategy
+     */
+    readonly description?: string;
+    /**
+     * The type of memory strategy
+     */
+    readonly strategyType: MemoryStrategyType;
+    /**
+     * Renders internal attributes to CloudFormation
+     */
+    render(): bedrockagentcore.CfnMemory.MemoryStrategyProperty;
+    /**
+     * Grants the necessary permissions to the role
+     * @param grantee - The grantee to grant permissions to
+     * @returns The Grant object for chaining
+     */
+    grant(grantee: iam.IGrantable): iam.Grant | undefined;
+}
+/******************************************************************************
+ *                                 Factory
+ *****************************************************************************/
+/**
+ * Factory class for creating memory strategies
+ * If you need long-term memory for context recall across sessions, you can setup memory extraction strategies to extract the relevant memory from the raw events.
+ * Use built-in strategies for quick setup, use built-in strategies with override to specify models and prompt templates.
+ *
+ * @see https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/memory-strategies.html
+ */
+export declare class MemoryStrategy {
+    /**
+     * Default strategies for organizing and extracting memory data, each optimized for specific use cases.
+     * This strategy compresses conversations into concise overviews, preserving essential context and key insights for quick recall.
+     * Extracted memory example: Users confused by cloud setup during onboarding.
+     * @returns A ManagedMemoryStrategy.
+     */
+    static usingBuiltInSummarization(): ManagedMemoryStrategy;
+    /**
+     * Default strategies for organizing and extracting memory data, each optimized for specific use cases.
+     * Distills general facts, concepts, and underlying meanings from raw conversational data, presenting the information in a context-independent format.
+     * Extracted memory example: In-context learning = task-solving via examples, no training needed.
+     * @returns A ManagedMemoryStrategy.
+     */
+    static usingBuiltInSemantic(): ManagedMemoryStrategy;
+    /**
+     * Default strategies for organizing and extracting memory data, each optimized for specific use cases.
+     * Captures individual preferences, interaction patterns, and personalized settings to enhance future experiences.
+     * Extracted memory example: User needs clear guidance on cloud storage account connection during onboarding.
+     * @returns A ManagedMemoryStrategy.
+     */
+    static usingBuiltInUserPreference(): ManagedMemoryStrategy;
+    /**
+     * Creates a semantic memory strategy with custom configuration.
+     * Distills general facts, concepts, and underlying meanings from raw conversational data, presenting the information in a context-independent format.
+     * Extracted memory example: In-context learning = task-solving via examples, no training needed.
+     * @param config - The configuration for the semantic memory strategy.
+     * @returns A ManagedMemoryStrategy.
+     */
+    static usingSemantic(config: ManagedStrategyProps): ManagedMemoryStrategy;
+    /**
+     * Creates a user preference memory strategy with custom configuration.
+     * Captures individual preferences, interaction patterns, and personalized settings to enhance future experiences.
+     * Extracted memory example: User needs clear guidance on cloud storage account connection during onboarding.
+     * @param config - The configuration for the user preference memory strategy.
+     * @returns A ManagedMemoryStrategy.
+     */
+    static usingUserPreference(config: ManagedStrategyProps): ManagedMemoryStrategy;
+    /**
+     * Creates a summarization memory strategy with custom configuration.
+     * This strategy compresses conversations into concise overviews, preserving essential context and key insights for quick recall.
+     * Extracted memory example: Users confused by cloud setup during onboarding.
+     * @param config - The configuration for the summarization memory strategy.
+     * @returns A ManagedMemoryStrategy.
+     */
+    static usingSummarization(config: ManagedStrategyProps): ManagedMemoryStrategy;
+    /**
+     * Creates a self-managed memory strategy.
+     * A self-managed strategy gives you complete control over your memory extraction and consolidation pipelines.
+     * @param config - The configuration for the self-managed memory strategy.
+     * @returns A SelfManagedMemoryStrategy.
+     */
+    static usingSelfManaged(config: SelfManagedStrategyProps): SelfManagedMemoryStrategy;
+}