@alicloud/agentloop20260520 2.4.2 → 2.4.3

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 (37) hide show
  1. package/dist/client.d.ts +2 -2
  2. package/dist/client.js +8 -2
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CreateContextStoreRequest.d.ts +69 -48
  5. package/dist/models/CreateContextStoreRequest.js.map +1 -1
  6. package/dist/models/CreateContextStoreResponseBody.d.ts +1 -1
  7. package/dist/models/GetContextStoreResponseBody.d.ts +132 -55
  8. package/dist/models/GetContextStoreResponseBody.js +31 -1
  9. package/dist/models/GetContextStoreResponseBody.js.map +1 -1
  10. package/dist/models/ListContextStoresRequest.d.ts +1 -1
  11. package/dist/models/ListContextStoresResponseBody.d.ts +10 -6
  12. package/dist/models/ListContextStoresResponseBody.js.map +1 -1
  13. package/dist/models/SearchContextRequest.d.ts +8 -8
  14. package/dist/models/SearchContextResponseBody.d.ts +54 -3
  15. package/dist/models/SearchContextResponseBody.js +23 -0
  16. package/dist/models/SearchContextResponseBody.js.map +1 -1
  17. package/dist/models/UpdateContextStoreRequest.d.ts +88 -33
  18. package/dist/models/UpdateContextStoreRequest.js +6 -0
  19. package/dist/models/UpdateContextStoreRequest.js.map +1 -1
  20. package/dist/models/UpdateContextStoreResponseBody.d.ts +32 -2
  21. package/dist/models/UpdateContextStoreResponseBody.js +27 -1
  22. package/dist/models/UpdateContextStoreResponseBody.js.map +1 -1
  23. package/dist/models/model.d.ts +2 -0
  24. package/dist/models/model.js +38 -34
  25. package/dist/models/model.js.map +1 -1
  26. package/package.json +1 -1
  27. package/src/client.ts +10 -2
  28. package/src/models/CreateContextStoreRequest.ts +69 -48
  29. package/src/models/CreateContextStoreResponseBody.ts +1 -1
  30. package/src/models/GetContextStoreResponseBody.ts +153 -55
  31. package/src/models/ListContextStoresRequest.ts +1 -1
  32. package/src/models/ListContextStoresResponseBody.ts +10 -6
  33. package/src/models/SearchContextRequest.ts +8 -8
  34. package/src/models/SearchContextResponseBody.ts +73 -3
  35. package/src/models/UpdateContextStoreRequest.ts +94 -33
  36. package/src/models/UpdateContextStoreResponseBody.ts +49 -2
  37. package/src/models/model.ts +2 -0
@@ -29,7 +29,7 @@ export class ListContextStoresResponseBodyResults extends $dara.Model {
29
29
  contextType?: string;
30
30
  /**
31
31
  * @remarks
32
- * The time when the context store was created, in ISO 8601 UTC format.
32
+ * The time when the context store was created. The time is in the ISO 8601 UTC format.
33
33
  *
34
34
  * Use the UTC time format: yyyy-MM-ddTHH:mm:ssZ
35
35
  *
@@ -63,7 +63,7 @@ export class ListContextStoresResponseBodyResults extends $dara.Model {
63
63
  serviceNames?: string[];
64
64
  /**
65
65
  * @remarks
66
- * The memory data source type, such as manual, trajectory, or dataset. This parameter has a value only for the memory type.
66
+ * The data source type of the memory context store. Valid values: manual, trajectory, and dataset. This parameter has a value only for the memory type.
67
67
  *
68
68
  * @example
69
69
  * trajectory
@@ -79,16 +79,20 @@ export class ListContextStoresResponseBodyResults extends $dara.Model {
79
79
  status?: string;
80
80
  /**
81
81
  * @remarks
82
- * The memory storage mode, such as event or upsert. This parameter has a value only for the memory type.
82
+ * The storage mode of the memory context store. Valid values: event and upsert. This parameter has a value only for the memory type.
83
83
  *
84
84
  * @example
85
85
  * upsert
86
86
  */
87
87
  storageMode?: string;
88
+ /**
89
+ * @remarks
90
+ * The actual storage modes of each policy. A hybrid context store includes both event and upsert.
91
+ */
88
92
  storageModes?: string[];
89
93
  /**
90
94
  * @remarks
91
- * The time when the context store was last updated, in ISO 8601 UTC format.
95
+ * The time when the context store was last updated. The time is in the ISO 8601 UTC format.
92
96
  *
93
97
  * Use the UTC time format: yyyy-MM-ddTHH:mm:ssZ
94
98
  *
@@ -148,7 +152,7 @@ export class ListContextStoresResponseBodyResults extends $dara.Model {
148
152
  export class ListContextStoresResponseBody extends $dara.Model {
149
153
  /**
150
154
  * @remarks
151
- * The maximum number of results per page specified in the request.
155
+ * The maximum number of entries per page specified in the request.
152
156
  *
153
157
  * @example
154
158
  * 20
@@ -164,7 +168,7 @@ export class ListContextStoresResponseBody extends $dara.Model {
164
168
  nextToken?: string;
165
169
  /**
166
170
  * @remarks
167
- * The request ID, which can be used to locate the request during troubleshooting.
171
+ * The request ID, which is used to locate the request during troubleshooting.
168
172
  *
169
173
  * @example
170
174
  * 9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M
@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
5
5
  export class SearchContextRequestScope extends $dara.Model {
6
6
  /**
7
7
  * @remarks
8
- * Agent Id
8
+ * The ID of the agent.
9
9
  *
10
10
  * @example
11
11
  * sales-copilot
@@ -13,7 +13,7 @@ export class SearchContextRequestScope extends $dara.Model {
13
13
  agentId?: string;
14
14
  /**
15
15
  * @remarks
16
- * The application ID.
16
+ * The ID of the application.
17
17
  *
18
18
  * @example
19
19
  * crm-service
@@ -21,7 +21,7 @@ export class SearchContextRequestScope extends $dara.Model {
21
21
  appId?: string;
22
22
  /**
23
23
  * @remarks
24
- * The run ID.
24
+ * The ID of the run.
25
25
  *
26
26
  * @example
27
27
  * run-001
@@ -29,7 +29,7 @@ export class SearchContextRequestScope extends $dara.Model {
29
29
  runId?: string;
30
30
  /**
31
31
  * @remarks
32
- * The user ID.
32
+ * The ID of the user.
33
33
  *
34
34
  * @example
35
35
  * u-10001
@@ -81,7 +81,7 @@ export class SearchContextRequest extends $dara.Model {
81
81
  formatted?: boolean;
82
82
  /**
83
83
  * @remarks
84
- * Specifies whether to include memories whose sourceState is inactive. Default value: false.
84
+ * Specifies whether to include memories with sourceState=inactive. Default value: false.
85
85
  *
86
86
  * @example
87
87
  * false
@@ -89,7 +89,7 @@ export class SearchContextRequest extends $dara.Model {
89
89
  includeInactive?: boolean;
90
90
  /**
91
91
  * @remarks
92
- * The maximum number of returned results, which corresponds to the top N results by similarity.
92
+ * The maximum number of returned results based on the top-N similarity.
93
93
  *
94
94
  * @example
95
95
  * 10
@@ -115,12 +115,12 @@ export class SearchContextRequest extends $dara.Model {
115
115
  retrievalOption?: string;
116
116
  /**
117
117
  * @remarks
118
- * The recall scope. If a field with the same name conflicts with the filter, a 400 ScopeFilterConflict error is returned.
118
+ * The recall scope. If a field with the same name exists in the filter, a 400 ScopeFilterConflict error is returned.
119
119
  */
120
120
  scope?: SearchContextRequestScope;
121
121
  /**
122
122
  * @remarks
123
- * Filters results by extraction strategy ID. Multiple IDs in the list are evaluated with an OR condition. If this parameter is not specified, all strategies are recalled. An empty list returns a 400 error. If the format is valid but no matching IDs are found, an empty result is returned. IDs of historically removed strategies are supported.
123
+ * Filters results by extraction strategy IDs. Multiple IDs in the list are evaluated with an OR logic. If this parameter is not specified, all strategies are recalled. An empty list returns a 400 error. Valid IDs with no matches return empty results. Historical removed strategy IDs are supported.
124
124
  *
125
125
  * @example
126
126
  * ["preferences","profile"]
@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
5
5
  export class SearchContextResponseBody extends $dara.Model {
6
6
  /**
7
7
  * @remarks
8
- * The audit write status. Valid values: ok, degraded.
8
+ * The audit write status. Valid values: ok and degraded.
9
9
  *
10
10
  * @example
11
11
  * ok
@@ -13,7 +13,28 @@ export class SearchContextResponseBody extends $dara.Model {
13
13
  auditStatus?: string;
14
14
  /**
15
15
  * @remarks
16
- * The recall event ID. You can use this ID to call GetContextStoreRecall to view audit details.
16
+ * The call ID for the multi-strategy recall of the experience store.
17
+ *
18
+ * @example
19
+ * 550e8400-e29b-41d4-a716-446655440000
20
+ */
21
+ callId?: string;
22
+ /**
23
+ * @remarks
24
+ * The diagnostics information for the current experience recall, including duration, model call volume, and filtering. The actual diagnostics items are determined by the running mode.
25
+ */
26
+ diagnostics?: { [key: string]: any };
27
+ /**
28
+ * @remarks
29
+ * The actual experience recall mode used for the current request. Valid values: direct, agentic, and hybrid.
30
+ *
31
+ * @example
32
+ * agentic
33
+ */
34
+ mode?: string;
35
+ /**
36
+ * @remarks
37
+ * The ID of the recall event. You can use this ID to call the GetContextStoreRecall operation to view audit details.
17
38
  *
18
39
  * @example
19
40
  * 0190f1c2-7d3e-7a1b-9c4d-2e5f6a7b8c9d
@@ -21,7 +42,12 @@ export class SearchContextResponseBody extends $dara.Model {
21
42
  recallEventId?: string;
22
43
  /**
23
44
  * @remarks
24
- * The request ID, which is used to locate the request during troubleshooting.
45
+ * The list of relevance judgment results for candidate experiences.
46
+ */
47
+ relevance?: { [key: string]: any }[];
48
+ /**
49
+ * @remarks
50
+ * The ID of the request. You can use this ID to locate the request for troubleshooting.
25
51
  *
26
52
  * @example
27
53
  * 9ACFB10A-1B2C-3D4E-5F6G-7H8I9J0K1L2M
@@ -32,28 +58,72 @@ export class SearchContextResponseBody extends $dara.Model {
32
58
  * The list of retrieval results, sorted by similarity in descending order.
33
59
  */
34
60
  results?: { [key: string]: any }[];
61
+ /**
62
+ * @remarks
63
+ * The list of rewritten queries generated based on the original retrieval query. The original query is not included.
64
+ */
65
+ rewrittenQueries?: string[];
66
+ /**
67
+ * @remarks
68
+ * The processing status of the current experience recall call. Valid values: success, degraded, failed, and error.
69
+ *
70
+ * @example
71
+ * success
72
+ */
73
+ status?: string;
74
+ /**
75
+ * @remarks
76
+ * The strategy implementation version used for the current experience recall. This is used for auditing and result tracing.
77
+ *
78
+ * @example
79
+ * experience-recall-20261031-v5
80
+ */
81
+ strategyVersion?: string;
35
82
  static names(): { [key: string]: string } {
36
83
  return {
37
84
  auditStatus: 'auditStatus',
85
+ callId: 'callId',
86
+ diagnostics: 'diagnostics',
87
+ mode: 'mode',
38
88
  recallEventId: 'recallEventId',
89
+ relevance: 'relevance',
39
90
  requestId: 'requestId',
40
91
  results: 'results',
92
+ rewrittenQueries: 'rewrittenQueries',
93
+ status: 'status',
94
+ strategyVersion: 'strategyVersion',
41
95
  };
42
96
  }
43
97
 
44
98
  static types(): { [key: string]: any } {
45
99
  return {
46
100
  auditStatus: 'string',
101
+ callId: 'string',
102
+ diagnostics: { 'type': 'map', 'keyType': 'string', 'valueType': 'any' },
103
+ mode: 'string',
47
104
  recallEventId: 'string',
105
+ relevance: { 'type': 'array', 'itemType': { 'type': 'map', 'keyType': 'string', 'valueType': 'any' } },
48
106
  requestId: 'string',
49
107
  results: { 'type': 'array', 'itemType': { 'type': 'map', 'keyType': 'string', 'valueType': 'any' } },
108
+ rewrittenQueries: { 'type': 'array', 'itemType': 'string' },
109
+ status: 'string',
110
+ strategyVersion: 'string',
50
111
  };
51
112
  }
52
113
 
53
114
  validate() {
115
+ if(this.diagnostics) {
116
+ $dara.Model.validateMap(this.diagnostics);
117
+ }
118
+ if(Array.isArray(this.relevance)) {
119
+ $dara.Model.validateArray(this.relevance);
120
+ }
54
121
  if(Array.isArray(this.results)) {
55
122
  $dara.Model.validateArray(this.results);
56
123
  }
124
+ if(Array.isArray(this.rewrittenQueries)) {
125
+ $dara.Model.validateArray(this.rewrittenQueries);
126
+ }
57
127
  super.validate();
58
128
  }
59
129
 
@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
5
5
  export class UpdateContextStoreRequestConfigAudit extends $dara.Model {
6
6
  /**
7
7
  * @remarks
8
- * Specifies whether to write item events for candidates dropped during recall. Default value: false.
8
+ * Specifies whether to write item events for dropped recall candidates. Default value: false.
9
9
  *
10
10
  * @example
11
11
  * false
@@ -13,7 +13,10 @@ export class UpdateContextStoreRequestConfigAudit extends $dara.Model {
13
13
  droppedCandidates?: boolean;
14
14
  /**
15
15
  * @remarks
16
- * The recording mode for recall queries. Valid values: raw (plaintext) and hash (HMAC only). Default value: raw.
16
+ * The recording method for recall queries. Valid values:
17
+ * - raw: Plaintext.
18
+ * - hash: HMAC only.
19
+ * Default value: raw.
17
20
  *
18
21
  * @example
19
22
  * raw
@@ -55,7 +58,7 @@ export class UpdateContextStoreRequestConfigAudit extends $dara.Model {
55
58
  export class UpdateContextStoreRequestConfigExtractionPoliciesModel extends $dara.Model {
56
59
  /**
57
60
  * @remarks
58
- * The name of the extraction model. Currently, only qwen3.8-flash is supported. The platform uses internal credentials.
61
+ * The name of the extraction model. Currently, only qwen3.8-flash is supported, which uses internal platform credentials.
59
62
  *
60
63
  * @example
61
64
  * qwen3.8-flash
@@ -84,36 +87,60 @@ export class UpdateContextStoreRequestConfigExtractionPoliciesModel extends $dar
84
87
 
85
88
  export class UpdateContextStoreRequestConfigExtractionPoliciesStoragePolicy extends $dara.Model {
86
89
  /**
90
+ * @remarks
91
+ * The allowed storage actions. Default value: all actions (ADD, UPDATE, MERGE, and DELETE).
92
+ *
87
93
  * @example
88
94
  * ["ADD","UPDATE","MERGE","DELETE"]
89
95
  */
90
96
  allowedActions?: string[];
91
97
  /**
98
+ * @remarks
99
+ * Specifies whether to enable deduplication in event mode. Default value: true.
100
+ *
92
101
  * @example
93
102
  * true
94
103
  */
95
104
  dedupe?: boolean;
96
105
  /**
106
+ * @remarks
107
+ * Specifies whether to enable human edit protection. Default value: true. When enabled, automatic extraction does not overwrite manually modified memories.
108
+ *
97
109
  * @example
98
110
  * true
99
111
  */
100
112
  humanEditProtection?: boolean;
101
113
  /**
114
+ * @remarks
115
+ * The merge key for upsert operations. Valid values: factKey, semantic, and both. Default value: semantic.
116
+ *
102
117
  * @example
103
118
  * semantic
104
119
  */
105
120
  mergeKey?: string;
106
121
  /**
122
+ * @remarks
123
+ * The storage mode. Valid values:
124
+ * - event: Event append.
125
+ * - upsert: Merge and update.
126
+ * Default value: upsert.
127
+ *
107
128
  * @example
108
129
  * upsert
109
130
  */
110
131
  mode?: string;
111
132
  /**
133
+ * @remarks
134
+ * The similarity threshold for semantic merging. Valid values: 0 to 1. Default value: 0.4.
135
+ *
112
136
  * @example
113
137
  * 0.4
114
138
  */
115
139
  similarityThreshold?: number;
116
140
  /**
141
+ * @remarks
142
+ * The number of days before memories expire. A value of 0 indicates that memories do not expire.
143
+ *
117
144
  * @example
118
145
  * 0
119
146
  */
@@ -165,7 +192,7 @@ export class UpdateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
165
192
  categories?: string[];
166
193
  /**
167
194
  * @remarks
168
- * The custom extraction instructions. This parameter is required when preset is set to custom. The length must be 1 to 8,000 characters.
195
+ * The custom extraction instructions. This parameter is required when preset is set to custom. Length: 1 to 8000 characters.
169
196
  *
170
197
  * @example
171
198
  * Extract only user product preferences
@@ -173,7 +200,7 @@ export class UpdateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
173
200
  customInstructions?: string;
174
201
  /**
175
202
  * @remarks
176
- * Specifies whether to apply this policy to new inputs. Default value: true. Disabling the policy does not delete historical memories.
203
+ * Specifies whether to execute this policy for new inputs. Default value: true. Disabling the policy does not delete historical memories.
177
204
  *
178
205
  * @example
179
206
  * true
@@ -208,10 +235,14 @@ export class UpdateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
208
235
  * fact
209
236
  */
210
237
  preset?: string;
238
+ /**
239
+ * @remarks
240
+ * The independent storage rule for this policy. If omitted, the original value is retained. New policies use the default value. Repeatedly confirmed memories refresh the validity period by default.
241
+ */
211
242
  storagePolicy?: UpdateContextStoreRequestConfigExtractionPoliciesStoragePolicy;
212
243
  /**
213
244
  * @remarks
214
- * The ID of the extraction policy. This parameter is optional. If omitted, the default value is default. The ID must start with a letter and can contain only letters, digits, underscores (_), and hyphens (-). It can be up to 64 characters in length. After default value processing, the ID must be unique within the same library. Modifying the name or instructions does not change this ID.
245
+ * The ID of the extraction policy. This parameter is optional. If omitted, the default value is used. The ID must start with a letter and can contain only letters, digits, underscores, and hyphens. Maximum length: 64 characters. After default processing, the ID must be unique within the same library. Modifying the name or instructions does not change this ID.
215
246
  *
216
247
  * @example
217
248
  * preferences
@@ -269,7 +300,7 @@ export class UpdateContextStoreRequestConfigExtractionPolicies extends $dara.Mod
269
300
  export class UpdateContextStoreRequestConfigExtractionPolicyModel extends $dara.Model {
270
301
  /**
271
302
  * @remarks
272
- * The name of the extraction model. Currently, only qwen3.8-flash is supported. The platform uses internal credentials.
303
+ * The name of the extraction model. Currently, only qwen3.8-flash is supported, which uses internal platform credentials.
273
304
  *
274
305
  * @example
275
306
  * qwen3.8-flash
@@ -307,7 +338,7 @@ export class UpdateContextStoreRequestConfigExtractionPolicy extends $dara.Model
307
338
  categories?: string[];
308
339
  /**
309
340
  * @remarks
310
- * The custom extraction instructions. This parameter is required when preset is set to custom. The length must be 1 to 8,000 characters.
341
+ * The custom extraction instructions. This parameter is required when preset is set to custom. Length: 1 to 8000 characters.
311
342
  *
312
343
  * @example
313
344
  * Extract only user product preferences
@@ -375,7 +406,7 @@ export class UpdateContextStoreRequestConfigExtractionPolicy extends $dara.Model
375
406
  export class UpdateContextStoreRequestConfigScopePolicy extends $dara.Model {
376
407
  /**
377
408
  * @remarks
378
- * Specifies that at least one of the specified scope fields must be non-empty. Valid values for elements: userId, agentId, appId, and runId.
409
+ * Specifies that at least one of the scope fields must be non-empty. Valid values for the elements: userId, agentId, appId, and runId.
379
410
  *
380
411
  * @example
381
412
  * ["userId"]
@@ -408,7 +439,7 @@ export class UpdateContextStoreRequestConfigScopePolicy extends $dara.Model {
408
439
  export class UpdateContextStoreRequestConfigSourceDatasetCustomFields extends $dara.Model {
409
440
  /**
410
441
  * @remarks
411
- * The field description. Required when usage is set to extraction-input.
442
+ * The description of the field. This parameter is required when usage is set to extraction-input.
412
443
  *
413
444
  * @example
414
445
  * Customer tier
@@ -432,7 +463,7 @@ export class UpdateContextStoreRequestConfigSourceDatasetCustomFields extends $d
432
463
  sourceField?: string;
433
464
  /**
434
465
  * @remarks
435
- * The target path for writing, such as metadata.customerTier.
466
+ * The target write path, such as metadata.customerTier.
436
467
  *
437
468
  * @example
438
469
  * metadata.customerTier
@@ -478,7 +509,7 @@ export class UpdateContextStoreRequestConfigSourceDatasetCustomFields extends $d
478
509
  export class UpdateContextStoreRequestConfigSourceDatasetFilter extends $dara.Model {
479
510
  /**
480
511
  * @remarks
481
- * The subset of the pipeline where clause, which is pushed down to SQL.
512
+ * The subset of the Pipeline where clause, which is pushed down to SQL.
482
513
  *
483
514
  * @example
484
515
  * appId = \\"crm-service\\"
@@ -508,12 +539,12 @@ export class UpdateContextStoreRequestConfigSourceDatasetFilter extends $dara.Mo
508
539
  export class UpdateContextStoreRequestConfigSourceDataset extends $dara.Model {
509
540
  /**
510
541
  * @remarks
511
- * The list of custom field declarations. If specified, the entire list is overwritten.
542
+ * The list of custom field declarations. If provided, the entire list is overwritten.
512
543
  */
513
544
  customFields?: UpdateContextStoreRequestConfigSourceDatasetCustomFields[];
514
545
  /**
515
546
  * @remarks
516
- * The row filter conditions.
547
+ * The row filter condition.
517
548
  */
518
549
  filter?: UpdateContextStoreRequestConfigSourceDatasetFilter;
519
550
  /**
@@ -566,7 +597,7 @@ export class UpdateContextStoreRequestConfigSourceTrajectoryFilter extends $dara
566
597
  agentNames?: string[];
567
598
  /**
568
599
  * @remarks
569
- * Specifies whether to exclude degraded trajectories. Default value: false (includes degraded trajectories).
600
+ * Specifies whether to exclude degraded trajectories. Default value: false (degraded trajectories are included).
570
601
  *
571
602
  * @example
572
603
  * false
@@ -582,7 +613,7 @@ export class UpdateContextStoreRequestConfigSourceTrajectoryFilter extends $dara
582
613
  minStepCount?: number;
583
614
  /**
584
615
  * @remarks
585
- * The native Simple Log Service (SLS) query statement. It is combined with the preceding conditions using AND.
616
+ * The native Simple Log Service (SLS) query statement, which is combined with the preceding conditions using AND.
586
617
  *
587
618
  * @example
588
619
  * tool_names:"search_order"
@@ -634,7 +665,7 @@ export class UpdateContextStoreRequestConfigSourceTrajectoryFilter extends $dara
634
665
  export class UpdateContextStoreRequestConfigSourceTrajectoryScopeMapping extends $dara.Model {
635
666
  /**
636
667
  * @remarks
637
- * The JSONPath for agentId. Default value: $.agent_name.
668
+ * The JSONPath expression for agentId. Default value: $.agent_name.
638
669
  *
639
670
  * @example
640
671
  * $.agent_name
@@ -642,7 +673,7 @@ export class UpdateContextStoreRequestConfigSourceTrajectoryScopeMapping extends
642
673
  agentId?: string;
643
674
  /**
644
675
  * @remarks
645
- * The JSONPath for appId. Default value: $.service_names[0].
676
+ * The JSONPath expression for appId. Default value: $.service_names[0].
646
677
  *
647
678
  * @example
648
679
  * $.service_names[0]
@@ -650,7 +681,7 @@ export class UpdateContextStoreRequestConfigSourceTrajectoryScopeMapping extends
650
681
  appId?: string;
651
682
  /**
652
683
  * @remarks
653
- * The JSONPath for runId. Default value: $.trajectory_id.
684
+ * The JSONPath expression for runId. Default value: $.trajectory_id.
654
685
  *
655
686
  * @example
656
687
  * $.trajectory_id
@@ -658,7 +689,7 @@ export class UpdateContextStoreRequestConfigSourceTrajectoryScopeMapping extends
658
689
  runId?: string;
659
690
  /**
660
691
  * @remarks
661
- * The JSONPath for userId. By default, this field is not mapped.
692
+ * The JSONPath expression for userId. By default, this field is not mapped.
662
693
  *
663
694
  * @example
664
695
  * $.trajectory_extensions.user_id
@@ -694,7 +725,7 @@ export class UpdateContextStoreRequestConfigSourceTrajectoryScopeMapping extends
694
725
  export class UpdateContextStoreRequestConfigSourceTrajectory extends $dara.Model {
695
726
  /**
696
727
  * @remarks
697
- * The trajectory filter conditions. Conditions are combined with AND, and items within a list are combined with OR.
728
+ * The trajectory filter conditions. Conditions are combined with AND, while items within a list are combined with OR.
698
729
  */
699
730
  filter?: UpdateContextStoreRequestConfigSourceTrajectoryFilter;
700
731
  /**
@@ -754,7 +785,7 @@ export class UpdateContextStoreRequestConfigSourceTrajectory extends $dara.Model
754
785
  export class UpdateContextStoreRequestConfigSource extends $dara.Model {
755
786
  /**
756
787
  * @remarks
757
- * The AgentSpace where the trace data source is located. Cross-AgentSpace operations are not supported in the current phase. If specified, the value must be equal to the path AgentSpace. Otherwise, a 400 parameter error is returned. The AgentSpace cannot be changed after creation.
788
+ * The AgentSpace where the trace data source is located. Cross-AgentSpace operations are not supported in the current version. If specified, the value must be equal to the path AgentSpace. Otherwise, a 400 parameter error is returned. The AgentSpace cannot be changed after creation.
758
789
  *
759
790
  * @example
760
791
  * my-agent-space
@@ -767,7 +798,7 @@ export class UpdateContextStoreRequestConfigSource extends $dara.Model {
767
798
  dataset?: UpdateContextStoreRequestConfigSourceDataset;
768
799
  /**
769
800
  * @remarks
770
- * The start time for data backfill in ISO 8601 UTC format.
801
+ * The start time for data backfill, in ISO 8601 UTC format.
771
802
  *
772
803
  * @example
773
804
  * 2026-01-01T00:00:00Z
@@ -822,7 +853,7 @@ export class UpdateContextStoreRequestConfigStoragePolicy extends $dara.Model {
822
853
  allowedActions?: string[];
823
854
  /**
824
855
  * @remarks
825
- * Specifies whether to deduplicate data in event mode. Default value: true.
856
+ * Specifies whether to enable deduplication in event mode. Default value: true.
826
857
  *
827
858
  * @example
828
859
  * true
@@ -846,7 +877,10 @@ export class UpdateContextStoreRequestConfigStoragePolicy extends $dara.Model {
846
877
  mergeKey?: string;
847
878
  /**
848
879
  * @remarks
849
- * The storage mode. Valid values: event (event append) and upsert (merge and update). Default value: upsert.
880
+ * The storage mode. Valid values:
881
+ * - event: Event append.
882
+ * - upsert: Merge and update.
883
+ * Default value: upsert.
850
884
  *
851
885
  * @example
852
886
  * upsert
@@ -912,7 +946,7 @@ export class UpdateContextStoreRequestConfig extends $dara.Model {
912
946
  audit?: UpdateContextStoreRequestConfigAudit;
913
947
  /**
914
948
  * @remarks
915
- * The extraction policies. You can specify 1 to 10 policies. In a request, you can specify either this field or the compatible extractionPolicy field, but not both. The strategyVersion parameter indicates the snapshot version of the entire library configuration.
949
+ * The extraction policies. You can specify 1 to 10 policies. Compatible fields returned as-is during updates are ignored. strategyVersion indicates the snapshot version of the entire library configuration.
916
950
  */
917
951
  extractionPolicies?: UpdateContextStoreRequestConfigExtractionPolicies[];
918
952
  /**
@@ -922,12 +956,17 @@ export class UpdateContextStoreRequestConfig extends $dara.Model {
922
956
  extractionPolicy?: UpdateContextStoreRequestConfigExtractionPolicy;
923
957
  /**
924
958
  * @remarks
925
- * The metadata field mapping. The key is the business field and the value is the storage field.
959
+ * The metadata field mapping, where the key is the business field and the value is the storage field.
926
960
  *
927
961
  * @example
928
962
  * {"userId":"user_id","sessionId":"session_id"}
929
963
  */
930
964
  metadataField?: { [key: string]: string };
965
+ /**
966
+ * @remarks
967
+ * Specifies whether runtime recall is allowed for the experience library. When modifying this parameter, you must provide expectedRuntimeRecallRevision and submit only this property in the config.
968
+ */
969
+ runtimeRecallEnabled?: boolean;
931
970
  /**
932
971
  * @remarks
933
972
  * The scope constraint policy.
@@ -935,7 +974,7 @@ export class UpdateContextStoreRequestConfig extends $dara.Model {
935
974
  scopePolicy?: UpdateContextStoreRequestConfigScopePolicy;
936
975
  /**
937
976
  * @remarks
938
- * The datasource config. This serves only as the root identity for the data source.
977
+ * The datasource config, which serves only as the root identity for the data source.
939
978
  */
940
979
  source?: UpdateContextStoreRequestConfigSource;
941
980
  /**
@@ -949,6 +988,7 @@ export class UpdateContextStoreRequestConfig extends $dara.Model {
949
988
  extractionPolicies: 'extractionPolicies',
950
989
  extractionPolicy: 'extractionPolicy',
951
990
  metadataField: 'metadataField',
991
+ runtimeRecallEnabled: 'runtimeRecallEnabled',
952
992
  scopePolicy: 'scopePolicy',
953
993
  source: 'source',
954
994
  storagePolicy: 'storagePolicy',
@@ -961,6 +1001,7 @@ export class UpdateContextStoreRequestConfig extends $dara.Model {
961
1001
  extractionPolicies: { 'type': 'array', 'itemType': UpdateContextStoreRequestConfigExtractionPolicies },
962
1002
  extractionPolicy: UpdateContextStoreRequestConfigExtractionPolicy,
963
1003
  metadataField: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
1004
+ runtimeRecallEnabled: 'boolean',
964
1005
  scopePolicy: UpdateContextStoreRequestConfigScopePolicy,
965
1006
  source: UpdateContextStoreRequestConfigSource,
966
1007
  storagePolicy: UpdateContextStoreRequestConfigStoragePolicy,
@@ -1000,7 +1041,7 @@ export class UpdateContextStoreRequestConfig extends $dara.Model {
1000
1041
  export class UpdateContextStoreRequest extends $dara.Model {
1001
1042
  /**
1002
1043
  * @remarks
1003
- * The description of the policy change. A new policy version is created when policy fields in the configuration are changed.
1044
+ * The description of the policy change. A new policy version is generated when policy fields in the configuration change.
1004
1045
  *
1005
1046
  * @example
1006
1047
  * Relax the similarity threshold
@@ -1008,12 +1049,12 @@ export class UpdateContextStoreRequest extends $dara.Model {
1008
1049
  changeNote?: string;
1009
1050
  /**
1010
1051
  * @remarks
1011
- * The context library configuration. If specified, the entire configuration is overwritten. If omitted, the original configuration is retained.
1052
+ * The context library configuration. If passed, the entire configuration is overwritten. If not passed, the original configuration is retained.
1012
1053
  */
1013
1054
  config?: UpdateContextStoreRequestConfig;
1014
1055
  /**
1015
1056
  * @remarks
1016
- * The context library type. This field generally cannot be modified after creation and is provided only for exception correction.
1057
+ * The context library type. This field cannot be changed after creation and is provided only for exception correction.
1017
1058
  *
1018
1059
  * @example
1019
1060
  * experience
@@ -1029,7 +1070,23 @@ export class UpdateContextStoreRequest extends $dara.Model {
1029
1070
  description?: string;
1030
1071
  /**
1031
1072
  * @remarks
1032
- * The running status. Valid values: Active and Paused. For the memory type, pausing stops data source reading and extraction. For the experience dataset follow type, pausing retains submitted and in-flight checkpoints, and resuming continues to process new records without skipping history from the current time. You do not need to pass back the source parameter when only updating the status.
1073
+ * The expected runtime recall revision. This field is required when you modify the runtime recall switch and must be equal to the config.runtimeRecallRevision value returned by GetContextStore. A 409 error is returned if a conflict occurs.
1074
+ *
1075
+ * @example
1076
+ * 1
1077
+ */
1078
+ expectedRuntimeRecallRevision?: number;
1079
+ /**
1080
+ * @remarks
1081
+ * The audit reason for modifying the runtime recall switch. The maximum length is 2,000 characters.
1082
+ *
1083
+ * @example
1084
+ * Pause runtime recall during experience content adjustment
1085
+ */
1086
+ reason?: string;
1087
+ /**
1088
+ * @remarks
1089
+ * The running status, which can be Active or Paused. For the memory type, pausing stops data source reading and extraction. For the experience dataset follow type, pausing retains submitted and in-flight checkpoints, and resuming continues to process new records without skipping history from the current time. You do not need to pass back the source if you only update the status.
1033
1090
  *
1034
1091
  * @example
1035
1092
  * Active
@@ -1037,7 +1094,7 @@ export class UpdateContextStoreRequest extends $dara.Model {
1037
1094
  status?: string;
1038
1095
  /**
1039
1096
  * @remarks
1040
- * The idempotency token, which is a unique string generated by the client to ensure the idempotence of the update operation.
1097
+ * The client token. This is a unique string generated by the client to ensure the idempotence of the update operation.
1041
1098
  *
1042
1099
  * @example
1043
1100
  * a1b2c3d4-1234-5678-90ab-cdef12345678
@@ -1049,6 +1106,8 @@ export class UpdateContextStoreRequest extends $dara.Model {
1049
1106
  config: 'config',
1050
1107
  contextType: 'contextType',
1051
1108
  description: 'description',
1109
+ expectedRuntimeRecallRevision: 'expectedRuntimeRecallRevision',
1110
+ reason: 'reason',
1052
1111
  status: 'status',
1053
1112
  clientToken: 'clientToken',
1054
1113
  };
@@ -1060,6 +1119,8 @@ export class UpdateContextStoreRequest extends $dara.Model {
1060
1119
  config: UpdateContextStoreRequestConfig,
1061
1120
  contextType: 'string',
1062
1121
  description: 'string',
1122
+ expectedRuntimeRecallRevision: 'number',
1123
+ reason: 'string',
1063
1124
  status: 'string',
1064
1125
  clientToken: 'string',
1065
1126
  };