@lightspeed-ai/sdk 0.4.0 → 0.5.0

package/schema/api.schema.json

@@ -139,7 +139,7 @@
         },
         {
           "const": "environment_not_ready",
-          "description": "The environment exists but is not reachable yet: it is still\nprovisioning/booting, or it was powered down and a wake (desired\npower `running`) has been initiated by this request. Distinct from\n`Rejected` so clients retry with backoff instead of failing —\npolling and automation callers lean on this for wake-on-use.",
+          "description": "The environment exists but is not reachable yet: it is still\nprovisioning, its provider is waking or booting it after a data\nroute dial, or its registered daemon is reconnecting. Distinct from\n`Rejected` so clients retry with backoff instead of failing —\npolling and automation callers lean on this for wake-on-use.",
           "type": "string"
         },
         {
@@ -1067,7 +1067,7 @@
       ],
       "type": "object"
     },
-    "AgentApiOutcomeOfDeploymentEnvironmentAdoptResponse": {
+    "AgentApiOutcomeOfDeploymentDeletedSessionsListResponse": {
       "properties": {
         "notifications": {
           "items": {
@@ -1076,7 +1076,7 @@
           "type": "array"
         },
         "result": {
-          "$ref": "#/definitions/DeploymentEnvironmentAdoptResponse"
+          "$ref": "#/definitions/DeploymentDeletedSessionsListResponse"
         }
       },
       "required": [
@@ -1186,6 +1186,23 @@
       ],
       "type": "object"
     },
+    "AgentApiOutcomeOfDeploymentSessionPurgeResponse": {
+      "properties": {
+        "notifications": {
+          "items": {
+            "$ref": "#/definitions/AgentNotification"
+          },
+          "type": "array"
+        },
+        "result": {
+          "$ref": "#/definitions/DeploymentSessionPurgeResponse"
+        }
+      },
+      "required": [
+        "result"
+      ],
+      "type": "object"
+    },
     "AgentApiOutcomeOfDeploymentUniverseCreateResponse": {
       "properties": {
         "notifications": {
@@ -1356,23 +1373,6 @@
       ],
       "type": "object"
     },
-    "AgentApiOutcomeOfEnvironmentIdlePolicyPutResponse": {
-      "properties": {
-        "notifications": {
-          "items": {
-            "$ref": "#/definitions/AgentNotification"
-          },
-          "type": "array"
-        },
-        "result": {
-          "$ref": "#/definitions/EnvironmentIdlePolicyPutResponse"
-        }
-      },
-      "required": [
-        "result"
-      ],
-      "type": "object"
-    },
     "AgentApiOutcomeOfEnvironmentIngressPutResponse": {
       "properties": {
         "notifications": {
@@ -1594,6 +1594,40 @@
       ],
       "type": "object"
     },
+    "AgentApiOutcomeOfEnvironmentRegistrationKeyRotateResponse": {
+      "properties": {
+        "notifications": {
+          "items": {
+            "$ref": "#/definitions/AgentNotification"
+          },
+          "type": "array"
+        },
+        "result": {
+          "$ref": "#/definitions/EnvironmentRegistrationKeyRotateResponse"
+        }
+      },
+      "required": [
+        "result"
+      ],
+      "type": "object"
+    },
+    "AgentApiOutcomeOfEnvironmentRegistrationKeyUpdateResponse": {
+      "properties": {
+        "notifications": {
+          "items": {
+            "$ref": "#/definitions/AgentNotification"
+          },
+          "type": "array"
+        },
+        "result": {
+          "$ref": "#/definitions/EnvironmentRegistrationKeyUpdateResponse"
+        }
+      },
+      "required": [
+        "result"
+      ],
+      "type": "object"
+    },
     "AgentApiOutcomeOfEnvironmentTemplateListResponse": {
       "properties": {
         "notifications": {
@@ -1628,6 +1662,23 @@
       ],
       "type": "object"
     },
+    "AgentApiOutcomeOfEnvironmentUpdateResponse": {
+      "properties": {
+        "notifications": {
+          "items": {
+            "$ref": "#/definitions/AgentNotification"
+          },
+          "type": "array"
+        },
+        "result": {
+          "$ref": "#/definitions/EnvironmentUpdateResponse"
+        }
+      },
+      "required": [
+        "result"
+      ],
+      "type": "object"
+    },
     "AgentApiOutcomeOfInitializeResponse": {
       "properties": {
         "notifications": {
@@ -7261,6 +7312,110 @@
       ],
       "type": "object"
     },
+    "CodeModeFeature": {
+      "additionalProperties": false,
+      "description": "Grants JavaScript composition through `code_execute`. Available script tools\nare the session's ordinary callable tools, optionally narrowed by allowedTools.\nTypeScript, ambient filesystem/network access, and recursive code execution\nare unavailable. An empty allowedTools list grants pure computation only.",
+      "properties": {
+        "allowedTools": {
+          "description": "Logical tool ids (for example vfs.read_file), not provider wire names.\nAbsent permits every currently callable grant; an empty list permits none.",
+          "items": {
+            "type": "string"
+          },
+          "type": [
+            "array",
+            "null"
+          ]
+        },
+        "maxCatalogBytes": {
+          "default": 1048576,
+          "description": "Pinned callable catalog bytes, at most 8 MiB.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "maxMemoryBytes": {
+          "default": 67108864,
+          "description": "Interpreter heap, at most 512 MiB.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "maxOutputBytes": {
+          "default": 1048576,
+          "description": "Combined text() output and return value, at most 8 MiB.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "maxOutstandingToolCalls": {
+          "default": 16,
+          "description": "Concurrent pending calls, at most 64 and no greater than maxToolCalls.",
+          "format": "uint32",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "maxRequestBytes": {
+          "default": 1048576,
+          "description": "Serialized arguments per tool request, at most 8 MiB.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "maxResultBytes": {
+          "default": 1048576,
+          "description": "Serialized completion per tool request, at most 8 MiB.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "maxSourceBytes": {
+          "default": 262144,
+          "description": "UTF-8 source bytes, at most 1 MiB.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "maxStackBytes": {
+          "default": 1048576,
+          "description": "Interpreter native stack, at most 8 MiB.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "maxToolCalls": {
+          "default": 128,
+          "description": "Calls per script, at most 1,024.",
+          "format": "uint32",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "timeoutMs": {
+          "default": 60000,
+          "description": "Total attempt time including input loading, interpreter capacity waits,\nJavaScript evaluation, and tool waits; at most 600,000 milliseconds.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "version": {
+          "default": 1,
+          "format": "uint32",
+          "minimum": 0,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "CodeToolProgressPhase": {
+      "description": "Bounded lifecycle telemetry for a session-owned code tool execution.",
+      "enum": [
+        "scopeOpened",
+        "callAdmitted",
+        "callDeferred",
+        "callCompleted",
+        "scopeClosed"
+      ],
+      "type": "string"
+    },
     "CompactionPolicy": {
       "oneOf": [
         {
@@ -8238,6 +8393,28 @@
       ],
       "type": "object"
     },
+    "DeletedSessionView": {
+      "properties": {
+        "deletedAtMs": {
+          "format": "int64",
+          "type": "integer"
+        },
+        "displayName": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "sessionId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "sessionId",
+        "deletedAtMs"
+      ],
+      "type": "object"
+    },
     "DeploymentApiKeyCreateParams": {
       "additionalProperties": false,
       "properties": {
@@ -8510,71 +8687,43 @@
       ],
       "type": "object"
     },
-    "DeploymentEnvironmentAdoptParams": {
+    "DeploymentDeletedSessionsListParams": {
+      "additionalProperties": false,
       "properties": {
-        "bindingId": {
-          "type": "string"
-        },
-        "displayName": {
+        "after": {
+          "default": null,
+          "description": "Exclusive session ID cursor; each page contains at most 100 entries.",
           "type": [
             "string",
             "null"
           ]
         },
-        "metadata": {
-          "additionalProperties": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "requestId": {
-          "description": "Stable caller-generated retry identity inside the destination universe.",
-          "type": "string"
-        },
-        "sourceTarget": {
-          "description": "Provider-native source reference. The Incus provider accepts\n`<project>/<instance>` or an instance name in the `default` project.",
-          "type": "string"
-        },
-        "takeOwnership": {
-          "description": "Required acknowledgement that Lightspeed will move, reconfigure, and\ndelete the target as part of its ordinary managed lifecycle.",
-          "type": "boolean"
-        },
         "universeId": {
           "type": "string"
         }
       },
       "required": [
-        "universeId",
-        "requestId",
-        "bindingId",
-        "sourceTarget",
-        "takeOwnership"
-      ],
-      "type": "object"
-    },
-    "DeploymentEnvironmentAdoptResponse": {
-      "properties": {
-        "environment": {
-          "$ref": "#/definitions/EnvironmentView"
-        }
-      },
-      "required": [
-        "environment"
+        "universeId"
       ],
       "type": "object"
     },
-    "DeploymentEnvironmentProviderConnection": {
+    "DeploymentDeletedSessionsListResponse": {
       "properties": {
-        "endpoint": {
-          "type": "string"
+        "nextAfter": {
+          "type": [
+            "string",
+            "null"
+          ]
         },
-        "transport": {
-          "$ref": "#/definitions/DeploymentEnvironmentProviderTransport"
+        "sessions": {
+          "items": {
+            "$ref": "#/definitions/DeletedSessionView"
+          },
+          "type": "array"
         }
       },
       "required": [
-        "endpoint",
-        "transport"
+        "sessions"
       ],
       "type": "object"
     },
@@ -8618,21 +8767,35 @@
       "type": "object"
     },
     "DeploymentEnvironmentProviderPutParams": {
+      "description": "Register or replace a provider. `credential` is the optional bearer\ntoken Lightspeed presents to the provider's controller and data routes:\nit is sealed on receipt and never returned by any method. `Debug` output\nredacts it; request logging must never echo these params.",
       "properties": {
-        "controllerConnection": {
-          "$ref": "#/definitions/DeploymentEnvironmentProviderConnection"
+        "clearCredential": {
+          "description": "Remove the stored credential. Excludes `credential`.",
+          "type": "boolean"
         },
-        "displayName": {
+        "controllerEndpoint": {
+          "description": "`ws://`, `wss://` or `unix://` URL of the provider controller.",
+          "type": "string"
+        },
+        "credential": {
+          "description": "A new bearer credential; omit to keep the stored one. A provider needs\nnone. Excludes `clearCredential`.",
           "type": [
             "string",
             "null"
           ]
         },
-        "metadata": {
-          "additionalProperties": {
-            "type": "string"
-          },
-          "type": "object"
+        "dataRouteBase": {
+          "description": "`ws://` or `wss://` base of the provider's data routes; omit to derive\nit from the controller endpoint. Required for a `unix://` controller,\nand must not be `ws://` for a `wss://` controller.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "displayName": {
+          "type": [
+            "string",
+            "null"
+          ]
         },
         "providerId": {
           "type": "string"
@@ -8640,7 +8803,7 @@
       },
       "required": [
         "providerId",
-        "controllerConnection"
+        "controllerEndpoint"
       ],
       "type": "object"
     },
@@ -8677,82 +8840,22 @@
       ],
       "type": "object"
     },
-    "DeploymentEnvironmentProviderTransport": {
-      "oneOf": [
-        {
-          "properties": {
-            "type": {
-              "const": "webSocket",
-              "type": "string"
-            }
-          },
-          "required": [
-            "type"
-          ],
-          "type": "object"
+    "DeploymentEnvironmentProviderView": {
+      "properties": {
+        "controllerEndpoint": {
+          "description": "`ws://`, `wss://` or `unix://` URL of the provider controller.",
+          "type": "string"
         },
-        {
-          "properties": {
-            "type": {
-              "const": "http",
-              "type": "string"
-            }
-          },
-          "required": [
-            "type"
-          ],
-          "type": "object"
+        "createdAtMs": {
+          "format": "int64",
+          "type": "integer"
         },
-        {
-          "properties": {
-            "type": {
-              "const": "stdio",
-              "type": "string"
-            }
-          },
-          "required": [
-            "type"
-          ],
-          "type": "object"
-        },
-        {
-          "properties": {
-            "type": {
-              "const": "ssh",
-              "type": "string"
-            }
-          },
-          "required": [
-            "type"
-          ],
-          "type": "object"
-        },
-        {
-          "properties": {
-            "providerType": {
-              "type": "string"
-            },
-            "type": {
-              "const": "provider",
-              "type": "string"
-            }
-          },
-          "required": [
-            "type",
-            "providerType"
-          ],
-          "type": "object"
-        }
-      ]
-    },
-    "DeploymentEnvironmentProviderView": {
-      "properties": {
-        "controllerConnection": {
-          "$ref": "#/definitions/DeploymentEnvironmentProviderConnection"
-        },
-        "createdAtMs": {
-          "format": "int64",
-          "type": "integer"
+        "dataRouteBase": {
+          "description": "Operator-configured `ws://` or `wss://` base of the provider's data\nroutes; absent derives it from the controller endpoint.",
+          "type": [
+            "string",
+            "null"
+          ]
         },
         "displayName": {
           "type": [
@@ -8760,11 +8863,16 @@
             "null"
           ]
         },
-        "metadata": {
-          "additionalProperties": {
-            "type": "string"
-          },
-          "type": "object"
+        "effectiveDataRouteBase": {
+          "description": "The data route base Lightspeed dials: `dataRouteBase`, or the\ncontroller endpoint's origin followed by `/routes`. Absent only when it\ncannot be derived.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "hasCredential": {
+          "description": "A bearer credential is stored and presented to the controller and\ndata routes; without one no `Authorization` header is sent.",
+          "type": "boolean"
         },
         "providerId": {
           "type": "string"
@@ -8776,7 +8884,8 @@
       },
       "required": [
         "providerId",
-        "controllerConnection",
+        "controllerEndpoint",
+        "hasCredential",
         "createdAtMs",
         "updatedAtMs"
       ],
@@ -8784,7 +8893,7 @@
     },
     "DeploymentProviderBindingDeleteParams": {
       "properties": {
-        "bindingId": {
+        "providerId": {
           "type": "string"
         },
         "universeId": {
@@ -8793,7 +8902,7 @@
       },
       "required": [
         "universeId",
-        "bindingId"
+        "providerId"
       ],
       "type": "object"
     },
@@ -8809,39 +8918,23 @@
       "type": "object"
     },
     "DeploymentProviderBindingPutParams": {
+      "description": "Create or replace a universe's binding to a deployment provider.",
       "properties": {
-        "bindingId": {
-          "type": "string"
-        },
-        "expectedRevision": {
-          "format": "uint64",
-          "minimum": 0,
-          "type": [
-            "integer",
-            "null"
-          ]
-        },
-        "metadata": {
-          "additionalProperties": {
-            "type": "string"
-          },
-          "type": "object"
+        "enabled": {
+          "description": "Admits creates, template listing and data routes for the universe.",
+          "type": "boolean"
         },
         "providerId": {
           "type": "string"
         },
-        "status": {
-          "$ref": "#/definitions/EnvironmentProviderBindingStatusView"
-        },
         "universeId": {
           "type": "string"
         }
       },
       "required": [
         "universeId",
-        "bindingId",
         "providerId",
-        "status"
+        "enabled"
       ],
       "type": "object"
     },
@@ -8856,6 +8949,37 @@
       ],
       "type": "object"
     },
+    "DeploymentSessionPurgeParams": {
+      "additionalProperties": false,
+      "properties": {
+        "sessionId": {
+          "type": "string"
+        },
+        "universeId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "universeId",
+        "sessionId"
+      ],
+      "type": "object"
+    },
+    "DeploymentSessionPurgeResponse": {
+      "properties": {
+        "deletedSessionIds": {
+          "description": "Includes soft-deleted history forks and delegated descendants.\nEmpty when the target has already been permanently deleted.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "deletedSessionIds"
+      ],
+      "type": "object"
+    },
     "DeploymentUniverseCreateParams": {
       "properties": {
         "slug": {
@@ -9097,77 +9221,61 @@
       ],
       "type": "object"
     },
-    "EnvironmentCloseResponse": {
-      "properties": {
-        "environment": {
-          "$ref": "#/definitions/EnvironmentView"
-        }
-      },
-      "required": [
-        "environment"
-      ],
-      "type": "object"
-    },
-    "EnvironmentConnectionTransportView": {
+    "EnvironmentCloseReasonView": {
+      "description": "Why an environment is closing or closed.",
       "oneOf": [
         {
-          "enum": [
-            "webSocket",
-            "http",
-            "stdio",
-            "ssh"
-          ],
+          "const": "requested",
+          "description": "`environments/close`.",
           "type": "string"
         },
         {
-          "additionalProperties": false,
-          "properties": {
-            "provider": {
-              "properties": {
-                "provider_type": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "provider_type"
-              ],
-              "type": "object"
-            }
-          },
-          "required": [
-            "provider"
-          ],
-          "type": "object"
+          "const": "keyRevoked",
+          "description": "Its registration key was revoked with `closeEnvironments`.",
+          "type": "string"
+        },
+        {
+          "const": "ephemeralGrace",
+          "description": "Its ephemeral daemon stayed away longer than the key's disconnect\ngrace.",
+          "type": "string"
+        },
+        {
+          "const": "departed",
+          "description": "Its ephemeral daemon said goodbye.",
+          "type": "string"
+        },
+        {
+          "const": "offlineTimeout",
+          "description": "Its persistent daemon stayed away longer than the key's\n`offlineCloseAfterMs`.",
+          "type": "string"
+        },
+        {
+          "const": "providerEnded",
+          "description": "The provider reported the target closed or gone.",
+          "type": "string"
         }
       ]
     },
-    "EnvironmentConnectionView": {
+    "EnvironmentCloseResponse": {
       "properties": {
-        "endpoint": {
-          "type": "string"
-        },
-        "transport": {
-          "$ref": "#/definitions/EnvironmentConnectionTransportView"
+        "environment": {
+          "$ref": "#/definitions/EnvironmentView"
         }
       },
       "required": [
-        "endpoint",
-        "transport"
+        "environment"
       ],
       "type": "object"
     },
     "EnvironmentCreateParams": {
       "properties": {
-        "bindingId": {
-          "type": "string"
-        },
         "displayName": {
           "type": [
             "string",
             "null"
           ]
         },
-        "idlePolicy": {
+        "idle": {
           "anyOf": [
             {
               "$ref": "#/definitions/EnvironmentIdlePolicyView"
@@ -9176,7 +9284,7 @@
               "type": "null"
             }
           ],
-          "description": "Optional staged idle policy applied by the power reaper."
+          "description": "Idle policy passed to the provider in place of the template's `idle`.\nThe provider runs the idle clock; it cannot be changed after create."
         },
         "metadata": {
           "additionalProperties": {
@@ -9184,18 +9292,22 @@
           },
           "type": "object"
         },
+        "providerId": {
+          "description": "The provider to create the environment with; the universe needs an\nenabled binding to it.",
+          "type": "string"
+        },
         "requestId": {
-          "description": "Stable caller-generated retry identity, unique inside the universe.",
+          "description": "Stable caller-generated retry identity, unique inside the universe.\nRetrying with identical inputs returns the same environment.",
           "type": "string"
         },
         "templateId": {
-          "description": "Immutable provider template-version identity.",
+          "description": "The provider template to create the environment from.",
           "type": "string"
         }
       },
       "required": [
         "requestId",
-        "bindingId",
+        "providerId",
         "templateId"
       ],
       "type": "object"
@@ -9378,7 +9490,7 @@
           "type": "string"
         },
         "protocolVersion": {
-          "description": "Environment protocol version the gateway speaks. A daemon registers\nonly when it reports exactly this number.",
+          "description": "The envd protocol version (data plane and registration channel)\nthe gateway speaks. A daemon registers only when it reports exactly\nthis number.",
           "format": "uint32",
           "minimum": 0,
           "type": "integer"
@@ -9402,22 +9514,44 @@
       ],
       "type": "object"
     },
-    "EnvironmentExternalCreateParams": {
+    "EnvironmentDaemonView": {
+      "description": "The envd build serving an environment, from its registration or\nLightspeed's open handshake.",
       "properties": {
-        "connection": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/EnvironmentConnectionView"
-            }
-          ],
-          "description": "Connection to an envd instance reachable from Lightspeed."
+        "gitSha": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "protocolVersion": {
+          "format": "uint32",
+          "minimum": 0,
+          "type": "integer"
         },
+        "version": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "protocolVersion"
+      ],
+      "type": "object"
+    },
+    "EnvironmentExternalCreateParams": {
+      "properties": {
         "displayName": {
           "type": [
             "string",
             "null"
           ]
         },
+        "endpoint": {
+          "description": "`ws://`, `wss://` or `unix://` URL of an envd instance reachable from\nLightspeed.",
+          "type": "string"
+        },
         "metadata": {
           "additionalProperties": {
             "type": "string"
@@ -9425,12 +9559,13 @@
           "type": "object"
         },
         "requestId": {
+          "description": "Stable caller-generated retry identity, unique inside the universe.",
           "type": "string"
         }
       },
       "required": [
         "requestId",
-        "connection"
+        "endpoint"
       ],
       "type": "object"
     },
@@ -9446,55 +9581,23 @@
       "type": "object"
     },
     "EnvironmentIdentityModeView": {
-      "description": "What Lightspeed does with a registered environment while its daemon is\ndisconnected. Registration-key policy, copied onto each environment.",
+      "description": "What happens to a registered environment while its daemon is\ndisconnected. Policy of the registration key that admitted it.",
       "oneOf": [
         {
           "const": "persistent",
-          "description": "Stays offline until explicitly closed.",
+          "description": "Stays open: tools wait up to two minutes for the daemon to reconnect.\nClosed explicitly, or after the key's `offlineCloseAfterMs`.",
           "type": "string"
         },
         {
           "const": "ephemeral",
-          "description": "Closed once the daemon has been away longer than the key's\ndisconnect grace.",
+          "description": "Unusable while disconnected; closed once the daemon has been away\nlonger than the key's disconnect grace, or at once when it says\ngoodbye.",
           "type": "string"
         }
       ]
     },
-    "EnvironmentIdlePolicyPutParams": {
-      "properties": {
-        "environmentId": {
-          "type": "string"
-        },
-        "idlePolicy": {
-          "anyOf": [
-            {
-              "$ref": "#/definitions/EnvironmentIdlePolicyView"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "The complete new policy; omit to clear it."
-        }
-      },
-      "required": [
-        "environmentId"
-      ],
-      "type": "object"
-    },
-    "EnvironmentIdlePolicyPutResponse": {
-      "properties": {
-        "environment": {
-          "$ref": "#/definitions/EnvironmentView"
-        }
-      },
-      "required": [
-        "environment"
-      ],
-      "type": "object"
-    },
     "EnvironmentIdlePolicyView": {
-      "description": "Staged idle policy. Thresholds are milliseconds of daemon-reported idle\ntime and must be non-decreasing in the order pause, suspend, stop, close.\nStages whose power state the provider does not support are skipped.",
+      "additionalProperties": false,
+      "description": "Staged idle policy the provider applies. Thresholds are milliseconds of\nenvd-reported idle time (running processes, jobs and leftover process\ngroups hold it at zero) and must be non-decreasing in the order pause,\nsuspend, stop, close. Stages whose power state the template does not\nsupport are skipped.",
       "properties": {
         "closeAfterMs": {
           "format": "uint64",
@@ -9531,64 +9634,19 @@
       },
       "type": "object"
     },
-    "EnvironmentIncarnationView": {
+    "EnvironmentIngressPutParams": {
       "properties": {
-        "createdAtMs": {
-          "format": "int64",
-          "type": "integer"
+        "enabled": {
+          "description": "Ensure (`true`) or remove (`false`) the provider's public ingress.",
+          "type": "boolean"
         },
-        "incarnationId": {
+        "environmentId": {
           "type": "string"
-        },
-        "powerStates": {
-          "description": "Power states the provider reported for this target; empty until\nobserved or when the provider offers no power control.",
-          "items": {
-            "$ref": "#/definitions/EnvironmentPowerStateView"
-          },
-          "type": "array"
-        },
-        "providerTargetId": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "provisionRequestId": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "templateId": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "updatedAtMs": {
-          "format": "int64",
-          "type": "integer"
         }
       },
       "required": [
-        "incarnationId",
-        "createdAtMs",
-        "updatedAtMs"
-      ],
-      "type": "object"
-    },
-    "EnvironmentIngressPutParams": {
-      "properties": {
-        "enabled": {
-          "type": "boolean"
-        },
-        "environmentId": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "environmentId",
-        "enabled"
+        "environmentId",
+        "enabled"
       ],
       "type": "object"
     },
@@ -9687,7 +9745,8 @@
     },
     "EnvironmentJobReadParams": {
       "properties": {
-        "afterSeq": {
+        "after": {
+          "description": "Byte offset to read each job's output from: a previous entry's\n`outputNext`. Omitted with `tailBytes` omitted reads from the start.",
           "format": "uint64",
           "minimum": 0,
           "type": [
@@ -9695,18 +9754,24 @@
             "null"
           ]
         },
-        "includeArtifacts": {
-          "default": false,
-          "type": "boolean"
-        },
         "jobs": {
           "items": {
             "$ref": "#/definitions/SessionJobHandleInput"
           },
           "type": "array"
         },
-        "outputBytes": {
-          "format": "uint",
+        "maxBytes": {
+          "description": "Most output bytes per job; omit for the server's default page.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "tailBytes": {
+          "description": "Read each job's last `tailBytes` of output instead; excludes `after`.",
+          "format": "uint64",
           "minimum": 0,
           "type": [
             "integer",
@@ -9731,45 +9796,29 @@
       },
       "type": "object"
     },
-    "EnvironmentLifecycleStatusView": {
-      "oneOf": [
-        {
-          "enum": [
-            "provisioning",
-            "booting",
-            "ready",
-            "closing",
-            "closed",
-            "failed",
-            "unknown"
-          ],
-          "type": "string"
-        },
-        {
-          "const": "paused",
-          "description": "Execution frozen; wakes on next use.",
-          "type": "string"
-        },
-        {
-          "const": "suspended",
-          "description": "Execution state saved to disk; wakes on next use.",
-          "type": "string"
-        },
-        {
-          "const": "offline",
-          "description": "Powered off; provisioned environments wake on next use when the\nprovider supports power control.",
-          "type": "string"
-        }
-      ]
-    },
     "EnvironmentListParams": {
       "properties": {
-        "bindingId": {
+        "after": {
+          "description": "Exclusive environment id cursor: a previous page's `nextAfter`.",
           "type": [
             "string",
             "null"
           ]
         },
+        "includeClosed": {
+          "description": "Also list closed environments; they are omitted by default.",
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Most environments per page; omit for 100.",
+          "format": "uint32",
+          "maximum": 500,
+          "minimum": 1,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
         "metadata": {
           "additionalProperties": {
             "type": "string"
@@ -9778,6 +9827,7 @@
           "type": "object"
         },
         "providerId": {
+          "description": "Only provisioned environments of this provider.",
           "type": [
             "string",
             "null"
@@ -9790,15 +9840,16 @@
             "null"
           ]
         },
-        "status": {
+        "state": {
           "anyOf": [
             {
-              "$ref": "#/definitions/EnvironmentLifecycleStatusView"
+              "$ref": "#/definitions/EnvironmentStateView"
             },
             {
               "type": "null"
             }
-          ]
+          ],
+          "description": "Only environments in this lifecycle state. `closed` lists closed\nenvironments without `includeClosed`."
         }
       },
       "type": "object"
@@ -9807,14 +9858,56 @@
       "properties": {
         "environments": {
           "default": [],
+          "description": "Environments in environment id order.",
           "items": {
             "$ref": "#/definitions/EnvironmentView"
           },
           "type": "array"
+        },
+        "nextAfter": {
+          "description": "Pass as `after` to read the next page; absent on the last page.",
+          "type": [
+            "string",
+            "null"
+          ]
         }
       },
       "type": "object"
     },
+    "EnvironmentObservedTargetView": {
+      "description": "What the provider last reported about a provisioned environment's\ntarget. Display only: Lightspeed never converges it, and it may be up to\na few minutes old.",
+      "properties": {
+        "message": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "observedAtMs": {
+          "format": "int64",
+          "type": "integer"
+        },
+        "phase": {
+          "$ref": "#/definitions/EnvironmentTargetPhaseView"
+        },
+        "power": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/EnvironmentPowerStateView"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Present only while `phase` is `active`."
+        }
+      },
+      "required": [
+        "phase",
+        "observedAtMs"
+      ],
+      "type": "object"
+    },
     "EnvironmentPowerPutParams": {
       "properties": {
         "environmentId": {
@@ -9826,7 +9919,7 @@
               "$ref": "#/definitions/EnvironmentPowerStateView"
             }
           ],
-          "description": "Desired steady power state. Must be one of the provider-reported\n`incarnation.powerStates`."
+          "description": "Power state to move the target to; one of its template's\n`powerStates`."
         }
       },
       "required": [
@@ -9847,7 +9940,7 @@
       "type": "object"
     },
     "EnvironmentPowerStateView": {
-      "description": "Steady power state of a provisioned environment.",
+      "description": "Power state of a provisioned environment's target.",
       "oneOf": [
         {
           "enum": [
@@ -9909,12 +10002,12 @@
     },
     "EnvironmentProviderBindingReadParams": {
       "properties": {
-        "bindingId": {
+        "providerId": {
           "type": "string"
         }
       },
       "required": [
-        "bindingId"
+        "providerId"
       ],
       "type": "object"
     },
@@ -9929,49 +10022,27 @@
       ],
       "type": "object"
     },
-    "EnvironmentProviderBindingStatusView": {
-      "enum": [
-        "enabled",
-        "disabled"
-      ],
-      "type": "string"
-    },
     "EnvironmentProviderBindingView": {
+      "description": "A universe's binding to a deployment provider. Creates, templates and\ndata routes of the provider need it enabled.",
       "properties": {
-        "bindingId": {
-          "type": "string"
-        },
         "createdAtMs": {
           "format": "int64",
           "type": "integer"
         },
-        "metadata": {
-          "additionalProperties": {
-            "type": "string"
-          },
-          "type": "object"
+        "enabled": {
+          "type": "boolean"
         },
         "providerId": {
           "type": "string"
         },
-        "revision": {
-          "format": "uint64",
-          "minimum": 0,
-          "type": "integer"
-        },
-        "status": {
-          "$ref": "#/definitions/EnvironmentProviderBindingStatusView"
-        },
         "updatedAtMs": {
           "format": "int64",
           "type": "integer"
         }
       },
       "required": [
-        "bindingId",
         "providerId",
-        "status",
-        "revision",
+        "enabled",
         "createdAtMs",
         "updatedAtMs"
       ],
@@ -10022,7 +10093,12 @@
           ]
         },
         "identityMode": {
-          "$ref": "#/definitions/EnvironmentIdentityModeView"
+          "allOf": [
+            {
+              "$ref": "#/definitions/EnvironmentIdentityModeView"
+            }
+          ],
+          "description": "Immutable once the key exists."
         },
         "maxActiveEnvironments": {
           "description": "Non-closed environments the key may have at once; omit for unlimited.",
@@ -10032,6 +10108,15 @@
             "integer",
             "null"
           ]
+        },
+        "offlineCloseAfterMs": {
+          "description": "Persistent keys only: close environments whose daemon has been away\nlonger than this; omit to keep them open.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
         }
       },
       "required": [
@@ -10131,6 +10216,37 @@
       ],
       "type": "object"
     },
+    "EnvironmentRegistrationKeyRotateParams": {
+      "properties": {
+        "registrationKeyId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "registrationKeyId"
+      ],
+      "type": "object"
+    },
+    "EnvironmentRegistrationKeyRotateResponse": {
+      "properties": {
+        "registrationKey": {
+          "$ref": "#/definitions/EnvironmentRegistrationKeyView"
+        },
+        "secret": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/EnvironmentRegistrationSecretView"
+            }
+          ],
+          "description": "The new plaintext secret, returned only here."
+        }
+      },
+      "required": [
+        "registrationKey",
+        "secret"
+      ],
+      "type": "object"
+    },
     "EnvironmentRegistrationKeyStatusView": {
       "enum": [
         "active",
@@ -10139,6 +10255,68 @@
       ],
       "type": "string"
     },
+    "EnvironmentRegistrationKeyUpdateParams": {
+      "description": "The complete editable policy of a registration key; an absent field is\nunset. The identity mode is immutable.",
+      "properties": {
+        "displayName": {
+          "description": "Group name for the environments this key admits.",
+          "type": "string"
+        },
+        "ephemeralDisconnectGraceMs": {
+          "description": "Disconnect grace for ephemeral environments; omit for the default.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "expiresAtMs": {
+          "format": "int64",
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "maxActiveEnvironments": {
+          "description": "Non-closed environments the key may have at once; omit for unlimited.",
+          "format": "uint32",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "offlineCloseAfterMs": {
+          "description": "Persistent keys only: close environments whose daemon has been away\nlonger than this; omit to keep them open.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "registrationKeyId": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "registrationKeyId",
+        "displayName"
+      ],
+      "type": "object"
+    },
+    "EnvironmentRegistrationKeyUpdateResponse": {
+      "properties": {
+        "registrationKey": {
+          "$ref": "#/definitions/EnvironmentRegistrationKeyView"
+        }
+      },
+      "required": [
+        "registrationKey"
+      ],
+      "type": "object"
+    },
     "EnvironmentRegistrationKeyView": {
       "properties": {
         "activeEnvironmentCount": {
@@ -10172,7 +10350,7 @@
           "$ref": "#/definitions/EnvironmentIdentityModeView"
         },
         "keyPrefix": {
-          "description": "First characters of the secret, for identification only.",
+          "description": "First characters of the key's live secret, for identification only.",
           "type": "string"
         },
         "lastRegisteredAtMs": {
@@ -10190,6 +10368,15 @@
             "null"
           ]
         },
+        "offlineCloseAfterMs": {
+          "description": "Persistent keys only: environments whose daemon has been away longer\nthan this are closed; absent keeps them open.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
         "registeredEnvironmentCount": {
           "description": "Environments ever admitted by this key, closed included.",
           "format": "uint64",
@@ -10208,6 +10395,10 @@
         },
         "status": {
           "$ref": "#/definitions/EnvironmentRegistrationKeyStatusView"
+        },
+        "updatedAtMs": {
+          "format": "int64",
+          "type": "integer"
         }
       },
       "required": [
@@ -10219,7 +10410,8 @@
         "status",
         "registeredEnvironmentCount",
         "activeEnvironmentCount",
-        "createdAtMs"
+        "createdAtMs",
+        "updatedAtMs"
       ],
       "type": "object"
     },
@@ -10248,13 +10440,50 @@
     "EnvironmentSourceView": {
       "oneOf": [
         {
+          "description": "A target a deployment provider created from a template. The provider\nowns its power, idle policy and ingress.",
           "properties": {
-            "bindingId": {
-              "type": "string"
+            "idle": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/EnvironmentIdlePolicyView"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "The create-time idle policy, when one replaced the template's."
+            },
+            "observed": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/EnvironmentObservedTargetView"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Absent until the provider first reported the target."
             },
             "providerId": {
               "type": "string"
             },
+            "publicEndpoint": {
+              "description": "The public endpoint the provider last reported.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "targetId": {
+              "description": "The provider's handle for the target; absent until the provider\naccepted the create.",
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "templateId": {
+              "type": "string"
+            },
             "type": {
               "const": "provisioned",
               "type": "string"
@@ -10263,14 +10492,15 @@
           "required": [
             "type",
             "providerId",
-            "bindingId"
+            "templateId"
           ],
           "type": "object"
         },
         {
           "properties": {
-            "connection": {
-              "$ref": "#/definitions/EnvironmentConnectionView"
+            "endpoint": {
+              "description": "`ws://`, `wss://` or `unix://` URL Lightspeed dials envd at.",
+              "type": "string"
             },
             "type": {
               "const": "external",
@@ -10279,18 +10509,37 @@
           },
           "required": [
             "type",
-            "connection"
+            "endpoint"
           ],
           "type": "object"
         },
         {
           "description": "An envd that dialed the gateway outbound and was admitted by a\nregistration key. The key is the environment's group; the daemon id\nis derived from the daemon's public key and is its identity.",
           "properties": {
+            "connected": {
+              "description": "The daemon's control connection is up.",
+              "type": "boolean"
+            },
+            "connectionChangedAtMs": {
+              "description": "When the daemon last connected or disconnected.",
+              "format": "int64",
+              "type": "integer"
+            },
             "daemonId": {
               "type": "string"
             },
             "identityMode": {
-              "$ref": "#/definitions/EnvironmentIdentityModeView"
+              "allOf": [
+                {
+                  "$ref": "#/definitions/EnvironmentIdentityModeView"
+                }
+              ],
+              "description": "The admitting key's identity mode."
+            },
+            "lastSeenAtMs": {
+              "description": "When the gateway last recorded the daemon's control connection:\nat connect, at disconnect, and at most every five minutes while\nconnected.",
+              "format": "int64",
+              "type": "integer"
             },
             "registrationKeyId": {
               "type": "string"
@@ -10304,15 +10553,98 @@
             "type",
             "registrationKeyId",
             "daemonId",
-            "identityMode"
+            "identityMode",
+            "connected",
+            "connectionChangedAtMs",
+            "lastSeenAtMs"
           ],
           "type": "object"
         }
       ]
     },
+    "EnvironmentStateView": {
+      "description": "The lifecycle Lightspeed owns. External and registered environments are\nonly ever `open` or `closed`.",
+      "oneOf": [
+        {
+          "enum": [
+            "open",
+            "closed"
+          ],
+          "type": "string"
+        },
+        {
+          "const": "provisioning",
+          "description": "The provider is creating the target; the environment opens after\nLightspeed's first handshake with its envd.",
+          "type": "string"
+        },
+        {
+          "const": "closing",
+          "description": "The provider is removing the target.",
+          "type": "string"
+        },
+        {
+          "const": "failed",
+          "description": "Provisioning or the provider failed; `stateMessage` says why.",
+          "type": "string"
+        }
+      ]
+    },
+    "EnvironmentStatusView": {
+      "description": "Display status derived from `state` and the latest observation; never\nstored. Tools that use a paused, suspended or stopped environment wake\nit.",
+      "oneOf": [
+        {
+          "enum": [
+            "provisioning",
+            "ready",
+            "closing",
+            "closed",
+            "failed"
+          ],
+          "type": "string"
+        },
+        {
+          "const": "paused",
+          "description": "Execution frozen with RAM resident.",
+          "type": "string"
+        },
+        {
+          "const": "suspended",
+          "description": "Execution state saved to disk.",
+          "type": "string"
+        },
+        {
+          "const": "stopped",
+          "description": "Powered off with disk retained.",
+          "type": "string"
+        },
+        {
+          "const": "unknown",
+          "description": "Open, but the provider's latest observation is inconclusive.",
+          "type": "string"
+        },
+        {
+          "const": "away",
+          "description": "Registered, open, and its daemon is not connected.",
+          "type": "string"
+        }
+      ]
+    },
+    "EnvironmentTargetPhaseView": {
+      "description": "Lifecycle phase of a provider target, as the provider reports it.",
+      "enum": [
+        "provisioning",
+        "active",
+        "closing",
+        "closed",
+        "failed",
+        "unknown"
+      ],
+      "type": "string"
+    },
     "EnvironmentTemplateListParams": {
       "properties": {
-        "bindingId": {
+        "providerId": {
+          "description": "Only this provider's templates; omit for every enabled binding.",
           "type": [
             "string",
             "null"
@@ -10337,7 +10669,7 @@
     },
     "EnvironmentTemplateReadParams": {
       "properties": {
-        "bindingId": {
+        "providerId": {
           "type": "string"
         },
         "templateId": {
@@ -10345,7 +10677,7 @@
         }
       },
       "required": [
-        "bindingId",
+        "providerId",
         "templateId"
       ],
       "type": "object"
@@ -10361,11 +10693,38 @@
       ],
       "type": "object"
     },
-    "EnvironmentTemplateView": {
+    "EnvironmentTemplateResourcesView": {
+      "description": "A template's compute, in provider-neutral units. Each field is absent\nwhen the provider does not fix it.",
       "properties": {
-        "bindingId": {
-          "type": "string"
+        "diskBytes": {
+          "format": "uint64",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "memoryBytes": {
+          "format": "uint64",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
         },
+        "vcpus": {
+          "format": "uint32",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "EnvironmentTemplateView": {
+      "properties": {
         "deprecated": {
           "type": "boolean"
         },
@@ -10378,18 +10737,48 @@
         "displayName": {
           "type": "string"
         },
+        "idle": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/EnvironmentIdlePolicyView"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Idle policy targets get when `environments/create` names none."
+        },
         "metadata": {
           "additionalProperties": {
             "type": "string"
           },
           "type": "object"
         },
+        "powerStates": {
+          "description": "Power states `environments/power/put` can move targets of this\ntemplate to; empty without power control.",
+          "items": {
+            "$ref": "#/definitions/EnvironmentPowerStateView"
+          },
+          "type": "array"
+        },
         "providerId": {
           "type": "string"
         },
         "publicIngress": {
+          "description": "`environments/ingress/put` can enable public ingress on targets of\nthis template.",
           "type": "boolean"
         },
+        "resources": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/EnvironmentTemplateResourcesView"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Compute targets of this template get; absent when the provider does\nnot fix it."
+        },
         "templateId": {
           "type": "string"
         }
@@ -10397,28 +10786,18 @@
       "required": [
         "templateId",
         "providerId",
-        "bindingId",
         "displayName",
         "publicIngress",
-        "deprecated"
+        "deprecated",
+        "powerStates"
       ],
       "type": "object"
     },
-    "EnvironmentView": {
+    "EnvironmentUpdateParams": {
+      "description": "Replace an environment's display name and caller metadata.",
       "properties": {
-        "createdAtMs": {
-          "format": "int64",
-          "type": "integer"
-        },
-        "desiredPower": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/EnvironmentPowerStateView"
-            }
-          ],
-          "description": "Lightspeed-owned power intent; `status` is the observed state."
-        },
         "displayName": {
+          "description": "The new display name; omit to clear it.",
           "type": [
             "string",
             "null"
@@ -10427,50 +10806,108 @@
         "environmentId": {
           "type": "string"
         },
-        "idlePolicy": {
+        "metadata": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "The complete new caller metadata; omit or `{}` to clear it.",
+          "type": "object"
+        }
+      },
+      "required": [
+        "environmentId"
+      ],
+      "type": "object"
+    },
+    "EnvironmentUpdateResponse": {
+      "properties": {
+        "environment": {
+          "$ref": "#/definitions/EnvironmentView"
+        }
+      },
+      "required": [
+        "environment"
+      ],
+      "type": "object"
+    },
+    "EnvironmentView": {
+      "properties": {
+        "closeReason": {
           "anyOf": [
             {
-              "$ref": "#/definitions/EnvironmentIdlePolicyView"
+              "$ref": "#/definitions/EnvironmentCloseReasonView"
             },
             {
               "type": "null"
             }
-          ]
+          ],
+          "description": "Present exactly while `state` is `closing` or `closed`."
         },
-        "incarnation": {
-          "$ref": "#/definitions/EnvironmentIncarnationView"
+        "closedAtMs": {
+          "format": "int64",
+          "type": [
+            "integer",
+            "null"
+          ]
         },
-        "lastSeenAtMs": {
-          "description": "Registered environments only: when the gateway last saw the daemon's\ncontrol connection.",
+        "createdAtMs": {
           "format": "int64",
+          "type": "integer"
+        },
+        "daemon": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/EnvironmentDaemonView"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "The envd build serving the environment; absent until known."
+        },
+        "displayName": {
           "type": [
-            "integer",
+            "string",
             "null"
           ]
         },
+        "environmentId": {
+          "type": "string"
+        },
         "metadata": {
           "additionalProperties": {
             "type": "string"
           },
+          "description": "Caller metadata.",
           "type": "object"
         },
-        "publicEndpoint": {
+        "requestId": {
+          "description": "The caller's retry identity; absent for registered environments.",
           "type": [
             "string",
             "null"
           ]
         },
-        "publicIngressEnabled": {
-          "type": "boolean"
-        },
-        "requestId": {
-          "type": "string"
-        },
         "source": {
           "$ref": "#/definitions/EnvironmentSourceView"
         },
+        "state": {
+          "$ref": "#/definitions/EnvironmentStateView"
+        },
+        "stateChangedAtMs": {
+          "description": "When `state` last changed.",
+          "format": "int64",
+          "type": "integer"
+        },
+        "stateMessage": {
+          "description": "Why the environment failed, or what provisioning or closing is\nwaiting on.",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
         "status": {
-          "$ref": "#/definitions/EnvironmentLifecycleStatusView"
+          "$ref": "#/definitions/EnvironmentStatusView"
         },
         "updatedAtMs": {
           "format": "int64",
@@ -10479,12 +10916,10 @@
       },
       "required": [
         "environmentId",
-        "requestId",
         "source",
+        "state",
         "status",
-        "desiredPower",
-        "incarnation",
-        "publicIngressEnabled",
+        "stateChangedAtMs",
         "createdAtMs",
         "updatedAtMs"
       ],
@@ -10630,6 +11065,16 @@
       "additionalProperties": false,
       "description": "Capability grants. An absent feature is not granted; `{}` grants it with\ndefaults. Every block carries a behavior `version` that pins semantics.",
       "properties": {
+        "codeMode": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/CodeModeFeature"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
         "environments": {
           "anyOf": [
             {
@@ -11998,7 +12443,8 @@
             "mcp",
             "bots",
             "deployment/universes",
-            "deployment/api-keys"
+            "deployment/api-keys",
+            "deployment/sessions"
           ],
           "type": "string"
         },
@@ -12007,6 +12453,11 @@
           "description": "`session/*`, `blobs/read` and `blobs/has`.",
           "type": "string"
         },
+        {
+          "const": "session/delete",
+          "description": "Destructive session operations and deletion retention.",
+          "type": "string"
+        },
         {
           "const": "blobs/put",
           "description": "`blobs/put` alone, so connectors can upload attachments without\nreading sessions.",
@@ -12039,7 +12490,7 @@
         },
         {
           "const": "deployment/environment-providers",
-          "description": "Environment providers, their bindings and adoption.",
+          "description": "Environment providers and their universe bindings.",
           "type": "string"
         },
         {
@@ -13892,6 +14343,14 @@
         },
         "sessionId": {
           "type": "string"
+        },
+        "sharedOnly": {
+          "description": "Atomically require every selected session's audience to be shared.\nDelegating services use this guard for operators deleting shared work.",
+          "type": "boolean"
+        },
+        "softDelete": {
+          "description": "Hide sessions while retaining records, events, checkpoints and blob roots.\nFalse (the default) permanently deletes them without prior soft deletion.",
+          "type": "boolean"
         }
       },
       "required": [
@@ -15344,6 +15803,43 @@
             "batchId"
           ],
           "type": "object"
+        },
+        {
+          "description": "Progress of a code tool execution. This preserves the contiguous session\nevent cursor without projecting internal scope bindings or payloads as\nconversational tool calls.",
+          "properties": {
+            "executionId": {
+              "type": "string"
+            },
+            "phase": {
+              "$ref": "#/definitions/CodeToolProgressPhase"
+            },
+            "requestId": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "status": {
+              "anyOf": [
+                {
+                  "$ref": "#/definitions/ToolItemStatus"
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "type": {
+              "const": "codeToolProgress",
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "executionId",
+            "phase"
+          ],
+          "type": "object"
         }
       ]
     },
@@ -15485,29 +15981,6 @@
       ],
       "type": "object"
     },
-    "SessionJobArtifactView": {
-      "properties": {
-        "kind": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "metadata": {
-          "additionalProperties": {
-            "type": "string"
-          },
-          "type": "object"
-        },
-        "path": {
-          "type": "string"
-        }
-      },
-      "required": [
-        "path"
-      ],
-      "type": "object"
-    },
     "SessionJobCancelEntryView": {
       "properties": {
         "error": {
@@ -15570,6 +16043,49 @@
       ],
       "type": "string"
     },
+    "SessionJobExitView": {
+      "description": "How a job's root process ended.",
+      "oneOf": [
+        {
+          "description": "Normal exit with this status code.",
+          "properties": {
+            "code": {
+              "format": "int32",
+              "type": "integer"
+            },
+            "type": {
+              "const": "code",
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "code"
+          ],
+          "type": "object"
+        },
+        {
+          "description": "Killed by this signal, named like `SIGSEGV`.",
+          "properties": {
+            "coreDumped": {
+              "type": "boolean"
+            },
+            "signal": {
+              "type": "string"
+            },
+            "type": {
+              "const": "signal",
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "signal"
+          ],
+          "type": "object"
+        }
+      ]
+    },
     "SessionJobHandleInput": {
       "properties": {
         "environmentId": {
@@ -15605,7 +16121,8 @@
         "dataBase64": {
           "type": "string"
         },
-        "seq": {
+        "offset": {
+          "description": "Byte offset of the chunk's first byte in the job's combined output.",
           "format": "uint64",
           "minimum": 0,
           "type": "integer"
@@ -15615,12 +16132,50 @@
         }
       },
       "required": [
-        "seq",
+        "offset",
         "stream",
         "dataBase64"
       ],
       "type": "object"
     },
+    "SessionJobOutputGapReasonView": {
+      "oneOf": [
+        {
+          "const": "overflow",
+          "description": "Dropped from the middle because the job's retained output exceeded\nits cap; the head and the newest bytes are kept.",
+          "type": "string"
+        },
+        {
+          "const": "expired",
+          "description": "Released after it was delivered.",
+          "type": "string"
+        }
+      ]
+    },
+    "SessionJobOutputGapView": {
+      "description": "Output bytes in `[offset, offset + omittedBytes)` that cannot be\nreturned.",
+      "properties": {
+        "offset": {
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "omittedBytes": {
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "reason": {
+          "$ref": "#/definitions/SessionJobOutputGapReasonView"
+        }
+      },
+      "required": [
+        "offset",
+        "omittedBytes",
+        "reason"
+      ],
+      "type": "object"
+    },
     "SessionJobOutputStreamView": {
       "enum": [
         "stdout",
@@ -15629,13 +16184,8 @@
       "type": "string"
     },
     "SessionJobReadEntryView": {
+      "description": "One job's summary and output page, or why it could not be read: an\nentry with `error` and no summary names a job the environment does not\nknow (never created, or garbage-collected).",
       "properties": {
-        "artifacts": {
-          "items": {
-            "$ref": "#/definitions/SessionJobArtifactView"
-          },
-          "type": "array"
-        },
         "error": {
           "type": [
             "string",
@@ -15653,12 +16203,27 @@
           ]
         },
         "outputChunks": {
+          "description": "Output in offset order.",
           "items": {
             "$ref": "#/definitions/SessionJobOutputChunkView"
           },
           "type": "array"
         },
-        "outputNextSeq": {
+        "outputEnd": {
+          "description": "Output bytes the job produced so far; final once it is terminal.",
+          "format": "uint64",
+          "minimum": 0,
+          "type": "integer"
+        },
+        "outputGaps": {
+          "description": "Output ranges between the requested start and `outputNext` that\ncannot be returned.",
+          "items": {
+            "$ref": "#/definitions/SessionJobOutputGapView"
+          },
+          "type": "array"
+        },
+        "outputNext": {
+          "description": "Byte offset to continue reading from: pass it as `after`.",
           "format": "uint64",
           "minimum": 0,
           "type": "integer"
@@ -15675,7 +16240,8 @@
         }
       },
       "required": [
-        "outputNextSeq"
+        "outputNext",
+        "outputEnd"
       ],
       "type": "object"
     },
@@ -15795,26 +16361,84 @@
       "type": "object"
     },
     "SessionJobStatusView": {
-      "enum": [
-        "accepted",
-        "queued",
-        "running",
-        "succeeded",
-        "failed",
-        "cancelRequested",
-        "cancelled",
-        "timedOut",
-        "dependencyFailed",
-        "interrupted",
-        "lost"
-      ],
-      "type": "string"
+      "description": "Job lifecycle. `queued` and `running` are live; the rest are terminal.",
+      "oneOf": [
+        {
+          "enum": [
+            "running"
+          ],
+          "type": "string"
+        },
+        {
+          "const": "queued",
+          "description": "Waiting for dependencies or its queue.",
+          "type": "string"
+        },
+        {
+          "const": "succeeded",
+          "description": "Exited with code 0.",
+          "type": "string"
+        },
+        {
+          "const": "failed",
+          "description": "Exited otherwise, or could not start.",
+          "type": "string"
+        },
+        {
+          "const": "timedOut",
+          "description": "Its timeout expired and it was stopped.",
+          "type": "string"
+        },
+        {
+          "const": "cancelled",
+          "description": "Stopped or never started because of a cancel.",
+          "type": "string"
+        },
+        {
+          "const": "dependencyFailed",
+          "description": "A dependency did not finish as the dependency policy requires.",
+          "type": "string"
+        },
+        {
+          "const": "interrupted",
+          "description": "The environment daemon stopped while the job was queued or running.",
+          "type": "string"
+        }
+      ]
+    },
+    "SessionJobStoppedByView": {
+      "description": "Why Lightspeed stopped a running job.",
+      "oneOf": [
+        {
+          "const": "timeout",
+          "description": "Its timeout expired: terminate, a grace period, then kill.",
+          "type": "string"
+        },
+        {
+          "const": "terminate",
+          "description": "A cancel without `force`: terminate, a grace period, then kill.",
+          "type": "string"
+        },
+        {
+          "const": "kill",
+          "description": "A cancel with `force`: killed at once.",
+          "type": "string"
+        }
+      ]
     },
     "SessionJobSummaryView": {
+      "description": "What a job is and how it ended. Instants are the environment's wall\nclock.",
       "properties": {
+        "cancelRequestedAtMs": {
+          "description": "When a cancel reached the job while it ran.",
+          "format": "int64",
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
         "createdAtMs": {
-          "format": "uint64",
-          "minimum": 0,
+          "format": "int64",
           "type": "integer"
         },
         "dependencies": {
@@ -15823,13 +16447,26 @@
           },
           "type": "array"
         },
-        "exitCode": {
-          "format": "int32",
+        "durationMs": {
+          "description": "Run time from start to finish, immune to clock jumps.",
+          "format": "uint64",
+          "minimum": 0,
           "type": [
             "integer",
             "null"
           ]
         },
+        "exit": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SessionJobExitView"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "How the job's root process ended, once it ran and exited."
+        },
         "failure": {
           "type": [
             "string",
@@ -15837,8 +16474,7 @@
           ]
         },
         "finishedAtMs": {
-          "format": "uint64",
-          "minimum": 0,
+          "format": "int64",
           "type": [
             "integer",
             "null"
@@ -15853,9 +16489,6 @@
             "null"
           ]
         },
-        "namespace": {
-          "type": "string"
-        },
         "orphanedDescendants": {
           "description": "True when the job's root process exited while descendants it spawned\nwere still running; the host terminated them best-effort at job\ncompletion.",
           "type": "boolean"
@@ -15867,16 +16500,18 @@
           ]
         },
         "queuedAtMs": {
-          "format": "uint64",
-          "minimum": 0,
+          "format": "int64",
           "type": [
             "integer",
             "null"
           ]
         },
+        "requestId": {
+          "description": "The start request that created the job; part of its identity.",
+          "type": "string"
+        },
         "startedAtMs": {
-          "format": "uint64",
-          "minimum": 0,
+          "format": "int64",
           "type": [
             "integer",
             "null"
@@ -15884,11 +16519,22 @@
         },
         "status": {
           "$ref": "#/definitions/SessionJobStatusView"
+        },
+        "stoppedBy": {
+          "anyOf": [
+            {
+              "$ref": "#/definitions/SessionJobStoppedByView"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Set when Lightspeed stopped the running job."
         }
       },
       "required": [
-        "namespace",
         "jobId",
+        "requestId",
         "status",
         "createdAtMs"
       ],
@@ -16184,7 +16830,7 @@
       "additionalProperties": false,
       "properties": {
         "deleteAfterCloseMs": {
-          "description": "Positive duration enables automatic tree deletion; null disables it.",
+          "description": "Positive duration enables automatic tree soft deletion; null disables it.",
           "format": "uint64",
           "minimum": 1,
           "type": [
@@ -16289,7 +16935,7 @@
           ]
         },
         "deleteAfterCloseMs": {
-          "description": "Root-owned automatic deletion measured from close. Absent inherits a\nprofile default, explicit null keeps the tree, and a duration overrides\nthe profile.",
+          "description": "Root-owned automatic soft deletion measured from close. Absent inherits a\nprofile default, explicit null keeps the tree, and a duration overrides\nthe profile.",
           "format": "uint64",
           "maximum": 3153600000000,
           "minimum": 1,
@@ -17005,6 +17651,11 @@
           "description": "Runs or controls a process.",
           "type": "string"
         },
+        {
+          "const": "code",
+          "description": "Orchestrates tool calls in a code-mode script.",
+          "type": "string"
+        },
         {
           "const": "mcp",
           "description": "Calls a tool on an MCP server, through the builtin bridge or a\nprovider-native MCP block.",
@@ -17679,8 +18330,11 @@
             "read",
             "create_session",
             "control_session",
+            "configure_session",
             "stop_session",
+            "close_session",
             "delete_session",
+            "set_session_retention",
             "create_profile",
             "manage_profile",
             "create_bot",