feat(memory): add agentcore memory l2 construct (#35757)

### Issue # (if applicable)

Related to aws/aws-cdk-rfcs#825

### Reason for this change

Adding a new alpha package for Amazon Bedrock AgentCore and add support for memory.

### Description of changes

- Create a new alpha package
- Add L2 constructs for memory
- Add documentation
- Add tests

### Describe any new or updated permissions being added

Using permissions for agent core defined in https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrockagentcore.html


### Description of how you validated changes

Unit tests, integration tests, manual tests

### Checklist
- [x] My code adheres to the [CONTRIBUTING GUIDE](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and [DESIGN GUIDELINES](https://github.com/aws/aws-cdk/blob/main/docs/DESIGN_GUIDELINES.md)

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Author: krokoko

packages/@aws-cdk/aws-bedrock-agentcore-alpha/README.md

@@ -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';
 // ===================================
 // Network Configuration
 // ===================================

packages/@aws-cdk/aws-bedrock-agentcore-alpha/agentcore/index.ts

@@ -0,0 +1,199 @@
+/**
+ *  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';
+// Internal libs
+import { ManagedMemoryStrategy, ManagedStrategyProps } from './strategies/managed-strategy';
+import { SelfManagedMemoryStrategy, SelfManagedStrategyProps } from './strategies/self-managed-strategy';
+
+/******************************************************************************
+ *                              CONSTANTS
+ *****************************************************************************/
+/**
+ * Minimum length for memory strategy name
+ * @internal
+ */
+export const MEMORY_NAME_MIN_LENGTH = 1;
+/**
+ * Maximum length for memory strategy name
+ * @internal
+ */
+export const MEMORY_NAME_MAX_LENGTH = 48;
+
+/**
+ * Long-term memory extraction strategy types.
+ */
+export 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 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.
+   */
+  public static usingBuiltInSummarization(): ManagedMemoryStrategy {
+    return new ManagedMemoryStrategy(MemoryStrategyType.SUMMARIZATION, {
+      name: 'summary_builtin_cdkGen0001',
+      description: 'Summarize interactions to preserve critical context and key insights',
+      namespaces: ['/strategies/{memoryStrategyId}/actors/{actorId}/sessions/{sessionId}'],
+    });
+  }
+  /**
+   * 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.
+   */
+  public static usingBuiltInSemantic(): ManagedMemoryStrategy {
+    return new ManagedMemoryStrategy(MemoryStrategyType.SEMANTIC, {
+      name: 'semantic_builtin_cdkGen0001',
+      description:
+      'Extract general factual knowledge, concepts and meanings from raw conversations in a context-independent format.',
+      namespaces: ['/strategies/{memoryStrategyId}/actors/{actorId}'],
+    });
+  }
+  /**
+   * 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.
+   */
+  public static usingBuiltInUserPreference(): ManagedMemoryStrategy {
+    return new ManagedMemoryStrategy(MemoryStrategyType.USER_PREFERENCE, {
+      name: 'preference_builtin_cdkGen0001',
+      description: 'Capture individual preferences, interaction patterns, and personalized settings to enhance future experiences.',
+      namespaces: ['/strategies/{memoryStrategyId}/actors/{actorId}'],
+    });
+  }
+  /**
+   * 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.
+   */
+  public static usingSemantic(config: ManagedStrategyProps): ManagedMemoryStrategy {
+    return new ManagedMemoryStrategy(MemoryStrategyType.SEMANTIC, config);
+  }
+  /**
+   * 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.
+   */
+  public static usingUserPreference(config: ManagedStrategyProps): ManagedMemoryStrategy {
+    return new ManagedMemoryStrategy(MemoryStrategyType.USER_PREFERENCE, config);
+  }
+  /**
+   * 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.
+   */
+  public static usingSummarization(config: ManagedStrategyProps): ManagedMemoryStrategy {
+    return new ManagedMemoryStrategy(MemoryStrategyType.SUMMARIZATION, config);
+  }
+  /**
+   * 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.
+   */
+  public static usingSelfManaged(config: SelfManagedStrategyProps): SelfManagedMemoryStrategy {
+    // Scope is passed for future use in permission granting
+    return new SelfManagedMemoryStrategy(MemoryStrategyType.CUSTOM, config);
+  }
+}