@zocomputer/system-api 0.2.0 → 0.3.1

package/dist/generated/operations.d.ts

@@ -55,13 +55,17 @@ export interface ZoActivityListQueryV1 {
     sort?: "occurred_at.desc";
     filter?: {
         /**
-         * Only rows after this time.
+         * Only rows after this time. A run or turn row's time is when it ended.
          */
         occurred_after?: (string | null);
         /**
-         * Only rows before this time.
+         * Only rows before this time. A run or turn row's time is when it ended.
          */
         occurred_before?: (string | null);
+        /**
+         * Match any listed value for each details key; keys combine with AND. Empty is a no-op.
+         */
+        details?: (ZoActivityListQueryV1ActivityDetailsFilter | null);
         /**
          * Only what this principal did.
          */
@@ -88,6 +92,24 @@ export interface ZoActivityListQueryV1 {
         search?: (string | null);
     };
 }
+export interface ZoActivityListQueryV1ActivityDetailsFilter {
+    /**
+     * system_agent_turn_ended rows carry the runner's turn_outcome.
+     */
+    turn_outcome?: ([("completed" | "failed" | "cancelled" | "interrupted")] | [("completed" | "failed" | "cancelled" | "interrupted"), ("completed" | "failed" | "cancelled" | "interrupted")] | [("completed" | "failed" | "cancelled" | "interrupted"), ("completed" | "failed" | "cancelled" | "interrupted"), ("completed" | "failed" | "cancelled" | "interrupted")] | [("completed" | "failed" | "cancelled" | "interrupted"), ("completed" | "failed" | "cancelled" | "interrupted"), ("completed" | "failed" | "cancelled" | "interrupted"), ("completed" | "failed" | "cancelled" | "interrupted")] | null);
+    /**
+     * system_agent_turn_ended rows carry reason when the turn has an error reason.
+     */
+    reason?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
+    /**
+     * function_run_ended and workflow_run_ended carry error_code on errors. managed_machine_create_failed, managed_machine_resume_failed, machine_image_import_failed and database_create_failed carry error_code, including "none".
+     */
+    error_code?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
+    /**
+     * system_agent_turn_ended rows carry message or event; scheduled_runs_summarized rows carry schedule or event.
+     */
+    trigger?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
+}
 export interface ZoActivityListQueryV1EntityFilter {
     type: string;
     id: string;
@@ -425,7 +447,7 @@ export interface ZoAgentListMessagesOutputV1Message {
     workspace_id: string;
     author: ZoAgentListMessagesOutputV1PrincipalReference;
     recipient: ZoAgentListMessagesOutputV1PrincipalReference;
-    content: (ZoAgentListMessagesOutputV1TextBlock | ZoAgentListMessagesOutputV1ImageBlock | ZoAgentListMessagesOutputV1AudioBlock | ZoAgentListMessagesOutputV1ResourceBlock | ZoAgentListMessagesOutputV1ResourceLinkBlock)[];
+    content: (ZoAgentListMessagesOutputV1TextBlock | ZoAgentListMessagesOutputV1ImageBlock | ZoAgentListMessagesOutputV1AudioBlock | ZoAgentListMessagesOutputV1ResourceBlock | ZoAgentListMessagesOutputV1MessageResourceLinkBlock)[];
     created_at: string;
     /**
      * The delivery to the recipient Agent.
@@ -464,14 +486,24 @@ export interface ZoAgentListMessagesOutputV1EmbeddedResource {
     blob?: (string | null);
 }
 /**
- * On input, ``uri`` names an upload (``zo-upload://``). On output, a presigned URL for stored media.
+ * A stored file: ``uri`` is a URL valid for an hour, or ``zo-file://{file_id}`` once it's deleted.
  */
-export interface ZoAgentListMessagesOutputV1ResourceLinkBlock {
+export interface ZoAgentListMessagesOutputV1MessageResourceLinkBlock {
     type: "resource_link";
     uri: string;
     name: string;
     mimeType?: (string | null);
     size?: (number | null);
+    _meta: ZoAgentListMessagesOutputV1LinkMeta;
+}
+export interface ZoAgentListMessagesOutputV1LinkMeta {
+    zo: ZoAgentListMessagesOutputV1ZoLinkMeta;
+}
+export interface ZoAgentListMessagesOutputV1ZoLinkMeta {
+    /**
+     * The Knowledge file that holds the attachment.
+     */
+    file_id: string;
 }
 export interface ZoAgentListMessagesOutputV1MessageDelivery {
     session_id: string;
@@ -694,9 +726,33 @@ export interface ZoAgentSessionGetOutputV1 {
     agent_id: string;
     created_at: string;
     /**
-     * When the session's newest message or event was delivered to it; created_at when it has none.
+     * When the session last received an input or finished a turn; created_at when it has done neither.
      */
     last_activity_at: string;
+    /**
+     * Turns ended in the session; null for a session with no turn ended since turns were counted.
+     */
+    turn_count: (number | null);
+    /**
+     * The summed duration of turns ended since the count was filled.
+     */
+    turns_duration_ms: (number | null);
+    /**
+     * Milliseconds from created_at to last_turn_ended_at, rounded.
+     */
+    elapsed_ms: (number | null);
+    /**
+     * When the last turn ended, as an RFC 3339 time.
+     */
+    last_turn_ended_at: (string | null);
+    /**
+     * How the last turn ended.
+     */
+    last_turn_outcome: (("completed" | "cancelled" | "interrupted" | "failed") | null);
+    /**
+     * The reason the last turn ended with, such as model_error.
+     */
+    last_turn_reason: (string | null);
     /**
      * The model the session's next inputs run with.
      */
@@ -725,7 +781,23 @@ export interface ZoAgentSessionHistoryOutputV1AgentSessionHistoryItem {
      * Position in the session; the stream continues after the newest item's seq.
      */
     seq: number;
-    kind: ("input" | "response" | "tool_results");
+    kind: ("input" | "response" | "tool_results" | "turn_ended");
+    /**
+     * The turn that produced this item.
+     */
+    turn_id: string;
+    /**
+     * RFC 3339 row time, or the turn's end time for turn_ended; null when that end time was not recorded.
+     */
+    created_at: (string | null);
+    /**
+     * The turn's outcome on turn_ended; null on row items.
+     */
+    outcome: (("completed" | "cancelled" | "interrupted" | "failed") | null);
+    /**
+     * The turn's outcome reason on turn_ended; null on row items.
+     */
+    reason: (string | null);
     /**
      * ACP session/update updates, with Zo fields under _meta.zo.
      */
@@ -760,9 +832,33 @@ export interface ZoAgentSessionListOutputV1AgentSession {
     agent_id: string;
     created_at: string;
     /**
-     * When the session's newest message or event was delivered to it; created_at when it has none.
+     * When the session last received an input or finished a turn; created_at when it has done neither.
      */
     last_activity_at: string;
+    /**
+     * Turns ended in the session; null for a session with no turn ended since turns were counted.
+     */
+    turn_count: (number | null);
+    /**
+     * The summed duration of turns ended since the count was filled.
+     */
+    turns_duration_ms: (number | null);
+    /**
+     * Milliseconds from created_at to last_turn_ended_at, rounded.
+     */
+    elapsed_ms: (number | null);
+    /**
+     * When the last turn ended, as an RFC 3339 time.
+     */
+    last_turn_ended_at: (string | null);
+    /**
+     * How the last turn ended.
+     */
+    last_turn_outcome: (("completed" | "cancelled" | "interrupted" | "failed") | null);
+    /**
+     * The reason the last turn ended with, such as model_error.
+     */
+    last_turn_reason: (string | null);
     /**
      * The model the session's next inputs run with.
      */
@@ -782,6 +878,20 @@ export interface ZoAgentSessionListQueryV1 {
      */
     cursor?: string;
     sort?: ("id.asc" | "created_at.desc" | "created_at.asc" | "display_name.asc" | "last_activity_at.desc");
+    filter?: {
+        /**
+         * Only sessions whose last turn ended after this time, exclusively.
+         */
+        last_turn_ended_after?: (string | null);
+        /**
+         * Only sessions whose last turn ended before this time, exclusively.
+         */
+        last_turn_ended_before?: (string | null);
+        /**
+         * Only sessions whose last turn has any of these outcomes.
+         */
+        last_turn_outcome?: ([("completed" | "cancelled" | "interrupted" | "failed")] | [("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed")] | [("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed")] | [("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed")] | null);
+    };
 }
 export interface ZoAgentSessionListWorkspaceInputV1 {
     workspace_id: string;
@@ -800,9 +910,33 @@ export interface ZoAgentSessionListWorkspaceOutputV1AgentSession {
     agent_id: string;
     created_at: string;
     /**
-     * When the session's newest message or event was delivered to it; created_at when it has none.
+     * When the session last received an input or finished a turn; created_at when it has done neither.
      */
     last_activity_at: string;
+    /**
+     * Turns ended in the session; null for a session with no turn ended since turns were counted.
+     */
+    turn_count: (number | null);
+    /**
+     * The summed duration of turns ended since the count was filled.
+     */
+    turns_duration_ms: (number | null);
+    /**
+     * Milliseconds from created_at to last_turn_ended_at, rounded.
+     */
+    elapsed_ms: (number | null);
+    /**
+     * When the last turn ended, as an RFC 3339 time.
+     */
+    last_turn_ended_at: (string | null);
+    /**
+     * How the last turn ended.
+     */
+    last_turn_outcome: (("completed" | "cancelled" | "interrupted" | "failed") | null);
+    /**
+     * The reason the last turn ended with, such as model_error.
+     */
+    last_turn_reason: (string | null);
     /**
      * The model the session's next inputs run with.
      */
@@ -823,6 +957,18 @@ export interface ZoAgentSessionListWorkspaceQueryV1 {
     cursor?: string;
     sort?: ("id.asc" | "created_at.desc" | "created_at.asc" | "display_name.asc" | "last_activity_at.desc");
     filter?: {
+        /**
+         * Only sessions whose last turn ended after this time, exclusively.
+         */
+        last_turn_ended_after?: (string | null);
+        /**
+         * Only sessions whose last turn ended before this time, exclusively.
+         */
+        last_turn_ended_before?: (string | null);
+        /**
+         * Only sessions whose last turn has any of these outcomes.
+         */
+        last_turn_outcome?: ([("completed" | "cancelled" | "interrupted" | "failed")] | [("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed")] | [("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed")] | [("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed"), ("completed" | "cancelled" | "interrupted" | "failed")] | null);
         /**
          * Only this Agent's sessions.
          */
@@ -1261,15 +1407,27 @@ export interface ZoConnectionGetOutputV1 {
     environment: {
         [k: string]: string;
     };
+    /**
+     * When Zo last handed this connection's credential to a Function run or machine.
+     */
+    last_used_at: (string | null);
+    /**
+     * Whether Zo will deliver this connection's credential now.
+     */
+    usable: boolean;
+    /**
+     * Why Zo will not deliver this connection's credential now, or null when it will.
+     */
+    unusable_reason: (("definition_withdrawn" | "configuring" | "reauthorization_required" | "disabled") | null);
 }
 export interface ZoConnectionListInputV1 {
     workspace_id: string;
 }
 export interface ZoConnectionListOutputV1 {
-    connections: ZoConnectionListOutputV1ConnectionWithAccountsResource[];
+    connections: ZoConnectionListOutputV1ConnectionReadResource[];
     next_cursor: (string | null);
 }
-export interface ZoConnectionListOutputV1ConnectionWithAccountsResource {
+export interface ZoConnectionListOutputV1ConnectionReadResource {
     id: string;
     workspace_id: string;
     display_name: string;
@@ -1286,6 +1444,18 @@ export interface ZoConnectionListOutputV1ConnectionWithAccountsResource {
     environment: {
         [k: string]: string;
     };
+    /**
+     * When Zo last handed this connection's credential to a Function run or machine.
+     */
+    last_used_at: (string | null);
+    /**
+     * Whether Zo will deliver this connection's credential now.
+     */
+    usable: boolean;
+    /**
+     * Why Zo will not deliver this connection's credential now, or null when it will.
+     */
+    unusable_reason: (("definition_withdrawn" | "configuring" | "reauthorization_required" | "disabled") | null);
 }
 export interface ZoConnectionListQueryV1 {
     /**
@@ -2709,6 +2879,7 @@ export interface ZoFunctionGetOutputV1DeploymentWithSlotsSummary {
     invoke_enabled: boolean;
     http_enabled: boolean;
     created_at: string;
+    route_ids: string[];
     credential_slots: ZoFunctionGetOutputV1CredentialSlotSummary[];
 }
 /**
@@ -2733,6 +2904,9 @@ export interface ZoFunctionGetRunOutputV1 {
     id: string;
     function_id: string;
     deployment_id: string;
+    /**
+     * The API surface the run arrived through: `direct` for an invoke, `http` for a Website request; `connection` is reserved. Read `trigger` on the run for what started it.
+     */
     entry_kind: ("direct" | "connection" | "http");
     state: ZoFunctionGetRunOutputV1RunState;
     error_code: (string | null);
@@ -2744,12 +2918,53 @@ export interface ZoFunctionGetRunOutputV1 {
     result: JsonValue;
     result_available: boolean;
     parent: (ZoFunctionGetRunOutputV1RunParent | null);
+    trigger: ZoFunctionGetRunOutputV1RunTrigger;
 }
 export interface ZoFunctionGetRunOutputV1RunParent {
     workflow_run_id: string;
     step: string;
     iteration: number;
 }
+export interface ZoFunctionGetRunOutputV1RunTrigger {
+    /**
+     * What started the run.
+     */
+    kind: ("direct" | "http" | "event" | "workflow_step" | "run" | "agent");
+    /**
+     * The event subscription that delivered the run.
+     */
+    subscription_id: (string | null);
+    /**
+     * The event occurrence that delivered the run.
+     */
+    occurrence_id: (string | null);
+    /**
+     * The delivered event type.
+     */
+    event_type: (string | null);
+    /**
+     * The Function or Workflow run that started this run.
+     */
+    caller: (ZoFunctionGetRunOutputV1RunRef | null);
+    /**
+     * The Agent session that invoked the run.
+     */
+    agent_session_id: (string | null);
+}
+export interface ZoFunctionGetRunOutputV1RunRef {
+    /**
+     * The run that invoked this run.
+     */
+    run_id: string;
+    /**
+     * The caller's Function ID, or null for a Workflow run.
+     */
+    function_id: (string | null);
+    /**
+     * The caller's Workflow ID, or null for a Function run.
+     */
+    workflow_id: (string | null);
+}
 export interface ZoFunctionInvokeInputV1 {
     function_id: string;
     contract_version: number;
@@ -2811,6 +3026,9 @@ export interface ZoFunctionListQueryV1 {
      * The previous page's next_cursor, sent with the same sort, filter and search.
      */
     cursor?: string;
+    filter?: {
+        connection_id?: (string | null);
+    };
 }
 export interface ZoFunctionListRunsInputV1 {
     function_id: string;
@@ -2824,6 +3042,9 @@ export interface ZoFunctionListRunsOutputV1FunctionRunSummary {
     id: string;
     function_id: string;
     deployment_id: string;
+    /**
+     * The API surface the run arrived through: `direct` for an invoke, `http` for a Website request; `connection` is reserved. Read `trigger` on the run for what started it.
+     */
     entry_kind: ("direct" | "connection" | "http");
     state: ZoFunctionListRunsOutputV1RunState;
     error_code: (string | null);
@@ -2832,6 +3053,7 @@ export interface ZoFunctionListRunsOutputV1FunctionRunSummary {
     deadline: string;
     finished_at: (string | null);
 }
+export type ZoFunctionListRunsQueryV1RunState = ("queued" | "starting" | "running" | "succeeded" | "failed" | "cancel_requested" | "cancelled" | "unknown");
 export interface ZoFunctionListRunsQueryV1 {
     /**
      * Rows per page, at most 200; a larger value is reduced to it.
@@ -2841,6 +3063,45 @@ export interface ZoFunctionListRunsQueryV1 {
      * The previous page's next_cursor, sent with the same sort, filter and search.
      */
     cursor?: string;
+    sort?: ("created_at.desc" | "created_at.asc");
+    filter?: {
+        /**
+         * Only runs created after this time.
+         */
+        created_after?: (string | null);
+        /**
+         * Only runs created before this time.
+         */
+        created_before?: (string | null);
+        /**
+         * Only runs in any of these states.
+         */
+        state?: ([ZoFunctionListRunsQueryV1RunState] | [ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState] | [ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState] | [ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState] | [ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState] | [ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState] | [ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState] | [ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState, ZoFunctionListRunsQueryV1RunState] | null);
+        /**
+         * Only runs with any of these error codes.
+         */
+        error_code?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
+        /**
+         * Only runs of this deployment.
+         */
+        deployment_id?: (string | null);
+        /**
+         * Only runs with any of these entry kinds.
+         */
+        entry_kind?: ([("direct" | "connection" | "http")] | [("direct" | "connection" | "http"), ("direct" | "connection" | "http")] | [("direct" | "connection" | "http"), ("direct" | "connection" | "http"), ("direct" | "connection" | "http")] | null);
+        /**
+         * Only runs with any of these trigger kinds.
+         */
+        trigger?: ([("direct" | "http" | "event" | "workflow_step" | "run" | "agent")] | [("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent")] | [("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent")] | [("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent")] | [("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent")] | [("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent"), ("direct" | "http" | "event" | "workflow_step" | "run" | "agent")] | null);
+        /**
+         * Only runs delivered by this subscription.
+         */
+        subscription_id?: (string | null);
+        /**
+         * Only runs started by this Agent session.
+         */
+        agent_session_id?: (string | null);
+    };
 }
 export interface ZoFunctionPublishContractInputV1 {
     function_id: string;
@@ -3480,6 +3741,7 @@ export interface ZoMachineListOutputV1MachineBootedView {
     init: ("none" | "image");
     command: (string[] | null);
 }
+export type ZoMachineListQueryV1ObservedState = ("creating" | "running" | "stopping" | "stopped" | "resuming" | "destroying" | "destroyed" | "failed");
 export interface ZoMachineListQueryV1 {
     /**
      * Rows per page, at most 200; a larger value is reduced to it.
@@ -3490,6 +3752,12 @@ export interface ZoMachineListQueryV1 {
      */
     cursor?: string;
     sort?: ("id.asc" | "created_at.desc" | "created_at.asc" | "display_name.asc");
+    filter?: {
+        /**
+         * Only machines in any of these states.
+         */
+        state?: ([ZoMachineListQueryV1ObservedState] | [ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState] | [ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState] | [ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState] | [ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState] | [ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState] | [ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState] | [ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState, ZoMachineListQueryV1ObservedState] | null);
+    };
 }
 export interface ZoMachineListConfigurationsInputV1 {
     workspace_id: string;
@@ -4308,7 +4576,7 @@ export interface ZoMessageGetOutputV1 {
     workspace_id: string;
     author: ZoMessageGetOutputV1PrincipalReference;
     recipient: ZoMessageGetOutputV1PrincipalReference;
-    content: (ZoMessageGetOutputV1TextBlock | ZoMessageGetOutputV1ImageBlock | ZoMessageGetOutputV1AudioBlock | ZoMessageGetOutputV1ResourceBlock | ZoMessageGetOutputV1ResourceLinkBlock)[];
+    content: (ZoMessageGetOutputV1TextBlock | ZoMessageGetOutputV1ImageBlock | ZoMessageGetOutputV1AudioBlock | ZoMessageGetOutputV1ResourceBlock | ZoMessageGetOutputV1MessageResourceLinkBlock)[];
     created_at: string;
     /**
      * The delivery to the recipient Agent.
@@ -4347,14 +4615,24 @@ export interface ZoMessageGetOutputV1EmbeddedResource {
     blob?: (string | null);
 }
 /**
- * On input, ``uri`` names an upload (``zo-upload://``). On output, a presigned URL for stored media.
+ * A stored file: ``uri`` is a URL valid for an hour, or ``zo-file://{file_id}`` once it's deleted.
  */
-export interface ZoMessageGetOutputV1ResourceLinkBlock {
+export interface ZoMessageGetOutputV1MessageResourceLinkBlock {
     type: "resource_link";
     uri: string;
     name: string;
     mimeType?: (string | null);
     size?: (number | null);
+    _meta: ZoMessageGetOutputV1LinkMeta;
+}
+export interface ZoMessageGetOutputV1LinkMeta {
+    zo: ZoMessageGetOutputV1ZoLinkMeta;
+}
+export interface ZoMessageGetOutputV1ZoLinkMeta {
+    /**
+     * The Knowledge file that holds the attachment.
+     */
+    file_id: string;
 }
 export interface ZoMessageGetOutputV1MessageDelivery {
     session_id: string;
@@ -4372,6 +4650,386 @@ export interface ZoMessageGetOutputV1MessageDelivery {
      */
     reasoning: (string | null);
 }
+export interface ZoModelGenerateTextInputV1 {
+    workspace_id: string;
+    /**
+     * A model ID from zo.model.list, such as anthropic/claude-sonnet-5-5.
+     */
+    model: string;
+    /**
+     * A single user message. Set this or messages.
+     */
+    prompt?: (string | null);
+    /**
+     * A conversation that ends with a user message. Set this or prompt.
+     */
+    messages?: ([(ZoModelGenerateTextInputV1UserMessage | ZoModelGenerateTextInputV1AssistantMessage), ...((ZoModelGenerateTextInputV1UserMessage | ZoModelGenerateTextInputV1AssistantMessage))[]] | null);
+    /**
+     * System instructions.
+     */
+    instructions?: (string | null);
+    /**
+     * The structured output wanted. Omit for plain text.
+     */
+    output?: ((ZoModelGenerateTextInputV1ObjectOutput | ZoModelGenerateTextInputV1ArrayOutput | ZoModelGenerateTextInputV1ChoiceOutput | ZoModelGenerateTextInputV1JsonOutput) | null);
+    /**
+     * Reasoning effort, one of the model's reasoning_levels. Omit for its default.
+     */
+    reasoning?: (string | null);
+    include?: (ZoModelGenerateTextInputV1Include | null);
+    /**
+     * Settings for the provider the model runs on, keyed by provider, in snake case. Only the routed provider's options are used; an option it doesn't take is refused before the call.
+     */
+    provider_options?: (ZoModelGenerateTextInputV1ProviderOptions | null);
+    /**
+     * The most tokens to generate.
+     */
+    max_output_tokens?: (number | null);
+    temperature?: (number | null);
+    top_p?: (number | null);
+    top_k?: (number | null);
+    presence_penalty?: (number | null);
+    frequency_penalty?: (number | null);
+    stop_sequences?: ([string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string] | null);
+    seed?: (number | null);
+}
+export interface ZoModelGenerateTextInputV1UserMessage {
+    role: "user";
+    /**
+     * Text and file parts, in order.
+     *
+     * @minItems 1
+     * @maxItems 100
+     */
+    content: [(ZoModelGenerateTextInputV1TextPart | ZoModelGenerateTextInputV1FilePart), ...((ZoModelGenerateTextInputV1TextPart | ZoModelGenerateTextInputV1FilePart))[]];
+}
+export interface ZoModelGenerateTextInputV1TextPart {
+    type: "text";
+    text: string;
+}
+/**
+ * An image (PNG, JPEG, GIF or WebP, up to 20 MiB) or a text file (up to 1 MiB), as a Knowledge file by ID or
+ * inline as base64. A call may name at most 20 distinct Knowledge files. Other types, PDFs and video included, are
+ * refused. Which types a model takes is its `input_media` in `zo.model.list`.
+ */
+export interface ZoModelGenerateTextInputV1FilePart {
+    type: "file";
+    /**
+     * A Knowledge file the caller can read. Set this or data, not both.
+     */
+    file_id?: (string | null);
+    /**
+     * The file's bytes as base64.
+     */
+    data?: (string | null);
+    /**
+     * Required with data, such as image/png or text/plain. Ignored for a Knowledge file, which always uses its stored type.
+     */
+    media_type?: (string | null);
+    filename?: (string | null);
+}
+export interface ZoModelGenerateTextInputV1AssistantMessage {
+    role: "assistant";
+    /**
+     * @minItems 1
+     * @maxItems 100
+     */
+    content: [ZoModelGenerateTextInputV1TextPart, ...(ZoModelGenerateTextInputV1TextPart)[]];
+}
+export interface ZoModelGenerateTextInputV1ObjectOutput {
+    type: "object";
+    /**
+     * A JSON Schema whose root type is object. The result matches it.
+     */
+    schema: {
+        [k: string]: JsonValue;
+    };
+    name?: (string | null);
+    description?: (string | null);
+}
+export interface ZoModelGenerateTextInputV1ArrayOutput {
+    type: "array";
+    /**
+     * A JSON Schema every element of the result matches.
+     */
+    element_schema: {
+        [k: string]: JsonValue;
+    };
+    name?: (string | null);
+    description?: (string | null);
+}
+export interface ZoModelGenerateTextInputV1ChoiceOutput {
+    type: "choice";
+    /**
+     * The result is exactly one of these.
+     *
+     * @minItems 2
+     * @maxItems 100
+     */
+    options: [string, string, ...(string)[]];
+}
+export interface ZoModelGenerateTextInputV1JsonOutput {
+    type: "json";
+}
+export interface ZoModelGenerateTextInputV1Include {
+    /**
+     * Return the model's reasoning text when it provides one.
+     */
+    reasoning?: boolean;
+}
+/**
+ * Settings for one provider, keyed by provider, passed through to that
+ * provider's request as the Vercel AI SDK's providerOptions are. Shared by
+ * every model action that takes them.
+ */
+export interface ZoModelGenerateTextInputV1ProviderOptions {
+    /**
+     * For Anthropic models: thinking, send_reasoning.
+     */
+    anthropic?: ({
+        [k: string]: JsonValue;
+    } | null);
+    /**
+     * For OpenAI models: reasoning_summary, text_verbosity, service_tier, user, logit_bias.
+     */
+    openai?: ({
+        [k: string]: JsonValue;
+    } | null);
+    /**
+     * For Google models: thinking_config, safety_settings.
+     */
+    google?: ({
+        [k: string]: JsonValue;
+    } | null);
+    /**
+     * For xAI models. None are accepted yet.
+     */
+    xai?: ({
+        [k: string]: JsonValue;
+    } | null);
+    /**
+     * For DeepSeek models. None are accepted yet.
+     */
+    deepseek?: ({
+        [k: string]: JsonValue;
+    } | null);
+    /**
+     * For Moonshot models. None are accepted yet.
+     */
+    moonshot?: ({
+        [k: string]: JsonValue;
+    } | null);
+    /**
+     * For Z.ai models. None are accepted yet.
+     */
+    zai?: ({
+        [k: string]: JsonValue;
+    } | null);
+    /**
+     * For Voyage models: truncation.
+     */
+    voyage?: ({
+        [k: string]: JsonValue;
+    } | null);
+    /**
+     * For ByteDance models. None are accepted yet.
+     */
+    bytedance?: ({
+        [k: string]: JsonValue;
+    } | null);
+    /**
+     * For Recraft models. None are accepted yet.
+     */
+    recraft?: ({
+        [k: string]: JsonValue;
+    } | null);
+    /**
+     * For AssemblyAI transcription: punctuate, format_text, disfluencies, filter_profanity, word_boost, boost_param.
+     */
+    assemblyai?: ({
+        [k: string]: JsonValue;
+    } | null);
+}
+export interface ZoModelGenerateTextOutputV1 {
+    /**
+     * The generated text. For structured output, the JSON the model wrote.
+     */
+    text: string;
+    /**
+     * The parsed result when output was set, else null.
+     */
+    output: (JsonValue | null);
+    /**
+     * The model's reasoning text, when asked for and provided.
+     */
+    reasoning: (string | null);
+    /**
+     * Why generation ended. deadline: the request ran out of time and text holds what was generated by then.
+     */
+    finish_reason: ("stop" | "length" | "content_filter" | "deadline" | "other");
+    /**
+     * The model that answered.
+     */
+    model: string;
+    usage: ZoModelGenerateTextOutputV1Usage;
+    charge: ZoModelGenerateTextOutputV1Charge;
+}
+/**
+ * What the provider reported, in the units the model is billed in. A
+ * model action sets only its own units.
+ */
+export interface ZoModelGenerateTextOutputV1Usage {
+    input_tokens?: (number | null);
+    output_tokens?: (number | null);
+    cache_read_tokens?: (number | null);
+    cache_write_tokens?: (number | null);
+    reasoning_tokens?: (number | null);
+}
+export interface ZoModelGenerateTextOutputV1Charge {
+    /**
+     * What this call added to the workspace's usage, in US dollars as a decimal string. Null when the amount couldn't be confirmed; the workspace's billing entries are the record.
+     */
+    usd: (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;
@@ -4386,7 +5044,7 @@ export interface ZoOauthAppCreateInputV1 {
     requested_scopes: string[];
     connection_id?: (string | null);
     /**
-     * The app's client secret. Zo seals it in the workspace vault and stores only its `manager_ref.client_secret_id`; it is never returned.
+     * The app's client secret. Zo seals it in the workspace vault and never returns it. A private app needs one. After an update, every connection on the app uses the new secret from its next refresh.
      */
     client_secret?: (string | null);
 }
@@ -4478,14 +5136,14 @@ export interface ZoOauthAppUpdateInputV1 {
     expected_state: string;
     client_id?: (string | null);
     /**
-     * Omitted: keep the app's current `manager_ref` (with a new `client_secret`, only its secret id changes).
+     * Omitted: keep the app's current `manager_ref`. It can't contain `client_secret`, `client_secret_id` or `client_secret_env`.
      */
     manager_ref?: ({
         [k: string]: JsonValue;
     } | null);
     visibility: ("private" | "public");
     /**
-     * The app's client secret. Zo seals it in the workspace vault and stores only its `manager_ref.client_secret_id`; it is never returned.
+     * The app's client secret. Zo seals it in the workspace vault and never returns it. A private app needs one. After an update, every connection on the app uses the new secret from its next refresh.
      */
     client_secret?: (string | null);
 }
@@ -5754,6 +6412,10 @@ export interface ZoSubscriptionListQueryV1 {
          * Only subscriptions to this event definition.
          */
         event_id?: (string | null);
+        /**
+         * Only subscriptions that run for this schedule.
+         */
+        schedule_id?: (string | null);
         /**
          * Only subscriptions whose handler is this resource: its handler_resource_type and handler_resource_id, such as an Agent.
          */
@@ -5911,6 +6573,10 @@ export interface ZoSubscriptionListQueryV2 {
          * Only subscriptions to this event definition.
          */
         event_id?: (string | null);
+        /**
+         * Only subscriptions that run for this schedule.
+         */
+        schedule_id?: (string | null);
         /**
          * Only subscriptions whose handler is this resource: its handler_resource_type and handler_resource_id, such as an Agent.
          */
@@ -7576,6 +8242,15 @@ export interface ZoWebsiteCreateOutputV1 {
 export interface ZoWebsiteCreateOutputV1WebsiteHostname {
     hostname: string;
     state: ("pending_dns" | "pending_ssl" | "active" | "released");
+    /**
+     * The records to keep at your DNS provider: a CNAME that routes the hostname to Zo, and a TXT record whose value is unique to this claim and proves you control the hostname.
+     */
+    dns_records: ZoWebsiteCreateOutputV1WebsiteDnsRecord[];
+}
+export interface ZoWebsiteCreateOutputV1WebsiteDnsRecord {
+    type: ("CNAME" | "TXT");
+    name: string;
+    value: string;
 }
 export interface ZoWebsiteDeleteInputV1 {
     website_id: string;
@@ -7606,6 +8281,15 @@ export interface ZoWebsiteGetOutputV1 {
 export interface ZoWebsiteGetOutputV1WebsiteHostname {
     hostname: string;
     state: ("pending_dns" | "pending_ssl" | "active" | "released");
+    /**
+     * The records to keep at your DNS provider: a CNAME that routes the hostname to Zo, and a TXT record whose value is unique to this claim and proves you control the hostname.
+     */
+    dns_records: ZoWebsiteGetOutputV1WebsiteDnsRecord[];
+}
+export interface ZoWebsiteGetOutputV1WebsiteDnsRecord {
+    type: ("CNAME" | "TXT");
+    name: string;
+    value: string;
 }
 export interface ZoWebsiteListInputV1 {
     workspace_id: string;
@@ -7634,6 +8318,15 @@ export interface ZoWebsiteListOutputV1WebsiteListItem {
 export interface ZoWebsiteListOutputV1WebsiteHostname {
     hostname: string;
     state: ("pending_dns" | "pending_ssl" | "active" | "released");
+    /**
+     * The records to keep at your DNS provider: a CNAME that routes the hostname to Zo, and a TXT record whose value is unique to this claim and proves you control the hostname.
+     */
+    dns_records: ZoWebsiteListOutputV1WebsiteDnsRecord[];
+}
+export interface ZoWebsiteListOutputV1WebsiteDnsRecord {
+    type: ("CNAME" | "TXT");
+    name: string;
+    value: string;
 }
 export interface ZoWebsiteListOutputV1WebsiteRoute {
     id: string;
@@ -7710,6 +8403,15 @@ export interface ZoWebsiteUpdateOutputV1 {
 export interface ZoWebsiteUpdateOutputV1WebsiteHostname {
     hostname: string;
     state: ("pending_dns" | "pending_ssl" | "active" | "released");
+    /**
+     * The records to keep at your DNS provider: a CNAME that routes the hostname to Zo, and a TXT record whose value is unique to this claim and proves you control the hostname.
+     */
+    dns_records: ZoWebsiteUpdateOutputV1WebsiteDnsRecord[];
+}
+export interface ZoWebsiteUpdateOutputV1WebsiteDnsRecord {
+    type: ("CNAME" | "TXT");
+    name: string;
+    value: string;
 }
 export interface ZoWebsiteRouteCreateInputV1 {
     website_id: string;
@@ -8098,6 +8800,9 @@ export interface ZoWorkflowGetRunOutputV1 {
     id: string;
     workflow_id: string;
     revision_id: string;
+    /**
+     * Always `direct`. Read `trigger` on the run for what started it.
+     */
     entry_kind: "direct";
     state: ZoWorkflowGetRunOutputV1RunState;
     error_code: (ZoWorkflowGetRunOutputV1WorkflowRunError | null);
@@ -8109,6 +8814,7 @@ export interface ZoWorkflowGetRunOutputV1 {
     steps: ZoWorkflowGetRunOutputV1StepEntry[];
     result: JsonValue;
     result_available: boolean;
+    trigger: ZoWorkflowGetRunOutputV1RunTrigger;
 }
 export interface ZoWorkflowGetRunOutputV1StepEntry {
     step: string;
@@ -8117,11 +8823,109 @@ export interface ZoWorkflowGetRunOutputV1StepEntry {
     attempts?: (number | null);
     iterations?: (ZoWorkflowGetRunOutputV1Iterations | null);
     error_code?: (string | null);
+    /**
+     * The first attempt's start time, or null before the step starts.
+     */
+    started_at: (string | null);
+    /**
+     * The latest attempt's finish time, or null while the step has not finished.
+     */
+    finished_at: (string | null);
+    /**
+     * The called Function's ID, or null for wait, Agent, and parallel steps.
+     */
+    function_id: (string | null);
+    /**
+     * The child run's error message, or null when it has none.
+     */
+    error_message: (string | null);
+    /**
+     * The Agent session that replied, or null when no Agent session replied.
+     */
+    agent_session_id: (string | null);
+    /**
+     * Why the step was skipped, or null when it was not skipped.
+     */
+    skip_reason: (("condition_false" | "parent_skipped") | null);
+    /**
+     * Whether the step continued after ending failed, cancelled, or unknown under `on_error: continue`.
+     */
+    continued: boolean;
+    /**
+     * The first 100 failed, cancelled, or unknown iterations by index; an empty list when a resolved loop has none, and null for every other step.
+     */
+    failed_iterations: (ZoWorkflowGetRunOutputV1StepIteration[] | null);
 }
 export interface ZoWorkflowGetRunOutputV1Iterations {
     total: number;
     finished: number;
 }
+export interface ZoWorkflowGetRunOutputV1StepIteration {
+    /**
+     * The loop iteration's zero-based index.
+     */
+    iteration: number;
+    /**
+     * The iteration's final state.
+     */
+    state: string;
+    /**
+     * The child Function run ID, or null when no Function run started.
+     */
+    run_id: (string | null);
+    /**
+     * The iteration's error code, or null when it has none.
+     */
+    error_code: (string | null);
+    /**
+     * The child run's error message, or null when it has none.
+     */
+    error_message: (string | null);
+    /**
+     * The Agent session that replied, or null when no Agent session replied.
+     */
+    agent_session_id: (string | null);
+}
+export interface ZoWorkflowGetRunOutputV1RunTrigger {
+    /**
+     * What started the run.
+     */
+    kind: ("direct" | "http" | "event" | "workflow_step" | "run" | "agent");
+    /**
+     * The event subscription that delivered the run.
+     */
+    subscription_id: (string | null);
+    /**
+     * The event occurrence that delivered the run.
+     */
+    occurrence_id: (string | null);
+    /**
+     * The delivered event type.
+     */
+    event_type: (string | null);
+    /**
+     * The Function or Workflow run that started this run.
+     */
+    caller: (ZoWorkflowGetRunOutputV1RunRef | null);
+    /**
+     * The Agent session that invoked the run.
+     */
+    agent_session_id: (string | null);
+}
+export interface ZoWorkflowGetRunOutputV1RunRef {
+    /**
+     * The run that invoked this run.
+     */
+    run_id: string;
+    /**
+     * The caller's Function ID, or null for a Workflow run.
+     */
+    function_id: (string | null);
+    /**
+     * The caller's Workflow ID, or null for a Function run.
+     */
+    workflow_id: (string | null);
+}
 export interface ZoWorkflowInvokeInputV1 {
     workflow_id: string;
     input: JsonValue;
@@ -8189,6 +8993,9 @@ export interface ZoWorkflowListRunsOutputV1WorkflowRunSummary {
     id: string;
     workflow_id: string;
     revision_id: string;
+    /**
+     * Always `direct`. Read `trigger` on the run for what started it.
+     */
     entry_kind: "direct";
     state: ZoWorkflowListRunsOutputV1RunState;
     error_code: (ZoWorkflowListRunsOutputV1WorkflowRunError | null);
@@ -8196,6 +9003,8 @@ export interface ZoWorkflowListRunsOutputV1WorkflowRunSummary {
     deadline: string;
     finished_at: (string | null);
 }
+export type ZoWorkflowListRunsQueryV1WorkflowRunState = ("queued" | "running" | "cancel_requested" | "succeeded" | "failed" | "cancelled" | "unknown");
+export type ZoWorkflowListRunsQueryV1WorkflowRunError = ("step_failed" | "deadline_exceeded" | "engine_error" | "engine_rejected" | "engine_unavailable");
 export interface ZoWorkflowListRunsQueryV1 {
     /**
      * Rows per page, at most 200; a larger value is reduced to it.
@@ -8205,6 +9014,41 @@ export interface ZoWorkflowListRunsQueryV1 {
      * The previous page's next_cursor, sent with the same sort, filter and search.
      */
     cursor?: string;
+    sort?: ("created_at.desc" | "created_at.asc");
+    filter?: {
+        /**
+         * Only runs created after this time.
+         */
+        created_after?: (string | null);
+        /**
+         * Only runs created before this time.
+         */
+        created_before?: (string | null);
+        /**
+         * Only runs in any of these states.
+         */
+        state?: ([ZoWorkflowListRunsQueryV1WorkflowRunState] | [ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState] | [ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState] | [ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState] | [ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState] | [ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState] | [ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState, ZoWorkflowListRunsQueryV1WorkflowRunState] | null);
+        /**
+         * Only runs with any of these error codes.
+         */
+        error_code?: ([ZoWorkflowListRunsQueryV1WorkflowRunError] | [ZoWorkflowListRunsQueryV1WorkflowRunError, ZoWorkflowListRunsQueryV1WorkflowRunError] | [ZoWorkflowListRunsQueryV1WorkflowRunError, ZoWorkflowListRunsQueryV1WorkflowRunError, ZoWorkflowListRunsQueryV1WorkflowRunError] | [ZoWorkflowListRunsQueryV1WorkflowRunError, ZoWorkflowListRunsQueryV1WorkflowRunError, ZoWorkflowListRunsQueryV1WorkflowRunError, ZoWorkflowListRunsQueryV1WorkflowRunError] | [ZoWorkflowListRunsQueryV1WorkflowRunError, ZoWorkflowListRunsQueryV1WorkflowRunError, ZoWorkflowListRunsQueryV1WorkflowRunError, ZoWorkflowListRunsQueryV1WorkflowRunError, ZoWorkflowListRunsQueryV1WorkflowRunError] | null);
+        /**
+         * Only runs of this revision.
+         */
+        revision_id?: (string | null);
+        /**
+         * Only runs with any of these trigger kinds.
+         */
+        trigger?: ([("direct" | "event" | "run" | "agent")] | [("direct" | "event" | "run" | "agent"), ("direct" | "event" | "run" | "agent")] | [("direct" | "event" | "run" | "agent"), ("direct" | "event" | "run" | "agent"), ("direct" | "event" | "run" | "agent")] | [("direct" | "event" | "run" | "agent"), ("direct" | "event" | "run" | "agent"), ("direct" | "event" | "run" | "agent"), ("direct" | "event" | "run" | "agent")] | null);
+        /**
+         * Only runs delivered by this subscription.
+         */
+        subscription_id?: (string | null);
+        /**
+         * Only runs started by this Agent session.
+         */
+        agent_session_id?: (string | null);
+    };
 }
 export interface ZoWorkflowPublishInputV1 {
     workflow_id: string;
@@ -9037,6 +9881,19 @@ export type Operations = {
             output: ZoMessageGetOutputV1;
         };
     };
+    "zo.model.generate_text": {
+        1: {
+            input: ZoModelGenerateTextInputV1;
+            output: ZoModelGenerateTextOutputV1;
+        };
+    };
+    "zo.model.list": {
+        1: {
+            input: ZoModelListInputV1;
+            output: ZoModelListOutputV1;
+            query: ZoModelListQueryV1;
+        };
+    };
     "zo.oauth_app.create": {
         1: {
             input: ZoOauthAppCreateInputV1;
@@ -9543,6 +10400,8 @@ export type DefaultVersions = {
     "zo.machine_image.list": 1;
     "zo.machine_image.update": 1;
     "zo.message.get": 1;
+    "zo.model.generate_text": 1;
+    "zo.model.list": 1;
     "zo.oauth_app.create": 1;
     "zo.oauth_app.delete": 1;
     "zo.oauth_app.get": 1;