@onesi/genesis 0.2.1 → 0.2.3

package/dist/generated/schema.d.ts

@@ -4620,7 +4620,7 @@ export interface paths {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -4648,7 +4648,7 @@ export interface paths {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -4672,7 +4672,7 @@ export interface paths {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -4696,7 +4696,7 @@ export interface paths {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
                 recordId: number;
             };
@@ -6016,6 +6016,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/relays/domains/specials": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List TLDs priced below their 24-hour mean
+         * @description Genesis scope relays:read; local scope registrar:read. Needs the selected project's existing Relays account and never provisions it (403 RELAYS_NOT_PROVISIONED until an owner or admin opens Relays). Returns the TLDs whose cheapest current wholesale registration price across Relays' registrars is at least 10% below its 24-hour trailing mean, deepest discount first, at most 50. Prices are integer cents; deltaPercent is the fractional change (-0.25 is 25% below the mean). narrative is present when a recent pricing note exists for the TLD. The data is market pricing shared by every account and is recomputed at most once a minute (cached says whether this answer came from that cache). Nothing is bought.
+         */
+        get: operations["relays_listDomainSpecials"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/relays/domains/forwarding": {
         parameters: {
             query?: never;
@@ -6317,7 +6337,7 @@ export interface paths {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -6364,7 +6384,7 @@ export interface paths {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -6387,7 +6407,7 @@ export interface paths {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -6410,7 +6430,7 @@ export interface paths {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -11506,7 +11526,7 @@ export interface paths {
         };
         /**
          * forgetting: GET /v1/forgetting/requests
-         * @description Calls `GET /v1/forgetting/requests` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read` on `_system_forgetting_requests` (minds:instances:read). Registered on every Mind with a storage service (kv, graph, analytics, ml, inference, vector or memory) enabled. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `GET /v1/forgetting/requests` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `query`, `read` on `_system_forgetting_requests` (minds:instances:read). Registered on every Mind with a storage service (kv, graph, analytics, ml, inference, vector or memory) enabled. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         get: operations["minds_engineForgettingGetForgettingRequests"];
         put?: never;
@@ -11550,7 +11570,7 @@ export interface paths {
         };
         /**
          * forgetting: GET /v1/forgetting/stats
-         * @description Calls `GET /v1/forgetting/stats` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read` on `_system_forgetting_requests` (minds:instances:read). Registered on every Mind with a storage service (kv, graph, analytics, ml, inference, vector or memory) enabled. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `GET /v1/forgetting/stats` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `query`, `read` on `_system_forgetting_requests` (minds:instances:read). Registered on every Mind with a storage service (kv, graph, analytics, ml, inference, vector or memory) enabled. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         get: operations["minds_engineForgettingGetForgettingStats"];
         put?: never;
@@ -12403,7 +12423,7 @@ export interface paths {
         get: operations["minds_engineEpisodicMemoryGetMemoryEpisodicId"];
         /**
          * episodic-memory: PUT /v1/memory/episodic/:id
-         * @description Calls `PUT /v1/memory/episodic/:id` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `update` on `memory:episodic` (minds:instances:update). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` and `minds:write`. Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `PUT /v1/memory/episodic/:id` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read`, `update` on `memory:episodic` (minds:instances:update). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` and `minds:write`. Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         put: operations["minds_engineEpisodicMemoryPutMemoryEpisodicId"];
         post?: never;
@@ -12506,7 +12526,7 @@ export interface paths {
         };
         /**
          * procedural-memory: GET /v1/memory/procedures/list
-         * @description Calls `GET /v1/memory/procedures/list` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read` on `memory:procedural` (minds:instances:read). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `GET /v1/memory/procedures/list` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `query`, `read` on `memory:procedural` (minds:instances:read). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         get: operations["minds_engineProceduralMemoryGetMemoryProceduresList"];
         put?: never;
@@ -12548,7 +12568,7 @@ export interface paths {
         put?: never;
         /**
          * procedural-memory: POST /v1/memory/procedures/update
-         * @description Calls `POST /v1/memory/procedures/update` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `update` on `memory:procedural` (minds:instances:update). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` and `minds:write`. Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `POST /v1/memory/procedures/update` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read`, `update` on `memory:procedural` (minds:instances:update). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` and `minds:write`. Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         post: operations["minds_engineProceduralMemoryPostMemoryProceduresUpdate"];
         delete?: never;
@@ -12608,7 +12628,7 @@ export interface paths {
         put?: never;
         /**
          * resource-memory: POST /v1/memory/resources/access
-         * @description Calls `POST /v1/memory/resources/access` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `update` on `memory:resource` (minds:instances:update). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` and `minds:write`. Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `POST /v1/memory/resources/access` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `update`, `write` on `memory:resource` (minds:instances:update). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` and `minds:write`. Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         post: operations["minds_engineResourceMemoryPostMemoryResourcesAccess"];
         delete?: never;
@@ -12726,7 +12746,7 @@ export interface paths {
         };
         /**
          * resource-memory: GET /v1/memory/resources/list
-         * @description Calls `GET /v1/memory/resources/list` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read` on `memory:resource` (minds:instances:read). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `GET /v1/memory/resources/list` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `query`, `read` on `memory:resource` (minds:instances:read). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         get: operations["minds_engineResourceMemoryGetMemoryResourcesList"];
         put?: never;
@@ -12748,7 +12768,7 @@ export interface paths {
         put?: never;
         /**
          * resource-memory: POST /v1/memory/resources/type
-         * @description Calls `POST /v1/memory/resources/type` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read` on `memory:resource` (minds:instances:read). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `POST /v1/memory/resources/type` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `query`, `read` on `memory:resource` (minds:instances:read). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         post: operations["minds_engineResourceMemoryPostMemoryResourcesType"];
         delete?: never;
@@ -12768,7 +12788,7 @@ export interface paths {
         put?: never;
         /**
          * resource-memory: POST /v1/memory/resources/usage
-         * @description Calls `POST /v1/memory/resources/usage` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read` on `memory:resource` (minds:instances:read). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `POST /v1/memory/resources/usage` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `query`, `read` on `memory:resource` (minds:instances:read). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         post: operations["minds_engineResourceMemoryPostMemoryResourcesUsage"];
         delete?: never;
@@ -12926,7 +12946,7 @@ export interface paths {
         };
         /**
          * vault: GET /v1/memory/vault/stats
-         * @description Calls `GET /v1/memory/vault/stats` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read` on `memory:vault` (minds:instances:read). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `GET /v1/memory/vault/stats` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `query`, `read` on `memory:vault` (minds:instances:read). Exists only on Minds created with `enable_memory` set; elsewhere the Mind answers 404. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         get: operations["minds_engineVaultGetMemoryVaultStats"];
         put?: never;
@@ -13466,7 +13486,7 @@ export interface paths {
         };
         /**
          * learning-isolation: GET /v1/quarantine/items
-         * @description Calls `GET /v1/quarantine/items` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read` on `_system_quarantine` (minds:instances:read). Registered on every Mind with a storage service (kv, graph, analytics, ml, inference, vector or memory) enabled. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `GET /v1/quarantine/items` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `query`, `read` on `_system_quarantine` (minds:instances:read). Registered on every Mind with a storage service (kv, graph, analytics, ml, inference, vector or memory) enabled. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         get: operations["minds_engineLearningIsolationGetQuarantineItems"];
         put?: never;
@@ -13566,7 +13586,7 @@ export interface paths {
         };
         /**
          * learning-isolation: GET /v1/quarantine/stats
-         * @description Calls `GET /v1/quarantine/stats` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `read` on `_system_quarantine` (minds:instances:read). Registered on every Mind with a storage service (kv, graph, analytics, ml, inference, vector or memory) enabled. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
+         * @description Calls `GET /v1/quarantine/stats` on the selected Sandbox Mind's engine with a capability minted for this request only. Grant: actions `query`, `read` on `_system_quarantine` (minds:instances:read). Registered on every Mind with a storage service (kv, graph, analytics, ml, inference, vector or memory) enabled. Requires a `genesis login` session with a Console Sandbox selection, or an org API key. Org API keys with a Sandbox binding are admitted with `minds:read` (or `minds:write`). Missing scopes answer 403 `SCOPE_MISSING` with required_scope.
          */
         get: operations["minds_engineLearningIsolationGetQuarantineStats"];
         put?: never;
@@ -14942,7 +14962,7 @@ export interface paths {
         };
         /**
          * List your Rigs (desktops)
-         * @description Rigs in the selected organization and project. Needs `rigs:read` (or `rigs:write`). An inventory of 100 or more is refused rather than shown incomplete.
+         * @description Rigs in the selected organization and project. Needs `rigs:read` (or `rigs:write`). Ended Rigs are left out unless `include=ended` is given. Ended means omega-native's set, `cancelled`, `terminated`, `failed` or `succeeded`; `orphaned` counts as active. Omega keeps them for audit. Get-by-id returns an ended Rig either way, with its status. An inventory of 100 or more is refused rather than shown incomplete.
          */
         get: operations["rigs_listRigs"];
         put?: never;
@@ -14998,7 +15018,7 @@ export interface paths {
         put?: never;
         /**
          * Run an action on one Rig
-         * @description The facade's action route with its own body form, `{capability, args}`. Capabilities: `stop`, `restart`, `reinstall_os`, `snapshot`, `resize`, `wipe_state`, `logs`. Needs `rigs:write`. Idempotency-Key is required for every capability except `stop`; a retry with the same key replays instead of acting twice. Until Omega's native executor for a capability ships, the facade answers 503 for it.
+         * @description The facade's action route with its own body form, `{capability, args}`. Capabilities: `stop`, `restart`, `reinstall_os`, `snapshot`, `wipe_state`, `logs`. Needs `rigs:write`. Idempotency-Key is required for every capability except `stop`; a retry with the same key replays instead of acting twice. Until Omega's native executor for a capability ships, the facade answers 503 for it. A Rig's desktop resolution is fixed at create, so there is no `resize`.
          */
         post: operations["rigs_actOnRig"];
         delete?: never;
@@ -15039,7 +15059,7 @@ export interface paths {
         };
         /**
          * List your Panes (browsers)
-         * @description Browser instances in the selected organization and project. Needs `panes:read`.
+         * @description Browser instances in the selected organization and project. Needs `panes:read`. Ended Panes are left out unless `include=ended` is given. Ended means omega-native's set, `cancelled`, `terminated`, `failed` or `succeeded`; `orphaned` counts as active. Omega keeps them for audit. Get-by-id returns an ended Pane either way, with its status.
          */
         get: operations["panes_listPanes"];
         put?: never;
@@ -15161,7 +15181,7 @@ export interface paths {
         };
         /**
          * List your Shells (sandboxes)
-         * @description Sandbox instances in the selected organization and project. Needs `shells:read`.
+         * @description Sandbox instances in the selected organization and project. Needs `shells:read`. Ended Shells are left out unless `include=ended` is given. Ended means omega-native's set, `cancelled`, `terminated`, `failed` or `succeeded`; `orphaned` counts as active. Omega keeps them for audit. Get-by-id returns an ended Shell either way, with its status.
          */
         get: operations["shells_listShells"];
         put?: never;
@@ -23908,10 +23928,12 @@ export interface components {
             /** @description Retired keys that still verify receipts signed before a rotation. Empty when no rotation has happened. */
             retired: components["schemas"]["Foundry.ReceiptVerificationKey"][];
         };
+        /** @description Body for creating or rotating a Sandbox prepaid native key through Genesis (Console key broker, gateway/src/foundry-key-write.ts). The secret is generated by Foundry and returned once; it is never sent by the caller. */
         "Foundry.ApiKeyCreateRequest": {
-            api_key: string;
-            label?: string | null;
-            scopes?: string[];
+            /** @description Display label (UTF-8, at most 120 bytes, no control characters), or null. */
+            label: string | null;
+            /** @description Exactly ["foundry:gateway:invoke:prepaid"]. */
+            scopes: "foundry:gateway:invoke:prepaid"[];
         };
         "Foundry.ProviderKeyRequest": {
             provider_id: string;
@@ -28923,7 +28945,7 @@ export interface components {
             /** @description Years */
             period?: number;
             /**
-             * @description Relays list price for the TLD
+             * @description Relays list price for the TLD, not a registrar quote
              * @constant
              */
             basis?: "list";
@@ -29050,6 +29072,23 @@ export interface components {
             /** @default 30 */
             limit?: number;
         };
+        "Relays.DomSpecials": {
+            specials: {
+                /** @description The TLD without a leading dot, e.g. com */
+                tld: string;
+                /** @description Cheapest current registration price, in cents */
+                latestPriceCents: number;
+                /** @description Mean registration price over the last 24 hours, in cents */
+                trailingMeanCents: number;
+                /** @description Fractional change from the mean; -0.25 is 25% below */
+                deltaPercent: number;
+                currency: string;
+                /** @description A recent pricing note for the TLD, when one exists */
+                narrative?: string;
+            }[];
+            /** @description True when the answer came from the one-minute cache */
+            cached?: boolean;
+        };
         "Relays.DomSuggestResult": {
             suggestions?: {
                 name?: string;
@@ -29065,7 +29104,7 @@ export interface components {
                 cluster?: "literal" | "abstract" | "compound" | "invented" | "category";
                 /** @description Present on the first 20 names when check_availability is true. */
                 availability?: {
-                    /** @description true only when the registrar answered; false means unknown */
+                    /** @description true only when the registrar answered; false means unknown, not taken */
                     checked: boolean;
                     /** @enum {string} */
                     source: "openprovider" | "sample";
@@ -29822,7 +29861,7 @@ export interface components {
             /** @description w_<ulid> */
             id: string;
             organizationId: string;
-            /** @description The project this workspace belongs to */
+            /** @description The project this workspace belongs to, when it has one */
             projectId?: string;
             name: string;
             metadata?: {
@@ -33571,6 +33610,25 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
+        /** @description The 503 answer to a native `snapshot` while Omega has no snapshot executor. */
+        "Rigs.SnapshotUnavailable": {
+            error: {
+                /** @constant */
+                type: "service_unavailable";
+                /** @constant */
+                code: "SNAPSHOT_UNAVAILABLE";
+                /** @constant */
+                reason: "no_omega_executor";
+                /** @description Snapshots are not available for Rigs yet. */
+                message: string;
+                /** @description The gateway request id */
+                request_id?: string;
+                /** Format: uri */
+                docs_url?: string;
+                /** @description The service that refused (rigs) */
+                layer?: string;
+            };
+        };
         "Rigs.ActionResponse": {
             ok: boolean;
             product: string;
@@ -33606,10 +33664,10 @@ export interface components {
              */
             environment?: "xfce" | "kde" | "windows" | "macos";
             /**
-             * @description Default 1920x1080
+             * @description Optional. A Rig's desktop is a fixed 1920x1080 display; any other value is refused (400).
              * @enum {string}
              */
-            resolution?: "1366x768" | "1440x900" | "1920x1080" | "2560x1440";
+            resolution?: "1920x1080";
             /**
              * @description Default persistent
              * @enum {string}
@@ -33662,6 +33720,25 @@ export interface components {
                 bridge?: boolean;
             };
         };
+        /** @description The 503 answer to a native `snapshot` while Omega has no snapshot executor. */
+        "Panes.SnapshotUnavailable": {
+            error: {
+                /** @constant */
+                type: "service_unavailable";
+                /** @constant */
+                code: "SNAPSHOT_UNAVAILABLE";
+                /** @constant */
+                reason: "no_omega_executor";
+                /** @description Snapshots are not available for Panes yet. */
+                message: string;
+                /** @description The gateway request id */
+                request_id?: string;
+                /** Format: uri */
+                docs_url?: string;
+                /** @description The service that refused (panes) */
+                layer?: string;
+            };
+        };
         "Panes.ActionResponse": {
             ok: boolean;
             product: string;
@@ -33689,14 +33766,24 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
-        /** @description Launch options; the Panes facade validates them. */
+        /** @description Launch options; the Panes facade validates them. A native Pane opens about:blank at 780x437 in headless Chromium; any other url, viewport or headless value is refused with 422 OMEGA_NATIVE_UNSUPPORTED_PROFILE. Set the viewport after create with the resize action. */
         "Panes.PaneLaunch": {
             name?: string;
-            /** @description The first page to open (default about:blank) */
-            url?: string;
-            /** @description WIDTHxHEIGHT, e.g. 1280x800 */
-            viewport?: string;
-            headless?: boolean;
+            /**
+             * @description Native Panes open on about:blank. Any other value is refused with 422 OMEGA_NATIVE_UNSUPPORTED_PROFILE; omit it.
+             * @constant
+             */
+            url?: "about:blank";
+            /**
+             * @description Native Panes open at 780x437. Any other value is refused with 422 OMEGA_NATIVE_UNSUPPORTED_PROFILE; omit it and set the viewport after create with the resize action.
+             * @constant
+             */
+            viewport?: "780x437";
+            /**
+             * @description Native Panes run headless Chromium. false is refused with 422 OMEGA_NATIVE_UNSUPPORTED_PROFILE; omit it.
+             * @constant
+             */
+            headless?: true;
         } & {
             [key: string]: unknown;
         };
@@ -33715,9 +33802,27 @@ export interface components {
             runtime?: string | null;
             createdAt?: string | null;
             updatedAt?: string | null;
+            /** @description Panes: the page the browser opened (about:blank); present on the create response */
+            url?: string;
+            /** @description Panes: WIDTHxHEIGHT (780x437 at create); present on the create response */
+            viewport?: string;
+            /**
+             * @description Panes: native Panes run headless; present on the create response
+             * @constant
+             */
+            headless?: true;
         } & {
             [key: string]: unknown;
         };
+        "Panes.UnsupportedProfileError": {
+            error: {
+                /** @constant */
+                code: "OMEGA_NATIVE_UNSUPPORTED_PROFILE";
+                /** @description The refused launch field: url, viewport or headless */
+                field: string;
+                message: string;
+            };
+        };
         "Panes.PanesList": {
             /** @constant */
             product: "panes";
@@ -33752,6 +33857,25 @@ export interface components {
         } & {
             [key: string]: unknown;
         };
+        /** @description The 503 answer to a native `snapshot` while Omega has no snapshot executor. */
+        "Shells.SnapshotUnavailable": {
+            error: {
+                /** @constant */
+                type: "service_unavailable";
+                /** @constant */
+                code: "SNAPSHOT_UNAVAILABLE";
+                /** @constant */
+                reason: "no_omega_executor";
+                /** @description Snapshots are not available for Shells yet. */
+                message: string;
+                /** @description The gateway request id */
+                request_id?: string;
+                /** Format: uri */
+                docs_url?: string;
+                /** @description The service that refused (shells) */
+                layer?: string;
+            };
+        };
         "Shells.ActionResponse": {
             ok: boolean;
             product: string;
@@ -33782,7 +33906,7 @@ export interface components {
         "Shells.ExecRequest": {
             /** @description The command and its arguments, no shell; at most 32 KiB in total; argv[0] non-empty */
             argv: string[];
-            /** @description Canonical base64 */
+            /** @description Canonical base64, at most 48128 bytes decoded */
             stdin?: string;
             /** @default 30000 */
             timeoutMs?: number;
@@ -35372,7 +35496,7 @@ export interface components {
             seq?: number;
             project_id: string;
             number: number;
-            /** @description Project key and number */
+            /** @description Project key and number, e.g. ENG-12 */
             identifier: string;
             title: string;
             description: string | null;
@@ -35477,11 +35601,11 @@ export interface components {
             kind?: components["schemas"]["Scopes.DependencyKind"];
         };
         "Scopes.TaskDependencies": {
-            /** @description Edges whose other task blocks this one */
+            /** @description Edges whose other task blocks this one, each with the other task's summary */
             blocked_by: components["schemas"]["Scopes.Dependency"][];
-            /** @description Edges whose other task this one blocks */
+            /** @description Edges whose other task this one blocks, each with the other task's summary */
             blocks: components["schemas"]["Scopes.Dependency"][];
-            /** @description relates and duplicates edges */
+            /** @description relates and duplicates edges, each with the other task's summary */
             related: components["schemas"]["Scopes.Dependency"][];
         };
         "Scopes.Graph": {
@@ -36243,6 +36367,10 @@ export interface components {
             name: string;
             address: components["schemas"]["Orgs.Address"];
             email?: components["schemas"]["Orgs.Email"];
+            /** @description The state's id for the agent (for example from WyoBiz's agent search) */
+            agent_id?: string;
+            /** @description An `agent_consent` document on this entity: the agent's signed, dated consent to appointment. Only settable with PUT …/registered-agent (refused at entity creation). A formation run attests that consent was obtained only when it is on file. */
+            consent_document_id?: string;
         };
         "Orgs.Entity": {
             id: string;
@@ -36363,7 +36491,7 @@ export interface components {
             note?: string;
         };
         /** @enum {string} */
-        "Orgs.DocumentKind": "articles" | "certificate" | "operating_agreement" | "bylaws" | "resolution" | "filing_receipt" | "evidence" | "tax_letter" | "other";
+        "Orgs.DocumentKind": "agent_consent" | "articles" | "certificate" | "operating_agreement" | "bylaws" | "resolution" | "filing_receipt" | "evidence" | "tax_letter" | "other";
         "Orgs.Signature": {
             seat_id: string;
             principal: string;
@@ -36395,7 +36523,7 @@ export interface components {
         };
         "Orgs.AddDocumentRequest": {
             /** @enum {string} */
-            kind: "articles" | "certificate" | "operating_agreement" | "bylaws" | "resolution" | "filing_receipt" | "tax_letter" | "other";
+            kind: "agent_consent" | "articles" | "certificate" | "operating_agreement" | "bylaws" | "resolution" | "filing_receipt" | "tax_letter" | "other";
             title: string;
             /** @enum {string} */
             media_type: "application/pdf" | "image/png" | "image/jpeg" | "text/plain" | "text/markdown" | "application/json";
@@ -36438,7 +36566,7 @@ export interface components {
             due_on?: string | null;
             /** @description Up to 64 KiB of JSON */
             packet?: Record<string, never>;
-            /** @description The state's receipt */
+            /** @description The state's receipt, up to 16 KiB of JSON */
             receipt?: Record<string, never>;
         };
         "Orgs.FormationRequest": {
@@ -39753,7 +39881,7 @@ export interface components {
         };
     };
     parameters: {
-        /** @description Zone name */
+        /** @description Zone name, e.g. example.com */
         "Relays.Zone": string;
         "Relays.CertId": string;
         "Relays.MonitorId": string;
@@ -39801,14 +39929,20 @@ export interface components {
         /** @description Nonzero lowercase record UUID returned by create or list. */
         "Beacons.DashboardResourceId": string;
         "Runner.JobId": components["schemas"]["Runner.SafeOpaqueRef"];
+        /** @description `ended` also lists ended Rigs (`cancelled`, `terminated`, `failed` or `succeeded`; `orphaned` counts as active). Omit it to list live Rigs only. */
+        "Rigs.IncludeEnded": "ended";
         /** @description Required. A stable key for this one create. The gateway derives the operation key from it (with your organization, principal, method and path); reuse the same key to retry and the original result is replayed instead of creating twice. */
         "Rigs.IdempotencyKeyRequired": string;
         /** @description Optional. With it the stop is one journaled operation; a retry with the same key replays it. */
         "Rigs.IdempotencyKeyOptional": string;
+        /** @description `ended` also lists ended Panes (`cancelled`, `terminated`, `failed` or `succeeded`; `orphaned` counts as active). Omit it to list live Panes only. */
+        "Panes.IncludeEnded": "ended";
         /** @description Required. A stable key for this one create. The gateway derives the operation key from it (with your organization, principal, method and path); reuse the same key to retry and the original result is replayed instead of creating twice. */
         "Panes.IdempotencyKeyRequired": string;
         /** @description Optional. With it the stop is one journaled operation; a retry with the same key replays it. */
         "Panes.IdempotencyKeyOptional": string;
+        /** @description `ended` also lists ended Shells (`cancelled`, `terminated`, `failed` or `succeeded`; `orphaned` counts as active). Omit it to list live Shells only. */
+        "Shells.IncludeEnded": "ended";
         /** @description Required. A stable key for this one create. The gateway derives the operation key from it (with your organization, principal, method and path); reuse the same key to retry and the original result is replayed instead of creating twice. */
         "Shells.IdempotencyKeyRequired": string;
         /** @description Optional. With it the stop is one journaled operation; a retry with the same key replays it. */
@@ -42394,7 +42528,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Foundry.ApiKeyCreateRequest"];
+            };
+        };
         responses: {
             /** @description Successful response. */
             200: {
@@ -49152,7 +49290,7 @@ export interface operations {
                     "application/json": components["schemas"]["Hives.QueueSendOperation"];
                 };
             };
-            /** @description Missing or wrong owner */
+            /** @description Missing or wrong owner, actor, binding or queue */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -53610,7 +53748,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -53634,7 +53772,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -53660,7 +53798,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -53691,7 +53829,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -53718,7 +53856,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -53755,7 +53893,7 @@ export interface operations {
             };
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -53779,7 +53917,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -53814,7 +53952,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
                 recordId: number;
             };
@@ -53841,7 +53979,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
                 recordId: number;
             };
@@ -53868,7 +54006,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
                 recordId: number;
             };
@@ -53902,7 +54040,7 @@ export interface operations {
                 limit?: number;
                 status?: "pending" | "validating" | "issued" | "expired" | "revoked" | "failed";
                 cert_type?: "single" | "wildcard" | "multi";
-                /** @description Substring of the common name */
+                /** @description Substring of the common name, or an exact SAN */
                 search?: string;
                 /** @description Issued certificates expiring within this many days */
                 expiring_within_days?: number;
@@ -56228,7 +56366,7 @@ export interface operations {
     relays_searchRegistrarDomains: {
         parameters: {
             query: {
-                /** @description Name to search */
+                /** @description Name to search, at least 2 characters; the part before the first dot is used */
                 q: string;
                 /** @description Up to 10 comma-separated TLDs, default com,net,org,io,dev,ai,co,app */
                 tlds?: string;
@@ -56378,10 +56516,33 @@ export interface operations {
             500: components["responses"]["Relays.Error"];
         };
     };
+    relays_listDomainSpecials: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Current specials */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Relays.DomSpecials"];
+                };
+            };
+            401: components["responses"]["Relays.Error"];
+            403: components["responses"]["Relays.Error"];
+            500: components["responses"]["Relays.Error"];
+        };
+    };
     relays_listDomainForwardingRules: {
         parameters: {
             query: {
-                /** @description Hostname */
+                /** @description Hostname, e.g. example.com */
                 domain: string;
             };
             header?: never;
@@ -56573,7 +56734,7 @@ export interface operations {
                     "application/json": components["schemas"]["Relays.DnsProvConnectionEnvelope"];
                 };
             };
-            /** @description Invalid body */
+            /** @description Invalid body, unknown provider, unsupported auth model, an API endpoint off the provider's hosts, or duplicate label */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -56937,7 +57098,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -56964,7 +57125,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -57021,7 +57182,7 @@ export interface operations {
             };
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -57048,7 +57209,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -57081,7 +57242,7 @@ export interface operations {
             query?: never;
             header?: never;
             path: {
-                /** @description Zone name */
+                /** @description Zone name, e.g. example.com */
                 zone: components["parameters"]["Relays.Zone"];
             };
             cookie?: never;
@@ -57489,7 +57650,7 @@ export interface operations {
                 content?: never;
             };
             404: components["responses"]["Iam.NotFound"];
-            /** @description Workspaces */
+            /** @description Workspaces, fleets or grants still reference the project */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -81241,7 +81402,10 @@ export interface operations {
     };
     rigs_listRigs: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description `ended` also lists ended Rigs (`cancelled`, `terminated`, `failed` or `succeeded`; `orphaned` counts as active). Omit it to list live Rigs only. */
+                include?: components["parameters"]["Rigs.IncludeEnded"];
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -81264,6 +81428,13 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description Any query other than `include=ended` */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             /** @description RIGS_CONTEXT_CHANGED (selection changed during the read) */
             409: {
                 headers: {
@@ -81312,7 +81483,7 @@ export interface operations {
                     "application/json": components["schemas"]["Rigs.RigResponse"];
                 };
             };
-            /** @description RIGS_IDEMPOTENCY_KEY_REQUIRED, RIGS_INVALID_IDEMPOTENCY_KEY, RIGS_INVALID_REQUEST (not one JSON object), or RIGS_CREATE_REFUSED (the facade refused the launch input) */
+            /** @description RIGS_IDEMPOTENCY_KEY_REQUIRED, RIGS_INVALID_IDEMPOTENCY_KEY, RIGS_INVALID_REQUEST (not one JSON object), or RIGS_CREATE_REFUSED (the facade refused the launch input, for example a resolution other than 1920x1080) */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -81506,7 +81677,7 @@ export interface operations {
             content: {
                 "application/json": {
                     /** @enum {string} */
-                    capability: "stop" | "restart" | "reinstall_os" | "snapshot" | "resize" | "wipe_state" | "logs";
+                    capability: "stop" | "restart" | "reinstall_os" | "snapshot" | "wipe_state" | "logs";
                     /** @description Capability arguments (default an empty object) */
                     args?: {
                         [key: string]: unknown;
@@ -81531,7 +81702,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the write scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -81559,12 +81730,14 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description The native executor is not available yet, or the facade is unavailable; retry with the same key */
+            /** @description A native `snapshot` is `SNAPSHOT_UNAVAILABLE` (reason `no_omega_executor`): Omega has no snapshot executor yet, so the facade refuses it before contacting Omega. Nothing is billed or journaled, and a retry gets the same answer. Any other 503 means the native executor for the capability is not available yet or the facade is unavailable; retry with the same key. */
             503: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["Rigs.SnapshotUnavailable"];
+                };
             };
         };
     };
@@ -81596,7 +81769,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the write scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -81610,7 +81783,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description The native stream transport is not bound yet */
+            /** @description The native stream transport is not bound yet, or the facade is unavailable */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -81621,7 +81794,10 @@ export interface operations {
     };
     panes_listPanes: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description `ended` also lists ended Panes (`cancelled`, `terminated`, `failed` or `succeeded`; `orphaned` counts as active). Omit it to list live Panes only. */
+                include?: components["parameters"]["Panes.IncludeEnded"];
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -81644,6 +81820,13 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description Any query other than `include=ended` */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             /** @description Panes private admission unavailable */
             503: {
                 headers: {
@@ -81699,6 +81882,15 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description OMEGA_NATIVE_UNSUPPORTED_PROFILE: a launch value native Panes cannot run (a url other than about:blank, a viewport other than 780x437, or headless false). `field` names it. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Panes.UnsupportedProfileError"];
+                };
+            };
             /** @description Panes unavailable; the create may or may not have started; retry with the same key */
             503: {
                 headers: {
@@ -81736,7 +81928,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the read scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -81799,7 +81991,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the write scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -81854,7 +82046,7 @@ export interface operations {
                 "application/json": {
                     /** @enum {string} */
                     capability: "stop" | "restart" | "snapshot" | "resize" | "clear_profile" | "screenshot" | "logs" | "devtools";
-                    /** @description Capability arguments (default an empty object) */
+                    /** @description Capability arguments (default an empty object). resize takes integer width 320-3840 and height 240-2160, as {width, height} or {viewport: "WxH"}; out-of-range values get 400. */
                     args?: {
                         [key: string]: unknown;
                     };
@@ -81878,7 +82070,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the write scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -81906,12 +82098,14 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description The native executor is not available yet, or the facade is unavailable; retry with the same key */
+            /** @description A native `snapshot` is `SNAPSHOT_UNAVAILABLE` (reason `no_omega_executor`): Omega has no snapshot executor yet, so the facade refuses it before contacting Omega. Nothing is billed or journaled, and a retry gets the same answer. Any other 503 means the native executor for the capability is not available yet or the facade is unavailable; retry with the same key. */
             503: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["Panes.SnapshotUnavailable"];
+                };
             };
         };
     };
@@ -81943,7 +82137,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the write scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -81957,7 +82151,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description The native stream transport is not bound yet */
+            /** @description The native stream transport is not bound yet, or the facade is unavailable */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -81997,7 +82191,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the read scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -82011,7 +82205,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description The native artifact store is not available yet */
+            /** @description The native artifact store is not available yet, or the facade is unavailable */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -82022,7 +82216,10 @@ export interface operations {
     };
     shells_listShells: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description `ended` also lists ended Shells (`cancelled`, `terminated`, `failed` or `succeeded`; `orphaned` counts as active). Omit it to list live Shells only. */
+                include?: components["parameters"]["Shells.IncludeEnded"];
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -82045,6 +82242,13 @@ export interface operations {
                 };
                 content?: never;
             };
+            /** @description Any query other than `include=ended` */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             /** @description Shells private admission unavailable */
             503: {
                 headers: {
@@ -82137,7 +82341,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the read scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -82191,7 +82395,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the write scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -82263,7 +82467,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the write scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -82291,12 +82495,14 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description The native executor is not available yet, or the facade is unavailable; retry with the same key */
+            /** @description A native `snapshot` is `SNAPSHOT_UNAVAILABLE` (reason `no_omega_executor`): Omega has no snapshot executor yet, so the facade refuses it before contacting Omega. Nothing is billed or journaled, and a retry gets the same answer. Any other 503 means the native executor for the capability is not available yet or the facade is unavailable; retry with the same key. */
             503: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["Shells.SnapshotUnavailable"];
+                };
             };
         };
     };
@@ -82328,7 +82534,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the write scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -82342,7 +82548,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description The native stream transport is not bound yet */
+            /** @description The native stream transport is not bound yet, or the facade is unavailable */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -82386,7 +82592,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Signed organization and project selection */
+            /** @description Signed organization and project selection, or the write scope, required */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -82854,7 +83060,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Run is already terminal */
+            /** @description Run is already terminal, or a wait_for_completion child is still running */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -83063,7 +83269,7 @@ export interface operations {
                     "application/json": Record<string, never>;
                 };
             };
-            /** @description Invalid body */
+            /** @description Invalid body, attempt, or not exactly one of outputRef and errorRef */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -83202,7 +83408,7 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description The Flowers runtime could not spawn the child; the child run is recorded as Failed */
+            /** @description The Flowers runtime could not spawn the child; the child run is recorded as Failed, never left Running */
             502: {
                 headers: {
                     [name: string]: unknown;
@@ -90382,7 +90588,7 @@ export interface operations {
                     "application/json": components["schemas"]["Taps.TapList"];
                 };
             };
-            /** @description Unknown status */
+            /** @description Unknown status, unknown or repeated query key */
             422: {
                 headers: {
                     [name: string]: unknown;