@aws-sdk/client-bedrock-agent-runtime 3.1111.0 → 3.1112.0

package/dist-types/commands/AgenticRetrieveStreamCommand.d.ts

@@ -139,6 +139,39 @@ declare const AgenticRetrieveStreamCommand_base: {
  *   userContext: { // UserContext
  *     userId: "STRING_VALUE", // required
  *   },
+ *   memoryConfiguration: { // AgenticRetrieveMemoryConfiguration
+ *     memoryId: "STRING_VALUE", // required
+ *     sessionBinding: { // AgenticRetrieveMemorySessionBinding
+ *       actorId: "STRING_VALUE", // required
+ *       sessionId: "STRING_VALUE", // required
+ *     },
+ *     retrievalConfigs: [ // AgenticRetrieveMemoryRetrievalConfigList
+ *       { // AgenticRetrieveMemoryRetrievalConfig
+ *         namespace: "STRING_VALUE",
+ *         namespacePath: "STRING_VALUE",
+ *         strategyId: "STRING_VALUE",
+ *         metadataFilters: [ // AgenticRetrieveMemoryMetadataFilterList
+ *           { // AgenticRetrieveMemoryMetadataFilter
+ *             left: { // AgenticRetrieveMemoryMetadataFilterLeft Union: only one key present
+ *               metadataKey: "STRING_VALUE",
+ *             },
+ *             operator: "EQUALS_TO" || "EXISTS" || "NOT_EXISTS" || "BEFORE" || "AFTER" || "CONTAINS" || "GREATER_THAN" || "GREATER_THAN_OR_EQUALS" || "LESS_THAN" || "LESS_THAN_OR_EQUALS", // required
+ *             right: { // AgenticRetrieveMemoryMetadataFilterRight Union: only one key present
+ *               metadataValue: { // AgenticRetrieveMemoryMetadataValue Union: only one key present
+ *                 stringValue: "STRING_VALUE",
+ *                 numberValue: Number("double"),
+ *                 stringListValue: [ // AgenticRetrieveMemoryMetadataStringList
+ *                   "STRING_VALUE",
+ *                 ],
+ *                 dateTimeValue: new Date("TIMESTAMP"),
+ *               },
+ *             },
+ *           },
+ *         ],
+ *       },
+ *     ],
+ *     persistenceMode: "DEFAULT" || "NONE",
+ *   },
  *   generateResponse: true || false,
  * };
  * const command = new AgenticRetrieveStreamCommand(input);
@@ -181,7 +214,7 @@ declare const AgenticRetrieveStreamCommand_base: {
  * //       id: "STRING_VALUE", // required
  * //       timestamp: Number("long"), // required
  * //       attributes: { // AgenticRetrieveTraceEventAttributes
- * //         step: "Planning" || "Retrieval" || "SpeculativeRetrieval" || "FullDocumentExpansion", // required
+ * //         step: "Planning" || "Retrieval" || "SpeculativeRetrieval" || "FullDocumentExpansion" || "SessionHistoryLoad", // required
  * //         status: "IN_PROGRESS" || "SUCCEEDED" || "FAILED", // required
  * //         message: "STRING_VALUE", // required
  * //         actions: [ // AgenticRetrieveActions
@@ -200,6 +233,15 @@ declare const AgenticRetrieveStreamCommand_base: {
  * //               documentId: "STRING_VALUE",
  * //               sourceRetriever: "<AgenticRetrieveSourceRetriever>",
  * //             },
+ * //             memoryRetrieve: { // AgenticRetrieveMemoryRetrieveDetails
+ * //               inputQuery: {
+ * //                 text: "STRING_VALUE",
+ * //               },
+ * //               memoryId: "STRING_VALUE", // required
+ * //               namespace: "STRING_VALUE",
+ * //               namespacePath: "STRING_VALUE",
+ * //               strategyId: "STRING_VALUE",
+ * //             },
  * //           },
  * //         ],
  * //         warnings: [ // AgenticRetrieveWarnings
@@ -223,7 +265,7 @@ declare const AgenticRetrieveStreamCommand_base: {
  * //         retrievalMetadata: [ // AgenticRetrieveSourceMetadataList
  * //           { // AgenticRetrieveSourceMetadata
  * //             identifier: "STRING_VALUE",
- * //             retrievalType: "BedrockKnowledgeBase",
+ * //             retrievalType: "BedrockKnowledgeBase" || "BedrockAgentCoreMemory",
  * //           },
  * //         ],
  * //         retrievalResponse: [ // AgenticRetrieveTraceResults

package/dist-types/commands/CreateSessionCommand.d.ts

@@ -1,6 +1,5 @@
 import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import type { CreateSessionRequest } from "../models/models_0";
-import type { CreateSessionResponse } from "../models/models_1";
+import type { CreateSessionRequest, CreateSessionResponse } from "../models/models_1";
 /**
  * @public
  */

package/dist-types/commands/RetrieveAndGenerateStreamCommand.d.ts

@@ -1,6 +1,5 @@
 import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import type { RetrieveAndGenerateStreamResponse } from "../models/models_0";
-import type { RetrieveAndGenerateStreamRequest } from "../models/models_1";
+import type { RetrieveAndGenerateStreamRequest, RetrieveAndGenerateStreamResponse } from "../models/models_1";
 /**
  * @public
  */

package/dist-types/commands/RetrieveCommand.d.ts

@@ -1,6 +1,5 @@
 import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import type { RetrieveResponse } from "../models/models_0";
-import type { RetrieveRequest } from "../models/models_1";
+import type { RetrieveRequest, RetrieveResponse } from "../models/models_1";
 /**
  * @public
  */

package/dist-types/models/enums.d.ts

@@ -198,6 +198,74 @@ export declare const GuardrailAction: {
  * @public
  */
 export type GuardrailAction = (typeof GuardrailAction)[keyof typeof GuardrailAction];
+/**
+ * @public
+ * @enum
+ */
+export declare const AgenticRetrieveMemoryPersistenceMode: {
+    /**
+     * <p>Specifies that the question and the agent-generated answer are persisted to the session. This is the default when persistenceMode is omitted.</p>
+     */
+    readonly DEFAULT: "DEFAULT";
+    /**
+     * <p>Specifies that the session is left unchanged.</p>
+     */
+    readonly NONE: "NONE";
+};
+/**
+ * @public
+ */
+export type AgenticRetrieveMemoryPersistenceMode = (typeof AgenticRetrieveMemoryPersistenceMode)[keyof typeof AgenticRetrieveMemoryPersistenceMode];
+/**
+ * @public
+ * @enum
+ */
+export declare const AgenticRetrieveMemoryMetadataFilterOperator: {
+    /**
+     * <p>The AFTER operator matches memory records whose timestamp metadata value falls after the supplied value.</p>
+     */
+    readonly AFTER: "AFTER";
+    /**
+     * <p>The BEFORE operator matches memory records whose timestamp metadata value falls before the supplied value.</p>
+     */
+    readonly BEFORE: "BEFORE";
+    /**
+     * <p>The CONTAINS operator matches memory records whose metadata value contains the supplied value.</p>
+     */
+    readonly CONTAINS: "CONTAINS";
+    /**
+     * <p>The EQUALS_TO operator matches memory records whose metadata value equals the supplied value.</p>
+     */
+    readonly EQUALS_TO: "EQUALS_TO";
+    /**
+     * <p>The EXISTS operator matches memory records that carry the metadata key, whatever its value. This operator takes no right operand.</p>
+     */
+    readonly EXISTS: "EXISTS";
+    /**
+     * <p>The GREATER_THAN operator matches memory records whose numeric metadata value is greater than the supplied value.</p>
+     */
+    readonly GREATER_THAN: "GREATER_THAN";
+    /**
+     * <p>The GREATER_THAN_OR_EQUALS operator matches memory records whose numeric metadata value is greater than or equal to the supplied value.</p>
+     */
+    readonly GREATER_THAN_OR_EQUALS: "GREATER_THAN_OR_EQUALS";
+    /**
+     * <p>The LESS_THAN operator matches memory records whose numeric metadata value is less than the supplied value.</p>
+     */
+    readonly LESS_THAN: "LESS_THAN";
+    /**
+     * <p>The LESS_THAN_OR_EQUALS operator matches memory records whose numeric metadata value is less than or equal to the supplied value.</p>
+     */
+    readonly LESS_THAN_OR_EQUALS: "LESS_THAN_OR_EQUALS";
+    /**
+     * <p>The NOT_EXISTS operator matches memory records that do not carry the metadata key. This operator takes no right operand.</p>
+     */
+    readonly NOT_EXISTS: "NOT_EXISTS";
+};
+/**
+ * @public
+ */
+export type AgenticRetrieveMemoryMetadataFilterOperator = (typeof AgenticRetrieveMemoryMetadataFilterOperator)[keyof typeof AgenticRetrieveMemoryMetadataFilterOperator];
 /**
  * @public
  * @enum
@@ -215,6 +283,10 @@ export type ConversationRole = (typeof ConversationRole)[keyof typeof Conversati
  * @enum
  */
 export declare const AgenticRetrieveType: {
+    /**
+     * <p>An AgentCore Memory resource. Long-term memory retrievals report under the Retrieval step with this source type.</p>
+     */
+    readonly BEDROCK_AGENT_CORE_MEMORY: "BedrockAgentCoreMemory";
     /**
      * <p>A Bedrock knowledge base retrieval source.</p>
      */
@@ -263,6 +335,10 @@ export declare const AgenticRetrieveStep: {
      * <p>The retrieval phase where data is fetched.</p>
      */
     readonly RETRIEVAL: "Retrieval";
+    /**
+     * <p>The phase that restores prior session history from AgentCore Memory short-term memory, before the agent begins work.</p>
+     */
+    readonly SESSION_HISTORY_LOAD: "SessionHistoryLoad";
     /**
      * <p>A speculative retrieval phase for optimization.</p>
      */