@aws-sdk/client-bedrock-agentcore 3.901.0 → 3.904.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 (42) hide show
  1. package/README.md +40 -0
  2. package/dist-cjs/endpoint/ruleset.js +1 -1
  3. package/dist-cjs/index.js +432 -77
  4. package/dist-es/BedrockAgentCore.js +10 -0
  5. package/dist-es/commands/BatchCreateMemoryRecordsCommand.js +23 -0
  6. package/dist-es/commands/BatchDeleteMemoryRecordsCommand.js +22 -0
  7. package/dist-es/commands/BatchUpdateMemoryRecordsCommand.js +23 -0
  8. package/dist-es/commands/GetAgentCardCommand.js +22 -0
  9. package/dist-es/commands/StopRuntimeSessionCommand.js +22 -0
  10. package/dist-es/commands/index.js +5 -0
  11. package/dist-es/endpoint/ruleset.js +1 -1
  12. package/dist-es/models/models_0.js +111 -56
  13. package/dist-es/protocols/Aws_restJson1.js +193 -6
  14. package/dist-types/BedrockAgentCore.d.ts +35 -0
  15. package/dist-types/BedrockAgentCoreClient.d.ts +7 -2
  16. package/dist-types/commands/BatchCreateMemoryRecordsCommand.d.ts +123 -0
  17. package/dist-types/commands/BatchDeleteMemoryRecordsCommand.d.ts +114 -0
  18. package/dist-types/commands/BatchUpdateMemoryRecordsCommand.d.ts +122 -0
  19. package/dist-types/commands/CreateEventCommand.d.ts +10 -0
  20. package/dist-types/commands/GetAgentCardCommand.d.ts +99 -0
  21. package/dist-types/commands/GetEventCommand.d.ts +5 -0
  22. package/dist-types/commands/GetResourceApiKeyCommand.d.ts +1 -1
  23. package/dist-types/commands/GetResourceOauth2TokenCommand.d.ts +1 -1
  24. package/dist-types/commands/GetWorkloadAccessTokenCommand.d.ts +1 -1
  25. package/dist-types/commands/GetWorkloadAccessTokenForJWTCommand.d.ts +1 -1
  26. package/dist-types/commands/GetWorkloadAccessTokenForUserIdCommand.d.ts +1 -1
  27. package/dist-types/commands/ListEventsCommand.d.ts +18 -0
  28. package/dist-types/commands/StopRuntimeSessionCommand.d.ts +105 -0
  29. package/dist-types/commands/index.d.ts +5 -0
  30. package/dist-types/models/models_0.d.ts +632 -186
  31. package/dist-types/protocols/Aws_restJson1.d.ts +45 -0
  32. package/dist-types/ts3.4/BedrockAgentCore.d.ts +85 -0
  33. package/dist-types/ts3.4/BedrockAgentCoreClient.d.ts +30 -0
  34. package/dist-types/ts3.4/commands/BatchCreateMemoryRecordsCommand.d.ts +51 -0
  35. package/dist-types/ts3.4/commands/BatchDeleteMemoryRecordsCommand.d.ts +51 -0
  36. package/dist-types/ts3.4/commands/BatchUpdateMemoryRecordsCommand.d.ts +51 -0
  37. package/dist-types/ts3.4/commands/GetAgentCardCommand.d.ts +47 -0
  38. package/dist-types/ts3.4/commands/StopRuntimeSessionCommand.d.ts +51 -0
  39. package/dist-types/ts3.4/commands/index.d.ts +5 -0
  40. package/dist-types/ts3.4/models/models_0.d.ts +225 -70
  41. package/dist-types/ts3.4/protocols/Aws_restJson1.d.ts +60 -0
  42. package/package.json +1 -1
@@ -24,6 +24,46 @@ export interface ActorSummary {
24
24
  */
25
25
  actorId: string | undefined;
26
26
  }
27
+ /**
28
+ * @public
29
+ */
30
+ export interface GetAgentCardRequest {
31
+ /**
32
+ * <p>The session ID that the AgentCore Runtime agent is using. </p>
33
+ * @public
34
+ */
35
+ runtimeSessionId?: string | undefined;
36
+ /**
37
+ * <p>The ARN of the AgentCore Runtime agent for which you want to get the A2A agent card.</p>
38
+ * @public
39
+ */
40
+ agentRuntimeArn: string | undefined;
41
+ /**
42
+ * <p>Optional qualifier to specify an agent alias, such as <code>prod</code>code&gt; or <code>dev</code>. If you don't provide a value, the DEFAULT alias is used. </p>
43
+ * @public
44
+ */
45
+ qualifier?: string | undefined;
46
+ }
47
+ /**
48
+ * @public
49
+ */
50
+ export interface GetAgentCardResponse {
51
+ /**
52
+ * <p>The ID of the session associated with the AgentCore Runtime agent.</p>
53
+ * @public
54
+ */
55
+ runtimeSessionId?: string | undefined;
56
+ /**
57
+ * <p>An agent card document that contains metadata and capabilities for an AgentCore Runtime agent.</p>
58
+ * @public
59
+ */
60
+ agentCard: __DocumentType | undefined;
61
+ /**
62
+ * <p>The status code of the request.</p>
63
+ * @public
64
+ */
65
+ statusCode?: number | undefined;
66
+ }
27
67
  /**
28
68
  * <p>The exception that occurs when the service encounters an unexpected internal error. This is a temporary condition that will resolve itself with retries. We recommend implementing exponential backoff retry logic in your application.</p>
29
69
  * @public
@@ -36,6 +76,99 @@ export declare class InternalServerException extends __BaseException {
36
76
  */
37
77
  constructor(opts: __ExceptionOptionType<InternalServerException, __BaseException>);
38
78
  }
79
+ /**
80
+ * <p>The exception that occurs when the specified resource does not exist. This can happen when using an invalid identifier or when trying to access a resource that has been deleted.</p>
81
+ * @public
82
+ */
83
+ export declare class ResourceNotFoundException extends __BaseException {
84
+ readonly name: "ResourceNotFoundException";
85
+ readonly $fault: "client";
86
+ /**
87
+ * @internal
88
+ */
89
+ constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
90
+ }
91
+ /**
92
+ * <p>The exception that occurs when there is an error in the runtime client. This can happen due to network issues, invalid configuration, or other client-side problems. Check the error message for specific details about the error.</p>
93
+ * @public
94
+ */
95
+ export declare class RuntimeClientError extends __BaseException {
96
+ readonly name: "RuntimeClientError";
97
+ readonly $fault: "client";
98
+ /**
99
+ * @internal
100
+ */
101
+ constructor(opts: __ExceptionOptionType<RuntimeClientError, __BaseException>);
102
+ }
103
+ /**
104
+ * <p>The exception that occurs when the request would cause a service quota to be exceeded. Review your service quotas and either reduce your request rate or request a quota increase.</p>
105
+ * @public
106
+ */
107
+ export declare class ServiceQuotaExceededException extends __BaseException {
108
+ readonly name: "ServiceQuotaExceededException";
109
+ readonly $fault: "client";
110
+ /**
111
+ * @internal
112
+ */
113
+ constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>);
114
+ }
115
+ /**
116
+ * <p>The exception that occurs when the request was denied due to request throttling. This happens when you exceed the allowed request rate for an operation. Reduce the frequency of requests or implement exponential backoff retry logic in your application.</p>
117
+ * @public
118
+ */
119
+ export declare class ThrottlingException extends __BaseException {
120
+ readonly name: "ThrottlingException";
121
+ readonly $fault: "client";
122
+ /**
123
+ * @internal
124
+ */
125
+ constructor(opts: __ExceptionOptionType<ThrottlingException, __BaseException>);
126
+ }
127
+ /**
128
+ * <p>Stores information about a field passed inside a request that resulted in an exception.</p>
129
+ * @public
130
+ */
131
+ export interface ValidationExceptionField {
132
+ /**
133
+ * <p>The name of the field.</p>
134
+ * @public
135
+ */
136
+ name: string | undefined;
137
+ /**
138
+ * <p>A message describing why this field failed validation.</p>
139
+ * @public
140
+ */
141
+ message: string | undefined;
142
+ }
143
+ /**
144
+ * @public
145
+ * @enum
146
+ */
147
+ export declare const ValidationExceptionReason: {
148
+ readonly CANNOT_PARSE: "CannotParse";
149
+ readonly FIELD_VALIDATION_FAILED: "FieldValidationFailed";
150
+ readonly IDEMPOTENT_PARAMETER_MISMATCH_EXCEPTION: "IdempotentParameterMismatchException";
151
+ readonly RESOURCE_CONFLICT: "ResourceConflict";
152
+ readonly ROOT_EVENT_IN_OTHER_SESSION: "EventInOtherSession";
153
+ };
154
+ /**
155
+ * @public
156
+ */
157
+ export type ValidationExceptionReason = (typeof ValidationExceptionReason)[keyof typeof ValidationExceptionReason];
158
+ /**
159
+ * <p>The exception that occurs when the input fails to satisfy the constraints specified by the service. Check the error message for details about which input parameter is invalid and correct your request.</p>
160
+ * @public
161
+ */
162
+ export declare class ValidationException extends __BaseException {
163
+ readonly name: "ValidationException";
164
+ readonly $fault: "client";
165
+ reason: ValidationExceptionReason | undefined;
166
+ fieldList?: ValidationExceptionField[] | undefined;
167
+ /**
168
+ * @internal
169
+ */
170
+ constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
171
+ }
39
172
  /**
40
173
  * @public
41
174
  */
@@ -162,97 +295,68 @@ export interface InvokeAgentRuntimeResponse {
162
295
  statusCode?: number | undefined;
163
296
  }
164
297
  /**
165
- * <p>The exception that occurs when the specified resource does not exist. This can happen when using an invalid identifier or when trying to access a resource that has been deleted.</p>
298
+ * <p>The exception that occurs when the request conflicts with the current state of the resource. This can happen when trying to modify a resource that is currently being modified by another request, or when trying to create a resource that already exists.</p>
166
299
  * @public
167
300
  */
168
- export declare class ResourceNotFoundException extends __BaseException {
169
- readonly name: "ResourceNotFoundException";
301
+ export declare class ConflictException extends __BaseException {
302
+ readonly name: "ConflictException";
170
303
  readonly $fault: "client";
171
304
  /**
172
305
  * @internal
173
306
  */
174
- constructor(opts: __ExceptionOptionType<ResourceNotFoundException, __BaseException>);
307
+ constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
175
308
  }
176
309
  /**
177
- * <p>The exception that occurs when there is an error in the runtime client. This can happen due to network issues, invalid configuration, or other client-side problems. Check the error message for specific details about the error.</p>
178
310
  * @public
179
311
  */
180
- export declare class RuntimeClientError extends __BaseException {
181
- readonly name: "RuntimeClientError";
182
- readonly $fault: "client";
312
+ export interface StopRuntimeSessionRequest {
183
313
  /**
184
- * @internal
314
+ * <p>The ID of the session that you want to stop.</p>
315
+ * @public
185
316
  */
186
- constructor(opts: __ExceptionOptionType<RuntimeClientError, __BaseException>);
187
- }
188
- /**
189
- * <p>The exception that occurs when the request would cause a service quota to be exceeded. Review your service quotas and either reduce your request rate or request a quota increase.</p>
190
- * @public
191
- */
192
- export declare class ServiceQuotaExceededException extends __BaseException {
193
- readonly name: "ServiceQuotaExceededException";
194
- readonly $fault: "client";
317
+ runtimeSessionId: string | undefined;
195
318
  /**
196
- * @internal
319
+ * <p>The ARN of the agent that contains the session that you want to stop.</p>
320
+ * @public
197
321
  */
198
- constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>);
199
- }
200
- /**
201
- * <p>The exception that occurs when the request was denied due to request throttling. This happens when you exceed the allowed request rate for an operation. Reduce the frequency of requests or implement exponential backoff retry logic in your application.</p>
202
- * @public
203
- */
204
- export declare class ThrottlingException extends __BaseException {
205
- readonly name: "ThrottlingException";
206
- readonly $fault: "client";
322
+ agentRuntimeArn: string | undefined;
207
323
  /**
208
- * @internal
324
+ * <p>Optional qualifier to specify an agent alias, such as <code>prod</code>code&gt; or <code>dev</code>. If you don't provide a value, the DEFAULT alias is used. </p>
325
+ * @public
209
326
  */
210
- constructor(opts: __ExceptionOptionType<ThrottlingException, __BaseException>);
327
+ qualifier?: string | undefined;
328
+ /**
329
+ * <p>Idempotent token used to identify the request. If you use the same token with multiple requests, the same response is returned. Use ClientToken to prevent the same request from being processed more than once.</p>
330
+ * @public
331
+ */
332
+ clientToken?: string | undefined;
211
333
  }
212
334
  /**
213
- * <p>Stores information about a field passed inside a request that resulted in an exception.</p>
214
335
  * @public
215
336
  */
216
- export interface ValidationExceptionField {
337
+ export interface StopRuntimeSessionResponse {
217
338
  /**
218
- * <p>The name of the field.</p>
339
+ * <p>The ID of the session that you requested to stop.</p>
219
340
  * @public
220
341
  */
221
- name: string | undefined;
342
+ runtimeSessionId?: string | undefined;
222
343
  /**
223
- * <p>A message describing why this field failed validation.</p>
344
+ * <p>The status code of the request to stop the session.</p>
224
345
  * @public
225
346
  */
226
- message: string | undefined;
347
+ statusCode?: number | undefined;
227
348
  }
228
349
  /**
229
- * @public
230
- * @enum
231
- */
232
- export declare const ValidationExceptionReason: {
233
- readonly CANNOT_PARSE: "CannotParse";
234
- readonly FIELD_VALIDATION_FAILED: "FieldValidationFailed";
235
- readonly IDEMPOTENT_PARAMETER_MISMATCH_EXCEPTION: "IdempotentParameterMismatchException";
236
- readonly RESOURCE_CONFLICT: "ResourceConflict";
237
- readonly ROOT_EVENT_IN_OTHER_SESSION: "EventInOtherSession";
238
- };
239
- /**
240
- * @public
241
- */
242
- export type ValidationExceptionReason = (typeof ValidationExceptionReason)[keyof typeof ValidationExceptionReason];
243
- /**
244
- * <p>The exception that occurs when the input fails to satisfy the constraints specified by the service. Check the error message for details about which input parameter is invalid and correct your request.</p>
350
+ * <p>This exception is thrown when the JWT bearer token is invalid or not found for OAuth bearer token based access</p>
245
351
  * @public
246
352
  */
247
- export declare class ValidationException extends __BaseException {
248
- readonly name: "ValidationException";
353
+ export declare class UnauthorizedException extends __BaseException {
354
+ readonly name: "UnauthorizedException";
249
355
  readonly $fault: "client";
250
- reason: ValidationExceptionReason | undefined;
251
- fieldList?: ValidationExceptionField[] | undefined;
252
356
  /**
253
357
  * @internal
254
358
  */
255
- constructor(opts: __ExceptionOptionType<ValidationException, __BaseException>);
359
+ constructor(opts: __ExceptionOptionType<UnauthorizedException, __BaseException>);
256
360
  }
257
361
  /**
258
362
  * @public
@@ -483,18 +587,6 @@ export interface ListBrowserSessionsResponse {
483
587
  */
484
588
  nextToken?: string | undefined;
485
589
  }
486
- /**
487
- * <p>The exception that occurs when the request conflicts with the current state of the resource. This can happen when trying to modify a resource that is currently being modified by another request, or when trying to create a resource that already exists.</p>
488
- * @public
489
- */
490
- export declare class ConflictException extends __BaseException {
491
- readonly name: "ConflictException";
492
- readonly $fault: "client";
493
- /**
494
- * @internal
495
- */
496
- constructor(opts: __ExceptionOptionType<ConflictException, __BaseException>);
497
- }
498
590
  /**
499
591
  * @public
500
592
  */
@@ -834,7 +926,7 @@ export interface StartCodeInterpreterSessionRequest {
834
926
  */
835
927
  name?: string | undefined;
836
928
  /**
837
- * <p>The time in seconds after which the session automatically terminates if there is no activity. The default value is 3600 seconds (1 hour). The minimum allowed value is 60 seconds, and the maximum allowed value is 28800 seconds (8 hours).</p>
929
+ * <p>The time in seconds after which the session automatically terminates if there is no activity. The default value is 900 seconds (15 minutes). The minimum allowed value is 60 seconds, and the maximum allowed value is 28800 seconds (8 hours).</p>
838
930
  * @public
839
931
  */
840
932
  sessionTimeoutSeconds?: number | undefined;
@@ -909,12 +1001,12 @@ export interface StopCodeInterpreterSessionResponse {
909
1001
  */
910
1002
  export interface GetResourceApiKeyRequest {
911
1003
  /**
912
- * <p>The identity token of the workload you want to get the API Key of.</p>
1004
+ * <p>The identity token of the workload from which you want to retrieve the API key.</p>
913
1005
  * @public
914
1006
  */
915
1007
  workloadIdentityToken: string | undefined;
916
1008
  /**
917
- * <p>The credential provider name of the resource you are retrieving the API Key of.</p>
1009
+ * <p>The credential provider name for the resource from which you are retrieving the API key.</p>
918
1010
  * @public
919
1011
  */
920
1012
  resourceCredentialProviderName: string | undefined;
@@ -924,23 +1016,11 @@ export interface GetResourceApiKeyRequest {
924
1016
  */
925
1017
  export interface GetResourceApiKeyResponse {
926
1018
  /**
927
- * <p>The API Key associated with the resource requested.</p>
1019
+ * <p>The API key associated with the resource requested.</p>
928
1020
  * @public
929
1021
  */
930
1022
  apiKey: string | undefined;
931
1023
  }
932
- /**
933
- * <p>This exception is thrown when the JWT bearer token is invalid or not found for OAuth bearer token based access</p>
934
- * @public
935
- */
936
- export declare class UnauthorizedException extends __BaseException {
937
- readonly name: "UnauthorizedException";
938
- readonly $fault: "client";
939
- /**
940
- * @internal
941
- */
942
- constructor(opts: __ExceptionOptionType<UnauthorizedException, __BaseException>);
943
- }
944
1024
  /**
945
1025
  * @public
946
1026
  * @enum
@@ -958,37 +1038,37 @@ export type Oauth2FlowType = (typeof Oauth2FlowType)[keyof typeof Oauth2FlowType
958
1038
  */
959
1039
  export interface GetResourceOauth2TokenRequest {
960
1040
  /**
961
- * <p>The identity token of the workload you want to retrive the Oauth2 Token of.</p>
1041
+ * <p>The identity token of the workload from which you want to retrieve the OAuth2 token.</p>
962
1042
  * @public
963
1043
  */
964
1044
  workloadIdentityToken: string | undefined;
965
1045
  /**
966
- * <p>Reference to the credential provider</p>
1046
+ * <p>The name of the resource's credential provider.</p>
967
1047
  * @public
968
1048
  */
969
1049
  resourceCredentialProviderName: string | undefined;
970
1050
  /**
971
- * <p>The OAuth scopes requested</p>
1051
+ * <p>The OAuth scopes being requested.</p>
972
1052
  * @public
973
1053
  */
974
1054
  scopes: string[] | undefined;
975
1055
  /**
976
- * <p>The type of flow to be performed</p>
1056
+ * <p>The type of flow to be performed.</p>
977
1057
  * @public
978
1058
  */
979
1059
  oauth2Flow: Oauth2FlowType | undefined;
980
1060
  /**
981
- * <p>Callback url to redirect after token retrieval completes. Should be one of the provideded urls during WorkloadIdentity creation</p>
1061
+ * <p>The callback URL to redirect to after the OAuth 2.0 token retrieval is complete. This URL must be one of the provided URLs configured for the workload identity.</p>
982
1062
  * @public
983
1063
  */
984
1064
  resourceOauth2ReturnUrl?: string | undefined;
985
1065
  /**
986
- * <p>If true, always initiate a new 3LO flow</p>
1066
+ * <p>Indicates whether to always initiate a new three-legged OAuth (3LO) flow, regardless of any existing session.</p>
987
1067
  * @public
988
1068
  */
989
1069
  forceAuthentication?: boolean | undefined;
990
1070
  /**
991
- * <p>Gives the ability to send extra/custom parameters to the resource credentials provider during the authorization process. Standard OAuth2 flow parameters will not be overriden.</p>
1071
+ * <p>A map of custom parameters to include in the authorization request to the resource credential provider. These parameters are in addition to the standard OAuth 2.0 flow parameters, and will not override them.</p>
992
1072
  * @public
993
1073
  */
994
1074
  customParameters?: Record<string, string> | undefined;
@@ -998,12 +1078,12 @@ export interface GetResourceOauth2TokenRequest {
998
1078
  */
999
1079
  export interface GetResourceOauth2TokenResponse {
1000
1080
  /**
1001
- * <p>The URL for the authorization process, provided if the Access token requires user Authorization.</p>
1081
+ * <p>The URL to initiate the authorization process, provided when the access token requires user authorization.</p>
1002
1082
  * @public
1003
1083
  */
1004
1084
  authorizationUrl?: string | undefined;
1005
1085
  /**
1006
- * <p>OAuth2 token ready for use</p>
1086
+ * <p>The OAuth 2.0 access token to use.</p>
1007
1087
  * @public
1008
1088
  */
1009
1089
  accessToken?: string | undefined;
@@ -1013,7 +1093,7 @@ export interface GetResourceOauth2TokenResponse {
1013
1093
  */
1014
1094
  export interface GetWorkloadAccessTokenRequest {
1015
1095
  /**
1016
- * <p>Unique identifier for the registered agent</p>
1096
+ * <p>The unique identifier for the registered workload.</p>
1017
1097
  * @public
1018
1098
  */
1019
1099
  workloadName: string | undefined;
@@ -1023,7 +1103,7 @@ export interface GetWorkloadAccessTokenRequest {
1023
1103
  */
1024
1104
  export interface GetWorkloadAccessTokenResponse {
1025
1105
  /**
1026
- * <p>Opaque token representing both agent and user identity</p>
1106
+ * <p>An opaque token representing the identity of both the workload and the user.</p>
1027
1107
  * @public
1028
1108
  */
1029
1109
  workloadAccessToken: string | undefined;
@@ -1033,12 +1113,12 @@ export interface GetWorkloadAccessTokenResponse {
1033
1113
  */
1034
1114
  export interface GetWorkloadAccessTokenForJWTRequest {
1035
1115
  /**
1036
- * <p>Unique identifier for the registered agent</p>
1116
+ * <p>The unique identifier for the registered workload.</p>
1037
1117
  * @public
1038
1118
  */
1039
1119
  workloadName: string | undefined;
1040
1120
  /**
1041
- * <p>OAuth2 token issued by the user's identity provider</p>
1121
+ * <p>The OAuth 2.0 token issued by the user's identity provider.</p>
1042
1122
  * @public
1043
1123
  */
1044
1124
  userToken: string | undefined;
@@ -1048,7 +1128,7 @@ export interface GetWorkloadAccessTokenForJWTRequest {
1048
1128
  */
1049
1129
  export interface GetWorkloadAccessTokenForJWTResponse {
1050
1130
  /**
1051
- * <p>Opaque token representing both agent and user identity</p>
1131
+ * <p>An opaque token representing the identity of both the workload and the user.</p>
1052
1132
  * @public
1053
1133
  */
1054
1134
  workloadAccessToken: string | undefined;
@@ -1058,12 +1138,12 @@ export interface GetWorkloadAccessTokenForJWTResponse {
1058
1138
  */
1059
1139
  export interface GetWorkloadAccessTokenForUserIdRequest {
1060
1140
  /**
1061
- * <p>The name of the worklaod you want to get the access token of.</p>
1141
+ * <p>The name of the workload from which you want to retrieve the access token.</p>
1062
1142
  * @public
1063
1143
  */
1064
1144
  workloadName: string | undefined;
1065
1145
  /**
1066
- * <p>The user id of the user you are retrieving the access token for.</p>
1146
+ * <p>The ID of the user for whom you are retrieving the access token.</p>
1067
1147
  * @public
1068
1148
  */
1069
1149
  userId: string | undefined;
@@ -1073,7 +1153,7 @@ export interface GetWorkloadAccessTokenForUserIdRequest {
1073
1153
  */
1074
1154
  export interface GetWorkloadAccessTokenForUserIdResponse {
1075
1155
  /**
1076
- * <p>The workload access token of the named workload.</p>
1156
+ * <p>The access token for the specified workload.</p>
1077
1157
  * @public
1078
1158
  */
1079
1159
  workloadAccessToken: string | undefined;
@@ -1559,32 +1639,16 @@ export interface InvokeCodeInterpreterResponse {
1559
1639
  stream: AsyncIterable<CodeInterpreterStreamOutput> | undefined;
1560
1640
  }
1561
1641
  /**
1562
- * <p>Contains information about a branch in an AgentCore Memory resource. Branches allow for organizing events into different conversation threads or paths.</p>
1563
- * @public
1564
- */
1565
- export interface Branch {
1566
- /**
1567
- * <p>The identifier of the root event for this branch.</p>
1568
- * @public
1569
- */
1570
- rootEventId?: string | undefined;
1571
- /**
1572
- * <p>The name of the branch.</p>
1573
- * @public
1574
- */
1575
- name: string | undefined;
1576
- }
1577
- /**
1578
- * <p>Contains the content of a memory item.</p>
1642
+ * <p>Contains the content of a memory record.</p>
1579
1643
  * @public
1580
1644
  */
1581
- export type Content = Content.TextMember | Content.$UnknownMember;
1645
+ export type MemoryContent = MemoryContent.TextMember | MemoryContent.$UnknownMember;
1582
1646
  /**
1583
1647
  * @public
1584
1648
  */
1585
- export declare namespace Content {
1649
+ export declare namespace MemoryContent {
1586
1650
  /**
1587
- * <p>The text content of the memory item.</p>
1651
+ * <p>The text content of the memory record.</p>
1588
1652
  * @public
1589
1653
  */
1590
1654
  interface TextMember {
@@ -1602,16 +1666,327 @@ export declare namespace Content {
1602
1666
  text: (value: string) => T;
1603
1667
  _: (name: string, value: any) => T;
1604
1668
  }
1605
- const visit: <T>(value: Content, visitor: Visitor<T>) => T;
1669
+ const visit: <T>(value: MemoryContent, visitor: Visitor<T>) => T;
1606
1670
  }
1607
1671
  /**
1672
+ * <p>Input structure to create a new memory record.</p>
1608
1673
  * @public
1609
- * @enum
1610
1674
  */
1611
- export declare const Role: {
1612
- readonly ASSISTANT: "ASSISTANT";
1613
- readonly OTHER: "OTHER";
1614
- readonly TOOL: "TOOL";
1675
+ export interface MemoryRecordCreateInput {
1676
+ /**
1677
+ * <p>A client-provided identifier for tracking this specific record creation request.</p>
1678
+ * @public
1679
+ */
1680
+ requestIdentifier: string | undefined;
1681
+ /**
1682
+ * <p>A list of namespace identifiers that categorize or group the memory record.</p>
1683
+ * @public
1684
+ */
1685
+ namespaces: string[] | undefined;
1686
+ /**
1687
+ * <p>The content to be stored within the memory record.</p>
1688
+ * @public
1689
+ */
1690
+ content: MemoryContent | undefined;
1691
+ /**
1692
+ * <p>Time at which the memory record was created.</p>
1693
+ * @public
1694
+ */
1695
+ timestamp: Date | undefined;
1696
+ /**
1697
+ * <p>The ID of the memory strategy that defines how this memory record is grouped.</p>
1698
+ * @public
1699
+ */
1700
+ memoryStrategyId?: string | undefined;
1701
+ }
1702
+ /**
1703
+ * @public
1704
+ */
1705
+ export interface BatchCreateMemoryRecordsInput {
1706
+ /**
1707
+ * <p>The unique ID of the memory resource where records will be created.</p>
1708
+ * @public
1709
+ */
1710
+ memoryId: string | undefined;
1711
+ /**
1712
+ * <p>A list of memory record creation inputs to be processed in the batch operation.</p>
1713
+ * @public
1714
+ */
1715
+ records: MemoryRecordCreateInput[] | undefined;
1716
+ /**
1717
+ * <p>A unique, case-sensitive identifier to ensure idempotent processing of the batch request.</p>
1718
+ * @public
1719
+ */
1720
+ clientToken?: string | undefined;
1721
+ }
1722
+ /**
1723
+ * @public
1724
+ * @enum
1725
+ */
1726
+ export declare const MemoryRecordStatus: {
1727
+ readonly FAILED: "FAILED";
1728
+ readonly SUCCEEDED: "SUCCEEDED";
1729
+ };
1730
+ /**
1731
+ * @public
1732
+ */
1733
+ export type MemoryRecordStatus = (typeof MemoryRecordStatus)[keyof typeof MemoryRecordStatus];
1734
+ /**
1735
+ * <p>Output information returned after processing a memory record operation.</p>
1736
+ * @public
1737
+ */
1738
+ export interface MemoryRecordOutput {
1739
+ /**
1740
+ * <p>The unique ID associated to the memory record.</p>
1741
+ * @public
1742
+ */
1743
+ memoryRecordId: string | undefined;
1744
+ /**
1745
+ * <p>The status of the memory record operation (e.g., SUCCEEDED, FAILED).</p>
1746
+ * @public
1747
+ */
1748
+ status: MemoryRecordStatus | undefined;
1749
+ /**
1750
+ * <p>The client-provided identifier that was used to track this record operation.</p>
1751
+ * @public
1752
+ */
1753
+ requestIdentifier?: string | undefined;
1754
+ /**
1755
+ * <p>The error code returned when the memory record operation fails.</p>
1756
+ * @public
1757
+ */
1758
+ errorCode?: number | undefined;
1759
+ /**
1760
+ * <p>A human-readable error message describing why the memory record operation failed.</p>
1761
+ * @public
1762
+ */
1763
+ errorMessage?: string | undefined;
1764
+ }
1765
+ /**
1766
+ * @public
1767
+ */
1768
+ export interface BatchCreateMemoryRecordsOutput {
1769
+ /**
1770
+ * <p>A list of memory records that were successfully created during the batch operation.</p>
1771
+ * @public
1772
+ */
1773
+ successfulRecords: MemoryRecordOutput[] | undefined;
1774
+ /**
1775
+ * <p>A list of memory records that failed to be created, including error details for each failure.</p>
1776
+ * @public
1777
+ */
1778
+ failedRecords: MemoryRecordOutput[] | undefined;
1779
+ }
1780
+ /**
1781
+ * <p>The service encountered an internal error. Try your request again later.</p>
1782
+ * @public
1783
+ */
1784
+ export declare class ServiceException extends __BaseException {
1785
+ readonly name: "ServiceException";
1786
+ readonly $fault: "server";
1787
+ /**
1788
+ * @internal
1789
+ */
1790
+ constructor(opts: __ExceptionOptionType<ServiceException, __BaseException>);
1791
+ }
1792
+ /**
1793
+ * <p>The request was denied due to request throttling. Reduce the frequency of requests and try again.</p>
1794
+ * @public
1795
+ */
1796
+ export declare class ThrottledException extends __BaseException {
1797
+ readonly name: "ThrottledException";
1798
+ readonly $fault: "client";
1799
+ /**
1800
+ * @internal
1801
+ */
1802
+ constructor(opts: __ExceptionOptionType<ThrottledException, __BaseException>);
1803
+ }
1804
+ /**
1805
+ * <p>Input structure to delete an existing memory record.</p>
1806
+ * @public
1807
+ */
1808
+ export interface MemoryRecordDeleteInput {
1809
+ /**
1810
+ * <p>The unique ID of the memory record to be deleted.</p>
1811
+ * @public
1812
+ */
1813
+ memoryRecordId: string | undefined;
1814
+ }
1815
+ /**
1816
+ * @public
1817
+ */
1818
+ export interface BatchDeleteMemoryRecordsInput {
1819
+ /**
1820
+ * <p>The unique ID of the memory resource where records will be deleted.</p>
1821
+ * @public
1822
+ */
1823
+ memoryId: string | undefined;
1824
+ /**
1825
+ * <p>A list of memory record deletion inputs to be processed in the batch operation.</p>
1826
+ * @public
1827
+ */
1828
+ records: MemoryRecordDeleteInput[] | undefined;
1829
+ }
1830
+ /**
1831
+ * @public
1832
+ */
1833
+ export interface BatchDeleteMemoryRecordsOutput {
1834
+ /**
1835
+ * <p>A list of memory records that were successfully deleted during the batch operation.</p>
1836
+ * @public
1837
+ */
1838
+ successfulRecords: MemoryRecordOutput[] | undefined;
1839
+ /**
1840
+ * <p>A list of memory records that failed to be deleted, including error details for each failure.</p>
1841
+ * @public
1842
+ */
1843
+ failedRecords: MemoryRecordOutput[] | undefined;
1844
+ }
1845
+ /**
1846
+ * <p>Input structure to update an existing memory record.</p>
1847
+ * @public
1848
+ */
1849
+ export interface MemoryRecordUpdateInput {
1850
+ /**
1851
+ * <p>The unique ID of the memory record to be updated.</p>
1852
+ * @public
1853
+ */
1854
+ memoryRecordId: string | undefined;
1855
+ /**
1856
+ * <p>Time at which the memory record was updated</p>
1857
+ * @public
1858
+ */
1859
+ timestamp: Date | undefined;
1860
+ /**
1861
+ * <p>The content to be stored within the memory record.</p>
1862
+ * @public
1863
+ */
1864
+ content?: MemoryContent | undefined;
1865
+ /**
1866
+ * <p>The updated list of namespace identifiers for categorizing the memory record.</p>
1867
+ * @public
1868
+ */
1869
+ namespaces?: string[] | undefined;
1870
+ /**
1871
+ * <p>The updated ID of the memory strategy that defines how this memory record is grouped.</p>
1872
+ * @public
1873
+ */
1874
+ memoryStrategyId?: string | undefined;
1875
+ }
1876
+ /**
1877
+ * @public
1878
+ */
1879
+ export interface BatchUpdateMemoryRecordsInput {
1880
+ /**
1881
+ * <p>The unique ID of the memory resource where records will be updated.</p>
1882
+ * @public
1883
+ */
1884
+ memoryId: string | undefined;
1885
+ /**
1886
+ * <p>A list of memory record update inputs to be processed in the batch operation.</p>
1887
+ * @public
1888
+ */
1889
+ records: MemoryRecordUpdateInput[] | undefined;
1890
+ }
1891
+ /**
1892
+ * @public
1893
+ */
1894
+ export interface BatchUpdateMemoryRecordsOutput {
1895
+ /**
1896
+ * <p>A list of memory records that were successfully updated during the batch operation.</p>
1897
+ * @public
1898
+ */
1899
+ successfulRecords: MemoryRecordOutput[] | undefined;
1900
+ /**
1901
+ * <p>A list of memory records that failed to be updated, including error details for each failure.</p>
1902
+ * @public
1903
+ */
1904
+ failedRecords: MemoryRecordOutput[] | undefined;
1905
+ }
1906
+ /**
1907
+ * <p>Contains information about a branch in an AgentCore Memory resource. Branches allow for organizing events into different conversation threads or paths.</p>
1908
+ * @public
1909
+ */
1910
+ export interface Branch {
1911
+ /**
1912
+ * <p>The identifier of the root event for this branch.</p>
1913
+ * @public
1914
+ */
1915
+ rootEventId?: string | undefined;
1916
+ /**
1917
+ * <p>The name of the branch.</p>
1918
+ * @public
1919
+ */
1920
+ name: string | undefined;
1921
+ }
1922
+ /**
1923
+ * <p>Value associated with the <code>eventMetadata</code> key.</p>
1924
+ * @public
1925
+ */
1926
+ export type MetadataValue = MetadataValue.StringValueMember | MetadataValue.$UnknownMember;
1927
+ /**
1928
+ * @public
1929
+ */
1930
+ export declare namespace MetadataValue {
1931
+ /**
1932
+ * <p>Value associated with the <code>eventMetadata</code> key.</p>
1933
+ * @public
1934
+ */
1935
+ interface StringValueMember {
1936
+ stringValue: string;
1937
+ $unknown?: never;
1938
+ }
1939
+ /**
1940
+ * @public
1941
+ */
1942
+ interface $UnknownMember {
1943
+ stringValue?: never;
1944
+ $unknown: [string, any];
1945
+ }
1946
+ interface Visitor<T> {
1947
+ stringValue: (value: string) => T;
1948
+ _: (name: string, value: any) => T;
1949
+ }
1950
+ const visit: <T>(value: MetadataValue, visitor: Visitor<T>) => T;
1951
+ }
1952
+ /**
1953
+ * <p>Contains the content of a memory item.</p>
1954
+ * @public
1955
+ */
1956
+ export type Content = Content.TextMember | Content.$UnknownMember;
1957
+ /**
1958
+ * @public
1959
+ */
1960
+ export declare namespace Content {
1961
+ /**
1962
+ * <p>The text content of the memory item.</p>
1963
+ * @public
1964
+ */
1965
+ interface TextMember {
1966
+ text: string;
1967
+ $unknown?: never;
1968
+ }
1969
+ /**
1970
+ * @public
1971
+ */
1972
+ interface $UnknownMember {
1973
+ text?: never;
1974
+ $unknown: [string, any];
1975
+ }
1976
+ interface Visitor<T> {
1977
+ text: (value: string) => T;
1978
+ _: (name: string, value: any) => T;
1979
+ }
1980
+ const visit: <T>(value: Content, visitor: Visitor<T>) => T;
1981
+ }
1982
+ /**
1983
+ * @public
1984
+ * @enum
1985
+ */
1986
+ export declare const Role: {
1987
+ readonly ASSISTANT: "ASSISTANT";
1988
+ readonly OTHER: "OTHER";
1989
+ readonly TOOL: "TOOL";
1615
1990
  readonly USER: "USER";
1616
1991
  };
1617
1992
  /**
@@ -1715,6 +2090,11 @@ export interface CreateEventInput {
1715
2090
  * @public
1716
2091
  */
1717
2092
  clientToken?: string | undefined;
2093
+ /**
2094
+ * <p>The key-value metadata to attach to the event.</p>
2095
+ * @public
2096
+ */
2097
+ metadata?: Record<string, MetadataValue> | undefined;
1718
2098
  }
1719
2099
  /**
1720
2100
  * <p>Contains information about an event in an AgentCore Memory resource.</p>
@@ -1756,6 +2136,11 @@ export interface Event {
1756
2136
  * @public
1757
2137
  */
1758
2138
  branch?: Branch | undefined;
2139
+ /**
2140
+ * <p>Metadata associated with an event.</p>
2141
+ * @public
2142
+ */
2143
+ metadata?: Record<string, MetadataValue> | undefined;
1759
2144
  }
1760
2145
  /**
1761
2146
  * @public
@@ -1779,30 +2164,6 @@ export declare class InvalidInputException extends __BaseException {
1779
2164
  */
1780
2165
  constructor(opts: __ExceptionOptionType<InvalidInputException, __BaseException>);
1781
2166
  }
1782
- /**
1783
- * <p>The service encountered an internal error. Try your request again later.</p>
1784
- * @public
1785
- */
1786
- export declare class ServiceException extends __BaseException {
1787
- readonly name: "ServiceException";
1788
- readonly $fault: "server";
1789
- /**
1790
- * @internal
1791
- */
1792
- constructor(opts: __ExceptionOptionType<ServiceException, __BaseException>);
1793
- }
1794
- /**
1795
- * <p>The request was denied due to request throttling. Reduce the frequency of requests and try again.</p>
1796
- * @public
1797
- */
1798
- export declare class ThrottledException extends __BaseException {
1799
- readonly name: "ThrottledException";
1800
- readonly $fault: "client";
1801
- /**
1802
- * @internal
1803
- */
1804
- constructor(opts: __ExceptionOptionType<ThrottledException, __BaseException>);
1805
- }
1806
2167
  /**
1807
2168
  * @public
1808
2169
  */
@@ -1913,36 +2274,6 @@ export interface GetMemoryRecordInput {
1913
2274
  */
1914
2275
  memoryRecordId: string | undefined;
1915
2276
  }
1916
- /**
1917
- * <p>Contains the content of a memory record.</p>
1918
- * @public
1919
- */
1920
- export type MemoryContent = MemoryContent.TextMember | MemoryContent.$UnknownMember;
1921
- /**
1922
- * @public
1923
- */
1924
- export declare namespace MemoryContent {
1925
- /**
1926
- * <p>The text content of the memory record.</p>
1927
- * @public
1928
- */
1929
- interface TextMember {
1930
- text: string;
1931
- $unknown?: never;
1932
- }
1933
- /**
1934
- * @public
1935
- */
1936
- interface $UnknownMember {
1937
- text?: never;
1938
- $unknown: [string, any];
1939
- }
1940
- interface Visitor<T> {
1941
- text: (value: string) => T;
1942
- _: (name: string, value: any) => T;
1943
- }
1944
- const visit: <T>(value: MemoryContent, visitor: Visitor<T>) => T;
1945
- }
1946
2277
  /**
1947
2278
  * <p>Contains information about a memory record in an AgentCore Memory resource.</p>
1948
2279
  * @public
@@ -2035,6 +2366,100 @@ export interface BranchFilter {
2035
2366
  */
2036
2367
  includeParentBranches?: boolean | undefined;
2037
2368
  }
2369
+ /**
2370
+ * <p>Left expression of the event metadata filter.</p>
2371
+ * @public
2372
+ */
2373
+ export type LeftExpression = LeftExpression.MetadataKeyMember | LeftExpression.$UnknownMember;
2374
+ /**
2375
+ * @public
2376
+ */
2377
+ export declare namespace LeftExpression {
2378
+ /**
2379
+ * <p>Key associated with the metadata in an event.</p>
2380
+ * @public
2381
+ */
2382
+ interface MetadataKeyMember {
2383
+ metadataKey: string;
2384
+ $unknown?: never;
2385
+ }
2386
+ /**
2387
+ * @public
2388
+ */
2389
+ interface $UnknownMember {
2390
+ metadataKey?: never;
2391
+ $unknown: [string, any];
2392
+ }
2393
+ interface Visitor<T> {
2394
+ metadataKey: (value: string) => T;
2395
+ _: (name: string, value: any) => T;
2396
+ }
2397
+ const visit: <T>(value: LeftExpression, visitor: Visitor<T>) => T;
2398
+ }
2399
+ /**
2400
+ * @public
2401
+ * @enum
2402
+ */
2403
+ export declare const OperatorType: {
2404
+ readonly EQUALS_TO: "EQUALS_TO";
2405
+ readonly EXISTS: "EXISTS";
2406
+ readonly NOT_EXISTS: "NOT_EXISTS";
2407
+ };
2408
+ /**
2409
+ * @public
2410
+ */
2411
+ export type OperatorType = (typeof OperatorType)[keyof typeof OperatorType];
2412
+ /**
2413
+ * <p>Right expression of the <code>eventMetadata</code>filter.</p>
2414
+ * @public
2415
+ */
2416
+ export type RightExpression = RightExpression.MetadataValueMember | RightExpression.$UnknownMember;
2417
+ /**
2418
+ * @public
2419
+ */
2420
+ export declare namespace RightExpression {
2421
+ /**
2422
+ * <p>Value associated with the key in <code>eventMetadata</code>.</p>
2423
+ * @public
2424
+ */
2425
+ interface MetadataValueMember {
2426
+ metadataValue: MetadataValue;
2427
+ $unknown?: never;
2428
+ }
2429
+ /**
2430
+ * @public
2431
+ */
2432
+ interface $UnknownMember {
2433
+ metadataValue?: never;
2434
+ $unknown: [string, any];
2435
+ }
2436
+ interface Visitor<T> {
2437
+ metadataValue: (value: MetadataValue) => T;
2438
+ _: (name: string, value: any) => T;
2439
+ }
2440
+ const visit: <T>(value: RightExpression, visitor: Visitor<T>) => T;
2441
+ }
2442
+ /**
2443
+ * <p>Filter expression for retrieving events based on metadata associated with an event.</p>
2444
+ * @public
2445
+ */
2446
+ export interface EventMetadataFilterExpression {
2447
+ /**
2448
+ * <p>Left operand of the event metadata filter expression.</p>
2449
+ * @public
2450
+ */
2451
+ left: LeftExpression | undefined;
2452
+ /**
2453
+ * <p>Operator applied to the event metadata filter expression.</p>
2454
+ * @public
2455
+ */
2456
+ operator: OperatorType | undefined;
2457
+ /**
2458
+ * <p>Right operand of the event metadata filter expression.</p>
2459
+ * @public
2460
+ */
2461
+ right?: RightExpression | undefined;
2462
+ }
2038
2463
  /**
2039
2464
  * <p>Contains filter criteria for listing events.</p>
2040
2465
  * @public
@@ -2045,6 +2470,11 @@ export interface FilterInput {
2045
2470
  * @public
2046
2471
  */
2047
2472
  branch?: BranchFilter | undefined;
2473
+ /**
2474
+ * <p>Event metadata filter criteria to apply when retrieving events.</p>
2475
+ * @public
2476
+ */
2477
+ eventMetadata?: EventMetadataFilterExpression[] | undefined;
2048
2478
  }
2049
2479
  /**
2050
2480
  * @public
@@ -2369,6 +2799,26 @@ export declare const CodeInterpreterStreamOutputFilterSensitiveLog: (obj: CodeIn
2369
2799
  * @internal
2370
2800
  */
2371
2801
  export declare const InvokeCodeInterpreterResponseFilterSensitiveLog: (obj: InvokeCodeInterpreterResponse) => any;
2802
+ /**
2803
+ * @internal
2804
+ */
2805
+ export declare const MemoryContentFilterSensitiveLog: (obj: MemoryContent) => any;
2806
+ /**
2807
+ * @internal
2808
+ */
2809
+ export declare const MemoryRecordCreateInputFilterSensitiveLog: (obj: MemoryRecordCreateInput) => any;
2810
+ /**
2811
+ * @internal
2812
+ */
2813
+ export declare const BatchCreateMemoryRecordsInputFilterSensitiveLog: (obj: BatchCreateMemoryRecordsInput) => any;
2814
+ /**
2815
+ * @internal
2816
+ */
2817
+ export declare const MemoryRecordUpdateInputFilterSensitiveLog: (obj: MemoryRecordUpdateInput) => any;
2818
+ /**
2819
+ * @internal
2820
+ */
2821
+ export declare const BatchUpdateMemoryRecordsInputFilterSensitiveLog: (obj: BatchUpdateMemoryRecordsInput) => any;
2372
2822
  /**
2373
2823
  * @internal
2374
2824
  */
@@ -2397,10 +2847,6 @@ export declare const CreateEventOutputFilterSensitiveLog: (obj: CreateEventOutpu
2397
2847
  * @internal
2398
2848
  */
2399
2849
  export declare const GetEventOutputFilterSensitiveLog: (obj: GetEventOutput) => any;
2400
- /**
2401
- * @internal
2402
- */
2403
- export declare const MemoryContentFilterSensitiveLog: (obj: MemoryContent) => any;
2404
2850
  /**
2405
2851
  * @internal
2406
2852
  */