@zocomputer/system-api 0.1.1 → 0.1.2

package/openapi.json

@@ -1570,7 +1570,7 @@
       "name": "zo.agent.create",
       "version": 1,
       "publisher": "zo",
-      "description": "Create an Agent in a workspace. A zo.native Agent requires the workspace to be on Metronome billing.",
+      "description": "Create an Agent in a workspace. A zo.native Agent requires the workspace to be on Metronome billing. Describe what this Agent is for in the user's terms.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -1586,6 +1586,13 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "default": "",
+            "description": "Describe what this Agent is for in the user's terms.",
+            "maxLength": 2000,
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "default": "workspace",
             "enum": [
@@ -1708,6 +1715,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -1763,6 +1774,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "implementation",
           "configuration",
@@ -1910,7 +1922,7 @@
         "conflict",
         "invalid_definition"
       ],
-      "digest": "sha256:c593aa0a48ee1f9515eafb9087ab587f251f39f32e0b04d767ea1eb1d6d43674"
+      "digest": "sha256:4fbc9ab5aa876ca0ca2c3ee8c7a82eeda3166ea8eb9427110f2c496327ff5a44"
     },
     {
       "name": "zo.agent.delete",
@@ -2031,6 +2043,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -2086,6 +2102,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "implementation",
           "configuration",
@@ -2232,7 +2249,7 @@
         "implementation_unavailable",
         "resource_not_found"
       ],
-      "digest": "sha256:3a65d4c7e0de2c543834c3b7c7c960ecc4ca8953051afcb828b8c7cb35b33a3a"
+      "digest": "sha256:1560dba5acc73165eff2d8fd59db25b74a6f0b84d78d45bd111a2a9d9fa30616"
     },
     {
       "name": "zo.agent.list",
@@ -2318,6 +2335,10 @@
                 "title": "Display Name",
                 "type": "string"
               },
+              "description": {
+                "title": "Description",
+                "type": "string"
+              },
               "revision": {
                 "exclusiveMinimum": 0,
                 "maximum": 9007199254740991,
@@ -2373,6 +2394,7 @@
               "type",
               "type_version",
               "display_name",
+              "description",
               "revision",
               "implementation",
               "configuration",
@@ -2518,7 +2540,7 @@
       "error_codes": [
         "implementation_unavailable"
       ],
-      "digest": "sha256:3c76302e49c7d7fec9c4d73ef8bff1c81bf0ee0e99c263b57ffbd431c8151bad"
+      "digest": "sha256:d4a96db2bedb15c6bc484d5a1142bca8b9e386f5e277a57615274aa7e44d910b"
     },
     {
       "name": "zo.agent.list_messages",
@@ -3338,6 +3360,20 @@
             "default": null,
             "title": "Display Name"
           },
+          "description": {
+            "anyOf": [
+              {
+                "maxLength": 2000,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Describe what this Agent is for in the user's terms.",
+            "title": "Description"
+          },
           "configuration": {
             "anyOf": [
               {
@@ -3452,6 +3488,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -3507,6 +3547,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "implementation",
           "configuration",
@@ -3655,7 +3696,7 @@
         "invalid_definition",
         "resource_not_found"
       ],
-      "digest": "sha256:7d5e23eae129a899a6df255bf6c0d217c527979b2339f19329b0b770b825e37c"
+      "digest": "sha256:9e1fe6ba87805ca19b754c33d82884eda4ab90a822321d23a1011333d721acb4"
     },
     {
       "name": "zo.agent_session.get",
@@ -4328,7 +4369,7 @@
       "name": "zo.connection.create",
       "version": 1,
       "publisher": "zo",
-      "description": "Create a connection from a published definition. A protected connection is reachable only by its owner and the principals they grant.",
+      "description": "Create a connection from a published definition, or from named values on a private definition Zo publishes for it. A protected connection is reachable only by its owner and the principals they grant. Describe what this connection is for in the user's terms.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -4339,16 +4380,34 @@
             "type": "string"
           },
           "definition_id": {
-            "maxLength": 200,
-            "minLength": 1,
-            "title": "Definition Id",
-            "type": "string"
+            "anyOf": [
+              {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "The published definition to connect to. Give it, or `values`, not both.",
+            "title": "Definition Id"
           },
           "definition_version": {
-            "exclusiveMinimum": 0,
-            "maximum": 2147483647,
-            "title": "Definition Version",
-            "type": "integer"
+            "anyOf": [
+              {
+                "exclusiveMinimum": 0,
+                "maximum": 2147483647,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "The version of `definition_id` to connect to; required with it.",
+            "title": "Definition Version"
           },
           "display_name": {
             "maxLength": 256,
@@ -4356,12 +4415,28 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "default": "",
+            "description": "Describe what this connection is for in the user's terms.",
+            "maxLength": 2000,
+            "title": "Description",
+            "type": "string"
+          },
           "configuration": {
-            "additionalProperties": {
-              "x-zo-json-value": true
-            },
-            "title": "Configuration",
-            "type": "object"
+            "anyOf": [
+              {
+                "additionalProperties": {
+                  "x-zo-json-value": true
+                },
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "The connection's configuration; required with `definition_id`.",
+            "title": "Configuration"
           },
           "visibility": {
             "default": "workspace",
@@ -4371,14 +4446,43 @@
             ],
             "title": "Visibility",
             "type": "string"
+          },
+          "values": {
+            "anyOf": [
+              {
+                "additionalProperties": {
+                  "description": "Secret: the value. Stored sealed and never returned.",
+                  "maxLength": 16384,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "maxProperties": 100,
+                "minProperties": 1,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "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.",
+            "title": "Values"
+          },
+          "environment": {
+            "additionalProperties": {
+              "maxLength": 4096,
+              "type": "string"
+            },
+            "default": {},
+            "description": "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.",
+            "maxProperties": 64,
+            "title": "Environment",
+            "type": "object"
           }
         },
         "required": [
           "workspace_id",
-          "definition_id",
-          "definition_version",
-          "display_name",
-          "configuration"
+          "display_name"
         ],
         "title": "ConnectionCreateInput",
         "type": "object"
@@ -4398,6 +4502,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "definition_id": {
             "title": "Definition Id",
             "type": "string"
@@ -4449,6 +4557,7 @@
           "id",
           "workspace_id",
           "display_name",
+          "description",
           "definition_id",
           "definition_version",
           "visibility",
@@ -4468,9 +4577,10 @@
       "result_kind": "inline",
       "error_codes": [
         "invalid_input",
+        "conflict",
         "resource_not_found"
       ],
-      "digest": "sha256:996764cac5f7ef40d6ca7e45c15728d59c41c8df9d50897f7fadb9cc8a88aad0"
+      "digest": "sha256:e4d646f09a95067bc7d5617fe6407fa17dd20b12dfa124fbbc641d531a77757e"
     },
     {
       "name": "zo.connection.delete",
@@ -4578,6 +4688,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "definition_id": {
             "title": "Definition Id",
             "type": "string"
@@ -4629,6 +4743,7 @@
           "id",
           "workspace_id",
           "display_name",
+          "description",
           "definition_id",
           "definition_version",
           "visibility",
@@ -4650,7 +4765,7 @@
         "conflict",
         "resource_not_found"
       ],
-      "digest": "sha256:2c4dc31f348d30503d1acaec0182d729d9d65b8ab8de18f7cdd422dd7655b0ea"
+      "digest": "sha256:4eb5f723894a35b5cc94392978d8061b1616aeb0e332761d0d41e66a33535921"
     },
     {
       "name": "zo.connection.get",
@@ -4688,6 +4803,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "definition_id": {
             "title": "Definition Id",
             "type": "string"
@@ -4740,19 +4859,28 @@
             },
             "title": "Account Labels",
             "type": "object"
+          },
+          "environment": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "title": "Environment",
+            "type": "object"
           }
         },
         "required": [
           "id",
           "workspace_id",
           "display_name",
+          "description",
           "definition_id",
           "definition_version",
           "visibility",
           "owner_user_id",
           "status",
           "revision",
-          "account_labels"
+          "account_labels",
+          "environment"
         ],
         "title": "ConnectionWithAccountsResource",
         "type": "object"
@@ -4767,7 +4895,7 @@
       "error_codes": [
         "resource_not_found"
       ],
-      "digest": "sha256:1984bb0c5018e59ace5610df863d88f0e2236a170330533f9bd54e24e9ec1a09"
+      "digest": "sha256:5ca6347217eba21af2b37e1830df0252e5d4115a3f7ee4f9357bed5e11280861"
     },
     {
       "name": "zo.connection.list",
@@ -4834,6 +4962,10 @@
                 "title": "Display Name",
                 "type": "string"
               },
+              "description": {
+                "title": "Description",
+                "type": "string"
+              },
               "definition_id": {
                 "title": "Definition Id",
                 "type": "string"
@@ -4886,19 +5018,28 @@
                 },
                 "title": "Account Labels",
                 "type": "object"
+              },
+              "environment": {
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "title": "Environment",
+                "type": "object"
               }
             },
             "required": [
               "id",
               "workspace_id",
               "display_name",
+              "description",
               "definition_id",
               "definition_version",
               "visibility",
               "owner_user_id",
               "status",
               "revision",
-              "account_labels"
+              "account_labels",
+              "environment"
             ],
             "title": "ConnectionWithAccountsResource",
             "type": "object"
@@ -4915,7 +5056,7 @@
       "error_codes": [
         "invalid_cursor"
       ],
-      "digest": "sha256:bc22298a1354133759f52e3de81a8c72808f616e52f3c3ef5f8e8195f72cc0de"
+      "digest": "sha256:92aca1c5160f58db8d84f380e55f271730a7159e4ca3d2bddde8462adba18a30"
     },
     {
       "name": "zo.connection.register_resource",
@@ -5066,6 +5207,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "definition_id": {
             "title": "Definition Id",
             "type": "string"
@@ -5118,19 +5263,28 @@
             },
             "title": "Account Labels",
             "type": "object"
+          },
+          "environment": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "title": "Environment",
+            "type": "object"
           }
         },
         "required": [
           "id",
           "workspace_id",
           "display_name",
+          "description",
           "definition_id",
           "definition_version",
           "visibility",
           "owner_user_id",
           "status",
           "revision",
-          "account_labels"
+          "account_labels",
+          "environment"
         ],
         "title": "ConnectionWithAccountsResource",
         "type": "object"
@@ -5148,7 +5302,7 @@
         "resource_not_found",
         "provider_failure"
       ],
-      "digest": "sha256:91d27f8956f09feddf5a25f645435bc6f1a95656fe7fee787813450730615ce4"
+      "digest": "sha256:38809f082e91970b4def46e398f923d88ccfd8c89b8f53bbfebd9da2807c608d"
     },
     {
       "name": "zo.connection.slack.start_authorization",
@@ -5225,7 +5379,7 @@
       "name": "zo.connection.update",
       "version": 1,
       "publisher": "zo",
-      "description": "Replace a connection's configuration, rename it, or both; a field left out keeps its current value.",
+      "description": "Replace a connection's configuration or environment, rename it, move it to another version of its definition, or set and remove its named values; a field left out keeps its current value.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -5271,6 +5425,81 @@
             "default": null,
             "description": "A new name for the connection; omit it to keep the current name.",
             "title": "Display Name"
+          },
+          "description": {
+            "anyOf": [
+              {
+                "maxLength": 2000,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Describe what this connection is for in the user's terms.",
+            "title": "Description"
+          },
+          "definition_version": {
+            "anyOf": [
+              {
+                "exclusiveMinimum": 0,
+                "maximum": 2147483647,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "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.",
+            "title": "Definition Version"
+          },
+          "values": {
+            "anyOf": [
+              {
+                "additionalProperties": {
+                  "anyOf": [
+                    {
+                      "description": "Secret: the value. Stored sealed and never returned.",
+                      "maxLength": 16384,
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "maxProperties": 100,
+                "minProperties": 1,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "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`.",
+            "title": "Values"
+          },
+          "environment": {
+            "anyOf": [
+              {
+                "additionalProperties": {
+                  "maxLength": 4096,
+                  "type": "string"
+                },
+                "maxProperties": 64,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "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.",
+            "title": "Environment"
           }
         },
         "required": [
@@ -5295,6 +5524,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "definition_id": {
             "title": "Definition Id",
             "type": "string"
@@ -5346,6 +5579,7 @@
           "id",
           "workspace_id",
           "display_name",
+          "description",
           "definition_id",
           "definition_version",
           "visibility",
@@ -5368,7 +5602,7 @@
         "conflict",
         "resource_not_found"
       ],
-      "digest": "sha256:bfdfade43317e19a69e255667253ddb95fb974d649dfb0d64908950c7f565fc9"
+      "digest": "sha256:15dae788862b599d14e1a938952ce41ff262ba411dbf57e6a48b21ff9b3d2271"
     },
     {
       "name": "zo.connection_definition.list",
@@ -10641,7 +10875,7 @@
       "name": "zo.function.create",
       "version": 1,
       "publisher": "zo",
-      "description": "Create a workspace-owned function.",
+      "description": "Create a workspace-owned function. Describe what this function is for in the user's terms.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -10655,6 +10889,13 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "default": "",
+            "description": "Describe what this function is for in the user's terms.",
+            "maxLength": 2000,
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "default": "workspace",
             "enum": [
@@ -10698,6 +10939,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -10744,6 +10989,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "properties",
           "active_deployment_id",
@@ -10783,7 +11029,7 @@
       "error_codes": [
         "implementation_unavailable"
       ],
-      "digest": "sha256:ca84897748a382db73aefaa99e5ba5c761862603d8af8f44b159b1c526f4bc86"
+      "digest": "sha256:3a3f96335e4952f0e7d270fb6074c0fe94185b3394999696d8b530d902403b71"
     },
     {
       "name": "zo.function.delete",
@@ -11110,6 +11356,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -11170,6 +11420,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "properties",
           "active_deployment_id",
@@ -11452,7 +11703,7 @@
       "effect": "read",
       "result_kind": "inline",
       "error_codes": [],
-      "digest": "sha256:04f2e8f6c6faeefa8ca08a264cd18d2012b0bced62cf3cb19f269a98861798a2"
+      "digest": "sha256:8fefdcc1440b09264f2c0b0a31ef8f3cefb5f2fe79f0166341e7537addf89819"
     },
     {
       "name": "zo.function.get_run",
@@ -11865,6 +12116,10 @@
                 "title": "Display Name",
                 "type": "string"
               },
+              "description": {
+                "title": "Description",
+                "type": "string"
+              },
               "revision": {
                 "exclusiveMinimum": 0,
                 "maximum": 9007199254740991,
@@ -11911,6 +12166,7 @@
               "type",
               "type_version",
               "display_name",
+              "description",
               "revision",
               "properties",
               "active_deployment_id",
@@ -11930,7 +12186,7 @@
       "effect": "read",
       "result_kind": "inline",
       "error_codes": [],
-      "digest": "sha256:0f867836701588988416f212685e79214255cb5bea899ff05b5091054e93196e"
+      "digest": "sha256:5bdcf3d50f92889be5498dedee04a9145710f5b9a0093894844cc1e94897a146"
     },
     {
       "name": "zo.function.list_runs",
@@ -12278,7 +12534,7 @@
       "name": "zo.machine.create",
       "version": 1,
       "publisher": "zo",
-      "description": "Create a managed machine from a machine image and return its current view.",
+      "description": "Create a managed machine from a machine image and return its current view. Describe what this machine is for in the user's terms.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -12299,6 +12555,13 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "default": "",
+            "description": "Describe what this machine is for in the user's terms.",
+            "maxLength": 2000,
+            "title": "Description",
+            "type": "string"
+          },
           "source": {
             "$ref": "#/$defs/MachineSourceInput"
           },
@@ -12316,7 +12579,7 @@
           },
           "init": {
             "default": "none",
-            "description": "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=`.",
+            "description": "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`.",
             "enum": [
               "none",
               "image"
@@ -12340,9 +12603,32 @@
               }
             ],
             "default": null,
-            "description": "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`.",
+            "description": "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`.",
             "title": "Command"
           },
+          "environment": {
+            "additionalProperties": {
+              "maxLength": 4096,
+              "type": "string"
+            },
+            "default": {},
+            "description": "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.",
+            "maxProperties": 64,
+            "title": "Environment",
+            "type": "object"
+          },
+          "credentials": {
+            "default": [],
+            "description": "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.",
+            "items": {
+              "maxLength": 200,
+              "minLength": 1,
+              "type": "string"
+            },
+            "maxItems": 100,
+            "title": "Credentials",
+            "type": "array"
+          },
           "visibility": {
             "default": "workspace",
             "description": "`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.",
@@ -12365,15 +12651,62 @@
         "title": "MachineCreateInput",
         "type": "object",
         "$defs": {
-          "MachineLifecycleInput": {
+          "GpuType": {
+            "enum": [
+              "T4",
+              "L4",
+              "A10",
+              "L40S",
+              "A100",
+              "A100-40GB",
+              "A100-80GB",
+              "RTX-PRO-6000",
+              "H100",
+              "H100!",
+              "H200",
+              "B200",
+              "B200+",
+              "B300"
+            ],
+            "type": "string"
+          },
+          "MachineGpu": {
             "additionalProperties": false,
             "properties": {
-              "idle_timeout_seconds": {
-                "default": 900,
-                "maximum": 86400,
+              "type": {
+                "$ref": "#/$defs/GpuType"
+              },
+              "count": {
+                "maximum": 8,
                 "minimum": 1,
-                "title": "Idle Timeout Seconds",
+                "title": "Count",
                 "type": "integer"
+              }
+            },
+            "required": [
+              "type",
+              "count"
+            ],
+            "title": "MachineGpu",
+            "type": "object"
+          },
+          "MachineLifecycleInput": {
+            "additionalProperties": false,
+            "properties": {
+              "idle_timeout_seconds": {
+                "anyOf": [
+                  {
+                    "maximum": 86400,
+                    "minimum": 1,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "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.",
+                "title": "Idle Timeout Seconds"
               },
               "max_run_seconds": {
                 "maximum": 86400,
@@ -12403,6 +12736,17 @@
                 "minimum": 1,
                 "title": "Memory Mib",
                 "type": "integer"
+              },
+              "gpu": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/MachineGpu"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
               }
             },
             "required": [
@@ -12456,6 +12800,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "enum": [
               "workspace",
@@ -12537,6 +12885,23 @@
               }
             ],
             "title": "Destroyed At"
+          },
+          "recoverable_until": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Recoverable Until"
+          },
+          "recovery_acceptance_required": {
+            "default": false,
+            "title": "Recovery Acceptance Required",
+            "type": "boolean"
           }
         },
         "required": [
@@ -12545,6 +12910,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "visibility",
           "revision",
           "properties",
@@ -12560,6 +12926,25 @@
         "title": "ManagedMachineView",
         "type": "object",
         "$defs": {
+          "GpuType": {
+            "enum": [
+              "T4",
+              "L4",
+              "A10",
+              "L40S",
+              "A100",
+              "A100-40GB",
+              "A100-80GB",
+              "RTX-PRO-6000",
+              "H100",
+              "H100!",
+              "H200",
+              "B200",
+              "B200+",
+              "B300"
+            ],
+            "type": "string"
+          },
           "MachineBootedView": {
             "additionalProperties": false,
             "properties": {
@@ -12593,6 +12978,26 @@
             "title": "MachineBootedView",
             "type": "object"
           },
+          "MachineGpu": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "$ref": "#/$defs/GpuType"
+              },
+              "count": {
+                "maximum": 8,
+                "minimum": 1,
+                "title": "Count",
+                "type": "integer"
+              }
+            },
+            "required": [
+              "type",
+              "count"
+            ],
+            "title": "MachineGpu",
+            "type": "object"
+          },
           "MachineProperties": {
             "additionalProperties": false,
             "description": "Public properties of a `machine` resource.\n\nFive dimensions say what kind of machine it is, in supported combinations\nonly. A managed sandbox also carries its image, shape and region,\nplus desired timers and boot settings; every other kind\ncarries null there. Lifecycle state is not a property.",
@@ -12675,6 +13080,17 @@
                 ],
                 "title": "Memory Mib"
               },
+              "gpu": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/MachineGpu"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
               "region": {
                 "anyOf": [
                   {
@@ -12746,6 +13162,38 @@
                 ],
                 "default": null,
                 "title": "Command"
+              },
+              "environment": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "maxLength": 4096,
+                      "type": "string"
+                    },
+                    "maxProperties": 64,
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Environment"
+              },
+              "credentials": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Credentials"
               }
             },
             "required": [
@@ -12792,7 +13240,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:e2ff77f02465e7be474b0734ba2af6f084454949638756bb4cf6a1c62b8d404e"
+      "digest": "sha256:177af508fda4d92f9592aae4499bd52ef51b2b90221200f81b26c5fcb86ce51f"
     },
     {
       "name": "zo.machine.destroy",
@@ -12854,6 +13302,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "enum": [
               "workspace",
@@ -12935,6 +13387,23 @@
               }
             ],
             "title": "Destroyed At"
+          },
+          "recoverable_until": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Recoverable Until"
+          },
+          "recovery_acceptance_required": {
+            "default": false,
+            "title": "Recovery Acceptance Required",
+            "type": "boolean"
           }
         },
         "required": [
@@ -12943,6 +13412,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "visibility",
           "revision",
           "properties",
@@ -12958,6 +13428,25 @@
         "title": "ManagedMachineView",
         "type": "object",
         "$defs": {
+          "GpuType": {
+            "enum": [
+              "T4",
+              "L4",
+              "A10",
+              "L40S",
+              "A100",
+              "A100-40GB",
+              "A100-80GB",
+              "RTX-PRO-6000",
+              "H100",
+              "H100!",
+              "H200",
+              "B200",
+              "B200+",
+              "B300"
+            ],
+            "type": "string"
+          },
           "MachineBootedView": {
             "additionalProperties": false,
             "properties": {
@@ -12991,6 +13480,26 @@
             "title": "MachineBootedView",
             "type": "object"
           },
+          "MachineGpu": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "$ref": "#/$defs/GpuType"
+              },
+              "count": {
+                "maximum": 8,
+                "minimum": 1,
+                "title": "Count",
+                "type": "integer"
+              }
+            },
+            "required": [
+              "type",
+              "count"
+            ],
+            "title": "MachineGpu",
+            "type": "object"
+          },
           "MachineProperties": {
             "additionalProperties": false,
             "description": "Public properties of a `machine` resource.\n\nFive dimensions say what kind of machine it is, in supported combinations\nonly. A managed sandbox also carries its image, shape and region,\nplus desired timers and boot settings; every other kind\ncarries null there. Lifecycle state is not a property.",
@@ -13073,6 +13582,17 @@
                 ],
                 "title": "Memory Mib"
               },
+              "gpu": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/MachineGpu"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
               "region": {
                 "anyOf": [
                   {
@@ -13144,6 +13664,38 @@
                 ],
                 "default": null,
                 "title": "Command"
+              },
+              "environment": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "maxLength": 4096,
+                      "type": "string"
+                    },
+                    "maxProperties": 64,
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Environment"
+              },
+              "credentials": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Credentials"
               }
             },
             "required": [
@@ -13190,7 +13742,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:aa2370f3cbc14f2d8ac18b1218b640d8e86a4609378b6c07bb0f980b6d0aa1f1"
+      "digest": "sha256:2f2f27929bbf88428f843c2be5448675a4fc34276d194fdb2d00fd10a7ef32d3"
     },
     {
       "name": "zo.machine.exec",
@@ -13328,6 +13880,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "enum": [
               "workspace",
@@ -13409,6 +13965,23 @@
               }
             ],
             "title": "Destroyed At"
+          },
+          "recoverable_until": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Recoverable Until"
+          },
+          "recovery_acceptance_required": {
+            "default": false,
+            "title": "Recovery Acceptance Required",
+            "type": "boolean"
           }
         },
         "required": [
@@ -13417,6 +13990,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "visibility",
           "revision",
           "properties",
@@ -13432,6 +14006,25 @@
         "title": "ManagedMachineView",
         "type": "object",
         "$defs": {
+          "GpuType": {
+            "enum": [
+              "T4",
+              "L4",
+              "A10",
+              "L40S",
+              "A100",
+              "A100-40GB",
+              "A100-80GB",
+              "RTX-PRO-6000",
+              "H100",
+              "H100!",
+              "H200",
+              "B200",
+              "B200+",
+              "B300"
+            ],
+            "type": "string"
+          },
           "MachineBootedView": {
             "additionalProperties": false,
             "properties": {
@@ -13465,6 +14058,26 @@
             "title": "MachineBootedView",
             "type": "object"
           },
+          "MachineGpu": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "$ref": "#/$defs/GpuType"
+              },
+              "count": {
+                "maximum": 8,
+                "minimum": 1,
+                "title": "Count",
+                "type": "integer"
+              }
+            },
+            "required": [
+              "type",
+              "count"
+            ],
+            "title": "MachineGpu",
+            "type": "object"
+          },
           "MachineProperties": {
             "additionalProperties": false,
             "description": "Public properties of a `machine` resource.\n\nFive dimensions say what kind of machine it is, in supported combinations\nonly. A managed sandbox also carries its image, shape and region,\nplus desired timers and boot settings; every other kind\ncarries null there. Lifecycle state is not a property.",
@@ -13547,6 +14160,17 @@
                 ],
                 "title": "Memory Mib"
               },
+              "gpu": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/MachineGpu"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
               "region": {
                 "anyOf": [
                   {
@@ -13618,6 +14242,38 @@
                 ],
                 "default": null,
                 "title": "Command"
+              },
+              "environment": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "maxLength": 4096,
+                      "type": "string"
+                    },
+                    "maxProperties": 64,
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Environment"
+              },
+              "credentials": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Credentials"
               }
             },
             "required": [
@@ -13662,7 +14318,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:137a936d3a72cf4d5815b244ad69ec75bb8aeca74a2bfd134d34e7f9698c8665"
+      "digest": "sha256:fedb37635e30c6aa33c67739751dfc7cd6bcb9463f58497abef71894c2f143be"
     },
     {
       "name": "zo.machine.list",
@@ -13712,6 +14368,25 @@
         "title": "ManagedMachineListOutput",
         "type": "object",
         "$defs": {
+          "GpuType": {
+            "enum": [
+              "T4",
+              "L4",
+              "A10",
+              "L40S",
+              "A100",
+              "A100-40GB",
+              "A100-80GB",
+              "RTX-PRO-6000",
+              "H100",
+              "H100!",
+              "H200",
+              "B200",
+              "B200+",
+              "B300"
+            ],
+            "type": "string"
+          },
           "MachineBootedView": {
             "additionalProperties": false,
             "properties": {
@@ -13745,6 +14420,26 @@
             "title": "MachineBootedView",
             "type": "object"
           },
+          "MachineGpu": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "$ref": "#/$defs/GpuType"
+              },
+              "count": {
+                "maximum": 8,
+                "minimum": 1,
+                "title": "Count",
+                "type": "integer"
+              }
+            },
+            "required": [
+              "type",
+              "count"
+            ],
+            "title": "MachineGpu",
+            "type": "object"
+          },
           "MachineProperties": {
             "additionalProperties": false,
             "description": "Public properties of a `machine` resource.\n\nFive dimensions say what kind of machine it is, in supported combinations\nonly. A managed sandbox also carries its image, shape and region,\nplus desired timers and boot settings; every other kind\ncarries null there. Lifecycle state is not a property.",
@@ -13827,6 +14522,17 @@
                 ],
                 "title": "Memory Mib"
               },
+              "gpu": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/MachineGpu"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
               "region": {
                 "anyOf": [
                   {
@@ -13898,6 +14604,38 @@
                 ],
                 "default": null,
                 "title": "Command"
+              },
+              "environment": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "maxLength": 4096,
+                      "type": "string"
+                    },
+                    "maxProperties": 64,
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Environment"
+              },
+              "credentials": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Credentials"
               }
             },
             "required": [
@@ -13942,6 +14680,10 @@
                 "title": "Display Name",
                 "type": "string"
               },
+              "description": {
+                "title": "Description",
+                "type": "string"
+              },
               "visibility": {
                 "enum": [
                   "workspace",
@@ -14023,6 +14765,23 @@
                   }
                 ],
                 "title": "Destroyed At"
+              },
+              "recoverable_until": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Recoverable Until"
+              },
+              "recovery_acceptance_required": {
+                "default": false,
+                "title": "Recovery Acceptance Required",
+                "type": "boolean"
               }
             },
             "required": [
@@ -14031,6 +14790,7 @@
               "type",
               "type_version",
               "display_name",
+              "description",
               "visibility",
               "revision",
               "properties",
@@ -14072,13 +14832,13 @@
         "invalid_cursor",
         "implementation_unavailable"
       ],
-      "digest": "sha256:06241169072bd5874b8deaf5ceed070861a5ecf07bc7dc71a68decf726e5dbcf"
+      "digest": "sha256:eec29f1b2d49d923a19a2ec3cd793f803ec02ac4a6a2aa1449dfbb4935967990"
     },
     {
       "name": "zo.machine.list_configurations",
       "version": 1,
       "publisher": "zo",
-      "description": "List independent whole-vCPU and whole-MiB ranges, regions, timeout bounds and per-second unit prices.",
+      "description": "List independent CPU/RAM bounds, GPU allocations, runtime capabilities, timers and per-second unit prices.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -14100,6 +14860,18 @@
           "resources": {
             "$ref": "#/$defs/MachineResourceBounds"
           },
+          "gpus": {
+            "items": {
+              "$ref": "#/$defs/MachineGpuOffer"
+            },
+            "title": "Gpus",
+            "type": "array"
+          },
+          "runtime": {
+            "const": "vm",
+            "title": "Runtime",
+            "type": "string"
+          },
           "vcpu_microusd_per_second": {
             "title": "Vcpu Microusd Per Second",
             "type": "number"
@@ -14146,6 +14918,8 @@
         },
         "required": [
           "resources",
+          "gpus",
+          "runtime",
           "vcpu_microusd_per_second",
           "memory_gib_microusd_per_second",
           "regions",
@@ -14183,6 +14957,57 @@
             "title": "MachineCommandOffer",
             "type": "object"
           },
+          "MachineGpuOffer": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "title": "Type",
+                "type": "string"
+              },
+              "count": {
+                "$ref": "#/$defs/MachineRunBounds"
+              },
+              "vram_gb": {
+                "title": "Vram Gb",
+                "type": "integer"
+              },
+              "gpu_microusd_per_second": {
+                "title": "Gpu Microusd Per Second",
+                "type": "number"
+              },
+              "runtime": {
+                "const": "gvisor",
+                "title": "Runtime",
+                "type": "string"
+              },
+              "init": {
+                "items": {
+                  "const": "none",
+                  "type": "string"
+                },
+                "title": "Init",
+                "type": "array"
+              },
+              "idle_timeout_seconds": {
+                "$ref": "#/$defs/MachineIdleTimeoutBounds"
+              },
+              "max_run_seconds": {
+                "$ref": "#/$defs/MachineRunBounds"
+              }
+            },
+            "required": [
+              "type",
+              "count",
+              "vram_gb",
+              "gpu_microusd_per_second",
+              "runtime",
+              "init",
+              "idle_timeout_seconds",
+              "max_run_seconds"
+            ],
+            "title": "MachineGpuOffer",
+            "type": "object"
+          },
           "MachineIdleTimeoutBounds": {
             "additionalProperties": false,
             "properties": {
@@ -14255,7 +15080,7 @@
       "error_codes": [
         "implementation_unavailable"
       ],
-      "digest": "sha256:b3ceea6f5d8b895e832abb2153916c2a104756d36aa1f573f37edcc61dd871f4"
+      "digest": "sha256:a8011aa7aa579dfc66c3cedbfbd25056d76a7b5c5063bbb7eab5d7c31be6cd3d"
     },
     {
       "name": "zo.machine.list_files",
@@ -14530,6 +15355,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "enum": [
               "workspace",
@@ -14611,6 +15440,23 @@
               }
             ],
             "title": "Destroyed At"
+          },
+          "recoverable_until": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Recoverable Until"
+          },
+          "recovery_acceptance_required": {
+            "default": false,
+            "title": "Recovery Acceptance Required",
+            "type": "boolean"
           }
         },
         "required": [
@@ -14619,6 +15465,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "visibility",
           "revision",
           "properties",
@@ -14634,6 +15481,25 @@
         "title": "ManagedMachineView",
         "type": "object",
         "$defs": {
+          "GpuType": {
+            "enum": [
+              "T4",
+              "L4",
+              "A10",
+              "L40S",
+              "A100",
+              "A100-40GB",
+              "A100-80GB",
+              "RTX-PRO-6000",
+              "H100",
+              "H100!",
+              "H200",
+              "B200",
+              "B200+",
+              "B300"
+            ],
+            "type": "string"
+          },
           "MachineBootedView": {
             "additionalProperties": false,
             "properties": {
@@ -14667,6 +15533,26 @@
             "title": "MachineBootedView",
             "type": "object"
           },
+          "MachineGpu": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "$ref": "#/$defs/GpuType"
+              },
+              "count": {
+                "maximum": 8,
+                "minimum": 1,
+                "title": "Count",
+                "type": "integer"
+              }
+            },
+            "required": [
+              "type",
+              "count"
+            ],
+            "title": "MachineGpu",
+            "type": "object"
+          },
           "MachineProperties": {
             "additionalProperties": false,
             "description": "Public properties of a `machine` resource.\n\nFive dimensions say what kind of machine it is, in supported combinations\nonly. A managed sandbox also carries its image, shape and region,\nplus desired timers and boot settings; every other kind\ncarries null there. Lifecycle state is not a property.",
@@ -14749,6 +15635,17 @@
                 ],
                 "title": "Memory Mib"
               },
+              "gpu": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/MachineGpu"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
               "region": {
                 "anyOf": [
                   {
@@ -14820,6 +15717,38 @@
                 ],
                 "default": null,
                 "title": "Command"
+              },
+              "environment": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "maxLength": 4096,
+                      "type": "string"
+                    },
+                    "maxProperties": 64,
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Environment"
+              },
+              "credentials": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Credentials"
               }
             },
             "required": [
@@ -14866,13 +15795,13 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:7d7da6a806a046d076be3631c4b1fa0ca2700b1431b1a917ce21bc3c600fa993"
+      "digest": "sha256:2e44526b75636d16e72c4f4c54bee0534b19beb8f63770d3e4b5f301599c6458"
     },
     {
       "name": "zo.machine.snapshot",
       "version": 1,
       "publisher": "zo",
-      "description": "Save a running managed machine's filesystem as a ready image. Destination options live under image. Image visibility defaults to the source; choose workspace or protected explicitly to override it. Finish filesystem writes first. Processes and credentials are not rebound from the source. User-written secrets remain in captured files. Never automatically retry an uncertain result.",
+      "description": "Save a running managed machine's filesystem as a ready image. Destination options live under image. Image visibility defaults to the source; choose workspace or protected explicitly to override it. Finish filesystem writes first. Processes and credentials are not rebound from the source. User-written secrets remain in captured files. Never automatically retry an uncertain result. Describe what this machine image is for in the user's terms.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -14915,6 +15844,13 @@
                 "title": "Display Name",
                 "type": "string"
               },
+              "description": {
+                "default": "",
+                "description": "Describe what this machine image is for in the user's terms.",
+                "maxLength": 2000,
+                "title": "Description",
+                "type": "string"
+              },
               "visibility": {
                 "anyOf": [
                   {
@@ -14968,6 +15904,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "enum": [
               "workspace",
@@ -15043,6 +15983,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "visibility",
           "revision",
           "properties",
@@ -15135,7 +16076,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:645ee2be3919a45a1e1ec2357a54f70d898def16f8fbf6dd5b586d54cd60314e"
+      "digest": "sha256:872a8c42e681e283f9f8b1b79825d5dbce069b7b39eae4139eb46ac93b57beca"
     },
     {
       "name": "zo.machine.stop",
@@ -15197,6 +16138,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "enum": [
               "workspace",
@@ -15278,6 +16223,23 @@
               }
             ],
             "title": "Destroyed At"
+          },
+          "recoverable_until": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Recoverable Until"
+          },
+          "recovery_acceptance_required": {
+            "default": false,
+            "title": "Recovery Acceptance Required",
+            "type": "boolean"
           }
         },
         "required": [
@@ -15286,6 +16248,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "visibility",
           "revision",
           "properties",
@@ -15301,6 +16264,25 @@
         "title": "ManagedMachineView",
         "type": "object",
         "$defs": {
+          "GpuType": {
+            "enum": [
+              "T4",
+              "L4",
+              "A10",
+              "L40S",
+              "A100",
+              "A100-40GB",
+              "A100-80GB",
+              "RTX-PRO-6000",
+              "H100",
+              "H100!",
+              "H200",
+              "B200",
+              "B200+",
+              "B300"
+            ],
+            "type": "string"
+          },
           "MachineBootedView": {
             "additionalProperties": false,
             "properties": {
@@ -15334,6 +16316,26 @@
             "title": "MachineBootedView",
             "type": "object"
           },
+          "MachineGpu": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "$ref": "#/$defs/GpuType"
+              },
+              "count": {
+                "maximum": 8,
+                "minimum": 1,
+                "title": "Count",
+                "type": "integer"
+              }
+            },
+            "required": [
+              "type",
+              "count"
+            ],
+            "title": "MachineGpu",
+            "type": "object"
+          },
           "MachineProperties": {
             "additionalProperties": false,
             "description": "Public properties of a `machine` resource.\n\nFive dimensions say what kind of machine it is, in supported combinations\nonly. A managed sandbox also carries its image, shape and region,\nplus desired timers and boot settings; every other kind\ncarries null there. Lifecycle state is not a property.",
@@ -15416,6 +16418,17 @@
                 ],
                 "title": "Memory Mib"
               },
+              "gpu": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/MachineGpu"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
               "region": {
                 "anyOf": [
                   {
@@ -15487,6 +16500,38 @@
                 ],
                 "default": null,
                 "title": "Command"
+              },
+              "environment": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "maxLength": 4096,
+                      "type": "string"
+                    },
+                    "maxProperties": 64,
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Environment"
+              },
+              "credentials": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Credentials"
               }
             },
             "required": [
@@ -15533,7 +16578,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:571e495b82a4147f416a12471d89baf8926ba3fbfc40c528c938bc2e46f3f66a"
+      "digest": "sha256:a4084a97871db1ea5edbe78ada81492054939eb0fbc3acf264c948b1339cee34"
     },
     {
       "name": "zo.machine.system_info",
@@ -15621,6 +16666,25 @@
             ],
             "type": "string"
           },
+          "GpuType": {
+            "enum": [
+              "T4",
+              "L4",
+              "A10",
+              "L40S",
+              "A100",
+              "A100-40GB",
+              "A100-80GB",
+              "RTX-PRO-6000",
+              "H100",
+              "H100!",
+              "H200",
+              "B200",
+              "B200+",
+              "B300"
+            ],
+            "type": "string"
+          },
           "InfoGroup": {
             "enum": [
               "architecture",
@@ -15694,6 +16758,26 @@
             "title": "MachineCapability",
             "type": "object"
           },
+          "MachineGpu": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "$ref": "#/$defs/GpuType"
+              },
+              "count": {
+                "maximum": 8,
+                "minimum": 1,
+                "title": "Count",
+                "type": "integer"
+              }
+            },
+            "required": [
+              "type",
+              "count"
+            ],
+            "title": "MachineGpu",
+            "type": "object"
+          },
           "MachineInfoAllocation": {
             "additionalProperties": false,
             "description": "The requested shape, and the provider-verified one once recorded. The\ntwo are separate facts; neither is a guest-visible count.",
@@ -15713,6 +16797,17 @@
                 "title": "Requested Memory Mib",
                 "type": "integer"
               },
+              "requested_gpu": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/MachineGpu"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null
+              },
               "verified_vcpus": {
                 "anyOf": [
                   {
@@ -15933,7 +17028,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:e2ef28262575d67a5fe38626362309179825db97db20185ee9f4ea97fa73623b"
+      "digest": "sha256:13a4cb98a7bac12bb3f96d98321733aecbb4445252488d641affe3976f539432"
     },
     {
       "name": "zo.machine.update",
@@ -15967,6 +17062,20 @@
             "default": null,
             "title": "Display Name"
           },
+          "description": {
+            "anyOf": [
+              {
+                "maxLength": 2000,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Describe what this machine is for in the user's terms.",
+            "title": "Description"
+          },
           "lifecycle": {
             "anyOf": [
               {
@@ -15992,7 +17101,7 @@
               }
             ],
             "default": null,
-            "description": "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.",
+            "description": "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.",
             "title": "Init"
           },
           "command": {
@@ -16011,14 +17120,51 @@
               }
             ],
             "default": null,
-            "description": "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.",
+            "description": "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.",
             "title": "Command"
           },
           "clear_command": {
             "default": false,
-            "description": "Remove the main process on the next resume. Requires manage permission only.",
+            "description": "Remove the main process on the next resume.",
             "title": "Clear Command",
             "type": "boolean"
+          },
+          "environment": {
+            "anyOf": [
+              {
+                "additionalProperties": {
+                  "maxLength": 4096,
+                  "type": "string"
+                },
+                "maxProperties": 64,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "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.",
+            "title": "Environment"
+          },
+          "credentials": {
+            "anyOf": [
+              {
+                "items": {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "maxItems": 100,
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "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.",
+            "title": "Credentials"
           }
         },
         "required": [
@@ -16084,6 +17230,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "idle_timeout_seconds": {
             "title": "Idle Timeout Seconds",
             "type": "integer"
@@ -16104,6 +17254,7 @@
           "machine_id",
           "revision",
           "display_name",
+          "description",
           "idle_timeout_seconds",
           "max_run_seconds"
         ],
@@ -16124,7 +17275,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:49ca93944646dfc1d5f659607adc95718b2b1067e37aece52fc9c32579dab7cb"
+      "digest": "sha256:c6c5547e739a2d0696a0df3e4300727bffe8b77c42ecbcf2cdb4f945f98da011"
     },
     {
       "name": "zo.machine.write_bytes",
@@ -16290,6 +17441,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "enum": [
               "workspace",
@@ -16365,6 +17520,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "visibility",
           "revision",
           "properties",
@@ -16457,7 +17613,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:3f2149152dcee8d81e441ab66b5903709a1ff50dc0c023d43c2ce1b4f44e7598"
+      "digest": "sha256:a073d8d08bad780f0c6e993ef023b13ce903908bd1a0e0ad98d305b845a4f36f"
     },
     {
       "name": "zo.machine_image.get",
@@ -16505,6 +17661,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "enum": [
               "workspace",
@@ -16580,6 +17740,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "visibility",
           "revision",
           "properties",
@@ -16669,13 +17830,13 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:95151f7bcd3dbf6264e830ac1854083915d5d2ab6ac240c7e3eadf06d3de91fb"
+      "digest": "sha256:5dfdc9267c96522de0e7db27a1aeb7aa5d2745910879dd164b5c3ab68adde4fb"
     },
     {
       "name": "zo.machine_image.import",
       "version": 1,
       "publisher": "zo",
-      "description": "Import a registry image, pinned to its manifest digest, and return the image view.",
+      "description": "Import a registry image, pinned to its manifest digest, and return the image view. Describe what this machine image is for in the user's terms.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -16685,6 +17846,13 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "default": "",
+            "description": "Describe what this machine image is for in the user's terms.",
+            "maxLength": 2000,
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "default": "workspace",
             "description": "`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.",
@@ -16777,6 +17945,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "enum": [
               "workspace",
@@ -16852,6 +18024,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "visibility",
           "revision",
           "properties",
@@ -16944,7 +18117,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:72d2b0b6cb83955b9624e6ffe058dcc0733db58d0db7846da55a919c35ddd750"
+      "digest": "sha256:9e0bb0fb82671c75e48f20e96301fcf1f8d98bb5f5838667e3ed9b29cd0cc375"
     },
     {
       "name": "zo.machine_image.list",
@@ -17084,6 +18257,10 @@
                 "title": "Display Name",
                 "type": "string"
               },
+              "description": {
+                "title": "Description",
+                "type": "string"
+              },
               "visibility": {
                 "enum": [
                   "workspace",
@@ -17159,6 +18336,7 @@
               "type",
               "type_version",
               "display_name",
+              "description",
               "visibility",
               "revision",
               "properties",
@@ -17185,7 +18363,7 @@
         "invalid_cursor",
         "implementation_unavailable"
       ],
-      "digest": "sha256:8c64e821d1d72a4b55881a7387aff27342b1913d63728e2adfa84f0f926e03f5"
+      "digest": "sha256:e26cac898b1ec2ac11b4576d9825c8ace5be890ef92d7081f9d15e8c932ef0e5"
     },
     {
       "name": "zo.message.get",
@@ -18372,7 +19550,7 @@
       "name": "zo.schedule.create",
       "version": 1,
       "publisher": "zo",
-      "description": "Create a schedule.",
+      "description": "Create a schedule. Describe what this schedule is for in the user's terms.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -18388,6 +19566,13 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "default": "",
+            "description": "Describe what this schedule is for in the user's terms.",
+            "maxLength": 2000,
+            "title": "Description",
+            "type": "string"
+          },
           "rrule": {
             "maxLength": 1000,
             "minLength": 1,
@@ -18454,6 +19639,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -18560,6 +19749,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "visibility",
           "owner_user_id",
@@ -18590,7 +19780,7 @@
         "invalid_input",
         "conflict"
       ],
-      "digest": "sha256:8f693289756d382a8e744c9b215cdecce6707d630aa4443094964735385ac83d"
+      "digest": "sha256:d01b8626e136e81b3061302cf6903357ad9ca21624b3a45c04844535d60debd5"
     },
     {
       "name": "zo.schedule.delete",
@@ -18701,6 +19891,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -18807,6 +20001,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "visibility",
           "owner_user_id",
@@ -18836,7 +20031,7 @@
         "implementation_unavailable",
         "resource_not_found"
       ],
-      "digest": "sha256:b71d5c60e03878e6dcf965fa90173191b08be556f531629169a64d1d9d255190"
+      "digest": "sha256:963753b318bbba35f7cb4f862da14681781cb5be86e19fdc28de69b36db29393"
     },
     {
       "name": "zo.schedule.list",
@@ -18912,6 +20107,10 @@
                 "title": "Display Name",
                 "type": "string"
               },
+              "description": {
+                "title": "Description",
+                "type": "string"
+              },
               "revision": {
                 "exclusiveMinimum": 0,
                 "maximum": 9007199254740991,
@@ -19010,6 +20209,7 @@
               "type",
               "type_version",
               "display_name",
+              "description",
               "revision",
               "visibility",
               "owner_user_id",
@@ -19040,7 +20240,7 @@
         "implementation_unavailable",
         "invalid_cursor"
       ],
-      "digest": "sha256:385d37b7cad26dc41da87a40a0947af85ec9c29435ae9cb896e20ccdac095ef5"
+      "digest": "sha256:9bea265b3fafa8c506e6e3f17404de8a8d492174552aa785c6132fb40ea03395"
     },
     {
       "name": "zo.schedule.update",
@@ -19068,6 +20268,20 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "anyOf": [
+              {
+                "maxLength": 2000,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Describe what this schedule is for in the user's terms.",
+            "title": "Description"
+          },
           "rrule": {
             "maxLength": 1000,
             "minLength": 1,
@@ -19135,6 +20349,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -19241,6 +20459,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "visibility",
           "owner_user_id",
@@ -19272,7 +20491,7 @@
         "conflict",
         "resource_not_found"
       ],
-      "digest": "sha256:c852330fa645f3e7230229d75ec2ac29017a74338a6cf609297b696273f4c325"
+      "digest": "sha256:bd59de12c637d57f1f0ef188d956cd0f03ea0d7e1d5af0ab69b2c4db5e52da50"
     },
     {
       "name": "zo.source.complete",
@@ -20668,7 +21887,7 @@
       "name": "zo.subscription.create",
       "version": 2,
       "publisher": "zo",
-      "description": "Bind an event definition to a function entrypoint or a workflow's start run as a non-human execution principal, or to an Agent whose sessions receive each occurrence.",
+      "description": "Bind an event definition to a function entrypoint or a workflow's start run as a non-human execution principal, or to an Agent whose sessions receive each occurrence. Describe what this subscription is for in the user's terms.",
       "input_schema": {
         "additionalProperties": false,
         "description": "Bind an event definition to a handler. ``handler_resource_type`` is\n``function``, ``workflow`` or ``agent``. A Function target names\n``handler_resource_id``, ``handler_entrypoint``, ``input_contract_version``,\n``input_contract_kind`` and the ``execution_principal_id`` service account it\nruns as. A workflow target names ``workflow_id`` and the same fields but\n``handler_resource_id``: ``handler_entrypoint`` is ``start``, which begins a\nnew run per occurrence with the envelope as its ``event`` input, and\n``input_contract_version`` is 1, the contract of that input. An Agent\ntarget names ``agent_id``, the ``agent_priority`` an occurrence enters a turn\nwith (``queue``, ``steer`` or ``interrupt``), the ``agent_session_policy``\nthat picks its session (``new``; ``fixed``, with ``agent_session_id``; or\n``per_conversation``, for an event with a ``conversation_path``, keyed in\n``agent_session_scope``, the event's ``<publisher>/<name>`` when omitted)\nand optional ``agent_instructions`` shown with every occurrence. Fields of\nthe other handler type are refused. Omit ``filter`` to receive every\noccurrence.",
@@ -20687,6 +21906,13 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "default": "",
+            "description": "Describe what this subscription is for in the user's terms.",
+            "maxLength": 2000,
+            "title": "Description",
+            "type": "string"
+          },
           "filter": {
             "anyOf": [
               {
@@ -21312,6 +22538,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -21529,6 +22759,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "properties",
           "event_type",
@@ -22051,7 +23282,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:154bafc3367647707039d03a47622b34245691f22fadf4b89c159120c4a00f41"
+      "digest": "sha256:8e9b1435cc7a44463c1b3a763000b0331cb0ef2f3aff18be8aed7e2a5e7d7a9e"
     },
     {
       "name": "zo.subscription.delete",
@@ -22966,6 +24197,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -23194,6 +24429,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "properties",
           "event_type",
@@ -23840,7 +25076,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:73d6e4a764ed4b5cc58ff16efe4ff2d02fdc878f477325384712f52d513bd9d8"
+      "digest": "sha256:b87a997bc826d53053a86e77acc2e5d9e369347168b11b41c209df2b1aa5c193"
     },
     {
       "name": "zo.subscription.list",
@@ -25051,6 +26287,10 @@
                 "title": "Display Name",
                 "type": "string"
               },
+              "description": {
+                "title": "Description",
+                "type": "string"
+              },
               "revision": {
                 "exclusiveMinimum": 0,
                 "maximum": 9007199254740991,
@@ -25268,6 +26508,7 @@
               "type",
               "type_version",
               "display_name",
+              "description",
               "revision",
               "properties",
               "event_type",
@@ -25306,7 +26547,7 @@
         "invalid_cursor",
         "implementation_unavailable"
       ],
-      "digest": "sha256:ce9c299c43c5553699c4c81c2de3aaa5674de5b9aed5a7dff826c5f8f4e2eb8b"
+      "digest": "sha256:4917ff24cbee91ba140a6149664b94556a39e1c0d0ea2df39a7938106831a0e0"
     },
     {
       "name": "zo.subscription.update",
@@ -26452,7 +27693,7 @@
       "description": "Replace a subscription's configuration and lifecycle at the expected revision.",
       "input_schema": {
         "additionalProperties": false,
-        "description": "Full replacement of every create field but the workspace and the event (a new\ndefinition or version is a new subscription), plus ``lifecycle``: ``active``\nresumes a paused or suspended subscription, ``paused`` pauses it;\n``zo.subscription.delete`` retires. ``handler_resource_type`` must be the\nsubscription's own: a different handler type is a new subscription.",
+        "description": "Replace create fields except workspace, event and optional description.\nA new event definition or version requires a new subscription.\nOmitted or null description keeps its value. ``lifecycle``: ``active``\nresumes a paused or suspended subscription, ``paused`` pauses it;\n``zo.subscription.delete`` retires. ``handler_resource_type`` must be the\nsubscription's own: a different handler type is a new subscription.",
         "properties": {
           "subscription_id": {
             "title": "Subscription Id",
@@ -26470,6 +27711,20 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "anyOf": [
+              {
+                "maxLength": 2000,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Describe what this subscription is for in the user's terms.",
+            "title": "Description"
+          },
           "filter": {
             "anyOf": [
               {
@@ -27095,6 +28350,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -27312,6 +28571,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "properties",
           "event_type",
@@ -27831,7 +29091,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:a76cf78cee9bda330e590942f448e6cd6690ed30d6155c0995f63aec56cb7110"
+      "digest": "sha256:b6dacc05c901e8a6e80d8de6f54a8ce22e66d6a46120056122277b54f11f1360"
     },
     {
       "name": "zo.tag.assign",
@@ -34026,7 +35286,7 @@
       "name": "zo.website.create",
       "version": 1,
       "publisher": "zo",
-      "description": "Create a Website address in a workspace.",
+      "description": "Create a Website address in a workspace. Describe what this Website is for in the user's terms.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -34047,6 +35307,13 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "default": "",
+            "description": "Describe what this Website is for in the user's terms.",
+            "maxLength": 2000,
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "default": "workspace",
             "enum": [
@@ -34084,6 +35351,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "generated_hostname": {
             "title": "Generated Hostname",
             "type": "string"
@@ -34142,6 +35413,7 @@
           "workspace_id",
           "slug",
           "display_name",
+          "description",
           "generated_hostname",
           "custom_hostname",
           "access",
@@ -34193,7 +35465,7 @@
         "invalid_input",
         "conflict"
       ],
-      "digest": "sha256:9ba23e6af8e25fa7bc9f169ff63d949dc8b719b2213089fee922218e38d2546b"
+      "digest": "sha256:11c07fbf5d7ad7546db624a32b0fa0d3d091a3750e5f299280cd79e44b6d457c"
     },
     {
       "name": "zo.website.delete",
@@ -34296,6 +35568,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "generated_hostname": {
             "title": "Generated Hostname",
             "type": "string"
@@ -34354,6 +35630,7 @@
           "workspace_id",
           "slug",
           "display_name",
+          "description",
           "generated_hostname",
           "custom_hostname",
           "access",
@@ -34404,7 +35681,7 @@
         "implementation_unavailable",
         "resource_not_found"
       ],
-      "digest": "sha256:de2e733773d831c4c44cc5078200e3a25574ba956ed3ecb298a5ed2219912cd2"
+      "digest": "sha256:69267cde0d466e6011a6f11dc475ea6b7ef928541ecb2ee0f77db72a6d51dd79"
     },
     {
       "name": "zo.website.list",
@@ -34616,6 +35893,10 @@
                 "title": "Display Name",
                 "type": "string"
               },
+              "description": {
+                "title": "Description",
+                "type": "string"
+              },
               "generated_hostname": {
                 "title": "Generated Hostname",
                 "type": "string"
@@ -34686,6 +35967,7 @@
               "workspace_id",
               "slug",
               "display_name",
+              "description",
               "generated_hostname",
               "custom_hostname",
               "access",
@@ -34788,7 +36070,7 @@
         "implementation_unavailable",
         "invalid_input"
       ],
-      "digest": "sha256:f4646e08b3b031b5a408e082f348c09fb1f3a06530cd299a7cb7ea3ef466fae1"
+      "digest": "sha256:54c7ec12e23d6d642a6b738f23797aacb945e4bafebf4604b15c12ecf70d019f"
     },
     {
       "name": "zo.website.update",
@@ -34824,6 +36106,20 @@
             "default": null,
             "title": "Display Name"
           },
+          "description": {
+            "anyOf": [
+              {
+                "maxLength": 2000,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Describe what this Website is for in the user's terms.",
+            "title": "Description"
+          },
           "custom_hostname": {
             "anyOf": [
               {
@@ -34887,6 +36183,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "generated_hostname": {
             "title": "Generated Hostname",
             "type": "string"
@@ -34945,6 +36245,7 @@
           "workspace_id",
           "slug",
           "display_name",
+          "description",
           "generated_hostname",
           "custom_hostname",
           "access",
@@ -34996,7 +36297,7 @@
         "invalid_input",
         "conflict"
       ],
-      "digest": "sha256:65402621deb4ac22ada90c12fdb41cb83d496852c03fff65e35e95eed7ff7dd4"
+      "digest": "sha256:6900ed69ecf24c10329a7e4277a228d5d1fa0d68e445e51744e89201d0d675da"
     },
     {
       "name": "zo.website_route.create",
@@ -37042,7 +38343,7 @@
       "name": "zo.workflow.create",
       "version": 1,
       "publisher": "zo",
-      "description": "Create a workflow in a workspace.",
+      "description": "Create a workflow in a workspace. Describe what this workflow is for in the user's terms.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -37056,6 +38357,13 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "default": "",
+            "description": "Describe what this workflow is for in the user's terms.",
+            "maxLength": 2000,
+            "title": "Description",
+            "type": "string"
+          },
           "visibility": {
             "default": "workspace",
             "enum": [
@@ -37099,6 +38407,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -37157,6 +38469,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "active_revision_id",
           "latest_revision_id",
@@ -37177,7 +38490,7 @@
       "error_codes": [
         "implementation_unavailable"
       ],
-      "digest": "sha256:b371ae5ed9c329dc54fa04b05adf18f0058866c0c2465b603f3d4363726b38e1"
+      "digest": "sha256:e7b85fb404264583d7340a64f558b716531470bd3b11bdfc48872d677f4b6de7"
     },
     {
       "name": "zo.workflow.delete",
@@ -37287,6 +38600,10 @@
             "title": "Display Name",
             "type": "string"
           },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
           "revision": {
             "exclusiveMinimum": 0,
             "maximum": 9007199254740991,
@@ -37345,6 +38662,7 @@
           "type",
           "type_version",
           "display_name",
+          "description",
           "revision",
           "active_revision_id",
           "latest_revision_id",
@@ -37366,7 +38684,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:35816b8f25b6e870a125f9e98cfa6a6fcefc1cea5dddc30903a610eae80e84cf"
+      "digest": "sha256:412d31310a1dd06f3165aa8c5ead4b896106733579bfdd654d111a5636d5a40a"
     },
     {
       "name": "zo.workflow.get_run",
@@ -37783,6 +39101,10 @@
                 "title": "Display Name",
                 "type": "string"
               },
+              "description": {
+                "title": "Description",
+                "type": "string"
+              },
               "revision": {
                 "exclusiveMinimum": 0,
                 "maximum": 9007199254740991,
@@ -37841,6 +39163,7 @@
               "type",
               "type_version",
               "display_name",
+              "description",
               "revision",
               "active_revision_id",
               "latest_revision_id",
@@ -37863,7 +39186,7 @@
       "error_codes": [
         "implementation_unavailable"
       ],
-      "digest": "sha256:b42eaaafa002d0949c423a487c65b39e48f1ab3430e1ae14ebb14e9fa9e1e1a9"
+      "digest": "sha256:24bb99b80d44491a982fb96d4f0b76a81aa35de9cd6f2d8aaf5e6f521ee1b479"
     },
     {
       "name": "zo.workflow.list_runs",
@@ -38662,6 +39985,17 @@
             ],
             "title": "Memory Mib"
           },
+          "gpu": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/MachineGpu"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null
+          },
           "region": {
             "anyOf": [
               {
@@ -38733,6 +40067,38 @@
             ],
             "default": null,
             "title": "Command"
+          },
+          "environment": {
+            "anyOf": [
+              {
+                "additionalProperties": {
+                  "maxLength": 4096,
+                  "type": "string"
+                },
+                "maxProperties": 64,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Environment"
+          },
+          "credentials": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Credentials"
           }
         },
         "required": [
@@ -38749,9 +40115,50 @@
           "max_run_seconds"
         ],
         "title": "MachineProperties",
-        "type": "object"
+        "type": "object",
+        "$defs": {
+          "GpuType": {
+            "enum": [
+              "T4",
+              "L4",
+              "A10",
+              "L40S",
+              "A100",
+              "A100-40GB",
+              "A100-80GB",
+              "RTX-PRO-6000",
+              "H100",
+              "H100!",
+              "H200",
+              "B200",
+              "B200+",
+              "B300"
+            ],
+            "type": "string"
+          },
+          "MachineGpu": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "$ref": "#/$defs/GpuType"
+              },
+              "count": {
+                "maximum": 8,
+                "minimum": 1,
+                "title": "Count",
+                "type": "integer"
+              }
+            },
+            "required": [
+              "type",
+              "count"
+            ],
+            "title": "MachineGpu",
+            "type": "object"
+          }
+        }
       },
-      "digest": "sha256:64515eb4ae68a013b91cadf469f3112c758ebe440f36a6103bd53be66208d6ca"
+      "digest": "sha256:80d9978768454d265ee3e497e4fffc34a59f8137d814c435573b785bc742c66e"
     },
     {
       "type": "machine_image",