@zocomputer/system-api 0.2.0 → 0.3.0

package/dist/generate/cli.js

@@ -33,11 +33,11 @@ class CliError extends Error {
  */
 const MAX_EXPORT_BYTES = 4 * 1024 * 1024;
 /**
- * Client deadline for the export request. The service bounds its own work at 90s
+ * Client deadline for the export request. The service bounds its own work at 210s
  * (MAX_REQUEST_SECONDS); this leaves margin for the round trip, but a truly
  * stalled endpoint can never hang the CLI forever.
  */
-const EXPORT_TIMEOUT_MS = 120_000;
+const EXPORT_TIMEOUT_MS = 240_000;
 function parseArgs(argv) {
     const flags = new Map();
     let check = false;

package/dist/generated/catalog.js

@@ -474,6 +474,12 @@ export const catalog = defineCatalog({
                 1: { digest: "sha256:aadcb480b26c475386eb47a4694a413a0b118969638cd9bfd9d9e5d68b5f758e" },
             },
         },
+        "zo.model.list": {
+            defaultVersion: 1,
+            versions: {
+                1: { digest: "sha256:33b88b18e759ba942f7bf344798e5f693926666a1bc2947b75b1c1cc6e1a8fbc" },
+            },
+        },
         "zo.oauth_app.create": {
             defaultVersion: 1,
             versions: {

package/dist/generated/manifest.json

@@ -1,7 +1,7 @@
 {
   "generatorVersion": "0.1.0",
-  "schemaDigest": "sha256:72a660c4863ad100211dacc6ed13014d46a5311230b0e648e2870e2d4c3f0be4",
-  "bundleDigest": "sha256:de6be59967662af94952484e0c7aaa593df24fbe49b8bf15c25685e00f5194c4",
+  "schemaDigest": "sha256:f3723f93d9d519ebe2517e16cb3db50c99b38e60b9705187006ada3eaeb4e391",
+  "bundleDigest": "sha256:3a231dad9b11d51ce7019ce70c98d528eb3ee3144152814edc44a8c0ceaa1302",
   "actions": [
     {
       "action": "zo.activity.list",
@@ -403,6 +403,11 @@
       "version": 1,
       "digest": "sha256:aadcb480b26c475386eb47a4694a413a0b118969638cd9bfd9d9e5d68b5f758e"
     },
+    {
+      "action": "zo.model.list",
+      "version": 1,
+      "digest": "sha256:33b88b18e759ba942f7bf344798e5f693926666a1bc2947b75b1c1cc6e1a8fbc"
+    },
     {
       "action": "zo.oauth_app.create",
       "version": 1,

package/dist/generated/operations.d.ts

@@ -4372,6 +4372,145 @@ export interface ZoMessageGetOutputV1MessageDelivery {
      */
     reasoning: (string | null);
 }
+export interface ZoModelListInputV1 {
+    workspace_id: string;
+}
+export interface ZoModelListOutputV1 {
+    models: ZoModelListOutputV1ModelEntry[];
+    next_cursor: (string | null);
+}
+export interface ZoModelListOutputV1ModelEntry {
+    /**
+     * The ID to pass as model.
+     */
+    id: string;
+    display_name: string;
+    provider: string;
+    capabilities: ("text" | "structured_output" | "embedding" | "rerank" | "image" | "speech" | "transcription" | "video")[];
+    /**
+     * Media types the model accepts in file parts, such as image/* and text/*.
+     */
+    input_media: string[];
+    context_window_tokens: (number | null);
+    max_output_tokens: (number | null);
+    /**
+     * The reasoning levels the model offers. Empty when it has none.
+     */
+    reasoning_levels: string[];
+    /**
+     * Every setting the model accepts, with its allowed values. A setting not listed is refused with invalid_input before the call.
+     */
+    settings: ZoModelListOutputV1ModelSetting[];
+    /**
+     * Named limits for the model's actions, such as max_values.
+     */
+    limits: {
+        [k: string]: number;
+    };
+    /**
+     * Every rate the model is billed at, the rows zo.billing.list_rates returns for it. A call is charged at the rates whose conditions it meets.
+     */
+    prices: ZoModelListOutputV1ModelPrice[];
+    status: ("available" | "deprecated");
+}
+/**
+ * One setting the model accepts and the values it allows.
+ */
+export interface ZoModelListOutputV1ModelSetting {
+    /**
+     * The input field, such as temperature or reasoning.
+     */
+    name: string;
+    /**
+     * The smallest allowed value, as a decimal string.
+     */
+    minimum: (string | null);
+    /**
+     * The largest allowed value, as a decimal string.
+     */
+    maximum: (string | null);
+    /**
+     * The most items a list setting takes.
+     */
+    max_items: (number | null);
+    /**
+     * The allowed values of a string setting.
+     */
+    values: (string[] | null);
+}
+/**
+ * One of the model's rates: the row ``zo.billing.list_rates`` returns for it.
+ */
+export interface ZoModelListOutputV1ModelPrice {
+    /**
+     * The rate's key in zo.billing.list_rates.
+     */
+    rate_key: string;
+    /**
+     * The usage meter the rate prices, as zo.billing.list_rates names it.
+     */
+    meter: string;
+    /**
+     * What one billed unit is. input, output, cache_read and cache_write are tokens: the usage fields input_tokens, output_tokens, cache_read_tokens and cache_write_tokens. request is one generated output, such as an image or a video.
+     */
+    unit: ("input" | "output" | "cache_read" | "cache_write" | "request" | "character" | "millisecond" | "audio_minute" | "megapixel" | "video_second");
+    /**
+     * The workspace's current price for per units, as a decimal string.
+     */
+    usd: string;
+    /**
+     * How many units usd is for: 1000000 for tokens.
+     */
+    per: string;
+    conditions: ZoModelListOutputV1RateConditions;
+}
+/**
+ * When the rate applies, as zo.billing.list_rates gives it: input-token tiers for text models; operation, selector, resolution, quality, duration and quantity bounds for media models.
+ */
+export interface ZoModelListOutputV1RateConditions {
+    /**
+     * Inclusive request-size lower bound.
+     */
+    request_input_tokens_min?: (number | null);
+    /**
+     * Exclusive request-size upper bound.
+     */
+    request_input_tokens_max?: (number | null);
+    /**
+     * The matching tier prices the whole request.
+     */
+    whole_request?: boolean;
+    operation?: (string | null);
+    resolution?: (string | null);
+    quality?: (string | null);
+    duration_seconds?: (string | null);
+    quantity_min?: (string | null);
+    quantity_max?: (string | null);
+    included_quantity?: (string | null);
+    default_quantity?: (string | null);
+    quantity_argument?: (string | null);
+    selector?: {
+        [k: string]: JsonValue;
+    };
+    rounding?: ("none" | "ceil_step");
+}
+export interface ZoModelListQueryV1 {
+    /**
+     * Rows per page, at most 200; a larger value is reduced to it.
+     */
+    limit?: number;
+    /**
+     * The previous page's next_cursor, sent with the same sort, filter and search.
+     */
+    cursor?: string;
+    sort?: "id.asc";
+    filter?: {
+        /**
+         * Only models with this capability.
+         */
+        capability?: (("text" | "structured_output" | "embedding" | "rerank" | "image" | "speech" | "transcription" | "video") | null);
+    };
+}
 export interface ZoOauthAppCreateInputV1 {
     workspace_id: string;
     provider: string;
@@ -9037,6 +9176,13 @@ export type Operations = {
             output: ZoMessageGetOutputV1;
         };
     };
+    "zo.model.list": {
+        1: {
+            input: ZoModelListInputV1;
+            output: ZoModelListOutputV1;
+            query: ZoModelListQueryV1;
+        };
+    };
     "zo.oauth_app.create": {
         1: {
             input: ZoOauthAppCreateInputV1;
@@ -9543,6 +9689,7 @@ export type DefaultVersions = {
     "zo.machine_image.list": 1;
     "zo.machine_image.update": 1;
     "zo.message.get": 1;
+    "zo.model.list": 1;
     "zo.oauth_app.create": 1;
     "zo.oauth_app.delete": 1;
     "zo.oauth_app.get": 1;

package/dist/generated/schema.json

@@ -21141,6 +21141,501 @@
       ],
       "digest": "sha256:aadcb480b26c475386eb47a4694a413a0b118969638cd9bfd9d9e5d68b5f758e"
     },
+    {
+      "name": "zo.model.list",
+      "version": 1,
+      "publisher": "zo",
+      "description": "List the models this workspace can call, each with its ID, capabilities, accepted file types, reasoning levels, limits and current prices.",
+      "input_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "maxLength": 200,
+            "minLength": 1,
+            "title": "Workspace Id",
+            "type": "string"
+          }
+        },
+        "required": [
+          "workspace_id"
+        ],
+        "title": "ModelListInput",
+        "type": "object"
+      },
+      "output_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "models": {
+            "items": {
+              "$ref": "#/$defs/ModelEntry"
+            },
+            "title": "Models",
+            "type": "array"
+          },
+          "next_cursor": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Next Cursor"
+          }
+        },
+        "required": [
+          "models",
+          "next_cursor"
+        ],
+        "title": "ModelListResult",
+        "type": "object",
+        "$defs": {
+          "ModelEntry": {
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "description": "The ID to pass as model.",
+                "title": "Id",
+                "type": "string"
+              },
+              "display_name": {
+                "title": "Display Name",
+                "type": "string"
+              },
+              "provider": {
+                "title": "Provider",
+                "type": "string"
+              },
+              "capabilities": {
+                "items": {
+                  "enum": [
+                    "text",
+                    "structured_output",
+                    "embedding",
+                    "rerank",
+                    "image",
+                    "speech",
+                    "transcription",
+                    "video"
+                  ],
+                  "type": "string"
+                },
+                "title": "Capabilities",
+                "type": "array"
+              },
+              "input_media": {
+                "description": "Media types the model accepts in file parts, such as image/* and text/*.",
+                "items": {
+                  "type": "string"
+                },
+                "title": "Input Media",
+                "type": "array"
+              },
+              "context_window_tokens": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "title": "Context Window Tokens"
+              },
+              "max_output_tokens": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "title": "Max Output Tokens"
+              },
+              "reasoning_levels": {
+                "description": "The reasoning levels the model offers. Empty when it has none.",
+                "items": {
+                  "type": "string"
+                },
+                "title": "Reasoning Levels",
+                "type": "array"
+              },
+              "settings": {
+                "description": "Every setting the model accepts, with its allowed values. A setting not listed is refused with invalid_input before the call.",
+                "items": {
+                  "$ref": "#/$defs/ModelSetting"
+                },
+                "title": "Settings",
+                "type": "array"
+              },
+              "limits": {
+                "additionalProperties": {
+                  "type": "integer"
+                },
+                "description": "Named limits for the model's actions, such as max_values.",
+                "title": "Limits",
+                "type": "object"
+              },
+              "prices": {
+                "description": "Every rate the model is billed at, the rows zo.billing.list_rates returns for it. A call is charged at the rates whose conditions it meets.",
+                "items": {
+                  "$ref": "#/$defs/ModelPrice"
+                },
+                "title": "Prices",
+                "type": "array"
+              },
+              "status": {
+                "enum": [
+                  "available",
+                  "deprecated"
+                ],
+                "title": "Status",
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "display_name",
+              "provider",
+              "capabilities",
+              "input_media",
+              "context_window_tokens",
+              "max_output_tokens",
+              "reasoning_levels",
+              "settings",
+              "limits",
+              "prices",
+              "status"
+            ],
+            "title": "ModelEntry",
+            "type": "object"
+          },
+          "ModelPrice": {
+            "additionalProperties": false,
+            "description": "One of the model's rates: the row ``zo.billing.list_rates`` returns for it.",
+            "properties": {
+              "rate_key": {
+                "description": "The rate's key in zo.billing.list_rates.",
+                "title": "Rate Key",
+                "type": "string"
+              },
+              "meter": {
+                "description": "The usage meter the rate prices, as zo.billing.list_rates names it.",
+                "title": "Meter",
+                "type": "string"
+              },
+              "unit": {
+                "description": "What one billed unit is. input, output, cache_read and cache_write are tokens: the usage fields input_tokens, output_tokens, cache_read_tokens and cache_write_tokens. request is one generated output, such as an image or a video.",
+                "enum": [
+                  "input",
+                  "output",
+                  "cache_read",
+                  "cache_write",
+                  "request",
+                  "character",
+                  "millisecond",
+                  "audio_minute",
+                  "megapixel",
+                  "video_second"
+                ],
+                "title": "Unit",
+                "type": "string"
+              },
+              "usd": {
+                "description": "The workspace's current price for per units, as a decimal string.",
+                "maxLength": 200,
+                "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                "title": "Usd",
+                "type": "string"
+              },
+              "per": {
+                "description": "How many units usd is for: 1000000 for tokens.",
+                "maxLength": 200,
+                "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                "title": "Per",
+                "type": "string"
+              },
+              "conditions": {
+                "$ref": "#/$defs/RateConditions",
+                "description": "When the rate applies, as zo.billing.list_rates gives it: input-token tiers for text models; operation, selector, resolution, quality, duration and quantity bounds for media models."
+              }
+            },
+            "required": [
+              "rate_key",
+              "meter",
+              "unit",
+              "usd",
+              "per",
+              "conditions"
+            ],
+            "title": "ModelPrice",
+            "type": "object"
+          },
+          "ModelSetting": {
+            "additionalProperties": false,
+            "description": "One setting the model accepts and the values it allows.",
+            "properties": {
+              "name": {
+                "description": "The input field, such as temperature or reasoning.",
+                "title": "Name",
+                "type": "string"
+              },
+              "minimum": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The smallest allowed value, as a decimal string.",
+                "title": "Minimum"
+              },
+              "maximum": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The largest allowed value, as a decimal string.",
+                "title": "Maximum"
+              },
+              "max_items": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The most items a list setting takes.",
+                "title": "Max Items"
+              },
+              "values": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The allowed values of a string setting.",
+                "title": "Values"
+              }
+            },
+            "required": [
+              "name",
+              "minimum",
+              "maximum",
+              "max_items",
+              "values"
+            ],
+            "title": "ModelSetting",
+            "type": "object"
+          },
+          "RateConditions": {
+            "additionalProperties": false,
+            "properties": {
+              "request_input_tokens_min": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Inclusive request-size lower bound.",
+                "title": "Request Input Tokens Min"
+              },
+              "request_input_tokens_max": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Exclusive request-size upper bound.",
+                "title": "Request Input Tokens Max"
+              },
+              "whole_request": {
+                "default": true,
+                "description": "The matching tier prices the whole request.",
+                "title": "Whole Request",
+                "type": "boolean"
+              },
+              "operation": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Operation"
+              },
+              "resolution": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Resolution"
+              },
+              "quality": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Quality"
+              },
+              "duration_seconds": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Duration Seconds"
+              },
+              "quantity_min": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Quantity Min"
+              },
+              "quantity_max": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Quantity Max"
+              },
+              "included_quantity": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Included Quantity"
+              },
+              "default_quantity": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Default Quantity"
+              },
+              "quantity_argument": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Quantity Argument"
+              },
+              "selector": {
+                "additionalProperties": {
+                  "x-zo-json-value": true
+                },
+                "title": "Selector",
+                "type": "object"
+              },
+              "rounding": {
+                "default": "none",
+                "enum": [
+                  "none",
+                  "ceil_step"
+                ],
+                "title": "Rounding",
+                "type": "string"
+              }
+            },
+            "title": "RateConditions",
+            "type": "object",
+            "required": []
+          }
+        }
+      },
+      "target": {
+        "type": "workspace",
+        "input_pointer": "/workspace_id"
+      },
+      "additional_checks": [],
+      "effect": "read",
+      "result_kind": "inline",
+      "error_codes": [
+        "implementation_unavailable",
+        "invalid_input",
+        "invalid_cursor"
+      ],
+      "digest": "sha256:33b88b18e759ba942f7bf344798e5f693926666a1bc2947b75b1c1cc6e1a8fbc"
+    },
     {
       "name": "zo.oauth_app.create",
       "version": 1,
@@ -42950,6 +43445,7 @@
     "zo.machine_image.list": 1,
     "zo.machine_image.update": 1,
     "zo.message.get": 1,
+    "zo.model.list": 1,
     "zo.oauth_app.create": 1,
     "zo.oauth_app.delete": 1,
     "zo.oauth_app.get": 1,
@@ -44530,6 +45026,63 @@
       },
       "required": []
     },
+    "zo.model.list@1": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 100,
+          "description": "Rows per page, at most 200; a larger value is reduced to it."
+        },
+        "cursor": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 5504,
+          "description": "The previous page's next_cursor, sent with the same sort, filter and search."
+        },
+        "sort": {
+          "type": "string",
+          "enum": [
+            "id.asc"
+          ],
+          "default": "id.asc"
+        },
+        "filter": {
+          "additionalProperties": false,
+          "properties": {
+            "capability": {
+              "anyOf": [
+                {
+                  "enum": [
+                    "text",
+                    "structured_output",
+                    "embedding",
+                    "rerank",
+                    "image",
+                    "speech",
+                    "transcription",
+                    "video"
+                  ],
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only models with this capability.",
+              "title": "Capability"
+            }
+          },
+          "type": "object",
+          "required": [],
+          "default": {}
+        }
+      },
+      "required": []
+    },
     "zo.oauth_app.list@1": {
       "type": "object",
       "additionalProperties": false,

package/openapi.json

@@ -22444,6 +22444,501 @@
       ],
       "digest": "sha256:aadcb480b26c475386eb47a4694a413a0b118969638cd9bfd9d9e5d68b5f758e"
     },
+    {
+      "name": "zo.model.list",
+      "version": 1,
+      "publisher": "zo",
+      "description": "List the models this workspace can call, each with its ID, capabilities, accepted file types, reasoning levels, limits and current prices.",
+      "input_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "maxLength": 200,
+            "minLength": 1,
+            "title": "Workspace Id",
+            "type": "string"
+          }
+        },
+        "required": [
+          "workspace_id"
+        ],
+        "title": "ModelListInput",
+        "type": "object"
+      },
+      "output_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "models": {
+            "items": {
+              "$ref": "#/$defs/ModelEntry"
+            },
+            "title": "Models",
+            "type": "array"
+          },
+          "next_cursor": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Next Cursor"
+          }
+        },
+        "required": [
+          "models",
+          "next_cursor"
+        ],
+        "title": "ModelListResult",
+        "type": "object",
+        "$defs": {
+          "ModelEntry": {
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "description": "The ID to pass as model.",
+                "title": "Id",
+                "type": "string"
+              },
+              "display_name": {
+                "title": "Display Name",
+                "type": "string"
+              },
+              "provider": {
+                "title": "Provider",
+                "type": "string"
+              },
+              "capabilities": {
+                "items": {
+                  "enum": [
+                    "text",
+                    "structured_output",
+                    "embedding",
+                    "rerank",
+                    "image",
+                    "speech",
+                    "transcription",
+                    "video"
+                  ],
+                  "type": "string"
+                },
+                "title": "Capabilities",
+                "type": "array"
+              },
+              "input_media": {
+                "description": "Media types the model accepts in file parts, such as image/* and text/*.",
+                "items": {
+                  "type": "string"
+                },
+                "title": "Input Media",
+                "type": "array"
+              },
+              "context_window_tokens": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "title": "Context Window Tokens"
+              },
+              "max_output_tokens": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "title": "Max Output Tokens"
+              },
+              "reasoning_levels": {
+                "description": "The reasoning levels the model offers. Empty when it has none.",
+                "items": {
+                  "type": "string"
+                },
+                "title": "Reasoning Levels",
+                "type": "array"
+              },
+              "settings": {
+                "description": "Every setting the model accepts, with its allowed values. A setting not listed is refused with invalid_input before the call.",
+                "items": {
+                  "$ref": "#/$defs/ModelSetting"
+                },
+                "title": "Settings",
+                "type": "array"
+              },
+              "limits": {
+                "additionalProperties": {
+                  "type": "integer"
+                },
+                "description": "Named limits for the model's actions, such as max_values.",
+                "title": "Limits",
+                "type": "object"
+              },
+              "prices": {
+                "description": "Every rate the model is billed at, the rows zo.billing.list_rates returns for it. A call is charged at the rates whose conditions it meets.",
+                "items": {
+                  "$ref": "#/$defs/ModelPrice"
+                },
+                "title": "Prices",
+                "type": "array"
+              },
+              "status": {
+                "enum": [
+                  "available",
+                  "deprecated"
+                ],
+                "title": "Status",
+                "type": "string"
+              }
+            },
+            "required": [
+              "id",
+              "display_name",
+              "provider",
+              "capabilities",
+              "input_media",
+              "context_window_tokens",
+              "max_output_tokens",
+              "reasoning_levels",
+              "settings",
+              "limits",
+              "prices",
+              "status"
+            ],
+            "title": "ModelEntry",
+            "type": "object"
+          },
+          "ModelPrice": {
+            "additionalProperties": false,
+            "description": "One of the model's rates: the row ``zo.billing.list_rates`` returns for it.",
+            "properties": {
+              "rate_key": {
+                "description": "The rate's key in zo.billing.list_rates.",
+                "title": "Rate Key",
+                "type": "string"
+              },
+              "meter": {
+                "description": "The usage meter the rate prices, as zo.billing.list_rates names it.",
+                "title": "Meter",
+                "type": "string"
+              },
+              "unit": {
+                "description": "What one billed unit is. input, output, cache_read and cache_write are tokens: the usage fields input_tokens, output_tokens, cache_read_tokens and cache_write_tokens. request is one generated output, such as an image or a video.",
+                "enum": [
+                  "input",
+                  "output",
+                  "cache_read",
+                  "cache_write",
+                  "request",
+                  "character",
+                  "millisecond",
+                  "audio_minute",
+                  "megapixel",
+                  "video_second"
+                ],
+                "title": "Unit",
+                "type": "string"
+              },
+              "usd": {
+                "description": "The workspace's current price for per units, as a decimal string.",
+                "maxLength": 200,
+                "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                "title": "Usd",
+                "type": "string"
+              },
+              "per": {
+                "description": "How many units usd is for: 1000000 for tokens.",
+                "maxLength": 200,
+                "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                "title": "Per",
+                "type": "string"
+              },
+              "conditions": {
+                "$ref": "#/$defs/RateConditions",
+                "description": "When the rate applies, as zo.billing.list_rates gives it: input-token tiers for text models; operation, selector, resolution, quality, duration and quantity bounds for media models."
+              }
+            },
+            "required": [
+              "rate_key",
+              "meter",
+              "unit",
+              "usd",
+              "per",
+              "conditions"
+            ],
+            "title": "ModelPrice",
+            "type": "object"
+          },
+          "ModelSetting": {
+            "additionalProperties": false,
+            "description": "One setting the model accepts and the values it allows.",
+            "properties": {
+              "name": {
+                "description": "The input field, such as temperature or reasoning.",
+                "title": "Name",
+                "type": "string"
+              },
+              "minimum": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The smallest allowed value, as a decimal string.",
+                "title": "Minimum"
+              },
+              "maximum": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The largest allowed value, as a decimal string.",
+                "title": "Maximum"
+              },
+              "max_items": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The most items a list setting takes.",
+                "title": "Max Items"
+              },
+              "values": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The allowed values of a string setting.",
+                "title": "Values"
+              }
+            },
+            "required": [
+              "name",
+              "minimum",
+              "maximum",
+              "max_items",
+              "values"
+            ],
+            "title": "ModelSetting",
+            "type": "object"
+          },
+          "RateConditions": {
+            "additionalProperties": false,
+            "properties": {
+              "request_input_tokens_min": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Inclusive request-size lower bound.",
+                "title": "Request Input Tokens Min"
+              },
+              "request_input_tokens_max": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Exclusive request-size upper bound.",
+                "title": "Request Input Tokens Max"
+              },
+              "whole_request": {
+                "default": true,
+                "description": "The matching tier prices the whole request.",
+                "title": "Whole Request",
+                "type": "boolean"
+              },
+              "operation": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Operation"
+              },
+              "resolution": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Resolution"
+              },
+              "quality": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Quality"
+              },
+              "duration_seconds": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Duration Seconds"
+              },
+              "quantity_min": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Quantity Min"
+              },
+              "quantity_max": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Quantity Max"
+              },
+              "included_quantity": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Included Quantity"
+              },
+              "default_quantity": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "pattern": "^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Default Quantity"
+              },
+              "quantity_argument": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Quantity Argument"
+              },
+              "selector": {
+                "additionalProperties": {
+                  "x-zo-json-value": true
+                },
+                "title": "Selector",
+                "type": "object"
+              },
+              "rounding": {
+                "default": "none",
+                "enum": [
+                  "none",
+                  "ceil_step"
+                ],
+                "title": "Rounding",
+                "type": "string"
+              }
+            },
+            "title": "RateConditions",
+            "type": "object",
+            "required": []
+          }
+        }
+      },
+      "target": {
+        "type": "workspace",
+        "input_pointer": "/workspace_id"
+      },
+      "additional_checks": [],
+      "effect": "read",
+      "result_kind": "inline",
+      "error_codes": [
+        "implementation_unavailable",
+        "invalid_input",
+        "invalid_cursor"
+      ],
+      "digest": "sha256:33b88b18e759ba942f7bf344798e5f693926666a1bc2947b75b1c1cc6e1a8fbc"
+    },
     {
       "name": "zo.oauth_app.create",
       "version": 1,
@@ -44253,6 +44748,7 @@
     "zo.machine_image.list": 1,
     "zo.machine_image.update": 1,
     "zo.message.get": 1,
+    "zo.model.list": 1,
     "zo.oauth_app.create": 1,
     "zo.oauth_app.delete": 1,
     "zo.oauth_app.get": 1,
@@ -45833,6 +46329,63 @@
       },
       "required": []
     },
+    "zo.model.list@1": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 100,
+          "description": "Rows per page, at most 200; a larger value is reduced to it."
+        },
+        "cursor": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 5504,
+          "description": "The previous page's next_cursor, sent with the same sort, filter and search."
+        },
+        "sort": {
+          "type": "string",
+          "enum": [
+            "id.asc"
+          ],
+          "default": "id.asc"
+        },
+        "filter": {
+          "additionalProperties": false,
+          "properties": {
+            "capability": {
+              "anyOf": [
+                {
+                  "enum": [
+                    "text",
+                    "structured_output",
+                    "embedding",
+                    "rerank",
+                    "image",
+                    "speech",
+                    "transcription",
+                    "video"
+                  ],
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only models with this capability.",
+              "title": "Capability"
+            }
+          },
+          "type": "object",
+          "required": [],
+          "default": {}
+        }
+      },
+      "required": []
+    },
     "zo.oauth_app.list@1": {
       "type": "object",
       "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zocomputer/system-api",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Zo System API client runtime: typed invocation transport, catalog ABI, and structured errors.",
   "exports": {