@lightspeed-ai/agent-client 0.1.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 +63 -0
  2. package/dist/client.d.ts +65 -0
  3. package/dist/client.d.ts.map +1 -0
  4. package/dist/client.js +194 -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 +47 -0
  9. package/dist/errors.js.map +1 -0
  10. package/dist/generated/methods.d.ts +2497 -0
  11. package/dist/generated/methods.d.ts.map +1 -0
  12. package/dist/generated/methods.js +1751 -0
  13. package/dist/generated/methods.js.map +1 -0
  14. package/dist/generated/types.d.ts +6950 -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 +219 -0
  19. package/dist/generated/workflow-manifest.d.ts.map +1 -0
  20. package/dist/generated/workflow-manifest.js +251 -0
  21. package/dist/generated/workflow-manifest.js.map +1 -0
  22. package/dist/generated/workflow-types.d.ts +451 -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 +217 -0
  31. package/dist/workflow.d.ts.map +1 -0
  32. package/dist/workflow.js +338 -0
  33. package/dist/workflow.js.map +1 -0
  34. package/examples/temporal-activity.ts +33 -0
  35. package/package.json +55 -0
  36. package/release.json +4 -0
  37. package/schema/api.schema.json +16643 -0
  38. package/schema/workflow.json +246 -0
  39. package/schema/workflow.schema.json +880 -0
  40. package/src/client.ts +318 -0
  41. package/src/errors.ts +64 -0
  42. package/src/generated/methods.ts +2888 -0
  43. package/src/generated/types.ts +7189 -0
  44. package/src/generated/workflow-manifest.ts +251 -0
  45. package/src/generated/workflow-types.ts +468 -0
  46. package/src/index.ts +31 -0
  47. package/src/workflow.ts +468 -0
@@ -0,0 +1,2497 @@
1
+ import type * as Api from "./types.js";
2
+ export declare const METHODS: readonly ["initialize", "session/start", "session/managed/start", "session/read", "session/list", "session/config/put", "session/rename", "session/close", "session/delete", "session/events/read", "session/context/append", "session/context/remove", "session/context/compact", "session/runs/start", "session/runs/list", "session/runs/read", "session/runs/cancel", "session/runs/approvals/decide", "session/runs/steer", "session/skills/list", "session/skills/active", "session/skills/activate", "session/skills/deactivate", "session/profiles/apply", "session/environments/activate", "session/environments/deactivate", "environments/credentials/bind", "environments/credentials/list", "environments/credentials/unbind", "environments/create", "environments/read", "environments/list", "environments/close", "environments/external/create", "environments/ingress/put", "environments/power/put", "environments/idle-policy/put", "environments/provider-bindings/list", "environments/provider-bindings/read", "environments/templates/list", "environments/templates/read", "environments/jobs/create", "environments/jobs/read", "environments/jobs/cancel", "models/list", "profiles/create", "profiles/read", "profiles/list", "profiles/put", "profiles/delete", "blobs/put", "blobs/read", "blobs/has", "vfs/snapshots/commit", "vfs/snapshots/read", "vfs/workspaces/create", "vfs/workspaces/read", "vfs/workspaces/list", "vfs/workspaces/update", "vfs/workspaces/delete", "mcp/servers/put", "mcp/servers/auth/discover", "mcp/servers/tools/discover", "mcp/servers/read", "mcp/servers/list", "mcp/servers/delete", "auth/grants/import", "auth/grants/lease", "auth/grants/read", "auth/grants/list", "auth/grants/revoke", "auth/clients/create", "auth/clients/read", "auth/clients/list", "auth/clients/delete", "auth/flows/start", "auth/flows/read", "auth/providers/create", "auth/providers/read", "auth/providers/list", "auth/providers/delete", "auth/github/installations/list", "auth/github/installations/grant", "bots/create", "bots/put", "bots/read", "bots/list", "bots/close", "bots/delete", "bots/state/read", "bots/sessions/rotate", "bots/triggers/put", "bots/triggers/read", "bots/triggers/list", "bots/triggers/delete", "bots/events/admit", "bots/events/replay", "bots/events/list", "bots/events/read", "bots/filters/test", "channels/accounts/create", "channels/accounts/put", "channels/accounts/read", "channels/accounts/list", "channels/accounts/delete", "channels/inbound/admit", "channels/pairings/list", "channels/pairings/delete", "channels/conversations/read", "operator/universes/create", "operator/universes/list", "operator/universes/read", "operator/universes/delete", "operator/api-keys/create", "operator/api-keys/list", "operator/api-keys/revoke", "operator/environment-providers/put", "operator/environment-providers/list", "operator/environment-providers/read", "operator/environment-providers/delete", "operator/environment-providers/bindings/put", "operator/environment-providers/bindings/delete", "operator/environments/adopt", "operator/channels/accounts/list"];
3
+ export declare const METHOD_INFO: {
4
+ readonly initialize: {
5
+ readonly scope: "universe";
6
+ readonly summary: "Inspect the Lightspeed protocol";
7
+ readonly description: "Returns protocol version, server identity, and supported capabilities without changing universe state.";
8
+ };
9
+ readonly "session/start": {
10
+ readonly scope: "universe";
11
+ readonly summary: "Create or reopen a session";
12
+ readonly description: "Creates a session with optional config/profile setup. Retrying an existing session id returns that session; creation settings apply only when it is first created.";
13
+ };
14
+ readonly "session/managed/start": {
15
+ readonly scope: "universe";
16
+ readonly summary: "Create or reopen a managed session";
17
+ readonly description: "Creates a session with an immutable lifecycle controller and/or workflow tools using explicit bound pull/push dispatch, start targets, and Accepted, Joined, or keyed-Promise completion. Retrying an existing session id requires the same managed-creation declaration; an ordinary session cannot be upgraded to managed.";
18
+ };
19
+ readonly "session/read": {
20
+ readonly scope: "universe";
21
+ readonly summary: "Read a session";
22
+ readonly 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.";
23
+ };
24
+ readonly "session/list": {
25
+ readonly scope: "universe";
26
+ readonly summary: "List sessions";
27
+ readonly description: "Returns a cursor-paginated summary list ordered by most recent update. Pages may shift while sessions are changing.";
28
+ };
29
+ readonly "session/config/put": {
30
+ readonly scope: "universe";
31
+ readonly summary: "Replace session configuration";
32
+ readonly 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 and an identical document is a no-op.";
33
+ };
34
+ readonly "session/rename": {
35
+ readonly scope: "universe";
36
+ readonly summary: "Rename a session";
37
+ readonly description: "Sets the display name, or clears it when displayName is omitted.";
38
+ };
39
+ readonly "session/close": {
40
+ readonly scope: "universe";
41
+ readonly summary: "Close a session";
42
+ readonly 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.";
43
+ };
44
+ readonly "session/delete": {
45
+ readonly scope: "universe";
46
+ readonly summary: "Delete a closed session";
47
+ readonly description: "Permanently removes session storage after the session has been closed; close active/open sessions first.";
48
+ };
49
+ readonly "session/events/read": {
50
+ readonly scope: "universe";
51
+ readonly summary: "Read the session event stream";
52
+ readonly description: "Reads events after a cursor and optionally long-polls when caught up. Continue from nextCursor/headCursor and inspect complete/gap rather than assuming an uninterrupted page.";
53
+ };
54
+ readonly "session/context/append": {
55
+ readonly scope: "universe";
56
+ readonly summary: "Append keyed session context";
57
+ readonly description: "Admits a batch of context entries with per-entry results. Stable keys make same-content retries no-ops; media preprocessing can fail one entry without discarding successful entries.";
58
+ };
59
+ readonly "session/context/remove": {
60
+ readonly scope: "universe";
61
+ readonly summary: "Remove keyed session context";
62
+ readonly description: "Removes active entries by stable key with per-key results. Missing keys are idempotent no-ops; runtime-reserved run keys cannot be removed.";
63
+ };
64
+ readonly "session/context/compact": {
65
+ readonly scope: "universe";
66
+ readonly summary: "Compact session context";
67
+ readonly description: "Runs the configured compaction policy on an open idle session and waits for the resulting context revision.";
68
+ };
69
+ readonly "session/runs/start": {
70
+ readonly scope: "universe";
71
+ readonly summary: "Start an agent run";
72
+ readonly 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.";
73
+ };
74
+ readonly "session/runs/list": {
75
+ readonly scope: "universe";
76
+ readonly summary: "List session runs";
77
+ readonly description: "Returns a newest-first keyset page of bounded run summaries projected from current reducer state.";
78
+ };
79
+ readonly "session/runs/read": {
80
+ readonly scope: "universe";
81
+ readonly summary: "Read one session run";
82
+ readonly description: "Reads and projects one run from its bounded event interval, paged by event sequence.";
83
+ };
84
+ readonly "session/runs/cancel": {
85
+ readonly scope: "universe";
86
+ readonly summary: "Cancel a run";
87
+ readonly 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.";
88
+ };
89
+ readonly "session/runs/approvals/decide": {
90
+ readonly scope: "universe";
91
+ readonly summary: "Decide pending run approvals";
92
+ readonly 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.";
93
+ };
94
+ readonly "session/runs/steer": {
95
+ readonly scope: "universe";
96
+ readonly summary: "Steer the active run";
97
+ readonly 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.";
98
+ };
99
+ readonly "session/skills/list": {
100
+ readonly scope: "universe";
101
+ readonly summary: "List available session skills";
102
+ readonly description: "Refreshes the session's configured VFS skill catalog and reports which discovered skills are enabled and active. An absent catalog yields an empty result.";
103
+ };
104
+ readonly "session/skills/active": {
105
+ readonly scope: "universe";
106
+ readonly summary: "List active session skills";
107
+ readonly description: "Returns skill instructions currently injected into context, including activation scope and source.";
108
+ };
109
+ readonly "session/skills/activate": {
110
+ readonly scope: "universe";
111
+ readonly summary: "Activate a session skill";
112
+ readonly description: "Loads an enabled skill from the current catalog and injects its instructions into an open idle session. Run-scoped activation is the default.";
113
+ };
114
+ readonly "session/skills/deactivate": {
115
+ readonly scope: "universe";
116
+ readonly summary: "Deactivate a session skill";
117
+ readonly description: "Removes an active skill's injected context from an open idle session; the skill must currently be active.";
118
+ };
119
+ readonly "session/profiles/apply": {
120
+ readonly scope: "universe";
121
+ readonly summary: "Apply a profile to a session";
122
+ readonly 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.";
123
+ };
124
+ readonly "session/environments/activate": {
125
+ readonly scope: "universe";
126
+ readonly summary: "Activate a session environment";
127
+ readonly description: "Selects an allowed, live universe environment for environment-targeted tools while the session is idle.";
128
+ };
129
+ readonly "session/environments/deactivate": {
130
+ readonly scope: "universe";
131
+ readonly summary: "Deactivate the session environment";
132
+ readonly description: "Clears active environment selection without changing or closing the universe environment.";
133
+ };
134
+ readonly "environments/credentials/bind": {
135
+ readonly scope: "universe";
136
+ readonly summary: "Bind a credential into an environment";
137
+ readonly description: "Maps an environment variable name to an existing grant/provider/direct-secret handle for a universe environment. The response exposes only the source handle, never secret material.";
138
+ };
139
+ readonly "environments/credentials/list": {
140
+ readonly scope: "universe";
141
+ readonly summary: "List environment credential bindings";
142
+ readonly description: "Returns variable names and credential source handles for a universe environment; resolved secret values are never returned.";
143
+ };
144
+ readonly "environments/credentials/unbind": {
145
+ readonly scope: "universe";
146
+ readonly summary: "Unbind an environment credential";
147
+ readonly description: "Removes one variable-to-credential mapping without deleting the underlying grant, provider credential, or secret.";
148
+ };
149
+ readonly "environments/create": {
150
+ readonly scope: "universe";
151
+ readonly summary: "Create an environment";
152
+ readonly description: "Records an idempotent provisioning intent against an enabled universe binding. The provider validates its provider-wide template and provisions through its backend asynchronously.";
153
+ };
154
+ readonly "environments/read": {
155
+ readonly scope: "universe";
156
+ readonly summary: "Read an environment";
157
+ readonly description: "Returns the durable universe resource, source binding, logical lifecycle state, and minimal current-incarnation identity.";
158
+ };
159
+ readonly "environments/list": {
160
+ readonly scope: "universe";
161
+ readonly summary: "List environments";
162
+ readonly description: "Lists universe-owned environment resources, optionally filtered by provider, binding, or logical lifecycle state.";
163
+ };
164
+ readonly "environments/close": {
165
+ readonly scope: "universe";
166
+ readonly summary: "Close an environment";
167
+ readonly description: "Records an asynchronous idempotent close intent. Provider cleanup is resumed by lifecycle reconciliation; quota is released only after Closed.";
168
+ };
169
+ readonly "environments/external/create": {
170
+ readonly scope: "universe";
171
+ readonly summary: "Register an external environment";
172
+ readonly description: "Creates an environment backed by a Lightspeed-reachable envd WebSocket endpoint. Reachability is checked on demand.";
173
+ };
174
+ readonly "environments/ingress/put": {
175
+ readonly scope: "universe";
176
+ readonly summary: "Configure environment public ingress";
177
+ readonly 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.";
178
+ };
179
+ readonly "environments/power/put": {
180
+ readonly scope: "universe";
181
+ readonly summary: "Set environment power intent";
182
+ readonly 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.";
183
+ };
184
+ readonly "environments/idle-policy/put": {
185
+ readonly scope: "universe";
186
+ readonly summary: "Set environment idle policy";
187
+ readonly 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.";
188
+ };
189
+ readonly "environments/provider-bindings/list": {
190
+ readonly scope: "universe";
191
+ readonly summary: "List environment provider bindings";
192
+ readonly description: "Lists this universe's revisioned routing and admission bindings to deployment-scoped physical providers.";
193
+ };
194
+ readonly "environments/provider-bindings/read": {
195
+ readonly scope: "universe";
196
+ readonly summary: "Read an environment provider binding";
197
+ readonly description: "Returns one universe routing and admission binding. Provider-wide templates and physical resource, network, and ingress policy remain provider-owned.";
198
+ };
199
+ readonly "environments/templates/list": {
200
+ readonly scope: "universe";
201
+ readonly summary: "List environment templates";
202
+ readonly description: "Reads immutable templates directly from the selected bound provider controller.";
203
+ };
204
+ readonly "environments/templates/read": {
205
+ readonly scope: "universe";
206
+ readonly summary: "Read an environment template";
207
+ readonly description: "Returns one immutable template version from the selected bound provider controller.";
208
+ };
209
+ readonly "environments/jobs/create": {
210
+ readonly scope: "universe";
211
+ readonly summary: "Create environment jobs";
212
+ readonly 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.";
213
+ };
214
+ readonly "environments/jobs/read": {
215
+ readonly scope: "universe";
216
+ readonly summary: "Read environment jobs";
217
+ readonly description: "Reads selected job handles with bounded output, optional sequence continuation, and optional artifacts; use returned status/sequence data for polling.";
218
+ };
219
+ readonly "environments/jobs/cancel": {
220
+ readonly scope: "universe";
221
+ readonly summary: "Cancel environment jobs";
222
+ readonly description: "Requests cancellation for selected jobs, optionally including dependents. Force is provider-specific escalation; inspect each per-job result.";
223
+ };
224
+ readonly "models/list": {
225
+ readonly scope: "universe";
226
+ readonly summary: "Discover available models";
227
+ readonly description: "Queries supported providers directly on every call and returns best-effort selectable routes. One provider failure does not discard successful results from others.";
228
+ };
229
+ readonly "profiles/create": {
230
+ readonly scope: "universe";
231
+ readonly summary: "Create an agent profile";
232
+ readonly description: "Creates a new universe-scoped reusable profile document; use profiles/put for create-or-replace revision semantics.";
233
+ };
234
+ readonly "profiles/read": {
235
+ readonly scope: "universe";
236
+ readonly summary: "Read an agent profile";
237
+ readonly description: "Returns the complete profile document and current revision.";
238
+ };
239
+ readonly "profiles/list": {
240
+ readonly scope: "universe";
241
+ readonly summary: "List agent profiles";
242
+ readonly description: "Returns lightweight summaries of universe-scoped reusable profiles.";
243
+ };
244
+ readonly "profiles/put": {
245
+ readonly scope: "universe";
246
+ readonly summary: "Create or replace an agent profile";
247
+ readonly description: "Stores the complete profile document. Use expectedRevision from profiles/read when replacing to prevent lost updates; absence writes unconditionally.";
248
+ };
249
+ readonly "profiles/delete": {
250
+ readonly scope: "universe";
251
+ readonly summary: "Delete an agent profile";
252
+ readonly description: "Deletes the catalog document; sessions previously created or configured from it retain their materialized state.";
253
+ };
254
+ readonly "blobs/put": {
255
+ readonly scope: "universe";
256
+ readonly summary: "Store content-addressed blobs";
257
+ readonly description: "Decodes and stores a batch of base64 payloads, returning immutable content references in request order. Re-uploading identical bytes is naturally deduplicated.";
258
+ };
259
+ readonly "blobs/read": {
260
+ readonly scope: "universe";
261
+ readonly summary: "Read a content-addressed blob";
262
+ readonly description: "Returns the complete immutable blob as base64; large values count against gateway and MCP response limits.";
263
+ };
264
+ readonly "blobs/has": {
265
+ readonly scope: "universe";
266
+ readonly summary: "Check blob availability";
267
+ readonly description: "Checks a batch of content references without returning blob bodies, preserving request order.";
268
+ };
269
+ readonly "vfs/snapshots/commit": {
270
+ readonly scope: "universe";
271
+ readonly summary: "Commit a VFS snapshot";
272
+ readonly description: "Validates and stores an immutable filesystem manifest. Upload referenced file blobs first; the returned snapshot ref is content-addressed.";
273
+ };
274
+ readonly "vfs/snapshots/read": {
275
+ readonly scope: "universe";
276
+ readonly summary: "Read a VFS snapshot";
277
+ readonly description: "Returns an immutable snapshot manifest and aggregate file/byte counts; file bodies remain separate blobs.";
278
+ };
279
+ readonly "vfs/workspaces/create": {
280
+ readonly scope: "universe";
281
+ readonly summary: "Create a mutable VFS workspace";
282
+ readonly description: "Creates a universe workspace at an optional seed snapshot; absence starts from a server-created empty snapshot.";
283
+ };
284
+ readonly "vfs/workspaces/read": {
285
+ readonly scope: "universe";
286
+ readonly summary: "Read a VFS workspace";
287
+ readonly description: "Returns workspace metadata, current head snapshot, and revision for safe updates.";
288
+ };
289
+ readonly "vfs/workspaces/list": {
290
+ readonly scope: "universe";
291
+ readonly summary: "List VFS workspaces";
292
+ readonly description: "Lists mutable universe workspaces with head snapshots, sizes, and revisions.";
293
+ };
294
+ readonly "vfs/workspaces/update": {
295
+ readonly scope: "universe";
296
+ readonly summary: "Update a VFS workspace";
297
+ readonly description: "Moves the workspace head to an existing snapshot and updates its display name. Pass expectedRevision from a read to prevent lost updates.";
298
+ };
299
+ readonly "vfs/workspaces/delete": {
300
+ readonly scope: "universe";
301
+ readonly summary: "Delete a VFS workspace";
302
+ readonly description: "Deletes the mutable workspace record; immutable snapshots and blobs remain content-addressed resources.";
303
+ };
304
+ readonly "mcp/servers/put": {
305
+ readonly scope: "universe";
306
+ readonly summary: "Create or replace an MCP server record";
307
+ readonly description: "Stores the complete universe catalog document, including its optional universe auth-grant credential. Use expectedRevision when replacing; token material is never accepted or returned.";
308
+ };
309
+ readonly "mcp/servers/auth/discover": {
310
+ readonly scope: "universe";
311
+ readonly summary: "Discover MCP server authentication";
312
+ readonly 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.";
313
+ };
314
+ readonly "mcp/servers/tools/discover": {
315
+ readonly scope: "universe";
316
+ readonly summary: "Discover MCP server tools";
317
+ readonly 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.";
318
+ };
319
+ readonly "mcp/servers/read": {
320
+ readonly scope: "universe";
321
+ readonly summary: "Read an MCP server record";
322
+ readonly description: "Returns one catalog document with defaults, auth policy, non-secret grant binding, status, and revision; no credential value is exposed.";
323
+ };
324
+ readonly "mcp/servers/list": {
325
+ readonly scope: "universe";
326
+ readonly summary: "List MCP server records";
327
+ readonly description: "Lists universe catalog entries, optionally filtered by lifecycle/configuration status.";
328
+ };
329
+ readonly "mcp/servers/delete": {
330
+ readonly scope: "universe";
331
+ readonly summary: "Delete an MCP server record";
332
+ readonly description: "Deletes the catalog document. Existing session configs that reference it are not silently rewritten and may need explicit reconfiguration.";
333
+ };
334
+ readonly "auth/grants/import": {
335
+ readonly scope: "universe";
336
+ readonly summary: "Import a static bearer grant";
337
+ readonly 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.";
338
+ };
339
+ readonly "auth/grants/lease": {
340
+ readonly scope: "service";
341
+ readonly summary: "Lease a retrievable authentication grant";
342
+ readonly 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.";
343
+ };
344
+ readonly "auth/grants/read": {
345
+ readonly scope: "universe";
346
+ readonly summary: "Read authentication grant metadata";
347
+ readonly description: "Returns principal, provider binding, scopes, audience, expiry, status, and token-presence flags; access and refresh token values are never returned.";
348
+ };
349
+ readonly "auth/grants/list": {
350
+ readonly scope: "universe";
351
+ readonly summary: "List authentication grants";
352
+ readonly description: "Lists non-secret grant metadata for the universe, optionally filtered by status.";
353
+ };
354
+ readonly "auth/grants/revoke": {
355
+ readonly scope: "universe";
356
+ readonly summary: "Revoke an authentication grant";
357
+ readonly description: "Marks the grant unusable by token consumers while retaining non-secret audit metadata.";
358
+ };
359
+ readonly "auth/clients/create": {
360
+ readonly scope: "universe";
361
+ readonly summary: "Register an OAuth client";
362
+ readonly description: "Stores provider endpoints and client identity; an optional plaintext client secret is encrypted and represented thereafter only by hasClientSecret.";
363
+ };
364
+ readonly "auth/clients/read": {
365
+ readonly scope: "universe";
366
+ readonly summary: "Read OAuth client metadata";
367
+ readonly description: "Returns endpoints, public client identity, defaults, and secret-presence state; the client secret is never returned.";
368
+ };
369
+ readonly "auth/clients/list": {
370
+ readonly scope: "universe";
371
+ readonly summary: "List OAuth clients";
372
+ readonly description: "Lists non-secret OAuth client registrations in the universe.";
373
+ };
374
+ readonly "auth/clients/delete": {
375
+ readonly scope: "universe";
376
+ readonly summary: "Delete an OAuth client";
377
+ readonly description: "Deletes the client registration and its stored client secret; grants already created from it remain separate records.";
378
+ };
379
+ readonly "auth/flows/start": {
380
+ readonly scope: "universe";
381
+ readonly summary: "Start an OAuth authorization flow";
382
+ readonly 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.";
383
+ };
384
+ readonly "auth/flows/read": {
385
+ readonly scope: "universe";
386
+ readonly summary: "Read OAuth flow status";
387
+ readonly description: "Polls a flow's pending/completed/failed/expired state and returns the resulting grant id when authorization succeeds; no token value is exposed.";
388
+ };
389
+ readonly "auth/providers/create": {
390
+ readonly scope: "universe";
391
+ readonly summary: "Register an authentication provider";
392
+ readonly 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.";
393
+ };
394
+ readonly "auth/providers/read": {
395
+ readonly scope: "universe";
396
+ readonly summary: "Read authentication provider metadata";
397
+ readonly description: "Returns provider kind, non-secret configuration, credential-presence state, and status; stored credentials are never returned.";
398
+ };
399
+ readonly "auth/providers/list": {
400
+ readonly scope: "universe";
401
+ readonly summary: "List authentication providers";
402
+ readonly description: "Lists non-secret model/GitHub provider registrations for the universe.";
403
+ };
404
+ readonly "auth/providers/delete": {
405
+ readonly scope: "universe";
406
+ readonly summary: "Delete an authentication provider";
407
+ readonly description: "Deletes the provider registration and its directly stored credential; separately stored grants remain independent records.";
408
+ };
409
+ readonly "auth/github/installations/list": {
410
+ readonly scope: "universe";
411
+ readonly summary: "List GitHub App installations";
412
+ readonly description: "Uses the registered GitHub App provider credential to query accessible installations and returns account/permission metadata without tokens.";
413
+ };
414
+ readonly "auth/github/installations/grant": {
415
+ readonly scope: "universe";
416
+ readonly summary: "Grant access to a GitHub App installation";
417
+ readonly description: "Creates or refreshes a universe auth grant for one accessible installation. The installation token is brokered internally and never returned.";
418
+ };
419
+ readonly "bots/create": {
420
+ readonly scope: "universe";
421
+ readonly summary: "Create a bot";
422
+ readonly 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.";
423
+ };
424
+ readonly "bots/put": {
425
+ readonly scope: "universe";
426
+ readonly summary: "Create or replace a bot document";
427
+ readonly 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.";
428
+ };
429
+ readonly "bots/read": {
430
+ readonly scope: "universe";
431
+ readonly summary: "Read a bot";
432
+ readonly description: "Returns the bot record, its current revision, and lifecycle columns.";
433
+ };
434
+ readonly "bots/list": {
435
+ readonly scope: "universe";
436
+ readonly summary: "List bots";
437
+ readonly description: "Returns the roster: every bot with its trigger count, pending event count, and latest event.";
438
+ };
439
+ readonly "bots/close": {
440
+ readonly scope: "universe";
441
+ readonly summary: "Close a bot";
442
+ readonly 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.";
443
+ };
444
+ readonly "bots/delete": {
445
+ readonly scope: "universe";
446
+ readonly summary: "Delete a bot";
447
+ readonly 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.";
448
+ };
449
+ readonly "bots/state/read": {
450
+ readonly scope: "universe";
451
+ readonly summary: "Read bot controller state";
452
+ readonly 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.";
453
+ };
454
+ readonly "bots/sessions/rotate": {
455
+ readonly scope: "universe";
456
+ readonly summary: "Rotate a bot session";
457
+ readonly 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.";
458
+ };
459
+ readonly "bots/triggers/put": {
460
+ readonly scope: "universe";
461
+ readonly summary: "Create or replace a trigger";
462
+ readonly 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.";
463
+ };
464
+ readonly "bots/triggers/read": {
465
+ readonly scope: "universe";
466
+ readonly summary: "Read a trigger";
467
+ readonly description: "Returns one trigger with its incidents and cursor; the ingest path and pairing code are shown only to managing principals.";
468
+ };
469
+ readonly "bots/triggers/list": {
470
+ readonly scope: "universe";
471
+ readonly summary: "List a bot's triggers";
472
+ readonly description: "Returns every trigger of the bot ordered by id, secrets redacted for non-managing principals.";
473
+ };
474
+ readonly "bots/triggers/delete": {
475
+ readonly scope: "universe";
476
+ readonly summary: "Delete a trigger";
477
+ readonly description: "Drops the trigger's Temporal Schedule and pairings, then the record; stored events keep their history.";
478
+ };
479
+ readonly "bots/events/admit": {
480
+ readonly scope: "universe";
481
+ readonly summary: "Admit an event manually";
482
+ readonly 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.";
483
+ };
484
+ readonly "bots/events/replay": {
485
+ readonly scope: "universe";
486
+ readonly summary: "Replay a stored event";
487
+ readonly description: "Re-admits the stored envelope as a fresh event with the original routing; the replay never coalesces.";
488
+ };
489
+ readonly "bots/events/list": {
490
+ readonly scope: "universe";
491
+ readonly summary: "List a bot's events";
492
+ readonly description: "Cursor-paginated event log, newest first, with outcomes; payload documents stay in the CAS.";
493
+ };
494
+ readonly "bots/events/read": {
495
+ readonly scope: "universe";
496
+ readonly summary: "Read an event by number";
497
+ readonly description: "Returns the event row and its full stored envelope document.";
498
+ };
499
+ readonly "bots/filters/test": {
500
+ readonly scope: "universe";
501
+ readonly summary: "Test a CEL filter";
502
+ readonly description: "Evaluates a filter against one payload or a sample of recent stored events, reporting matches and evaluation errors without changing anything.";
503
+ };
504
+ readonly "channels/accounts/create": {
505
+ readonly scope: "universe";
506
+ readonly summary: "Create a channel account";
507
+ readonly description: "Registers a provider account (Telegram, WhatsApp) for this universe. The credential is a retrievable grant reference; no token is accepted here.";
508
+ };
509
+ readonly "channels/accounts/put": {
510
+ readonly scope: "universe";
511
+ readonly summary: "Create or replace a channel account";
512
+ readonly description: "Replaces the account document whole; pass expectedRevision when replacing. The connector host picks the change up on its next discovery pass.";
513
+ };
514
+ readonly "channels/accounts/read": {
515
+ readonly scope: "universe";
516
+ readonly summary: "Read a channel account";
517
+ readonly description: "Returns the account document and revision.";
518
+ };
519
+ readonly "channels/accounts/list": {
520
+ readonly scope: "universe";
521
+ readonly summary: "List channel accounts";
522
+ readonly description: "Lists this universe's provider accounts, optionally by provider.";
523
+ };
524
+ readonly "channels/accounts/delete": {
525
+ readonly scope: "universe";
526
+ readonly summary: "Delete a channel account";
527
+ readonly description: "Removes the account and its pairings; chat triggers that reference it stop serving conversations.";
528
+ };
529
+ readonly "channels/inbound/admit": {
530
+ readonly scope: "service";
531
+ readonly summary: "Admit a provider message";
532
+ readonly 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.";
533
+ };
534
+ readonly "channels/pairings/list": {
535
+ readonly scope: "universe";
536
+ readonly summary: "List chat pairings";
537
+ readonly description: "Lists conversations paired to chat triggers, optionally by account or bot.";
538
+ };
539
+ readonly "channels/pairings/delete": {
540
+ readonly scope: "universe";
541
+ readonly summary: "Unpair a conversation";
542
+ readonly description: "Removes one pairing; the conversation must present the pairing code again to reconnect.";
543
+ };
544
+ readonly "channels/conversations/read": {
545
+ readonly scope: "universe";
546
+ readonly summary: "Read a conversation snapshot";
547
+ readonly description: "Queries the conversation workflow's live state for one chat, for debugging; absent when no workflow exists yet.";
548
+ };
549
+ readonly "operator/universes/create": {
550
+ readonly scope: "operator";
551
+ readonly summary: "Create a universe";
552
+ readonly description: "Creates the deployment tenant boundary for an explicit UUID. The operation is idempotent and reports whether a new universe was created.";
553
+ };
554
+ readonly "operator/universes/list": {
555
+ readonly scope: "operator";
556
+ readonly summary: "List universes";
557
+ readonly description: "Returns deployment-wide universe summaries with approximate live aggregate counts and last session activity.";
558
+ };
559
+ readonly "operator/universes/read": {
560
+ readonly scope: "operator";
561
+ readonly summary: "Read a universe";
562
+ readonly description: "Returns one deployment tenant summary with aggregate session, workspace, profile, and blob usage.";
563
+ };
564
+ readonly "operator/universes/delete": {
565
+ readonly scope: "operator";
566
+ readonly summary: "Purge a universe";
567
+ readonly description: "Permanently terminates live session workflows, deletes external blob objects, and cascades universe data. The purge is resumable/idempotent after partial failure.";
568
+ };
569
+ readonly "operator/api-keys/create": {
570
+ readonly scope: "operator";
571
+ readonly summary: "Create a universe API key";
572
+ readonly description: "Mints an inbound gateway key for one existing universe. The plaintext secret is returned exactly once and cannot be recovered; persist only the displayed prefix for identification.";
573
+ };
574
+ readonly "operator/api-keys/list": {
575
+ readonly scope: "operator";
576
+ readonly summary: "List universe API keys";
577
+ readonly description: "Returns only non-secret key metadata for the requested universe, including revocation and last-use timestamps. Plaintext secrets are never stored or returned.";
578
+ };
579
+ readonly "operator/api-keys/revoke": {
580
+ readonly scope: "operator";
581
+ readonly summary: "Revoke a universe API key";
582
+ readonly description: "Immediately and idempotently revokes the matching key only when it belongs to the requested universe. Unknown and foreign-universe prefixes return not found.";
583
+ };
584
+ readonly "operator/environment-providers/put": {
585
+ readonly scope: "operator";
586
+ readonly summary: "Put an environment provider";
587
+ readonly description: "Registers or replaces one deployment provider and its controller connection. The provider does not call this API or require access to Lightspeed.";
588
+ };
589
+ readonly "operator/environment-providers/list": {
590
+ readonly scope: "operator";
591
+ readonly summary: "List environment providers";
592
+ readonly description: "Returns every operator-registered deployment provider and its controller connection.";
593
+ };
594
+ readonly "operator/environment-providers/read": {
595
+ readonly scope: "operator";
596
+ readonly summary: "Read an environment provider";
597
+ readonly description: "Returns one operator-registered deployment provider and its controller connection.";
598
+ };
599
+ readonly "operator/environment-providers/delete": {
600
+ readonly scope: "operator";
601
+ readonly summary: "Delete an environment provider";
602
+ readonly description: "Deletes a deployment provider only when no universe binding references it.";
603
+ };
604
+ readonly "operator/environment-providers/bindings/put": {
605
+ readonly scope: "operator";
606
+ readonly summary: "Put an environment provider binding";
607
+ readonly 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.";
608
+ };
609
+ readonly "operator/environment-providers/bindings/delete": {
610
+ readonly scope: "operator";
611
+ readonly summary: "Delete an environment provider binding";
612
+ readonly description: "Deletes a universe provider binding only after every referencing environment has reached Closed.";
613
+ };
614
+ readonly "operator/environments/adopt": {
615
+ readonly scope: "operator";
616
+ readonly summary: "Adopt a provider environment";
617
+ readonly description: "Creates a universe environment by transferring an existing provider target into Lightspeed's managed lifecycle. The caller must explicitly accept ownership transfer.";
618
+ };
619
+ readonly "operator/channels/accounts/list": {
620
+ readonly scope: "operator";
621
+ readonly summary: "List channel accounts across universes";
622
+ readonly 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.";
623
+ };
624
+ };
625
+ export declare const NOTIFICATIONS: readonly ["session/started", "session/status/changed", "session/event", "session/runs/started", "session/runs/completed", "error"];
626
+ export type Method = (typeof METHODS)[number];
627
+ export type NotificationMethod = (typeof NOTIFICATIONS)[number];
628
+ export interface MethodMap {
629
+ /**
630
+ * Inspect the Lightspeed protocol
631
+ *
632
+ * Returns protocol version, server identity, and supported capabilities without changing universe state.
633
+ */
634
+ "initialize": {
635
+ params: Api.InitializeParams;
636
+ result: Api.AgentApiOutcomeOfInitializeResponse;
637
+ };
638
+ /**
639
+ * Create or reopen a session
640
+ *
641
+ * Creates a session with optional config/profile setup. Retrying an existing session id returns that session; creation settings apply only when it is first created.
642
+ */
643
+ "session/start": {
644
+ params: Api.SessionStartParams;
645
+ result: Api.AgentApiOutcomeOfSessionStartResponse;
646
+ };
647
+ /**
648
+ * Create or reopen a managed session
649
+ *
650
+ * Creates a session with an immutable lifecycle controller and/or workflow tools using explicit bound pull/push dispatch, start targets, and Accepted, Joined, or keyed-Promise completion. Retrying an existing session id requires the same managed-creation declaration; an ordinary session cannot be upgraded to managed.
651
+ */
652
+ "session/managed/start": {
653
+ params: Api.ManagedSessionStartParams;
654
+ result: Api.AgentApiOutcomeOfSessionStartResponse;
655
+ };
656
+ /**
657
+ * Read a session
658
+ *
659
+ * 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.
660
+ */
661
+ "session/read": {
662
+ params: Api.SessionReadParams;
663
+ result: Api.AgentApiOutcomeOfSessionReadResponse;
664
+ };
665
+ /**
666
+ * List sessions
667
+ *
668
+ * Returns a cursor-paginated summary list ordered by most recent update. Pages may shift while sessions are changing.
669
+ */
670
+ "session/list": {
671
+ params: Api.SessionListParams;
672
+ result: Api.AgentApiOutcomeOfSessionListResponse;
673
+ };
674
+ /**
675
+ * Replace session configuration
676
+ *
677
+ * Replaces the complete sparse config while the session is idle. Use the current config revision for safe read-modify-write; omitted features are revoked and an identical document is a no-op.
678
+ */
679
+ "session/config/put": {
680
+ params: Api.SessionConfigPutParams;
681
+ result: Api.AgentApiOutcomeOfSessionConfigPutResponse;
682
+ };
683
+ /**
684
+ * Rename a session
685
+ *
686
+ * Sets the display name, or clears it when displayName is omitted.
687
+ */
688
+ "session/rename": {
689
+ params: Api.SessionRenameParams;
690
+ result: Api.AgentApiOutcomeOfSessionRenameResponse;
691
+ };
692
+ /**
693
+ * Close a session
694
+ *
695
+ * 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.
696
+ */
697
+ "session/close": {
698
+ params: Api.SessionCloseParams;
699
+ result: Api.AgentApiOutcomeOfSessionCloseResponse;
700
+ };
701
+ /**
702
+ * Delete a closed session
703
+ *
704
+ * Permanently removes session storage after the session has been closed; close active/open sessions first.
705
+ */
706
+ "session/delete": {
707
+ params: Api.SessionDeleteParams;
708
+ result: Api.AgentApiOutcomeOfSessionDeleteResponse;
709
+ };
710
+ /**
711
+ * Read the session event stream
712
+ *
713
+ * Reads events after a cursor and optionally long-polls when caught up. Continue from nextCursor/headCursor and inspect complete/gap rather than assuming an uninterrupted page.
714
+ */
715
+ "session/events/read": {
716
+ params: Api.SessionEventsReadParams;
717
+ result: Api.AgentApiOutcomeOfSessionEventsReadResponse;
718
+ };
719
+ /**
720
+ * Append keyed session context
721
+ *
722
+ * Admits a batch of context entries with per-entry results. Stable keys make same-content retries no-ops; media preprocessing can fail one entry without discarding successful entries.
723
+ */
724
+ "session/context/append": {
725
+ params: Api.ContextAppendParams;
726
+ result: Api.AgentApiOutcomeOfContextAppendResponse;
727
+ };
728
+ /**
729
+ * Remove keyed session context
730
+ *
731
+ * Removes active entries by stable key with per-key results. Missing keys are idempotent no-ops; runtime-reserved run keys cannot be removed.
732
+ */
733
+ "session/context/remove": {
734
+ params: Api.ContextRemoveParams;
735
+ result: Api.AgentApiOutcomeOfContextRemoveResponse;
736
+ };
737
+ /**
738
+ * Compact session context
739
+ *
740
+ * Runs the configured compaction policy on an open idle session and waits for the resulting context revision.
741
+ */
742
+ "session/context/compact": {
743
+ params: Api.ContextCompactParams;
744
+ result: Api.AgentApiOutcomeOfContextCompactResponse;
745
+ };
746
+ /**
747
+ * Start an agent run
748
+ *
749
+ * 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.
750
+ */
751
+ "session/runs/start": {
752
+ params: Api.RunStartParams;
753
+ result: Api.AgentApiOutcomeOfRunStartResponse;
754
+ };
755
+ /**
756
+ * List session runs
757
+ *
758
+ * Returns a newest-first keyset page of bounded run summaries projected from current reducer state.
759
+ */
760
+ "session/runs/list": {
761
+ params: Api.RunListParams;
762
+ result: Api.AgentApiOutcomeOfRunListResponse;
763
+ };
764
+ /**
765
+ * Read one session run
766
+ *
767
+ * Reads and projects one run from its bounded event interval, paged by event sequence.
768
+ */
769
+ "session/runs/read": {
770
+ params: Api.RunReadParams;
771
+ result: Api.AgentApiOutcomeOfRunReadResponse;
772
+ };
773
+ /**
774
+ * Cancel a run
775
+ *
776
+ * 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.
777
+ */
778
+ "session/runs/cancel": {
779
+ params: Api.RunCancelParams;
780
+ result: Api.AgentApiOutcomeOfRunCancelResponse;
781
+ };
782
+ /**
783
+ * Decide pending run approvals
784
+ *
785
+ * 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.
786
+ */
787
+ "session/runs/approvals/decide": {
788
+ params: Api.RunApprovalsDecideParams;
789
+ result: Api.AgentApiOutcomeOfRunApprovalsDecideResponse;
790
+ };
791
+ /**
792
+ * Steer the active run
793
+ *
794
+ * 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.
795
+ */
796
+ "session/runs/steer": {
797
+ params: Api.RunSteerParams;
798
+ result: Api.AgentApiOutcomeOfRunSteerResponse;
799
+ };
800
+ /**
801
+ * List available session skills
802
+ *
803
+ * Refreshes the session's configured VFS skill catalog and reports which discovered skills are enabled and active. An absent catalog yields an empty result.
804
+ */
805
+ "session/skills/list": {
806
+ params: Api.SkillListParams;
807
+ result: Api.AgentApiOutcomeOfSkillListResponse;
808
+ };
809
+ /**
810
+ * List active session skills
811
+ *
812
+ * Returns skill instructions currently injected into context, including activation scope and source.
813
+ */
814
+ "session/skills/active": {
815
+ params: Api.SkillActiveParams;
816
+ result: Api.AgentApiOutcomeOfSkillActiveResponse;
817
+ };
818
+ /**
819
+ * Activate a session skill
820
+ *
821
+ * Loads an enabled skill from the current catalog and injects its instructions into an open idle session. Run-scoped activation is the default.
822
+ */
823
+ "session/skills/activate": {
824
+ params: Api.SkillActivateParams;
825
+ result: Api.AgentApiOutcomeOfSkillActivateResponse;
826
+ };
827
+ /**
828
+ * Deactivate a session skill
829
+ *
830
+ * Removes an active skill's injected context from an open idle session; the skill must currently be active.
831
+ */
832
+ "session/skills/deactivate": {
833
+ params: Api.SkillDeactivateParams;
834
+ result: Api.AgentApiOutcomeOfSkillDeactivateResponse;
835
+ };
836
+ /**
837
+ * Apply a profile to a session
838
+ *
839
+ * 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.
840
+ */
841
+ "session/profiles/apply": {
842
+ params: Api.ProfileApplyParams;
843
+ result: Api.AgentApiOutcomeOfProfileApplyResponse;
844
+ };
845
+ /**
846
+ * Activate a session environment
847
+ *
848
+ * Selects an allowed, live universe environment for environment-targeted tools while the session is idle.
849
+ */
850
+ "session/environments/activate": {
851
+ params: Api.SessionEnvironmentActivateParams;
852
+ result: Api.AgentApiOutcomeOfSessionEnvironmentActivateResponse;
853
+ };
854
+ /**
855
+ * Deactivate the session environment
856
+ *
857
+ * Clears active environment selection without changing or closing the universe environment.
858
+ */
859
+ "session/environments/deactivate": {
860
+ params: Api.SessionEnvironmentDeactivateParams;
861
+ result: Api.AgentApiOutcomeOfSessionEnvironmentDeactivateResponse;
862
+ };
863
+ /**
864
+ * Bind a credential into an environment
865
+ *
866
+ * Maps an environment variable name to an existing grant/provider/direct-secret handle for a universe environment. The response exposes only the source handle, never secret material.
867
+ */
868
+ "environments/credentials/bind": {
869
+ params: Api.EnvironmentCredentialBindParams;
870
+ result: Api.AgentApiOutcomeOfEnvironmentCredentialBindResponse;
871
+ };
872
+ /**
873
+ * List environment credential bindings
874
+ *
875
+ * Returns variable names and credential source handles for a universe environment; resolved secret values are never returned.
876
+ */
877
+ "environments/credentials/list": {
878
+ params: Api.EnvironmentCredentialListParams;
879
+ result: Api.AgentApiOutcomeOfEnvironmentCredentialListResponse;
880
+ };
881
+ /**
882
+ * Unbind an environment credential
883
+ *
884
+ * Removes one variable-to-credential mapping without deleting the underlying grant, provider credential, or secret.
885
+ */
886
+ "environments/credentials/unbind": {
887
+ params: Api.EnvironmentCredentialUnbindParams;
888
+ result: Api.AgentApiOutcomeOfEnvironmentCredentialUnbindResponse;
889
+ };
890
+ /**
891
+ * Create an environment
892
+ *
893
+ * Records an idempotent provisioning intent against an enabled universe binding. The provider validates its provider-wide template and provisions through its backend asynchronously.
894
+ */
895
+ "environments/create": {
896
+ params: Api.EnvironmentCreateParams;
897
+ result: Api.AgentApiOutcomeOfEnvironmentCreateResponse;
898
+ };
899
+ /**
900
+ * Read an environment
901
+ *
902
+ * Returns the durable universe resource, source binding, logical lifecycle state, and minimal current-incarnation identity.
903
+ */
904
+ "environments/read": {
905
+ params: Api.EnvironmentReadParams;
906
+ result: Api.AgentApiOutcomeOfEnvironmentReadResponse;
907
+ };
908
+ /**
909
+ * List environments
910
+ *
911
+ * Lists universe-owned environment resources, optionally filtered by provider, binding, or logical lifecycle state.
912
+ */
913
+ "environments/list": {
914
+ params: Api.EnvironmentListParams;
915
+ result: Api.AgentApiOutcomeOfEnvironmentListResponse;
916
+ };
917
+ /**
918
+ * Close an environment
919
+ *
920
+ * Records an asynchronous idempotent close intent. Provider cleanup is resumed by lifecycle reconciliation; quota is released only after Closed.
921
+ */
922
+ "environments/close": {
923
+ params: Api.EnvironmentCloseParams;
924
+ result: Api.AgentApiOutcomeOfEnvironmentCloseResponse;
925
+ };
926
+ /**
927
+ * Register an external environment
928
+ *
929
+ * Creates an environment backed by a Lightspeed-reachable envd WebSocket endpoint. Reachability is checked on demand.
930
+ */
931
+ "environments/external/create": {
932
+ params: Api.EnvironmentExternalCreateParams;
933
+ result: Api.AgentApiOutcomeOfEnvironmentExternalCreateResponse;
934
+ };
935
+ /**
936
+ * Configure environment public ingress
937
+ *
938
+ * 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.
939
+ */
940
+ "environments/ingress/put": {
941
+ params: Api.EnvironmentIngressPutParams;
942
+ result: Api.AgentApiOutcomeOfEnvironmentIngressPutResponse;
943
+ };
944
+ /**
945
+ * Set environment power intent
946
+ *
947
+ * 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.
948
+ */
949
+ "environments/power/put": {
950
+ params: Api.EnvironmentPowerPutParams;
951
+ result: Api.AgentApiOutcomeOfEnvironmentPowerPutResponse;
952
+ };
953
+ /**
954
+ * Set environment idle policy
955
+ *
956
+ * 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.
957
+ */
958
+ "environments/idle-policy/put": {
959
+ params: Api.EnvironmentIdlePolicyPutParams;
960
+ result: Api.AgentApiOutcomeOfEnvironmentIdlePolicyPutResponse;
961
+ };
962
+ /**
963
+ * List environment provider bindings
964
+ *
965
+ * Lists this universe's revisioned routing and admission bindings to deployment-scoped physical providers.
966
+ */
967
+ "environments/provider-bindings/list": {
968
+ params: Api.EnvironmentProviderBindingListParams;
969
+ result: Api.AgentApiOutcomeOfEnvironmentProviderBindingListResponse;
970
+ };
971
+ /**
972
+ * Read an environment provider binding
973
+ *
974
+ * Returns one universe routing and admission binding. Provider-wide templates and physical resource, network, and ingress policy remain provider-owned.
975
+ */
976
+ "environments/provider-bindings/read": {
977
+ params: Api.EnvironmentProviderBindingReadParams;
978
+ result: Api.AgentApiOutcomeOfEnvironmentProviderBindingReadResponse;
979
+ };
980
+ /**
981
+ * List environment templates
982
+ *
983
+ * Reads immutable templates directly from the selected bound provider controller.
984
+ */
985
+ "environments/templates/list": {
986
+ params: Api.EnvironmentTemplateListParams;
987
+ result: Api.AgentApiOutcomeOfEnvironmentTemplateListResponse;
988
+ };
989
+ /**
990
+ * Read an environment template
991
+ *
992
+ * Returns one immutable template version from the selected bound provider controller.
993
+ */
994
+ "environments/templates/read": {
995
+ params: Api.EnvironmentTemplateReadParams;
996
+ result: Api.AgentApiOutcomeOfEnvironmentTemplateReadResponse;
997
+ };
998
+ /**
999
+ * Create environment jobs
1000
+ *
1001
+ * 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.
1002
+ */
1003
+ "environments/jobs/create": {
1004
+ params: Api.EnvironmentJobCreateParams;
1005
+ result: Api.AgentApiOutcomeOfEnvironmentJobCreateResponse;
1006
+ };
1007
+ /**
1008
+ * Read environment jobs
1009
+ *
1010
+ * Reads selected job handles with bounded output, optional sequence continuation, and optional artifacts; use returned status/sequence data for polling.
1011
+ */
1012
+ "environments/jobs/read": {
1013
+ params: Api.EnvironmentJobReadParams;
1014
+ result: Api.AgentApiOutcomeOfEnvironmentJobReadResponse;
1015
+ };
1016
+ /**
1017
+ * Cancel environment jobs
1018
+ *
1019
+ * Requests cancellation for selected jobs, optionally including dependents. Force is provider-specific escalation; inspect each per-job result.
1020
+ */
1021
+ "environments/jobs/cancel": {
1022
+ params: Api.EnvironmentJobCancelParams;
1023
+ result: Api.AgentApiOutcomeOfEnvironmentJobCancelResponse;
1024
+ };
1025
+ /**
1026
+ * Discover available models
1027
+ *
1028
+ * Queries supported providers directly on every call and returns best-effort selectable routes. One provider failure does not discard successful results from others.
1029
+ */
1030
+ "models/list": {
1031
+ params: Api.ModelListParams;
1032
+ result: Api.AgentApiOutcomeOfModelListResponse;
1033
+ };
1034
+ /**
1035
+ * Create an agent profile
1036
+ *
1037
+ * Creates a new universe-scoped reusable profile document; use profiles/put for create-or-replace revision semantics.
1038
+ */
1039
+ "profiles/create": {
1040
+ params: Api.ProfileCreateParams;
1041
+ result: Api.AgentApiOutcomeOfProfileCreateResponse;
1042
+ };
1043
+ /**
1044
+ * Read an agent profile
1045
+ *
1046
+ * Returns the complete profile document and current revision.
1047
+ */
1048
+ "profiles/read": {
1049
+ params: Api.ProfileReadParams;
1050
+ result: Api.AgentApiOutcomeOfProfileReadResponse;
1051
+ };
1052
+ /**
1053
+ * List agent profiles
1054
+ *
1055
+ * Returns lightweight summaries of universe-scoped reusable profiles.
1056
+ */
1057
+ "profiles/list": {
1058
+ params: Api.ProfileListParams;
1059
+ result: Api.AgentApiOutcomeOfProfileListResponse;
1060
+ };
1061
+ /**
1062
+ * Create or replace an agent profile
1063
+ *
1064
+ * Stores the complete profile document. Use expectedRevision from profiles/read when replacing to prevent lost updates; absence writes unconditionally.
1065
+ */
1066
+ "profiles/put": {
1067
+ params: Api.ProfilePutParams;
1068
+ result: Api.AgentApiOutcomeOfProfilePutResponse;
1069
+ };
1070
+ /**
1071
+ * Delete an agent profile
1072
+ *
1073
+ * Deletes the catalog document; sessions previously created or configured from it retain their materialized state.
1074
+ */
1075
+ "profiles/delete": {
1076
+ params: Api.ProfileDeleteParams;
1077
+ result: Api.AgentApiOutcomeOfProfileDeleteResponse;
1078
+ };
1079
+ /**
1080
+ * Store content-addressed blobs
1081
+ *
1082
+ * Decodes and stores a batch of base64 payloads, returning immutable content references in request order. Re-uploading identical bytes is naturally deduplicated.
1083
+ */
1084
+ "blobs/put": {
1085
+ params: Api.BlobPutParams;
1086
+ result: Api.AgentApiOutcomeOfBlobPutResponse;
1087
+ };
1088
+ /**
1089
+ * Read a content-addressed blob
1090
+ *
1091
+ * Returns the complete immutable blob as base64; large values count against gateway and MCP response limits.
1092
+ */
1093
+ "blobs/read": {
1094
+ params: Api.BlobReadParams;
1095
+ result: Api.AgentApiOutcomeOfBlobReadResponse;
1096
+ };
1097
+ /**
1098
+ * Check blob availability
1099
+ *
1100
+ * Checks a batch of content references without returning blob bodies, preserving request order.
1101
+ */
1102
+ "blobs/has": {
1103
+ params: Api.BlobHasParams;
1104
+ result: Api.AgentApiOutcomeOfBlobHasResponse;
1105
+ };
1106
+ /**
1107
+ * Commit a VFS snapshot
1108
+ *
1109
+ * Validates and stores an immutable filesystem manifest. Upload referenced file blobs first; the returned snapshot ref is content-addressed.
1110
+ */
1111
+ "vfs/snapshots/commit": {
1112
+ params: Api.VfsSnapshotCommitParams;
1113
+ result: Api.AgentApiOutcomeOfVfsSnapshotCommitResponse;
1114
+ };
1115
+ /**
1116
+ * Read a VFS snapshot
1117
+ *
1118
+ * Returns an immutable snapshot manifest and aggregate file/byte counts; file bodies remain separate blobs.
1119
+ */
1120
+ "vfs/snapshots/read": {
1121
+ params: Api.VfsSnapshotReadParams;
1122
+ result: Api.AgentApiOutcomeOfVfsSnapshotReadResponse;
1123
+ };
1124
+ /**
1125
+ * Create a mutable VFS workspace
1126
+ *
1127
+ * Creates a universe workspace at an optional seed snapshot; absence starts from a server-created empty snapshot.
1128
+ */
1129
+ "vfs/workspaces/create": {
1130
+ params: Api.VfsWorkspaceCreateParams;
1131
+ result: Api.AgentApiOutcomeOfVfsWorkspaceCreateResponse;
1132
+ };
1133
+ /**
1134
+ * Read a VFS workspace
1135
+ *
1136
+ * Returns workspace metadata, current head snapshot, and revision for safe updates.
1137
+ */
1138
+ "vfs/workspaces/read": {
1139
+ params: Api.VfsWorkspaceReadParams;
1140
+ result: Api.AgentApiOutcomeOfVfsWorkspaceReadResponse;
1141
+ };
1142
+ /**
1143
+ * List VFS workspaces
1144
+ *
1145
+ * Lists mutable universe workspaces with head snapshots, sizes, and revisions.
1146
+ */
1147
+ "vfs/workspaces/list": {
1148
+ params: Api.VfsWorkspaceListParams;
1149
+ result: Api.AgentApiOutcomeOfVfsWorkspaceListResponse;
1150
+ };
1151
+ /**
1152
+ * Update a VFS workspace
1153
+ *
1154
+ * Moves the workspace head to an existing snapshot and updates its display name. Pass expectedRevision from a read to prevent lost updates.
1155
+ */
1156
+ "vfs/workspaces/update": {
1157
+ params: Api.VfsWorkspaceUpdateParams;
1158
+ result: Api.AgentApiOutcomeOfVfsWorkspaceUpdateResponse;
1159
+ };
1160
+ /**
1161
+ * Delete a VFS workspace
1162
+ *
1163
+ * Deletes the mutable workspace record; immutable snapshots and blobs remain content-addressed resources.
1164
+ */
1165
+ "vfs/workspaces/delete": {
1166
+ params: Api.VfsWorkspaceDeleteParams;
1167
+ result: Api.AgentApiOutcomeOfVfsWorkspaceDeleteResponse;
1168
+ };
1169
+ /**
1170
+ * Create or replace an MCP server record
1171
+ *
1172
+ * Stores the complete universe catalog document, including its optional universe auth-grant credential. Use expectedRevision when replacing; token material is never accepted or returned.
1173
+ */
1174
+ "mcp/servers/put": {
1175
+ params: Api.McpServerPutParams;
1176
+ result: Api.AgentApiOutcomeOfMcpServerPutResponse;
1177
+ };
1178
+ /**
1179
+ * Discover MCP server authentication
1180
+ *
1181
+ * 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.
1182
+ */
1183
+ "mcp/servers/auth/discover": {
1184
+ params: Api.McpServerAuthDiscoverParams;
1185
+ result: Api.AgentApiOutcomeOfMcpServerAuthDiscoverResponse;
1186
+ };
1187
+ /**
1188
+ * Discover MCP server tools
1189
+ *
1190
+ * 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.
1191
+ */
1192
+ "mcp/servers/tools/discover": {
1193
+ params: Api.McpServerToolsDiscoverParams;
1194
+ result: Api.AgentApiOutcomeOfMcpServerToolsDiscoverResponse;
1195
+ };
1196
+ /**
1197
+ * Read an MCP server record
1198
+ *
1199
+ * Returns one catalog document with defaults, auth policy, non-secret grant binding, status, and revision; no credential value is exposed.
1200
+ */
1201
+ "mcp/servers/read": {
1202
+ params: Api.McpServerReadParams;
1203
+ result: Api.AgentApiOutcomeOfMcpServerReadResponse;
1204
+ };
1205
+ /**
1206
+ * List MCP server records
1207
+ *
1208
+ * Lists universe catalog entries, optionally filtered by lifecycle/configuration status.
1209
+ */
1210
+ "mcp/servers/list": {
1211
+ params: Api.McpServerListParams;
1212
+ result: Api.AgentApiOutcomeOfMcpServerListResponse;
1213
+ };
1214
+ /**
1215
+ * Delete an MCP server record
1216
+ *
1217
+ * Deletes the catalog document. Existing session configs that reference it are not silently rewritten and may need explicit reconfiguration.
1218
+ */
1219
+ "mcp/servers/delete": {
1220
+ params: Api.McpServerDeleteParams;
1221
+ result: Api.AgentApiOutcomeOfMcpServerDeleteResponse;
1222
+ };
1223
+ /**
1224
+ * Import a static bearer grant
1225
+ *
1226
+ * 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.
1227
+ */
1228
+ "auth/grants/import": {
1229
+ params: Api.AuthGrantImportParams;
1230
+ result: Api.AgentApiOutcomeOfAuthGrantImportResponse;
1231
+ };
1232
+ /**
1233
+ * Lease a retrievable authentication grant
1234
+ *
1235
+ * 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.
1236
+ */
1237
+ "auth/grants/lease": {
1238
+ params: Api.AuthGrantLeaseParams;
1239
+ result: Api.AgentApiOutcomeOfAuthGrantLeaseResponse;
1240
+ };
1241
+ /**
1242
+ * Read authentication grant metadata
1243
+ *
1244
+ * Returns principal, provider binding, scopes, audience, expiry, status, and token-presence flags; access and refresh token values are never returned.
1245
+ */
1246
+ "auth/grants/read": {
1247
+ params: Api.AuthGrantReadParams;
1248
+ result: Api.AgentApiOutcomeOfAuthGrantReadResponse;
1249
+ };
1250
+ /**
1251
+ * List authentication grants
1252
+ *
1253
+ * Lists non-secret grant metadata for the universe, optionally filtered by status.
1254
+ */
1255
+ "auth/grants/list": {
1256
+ params: Api.AuthGrantListParams;
1257
+ result: Api.AgentApiOutcomeOfAuthGrantListResponse;
1258
+ };
1259
+ /**
1260
+ * Revoke an authentication grant
1261
+ *
1262
+ * Marks the grant unusable by token consumers while retaining non-secret audit metadata.
1263
+ */
1264
+ "auth/grants/revoke": {
1265
+ params: Api.AuthGrantRevokeParams;
1266
+ result: Api.AgentApiOutcomeOfAuthGrantRevokeResponse;
1267
+ };
1268
+ /**
1269
+ * Register an OAuth client
1270
+ *
1271
+ * Stores provider endpoints and client identity; an optional plaintext client secret is encrypted and represented thereafter only by hasClientSecret.
1272
+ */
1273
+ "auth/clients/create": {
1274
+ params: Api.AuthClientCreateParams;
1275
+ result: Api.AgentApiOutcomeOfAuthClientCreateResponse;
1276
+ };
1277
+ /**
1278
+ * Read OAuth client metadata
1279
+ *
1280
+ * Returns endpoints, public client identity, defaults, and secret-presence state; the client secret is never returned.
1281
+ */
1282
+ "auth/clients/read": {
1283
+ params: Api.AuthClientReadParams;
1284
+ result: Api.AgentApiOutcomeOfAuthClientReadResponse;
1285
+ };
1286
+ /**
1287
+ * List OAuth clients
1288
+ *
1289
+ * Lists non-secret OAuth client registrations in the universe.
1290
+ */
1291
+ "auth/clients/list": {
1292
+ params: Api.AuthClientListParams;
1293
+ result: Api.AgentApiOutcomeOfAuthClientListResponse;
1294
+ };
1295
+ /**
1296
+ * Delete an OAuth client
1297
+ *
1298
+ * Deletes the client registration and its stored client secret; grants already created from it remain separate records.
1299
+ */
1300
+ "auth/clients/delete": {
1301
+ params: Api.AuthClientDeleteParams;
1302
+ result: Api.AgentApiOutcomeOfAuthClientDeleteResponse;
1303
+ };
1304
+ /**
1305
+ * Start an OAuth authorization flow
1306
+ *
1307
+ * 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.
1308
+ */
1309
+ "auth/flows/start": {
1310
+ params: Api.AuthFlowStartParams;
1311
+ result: Api.AgentApiOutcomeOfAuthFlowStartResponse;
1312
+ };
1313
+ /**
1314
+ * Read OAuth flow status
1315
+ *
1316
+ * Polls a flow's pending/completed/failed/expired state and returns the resulting grant id when authorization succeeds; no token value is exposed.
1317
+ */
1318
+ "auth/flows/read": {
1319
+ params: Api.AuthFlowStatusParams;
1320
+ result: Api.AgentApiOutcomeOfAuthFlowStatusResponse;
1321
+ };
1322
+ /**
1323
+ * Register an authentication provider
1324
+ *
1325
+ * Creates a model or GitHub credential source. Plaintext API keys/private keys are encrypted on receipt and later represented only by configuration plus hasCredential.
1326
+ */
1327
+ "auth/providers/create": {
1328
+ params: Api.AuthProviderCreateParams;
1329
+ result: Api.AgentApiOutcomeOfAuthProviderCreateResponse;
1330
+ };
1331
+ /**
1332
+ * Read authentication provider metadata
1333
+ *
1334
+ * Returns provider kind, non-secret configuration, credential-presence state, and status; stored credentials are never returned.
1335
+ */
1336
+ "auth/providers/read": {
1337
+ params: Api.AuthProviderReadParams;
1338
+ result: Api.AgentApiOutcomeOfAuthProviderReadResponse;
1339
+ };
1340
+ /**
1341
+ * List authentication providers
1342
+ *
1343
+ * Lists non-secret model/GitHub provider registrations for the universe.
1344
+ */
1345
+ "auth/providers/list": {
1346
+ params: Api.AuthProviderListParams;
1347
+ result: Api.AgentApiOutcomeOfAuthProviderListResponse;
1348
+ };
1349
+ /**
1350
+ * Delete an authentication provider
1351
+ *
1352
+ * Deletes the provider registration and its directly stored credential; separately stored grants remain independent records.
1353
+ */
1354
+ "auth/providers/delete": {
1355
+ params: Api.AuthProviderDeleteParams;
1356
+ result: Api.AgentApiOutcomeOfAuthProviderDeleteResponse;
1357
+ };
1358
+ /**
1359
+ * List GitHub App installations
1360
+ *
1361
+ * Uses the registered GitHub App provider credential to query accessible installations and returns account/permission metadata without tokens.
1362
+ */
1363
+ "auth/github/installations/list": {
1364
+ params: Api.AuthGitHubInstallationListParams;
1365
+ result: Api.AgentApiOutcomeOfAuthGitHubInstallationListResponse;
1366
+ };
1367
+ /**
1368
+ * Grant access to a GitHub App installation
1369
+ *
1370
+ * Creates or refreshes a universe auth grant for one accessible installation. The installation token is brokered internally and never returned.
1371
+ */
1372
+ "auth/github/installations/grant": {
1373
+ params: Api.AuthGitHubInstallationGrantParams;
1374
+ result: Api.AgentApiOutcomeOfAuthGitHubInstallationGrantResponse;
1375
+ };
1376
+ /**
1377
+ * Create a bot
1378
+ *
1379
+ * 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.
1380
+ */
1381
+ "bots/create": {
1382
+ params: Api.BotCreateParams;
1383
+ result: Api.AgentApiOutcomeOfBotCreateResponse;
1384
+ };
1385
+ /**
1386
+ * Create or replace a bot document
1387
+ *
1388
+ * 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.
1389
+ */
1390
+ "bots/put": {
1391
+ params: Api.BotPutParams;
1392
+ result: Api.AgentApiOutcomeOfBotPutResponse;
1393
+ };
1394
+ /**
1395
+ * Read a bot
1396
+ *
1397
+ * Returns the bot record, its current revision, and lifecycle columns.
1398
+ */
1399
+ "bots/read": {
1400
+ params: Api.BotReadParams;
1401
+ result: Api.AgentApiOutcomeOfBotReadResponse;
1402
+ };
1403
+ /**
1404
+ * List bots
1405
+ *
1406
+ * Returns the roster: every bot with its trigger count, pending event count, and latest event.
1407
+ */
1408
+ "bots/list": {
1409
+ params: Api.BotListParams;
1410
+ result: Api.AgentApiOutcomeOfBotListResponse;
1411
+ };
1412
+ /**
1413
+ * Close a bot
1414
+ *
1415
+ * 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.
1416
+ */
1417
+ "bots/close": {
1418
+ params: Api.BotCloseParams;
1419
+ result: Api.AgentApiOutcomeOfBotCloseResponse;
1420
+ };
1421
+ /**
1422
+ * Delete a bot
1423
+ *
1424
+ * 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.
1425
+ */
1426
+ "bots/delete": {
1427
+ params: Api.BotDeleteParams;
1428
+ result: Api.AgentApiOutcomeOfBotDeleteResponse;
1429
+ };
1430
+ /**
1431
+ * Read bot controller state
1432
+ *
1433
+ * 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.
1434
+ */
1435
+ "bots/state/read": {
1436
+ params: Api.BotStateReadParams;
1437
+ result: Api.AgentApiOutcomeOfBotStateReadResponse;
1438
+ };
1439
+ /**
1440
+ * Rotate a bot session
1441
+ *
1442
+ * 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.
1443
+ */
1444
+ "bots/sessions/rotate": {
1445
+ params: Api.BotSessionRotateParams;
1446
+ result: Api.AgentApiOutcomeOfBotSessionRotateResponse;
1447
+ };
1448
+ /**
1449
+ * Create or replace a trigger
1450
+ *
1451
+ * 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.
1452
+ */
1453
+ "bots/triggers/put": {
1454
+ params: Api.BotTriggerPutParams;
1455
+ result: Api.AgentApiOutcomeOfBotTriggerPutResponse;
1456
+ };
1457
+ /**
1458
+ * Read a trigger
1459
+ *
1460
+ * Returns one trigger with its incidents and cursor; the ingest path and pairing code are shown only to managing principals.
1461
+ */
1462
+ "bots/triggers/read": {
1463
+ params: Api.BotTriggerReadParams;
1464
+ result: Api.AgentApiOutcomeOfBotTriggerReadResponse;
1465
+ };
1466
+ /**
1467
+ * List a bot's triggers
1468
+ *
1469
+ * Returns every trigger of the bot ordered by id, secrets redacted for non-managing principals.
1470
+ */
1471
+ "bots/triggers/list": {
1472
+ params: Api.BotTriggerListParams;
1473
+ result: Api.AgentApiOutcomeOfBotTriggerListResponse;
1474
+ };
1475
+ /**
1476
+ * Delete a trigger
1477
+ *
1478
+ * Drops the trigger's Temporal Schedule and pairings, then the record; stored events keep their history.
1479
+ */
1480
+ "bots/triggers/delete": {
1481
+ params: Api.BotTriggerDeleteParams;
1482
+ result: Api.AgentApiOutcomeOfBotTriggerDeleteResponse;
1483
+ };
1484
+ /**
1485
+ * Admit an event manually
1486
+ *
1487
+ * 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.
1488
+ */
1489
+ "bots/events/admit": {
1490
+ params: Api.BotEventAdmitParams;
1491
+ result: Api.AgentApiOutcomeOfBotEventAdmitResponse;
1492
+ };
1493
+ /**
1494
+ * Replay a stored event
1495
+ *
1496
+ * Re-admits the stored envelope as a fresh event with the original routing; the replay never coalesces.
1497
+ */
1498
+ "bots/events/replay": {
1499
+ params: Api.BotEventReplayParams;
1500
+ result: Api.AgentApiOutcomeOfBotEventReplayResponse;
1501
+ };
1502
+ /**
1503
+ * List a bot's events
1504
+ *
1505
+ * Cursor-paginated event log, newest first, with outcomes; payload documents stay in the CAS.
1506
+ */
1507
+ "bots/events/list": {
1508
+ params: Api.BotEventListParams;
1509
+ result: Api.AgentApiOutcomeOfBotEventListResponse;
1510
+ };
1511
+ /**
1512
+ * Read an event by number
1513
+ *
1514
+ * Returns the event row and its full stored envelope document.
1515
+ */
1516
+ "bots/events/read": {
1517
+ params: Api.BotEventReadParams;
1518
+ result: Api.AgentApiOutcomeOfBotEventReadResponse;
1519
+ };
1520
+ /**
1521
+ * Test a CEL filter
1522
+ *
1523
+ * Evaluates a filter against one payload or a sample of recent stored events, reporting matches and evaluation errors without changing anything.
1524
+ */
1525
+ "bots/filters/test": {
1526
+ params: Api.BotFilterTestParams;
1527
+ result: Api.AgentApiOutcomeOfBotFilterTestResponse;
1528
+ };
1529
+ /**
1530
+ * Create a channel account
1531
+ *
1532
+ * Registers a provider account (Telegram, WhatsApp) for this universe. The credential is a retrievable grant reference; no token is accepted here.
1533
+ */
1534
+ "channels/accounts/create": {
1535
+ params: Api.ChannelAccountCreateParams;
1536
+ result: Api.AgentApiOutcomeOfChannelAccountCreateResponse;
1537
+ };
1538
+ /**
1539
+ * Create or replace a channel account
1540
+ *
1541
+ * Replaces the account document whole; pass expectedRevision when replacing. The connector host picks the change up on its next discovery pass.
1542
+ */
1543
+ "channels/accounts/put": {
1544
+ params: Api.ChannelAccountPutParams;
1545
+ result: Api.AgentApiOutcomeOfChannelAccountPutResponse;
1546
+ };
1547
+ /**
1548
+ * Read a channel account
1549
+ *
1550
+ * Returns the account document and revision.
1551
+ */
1552
+ "channels/accounts/read": {
1553
+ params: Api.ChannelAccountReadParams;
1554
+ result: Api.AgentApiOutcomeOfChannelAccountReadResponse;
1555
+ };
1556
+ /**
1557
+ * List channel accounts
1558
+ *
1559
+ * Lists this universe's provider accounts, optionally by provider.
1560
+ */
1561
+ "channels/accounts/list": {
1562
+ params: Api.ChannelAccountListParams;
1563
+ result: Api.AgentApiOutcomeOfChannelAccountListResponse;
1564
+ };
1565
+ /**
1566
+ * Delete a channel account
1567
+ *
1568
+ * Removes the account and its pairings; chat triggers that reference it stop serving conversations.
1569
+ */
1570
+ "channels/accounts/delete": {
1571
+ params: Api.ChannelAccountDeleteParams;
1572
+ result: Api.AgentApiOutcomeOfChannelAccountDeleteResponse;
1573
+ };
1574
+ /**
1575
+ * Admit a provider message
1576
+ *
1577
+ * 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.
1578
+ */
1579
+ "channels/inbound/admit": {
1580
+ params: Api.ChannelInboundAdmitParams;
1581
+ result: Api.AgentApiOutcomeOfChannelInboundAdmitResponse;
1582
+ };
1583
+ /**
1584
+ * List chat pairings
1585
+ *
1586
+ * Lists conversations paired to chat triggers, optionally by account or bot.
1587
+ */
1588
+ "channels/pairings/list": {
1589
+ params: Api.ChannelPairingListParams;
1590
+ result: Api.AgentApiOutcomeOfChannelPairingListResponse;
1591
+ };
1592
+ /**
1593
+ * Unpair a conversation
1594
+ *
1595
+ * Removes one pairing; the conversation must present the pairing code again to reconnect.
1596
+ */
1597
+ "channels/pairings/delete": {
1598
+ params: Api.ChannelPairingDeleteParams;
1599
+ result: Api.AgentApiOutcomeOfChannelPairingDeleteResponse;
1600
+ };
1601
+ /**
1602
+ * Read a conversation snapshot
1603
+ *
1604
+ * Queries the conversation workflow's live state for one chat, for debugging; absent when no workflow exists yet.
1605
+ */
1606
+ "channels/conversations/read": {
1607
+ params: Api.ChannelConversationReadParams;
1608
+ result: Api.AgentApiOutcomeOfChannelConversationReadResponse;
1609
+ };
1610
+ /**
1611
+ * Create a universe
1612
+ *
1613
+ * Creates the deployment tenant boundary for an explicit UUID. The operation is idempotent and reports whether a new universe was created.
1614
+ */
1615
+ "operator/universes/create": {
1616
+ params: Api.OperatorUniverseCreateParams;
1617
+ result: Api.AgentApiOutcomeOfOperatorUniverseCreateResponse;
1618
+ };
1619
+ /**
1620
+ * List universes
1621
+ *
1622
+ * Returns deployment-wide universe summaries with approximate live aggregate counts and last session activity.
1623
+ */
1624
+ "operator/universes/list": {
1625
+ params: Api.OperatorUniverseListParams;
1626
+ result: Api.AgentApiOutcomeOfOperatorUniverseListResponse;
1627
+ };
1628
+ /**
1629
+ * Read a universe
1630
+ *
1631
+ * Returns one deployment tenant summary with aggregate session, workspace, profile, and blob usage.
1632
+ */
1633
+ "operator/universes/read": {
1634
+ params: Api.OperatorUniverseReadParams;
1635
+ result: Api.AgentApiOutcomeOfOperatorUniverseReadResponse;
1636
+ };
1637
+ /**
1638
+ * Purge a universe
1639
+ *
1640
+ * Permanently terminates live session workflows, deletes external blob objects, and cascades universe data. The purge is resumable/idempotent after partial failure.
1641
+ */
1642
+ "operator/universes/delete": {
1643
+ params: Api.OperatorUniverseDeleteParams;
1644
+ result: Api.AgentApiOutcomeOfOperatorUniverseDeleteResponse;
1645
+ };
1646
+ /**
1647
+ * Create a universe API key
1648
+ *
1649
+ * Mints an inbound gateway key for one existing universe. The plaintext secret is returned exactly once and cannot be recovered; persist only the displayed prefix for identification.
1650
+ */
1651
+ "operator/api-keys/create": {
1652
+ params: Api.OperatorApiKeyCreateParams;
1653
+ result: Api.AgentApiOutcomeOfOperatorApiKeyCreateResponse;
1654
+ };
1655
+ /**
1656
+ * List universe API keys
1657
+ *
1658
+ * Returns only non-secret key metadata for the requested universe, including revocation and last-use timestamps. Plaintext secrets are never stored or returned.
1659
+ */
1660
+ "operator/api-keys/list": {
1661
+ params: Api.OperatorApiKeyListParams;
1662
+ result: Api.AgentApiOutcomeOfOperatorApiKeyListResponse;
1663
+ };
1664
+ /**
1665
+ * Revoke a universe API key
1666
+ *
1667
+ * Immediately and idempotently revokes the matching key only when it belongs to the requested universe. Unknown and foreign-universe prefixes return not found.
1668
+ */
1669
+ "operator/api-keys/revoke": {
1670
+ params: Api.OperatorApiKeyRevokeParams;
1671
+ result: Api.AgentApiOutcomeOfOperatorApiKeyRevokeResponse;
1672
+ };
1673
+ /**
1674
+ * Put an environment provider
1675
+ *
1676
+ * Registers or replaces one deployment provider and its controller connection. The provider does not call this API or require access to Lightspeed.
1677
+ */
1678
+ "operator/environment-providers/put": {
1679
+ params: Api.OperatorEnvironmentProviderPutParams;
1680
+ result: Api.AgentApiOutcomeOfOperatorEnvironmentProviderPutResponse;
1681
+ };
1682
+ /**
1683
+ * List environment providers
1684
+ *
1685
+ * Returns every operator-registered deployment provider and its controller connection.
1686
+ */
1687
+ "operator/environment-providers/list": {
1688
+ params: Api.OperatorEnvironmentProviderListParams;
1689
+ result: Api.AgentApiOutcomeOfOperatorEnvironmentProviderListResponse;
1690
+ };
1691
+ /**
1692
+ * Read an environment provider
1693
+ *
1694
+ * Returns one operator-registered deployment provider and its controller connection.
1695
+ */
1696
+ "operator/environment-providers/read": {
1697
+ params: Api.OperatorEnvironmentProviderReadParams;
1698
+ result: Api.AgentApiOutcomeOfOperatorEnvironmentProviderReadResponse;
1699
+ };
1700
+ /**
1701
+ * Delete an environment provider
1702
+ *
1703
+ * Deletes a deployment provider only when no universe binding references it.
1704
+ */
1705
+ "operator/environment-providers/delete": {
1706
+ params: Api.OperatorEnvironmentProviderDeleteParams;
1707
+ result: Api.AgentApiOutcomeOfOperatorEnvironmentProviderDeleteResponse;
1708
+ };
1709
+ /**
1710
+ * Put an environment provider binding
1711
+ *
1712
+ * Creates or replaces one universe's complete revisioned routing and admission binding. A deployment provider may have at most one binding in a universe.
1713
+ */
1714
+ "operator/environment-providers/bindings/put": {
1715
+ params: Api.OperatorProviderBindingPutParams;
1716
+ result: Api.AgentApiOutcomeOfOperatorProviderBindingPutResponse;
1717
+ };
1718
+ /**
1719
+ * Delete an environment provider binding
1720
+ *
1721
+ * Deletes a universe provider binding only after every referencing environment has reached Closed.
1722
+ */
1723
+ "operator/environment-providers/bindings/delete": {
1724
+ params: Api.OperatorProviderBindingDeleteParams;
1725
+ result: Api.AgentApiOutcomeOfOperatorProviderBindingDeleteResponse;
1726
+ };
1727
+ /**
1728
+ * Adopt a provider environment
1729
+ *
1730
+ * Creates a universe environment by transferring an existing provider target into Lightspeed's managed lifecycle. The caller must explicitly accept ownership transfer.
1731
+ */
1732
+ "operator/environments/adopt": {
1733
+ params: Api.OperatorEnvironmentAdoptParams;
1734
+ result: Api.AgentApiOutcomeOfOperatorEnvironmentAdoptResponse;
1735
+ };
1736
+ /**
1737
+ * List channel accounts across universes
1738
+ *
1739
+ * 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.
1740
+ */
1741
+ "operator/channels/accounts/list": {
1742
+ params: Api.OperatorChannelAccountListParams;
1743
+ result: Api.AgentApiOutcomeOfOperatorChannelAccountListResponse;
1744
+ };
1745
+ }
1746
+ export type MethodParams<M extends Method> = MethodMap[M]["params"];
1747
+ export type MethodResult<M extends Method> = MethodMap[M]["result"];
1748
+ export interface RpcCaller {
1749
+ call<M extends Method>(method: M, params: MethodParams<M>): Promise<MethodResult<M>>;
1750
+ }
1751
+ export declare const rpc: {
1752
+ /**
1753
+ * Inspect the Lightspeed protocol
1754
+ *
1755
+ * Returns protocol version, server identity, and supported capabilities without changing universe state.
1756
+ */
1757
+ readonly initialize: (client: RpcCaller, params: Api.InitializeParams) => Promise<Api.AgentApiOutcomeOfInitializeResponse>;
1758
+ /**
1759
+ * Create or reopen a session
1760
+ *
1761
+ * Creates a session with optional config/profile setup. Retrying an existing session id returns that session; creation settings apply only when it is first created.
1762
+ */
1763
+ readonly sessionStart: (client: RpcCaller, params: Api.SessionStartParams) => Promise<Api.AgentApiOutcomeOfSessionStartResponse>;
1764
+ /**
1765
+ * Create or reopen a managed session
1766
+ *
1767
+ * Creates a session with an immutable lifecycle controller and/or workflow tools using explicit bound pull/push dispatch, start targets, and Accepted, Joined, or keyed-Promise completion. Retrying an existing session id requires the same managed-creation declaration; an ordinary session cannot be upgraded to managed.
1768
+ */
1769
+ readonly sessionManagedStart: (client: RpcCaller, params: Api.ManagedSessionStartParams) => Promise<Api.AgentApiOutcomeOfSessionStartResponse>;
1770
+ /**
1771
+ * Read a session
1772
+ *
1773
+ * 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.
1774
+ */
1775
+ readonly sessionRead: (client: RpcCaller, params: Api.SessionReadParams) => Promise<Api.AgentApiOutcomeOfSessionReadResponse>;
1776
+ /**
1777
+ * List sessions
1778
+ *
1779
+ * Returns a cursor-paginated summary list ordered by most recent update. Pages may shift while sessions are changing.
1780
+ */
1781
+ readonly sessionList: (client: RpcCaller, params: Api.SessionListParams) => Promise<Api.AgentApiOutcomeOfSessionListResponse>;
1782
+ /**
1783
+ * Replace session configuration
1784
+ *
1785
+ * Replaces the complete sparse config while the session is idle. Use the current config revision for safe read-modify-write; omitted features are revoked and an identical document is a no-op.
1786
+ */
1787
+ readonly sessionConfigPut: (client: RpcCaller, params: Api.SessionConfigPutParams) => Promise<Api.AgentApiOutcomeOfSessionConfigPutResponse>;
1788
+ /**
1789
+ * Rename a session
1790
+ *
1791
+ * Sets the display name, or clears it when displayName is omitted.
1792
+ */
1793
+ readonly sessionRename: (client: RpcCaller, params: Api.SessionRenameParams) => Promise<Api.AgentApiOutcomeOfSessionRenameResponse>;
1794
+ /**
1795
+ * Close a session
1796
+ *
1797
+ * 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.
1798
+ */
1799
+ readonly sessionClose: (client: RpcCaller, params: Api.SessionCloseParams) => Promise<Api.AgentApiOutcomeOfSessionCloseResponse>;
1800
+ /**
1801
+ * Delete a closed session
1802
+ *
1803
+ * Permanently removes session storage after the session has been closed; close active/open sessions first.
1804
+ */
1805
+ readonly sessionDelete: (client: RpcCaller, params: Api.SessionDeleteParams) => Promise<Api.AgentApiOutcomeOfSessionDeleteResponse>;
1806
+ /**
1807
+ * Read the session event stream
1808
+ *
1809
+ * Reads events after a cursor and optionally long-polls when caught up. Continue from nextCursor/headCursor and inspect complete/gap rather than assuming an uninterrupted page.
1810
+ */
1811
+ readonly sessionEventsRead: (client: RpcCaller, params: Api.SessionEventsReadParams) => Promise<Api.AgentApiOutcomeOfSessionEventsReadResponse>;
1812
+ /**
1813
+ * Append keyed session context
1814
+ *
1815
+ * Admits a batch of context entries with per-entry results. Stable keys make same-content retries no-ops; media preprocessing can fail one entry without discarding successful entries.
1816
+ */
1817
+ readonly sessionContextAppend: (client: RpcCaller, params: Api.ContextAppendParams) => Promise<Api.AgentApiOutcomeOfContextAppendResponse>;
1818
+ /**
1819
+ * Remove keyed session context
1820
+ *
1821
+ * Removes active entries by stable key with per-key results. Missing keys are idempotent no-ops; runtime-reserved run keys cannot be removed.
1822
+ */
1823
+ readonly sessionContextRemove: (client: RpcCaller, params: Api.ContextRemoveParams) => Promise<Api.AgentApiOutcomeOfContextRemoveResponse>;
1824
+ /**
1825
+ * Compact session context
1826
+ *
1827
+ * Runs the configured compaction policy on an open idle session and waits for the resulting context revision.
1828
+ */
1829
+ readonly sessionContextCompact: (client: RpcCaller, params: Api.ContextCompactParams) => Promise<Api.AgentApiOutcomeOfContextCompactResponse>;
1830
+ /**
1831
+ * Start an agent run
1832
+ *
1833
+ * 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.
1834
+ */
1835
+ readonly sessionRunsStart: (client: RpcCaller, params: Api.RunStartParams) => Promise<Api.AgentApiOutcomeOfRunStartResponse>;
1836
+ /**
1837
+ * List session runs
1838
+ *
1839
+ * Returns a newest-first keyset page of bounded run summaries projected from current reducer state.
1840
+ */
1841
+ readonly sessionRunsList: (client: RpcCaller, params: Api.RunListParams) => Promise<Api.AgentApiOutcomeOfRunListResponse>;
1842
+ /**
1843
+ * Read one session run
1844
+ *
1845
+ * Reads and projects one run from its bounded event interval, paged by event sequence.
1846
+ */
1847
+ readonly sessionRunsRead: (client: RpcCaller, params: Api.RunReadParams) => Promise<Api.AgentApiOutcomeOfRunReadResponse>;
1848
+ /**
1849
+ * Cancel a run
1850
+ *
1851
+ * 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.
1852
+ */
1853
+ readonly sessionRunsCancel: (client: RpcCaller, params: Api.RunCancelParams) => Promise<Api.AgentApiOutcomeOfRunCancelResponse>;
1854
+ /**
1855
+ * Decide pending run approvals
1856
+ *
1857
+ * 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.
1858
+ */
1859
+ readonly sessionRunsApprovalsDecide: (client: RpcCaller, params: Api.RunApprovalsDecideParams) => Promise<Api.AgentApiOutcomeOfRunApprovalsDecideResponse>;
1860
+ /**
1861
+ * Steer the active run
1862
+ *
1863
+ * 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.
1864
+ */
1865
+ readonly sessionRunsSteer: (client: RpcCaller, params: Api.RunSteerParams) => Promise<Api.AgentApiOutcomeOfRunSteerResponse>;
1866
+ /**
1867
+ * List available session skills
1868
+ *
1869
+ * Refreshes the session's configured VFS skill catalog and reports which discovered skills are enabled and active. An absent catalog yields an empty result.
1870
+ */
1871
+ readonly sessionSkillsList: (client: RpcCaller, params: Api.SkillListParams) => Promise<Api.AgentApiOutcomeOfSkillListResponse>;
1872
+ /**
1873
+ * List active session skills
1874
+ *
1875
+ * Returns skill instructions currently injected into context, including activation scope and source.
1876
+ */
1877
+ readonly sessionSkillsActive: (client: RpcCaller, params: Api.SkillActiveParams) => Promise<Api.AgentApiOutcomeOfSkillActiveResponse>;
1878
+ /**
1879
+ * Activate a session skill
1880
+ *
1881
+ * Loads an enabled skill from the current catalog and injects its instructions into an open idle session. Run-scoped activation is the default.
1882
+ */
1883
+ readonly sessionSkillsActivate: (client: RpcCaller, params: Api.SkillActivateParams) => Promise<Api.AgentApiOutcomeOfSkillActivateResponse>;
1884
+ /**
1885
+ * Deactivate a session skill
1886
+ *
1887
+ * Removes an active skill's injected context from an open idle session; the skill must currently be active.
1888
+ */
1889
+ readonly sessionSkillsDeactivate: (client: RpcCaller, params: Api.SkillDeactivateParams) => Promise<Api.AgentApiOutcomeOfSkillDeactivateResponse>;
1890
+ /**
1891
+ * Apply a profile to a session
1892
+ *
1893
+ * 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.
1894
+ */
1895
+ readonly sessionProfilesApply: (client: RpcCaller, params: Api.ProfileApplyParams) => Promise<Api.AgentApiOutcomeOfProfileApplyResponse>;
1896
+ /**
1897
+ * Activate a session environment
1898
+ *
1899
+ * Selects an allowed, live universe environment for environment-targeted tools while the session is idle.
1900
+ */
1901
+ readonly sessionEnvironmentsActivate: (client: RpcCaller, params: Api.SessionEnvironmentActivateParams) => Promise<Api.AgentApiOutcomeOfSessionEnvironmentActivateResponse>;
1902
+ /**
1903
+ * Deactivate the session environment
1904
+ *
1905
+ * Clears active environment selection without changing or closing the universe environment.
1906
+ */
1907
+ readonly sessionEnvironmentsDeactivate: (client: RpcCaller, params: Api.SessionEnvironmentDeactivateParams) => Promise<Api.AgentApiOutcomeOfSessionEnvironmentDeactivateResponse>;
1908
+ /**
1909
+ * Bind a credential into an environment
1910
+ *
1911
+ * Maps an environment variable name to an existing grant/provider/direct-secret handle for a universe environment. The response exposes only the source handle, never secret material.
1912
+ */
1913
+ readonly environmentsCredentialsBind: (client: RpcCaller, params: Api.EnvironmentCredentialBindParams) => Promise<Api.AgentApiOutcomeOfEnvironmentCredentialBindResponse>;
1914
+ /**
1915
+ * List environment credential bindings
1916
+ *
1917
+ * Returns variable names and credential source handles for a universe environment; resolved secret values are never returned.
1918
+ */
1919
+ readonly environmentsCredentialsList: (client: RpcCaller, params: Api.EnvironmentCredentialListParams) => Promise<Api.AgentApiOutcomeOfEnvironmentCredentialListResponse>;
1920
+ /**
1921
+ * Unbind an environment credential
1922
+ *
1923
+ * Removes one variable-to-credential mapping without deleting the underlying grant, provider credential, or secret.
1924
+ */
1925
+ readonly environmentsCredentialsUnbind: (client: RpcCaller, params: Api.EnvironmentCredentialUnbindParams) => Promise<Api.AgentApiOutcomeOfEnvironmentCredentialUnbindResponse>;
1926
+ /**
1927
+ * Create an environment
1928
+ *
1929
+ * Records an idempotent provisioning intent against an enabled universe binding. The provider validates its provider-wide template and provisions through its backend asynchronously.
1930
+ */
1931
+ readonly environmentsCreate: (client: RpcCaller, params: Api.EnvironmentCreateParams) => Promise<Api.AgentApiOutcomeOfEnvironmentCreateResponse>;
1932
+ /**
1933
+ * Read an environment
1934
+ *
1935
+ * Returns the durable universe resource, source binding, logical lifecycle state, and minimal current-incarnation identity.
1936
+ */
1937
+ readonly environmentsRead: (client: RpcCaller, params: Api.EnvironmentReadParams) => Promise<Api.AgentApiOutcomeOfEnvironmentReadResponse>;
1938
+ /**
1939
+ * List environments
1940
+ *
1941
+ * Lists universe-owned environment resources, optionally filtered by provider, binding, or logical lifecycle state.
1942
+ */
1943
+ readonly environmentsList: (client: RpcCaller, params: Api.EnvironmentListParams) => Promise<Api.AgentApiOutcomeOfEnvironmentListResponse>;
1944
+ /**
1945
+ * Close an environment
1946
+ *
1947
+ * Records an asynchronous idempotent close intent. Provider cleanup is resumed by lifecycle reconciliation; quota is released only after Closed.
1948
+ */
1949
+ readonly environmentsClose: (client: RpcCaller, params: Api.EnvironmentCloseParams) => Promise<Api.AgentApiOutcomeOfEnvironmentCloseResponse>;
1950
+ /**
1951
+ * Register an external environment
1952
+ *
1953
+ * Creates an environment backed by a Lightspeed-reachable envd WebSocket endpoint. Reachability is checked on demand.
1954
+ */
1955
+ readonly environmentsExternalCreate: (client: RpcCaller, params: Api.EnvironmentExternalCreateParams) => Promise<Api.AgentApiOutcomeOfEnvironmentExternalCreateResponse>;
1956
+ /**
1957
+ * Configure environment public ingress
1958
+ *
1959
+ * 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.
1960
+ */
1961
+ readonly environmentsIngressPut: (client: RpcCaller, params: Api.EnvironmentIngressPutParams) => Promise<Api.AgentApiOutcomeOfEnvironmentIngressPutResponse>;
1962
+ /**
1963
+ * Set environment power intent
1964
+ *
1965
+ * 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.
1966
+ */
1967
+ readonly environmentsPowerPut: (client: RpcCaller, params: Api.EnvironmentPowerPutParams) => Promise<Api.AgentApiOutcomeOfEnvironmentPowerPutResponse>;
1968
+ /**
1969
+ * Set environment idle policy
1970
+ *
1971
+ * 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.
1972
+ */
1973
+ readonly environmentsIdlePolicyPut: (client: RpcCaller, params: Api.EnvironmentIdlePolicyPutParams) => Promise<Api.AgentApiOutcomeOfEnvironmentIdlePolicyPutResponse>;
1974
+ /**
1975
+ * List environment provider bindings
1976
+ *
1977
+ * Lists this universe's revisioned routing and admission bindings to deployment-scoped physical providers.
1978
+ */
1979
+ readonly environmentsProviderBindingsList: (client: RpcCaller, params: Api.EnvironmentProviderBindingListParams) => Promise<Api.AgentApiOutcomeOfEnvironmentProviderBindingListResponse>;
1980
+ /**
1981
+ * Read an environment provider binding
1982
+ *
1983
+ * Returns one universe routing and admission binding. Provider-wide templates and physical resource, network, and ingress policy remain provider-owned.
1984
+ */
1985
+ readonly environmentsProviderBindingsRead: (client: RpcCaller, params: Api.EnvironmentProviderBindingReadParams) => Promise<Api.AgentApiOutcomeOfEnvironmentProviderBindingReadResponse>;
1986
+ /**
1987
+ * List environment templates
1988
+ *
1989
+ * Reads immutable templates directly from the selected bound provider controller.
1990
+ */
1991
+ readonly environmentsTemplatesList: (client: RpcCaller, params: Api.EnvironmentTemplateListParams) => Promise<Api.AgentApiOutcomeOfEnvironmentTemplateListResponse>;
1992
+ /**
1993
+ * Read an environment template
1994
+ *
1995
+ * Returns one immutable template version from the selected bound provider controller.
1996
+ */
1997
+ readonly environmentsTemplatesRead: (client: RpcCaller, params: Api.EnvironmentTemplateReadParams) => Promise<Api.AgentApiOutcomeOfEnvironmentTemplateReadResponse>;
1998
+ /**
1999
+ * Create environment jobs
2000
+ *
2001
+ * 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.
2002
+ */
2003
+ readonly environmentsJobsCreate: (client: RpcCaller, params: Api.EnvironmentJobCreateParams) => Promise<Api.AgentApiOutcomeOfEnvironmentJobCreateResponse>;
2004
+ /**
2005
+ * Read environment jobs
2006
+ *
2007
+ * Reads selected job handles with bounded output, optional sequence continuation, and optional artifacts; use returned status/sequence data for polling.
2008
+ */
2009
+ readonly environmentsJobsRead: (client: RpcCaller, params: Api.EnvironmentJobReadParams) => Promise<Api.AgentApiOutcomeOfEnvironmentJobReadResponse>;
2010
+ /**
2011
+ * Cancel environment jobs
2012
+ *
2013
+ * Requests cancellation for selected jobs, optionally including dependents. Force is provider-specific escalation; inspect each per-job result.
2014
+ */
2015
+ readonly environmentsJobsCancel: (client: RpcCaller, params: Api.EnvironmentJobCancelParams) => Promise<Api.AgentApiOutcomeOfEnvironmentJobCancelResponse>;
2016
+ /**
2017
+ * Discover available models
2018
+ *
2019
+ * Queries supported providers directly on every call and returns best-effort selectable routes. One provider failure does not discard successful results from others.
2020
+ */
2021
+ readonly modelsList: (client: RpcCaller, params: Api.ModelListParams) => Promise<Api.AgentApiOutcomeOfModelListResponse>;
2022
+ /**
2023
+ * Create an agent profile
2024
+ *
2025
+ * Creates a new universe-scoped reusable profile document; use profiles/put for create-or-replace revision semantics.
2026
+ */
2027
+ readonly profilesCreate: (client: RpcCaller, params: Api.ProfileCreateParams) => Promise<Api.AgentApiOutcomeOfProfileCreateResponse>;
2028
+ /**
2029
+ * Read an agent profile
2030
+ *
2031
+ * Returns the complete profile document and current revision.
2032
+ */
2033
+ readonly profilesRead: (client: RpcCaller, params: Api.ProfileReadParams) => Promise<Api.AgentApiOutcomeOfProfileReadResponse>;
2034
+ /**
2035
+ * List agent profiles
2036
+ *
2037
+ * Returns lightweight summaries of universe-scoped reusable profiles.
2038
+ */
2039
+ readonly profilesList: (client: RpcCaller, params: Api.ProfileListParams) => Promise<Api.AgentApiOutcomeOfProfileListResponse>;
2040
+ /**
2041
+ * Create or replace an agent profile
2042
+ *
2043
+ * Stores the complete profile document. Use expectedRevision from profiles/read when replacing to prevent lost updates; absence writes unconditionally.
2044
+ */
2045
+ readonly profilesPut: (client: RpcCaller, params: Api.ProfilePutParams) => Promise<Api.AgentApiOutcomeOfProfilePutResponse>;
2046
+ /**
2047
+ * Delete an agent profile
2048
+ *
2049
+ * Deletes the catalog document; sessions previously created or configured from it retain their materialized state.
2050
+ */
2051
+ readonly profilesDelete: (client: RpcCaller, params: Api.ProfileDeleteParams) => Promise<Api.AgentApiOutcomeOfProfileDeleteResponse>;
2052
+ /**
2053
+ * Store content-addressed blobs
2054
+ *
2055
+ * Decodes and stores a batch of base64 payloads, returning immutable content references in request order. Re-uploading identical bytes is naturally deduplicated.
2056
+ */
2057
+ readonly blobsPut: (client: RpcCaller, params: Api.BlobPutParams) => Promise<Api.AgentApiOutcomeOfBlobPutResponse>;
2058
+ /**
2059
+ * Read a content-addressed blob
2060
+ *
2061
+ * Returns the complete immutable blob as base64; large values count against gateway and MCP response limits.
2062
+ */
2063
+ readonly blobsRead: (client: RpcCaller, params: Api.BlobReadParams) => Promise<Api.AgentApiOutcomeOfBlobReadResponse>;
2064
+ /**
2065
+ * Check blob availability
2066
+ *
2067
+ * Checks a batch of content references without returning blob bodies, preserving request order.
2068
+ */
2069
+ readonly blobsHas: (client: RpcCaller, params: Api.BlobHasParams) => Promise<Api.AgentApiOutcomeOfBlobHasResponse>;
2070
+ /**
2071
+ * Commit a VFS snapshot
2072
+ *
2073
+ * Validates and stores an immutable filesystem manifest. Upload referenced file blobs first; the returned snapshot ref is content-addressed.
2074
+ */
2075
+ readonly vfsSnapshotsCommit: (client: RpcCaller, params: Api.VfsSnapshotCommitParams) => Promise<Api.AgentApiOutcomeOfVfsSnapshotCommitResponse>;
2076
+ /**
2077
+ * Read a VFS snapshot
2078
+ *
2079
+ * Returns an immutable snapshot manifest and aggregate file/byte counts; file bodies remain separate blobs.
2080
+ */
2081
+ readonly vfsSnapshotsRead: (client: RpcCaller, params: Api.VfsSnapshotReadParams) => Promise<Api.AgentApiOutcomeOfVfsSnapshotReadResponse>;
2082
+ /**
2083
+ * Create a mutable VFS workspace
2084
+ *
2085
+ * Creates a universe workspace at an optional seed snapshot; absence starts from a server-created empty snapshot.
2086
+ */
2087
+ readonly vfsWorkspacesCreate: (client: RpcCaller, params: Api.VfsWorkspaceCreateParams) => Promise<Api.AgentApiOutcomeOfVfsWorkspaceCreateResponse>;
2088
+ /**
2089
+ * Read a VFS workspace
2090
+ *
2091
+ * Returns workspace metadata, current head snapshot, and revision for safe updates.
2092
+ */
2093
+ readonly vfsWorkspacesRead: (client: RpcCaller, params: Api.VfsWorkspaceReadParams) => Promise<Api.AgentApiOutcomeOfVfsWorkspaceReadResponse>;
2094
+ /**
2095
+ * List VFS workspaces
2096
+ *
2097
+ * Lists mutable universe workspaces with head snapshots, sizes, and revisions.
2098
+ */
2099
+ readonly vfsWorkspacesList: (client: RpcCaller, params: Api.VfsWorkspaceListParams) => Promise<Api.AgentApiOutcomeOfVfsWorkspaceListResponse>;
2100
+ /**
2101
+ * Update a VFS workspace
2102
+ *
2103
+ * Moves the workspace head to an existing snapshot and updates its display name. Pass expectedRevision from a read to prevent lost updates.
2104
+ */
2105
+ readonly vfsWorkspacesUpdate: (client: RpcCaller, params: Api.VfsWorkspaceUpdateParams) => Promise<Api.AgentApiOutcomeOfVfsWorkspaceUpdateResponse>;
2106
+ /**
2107
+ * Delete a VFS workspace
2108
+ *
2109
+ * Deletes the mutable workspace record; immutable snapshots and blobs remain content-addressed resources.
2110
+ */
2111
+ readonly vfsWorkspacesDelete: (client: RpcCaller, params: Api.VfsWorkspaceDeleteParams) => Promise<Api.AgentApiOutcomeOfVfsWorkspaceDeleteResponse>;
2112
+ /**
2113
+ * Create or replace an MCP server record
2114
+ *
2115
+ * Stores the complete universe catalog document, including its optional universe auth-grant credential. Use expectedRevision when replacing; token material is never accepted or returned.
2116
+ */
2117
+ readonly mcpServersPut: (client: RpcCaller, params: Api.McpServerPutParams) => Promise<Api.AgentApiOutcomeOfMcpServerPutResponse>;
2118
+ /**
2119
+ * Discover MCP server authentication
2120
+ *
2121
+ * 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.
2122
+ */
2123
+ readonly mcpServersAuthDiscover: (client: RpcCaller, params: Api.McpServerAuthDiscoverParams) => Promise<Api.AgentApiOutcomeOfMcpServerAuthDiscoverResponse>;
2124
+ /**
2125
+ * Discover MCP server tools
2126
+ *
2127
+ * 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.
2128
+ */
2129
+ readonly mcpServersToolsDiscover: (client: RpcCaller, params: Api.McpServerToolsDiscoverParams) => Promise<Api.AgentApiOutcomeOfMcpServerToolsDiscoverResponse>;
2130
+ /**
2131
+ * Read an MCP server record
2132
+ *
2133
+ * Returns one catalog document with defaults, auth policy, non-secret grant binding, status, and revision; no credential value is exposed.
2134
+ */
2135
+ readonly mcpServersRead: (client: RpcCaller, params: Api.McpServerReadParams) => Promise<Api.AgentApiOutcomeOfMcpServerReadResponse>;
2136
+ /**
2137
+ * List MCP server records
2138
+ *
2139
+ * Lists universe catalog entries, optionally filtered by lifecycle/configuration status.
2140
+ */
2141
+ readonly mcpServersList: (client: RpcCaller, params: Api.McpServerListParams) => Promise<Api.AgentApiOutcomeOfMcpServerListResponse>;
2142
+ /**
2143
+ * Delete an MCP server record
2144
+ *
2145
+ * Deletes the catalog document. Existing session configs that reference it are not silently rewritten and may need explicit reconfiguration.
2146
+ */
2147
+ readonly mcpServersDelete: (client: RpcCaller, params: Api.McpServerDeleteParams) => Promise<Api.AgentApiOutcomeOfMcpServerDeleteResponse>;
2148
+ /**
2149
+ * Import a static bearer grant
2150
+ *
2151
+ * 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.
2152
+ */
2153
+ readonly authGrantsImport: (client: RpcCaller, params: Api.AuthGrantImportParams) => Promise<Api.AgentApiOutcomeOfAuthGrantImportResponse>;
2154
+ /**
2155
+ * Lease a retrievable authentication grant
2156
+ *
2157
+ * 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.
2158
+ */
2159
+ readonly authGrantsLease: (client: RpcCaller, params: Api.AuthGrantLeaseParams) => Promise<Api.AgentApiOutcomeOfAuthGrantLeaseResponse>;
2160
+ /**
2161
+ * Read authentication grant metadata
2162
+ *
2163
+ * Returns principal, provider binding, scopes, audience, expiry, status, and token-presence flags; access and refresh token values are never returned.
2164
+ */
2165
+ readonly authGrantsRead: (client: RpcCaller, params: Api.AuthGrantReadParams) => Promise<Api.AgentApiOutcomeOfAuthGrantReadResponse>;
2166
+ /**
2167
+ * List authentication grants
2168
+ *
2169
+ * Lists non-secret grant metadata for the universe, optionally filtered by status.
2170
+ */
2171
+ readonly authGrantsList: (client: RpcCaller, params: Api.AuthGrantListParams) => Promise<Api.AgentApiOutcomeOfAuthGrantListResponse>;
2172
+ /**
2173
+ * Revoke an authentication grant
2174
+ *
2175
+ * Marks the grant unusable by token consumers while retaining non-secret audit metadata.
2176
+ */
2177
+ readonly authGrantsRevoke: (client: RpcCaller, params: Api.AuthGrantRevokeParams) => Promise<Api.AgentApiOutcomeOfAuthGrantRevokeResponse>;
2178
+ /**
2179
+ * Register an OAuth client
2180
+ *
2181
+ * Stores provider endpoints and client identity; an optional plaintext client secret is encrypted and represented thereafter only by hasClientSecret.
2182
+ */
2183
+ readonly authClientsCreate: (client: RpcCaller, params: Api.AuthClientCreateParams) => Promise<Api.AgentApiOutcomeOfAuthClientCreateResponse>;
2184
+ /**
2185
+ * Read OAuth client metadata
2186
+ *
2187
+ * Returns endpoints, public client identity, defaults, and secret-presence state; the client secret is never returned.
2188
+ */
2189
+ readonly authClientsRead: (client: RpcCaller, params: Api.AuthClientReadParams) => Promise<Api.AgentApiOutcomeOfAuthClientReadResponse>;
2190
+ /**
2191
+ * List OAuth clients
2192
+ *
2193
+ * Lists non-secret OAuth client registrations in the universe.
2194
+ */
2195
+ readonly authClientsList: (client: RpcCaller, params: Api.AuthClientListParams) => Promise<Api.AgentApiOutcomeOfAuthClientListResponse>;
2196
+ /**
2197
+ * Delete an OAuth client
2198
+ *
2199
+ * Deletes the client registration and its stored client secret; grants already created from it remain separate records.
2200
+ */
2201
+ readonly authClientsDelete: (client: RpcCaller, params: Api.AuthClientDeleteParams) => Promise<Api.AgentApiOutcomeOfAuthClientDeleteResponse>;
2202
+ /**
2203
+ * Start an OAuth authorization flow
2204
+ *
2205
+ * 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.
2206
+ */
2207
+ readonly authFlowsStart: (client: RpcCaller, params: Api.AuthFlowStartParams) => Promise<Api.AgentApiOutcomeOfAuthFlowStartResponse>;
2208
+ /**
2209
+ * Read OAuth flow status
2210
+ *
2211
+ * Polls a flow's pending/completed/failed/expired state and returns the resulting grant id when authorization succeeds; no token value is exposed.
2212
+ */
2213
+ readonly authFlowsRead: (client: RpcCaller, params: Api.AuthFlowStatusParams) => Promise<Api.AgentApiOutcomeOfAuthFlowStatusResponse>;
2214
+ /**
2215
+ * Register an authentication provider
2216
+ *
2217
+ * Creates a model or GitHub credential source. Plaintext API keys/private keys are encrypted on receipt and later represented only by configuration plus hasCredential.
2218
+ */
2219
+ readonly authProvidersCreate: (client: RpcCaller, params: Api.AuthProviderCreateParams) => Promise<Api.AgentApiOutcomeOfAuthProviderCreateResponse>;
2220
+ /**
2221
+ * Read authentication provider metadata
2222
+ *
2223
+ * Returns provider kind, non-secret configuration, credential-presence state, and status; stored credentials are never returned.
2224
+ */
2225
+ readonly authProvidersRead: (client: RpcCaller, params: Api.AuthProviderReadParams) => Promise<Api.AgentApiOutcomeOfAuthProviderReadResponse>;
2226
+ /**
2227
+ * List authentication providers
2228
+ *
2229
+ * Lists non-secret model/GitHub provider registrations for the universe.
2230
+ */
2231
+ readonly authProvidersList: (client: RpcCaller, params: Api.AuthProviderListParams) => Promise<Api.AgentApiOutcomeOfAuthProviderListResponse>;
2232
+ /**
2233
+ * Delete an authentication provider
2234
+ *
2235
+ * Deletes the provider registration and its directly stored credential; separately stored grants remain independent records.
2236
+ */
2237
+ readonly authProvidersDelete: (client: RpcCaller, params: Api.AuthProviderDeleteParams) => Promise<Api.AgentApiOutcomeOfAuthProviderDeleteResponse>;
2238
+ /**
2239
+ * List GitHub App installations
2240
+ *
2241
+ * Uses the registered GitHub App provider credential to query accessible installations and returns account/permission metadata without tokens.
2242
+ */
2243
+ readonly authGithubInstallationsList: (client: RpcCaller, params: Api.AuthGitHubInstallationListParams) => Promise<Api.AgentApiOutcomeOfAuthGitHubInstallationListResponse>;
2244
+ /**
2245
+ * Grant access to a GitHub App installation
2246
+ *
2247
+ * Creates or refreshes a universe auth grant for one accessible installation. The installation token is brokered internally and never returned.
2248
+ */
2249
+ readonly authGithubInstallationsGrant: (client: RpcCaller, params: Api.AuthGitHubInstallationGrantParams) => Promise<Api.AgentApiOutcomeOfAuthGitHubInstallationGrantResponse>;
2250
+ /**
2251
+ * Create a bot
2252
+ *
2253
+ * 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.
2254
+ */
2255
+ readonly botsCreate: (client: RpcCaller, params: Api.BotCreateParams) => Promise<Api.AgentApiOutcomeOfBotCreateResponse>;
2256
+ /**
2257
+ * Create or replace a bot document
2258
+ *
2259
+ * 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.
2260
+ */
2261
+ readonly botsPut: (client: RpcCaller, params: Api.BotPutParams) => Promise<Api.AgentApiOutcomeOfBotPutResponse>;
2262
+ /**
2263
+ * Read a bot
2264
+ *
2265
+ * Returns the bot record, its current revision, and lifecycle columns.
2266
+ */
2267
+ readonly botsRead: (client: RpcCaller, params: Api.BotReadParams) => Promise<Api.AgentApiOutcomeOfBotReadResponse>;
2268
+ /**
2269
+ * List bots
2270
+ *
2271
+ * Returns the roster: every bot with its trigger count, pending event count, and latest event.
2272
+ */
2273
+ readonly botsList: (client: RpcCaller, params: Api.BotListParams) => Promise<Api.AgentApiOutcomeOfBotListResponse>;
2274
+ /**
2275
+ * Close a bot
2276
+ *
2277
+ * 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.
2278
+ */
2279
+ readonly botsClose: (client: RpcCaller, params: Api.BotCloseParams) => Promise<Api.AgentApiOutcomeOfBotCloseResponse>;
2280
+ /**
2281
+ * Delete a bot
2282
+ *
2283
+ * 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.
2284
+ */
2285
+ readonly botsDelete: (client: RpcCaller, params: Api.BotDeleteParams) => Promise<Api.AgentApiOutcomeOfBotDeleteResponse>;
2286
+ /**
2287
+ * Read bot controller state
2288
+ *
2289
+ * 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.
2290
+ */
2291
+ readonly botsStateRead: (client: RpcCaller, params: Api.BotStateReadParams) => Promise<Api.AgentApiOutcomeOfBotStateReadResponse>;
2292
+ /**
2293
+ * Rotate a bot session
2294
+ *
2295
+ * 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.
2296
+ */
2297
+ readonly botsSessionsRotate: (client: RpcCaller, params: Api.BotSessionRotateParams) => Promise<Api.AgentApiOutcomeOfBotSessionRotateResponse>;
2298
+ /**
2299
+ * Create or replace a trigger
2300
+ *
2301
+ * 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.
2302
+ */
2303
+ readonly botsTriggersPut: (client: RpcCaller, params: Api.BotTriggerPutParams) => Promise<Api.AgentApiOutcomeOfBotTriggerPutResponse>;
2304
+ /**
2305
+ * Read a trigger
2306
+ *
2307
+ * Returns one trigger with its incidents and cursor; the ingest path and pairing code are shown only to managing principals.
2308
+ */
2309
+ readonly botsTriggersRead: (client: RpcCaller, params: Api.BotTriggerReadParams) => Promise<Api.AgentApiOutcomeOfBotTriggerReadResponse>;
2310
+ /**
2311
+ * List a bot's triggers
2312
+ *
2313
+ * Returns every trigger of the bot ordered by id, secrets redacted for non-managing principals.
2314
+ */
2315
+ readonly botsTriggersList: (client: RpcCaller, params: Api.BotTriggerListParams) => Promise<Api.AgentApiOutcomeOfBotTriggerListResponse>;
2316
+ /**
2317
+ * Delete a trigger
2318
+ *
2319
+ * Drops the trigger's Temporal Schedule and pairings, then the record; stored events keep their history.
2320
+ */
2321
+ readonly botsTriggersDelete: (client: RpcCaller, params: Api.BotTriggerDeleteParams) => Promise<Api.AgentApiOutcomeOfBotTriggerDeleteResponse>;
2322
+ /**
2323
+ * Admit an event manually
2324
+ *
2325
+ * 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.
2326
+ */
2327
+ readonly botsEventsAdmit: (client: RpcCaller, params: Api.BotEventAdmitParams) => Promise<Api.AgentApiOutcomeOfBotEventAdmitResponse>;
2328
+ /**
2329
+ * Replay a stored event
2330
+ *
2331
+ * Re-admits the stored envelope as a fresh event with the original routing; the replay never coalesces.
2332
+ */
2333
+ readonly botsEventsReplay: (client: RpcCaller, params: Api.BotEventReplayParams) => Promise<Api.AgentApiOutcomeOfBotEventReplayResponse>;
2334
+ /**
2335
+ * List a bot's events
2336
+ *
2337
+ * Cursor-paginated event log, newest first, with outcomes; payload documents stay in the CAS.
2338
+ */
2339
+ readonly botsEventsList: (client: RpcCaller, params: Api.BotEventListParams) => Promise<Api.AgentApiOutcomeOfBotEventListResponse>;
2340
+ /**
2341
+ * Read an event by number
2342
+ *
2343
+ * Returns the event row and its full stored envelope document.
2344
+ */
2345
+ readonly botsEventsRead: (client: RpcCaller, params: Api.BotEventReadParams) => Promise<Api.AgentApiOutcomeOfBotEventReadResponse>;
2346
+ /**
2347
+ * Test a CEL filter
2348
+ *
2349
+ * Evaluates a filter against one payload or a sample of recent stored events, reporting matches and evaluation errors without changing anything.
2350
+ */
2351
+ readonly botsFiltersTest: (client: RpcCaller, params: Api.BotFilterTestParams) => Promise<Api.AgentApiOutcomeOfBotFilterTestResponse>;
2352
+ /**
2353
+ * Create a channel account
2354
+ *
2355
+ * Registers a provider account (Telegram, WhatsApp) for this universe. The credential is a retrievable grant reference; no token is accepted here.
2356
+ */
2357
+ readonly channelsAccountsCreate: (client: RpcCaller, params: Api.ChannelAccountCreateParams) => Promise<Api.AgentApiOutcomeOfChannelAccountCreateResponse>;
2358
+ /**
2359
+ * Create or replace a channel account
2360
+ *
2361
+ * Replaces the account document whole; pass expectedRevision when replacing. The connector host picks the change up on its next discovery pass.
2362
+ */
2363
+ readonly channelsAccountsPut: (client: RpcCaller, params: Api.ChannelAccountPutParams) => Promise<Api.AgentApiOutcomeOfChannelAccountPutResponse>;
2364
+ /**
2365
+ * Read a channel account
2366
+ *
2367
+ * Returns the account document and revision.
2368
+ */
2369
+ readonly channelsAccountsRead: (client: RpcCaller, params: Api.ChannelAccountReadParams) => Promise<Api.AgentApiOutcomeOfChannelAccountReadResponse>;
2370
+ /**
2371
+ * List channel accounts
2372
+ *
2373
+ * Lists this universe's provider accounts, optionally by provider.
2374
+ */
2375
+ readonly channelsAccountsList: (client: RpcCaller, params: Api.ChannelAccountListParams) => Promise<Api.AgentApiOutcomeOfChannelAccountListResponse>;
2376
+ /**
2377
+ * Delete a channel account
2378
+ *
2379
+ * Removes the account and its pairings; chat triggers that reference it stop serving conversations.
2380
+ */
2381
+ readonly channelsAccountsDelete: (client: RpcCaller, params: Api.ChannelAccountDeleteParams) => Promise<Api.AgentApiOutcomeOfChannelAccountDeleteResponse>;
2382
+ /**
2383
+ * Admit a provider message
2384
+ *
2385
+ * 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.
2386
+ */
2387
+ readonly channelsInboundAdmit: (client: RpcCaller, params: Api.ChannelInboundAdmitParams) => Promise<Api.AgentApiOutcomeOfChannelInboundAdmitResponse>;
2388
+ /**
2389
+ * List chat pairings
2390
+ *
2391
+ * Lists conversations paired to chat triggers, optionally by account or bot.
2392
+ */
2393
+ readonly channelsPairingsList: (client: RpcCaller, params: Api.ChannelPairingListParams) => Promise<Api.AgentApiOutcomeOfChannelPairingListResponse>;
2394
+ /**
2395
+ * Unpair a conversation
2396
+ *
2397
+ * Removes one pairing; the conversation must present the pairing code again to reconnect.
2398
+ */
2399
+ readonly channelsPairingsDelete: (client: RpcCaller, params: Api.ChannelPairingDeleteParams) => Promise<Api.AgentApiOutcomeOfChannelPairingDeleteResponse>;
2400
+ /**
2401
+ * Read a conversation snapshot
2402
+ *
2403
+ * Queries the conversation workflow's live state for one chat, for debugging; absent when no workflow exists yet.
2404
+ */
2405
+ readonly channelsConversationsRead: (client: RpcCaller, params: Api.ChannelConversationReadParams) => Promise<Api.AgentApiOutcomeOfChannelConversationReadResponse>;
2406
+ /**
2407
+ * Create a universe
2408
+ *
2409
+ * Creates the deployment tenant boundary for an explicit UUID. The operation is idempotent and reports whether a new universe was created.
2410
+ */
2411
+ readonly operatorUniversesCreate: (client: RpcCaller, params: Api.OperatorUniverseCreateParams) => Promise<Api.AgentApiOutcomeOfOperatorUniverseCreateResponse>;
2412
+ /**
2413
+ * List universes
2414
+ *
2415
+ * Returns deployment-wide universe summaries with approximate live aggregate counts and last session activity.
2416
+ */
2417
+ readonly operatorUniversesList: (client: RpcCaller, params: Api.OperatorUniverseListParams) => Promise<Api.AgentApiOutcomeOfOperatorUniverseListResponse>;
2418
+ /**
2419
+ * Read a universe
2420
+ *
2421
+ * Returns one deployment tenant summary with aggregate session, workspace, profile, and blob usage.
2422
+ */
2423
+ readonly operatorUniversesRead: (client: RpcCaller, params: Api.OperatorUniverseReadParams) => Promise<Api.AgentApiOutcomeOfOperatorUniverseReadResponse>;
2424
+ /**
2425
+ * Purge a universe
2426
+ *
2427
+ * Permanently terminates live session workflows, deletes external blob objects, and cascades universe data. The purge is resumable/idempotent after partial failure.
2428
+ */
2429
+ readonly operatorUniversesDelete: (client: RpcCaller, params: Api.OperatorUniverseDeleteParams) => Promise<Api.AgentApiOutcomeOfOperatorUniverseDeleteResponse>;
2430
+ /**
2431
+ * Create a universe API key
2432
+ *
2433
+ * Mints an inbound gateway key for one existing universe. The plaintext secret is returned exactly once and cannot be recovered; persist only the displayed prefix for identification.
2434
+ */
2435
+ readonly operatorApiKeysCreate: (client: RpcCaller, params: Api.OperatorApiKeyCreateParams) => Promise<Api.AgentApiOutcomeOfOperatorApiKeyCreateResponse>;
2436
+ /**
2437
+ * List universe API keys
2438
+ *
2439
+ * Returns only non-secret key metadata for the requested universe, including revocation and last-use timestamps. Plaintext secrets are never stored or returned.
2440
+ */
2441
+ readonly operatorApiKeysList: (client: RpcCaller, params: Api.OperatorApiKeyListParams) => Promise<Api.AgentApiOutcomeOfOperatorApiKeyListResponse>;
2442
+ /**
2443
+ * Revoke a universe API key
2444
+ *
2445
+ * Immediately and idempotently revokes the matching key only when it belongs to the requested universe. Unknown and foreign-universe prefixes return not found.
2446
+ */
2447
+ readonly operatorApiKeysRevoke: (client: RpcCaller, params: Api.OperatorApiKeyRevokeParams) => Promise<Api.AgentApiOutcomeOfOperatorApiKeyRevokeResponse>;
2448
+ /**
2449
+ * Put an environment provider
2450
+ *
2451
+ * Registers or replaces one deployment provider and its controller connection. The provider does not call this API or require access to Lightspeed.
2452
+ */
2453
+ readonly operatorEnvironmentProvidersPut: (client: RpcCaller, params: Api.OperatorEnvironmentProviderPutParams) => Promise<Api.AgentApiOutcomeOfOperatorEnvironmentProviderPutResponse>;
2454
+ /**
2455
+ * List environment providers
2456
+ *
2457
+ * Returns every operator-registered deployment provider and its controller connection.
2458
+ */
2459
+ readonly operatorEnvironmentProvidersList: (client: RpcCaller, params: Api.OperatorEnvironmentProviderListParams) => Promise<Api.AgentApiOutcomeOfOperatorEnvironmentProviderListResponse>;
2460
+ /**
2461
+ * Read an environment provider
2462
+ *
2463
+ * Returns one operator-registered deployment provider and its controller connection.
2464
+ */
2465
+ readonly operatorEnvironmentProvidersRead: (client: RpcCaller, params: Api.OperatorEnvironmentProviderReadParams) => Promise<Api.AgentApiOutcomeOfOperatorEnvironmentProviderReadResponse>;
2466
+ /**
2467
+ * Delete an environment provider
2468
+ *
2469
+ * Deletes a deployment provider only when no universe binding references it.
2470
+ */
2471
+ readonly operatorEnvironmentProvidersDelete: (client: RpcCaller, params: Api.OperatorEnvironmentProviderDeleteParams) => Promise<Api.AgentApiOutcomeOfOperatorEnvironmentProviderDeleteResponse>;
2472
+ /**
2473
+ * Put an environment provider binding
2474
+ *
2475
+ * Creates or replaces one universe's complete revisioned routing and admission binding. A deployment provider may have at most one binding in a universe.
2476
+ */
2477
+ readonly operatorEnvironmentProvidersBindingsPut: (client: RpcCaller, params: Api.OperatorProviderBindingPutParams) => Promise<Api.AgentApiOutcomeOfOperatorProviderBindingPutResponse>;
2478
+ /**
2479
+ * Delete an environment provider binding
2480
+ *
2481
+ * Deletes a universe provider binding only after every referencing environment has reached Closed.
2482
+ */
2483
+ readonly operatorEnvironmentProvidersBindingsDelete: (client: RpcCaller, params: Api.OperatorProviderBindingDeleteParams) => Promise<Api.AgentApiOutcomeOfOperatorProviderBindingDeleteResponse>;
2484
+ /**
2485
+ * Adopt a provider environment
2486
+ *
2487
+ * Creates a universe environment by transferring an existing provider target into Lightspeed's managed lifecycle. The caller must explicitly accept ownership transfer.
2488
+ */
2489
+ readonly operatorEnvironmentsAdopt: (client: RpcCaller, params: Api.OperatorEnvironmentAdoptParams) => Promise<Api.AgentApiOutcomeOfOperatorEnvironmentAdoptResponse>;
2490
+ /**
2491
+ * List channel accounts across universes
2492
+ *
2493
+ * 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.
2494
+ */
2495
+ readonly operatorChannelsAccountsList: (client: RpcCaller, params: Api.OperatorChannelAccountListParams) => Promise<Api.AgentApiOutcomeOfOperatorChannelAccountListResponse>;
2496
+ };
2497
+ //# sourceMappingURL=methods.d.ts.map