@lightspeed-ai/sdk 0.4.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 (47) hide show
  1. package/README.md +68 -0
  2. package/dist/client.d.ts +65 -0
  3. package/dist/client.d.ts.map +1 -0
  4. package/dist/client.js +198 -0
  5. package/dist/client.js.map +1 -0
  6. package/dist/errors.d.ts +20 -0
  7. package/dist/errors.d.ts.map +1 -0
  8. package/dist/errors.js +53 -0
  9. package/dist/errors.js.map +1 -0
  10. package/dist/generated/methods.d.ts +3308 -0
  11. package/dist/generated/methods.d.ts.map +1 -0
  12. package/dist/generated/methods.js +2085 -0
  13. package/dist/generated/methods.js.map +1 -0
  14. package/dist/generated/types.d.ts +8048 -0
  15. package/dist/generated/types.d.ts.map +1 -0
  16. package/dist/generated/types.js +6 -0
  17. package/dist/generated/types.js.map +1 -0
  18. package/dist/generated/workflow-manifest.d.ts +223 -0
  19. package/dist/generated/workflow-manifest.d.ts.map +1 -0
  20. package/dist/generated/workflow-manifest.js +258 -0
  21. package/dist/generated/workflow-manifest.js.map +1 -0
  22. package/dist/generated/workflow-types.d.ts +587 -0
  23. package/dist/generated/workflow-types.d.ts.map +1 -0
  24. package/dist/generated/workflow-types.js +6 -0
  25. package/dist/generated/workflow-types.js.map +1 -0
  26. package/dist/index.d.ts +8 -0
  27. package/dist/index.d.ts.map +1 -0
  28. package/dist/index.js +4 -0
  29. package/dist/index.js.map +1 -0
  30. package/dist/workflow.d.ts +221 -0
  31. package/dist/workflow.d.ts.map +1 -0
  32. package/dist/workflow.js +346 -0
  33. package/dist/workflow.js.map +1 -0
  34. package/examples/temporal-activity.ts +32 -0
  35. package/package.json +55 -0
  36. package/release.json +4 -0
  37. package/schema/api.schema.json +18595 -0
  38. package/schema/workflow.json +253 -0
  39. package/schema/workflow.schema.json +1237 -0
  40. package/src/client.ts +323 -0
  41. package/src/errors.ts +73 -0
  42. package/src/generated/methods.ts +3348 -0
  43. package/src/generated/types.ts +8319 -0
  44. package/src/generated/workflow-manifest.ts +258 -0
  45. package/src/generated/workflow-types.ts +612 -0
  46. package/src/index.ts +31 -0
  47. package/src/workflow.ts +475 -0
@@ -0,0 +1,3348 @@
1
+ /*
2
+ * Generated by clients/typescript/scripts/generate.mjs.
3
+ * Do not edit by hand.
4
+ */
5
+ import type * as Api from "./types.js";
6
+
7
+ export const METHODS = [
8
+ "vfs/workspaces/files/read",
9
+ "initialize",
10
+ "session/start",
11
+ "session/managed/start",
12
+ "session/read",
13
+ "session/list",
14
+ "session/config/put",
15
+ "session/rename",
16
+ "session/metadata/put",
17
+ "session/retention/put",
18
+ "session/close",
19
+ "session/delete",
20
+ "session/share",
21
+ "session/events/read",
22
+ "session/context/append",
23
+ "session/context/remove",
24
+ "session/context/replace",
25
+ "session/context/compact",
26
+ "session/runs/start",
27
+ "session/runs/list",
28
+ "session/runs/read",
29
+ "session/runs/cancel",
30
+ "session/runs/approvals/decide",
31
+ "session/runs/steer",
32
+ "session/skills/list",
33
+ "session/profiles/apply",
34
+ "session/environments/activate",
35
+ "session/environments/deactivate",
36
+ "environments/credentials/bind",
37
+ "environments/credentials/list",
38
+ "environments/credentials/unbind",
39
+ "environments/create",
40
+ "environments/read",
41
+ "environments/list",
42
+ "environments/close",
43
+ "environments/external/create",
44
+ "environments/ingress/put",
45
+ "environments/power/put",
46
+ "environments/idle-policy/put",
47
+ "environments/provider-bindings/list",
48
+ "environments/provider-bindings/read",
49
+ "environments/templates/list",
50
+ "environments/templates/read",
51
+ "environments/jobs/create",
52
+ "environments/jobs/read",
53
+ "environments/jobs/cancel",
54
+ "environments/registration-keys/create",
55
+ "environments/registration-keys/read",
56
+ "environments/registration-keys/list",
57
+ "environments/registration-keys/revoke",
58
+ "transcriptions/start",
59
+ "transcriptions/read",
60
+ "transcriptions/cancel",
61
+ "models/defaults/read",
62
+ "models/defaults/put",
63
+ "models/list",
64
+ "profiles/create",
65
+ "profiles/read",
66
+ "profiles/list",
67
+ "profiles/put",
68
+ "profiles/delete",
69
+ "blobs/put",
70
+ "blobs/read",
71
+ "blobs/has",
72
+ "vfs/snapshots/commit",
73
+ "vfs/snapshots/read",
74
+ "vfs/workspaces/create",
75
+ "vfs/workspaces/read",
76
+ "vfs/workspaces/list",
77
+ "vfs/workspaces/update",
78
+ "vfs/workspaces/delete",
79
+ "mcp/servers/put",
80
+ "mcp/servers/auth/discover",
81
+ "mcp/servers/tools/discover",
82
+ "mcp/servers/read",
83
+ "mcp/servers/list",
84
+ "mcp/servers/delete",
85
+ "auth/grants/import",
86
+ "auth/grants/lease",
87
+ "auth/grants/read",
88
+ "auth/grants/list",
89
+ "auth/grants/revoke",
90
+ "auth/clients/create",
91
+ "auth/clients/read",
92
+ "auth/clients/list",
93
+ "auth/clients/delete",
94
+ "auth/flows/start",
95
+ "auth/flows/read",
96
+ "auth/providers/create",
97
+ "auth/providers/read",
98
+ "auth/providers/list",
99
+ "auth/providers/delete",
100
+ "auth/github/installations/list",
101
+ "auth/github/installations/grant",
102
+ "bots/create",
103
+ "bots/put",
104
+ "bots/read",
105
+ "bots/list",
106
+ "bots/close",
107
+ "bots/delete",
108
+ "bots/state/read",
109
+ "bots/sessions/rotate",
110
+ "bots/triggers/put",
111
+ "bots/triggers/read",
112
+ "bots/triggers/list",
113
+ "bots/triggers/delete",
114
+ "bots/events/admit",
115
+ "bots/events/replay",
116
+ "bots/events/list",
117
+ "bots/events/read",
118
+ "bots/filters/test",
119
+ "channels/accounts/create",
120
+ "channels/accounts/put",
121
+ "channels/accounts/read",
122
+ "channels/accounts/list",
123
+ "channels/accounts/delete",
124
+ "channels/inbound/admit",
125
+ "channels/pairings/list",
126
+ "channels/pairings/delete",
127
+ "channels/conversations/read",
128
+ "deployment/environment-provider-bindings/list",
129
+ "deployment/universes/create",
130
+ "deployment/universes/list",
131
+ "deployment/universes/read",
132
+ "deployment/universes/slug/put",
133
+ "deployment/universes/delete",
134
+ "deployment/api-keys/create",
135
+ "deployment/api-keys/list",
136
+ "deployment/api-keys/rotate",
137
+ "deployment/api-keys/revoke",
138
+ "deployment/environment-providers/put",
139
+ "deployment/environment-providers/list",
140
+ "deployment/environment-providers/read",
141
+ "deployment/environment-providers/delete",
142
+ "deployment/environment-providers/bindings/put",
143
+ "deployment/environment-providers/bindings/delete",
144
+ "deployment/environments/adopt",
145
+ "deployment/channels/accounts/list",
146
+ ] as const;
147
+
148
+ export const METHOD_INFO = {
149
+ "vfs/workspaces/files/read": {
150
+ scope: "universe",
151
+ access: {"action":"read","kind":"universe"},
152
+ summary: "Read a workspace file",
153
+ description: "Reads bytes at a path in the current workspace head.",
154
+ },
155
+ "initialize": {
156
+ scope: "connection",
157
+ access: {"kind":"connection"},
158
+ summary: "Inspect the Lightspeed protocol",
159
+ description: "Returns protocol version, server identity, credential scope and allowed groups before universe selection. Requires authentication in authenticated mode; no universe header is accepted.",
160
+ },
161
+ "session/start": {
162
+ scope: "universe",
163
+ access: {"action":"create_session","kind":"universe"},
164
+ summary: "Create or reopen a session",
165
+ description: "Creates a session, unshared unless access says universe, with optional config/profile setup. Profile metadata and retention supply defaults that explicit values override; the config's default environment attachment becomes active. Retrying an existing id returns that session and keeps its audience.",
166
+ },
167
+ "session/managed/start": {
168
+ scope: "universe",
169
+ access: {"action":"create_session","kind":"universe"},
170
+ summary: "Create or reopen a managed session",
171
+ description: "Creates a session with immutable lifecycle and workflow-tool declarations using explicit bound dispatch. Profile metadata, retention, and default environment attachment selection follow session/start semantics. Retrying an id requires the same managed declaration; an ordinary session cannot be upgraded.",
172
+ },
173
+ "session/read": {
174
+ scope: "universe",
175
+ access: {"action":"read","kind":"universe"},
176
+ summary: "Read a session",
177
+ description: "Returns current state plus a bounded newest-first run-summary page. Follow nextRunCursor with session/runs/list when hasOlderRuns is true; use session/events/read for the transcript.",
178
+ },
179
+ "session/list": {
180
+ scope: "universe",
181
+ access: {"action":"read","kind":"universe"},
182
+ summary: "List sessions",
183
+ description: "Returns a cursor-paginated summary list ordered by most recent update, optionally narrowed by the audience of each session's root: createdBy, visibility, or visibleTo (shared with the universe or created by that actor). Pages may shift while sessions are changing.",
184
+ },
185
+ "session/config/put": {
186
+ scope: "universe",
187
+ access: {"action":"control_session","kind":"universe"},
188
+ summary: "Replace session configuration",
189
+ description: "Replaces the complete sparse config while the session is idle. Use the current config revision for safe read-modify-write; omitted features are revoked, an omitted model preserves the current model, and an identical document is a no-op.",
190
+ },
191
+ "session/rename": {
192
+ scope: "universe",
193
+ access: {"action":"control_session","kind":"universe"},
194
+ summary: "Rename a session",
195
+ description: "Sets the display name, or clears it when displayName is omitted.",
196
+ },
197
+ "session/metadata/put": {
198
+ scope: "universe",
199
+ access: {"action":"control_session","kind":"universe"},
200
+ summary: "Replace session metadata",
201
+ description: "Replaces the complete descriptive key/value map (bounded like session/start); an omitted or empty map clears it. Record-only: the event log and updatedAtMs are untouched.",
202
+ },
203
+ "session/retention/put": {
204
+ scope: "universe",
205
+ access: {"action":"control_session","kind":"universe"},
206
+ summary: "Replace session retention",
207
+ description: "Sets the positive close-relative automatic-deletion duration on a retention root, or clears it with null. Forks and delegated children inherit the root policy and cannot override it.",
208
+ },
209
+ "session/close": {
210
+ scope: "universe",
211
+ access: {"action":"stop_session","kind":"universe"},
212
+ summary: "Close a session",
213
+ description: "Closes an idle session and detaches its environment bindings. Force mode cancels active work, drops queued runs, and can recover a session whose workflow is unavailable.",
214
+ },
215
+ "session/delete": {
216
+ scope: "universe",
217
+ access: {"action":"delete_session","kind":"universe"},
218
+ summary: "Delete closed sessions",
219
+ description: "Permanently removes a closed retention-tree leaf, or its closed history-fork and delegated-child subtree when cascade is true. Config-only clones are never included.",
220
+ },
221
+ "session/share": {
222
+ scope: "universe",
223
+ access: {"action":"share_session","kind":"universe"},
224
+ summary: "Share a session with the universe",
225
+ description: "Moves an unshared root session to universe visibility, one way; its delegated children follow it. Refused on a bot's session, a delegated child, and a session already shared. Core applies it for any caller of the method; who may share is the caller's gate's decision.",
226
+ },
227
+ "session/events/read": {
228
+ scope: "universe",
229
+ access: {"action":"read","kind":"universe"},
230
+ summary: "Read the session event stream",
231
+ description: "Returns chronological events. Forward (default) follows after and supports long-polling. Backward reads the latest window below before (or the head); pass nextCursor as before until complete. Follow live events after the initial backward headCursor. Windows may split runs/tool batches; keep historical reconstruction separate from live controls.",
232
+ },
233
+ "session/context/append": {
234
+ scope: "universe",
235
+ access: {"action":"control_session","kind":"universe"},
236
+ summary: "Append keyed session context",
237
+ description: "Admits a batch of context entries with per-entry results. Stable keys make same-content retries no-ops; invalid input can fail one entry without discarding successful entries.",
238
+ },
239
+ "session/context/remove": {
240
+ scope: "universe",
241
+ access: {"action":"control_session","kind":"universe"},
242
+ summary: "Remove keyed session context",
243
+ description: "Removes active entries by stable key with per-key results. Missing keys are idempotent no-ops; runtime-reserved run keys cannot be removed.",
244
+ },
245
+ "session/context/replace": {
246
+ scope: "universe",
247
+ access: {"action":"control_session","kind":"universe"},
248
+ summary: "Replace session context entries",
249
+ description: "Replaces active tool results and user messages in place by entry id, with per-entry results, e.g. to withdraw content the provider rejects. Entries keep their ids, positions, and kinds, so a tool result takes only text and its call stays answered. Refused while a run is active; ids no longer in context report absent.",
250
+ },
251
+ "session/context/compact": {
252
+ scope: "universe",
253
+ access: {"action":"control_session","kind":"universe"},
254
+ summary: "Compact session context",
255
+ description: "Performs one standalone compaction in any automatic mode, including Disabled, and waits for completion. Active work queues the operation until a safe turn boundary; automatic policy remains unchanged.",
256
+ },
257
+ "session/runs/start": {
258
+ scope: "universe",
259
+ access: {"action":"control_session","kind":"universe"},
260
+ summary: "Start an agent run",
261
+ description: "Accepts input or existing context keys and returns once the run is accepted — queued behind an active run, or running — not when it finishes. Supply submissionId for retry safety, then follow session events or reread the session.",
262
+ },
263
+ "session/runs/list": {
264
+ scope: "universe",
265
+ access: {"action":"read","kind":"universe"},
266
+ summary: "List session runs",
267
+ description: "Returns a newest-first keyset page of bounded run summaries projected from current reducer state.",
268
+ },
269
+ "session/runs/read": {
270
+ scope: "universe",
271
+ access: {"action":"read","kind":"universe"},
272
+ summary: "Read one session run",
273
+ description: "Reads and projects one run from its bounded event interval, paged by event sequence.",
274
+ },
275
+ "session/runs/cancel": {
276
+ scope: "universe",
277
+ access: {"action":"stop_session","kind":"universe"},
278
+ summary: "Cancel a run",
279
+ description: "Requests cancellation of the named queued or active run and returns its current projected state; observe session events for terminal completion. In-flight model and tool activity is aborted; no grace turn runs.",
280
+ },
281
+ "session/runs/approvals/decide": {
282
+ scope: "universe",
283
+ access: {"action":"control_session","kind":"universe"},
284
+ summary: "Decide pending run approvals",
285
+ description: "Approves or rejects pending MCP tool calls on the named active run. Valid decisions apply independently; the run resumes only after every pending approval has a decision.",
286
+ },
287
+ "session/runs/steer": {
288
+ scope: "universe",
289
+ access: {"action":"control_session","kind":"universe"},
290
+ summary: "Steer the active run",
291
+ description: "Injects input into the named active run; the model sees it at the next turn boundary without interrupting the in-flight turn. Accepted while the run is running or parked on an await; rejected for queued, cancelling, or finished runs.",
292
+ },
293
+ "session/skills/list": {
294
+ scope: "universe",
295
+ access: {"action":"read","kind":"universe"},
296
+ summary: "List available session skills",
297
+ description: "Returns separate VFS and environment catalogs with source, reference, availability, readable skill paths, and warnings. Refreshes only when open with no active or queued run, without waking environments. Absent catalogs are omitted.",
298
+ },
299
+ "session/profiles/apply": {
300
+ scope: "universe",
301
+ access: {"action":"control_session","kind":"universe"},
302
+ summary: "Apply a profile to a session",
303
+ description: "Applies a named or inline profile's config, instructions, and environment setup to an existing session; mutating profile sections require it to be open and idle. Pass current revisions to guard concurrent changes.",
304
+ },
305
+ "session/environments/activate": {
306
+ scope: "universe",
307
+ access: {"action":"control_session","kind":"universe"},
308
+ summary: "Activate a session environment",
309
+ description: "Selects an attached, live universe environment for environment-targeted tools while the session is idle.",
310
+ },
311
+ "session/environments/deactivate": {
312
+ scope: "universe",
313
+ access: {"action":"control_session","kind":"universe"},
314
+ summary: "Deactivate the session environment",
315
+ description: "Clears active environment selection without changing or closing the universe environment.",
316
+ },
317
+ "environments/credentials/bind": {
318
+ scope: "universe",
319
+ access: {"action":"configure_resource","kind":"universe"},
320
+ summary: "Bind a credential into an environment",
321
+ description: "Maps an environment variable name to an existing grant/provider/direct-secret handle for a universe environment. Requires configuring the environment and configuring resources in the universe. The response exposes only the source handle, never secret material.",
322
+ },
323
+ "environments/credentials/list": {
324
+ scope: "universe",
325
+ access: {"action":"configure_resource","kind":"universe"},
326
+ summary: "List environment credential bindings",
327
+ description: "Returns variable names and credential source handles for a universe environment; resolved secret values are never returned.",
328
+ },
329
+ "environments/credentials/unbind": {
330
+ scope: "universe",
331
+ access: {"action":"configure_resource","kind":"universe"},
332
+ summary: "Unbind an environment credential",
333
+ description: "Removes one variable-to-credential mapping without deleting the underlying grant, provider credential, or secret.",
334
+ },
335
+ "environments/create": {
336
+ scope: "universe",
337
+ access: {"action":"configure_resource","kind":"universe"},
338
+ summary: "Create an environment",
339
+ description: "Records an idempotent provisioning intent against an enabled universe binding, attributed to the caller. The provider validates its provider-wide template and provisions through its backend asynchronously.",
340
+ },
341
+ "environments/read": {
342
+ scope: "universe",
343
+ access: {"action":"read","kind":"universe"},
344
+ summary: "Read an environment",
345
+ description: "Returns the durable universe resource, source binding, logical lifecycle state, and minimal current-incarnation identity.",
346
+ },
347
+ "environments/list": {
348
+ scope: "universe",
349
+ access: {"action":"read","kind":"universe"},
350
+ summary: "List environments",
351
+ description: "Lists the universe environments, optionally filtered by provider, binding, or logical lifecycle state.",
352
+ },
353
+ "environments/close": {
354
+ scope: "universe",
355
+ access: {"action":"configure_resource","kind":"universe"},
356
+ summary: "Close an environment",
357
+ description: "Records an asynchronous idempotent close intent. Provider cleanup is resumed by lifecycle reconciliation; quota is released only after Closed.",
358
+ },
359
+ "environments/external/create": {
360
+ scope: "universe",
361
+ access: {"action":"configure_resource","kind":"universe"},
362
+ summary: "Register an external environment",
363
+ description: "Creates an environment backed by a Lightspeed-reachable envd WebSocket endpoint, attributed to the caller. Reachability is checked on demand.",
364
+ },
365
+ "environments/ingress/put": {
366
+ scope: "universe",
367
+ access: {"action":"configure_resource","kind":"universe"},
368
+ summary: "Configure environment public ingress",
369
+ description: "Synchronously enables or disables one provider-authorized HTTPS endpoint for a provisioned environment. The provider owns hostname allocation, the approved guest port, routing, TLS, and health.",
370
+ },
371
+ "environments/power/put": {
372
+ scope: "universe",
373
+ access: {"action":"configure_resource","kind":"universe"},
374
+ summary: "Set environment power intent",
375
+ description: "Records the desired power state (running, paused, suspended, or stopped) of a provisioned environment; the lifecycle reconciler converges the provider target asynchronously. Powered-down environments wake transparently on their next use. Rejected when the provider does not support the state.",
376
+ },
377
+ "environments/idle-policy/put": {
378
+ scope: "universe",
379
+ access: {"action":"configure_resource","kind":"universe"},
380
+ summary: "Set environment idle policy",
381
+ description: "Replaces or clears the staged idle policy of a provisioned environment. The power reaper measures the daemon's idle duration against the pause/suspend/stop/close thresholds and escalates through the stages the provider supports.",
382
+ },
383
+ "environments/provider-bindings/list": {
384
+ scope: "universe",
385
+ access: {"action":"read","kind":"universe"},
386
+ summary: "List environment provider bindings",
387
+ description: "Lists this universe's revisioned routing and admission bindings to deployment-scoped physical providers.",
388
+ },
389
+ "environments/provider-bindings/read": {
390
+ scope: "universe",
391
+ access: {"action":"read","kind":"universe"},
392
+ summary: "Read an environment provider binding",
393
+ description: "Returns one universe routing and admission binding. Provider-wide templates and physical resource, network, and ingress policy remain provider-owned.",
394
+ },
395
+ "environments/templates/list": {
396
+ scope: "universe",
397
+ access: {"action":"read","kind":"universe"},
398
+ summary: "List environment templates",
399
+ description: "Reads immutable templates directly from the selected bound provider controller.",
400
+ },
401
+ "environments/templates/read": {
402
+ scope: "universe",
403
+ access: {"action":"read","kind":"universe"},
404
+ summary: "Read an environment template",
405
+ description: "Returns one immutable template version from the selected bound provider controller.",
406
+ },
407
+ "environments/jobs/create": {
408
+ scope: "universe",
409
+ access: {"action":"use_resource","kind":"universe"},
410
+ summary: "Create environment jobs",
411
+ description: "Starts a dependency-aware job group on one environment instance, injecting the environment's configured credentials at provider start. requestId is the retry identity; jobs are owned by the instance rather than a session. A powered-down environment is woken on use: the call fails with environment_not_ready while the wake is in progress; retry with backoff.",
412
+ },
413
+ "environments/jobs/read": {
414
+ scope: "universe",
415
+ access: {"action":"read","kind":"universe"},
416
+ summary: "Read environment jobs",
417
+ description: "Reads selected job handles with bounded output, optional sequence continuation, and optional artifacts; use returned status/sequence data for polling.",
418
+ },
419
+ "environments/jobs/cancel": {
420
+ scope: "universe",
421
+ access: {"action":"use_resource","kind":"universe"},
422
+ summary: "Cancel environment jobs",
423
+ description: "Requests cancellation for selected jobs, optionally including dependents. Force is provider-specific escalation; inspect each per-job result.",
424
+ },
425
+ "environments/registration-keys/create": {
426
+ scope: "universe",
427
+ access: {"action":"configure_resource","kind":"universe"},
428
+ summary: "Mint an environment registration key",
429
+ description: "Creates a reusable universe-scoped key that lets outbound envd daemons register as environments. The plaintext secret is returned exactly once; only its hash is stored. Identity mode, active limit, disconnect grace, and expiry are the key's policy. Treat the secret like a cluster-join credential.",
430
+ },
431
+ "environments/registration-keys/read": {
432
+ scope: "universe",
433
+ access: {"action":"configure_resource","kind":"universe"},
434
+ summary: "Read an environment registration key",
435
+ description: "Returns the key's display prefix, policy, status, and derived environment counts; never the secret or its hash.",
436
+ },
437
+ "environments/registration-keys/list": {
438
+ scope: "universe",
439
+ access: {"action":"configure_resource","kind":"universe"},
440
+ summary: "List environment registration keys",
441
+ description: "Lists this universe's registration keys with policy, status, and derived counts. Each key is the group of the environments it admitted.",
442
+ },
443
+ "environments/registration-keys/revoke": {
444
+ scope: "universe",
445
+ access: {"action":"configure_resource","kind":"universe"},
446
+ summary: "Revoke an environment registration key",
447
+ description: "Stops the key from admitting new daemon identities; already registered daemons keep reconnecting. With closeEnvironments, also closes every non-closed environment the key admitted. Idempotent.",
448
+ },
449
+ "transcriptions/start": {
450
+ scope: "universe",
451
+ access: {"action":"use_resource","kind":"universe"},
452
+ summary: "Start transcription",
453
+ description: "Admit or rejoin a requester-scoped audio transcription. The resolved model is immutable. No session or run is created.",
454
+ },
455
+ "transcriptions/read": {
456
+ scope: "universe",
457
+ access: {"action":"read","kind":"universe"},
458
+ summary: "Read transcription",
459
+ description: "Read status and transcript text. An asserted actor may only read their own drafts; direct universe keys retain method-group authority. Unsubmitted CAS results may expire.",
460
+ },
461
+ "transcriptions/cancel": {
462
+ scope: "universe",
463
+ access: {"action":"use_resource","kind":"universe"},
464
+ summary: "Cancel transcription",
465
+ description: "Cancel unfinished transcription. Repeated cancellation is safe; completed results remain unchanged. An asserted actor may only cancel their own drafts; direct universe keys retain method-group authority.",
466
+ },
467
+ "models/defaults/read": {
468
+ scope: "universe",
469
+ access: {"action":"read","kind":"universe"},
470
+ summary: "Read universe model defaults",
471
+ description: "Returns the revision and independent agentRun and speechToText selections. Revision zero means no update has been made. Does not contact model providers.",
472
+ },
473
+ "models/defaults/put": {
474
+ scope: "universe",
475
+ access: {"action":"configure_resource","kind":"universe"},
476
+ summary: "Set a universe model default",
477
+ description: "Sets or explicitly clears one purpose slot using its current expected revision. Existing sessions and admitted work keep their model. Validates the purpose and protocol without contacting provider discovery.",
478
+ },
479
+ "models/list": {
480
+ scope: "universe",
481
+ access: {"action":"read","kind":"universe"},
482
+ summary: "Discover available models",
483
+ description: "Queries supported providers directly, with a brief process-local burst cache, and returns best-effort selectable routes. One provider failure does not discard successful results from others.",
484
+ },
485
+ "profiles/create": {
486
+ scope: "universe",
487
+ access: {"action":"create_profile","kind":"universe"},
488
+ summary: "Create an agent profile",
489
+ description: "Creates a new universe-scoped reusable profile document; use profiles/put for create-or-replace revision semantics.",
490
+ },
491
+ "profiles/read": {
492
+ scope: "universe",
493
+ access: {"action":"read","kind":"universe"},
494
+ summary: "Read an agent profile",
495
+ description: "Returns the complete profile document and current revision.",
496
+ },
497
+ "profiles/list": {
498
+ scope: "universe",
499
+ access: {"action":"read","kind":"universe"},
500
+ summary: "List agent profiles",
501
+ description: "Returns lightweight summaries of universe-scoped reusable profiles.",
502
+ },
503
+ "profiles/put": {
504
+ scope: "universe",
505
+ access: {"action":"manage_profile","kind":"universe"},
506
+ summary: "Create or replace an agent profile",
507
+ description: "Stores the complete profile document. Use expectedRevision from profiles/read when replacing to prevent lost updates; absence writes unconditionally.",
508
+ },
509
+ "profiles/delete": {
510
+ scope: "universe",
511
+ access: {"action":"manage_profile","kind":"universe"},
512
+ summary: "Delete an agent profile",
513
+ description: "Deletes the catalog document; sessions previously created or configured from it retain their materialized state.",
514
+ },
515
+ "blobs/put": {
516
+ scope: "universe",
517
+ access: {"action":"use_resource","kind":"universe"},
518
+ summary: "Store content-addressed blobs",
519
+ description: "Decodes and stores a batch of base64 payloads, returning immutable content references in request order. Re-uploading identical bytes is naturally deduplicated.",
520
+ },
521
+ "blobs/read": {
522
+ scope: "universe",
523
+ access: {"action":"read","kind":"universe"},
524
+ summary: "Read a content-addressed blob",
525
+ description: "Returns the complete immutable blob of this universe as base64; large values count against gateway and MCP response limits.",
526
+ },
527
+ "blobs/has": {
528
+ scope: "universe",
529
+ access: {"action":"read","kind":"universe"},
530
+ summary: "Check blob availability",
531
+ description: "Checks a batch of content references without returning blob bodies, preserving request order.",
532
+ },
533
+ "vfs/snapshots/commit": {
534
+ scope: "universe",
535
+ access: {"action":"use_resource","kind":"universe"},
536
+ summary: "Commit a VFS snapshot",
537
+ description: "Validates and stores an immutable filesystem manifest. Upload referenced file blobs first; the returned snapshot ref is content-addressed.",
538
+ },
539
+ "vfs/snapshots/read": {
540
+ scope: "universe",
541
+ access: {"action":"read","kind":"universe"},
542
+ summary: "Read a VFS snapshot",
543
+ description: "Returns an immutable snapshot manifest and aggregate file/byte counts; file bodies remain separate blobs.",
544
+ },
545
+ "vfs/workspaces/create": {
546
+ scope: "universe",
547
+ access: {"action":"create_workspace","kind":"universe"},
548
+ summary: "Create a mutable VFS workspace",
549
+ description: "Creates a universe workspace attributed to the caller at an optional seed snapshot; absence starts from a server-created empty snapshot.",
550
+ },
551
+ "vfs/workspaces/read": {
552
+ scope: "universe",
553
+ access: {"action":"read","kind":"universe"},
554
+ summary: "Read a VFS workspace",
555
+ description: "Returns workspace metadata, current head snapshot, and revision for safe updates.",
556
+ },
557
+ "vfs/workspaces/list": {
558
+ scope: "universe",
559
+ access: {"action":"read","kind":"universe"},
560
+ summary: "List VFS workspaces",
561
+ description: "Lists the mutable universe workspaces with head snapshots, sizes, and revisions.",
562
+ },
563
+ "vfs/workspaces/update": {
564
+ scope: "universe",
565
+ access: {"action":"use_resource","kind":"universe"},
566
+ summary: "Update a VFS workspace",
567
+ description: "Moves the workspace head to an existing snapshot, which requires use of the workspace, and updates its display name, which requires configuring it. Pass expectedRevision from a read to prevent lost updates.",
568
+ },
569
+ "vfs/workspaces/delete": {
570
+ scope: "universe",
571
+ access: {"action":"configure_resource","kind":"universe"},
572
+ summary: "Delete a VFS workspace",
573
+ description: "Deletes the mutable workspace record; immutable snapshots and blobs remain content-addressed resources.",
574
+ },
575
+ "mcp/servers/put": {
576
+ scope: "universe",
577
+ access: {"action":"configure_resource","kind":"universe"},
578
+ summary: "Create or replace an MCP server record",
579
+ description: "Stores the complete catalog document with its optional auth-grant credential. A new server is attributed to the caller. Use expectedRevision when replacing; token material is never accepted or returned.",
580
+ },
581
+ "mcp/servers/auth/discover": {
582
+ scope: "universe",
583
+ access: {"action":"configure_resource","kind":"universe"},
584
+ summary: "Discover MCP server authentication",
585
+ description: "Looks for standards-based OAuth protected-resource metadata without creating a server, OAuth client, flow, or grant. An absent OAuth result is inconclusive and callers must allow manual auth selection.",
586
+ },
587
+ "mcp/servers/tools/discover": {
588
+ scope: "universe",
589
+ access: {"action":"configure_resource","kind":"universe"},
590
+ summary: "Discover MCP server tools",
591
+ description: "Connects directly to the configured MCP server with its current universe credential and returns one bounded live tools/list result. The inventory is never persisted or cached and no tool is invoked.",
592
+ },
593
+ "mcp/servers/read": {
594
+ scope: "universe",
595
+ access: {"action":"read","kind":"universe"},
596
+ summary: "Read an MCP server record",
597
+ description: "Returns one catalog document with defaults, auth policy, non-secret grant binding, status, and revision; no credential value is exposed.",
598
+ },
599
+ "mcp/servers/list": {
600
+ scope: "universe",
601
+ access: {"action":"read","kind":"universe"},
602
+ summary: "List MCP server records",
603
+ description: "Lists the universe catalog entries, optionally filtered by lifecycle/configuration status.",
604
+ },
605
+ "mcp/servers/delete": {
606
+ scope: "universe",
607
+ access: {"action":"configure_resource","kind":"universe"},
608
+ summary: "Delete an MCP server record",
609
+ description: "Deletes the catalog document. Existing session configs that reference it are not silently rewritten and may need explicit reconfiguration.",
610
+ },
611
+ "auth/grants/import": {
612
+ scope: "universe",
613
+ access: {"action":"configure_resource","kind":"universe"},
614
+ summary: "Import a static bearer grant",
615
+ description: "Accepts a plaintext token, encrypts it immediately, and returns only grant metadata/token-presence flags. Brokered is the default; retrievable exposure is immutable and permits service-only leases.",
616
+ },
617
+ "auth/grants/lease": {
618
+ scope: "service",
619
+ access: {"kind":"service"},
620
+ summary: "Lease a retrievable authentication grant",
621
+ description: "Service callers only. Resolves the current access token through the broker, records the lease, and returns it once. Cache only in memory until expiry minus margin (or at most five minutes without expiry), re-lease after target 401/403, and never persist or place the token in workflow payloads.",
622
+ },
623
+ "auth/grants/read": {
624
+ scope: "universe",
625
+ access: {"action":"read","kind":"universe"},
626
+ summary: "Read authentication grant metadata",
627
+ description: "Returns creator attribution, provider binding, scopes, audience, expiry, status, and token-presence flags; access and refresh token values are never returned.",
628
+ },
629
+ "auth/grants/list": {
630
+ scope: "universe",
631
+ access: {"action":"read","kind":"universe"},
632
+ summary: "List authentication grants",
633
+ description: "Lists non-secret grant metadata for the universe, optionally filtered by status.",
634
+ },
635
+ "auth/grants/revoke": {
636
+ scope: "universe",
637
+ access: {"action":"configure_resource","kind":"universe"},
638
+ summary: "Revoke an authentication grant",
639
+ description: "Marks the grant unusable by token consumers while retaining non-secret audit metadata.",
640
+ },
641
+ "auth/clients/create": {
642
+ scope: "universe",
643
+ access: {"action":"configure_resource","kind":"universe"},
644
+ summary: "Register an OAuth client",
645
+ description: "Stores provider endpoints and client identity; an optional plaintext client secret is encrypted and represented thereafter only by hasClientSecret.",
646
+ },
647
+ "auth/clients/read": {
648
+ scope: "universe",
649
+ access: {"action":"read","kind":"universe"},
650
+ summary: "Read OAuth client metadata",
651
+ description: "Returns endpoints, public client identity, defaults, and secret-presence state; the client secret is never returned.",
652
+ },
653
+ "auth/clients/list": {
654
+ scope: "universe",
655
+ access: {"action":"read","kind":"universe"},
656
+ summary: "List OAuth clients",
657
+ description: "Lists non-secret OAuth client registrations in the universe.",
658
+ },
659
+ "auth/clients/delete": {
660
+ scope: "universe",
661
+ access: {"action":"configure_resource","kind":"universe"},
662
+ summary: "Delete an OAuth client",
663
+ description: "Deletes the client registration and its stored client secret; grants already created from it remain separate records.",
664
+ },
665
+ "auth/flows/start": {
666
+ scope: "universe",
667
+ access: {"action":"configure_resource","kind":"universe"},
668
+ summary: "Start an OAuth authorization flow",
669
+ description: "Creates a short-lived PKCE flow carrying the immutable grant exposure choice and returns a browser authorization URL containing one-time state. Treat the URL as sensitive and poll auth/flows/read for completion.",
670
+ },
671
+ "auth/flows/read": {
672
+ scope: "universe",
673
+ access: {"action":"configure_resource","kind":"universe"},
674
+ summary: "Read OAuth flow status",
675
+ description: "Polls a flow's pending/completed/failed/expired state and returns the resulting grant id when authorization succeeds; no token value is exposed.",
676
+ },
677
+ "auth/providers/create": {
678
+ scope: "universe",
679
+ access: {"action":"configure_resource","kind":"universe"},
680
+ summary: "Register an authentication provider",
681
+ description: "Creates a model or GitHub credential source. Plaintext API keys/private keys are encrypted on receipt and later represented only by configuration plus hasCredential.",
682
+ },
683
+ "auth/providers/read": {
684
+ scope: "universe",
685
+ access: {"action":"read","kind":"universe"},
686
+ summary: "Read authentication provider metadata",
687
+ description: "Returns provider kind, non-secret configuration, credential-presence state, and status; stored credentials are never returned.",
688
+ },
689
+ "auth/providers/list": {
690
+ scope: "universe",
691
+ access: {"action":"read","kind":"universe"},
692
+ summary: "List authentication providers",
693
+ description: "Lists non-secret model/GitHub provider registrations for the universe.",
694
+ },
695
+ "auth/providers/delete": {
696
+ scope: "universe",
697
+ access: {"action":"configure_resource","kind":"universe"},
698
+ summary: "Delete an authentication provider",
699
+ description: "Deletes the provider registration and its directly stored credential; separately stored grants remain independent records.",
700
+ },
701
+ "auth/github/installations/list": {
702
+ scope: "universe",
703
+ access: {"action":"configure_resource","kind":"universe"},
704
+ summary: "List GitHub App installations",
705
+ description: "Uses the registered GitHub App provider credential to query accessible installations and returns account/permission metadata without tokens.",
706
+ },
707
+ "auth/github/installations/grant": {
708
+ scope: "universe",
709
+ access: {"action":"configure_resource","kind":"universe"},
710
+ summary: "Grant access to a GitHub App installation",
711
+ description: "Creates or refreshes a universe auth grant for one accessible installation. The installation token is brokered internally and never returned.",
712
+ },
713
+ "bots/create": {
714
+ scope: "universe",
715
+ access: {"action":"create_bot","kind":"universe"},
716
+ summary: "Create a bot",
717
+ description: "Creates the bot record, optionally with its triggers, and starts its controller. Fails if the bot id exists; a trigger failure rolls the bot back.",
718
+ },
719
+ "bots/put": {
720
+ scope: "universe",
721
+ access: {"action":"manage_bot","kind":"universe"},
722
+ summary: "Create or replace a bot document",
723
+ description: "Replaces the mutable configuration whole and signals the controller, which applies it at its next idle boundary. Pass expectedRevision when replacing; a closed bot accepts label-only edits.",
724
+ },
725
+ "bots/read": {
726
+ scope: "universe",
727
+ access: {"action":"read","kind":"universe"},
728
+ summary: "Read a bot",
729
+ description: "Returns the bot record, its current revision, and lifecycle columns.",
730
+ },
731
+ "bots/list": {
732
+ scope: "universe",
733
+ access: {"action":"read","kind":"universe"},
734
+ summary: "List bots",
735
+ description: "Returns the roster: every bot with its trigger count, pending event count, and latest event, optionally narrowed by createdBy.",
736
+ },
737
+ "bots/close": {
738
+ scope: "universe",
739
+ access: {"action":"manage_bot","kind":"universe"},
740
+ summary: "Close a bot",
741
+ description: "Terminal and idempotent: disables every trigger, drops schedules, and tells the controller to archive pending events and force-close its sessions. Returns once signalled; follow bots/state/read for closing to closed.",
742
+ },
743
+ "bots/delete": {
744
+ scope: "universe",
745
+ access: {"action":"manage_bot","kind":"universe"},
746
+ summary: "Delete a bot",
747
+ description: "Closes the bot if needed, waits for its controller to complete, deletes the sessions it closed, and removes the record so the bot id is free again.",
748
+ },
749
+ "bots/state/read": {
750
+ scope: "universe",
751
+ access: {"action":"read","kind":"universe"},
752
+ summary: "Read bot controller state",
753
+ description: "Queries the controller workflow for its live snapshot (sessions, buffers, active and recent deliveries, budget) and lists sub-agent descendants. The controller is absent until the bot's first event.",
754
+ },
755
+ "bots/sessions/rotate": {
756
+ scope: "universe",
757
+ access: {"action":"manage_bot","kind":"universe"},
758
+ summary: "Rotate a bot session",
759
+ description: "Asks the controller to close one of the bot's sessions at its next idle boundary and continue on a fresh generation; queued deliveries follow.",
760
+ },
761
+ "bots/triggers/put": {
762
+ scope: "universe",
763
+ access: {"action":"manage_bot","kind":"universe"},
764
+ summary: "Create or replace a trigger",
765
+ description: "Validates the trigger document (CEL parses, grants exist, one inbox per bot, chat routes per conversation), reconciles its Temporal Schedule, and stores it. A poll spec edit resets the cursor; a webhook keeps its URL token.",
766
+ },
767
+ "bots/triggers/read": {
768
+ scope: "universe",
769
+ access: {"action":"read","kind":"universe"},
770
+ summary: "Read a trigger",
771
+ description: "Returns one trigger with its incidents and cursor; the ingest path and pairing code are included for bot-management callers.",
772
+ },
773
+ "bots/triggers/list": {
774
+ scope: "universe",
775
+ access: {"action":"read","kind":"universe"},
776
+ summary: "List a bot's triggers",
777
+ description: "Returns every trigger of the bot ordered by id, secrets included for bot-management callers.",
778
+ },
779
+ "bots/triggers/delete": {
780
+ scope: "universe",
781
+ access: {"action":"manage_bot","kind":"universe"},
782
+ summary: "Delete a trigger",
783
+ description: "Drops the trigger's Temporal Schedule and pairings, then the record; stored events keep their history.",
784
+ },
785
+ "bots/events/admit": {
786
+ scope: "universe",
787
+ access: {"action":"invoke_bot","kind":"universe"},
788
+ summary: "Admit an event manually",
789
+ description: "Stores an operator-authored event for the bot's main session and wakes the controller. eventId is the dedupe identity; a duplicate returns the stored row.",
790
+ },
791
+ "bots/events/replay": {
792
+ scope: "universe",
793
+ access: {"action":"manage_bot","kind":"universe"},
794
+ summary: "Replay a stored event",
795
+ description: "Re-admits the stored envelope as a fresh event with the original routing; the replay never coalesces.",
796
+ },
797
+ "bots/events/list": {
798
+ scope: "universe",
799
+ access: {"action":"read","kind":"universe"},
800
+ summary: "List a bot's events",
801
+ description: "Cursor-paginated event log, newest first, with outcomes; payload documents stay in the CAS.",
802
+ },
803
+ "bots/events/read": {
804
+ scope: "universe",
805
+ access: {"action":"read","kind":"universe"},
806
+ summary: "Read an event by number",
807
+ description: "Returns the event row and its full stored envelope document.",
808
+ },
809
+ "bots/filters/test": {
810
+ scope: "universe",
811
+ access: {"action":"manage_bot","kind":"universe"},
812
+ summary: "Test a CEL filter",
813
+ description: "Evaluates a filter against one payload or a sample of recent stored events, reporting matches and evaluation errors without changing anything.",
814
+ },
815
+ "channels/accounts/create": {
816
+ scope: "universe",
817
+ access: {"action":"configure_resource","kind":"universe"},
818
+ summary: "Create a channel account",
819
+ description: "Registers a provider account (Telegram, WhatsApp) for this universe. The credential is a retrievable grant reference; no token is accepted here.",
820
+ },
821
+ "channels/accounts/put": {
822
+ scope: "universe",
823
+ access: {"action":"configure_resource","kind":"universe"},
824
+ summary: "Create or replace a channel account",
825
+ description: "Replaces the account document whole; pass expectedRevision when replacing. The connector host picks the change up on its next discovery pass.",
826
+ },
827
+ "channels/accounts/read": {
828
+ scope: "universe",
829
+ access: {"action":"read","kind":"universe"},
830
+ summary: "Read a channel account",
831
+ description: "Returns the account document and revision.",
832
+ },
833
+ "channels/accounts/list": {
834
+ scope: "universe",
835
+ access: {"action":"read","kind":"universe"},
836
+ summary: "List channel accounts",
837
+ description: "Lists this universe's provider accounts, optionally by provider.",
838
+ },
839
+ "channels/accounts/delete": {
840
+ scope: "universe",
841
+ access: {"action":"configure_resource","kind":"universe"},
842
+ summary: "Delete a channel account",
843
+ description: "Removes the account and its pairings; chat triggers that reference it stop serving conversations.",
844
+ },
845
+ "channels/inbound/admit": {
846
+ scope: "service",
847
+ access: {"kind":"service"},
848
+ summary: "Admit a provider message",
849
+ description: "Service callers only. Resolves the chat trigger for the conversation, applies pairing, and signals the conversation workflow. Returns the decision so the connector can send pairing prompts itself; acknowledge the provider only after this returns.",
850
+ },
851
+ "channels/pairings/list": {
852
+ scope: "universe",
853
+ access: {"action":"read","kind":"universe"},
854
+ summary: "List chat pairings",
855
+ description: "Lists conversations paired to chat triggers, optionally by account or bot.",
856
+ },
857
+ "channels/pairings/delete": {
858
+ scope: "universe",
859
+ access: {"action":"configure_resource","kind":"universe"},
860
+ summary: "Unpair a conversation",
861
+ description: "Removes one pairing; the conversation must present the pairing code again to reconnect.",
862
+ },
863
+ "channels/conversations/read": {
864
+ scope: "universe",
865
+ access: {"action":"read","kind":"universe"},
866
+ summary: "Read a conversation snapshot",
867
+ description: "Queries the conversation workflow's live state for one chat, for debugging; absent when no workflow exists yet.",
868
+ },
869
+ "deployment/environment-provider-bindings/list": {
870
+ scope: "deployment",
871
+ access: {"kind":"deployment"},
872
+ summary: "List a universe's deployment provider bindings",
873
+ description: "Deployment configuration inventory of one universe's provider bindings.",
874
+ },
875
+ "deployment/universes/create": {
876
+ scope: "deployment",
877
+ access: {"kind":"deployment"},
878
+ summary: "Create a universe",
879
+ description: "Creates the deployment tenant boundary for an explicit UUID. The operation is idempotent and reports whether a new universe was created.",
880
+ },
881
+ "deployment/universes/list": {
882
+ scope: "deployment",
883
+ access: {"kind":"deployment"},
884
+ summary: "List universes",
885
+ description: "Returns deployment-wide universe summaries with approximate live aggregate counts and last session activity.",
886
+ },
887
+ "deployment/universes/read": {
888
+ scope: "deployment",
889
+ access: {"kind":"deployment"},
890
+ summary: "Read a universe",
891
+ description: "Returns one deployment tenant summary with aggregate session, workspace, profile, and blob usage.",
892
+ },
893
+ "deployment/universes/slug/put": {
894
+ scope: "deployment",
895
+ access: {"kind":"deployment"},
896
+ summary: "Set a universe slug",
897
+ description: "Sets or changes a deployment-unique slug without changing the universe UUID or resources. The previous slug is released and old URLs may stop working. With onlyIfUnset, a different existing slug is a conflict. Claiming another universe's slug also returns a conflict. Does not create a universe.",
898
+ },
899
+ "deployment/universes/delete": {
900
+ scope: "deployment",
901
+ access: {"kind":"deployment"},
902
+ summary: "Purge a universe",
903
+ description: "Permanently terminates live session workflows, deletes external blob objects, and cascades universe data. The purge is resumable/idempotent after partial failure.",
904
+ },
905
+ "deployment/api-keys/create": {
906
+ scope: "deployment",
907
+ access: {"kind":"deployment"},
908
+ summary: "Create a scoped API key",
909
+ description: "Mints a key for a universe or the deployment with the method groups it may call and whether it may assert actors. The plaintext secret is returned exactly once and cannot be recovered; persist only the displayed prefix for identification. Key authority is immutable: revoke and mint to change what one may do.",
910
+ },
911
+ "deployment/api-keys/list": {
912
+ scope: "deployment",
913
+ access: {"kind":"deployment"},
914
+ summary: "List scoped API keys",
915
+ description: "Returns non-secret key metadata, all keys or those of one scope, including groups, revocation and last-use timestamps. Plaintext secrets are never stored or returned.",
916
+ },
917
+ "deployment/api-keys/rotate": {
918
+ scope: "deployment",
919
+ access: {"kind":"deployment"},
920
+ summary: "Rotate a scoped API key",
921
+ description: "Atomically replaces an active key secret and display prefix, immediately rejecting the old secret on subsequent requests. Preserves scope, groups, actor authority, name, creator and creation time; clears last use. Returns the new secret once. Unknown or revoked prefixes are not found. Already admitted work continues.",
922
+ },
923
+ "deployment/api-keys/revoke": {
924
+ scope: "deployment",
925
+ access: {"kind":"deployment"},
926
+ summary: "Revoke a scoped API key",
927
+ description: "Revokes the key with this display prefix; revoking a revoked key keeps its first revocation time. An unknown prefix is not found.",
928
+ },
929
+ "deployment/environment-providers/put": {
930
+ scope: "deployment",
931
+ access: {"kind":"deployment"},
932
+ summary: "Put an environment provider",
933
+ description: "Registers or replaces one deployment provider and its controller connection. The provider does not call this API or require access to Lightspeed.",
934
+ },
935
+ "deployment/environment-providers/list": {
936
+ scope: "deployment",
937
+ access: {"kind":"deployment"},
938
+ summary: "List environment providers",
939
+ description: "Returns every deployment-registered deployment provider and its controller connection.",
940
+ },
941
+ "deployment/environment-providers/read": {
942
+ scope: "deployment",
943
+ access: {"kind":"deployment"},
944
+ summary: "Read an environment provider",
945
+ description: "Returns one deployment-registered deployment provider and its controller connection.",
946
+ },
947
+ "deployment/environment-providers/delete": {
948
+ scope: "deployment",
949
+ access: {"kind":"deployment"},
950
+ summary: "Delete an environment provider",
951
+ description: "Deletes a deployment provider only when no universe binding references it.",
952
+ },
953
+ "deployment/environment-providers/bindings/put": {
954
+ scope: "deployment",
955
+ access: {"kind":"deployment"},
956
+ summary: "Put an environment provider binding",
957
+ description: "Creates or replaces one universe's complete revisioned routing and admission binding. A deployment provider may have at most one binding in a universe.",
958
+ },
959
+ "deployment/environment-providers/bindings/delete": {
960
+ scope: "deployment",
961
+ access: {"kind":"deployment"},
962
+ summary: "Delete an environment provider binding",
963
+ description: "Deletes a universe provider binding only after every referencing environment has reached Closed.",
964
+ },
965
+ "deployment/environments/adopt": {
966
+ scope: "deployment",
967
+ access: {"kind":"deployment"},
968
+ summary: "Adopt a provider environment",
969
+ description: "Creates a universe environment by transferring an existing provider target into Lightspeed's managed lifecycle. The caller must explicitly accept ownership transfer.",
970
+ },
971
+ "deployment/channels/accounts/list": {
972
+ scope: "deployment",
973
+ access: {"kind":"deployment"},
974
+ summary: "List channel accounts across universes",
975
+ description: "The connector host's discovery call: every enabled provider account of the deployment with its universe id and credential grant reference. Re-poll to pick up accounts created or disabled since.",
976
+ },
977
+ } as const;
978
+
979
+ export const NOTIFICATIONS = [
980
+ "session/started",
981
+ "session/status/changed",
982
+ "session/event",
983
+ "session/runs/started",
984
+ "session/runs/completed",
985
+ "error",
986
+ ] as const;
987
+
988
+ export type Method = (typeof METHODS)[number];
989
+ export type NotificationMethod = (typeof NOTIFICATIONS)[number];
990
+
991
+ export interface MethodMap {
992
+ /**
993
+ * Read a workspace file
994
+ *
995
+ * Reads bytes at a path in the current workspace head.
996
+ */
997
+ "vfs/workspaces/files/read": {
998
+ params: Api.VfsWorkspaceFileReadParams;
999
+ result: Api.AgentApiOutcomeOfBlobReadResponse;
1000
+ };
1001
+ /**
1002
+ * Inspect the Lightspeed protocol
1003
+ *
1004
+ * Returns protocol version, server identity, credential scope and allowed groups before universe selection. Requires authentication in authenticated mode; no universe header is accepted.
1005
+ */
1006
+ "initialize": {
1007
+ params: Api.InitializeParams;
1008
+ result: Api.AgentApiOutcomeOfInitializeResponse;
1009
+ };
1010
+ /**
1011
+ * Create or reopen a session
1012
+ *
1013
+ * Creates a session, unshared unless access says universe, with optional config/profile setup. Profile metadata and retention supply defaults that explicit values override; the config's default environment attachment becomes active. Retrying an existing id returns that session and keeps its audience.
1014
+ */
1015
+ "session/start": {
1016
+ params: Api.SessionStartParams;
1017
+ result: Api.AgentApiOutcomeOfSessionStartResponse;
1018
+ };
1019
+ /**
1020
+ * Create or reopen a managed session
1021
+ *
1022
+ * Creates a session with immutable lifecycle and workflow-tool declarations using explicit bound dispatch. Profile metadata, retention, and default environment attachment selection follow session/start semantics. Retrying an id requires the same managed declaration; an ordinary session cannot be upgraded.
1023
+ */
1024
+ "session/managed/start": {
1025
+ params: Api.ManagedSessionStartParams;
1026
+ result: Api.AgentApiOutcomeOfSessionStartResponse;
1027
+ };
1028
+ /**
1029
+ * Read a session
1030
+ *
1031
+ * Returns current state plus a bounded newest-first run-summary page. Follow nextRunCursor with session/runs/list when hasOlderRuns is true; use session/events/read for the transcript.
1032
+ */
1033
+ "session/read": {
1034
+ params: Api.SessionReadParams;
1035
+ result: Api.AgentApiOutcomeOfSessionReadResponse;
1036
+ };
1037
+ /**
1038
+ * List sessions
1039
+ *
1040
+ * Returns a cursor-paginated summary list ordered by most recent update, optionally narrowed by the audience of each session's root: createdBy, visibility, or visibleTo (shared with the universe or created by that actor). Pages may shift while sessions are changing.
1041
+ */
1042
+ "session/list": {
1043
+ params: Api.SessionListParams;
1044
+ result: Api.AgentApiOutcomeOfSessionListResponse;
1045
+ };
1046
+ /**
1047
+ * Replace session configuration
1048
+ *
1049
+ * Replaces the complete sparse config while the session is idle. Use the current config revision for safe read-modify-write; omitted features are revoked, an omitted model preserves the current model, and an identical document is a no-op.
1050
+ */
1051
+ "session/config/put": {
1052
+ params: Api.SessionConfigPutParams;
1053
+ result: Api.AgentApiOutcomeOfSessionConfigPutResponse;
1054
+ };
1055
+ /**
1056
+ * Rename a session
1057
+ *
1058
+ * Sets the display name, or clears it when displayName is omitted.
1059
+ */
1060
+ "session/rename": {
1061
+ params: Api.SessionRenameParams;
1062
+ result: Api.AgentApiOutcomeOfSessionRenameResponse;
1063
+ };
1064
+ /**
1065
+ * Replace session metadata
1066
+ *
1067
+ * Replaces the complete descriptive key/value map (bounded like session/start); an omitted or empty map clears it. Record-only: the event log and updatedAtMs are untouched.
1068
+ */
1069
+ "session/metadata/put": {
1070
+ params: Api.SessionMetadataPutParams;
1071
+ result: Api.AgentApiOutcomeOfSessionMetadataPutResponse;
1072
+ };
1073
+ /**
1074
+ * Replace session retention
1075
+ *
1076
+ * Sets the positive close-relative automatic-deletion duration on a retention root, or clears it with null. Forks and delegated children inherit the root policy and cannot override it.
1077
+ */
1078
+ "session/retention/put": {
1079
+ params: Api.SessionRetentionPutParams;
1080
+ result: Api.AgentApiOutcomeOfSessionRetentionPutResponse;
1081
+ };
1082
+ /**
1083
+ * Close a session
1084
+ *
1085
+ * Closes an idle session and detaches its environment bindings. Force mode cancels active work, drops queued runs, and can recover a session whose workflow is unavailable.
1086
+ */
1087
+ "session/close": {
1088
+ params: Api.SessionCloseParams;
1089
+ result: Api.AgentApiOutcomeOfSessionCloseResponse;
1090
+ };
1091
+ /**
1092
+ * Delete closed sessions
1093
+ *
1094
+ * Permanently removes a closed retention-tree leaf, or its closed history-fork and delegated-child subtree when cascade is true. Config-only clones are never included.
1095
+ */
1096
+ "session/delete": {
1097
+ params: Api.SessionDeleteParams;
1098
+ result: Api.AgentApiOutcomeOfSessionDeleteResponse;
1099
+ };
1100
+ /**
1101
+ * Share a session with the universe
1102
+ *
1103
+ * Moves an unshared root session to universe visibility, one way; its delegated children follow it. Refused on a bot's session, a delegated child, and a session already shared. Core applies it for any caller of the method; who may share is the caller's gate's decision.
1104
+ */
1105
+ "session/share": {
1106
+ params: Api.SessionShareParams;
1107
+ result: Api.AgentApiOutcomeOfSessionShareResponse;
1108
+ };
1109
+ /**
1110
+ * Read the session event stream
1111
+ *
1112
+ * Returns chronological events. Forward (default) follows after and supports long-polling. Backward reads the latest window below before (or the head); pass nextCursor as before until complete. Follow live events after the initial backward headCursor. Windows may split runs/tool batches; keep historical reconstruction separate from live controls.
1113
+ */
1114
+ "session/events/read": {
1115
+ params: Api.SessionEventsReadParams;
1116
+ result: Api.AgentApiOutcomeOfSessionEventsReadResponse;
1117
+ };
1118
+ /**
1119
+ * Append keyed session context
1120
+ *
1121
+ * Admits a batch of context entries with per-entry results. Stable keys make same-content retries no-ops; invalid input can fail one entry without discarding successful entries.
1122
+ */
1123
+ "session/context/append": {
1124
+ params: Api.ContextAppendParams;
1125
+ result: Api.AgentApiOutcomeOfContextAppendResponse;
1126
+ };
1127
+ /**
1128
+ * Remove keyed session context
1129
+ *
1130
+ * Removes active entries by stable key with per-key results. Missing keys are idempotent no-ops; runtime-reserved run keys cannot be removed.
1131
+ */
1132
+ "session/context/remove": {
1133
+ params: Api.ContextRemoveParams;
1134
+ result: Api.AgentApiOutcomeOfContextRemoveResponse;
1135
+ };
1136
+ /**
1137
+ * Replace session context entries
1138
+ *
1139
+ * Replaces active tool results and user messages in place by entry id, with per-entry results, e.g. to withdraw content the provider rejects. Entries keep their ids, positions, and kinds, so a tool result takes only text and its call stays answered. Refused while a run is active; ids no longer in context report absent.
1140
+ */
1141
+ "session/context/replace": {
1142
+ params: Api.ContextReplaceParams;
1143
+ result: Api.AgentApiOutcomeOfContextReplaceResponse;
1144
+ };
1145
+ /**
1146
+ * Compact session context
1147
+ *
1148
+ * Performs one standalone compaction in any automatic mode, including Disabled, and waits for completion. Active work queues the operation until a safe turn boundary; automatic policy remains unchanged.
1149
+ */
1150
+ "session/context/compact": {
1151
+ params: Api.ContextCompactParams;
1152
+ result: Api.AgentApiOutcomeOfContextCompactResponse;
1153
+ };
1154
+ /**
1155
+ * Start an agent run
1156
+ *
1157
+ * Accepts input or existing context keys and returns once the run is accepted — queued behind an active run, or running — not when it finishes. Supply submissionId for retry safety, then follow session events or reread the session.
1158
+ */
1159
+ "session/runs/start": {
1160
+ params: Api.RunStartParams;
1161
+ result: Api.AgentApiOutcomeOfRunStartResponse;
1162
+ };
1163
+ /**
1164
+ * List session runs
1165
+ *
1166
+ * Returns a newest-first keyset page of bounded run summaries projected from current reducer state.
1167
+ */
1168
+ "session/runs/list": {
1169
+ params: Api.RunListParams;
1170
+ result: Api.AgentApiOutcomeOfRunListResponse;
1171
+ };
1172
+ /**
1173
+ * Read one session run
1174
+ *
1175
+ * Reads and projects one run from its bounded event interval, paged by event sequence.
1176
+ */
1177
+ "session/runs/read": {
1178
+ params: Api.RunReadParams;
1179
+ result: Api.AgentApiOutcomeOfRunReadResponse;
1180
+ };
1181
+ /**
1182
+ * Cancel a run
1183
+ *
1184
+ * Requests cancellation of the named queued or active run and returns its current projected state; observe session events for terminal completion. In-flight model and tool activity is aborted; no grace turn runs.
1185
+ */
1186
+ "session/runs/cancel": {
1187
+ params: Api.RunCancelParams;
1188
+ result: Api.AgentApiOutcomeOfRunCancelResponse;
1189
+ };
1190
+ /**
1191
+ * Decide pending run approvals
1192
+ *
1193
+ * Approves or rejects pending MCP tool calls on the named active run. Valid decisions apply independently; the run resumes only after every pending approval has a decision.
1194
+ */
1195
+ "session/runs/approvals/decide": {
1196
+ params: Api.RunApprovalsDecideParams;
1197
+ result: Api.AgentApiOutcomeOfRunApprovalsDecideResponse;
1198
+ };
1199
+ /**
1200
+ * Steer the active run
1201
+ *
1202
+ * Injects input into the named active run; the model sees it at the next turn boundary without interrupting the in-flight turn. Accepted while the run is running or parked on an await; rejected for queued, cancelling, or finished runs.
1203
+ */
1204
+ "session/runs/steer": {
1205
+ params: Api.RunSteerParams;
1206
+ result: Api.AgentApiOutcomeOfRunSteerResponse;
1207
+ };
1208
+ /**
1209
+ * List available session skills
1210
+ *
1211
+ * Returns separate VFS and environment catalogs with source, reference, availability, readable skill paths, and warnings. Refreshes only when open with no active or queued run, without waking environments. Absent catalogs are omitted.
1212
+ */
1213
+ "session/skills/list": {
1214
+ params: Api.SkillListParams;
1215
+ result: Api.AgentApiOutcomeOfSkillListResponse;
1216
+ };
1217
+ /**
1218
+ * Apply a profile to a session
1219
+ *
1220
+ * Applies a named or inline profile's config, instructions, and environment setup to an existing session; mutating profile sections require it to be open and idle. Pass current revisions to guard concurrent changes.
1221
+ */
1222
+ "session/profiles/apply": {
1223
+ params: Api.ProfileApplyParams;
1224
+ result: Api.AgentApiOutcomeOfProfileApplyResponse;
1225
+ };
1226
+ /**
1227
+ * Activate a session environment
1228
+ *
1229
+ * Selects an attached, live universe environment for environment-targeted tools while the session is idle.
1230
+ */
1231
+ "session/environments/activate": {
1232
+ params: Api.SessionEnvironmentActivateParams;
1233
+ result: Api.AgentApiOutcomeOfSessionEnvironmentActivateResponse;
1234
+ };
1235
+ /**
1236
+ * Deactivate the session environment
1237
+ *
1238
+ * Clears active environment selection without changing or closing the universe environment.
1239
+ */
1240
+ "session/environments/deactivate": {
1241
+ params: Api.SessionEnvironmentDeactivateParams;
1242
+ result: Api.AgentApiOutcomeOfSessionEnvironmentDeactivateResponse;
1243
+ };
1244
+ /**
1245
+ * Bind a credential into an environment
1246
+ *
1247
+ * Maps an environment variable name to an existing grant/provider/direct-secret handle for a universe environment. Requires configuring the environment and configuring resources in the universe. The response exposes only the source handle, never secret material.
1248
+ */
1249
+ "environments/credentials/bind": {
1250
+ params: Api.EnvironmentCredentialBindParams;
1251
+ result: Api.AgentApiOutcomeOfEnvironmentCredentialBindResponse;
1252
+ };
1253
+ /**
1254
+ * List environment credential bindings
1255
+ *
1256
+ * Returns variable names and credential source handles for a universe environment; resolved secret values are never returned.
1257
+ */
1258
+ "environments/credentials/list": {
1259
+ params: Api.EnvironmentCredentialListParams;
1260
+ result: Api.AgentApiOutcomeOfEnvironmentCredentialListResponse;
1261
+ };
1262
+ /**
1263
+ * Unbind an environment credential
1264
+ *
1265
+ * Removes one variable-to-credential mapping without deleting the underlying grant, provider credential, or secret.
1266
+ */
1267
+ "environments/credentials/unbind": {
1268
+ params: Api.EnvironmentCredentialUnbindParams;
1269
+ result: Api.AgentApiOutcomeOfEnvironmentCredentialUnbindResponse;
1270
+ };
1271
+ /**
1272
+ * Create an environment
1273
+ *
1274
+ * Records an idempotent provisioning intent against an enabled universe binding, attributed to the caller. The provider validates its provider-wide template and provisions through its backend asynchronously.
1275
+ */
1276
+ "environments/create": {
1277
+ params: Api.EnvironmentCreateParams;
1278
+ result: Api.AgentApiOutcomeOfEnvironmentCreateResponse;
1279
+ };
1280
+ /**
1281
+ * Read an environment
1282
+ *
1283
+ * Returns the durable universe resource, source binding, logical lifecycle state, and minimal current-incarnation identity.
1284
+ */
1285
+ "environments/read": {
1286
+ params: Api.EnvironmentReadParams;
1287
+ result: Api.AgentApiOutcomeOfEnvironmentReadResponse;
1288
+ };
1289
+ /**
1290
+ * List environments
1291
+ *
1292
+ * Lists the universe environments, optionally filtered by provider, binding, or logical lifecycle state.
1293
+ */
1294
+ "environments/list": {
1295
+ params: Api.EnvironmentListParams;
1296
+ result: Api.AgentApiOutcomeOfEnvironmentListResponse;
1297
+ };
1298
+ /**
1299
+ * Close an environment
1300
+ *
1301
+ * Records an asynchronous idempotent close intent. Provider cleanup is resumed by lifecycle reconciliation; quota is released only after Closed.
1302
+ */
1303
+ "environments/close": {
1304
+ params: Api.EnvironmentCloseParams;
1305
+ result: Api.AgentApiOutcomeOfEnvironmentCloseResponse;
1306
+ };
1307
+ /**
1308
+ * Register an external environment
1309
+ *
1310
+ * Creates an environment backed by a Lightspeed-reachable envd WebSocket endpoint, attributed to the caller. Reachability is checked on demand.
1311
+ */
1312
+ "environments/external/create": {
1313
+ params: Api.EnvironmentExternalCreateParams;
1314
+ result: Api.AgentApiOutcomeOfEnvironmentExternalCreateResponse;
1315
+ };
1316
+ /**
1317
+ * Configure environment public ingress
1318
+ *
1319
+ * Synchronously enables or disables one provider-authorized HTTPS endpoint for a provisioned environment. The provider owns hostname allocation, the approved guest port, routing, TLS, and health.
1320
+ */
1321
+ "environments/ingress/put": {
1322
+ params: Api.EnvironmentIngressPutParams;
1323
+ result: Api.AgentApiOutcomeOfEnvironmentIngressPutResponse;
1324
+ };
1325
+ /**
1326
+ * Set environment power intent
1327
+ *
1328
+ * Records the desired power state (running, paused, suspended, or stopped) of a provisioned environment; the lifecycle reconciler converges the provider target asynchronously. Powered-down environments wake transparently on their next use. Rejected when the provider does not support the state.
1329
+ */
1330
+ "environments/power/put": {
1331
+ params: Api.EnvironmentPowerPutParams;
1332
+ result: Api.AgentApiOutcomeOfEnvironmentPowerPutResponse;
1333
+ };
1334
+ /**
1335
+ * Set environment idle policy
1336
+ *
1337
+ * Replaces or clears the staged idle policy of a provisioned environment. The power reaper measures the daemon's idle duration against the pause/suspend/stop/close thresholds and escalates through the stages the provider supports.
1338
+ */
1339
+ "environments/idle-policy/put": {
1340
+ params: Api.EnvironmentIdlePolicyPutParams;
1341
+ result: Api.AgentApiOutcomeOfEnvironmentIdlePolicyPutResponse;
1342
+ };
1343
+ /**
1344
+ * List environment provider bindings
1345
+ *
1346
+ * Lists this universe's revisioned routing and admission bindings to deployment-scoped physical providers.
1347
+ */
1348
+ "environments/provider-bindings/list": {
1349
+ params: Api.EnvironmentProviderBindingListParams;
1350
+ result: Api.AgentApiOutcomeOfEnvironmentProviderBindingListResponse;
1351
+ };
1352
+ /**
1353
+ * Read an environment provider binding
1354
+ *
1355
+ * Returns one universe routing and admission binding. Provider-wide templates and physical resource, network, and ingress policy remain provider-owned.
1356
+ */
1357
+ "environments/provider-bindings/read": {
1358
+ params: Api.EnvironmentProviderBindingReadParams;
1359
+ result: Api.AgentApiOutcomeOfEnvironmentProviderBindingReadResponse;
1360
+ };
1361
+ /**
1362
+ * List environment templates
1363
+ *
1364
+ * Reads immutable templates directly from the selected bound provider controller.
1365
+ */
1366
+ "environments/templates/list": {
1367
+ params: Api.EnvironmentTemplateListParams;
1368
+ result: Api.AgentApiOutcomeOfEnvironmentTemplateListResponse;
1369
+ };
1370
+ /**
1371
+ * Read an environment template
1372
+ *
1373
+ * Returns one immutable template version from the selected bound provider controller.
1374
+ */
1375
+ "environments/templates/read": {
1376
+ params: Api.EnvironmentTemplateReadParams;
1377
+ result: Api.AgentApiOutcomeOfEnvironmentTemplateReadResponse;
1378
+ };
1379
+ /**
1380
+ * Create environment jobs
1381
+ *
1382
+ * Starts a dependency-aware job group on one environment instance, injecting the environment's configured credentials at provider start. requestId is the retry identity; jobs are owned by the instance rather than a session. A powered-down environment is woken on use: the call fails with environment_not_ready while the wake is in progress; retry with backoff.
1383
+ */
1384
+ "environments/jobs/create": {
1385
+ params: Api.EnvironmentJobCreateParams;
1386
+ result: Api.AgentApiOutcomeOfEnvironmentJobCreateResponse;
1387
+ };
1388
+ /**
1389
+ * Read environment jobs
1390
+ *
1391
+ * Reads selected job handles with bounded output, optional sequence continuation, and optional artifacts; use returned status/sequence data for polling.
1392
+ */
1393
+ "environments/jobs/read": {
1394
+ params: Api.EnvironmentJobReadParams;
1395
+ result: Api.AgentApiOutcomeOfEnvironmentJobReadResponse;
1396
+ };
1397
+ /**
1398
+ * Cancel environment jobs
1399
+ *
1400
+ * Requests cancellation for selected jobs, optionally including dependents. Force is provider-specific escalation; inspect each per-job result.
1401
+ */
1402
+ "environments/jobs/cancel": {
1403
+ params: Api.EnvironmentJobCancelParams;
1404
+ result: Api.AgentApiOutcomeOfEnvironmentJobCancelResponse;
1405
+ };
1406
+ /**
1407
+ * Mint an environment registration key
1408
+ *
1409
+ * Creates a reusable universe-scoped key that lets outbound envd daemons register as environments. The plaintext secret is returned exactly once; only its hash is stored. Identity mode, active limit, disconnect grace, and expiry are the key's policy. Treat the secret like a cluster-join credential.
1410
+ */
1411
+ "environments/registration-keys/create": {
1412
+ params: Api.EnvironmentRegistrationKeyCreateParams;
1413
+ result: Api.AgentApiOutcomeOfEnvironmentRegistrationKeyCreateResponse;
1414
+ };
1415
+ /**
1416
+ * Read an environment registration key
1417
+ *
1418
+ * Returns the key's display prefix, policy, status, and derived environment counts; never the secret or its hash.
1419
+ */
1420
+ "environments/registration-keys/read": {
1421
+ params: Api.EnvironmentRegistrationKeyReadParams;
1422
+ result: Api.AgentApiOutcomeOfEnvironmentRegistrationKeyReadResponse;
1423
+ };
1424
+ /**
1425
+ * List environment registration keys
1426
+ *
1427
+ * Lists this universe's registration keys with policy, status, and derived counts. Each key is the group of the environments it admitted.
1428
+ */
1429
+ "environments/registration-keys/list": {
1430
+ params: Api.EnvironmentRegistrationKeyListParams;
1431
+ result: Api.AgentApiOutcomeOfEnvironmentRegistrationKeyListResponse;
1432
+ };
1433
+ /**
1434
+ * Revoke an environment registration key
1435
+ *
1436
+ * Stops the key from admitting new daemon identities; already registered daemons keep reconnecting. With closeEnvironments, also closes every non-closed environment the key admitted. Idempotent.
1437
+ */
1438
+ "environments/registration-keys/revoke": {
1439
+ params: Api.EnvironmentRegistrationKeyRevokeParams;
1440
+ result: Api.AgentApiOutcomeOfEnvironmentRegistrationKeyRevokeResponse;
1441
+ };
1442
+ /**
1443
+ * Start transcription
1444
+ *
1445
+ * Admit or rejoin a requester-scoped audio transcription. The resolved model is immutable. No session or run is created.
1446
+ */
1447
+ "transcriptions/start": {
1448
+ params: Api.TranscriptionStartParams;
1449
+ result: Api.AgentApiOutcomeOfTranscriptionResponse;
1450
+ };
1451
+ /**
1452
+ * Read transcription
1453
+ *
1454
+ * Read status and transcript text. An asserted actor may only read their own drafts; direct universe keys retain method-group authority. Unsubmitted CAS results may expire.
1455
+ */
1456
+ "transcriptions/read": {
1457
+ params: Api.TranscriptionReadParams;
1458
+ result: Api.AgentApiOutcomeOfTranscriptionResponse;
1459
+ };
1460
+ /**
1461
+ * Cancel transcription
1462
+ *
1463
+ * Cancel unfinished transcription. Repeated cancellation is safe; completed results remain unchanged. An asserted actor may only cancel their own drafts; direct universe keys retain method-group authority.
1464
+ */
1465
+ "transcriptions/cancel": {
1466
+ params: Api.TranscriptionCancelParams;
1467
+ result: Api.AgentApiOutcomeOfTranscriptionResponse;
1468
+ };
1469
+ /**
1470
+ * Read universe model defaults
1471
+ *
1472
+ * Returns the revision and independent agentRun and speechToText selections. Revision zero means no update has been made. Does not contact model providers.
1473
+ */
1474
+ "models/defaults/read": {
1475
+ params: Api.ModelDefaultsReadParams;
1476
+ result: Api.AgentApiOutcomeOfModelDefaultsResponse;
1477
+ };
1478
+ /**
1479
+ * Set a universe model default
1480
+ *
1481
+ * Sets or explicitly clears one purpose slot using its current expected revision. Existing sessions and admitted work keep their model. Validates the purpose and protocol without contacting provider discovery.
1482
+ */
1483
+ "models/defaults/put": {
1484
+ params: Api.ModelDefaultsPutParams;
1485
+ result: Api.AgentApiOutcomeOfModelDefaultsResponse;
1486
+ };
1487
+ /**
1488
+ * Discover available models
1489
+ *
1490
+ * Queries supported providers directly, with a brief process-local burst cache, and returns best-effort selectable routes. One provider failure does not discard successful results from others.
1491
+ */
1492
+ "models/list": {
1493
+ params: Api.ModelListParams;
1494
+ result: Api.AgentApiOutcomeOfModelListResponse;
1495
+ };
1496
+ /**
1497
+ * Create an agent profile
1498
+ *
1499
+ * Creates a new universe-scoped reusable profile document; use profiles/put for create-or-replace revision semantics.
1500
+ */
1501
+ "profiles/create": {
1502
+ params: Api.ProfileCreateParams;
1503
+ result: Api.AgentApiOutcomeOfProfileCreateResponse;
1504
+ };
1505
+ /**
1506
+ * Read an agent profile
1507
+ *
1508
+ * Returns the complete profile document and current revision.
1509
+ */
1510
+ "profiles/read": {
1511
+ params: Api.ProfileReadParams;
1512
+ result: Api.AgentApiOutcomeOfProfileReadResponse;
1513
+ };
1514
+ /**
1515
+ * List agent profiles
1516
+ *
1517
+ * Returns lightweight summaries of universe-scoped reusable profiles.
1518
+ */
1519
+ "profiles/list": {
1520
+ params: Api.ProfileListParams;
1521
+ result: Api.AgentApiOutcomeOfProfileListResponse;
1522
+ };
1523
+ /**
1524
+ * Create or replace an agent profile
1525
+ *
1526
+ * Stores the complete profile document. Use expectedRevision from profiles/read when replacing to prevent lost updates; absence writes unconditionally.
1527
+ */
1528
+ "profiles/put": {
1529
+ params: Api.ProfilePutParams;
1530
+ result: Api.AgentApiOutcomeOfProfilePutResponse;
1531
+ };
1532
+ /**
1533
+ * Delete an agent profile
1534
+ *
1535
+ * Deletes the catalog document; sessions previously created or configured from it retain their materialized state.
1536
+ */
1537
+ "profiles/delete": {
1538
+ params: Api.ProfileDeleteParams;
1539
+ result: Api.AgentApiOutcomeOfProfileDeleteResponse;
1540
+ };
1541
+ /**
1542
+ * Store content-addressed blobs
1543
+ *
1544
+ * Decodes and stores a batch of base64 payloads, returning immutable content references in request order. Re-uploading identical bytes is naturally deduplicated.
1545
+ */
1546
+ "blobs/put": {
1547
+ params: Api.BlobPutParams;
1548
+ result: Api.AgentApiOutcomeOfBlobPutResponse;
1549
+ };
1550
+ /**
1551
+ * Read a content-addressed blob
1552
+ *
1553
+ * Returns the complete immutable blob of this universe as base64; large values count against gateway and MCP response limits.
1554
+ */
1555
+ "blobs/read": {
1556
+ params: Api.BlobReadParams;
1557
+ result: Api.AgentApiOutcomeOfBlobReadResponse;
1558
+ };
1559
+ /**
1560
+ * Check blob availability
1561
+ *
1562
+ * Checks a batch of content references without returning blob bodies, preserving request order.
1563
+ */
1564
+ "blobs/has": {
1565
+ params: Api.BlobHasParams;
1566
+ result: Api.AgentApiOutcomeOfBlobHasResponse;
1567
+ };
1568
+ /**
1569
+ * Commit a VFS snapshot
1570
+ *
1571
+ * Validates and stores an immutable filesystem manifest. Upload referenced file blobs first; the returned snapshot ref is content-addressed.
1572
+ */
1573
+ "vfs/snapshots/commit": {
1574
+ params: Api.VfsSnapshotCommitParams;
1575
+ result: Api.AgentApiOutcomeOfVfsSnapshotCommitResponse;
1576
+ };
1577
+ /**
1578
+ * Read a VFS snapshot
1579
+ *
1580
+ * Returns an immutable snapshot manifest and aggregate file/byte counts; file bodies remain separate blobs.
1581
+ */
1582
+ "vfs/snapshots/read": {
1583
+ params: Api.VfsSnapshotReadParams;
1584
+ result: Api.AgentApiOutcomeOfVfsSnapshotReadResponse;
1585
+ };
1586
+ /**
1587
+ * Create a mutable VFS workspace
1588
+ *
1589
+ * Creates a universe workspace attributed to the caller at an optional seed snapshot; absence starts from a server-created empty snapshot.
1590
+ */
1591
+ "vfs/workspaces/create": {
1592
+ params: Api.VfsWorkspaceCreateParams;
1593
+ result: Api.AgentApiOutcomeOfVfsWorkspaceCreateResponse;
1594
+ };
1595
+ /**
1596
+ * Read a VFS workspace
1597
+ *
1598
+ * Returns workspace metadata, current head snapshot, and revision for safe updates.
1599
+ */
1600
+ "vfs/workspaces/read": {
1601
+ params: Api.VfsWorkspaceReadParams;
1602
+ result: Api.AgentApiOutcomeOfVfsWorkspaceReadResponse;
1603
+ };
1604
+ /**
1605
+ * List VFS workspaces
1606
+ *
1607
+ * Lists the mutable universe workspaces with head snapshots, sizes, and revisions.
1608
+ */
1609
+ "vfs/workspaces/list": {
1610
+ params: Api.VfsWorkspaceListParams;
1611
+ result: Api.AgentApiOutcomeOfVfsWorkspaceListResponse;
1612
+ };
1613
+ /**
1614
+ * Update a VFS workspace
1615
+ *
1616
+ * Moves the workspace head to an existing snapshot, which requires use of the workspace, and updates its display name, which requires configuring it. Pass expectedRevision from a read to prevent lost updates.
1617
+ */
1618
+ "vfs/workspaces/update": {
1619
+ params: Api.VfsWorkspaceUpdateParams;
1620
+ result: Api.AgentApiOutcomeOfVfsWorkspaceUpdateResponse;
1621
+ };
1622
+ /**
1623
+ * Delete a VFS workspace
1624
+ *
1625
+ * Deletes the mutable workspace record; immutable snapshots and blobs remain content-addressed resources.
1626
+ */
1627
+ "vfs/workspaces/delete": {
1628
+ params: Api.VfsWorkspaceDeleteParams;
1629
+ result: Api.AgentApiOutcomeOfVfsWorkspaceDeleteResponse;
1630
+ };
1631
+ /**
1632
+ * Create or replace an MCP server record
1633
+ *
1634
+ * Stores the complete catalog document with its optional auth-grant credential. A new server is attributed to the caller. Use expectedRevision when replacing; token material is never accepted or returned.
1635
+ */
1636
+ "mcp/servers/put": {
1637
+ params: Api.McpServerPutParams;
1638
+ result: Api.AgentApiOutcomeOfMcpServerPutResponse;
1639
+ };
1640
+ /**
1641
+ * Discover MCP server authentication
1642
+ *
1643
+ * Looks for standards-based OAuth protected-resource metadata without creating a server, OAuth client, flow, or grant. An absent OAuth result is inconclusive and callers must allow manual auth selection.
1644
+ */
1645
+ "mcp/servers/auth/discover": {
1646
+ params: Api.McpServerAuthDiscoverParams;
1647
+ result: Api.AgentApiOutcomeOfMcpServerAuthDiscoverResponse;
1648
+ };
1649
+ /**
1650
+ * Discover MCP server tools
1651
+ *
1652
+ * Connects directly to the configured MCP server with its current universe credential and returns one bounded live tools/list result. The inventory is never persisted or cached and no tool is invoked.
1653
+ */
1654
+ "mcp/servers/tools/discover": {
1655
+ params: Api.McpServerToolsDiscoverParams;
1656
+ result: Api.AgentApiOutcomeOfMcpServerToolsDiscoverResponse;
1657
+ };
1658
+ /**
1659
+ * Read an MCP server record
1660
+ *
1661
+ * Returns one catalog document with defaults, auth policy, non-secret grant binding, status, and revision; no credential value is exposed.
1662
+ */
1663
+ "mcp/servers/read": {
1664
+ params: Api.McpServerReadParams;
1665
+ result: Api.AgentApiOutcomeOfMcpServerReadResponse;
1666
+ };
1667
+ /**
1668
+ * List MCP server records
1669
+ *
1670
+ * Lists the universe catalog entries, optionally filtered by lifecycle/configuration status.
1671
+ */
1672
+ "mcp/servers/list": {
1673
+ params: Api.McpServerListParams;
1674
+ result: Api.AgentApiOutcomeOfMcpServerListResponse;
1675
+ };
1676
+ /**
1677
+ * Delete an MCP server record
1678
+ *
1679
+ * Deletes the catalog document. Existing session configs that reference it are not silently rewritten and may need explicit reconfiguration.
1680
+ */
1681
+ "mcp/servers/delete": {
1682
+ params: Api.McpServerDeleteParams;
1683
+ result: Api.AgentApiOutcomeOfMcpServerDeleteResponse;
1684
+ };
1685
+ /**
1686
+ * Import a static bearer grant
1687
+ *
1688
+ * Accepts a plaintext token, encrypts it immediately, and returns only grant metadata/token-presence flags. Brokered is the default; retrievable exposure is immutable and permits service-only leases.
1689
+ */
1690
+ "auth/grants/import": {
1691
+ params: Api.AuthGrantImportParams;
1692
+ result: Api.AgentApiOutcomeOfAuthGrantImportResponse;
1693
+ };
1694
+ /**
1695
+ * Lease a retrievable authentication grant
1696
+ *
1697
+ * Service callers only. Resolves the current access token through the broker, records the lease, and returns it once. Cache only in memory until expiry minus margin (or at most five minutes without expiry), re-lease after target 401/403, and never persist or place the token in workflow payloads.
1698
+ */
1699
+ "auth/grants/lease": {
1700
+ params: Api.AuthGrantLeaseParams;
1701
+ result: Api.AgentApiOutcomeOfAuthGrantLeaseResponse;
1702
+ };
1703
+ /**
1704
+ * Read authentication grant metadata
1705
+ *
1706
+ * Returns creator attribution, provider binding, scopes, audience, expiry, status, and token-presence flags; access and refresh token values are never returned.
1707
+ */
1708
+ "auth/grants/read": {
1709
+ params: Api.AuthGrantReadParams;
1710
+ result: Api.AgentApiOutcomeOfAuthGrantReadResponse;
1711
+ };
1712
+ /**
1713
+ * List authentication grants
1714
+ *
1715
+ * Lists non-secret grant metadata for the universe, optionally filtered by status.
1716
+ */
1717
+ "auth/grants/list": {
1718
+ params: Api.AuthGrantListParams;
1719
+ result: Api.AgentApiOutcomeOfAuthGrantListResponse;
1720
+ };
1721
+ /**
1722
+ * Revoke an authentication grant
1723
+ *
1724
+ * Marks the grant unusable by token consumers while retaining non-secret audit metadata.
1725
+ */
1726
+ "auth/grants/revoke": {
1727
+ params: Api.AuthGrantRevokeParams;
1728
+ result: Api.AgentApiOutcomeOfAuthGrantRevokeResponse;
1729
+ };
1730
+ /**
1731
+ * Register an OAuth client
1732
+ *
1733
+ * Stores provider endpoints and client identity; an optional plaintext client secret is encrypted and represented thereafter only by hasClientSecret.
1734
+ */
1735
+ "auth/clients/create": {
1736
+ params: Api.AuthClientCreateParams;
1737
+ result: Api.AgentApiOutcomeOfAuthClientCreateResponse;
1738
+ };
1739
+ /**
1740
+ * Read OAuth client metadata
1741
+ *
1742
+ * Returns endpoints, public client identity, defaults, and secret-presence state; the client secret is never returned.
1743
+ */
1744
+ "auth/clients/read": {
1745
+ params: Api.AuthClientReadParams;
1746
+ result: Api.AgentApiOutcomeOfAuthClientReadResponse;
1747
+ };
1748
+ /**
1749
+ * List OAuth clients
1750
+ *
1751
+ * Lists non-secret OAuth client registrations in the universe.
1752
+ */
1753
+ "auth/clients/list": {
1754
+ params: Api.AuthClientListParams;
1755
+ result: Api.AgentApiOutcomeOfAuthClientListResponse;
1756
+ };
1757
+ /**
1758
+ * Delete an OAuth client
1759
+ *
1760
+ * Deletes the client registration and its stored client secret; grants already created from it remain separate records.
1761
+ */
1762
+ "auth/clients/delete": {
1763
+ params: Api.AuthClientDeleteParams;
1764
+ result: Api.AgentApiOutcomeOfAuthClientDeleteResponse;
1765
+ };
1766
+ /**
1767
+ * Start an OAuth authorization flow
1768
+ *
1769
+ * Creates a short-lived PKCE flow carrying the immutable grant exposure choice and returns a browser authorization URL containing one-time state. Treat the URL as sensitive and poll auth/flows/read for completion.
1770
+ */
1771
+ "auth/flows/start": {
1772
+ params: Api.AuthFlowStartParams;
1773
+ result: Api.AgentApiOutcomeOfAuthFlowStartResponse;
1774
+ };
1775
+ /**
1776
+ * Read OAuth flow status
1777
+ *
1778
+ * Polls a flow's pending/completed/failed/expired state and returns the resulting grant id when authorization succeeds; no token value is exposed.
1779
+ */
1780
+ "auth/flows/read": {
1781
+ params: Api.AuthFlowStatusParams;
1782
+ result: Api.AgentApiOutcomeOfAuthFlowStatusResponse;
1783
+ };
1784
+ /**
1785
+ * Register an authentication provider
1786
+ *
1787
+ * Creates a model or GitHub credential source. Plaintext API keys/private keys are encrypted on receipt and later represented only by configuration plus hasCredential.
1788
+ */
1789
+ "auth/providers/create": {
1790
+ params: Api.AuthProviderCreateParams;
1791
+ result: Api.AgentApiOutcomeOfAuthProviderCreateResponse;
1792
+ };
1793
+ /**
1794
+ * Read authentication provider metadata
1795
+ *
1796
+ * Returns provider kind, non-secret configuration, credential-presence state, and status; stored credentials are never returned.
1797
+ */
1798
+ "auth/providers/read": {
1799
+ params: Api.AuthProviderReadParams;
1800
+ result: Api.AgentApiOutcomeOfAuthProviderReadResponse;
1801
+ };
1802
+ /**
1803
+ * List authentication providers
1804
+ *
1805
+ * Lists non-secret model/GitHub provider registrations for the universe.
1806
+ */
1807
+ "auth/providers/list": {
1808
+ params: Api.AuthProviderListParams;
1809
+ result: Api.AgentApiOutcomeOfAuthProviderListResponse;
1810
+ };
1811
+ /**
1812
+ * Delete an authentication provider
1813
+ *
1814
+ * Deletes the provider registration and its directly stored credential; separately stored grants remain independent records.
1815
+ */
1816
+ "auth/providers/delete": {
1817
+ params: Api.AuthProviderDeleteParams;
1818
+ result: Api.AgentApiOutcomeOfAuthProviderDeleteResponse;
1819
+ };
1820
+ /**
1821
+ * List GitHub App installations
1822
+ *
1823
+ * Uses the registered GitHub App provider credential to query accessible installations and returns account/permission metadata without tokens.
1824
+ */
1825
+ "auth/github/installations/list": {
1826
+ params: Api.AuthGitHubInstallationListParams;
1827
+ result: Api.AgentApiOutcomeOfAuthGitHubInstallationListResponse;
1828
+ };
1829
+ /**
1830
+ * Grant access to a GitHub App installation
1831
+ *
1832
+ * Creates or refreshes a universe auth grant for one accessible installation. The installation token is brokered internally and never returned.
1833
+ */
1834
+ "auth/github/installations/grant": {
1835
+ params: Api.AuthGitHubInstallationGrantParams;
1836
+ result: Api.AgentApiOutcomeOfAuthGitHubInstallationGrantResponse;
1837
+ };
1838
+ /**
1839
+ * Create a bot
1840
+ *
1841
+ * Creates the bot record, optionally with its triggers, and starts its controller. Fails if the bot id exists; a trigger failure rolls the bot back.
1842
+ */
1843
+ "bots/create": {
1844
+ params: Api.BotCreateParams;
1845
+ result: Api.AgentApiOutcomeOfBotCreateResponse;
1846
+ };
1847
+ /**
1848
+ * Create or replace a bot document
1849
+ *
1850
+ * Replaces the mutable configuration whole and signals the controller, which applies it at its next idle boundary. Pass expectedRevision when replacing; a closed bot accepts label-only edits.
1851
+ */
1852
+ "bots/put": {
1853
+ params: Api.BotPutParams;
1854
+ result: Api.AgentApiOutcomeOfBotPutResponse;
1855
+ };
1856
+ /**
1857
+ * Read a bot
1858
+ *
1859
+ * Returns the bot record, its current revision, and lifecycle columns.
1860
+ */
1861
+ "bots/read": {
1862
+ params: Api.BotReadParams;
1863
+ result: Api.AgentApiOutcomeOfBotReadResponse;
1864
+ };
1865
+ /**
1866
+ * List bots
1867
+ *
1868
+ * Returns the roster: every bot with its trigger count, pending event count, and latest event, optionally narrowed by createdBy.
1869
+ */
1870
+ "bots/list": {
1871
+ params: Api.BotListParams;
1872
+ result: Api.AgentApiOutcomeOfBotListResponse;
1873
+ };
1874
+ /**
1875
+ * Close a bot
1876
+ *
1877
+ * Terminal and idempotent: disables every trigger, drops schedules, and tells the controller to archive pending events and force-close its sessions. Returns once signalled; follow bots/state/read for closing to closed.
1878
+ */
1879
+ "bots/close": {
1880
+ params: Api.BotCloseParams;
1881
+ result: Api.AgentApiOutcomeOfBotCloseResponse;
1882
+ };
1883
+ /**
1884
+ * Delete a bot
1885
+ *
1886
+ * Closes the bot if needed, waits for its controller to complete, deletes the sessions it closed, and removes the record so the bot id is free again.
1887
+ */
1888
+ "bots/delete": {
1889
+ params: Api.BotDeleteParams;
1890
+ result: Api.AgentApiOutcomeOfBotDeleteResponse;
1891
+ };
1892
+ /**
1893
+ * Read bot controller state
1894
+ *
1895
+ * Queries the controller workflow for its live snapshot (sessions, buffers, active and recent deliveries, budget) and lists sub-agent descendants. The controller is absent until the bot's first event.
1896
+ */
1897
+ "bots/state/read": {
1898
+ params: Api.BotStateReadParams;
1899
+ result: Api.AgentApiOutcomeOfBotStateReadResponse;
1900
+ };
1901
+ /**
1902
+ * Rotate a bot session
1903
+ *
1904
+ * Asks the controller to close one of the bot's sessions at its next idle boundary and continue on a fresh generation; queued deliveries follow.
1905
+ */
1906
+ "bots/sessions/rotate": {
1907
+ params: Api.BotSessionRotateParams;
1908
+ result: Api.AgentApiOutcomeOfBotSessionRotateResponse;
1909
+ };
1910
+ /**
1911
+ * Create or replace a trigger
1912
+ *
1913
+ * Validates the trigger document (CEL parses, grants exist, one inbox per bot, chat routes per conversation), reconciles its Temporal Schedule, and stores it. A poll spec edit resets the cursor; a webhook keeps its URL token.
1914
+ */
1915
+ "bots/triggers/put": {
1916
+ params: Api.BotTriggerPutParams;
1917
+ result: Api.AgentApiOutcomeOfBotTriggerPutResponse;
1918
+ };
1919
+ /**
1920
+ * Read a trigger
1921
+ *
1922
+ * Returns one trigger with its incidents and cursor; the ingest path and pairing code are included for bot-management callers.
1923
+ */
1924
+ "bots/triggers/read": {
1925
+ params: Api.BotTriggerReadParams;
1926
+ result: Api.AgentApiOutcomeOfBotTriggerReadResponse;
1927
+ };
1928
+ /**
1929
+ * List a bot's triggers
1930
+ *
1931
+ * Returns every trigger of the bot ordered by id, secrets included for bot-management callers.
1932
+ */
1933
+ "bots/triggers/list": {
1934
+ params: Api.BotTriggerListParams;
1935
+ result: Api.AgentApiOutcomeOfBotTriggerListResponse;
1936
+ };
1937
+ /**
1938
+ * Delete a trigger
1939
+ *
1940
+ * Drops the trigger's Temporal Schedule and pairings, then the record; stored events keep their history.
1941
+ */
1942
+ "bots/triggers/delete": {
1943
+ params: Api.BotTriggerDeleteParams;
1944
+ result: Api.AgentApiOutcomeOfBotTriggerDeleteResponse;
1945
+ };
1946
+ /**
1947
+ * Admit an event manually
1948
+ *
1949
+ * Stores an operator-authored event for the bot's main session and wakes the controller. eventId is the dedupe identity; a duplicate returns the stored row.
1950
+ */
1951
+ "bots/events/admit": {
1952
+ params: Api.BotEventAdmitParams;
1953
+ result: Api.AgentApiOutcomeOfBotEventAdmitResponse;
1954
+ };
1955
+ /**
1956
+ * Replay a stored event
1957
+ *
1958
+ * Re-admits the stored envelope as a fresh event with the original routing; the replay never coalesces.
1959
+ */
1960
+ "bots/events/replay": {
1961
+ params: Api.BotEventReplayParams;
1962
+ result: Api.AgentApiOutcomeOfBotEventReplayResponse;
1963
+ };
1964
+ /**
1965
+ * List a bot's events
1966
+ *
1967
+ * Cursor-paginated event log, newest first, with outcomes; payload documents stay in the CAS.
1968
+ */
1969
+ "bots/events/list": {
1970
+ params: Api.BotEventListParams;
1971
+ result: Api.AgentApiOutcomeOfBotEventListResponse;
1972
+ };
1973
+ /**
1974
+ * Read an event by number
1975
+ *
1976
+ * Returns the event row and its full stored envelope document.
1977
+ */
1978
+ "bots/events/read": {
1979
+ params: Api.BotEventReadParams;
1980
+ result: Api.AgentApiOutcomeOfBotEventReadResponse;
1981
+ };
1982
+ /**
1983
+ * Test a CEL filter
1984
+ *
1985
+ * Evaluates a filter against one payload or a sample of recent stored events, reporting matches and evaluation errors without changing anything.
1986
+ */
1987
+ "bots/filters/test": {
1988
+ params: Api.BotFilterTestParams;
1989
+ result: Api.AgentApiOutcomeOfBotFilterTestResponse;
1990
+ };
1991
+ /**
1992
+ * Create a channel account
1993
+ *
1994
+ * Registers a provider account (Telegram, WhatsApp) for this universe. The credential is a retrievable grant reference; no token is accepted here.
1995
+ */
1996
+ "channels/accounts/create": {
1997
+ params: Api.ChannelAccountCreateParams;
1998
+ result: Api.AgentApiOutcomeOfChannelAccountCreateResponse;
1999
+ };
2000
+ /**
2001
+ * Create or replace a channel account
2002
+ *
2003
+ * Replaces the account document whole; pass expectedRevision when replacing. The connector host picks the change up on its next discovery pass.
2004
+ */
2005
+ "channels/accounts/put": {
2006
+ params: Api.ChannelAccountPutParams;
2007
+ result: Api.AgentApiOutcomeOfChannelAccountPutResponse;
2008
+ };
2009
+ /**
2010
+ * Read a channel account
2011
+ *
2012
+ * Returns the account document and revision.
2013
+ */
2014
+ "channels/accounts/read": {
2015
+ params: Api.ChannelAccountReadParams;
2016
+ result: Api.AgentApiOutcomeOfChannelAccountReadResponse;
2017
+ };
2018
+ /**
2019
+ * List channel accounts
2020
+ *
2021
+ * Lists this universe's provider accounts, optionally by provider.
2022
+ */
2023
+ "channels/accounts/list": {
2024
+ params: Api.ChannelAccountListParams;
2025
+ result: Api.AgentApiOutcomeOfChannelAccountListResponse;
2026
+ };
2027
+ /**
2028
+ * Delete a channel account
2029
+ *
2030
+ * Removes the account and its pairings; chat triggers that reference it stop serving conversations.
2031
+ */
2032
+ "channels/accounts/delete": {
2033
+ params: Api.ChannelAccountDeleteParams;
2034
+ result: Api.AgentApiOutcomeOfChannelAccountDeleteResponse;
2035
+ };
2036
+ /**
2037
+ * Admit a provider message
2038
+ *
2039
+ * Service callers only. Resolves the chat trigger for the conversation, applies pairing, and signals the conversation workflow. Returns the decision so the connector can send pairing prompts itself; acknowledge the provider only after this returns.
2040
+ */
2041
+ "channels/inbound/admit": {
2042
+ params: Api.ChannelInboundAdmitParams;
2043
+ result: Api.AgentApiOutcomeOfChannelInboundAdmitResponse;
2044
+ };
2045
+ /**
2046
+ * List chat pairings
2047
+ *
2048
+ * Lists conversations paired to chat triggers, optionally by account or bot.
2049
+ */
2050
+ "channels/pairings/list": {
2051
+ params: Api.ChannelPairingListParams;
2052
+ result: Api.AgentApiOutcomeOfChannelPairingListResponse;
2053
+ };
2054
+ /**
2055
+ * Unpair a conversation
2056
+ *
2057
+ * Removes one pairing; the conversation must present the pairing code again to reconnect.
2058
+ */
2059
+ "channels/pairings/delete": {
2060
+ params: Api.ChannelPairingDeleteParams;
2061
+ result: Api.AgentApiOutcomeOfChannelPairingDeleteResponse;
2062
+ };
2063
+ /**
2064
+ * Read a conversation snapshot
2065
+ *
2066
+ * Queries the conversation workflow's live state for one chat, for debugging; absent when no workflow exists yet.
2067
+ */
2068
+ "channels/conversations/read": {
2069
+ params: Api.ChannelConversationReadParams;
2070
+ result: Api.AgentApiOutcomeOfChannelConversationReadResponse;
2071
+ };
2072
+ /**
2073
+ * List a universe's deployment provider bindings
2074
+ *
2075
+ * Deployment configuration inventory of one universe's provider bindings.
2076
+ */
2077
+ "deployment/environment-provider-bindings/list": {
2078
+ params: Api.DeploymentUniverseReadParams;
2079
+ result: Api.AgentApiOutcomeOfEnvironmentProviderBindingListResponse;
2080
+ };
2081
+ /**
2082
+ * Create a universe
2083
+ *
2084
+ * Creates the deployment tenant boundary for an explicit UUID. The operation is idempotent and reports whether a new universe was created.
2085
+ */
2086
+ "deployment/universes/create": {
2087
+ params: Api.DeploymentUniverseCreateParams;
2088
+ result: Api.AgentApiOutcomeOfDeploymentUniverseCreateResponse;
2089
+ };
2090
+ /**
2091
+ * List universes
2092
+ *
2093
+ * Returns deployment-wide universe summaries with approximate live aggregate counts and last session activity.
2094
+ */
2095
+ "deployment/universes/list": {
2096
+ params: Api.DeploymentUniverseListParams;
2097
+ result: Api.AgentApiOutcomeOfDeploymentUniverseListResponse;
2098
+ };
2099
+ /**
2100
+ * Read a universe
2101
+ *
2102
+ * Returns one deployment tenant summary with aggregate session, workspace, profile, and blob usage.
2103
+ */
2104
+ "deployment/universes/read": {
2105
+ params: Api.DeploymentUniverseReadParams;
2106
+ result: Api.AgentApiOutcomeOfDeploymentUniverseReadResponse;
2107
+ };
2108
+ /**
2109
+ * Set a universe slug
2110
+ *
2111
+ * Sets or changes a deployment-unique slug without changing the universe UUID or resources. The previous slug is released and old URLs may stop working. With onlyIfUnset, a different existing slug is a conflict. Claiming another universe's slug also returns a conflict. Does not create a universe.
2112
+ */
2113
+ "deployment/universes/slug/put": {
2114
+ params: Api.DeploymentUniverseSlugPutParams;
2115
+ result: Api.AgentApiOutcomeOfDeploymentUniverseReadResponse;
2116
+ };
2117
+ /**
2118
+ * Purge a universe
2119
+ *
2120
+ * Permanently terminates live session workflows, deletes external blob objects, and cascades universe data. The purge is resumable/idempotent after partial failure.
2121
+ */
2122
+ "deployment/universes/delete": {
2123
+ params: Api.DeploymentUniverseDeleteParams;
2124
+ result: Api.AgentApiOutcomeOfDeploymentUniverseDeleteResponse;
2125
+ };
2126
+ /**
2127
+ * Create a scoped API key
2128
+ *
2129
+ * Mints a key for a universe or the deployment with the method groups it may call and whether it may assert actors. The plaintext secret is returned exactly once and cannot be recovered; persist only the displayed prefix for identification. Key authority is immutable: revoke and mint to change what one may do.
2130
+ */
2131
+ "deployment/api-keys/create": {
2132
+ params: Api.DeploymentApiKeyCreateParams;
2133
+ result: Api.AgentApiOutcomeOfDeploymentApiKeyCreateResponse;
2134
+ };
2135
+ /**
2136
+ * List scoped API keys
2137
+ *
2138
+ * Returns non-secret key metadata, all keys or those of one scope, including groups, revocation and last-use timestamps. Plaintext secrets are never stored or returned.
2139
+ */
2140
+ "deployment/api-keys/list": {
2141
+ params: Api.DeploymentApiKeyListParams;
2142
+ result: Api.AgentApiOutcomeOfDeploymentApiKeyListResponse;
2143
+ };
2144
+ /**
2145
+ * Rotate a scoped API key
2146
+ *
2147
+ * Atomically replaces an active key secret and display prefix, immediately rejecting the old secret on subsequent requests. Preserves scope, groups, actor authority, name, creator and creation time; clears last use. Returns the new secret once. Unknown or revoked prefixes are not found. Already admitted work continues.
2148
+ */
2149
+ "deployment/api-keys/rotate": {
2150
+ params: Api.DeploymentApiKeyRotateParams;
2151
+ result: Api.AgentApiOutcomeOfDeploymentApiKeyCreateResponse;
2152
+ };
2153
+ /**
2154
+ * Revoke a scoped API key
2155
+ *
2156
+ * Revokes the key with this display prefix; revoking a revoked key keeps its first revocation time. An unknown prefix is not found.
2157
+ */
2158
+ "deployment/api-keys/revoke": {
2159
+ params: Api.DeploymentApiKeyRevokeParams;
2160
+ result: Api.AgentApiOutcomeOfDeploymentApiKeyRevokeResponse;
2161
+ };
2162
+ /**
2163
+ * Put an environment provider
2164
+ *
2165
+ * Registers or replaces one deployment provider and its controller connection. The provider does not call this API or require access to Lightspeed.
2166
+ */
2167
+ "deployment/environment-providers/put": {
2168
+ params: Api.DeploymentEnvironmentProviderPutParams;
2169
+ result: Api.AgentApiOutcomeOfDeploymentEnvironmentProviderPutResponse;
2170
+ };
2171
+ /**
2172
+ * List environment providers
2173
+ *
2174
+ * Returns every deployment-registered deployment provider and its controller connection.
2175
+ */
2176
+ "deployment/environment-providers/list": {
2177
+ params: Api.DeploymentEnvironmentProviderListParams;
2178
+ result: Api.AgentApiOutcomeOfDeploymentEnvironmentProviderListResponse;
2179
+ };
2180
+ /**
2181
+ * Read an environment provider
2182
+ *
2183
+ * Returns one deployment-registered deployment provider and its controller connection.
2184
+ */
2185
+ "deployment/environment-providers/read": {
2186
+ params: Api.DeploymentEnvironmentProviderReadParams;
2187
+ result: Api.AgentApiOutcomeOfDeploymentEnvironmentProviderReadResponse;
2188
+ };
2189
+ /**
2190
+ * Delete an environment provider
2191
+ *
2192
+ * Deletes a deployment provider only when no universe binding references it.
2193
+ */
2194
+ "deployment/environment-providers/delete": {
2195
+ params: Api.DeploymentEnvironmentProviderDeleteParams;
2196
+ result: Api.AgentApiOutcomeOfDeploymentEnvironmentProviderDeleteResponse;
2197
+ };
2198
+ /**
2199
+ * Put an environment provider binding
2200
+ *
2201
+ * Creates or replaces one universe's complete revisioned routing and admission binding. A deployment provider may have at most one binding in a universe.
2202
+ */
2203
+ "deployment/environment-providers/bindings/put": {
2204
+ params: Api.DeploymentProviderBindingPutParams;
2205
+ result: Api.AgentApiOutcomeOfDeploymentProviderBindingPutResponse;
2206
+ };
2207
+ /**
2208
+ * Delete an environment provider binding
2209
+ *
2210
+ * Deletes a universe provider binding only after every referencing environment has reached Closed.
2211
+ */
2212
+ "deployment/environment-providers/bindings/delete": {
2213
+ params: Api.DeploymentProviderBindingDeleteParams;
2214
+ result: Api.AgentApiOutcomeOfDeploymentProviderBindingDeleteResponse;
2215
+ };
2216
+ /**
2217
+ * Adopt a provider environment
2218
+ *
2219
+ * Creates a universe environment by transferring an existing provider target into Lightspeed's managed lifecycle. The caller must explicitly accept ownership transfer.
2220
+ */
2221
+ "deployment/environments/adopt": {
2222
+ params: Api.DeploymentEnvironmentAdoptParams;
2223
+ result: Api.AgentApiOutcomeOfDeploymentEnvironmentAdoptResponse;
2224
+ };
2225
+ /**
2226
+ * List channel accounts across universes
2227
+ *
2228
+ * The connector host's discovery call: every enabled provider account of the deployment with its universe id and credential grant reference. Re-poll to pick up accounts created or disabled since.
2229
+ */
2230
+ "deployment/channels/accounts/list": {
2231
+ params: Api.DeploymentChannelAccountListParams;
2232
+ result: Api.AgentApiOutcomeOfDeploymentChannelAccountListResponse;
2233
+ };
2234
+ }
2235
+
2236
+ export type MethodParams<M extends Method> = MethodMap[M]["params"];
2237
+ export type MethodResult<M extends Method> = MethodMap[M]["result"];
2238
+
2239
+ export interface RpcCaller {
2240
+ call<M extends Method>(method: M, params: MethodParams<M>): Promise<MethodResult<M>>;
2241
+ }
2242
+
2243
+ export const rpc = {
2244
+ /**
2245
+ * Read a workspace file
2246
+ *
2247
+ * Reads bytes at a path in the current workspace head.
2248
+ */
2249
+ vfsWorkspacesFilesRead(client: RpcCaller, params: Api.VfsWorkspaceFileReadParams): Promise<Api.AgentApiOutcomeOfBlobReadResponse> {
2250
+ return client.call("vfs/workspaces/files/read", params);
2251
+ },
2252
+ /**
2253
+ * Inspect the Lightspeed protocol
2254
+ *
2255
+ * Returns protocol version, server identity, credential scope and allowed groups before universe selection. Requires authentication in authenticated mode; no universe header is accepted.
2256
+ */
2257
+ initialize(client: RpcCaller, params: Api.InitializeParams): Promise<Api.AgentApiOutcomeOfInitializeResponse> {
2258
+ return client.call("initialize", params);
2259
+ },
2260
+ /**
2261
+ * Create or reopen a session
2262
+ *
2263
+ * Creates a session, unshared unless access says universe, with optional config/profile setup. Profile metadata and retention supply defaults that explicit values override; the config's default environment attachment becomes active. Retrying an existing id returns that session and keeps its audience.
2264
+ */
2265
+ sessionStart(client: RpcCaller, params: Api.SessionStartParams): Promise<Api.AgentApiOutcomeOfSessionStartResponse> {
2266
+ return client.call("session/start", params);
2267
+ },
2268
+ /**
2269
+ * Create or reopen a managed session
2270
+ *
2271
+ * Creates a session with immutable lifecycle and workflow-tool declarations using explicit bound dispatch. Profile metadata, retention, and default environment attachment selection follow session/start semantics. Retrying an id requires the same managed declaration; an ordinary session cannot be upgraded.
2272
+ */
2273
+ sessionManagedStart(client: RpcCaller, params: Api.ManagedSessionStartParams): Promise<Api.AgentApiOutcomeOfSessionStartResponse> {
2274
+ return client.call("session/managed/start", params);
2275
+ },
2276
+ /**
2277
+ * Read a session
2278
+ *
2279
+ * Returns current state plus a bounded newest-first run-summary page. Follow nextRunCursor with session/runs/list when hasOlderRuns is true; use session/events/read for the transcript.
2280
+ */
2281
+ sessionRead(client: RpcCaller, params: Api.SessionReadParams): Promise<Api.AgentApiOutcomeOfSessionReadResponse> {
2282
+ return client.call("session/read", params);
2283
+ },
2284
+ /**
2285
+ * List sessions
2286
+ *
2287
+ * Returns a cursor-paginated summary list ordered by most recent update, optionally narrowed by the audience of each session's root: createdBy, visibility, or visibleTo (shared with the universe or created by that actor). Pages may shift while sessions are changing.
2288
+ */
2289
+ sessionList(client: RpcCaller, params: Api.SessionListParams): Promise<Api.AgentApiOutcomeOfSessionListResponse> {
2290
+ return client.call("session/list", params);
2291
+ },
2292
+ /**
2293
+ * Replace session configuration
2294
+ *
2295
+ * Replaces the complete sparse config while the session is idle. Use the current config revision for safe read-modify-write; omitted features are revoked, an omitted model preserves the current model, and an identical document is a no-op.
2296
+ */
2297
+ sessionConfigPut(client: RpcCaller, params: Api.SessionConfigPutParams): Promise<Api.AgentApiOutcomeOfSessionConfigPutResponse> {
2298
+ return client.call("session/config/put", params);
2299
+ },
2300
+ /**
2301
+ * Rename a session
2302
+ *
2303
+ * Sets the display name, or clears it when displayName is omitted.
2304
+ */
2305
+ sessionRename(client: RpcCaller, params: Api.SessionRenameParams): Promise<Api.AgentApiOutcomeOfSessionRenameResponse> {
2306
+ return client.call("session/rename", params);
2307
+ },
2308
+ /**
2309
+ * Replace session metadata
2310
+ *
2311
+ * Replaces the complete descriptive key/value map (bounded like session/start); an omitted or empty map clears it. Record-only: the event log and updatedAtMs are untouched.
2312
+ */
2313
+ sessionMetadataPut(client: RpcCaller, params: Api.SessionMetadataPutParams): Promise<Api.AgentApiOutcomeOfSessionMetadataPutResponse> {
2314
+ return client.call("session/metadata/put", params);
2315
+ },
2316
+ /**
2317
+ * Replace session retention
2318
+ *
2319
+ * Sets the positive close-relative automatic-deletion duration on a retention root, or clears it with null. Forks and delegated children inherit the root policy and cannot override it.
2320
+ */
2321
+ sessionRetentionPut(client: RpcCaller, params: Api.SessionRetentionPutParams): Promise<Api.AgentApiOutcomeOfSessionRetentionPutResponse> {
2322
+ return client.call("session/retention/put", params);
2323
+ },
2324
+ /**
2325
+ * Close a session
2326
+ *
2327
+ * Closes an idle session and detaches its environment bindings. Force mode cancels active work, drops queued runs, and can recover a session whose workflow is unavailable.
2328
+ */
2329
+ sessionClose(client: RpcCaller, params: Api.SessionCloseParams): Promise<Api.AgentApiOutcomeOfSessionCloseResponse> {
2330
+ return client.call("session/close", params);
2331
+ },
2332
+ /**
2333
+ * Delete closed sessions
2334
+ *
2335
+ * Permanently removes a closed retention-tree leaf, or its closed history-fork and delegated-child subtree when cascade is true. Config-only clones are never included.
2336
+ */
2337
+ sessionDelete(client: RpcCaller, params: Api.SessionDeleteParams): Promise<Api.AgentApiOutcomeOfSessionDeleteResponse> {
2338
+ return client.call("session/delete", params);
2339
+ },
2340
+ /**
2341
+ * Share a session with the universe
2342
+ *
2343
+ * Moves an unshared root session to universe visibility, one way; its delegated children follow it. Refused on a bot's session, a delegated child, and a session already shared. Core applies it for any caller of the method; who may share is the caller's gate's decision.
2344
+ */
2345
+ sessionShare(client: RpcCaller, params: Api.SessionShareParams): Promise<Api.AgentApiOutcomeOfSessionShareResponse> {
2346
+ return client.call("session/share", params);
2347
+ },
2348
+ /**
2349
+ * Read the session event stream
2350
+ *
2351
+ * Returns chronological events. Forward (default) follows after and supports long-polling. Backward reads the latest window below before (or the head); pass nextCursor as before until complete. Follow live events after the initial backward headCursor. Windows may split runs/tool batches; keep historical reconstruction separate from live controls.
2352
+ */
2353
+ sessionEventsRead(client: RpcCaller, params: Api.SessionEventsReadParams): Promise<Api.AgentApiOutcomeOfSessionEventsReadResponse> {
2354
+ return client.call("session/events/read", params);
2355
+ },
2356
+ /**
2357
+ * Append keyed session context
2358
+ *
2359
+ * Admits a batch of context entries with per-entry results. Stable keys make same-content retries no-ops; invalid input can fail one entry without discarding successful entries.
2360
+ */
2361
+ sessionContextAppend(client: RpcCaller, params: Api.ContextAppendParams): Promise<Api.AgentApiOutcomeOfContextAppendResponse> {
2362
+ return client.call("session/context/append", params);
2363
+ },
2364
+ /**
2365
+ * Remove keyed session context
2366
+ *
2367
+ * Removes active entries by stable key with per-key results. Missing keys are idempotent no-ops; runtime-reserved run keys cannot be removed.
2368
+ */
2369
+ sessionContextRemove(client: RpcCaller, params: Api.ContextRemoveParams): Promise<Api.AgentApiOutcomeOfContextRemoveResponse> {
2370
+ return client.call("session/context/remove", params);
2371
+ },
2372
+ /**
2373
+ * Replace session context entries
2374
+ *
2375
+ * Replaces active tool results and user messages in place by entry id, with per-entry results, e.g. to withdraw content the provider rejects. Entries keep their ids, positions, and kinds, so a tool result takes only text and its call stays answered. Refused while a run is active; ids no longer in context report absent.
2376
+ */
2377
+ sessionContextReplace(client: RpcCaller, params: Api.ContextReplaceParams): Promise<Api.AgentApiOutcomeOfContextReplaceResponse> {
2378
+ return client.call("session/context/replace", params);
2379
+ },
2380
+ /**
2381
+ * Compact session context
2382
+ *
2383
+ * Performs one standalone compaction in any automatic mode, including Disabled, and waits for completion. Active work queues the operation until a safe turn boundary; automatic policy remains unchanged.
2384
+ */
2385
+ sessionContextCompact(client: RpcCaller, params: Api.ContextCompactParams): Promise<Api.AgentApiOutcomeOfContextCompactResponse> {
2386
+ return client.call("session/context/compact", params);
2387
+ },
2388
+ /**
2389
+ * Start an agent run
2390
+ *
2391
+ * Accepts input or existing context keys and returns once the run is accepted — queued behind an active run, or running — not when it finishes. Supply submissionId for retry safety, then follow session events or reread the session.
2392
+ */
2393
+ sessionRunsStart(client: RpcCaller, params: Api.RunStartParams): Promise<Api.AgentApiOutcomeOfRunStartResponse> {
2394
+ return client.call("session/runs/start", params);
2395
+ },
2396
+ /**
2397
+ * List session runs
2398
+ *
2399
+ * Returns a newest-first keyset page of bounded run summaries projected from current reducer state.
2400
+ */
2401
+ sessionRunsList(client: RpcCaller, params: Api.RunListParams): Promise<Api.AgentApiOutcomeOfRunListResponse> {
2402
+ return client.call("session/runs/list", params);
2403
+ },
2404
+ /**
2405
+ * Read one session run
2406
+ *
2407
+ * Reads and projects one run from its bounded event interval, paged by event sequence.
2408
+ */
2409
+ sessionRunsRead(client: RpcCaller, params: Api.RunReadParams): Promise<Api.AgentApiOutcomeOfRunReadResponse> {
2410
+ return client.call("session/runs/read", params);
2411
+ },
2412
+ /**
2413
+ * Cancel a run
2414
+ *
2415
+ * Requests cancellation of the named queued or active run and returns its current projected state; observe session events for terminal completion. In-flight model and tool activity is aborted; no grace turn runs.
2416
+ */
2417
+ sessionRunsCancel(client: RpcCaller, params: Api.RunCancelParams): Promise<Api.AgentApiOutcomeOfRunCancelResponse> {
2418
+ return client.call("session/runs/cancel", params);
2419
+ },
2420
+ /**
2421
+ * Decide pending run approvals
2422
+ *
2423
+ * Approves or rejects pending MCP tool calls on the named active run. Valid decisions apply independently; the run resumes only after every pending approval has a decision.
2424
+ */
2425
+ sessionRunsApprovalsDecide(client: RpcCaller, params: Api.RunApprovalsDecideParams): Promise<Api.AgentApiOutcomeOfRunApprovalsDecideResponse> {
2426
+ return client.call("session/runs/approvals/decide", params);
2427
+ },
2428
+ /**
2429
+ * Steer the active run
2430
+ *
2431
+ * Injects input into the named active run; the model sees it at the next turn boundary without interrupting the in-flight turn. Accepted while the run is running or parked on an await; rejected for queued, cancelling, or finished runs.
2432
+ */
2433
+ sessionRunsSteer(client: RpcCaller, params: Api.RunSteerParams): Promise<Api.AgentApiOutcomeOfRunSteerResponse> {
2434
+ return client.call("session/runs/steer", params);
2435
+ },
2436
+ /**
2437
+ * List available session skills
2438
+ *
2439
+ * Returns separate VFS and environment catalogs with source, reference, availability, readable skill paths, and warnings. Refreshes only when open with no active or queued run, without waking environments. Absent catalogs are omitted.
2440
+ */
2441
+ sessionSkillsList(client: RpcCaller, params: Api.SkillListParams): Promise<Api.AgentApiOutcomeOfSkillListResponse> {
2442
+ return client.call("session/skills/list", params);
2443
+ },
2444
+ /**
2445
+ * Apply a profile to a session
2446
+ *
2447
+ * Applies a named or inline profile's config, instructions, and environment setup to an existing session; mutating profile sections require it to be open and idle. Pass current revisions to guard concurrent changes.
2448
+ */
2449
+ sessionProfilesApply(client: RpcCaller, params: Api.ProfileApplyParams): Promise<Api.AgentApiOutcomeOfProfileApplyResponse> {
2450
+ return client.call("session/profiles/apply", params);
2451
+ },
2452
+ /**
2453
+ * Activate a session environment
2454
+ *
2455
+ * Selects an attached, live universe environment for environment-targeted tools while the session is idle.
2456
+ */
2457
+ sessionEnvironmentsActivate(client: RpcCaller, params: Api.SessionEnvironmentActivateParams): Promise<Api.AgentApiOutcomeOfSessionEnvironmentActivateResponse> {
2458
+ return client.call("session/environments/activate", params);
2459
+ },
2460
+ /**
2461
+ * Deactivate the session environment
2462
+ *
2463
+ * Clears active environment selection without changing or closing the universe environment.
2464
+ */
2465
+ sessionEnvironmentsDeactivate(client: RpcCaller, params: Api.SessionEnvironmentDeactivateParams): Promise<Api.AgentApiOutcomeOfSessionEnvironmentDeactivateResponse> {
2466
+ return client.call("session/environments/deactivate", params);
2467
+ },
2468
+ /**
2469
+ * Bind a credential into an environment
2470
+ *
2471
+ * Maps an environment variable name to an existing grant/provider/direct-secret handle for a universe environment. Requires configuring the environment and configuring resources in the universe. The response exposes only the source handle, never secret material.
2472
+ */
2473
+ environmentsCredentialsBind(client: RpcCaller, params: Api.EnvironmentCredentialBindParams): Promise<Api.AgentApiOutcomeOfEnvironmentCredentialBindResponse> {
2474
+ return client.call("environments/credentials/bind", params);
2475
+ },
2476
+ /**
2477
+ * List environment credential bindings
2478
+ *
2479
+ * Returns variable names and credential source handles for a universe environment; resolved secret values are never returned.
2480
+ */
2481
+ environmentsCredentialsList(client: RpcCaller, params: Api.EnvironmentCredentialListParams): Promise<Api.AgentApiOutcomeOfEnvironmentCredentialListResponse> {
2482
+ return client.call("environments/credentials/list", params);
2483
+ },
2484
+ /**
2485
+ * Unbind an environment credential
2486
+ *
2487
+ * Removes one variable-to-credential mapping without deleting the underlying grant, provider credential, or secret.
2488
+ */
2489
+ environmentsCredentialsUnbind(client: RpcCaller, params: Api.EnvironmentCredentialUnbindParams): Promise<Api.AgentApiOutcomeOfEnvironmentCredentialUnbindResponse> {
2490
+ return client.call("environments/credentials/unbind", params);
2491
+ },
2492
+ /**
2493
+ * Create an environment
2494
+ *
2495
+ * Records an idempotent provisioning intent against an enabled universe binding, attributed to the caller. The provider validates its provider-wide template and provisions through its backend asynchronously.
2496
+ */
2497
+ environmentsCreate(client: RpcCaller, params: Api.EnvironmentCreateParams): Promise<Api.AgentApiOutcomeOfEnvironmentCreateResponse> {
2498
+ return client.call("environments/create", params);
2499
+ },
2500
+ /**
2501
+ * Read an environment
2502
+ *
2503
+ * Returns the durable universe resource, source binding, logical lifecycle state, and minimal current-incarnation identity.
2504
+ */
2505
+ environmentsRead(client: RpcCaller, params: Api.EnvironmentReadParams): Promise<Api.AgentApiOutcomeOfEnvironmentReadResponse> {
2506
+ return client.call("environments/read", params);
2507
+ },
2508
+ /**
2509
+ * List environments
2510
+ *
2511
+ * Lists the universe environments, optionally filtered by provider, binding, or logical lifecycle state.
2512
+ */
2513
+ environmentsList(client: RpcCaller, params: Api.EnvironmentListParams): Promise<Api.AgentApiOutcomeOfEnvironmentListResponse> {
2514
+ return client.call("environments/list", params);
2515
+ },
2516
+ /**
2517
+ * Close an environment
2518
+ *
2519
+ * Records an asynchronous idempotent close intent. Provider cleanup is resumed by lifecycle reconciliation; quota is released only after Closed.
2520
+ */
2521
+ environmentsClose(client: RpcCaller, params: Api.EnvironmentCloseParams): Promise<Api.AgentApiOutcomeOfEnvironmentCloseResponse> {
2522
+ return client.call("environments/close", params);
2523
+ },
2524
+ /**
2525
+ * Register an external environment
2526
+ *
2527
+ * Creates an environment backed by a Lightspeed-reachable envd WebSocket endpoint, attributed to the caller. Reachability is checked on demand.
2528
+ */
2529
+ environmentsExternalCreate(client: RpcCaller, params: Api.EnvironmentExternalCreateParams): Promise<Api.AgentApiOutcomeOfEnvironmentExternalCreateResponse> {
2530
+ return client.call("environments/external/create", params);
2531
+ },
2532
+ /**
2533
+ * Configure environment public ingress
2534
+ *
2535
+ * Synchronously enables or disables one provider-authorized HTTPS endpoint for a provisioned environment. The provider owns hostname allocation, the approved guest port, routing, TLS, and health.
2536
+ */
2537
+ environmentsIngressPut(client: RpcCaller, params: Api.EnvironmentIngressPutParams): Promise<Api.AgentApiOutcomeOfEnvironmentIngressPutResponse> {
2538
+ return client.call("environments/ingress/put", params);
2539
+ },
2540
+ /**
2541
+ * Set environment power intent
2542
+ *
2543
+ * Records the desired power state (running, paused, suspended, or stopped) of a provisioned environment; the lifecycle reconciler converges the provider target asynchronously. Powered-down environments wake transparently on their next use. Rejected when the provider does not support the state.
2544
+ */
2545
+ environmentsPowerPut(client: RpcCaller, params: Api.EnvironmentPowerPutParams): Promise<Api.AgentApiOutcomeOfEnvironmentPowerPutResponse> {
2546
+ return client.call("environments/power/put", params);
2547
+ },
2548
+ /**
2549
+ * Set environment idle policy
2550
+ *
2551
+ * Replaces or clears the staged idle policy of a provisioned environment. The power reaper measures the daemon's idle duration against the pause/suspend/stop/close thresholds and escalates through the stages the provider supports.
2552
+ */
2553
+ environmentsIdlePolicyPut(client: RpcCaller, params: Api.EnvironmentIdlePolicyPutParams): Promise<Api.AgentApiOutcomeOfEnvironmentIdlePolicyPutResponse> {
2554
+ return client.call("environments/idle-policy/put", params);
2555
+ },
2556
+ /**
2557
+ * List environment provider bindings
2558
+ *
2559
+ * Lists this universe's revisioned routing and admission bindings to deployment-scoped physical providers.
2560
+ */
2561
+ environmentsProviderBindingsList(client: RpcCaller, params: Api.EnvironmentProviderBindingListParams): Promise<Api.AgentApiOutcomeOfEnvironmentProviderBindingListResponse> {
2562
+ return client.call("environments/provider-bindings/list", params);
2563
+ },
2564
+ /**
2565
+ * Read an environment provider binding
2566
+ *
2567
+ * Returns one universe routing and admission binding. Provider-wide templates and physical resource, network, and ingress policy remain provider-owned.
2568
+ */
2569
+ environmentsProviderBindingsRead(client: RpcCaller, params: Api.EnvironmentProviderBindingReadParams): Promise<Api.AgentApiOutcomeOfEnvironmentProviderBindingReadResponse> {
2570
+ return client.call("environments/provider-bindings/read", params);
2571
+ },
2572
+ /**
2573
+ * List environment templates
2574
+ *
2575
+ * Reads immutable templates directly from the selected bound provider controller.
2576
+ */
2577
+ environmentsTemplatesList(client: RpcCaller, params: Api.EnvironmentTemplateListParams): Promise<Api.AgentApiOutcomeOfEnvironmentTemplateListResponse> {
2578
+ return client.call("environments/templates/list", params);
2579
+ },
2580
+ /**
2581
+ * Read an environment template
2582
+ *
2583
+ * Returns one immutable template version from the selected bound provider controller.
2584
+ */
2585
+ environmentsTemplatesRead(client: RpcCaller, params: Api.EnvironmentTemplateReadParams): Promise<Api.AgentApiOutcomeOfEnvironmentTemplateReadResponse> {
2586
+ return client.call("environments/templates/read", params);
2587
+ },
2588
+ /**
2589
+ * Create environment jobs
2590
+ *
2591
+ * Starts a dependency-aware job group on one environment instance, injecting the environment's configured credentials at provider start. requestId is the retry identity; jobs are owned by the instance rather than a session. A powered-down environment is woken on use: the call fails with environment_not_ready while the wake is in progress; retry with backoff.
2592
+ */
2593
+ environmentsJobsCreate(client: RpcCaller, params: Api.EnvironmentJobCreateParams): Promise<Api.AgentApiOutcomeOfEnvironmentJobCreateResponse> {
2594
+ return client.call("environments/jobs/create", params);
2595
+ },
2596
+ /**
2597
+ * Read environment jobs
2598
+ *
2599
+ * Reads selected job handles with bounded output, optional sequence continuation, and optional artifacts; use returned status/sequence data for polling.
2600
+ */
2601
+ environmentsJobsRead(client: RpcCaller, params: Api.EnvironmentJobReadParams): Promise<Api.AgentApiOutcomeOfEnvironmentJobReadResponse> {
2602
+ return client.call("environments/jobs/read", params);
2603
+ },
2604
+ /**
2605
+ * Cancel environment jobs
2606
+ *
2607
+ * Requests cancellation for selected jobs, optionally including dependents. Force is provider-specific escalation; inspect each per-job result.
2608
+ */
2609
+ environmentsJobsCancel(client: RpcCaller, params: Api.EnvironmentJobCancelParams): Promise<Api.AgentApiOutcomeOfEnvironmentJobCancelResponse> {
2610
+ return client.call("environments/jobs/cancel", params);
2611
+ },
2612
+ /**
2613
+ * Mint an environment registration key
2614
+ *
2615
+ * Creates a reusable universe-scoped key that lets outbound envd daemons register as environments. The plaintext secret is returned exactly once; only its hash is stored. Identity mode, active limit, disconnect grace, and expiry are the key's policy. Treat the secret like a cluster-join credential.
2616
+ */
2617
+ environmentsRegistrationKeysCreate(client: RpcCaller, params: Api.EnvironmentRegistrationKeyCreateParams): Promise<Api.AgentApiOutcomeOfEnvironmentRegistrationKeyCreateResponse> {
2618
+ return client.call("environments/registration-keys/create", params);
2619
+ },
2620
+ /**
2621
+ * Read an environment registration key
2622
+ *
2623
+ * Returns the key's display prefix, policy, status, and derived environment counts; never the secret or its hash.
2624
+ */
2625
+ environmentsRegistrationKeysRead(client: RpcCaller, params: Api.EnvironmentRegistrationKeyReadParams): Promise<Api.AgentApiOutcomeOfEnvironmentRegistrationKeyReadResponse> {
2626
+ return client.call("environments/registration-keys/read", params);
2627
+ },
2628
+ /**
2629
+ * List environment registration keys
2630
+ *
2631
+ * Lists this universe's registration keys with policy, status, and derived counts. Each key is the group of the environments it admitted.
2632
+ */
2633
+ environmentsRegistrationKeysList(client: RpcCaller, params: Api.EnvironmentRegistrationKeyListParams): Promise<Api.AgentApiOutcomeOfEnvironmentRegistrationKeyListResponse> {
2634
+ return client.call("environments/registration-keys/list", params);
2635
+ },
2636
+ /**
2637
+ * Revoke an environment registration key
2638
+ *
2639
+ * Stops the key from admitting new daemon identities; already registered daemons keep reconnecting. With closeEnvironments, also closes every non-closed environment the key admitted. Idempotent.
2640
+ */
2641
+ environmentsRegistrationKeysRevoke(client: RpcCaller, params: Api.EnvironmentRegistrationKeyRevokeParams): Promise<Api.AgentApiOutcomeOfEnvironmentRegistrationKeyRevokeResponse> {
2642
+ return client.call("environments/registration-keys/revoke", params);
2643
+ },
2644
+ /**
2645
+ * Start transcription
2646
+ *
2647
+ * Admit or rejoin a requester-scoped audio transcription. The resolved model is immutable. No session or run is created.
2648
+ */
2649
+ transcriptionsStart(client: RpcCaller, params: Api.TranscriptionStartParams): Promise<Api.AgentApiOutcomeOfTranscriptionResponse> {
2650
+ return client.call("transcriptions/start", params);
2651
+ },
2652
+ /**
2653
+ * Read transcription
2654
+ *
2655
+ * Read status and transcript text. An asserted actor may only read their own drafts; direct universe keys retain method-group authority. Unsubmitted CAS results may expire.
2656
+ */
2657
+ transcriptionsRead(client: RpcCaller, params: Api.TranscriptionReadParams): Promise<Api.AgentApiOutcomeOfTranscriptionResponse> {
2658
+ return client.call("transcriptions/read", params);
2659
+ },
2660
+ /**
2661
+ * Cancel transcription
2662
+ *
2663
+ * Cancel unfinished transcription. Repeated cancellation is safe; completed results remain unchanged. An asserted actor may only cancel their own drafts; direct universe keys retain method-group authority.
2664
+ */
2665
+ transcriptionsCancel(client: RpcCaller, params: Api.TranscriptionCancelParams): Promise<Api.AgentApiOutcomeOfTranscriptionResponse> {
2666
+ return client.call("transcriptions/cancel", params);
2667
+ },
2668
+ /**
2669
+ * Read universe model defaults
2670
+ *
2671
+ * Returns the revision and independent agentRun and speechToText selections. Revision zero means no update has been made. Does not contact model providers.
2672
+ */
2673
+ modelsDefaultsRead(client: RpcCaller, params: Api.ModelDefaultsReadParams): Promise<Api.AgentApiOutcomeOfModelDefaultsResponse> {
2674
+ return client.call("models/defaults/read", params);
2675
+ },
2676
+ /**
2677
+ * Set a universe model default
2678
+ *
2679
+ * Sets or explicitly clears one purpose slot using its current expected revision. Existing sessions and admitted work keep their model. Validates the purpose and protocol without contacting provider discovery.
2680
+ */
2681
+ modelsDefaultsPut(client: RpcCaller, params: Api.ModelDefaultsPutParams): Promise<Api.AgentApiOutcomeOfModelDefaultsResponse> {
2682
+ return client.call("models/defaults/put", params);
2683
+ },
2684
+ /**
2685
+ * Discover available models
2686
+ *
2687
+ * Queries supported providers directly, with a brief process-local burst cache, and returns best-effort selectable routes. One provider failure does not discard successful results from others.
2688
+ */
2689
+ modelsList(client: RpcCaller, params: Api.ModelListParams): Promise<Api.AgentApiOutcomeOfModelListResponse> {
2690
+ return client.call("models/list", params);
2691
+ },
2692
+ /**
2693
+ * Create an agent profile
2694
+ *
2695
+ * Creates a new universe-scoped reusable profile document; use profiles/put for create-or-replace revision semantics.
2696
+ */
2697
+ profilesCreate(client: RpcCaller, params: Api.ProfileCreateParams): Promise<Api.AgentApiOutcomeOfProfileCreateResponse> {
2698
+ return client.call("profiles/create", params);
2699
+ },
2700
+ /**
2701
+ * Read an agent profile
2702
+ *
2703
+ * Returns the complete profile document and current revision.
2704
+ */
2705
+ profilesRead(client: RpcCaller, params: Api.ProfileReadParams): Promise<Api.AgentApiOutcomeOfProfileReadResponse> {
2706
+ return client.call("profiles/read", params);
2707
+ },
2708
+ /**
2709
+ * List agent profiles
2710
+ *
2711
+ * Returns lightweight summaries of universe-scoped reusable profiles.
2712
+ */
2713
+ profilesList(client: RpcCaller, params: Api.ProfileListParams): Promise<Api.AgentApiOutcomeOfProfileListResponse> {
2714
+ return client.call("profiles/list", params);
2715
+ },
2716
+ /**
2717
+ * Create or replace an agent profile
2718
+ *
2719
+ * Stores the complete profile document. Use expectedRevision from profiles/read when replacing to prevent lost updates; absence writes unconditionally.
2720
+ */
2721
+ profilesPut(client: RpcCaller, params: Api.ProfilePutParams): Promise<Api.AgentApiOutcomeOfProfilePutResponse> {
2722
+ return client.call("profiles/put", params);
2723
+ },
2724
+ /**
2725
+ * Delete an agent profile
2726
+ *
2727
+ * Deletes the catalog document; sessions previously created or configured from it retain their materialized state.
2728
+ */
2729
+ profilesDelete(client: RpcCaller, params: Api.ProfileDeleteParams): Promise<Api.AgentApiOutcomeOfProfileDeleteResponse> {
2730
+ return client.call("profiles/delete", params);
2731
+ },
2732
+ /**
2733
+ * Store content-addressed blobs
2734
+ *
2735
+ * Decodes and stores a batch of base64 payloads, returning immutable content references in request order. Re-uploading identical bytes is naturally deduplicated.
2736
+ */
2737
+ blobsPut(client: RpcCaller, params: Api.BlobPutParams): Promise<Api.AgentApiOutcomeOfBlobPutResponse> {
2738
+ return client.call("blobs/put", params);
2739
+ },
2740
+ /**
2741
+ * Read a content-addressed blob
2742
+ *
2743
+ * Returns the complete immutable blob of this universe as base64; large values count against gateway and MCP response limits.
2744
+ */
2745
+ blobsRead(client: RpcCaller, params: Api.BlobReadParams): Promise<Api.AgentApiOutcomeOfBlobReadResponse> {
2746
+ return client.call("blobs/read", params);
2747
+ },
2748
+ /**
2749
+ * Check blob availability
2750
+ *
2751
+ * Checks a batch of content references without returning blob bodies, preserving request order.
2752
+ */
2753
+ blobsHas(client: RpcCaller, params: Api.BlobHasParams): Promise<Api.AgentApiOutcomeOfBlobHasResponse> {
2754
+ return client.call("blobs/has", params);
2755
+ },
2756
+ /**
2757
+ * Commit a VFS snapshot
2758
+ *
2759
+ * Validates and stores an immutable filesystem manifest. Upload referenced file blobs first; the returned snapshot ref is content-addressed.
2760
+ */
2761
+ vfsSnapshotsCommit(client: RpcCaller, params: Api.VfsSnapshotCommitParams): Promise<Api.AgentApiOutcomeOfVfsSnapshotCommitResponse> {
2762
+ return client.call("vfs/snapshots/commit", params);
2763
+ },
2764
+ /**
2765
+ * Read a VFS snapshot
2766
+ *
2767
+ * Returns an immutable snapshot manifest and aggregate file/byte counts; file bodies remain separate blobs.
2768
+ */
2769
+ vfsSnapshotsRead(client: RpcCaller, params: Api.VfsSnapshotReadParams): Promise<Api.AgentApiOutcomeOfVfsSnapshotReadResponse> {
2770
+ return client.call("vfs/snapshots/read", params);
2771
+ },
2772
+ /**
2773
+ * Create a mutable VFS workspace
2774
+ *
2775
+ * Creates a universe workspace attributed to the caller at an optional seed snapshot; absence starts from a server-created empty snapshot.
2776
+ */
2777
+ vfsWorkspacesCreate(client: RpcCaller, params: Api.VfsWorkspaceCreateParams): Promise<Api.AgentApiOutcomeOfVfsWorkspaceCreateResponse> {
2778
+ return client.call("vfs/workspaces/create", params);
2779
+ },
2780
+ /**
2781
+ * Read a VFS workspace
2782
+ *
2783
+ * Returns workspace metadata, current head snapshot, and revision for safe updates.
2784
+ */
2785
+ vfsWorkspacesRead(client: RpcCaller, params: Api.VfsWorkspaceReadParams): Promise<Api.AgentApiOutcomeOfVfsWorkspaceReadResponse> {
2786
+ return client.call("vfs/workspaces/read", params);
2787
+ },
2788
+ /**
2789
+ * List VFS workspaces
2790
+ *
2791
+ * Lists the mutable universe workspaces with head snapshots, sizes, and revisions.
2792
+ */
2793
+ vfsWorkspacesList(client: RpcCaller, params: Api.VfsWorkspaceListParams): Promise<Api.AgentApiOutcomeOfVfsWorkspaceListResponse> {
2794
+ return client.call("vfs/workspaces/list", params);
2795
+ },
2796
+ /**
2797
+ * Update a VFS workspace
2798
+ *
2799
+ * Moves the workspace head to an existing snapshot, which requires use of the workspace, and updates its display name, which requires configuring it. Pass expectedRevision from a read to prevent lost updates.
2800
+ */
2801
+ vfsWorkspacesUpdate(client: RpcCaller, params: Api.VfsWorkspaceUpdateParams): Promise<Api.AgentApiOutcomeOfVfsWorkspaceUpdateResponse> {
2802
+ return client.call("vfs/workspaces/update", params);
2803
+ },
2804
+ /**
2805
+ * Delete a VFS workspace
2806
+ *
2807
+ * Deletes the mutable workspace record; immutable snapshots and blobs remain content-addressed resources.
2808
+ */
2809
+ vfsWorkspacesDelete(client: RpcCaller, params: Api.VfsWorkspaceDeleteParams): Promise<Api.AgentApiOutcomeOfVfsWorkspaceDeleteResponse> {
2810
+ return client.call("vfs/workspaces/delete", params);
2811
+ },
2812
+ /**
2813
+ * Create or replace an MCP server record
2814
+ *
2815
+ * Stores the complete catalog document with its optional auth-grant credential. A new server is attributed to the caller. Use expectedRevision when replacing; token material is never accepted or returned.
2816
+ */
2817
+ mcpServersPut(client: RpcCaller, params: Api.McpServerPutParams): Promise<Api.AgentApiOutcomeOfMcpServerPutResponse> {
2818
+ return client.call("mcp/servers/put", params);
2819
+ },
2820
+ /**
2821
+ * Discover MCP server authentication
2822
+ *
2823
+ * Looks for standards-based OAuth protected-resource metadata without creating a server, OAuth client, flow, or grant. An absent OAuth result is inconclusive and callers must allow manual auth selection.
2824
+ */
2825
+ mcpServersAuthDiscover(client: RpcCaller, params: Api.McpServerAuthDiscoverParams): Promise<Api.AgentApiOutcomeOfMcpServerAuthDiscoverResponse> {
2826
+ return client.call("mcp/servers/auth/discover", params);
2827
+ },
2828
+ /**
2829
+ * Discover MCP server tools
2830
+ *
2831
+ * Connects directly to the configured MCP server with its current universe credential and returns one bounded live tools/list result. The inventory is never persisted or cached and no tool is invoked.
2832
+ */
2833
+ mcpServersToolsDiscover(client: RpcCaller, params: Api.McpServerToolsDiscoverParams): Promise<Api.AgentApiOutcomeOfMcpServerToolsDiscoverResponse> {
2834
+ return client.call("mcp/servers/tools/discover", params);
2835
+ },
2836
+ /**
2837
+ * Read an MCP server record
2838
+ *
2839
+ * Returns one catalog document with defaults, auth policy, non-secret grant binding, status, and revision; no credential value is exposed.
2840
+ */
2841
+ mcpServersRead(client: RpcCaller, params: Api.McpServerReadParams): Promise<Api.AgentApiOutcomeOfMcpServerReadResponse> {
2842
+ return client.call("mcp/servers/read", params);
2843
+ },
2844
+ /**
2845
+ * List MCP server records
2846
+ *
2847
+ * Lists the universe catalog entries, optionally filtered by lifecycle/configuration status.
2848
+ */
2849
+ mcpServersList(client: RpcCaller, params: Api.McpServerListParams): Promise<Api.AgentApiOutcomeOfMcpServerListResponse> {
2850
+ return client.call("mcp/servers/list", params);
2851
+ },
2852
+ /**
2853
+ * Delete an MCP server record
2854
+ *
2855
+ * Deletes the catalog document. Existing session configs that reference it are not silently rewritten and may need explicit reconfiguration.
2856
+ */
2857
+ mcpServersDelete(client: RpcCaller, params: Api.McpServerDeleteParams): Promise<Api.AgentApiOutcomeOfMcpServerDeleteResponse> {
2858
+ return client.call("mcp/servers/delete", params);
2859
+ },
2860
+ /**
2861
+ * Import a static bearer grant
2862
+ *
2863
+ * Accepts a plaintext token, encrypts it immediately, and returns only grant metadata/token-presence flags. Brokered is the default; retrievable exposure is immutable and permits service-only leases.
2864
+ */
2865
+ authGrantsImport(client: RpcCaller, params: Api.AuthGrantImportParams): Promise<Api.AgentApiOutcomeOfAuthGrantImportResponse> {
2866
+ return client.call("auth/grants/import", params);
2867
+ },
2868
+ /**
2869
+ * Lease a retrievable authentication grant
2870
+ *
2871
+ * Service callers only. Resolves the current access token through the broker, records the lease, and returns it once. Cache only in memory until expiry minus margin (or at most five minutes without expiry), re-lease after target 401/403, and never persist or place the token in workflow payloads.
2872
+ */
2873
+ authGrantsLease(client: RpcCaller, params: Api.AuthGrantLeaseParams): Promise<Api.AgentApiOutcomeOfAuthGrantLeaseResponse> {
2874
+ return client.call("auth/grants/lease", params);
2875
+ },
2876
+ /**
2877
+ * Read authentication grant metadata
2878
+ *
2879
+ * Returns creator attribution, provider binding, scopes, audience, expiry, status, and token-presence flags; access and refresh token values are never returned.
2880
+ */
2881
+ authGrantsRead(client: RpcCaller, params: Api.AuthGrantReadParams): Promise<Api.AgentApiOutcomeOfAuthGrantReadResponse> {
2882
+ return client.call("auth/grants/read", params);
2883
+ },
2884
+ /**
2885
+ * List authentication grants
2886
+ *
2887
+ * Lists non-secret grant metadata for the universe, optionally filtered by status.
2888
+ */
2889
+ authGrantsList(client: RpcCaller, params: Api.AuthGrantListParams): Promise<Api.AgentApiOutcomeOfAuthGrantListResponse> {
2890
+ return client.call("auth/grants/list", params);
2891
+ },
2892
+ /**
2893
+ * Revoke an authentication grant
2894
+ *
2895
+ * Marks the grant unusable by token consumers while retaining non-secret audit metadata.
2896
+ */
2897
+ authGrantsRevoke(client: RpcCaller, params: Api.AuthGrantRevokeParams): Promise<Api.AgentApiOutcomeOfAuthGrantRevokeResponse> {
2898
+ return client.call("auth/grants/revoke", params);
2899
+ },
2900
+ /**
2901
+ * Register an OAuth client
2902
+ *
2903
+ * Stores provider endpoints and client identity; an optional plaintext client secret is encrypted and represented thereafter only by hasClientSecret.
2904
+ */
2905
+ authClientsCreate(client: RpcCaller, params: Api.AuthClientCreateParams): Promise<Api.AgentApiOutcomeOfAuthClientCreateResponse> {
2906
+ return client.call("auth/clients/create", params);
2907
+ },
2908
+ /**
2909
+ * Read OAuth client metadata
2910
+ *
2911
+ * Returns endpoints, public client identity, defaults, and secret-presence state; the client secret is never returned.
2912
+ */
2913
+ authClientsRead(client: RpcCaller, params: Api.AuthClientReadParams): Promise<Api.AgentApiOutcomeOfAuthClientReadResponse> {
2914
+ return client.call("auth/clients/read", params);
2915
+ },
2916
+ /**
2917
+ * List OAuth clients
2918
+ *
2919
+ * Lists non-secret OAuth client registrations in the universe.
2920
+ */
2921
+ authClientsList(client: RpcCaller, params: Api.AuthClientListParams): Promise<Api.AgentApiOutcomeOfAuthClientListResponse> {
2922
+ return client.call("auth/clients/list", params);
2923
+ },
2924
+ /**
2925
+ * Delete an OAuth client
2926
+ *
2927
+ * Deletes the client registration and its stored client secret; grants already created from it remain separate records.
2928
+ */
2929
+ authClientsDelete(client: RpcCaller, params: Api.AuthClientDeleteParams): Promise<Api.AgentApiOutcomeOfAuthClientDeleteResponse> {
2930
+ return client.call("auth/clients/delete", params);
2931
+ },
2932
+ /**
2933
+ * Start an OAuth authorization flow
2934
+ *
2935
+ * Creates a short-lived PKCE flow carrying the immutable grant exposure choice and returns a browser authorization URL containing one-time state. Treat the URL as sensitive and poll auth/flows/read for completion.
2936
+ */
2937
+ authFlowsStart(client: RpcCaller, params: Api.AuthFlowStartParams): Promise<Api.AgentApiOutcomeOfAuthFlowStartResponse> {
2938
+ return client.call("auth/flows/start", params);
2939
+ },
2940
+ /**
2941
+ * Read OAuth flow status
2942
+ *
2943
+ * Polls a flow's pending/completed/failed/expired state and returns the resulting grant id when authorization succeeds; no token value is exposed.
2944
+ */
2945
+ authFlowsRead(client: RpcCaller, params: Api.AuthFlowStatusParams): Promise<Api.AgentApiOutcomeOfAuthFlowStatusResponse> {
2946
+ return client.call("auth/flows/read", params);
2947
+ },
2948
+ /**
2949
+ * Register an authentication provider
2950
+ *
2951
+ * Creates a model or GitHub credential source. Plaintext API keys/private keys are encrypted on receipt and later represented only by configuration plus hasCredential.
2952
+ */
2953
+ authProvidersCreate(client: RpcCaller, params: Api.AuthProviderCreateParams): Promise<Api.AgentApiOutcomeOfAuthProviderCreateResponse> {
2954
+ return client.call("auth/providers/create", params);
2955
+ },
2956
+ /**
2957
+ * Read authentication provider metadata
2958
+ *
2959
+ * Returns provider kind, non-secret configuration, credential-presence state, and status; stored credentials are never returned.
2960
+ */
2961
+ authProvidersRead(client: RpcCaller, params: Api.AuthProviderReadParams): Promise<Api.AgentApiOutcomeOfAuthProviderReadResponse> {
2962
+ return client.call("auth/providers/read", params);
2963
+ },
2964
+ /**
2965
+ * List authentication providers
2966
+ *
2967
+ * Lists non-secret model/GitHub provider registrations for the universe.
2968
+ */
2969
+ authProvidersList(client: RpcCaller, params: Api.AuthProviderListParams): Promise<Api.AgentApiOutcomeOfAuthProviderListResponse> {
2970
+ return client.call("auth/providers/list", params);
2971
+ },
2972
+ /**
2973
+ * Delete an authentication provider
2974
+ *
2975
+ * Deletes the provider registration and its directly stored credential; separately stored grants remain independent records.
2976
+ */
2977
+ authProvidersDelete(client: RpcCaller, params: Api.AuthProviderDeleteParams): Promise<Api.AgentApiOutcomeOfAuthProviderDeleteResponse> {
2978
+ return client.call("auth/providers/delete", params);
2979
+ },
2980
+ /**
2981
+ * List GitHub App installations
2982
+ *
2983
+ * Uses the registered GitHub App provider credential to query accessible installations and returns account/permission metadata without tokens.
2984
+ */
2985
+ authGithubInstallationsList(client: RpcCaller, params: Api.AuthGitHubInstallationListParams): Promise<Api.AgentApiOutcomeOfAuthGitHubInstallationListResponse> {
2986
+ return client.call("auth/github/installations/list", params);
2987
+ },
2988
+ /**
2989
+ * Grant access to a GitHub App installation
2990
+ *
2991
+ * Creates or refreshes a universe auth grant for one accessible installation. The installation token is brokered internally and never returned.
2992
+ */
2993
+ authGithubInstallationsGrant(client: RpcCaller, params: Api.AuthGitHubInstallationGrantParams): Promise<Api.AgentApiOutcomeOfAuthGitHubInstallationGrantResponse> {
2994
+ return client.call("auth/github/installations/grant", params);
2995
+ },
2996
+ /**
2997
+ * Create a bot
2998
+ *
2999
+ * Creates the bot record, optionally with its triggers, and starts its controller. Fails if the bot id exists; a trigger failure rolls the bot back.
3000
+ */
3001
+ botsCreate(client: RpcCaller, params: Api.BotCreateParams): Promise<Api.AgentApiOutcomeOfBotCreateResponse> {
3002
+ return client.call("bots/create", params);
3003
+ },
3004
+ /**
3005
+ * Create or replace a bot document
3006
+ *
3007
+ * Replaces the mutable configuration whole and signals the controller, which applies it at its next idle boundary. Pass expectedRevision when replacing; a closed bot accepts label-only edits.
3008
+ */
3009
+ botsPut(client: RpcCaller, params: Api.BotPutParams): Promise<Api.AgentApiOutcomeOfBotPutResponse> {
3010
+ return client.call("bots/put", params);
3011
+ },
3012
+ /**
3013
+ * Read a bot
3014
+ *
3015
+ * Returns the bot record, its current revision, and lifecycle columns.
3016
+ */
3017
+ botsRead(client: RpcCaller, params: Api.BotReadParams): Promise<Api.AgentApiOutcomeOfBotReadResponse> {
3018
+ return client.call("bots/read", params);
3019
+ },
3020
+ /**
3021
+ * List bots
3022
+ *
3023
+ * Returns the roster: every bot with its trigger count, pending event count, and latest event, optionally narrowed by createdBy.
3024
+ */
3025
+ botsList(client: RpcCaller, params: Api.BotListParams): Promise<Api.AgentApiOutcomeOfBotListResponse> {
3026
+ return client.call("bots/list", params);
3027
+ },
3028
+ /**
3029
+ * Close a bot
3030
+ *
3031
+ * Terminal and idempotent: disables every trigger, drops schedules, and tells the controller to archive pending events and force-close its sessions. Returns once signalled; follow bots/state/read for closing to closed.
3032
+ */
3033
+ botsClose(client: RpcCaller, params: Api.BotCloseParams): Promise<Api.AgentApiOutcomeOfBotCloseResponse> {
3034
+ return client.call("bots/close", params);
3035
+ },
3036
+ /**
3037
+ * Delete a bot
3038
+ *
3039
+ * Closes the bot if needed, waits for its controller to complete, deletes the sessions it closed, and removes the record so the bot id is free again.
3040
+ */
3041
+ botsDelete(client: RpcCaller, params: Api.BotDeleteParams): Promise<Api.AgentApiOutcomeOfBotDeleteResponse> {
3042
+ return client.call("bots/delete", params);
3043
+ },
3044
+ /**
3045
+ * Read bot controller state
3046
+ *
3047
+ * Queries the controller workflow for its live snapshot (sessions, buffers, active and recent deliveries, budget) and lists sub-agent descendants. The controller is absent until the bot's first event.
3048
+ */
3049
+ botsStateRead(client: RpcCaller, params: Api.BotStateReadParams): Promise<Api.AgentApiOutcomeOfBotStateReadResponse> {
3050
+ return client.call("bots/state/read", params);
3051
+ },
3052
+ /**
3053
+ * Rotate a bot session
3054
+ *
3055
+ * Asks the controller to close one of the bot's sessions at its next idle boundary and continue on a fresh generation; queued deliveries follow.
3056
+ */
3057
+ botsSessionsRotate(client: RpcCaller, params: Api.BotSessionRotateParams): Promise<Api.AgentApiOutcomeOfBotSessionRotateResponse> {
3058
+ return client.call("bots/sessions/rotate", params);
3059
+ },
3060
+ /**
3061
+ * Create or replace a trigger
3062
+ *
3063
+ * Validates the trigger document (CEL parses, grants exist, one inbox per bot, chat routes per conversation), reconciles its Temporal Schedule, and stores it. A poll spec edit resets the cursor; a webhook keeps its URL token.
3064
+ */
3065
+ botsTriggersPut(client: RpcCaller, params: Api.BotTriggerPutParams): Promise<Api.AgentApiOutcomeOfBotTriggerPutResponse> {
3066
+ return client.call("bots/triggers/put", params);
3067
+ },
3068
+ /**
3069
+ * Read a trigger
3070
+ *
3071
+ * Returns one trigger with its incidents and cursor; the ingest path and pairing code are included for bot-management callers.
3072
+ */
3073
+ botsTriggersRead(client: RpcCaller, params: Api.BotTriggerReadParams): Promise<Api.AgentApiOutcomeOfBotTriggerReadResponse> {
3074
+ return client.call("bots/triggers/read", params);
3075
+ },
3076
+ /**
3077
+ * List a bot's triggers
3078
+ *
3079
+ * Returns every trigger of the bot ordered by id, secrets included for bot-management callers.
3080
+ */
3081
+ botsTriggersList(client: RpcCaller, params: Api.BotTriggerListParams): Promise<Api.AgentApiOutcomeOfBotTriggerListResponse> {
3082
+ return client.call("bots/triggers/list", params);
3083
+ },
3084
+ /**
3085
+ * Delete a trigger
3086
+ *
3087
+ * Drops the trigger's Temporal Schedule and pairings, then the record; stored events keep their history.
3088
+ */
3089
+ botsTriggersDelete(client: RpcCaller, params: Api.BotTriggerDeleteParams): Promise<Api.AgentApiOutcomeOfBotTriggerDeleteResponse> {
3090
+ return client.call("bots/triggers/delete", params);
3091
+ },
3092
+ /**
3093
+ * Admit an event manually
3094
+ *
3095
+ * Stores an operator-authored event for the bot's main session and wakes the controller. eventId is the dedupe identity; a duplicate returns the stored row.
3096
+ */
3097
+ botsEventsAdmit(client: RpcCaller, params: Api.BotEventAdmitParams): Promise<Api.AgentApiOutcomeOfBotEventAdmitResponse> {
3098
+ return client.call("bots/events/admit", params);
3099
+ },
3100
+ /**
3101
+ * Replay a stored event
3102
+ *
3103
+ * Re-admits the stored envelope as a fresh event with the original routing; the replay never coalesces.
3104
+ */
3105
+ botsEventsReplay(client: RpcCaller, params: Api.BotEventReplayParams): Promise<Api.AgentApiOutcomeOfBotEventReplayResponse> {
3106
+ return client.call("bots/events/replay", params);
3107
+ },
3108
+ /**
3109
+ * List a bot's events
3110
+ *
3111
+ * Cursor-paginated event log, newest first, with outcomes; payload documents stay in the CAS.
3112
+ */
3113
+ botsEventsList(client: RpcCaller, params: Api.BotEventListParams): Promise<Api.AgentApiOutcomeOfBotEventListResponse> {
3114
+ return client.call("bots/events/list", params);
3115
+ },
3116
+ /**
3117
+ * Read an event by number
3118
+ *
3119
+ * Returns the event row and its full stored envelope document.
3120
+ */
3121
+ botsEventsRead(client: RpcCaller, params: Api.BotEventReadParams): Promise<Api.AgentApiOutcomeOfBotEventReadResponse> {
3122
+ return client.call("bots/events/read", params);
3123
+ },
3124
+ /**
3125
+ * Test a CEL filter
3126
+ *
3127
+ * Evaluates a filter against one payload or a sample of recent stored events, reporting matches and evaluation errors without changing anything.
3128
+ */
3129
+ botsFiltersTest(client: RpcCaller, params: Api.BotFilterTestParams): Promise<Api.AgentApiOutcomeOfBotFilterTestResponse> {
3130
+ return client.call("bots/filters/test", params);
3131
+ },
3132
+ /**
3133
+ * Create a channel account
3134
+ *
3135
+ * Registers a provider account (Telegram, WhatsApp) for this universe. The credential is a retrievable grant reference; no token is accepted here.
3136
+ */
3137
+ channelsAccountsCreate(client: RpcCaller, params: Api.ChannelAccountCreateParams): Promise<Api.AgentApiOutcomeOfChannelAccountCreateResponse> {
3138
+ return client.call("channels/accounts/create", params);
3139
+ },
3140
+ /**
3141
+ * Create or replace a channel account
3142
+ *
3143
+ * Replaces the account document whole; pass expectedRevision when replacing. The connector host picks the change up on its next discovery pass.
3144
+ */
3145
+ channelsAccountsPut(client: RpcCaller, params: Api.ChannelAccountPutParams): Promise<Api.AgentApiOutcomeOfChannelAccountPutResponse> {
3146
+ return client.call("channels/accounts/put", params);
3147
+ },
3148
+ /**
3149
+ * Read a channel account
3150
+ *
3151
+ * Returns the account document and revision.
3152
+ */
3153
+ channelsAccountsRead(client: RpcCaller, params: Api.ChannelAccountReadParams): Promise<Api.AgentApiOutcomeOfChannelAccountReadResponse> {
3154
+ return client.call("channels/accounts/read", params);
3155
+ },
3156
+ /**
3157
+ * List channel accounts
3158
+ *
3159
+ * Lists this universe's provider accounts, optionally by provider.
3160
+ */
3161
+ channelsAccountsList(client: RpcCaller, params: Api.ChannelAccountListParams): Promise<Api.AgentApiOutcomeOfChannelAccountListResponse> {
3162
+ return client.call("channels/accounts/list", params);
3163
+ },
3164
+ /**
3165
+ * Delete a channel account
3166
+ *
3167
+ * Removes the account and its pairings; chat triggers that reference it stop serving conversations.
3168
+ */
3169
+ channelsAccountsDelete(client: RpcCaller, params: Api.ChannelAccountDeleteParams): Promise<Api.AgentApiOutcomeOfChannelAccountDeleteResponse> {
3170
+ return client.call("channels/accounts/delete", params);
3171
+ },
3172
+ /**
3173
+ * Admit a provider message
3174
+ *
3175
+ * Service callers only. Resolves the chat trigger for the conversation, applies pairing, and signals the conversation workflow. Returns the decision so the connector can send pairing prompts itself; acknowledge the provider only after this returns.
3176
+ */
3177
+ channelsInboundAdmit(client: RpcCaller, params: Api.ChannelInboundAdmitParams): Promise<Api.AgentApiOutcomeOfChannelInboundAdmitResponse> {
3178
+ return client.call("channels/inbound/admit", params);
3179
+ },
3180
+ /**
3181
+ * List chat pairings
3182
+ *
3183
+ * Lists conversations paired to chat triggers, optionally by account or bot.
3184
+ */
3185
+ channelsPairingsList(client: RpcCaller, params: Api.ChannelPairingListParams): Promise<Api.AgentApiOutcomeOfChannelPairingListResponse> {
3186
+ return client.call("channels/pairings/list", params);
3187
+ },
3188
+ /**
3189
+ * Unpair a conversation
3190
+ *
3191
+ * Removes one pairing; the conversation must present the pairing code again to reconnect.
3192
+ */
3193
+ channelsPairingsDelete(client: RpcCaller, params: Api.ChannelPairingDeleteParams): Promise<Api.AgentApiOutcomeOfChannelPairingDeleteResponse> {
3194
+ return client.call("channels/pairings/delete", params);
3195
+ },
3196
+ /**
3197
+ * Read a conversation snapshot
3198
+ *
3199
+ * Queries the conversation workflow's live state for one chat, for debugging; absent when no workflow exists yet.
3200
+ */
3201
+ channelsConversationsRead(client: RpcCaller, params: Api.ChannelConversationReadParams): Promise<Api.AgentApiOutcomeOfChannelConversationReadResponse> {
3202
+ return client.call("channels/conversations/read", params);
3203
+ },
3204
+ /**
3205
+ * List a universe's deployment provider bindings
3206
+ *
3207
+ * Deployment configuration inventory of one universe's provider bindings.
3208
+ */
3209
+ deploymentEnvironmentProviderBindingsList(client: RpcCaller, params: Api.DeploymentUniverseReadParams): Promise<Api.AgentApiOutcomeOfEnvironmentProviderBindingListResponse> {
3210
+ return client.call("deployment/environment-provider-bindings/list", params);
3211
+ },
3212
+ /**
3213
+ * Create a universe
3214
+ *
3215
+ * Creates the deployment tenant boundary for an explicit UUID. The operation is idempotent and reports whether a new universe was created.
3216
+ */
3217
+ deploymentUniversesCreate(client: RpcCaller, params: Api.DeploymentUniverseCreateParams): Promise<Api.AgentApiOutcomeOfDeploymentUniverseCreateResponse> {
3218
+ return client.call("deployment/universes/create", params);
3219
+ },
3220
+ /**
3221
+ * List universes
3222
+ *
3223
+ * Returns deployment-wide universe summaries with approximate live aggregate counts and last session activity.
3224
+ */
3225
+ deploymentUniversesList(client: RpcCaller, params: Api.DeploymentUniverseListParams): Promise<Api.AgentApiOutcomeOfDeploymentUniverseListResponse> {
3226
+ return client.call("deployment/universes/list", params);
3227
+ },
3228
+ /**
3229
+ * Read a universe
3230
+ *
3231
+ * Returns one deployment tenant summary with aggregate session, workspace, profile, and blob usage.
3232
+ */
3233
+ deploymentUniversesRead(client: RpcCaller, params: Api.DeploymentUniverseReadParams): Promise<Api.AgentApiOutcomeOfDeploymentUniverseReadResponse> {
3234
+ return client.call("deployment/universes/read", params);
3235
+ },
3236
+ /**
3237
+ * Set a universe slug
3238
+ *
3239
+ * Sets or changes a deployment-unique slug without changing the universe UUID or resources. The previous slug is released and old URLs may stop working. With onlyIfUnset, a different existing slug is a conflict. Claiming another universe's slug also returns a conflict. Does not create a universe.
3240
+ */
3241
+ deploymentUniversesSlugPut(client: RpcCaller, params: Api.DeploymentUniverseSlugPutParams): Promise<Api.AgentApiOutcomeOfDeploymentUniverseReadResponse> {
3242
+ return client.call("deployment/universes/slug/put", params);
3243
+ },
3244
+ /**
3245
+ * Purge a universe
3246
+ *
3247
+ * Permanently terminates live session workflows, deletes external blob objects, and cascades universe data. The purge is resumable/idempotent after partial failure.
3248
+ */
3249
+ deploymentUniversesDelete(client: RpcCaller, params: Api.DeploymentUniverseDeleteParams): Promise<Api.AgentApiOutcomeOfDeploymentUniverseDeleteResponse> {
3250
+ return client.call("deployment/universes/delete", params);
3251
+ },
3252
+ /**
3253
+ * Create a scoped API key
3254
+ *
3255
+ * Mints a key for a universe or the deployment with the method groups it may call and whether it may assert actors. The plaintext secret is returned exactly once and cannot be recovered; persist only the displayed prefix for identification. Key authority is immutable: revoke and mint to change what one may do.
3256
+ */
3257
+ deploymentApiKeysCreate(client: RpcCaller, params: Api.DeploymentApiKeyCreateParams): Promise<Api.AgentApiOutcomeOfDeploymentApiKeyCreateResponse> {
3258
+ return client.call("deployment/api-keys/create", params);
3259
+ },
3260
+ /**
3261
+ * List scoped API keys
3262
+ *
3263
+ * Returns non-secret key metadata, all keys or those of one scope, including groups, revocation and last-use timestamps. Plaintext secrets are never stored or returned.
3264
+ */
3265
+ deploymentApiKeysList(client: RpcCaller, params: Api.DeploymentApiKeyListParams): Promise<Api.AgentApiOutcomeOfDeploymentApiKeyListResponse> {
3266
+ return client.call("deployment/api-keys/list", params);
3267
+ },
3268
+ /**
3269
+ * Rotate a scoped API key
3270
+ *
3271
+ * Atomically replaces an active key secret and display prefix, immediately rejecting the old secret on subsequent requests. Preserves scope, groups, actor authority, name, creator and creation time; clears last use. Returns the new secret once. Unknown or revoked prefixes are not found. Already admitted work continues.
3272
+ */
3273
+ deploymentApiKeysRotate(client: RpcCaller, params: Api.DeploymentApiKeyRotateParams): Promise<Api.AgentApiOutcomeOfDeploymentApiKeyCreateResponse> {
3274
+ return client.call("deployment/api-keys/rotate", params);
3275
+ },
3276
+ /**
3277
+ * Revoke a scoped API key
3278
+ *
3279
+ * Revokes the key with this display prefix; revoking a revoked key keeps its first revocation time. An unknown prefix is not found.
3280
+ */
3281
+ deploymentApiKeysRevoke(client: RpcCaller, params: Api.DeploymentApiKeyRevokeParams): Promise<Api.AgentApiOutcomeOfDeploymentApiKeyRevokeResponse> {
3282
+ return client.call("deployment/api-keys/revoke", params);
3283
+ },
3284
+ /**
3285
+ * Put an environment provider
3286
+ *
3287
+ * Registers or replaces one deployment provider and its controller connection. The provider does not call this API or require access to Lightspeed.
3288
+ */
3289
+ deploymentEnvironmentProvidersPut(client: RpcCaller, params: Api.DeploymentEnvironmentProviderPutParams): Promise<Api.AgentApiOutcomeOfDeploymentEnvironmentProviderPutResponse> {
3290
+ return client.call("deployment/environment-providers/put", params);
3291
+ },
3292
+ /**
3293
+ * List environment providers
3294
+ *
3295
+ * Returns every deployment-registered deployment provider and its controller connection.
3296
+ */
3297
+ deploymentEnvironmentProvidersList(client: RpcCaller, params: Api.DeploymentEnvironmentProviderListParams): Promise<Api.AgentApiOutcomeOfDeploymentEnvironmentProviderListResponse> {
3298
+ return client.call("deployment/environment-providers/list", params);
3299
+ },
3300
+ /**
3301
+ * Read an environment provider
3302
+ *
3303
+ * Returns one deployment-registered deployment provider and its controller connection.
3304
+ */
3305
+ deploymentEnvironmentProvidersRead(client: RpcCaller, params: Api.DeploymentEnvironmentProviderReadParams): Promise<Api.AgentApiOutcomeOfDeploymentEnvironmentProviderReadResponse> {
3306
+ return client.call("deployment/environment-providers/read", params);
3307
+ },
3308
+ /**
3309
+ * Delete an environment provider
3310
+ *
3311
+ * Deletes a deployment provider only when no universe binding references it.
3312
+ */
3313
+ deploymentEnvironmentProvidersDelete(client: RpcCaller, params: Api.DeploymentEnvironmentProviderDeleteParams): Promise<Api.AgentApiOutcomeOfDeploymentEnvironmentProviderDeleteResponse> {
3314
+ return client.call("deployment/environment-providers/delete", params);
3315
+ },
3316
+ /**
3317
+ * Put an environment provider binding
3318
+ *
3319
+ * Creates or replaces one universe's complete revisioned routing and admission binding. A deployment provider may have at most one binding in a universe.
3320
+ */
3321
+ deploymentEnvironmentProvidersBindingsPut(client: RpcCaller, params: Api.DeploymentProviderBindingPutParams): Promise<Api.AgentApiOutcomeOfDeploymentProviderBindingPutResponse> {
3322
+ return client.call("deployment/environment-providers/bindings/put", params);
3323
+ },
3324
+ /**
3325
+ * Delete an environment provider binding
3326
+ *
3327
+ * Deletes a universe provider binding only after every referencing environment has reached Closed.
3328
+ */
3329
+ deploymentEnvironmentProvidersBindingsDelete(client: RpcCaller, params: Api.DeploymentProviderBindingDeleteParams): Promise<Api.AgentApiOutcomeOfDeploymentProviderBindingDeleteResponse> {
3330
+ return client.call("deployment/environment-providers/bindings/delete", params);
3331
+ },
3332
+ /**
3333
+ * Adopt a provider environment
3334
+ *
3335
+ * Creates a universe environment by transferring an existing provider target into Lightspeed's managed lifecycle. The caller must explicitly accept ownership transfer.
3336
+ */
3337
+ deploymentEnvironmentsAdopt(client: RpcCaller, params: Api.DeploymentEnvironmentAdoptParams): Promise<Api.AgentApiOutcomeOfDeploymentEnvironmentAdoptResponse> {
3338
+ return client.call("deployment/environments/adopt", params);
3339
+ },
3340
+ /**
3341
+ * List channel accounts across universes
3342
+ *
3343
+ * The connector host's discovery call: every enabled provider account of the deployment with its universe id and credential grant reference. Re-poll to pick up accounts created or disabled since.
3344
+ */
3345
+ deploymentChannelsAccountsList(client: RpcCaller, params: Api.DeploymentChannelAccountListParams): Promise<Api.AgentApiOutcomeOfDeploymentChannelAccountListResponse> {
3346
+ return client.call("deployment/channels/accounts/list", params);
3347
+ },
3348
+ } as const;