agentbase-web-sdk 1.12.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 (107) hide show
  1. package/LICENSE +0 -0
  2. package/README.md +41 -0
  3. package/dist/cjs/sdk.js +16322 -0
  4. package/dist/cjs/sdk.js.map +1 -0
  5. package/dist/esm/sdk.js +16292 -0
  6. package/dist/esm/sdk.js.map +1 -0
  7. package/dist/iife/sdk.js +20121 -0
  8. package/package.json +54 -0
  9. package/types/channel.d.ts +79 -0
  10. package/types/client.d.ts +289 -0
  11. package/types/enums/authentication-factor.d.ts +6 -0
  12. package/types/enums/authenticator-type.d.ts +3 -0
  13. package/types/enums/browser-permission.d.ts +22 -0
  14. package/types/enums/browser.d.ts +16 -0
  15. package/types/enums/credit-card.d.ts +19 -0
  16. package/types/enums/data-api-catalog-data-source-database-type.d.ts +6 -0
  17. package/types/enums/data-api-catalog-data-source-visibility-source.d.ts +7 -0
  18. package/types/enums/data-api-catalog-database-availability.d.ts +5 -0
  19. package/types/enums/data-api-catalog-database-classification.d.ts +4 -0
  20. package/types/enums/data-api-catalog-database-status.d.ts +4 -0
  21. package/types/enums/data-api-catalog-database-visibility-source.d.ts +7 -0
  22. package/types/enums/data-api-filter-logic.d.ts +4 -0
  23. package/types/enums/data-api-owned-binding-principal-type.d.ts +4 -0
  24. package/types/enums/data-api-owned-binding-status.d.ts +4 -0
  25. package/types/enums/distillation-message-role.d.ts +6 -0
  26. package/types/enums/distillation-mode.d.ts +4 -0
  27. package/types/enums/distillation-tool-status.d.ts +4 -0
  28. package/types/enums/execution-method.d.ts +9 -0
  29. package/types/enums/execution-status.d.ts +7 -0
  30. package/types/enums/execution-trigger.d.ts +5 -0
  31. package/types/enums/export-job-mode.d.ts +4 -0
  32. package/types/enums/export-mode.d.ts +3 -0
  33. package/types/enums/feedback-type.d.ts +5 -0
  34. package/types/enums/flag.d.ts +197 -0
  35. package/types/enums/format.d.ts +4 -0
  36. package/types/enums/image-format.d.ts +9 -0
  37. package/types/enums/image-gravity.d.ts +11 -0
  38. package/types/enums/kind.d.ts +6 -0
  39. package/types/enums/kinds.d.ts +6 -0
  40. package/types/enums/knowledge-base-data-source-document-import-result-status.d.ts +5 -0
  41. package/types/enums/memory-access-mode.d.ts +4 -0
  42. package/types/enums/memory-batch-operation.d.ts +5 -0
  43. package/types/enums/memory-bulk-delete-item-status.d.ts +4 -0
  44. package/types/enums/memory-bulk-delete-response-status.d.ts +4 -0
  45. package/types/enums/memory-handling-policy.d.ts +5 -0
  46. package/types/enums/memory-message-role.d.ts +5 -0
  47. package/types/enums/memory-pipeline-run-result-status.d.ts +4 -0
  48. package/types/enums/memory-pipeline-run-scenario.d.ts +6 -0
  49. package/types/enums/memory-pipeline-run-status.d.ts +6 -0
  50. package/types/enums/memory-record-kind.d.ts +5 -0
  51. package/types/enums/memory-record-sensitivity.d.ts +5 -0
  52. package/types/enums/memory-scope.d.ts +7 -0
  53. package/types/enums/memory-sensitivity.d.ts +6 -0
  54. package/types/enums/memory-share-subject-type.d.ts +4 -0
  55. package/types/enums/method.d.ts +9 -0
  56. package/types/enums/o-auth-provider.d.ts +45 -0
  57. package/types/enums/organization-project-deletion-deletion-status.d.ts +5 -0
  58. package/types/enums/organization-role.d.ts +8 -0
  59. package/types/enums/organization-usage-range.d.ts +5 -0
  60. package/types/enums/outcome.d.ts +6 -0
  61. package/types/enums/path-match.d.ts +4 -0
  62. package/types/enums/profile-extraction-mode.d.ts +4 -0
  63. package/types/enums/profile-type.d.ts +4 -0
  64. package/types/enums/project-deletion-restore-status.d.ts +3 -0
  65. package/types/enums/project-deletion-result-deletion-status.d.ts +5 -0
  66. package/types/enums/project-deletion-result-status.d.ts +5 -0
  67. package/types/enums/record-kind.d.ts +5 -0
  68. package/types/enums/retention-policy.d.ts +3 -0
  69. package/types/enums/scenario.d.ts +6 -0
  70. package/types/enums/scene.d.ts +4 -0
  71. package/types/enums/scope.d.ts +5 -0
  72. package/types/enums/source-type.d.ts +6 -0
  73. package/types/enums/status.d.ts +23 -0
  74. package/types/enums/theme.d.ts +4 -0
  75. package/types/enums/timezone.d.ts +422 -0
  76. package/types/enums/transaction-action.d.ts +12 -0
  77. package/types/enums/validation-status.d.ts +6 -0
  78. package/types/enums/verification-source.d.ts +5 -0
  79. package/types/id.d.ts +20 -0
  80. package/types/index.d.ts +105 -0
  81. package/types/models.d.ts +3368 -0
  82. package/types/operator.d.ts +180 -0
  83. package/types/permission.d.ts +43 -0
  84. package/types/query.d.ts +442 -0
  85. package/types/role.d.ts +70 -0
  86. package/types/service.d.ts +11 -0
  87. package/types/services/account.d.ts +1350 -0
  88. package/types/services/agent-runtime.d.ts +370 -0
  89. package/types/services/ai-gateway.d.ts +888 -0
  90. package/types/services/avatars.d.ts +320 -0
  91. package/types/services/data-api.d.ts +257 -0
  92. package/types/services/databases.d.ts +441 -0
  93. package/types/services/documents-db.d.ts +409 -0
  94. package/types/services/functions.d.ts +175 -0
  95. package/types/services/graphql.d.ts +43 -0
  96. package/types/services/knowledge-bases.d.ts +304 -0
  97. package/types/services/llm-gateway.d.ts +289 -0
  98. package/types/services/locale.d.ts +64 -0
  99. package/types/services/memory.d.ts +2352 -0
  100. package/types/services/messaging.d.ts +53 -0
  101. package/types/services/projects.d.ts +129 -0
  102. package/types/services/realtime.d.ts +197 -0
  103. package/types/services/self-hosted-organizations.d.ts +495 -0
  104. package/types/services/storage.d.ts +265 -0
  105. package/types/services/tables-db.d.ts +438 -0
  106. package/types/services/teams.d.ts +341 -0
  107. package/types/services/vectors-db.d.ts +297 -0
@@ -0,0 +1,2352 @@
1
+ import { Client } from '../client';
2
+ import type { Models } from '../models';
3
+ import { MemoryAccessMode } from '../enums/memory-access-mode';
4
+ import { MemoryScope } from '../enums/memory-scope';
5
+ import { RecordKind } from '../enums/record-kind';
6
+ import { MemorySensitivity } from '../enums/memory-sensitivity';
7
+ import { MemoryHandlingPolicy } from '../enums/memory-handling-policy';
8
+ import { Scope } from '../enums/scope';
9
+ import { Status } from '../enums/status';
10
+ import { Kind } from '../enums/kind';
11
+ import { SourceType } from '../enums/source-type';
12
+ import { DistillationMode } from '../enums/distillation-mode';
13
+ import { Format } from '../enums/format';
14
+ import { ExportMode } from '../enums/export-mode';
15
+ import { ExportJobMode } from '../enums/export-job-mode';
16
+ import { FeedbackType } from '../enums/feedback-type';
17
+ import { ValidationStatus } from '../enums/validation-status';
18
+ import { Outcome } from '../enums/outcome';
19
+ import { VerificationSource } from '../enums/verification-source';
20
+ import { ProfileType } from '../enums/profile-type';
21
+ import { Kinds } from '../enums/kinds';
22
+ import { ProfileExtractionMode } from '../enums/profile-extraction-mode';
23
+ import { RetentionPolicy } from '../enums/retention-policy';
24
+ import { MemoryShareSubjectType } from '../enums/memory-share-subject-type';
25
+ import { Scenario } from '../enums/scenario';
26
+ export declare class Memory {
27
+ client: Client;
28
+ constructor(client: Client);
29
+ /**
30
+ * Get an asynchronous memory create job by its unique ID.
31
+ *
32
+ * @param {string} params.jobId - Memory create job unique ID.
33
+ * @throws {AgentbaseException}
34
+ * @returns {Promise<{}>}
35
+ */
36
+ getJob(params: {
37
+ jobId: string;
38
+ }): Promise<{}>;
39
+ /**
40
+ * Get an asynchronous memory create job by its unique ID.
41
+ *
42
+ * @param {string} jobId - Memory create job unique ID.
43
+ * @throws {AgentbaseException}
44
+ * @returns {Promise<{}>}
45
+ * @deprecated Use the object parameter style method for a better developer experience.
46
+ */
47
+ getJob(jobId: string): Promise<{}>;
48
+ /**
49
+ * List memory records visible to the current caller.
50
+ *
51
+ * @param {string} params.cursor - Opaque pagination cursor.
52
+ * @param {number} params.limit - Maximum number of memories.
53
+ * @param {object} params.filter - Structured memory filter.
54
+ * @param {string[]} params.queries - Array of query strings generated using the Query class provided by the SDK.
55
+ * @param {string} params.userId - Target user ID.
56
+ * @param {MemoryAccessMode} params.accessMode - Use owned for owner-filtered compatibility or accessible for the authorized visibility union.
57
+ * @throws {AgentbaseException}
58
+ * @returns {Promise<{}>}
59
+ */
60
+ list(params?: {
61
+ cursor?: string;
62
+ limit?: number;
63
+ filter?: object;
64
+ queries?: string[];
65
+ userId?: string;
66
+ accessMode?: MemoryAccessMode;
67
+ }): Promise<{}>;
68
+ /**
69
+ * List memory records visible to the current caller.
70
+ *
71
+ * @param {string} cursor - Opaque pagination cursor.
72
+ * @param {number} limit - Maximum number of memories.
73
+ * @param {object} filter - Structured memory filter.
74
+ * @param {string[]} queries - Array of query strings generated using the Query class provided by the SDK.
75
+ * @param {string} userId - Target user ID.
76
+ * @param {MemoryAccessMode} accessMode - Use owned for owner-filtered compatibility or accessible for the authorized visibility union.
77
+ * @throws {AgentbaseException}
78
+ * @returns {Promise<{}>}
79
+ * @deprecated Use the object parameter style method for a better developer experience.
80
+ */
81
+ list(cursor?: string, limit?: number, filter?: object, queries?: string[], userId?: string, accessMode?: MemoryAccessMode): Promise<{}>;
82
+ /**
83
+ * Create a memory record.
84
+ *
85
+ * @param {string} params.userId - Target user ID.
86
+ * @param {MemoryScope} params.scope - Memory visibility scope.
87
+ * @param {string} params.memoryType - Memory type. With infer=true, conversation input is retained as source evidence and derived records use long_term.
88
+ * @param {RecordKind} params.recordKind - Memory record kind. With infer=true, conversation input derives fact records.
89
+ * @param {string} params.pipelineId - Optional published add-memory Pipeline ID. Omit to use the project default or system default.
90
+ * @param {string} params.content - Compatibility memory text. Required when messages and media are omitted.
91
+ * @param {Models.MemoryMessage[]} params.messages - Optional typed role/content messages used as source evidence.
92
+ * @param {object} params.media - Optional Storage file reference {bucketId, fileId}. Accepts one PNG, JPEG, WebP or PDF up to 8 MiB; PDFs allow at most 10 pages. Requires files.read and configured vision routing. Media writes require async=true.
93
+ * @param {string} params.agentId - Optional agent ID.
94
+ * @param {string} params.runId - Optional run ID.
95
+ * @param {string} params.sessionId - Optional conversation ID (max 128 characters). With infer=true, bounded history is loaded only for user, group, and project scopes; private and strict_private never hydrate history.
96
+ * @param {MemorySensitivity} params.sensitivity - Content classification. Secret values must use Agentbase Secret or variables.
97
+ * @param {MemoryHandlingPolicy} params.handlingPolicy - Processing restriction. no_model requires infer=false.
98
+ * @param {object} params.metadata - Memory metadata.
99
+ * @param {object} params.sourceContext - Optional source conversationTime (YYYY-MM-DD or RFC3339 with offset) and timeZone (IANA). Missing conversation time stays unknown; it is not the event or import time.
100
+ * @param {boolean} params.infer - Use configured model-assisted extraction and cross-type deduplication. Defaults to true.
101
+ * @param {boolean} params.reRemember - Explicitly create new evidence for forgotten content.
102
+ * @param {boolean} params.async - Queue memory creation and return immediately. Defaults to the infer value for text; media always requires true, including infer=false.
103
+ * @throws {AgentbaseException}
104
+ * @returns {Promise<{}>}
105
+ */
106
+ create(params: {
107
+ userId: string;
108
+ scope: MemoryScope;
109
+ memoryType: string;
110
+ recordKind: RecordKind;
111
+ pipelineId?: string;
112
+ content?: string;
113
+ messages?: Models.MemoryMessage[];
114
+ media?: object;
115
+ agentId?: string;
116
+ runId?: string;
117
+ sessionId?: string;
118
+ sensitivity?: MemorySensitivity;
119
+ handlingPolicy?: MemoryHandlingPolicy;
120
+ metadata?: object;
121
+ sourceContext?: object;
122
+ infer?: boolean;
123
+ reRemember?: boolean;
124
+ async?: boolean;
125
+ }): Promise<{}>;
126
+ /**
127
+ * Create a memory record.
128
+ *
129
+ * @param {string} userId - Target user ID.
130
+ * @param {MemoryScope} scope - Memory visibility scope.
131
+ * @param {string} memoryType - Memory type. With infer=true, conversation input is retained as source evidence and derived records use long_term.
132
+ * @param {RecordKind} recordKind - Memory record kind. With infer=true, conversation input derives fact records.
133
+ * @param {string} pipelineId - Optional published add-memory Pipeline ID. Omit to use the project default or system default.
134
+ * @param {string} content - Compatibility memory text. Required when messages and media are omitted.
135
+ * @param {Models.MemoryMessage[]} messages - Optional typed role/content messages used as source evidence.
136
+ * @param {object} media - Optional Storage file reference {bucketId, fileId}. Accepts one PNG, JPEG, WebP or PDF up to 8 MiB; PDFs allow at most 10 pages. Requires files.read and configured vision routing. Media writes require async=true.
137
+ * @param {string} agentId - Optional agent ID.
138
+ * @param {string} runId - Optional run ID.
139
+ * @param {string} sessionId - Optional conversation ID (max 128 characters). With infer=true, bounded history is loaded only for user, group, and project scopes; private and strict_private never hydrate history.
140
+ * @param {MemorySensitivity} sensitivity - Content classification. Secret values must use Agentbase Secret or variables.
141
+ * @param {MemoryHandlingPolicy} handlingPolicy - Processing restriction. no_model requires infer=false.
142
+ * @param {object} metadata - Memory metadata.
143
+ * @param {object} sourceContext - Optional source conversationTime (YYYY-MM-DD or RFC3339 with offset) and timeZone (IANA). Missing conversation time stays unknown; it is not the event or import time.
144
+ * @param {boolean} infer - Use configured model-assisted extraction and cross-type deduplication. Defaults to true.
145
+ * @param {boolean} reRemember - Explicitly create new evidence for forgotten content.
146
+ * @param {boolean} async - Queue memory creation and return immediately. Defaults to the infer value for text; media always requires true, including infer=false.
147
+ * @throws {AgentbaseException}
148
+ * @returns {Promise<{}>}
149
+ * @deprecated Use the object parameter style method for a better developer experience.
150
+ */
151
+ create(userId: string, scope: MemoryScope, memoryType: string, recordKind: RecordKind, pipelineId?: string, content?: string, messages?: Models.MemoryMessage[], media?: object, agentId?: string, runId?: string, sessionId?: string, sensitivity?: MemorySensitivity, handlingPolicy?: MemoryHandlingPolicy, metadata?: object, sourceContext?: object, infer?: boolean, reRemember?: boolean, async?: boolean): Promise<{}>;
152
+ /**
153
+ * Forget memory records in one bounded pass. Repeat while hasMore is true and inspect failed and items before considering the scope fully deleted.
154
+ *
155
+ * @param {string} params.userId - Target user ID.
156
+ * @param {string} params.memorySubStoreId - Memory sub-store for erasure.
157
+ * @param {number} params.limit - Requested upper bound for this pass, from 1 to 500. The service may process fewer records; repeat while hasMore is true.
158
+ * @param {string} params.reason - Forgetting reason.
159
+ * @param {string} params.source - Forgetting source.
160
+ * @throws {AgentbaseException}
161
+ * @returns {Promise<Models.MemoryBulkDeleteResponse>}
162
+ */
163
+ deleteMany(params?: {
164
+ userId?: string;
165
+ memorySubStoreId?: string;
166
+ limit?: number;
167
+ reason?: string;
168
+ source?: string;
169
+ }): Promise<Models.MemoryBulkDeleteResponse>;
170
+ /**
171
+ * Forget memory records in one bounded pass. Repeat while hasMore is true and inspect failed and items before considering the scope fully deleted.
172
+ *
173
+ * @param {string} userId - Target user ID.
174
+ * @param {string} memorySubStoreId - Memory sub-store for erasure.
175
+ * @param {number} limit - Requested upper bound for this pass, from 1 to 500. The service may process fewer records; repeat while hasMore is true.
176
+ * @param {string} reason - Forgetting reason.
177
+ * @param {string} source - Forgetting source.
178
+ * @throws {AgentbaseException}
179
+ * @returns {Promise<Models.MemoryBulkDeleteResponse>}
180
+ * @deprecated Use the object parameter style method for a better developer experience.
181
+ */
182
+ deleteMany(userId?: string, memorySubStoreId?: string, limit?: number, reason?: string, source?: string): Promise<Models.MemoryBulkDeleteResponse>;
183
+ /**
184
+ * Run a bounded batch of memory operations.
185
+ *
186
+ * @param {Models.MemoryBatchItem[]} params.items - Bounded create, delete, and search operations.
187
+ * @throws {AgentbaseException}
188
+ * @returns {Promise<{}>}
189
+ */
190
+ createBatch(params: {
191
+ items: Models.MemoryBatchItem[];
192
+ }): Promise<{}>;
193
+ /**
194
+ * Run a bounded batch of memory operations.
195
+ *
196
+ * @param {Models.MemoryBatchItem[]} items - Bounded create, delete, and search operations.
197
+ * @throws {AgentbaseException}
198
+ * @returns {Promise<{}>}
199
+ * @deprecated Use the object parameter style method for a better developer experience.
200
+ */
201
+ createBatch(items: Models.MemoryBatchItem[]): Promise<{}>;
202
+ /**
203
+ * List Memory context aggregates.
204
+ *
205
+ * @param {Scope} params.scope - Knowledge ownership scope.
206
+ * @param {string} params.userId - Target user ID.
207
+ * @param {string} params.agentId - Agent ID for agent scope.
208
+ * @param {string} params.sessionId - Source session ID.
209
+ * @param {string} params.runId - Source run ID.
210
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
211
+ * @param {Status} params.status - Context lifecycle status.
212
+ * @param {Kind} params.kind - Context hierarchy kind.
213
+ * @param {string} params.cursor - Opaque pagination cursor.
214
+ * @param {number} params.limit - Maximum number of contexts.
215
+ * @throws {AgentbaseException}
216
+ * @returns {Promise<{}>}
217
+ */
218
+ listContexts(params?: {
219
+ scope?: Scope;
220
+ userId?: string;
221
+ agentId?: string;
222
+ sessionId?: string;
223
+ runId?: string;
224
+ memorySubStoreId?: string;
225
+ status?: Status;
226
+ kind?: Kind;
227
+ cursor?: string;
228
+ limit?: number;
229
+ }): Promise<{}>;
230
+ /**
231
+ * List Memory context aggregates.
232
+ *
233
+ * @param {Scope} scope - Knowledge ownership scope.
234
+ * @param {string} userId - Target user ID.
235
+ * @param {string} agentId - Agent ID for agent scope.
236
+ * @param {string} sessionId - Source session ID.
237
+ * @param {string} runId - Source run ID.
238
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
239
+ * @param {Status} status - Context lifecycle status.
240
+ * @param {Kind} kind - Context hierarchy kind.
241
+ * @param {string} cursor - Opaque pagination cursor.
242
+ * @param {number} limit - Maximum number of contexts.
243
+ * @throws {AgentbaseException}
244
+ * @returns {Promise<{}>}
245
+ * @deprecated Use the object parameter style method for a better developer experience.
246
+ */
247
+ listContexts(scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, status?: Status, kind?: Kind, cursor?: string, limit?: number): Promise<{}>;
248
+ /**
249
+ * Scan changed memories and schedule Dreaming.
250
+ *
251
+ * @param {Scope} params.scope - Knowledge ownership scope.
252
+ * @param {string} params.userId - Target user ID.
253
+ * @param {string} params.agentId - Agent ID for agent scope.
254
+ * @param {string} params.sessionId - Source session ID.
255
+ * @param {string} params.runId - Source run ID.
256
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
257
+ * @throws {AgentbaseException}
258
+ * @returns {Promise<{}>}
259
+ */
260
+ createContextRun(params?: {
261
+ scope?: Scope;
262
+ userId?: string;
263
+ agentId?: string;
264
+ sessionId?: string;
265
+ runId?: string;
266
+ memorySubStoreId?: string;
267
+ }): Promise<{}>;
268
+ /**
269
+ * Scan changed memories and schedule Dreaming.
270
+ *
271
+ * @param {Scope} scope - Knowledge ownership scope.
272
+ * @param {string} userId - Target user ID.
273
+ * @param {string} agentId - Agent ID for agent scope.
274
+ * @param {string} sessionId - Source session ID.
275
+ * @param {string} runId - Source run ID.
276
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
277
+ * @throws {AgentbaseException}
278
+ * @returns {Promise<{}>}
279
+ * @deprecated Use the object parameter style method for a better developer experience.
280
+ */
281
+ createContextRun(scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
282
+ /**
283
+ * Get Dreaming watermark and job status.
284
+ *
285
+ * @param {Scope} params.scope - Knowledge ownership scope.
286
+ * @param {string} params.userId - Target user ID.
287
+ * @param {string} params.agentId - Agent ID for agent scope.
288
+ * @param {string} params.sessionId - Source session ID.
289
+ * @param {string} params.runId - Source run ID.
290
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
291
+ * @throws {AgentbaseException}
292
+ * @returns {Promise<{}>}
293
+ */
294
+ getContextStatus(params?: {
295
+ scope?: Scope;
296
+ userId?: string;
297
+ agentId?: string;
298
+ sessionId?: string;
299
+ runId?: string;
300
+ memorySubStoreId?: string;
301
+ }): Promise<{}>;
302
+ /**
303
+ * Get Dreaming watermark and job status.
304
+ *
305
+ * @param {Scope} scope - Knowledge ownership scope.
306
+ * @param {string} userId - Target user ID.
307
+ * @param {string} agentId - Agent ID for agent scope.
308
+ * @param {string} sessionId - Source session ID.
309
+ * @param {string} runId - Source run ID.
310
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
311
+ * @throws {AgentbaseException}
312
+ * @returns {Promise<{}>}
313
+ * @deprecated Use the object parameter style method for a better developer experience.
314
+ */
315
+ getContextStatus(scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
316
+ /**
317
+ * Get one Memory context aggregate.
318
+ *
319
+ * @param {string} params.contextId - Context knowledge ID.
320
+ * @param {Scope} params.scope - Knowledge ownership scope.
321
+ * @param {string} params.userId - Target user ID.
322
+ * @param {string} params.agentId - Agent ID for agent scope.
323
+ * @param {string} params.sessionId - Source session ID.
324
+ * @param {string} params.runId - Source run ID.
325
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
326
+ * @throws {AgentbaseException}
327
+ * @returns {Promise<{}>}
328
+ */
329
+ getContext(params: {
330
+ contextId: string;
331
+ scope?: Scope;
332
+ userId?: string;
333
+ agentId?: string;
334
+ sessionId?: string;
335
+ runId?: string;
336
+ memorySubStoreId?: string;
337
+ }): Promise<{}>;
338
+ /**
339
+ * Get one Memory context aggregate.
340
+ *
341
+ * @param {string} contextId - Context knowledge ID.
342
+ * @param {Scope} scope - Knowledge ownership scope.
343
+ * @param {string} userId - Target user ID.
344
+ * @param {string} agentId - Agent ID for agent scope.
345
+ * @param {string} sessionId - Source session ID.
346
+ * @param {string} runId - Source run ID.
347
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
348
+ * @throws {AgentbaseException}
349
+ * @returns {Promise<{}>}
350
+ * @deprecated Use the object parameter style method for a better developer experience.
351
+ */
352
+ getContext(contextId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
353
+ /**
354
+ * Activate a verified context shadow.
355
+ *
356
+ * @param {string} params.contextId - Context knowledge ID.
357
+ * @param {number} params.expectedVersion - Expected CAS version.
358
+ * @param {string} params.reason - Bounded governance reason.
359
+ * @param {Scope} params.scope - Knowledge ownership scope.
360
+ * @param {string} params.userId - Target user ID.
361
+ * @param {string} params.agentId - Agent ID for agent scope.
362
+ * @param {string} params.sessionId - Source session ID.
363
+ * @param {string} params.runId - Source run ID.
364
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
365
+ * @throws {AgentbaseException}
366
+ * @returns {Promise<{}>}
367
+ */
368
+ confirmContext(params: {
369
+ contextId: string;
370
+ expectedVersion: number;
371
+ reason: string;
372
+ scope?: Scope;
373
+ userId?: string;
374
+ agentId?: string;
375
+ sessionId?: string;
376
+ runId?: string;
377
+ memorySubStoreId?: string;
378
+ }): Promise<{}>;
379
+ /**
380
+ * Activate a verified context shadow.
381
+ *
382
+ * @param {string} contextId - Context knowledge ID.
383
+ * @param {number} expectedVersion - Expected CAS version.
384
+ * @param {string} reason - Bounded governance reason.
385
+ * @param {Scope} scope - Knowledge ownership scope.
386
+ * @param {string} userId - Target user ID.
387
+ * @param {string} agentId - Agent ID for agent scope.
388
+ * @param {string} sessionId - Source session ID.
389
+ * @param {string} runId - Source run ID.
390
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
391
+ * @throws {AgentbaseException}
392
+ * @returns {Promise<{}>}
393
+ * @deprecated Use the object parameter style method for a better developer experience.
394
+ */
395
+ confirmContext(contextId: string, expectedVersion: number, reason: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
396
+ /**
397
+ * Schedule one context for rebuilding.
398
+ *
399
+ * @param {string} params.contextId - Context knowledge ID.
400
+ * @param {string} params.reason - Bounded rebuild reason.
401
+ * @param {Scope} params.scope - Knowledge ownership scope.
402
+ * @param {string} params.userId - Target user ID.
403
+ * @param {string} params.agentId - Agent ID for agent scope.
404
+ * @param {string} params.sessionId - Source session ID.
405
+ * @param {string} params.runId - Source run ID.
406
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
407
+ * @throws {AgentbaseException}
408
+ * @returns {Promise<{}>}
409
+ */
410
+ rebuildContext(params: {
411
+ contextId: string;
412
+ reason: string;
413
+ scope?: Scope;
414
+ userId?: string;
415
+ agentId?: string;
416
+ sessionId?: string;
417
+ runId?: string;
418
+ memorySubStoreId?: string;
419
+ }): Promise<{}>;
420
+ /**
421
+ * Schedule one context for rebuilding.
422
+ *
423
+ * @param {string} contextId - Context knowledge ID.
424
+ * @param {string} reason - Bounded rebuild reason.
425
+ * @param {Scope} scope - Knowledge ownership scope.
426
+ * @param {string} userId - Target user ID.
427
+ * @param {string} agentId - Agent ID for agent scope.
428
+ * @param {string} sessionId - Source session ID.
429
+ * @param {string} runId - Source run ID.
430
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
431
+ * @throws {AgentbaseException}
432
+ * @returns {Promise<{}>}
433
+ * @deprecated Use the object parameter style method for a better developer experience.
434
+ */
435
+ rebuildContext(contextId: string, reason: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
436
+ /**
437
+ * Move an active context to an older verified revision.
438
+ *
439
+ * @param {string} params.contextId - Context knowledge ID.
440
+ * @param {number} params.expectedVersion - Expected CAS version.
441
+ * @param {number} params.targetRevision - Older verified revision number.
442
+ * @param {string} params.reason - Bounded governance reason.
443
+ * @param {Scope} params.scope - Knowledge ownership scope.
444
+ * @param {string} params.userId - Target user ID.
445
+ * @param {string} params.agentId - Agent ID for agent scope.
446
+ * @param {string} params.sessionId - Source session ID.
447
+ * @param {string} params.runId - Source run ID.
448
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
449
+ * @throws {AgentbaseException}
450
+ * @returns {Promise<{}>}
451
+ */
452
+ rollbackContext(params: {
453
+ contextId: string;
454
+ expectedVersion: number;
455
+ targetRevision: number;
456
+ reason: string;
457
+ scope?: Scope;
458
+ userId?: string;
459
+ agentId?: string;
460
+ sessionId?: string;
461
+ runId?: string;
462
+ memorySubStoreId?: string;
463
+ }): Promise<{}>;
464
+ /**
465
+ * Move an active context to an older verified revision.
466
+ *
467
+ * @param {string} contextId - Context knowledge ID.
468
+ * @param {number} expectedVersion - Expected CAS version.
469
+ * @param {number} targetRevision - Older verified revision number.
470
+ * @param {string} reason - Bounded governance reason.
471
+ * @param {Scope} scope - Knowledge ownership scope.
472
+ * @param {string} userId - Target user ID.
473
+ * @param {string} agentId - Agent ID for agent scope.
474
+ * @param {string} sessionId - Source session ID.
475
+ * @param {string} runId - Source run ID.
476
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
477
+ * @throws {AgentbaseException}
478
+ * @returns {Promise<{}>}
479
+ * @deprecated Use the object parameter style method for a better developer experience.
480
+ */
481
+ rollbackContext(contextId: string, expectedVersion: number, targetRevision: number, reason: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
482
+ /**
483
+ * List scoped distillation jobs.
484
+ *
485
+ * @param {Scope} params.scope - Knowledge ownership scope.
486
+ * @param {string} params.userId - Target user ID.
487
+ * @param {string} params.agentId - Agent ID for agent scope.
488
+ * @param {string} params.sessionId - Source session ID.
489
+ * @param {string} params.runId - Source run ID.
490
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
491
+ * @param {Status} params.status - Filter by job status.
492
+ * @param {string} params.cursor - Opaque pagination cursor.
493
+ * @param {number} params.limit - Maximum number of distillations.
494
+ * @throws {AgentbaseException}
495
+ * @returns {Promise<{}>}
496
+ */
497
+ listDistillations(params?: {
498
+ scope?: Scope;
499
+ userId?: string;
500
+ agentId?: string;
501
+ sessionId?: string;
502
+ runId?: string;
503
+ memorySubStoreId?: string;
504
+ status?: Status;
505
+ cursor?: string;
506
+ limit?: number;
507
+ }): Promise<{}>;
508
+ /**
509
+ * List scoped distillation jobs.
510
+ *
511
+ * @param {Scope} scope - Knowledge ownership scope.
512
+ * @param {string} userId - Target user ID.
513
+ * @param {string} agentId - Agent ID for agent scope.
514
+ * @param {string} sessionId - Source session ID.
515
+ * @param {string} runId - Source run ID.
516
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
517
+ * @param {Status} status - Filter by job status.
518
+ * @param {string} cursor - Opaque pagination cursor.
519
+ * @param {number} limit - Maximum number of distillations.
520
+ * @throws {AgentbaseException}
521
+ * @returns {Promise<{}>}
522
+ * @deprecated Use the object parameter style method for a better developer experience.
523
+ */
524
+ listDistillations(scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, status?: Status, cursor?: string, limit?: number): Promise<{}>;
525
+ /**
526
+ * Submit bounded evidence for Experience and Skill distillation, optionally waiting up to 20 seconds.
527
+ *
528
+ * @param {Scope} params.scope - Knowledge ownership scope.
529
+ * @param {string} params.userId - Target user ID.
530
+ * @param {string} params.agentId - Agent ID for agent scope.
531
+ * @param {string} params.sessionId - Source session ID.
532
+ * @param {string} params.runId - Source run ID.
533
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
534
+ * @param {string} params.pipelineId - Optional published Pipeline ID for this scenario. Omit to use its default.
535
+ * @param {string} params.sourceId - Persisted source ID.
536
+ * @param {SourceType} params.sourceType - Persisted source type.
537
+ * @param {Models.DistillationMessage[]} params.messages - Bounded conversation messages.
538
+ * @param {Models.DistillationToolEvent[]} params.toolEvents - Bounded tool execution events.
539
+ * @param {DistillationMode} params.mode - Use async to return immediately or wait to wait up to 20 seconds for a terminal result.
540
+ * @param {string} params.idempotencyKey - Stable key used to deduplicate retries. May be supplied as the Idempotency-Key header.
541
+ * @throws {AgentbaseException}
542
+ * @returns {Promise<{}>}
543
+ */
544
+ submitDistillation(params?: {
545
+ scope?: Scope;
546
+ userId?: string;
547
+ agentId?: string;
548
+ sessionId?: string;
549
+ runId?: string;
550
+ memorySubStoreId?: string;
551
+ pipelineId?: string;
552
+ sourceId?: string;
553
+ sourceType?: SourceType;
554
+ messages?: Models.DistillationMessage[];
555
+ toolEvents?: Models.DistillationToolEvent[];
556
+ mode?: DistillationMode;
557
+ idempotencyKey?: string;
558
+ }): Promise<{}>;
559
+ /**
560
+ * Submit bounded evidence for Experience and Skill distillation, optionally waiting up to 20 seconds.
561
+ *
562
+ * @param {Scope} scope - Knowledge ownership scope.
563
+ * @param {string} userId - Target user ID.
564
+ * @param {string} agentId - Agent ID for agent scope.
565
+ * @param {string} sessionId - Source session ID.
566
+ * @param {string} runId - Source run ID.
567
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
568
+ * @param {string} pipelineId - Optional published Pipeline ID for this scenario. Omit to use its default.
569
+ * @param {string} sourceId - Persisted source ID.
570
+ * @param {SourceType} sourceType - Persisted source type.
571
+ * @param {Models.DistillationMessage[]} messages - Bounded conversation messages.
572
+ * @param {Models.DistillationToolEvent[]} toolEvents - Bounded tool execution events.
573
+ * @param {DistillationMode} mode - Use async to return immediately or wait to wait up to 20 seconds for a terminal result.
574
+ * @param {string} idempotencyKey - Stable key used to deduplicate retries. May be supplied as the Idempotency-Key header.
575
+ * @throws {AgentbaseException}
576
+ * @returns {Promise<{}>}
577
+ * @deprecated Use the object parameter style method for a better developer experience.
578
+ */
579
+ submitDistillation(scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, pipelineId?: string, sourceId?: string, sourceType?: SourceType, messages?: Models.DistillationMessage[], toolEvents?: Models.DistillationToolEvent[], mode?: DistillationMode, idempotencyKey?: string): Promise<{}>;
580
+ /**
581
+ * Get a distillation job and its output references.
582
+ *
583
+ * @param {string} params.distillationId - Distillation unique ID.
584
+ * @param {Scope} params.scope - Knowledge ownership scope.
585
+ * @param {string} params.userId - Target user ID.
586
+ * @param {string} params.agentId - Agent ID for agent scope.
587
+ * @param {string} params.sessionId - Source session ID.
588
+ * @param {string} params.runId - Source run ID.
589
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
590
+ * @throws {AgentbaseException}
591
+ * @returns {Promise<{}>}
592
+ */
593
+ getDistillation(params: {
594
+ distillationId: string;
595
+ scope?: Scope;
596
+ userId?: string;
597
+ agentId?: string;
598
+ sessionId?: string;
599
+ runId?: string;
600
+ memorySubStoreId?: string;
601
+ }): Promise<{}>;
602
+ /**
603
+ * Get a distillation job and its output references.
604
+ *
605
+ * @param {string} distillationId - Distillation unique ID.
606
+ * @param {Scope} scope - Knowledge ownership scope.
607
+ * @param {string} userId - Target user ID.
608
+ * @param {string} agentId - Agent ID for agent scope.
609
+ * @param {string} sessionId - Source session ID.
610
+ * @param {string} runId - Source run ID.
611
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
612
+ * @throws {AgentbaseException}
613
+ * @returns {Promise<{}>}
614
+ * @deprecated Use the object parameter style method for a better developer experience.
615
+ */
616
+ getDistillation(distillationId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
617
+ /**
618
+ * Replay a failed or partial distillation job.
619
+ *
620
+ * @param {string} params.distillationId - Distillation unique ID.
621
+ * @param {Scope} params.scope - Knowledge ownership scope.
622
+ * @param {string} params.userId - Target user ID.
623
+ * @param {string} params.agentId - Agent ID for agent scope.
624
+ * @param {string} params.sessionId - Source session ID.
625
+ * @param {string} params.runId - Source run ID.
626
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
627
+ * @throws {AgentbaseException}
628
+ * @returns {Promise<{}>}
629
+ */
630
+ replayDistillation(params: {
631
+ distillationId: string;
632
+ scope?: Scope;
633
+ userId?: string;
634
+ agentId?: string;
635
+ sessionId?: string;
636
+ runId?: string;
637
+ memorySubStoreId?: string;
638
+ }): Promise<{}>;
639
+ /**
640
+ * Replay a failed or partial distillation job.
641
+ *
642
+ * @param {string} distillationId - Distillation unique ID.
643
+ * @param {Scope} scope - Knowledge ownership scope.
644
+ * @param {string} userId - Target user ID.
645
+ * @param {string} agentId - Agent ID for agent scope.
646
+ * @param {string} sessionId - Source session ID.
647
+ * @param {string} runId - Source run ID.
648
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
649
+ * @throws {AgentbaseException}
650
+ * @returns {Promise<{}>}
651
+ * @deprecated Use the object parameter style method for a better developer experience.
652
+ */
653
+ replayDistillation(distillationId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
654
+ /**
655
+ * List active verified Experiences.
656
+ *
657
+ * @param {Scope} params.scope - Knowledge ownership scope.
658
+ * @param {string} params.userId - Target user ID.
659
+ * @param {string} params.agentId - Agent ID for agent scope.
660
+ * @param {string} params.sessionId - Source session ID.
661
+ * @param {string} params.runId - Source run ID.
662
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
663
+ * @param {string} params.cursor - Opaque pagination cursor.
664
+ * @param {number} params.limit - Maximum number of Experiences.
665
+ * @throws {AgentbaseException}
666
+ * @returns {Promise<{}>}
667
+ */
668
+ listExperiences(params?: {
669
+ scope?: Scope;
670
+ userId?: string;
671
+ agentId?: string;
672
+ sessionId?: string;
673
+ runId?: string;
674
+ memorySubStoreId?: string;
675
+ cursor?: string;
676
+ limit?: number;
677
+ }): Promise<{}>;
678
+ /**
679
+ * List active verified Experiences.
680
+ *
681
+ * @param {Scope} scope - Knowledge ownership scope.
682
+ * @param {string} userId - Target user ID.
683
+ * @param {string} agentId - Agent ID for agent scope.
684
+ * @param {string} sessionId - Source session ID.
685
+ * @param {string} runId - Source run ID.
686
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
687
+ * @param {string} cursor - Opaque pagination cursor.
688
+ * @param {number} limit - Maximum number of Experiences.
689
+ * @throws {AgentbaseException}
690
+ * @returns {Promise<{}>}
691
+ * @deprecated Use the object parameter style method for a better developer experience.
692
+ */
693
+ listExperiences(scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, cursor?: string, limit?: number): Promise<{}>;
694
+ /**
695
+ * Search active verified Experiences using configured recall routes.
696
+ *
697
+ * @param {string} params.query - Semantic search query.
698
+ * @param {Scope} params.scope - Knowledge ownership scope.
699
+ * @param {string} params.userId - Target user ID.
700
+ * @param {string} params.agentId - Agent ID for agent scope.
701
+ * @param {string} params.sessionId - Source session ID.
702
+ * @param {string} params.runId - Source run ID.
703
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
704
+ * @param {string} params.cursor - Opaque pagination cursor.
705
+ * @param {number} params.limit - Maximum number of Experiences.
706
+ * @param {object} params.retrieval - Recall route overrides.
707
+ * @throws {AgentbaseException}
708
+ * @returns {Promise<{}>}
709
+ */
710
+ searchExperiences(params: {
711
+ query: string;
712
+ scope?: Scope;
713
+ userId?: string;
714
+ agentId?: string;
715
+ sessionId?: string;
716
+ runId?: string;
717
+ memorySubStoreId?: string;
718
+ cursor?: string;
719
+ limit?: number;
720
+ retrieval?: object;
721
+ }): Promise<{}>;
722
+ /**
723
+ * Search active verified Experiences using configured recall routes.
724
+ *
725
+ * @param {string} query - Semantic search query.
726
+ * @param {Scope} scope - Knowledge ownership scope.
727
+ * @param {string} userId - Target user ID.
728
+ * @param {string} agentId - Agent ID for agent scope.
729
+ * @param {string} sessionId - Source session ID.
730
+ * @param {string} runId - Source run ID.
731
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
732
+ * @param {string} cursor - Opaque pagination cursor.
733
+ * @param {number} limit - Maximum number of Experiences.
734
+ * @param {object} retrieval - Recall route overrides.
735
+ * @throws {AgentbaseException}
736
+ * @returns {Promise<{}>}
737
+ * @deprecated Use the object parameter style method for a better developer experience.
738
+ */
739
+ searchExperiences(query: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, cursor?: string, limit?: number, retrieval?: object): Promise<{}>;
740
+ /**
741
+ * Get an active verified Experience.
742
+ *
743
+ * @param {string} params.knowledgeId - Experience knowledge ID.
744
+ * @param {Scope} params.scope - Knowledge ownership scope.
745
+ * @param {string} params.userId - Target user ID.
746
+ * @param {string} params.agentId - Agent ID for agent scope.
747
+ * @param {string} params.sessionId - Source session ID.
748
+ * @param {string} params.runId - Source run ID.
749
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
750
+ * @throws {AgentbaseException}
751
+ * @returns {Promise<{}>}
752
+ */
753
+ getExperience(params: {
754
+ knowledgeId: string;
755
+ scope?: Scope;
756
+ userId?: string;
757
+ agentId?: string;
758
+ sessionId?: string;
759
+ runId?: string;
760
+ memorySubStoreId?: string;
761
+ }): Promise<{}>;
762
+ /**
763
+ * Get an active verified Experience.
764
+ *
765
+ * @param {string} knowledgeId - Experience knowledge ID.
766
+ * @param {Scope} scope - Knowledge ownership scope.
767
+ * @param {string} userId - Target user ID.
768
+ * @param {string} agentId - Agent ID for agent scope.
769
+ * @param {string} sessionId - Source session ID.
770
+ * @param {string} runId - Source run ID.
771
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
772
+ * @throws {AgentbaseException}
773
+ * @returns {Promise<{}>}
774
+ * @deprecated Use the object parameter style method for a better developer experience.
775
+ */
776
+ getExperience(knowledgeId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
777
+ /**
778
+ * List immutable provenance sources linked to an Experience.
779
+ *
780
+ * @param {string} params.knowledgeId - Experience knowledge ID.
781
+ * @param {Scope} params.scope - Knowledge ownership scope.
782
+ * @param {string} params.userId - Target user ID.
783
+ * @param {string} params.agentId - Agent ID for agent scope.
784
+ * @param {string} params.sessionId - Source session ID.
785
+ * @param {string} params.runId - Source run ID.
786
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
787
+ * @param {string} params.cursor - Opaque pagination cursor.
788
+ * @param {number} params.limit - Maximum sources.
789
+ * @throws {AgentbaseException}
790
+ * @returns {Promise<{}>}
791
+ */
792
+ listExperienceSources(params: {
793
+ knowledgeId: string;
794
+ scope?: Scope;
795
+ userId?: string;
796
+ agentId?: string;
797
+ sessionId?: string;
798
+ runId?: string;
799
+ memorySubStoreId?: string;
800
+ cursor?: string;
801
+ limit?: number;
802
+ }): Promise<{}>;
803
+ /**
804
+ * List immutable provenance sources linked to an Experience.
805
+ *
806
+ * @param {string} knowledgeId - Experience knowledge ID.
807
+ * @param {Scope} scope - Knowledge ownership scope.
808
+ * @param {string} userId - Target user ID.
809
+ * @param {string} agentId - Agent ID for agent scope.
810
+ * @param {string} sessionId - Source session ID.
811
+ * @param {string} runId - Source run ID.
812
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
813
+ * @param {string} cursor - Opaque pagination cursor.
814
+ * @param {number} limit - Maximum sources.
815
+ * @throws {AgentbaseException}
816
+ * @returns {Promise<{}>}
817
+ * @deprecated Use the object parameter style method for a better developer experience.
818
+ */
819
+ listExperienceSources(knowledgeId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, cursor?: string, limit?: number): Promise<{}>;
820
+ /**
821
+ * Export a bounded set of memories synchronously.
822
+ *
823
+ * @param {string} params.userId - User whose memories are exported.
824
+ * @param {Format} params.format - Export representation.
825
+ * @param {ExportMode} params.mode - Synchronous export mode.
826
+ * @param {boolean} params.includeForgotten - Include forgotten records. Requires system authorization.
827
+ * @param {boolean} params.includeVectors - Include vector projections. Requires system authorization.
828
+ * @param {boolean} params.includeRawSources - Include raw source evidence. Requires system authorization.
829
+ * @throws {AgentbaseException}
830
+ * @returns {Promise<{}>}
831
+ */
832
+ getExport(params: {
833
+ userId: string;
834
+ format?: Format;
835
+ mode?: ExportMode;
836
+ includeForgotten?: boolean;
837
+ includeVectors?: boolean;
838
+ includeRawSources?: boolean;
839
+ }): Promise<{}>;
840
+ /**
841
+ * Export a bounded set of memories synchronously.
842
+ *
843
+ * @param {string} userId - User whose memories are exported.
844
+ * @param {Format} format - Export representation.
845
+ * @param {ExportMode} mode - Synchronous export mode.
846
+ * @param {boolean} includeForgotten - Include forgotten records. Requires system authorization.
847
+ * @param {boolean} includeVectors - Include vector projections. Requires system authorization.
848
+ * @param {boolean} includeRawSources - Include raw source evidence. Requires system authorization.
849
+ * @throws {AgentbaseException}
850
+ * @returns {Promise<{}>}
851
+ * @deprecated Use the object parameter style method for a better developer experience.
852
+ */
853
+ getExport(userId: string, format?: Format, mode?: ExportMode, includeForgotten?: boolean, includeVectors?: boolean, includeRawSources?: boolean): Promise<{}>;
854
+ /**
855
+ * Create a memory export job.
856
+ *
857
+ * @param {string} params.userId - User whose memories are exported.
858
+ * @param {Format} params.format - Export representation.
859
+ * @param {boolean} params.includeForgotten - Include forgotten records. Requires system authorization.
860
+ * @param {boolean} params.includeVectors - Include vector projections. Requires system authorization.
861
+ * @param {boolean} params.includeRawSources - Include raw source evidence. Requires system authorization.
862
+ * @param {ExportJobMode} params.mode - Export job execution mode.
863
+ * @throws {AgentbaseException}
864
+ * @returns {Promise<{}>}
865
+ */
866
+ createExport(params: {
867
+ userId: string;
868
+ format?: Format;
869
+ includeForgotten?: boolean;
870
+ includeVectors?: boolean;
871
+ includeRawSources?: boolean;
872
+ mode?: ExportJobMode;
873
+ }): Promise<{}>;
874
+ /**
875
+ * Create a memory export job.
876
+ *
877
+ * @param {string} userId - User whose memories are exported.
878
+ * @param {Format} format - Export representation.
879
+ * @param {boolean} includeForgotten - Include forgotten records. Requires system authorization.
880
+ * @param {boolean} includeVectors - Include vector projections. Requires system authorization.
881
+ * @param {boolean} includeRawSources - Include raw source evidence. Requires system authorization.
882
+ * @param {ExportJobMode} mode - Export job execution mode.
883
+ * @throws {AgentbaseException}
884
+ * @returns {Promise<{}>}
885
+ * @deprecated Use the object parameter style method for a better developer experience.
886
+ */
887
+ createExport(userId: string, format?: Format, includeForgotten?: boolean, includeVectors?: boolean, includeRawSources?: boolean, mode?: ExportJobMode): Promise<{}>;
888
+ /**
889
+ * Get a memory export job by its unique ID.
890
+ *
891
+ * @param {string} params.exportId - Memory export job unique ID.
892
+ * @throws {AgentbaseException}
893
+ * @returns {Promise<{}>}
894
+ */
895
+ getExportJob(params: {
896
+ exportId: string;
897
+ }): Promise<{}>;
898
+ /**
899
+ * Get a memory export job by its unique ID.
900
+ *
901
+ * @param {string} exportId - Memory export job unique ID.
902
+ * @throws {AgentbaseException}
903
+ * @returns {Promise<{}>}
904
+ * @deprecated Use the object parameter style method for a better developer experience.
905
+ */
906
+ getExportJob(exportId: string): Promise<{}>;
907
+ /**
908
+ * Record feedback for one recalled knowledge revision.
909
+ *
910
+ * @param {string} params.injectionId - Recall injection ID.
911
+ * @param {string} params.knowledgeId - Recalled Skill or Experience knowledge ID. Memory and profile items are not feedback eligible.
912
+ * @param {number} params.revision - Knowledge revision.
913
+ * @param {FeedbackType} params.feedbackType - Feedback type.
914
+ * @param {Scope} params.scope - Knowledge ownership scope.
915
+ * @param {string} params.userId - Target user ID.
916
+ * @param {string} params.agentId - Agent ID for agent scope.
917
+ * @param {string} params.sessionId - Source session ID.
918
+ * @param {string} params.runId - Source run ID.
919
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
920
+ * @param {string} params.reasonCode - Optional bounded reason code.
921
+ * @param {string} params.idempotencyKey - Stable key used to deduplicate retries. May be supplied as the Idempotency-Key header.
922
+ * @throws {AgentbaseException}
923
+ * @returns {Promise<{}>}
924
+ */
925
+ createKnowledgeFeedback(params: {
926
+ injectionId: string;
927
+ knowledgeId: string;
928
+ revision: number;
929
+ feedbackType: FeedbackType;
930
+ scope?: Scope;
931
+ userId?: string;
932
+ agentId?: string;
933
+ sessionId?: string;
934
+ runId?: string;
935
+ memorySubStoreId?: string;
936
+ reasonCode?: string;
937
+ idempotencyKey?: string;
938
+ }): Promise<{}>;
939
+ /**
940
+ * Record feedback for one recalled knowledge revision.
941
+ *
942
+ * @param {string} injectionId - Recall injection ID.
943
+ * @param {string} knowledgeId - Recalled Skill or Experience knowledge ID. Memory and profile items are not feedback eligible.
944
+ * @param {number} revision - Knowledge revision.
945
+ * @param {FeedbackType} feedbackType - Feedback type.
946
+ * @param {Scope} scope - Knowledge ownership scope.
947
+ * @param {string} userId - Target user ID.
948
+ * @param {string} agentId - Agent ID for agent scope.
949
+ * @param {string} sessionId - Source session ID.
950
+ * @param {string} runId - Source run ID.
951
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
952
+ * @param {string} reasonCode - Optional bounded reason code.
953
+ * @param {string} idempotencyKey - Stable key used to deduplicate retries. May be supplied as the Idempotency-Key header.
954
+ * @throws {AgentbaseException}
955
+ * @returns {Promise<{}>}
956
+ * @deprecated Use the object parameter style method for a better developer experience.
957
+ */
958
+ createKnowledgeFeedback(injectionId: string, knowledgeId: string, revision: number, feedbackType: FeedbackType, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, reasonCode?: string, idempotencyKey?: string): Promise<{}>;
959
+ /**
960
+ * Create a memory import job.
961
+ *
962
+ * @param {string} params.userId - Target user ID.
963
+ * @param {string} params.pipelineId - Published add-memory Pipeline ID applied to every imported record. Omit to use the default Pipeline.
964
+ * @param {Format} params.format - Import format.
965
+ * @param {string} params.data - Raw JSON or JSONL import data.
966
+ * @param {Models.MemoryRecordInput[]} params.records - Structured memory records.
967
+ * @param {boolean} params.dryRun - Validate without writing records.
968
+ * @throws {AgentbaseException}
969
+ * @returns {Promise<{}>}
970
+ */
971
+ createImport(params: {
972
+ userId: string;
973
+ pipelineId?: string;
974
+ format?: Format;
975
+ data?: string;
976
+ records?: Models.MemoryRecordInput[];
977
+ dryRun?: boolean;
978
+ }): Promise<{}>;
979
+ /**
980
+ * Create a memory import job.
981
+ *
982
+ * @param {string} userId - Target user ID.
983
+ * @param {string} pipelineId - Published add-memory Pipeline ID applied to every imported record. Omit to use the default Pipeline.
984
+ * @param {Format} format - Import format.
985
+ * @param {string} data - Raw JSON or JSONL import data.
986
+ * @param {Models.MemoryRecordInput[]} records - Structured memory records.
987
+ * @param {boolean} dryRun - Validate without writing records.
988
+ * @throws {AgentbaseException}
989
+ * @returns {Promise<{}>}
990
+ * @deprecated Use the object parameter style method for a better developer experience.
991
+ */
992
+ createImport(userId: string, pipelineId?: string, format?: Format, data?: string, records?: Models.MemoryRecordInput[], dryRun?: boolean): Promise<{}>;
993
+ /**
994
+ * Get a memory import job by its unique ID.
995
+ *
996
+ * @param {string} params.importId - Memory import job unique ID.
997
+ * @throws {AgentbaseException}
998
+ * @returns {Promise<{}>}
999
+ */
1000
+ getImport(params: {
1001
+ importId: string;
1002
+ }): Promise<{}>;
1003
+ /**
1004
+ * Get a memory import job by its unique ID.
1005
+ *
1006
+ * @param {string} importId - Memory import job unique ID.
1007
+ * @throws {AgentbaseException}
1008
+ * @returns {Promise<{}>}
1009
+ * @deprecated Use the object parameter style method for a better developer experience.
1010
+ */
1011
+ getImport(importId: string): Promise<{}>;
1012
+ /**
1013
+ * Manage immutable Knowledge versions and optional human review.
1014
+ *
1015
+ * @param {Scope} params.scope - Knowledge ownership scope.
1016
+ * @param {string} params.userId - Target user ID.
1017
+ * @param {string} params.agentId - Agent ID for agent scope.
1018
+ * @param {string} params.sessionId - Source session ID.
1019
+ * @param {string} params.runId - Source run ID.
1020
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1021
+ * @param {number} params.limit - Page size, maximum 100.
1022
+ * @param {number} params.offset - Page offset.
1023
+ * @param {Status} params.status - Review status.
1024
+ * @param {string} params.knowledgeId - Knowledge ID filter.
1025
+ * @throws {AgentbaseException}
1026
+ * @returns {Promise<{}>}
1027
+ */
1028
+ listKnowledgeReviews(params?: {
1029
+ scope?: Scope;
1030
+ userId?: string;
1031
+ agentId?: string;
1032
+ sessionId?: string;
1033
+ runId?: string;
1034
+ memorySubStoreId?: string;
1035
+ limit?: number;
1036
+ offset?: number;
1037
+ status?: Status;
1038
+ knowledgeId?: string;
1039
+ }): Promise<{}>;
1040
+ /**
1041
+ * Manage immutable Knowledge versions and optional human review.
1042
+ *
1043
+ * @param {Scope} scope - Knowledge ownership scope.
1044
+ * @param {string} userId - Target user ID.
1045
+ * @param {string} agentId - Agent ID for agent scope.
1046
+ * @param {string} sessionId - Source session ID.
1047
+ * @param {string} runId - Source run ID.
1048
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1049
+ * @param {number} limit - Page size, maximum 100.
1050
+ * @param {number} offset - Page offset.
1051
+ * @param {Status} status - Review status.
1052
+ * @param {string} knowledgeId - Knowledge ID filter.
1053
+ * @throws {AgentbaseException}
1054
+ * @returns {Promise<{}>}
1055
+ * @deprecated Use the object parameter style method for a better developer experience.
1056
+ */
1057
+ listKnowledgeReviews(scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, limit?: number, offset?: number, status?: Status, knowledgeId?: string): Promise<{}>;
1058
+ /**
1059
+ * Manage immutable Knowledge versions and optional human review.
1060
+ *
1061
+ * @param {string} params.reviewId - reviewId
1062
+ * @param {Scope} params.scope - Knowledge ownership scope.
1063
+ * @param {string} params.userId - Target user ID.
1064
+ * @param {string} params.agentId - Agent ID for agent scope.
1065
+ * @param {string} params.sessionId - Source session ID.
1066
+ * @param {string} params.runId - Source run ID.
1067
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1068
+ * @throws {AgentbaseException}
1069
+ * @returns {Promise<{}>}
1070
+ */
1071
+ getKnowledgeReview(params: {
1072
+ reviewId: string;
1073
+ scope?: Scope;
1074
+ userId?: string;
1075
+ agentId?: string;
1076
+ sessionId?: string;
1077
+ runId?: string;
1078
+ memorySubStoreId?: string;
1079
+ }): Promise<{}>;
1080
+ /**
1081
+ * Manage immutable Knowledge versions and optional human review.
1082
+ *
1083
+ * @param {string} reviewId - reviewId
1084
+ * @param {Scope} scope - Knowledge ownership scope.
1085
+ * @param {string} userId - Target user ID.
1086
+ * @param {string} agentId - Agent ID for agent scope.
1087
+ * @param {string} sessionId - Source session ID.
1088
+ * @param {string} runId - Source run ID.
1089
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1090
+ * @throws {AgentbaseException}
1091
+ * @returns {Promise<{}>}
1092
+ * @deprecated Use the object parameter style method for a better developer experience.
1093
+ */
1094
+ getKnowledgeReview(reviewId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
1095
+ /**
1096
+ * Update managed knowledge state.
1097
+ *
1098
+ * @param {string} params.knowledgeId - Knowledge ID.
1099
+ * @param {number} params.expectedVersion - Expected CAS version.
1100
+ * @param {Scope} params.scope - Knowledge ownership scope.
1101
+ * @param {string} params.userId - Target user ID.
1102
+ * @param {string} params.agentId - Agent ID for agent scope.
1103
+ * @param {string} params.sessionId - Source session ID.
1104
+ * @param {string} params.runId - Source run ID.
1105
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1106
+ * @param {Status} params.status - Target knowledge status.
1107
+ * @param {ValidationStatus} params.validationStatus - Target validation status.
1108
+ * @throws {AgentbaseException}
1109
+ * @returns {Promise<{}>}
1110
+ */
1111
+ updateKnowledge(params: {
1112
+ knowledgeId: string;
1113
+ expectedVersion: number;
1114
+ scope?: Scope;
1115
+ userId?: string;
1116
+ agentId?: string;
1117
+ sessionId?: string;
1118
+ runId?: string;
1119
+ memorySubStoreId?: string;
1120
+ status?: Status;
1121
+ validationStatus?: ValidationStatus;
1122
+ }): Promise<{}>;
1123
+ /**
1124
+ * Update managed knowledge state.
1125
+ *
1126
+ * @param {string} knowledgeId - Knowledge ID.
1127
+ * @param {number} expectedVersion - Expected CAS version.
1128
+ * @param {Scope} scope - Knowledge ownership scope.
1129
+ * @param {string} userId - Target user ID.
1130
+ * @param {string} agentId - Agent ID for agent scope.
1131
+ * @param {string} sessionId - Source session ID.
1132
+ * @param {string} runId - Source run ID.
1133
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1134
+ * @param {Status} status - Target knowledge status.
1135
+ * @param {ValidationStatus} validationStatus - Target validation status.
1136
+ * @throws {AgentbaseException}
1137
+ * @returns {Promise<{}>}
1138
+ * @deprecated Use the object parameter style method for a better developer experience.
1139
+ */
1140
+ updateKnowledge(knowledgeId: string, expectedVersion: number, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, status?: Status, validationStatus?: ValidationStatus): Promise<{}>;
1141
+ /**
1142
+ * Write the metadata forgetting marker for managed knowledge.
1143
+ *
1144
+ * @param {string} params.knowledgeId - Knowledge ID.
1145
+ * @param {number} params.expectedVersion - Expected CAS version.
1146
+ * @param {Scope} params.scope - Knowledge ownership scope.
1147
+ * @param {string} params.userId - Target user ID.
1148
+ * @param {string} params.agentId - Agent ID for agent scope.
1149
+ * @param {string} params.sessionId - Source session ID.
1150
+ * @param {string} params.runId - Source run ID.
1151
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1152
+ * @param {string} params.reason - Forgetting reason.
1153
+ * @param {string} params.source - Forgetting marker source.
1154
+ * @throws {AgentbaseException}
1155
+ * @returns {Promise<{}>}
1156
+ */
1157
+ forgetKnowledge(params: {
1158
+ knowledgeId: string;
1159
+ expectedVersion: number;
1160
+ scope?: Scope;
1161
+ userId?: string;
1162
+ agentId?: string;
1163
+ sessionId?: string;
1164
+ runId?: string;
1165
+ memorySubStoreId?: string;
1166
+ reason?: string;
1167
+ source?: string;
1168
+ }): Promise<{}>;
1169
+ /**
1170
+ * Write the metadata forgetting marker for managed knowledge.
1171
+ *
1172
+ * @param {string} knowledgeId - Knowledge ID.
1173
+ * @param {number} expectedVersion - Expected CAS version.
1174
+ * @param {Scope} scope - Knowledge ownership scope.
1175
+ * @param {string} userId - Target user ID.
1176
+ * @param {string} agentId - Agent ID for agent scope.
1177
+ * @param {string} sessionId - Source session ID.
1178
+ * @param {string} runId - Source run ID.
1179
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1180
+ * @param {string} reason - Forgetting reason.
1181
+ * @param {string} source - Forgetting marker source.
1182
+ * @throws {AgentbaseException}
1183
+ * @returns {Promise<{}>}
1184
+ * @deprecated Use the object parameter style method for a better developer experience.
1185
+ */
1186
+ forgetKnowledge(knowledgeId: string, expectedVersion: number, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, reason?: string, source?: string): Promise<{}>;
1187
+ /**
1188
+ * Manage immutable Knowledge versions and optional human review.
1189
+ *
1190
+ * @param {string} params.knowledgeId - knowledgeId
1191
+ * @param {string} params.toRevisionId - Candidate revision.
1192
+ * @param {Scope} params.scope - Knowledge ownership scope.
1193
+ * @param {string} params.userId - Target user ID.
1194
+ * @param {string} params.agentId - Agent ID for agent scope.
1195
+ * @param {string} params.sessionId - Source session ID.
1196
+ * @param {string} params.runId - Source run ID.
1197
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1198
+ * @param {string} params.fromRevisionId - Base revision; empty compares a new item.
1199
+ * @throws {AgentbaseException}
1200
+ * @returns {Promise<{}>}
1201
+ */
1202
+ getKnowledgeDiff(params: {
1203
+ knowledgeId: string;
1204
+ toRevisionId: string;
1205
+ scope?: Scope;
1206
+ userId?: string;
1207
+ agentId?: string;
1208
+ sessionId?: string;
1209
+ runId?: string;
1210
+ memorySubStoreId?: string;
1211
+ fromRevisionId?: string;
1212
+ }): Promise<{}>;
1213
+ /**
1214
+ * Manage immutable Knowledge versions and optional human review.
1215
+ *
1216
+ * @param {string} knowledgeId - knowledgeId
1217
+ * @param {string} toRevisionId - Candidate revision.
1218
+ * @param {Scope} scope - Knowledge ownership scope.
1219
+ * @param {string} userId - Target user ID.
1220
+ * @param {string} agentId - Agent ID for agent scope.
1221
+ * @param {string} sessionId - Source session ID.
1222
+ * @param {string} runId - Source run ID.
1223
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1224
+ * @param {string} fromRevisionId - Base revision; empty compares a new item.
1225
+ * @throws {AgentbaseException}
1226
+ * @returns {Promise<{}>}
1227
+ * @deprecated Use the object parameter style method for a better developer experience.
1228
+ */
1229
+ getKnowledgeDiff(knowledgeId: string, toRevisionId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, fromRevisionId?: string): Promise<{}>;
1230
+ /**
1231
+ * Manage immutable Knowledge versions and optional human review.
1232
+ *
1233
+ * @param {string} params.knowledgeId - knowledgeId
1234
+ * @param {Scope} params.scope - Knowledge ownership scope.
1235
+ * @param {string} params.userId - Target user ID.
1236
+ * @param {string} params.agentId - Agent ID for agent scope.
1237
+ * @param {string} params.sessionId - Source session ID.
1238
+ * @param {string} params.runId - Source run ID.
1239
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1240
+ * @throws {AgentbaseException}
1241
+ * @returns {Promise<{}>}
1242
+ */
1243
+ listKnowledgeEvents(params: {
1244
+ knowledgeId: string;
1245
+ scope?: Scope;
1246
+ userId?: string;
1247
+ agentId?: string;
1248
+ sessionId?: string;
1249
+ runId?: string;
1250
+ memorySubStoreId?: string;
1251
+ }): Promise<{}>;
1252
+ /**
1253
+ * Manage immutable Knowledge versions and optional human review.
1254
+ *
1255
+ * @param {string} knowledgeId - knowledgeId
1256
+ * @param {Scope} scope - Knowledge ownership scope.
1257
+ * @param {string} userId - Target user ID.
1258
+ * @param {string} agentId - Agent ID for agent scope.
1259
+ * @param {string} sessionId - Source session ID.
1260
+ * @param {string} runId - Source run ID.
1261
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1262
+ * @throws {AgentbaseException}
1263
+ * @returns {Promise<{}>}
1264
+ * @deprecated Use the object parameter style method for a better developer experience.
1265
+ */
1266
+ listKnowledgeEvents(knowledgeId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
1267
+ /**
1268
+ * Manage immutable Knowledge versions and optional human review.
1269
+ *
1270
+ * @param {string} params.knowledgeId - knowledgeId
1271
+ * @param {Scope} params.scope - Knowledge ownership scope.
1272
+ * @param {string} params.userId - Target user ID.
1273
+ * @param {string} params.agentId - Agent ID for agent scope.
1274
+ * @param {string} params.sessionId - Source session ID.
1275
+ * @param {string} params.runId - Source run ID.
1276
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1277
+ * @param {number} params.limit - Page size, maximum 100.
1278
+ * @param {number} params.offset - Page offset.
1279
+ * @throws {AgentbaseException}
1280
+ * @returns {Promise<{}>}
1281
+ */
1282
+ listKnowledgeRevisions(params: {
1283
+ knowledgeId: string;
1284
+ scope?: Scope;
1285
+ userId?: string;
1286
+ agentId?: string;
1287
+ sessionId?: string;
1288
+ runId?: string;
1289
+ memorySubStoreId?: string;
1290
+ limit?: number;
1291
+ offset?: number;
1292
+ }): Promise<{}>;
1293
+ /**
1294
+ * Manage immutable Knowledge versions and optional human review.
1295
+ *
1296
+ * @param {string} knowledgeId - knowledgeId
1297
+ * @param {Scope} scope - Knowledge ownership scope.
1298
+ * @param {string} userId - Target user ID.
1299
+ * @param {string} agentId - Agent ID for agent scope.
1300
+ * @param {string} sessionId - Source session ID.
1301
+ * @param {string} runId - Source run ID.
1302
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1303
+ * @param {number} limit - Page size, maximum 100.
1304
+ * @param {number} offset - Page offset.
1305
+ * @throws {AgentbaseException}
1306
+ * @returns {Promise<{}>}
1307
+ * @deprecated Use the object parameter style method for a better developer experience.
1308
+ */
1309
+ listKnowledgeRevisions(knowledgeId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, limit?: number, offset?: number): Promise<{}>;
1310
+ /**
1311
+ * Record bounded evidence for a knowledge revision.
1312
+ *
1313
+ * @param {string} params.knowledgeId - Knowledge ID.
1314
+ * @param {number} params.revision - Knowledge revision.
1315
+ * @param {Outcome} params.outcome - Observed outcome.
1316
+ * @param {object} params.evidence - Bounded observation evidence.
1317
+ * @param {Scope} params.scope - Knowledge ownership scope.
1318
+ * @param {string} params.userId - Target user ID.
1319
+ * @param {string} params.agentId - Agent ID for agent scope.
1320
+ * @param {string} params.sessionId - Source session ID.
1321
+ * @param {string} params.runId - Source run ID.
1322
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1323
+ * @param {string} params.sourceId - Evidence source ID.
1324
+ * @param {string} params.injectionId - Recall injection ID.
1325
+ * @param {VerificationSource} params.verificationSource - Deprecated caller hint; Agentbase derives the trusted source from authentication.
1326
+ * @param {string} params.toolName - Tool name.
1327
+ * @param {string} params.toolVersion - Tool version.
1328
+ * @param {string} params.toolSchemaVersion - Tool schema version.
1329
+ * @param {string} params.errorFingerprint - Bounded error fingerprint.
1330
+ * @param {number} params.weight - Deprecated caller hint; Agentbase derives the trusted weight from authentication.
1331
+ * @param {string} params.observedAt - Observation timestamp.
1332
+ * @param {string} params.idempotencyKey - Stable key used to deduplicate retries. May be supplied as the Idempotency-Key header.
1333
+ * @throws {AgentbaseException}
1334
+ * @returns {Promise<{}>}
1335
+ */
1336
+ createKnowledgeObservation(params: {
1337
+ knowledgeId: string;
1338
+ revision: number;
1339
+ outcome: Outcome;
1340
+ evidence: object;
1341
+ scope?: Scope;
1342
+ userId?: string;
1343
+ agentId?: string;
1344
+ sessionId?: string;
1345
+ runId?: string;
1346
+ memorySubStoreId?: string;
1347
+ sourceId?: string;
1348
+ injectionId?: string;
1349
+ verificationSource?: VerificationSource;
1350
+ toolName?: string;
1351
+ toolVersion?: string;
1352
+ toolSchemaVersion?: string;
1353
+ errorFingerprint?: string;
1354
+ weight?: number;
1355
+ observedAt?: string;
1356
+ idempotencyKey?: string;
1357
+ }): Promise<{}>;
1358
+ /**
1359
+ * Record bounded evidence for a knowledge revision.
1360
+ *
1361
+ * @param {string} knowledgeId - Knowledge ID.
1362
+ * @param {number} revision - Knowledge revision.
1363
+ * @param {Outcome} outcome - Observed outcome.
1364
+ * @param {object} evidence - Bounded observation evidence.
1365
+ * @param {Scope} scope - Knowledge ownership scope.
1366
+ * @param {string} userId - Target user ID.
1367
+ * @param {string} agentId - Agent ID for agent scope.
1368
+ * @param {string} sessionId - Source session ID.
1369
+ * @param {string} runId - Source run ID.
1370
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1371
+ * @param {string} sourceId - Evidence source ID.
1372
+ * @param {string} injectionId - Recall injection ID.
1373
+ * @param {VerificationSource} verificationSource - Deprecated caller hint; Agentbase derives the trusted source from authentication.
1374
+ * @param {string} toolName - Tool name.
1375
+ * @param {string} toolVersion - Tool version.
1376
+ * @param {string} toolSchemaVersion - Tool schema version.
1377
+ * @param {string} errorFingerprint - Bounded error fingerprint.
1378
+ * @param {number} weight - Deprecated caller hint; Agentbase derives the trusted weight from authentication.
1379
+ * @param {string} observedAt - Observation timestamp.
1380
+ * @param {string} idempotencyKey - Stable key used to deduplicate retries. May be supplied as the Idempotency-Key header.
1381
+ * @throws {AgentbaseException}
1382
+ * @returns {Promise<{}>}
1383
+ * @deprecated Use the object parameter style method for a better developer experience.
1384
+ */
1385
+ createKnowledgeObservation(knowledgeId: string, revision: number, outcome: Outcome, evidence: object, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, sourceId?: string, injectionId?: string, verificationSource?: VerificationSource, toolName?: string, toolVersion?: string, toolSchemaVersion?: string, errorFingerprint?: string, weight?: number, observedAt?: string, idempotencyKey?: string): Promise<{}>;
1386
+ /**
1387
+ * List live user memory profiles.
1388
+ *
1389
+ * @param {string} params.cursor - Opaque pagination cursor.
1390
+ * @param {number} params.limit - Maximum number of profiles.
1391
+ * @param {string} params.userId - Target user ID.
1392
+ * @param {ProfileType} params.profileType - Profile type. Omit to include every type.
1393
+ * @throws {AgentbaseException}
1394
+ * @returns {Promise<{}>}
1395
+ */
1396
+ listProfiles(params?: {
1397
+ cursor?: string;
1398
+ limit?: number;
1399
+ userId?: string;
1400
+ profileType?: ProfileType;
1401
+ }): Promise<{}>;
1402
+ /**
1403
+ * List live user memory profiles.
1404
+ *
1405
+ * @param {string} cursor - Opaque pagination cursor.
1406
+ * @param {number} limit - Maximum number of profiles.
1407
+ * @param {string} userId - Target user ID.
1408
+ * @param {ProfileType} profileType - Profile type. Omit to include every type.
1409
+ * @throws {AgentbaseException}
1410
+ * @returns {Promise<{}>}
1411
+ * @deprecated Use the object parameter style method for a better developer experience.
1412
+ */
1413
+ listProfiles(cursor?: string, limit?: number, userId?: string, profileType?: ProfileType): Promise<{}>;
1414
+ /**
1415
+ * Get a memory quality report.
1416
+ *
1417
+ * @throws {AgentbaseException}
1418
+ * @returns {Promise<{}>}
1419
+ */
1420
+ getQuality(): Promise<{}>;
1421
+ /**
1422
+ * Recall memories, profiles, Skills, and Experiences under one token budget.
1423
+ *
1424
+ * @param {string} params.query - Recall query.
1425
+ * @param {Scope} params.scope - Knowledge ownership scope.
1426
+ * @param {string} params.userId - Target user ID.
1427
+ * @param {string} params.agentId - Agent ID for agent scope.
1428
+ * @param {string} params.sessionId - Source session ID.
1429
+ * @param {string} params.runId - Source run ID.
1430
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1431
+ * @param {Kinds[]} params.kinds - Knowledge kinds to recall.
1432
+ * @param {number} params.limit - Maximum number of recalled items.
1433
+ * @param {number} params.tokenBudget - Maximum context token budget.
1434
+ * @param {object} params.retrieval - Recall route overrides.
1435
+ * @param {MemoryAccessMode} params.accessMode - Use owned for owner-filtered compatibility or accessible for the authorized visibility union.
1436
+ * @throws {AgentbaseException}
1437
+ * @returns {Promise<{}>}
1438
+ */
1439
+ recallKnowledge(params: {
1440
+ query: string;
1441
+ scope?: Scope;
1442
+ userId?: string;
1443
+ agentId?: string;
1444
+ sessionId?: string;
1445
+ runId?: string;
1446
+ memorySubStoreId?: string;
1447
+ kinds?: Kinds[];
1448
+ limit?: number;
1449
+ tokenBudget?: number;
1450
+ retrieval?: object;
1451
+ accessMode?: MemoryAccessMode;
1452
+ }): Promise<{}>;
1453
+ /**
1454
+ * Recall memories, profiles, Skills, and Experiences under one token budget.
1455
+ *
1456
+ * @param {string} query - Recall query.
1457
+ * @param {Scope} scope - Knowledge ownership scope.
1458
+ * @param {string} userId - Target user ID.
1459
+ * @param {string} agentId - Agent ID for agent scope.
1460
+ * @param {string} sessionId - Source session ID.
1461
+ * @param {string} runId - Source run ID.
1462
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1463
+ * @param {Kinds[]} kinds - Knowledge kinds to recall.
1464
+ * @param {number} limit - Maximum number of recalled items.
1465
+ * @param {number} tokenBudget - Maximum context token budget.
1466
+ * @param {object} retrieval - Recall route overrides.
1467
+ * @param {MemoryAccessMode} accessMode - Use owned for owner-filtered compatibility or accessible for the authorized visibility union.
1468
+ * @throws {AgentbaseException}
1469
+ * @returns {Promise<{}>}
1470
+ * @deprecated Use the object parameter style method for a better developer experience.
1471
+ */
1472
+ recallKnowledge(query: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, kinds?: Kinds[], limit?: number, tokenBudget?: number, retrieval?: object, accessMode?: MemoryAccessMode): Promise<{}>;
1473
+ /**
1474
+ * Search visible memory records. When memoryLinking is enabled, includes one bounded hop of L1 evidence and typed links between returned records. Historical facts remain visible.
1475
+ *
1476
+ * @param {string} params.query - Search query. May be omitted with media.
1477
+ * @param {string} params.searchMode - Recall mode override.
1478
+ * @param {object} params.retrieval - Recall route overrides. sparse=false skips model-generated sparse recall for this request; omitted defaults to the project setting.
1479
+ * @param {object} params.media - Optional Storage image reference {bucketId, fileId}. Accepts one PNG, JPEG or WebP up to 8 MiB. Requires files.read and configured vision routing; parsed text is used for retrieval without writing a memory.
1480
+ * @param {string} params.userId - Target user ID.
1481
+ * @param {string} params.agentId - Agent ID filter.
1482
+ * @param {string} params.runId - Run ID filter.
1483
+ * @param {string} params.scope - Scope filter.
1484
+ * @param {string} params.memoryType - Memory type filter.
1485
+ * @param {string} params.recordKind - Record kind filter.
1486
+ * @param {object} params.filter - Structured memory filter.
1487
+ * @param {object} params.temporal - Optional mode current, asOf or history; asOf requires a timestamp with timezone. Uncertain facts are returned separately.
1488
+ * @param {number} params.limit - Maximum results; zero uses the project default.
1489
+ * @param {string} params.cursor - Pagination cursor.
1490
+ * @param {string} params.sort - Sort mode.
1491
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1492
+ * @param {string} params.sessionId - Session ID filter.
1493
+ * @param {string} params.groupId - Group or entity boundary filter.
1494
+ * @param {MemoryAccessMode} params.accessMode - Use owned for owner-filtered compatibility or accessible for the authorized visibility union.
1495
+ * @throws {AgentbaseException}
1496
+ * @returns {Promise<{}>}
1497
+ */
1498
+ search(params?: {
1499
+ query?: string;
1500
+ searchMode?: string;
1501
+ retrieval?: object;
1502
+ media?: object;
1503
+ userId?: string;
1504
+ agentId?: string;
1505
+ runId?: string;
1506
+ scope?: string;
1507
+ memoryType?: string;
1508
+ recordKind?: string;
1509
+ filter?: object;
1510
+ temporal?: object;
1511
+ limit?: number;
1512
+ cursor?: string;
1513
+ sort?: string;
1514
+ memorySubStoreId?: string;
1515
+ sessionId?: string;
1516
+ groupId?: string;
1517
+ accessMode?: MemoryAccessMode;
1518
+ }): Promise<{}>;
1519
+ /**
1520
+ * Search visible memory records. When memoryLinking is enabled, includes one bounded hop of L1 evidence and typed links between returned records. Historical facts remain visible.
1521
+ *
1522
+ * @param {string} query - Search query. May be omitted with media.
1523
+ * @param {string} searchMode - Recall mode override.
1524
+ * @param {object} retrieval - Recall route overrides. sparse=false skips model-generated sparse recall for this request; omitted defaults to the project setting.
1525
+ * @param {object} media - Optional Storage image reference {bucketId, fileId}. Accepts one PNG, JPEG or WebP up to 8 MiB. Requires files.read and configured vision routing; parsed text is used for retrieval without writing a memory.
1526
+ * @param {string} userId - Target user ID.
1527
+ * @param {string} agentId - Agent ID filter.
1528
+ * @param {string} runId - Run ID filter.
1529
+ * @param {string} scope - Scope filter.
1530
+ * @param {string} memoryType - Memory type filter.
1531
+ * @param {string} recordKind - Record kind filter.
1532
+ * @param {object} filter - Structured memory filter.
1533
+ * @param {object} temporal - Optional mode current, asOf or history; asOf requires a timestamp with timezone. Uncertain facts are returned separately.
1534
+ * @param {number} limit - Maximum results; zero uses the project default.
1535
+ * @param {string} cursor - Pagination cursor.
1536
+ * @param {string} sort - Sort mode.
1537
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1538
+ * @param {string} sessionId - Session ID filter.
1539
+ * @param {string} groupId - Group or entity boundary filter.
1540
+ * @param {MemoryAccessMode} accessMode - Use owned for owner-filtered compatibility or accessible for the authorized visibility union.
1541
+ * @throws {AgentbaseException}
1542
+ * @returns {Promise<{}>}
1543
+ * @deprecated Use the object parameter style method for a better developer experience.
1544
+ */
1545
+ search(query?: string, searchMode?: string, retrieval?: object, media?: object, userId?: string, agentId?: string, runId?: string, scope?: string, memoryType?: string, recordKind?: string, filter?: object, temporal?: object, limit?: number, cursor?: string, sort?: string, memorySubStoreId?: string, sessionId?: string, groupId?: string, accessMode?: MemoryAccessMode): Promise<{}>;
1546
+ /**
1547
+ * Get memory session aggregates.
1548
+ *
1549
+ * @throws {AgentbaseException}
1550
+ * @returns {Promise<{}>}
1551
+ */
1552
+ getSessions(): Promise<{}>;
1553
+ /**
1554
+ * List active verified Skills.
1555
+ *
1556
+ * @param {Scope} params.scope - Knowledge ownership scope.
1557
+ * @param {string} params.userId - Target user ID.
1558
+ * @param {string} params.agentId - Agent ID for agent scope.
1559
+ * @param {string} params.sessionId - Source session ID.
1560
+ * @param {string} params.runId - Source run ID.
1561
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1562
+ * @param {string} params.cursor - Opaque pagination cursor.
1563
+ * @param {number} params.limit - Maximum number of Skills.
1564
+ * @throws {AgentbaseException}
1565
+ * @returns {Promise<{}>}
1566
+ */
1567
+ listSkills(params?: {
1568
+ scope?: Scope;
1569
+ userId?: string;
1570
+ agentId?: string;
1571
+ sessionId?: string;
1572
+ runId?: string;
1573
+ memorySubStoreId?: string;
1574
+ cursor?: string;
1575
+ limit?: number;
1576
+ }): Promise<{}>;
1577
+ /**
1578
+ * List active verified Skills.
1579
+ *
1580
+ * @param {Scope} scope - Knowledge ownership scope.
1581
+ * @param {string} userId - Target user ID.
1582
+ * @param {string} agentId - Agent ID for agent scope.
1583
+ * @param {string} sessionId - Source session ID.
1584
+ * @param {string} runId - Source run ID.
1585
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1586
+ * @param {string} cursor - Opaque pagination cursor.
1587
+ * @param {number} limit - Maximum number of Skills.
1588
+ * @throws {AgentbaseException}
1589
+ * @returns {Promise<{}>}
1590
+ * @deprecated Use the object parameter style method for a better developer experience.
1591
+ */
1592
+ listSkills(scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, cursor?: string, limit?: number): Promise<{}>;
1593
+ /**
1594
+ * Search active verified Skills using configured recall routes.
1595
+ *
1596
+ * @param {string} params.query - Semantic search query.
1597
+ * @param {Scope} params.scope - Knowledge ownership scope.
1598
+ * @param {string} params.userId - Target user ID.
1599
+ * @param {string} params.agentId - Agent ID for agent scope.
1600
+ * @param {string} params.sessionId - Source session ID.
1601
+ * @param {string} params.runId - Source run ID.
1602
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1603
+ * @param {string} params.cursor - Opaque pagination cursor.
1604
+ * @param {number} params.limit - Maximum number of Skills.
1605
+ * @param {object} params.retrieval - Recall route overrides.
1606
+ * @throws {AgentbaseException}
1607
+ * @returns {Promise<{}>}
1608
+ */
1609
+ searchSkills(params: {
1610
+ query: string;
1611
+ scope?: Scope;
1612
+ userId?: string;
1613
+ agentId?: string;
1614
+ sessionId?: string;
1615
+ runId?: string;
1616
+ memorySubStoreId?: string;
1617
+ cursor?: string;
1618
+ limit?: number;
1619
+ retrieval?: object;
1620
+ }): Promise<{}>;
1621
+ /**
1622
+ * Search active verified Skills using configured recall routes.
1623
+ *
1624
+ * @param {string} query - Semantic search query.
1625
+ * @param {Scope} scope - Knowledge ownership scope.
1626
+ * @param {string} userId - Target user ID.
1627
+ * @param {string} agentId - Agent ID for agent scope.
1628
+ * @param {string} sessionId - Source session ID.
1629
+ * @param {string} runId - Source run ID.
1630
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1631
+ * @param {string} cursor - Opaque pagination cursor.
1632
+ * @param {number} limit - Maximum number of Skills.
1633
+ * @param {object} retrieval - Recall route overrides.
1634
+ * @throws {AgentbaseException}
1635
+ * @returns {Promise<{}>}
1636
+ * @deprecated Use the object parameter style method for a better developer experience.
1637
+ */
1638
+ searchSkills(query: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, cursor?: string, limit?: number, retrieval?: object): Promise<{}>;
1639
+ /**
1640
+ * Get an active verified Skill.
1641
+ *
1642
+ * @param {string} params.knowledgeId - Skill knowledge ID.
1643
+ * @param {Scope} params.scope - Knowledge ownership scope.
1644
+ * @param {string} params.userId - Target user ID.
1645
+ * @param {string} params.agentId - Agent ID for agent scope.
1646
+ * @param {string} params.sessionId - Source session ID.
1647
+ * @param {string} params.runId - Source run ID.
1648
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1649
+ * @throws {AgentbaseException}
1650
+ * @returns {Promise<{}>}
1651
+ */
1652
+ getSkill(params: {
1653
+ knowledgeId: string;
1654
+ scope?: Scope;
1655
+ userId?: string;
1656
+ agentId?: string;
1657
+ sessionId?: string;
1658
+ runId?: string;
1659
+ memorySubStoreId?: string;
1660
+ }): Promise<{}>;
1661
+ /**
1662
+ * Get an active verified Skill.
1663
+ *
1664
+ * @param {string} knowledgeId - Skill knowledge ID.
1665
+ * @param {Scope} scope - Knowledge ownership scope.
1666
+ * @param {string} userId - Target user ID.
1667
+ * @param {string} agentId - Agent ID for agent scope.
1668
+ * @param {string} sessionId - Source session ID.
1669
+ * @param {string} runId - Source run ID.
1670
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1671
+ * @throws {AgentbaseException}
1672
+ * @returns {Promise<{}>}
1673
+ * @deprecated Use the object parameter style method for a better developer experience.
1674
+ */
1675
+ getSkill(knowledgeId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string): Promise<{}>;
1676
+ /**
1677
+ * List immutable provenance sources linked to a Skill.
1678
+ *
1679
+ * @param {string} params.knowledgeId - Skill knowledge ID.
1680
+ * @param {Scope} params.scope - Knowledge ownership scope.
1681
+ * @param {string} params.userId - Target user ID.
1682
+ * @param {string} params.agentId - Agent ID for agent scope.
1683
+ * @param {string} params.sessionId - Source session ID.
1684
+ * @param {string} params.runId - Source run ID.
1685
+ * @param {string} params.memorySubStoreId - Bound memory sub-store ID.
1686
+ * @param {string} params.cursor - Opaque pagination cursor.
1687
+ * @param {number} params.limit - Maximum sources.
1688
+ * @throws {AgentbaseException}
1689
+ * @returns {Promise<{}>}
1690
+ */
1691
+ listSkillSources(params: {
1692
+ knowledgeId: string;
1693
+ scope?: Scope;
1694
+ userId?: string;
1695
+ agentId?: string;
1696
+ sessionId?: string;
1697
+ runId?: string;
1698
+ memorySubStoreId?: string;
1699
+ cursor?: string;
1700
+ limit?: number;
1701
+ }): Promise<{}>;
1702
+ /**
1703
+ * List immutable provenance sources linked to a Skill.
1704
+ *
1705
+ * @param {string} knowledgeId - Skill knowledge ID.
1706
+ * @param {Scope} scope - Knowledge ownership scope.
1707
+ * @param {string} userId - Target user ID.
1708
+ * @param {string} agentId - Agent ID for agent scope.
1709
+ * @param {string} sessionId - Source session ID.
1710
+ * @param {string} runId - Source run ID.
1711
+ * @param {string} memorySubStoreId - Bound memory sub-store ID.
1712
+ * @param {string} cursor - Opaque pagination cursor.
1713
+ * @param {number} limit - Maximum sources.
1714
+ * @throws {AgentbaseException}
1715
+ * @returns {Promise<{}>}
1716
+ * @deprecated Use the object parameter style method for a better developer experience.
1717
+ */
1718
+ listSkillSources(knowledgeId: string, scope?: Scope, userId?: string, agentId?: string, sessionId?: string, runId?: string, memorySubStoreId?: string, cursor?: string, limit?: number): Promise<{}>;
1719
+ /**
1720
+ * Get memory statistics visible to the current caller.
1721
+ *
1722
+ * @throws {AgentbaseException}
1723
+ * @returns {Promise<{}>}
1724
+ */
1725
+ getStats(): Promise<{}>;
1726
+ /**
1727
+ * Get a memory activity timeline.
1728
+ *
1729
+ * @throws {AgentbaseException}
1730
+ * @returns {Promise<{}>}
1731
+ */
1732
+ getTimeline(): Promise<{}>;
1733
+ /**
1734
+ * Get a user memory profile.
1735
+ *
1736
+ * @param {string} params.userId - Target user ID.
1737
+ * @param {ProfileType} params.profileType - Profile type.
1738
+ * @throws {AgentbaseException}
1739
+ * @returns {Promise<{}>}
1740
+ */
1741
+ getProfile(params: {
1742
+ userId: string;
1743
+ profileType?: ProfileType;
1744
+ }): Promise<{}>;
1745
+ /**
1746
+ * Get a user memory profile.
1747
+ *
1748
+ * @param {string} userId - Target user ID.
1749
+ * @param {ProfileType} profileType - Profile type.
1750
+ * @throws {AgentbaseException}
1751
+ * @returns {Promise<{}>}
1752
+ * @deprecated Use the object parameter style method for a better developer experience.
1753
+ */
1754
+ getProfile(userId: string, profileType?: ProfileType): Promise<{}>;
1755
+ /**
1756
+ * Delete a user memory profile and its derived provenance.
1757
+ *
1758
+ * @param {string} params.userId - Target user ID.
1759
+ * @param {ProfileType} params.profileType - Profile type.
1760
+ * @param {string} params.reason - Profile deletion reason.
1761
+ * @param {string} params.source - Profile deletion source.
1762
+ * @throws {AgentbaseException}
1763
+ * @returns {Promise<{}>}
1764
+ */
1765
+ deleteProfile(params: {
1766
+ userId: string;
1767
+ profileType?: ProfileType;
1768
+ reason?: string;
1769
+ source?: string;
1770
+ }): Promise<{}>;
1771
+ /**
1772
+ * Delete a user memory profile and its derived provenance.
1773
+ *
1774
+ * @param {string} userId - Target user ID.
1775
+ * @param {ProfileType} profileType - Profile type.
1776
+ * @param {string} reason - Profile deletion reason.
1777
+ * @param {string} source - Profile deletion source.
1778
+ * @throws {AgentbaseException}
1779
+ * @returns {Promise<{}>}
1780
+ * @deprecated Use the object parameter style method for a better developer experience.
1781
+ */
1782
+ deleteProfile(userId: string, profileType?: ProfileType, reason?: string, source?: string): Promise<{}>;
1783
+ /**
1784
+ * Create a user memory profile extraction.
1785
+ *
1786
+ * @param {string} params.userId - Target user ID.
1787
+ * @param {string} params.pipelineId - Optional published Pipeline ID for this scenario. Omit to use its default.
1788
+ * @param {ProfileType} params.profileType - Profile type.
1789
+ * @param {Models.MemoryMessage[]} params.messages - Typed role/content messages used as source evidence.
1790
+ * @param {string[]} params.sourceMemoryIds - Existing memory IDs used as replacement evidence.
1791
+ * @param {string} params.sessionId - Optional conversation ID used to correlate profile extraction observability.
1792
+ * @param {ProfileExtractionMode} params.mode - Incrementally update or replace the profile.
1793
+ * @throws {AgentbaseException}
1794
+ * @returns {Promise<{}>}
1795
+ */
1796
+ createProfileExtraction(params: {
1797
+ userId: string;
1798
+ pipelineId?: string;
1799
+ profileType?: ProfileType;
1800
+ messages?: Models.MemoryMessage[];
1801
+ sourceMemoryIds?: string[];
1802
+ sessionId?: string;
1803
+ mode?: ProfileExtractionMode;
1804
+ }): Promise<{}>;
1805
+ /**
1806
+ * Create a user memory profile extraction.
1807
+ *
1808
+ * @param {string} userId - Target user ID.
1809
+ * @param {string} pipelineId - Optional published Pipeline ID for this scenario. Omit to use its default.
1810
+ * @param {ProfileType} profileType - Profile type.
1811
+ * @param {Models.MemoryMessage[]} messages - Typed role/content messages used as source evidence.
1812
+ * @param {string[]} sourceMemoryIds - Existing memory IDs used as replacement evidence.
1813
+ * @param {string} sessionId - Optional conversation ID used to correlate profile extraction observability.
1814
+ * @param {ProfileExtractionMode} mode - Incrementally update or replace the profile.
1815
+ * @throws {AgentbaseException}
1816
+ * @returns {Promise<{}>}
1817
+ * @deprecated Use the object parameter style method for a better developer experience.
1818
+ */
1819
+ createProfileExtraction(userId: string, pipelineId?: string, profileType?: ProfileType, messages?: Models.MemoryMessage[], sourceMemoryIds?: string[], sessionId?: string, mode?: ProfileExtractionMode): Promise<{}>;
1820
+ /**
1821
+ * Create a user memory profile rebuild.
1822
+ *
1823
+ * @param {string} params.userId - Target user ID.
1824
+ * @param {string} params.pipelineId - Optional published Pipeline ID for this scenario. Omit to use its default.
1825
+ * @param {ProfileType} params.profileType - Profile type.
1826
+ * @throws {AgentbaseException}
1827
+ * @returns {Promise<{}>}
1828
+ */
1829
+ createProfileRebuild(params: {
1830
+ userId: string;
1831
+ pipelineId?: string;
1832
+ profileType?: ProfileType;
1833
+ }): Promise<{}>;
1834
+ /**
1835
+ * Create a user memory profile rebuild.
1836
+ *
1837
+ * @param {string} userId - Target user ID.
1838
+ * @param {string} pipelineId - Optional published Pipeline ID for this scenario. Omit to use its default.
1839
+ * @param {ProfileType} profileType - Profile type.
1840
+ * @throws {AgentbaseException}
1841
+ * @returns {Promise<{}>}
1842
+ * @deprecated Use the object parameter style method for a better developer experience.
1843
+ */
1844
+ createProfileRebuild(userId: string, pipelineId?: string, profileType?: ProfileType): Promise<{}>;
1845
+ /**
1846
+ * List the sources for a user memory profile.
1847
+ *
1848
+ * @param {string} params.userId - Target user ID.
1849
+ * @param {ProfileType} params.profileType - Profile type.
1850
+ * @throws {AgentbaseException}
1851
+ * @returns {Promise<{}>}
1852
+ */
1853
+ listProfileSources(params: {
1854
+ userId: string;
1855
+ profileType?: ProfileType;
1856
+ }): Promise<{}>;
1857
+ /**
1858
+ * List the sources for a user memory profile.
1859
+ *
1860
+ * @param {string} userId - Target user ID.
1861
+ * @param {ProfileType} profileType - Profile type.
1862
+ * @throws {AgentbaseException}
1863
+ * @returns {Promise<{}>}
1864
+ * @deprecated Use the object parameter style method for a better developer experience.
1865
+ */
1866
+ listProfileSources(userId: string, profileType?: ProfileType): Promise<{}>;
1867
+ /**
1868
+ * Get a memory record by its unique ID.
1869
+ *
1870
+ * @param {string} params.memoryId - Memory unique ID.
1871
+ * @throws {AgentbaseException}
1872
+ * @returns {Promise<{}>}
1873
+ */
1874
+ get(params: {
1875
+ memoryId: string;
1876
+ }): Promise<{}>;
1877
+ /**
1878
+ * Get a memory record by its unique ID.
1879
+ *
1880
+ * @param {string} memoryId - Memory unique ID.
1881
+ * @throws {AgentbaseException}
1882
+ * @returns {Promise<{}>}
1883
+ * @deprecated Use the object parameter style method for a better developer experience.
1884
+ */
1885
+ get(memoryId: string): Promise<{}>;
1886
+ /**
1887
+ * Update a memory record by its unique ID.
1888
+ *
1889
+ * @param {string} params.memoryId - Memory unique ID.
1890
+ * @param {number} params.version - Expected current memory version.
1891
+ * @param {string} params.content - Updated memory text.
1892
+ * @param {object} params.metadata - Metadata merge patch.
1893
+ * @param {RetentionPolicy} params.retentionPolicy - Retention policy.
1894
+ * @throws {AgentbaseException}
1895
+ * @returns {Promise<{}>}
1896
+ */
1897
+ update(params: {
1898
+ memoryId: string;
1899
+ version: number;
1900
+ content?: string;
1901
+ metadata?: object;
1902
+ retentionPolicy?: RetentionPolicy;
1903
+ }): Promise<{}>;
1904
+ /**
1905
+ * Update a memory record by its unique ID.
1906
+ *
1907
+ * @param {string} memoryId - Memory unique ID.
1908
+ * @param {number} version - Expected current memory version.
1909
+ * @param {string} content - Updated memory text.
1910
+ * @param {object} metadata - Metadata merge patch.
1911
+ * @param {RetentionPolicy} retentionPolicy - Retention policy.
1912
+ * @throws {AgentbaseException}
1913
+ * @returns {Promise<{}>}
1914
+ * @deprecated Use the object parameter style method for a better developer experience.
1915
+ */
1916
+ update(memoryId: string, version: number, content?: string, metadata?: object, retentionPolicy?: RetentionPolicy): Promise<{}>;
1917
+ /**
1918
+ * Delete a memory record by its unique ID.
1919
+ *
1920
+ * @param {string} params.memoryId - Memory unique ID.
1921
+ * @param {string} params.memorySubStoreId - Memory sub-store for erasure.
1922
+ * @param {string} params.reason - Forgetting reason.
1923
+ * @param {string} params.source - Forgetting source.
1924
+ * @throws {AgentbaseException}
1925
+ * @returns {Promise<{}>}
1926
+ */
1927
+ delete(params: {
1928
+ memoryId: string;
1929
+ memorySubStoreId?: string;
1930
+ reason?: string;
1931
+ source?: string;
1932
+ }): Promise<{}>;
1933
+ /**
1934
+ * Delete a memory record by its unique ID.
1935
+ *
1936
+ * @param {string} memoryId - Memory unique ID.
1937
+ * @param {string} memorySubStoreId - Memory sub-store for erasure.
1938
+ * @param {string} reason - Forgetting reason.
1939
+ * @param {string} source - Forgetting source.
1940
+ * @throws {AgentbaseException}
1941
+ * @returns {Promise<{}>}
1942
+ * @deprecated Use the object parameter style method for a better developer experience.
1943
+ */
1944
+ delete(memoryId: string, memorySubStoreId?: string, reason?: string, source?: string): Promise<{}>;
1945
+ /**
1946
+ * List active read grants for one memory.
1947
+ *
1948
+ * @param {string} params.memoryId - Memory unique ID.
1949
+ * @throws {AgentbaseException}
1950
+ * @returns {Promise<{}>}
1951
+ */
1952
+ listShares(params: {
1953
+ memoryId: string;
1954
+ }): Promise<{}>;
1955
+ /**
1956
+ * List active read grants for one memory.
1957
+ *
1958
+ * @param {string} memoryId - Memory unique ID.
1959
+ * @throws {AgentbaseException}
1960
+ * @returns {Promise<{}>}
1961
+ * @deprecated Use the object parameter style method for a better developer experience.
1962
+ */
1963
+ listShares(memoryId: string): Promise<{}>;
1964
+ /**
1965
+ * Grant read access to one memory for a user or group.
1966
+ *
1967
+ * @param {string} params.memoryId - Memory unique ID.
1968
+ * @param {MemoryShareSubjectType} params.subjectType - Share subject type.
1969
+ * @param {string} params.subjectId - Share subject ID.
1970
+ * @param {string} params.expiresAt - Optional RFC3339 expiration, at most 365 days in the future.
1971
+ * @throws {AgentbaseException}
1972
+ * @returns {Promise<{}>}
1973
+ */
1974
+ createShare(params: {
1975
+ memoryId: string;
1976
+ subjectType: MemoryShareSubjectType;
1977
+ subjectId: string;
1978
+ expiresAt?: string;
1979
+ }): Promise<{}>;
1980
+ /**
1981
+ * Grant read access to one memory for a user or group.
1982
+ *
1983
+ * @param {string} memoryId - Memory unique ID.
1984
+ * @param {MemoryShareSubjectType} subjectType - Share subject type.
1985
+ * @param {string} subjectId - Share subject ID.
1986
+ * @param {string} expiresAt - Optional RFC3339 expiration, at most 365 days in the future.
1987
+ * @throws {AgentbaseException}
1988
+ * @returns {Promise<{}>}
1989
+ * @deprecated Use the object parameter style method for a better developer experience.
1990
+ */
1991
+ createShare(memoryId: string, subjectType: MemoryShareSubjectType, subjectId: string, expiresAt?: string): Promise<{}>;
1992
+ /**
1993
+ * Revoke one memory read grant.
1994
+ *
1995
+ * @param {string} params.memoryId - Memory unique ID.
1996
+ * @param {string} params.shareId - Stable share ID.
1997
+ * @throws {AgentbaseException}
1998
+ * @returns {Promise<{}>}
1999
+ */
2000
+ deleteShare(params: {
2001
+ memoryId: string;
2002
+ shareId: string;
2003
+ }): Promise<{}>;
2004
+ /**
2005
+ * Revoke one memory read grant.
2006
+ *
2007
+ * @param {string} memoryId - Memory unique ID.
2008
+ * @param {string} shareId - Stable share ID.
2009
+ * @throws {AgentbaseException}
2010
+ * @returns {Promise<{}>}
2011
+ * @deprecated Use the object parameter style method for a better developer experience.
2012
+ */
2013
+ deleteShare(memoryId: string, shareId: string): Promise<{}>;
2014
+ /**
2015
+ * List immutable provenance sources linked to a Memory record.
2016
+ *
2017
+ * @param {string} params.memoryId - Memory ID.
2018
+ * @param {string} params.cursor - Opaque pagination cursor.
2019
+ * @param {number} params.limit - Maximum sources.
2020
+ * @throws {AgentbaseException}
2021
+ * @returns {Promise<{}>}
2022
+ */
2023
+ listSources(params: {
2024
+ memoryId: string;
2025
+ cursor?: string;
2026
+ limit?: number;
2027
+ }): Promise<{}>;
2028
+ /**
2029
+ * List immutable provenance sources linked to a Memory record.
2030
+ *
2031
+ * @param {string} memoryId - Memory ID.
2032
+ * @param {string} cursor - Opaque pagination cursor.
2033
+ * @param {number} limit - Maximum sources.
2034
+ * @throws {AgentbaseException}
2035
+ * @returns {Promise<{}>}
2036
+ * @deprecated Use the object parameter style method for a better developer experience.
2037
+ */
2038
+ listSources(memoryId: string, cursor?: string, limit?: number): Promise<{}>;
2039
+ /**
2040
+ * List Pipeline trial runs in the current project and scenario.
2041
+ *
2042
+ * @param {Scenario} params.scenario - Pipeline scenario.
2043
+ * @param {number} params.limit - Maximum number of trial runs.
2044
+ * @param {string} params.cursor - Opaque pagination cursor.
2045
+ * @throws {AgentbaseException}
2046
+ * @returns {Promise<Models.MemoryPipelineRunList>}
2047
+ */
2048
+ listPipelineRuns(params?: {
2049
+ scenario?: Scenario;
2050
+ limit?: number;
2051
+ cursor?: string;
2052
+ }): Promise<Models.MemoryPipelineRunList>;
2053
+ /**
2054
+ * List Pipeline trial runs in the current project and scenario.
2055
+ *
2056
+ * @param {Scenario} scenario - Pipeline scenario.
2057
+ * @param {number} limit - Maximum number of trial runs.
2058
+ * @param {string} cursor - Opaque pagination cursor.
2059
+ * @throws {AgentbaseException}
2060
+ * @returns {Promise<Models.MemoryPipelineRunList>}
2061
+ * @deprecated Use the object parameter style method for a better developer experience.
2062
+ */
2063
+ listPipelineRuns(scenario?: Scenario, limit?: number, cursor?: string): Promise<Models.MemoryPipelineRunList>;
2064
+ /**
2065
+ * Compare saved Pipeline versions against bounded samples without business writes. Candidate configurations and sample inputs are frozen when the run is accepted.
2066
+ *
2067
+ * @param {string} params.name - Trial run name, from 1 to 256 UTF-8 bytes after trimming.
2068
+ * @param {Scenario} params.scenario - Shared scenario of all candidates.
2069
+ * @param {object[]} params.candidates - One to eight objects containing pipelineId and saved versionId.
2070
+ * @param {object[]} params.samples - One to twenty objects containing a unique id and scenario-specific data object.
2071
+ * @throws {AgentbaseException}
2072
+ * @returns {Promise<Models.MemoryPipelineRun>}
2073
+ */
2074
+ createPipelineRun(params: {
2075
+ name: string;
2076
+ scenario: Scenario;
2077
+ candidates: object[];
2078
+ samples: object[];
2079
+ }): Promise<Models.MemoryPipelineRun>;
2080
+ /**
2081
+ * Compare saved Pipeline versions against bounded samples without business writes. Candidate configurations and sample inputs are frozen when the run is accepted.
2082
+ *
2083
+ * @param {string} name - Trial run name, from 1 to 256 UTF-8 bytes after trimming.
2084
+ * @param {Scenario} scenario - Shared scenario of all candidates.
2085
+ * @param {object[]} candidates - One to eight objects containing pipelineId and saved versionId.
2086
+ * @param {object[]} samples - One to twenty objects containing a unique id and scenario-specific data object.
2087
+ * @throws {AgentbaseException}
2088
+ * @returns {Promise<Models.MemoryPipelineRun>}
2089
+ * @deprecated Use the object parameter style method for a better developer experience.
2090
+ */
2091
+ createPipelineRun(name: string, scenario: Scenario, candidates: object[], samples: object[]): Promise<Models.MemoryPipelineRun>;
2092
+ /**
2093
+ * Read the frozen inputs, progress, and per-sample results of a Pipeline trial run.
2094
+ *
2095
+ * @param {string} params.runId - Trial run ID.
2096
+ * @throws {AgentbaseException}
2097
+ * @returns {Promise<Models.MemoryPipelineRun>}
2098
+ */
2099
+ getPipelineRun(params: {
2100
+ runId: string;
2101
+ }): Promise<Models.MemoryPipelineRun>;
2102
+ /**
2103
+ * Read the frozen inputs, progress, and per-sample results of a Pipeline trial run.
2104
+ *
2105
+ * @param {string} runId - Trial run ID.
2106
+ * @throws {AgentbaseException}
2107
+ * @returns {Promise<Models.MemoryPipelineRun>}
2108
+ * @deprecated Use the object parameter style method for a better developer experience.
2109
+ */
2110
+ getPipelineRun(runId: string): Promise<Models.MemoryPipelineRun>;
2111
+ /**
2112
+ * Configure Memory Pipelines.
2113
+ *
2114
+ * @param {Scenario} params.scenario - Pipeline scenario. Each scenario has its own default.
2115
+ * @throws {AgentbaseException}
2116
+ * @returns {Promise<{}>}
2117
+ */
2118
+ listPipelines(params?: {
2119
+ scenario?: Scenario;
2120
+ }): Promise<{}>;
2121
+ /**
2122
+ * Configure Memory Pipelines.
2123
+ *
2124
+ * @param {Scenario} scenario - Pipeline scenario. Each scenario has its own default.
2125
+ * @throws {AgentbaseException}
2126
+ * @returns {Promise<{}>}
2127
+ * @deprecated Use the object parameter style method for a better developer experience.
2128
+ */
2129
+ listPipelines(scenario?: Scenario): Promise<{}>;
2130
+ /**
2131
+ * Configure Memory Pipelines.
2132
+ *
2133
+ * @param {Scenario} params.scenario - Pipeline scenario. Each scenario has its own default.
2134
+ * @param {boolean} params.fromDefaults - Create with current default step parameters.
2135
+ * @param {object} params.config - Ordered step configurations for the selected scenario.
2136
+ * @throws {AgentbaseException}
2137
+ * @returns {Promise<{}>}
2138
+ */
2139
+ createPipeline(params?: {
2140
+ scenario?: Scenario;
2141
+ fromDefaults?: boolean;
2142
+ config?: object;
2143
+ }): Promise<{}>;
2144
+ /**
2145
+ * Configure Memory Pipelines.
2146
+ *
2147
+ * @param {Scenario} scenario - Pipeline scenario. Each scenario has its own default.
2148
+ * @param {boolean} fromDefaults - Create with current default step parameters.
2149
+ * @param {object} config - Ordered step configurations for the selected scenario.
2150
+ * @throws {AgentbaseException}
2151
+ * @returns {Promise<{}>}
2152
+ * @deprecated Use the object parameter style method for a better developer experience.
2153
+ */
2154
+ createPipeline(scenario?: Scenario, fromDefaults?: boolean, config?: object): Promise<{}>;
2155
+ /**
2156
+ * Configure Memory Pipelines.
2157
+ *
2158
+ * @param {Scenario} params.scenario - Pipeline scenario. Each scenario has its own default.
2159
+ * @param {string} params.pipelineId - Published Pipeline ID, or null to restore the system default.
2160
+ * @param {number} params.expectedRevision - Revision from the reviewed Pipeline. Required when pipelineId is not null.
2161
+ * @throws {AgentbaseException}
2162
+ * @returns {Promise<{}>}
2163
+ */
2164
+ setDefaultPipeline(params?: {
2165
+ scenario?: Scenario;
2166
+ pipelineId?: string;
2167
+ expectedRevision?: number;
2168
+ }): Promise<{}>;
2169
+ /**
2170
+ * Configure Memory Pipelines.
2171
+ *
2172
+ * @param {Scenario} scenario - Pipeline scenario. Each scenario has its own default.
2173
+ * @param {string} pipelineId - Published Pipeline ID, or null to restore the system default.
2174
+ * @param {number} expectedRevision - Revision from the reviewed Pipeline. Required when pipelineId is not null.
2175
+ * @throws {AgentbaseException}
2176
+ * @returns {Promise<{}>}
2177
+ * @deprecated Use the object parameter style method for a better developer experience.
2178
+ */
2179
+ setDefaultPipeline(scenario?: Scenario, pipelineId?: string, expectedRevision?: number): Promise<{}>;
2180
+ /**
2181
+ * Configure a Memory Pipeline.
2182
+ *
2183
+ * @param {string} params.pipelineId - Pipeline ID.
2184
+ * @throws {AgentbaseException}
2185
+ * @returns {Promise<{}>}
2186
+ */
2187
+ getPipeline(params: {
2188
+ pipelineId: string;
2189
+ }): Promise<{}>;
2190
+ /**
2191
+ * Configure a Memory Pipeline.
2192
+ *
2193
+ * @param {string} pipelineId - Pipeline ID.
2194
+ * @throws {AgentbaseException}
2195
+ * @returns {Promise<{}>}
2196
+ * @deprecated Use the object parameter style method for a better developer experience.
2197
+ */
2198
+ getPipeline(pipelineId: string): Promise<{}>;
2199
+ /**
2200
+ * Configure a Memory Pipeline.
2201
+ *
2202
+ * @param {string} params.pipelineId - Pipeline ID.
2203
+ * @param {number} params.expectedRevision - Expected editing revision.
2204
+ * @param {object} params.config - Complete Pipeline configuration.
2205
+ * @throws {AgentbaseException}
2206
+ * @returns {Promise<{}>}
2207
+ */
2208
+ updatePipeline(params: {
2209
+ pipelineId: string;
2210
+ expectedRevision: number;
2211
+ config: object;
2212
+ }): Promise<{}>;
2213
+ /**
2214
+ * Configure a Memory Pipeline.
2215
+ *
2216
+ * @param {string} pipelineId - Pipeline ID.
2217
+ * @param {number} expectedRevision - Expected editing revision.
2218
+ * @param {object} config - Complete Pipeline configuration.
2219
+ * @throws {AgentbaseException}
2220
+ * @returns {Promise<{}>}
2221
+ * @deprecated Use the object parameter style method for a better developer experience.
2222
+ */
2223
+ updatePipeline(pipelineId: string, expectedRevision: number, config: object): Promise<{}>;
2224
+ /**
2225
+ * Delete a Memory Pipeline. Accepted tasks and existing business data are kept.
2226
+ *
2227
+ * @param {string} params.pipelineId - Pipeline ID.
2228
+ * @param {number} params.expectedRevision - Expected editing revision.
2229
+ * @throws {AgentbaseException}
2230
+ * @returns {Promise<{}>}
2231
+ */
2232
+ deletePipeline(params: {
2233
+ pipelineId: string;
2234
+ expectedRevision: number;
2235
+ }): Promise<{}>;
2236
+ /**
2237
+ * Delete a Memory Pipeline. Accepted tasks and existing business data are kept.
2238
+ *
2239
+ * @param {string} pipelineId - Pipeline ID.
2240
+ * @param {number} expectedRevision - Expected editing revision.
2241
+ * @throws {AgentbaseException}
2242
+ * @returns {Promise<{}>}
2243
+ * @deprecated Use the object parameter style method for a better developer experience.
2244
+ */
2245
+ deletePipeline(pipelineId: string, expectedRevision: number): Promise<{}>;
2246
+ /**
2247
+ * Configure a Memory Pipeline.
2248
+ *
2249
+ * @param {string} params.pipelineId - Pipeline ID.
2250
+ * @param {string} params.versionId - Saved configuration version.
2251
+ * @param {number} params.expectedRevision - Expected editing revision.
2252
+ * @param {boolean} params.makeDefault - Make this the project default when publishing.
2253
+ * @throws {AgentbaseException}
2254
+ * @returns {Promise<{}>}
2255
+ */
2256
+ publishPipeline(params: {
2257
+ pipelineId: string;
2258
+ versionId: string;
2259
+ expectedRevision: number;
2260
+ makeDefault?: boolean;
2261
+ }): Promise<{}>;
2262
+ /**
2263
+ * Configure a Memory Pipeline.
2264
+ *
2265
+ * @param {string} pipelineId - Pipeline ID.
2266
+ * @param {string} versionId - Saved configuration version.
2267
+ * @param {number} expectedRevision - Expected editing revision.
2268
+ * @param {boolean} makeDefault - Make this the project default when publishing.
2269
+ * @throws {AgentbaseException}
2270
+ * @returns {Promise<{}>}
2271
+ * @deprecated Use the object parameter style method for a better developer experience.
2272
+ */
2273
+ publishPipeline(pipelineId: string, versionId: string, expectedRevision: number, makeDefault?: boolean): Promise<{}>;
2274
+ /**
2275
+ * Configure a Memory Pipeline.
2276
+ *
2277
+ * @param {string} params.pipelineId - Pipeline ID.
2278
+ * @param {string} params.versionId - Previously published version.
2279
+ * @param {number} params.expectedRevision - Expected editing revision.
2280
+ * @throws {AgentbaseException}
2281
+ * @returns {Promise<{}>}
2282
+ */
2283
+ rollbackPipeline(params: {
2284
+ pipelineId: string;
2285
+ versionId: string;
2286
+ expectedRevision: number;
2287
+ }): Promise<{}>;
2288
+ /**
2289
+ * Configure a Memory Pipeline.
2290
+ *
2291
+ * @param {string} pipelineId - Pipeline ID.
2292
+ * @param {string} versionId - Previously published version.
2293
+ * @param {number} expectedRevision - Expected editing revision.
2294
+ * @throws {AgentbaseException}
2295
+ * @returns {Promise<{}>}
2296
+ * @deprecated Use the object parameter style method for a better developer experience.
2297
+ */
2298
+ rollbackPipeline(pipelineId: string, versionId: string, expectedRevision: number): Promise<{}>;
2299
+ /**
2300
+ * Validate a Memory Pipeline.
2301
+ *
2302
+ * @param {string} params.pipelineId - Pipeline ID.
2303
+ * @param {string} params.versionId - Saved configuration version or current system default hash.
2304
+ * @param {object} params.data - Sample input for the Pipeline scenario, evaluated without business writes.
2305
+ * @param {Scenario} params.scenario - Scenario for system default validation.
2306
+ * @throws {AgentbaseException}
2307
+ * @returns {Promise<{}>}
2308
+ */
2309
+ validatePipeline(params: {
2310
+ pipelineId: string;
2311
+ versionId: string;
2312
+ data: object;
2313
+ scenario?: Scenario;
2314
+ }): Promise<{}>;
2315
+ /**
2316
+ * Validate a Memory Pipeline.
2317
+ *
2318
+ * @param {string} pipelineId - Pipeline ID.
2319
+ * @param {string} versionId - Saved configuration version or current system default hash.
2320
+ * @param {object} data - Sample input for the Pipeline scenario, evaluated without business writes.
2321
+ * @param {Scenario} scenario - Scenario for system default validation.
2322
+ * @throws {AgentbaseException}
2323
+ * @returns {Promise<{}>}
2324
+ * @deprecated Use the object parameter style method for a better developer experience.
2325
+ */
2326
+ validatePipeline(pipelineId: string, versionId: string, data: object, scenario?: Scenario): Promise<{}>;
2327
+ /**
2328
+ * Configure a Memory Pipeline.
2329
+ *
2330
+ * @param {string} params.pipelineId - Pipeline ID.
2331
+ * @param {string} params.versionId - Optional exact configuration version, including retained history after Pipeline deletion.
2332
+ * @param {number | bigint} params.beforeRevision - Load versions older than this revision; omit for the newest 100 versions.
2333
+ * @throws {AgentbaseException}
2334
+ * @returns {Promise<{}>}
2335
+ */
2336
+ listPipelineVersions(params: {
2337
+ pipelineId: string;
2338
+ versionId?: string;
2339
+ beforeRevision?: number | bigint;
2340
+ }): Promise<{}>;
2341
+ /**
2342
+ * Configure a Memory Pipeline.
2343
+ *
2344
+ * @param {string} pipelineId - Pipeline ID.
2345
+ * @param {string} versionId - Optional exact configuration version, including retained history after Pipeline deletion.
2346
+ * @param {number | bigint} beforeRevision - Load versions older than this revision; omit for the newest 100 versions.
2347
+ * @throws {AgentbaseException}
2348
+ * @returns {Promise<{}>}
2349
+ * @deprecated Use the object parameter style method for a better developer experience.
2350
+ */
2351
+ listPipelineVersions(pipelineId: string, versionId?: string, beforeRevision?: number | bigint): Promise<{}>;
2352
+ }