@onesi/genesis 0.2.2 → 0.2.3

package/README.md

@@ -3,7 +3,7 @@
 The TypeScript SDK for OneOS. One typed client for every Genesis service, through the Genesis API at `https://os.one.ml/api`.
 
 ```sh
-npm install @onesi/genesis@0.2.2
+npm install @onesi/genesis@0.2.3
 ```
 
 ```ts

package/dist/client.js

@@ -189,7 +189,7 @@ export class GenesisClient {
         const url = this.url(operationId, input);
         const headers = {
             accept: 'application/json',
-            'user-agent': this.opts.userAgent ?? '@onesi/genesis/0.2.2',
+            'user-agent': this.opts.userAgent ?? '@onesi/genesis/0.2.3',
             ...this.opts.headers, ...init.headers,
         };
         if (op.service === 'blinds' && !['GET', 'HEAD', 'OPTIONS'].includes(op.method))

package/dist/generated/operations.js

@@ -2345,7 +2345,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/files"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -2368,7 +2368,7 @@ export const operationTable = {
             "method": "POST",
             "path": "/v1/files"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -2407,7 +2407,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/files/{file_id}"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -2439,7 +2439,7 @@ export const operationTable = {
             "method": "DELETE",
             "path": "/v1/files/{file_id}"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -2471,7 +2471,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/files/{file_id}/content"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -2503,7 +2503,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/fine_tuning/providers"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -2526,7 +2526,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/fine_tuning/jobs"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -2549,7 +2549,7 @@ export const operationTable = {
             "method": "POST",
             "path": "/v1/fine_tuning/jobs"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -2663,7 +2663,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/fine_tuning/jobs/{job_id}"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -2695,7 +2695,7 @@ export const operationTable = {
             "method": "DELETE",
             "path": "/v1/fine_tuning/jobs/{job_id}"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -2727,7 +2727,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/fine_tuning/jobs/{job_id}/events"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -2759,7 +2759,7 @@ export const operationTable = {
             "method": "POST",
             "path": "/v1/fine_tuning/jobs/{job_id}/cancel"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -2791,7 +2791,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/fine_tuning/jobs/{job_id}/checkpoints"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -2823,7 +2823,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/fine_tuning/models"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -2846,7 +2846,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/fine_tuning/models/{model_id}"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -2878,7 +2878,7 @@ export const operationTable = {
             "method": "POST",
             "path": "/api/beta/batches"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -2932,7 +2932,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/api/beta/batches/{batch_id}"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -3081,7 +3081,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/api/v1/activity"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -3104,7 +3104,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/api/v1/activity/export"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -3135,7 +3135,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/api/v1/analytics/meta"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -4398,24 +4398,30 @@ export const operationTable = {
                 "body": {
                     "type": "object",
                     "required": [
-                        "api_key"
+                        "label",
+                        "scopes"
                     ],
+                    "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.",
                     "properties": {
-                        "api_key": {
-                            "type": "string",
-                            "writeOnly": true
-                        },
                         "label": {
                             "type": [
                                 "string",
                                 "null"
-                            ]
+                            ],
+                            "maxLength": 120,
+                            "description": "Display label (UTF-8, at most 120 bytes, no control characters), or null."
                         },
                         "scopes": {
                             "type": "array",
+                            "minItems": 1,
+                            "maxItems": 1,
                             "items": {
-                                "type": "string"
-                            }
+                                "type": "string",
+                                "enum": [
+                                    "foundry:gateway:invoke:prepaid"
+                                ]
+                            },
+                            "description": "Exactly [\"foundry:gateway:invoke:prepaid\"]."
                         }
                     },
                     "additionalProperties": false
@@ -4477,7 +4483,8 @@ export const operationTable = {
             "key_id"
         ],
         "queryParams": [],
-        "hasBody": false,
+        "hasBody": true,
+        "requestContentType": "application/json",
         "idempotencyKey": "required",
         "inputSchema": {
             "type": "object",
@@ -4485,10 +4492,42 @@ export const operationTable = {
                 "key_id": {
                     "type": "string",
                     "minLength": 1
+                },
+                "body": {
+                    "type": "object",
+                    "required": [
+                        "label",
+                        "scopes"
+                    ],
+                    "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.",
+                    "properties": {
+                        "label": {
+                            "type": [
+                                "string",
+                                "null"
+                            ],
+                            "maxLength": 120,
+                            "description": "Display label (UTF-8, at most 120 bytes, no control characters), or null."
+                        },
+                        "scopes": {
+                            "type": "array",
+                            "minItems": 1,
+                            "maxItems": 1,
+                            "items": {
+                                "type": "string",
+                                "enum": [
+                                    "foundry:gateway:invoke:prepaid"
+                                ]
+                            },
+                            "description": "Exactly [\"foundry:gateway:invoke:prepaid\"]."
+                        }
+                    },
+                    "additionalProperties": false
                 }
             },
             "required": [
-                "key_id"
+                "key_id",
+                "body"
             ],
             "additionalProperties": false
         }
@@ -4526,7 +4565,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/provider-keys"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -4549,7 +4588,7 @@ export const operationTable = {
             "method": "POST",
             "path": "/v1/provider-keys"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -4599,7 +4638,7 @@ export const operationTable = {
             "method": "DELETE",
             "path": "/v1/provider-keys/{provider_id}"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -4631,7 +4670,7 @@ export const operationTable = {
             "method": "PATCH",
             "path": "/v1/provider-keys/{provider_id}"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [
@@ -4677,7 +4716,7 @@ export const operationTable = {
             "method": "GET",
             "path": "/v1/provider-credential-policies"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [],
@@ -4700,7 +4739,7 @@ export const operationTable = {
             "method": "PUT",
             "path": "/v1/provider-credential-policies/{provider_id}"
         },
-        "mcp": false,
+        "mcp": true,
         "internal": false,
         "public": false,
         "pathParams": [

package/dist/generated/schema.d.ts

@@ -23928,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;
@@ -33608,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;
@@ -33699,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;
@@ -33817,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;
@@ -42469,7 +42528,11 @@ export interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["Foundry.ApiKeyCreateRequest"];
+            };
+        };
         responses: {
             /** @description Successful response. */
             200: {
@@ -81667,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"];
+                };
             };
         };
     };
@@ -82033,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"];
+                };
             };
         };
     };
@@ -82428,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"];
+                };
             };
         };
     };

package/dist/genesis.openapi.json

@@ -1985,7 +1985,7 @@
           "path": "/v1/files",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       },
       "post": {
         "operationId": "foundry_uploadFile",
@@ -2037,7 +2037,7 @@
           "path": "/v1/files",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/files/{file_id}": {
@@ -2083,7 +2083,7 @@
           "path": "/v1/files/{file_id}",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       },
       "delete": {
         "operationId": "foundry_deleteFile",
@@ -2127,7 +2127,7 @@
           "path": "/v1/files/{file_id}",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/files/{file_id}/content": {
@@ -2174,7 +2174,7 @@
           "path": "/v1/files/{file_id}/content",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/fine_tuning/providers": {
@@ -2209,7 +2209,7 @@
           "path": "/v1/fine_tuning/providers",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/fine_tuning/jobs": {
@@ -2264,7 +2264,7 @@
           "path": "/v1/fine_tuning/jobs",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       },
       "get": {
         "operationId": "foundry_listFineTuningJobs",
@@ -2297,7 +2297,7 @@
           "path": "/v1/fine_tuning/jobs",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/fine_tuning/jobs/{job_id}": {
@@ -2343,7 +2343,7 @@
           "path": "/v1/fine_tuning/jobs/{job_id}",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       },
       "delete": {
         "operationId": "foundry_deleteFineTuningJob",
@@ -2387,7 +2387,7 @@
           "path": "/v1/fine_tuning/jobs/{job_id}",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/fine_tuning/jobs/{job_id}/events": {
@@ -2433,7 +2433,7 @@
           "path": "/v1/fine_tuning/jobs/{job_id}/events",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/fine_tuning/jobs/{job_id}/cancel": {
@@ -2479,7 +2479,7 @@
           "path": "/v1/fine_tuning/jobs/{job_id}/cancel",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/fine_tuning/jobs/{job_id}/checkpoints": {
@@ -2525,7 +2525,7 @@
           "path": "/v1/fine_tuning/jobs/{job_id}/checkpoints",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/fine_tuning/models": {
@@ -2560,7 +2560,7 @@
           "path": "/v1/fine_tuning/models",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/fine_tuning/models/{model_id}": {
@@ -2606,7 +2606,7 @@
           "path": "/v1/fine_tuning/models/{model_id}",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/batches": {
@@ -2652,7 +2652,7 @@
           "path": "/api/beta/batches",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/batches/{batch_id}": {
@@ -2699,7 +2699,7 @@
           "path": "/api/beta/batches/{batch_id}",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/generation": {
@@ -2873,7 +2873,7 @@
           "path": "/api/v1/activity",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/activity/export": {
@@ -2919,7 +2919,7 @@
           "path": "/api/v1/activity/export",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/analytics/meta": {
@@ -2955,7 +2955,7 @@
           "path": "/api/v1/analytics/meta",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/analytics/query": {
@@ -4902,6 +4902,16 @@
             }
           }
         ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Foundry.ApiKeyCreateRequest"
+              }
+            }
+          }
+        },
         "x-genesis-service": "foundry",
         "x-upstream": {
           "base": "https://api.fdy.sh",
@@ -4980,7 +4990,7 @@
           "path": "/v1/provider-keys",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       },
       "post": {
         "operationId": "foundry_createProviderKey",
@@ -5023,7 +5033,7 @@
           "path": "/v1/provider-keys",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/provider-keys/{provider_id}": {
@@ -5079,7 +5089,7 @@
           "path": "/v1/provider-keys/{provider_id}",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       },
       "delete": {
         "operationId": "foundry_deleteProviderKey",
@@ -5123,7 +5133,7 @@
           "path": "/v1/provider-keys/{provider_id}",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/provider-credential-policies": {
@@ -5158,7 +5168,7 @@
           "path": "/v1/provider-credential-policies",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/provider-credential-policies/{provider_id}": {
@@ -5214,7 +5224,7 @@
           "path": "/v1/provider-credential-policies/{provider_id}",
           "status": "live"
         },
-        "x-mcp": false
+        "x-mcp": true
       }
     },
     "/v1/foundry/billing/profile": {
@@ -64496,7 +64506,14 @@
             "description": "The capability has no server-side executor"
           },
           "503": {
-            "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.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Rigs.SnapshotUnavailable"
+                }
+              }
+            }
           }
         },
         "tags": [
@@ -64873,7 +64890,14 @@
             "description": "The capability has no server-side executor"
           },
           "503": {
-            "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.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Panes.SnapshotUnavailable"
+                }
+              }
+            }
           }
         },
         "tags": [
@@ -65297,7 +65321,14 @@
             "description": "The capability has no server-side executor"
           },
           "503": {
-            "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.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Shells.SnapshotUnavailable"
+                }
+              }
+            }
           }
         },
         "tags": [
@@ -97719,24 +97750,30 @@
       "Foundry.ApiKeyCreateRequest": {
         "type": "object",
         "required": [
-          "api_key"
+          "label",
+          "scopes"
         ],
+        "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.",
         "properties": {
-          "api_key": {
-            "type": "string",
-            "writeOnly": true
-          },
           "label": {
             "type": [
               "string",
               "null"
-            ]
+            ],
+            "maxLength": 120,
+            "description": "Display label (UTF-8, at most 120 bytes, no control characters), or null."
           },
           "scopes": {
             "type": "array",
+            "minItems": 1,
+            "maxItems": 1,
             "items": {
-              "type": "string"
-            }
+              "type": "string",
+              "enum": [
+                "foundry:gateway:invoke:prepaid"
+              ]
+            },
+            "description": "Exactly [\"foundry:gateway:invoke:prepaid\"]."
           }
         },
         "additionalProperties": false
@@ -129185,6 +129222,54 @@
           }
         }
       },
+      "Rigs.SnapshotUnavailable": {
+        "type": "object",
+        "description": "The 503 answer to a native `snapshot` while Omega has no snapshot executor.",
+        "required": [
+          "error"
+        ],
+        "properties": {
+          "error": {
+            "type": "object",
+            "required": [
+              "type",
+              "code",
+              "reason",
+              "message"
+            ],
+            "properties": {
+              "type": {
+                "type": "string",
+                "const": "service_unavailable"
+              },
+              "code": {
+                "type": "string",
+                "const": "SNAPSHOT_UNAVAILABLE"
+              },
+              "reason": {
+                "type": "string",
+                "const": "no_omega_executor"
+              },
+              "message": {
+                "type": "string",
+                "description": "Snapshots are not available for Rigs yet."
+              },
+              "request_id": {
+                "type": "string",
+                "description": "The gateway request id"
+              },
+              "docs_url": {
+                "type": "string",
+                "format": "uri"
+              },
+              "layer": {
+                "type": "string",
+                "description": "The service that refused (rigs)"
+              }
+            }
+          }
+        }
+      },
       "Rigs.ActionResponse": {
         "type": "object",
         "required": [
@@ -129448,6 +129533,54 @@
           }
         }
       },
+      "Panes.SnapshotUnavailable": {
+        "type": "object",
+        "description": "The 503 answer to a native `snapshot` while Omega has no snapshot executor.",
+        "required": [
+          "error"
+        ],
+        "properties": {
+          "error": {
+            "type": "object",
+            "required": [
+              "type",
+              "code",
+              "reason",
+              "message"
+            ],
+            "properties": {
+              "type": {
+                "type": "string",
+                "const": "service_unavailable"
+              },
+              "code": {
+                "type": "string",
+                "const": "SNAPSHOT_UNAVAILABLE"
+              },
+              "reason": {
+                "type": "string",
+                "const": "no_omega_executor"
+              },
+              "message": {
+                "type": "string",
+                "description": "Snapshots are not available for Panes yet."
+              },
+              "request_id": {
+                "type": "string",
+                "description": "The gateway request id"
+              },
+              "docs_url": {
+                "type": "string",
+                "format": "uri"
+              },
+              "layer": {
+                "type": "string",
+                "description": "The service that refused (panes)"
+              }
+            }
+          }
+        }
+      },
       "Panes.ActionResponse": {
         "type": "object",
         "required": [
@@ -129737,6 +129870,54 @@
           }
         }
       },
+      "Shells.SnapshotUnavailable": {
+        "type": "object",
+        "description": "The 503 answer to a native `snapshot` while Omega has no snapshot executor.",
+        "required": [
+          "error"
+        ],
+        "properties": {
+          "error": {
+            "type": "object",
+            "required": [
+              "type",
+              "code",
+              "reason",
+              "message"
+            ],
+            "properties": {
+              "type": {
+                "type": "string",
+                "const": "service_unavailable"
+              },
+              "code": {
+                "type": "string",
+                "const": "SNAPSHOT_UNAVAILABLE"
+              },
+              "reason": {
+                "type": "string",
+                "const": "no_omega_executor"
+              },
+              "message": {
+                "type": "string",
+                "description": "Snapshots are not available for Shells yet."
+              },
+              "request_id": {
+                "type": "string",
+                "description": "The gateway request id"
+              },
+              "docs_url": {
+                "type": "string",
+                "format": "uri"
+              },
+              "layer": {
+                "type": "string",
+                "description": "The service that refused (shells)"
+              }
+            }
+          }
+        }
+      },
       "Shells.ActionResponse": {
         "type": "object",
         "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onesi/genesis",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/l1felabs/genesis-api.git",