@databricks/sdk-agentkit 0.0.0-stage → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,620 @@
1
+ import { Temporal } from "@js-temporal/polyfill";
2
+ import { FieldMask, JsonValue } from "@databricks/sdk-core/wkt";
3
+ import { z } from "zod";
4
+
5
+ //#region src/v1/model.d.ts
6
+ /** Identifies the source that created a memory entry. */
7
+ declare const ManagedMemoryEntrySourceType: {
8
+ /** The memory entry was created by an agent during a live conversation. */readonly MANAGED_MEMORY_ENTRY_SOURCE_TYPE_AGENT: "MANAGED_MEMORY_ENTRY_SOURCE_TYPE_AGENT"; /** The memory entry was distilled from prior sessions by the dreamer pipeline. */
9
+ readonly MANAGED_MEMORY_ENTRY_SOURCE_TYPE_DREAMER: "MANAGED_MEMORY_ENTRY_SOURCE_TYPE_DREAMER";
10
+ };
11
+ type ManagedMemoryEntrySourceType = (typeof ManagedMemoryEntrySourceType)[keyof typeof ManagedMemoryEntrySourceType] | (string & {});
12
+ /** Controls how much memory entry data is returned. */
13
+ declare const ManagedMemoryEntryView: {
14
+ /** Default view. Returns all entry fields, including `content`. */readonly MANAGED_MEMORY_ENTRY_VIEW_UNSPECIFIED: "MANAGED_MEMORY_ENTRY_VIEW_UNSPECIFIED"; /** Returns entry metadata without `content`. */
15
+ readonly MANAGED_MEMORY_ENTRY_VIEW_BASIC: "MANAGED_MEMORY_ENTRY_VIEW_BASIC"; /** Returns all entry fields, including `content`. */
16
+ readonly MANAGED_MEMORY_ENTRY_VIEW_FULL: "MANAGED_MEMORY_ENTRY_VIEW_FULL";
17
+ };
18
+ type ManagedMemoryEntryView = (typeof ManagedMemoryEntryView)[keyof typeof ManagedMemoryEntryView] | (string & {});
19
+ /** Type of service-managed storage backing a memory store. */
20
+ declare const StorageBackendType: {
21
+ /** Default value. Returned when the storage backend type is not set. */readonly STORAGE_BACKEND_TYPE_UNSPECIFIED: "STORAGE_BACKEND_TYPE_UNSPECIFIED"; /** Lakebase-managed storage backing the memory store. */
22
+ readonly STORAGE_BACKEND_TYPE_LAKEBASE: "STORAGE_BACKEND_TYPE_LAKEBASE";
23
+ };
24
+ type StorageBackendType = (typeof StorageBackendType)[keyof typeof StorageBackendType] | (string & {});
25
+ /** Request to append items to a session. */
26
+ interface AppendSessionItemsRequest {
27
+ /**
28
+ * Items to append atomically in request order. Concurrent append requests are serialized into one
29
+ * committed order without exposing a numeric sequence in the public contract.
30
+ */
31
+ items?: SessionItem[] | undefined;
32
+ /**
33
+ * Resource name of the containing session, in the form
34
+ * `session-stores/{session_store_id}/sessions/{session_id}`.
35
+ */
36
+ parent?: string | undefined;
37
+ }
38
+ /** Response containing appended items. */
39
+ interface AppendSessionItemsResponse {
40
+ /** Persisted session items with service-assigned fields. */
41
+ sessionItems?: SessionItem[] | undefined;
42
+ }
43
+ /** Request to clear all items from a session. */
44
+ interface ClearSessionItemsRequest {
45
+ /**
46
+ * Resource name of the containing session, in the form
47
+ * `session-stores/{session_store_id}/sessions/{session_id}`.
48
+ */
49
+ parent?: string | undefined;
50
+ }
51
+ /** Response from clearing items from a session. */
52
+ interface ClearSessionItemsResponse {}
53
+ /** Request to create a memory entry. */
54
+ interface CreateManagedMemoryEntryRequest {
55
+ /**
56
+ * Memory store that will contain the entry, in the form
57
+ * `memory-stores/{managed_memory_store_id}`.
58
+ */
59
+ parent?: string | undefined;
60
+ /** The memory entry to create. */
61
+ managedMemoryEntry?: ManagedMemoryEntry | undefined;
62
+ /** Optional caller-selected memory entry ID. The service generates an ID when omitted. */
63
+ managedMemoryEntryId?: string | undefined;
64
+ }
65
+ /** Request to create a memory store. */
66
+ interface CreateManagedMemoryStoreRequest {
67
+ /** The memory store to create. */
68
+ managedMemoryStore?: ManagedMemoryStore | undefined;
69
+ /**
70
+ * Caller-provided, workspace-unique memory store ID. It must be 3-56 characters, begin
71
+ * with a lowercase letter, contain only lowercase letters, digits, and hyphens, and end with a
72
+ * letter or digit.
73
+ */
74
+ managedMemoryStoreId?: string | undefined;
75
+ }
76
+ /** Request to create a session. */
77
+ interface CreateSessionRequest {
78
+ /**
79
+ * The session to create. `actor_id` is required. A session with `parent_session_id` is a child and
80
+ * must use its parent's `actor_id`. Independent forks are created only through `ForkSession`.
81
+ */
82
+ session?: Session | undefined;
83
+ /**
84
+ * Optional caller-selected session ID. The service generates a UUID when this field is omitted.
85
+ * The ID must be unique; a collision returns `ALREADY_EXISTS`.
86
+ */
87
+ sessionId?: string | undefined;
88
+ /**
89
+ * Resource name of the containing session store, in the form
90
+ * `session-stores/{session_store_id}`.
91
+ */
92
+ parent?: string | undefined;
93
+ }
94
+ /** Request to create a session store. */
95
+ interface CreateSessionStoreRequest {
96
+ /** The session store to create. */
97
+ sessionStore?: SessionStore | undefined;
98
+ /**
99
+ * Caller-provided, workspace-unique session store ID. It must be 3-55 characters, begin with a
100
+ * lowercase letter, and contain only lowercase letters, digits, and hyphens.
101
+ */
102
+ sessionStoreId?: string | undefined;
103
+ }
104
+ /** Request to delete a memory entry by resource name. */
105
+ interface DeleteManagedMemoryEntryRequest {
106
+ /**
107
+ * Resource name in the form
108
+ * `memory-stores/{managed_memory_store_id}/entries/{managed_memory_entry_id}`.
109
+ */
110
+ name?: string | undefined;
111
+ }
112
+ /** Request to delete a memory store by resource name. */
113
+ interface DeleteManagedMemoryStoreRequest {
114
+ /** Resource name in the form `memory-stores/{managed_memory_store_id}`. */
115
+ name?: string | undefined;
116
+ }
117
+ /** Request to delete a session. */
118
+ interface DeleteSessionRequest {
119
+ /**
120
+ * Resource name in the form
121
+ * `session-stores/{session_store_id}/sessions/{session_id}`.
122
+ */
123
+ name?: string | undefined;
124
+ }
125
+ /** Request to delete a session store. */
126
+ interface DeleteSessionStoreRequest {
127
+ /** Resource name in the form `session-stores/{session_store_id}`. */
128
+ name?: string | undefined;
129
+ }
130
+ /** Request to synchronously extract memories from a single session. */
131
+ interface ExtractMemoriesRequest {
132
+ /**
133
+ * Memory store the extracted entries are written to, in the form
134
+ * `memory-stores/{managed_memory_store_id}`.
135
+ */
136
+ memoryStore?: string | undefined;
137
+ /** Session store containing the session, in the form `session-stores/{session_store_id}`. */
138
+ sessionStore?: string | undefined;
139
+ /** Identifier of the session whose transcript is distilled into memories. */
140
+ sessionId?: string | undefined;
141
+ /** Instructions steering what is extracted from the session. */
142
+ instructions?: string | undefined;
143
+ /**
144
+ * When true, extract and return the entries without writing them to the memory store. Defaults
145
+ * to false, which persists the extracted entries and returns them.
146
+ */
147
+ dryRun?: boolean | undefined;
148
+ }
149
+ /** Result of a single-session memory extraction. */
150
+ interface ExtractMemoriesResponse {
151
+ /** Correlation identifier for this extraction, for logging and tracing. Not a fetchable resource. */
152
+ name?: string | undefined;
153
+ /** The memory entries written by this extraction. */
154
+ entries?: ManagedMemoryEntry[] | undefined;
155
+ }
156
+ /** Request to fork a session. */
157
+ interface ForkSessionRequest {
158
+ /** ID of the session to copy. */
159
+ sourceSessionId?: string | undefined;
160
+ /**
161
+ * Optional last item ID to copy through, inclusively. When omitted, the fork atomically copies
162
+ * all items committed before the fork operation begins.
163
+ */
164
+ upToItemId?: string | undefined;
165
+ /** Optional unique ID for the forked session. A collision returns `ALREADY_EXISTS`. */
166
+ sessionId?: string | undefined;
167
+ /** Opaque caller-provided identifier for the application actor associated with the forked session. */
168
+ actorId?: string | undefined;
169
+ /** Optional metadata for the fork. */
170
+ metadata?: Record<string, string> | undefined;
171
+ /**
172
+ * Resource name of the containing session store, in the form
173
+ * `session-stores/{session_store_id}`.
174
+ */
175
+ parent?: string | undefined;
176
+ }
177
+ /** Response from forking a session. */
178
+ interface ForkSessionResponse {
179
+ /** The newly-created independent top-level session. */
180
+ session?: Session | undefined;
181
+ }
182
+ /** Request to retrieve a memory entry by resource name. */
183
+ interface GetManagedMemoryEntryRequest {
184
+ /**
185
+ * Resource name in the form
186
+ * `memory-stores/{managed_memory_store_id}/entries/{managed_memory_entry_id}`.
187
+ */
188
+ name?: string | undefined;
189
+ /** Controls whether the response includes memory content. Defaults to `FULL`. */
190
+ view?: ManagedMemoryEntryView | undefined;
191
+ }
192
+ /** Request to retrieve a memory store by resource name. */
193
+ interface GetManagedMemoryStoreRequest {
194
+ /** Resource name in the form `memory-stores/{managed_memory_store_id}`. */
195
+ name?: string | undefined;
196
+ }
197
+ /** Request to get a session. */
198
+ interface GetSessionRequest {
199
+ /**
200
+ * Resource name in the form
201
+ * `session-stores/{session_store_id}/sessions/{session_id}`.
202
+ */
203
+ name?: string | undefined;
204
+ }
205
+ /** Request to get a session store. */
206
+ interface GetSessionStoreRequest {
207
+ /** Resource name in the form `session-stores/{session_store_id}`. */
208
+ name?: string | undefined;
209
+ }
210
+ /**
211
+ * Request to list memory entries for one actor, optionally restricted by session and
212
+ * path prefix, or matched by exact path regardless of session.
213
+ */
214
+ interface ListManagedMemoryEntriesRequest {
215
+ /**
216
+ * Memory store whose entries are listed, in the form
217
+ * `memory-stores/{managed_memory_store_id}`.
218
+ */
219
+ parent?: string | undefined;
220
+ /**
221
+ * Maximum number of entries to return. The service may return fewer entries than requested.
222
+ * Defaults to 10; must be between 1 and 100.
223
+ */
224
+ pageSize?: number | undefined;
225
+ /** Opaque pagination token from a previous ListManagedMemoryEntries response. */
226
+ pageToken?: string | undefined;
227
+ /** Customer-provided identifier for the actor whose entries are listed. */
228
+ actorId?: string | undefined;
229
+ /** Optional path prefix used to restrict entries within the actor partition. */
230
+ pathPrefix?: string | undefined;
231
+ /**
232
+ * Optional session identifier. When set, only entries with this exact `session_id` are
233
+ * returned. Omitted-session (cross-session) entries are not included. Ignored when path is set.
234
+ */
235
+ sessionId?: string | undefined;
236
+ /** Controls whether each returned entry includes memory content. Defaults to `FULL`. */
237
+ view?: ManagedMemoryEntryView | undefined;
238
+ }
239
+ /** Response containing memory entries. */
240
+ interface ListManagedMemoryEntriesResponse {
241
+ /** Memory entries matching the request and selected response view. */
242
+ managedMemoryEntries?: ManagedMemoryEntry[] | undefined;
243
+ /** Opaque pagination token. This field is omitted when there are no more results. */
244
+ nextPageToken?: string | undefined;
245
+ }
246
+ /** Request to list memory stores in the caller's workspace. */
247
+ interface ListManagedMemoryStoresRequest {
248
+ /**
249
+ * Maximum number of stores to return. The service may return fewer stores than requested.
250
+ * Defaults to 10; must be between 1 and 100.
251
+ */
252
+ pageSize?: number | undefined;
253
+ /** Opaque pagination token from a previous ListManagedMemoryStores response. */
254
+ pageToken?: string | undefined;
255
+ }
256
+ /** Response containing memory stores in the caller's workspace. */
257
+ interface ListManagedMemoryStoresResponse {
258
+ /** Memory stores in the caller's workspace. */
259
+ managedMemoryStores?: ManagedMemoryStore[] | undefined;
260
+ /** Opaque pagination token. This field is omitted when there are no more results. */
261
+ nextPageToken?: string | undefined;
262
+ }
263
+ /** Request to list items in a session. */
264
+ interface ListSessionItemsRequest {
265
+ /** Maximum number of items to return. Defaults to 10; must be between 1 and 100. */
266
+ pageSize?: number | undefined;
267
+ /** Token returned by a previous list request. */
268
+ pageToken?: string | undefined;
269
+ /**
270
+ * Sort order. Supported values are `create_time asc` and `create_time desc`. The default is
271
+ * `create_time desc`, which returns the most recently appended items first. Equal timestamps are
272
+ * resolved by committed append order in the requested direction.
273
+ */
274
+ orderBy?: string | undefined;
275
+ /**
276
+ * Resource name of the containing session, in the form
277
+ * `session-stores/{session_store_id}/sessions/{session_id}`.
278
+ */
279
+ parent?: string | undefined;
280
+ }
281
+ /** Response containing a page of session items. */
282
+ interface ListSessionItemsResponse {
283
+ /** Session items in the requested page. */
284
+ sessionItems?: SessionItem[] | undefined;
285
+ /** Token to retrieve the next page. */
286
+ nextPageToken?: string | undefined;
287
+ }
288
+ /** Request to list session stores. */
289
+ interface ListSessionStoresRequest {
290
+ /** Maximum number of session stores to return. Defaults to 10; must be between 1 and 100. */
291
+ pageSize?: number | undefined;
292
+ /** Token returned by a previous list request. */
293
+ pageToken?: string | undefined;
294
+ }
295
+ /** Response containing a page of session stores. */
296
+ interface ListSessionStoresResponse {
297
+ /** Session stores in the requested page. */
298
+ sessionStores?: SessionStore[] | undefined;
299
+ /** Token to retrieve the next page. */
300
+ nextPageToken?: string | undefined;
301
+ }
302
+ /** Request to list sessions. */
303
+ interface ListSessionsRequest {
304
+ /** Maximum number of sessions to return. Defaults to 10; must be between 1 and 100. */
305
+ pageSize?: number | undefined;
306
+ /** Token returned by a previous list request. */
307
+ pageToken?: string | undefined;
308
+ /**
309
+ * Filter expression. Supported fields include `actor_id` and `metadata`; for example,
310
+ * `actor_id = "support-customer-123"`.
311
+ */
312
+ filter?: string | undefined;
313
+ /**
314
+ * Sort order. Defaults to `last_activity_time desc`. Page-token continuation is exactly-once when
315
+ * ordering by `create_time` (immutable); ordering by `last_activity_time` is best-effort, because
316
+ * that value changes as a session gains activity, so a session updated between page requests may
317
+ * be repeated or skipped. To enumerate every session exactly once, order by `create_time`.
318
+ */
319
+ orderBy?: string | undefined;
320
+ /**
321
+ * Resource name of the containing session store, in the form
322
+ * `session-stores/{session_store_id}`.
323
+ */
324
+ parent?: string | undefined;
325
+ }
326
+ /** Response containing a page of sessions. */
327
+ interface ListSessionsResponse {
328
+ /** Sessions in the requested page. */
329
+ sessions?: Session[] | undefined;
330
+ /** Token to retrieve the next page. */
331
+ nextPageToken?: string | undefined;
332
+ }
333
+ /** A workspace-scoped entry in a memory store. */
334
+ interface ManagedMemoryEntry {
335
+ /**
336
+ * Resource name in the form
337
+ * `memory-stores/{managed_memory_store_id}/entries/{managed_memory_entry_id}`.
338
+ */
339
+ name?: string | undefined;
340
+ /** Customer-provided identifier for the actor whose memory this entry represents. */
341
+ actorId?: string | undefined;
342
+ /**
343
+ * Optional identifier for the session associated with this memory entry. When omitted, the
344
+ * entry applies across the actor's sessions.
345
+ */
346
+ sessionId?: string | undefined;
347
+ /**
348
+ * Absolute, case-sensitive path identifying the entry within its actor and optional session.
349
+ * Paths must begin with `/` and must not contain empty, `.` or `..` segments.
350
+ */
351
+ path?: string | undefined;
352
+ /** Optional free-form memory content. */
353
+ content?: string | undefined;
354
+ /** Human-readable description of the memory entry. */
355
+ description?: string | undefined;
356
+ /** Which writer created this entry. Caller sets this on Create; immutable after creation. */
357
+ sourceType?: ManagedMemoryEntrySourceType | undefined;
358
+ /** Time when the entry was created. */
359
+ createTime?: Temporal.Instant | undefined;
360
+ /** Time when the entry was last updated. */
361
+ updateTime?: Temporal.Instant | undefined;
362
+ }
363
+ /** One relevance-ranked memory search result. */
364
+ interface ManagedMemoryEntrySearchResult {
365
+ /** Memory entry matching the query. */
366
+ managedMemoryEntry?: ManagedMemoryEntry | undefined;
367
+ /** Relevance score for the result. Higher scores are more relevant. */
368
+ score?: number | undefined;
369
+ }
370
+ /** A workspace-scoped memory store backed by service-managed storage. */
371
+ interface ManagedMemoryStore {
372
+ /** Resource name in the form `memory-stores/{managed_memory_store_id}`. */
373
+ name?: string | undefined;
374
+ /**
375
+ * Deprecated compatibility alias for the caller-provided memory store ID. Canonical
376
+ * clients provide the ID through `CreateMemoryStoreRequest.managed_memory_store_id` and use
377
+ * `name` as the resource identifier.
378
+ */
379
+ displayName?: string | undefined;
380
+ /** Workspace that owns the memory store. */
381
+ workspaceId?: bigint | undefined;
382
+ /** Service-managed storage backing this memory store. */
383
+ storageBackend?: StorageBackend | undefined;
384
+ /**
385
+ * Deprecated alias for `creator_user_id`. This identifies the original creator, not a
386
+ * transferable owner. Use `creator_user_id` instead.
387
+ */
388
+ ownerUserId?: string | undefined;
389
+ /**
390
+ * Workspace-local user ID of the authenticated principal that created the store. This is
391
+ * immutable server-set attribution and does not grant access; authorization is evaluated from
392
+ * the authenticated request context.
393
+ */
394
+ creatorUserId?: string | undefined;
395
+ /** Human-readable description of the memory store. */
396
+ description?: string | undefined;
397
+ /** Time when the store was created. */
398
+ createTime?: Temporal.Instant | undefined;
399
+ /** Time when the store was last updated. */
400
+ updateTime?: Temporal.Instant | undefined;
401
+ }
402
+ /** Request to pop an item from a session. */
403
+ interface PopSessionItemRequest {
404
+ /**
405
+ * Resource name of the containing session, in the form
406
+ * `session-stores/{session_store_id}/sessions/{session_id}`.
407
+ */
408
+ parent?: string | undefined;
409
+ }
410
+ /** Response containing the popped item. */
411
+ interface PopSessionItemResponse {
412
+ /** Removed item, if any. */
413
+ item?: SessionItem | undefined;
414
+ }
415
+ /**
416
+ * Request to search memory entries by text query for one actor.
417
+ * Search returns a relevance-ranked top-N result set and does not currently paginate.
418
+ */
419
+ interface SearchManagedMemoryEntriesRequest {
420
+ /**
421
+ * Memory store whose entries are searched, in the form
422
+ * `memory-stores/{managed_memory_store_id}`.
423
+ */
424
+ parent?: string | undefined;
425
+ /** Customer-provided identifier for the actor whose entries are searched. */
426
+ actorId?: string | undefined;
427
+ /** Free-form search query. */
428
+ query?: string | undefined;
429
+ /** Deprecated alias for `page_size`. When both fields are set, their values must match. */
430
+ limit?: number | undefined;
431
+ /**
432
+ * Maximum number of relevance-ranked entries to return. Defaults to 10 and must be between 1 and
433
+ * 100.
434
+ */
435
+ pageSize?: number | undefined;
436
+ /**
437
+ * Reserved for pagination compatibility. The server currently ignores this field because Search
438
+ * returns a ranked top-N result set.
439
+ */
440
+ pageToken?: string | undefined;
441
+ /**
442
+ * Optional session identifier. When set, only entries with this exact `session_id` are
443
+ * searched. Omitted-session (cross-session) entries are not included.
444
+ */
445
+ sessionId?: string | undefined;
446
+ /**
447
+ * Optional absolute, case-sensitive path prefix used to restrict searched entries within the
448
+ * actor partition. The prefix must begin with `/` and must not contain empty, `.` or `..`
449
+ * segments.
450
+ */
451
+ pathPrefix?: string | undefined;
452
+ /**
453
+ * Controls whether each returned entry includes memory content. Search scores are always
454
+ * returned. Defaults to `FULL`.
455
+ */
456
+ view?: ManagedMemoryEntryView | undefined;
457
+ }
458
+ /** Response containing memory entries ranked by relevance. */
459
+ interface SearchManagedMemoryEntriesResponse {
460
+ /**
461
+ * Deprecated compatibility alias for clients migrating to `results`. This contains the same
462
+ * entries in the same order, but omits their relevance scores.
463
+ */
464
+ managedMemoryEntries?: ManagedMemoryEntry[] | undefined;
465
+ /**
466
+ * Opaque pagination token. Search currently returns an unpaginated ranked top-N result set, so
467
+ * the server does not populate this field.
468
+ */
469
+ nextPageToken?: string | undefined;
470
+ /** Canonical matching entries and relevance scores, ordered most relevant first. */
471
+ results?: ManagedMemoryEntrySearchResult[] | undefined;
472
+ }
473
+ /** A durable logical interaction stored within a Session Store. */
474
+ interface Session {
475
+ /**
476
+ * Unique session ID. The service generates a UUID unless the caller supplies
477
+ * `CreateSessionRequest.session_id`.
478
+ */
479
+ sessionId?: string | undefined;
480
+ /**
481
+ * Opaque caller-provided identifier for the application actor associated with the session.
482
+ *
483
+ * This is application data and has no <Databricks> authentication or authorization semantics.
484
+ * Use the same value as the Managed Memory Entry `actor_id` when storing memories associated
485
+ * with this actor. Every session must set it. A child session must use the same value as its parent.
486
+ */
487
+ actorId?: string | undefined;
488
+ /**
489
+ * Immediate parent session ID. Set only at creation for child sessions, immutable thereafter, and
490
+ * restricted to the same store.
491
+ */
492
+ parentSessionId?: string | undefined;
493
+ /**
494
+ * Top-level session ID in the spawn tree. This equals `session_id` for a root or fork and is
495
+ * inherited transitively by child sessions.
496
+ */
497
+ rootSessionId?: string | undefined;
498
+ /** Mutable caller-defined string labels. */
499
+ metadata?: Record<string, string> | undefined;
500
+ /** Time when the session was created. */
501
+ createTime?: Temporal.Instant | undefined;
502
+ /** Time when session resource fields last changed. */
503
+ updateTime?: Temporal.Instant | undefined;
504
+ /** Time when the session's item history was last mutated. */
505
+ lastActivityTime?: Temporal.Instant | undefined;
506
+ /** Resource name in the form `session-stores/{session_store_id}/sessions/{session_id}`. */
507
+ name?: string | undefined;
508
+ }
509
+ /** A transcript entry in a session's history. */
510
+ interface SessionItem {
511
+ /** Stable service-generated item ID. */
512
+ itemId?: string | undefined;
513
+ /**
514
+ * Complete SDK-native, JSON-compatible item. The service stores and returns this value without
515
+ * interpreting provider-specific fields such as `type`, `role`, or `content`.
516
+ */
517
+ data?: JsonValue | undefined;
518
+ /**
519
+ * Server-assigned time when the append commits. Values are nondecreasing within a session. Item
520
+ * listing orders by this timestamp; equal timestamps are resolved by committed append order.
521
+ */
522
+ createTime?: Temporal.Instant | undefined;
523
+ }
524
+ /** A workspace-scoped session store. */
525
+ interface SessionStore {
526
+ /**
527
+ * Workspace-local user ID of the authenticated principal that created the store. This is
528
+ * immutable server-set attribution and does not grant access; authorization is evaluated from
529
+ * the authenticated request context.
530
+ */
531
+ creatorUserId?: string | undefined;
532
+ /** Time when the store was created. */
533
+ createTime?: Temporal.Instant | undefined;
534
+ /** Time when the store was last updated. */
535
+ updateTime?: Temporal.Instant | undefined;
536
+ /** Human-readable description of the session store. */
537
+ description?: string | undefined;
538
+ /** Mutable caller-defined string labels. */
539
+ metadata?: Record<string, string> | undefined;
540
+ /** Resource name in the form `session-stores/{session_store_id}`. */
541
+ name?: string | undefined;
542
+ }
543
+ /** Service-managed storage backing a memory store. */
544
+ interface StorageBackend {
545
+ /** Type of the storage backend. */
546
+ backendType?: StorageBackendType | undefined;
547
+ /** Backend-specific identifier. For Lakebase, this is the project ID. */
548
+ backendId?: string | undefined;
549
+ }
550
+ /** Request to update a memory entry. */
551
+ interface UpdateManagedMemoryEntryRequest {
552
+ /** The memory entry to update. */
553
+ managedMemoryEntry?: ManagedMemoryEntry | undefined;
554
+ /** Fields to update. Only `content` and `description` may be updated. */
555
+ updateMask?: FieldMask<ManagedMemoryEntry> | undefined;
556
+ }
557
+ /** Request to update the description and metadata on a memory store. */
558
+ interface UpdateManagedMemoryStoreRequest {
559
+ /** The memory store to update. `name` is taken from the URL. */
560
+ managedMemoryStore?: ManagedMemoryStore | undefined;
561
+ /** Only `description` and `metadata` may be updated. Selecting `metadata` replaces the entire map. */
562
+ updateMask?: FieldMask<ManagedMemoryStore> | undefined;
563
+ }
564
+ /** Request to update a session. */
565
+ interface UpdateSessionRequest {
566
+ /** Session to update. */
567
+ session?: Session | undefined;
568
+ /**
569
+ * Fields to update. Only `metadata` is mutable; any other path returns
570
+ * `INVALID_PARAMETER_VALUE`.
571
+ */
572
+ updateMask?: FieldMask<Session> | undefined;
573
+ }
574
+ /** Request to update a session store. */
575
+ interface UpdateSessionStoreRequest {
576
+ /** Session store to update. */
577
+ sessionStore?: SessionStore | undefined;
578
+ /**
579
+ * Fields to update. Only `description` and `metadata` are mutable; any other
580
+ * path returns `INVALID_PARAMETER_VALUE`.
581
+ */
582
+ updateMask?: FieldMask<SessionStore> | undefined;
583
+ }
584
+ declare const unmarshalAppendSessionItemsResponseSchema: z.ZodType<AppendSessionItemsResponse>;
585
+ declare const unmarshalClearSessionItemsResponseSchema: z.ZodType<ClearSessionItemsResponse>;
586
+ declare const unmarshalExtractMemoriesResponseSchema: z.ZodType<ExtractMemoriesResponse>;
587
+ declare const unmarshalForkSessionResponseSchema: z.ZodType<ForkSessionResponse>;
588
+ declare const unmarshalListManagedMemoryEntriesResponseSchema: z.ZodType<ListManagedMemoryEntriesResponse>;
589
+ declare const unmarshalListManagedMemoryStoresResponseSchema: z.ZodType<ListManagedMemoryStoresResponse>;
590
+ declare const unmarshalListSessionItemsResponseSchema: z.ZodType<ListSessionItemsResponse>;
591
+ declare const unmarshalListSessionStoresResponseSchema: z.ZodType<ListSessionStoresResponse>;
592
+ declare const unmarshalListSessionsResponseSchema: z.ZodType<ListSessionsResponse>;
593
+ declare const unmarshalManagedMemoryEntrySchema: z.ZodType<ManagedMemoryEntry>;
594
+ declare const unmarshalManagedMemoryEntrySearchResultSchema: z.ZodType<ManagedMemoryEntrySearchResult>;
595
+ declare const unmarshalManagedMemoryStoreSchema: z.ZodType<ManagedMemoryStore>;
596
+ declare const unmarshalPopSessionItemResponseSchema: z.ZodType<PopSessionItemResponse>;
597
+ declare const unmarshalSearchManagedMemoryEntriesResponseSchema: z.ZodType<SearchManagedMemoryEntriesResponse>;
598
+ declare const unmarshalSessionSchema: z.ZodType<Session>;
599
+ declare const unmarshalSessionItemSchema: z.ZodType<SessionItem>;
600
+ declare const unmarshalSessionStoreSchema: z.ZodType<SessionStore>;
601
+ declare const unmarshalStorageBackendSchema: z.ZodType<StorageBackend>;
602
+ declare const marshalAppendSessionItemsRequestSchema: z.ZodType;
603
+ declare const marshalClearSessionItemsRequestSchema: z.ZodType;
604
+ declare const marshalExtractMemoriesRequestSchema: z.ZodType;
605
+ declare const marshalForkSessionRequestSchema: z.ZodType;
606
+ declare const marshalManagedMemoryEntrySchema: z.ZodType;
607
+ declare const marshalManagedMemoryStoreSchema: z.ZodType;
608
+ declare const marshalPopSessionItemRequestSchema: z.ZodType;
609
+ declare const marshalSearchManagedMemoryEntriesRequestSchema: z.ZodType;
610
+ declare const marshalSessionSchema: z.ZodType;
611
+ declare const marshalSessionItemSchema: z.ZodType;
612
+ declare const marshalSessionStoreSchema: z.ZodType;
613
+ declare const marshalStorageBackendSchema: z.ZodType;
614
+ declare function managedMemoryEntryFieldMask(...paths: string[]): FieldMask<ManagedMemoryEntry>;
615
+ declare function managedMemoryStoreFieldMask(...paths: string[]): FieldMask<ManagedMemoryStore>;
616
+ declare function sessionFieldMask(...paths: string[]): FieldMask<Session>;
617
+ declare function sessionStoreFieldMask(...paths: string[]): FieldMask<SessionStore>;
618
+ //#endregion
619
+ export { AppendSessionItemsRequest, AppendSessionItemsResponse, ClearSessionItemsRequest, ClearSessionItemsResponse, CreateManagedMemoryEntryRequest, CreateManagedMemoryStoreRequest, CreateSessionRequest, CreateSessionStoreRequest, DeleteManagedMemoryEntryRequest, DeleteManagedMemoryStoreRequest, DeleteSessionRequest, DeleteSessionStoreRequest, ExtractMemoriesRequest, ExtractMemoriesResponse, ForkSessionRequest, ForkSessionResponse, GetManagedMemoryEntryRequest, GetManagedMemoryStoreRequest, GetSessionRequest, GetSessionStoreRequest, ListManagedMemoryEntriesRequest, ListManagedMemoryEntriesResponse, ListManagedMemoryStoresRequest, ListManagedMemoryStoresResponse, ListSessionItemsRequest, ListSessionItemsResponse, ListSessionStoresRequest, ListSessionStoresResponse, ListSessionsRequest, ListSessionsResponse, ManagedMemoryEntry, ManagedMemoryEntrySearchResult, ManagedMemoryEntrySourceType, ManagedMemoryEntryView, ManagedMemoryStore, PopSessionItemRequest, PopSessionItemResponse, SearchManagedMemoryEntriesRequest, SearchManagedMemoryEntriesResponse, Session, SessionItem, SessionStore, StorageBackend, StorageBackendType, UpdateManagedMemoryEntryRequest, UpdateManagedMemoryStoreRequest, UpdateSessionRequest, UpdateSessionStoreRequest, managedMemoryEntryFieldMask, managedMemoryStoreFieldMask, marshalAppendSessionItemsRequestSchema, marshalClearSessionItemsRequestSchema, marshalExtractMemoriesRequestSchema, marshalForkSessionRequestSchema, marshalManagedMemoryEntrySchema, marshalManagedMemoryStoreSchema, marshalPopSessionItemRequestSchema, marshalSearchManagedMemoryEntriesRequestSchema, marshalSessionItemSchema, marshalSessionSchema, marshalSessionStoreSchema, marshalStorageBackendSchema, sessionFieldMask, sessionStoreFieldMask, unmarshalAppendSessionItemsResponseSchema, unmarshalClearSessionItemsResponseSchema, unmarshalExtractMemoriesResponseSchema, unmarshalForkSessionResponseSchema, unmarshalListManagedMemoryEntriesResponseSchema, unmarshalListManagedMemoryStoresResponseSchema, unmarshalListSessionItemsResponseSchema, unmarshalListSessionStoresResponseSchema, unmarshalListSessionsResponseSchema, unmarshalManagedMemoryEntrySchema, unmarshalManagedMemoryEntrySearchResultSchema, unmarshalManagedMemoryStoreSchema, unmarshalPopSessionItemResponseSchema, unmarshalSearchManagedMemoryEntriesResponseSchema, unmarshalSessionItemSchema, unmarshalSessionSchema, unmarshalSessionStoreSchema, unmarshalStorageBackendSchema };
620
+ //# sourceMappingURL=model.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model.d.ts","names":[],"sources":["../../src/v1/model.ts"],"mappings":"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"}