@zocomputer/system-api 0.1.1 → 0.1.2

package/dist/generated/operations.d.ts

@@ -105,6 +105,10 @@ export interface ZoAgentCancelOutputV1 {
 export interface ZoAgentCreateInputV1 {
     workspace_id: string;
     display_name: string;
+    /**
+     * Describe what this Agent is for in the user's terms.
+     */
+    description?: string;
     visibility?: ("workspace" | "protected");
     implementation: "zo.native";
     configuration: ZoAgentCreateInputV1NativeConfiguration;
@@ -139,6 +143,7 @@ export interface ZoAgentCreateOutputV1 {
     type: "agent";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     implementation: "zo.native";
     configuration: ZoAgentCreateOutputV1NativeConfiguration;
@@ -222,6 +227,7 @@ export interface ZoAgentGetOutputV1 {
     type: "agent";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     implementation: "zo.native";
     configuration: ZoAgentGetOutputV1NativeConfiguration;
@@ -301,6 +307,7 @@ export interface ZoAgentListOutputV1Agent {
     type: "agent";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     implementation: "zo.native";
     configuration: ZoAgentListOutputV1NativeConfiguration;
@@ -526,6 +533,10 @@ export interface ZoAgentUpdateInputV1 {
     agent_id: string;
     expected_revision: number;
     display_name?: (string | null);
+    /**
+     * Describe what this Agent is for in the user's terms.
+     */
+    description?: (string | null);
     configuration?: (ZoAgentUpdateInputV1NativeConfiguration | null);
 }
 /**
@@ -558,6 +569,7 @@ export interface ZoAgentUpdateOutputV1 {
     type: "agent";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     implementation: "zo.native";
     configuration: ZoAgentUpdateOutputV1NativeConfiguration;
@@ -789,18 +801,47 @@ export interface ZoConnectionAuthorizeOutputV1KeyAttached {
 }
 export interface ZoConnectionCreateInputV1 {
     workspace_id: string;
-    definition_id: string;
-    definition_version: number;
+    /**
+     * The published definition to connect to. Give it, or `values`, not both.
+     */
+    definition_id?: (string | null);
+    /**
+     * The version of `definition_id` to connect to; required with it.
+     */
+    definition_version?: (number | null);
     display_name: string;
-    configuration: {
+    /**
+     * Describe what this connection is for in the user's terms.
+     */
+    description?: string;
+    /**
+     * The connection's configuration; required with `definition_id`.
+     */
+    configuration?: ({
         [k: string]: JsonValue;
-    };
+    } | null);
     visibility?: ("workspace" | "protected");
+    /**
+     * Named values to store, in place of a definition: Zo publishes a private definition named after `display_name`, with one required key credential per name delivered as the environment variable of that name, creates the connection and stores every value. A definition name already taken in the workspace returns `conflict`. A name Zo refuses as an environment variable returns `invalid_input` with the `invalid_environment` violation.
+     */
+    values?: ({
+        /**
+         * Secret: the value. Stored sealed and never returned.
+         */
+        [k: string]: string;
+    } | null);
+    /**
+     * Environment variables delivered, exactly as written, to machines that list this connection, beside its credential and the variables its definition sets. Plain strings, not secrets: put a secret in the vault. Names are upper-case letters, digits and underscores; at most 64 variables of at most 4096 characters each.
+     */
+    environment?: {
+        [k: string]: string;
+    };
 }
 export interface ZoConnectionCreateOutputV1 {
     id: string;
     workspace_id: string;
     display_name: string;
+    description: string;
     definition_id: string;
     definition_version: number;
     visibility: ("workspace" | "protected");
@@ -824,6 +865,7 @@ export interface ZoConnectionDisconnectOutputV1 {
     id: string;
     workspace_id: string;
     display_name: string;
+    description: string;
     definition_id: string;
     definition_version: number;
     visibility: ("workspace" | "protected");
@@ -838,6 +880,7 @@ export interface ZoConnectionGetOutputV1 {
     id: string;
     workspace_id: string;
     display_name: string;
+    description: string;
     definition_id: string;
     definition_version: number;
     visibility: ("workspace" | "protected");
@@ -847,6 +890,9 @@ export interface ZoConnectionGetOutputV1 {
     account_labels: {
         [k: string]: string;
     };
+    environment: {
+        [k: string]: string;
+    };
 }
 export interface ZoConnectionListInputV1 {
     workspace_id: string;
@@ -859,6 +905,7 @@ export interface ZoConnectionListOutputV1ConnectionWithAccountsResource {
     id: string;
     workspace_id: string;
     display_name: string;
+    description: string;
     definition_id: string;
     definition_version: number;
     visibility: ("workspace" | "protected");
@@ -868,6 +915,9 @@ export interface ZoConnectionListOutputV1ConnectionWithAccountsResource {
     account_labels: {
         [k: string]: string;
     };
+    environment: {
+        [k: string]: string;
+    };
 }
 export interface ZoConnectionListQueryV1 {
     /**
@@ -904,6 +954,7 @@ export interface ZoConnectionSlackCompleteAuthorizationOutputV1 {
     id: string;
     workspace_id: string;
     display_name: string;
+    description: string;
     definition_id: string;
     definition_version: number;
     visibility: ("workspace" | "protected");
@@ -913,6 +964,9 @@ export interface ZoConnectionSlackCompleteAuthorizationOutputV1 {
     account_labels: {
         [k: string]: string;
     };
+    environment: {
+        [k: string]: string;
+    };
 }
 export interface ZoConnectionSlackStartAuthorizationInputV1 {
     connection_id: string;
@@ -936,11 +990,32 @@ export interface ZoConnectionUpdateInputV1 {
      * A new name for the connection; omit it to keep the current name.
      */
     display_name?: (string | null);
+    /**
+     * Describe what this connection is for in the user's terms.
+     */
+    description?: (string | null);
+    /**
+     * Move the connection to this version of its definition, keeping its id and grants. Credentials in both versions keep their values, credentials only the current version has are erased, and credentials only the new version has start empty. Omit it to stay on the current version.
+     */
+    definition_version?: (number | null);
+    /**
+     * Named values to set, or `null` to remove a name, on a connection whose definition is private to its workspace and holds only single-value key credentials, as one created from `values` does. Changing a value replaces that credential. Adding or removing a name publishes the definition's next version from the connection's own version and moves the connection to it, keeping its id and grants; other connections to the definition stay on their versions. A connection keeps at least one name. Any other connection returns `invalid_input`.
+     */
+    values?: ({
+        [k: string]: string | null;
+    } | null);
+    /**
+     * The environment that replaces the stored one; omit it to keep the stored environment. Environment variables delivered, exactly as written, to machines that list this connection, beside its credential and the variables its definition sets. Plain strings, not secrets: put a secret in the vault. Names are upper-case letters, digits and underscores; at most 64 variables of at most 4096 characters each.
+     */
+    environment?: ({
+        [k: string]: string;
+    } | null);
 }
 export interface ZoConnectionUpdateOutputV1 {
     id: string;
     workspace_id: string;
     display_name: string;
+    description: string;
     definition_id: string;
     definition_version: number;
     visibility: ("workspace" | "protected");
@@ -2127,6 +2202,10 @@ export interface ZoFunctionCancelRunOutputV1 {
 export interface ZoFunctionCreateInputV1 {
     workspace_id: string;
     display_name: string;
+    /**
+     * Describe what this function is for in the user's terms.
+     */
+    description?: string;
     visibility?: ("workspace" | "protected");
 }
 export interface ZoFunctionCreateOutputV1 {
@@ -2135,6 +2214,7 @@ export interface ZoFunctionCreateOutputV1 {
     type: "function";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     properties: ZoFunctionCreateOutputV1FunctionProperties;
     active_deployment_id: (string | null);
@@ -2203,6 +2283,7 @@ export interface ZoFunctionGetOutputV1 {
     type: "function";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     properties: ZoFunctionGetOutputV1FunctionProperties;
     active_deployment_id: (string | null);
@@ -2323,6 +2404,7 @@ export interface ZoFunctionListOutputV1VisibleFunctionResource {
     type: "function";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     properties: ZoFunctionListOutputV1FunctionProperties;
     active_deployment_id: (string | null);
@@ -2406,22 +2488,39 @@ export interface ZoMachineApplyPatchOutputV1 {
     size: number;
     sha256: string;
 }
+export type ZoMachineCreateInputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
 export interface ZoMachineCreateInputV1 {
     workspace_id: string;
     idempotency_key: string;
     display_name: string;
+    /**
+     * Describe what this machine is for in the user's terms.
+     */
+    description?: string;
     source: ZoMachineCreateInputV1MachineSourceInput;
     resources: ZoMachineCreateInputV1MachineResourcesInput;
     lifecycle: ZoMachineCreateInputV1MachineLifecycleInput;
     region?: string;
     /**
-     * Which process runs first at boot. `none` (default): nothing; the machine waits for exec. `image`: the init system inside the machine's image (systemd, OpenRC) becomes PID 1 and starts the services enabled on its disk. This does not choose the image; `source.machine_image_id` does. Debian and Ubuntu images need `systemd systemd-sysv` installed first. A unit restarts after a crash only when it sets `Restart=`.
+     * Which process runs first at boot. `none` (default): nothing; the machine waits for exec. `image`: the init system inside the machine's image (systemd, OpenRC) becomes PID 1 and starts the services enabled on its disk. This does not choose the image; `source.machine_image_id` does. Debian and Ubuntu images need `systemd systemd-sysv` installed first. A unit restarts after a crash only when it sets `Restart=`. GPU machines require `none`.
      */
     init?: ("none" | "image");
     /**
-     * Run these arguments as the main process on every boot, without a shell. Use ["sh", "-c", ...] for shell syntax. Find ENTRYPOINT and CMD on the image's registry page; Zo does not return them. Pass ENTRYPOINT then CMD. With `init: image`, the command must wait for services it needs. The machine stops when it exits; resume runs it again. It may run more than once after a lost create or resume response, so make it safe to rerun. Each argument is at most 4,096 UTF-8 bytes and all arguments total at most 65,536 bytes. A running command is not activity: set `idle_timeout_seconds` at least as long as the job. The maximum is published by `zo.machine.list_configurations` (3,600 s today); a longer job needs Zo exec or file calls, or HTTP through a tunnel or connect token. After exit, `get` may show `running` for a few minutes until the stop is recorded. Zo reports no exit reason or code. Write a job's result to disk. A resume runs the command again, so to read it, clear the command, resume, then use `zo.machine.read_bytes`. With `init: image` and a command, a missing `/sbin/init` ends the generation as an exit stop, without `incompatible_image`.
+     * Run these arguments as the main process on every boot, without a shell. Use ["sh", "-c", ...] for shell syntax. Find ENTRYPOINT and CMD on the image's registry page; Zo does not return them. Pass ENTRYPOINT then CMD. With `init: image`, the command must wait for services it needs. The machine stops when it exits; resume runs it again. It may run more than once after a lost create or resume response, so make it safe to rerun. Each argument is at most 4,096 UTF-8 bytes and all arguments total at most 65,536 bytes. A running command is not activity: set `idle_timeout_seconds` at least as long as the job. The maximum is published by `zo.machine.list_configurations`: 3,600 s for CPU machines and 86,400 s for GPU machines. Longer CPU jobs need Zo exec or file calls, or HTTP through a tunnel or connect token. After exit, `get` may show `running` for a few minutes until the stop is recorded. Zo reports no exit reason or code. Write a job's result to disk. A resume runs the command again, so to read it, clear the command, resume, then use `zo.machine.read_bytes`. With `init: image` and a command, a missing `/sbin/init` ends the generation as an exit stop, without `incompatible_image`.
      */
     command?: ([string, ...(string)[]] | null);
+    /**
+     * Environment variables set, exactly as written, in the boot process and every command run on the machine. Plain strings, not secrets: they are part of the machine's configuration, which anyone who can read the machine sees. Names are upper-case letters, digits and underscores, and reserved names such as `PATH` or ones starting with `ZO_` are refused; at most 64 variables of at most 4096 characters each. A variable here wins over a connection in `credentials` that sets the same name.
+     */
+    environment?: {
+        [k: string]: string;
+    };
+    /**
+     * Connection IDs whose credentials the machine receives as environment variables, in the boot process and every command. Each slot of a listed connection sets the variable its definition names, with the variables the slot and the connection declare. The machine also needs a use grant on each connection (`zo.grant.create` with the machine as assignee); a listed connection without one delivers nothing. When two listed connections set the same variable, the later one in the list wins. At most 100 connections, each listed once.
+     *
+     * @maxItems 100
+     */
+    credentials?: string[];
     /**
      * `workspace` (default): every member can see and use it. `protected`: only you, and whoever you share it with; workspace-wide grants don't reach it. Fixed at creation.
      */
@@ -2439,11 +2538,20 @@ export interface ZoMachineCreateInputV1MachineResourcesInput {
      */
     vcpus: number;
     memory_mib: number;
+    gpu?: (ZoMachineCreateInputV1MachineGpu | null);
+}
+export interface ZoMachineCreateInputV1MachineGpu {
+    type: ZoMachineCreateInputV1GpuType;
+    count: number;
 }
 export interface ZoMachineCreateInputV1MachineLifecycleInput {
-    idle_timeout_seconds?: number;
+    /**
+     * Omit for 900 seconds on CPU. For GPU, the default is the smaller of 300 seconds and max_run_seconds. An explicit GPU idle timeout must not exceed max_run_seconds.
+     */
+    idle_timeout_seconds?: (number | null);
     max_run_seconds: number;
 }
+export type ZoMachineCreateOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
 export type ZoMachineCreateOutputV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
 /**
  * A machine's registry envelope, boot settings and row-owned lifecycle state.
@@ -2454,6 +2562,7 @@ export interface ZoMachineCreateOutputV1 {
     type: "machine";
     type_version: 1;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineCreateOutputV1MachineProperties;
@@ -2465,6 +2574,8 @@ export interface ZoMachineCreateOutputV1 {
     created_at: string;
     updated_at: string;
     destroyed_at: (string | null);
+    recoverable_until?: (string | null);
+    recovery_acceptance_required?: boolean;
 }
 /**
  * Public properties of a `machine` resource.
@@ -2483,11 +2594,20 @@ export interface ZoMachineCreateOutputV1MachineProperties {
     machine_image_id: (string | null);
     vcpus: (number | null);
     memory_mib: (number | null);
+    gpu?: (ZoMachineCreateOutputV1MachineGpu | null);
     region: (string | null);
     idle_timeout_seconds: (number | null);
     max_run_seconds: (number | null);
     init?: (("none" | "image") | null);
     command?: ([string, ...(string)[]] | null);
+    environment?: ({
+        [k: string]: string;
+    } | null);
+    credentials?: (string[] | null);
+}
+export interface ZoMachineCreateOutputV1MachineGpu {
+    type: ZoMachineCreateOutputV1GpuType;
+    count: number;
 }
 export interface ZoMachineCreateOutputV1MachineBootedView {
     init: ("none" | "image");
@@ -2498,6 +2618,7 @@ export interface ZoMachineDestroyInputV1 {
     expected_revision: number;
     idempotency_key: string;
 }
+export type ZoMachineDestroyOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
 export type ZoMachineDestroyOutputV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
 /**
  * A machine's registry envelope, boot settings and row-owned lifecycle state.
@@ -2508,6 +2629,7 @@ export interface ZoMachineDestroyOutputV1 {
     type: "machine";
     type_version: 1;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineDestroyOutputV1MachineProperties;
@@ -2519,6 +2641,8 @@ export interface ZoMachineDestroyOutputV1 {
     created_at: string;
     updated_at: string;
     destroyed_at: (string | null);
+    recoverable_until?: (string | null);
+    recovery_acceptance_required?: boolean;
 }
 /**
  * Public properties of a `machine` resource.
@@ -2537,11 +2661,20 @@ export interface ZoMachineDestroyOutputV1MachineProperties {
     machine_image_id: (string | null);
     vcpus: (number | null);
     memory_mib: (number | null);
+    gpu?: (ZoMachineDestroyOutputV1MachineGpu | null);
     region: (string | null);
     idle_timeout_seconds: (number | null);
     max_run_seconds: (number | null);
     init?: (("none" | "image") | null);
     command?: ([string, ...(string)[]] | null);
+    environment?: ({
+        [k: string]: string;
+    } | null);
+    credentials?: (string[] | null);
+}
+export interface ZoMachineDestroyOutputV1MachineGpu {
+    type: ZoMachineDestroyOutputV1GpuType;
+    count: number;
 }
 export interface ZoMachineDestroyOutputV1MachineBootedView {
     init: ("none" | "image");
@@ -2565,6 +2698,7 @@ export interface ZoMachineExecOutputV1 {
 export interface ZoMachineGetInputV1 {
     machine_id: string;
 }
+export type ZoMachineGetOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
 export type ZoMachineGetOutputV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
 /**
  * A machine's registry envelope, boot settings and row-owned lifecycle state.
@@ -2575,6 +2709,7 @@ export interface ZoMachineGetOutputV1 {
     type: "machine";
     type_version: 1;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineGetOutputV1MachineProperties;
@@ -2586,6 +2721,8 @@ export interface ZoMachineGetOutputV1 {
     created_at: string;
     updated_at: string;
     destroyed_at: (string | null);
+    recoverable_until?: (string | null);
+    recovery_acceptance_required?: boolean;
 }
 /**
  * Public properties of a `machine` resource.
@@ -2604,11 +2741,20 @@ export interface ZoMachineGetOutputV1MachineProperties {
     machine_image_id: (string | null);
     vcpus: (number | null);
     memory_mib: (number | null);
+    gpu?: (ZoMachineGetOutputV1MachineGpu | null);
     region: (string | null);
     idle_timeout_seconds: (number | null);
     max_run_seconds: (number | null);
     init?: (("none" | "image") | null);
     command?: ([string, ...(string)[]] | null);
+    environment?: ({
+        [k: string]: string;
+    } | null);
+    credentials?: (string[] | null);
+}
+export interface ZoMachineGetOutputV1MachineGpu {
+    type: ZoMachineGetOutputV1GpuType;
+    count: number;
 }
 export interface ZoMachineGetOutputV1MachineBootedView {
     init: ("none" | "image");
@@ -2617,6 +2763,7 @@ export interface ZoMachineGetOutputV1MachineBootedView {
 export interface ZoMachineListInputV1 {
     workspace_id: string;
 }
+export type ZoMachineListOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
 export type ZoMachineListOutputV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
 export interface ZoMachineListOutputV1 {
     machines: ZoMachineListOutputV1ManagedMachineView[];
@@ -2631,6 +2778,7 @@ export interface ZoMachineListOutputV1ManagedMachineView {
     type: "machine";
     type_version: 1;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineListOutputV1MachineProperties;
@@ -2642,6 +2790,8 @@ export interface ZoMachineListOutputV1ManagedMachineView {
     created_at: string;
     updated_at: string;
     destroyed_at: (string | null);
+    recoverable_until?: (string | null);
+    recovery_acceptance_required?: boolean;
 }
 /**
  * Public properties of a `machine` resource.
@@ -2660,11 +2810,20 @@ export interface ZoMachineListOutputV1MachineProperties {
     machine_image_id: (string | null);
     vcpus: (number | null);
     memory_mib: (number | null);
+    gpu?: (ZoMachineListOutputV1MachineGpu | null);
     region: (string | null);
     idle_timeout_seconds: (number | null);
     max_run_seconds: (number | null);
     init?: (("none" | "image") | null);
     command?: ([string, ...(string)[]] | null);
+    environment?: ({
+        [k: string]: string;
+    } | null);
+    credentials?: (string[] | null);
+}
+export interface ZoMachineListOutputV1MachineGpu {
+    type: ZoMachineListOutputV1GpuType;
+    count: number;
 }
 export interface ZoMachineListOutputV1MachineBootedView {
     init: ("none" | "image");
@@ -2691,6 +2850,8 @@ export interface ZoMachineListConfigurationsInputV1 {
  */
 export interface ZoMachineListConfigurationsOutputV1 {
     resources: ZoMachineListConfigurationsOutputV1MachineResourceBounds;
+    gpus: ZoMachineListConfigurationsOutputV1MachineGpuOffer[];
+    runtime: "vm";
     vcpu_microusd_per_second: number;
     memory_gib_microusd_per_second: number;
     regions: string[];
@@ -2709,16 +2870,26 @@ export interface ZoMachineListConfigurationsOutputV1MachineRunBounds {
     minimum: number;
     maximum: number;
 }
-export interface ZoMachineListConfigurationsOutputV1MachineCommandOffer {
-    supported: boolean;
-    max_args: number;
-    max_arg_bytes: number;
+export interface ZoMachineListConfigurationsOutputV1MachineGpuOffer {
+    type: string;
+    count: ZoMachineListConfigurationsOutputV1MachineRunBounds;
+    vram_gb: number;
+    gpu_microusd_per_second: number;
+    runtime: "gvisor";
+    init: ("none")[];
+    idle_timeout_seconds: ZoMachineListConfigurationsOutputV1MachineIdleTimeoutBounds;
+    max_run_seconds: ZoMachineListConfigurationsOutputV1MachineRunBounds;
 }
 export interface ZoMachineListConfigurationsOutputV1MachineIdleTimeoutBounds {
     minimum: number;
     maximum: number;
     default: number;
 }
+export interface ZoMachineListConfigurationsOutputV1MachineCommandOffer {
+    supported: boolean;
+    max_args: number;
+    max_arg_bytes: number;
+}
 export interface ZoMachineListFilesInputV1 {
     machine_id: string;
     path: string;
@@ -2764,6 +2935,7 @@ export interface ZoMachineResumeInputV1 {
     idempotency_key: string;
     accept_recovery?: boolean;
 }
+export type ZoMachineResumeOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
 export type ZoMachineResumeOutputV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
 /**
  * A machine's registry envelope, boot settings and row-owned lifecycle state.
@@ -2774,6 +2946,7 @@ export interface ZoMachineResumeOutputV1 {
     type: "machine";
     type_version: 1;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineResumeOutputV1MachineProperties;
@@ -2785,6 +2958,8 @@ export interface ZoMachineResumeOutputV1 {
     created_at: string;
     updated_at: string;
     destroyed_at: (string | null);
+    recoverable_until?: (string | null);
+    recovery_acceptance_required?: boolean;
 }
 /**
  * Public properties of a `machine` resource.
@@ -2803,11 +2978,20 @@ export interface ZoMachineResumeOutputV1MachineProperties {
     machine_image_id: (string | null);
     vcpus: (number | null);
     memory_mib: (number | null);
+    gpu?: (ZoMachineResumeOutputV1MachineGpu | null);
     region: (string | null);
     idle_timeout_seconds: (number | null);
     max_run_seconds: (number | null);
     init?: (("none" | "image") | null);
     command?: ([string, ...(string)[]] | null);
+    environment?: ({
+        [k: string]: string;
+    } | null);
+    credentials?: (string[] | null);
+}
+export interface ZoMachineResumeOutputV1MachineGpu {
+    type: ZoMachineResumeOutputV1GpuType;
+    count: number;
 }
 export interface ZoMachineResumeOutputV1MachineBootedView {
     init: ("none" | "image");
@@ -2824,6 +3008,10 @@ export interface ZoMachineSnapshotInputV1 {
 }
 export interface ZoMachineSnapshotInputV1MachineImageCreateOptions {
     display_name: string;
+    /**
+     * Describe what this machine image is for in the user's terms.
+     */
+    description?: string;
     /**
      * Image visibility. Omit or pass null to use the creating operation's default. Protected images use ordinary verified-human creator ownership.
      */
@@ -2842,6 +3030,7 @@ export interface ZoMachineSnapshotOutputV1 {
     type: "machine_image";
     type_version: number;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineSnapshotOutputV1MachineImageProperties;
@@ -2868,6 +3057,7 @@ export interface ZoMachineStopInputV1 {
     expected_revision: number;
     idempotency_key: string;
 }
+export type ZoMachineStopOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
 export type ZoMachineStopOutputV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
 /**
  * A machine's registry envelope, boot settings and row-owned lifecycle state.
@@ -2878,6 +3068,7 @@ export interface ZoMachineStopOutputV1 {
     type: "machine";
     type_version: 1;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineStopOutputV1MachineProperties;
@@ -2889,6 +3080,8 @@ export interface ZoMachineStopOutputV1 {
     created_at: string;
     updated_at: string;
     destroyed_at: (string | null);
+    recoverable_until?: (string | null);
+    recovery_acceptance_required?: boolean;
 }
 /**
  * Public properties of a `machine` resource.
@@ -2907,11 +3100,20 @@ export interface ZoMachineStopOutputV1MachineProperties {
     machine_image_id: (string | null);
     vcpus: (number | null);
     memory_mib: (number | null);
+    gpu?: (ZoMachineStopOutputV1MachineGpu | null);
     region: (string | null);
     idle_timeout_seconds: (number | null);
     max_run_seconds: (number | null);
     init?: (("none" | "image") | null);
     command?: ([string, ...(string)[]] | null);
+    environment?: ({
+        [k: string]: string;
+    } | null);
+    credentials?: (string[] | null);
+}
+export interface ZoMachineStopOutputV1MachineGpu {
+    type: ZoMachineStopOutputV1GpuType;
+    count: number;
 }
 export interface ZoMachineStopOutputV1MachineBootedView {
     init: ("none" | "image");
@@ -2923,6 +3125,7 @@ export interface ZoMachineSystemInfoInputV1 {
 export type ZoMachineSystemInfoOutputV1DesiredState = ("running" | "stopped" | "destroyed");
 export type ZoMachineSystemInfoOutputV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
 export type ZoMachineSystemInfoOutputV1InfoSource = ("provider" | "zo_control");
+export type ZoMachineSystemInfoOutputV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
 export type ZoMachineSystemInfoOutputV1InfoGroup = ("architecture" | "os" | "allocation" | "guest" | "disk" | "network" | "accelerators" | "capabilities");
 export type ZoMachineSystemInfoOutputV1InfoUnknownReason = ("not_observed" | "driver_unavailable");
 /**
@@ -2971,9 +3174,14 @@ export interface ZoMachineSystemInfoOutputV1MachineInfoAllocation {
     observed_at: string;
     requested_vcpus: number;
     requested_memory_mib: number;
+    requested_gpu?: (ZoMachineSystemInfoOutputV1MachineGpu | null);
     verified_vcpus: (number | null);
     verified_memory_mib: (number | null);
 }
+export interface ZoMachineSystemInfoOutputV1MachineGpu {
+    type: ZoMachineSystemInfoOutputV1GpuType;
+    count: number;
+}
 /**
  * What the machine's driver supports, not what the caller may do.
  * ``stop`` keeps the filesystem; ``pause`` keeps memory too.
@@ -3004,19 +3212,33 @@ export interface ZoMachineUpdateInputV1 {
     machine_id: string;
     expected_revision: number;
     display_name?: (string | null);
+    /**
+     * Describe what this machine is for in the user's terms.
+     */
+    description?: (string | null);
     lifecycle?: (ZoMachineUpdateInputV1MachineLifecycleUpdate | null);
     /**
-     * Which process runs first at boot. `none` (default): nothing; the machine waits for exec. `image`: the image's init system (systemd, OpenRC) becomes PID 1 and starts enabled services. `source.machine_image_id` chooses the image. Debian and Ubuntu need `systemd systemd-sysv`. Setting `image` needs exec permission; approval-gated exec is denied. Write access to boot files can run code as root at next boot.
+     * Which process runs first at boot. `none` (default): nothing; the machine waits for exec. `image`: the image's init system (systemd, OpenRC) becomes PID 1 and starts enabled services. `source.machine_image_id` chooses the image. Debian and Ubuntu need `systemd systemd-sysv`. Write access to boot files can run code as root at next boot.
      */
     init?: (("none" | "image") | null);
     /**
-     * Set the main process for the next resume. Arguments run without a shell; use ["sh", "-c", ...] for shell syntax. Find ENTRYPOINT and CMD on the image's registry page; Zo does not return them. Pass ENTRYPOINT then CMD. With `init: image`, wait for needed services. The machine stops when the command exits; resume runs it again. It may run more than once after a lost create or resume response, so make it safe to rerun. Each argument is at most 4,096 UTF-8 bytes and all arguments total at most 65,536 bytes. A running command is not activity: set `idle_timeout_seconds` at least as long as the job. The maximum is published by `zo.machine.list_configurations` (3,600 s today); a longer job needs Zo exec or file calls, or HTTP through a tunnel or connect token. After exit, `get` may show `running` for a few minutes. Zo reports no exit reason or code. Write a job's result to disk. A resume runs the command again, so to read it, clear the command, resume, then use `zo.machine.read_bytes`. With `init: image` and a command, a missing `/sbin/init` ends the generation as an exit stop, without `incompatible_image`. Changing the command needs exec permission; approval-gated exec is denied. Write access to its script can run code as root at next boot.
+     * Set the main process for the next resume. Arguments run without a shell; use ["sh", "-c", ...] for shell syntax. Find ENTRYPOINT and CMD on the image's registry page; Zo does not return them. Pass ENTRYPOINT then CMD. With `init: image`, wait for needed services. The machine stops when the command exits; resume runs it again. It may run more than once after a lost create or resume response, so make it safe to rerun. Each argument is at most 4,096 UTF-8 bytes and all arguments total at most 65,536 bytes. A running command is not activity: set `idle_timeout_seconds` at least as long as the job. The maximum is published by `zo.machine.list_configurations`: 3,600 s for CPU machines and 86,400 s for GPU machines. Longer CPU jobs need Zo exec or file calls, or HTTP through a tunnel or connect token. After exit, `get` may show `running` for a few minutes. Zo reports no exit reason or code. Write a job's result to disk. A resume runs the command again, so to read it, clear the command, resume, then use `zo.machine.read_bytes`. With `init: image` and a command, a missing `/sbin/init` ends the generation as an exit stop, without `incompatible_image`. Write access to its script can run code as root at next boot.
      */
     command?: ([string, ...(string)[]] | null);
     /**
-     * Remove the main process on the next resume. Requires manage permission only.
+     * Remove the main process on the next resume.
      */
     clear_command?: boolean;
+    /**
+     * The environment that replaces the stored one; omit it to keep it. Environment variables set, exactly as written, in the boot process and every command run on the machine. Plain strings, not secrets: they are part of the machine's configuration, which anyone who can read the machine sees. Names are upper-case letters, digits and underscores, and reserved names such as `PATH` or ones starting with `ZO_` are refused; at most 64 variables of at most 4096 characters each. A variable here wins over a connection in `credentials` that sets the same name.
+     */
+    environment?: ({
+        [k: string]: string;
+    } | null);
+    /**
+     * The list that replaces the stored one; omit it to keep it. Connection IDs whose credentials the machine receives as environment variables, in the boot process and every command. Each slot of a listed connection sets the variable its definition names, with the variables the slot and the connection declare. The machine also needs a use grant on each connection (`zo.grant.create` with the machine as assignee); a listed connection without one delivers nothing. When two listed connections set the same variable, the later one in the list wins. At most 100 connections, each listed once.
+     */
+    credentials?: (string[] | null);
 }
 /**
  * The timers a caller may change after create. Modal fixes them at
@@ -3030,6 +3252,7 @@ export interface ZoMachineUpdateOutputV1 {
     machine_id: string;
     revision: number;
     display_name: string;
+    description: string;
     idle_timeout_seconds: number;
     max_run_seconds: (number | null);
 }
@@ -3063,6 +3286,7 @@ export interface ZoMachineImageDeleteOutputV1 {
     type: "machine_image";
     type_version: number;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineImageDeleteOutputV1MachineImageProperties;
@@ -3100,6 +3324,7 @@ export interface ZoMachineImageGetOutputV1 {
     type: "machine_image";
     type_version: number;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineImageGetOutputV1MachineImageProperties;
@@ -3123,6 +3348,10 @@ export interface ZoMachineImageGetOutputV1MachineImageProperties {
 }
 export interface ZoMachineImageImportInputV1 {
     display_name: string;
+    /**
+     * Describe what this machine image is for in the user's terms.
+     */
+    description?: string;
     /**
      * `workspace` (default): every member can see and use it. `protected`: only you, and whoever you share it with; workspace-wide grants don't reach it. Fixed at creation.
      */
@@ -3149,6 +3378,7 @@ export interface ZoMachineImageImportOutputV1 {
     type: "machine_image";
     type_version: number;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineImageImportOutputV1MachineImageProperties;
@@ -3190,6 +3420,7 @@ export interface ZoMachineImageListOutputV1MachineImageView {
     type: "machine_image";
     type_version: number;
     display_name: string;
+    description: string;
     visibility: ("workspace" | "protected");
     revision: number;
     properties: ZoMachineImageListOutputV1MachineImageProperties;
@@ -3430,6 +3661,10 @@ export interface ZoOauthAppUpdateOutputV1 {
 export interface ZoScheduleCreateInputV1 {
     workspace_id: string;
     display_name: string;
+    /**
+     * Describe what this schedule is for in the user's terms.
+     */
+    description?: string;
     rrule: string;
     start_at: string;
     timezone: string;
@@ -3444,6 +3679,7 @@ export interface ZoScheduleCreateOutputV1 {
     type: "schedule";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     visibility: ("workspace" | "protected");
     owner_user_id: (string | null);
@@ -3483,6 +3719,7 @@ export interface ZoScheduleGetOutputV1 {
     type: "schedule";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     visibility: ("workspace" | "protected");
     owner_user_id: (string | null);
@@ -3518,6 +3755,7 @@ export interface ZoScheduleListOutputV1ScheduleView {
     type: "schedule";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     visibility: ("workspace" | "protected");
     owner_user_id: (string | null);
@@ -3551,6 +3789,10 @@ export interface ZoScheduleUpdateInputV1 {
     schedule_id: string;
     expected_revision: number;
     display_name: string;
+    /**
+     * Describe what this schedule is for in the user's terms.
+     */
+    description?: (string | null);
     rrule: string;
     start_at: string;
     timezone: string;
@@ -3565,6 +3807,7 @@ export interface ZoScheduleUpdateOutputV1 {
     type: "schedule";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     visibility: ("workspace" | "protected");
     owner_user_id: (string | null);
@@ -3834,6 +4077,10 @@ export interface ZoSubscriptionCreateInputV2 {
     workspace_id: string;
     event_id: string;
     display_name: string;
+    /**
+     * Describe what this subscription is for in the user's terms.
+     */
+    description?: string;
     filter?: ((ZoSubscriptionCreateInputV2EqFilter | ZoSubscriptionCreateInputV2InFilter | ZoSubscriptionCreateInputV2ExistsFilter | ZoSubscriptionCreateInputV2All1 | ZoSubscriptionCreateInputV2Any1) | null);
     handler_resource_type: ("function" | "workflow" | "agent");
     handler_resource_id?: (string | null);
@@ -3940,6 +4187,7 @@ export interface ZoSubscriptionCreateOutputV2 {
     type: "event_subscription";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     properties: ZoSubscriptionCreateOutputV2EventSubscriptionProperties;
     event_type: string;
@@ -4213,6 +4461,7 @@ export interface ZoSubscriptionGetOutputV2 {
     type: "event_subscription";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     properties: ZoSubscriptionGetOutputV2EventSubscriptionProperties;
     event_type: string;
@@ -4516,6 +4765,7 @@ export interface ZoSubscriptionListOutputV2SubscriptionResourceV2 {
     type: "event_subscription";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     properties: ZoSubscriptionListOutputV2EventSubscriptionProperties;
     event_type: string;
@@ -4834,8 +5084,9 @@ export interface ZoSubscriptionUpdateOutputV1PrincipalRef {
 }
 export type ZoSubscriptionUpdateInputV2InputContractKind = ("exact_event" | "generic_envelope");
 /**
- * Full replacement of every create field but the workspace and the event (a new
- * definition or version is a new subscription), plus ``lifecycle``: ``active``
+ * Replace create fields except workspace, event and optional description.
+ * A new event definition or version requires a new subscription.
+ * Omitted or null description keeps its value. ``lifecycle``: ``active``
  * resumes a paused or suspended subscription, ``paused`` pauses it;
  * ``zo.subscription.delete`` retires. ``handler_resource_type`` must be the
  * subscription's own: a different handler type is a new subscription.
@@ -4844,6 +5095,10 @@ export interface ZoSubscriptionUpdateInputV2 {
     subscription_id: string;
     expected_revision: number;
     display_name: string;
+    /**
+     * Describe what this subscription is for in the user's terms.
+     */
+    description?: (string | null);
     filter?: ((ZoSubscriptionUpdateInputV2EqFilter | ZoSubscriptionUpdateInputV2InFilter | ZoSubscriptionUpdateInputV2ExistsFilter | ZoSubscriptionUpdateInputV2All1 | ZoSubscriptionUpdateInputV2Any1) | null);
     handler_resource_type: ("function" | "workflow" | "agent");
     handler_resource_id?: (string | null);
@@ -4950,6 +5205,7 @@ export interface ZoSubscriptionUpdateOutputV2 {
     type: "event_subscription";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     properties: ZoSubscriptionUpdateOutputV2EventSubscriptionProperties;
     event_type: string;
@@ -6589,6 +6845,10 @@ export interface ZoWebsiteCreateInputV1 {
     workspace_id: string;
     slug: string;
     display_name: string;
+    /**
+     * Describe what this Website is for in the user's terms.
+     */
+    description?: string;
     visibility?: ("workspace" | "protected");
 }
 export interface ZoWebsiteCreateOutputV1 {
@@ -6596,6 +6856,7 @@ export interface ZoWebsiteCreateOutputV1 {
     workspace_id: string;
     slug: string;
     display_name: string;
+    description: string;
     generated_hostname: string;
     custom_hostname: (ZoWebsiteCreateOutputV1WebsiteHostname | null);
     access: "public";
@@ -6625,6 +6886,7 @@ export interface ZoWebsiteGetOutputV1 {
     workspace_id: string;
     slug: string;
     display_name: string;
+    description: string;
     generated_hostname: string;
     custom_hostname: (ZoWebsiteGetOutputV1WebsiteHostname | null);
     access: "public";
@@ -6650,6 +6912,7 @@ export interface ZoWebsiteListOutputV1WebsiteListItem {
     workspace_id: string;
     slug: string;
     display_name: string;
+    description: string;
     generated_hostname: string;
     custom_hostname: (ZoWebsiteListOutputV1WebsiteHostname | null);
     access: "public";
@@ -6711,6 +6974,10 @@ export interface ZoWebsiteUpdateInputV1 {
     website_id: string;
     expected_revision: number;
     display_name?: (string | null);
+    /**
+     * Describe what this Website is for in the user's terms.
+     */
+    description?: (string | null);
     custom_hostname?: (ZoWebsiteUpdateInputV1CustomHostnameChange | null);
 }
 export interface ZoWebsiteUpdateInputV1CustomHostnameChange {
@@ -6721,6 +6988,7 @@ export interface ZoWebsiteUpdateOutputV1 {
     workspace_id: string;
     slug: string;
     display_name: string;
+    description: string;
     generated_hostname: string;
     custom_hostname: (ZoWebsiteUpdateOutputV1WebsiteHostname | null);
     access: "public";
@@ -7058,6 +7326,10 @@ export interface ZoWorkflowCancelRunOutputV1 {
 export interface ZoWorkflowCreateInputV1 {
     workspace_id: string;
     display_name: string;
+    /**
+     * Describe what this workflow is for in the user's terms.
+     */
+    description?: string;
     visibility?: ("workspace" | "protected");
 }
 export interface ZoWorkflowCreateOutputV1 {
@@ -7066,6 +7338,7 @@ export interface ZoWorkflowCreateOutputV1 {
     type: "workflow";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     active_revision_id: (string | null);
     latest_revision_id: (string | null);
@@ -7090,6 +7363,7 @@ export interface ZoWorkflowGetOutputV1 {
     type: "workflow";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     active_revision_id: (string | null);
     latest_revision_id: (string | null);
@@ -7167,6 +7441,7 @@ export interface ZoWorkflowListOutputV1VisibleWorkflowResource {
     type: "workflow";
     type_version: number;
     display_name: string;
+    description: string;
     revision: number;
     active_revision_id: (string | null);
     latest_revision_id: (string | null);
@@ -7341,6 +7616,7 @@ export interface EventSubscriptionV1 {
 export interface FunctionV1 {
     code_owner: ("zo" | "workspace");
 }
+export type MachineV1GpuType = ("T4" | "L4" | "A10" | "L40S" | "A100" | "A100-40GB" | "A100-80GB" | "RTX-PRO-6000" | "H100" | "H100!" | "H200" | "B200" | "B200+" | "B300");
 /**
  * Public properties of a `machine` resource.
  *
@@ -7358,11 +7634,20 @@ export interface MachineV1 {
     machine_image_id: (string | null);
     vcpus: (number | null);
     memory_mib: (number | null);
+    gpu?: (MachineV1MachineGpu | null);
     region: (string | null);
     idle_timeout_seconds: (number | null);
     max_run_seconds: (number | null);
     init?: (("none" | "image") | null);
     command?: ([string, ...(string)[]] | null);
+    environment?: ({
+        [k: string]: string;
+    } | null);
+    credentials?: (string[] | null);
+}
+export interface MachineV1MachineGpu {
+    type: MachineV1GpuType;
+    count: number;
 }
 export type MachineImageV1ImageOrigin = ("registry" | "build" | "machine_snapshot");
 /**