@lightspeed-ai/sdk 0.4.0 → 0.5.0

package/src/generated/types.ts

@@ -180,7 +180,7 @@ export type ToolItemStatus =
  * via the `definition` "ToolCallDisplayGroup".
  */
 export type ToolCallDisplayGroup =
-  "other" | "explore" | "edit" | "execute" | "mcp" | "agent" | "bot" | "message";
+  "other" | "explore" | "edit" | "execute" | "code" | "mcp" | "agent" | "bot" | "message";
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "ContextEntryKindView".
@@ -802,6 +802,13 @@ export type SessionEventKindView =
       runId: string;
       turnId: string;
       type: "toolBatchCompleted";
+    }
+  | {
+      executionId: string;
+      phase: CodeToolProgressPhase;
+      requestId?: string | null;
+      status?: ToolItemStatus | null;
+      type: "codeToolProgress";
     };
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
@@ -837,6 +844,14 @@ export type RunFailureKindView =
  * via the `definition` "ToolAttachmentKind".
  */
 export type ToolAttachmentKind = "media" | "file";
+/**
+ * Bounded lifecycle telemetry for a session-owned code tool execution.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "CodeToolProgressPhase".
+ */
+export type CodeToolProgressPhase =
+  "scopeOpened" | "callAdmitted" | "callDeferred" | "callCompleted" | "scopeClosed";
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "RunViewSource".
@@ -1340,8 +1355,10 @@ export type MethodGroup =
       | "bots"
       | "deployment/universes"
       | "deployment/api-keys"
+      | "deployment/sessions"
     )
   | "session"
+  | "session/delete"
   | "blobs/put"
   | "environments"
   | "channels"
@@ -1351,86 +1368,116 @@ export type MethodGroup =
   | "deployment/environment-providers"
   | "deployment/channels";
 /**
- * Steady power state of a provisioned environment.
+ * Why an environment is closing or closed.
  *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentPowerStateView".
+ * via the `definition` "EnvironmentCloseReasonView".
  */
-export type EnvironmentPowerStateView = "running" | "paused" | "suspended" | "stopped";
+export type EnvironmentCloseReasonView =
+  "requested" | "keyRevoked" | "ephemeralGrace" | "departed" | "offlineTimeout" | "providerEnded";
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "EnvironmentSourceView".
  */
 export type EnvironmentSourceView =
   | {
-      bindingId: string;
+      /**
+       * The create-time idle policy, when one replaced the template's.
+       */
+      idle?: EnvironmentIdlePolicyView | null;
+      /**
+       * Absent until the provider first reported the target.
+       */
+      observed?: EnvironmentObservedTargetView | null;
       providerId: string;
+      /**
+       * The public endpoint the provider last reported.
+       */
+      publicEndpoint?: string | null;
+      /**
+       * The provider's handle for the target; absent until the provider
+       * accepted the create.
+       */
+      targetId?: string | null;
+      templateId: string;
       type: "provisioned";
     }
   | {
-      connection: EnvironmentConnectionView;
+      /**
+       * `ws://`, `wss://` or `unix://` URL Lightspeed dials envd at.
+       */
+      endpoint: string;
       type: "external";
     }
   | {
+      /**
+       * The daemon's control connection is up.
+       */
+      connected: boolean;
+      /**
+       * When the daemon last connected or disconnected.
+       */
+      connectionChangedAtMs: number;
       daemonId: string;
+      /**
+       * The admitting key's identity mode.
+       */
       identityMode: EnvironmentIdentityModeView;
+      /**
+       * When the gateway last recorded the daemon's control connection:
+       * at connect, at disconnect, and at most every five minutes while
+       * connected.
+       */
+      lastSeenAtMs: number;
       registrationKeyId: string;
       type: "registered";
     };
 /**
+ * Lifecycle phase of a provider target, as the provider reports it.
+ *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentConnectionTransportView".
+ * via the `definition` "EnvironmentTargetPhaseView".
  */
-export type EnvironmentConnectionTransportView =
-  | ("webSocket" | "http" | "stdio" | "ssh")
-  | {
-      provider: {
-        provider_type: string;
-      };
-    };
+export type EnvironmentTargetPhaseView =
+  "provisioning" | "active" | "closing" | "closed" | "failed" | "unknown";
 /**
- * What Lightspeed does with a registered environment while its daemon is
- * disconnected. Registration-key policy, copied onto each environment.
+ * Power state of a provisioned environment's target.
  *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentIdentityModeView".
+ * via the `definition` "EnvironmentPowerStateView".
  */
-export type EnvironmentIdentityModeView = "persistent" | "ephemeral";
+export type EnvironmentPowerStateView = "running" | "paused" | "suspended" | "stopped";
 /**
+ * What happens to a registered environment while its daemon is
+ * disconnected. Policy of the registration key that admitted it.
+ *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentLifecycleStatusView".
+ * via the `definition` "EnvironmentIdentityModeView".
  */
-export type EnvironmentLifecycleStatusView =
-  | ("provisioning" | "booting" | "ready" | "closing" | "closed" | "failed" | "unknown")
-  | "paused"
-  | "suspended"
-  | "offline";
+export type EnvironmentIdentityModeView = "persistent" | "ephemeral";
 /**
+ * The lifecycle Lightspeed owns. External and registered environments are
+ * only ever `open` or `closed`.
+ *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "DeploymentEnvironmentProviderTransport".
+ * via the `definition` "EnvironmentStateView".
  */
-export type DeploymentEnvironmentProviderTransport =
-  | {
-      type: "webSocket";
-    }
-  | {
-      type: "http";
-    }
-  | {
-      type: "stdio";
-    }
-  | {
-      type: "ssh";
-    }
-  | {
-      providerType: string;
-      type: "provider";
-    };
+export type EnvironmentStateView = ("open" | "closed") | "provisioning" | "closing" | "failed";
 /**
+ * Display status derived from `state` and the latest observation; never
+ * stored. Tools that use a paused, suspended or stopped environment wake
+ * it.
+ *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentProviderBindingStatusView".
+ * via the `definition` "EnvironmentStatusView".
  */
-export type EnvironmentProviderBindingStatusView = "enabled" | "disabled";
+export type EnvironmentStatusView =
+  | ("provisioning" | "ready" | "closing" | "closed" | "failed")
+  | "paused"
+  | "suspended"
+  | "stopped"
+  | "unknown"
+  | "away";
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "EnvironmentCredentialSourceView".
@@ -1449,26 +1496,53 @@ export type EnvironmentCredentialSourceView =
       type: "directSecret";
     };
 /**
+ * How a job's root process ended.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "SessionJobExitView".
+ */
+export type SessionJobExitView =
+  | {
+      code: number;
+      type: "code";
+    }
+  | {
+      coreDumped?: boolean;
+      signal: string;
+      type: "signal";
+    };
+/**
+ * Job lifecycle. `queued` and `running` are live; the rest are terminal.
+ *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "SessionJobStatusView".
  */
 export type SessionJobStatusView =
-  | "accepted"
-  | "queued"
   | "running"
+  | "queued"
   | "succeeded"
   | "failed"
-  | "cancelRequested"
-  | "cancelled"
   | "timedOut"
+  | "cancelled"
   | "dependencyFailed"
-  | "interrupted"
-  | "lost";
+  | "interrupted";
+/**
+ * Why Lightspeed stopped a running job.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "SessionJobStoppedByView".
+ */
+export type SessionJobStoppedByView = "timeout" | "terminate" | "kill";
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "SessionJobOutputStreamView".
  */
 export type SessionJobOutputStreamView = "stdout" | "stderr";
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "SessionJobOutputGapReasonView".
+ */
+export type SessionJobOutputGapReasonView = "overflow" | "expired";
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "EnvironmentRegistrationKeyStatusView".
@@ -1817,8 +1891,11 @@ export type UniverseAction =
       | "read"
       | "create_session"
       | "control_session"
+      | "configure_session"
       | "stop_session"
+      | "close_session"
       | "delete_session"
+      | "set_session_retention"
       | "create_profile"
       | "manage_profile"
       | "create_bot"
@@ -2247,6 +2324,7 @@ export interface ContextConfig {
  * via the `definition` "FeaturesConfig".
  */
 export interface FeaturesConfig {
+  codeMode?: CodeModeFeature | null;
   environments?: EnvironmentsFeature | null;
   mcp?: McpFeature | null;
   subagents?: SubagentsFeature | null;
@@ -2254,6 +2332,64 @@ export interface FeaturesConfig {
   vfs?: VfsFeature | null;
   web?: WebFeature | null;
 }
+/**
+ * Grants JavaScript composition through `code_execute`. Available script tools
+ * are the session's ordinary callable tools, optionally narrowed by allowedTools.
+ * TypeScript, ambient filesystem/network access, and recursive code execution
+ * are unavailable. An empty allowedTools list grants pure computation only.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "CodeModeFeature".
+ */
+export interface CodeModeFeature {
+  /**
+   * Logical tool ids (for example vfs.read_file), not provider wire names.
+   * Absent permits every currently callable grant; an empty list permits none.
+   */
+  allowedTools?: string[] | null;
+  /**
+   * Pinned callable catalog bytes, at most 8 MiB.
+   */
+  maxCatalogBytes?: number;
+  /**
+   * Interpreter heap, at most 512 MiB.
+   */
+  maxMemoryBytes?: number;
+  /**
+   * Combined text() output and return value, at most 8 MiB.
+   */
+  maxOutputBytes?: number;
+  /**
+   * Concurrent pending calls, at most 64 and no greater than maxToolCalls.
+   */
+  maxOutstandingToolCalls?: number;
+  /**
+   * Serialized arguments per tool request, at most 8 MiB.
+   */
+  maxRequestBytes?: number;
+  /**
+   * Serialized completion per tool request, at most 8 MiB.
+   */
+  maxResultBytes?: number;
+  /**
+   * UTF-8 source bytes, at most 1 MiB.
+   */
+  maxSourceBytes?: number;
+  /**
+   * Interpreter native stack, at most 8 MiB.
+   */
+  maxStackBytes?: number;
+  /**
+   * Calls per script, at most 1,024.
+   */
+  maxToolCalls?: number;
+  /**
+   * Total attempt time including input loading, interpreter capacity waits,
+   * JavaScript evaluation, and tool waits; at most 600,000 milliseconds.
+   */
+  timeoutMs?: number;
+  version?: number;
+}
 /**
  * Grants session environments. The `environments` list is the allowed set:
  * the session can select, read, and run work only on a listed machine, each
@@ -4600,86 +4736,28 @@ export interface DeploymentChannelAccountView {
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "AgentApiOutcomeOfDeploymentEnvironmentAdoptResponse".
+ * via the `definition` "AgentApiOutcomeOfDeploymentDeletedSessionsListResponse".
  */
-export interface AgentApiOutcomeOfDeploymentEnvironmentAdoptResponse {
+export interface AgentApiOutcomeOfDeploymentDeletedSessionsListResponse {
   notifications?: AgentNotification[];
-  result: DeploymentEnvironmentAdoptResponse;
+  result: DeploymentDeletedSessionsListResponse;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "DeploymentEnvironmentAdoptResponse".
+ * via the `definition` "DeploymentDeletedSessionsListResponse".
  */
-export interface DeploymentEnvironmentAdoptResponse {
-  environment: EnvironmentView;
+export interface DeploymentDeletedSessionsListResponse {
+  nextAfter?: string | null;
+  sessions: DeletedSessionView[];
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentView".
+ * via the `definition` "DeletedSessionView".
  */
-export interface EnvironmentView {
-  createdAtMs: number;
-  /**
-   * Lightspeed-owned power intent; `status` is the observed state.
-   */
-  desiredPower: EnvironmentPowerStateView;
+export interface DeletedSessionView {
+  deletedAtMs: number;
   displayName?: string | null;
-  environmentId: string;
-  idlePolicy?: EnvironmentIdlePolicyView | null;
-  incarnation: EnvironmentIncarnationView;
-  /**
-   * Registered environments only: when the gateway last saw the daemon's
-   * control connection.
-   */
-  lastSeenAtMs?: number | null;
-  metadata?: {
-    [k: string]: string;
-  };
-  publicEndpoint?: string | null;
-  publicIngressEnabled: boolean;
-  requestId: string;
-  source: EnvironmentSourceView;
-  status: EnvironmentLifecycleStatusView;
-  updatedAtMs: number;
-}
-/**
- * Staged idle policy. Thresholds are milliseconds of daemon-reported idle
- * time and must be non-decreasing in the order pause, suspend, stop, close.
- * Stages whose power state the provider does not support are skipped.
- *
- * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentIdlePolicyView".
- */
-export interface EnvironmentIdlePolicyView {
-  closeAfterMs?: number | null;
-  pauseAfterMs?: number | null;
-  stopAfterMs?: number | null;
-  suspendAfterMs?: number | null;
-}
-/**
- * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentIncarnationView".
- */
-export interface EnvironmentIncarnationView {
-  createdAtMs: number;
-  incarnationId: string;
-  /**
-   * Power states the provider reported for this target; empty until
-   * observed or when the provider offers no power control.
-   */
-  powerStates?: EnvironmentPowerStateView[];
-  providerTargetId?: string | null;
-  provisionRequestId?: string | null;
-  templateId?: string | null;
-  updatedAtMs: number;
-}
-/**
- * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentConnectionView".
- */
-export interface EnvironmentConnectionView {
-  endpoint: string;
-  transport: EnvironmentConnectionTransportView;
+  sessionId: string;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
@@ -4701,23 +4779,31 @@ export interface DeploymentEnvironmentProviderDeleteResponse {
  * via the `definition` "DeploymentEnvironmentProviderView".
  */
 export interface DeploymentEnvironmentProviderView {
-  controllerConnection: DeploymentEnvironmentProviderConnection;
+  /**
+   * `ws://`, `wss://` or `unix://` URL of the provider controller.
+   */
+  controllerEndpoint: string;
   createdAtMs: number;
+  /**
+   * Operator-configured `ws://` or `wss://` base of the provider's data
+   * routes; absent derives it from the controller endpoint.
+   */
+  dataRouteBase?: string | null;
   displayName?: string | null;
-  metadata?: {
-    [k: string]: string;
-  };
+  /**
+   * The data route base Lightspeed dials: `dataRouteBase`, or the
+   * controller endpoint's origin followed by `/routes`. Absent only when it
+   * cannot be derived.
+   */
+  effectiveDataRouteBase?: string | null;
+  /**
+   * A bearer credential is stored and presented to the controller and
+   * data routes; without one no `Authorization` header is sent.
+   */
+  hasCredential: boolean;
   providerId: string;
   updatedAtMs: number;
 }
-/**
- * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "DeploymentEnvironmentProviderConnection".
- */
-export interface DeploymentEnvironmentProviderConnection {
-  endpoint: string;
-  transport: DeploymentEnvironmentProviderTransport;
-}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "AgentApiOutcomeOfDeploymentEnvironmentProviderListResponse".
@@ -4779,18 +4865,16 @@ export interface DeploymentProviderBindingDeleteResponse {
   binding: EnvironmentProviderBindingView;
 }
 /**
+ * A universe's binding to a deployment provider. Creates, templates and
+ * data routes of the provider need it enabled.
+ *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "EnvironmentProviderBindingView".
  */
 export interface EnvironmentProviderBindingView {
-  bindingId: string;
   createdAtMs: number;
-  metadata?: {
-    [k: string]: string;
-  };
+  enabled: boolean;
   providerId: string;
-  revision: number;
-  status: EnvironmentProviderBindingStatusView;
   updatedAtMs: number;
 }
 /**
@@ -4808,6 +4892,25 @@ export interface AgentApiOutcomeOfDeploymentProviderBindingPutResponse {
 export interface DeploymentProviderBindingPutResponse {
   binding: EnvironmentProviderBindingView;
 }
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "AgentApiOutcomeOfDeploymentSessionPurgeResponse".
+ */
+export interface AgentApiOutcomeOfDeploymentSessionPurgeResponse {
+  notifications?: AgentNotification[];
+  result: DeploymentSessionPurgeResponse;
+}
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "DeploymentSessionPurgeResponse".
+ */
+export interface DeploymentSessionPurgeResponse {
+  /**
+   * Includes soft-deleted history forks and delegated descendants.
+   * Empty when the target has already been permanently deleted.
+   */
+  deletedSessionIds: string[];
+}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "AgentApiOutcomeOfDeploymentUniverseCreateResponse".
@@ -4920,6 +5023,92 @@ export interface AgentApiOutcomeOfEnvironmentCloseResponse {
 export interface EnvironmentCloseResponse {
   environment: EnvironmentView;
 }
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentView".
+ */
+export interface EnvironmentView {
+  /**
+   * Present exactly while `state` is `closing` or `closed`.
+   */
+  closeReason?: EnvironmentCloseReasonView | null;
+  closedAtMs?: number | null;
+  createdAtMs: number;
+  /**
+   * The envd build serving the environment; absent until known.
+   */
+  daemon?: EnvironmentDaemonView | null;
+  displayName?: string | null;
+  environmentId: string;
+  /**
+   * Caller metadata.
+   */
+  metadata?: {
+    [k: string]: string;
+  };
+  /**
+   * The caller's retry identity; absent for registered environments.
+   */
+  requestId?: string | null;
+  source: EnvironmentSourceView;
+  state: EnvironmentStateView;
+  /**
+   * When `state` last changed.
+   */
+  stateChangedAtMs: number;
+  /**
+   * Why the environment failed, or what provisioning or closing is
+   * waiting on.
+   */
+  stateMessage?: string | null;
+  status: EnvironmentStatusView;
+  updatedAtMs: number;
+}
+/**
+ * The envd build serving an environment, from its registration or
+ * Lightspeed's open handshake.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentDaemonView".
+ */
+export interface EnvironmentDaemonView {
+  gitSha?: string | null;
+  protocolVersion: number;
+  version?: string | null;
+}
+/**
+ * Staged idle policy the provider applies. Thresholds are milliseconds of
+ * envd-reported idle time (running processes, jobs and leftover process
+ * groups hold it at zero) and must be non-decreasing in the order pause,
+ * suspend, stop, close. Stages whose power state the template does not
+ * support are skipped.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentIdlePolicyView".
+ */
+export interface EnvironmentIdlePolicyView {
+  closeAfterMs?: number | null;
+  pauseAfterMs?: number | null;
+  stopAfterMs?: number | null;
+  suspendAfterMs?: number | null;
+}
+/**
+ * What the provider last reported about a provisioned environment's
+ * target. Display only: Lightspeed never converges it, and it may be up to
+ * a few minutes old.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentObservedTargetView".
+ */
+export interface EnvironmentObservedTargetView {
+  message?: string | null;
+  observedAtMs: number;
+  phase: EnvironmentTargetPhaseView;
+  /**
+   * Present only while `phase` is `active`.
+   */
+  power?: EnvironmentPowerStateView | null;
+}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "AgentApiOutcomeOfEnvironmentCreateResponse".
@@ -5006,21 +5195,6 @@ export interface AgentApiOutcomeOfEnvironmentExternalCreateResponse {
 export interface EnvironmentExternalCreateResponse {
   environment: EnvironmentView;
 }
-/**
- * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "AgentApiOutcomeOfEnvironmentIdlePolicyPutResponse".
- */
-export interface AgentApiOutcomeOfEnvironmentIdlePolicyPutResponse {
-  notifications?: AgentNotification[];
-  result: EnvironmentIdlePolicyPutResponse;
-}
-/**
- * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentIdlePolicyPutResponse".
- */
-export interface EnvironmentIdlePolicyPutResponse {
-  environment: EnvironmentView;
-}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "AgentApiOutcomeOfEnvironmentIngressPutResponse".
@@ -5069,18 +5243,31 @@ export interface SessionJobHandleView {
   jobId: string;
 }
 /**
+ * What a job is and how it ended. Instants are the environment's wall
+ * clock.
+ *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "SessionJobSummaryView".
  */
 export interface SessionJobSummaryView {
+  /**
+   * When a cancel reached the job while it ran.
+   */
+  cancelRequestedAtMs?: number | null;
   createdAtMs: number;
   dependencies?: string[];
-  exitCode?: number | null;
+  /**
+   * Run time from start to finish, immune to clock jumps.
+   */
+  durationMs?: number | null;
+  /**
+   * How the job's root process ended, once it ran and exited.
+   */
+  exit?: SessionJobExitView | null;
   failure?: string | null;
   finishedAtMs?: number | null;
   jobId: string;
   name?: string | null;
-  namespace: string;
   /**
    * True when the job's root process exited while descendants it spawned
    * were still running; the host terminated them best-effort at job
@@ -5089,8 +5276,16 @@ export interface SessionJobSummaryView {
   orphanedDescendants?: boolean;
   queueKey?: string | null;
   queuedAtMs?: number | null;
+  /**
+   * The start request that created the job; part of its identity.
+   */
+  requestId: string;
   startedAtMs?: number | null;
   status: SessionJobStatusView;
+  /**
+   * Set when Lightspeed stopped the running job.
+   */
+  stoppedBy?: SessionJobStoppedByView | null;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
@@ -5138,37 +5333,59 @@ export interface EnvironmentJobReadResponse {
   jobs?: SessionJobReadEntryView[];
 }
 /**
+ * One job's summary and output page, or why it could not be read: an
+ * entry with `error` and no summary names a job the environment does not
+ * know (never created, or garbage-collected).
+ *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "SessionJobReadEntryView".
  */
 export interface SessionJobReadEntryView {
-  artifacts?: SessionJobArtifactView[];
   error?: string | null;
   handle?: SessionJobHandleView | null;
+  /**
+   * Output in offset order.
+   */
   outputChunks?: SessionJobOutputChunkView[];
-  outputNextSeq: number;
+  /**
+   * Output bytes the job produced so far; final once it is terminal.
+   */
+  outputEnd: number;
+  /**
+   * Output ranges between the requested start and `outputNext` that
+   * cannot be returned.
+   */
+  outputGaps?: SessionJobOutputGapView[];
+  /**
+   * Byte offset to continue reading from: pass it as `after`.
+   */
+  outputNext: number;
   summary?: SessionJobSummaryView | null;
 }
-/**
- * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "SessionJobArtifactView".
- */
-export interface SessionJobArtifactView {
-  kind?: string | null;
-  metadata?: {
-    [k: string]: string;
-  };
-  path: string;
-}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "SessionJobOutputChunkView".
  */
 export interface SessionJobOutputChunkView {
   dataBase64: string;
-  seq: number;
+  /**
+   * Byte offset of the chunk's first byte in the job's combined output.
+   */
+  offset: number;
   stream: SessionJobOutputStreamView;
 }
+/**
+ * Output bytes in `[offset, offset + omittedBytes)` that cannot be
+ * returned.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "SessionJobOutputGapView".
+ */
+export interface SessionJobOutputGapView {
+  offset: number;
+  omittedBytes: number;
+  reason: SessionJobOutputGapReasonView;
+}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "AgentApiOutcomeOfEnvironmentListResponse".
@@ -5182,7 +5399,14 @@ export interface AgentApiOutcomeOfEnvironmentListResponse {
  * via the `definition` "EnvironmentListResponse".
  */
 export interface EnvironmentListResponse {
+  /**
+   * Environments in environment id order.
+   */
   environments?: EnvironmentView[];
+  /**
+   * Pass as `after` to read the next page; absent on the last page.
+   */
+  nextAfter?: string | null;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
@@ -5284,11 +5508,16 @@ export interface EnvironmentRegistrationKeyView {
   expiresAtMs?: number | null;
   identityMode: EnvironmentIdentityModeView;
   /**
-   * First characters of the secret, for identification only.
+   * First characters of the key's live secret, for identification only.
    */
   keyPrefix: string;
   lastRegisteredAtMs?: number | null;
   maxActiveEnvironments?: number | null;
+  /**
+   * Persistent keys only: environments whose daemon has been away longer
+   * than this are closed; absent keeps them open.
+   */
+  offlineCloseAfterMs?: number | null;
   /**
    * Environments ever admitted by this key, closed included.
    */
@@ -5296,6 +5525,7 @@ export interface EnvironmentRegistrationKeyView {
   registrationKeyId: string;
   revokedAtMs?: number | null;
   status: EnvironmentRegistrationKeyStatusView;
+  updatedAtMs: number;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
@@ -5346,6 +5576,40 @@ export interface EnvironmentRegistrationKeyRevokeResponse {
   closedEnvironmentIds?: string[];
   registrationKey: EnvironmentRegistrationKeyView;
 }
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "AgentApiOutcomeOfEnvironmentRegistrationKeyRotateResponse".
+ */
+export interface AgentApiOutcomeOfEnvironmentRegistrationKeyRotateResponse {
+  notifications?: AgentNotification[];
+  result: EnvironmentRegistrationKeyRotateResponse;
+}
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentRegistrationKeyRotateResponse".
+ */
+export interface EnvironmentRegistrationKeyRotateResponse {
+  registrationKey: EnvironmentRegistrationKeyView;
+  /**
+   * The new plaintext secret, returned only here.
+   */
+  secret: EnvironmentRegistrationSecretView;
+}
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "AgentApiOutcomeOfEnvironmentRegistrationKeyUpdateResponse".
+ */
+export interface AgentApiOutcomeOfEnvironmentRegistrationKeyUpdateResponse {
+  notifications?: AgentNotification[];
+  result: EnvironmentRegistrationKeyUpdateResponse;
+}
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentRegistrationKeyUpdateResponse".
+ */
+export interface EnvironmentRegistrationKeyUpdateResponse {
+  registrationKey: EnvironmentRegistrationKeyView;
+}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "AgentApiOutcomeOfEnvironmentTemplateListResponse".
@@ -5366,17 +5630,46 @@ export interface EnvironmentTemplateListResponse {
  * via the `definition` "EnvironmentTemplateView".
  */
 export interface EnvironmentTemplateView {
-  bindingId: string;
   deprecated: boolean;
   description?: string | null;
   displayName: string;
+  /**
+   * Idle policy targets get when `environments/create` names none.
+   */
+  idle?: EnvironmentIdlePolicyView | null;
   metadata?: {
     [k: string]: string;
   };
+  /**
+   * Power states `environments/power/put` can move targets of this
+   * template to; empty without power control.
+   */
+  powerStates: EnvironmentPowerStateView[];
   providerId: string;
+  /**
+   * `environments/ingress/put` can enable public ingress on targets of
+   * this template.
+   */
   publicIngress: boolean;
+  /**
+   * Compute targets of this template get; absent when the provider does
+   * not fix it.
+   */
+  resources?: EnvironmentTemplateResourcesView | null;
   templateId: string;
 }
+/**
+ * A template's compute, in provider-neutral units. Each field is absent
+ * when the provider does not fix it.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentTemplateResourcesView".
+ */
+export interface EnvironmentTemplateResourcesView {
+  diskBytes?: number | null;
+  memoryBytes?: number | null;
+  vcpus?: number | null;
+}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "AgentApiOutcomeOfEnvironmentTemplateReadResponse".
@@ -5392,6 +5685,21 @@ export interface AgentApiOutcomeOfEnvironmentTemplateReadResponse {
 export interface EnvironmentTemplateReadResponse {
   template: EnvironmentTemplateView;
 }
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "AgentApiOutcomeOfEnvironmentUpdateResponse".
+ */
+export interface AgentApiOutcomeOfEnvironmentUpdateResponse {
+  notifications?: AgentNotification[];
+  result: EnvironmentUpdateResponse;
+}
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentUpdateResponse".
+ */
+export interface EnvironmentUpdateResponse {
+  environment: EnvironmentView;
+}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "AgentApiOutcomeOfInitializeResponse".
@@ -5480,8 +5788,9 @@ export interface ServerInfo {
 export interface EnvironmentDaemonInfo {
   gitSha: string;
   /**
-   * Environment protocol version the gateway speaks. A daemon registers
-   * only when it reports exactly this number.
+   * The envd protocol version (data plane and registration channel)
+   * the gateway speaks. A daemon registers only when it reports exactly
+   * this number.
    */
   protocolVersion: number;
   /**
@@ -7255,28 +7564,13 @@ export interface DeploymentChannelAccountListParams {
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "DeploymentEnvironmentAdoptParams".
+ * via the `definition` "DeploymentDeletedSessionsListParams".
  */
-export interface DeploymentEnvironmentAdoptParams {
-  bindingId: string;
-  displayName?: string | null;
-  metadata?: {
-    [k: string]: string;
-  };
+export interface DeploymentDeletedSessionsListParams {
   /**
-   * Stable caller-generated retry identity inside the destination universe.
+   * Exclusive session ID cursor; each page contains at most 100 entries.
    */
-  requestId: string;
-  /**
-   * Provider-native source reference. The Incus provider accepts
-   * `<project>/<instance>` or an instance name in the `default` project.
-   */
-  sourceTarget: string;
-  /**
-   * Required acknowledgement that Lightspeed will move, reconfigure, and
-   * delete the target as part of its ordinary managed lifecycle.
-   */
-  takeOwnership: boolean;
+  after?: string | null;
   universeId: string;
 }
 /**
@@ -7292,15 +7586,35 @@ export interface DeploymentEnvironmentProviderDeleteParams {
  */
 export interface DeploymentEnvironmentProviderListParams {}
 /**
+ * Register or replace a provider. `credential` is the optional bearer
+ * token Lightspeed presents to the provider's controller and data routes:
+ * it is sealed on receipt and never returned by any method. `Debug` output
+ * redacts it; request logging must never echo these params.
+ *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "DeploymentEnvironmentProviderPutParams".
  */
 export interface DeploymentEnvironmentProviderPutParams {
-  controllerConnection: DeploymentEnvironmentProviderConnection;
+  /**
+   * Remove the stored credential. Excludes `credential`.
+   */
+  clearCredential?: boolean;
+  /**
+   * `ws://`, `wss://` or `unix://` URL of the provider controller.
+   */
+  controllerEndpoint: string;
+  /**
+   * A new bearer credential; omit to keep the stored one. A provider needs
+   * none. Excludes `clearCredential`.
+   */
+  credential?: string | null;
+  /**
+   * `ws://` or `wss://` base of the provider's data routes; omit to derive
+   * it from the controller endpoint. Required for a `unix://` controller,
+   * and must not be `ws://` for a `wss://` controller.
+   */
+  dataRouteBase?: string | null;
   displayName?: string | null;
-  metadata?: {
-    [k: string]: string;
-  };
   providerId: string;
 }
 /**
@@ -7315,21 +7629,29 @@ export interface DeploymentEnvironmentProviderReadParams {
  * via the `definition` "DeploymentProviderBindingDeleteParams".
  */
 export interface DeploymentProviderBindingDeleteParams {
-  bindingId: string;
+  providerId: string;
   universeId: string;
 }
 /**
+ * Create or replace a universe's binding to a deployment provider.
+ *
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "DeploymentProviderBindingPutParams".
  */
 export interface DeploymentProviderBindingPutParams {
-  bindingId: string;
-  expectedRevision?: number | null;
-  metadata?: {
-    [k: string]: string;
-  };
+  /**
+   * Admits creates, template listing and data routes for the universe.
+   */
+  enabled: boolean;
   providerId: string;
-  status: EnvironmentProviderBindingStatusView;
+  universeId: string;
+}
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "DeploymentSessionPurgeParams".
+ */
+export interface DeploymentSessionPurgeParams {
+  sessionId: string;
   universeId: string;
 }
 /**
@@ -7394,21 +7716,27 @@ export interface EnvironmentCloseParams {
  * via the `definition` "EnvironmentCreateParams".
  */
 export interface EnvironmentCreateParams {
-  bindingId: string;
   displayName?: string | null;
   /**
-   * Optional staged idle policy applied by the power reaper.
+   * Idle policy passed to the provider in place of the template's `idle`.
+   * The provider runs the idle clock; it cannot be changed after create.
    */
-  idlePolicy?: EnvironmentIdlePolicyView | null;
+  idle?: EnvironmentIdlePolicyView | null;
   metadata?: {
     [k: string]: string;
   };
+  /**
+   * The provider to create the environment with; the universe needs an
+   * enabled binding to it.
+   */
+  providerId: string;
   /**
    * Stable caller-generated retry identity, unique inside the universe.
+   * Retrying with identical inputs returns the same environment.
    */
   requestId: string;
   /**
-   * Immutable provider template-version identity.
+   * The provider template to create the environment from.
    */
   templateId: string;
 }
@@ -7441,32 +7769,28 @@ export interface EnvironmentCredentialUnbindParams {
  * via the `definition` "EnvironmentExternalCreateParams".
  */
 export interface EnvironmentExternalCreateParams {
+  displayName?: string | null;
   /**
-   * Connection to an envd instance reachable from Lightspeed.
+   * `ws://`, `wss://` or `unix://` URL of an envd instance reachable from
+   * Lightspeed.
    */
-  connection: EnvironmentConnectionView;
-  displayName?: string | null;
+  endpoint: string;
   metadata?: {
     [k: string]: string;
   };
-  requestId: string;
-}
-/**
- * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
- * via the `definition` "EnvironmentIdlePolicyPutParams".
- */
-export interface EnvironmentIdlePolicyPutParams {
-  environmentId: string;
   /**
-   * The complete new policy; omit to clear it.
+   * Stable caller-generated retry identity, unique inside the universe.
    */
-  idlePolicy?: EnvironmentIdlePolicyView | null;
+  requestId: string;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "EnvironmentIngressPutParams".
  */
 export interface EnvironmentIngressPutParams {
+  /**
+   * Ensure (`true`) or remove (`false`) the provider's public ingress.
+   */
   enabled: boolean;
   environmentId: string;
 }
@@ -7527,17 +7851,38 @@ export interface SessionJobDependencyInput {
  * via the `definition` "EnvironmentJobReadParams".
  */
 export interface EnvironmentJobReadParams {
-  afterSeq?: number | null;
-  includeArtifacts?: boolean;
+  /**
+   * Byte offset to read each job's output from: a previous entry's
+   * `outputNext`. Omitted with `tailBytes` omitted reads from the start.
+   */
+  after?: number | null;
   jobs: SessionJobHandleInput[];
-  outputBytes?: number | null;
+  /**
+   * Most output bytes per job; omit for the server's default page.
+   */
+  maxBytes?: number | null;
+  /**
+   * Read each job's last `tailBytes` of output instead; excludes `after`.
+   */
+  tailBytes?: number | null;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "EnvironmentListParams".
  */
 export interface EnvironmentListParams {
-  bindingId?: string | null;
+  /**
+   * Exclusive environment id cursor: a previous page's `nextAfter`.
+   */
+  after?: string | null;
+  /**
+   * Also list closed environments; they are omitted by default.
+   */
+  includeClosed?: boolean;
+  /**
+   * Most environments per page; omit for 100.
+   */
+  limit?: number | null;
   /**
    * Only environments carrying every listed metadata pair (AND
    * semantics); the same filter `session/list` accepts.
@@ -7545,12 +7890,19 @@ export interface EnvironmentListParams {
   metadata?: {
     [k: string]: string;
   };
+  /**
+   * Only provisioned environments of this provider.
+   */
   providerId?: string | null;
   /**
    * Only registered environments admitted by this registration key.
    */
   registrationKeyId?: string | null;
-  status?: EnvironmentLifecycleStatusView | null;
+  /**
+   * Only environments in this lifecycle state. `closed` lists closed
+   * environments without `includeClosed`.
+   */
+  state?: EnvironmentStateView | null;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
@@ -7559,8 +7911,8 @@ export interface EnvironmentListParams {
 export interface EnvironmentPowerPutParams {
   environmentId: string;
   /**
-   * Desired steady power state. Must be one of the provider-reported
-   * `incarnation.powerStates`.
+   * Power state to move the target to; one of its template's
+   * `powerStates`.
    */
   power: EnvironmentPowerStateView;
 }
@@ -7574,7 +7926,7 @@ export interface EnvironmentProviderBindingListParams {}
  * via the `definition` "EnvironmentProviderBindingReadParams".
  */
 export interface EnvironmentProviderBindingReadParams {
-  bindingId: string;
+  providerId: string;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
@@ -7597,11 +7949,19 @@ export interface EnvironmentRegistrationKeyCreateParams {
    */
   ephemeralDisconnectGraceMs?: number | null;
   expiresAtMs?: number | null;
+  /**
+   * Immutable once the key exists.
+   */
   identityMode: EnvironmentIdentityModeView;
   /**
    * Non-closed environments the key may have at once; omit for unlimited.
    */
   maxActiveEnvironments?: number | null;
+  /**
+   * Persistent keys only: close environments whose daemon has been away
+   * longer than this; omit to keep them open.
+   */
+  offlineCloseAfterMs?: number | null;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
@@ -7626,21 +7986,78 @@ export interface EnvironmentRegistrationKeyRevokeParams {
   closeEnvironments?: boolean;
   registrationKeyId: string;
 }
+/**
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentRegistrationKeyRotateParams".
+ */
+export interface EnvironmentRegistrationKeyRotateParams {
+  registrationKeyId: string;
+}
+/**
+ * The complete editable policy of a registration key; an absent field is
+ * unset. The identity mode is immutable.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentRegistrationKeyUpdateParams".
+ */
+export interface EnvironmentRegistrationKeyUpdateParams {
+  /**
+   * Group name for the environments this key admits.
+   */
+  displayName: string;
+  /**
+   * Disconnect grace for ephemeral environments; omit for the default.
+   */
+  ephemeralDisconnectGraceMs?: number | null;
+  expiresAtMs?: number | null;
+  /**
+   * Non-closed environments the key may have at once; omit for unlimited.
+   */
+  maxActiveEnvironments?: number | null;
+  /**
+   * Persistent keys only: close environments whose daemon has been away
+   * longer than this; omit to keep them open.
+   */
+  offlineCloseAfterMs?: number | null;
+  registrationKeyId: string;
+}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "EnvironmentTemplateListParams".
  */
 export interface EnvironmentTemplateListParams {
-  bindingId?: string | null;
+  /**
+   * Only this provider's templates; omit for every enabled binding.
+   */
+  providerId?: string | null;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "EnvironmentTemplateReadParams".
  */
 export interface EnvironmentTemplateReadParams {
-  bindingId: string;
+  providerId: string;
   templateId: string;
 }
+/**
+ * Replace an environment's display name and caller metadata.
+ *
+ * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
+ * via the `definition` "EnvironmentUpdateParams".
+ */
+export interface EnvironmentUpdateParams {
+  /**
+   * The new display name; omit to clear it.
+   */
+  displayName?: string | null;
+  environmentId: string;
+  /**
+   * The complete new caller metadata; omit or `{}` to clear it.
+   */
+  metadata?: {
+    [k: string]: string;
+  };
+}
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
  * via the `definition` "InitializeParams".
@@ -8035,6 +8452,16 @@ export interface SessionDeleteParams {
    */
   cascade?: boolean;
   sessionId: string;
+  /**
+   * Atomically require every selected session's audience to be shared.
+   * Delegating services use this guard for operators deleting shared work.
+   */
+  sharedOnly?: boolean;
+  /**
+   * Hide sessions while retaining records, events, checkpoints and blob roots.
+   * False (the default) permanently deletes them without prior soft deletion.
+   */
+  softDelete?: boolean;
 }
 /**
  * This interface was referenced by `LightspeedAgentAPI`'s JSON-Schema
@@ -8171,7 +8598,7 @@ export interface SessionRenameParams {
  */
 export interface SessionRetentionPutParams {
   /**
-   * Positive duration enables automatic tree deletion; null disables it.
+   * Positive duration enables automatic tree soft deletion; null disables it.
    */
   deleteAfterCloseMs: number | null;
   sessionId: string;
@@ -8195,7 +8622,7 @@ export interface SessionStartParams {
   access?: AccessInput | null;
   config?: SessionConfig | null;
   /**
-   * Root-owned automatic deletion measured from close. Absent inherits a
+   * Root-owned automatic soft deletion measured from close. Absent inherits a
    * profile default, explicit null keeps the tree, and a duration overrides
    * the profile.
    */