@zocomputer/system-api 0.3.0 → 0.3.1

package/openapi.json

@@ -2797,6 +2797,19 @@
             "title": "ImageBlock",
             "type": "object"
           },
+          "LinkMeta": {
+            "additionalProperties": false,
+            "properties": {
+              "zo": {
+                "$ref": "#/$defs/ZoLinkMeta"
+              }
+            },
+            "required": [
+              "zo"
+            ],
+            "title": "LinkMeta",
+            "type": "object"
+          },
           "Message": {
             "additionalProperties": false,
             "properties": {
@@ -2821,7 +2834,7 @@
                       "audio": "#/$defs/AudioBlock",
                       "image": "#/$defs/ImageBlock",
                       "resource": "#/$defs/ResourceBlock",
-                      "resource_link": "#/$defs/ResourceLinkBlock",
+                      "resource_link": "#/$defs/MessageResourceLinkBlock",
                       "text": "#/$defs/TextBlock"
                     },
                     "propertyName": "type"
@@ -2840,7 +2853,7 @@
                       "$ref": "#/$defs/ResourceBlock"
                     },
                     {
-                      "$ref": "#/$defs/ResourceLinkBlock"
+                      "$ref": "#/$defs/MessageResourceLinkBlock"
                     }
                   ]
                 },
@@ -2946,47 +2959,9 @@
             "title": "MessageDelivery",
             "type": "object"
           },
-          "PrincipalReference": {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "title": "Type",
-                "type": "string"
-              },
-              "id": {
-                "title": "Id",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "id"
-            ],
-            "title": "PrincipalReference",
-            "type": "object"
-          },
-          "ResourceBlock": {
+          "MessageResourceLinkBlock": {
             "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "resource",
-                "title": "Type",
-                "type": "string"
-              },
-              "resource": {
-                "$ref": "#/$defs/EmbeddedResource"
-              }
-            },
-            "required": [
-              "type",
-              "resource"
-            ],
-            "title": "ResourceBlock",
-            "type": "object"
-          },
-          "ResourceLinkBlock": {
-            "additionalProperties": false,
-            "description": "On input, ``uri`` names an upload (``zo-upload://``). On output, a presigned URL for stored media.",
+            "description": "A stored file: ``uri`` is a URL valid for an hour, or ``zo-file://{file_id}`` once it's deleted.",
             "properties": {
               "type": {
                 "const": "resource_link",
@@ -3031,14 +3006,56 @@
                 ],
                 "default": null,
                 "title": "Size"
+              },
+              "_meta": {
+                "$ref": "#/$defs/LinkMeta"
               }
             },
             "required": [
               "type",
               "uri",
-              "name"
+              "name",
+              "_meta"
             ],
-            "title": "ResourceLinkBlock",
+            "title": "MessageResourceLinkBlock",
+            "type": "object"
+          },
+          "PrincipalReference": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "title": "Type",
+                "type": "string"
+              },
+              "id": {
+                "title": "Id",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "id"
+            ],
+            "title": "PrincipalReference",
+            "type": "object"
+          },
+          "ResourceBlock": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "resource",
+                "title": "Type",
+                "type": "string"
+              },
+              "resource": {
+                "$ref": "#/$defs/EmbeddedResource"
+              }
+            },
+            "required": [
+              "type",
+              "resource"
+            ],
+            "title": "ResourceBlock",
             "type": "object"
           },
           "TextBlock": {
@@ -3062,6 +3079,21 @@
             ],
             "title": "TextBlock",
             "type": "object"
+          },
+          "ZoLinkMeta": {
+            "additionalProperties": false,
+            "properties": {
+              "file_id": {
+                "description": "The Knowledge file that holds the attachment.",
+                "title": "File Id",
+                "type": "string"
+              }
+            },
+            "required": [
+              "file_id"
+            ],
+            "title": "ZoLinkMeta",
+            "type": "object"
           }
         }
       },
@@ -3082,7 +3114,7 @@
         "implementation_unavailable",
         "resource_not_found"
       ],
-      "digest": "sha256:a8e34e154f63267fa02c162d32cd887f95eeac983693ea1c6570c6504ebe202d"
+      "digest": "sha256:983f22ac6e48618bb3290155e3d7723ae1be7e885f78f9135f3ee0f37e5d0d16"
     },
     {
       "name": "zo.agent.send",
@@ -3919,10 +3951,91 @@
             "type": "string"
           },
           "last_activity_at": {
-            "description": "When the session's newest message or event was delivered to it; created_at when it has none.",
+            "description": "When the session last received an input or finished a turn; created_at when it has done neither.",
             "title": "Last Activity At",
             "type": "string"
           },
+          "turn_count": {
+            "anyOf": [
+              {
+                "minimum": 0,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Turns ended in the session; null for a session with no turn ended since turns were counted.",
+            "title": "Turn Count"
+          },
+          "turns_duration_ms": {
+            "anyOf": [
+              {
+                "minimum": 0,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The summed duration of turns ended since the count was filled.",
+            "title": "Turns Duration Ms"
+          },
+          "elapsed_ms": {
+            "anyOf": [
+              {
+                "minimum": 0,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Milliseconds from created_at to last_turn_ended_at, rounded.",
+            "title": "Elapsed Ms"
+          },
+          "last_turn_ended_at": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "When the last turn ended, as an RFC 3339 time.",
+            "title": "Last Turn Ended At"
+          },
+          "last_turn_outcome": {
+            "anyOf": [
+              {
+                "enum": [
+                  "completed",
+                  "cancelled",
+                  "interrupted",
+                  "failed"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "How the last turn ended.",
+            "title": "Last Turn Outcome"
+          },
+          "last_turn_reason": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The reason the last turn ended with, such as model_error.",
+            "title": "Last Turn Reason"
+          },
           "model": {
             "description": "The model the session's next inputs run with.",
             "title": "Model",
@@ -3956,6 +4069,12 @@
           "agent_id",
           "created_at",
           "last_activity_at",
+          "turn_count",
+          "turns_duration_ms",
+          "elapsed_ms",
+          "last_turn_ended_at",
+          "last_turn_outcome",
+          "last_turn_reason",
           "model",
           "reasoning",
           "stream_url"
@@ -3974,13 +4093,13 @@
         "implementation_unavailable",
         "resource_not_found"
       ],
-      "digest": "sha256:fa7d4538f2a14134318196e18081aca325cd991851561a50071e92808becdb1f"
+      "digest": "sha256:c9a0287765cc63f5c2681159cfbf66c1546a423fd3fdb2c21684169de7f29680"
     },
     {
       "name": "zo.agent_session.history",
       "version": 1,
       "publisher": "zo",
-      "description": "Read a session's history: its inputs, the Agent's responses and tool results, newest first, as ACP updates.",
+      "description": "Read a session's history: its inputs, the Agent's responses and tool results, newest first, as ACP updates. The page limit counts context rows, so a page can contain more items than its limit; a turn_ended item follows each finished turn's last item.",
       "input_schema": {
         "additionalProperties": false,
         "properties": {
@@ -4039,11 +4158,59 @@
                 "enum": [
                   "input",
                   "response",
-                  "tool_results"
+                  "tool_results",
+                  "turn_ended"
                 ],
                 "title": "Kind",
                 "type": "string"
               },
+              "turn_id": {
+                "description": "The turn that produced this item.",
+                "title": "Turn Id",
+                "type": "string"
+              },
+              "created_at": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "RFC 3339 row time, or the turn's end time for turn_ended; null when that end time was not recorded.",
+                "title": "Created At"
+              },
+              "outcome": {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "completed",
+                      "cancelled",
+                      "interrupted",
+                      "failed"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The turn's outcome on turn_ended; null on row items.",
+                "title": "Outcome"
+              },
+              "reason": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The turn's outcome reason on turn_ended; null on row items.",
+                "title": "Reason"
+              },
               "updates": {
                 "description": "ACP session/update updates, with Zo fields under _meta.zo.",
                 "items": {
@@ -4059,6 +4226,10 @@
             "required": [
               "seq",
               "kind",
+              "turn_id",
+              "created_at",
+              "outcome",
+              "reason",
               "updates"
             ],
             "title": "AgentSessionHistoryItem",
@@ -4078,7 +4249,7 @@
         "invalid_input",
         "resource_not_found"
       ],
-      "digest": "sha256:1d5dc59be3ce5b5186b4f3675283d0a87ff4aed46374e2d419defefaa85e2758"
+      "digest": "sha256:0ec9eeab9cf92d991c5586cbb00eb01a9c56a9b0f81b1b3b8d372e2e70b9419a"
     },
     {
       "name": "zo.agent_session.list",
@@ -4171,10 +4342,91 @@
                 "type": "string"
               },
               "last_activity_at": {
-                "description": "When the session's newest message or event was delivered to it; created_at when it has none.",
+                "description": "When the session last received an input or finished a turn; created_at when it has done neither.",
                 "title": "Last Activity At",
                 "type": "string"
               },
+              "turn_count": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Turns ended in the session; null for a session with no turn ended since turns were counted.",
+                "title": "Turn Count"
+              },
+              "turns_duration_ms": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The summed duration of turns ended since the count was filled.",
+                "title": "Turns Duration Ms"
+              },
+              "elapsed_ms": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Milliseconds from created_at to last_turn_ended_at, rounded.",
+                "title": "Elapsed Ms"
+              },
+              "last_turn_ended_at": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "When the last turn ended, as an RFC 3339 time.",
+                "title": "Last Turn Ended At"
+              },
+              "last_turn_outcome": {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "completed",
+                      "cancelled",
+                      "interrupted",
+                      "failed"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "How the last turn ended.",
+                "title": "Last Turn Outcome"
+              },
+              "last_turn_reason": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The reason the last turn ended with, such as model_error.",
+                "title": "Last Turn Reason"
+              },
               "model": {
                 "description": "The model the session's next inputs run with.",
                 "title": "Model",
@@ -4203,6 +4455,12 @@
               "agent_id",
               "created_at",
               "last_activity_at",
+              "turn_count",
+              "turns_duration_ms",
+              "elapsed_ms",
+              "last_turn_ended_at",
+              "last_turn_outcome",
+              "last_turn_reason",
               "model",
               "reasoning"
             ],
@@ -4222,7 +4480,7 @@
         "implementation_unavailable",
         "resource_not_found"
       ],
-      "digest": "sha256:ccad299f85ad1e29daa8630f04f7844e9db5aff02940dbb700cb173bf25017a1"
+      "digest": "sha256:77d2dc953e6259fb131c0d2e219299589c4fbfdab41f4db90140108e91e661ca"
     },
     {
       "name": "zo.agent_session.list_workspace",
@@ -4315,10 +4573,91 @@
                 "type": "string"
               },
               "last_activity_at": {
-                "description": "When the session's newest message or event was delivered to it; created_at when it has none.",
+                "description": "When the session last received an input or finished a turn; created_at when it has done neither.",
                 "title": "Last Activity At",
                 "type": "string"
               },
+              "turn_count": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Turns ended in the session; null for a session with no turn ended since turns were counted.",
+                "title": "Turn Count"
+              },
+              "turns_duration_ms": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The summed duration of turns ended since the count was filled.",
+                "title": "Turns Duration Ms"
+              },
+              "elapsed_ms": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Milliseconds from created_at to last_turn_ended_at, rounded.",
+                "title": "Elapsed Ms"
+              },
+              "last_turn_ended_at": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "When the last turn ended, as an RFC 3339 time.",
+                "title": "Last Turn Ended At"
+              },
+              "last_turn_outcome": {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "completed",
+                      "cancelled",
+                      "interrupted",
+                      "failed"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "How the last turn ended.",
+                "title": "Last Turn Outcome"
+              },
+              "last_turn_reason": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The reason the last turn ended with, such as model_error.",
+                "title": "Last Turn Reason"
+              },
               "model": {
                 "description": "The model the session's next inputs run with.",
                 "title": "Model",
@@ -4347,6 +4686,12 @@
               "agent_id",
               "created_at",
               "last_activity_at",
+              "turn_count",
+              "turns_duration_ms",
+              "elapsed_ms",
+              "last_turn_ended_at",
+              "last_turn_outcome",
+              "last_turn_reason",
               "model",
               "reasoning"
             ],
@@ -4365,7 +4710,7 @@
       "error_codes": [
         "implementation_unavailable"
       ],
-      "digest": "sha256:0c0023c827285b09c4e7fbb9d001c89faca96ee293d769568d77baf63885b0a2"
+      "digest": "sha256:332ee8b48ca75d74d5e09e4b71c030bca6ad9c3950b1d02ce532dfbb041116db"
     },
     {
       "name": "zo.billing.list_rates",
@@ -6528,6 +6873,43 @@
             },
             "title": "Environment",
             "type": "object"
+          },
+          "last_used_at": {
+            "anyOf": [
+              {
+                "maxLength": 40,
+                "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,6})?(Z|[+-][0-9]{2}:[0-9]{2})$",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "When Zo last handed this connection's credential to a Function run or machine.",
+            "title": "Last Used At"
+          },
+          "usable": {
+            "description": "Whether Zo will deliver this connection's credential now.",
+            "title": "Usable",
+            "type": "boolean"
+          },
+          "unusable_reason": {
+            "anyOf": [
+              {
+                "enum": [
+                  "definition_withdrawn",
+                  "configuring",
+                  "reauthorization_required",
+                  "disabled"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Why Zo will not deliver this connection's credential now, or null when it will.",
+            "title": "Unusable Reason"
           }
         },
         "required": [
@@ -6542,9 +6924,12 @@
           "status",
           "revision",
           "account_labels",
-          "environment"
+          "environment",
+          "last_used_at",
+          "usable",
+          "unusable_reason"
         ],
-        "title": "ConnectionWithAccountsResource",
+        "title": "ConnectionReadResource",
         "type": "object"
       },
       "target": {
@@ -6557,7 +6942,7 @@
       "error_codes": [
         "resource_not_found"
       ],
-      "digest": "sha256:5ca6347217eba21af2b37e1830df0252e5d4115a3f7ee4f9357bed5e11280861"
+      "digest": "sha256:888acd2e1feba5b19c1905857e5125329737f23ec450b85a4d63e1879b585cf2"
     },
     {
       "name": "zo.connection.list",
@@ -6585,7 +6970,7 @@
         "properties": {
           "connections": {
             "items": {
-              "$ref": "#/$defs/ConnectionWithAccountsResource"
+              "$ref": "#/$defs/ConnectionReadResource"
             },
             "title": "Connections",
             "type": "array"
@@ -6609,7 +6994,7 @@
         "title": "ConnectionListResult",
         "type": "object",
         "$defs": {
-          "ConnectionWithAccountsResource": {
+          "ConnectionReadResource": {
             "additionalProperties": false,
             "properties": {
               "id": {
@@ -6687,6 +7072,43 @@
                 },
                 "title": "Environment",
                 "type": "object"
+              },
+              "last_used_at": {
+                "anyOf": [
+                  {
+                    "maxLength": 40,
+                    "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\\.[0-9]{1,6})?(Z|[+-][0-9]{2}:[0-9]{2})$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "When Zo last handed this connection's credential to a Function run or machine.",
+                "title": "Last Used At"
+              },
+              "usable": {
+                "description": "Whether Zo will deliver this connection's credential now.",
+                "title": "Usable",
+                "type": "boolean"
+              },
+              "unusable_reason": {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "definition_withdrawn",
+                      "configuring",
+                      "reauthorization_required",
+                      "disabled"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Why Zo will not deliver this connection's credential now, or null when it will.",
+                "title": "Unusable Reason"
               }
             },
             "required": [
@@ -6701,9 +7123,12 @@
               "status",
               "revision",
               "account_labels",
-              "environment"
+              "environment",
+              "last_used_at",
+              "usable",
+              "unusable_reason"
             ],
-            "title": "ConnectionWithAccountsResource",
+            "title": "ConnectionReadResource",
             "type": "object"
           }
         }
@@ -6718,7 +7143,7 @@
       "error_codes": [
         "invalid_cursor"
       ],
-      "digest": "sha256:92aca1c5160f58db8d84f380e55f271730a7159e4ca3d2bddde8462adba18a30"
+      "digest": "sha256:980544a4939be631e0b12a1930bd7fa07266ee893055cb2187a97e75e791c6d7"
     },
     {
       "name": "zo.connection.register_resource",
@@ -13310,6 +13735,13 @@
                 "title": "Created At",
                 "type": "string"
               },
+              "route_ids": {
+                "items": {
+                  "type": "string"
+                },
+                "title": "Route Ids",
+                "type": "array"
+              },
               "credential_slots": {
                 "items": {
                   "$ref": "#/$defs/CredentialSlotSummary"
@@ -13327,6 +13759,7 @@
               "invoke_enabled",
               "http_enabled",
               "created_at",
+              "route_ids",
               "credential_slots"
             ],
             "title": "DeploymentWithSlotsSummary",
@@ -13416,7 +13849,7 @@
       "effect": "read",
       "result_kind": "inline",
       "error_codes": [],
-      "digest": "sha256:8fefdcc1440b09264f2c0b0a31ef8f3cefb5f2fe79f0166341e7537addf89819"
+      "digest": "sha256:a7003bbcae500ade1da64eb0f61f5442119a59ec2ab0c8c402c9627b3d1dfffb"
     },
     {
       "name": "zo.function.get_run",
@@ -13458,6 +13891,7 @@
             "type": "string"
           },
           "entry_kind": {
+            "description": "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.",
             "enum": [
               "direct",
               "connection",
@@ -13531,6 +13965,9 @@
                 "type": "null"
               }
             ]
+          },
+          "trigger": {
+            "$ref": "#/$defs/RunTrigger"
           }
         },
         "required": [
@@ -13547,7 +13984,8 @@
           "workspace_id",
           "result",
           "result_available",
-          "parent"
+          "parent",
+          "trigger"
         ],
         "title": "FunctionRun",
         "type": "object",
@@ -13576,6 +14014,47 @@
             "title": "RunParent",
             "type": "object"
           },
+          "RunRef": {
+            "additionalProperties": false,
+            "properties": {
+              "run_id": {
+                "description": "The run that invoked this run.",
+                "title": "Run Id",
+                "type": "string"
+              },
+              "function_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The caller's Function ID, or null for a Workflow run.",
+                "title": "Function Id"
+              },
+              "workflow_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The caller's Workflow ID, or null for a Function run.",
+                "title": "Workflow Id"
+              }
+            },
+            "required": [
+              "run_id",
+              "function_id",
+              "workflow_id"
+            ],
+            "title": "RunRef",
+            "type": "object"
+          },
           "RunState": {
             "enum": [
               "queued",
@@ -13588,6 +14067,93 @@
               "unknown"
             ],
             "type": "string"
+          },
+          "RunTrigger": {
+            "additionalProperties": false,
+            "properties": {
+              "kind": {
+                "description": "What started the run.",
+                "enum": [
+                  "direct",
+                  "http",
+                  "event",
+                  "workflow_step",
+                  "run",
+                  "agent"
+                ],
+                "title": "Kind",
+                "type": "string"
+              },
+              "subscription_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The event subscription that delivered the run.",
+                "title": "Subscription Id"
+              },
+              "occurrence_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The event occurrence that delivered the run.",
+                "title": "Occurrence Id"
+              },
+              "event_type": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The delivered event type.",
+                "title": "Event Type"
+              },
+              "caller": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/RunRef"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The Function or Workflow run that started this run."
+              },
+              "agent_session_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The Agent session that invoked the run.",
+                "title": "Agent Session Id"
+              }
+            },
+            "required": [
+              "kind",
+              "subscription_id",
+              "occurrence_id",
+              "event_type",
+              "caller",
+              "agent_session_id"
+            ],
+            "title": "RunTrigger",
+            "type": "object"
           }
         }
       },
@@ -13602,7 +14168,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:2505ec5258453629ea98a3d70911387096dbbd4c2f68d5c2c24ee5f32746eaca"
+      "digest": "sha256:e2ffa72539a3742262be01ce613f5da85c900f4d2c1a30358fbf3d08b6bc6ba0"
     },
     {
       "name": "zo.function.invoke",
@@ -13978,6 +14544,7 @@
                 "type": "string"
               },
               "entry_kind": {
+                "description": "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.",
                 "enum": [
                   "direct",
                   "connection",
@@ -14073,7 +14640,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:5afb66f0e9685192469f0fda5db8ea0cf49cf1a645ab23d22a03bc8698c8a7b4"
+      "digest": "sha256:4c4ca436fc7e5ef58880efeace4433508105f2f749b9609eb799609ffd648fa2"
     },
     {
       "name": "zo.function.publish_contract",
@@ -22070,7 +22637,7 @@
                   "audio": "#/$defs/AudioBlock",
                   "image": "#/$defs/ImageBlock",
                   "resource": "#/$defs/ResourceBlock",
-                  "resource_link": "#/$defs/ResourceLinkBlock",
+                  "resource_link": "#/$defs/MessageResourceLinkBlock",
                   "text": "#/$defs/TextBlock"
                 },
                 "propertyName": "type"
@@ -22089,7 +22656,7 @@
                   "$ref": "#/$defs/ResourceBlock"
                 },
                 {
-                  "$ref": "#/$defs/ResourceLinkBlock"
+                  "$ref": "#/$defs/MessageResourceLinkBlock"
                 }
               ]
             },
@@ -22241,6 +22808,19 @@
             "title": "ImageBlock",
             "type": "object"
           },
+          "LinkMeta": {
+            "additionalProperties": false,
+            "properties": {
+              "zo": {
+                "$ref": "#/$defs/ZoLinkMeta"
+              }
+            },
+            "required": [
+              "zo"
+            ],
+            "title": "LinkMeta",
+            "type": "object"
+          },
           "MessageDelivery": {
             "additionalProperties": false,
             "properties": {
@@ -22312,47 +22892,9 @@
             "title": "MessageDelivery",
             "type": "object"
           },
-          "PrincipalReference": {
-            "additionalProperties": false,
-            "properties": {
-              "type": {
-                "title": "Type",
-                "type": "string"
-              },
-              "id": {
-                "title": "Id",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "id"
-            ],
-            "title": "PrincipalReference",
-            "type": "object"
-          },
-          "ResourceBlock": {
+          "MessageResourceLinkBlock": {
             "additionalProperties": false,
-            "properties": {
-              "type": {
-                "const": "resource",
-                "title": "Type",
-                "type": "string"
-              },
-              "resource": {
-                "$ref": "#/$defs/EmbeddedResource"
-              }
-            },
-            "required": [
-              "type",
-              "resource"
-            ],
-            "title": "ResourceBlock",
-            "type": "object"
-          },
-          "ResourceLinkBlock": {
-            "additionalProperties": false,
-            "description": "On input, ``uri`` names an upload (``zo-upload://``). On output, a presigned URL for stored media.",
+            "description": "A stored file: ``uri`` is a URL valid for an hour, or ``zo-file://{file_id}`` once it's deleted.",
             "properties": {
               "type": {
                 "const": "resource_link",
@@ -22397,17 +22939,834 @@
                 ],
                 "default": null,
                 "title": "Size"
+              },
+              "_meta": {
+                "$ref": "#/$defs/LinkMeta"
+              }
+            },
+            "required": [
+              "type",
+              "uri",
+              "name",
+              "_meta"
+            ],
+            "title": "MessageResourceLinkBlock",
+            "type": "object"
+          },
+          "PrincipalReference": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "title": "Type",
+                "type": "string"
+              },
+              "id": {
+                "title": "Id",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "id"
+            ],
+            "title": "PrincipalReference",
+            "type": "object"
+          },
+          "ResourceBlock": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "resource",
+                "title": "Type",
+                "type": "string"
+              },
+              "resource": {
+                "$ref": "#/$defs/EmbeddedResource"
+              }
+            },
+            "required": [
+              "type",
+              "resource"
+            ],
+            "title": "ResourceBlock",
+            "type": "object"
+          },
+          "TextBlock": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "text",
+                "title": "Type",
+                "type": "string"
+              },
+              "text": {
+                "maxLength": 100000,
+                "minLength": 1,
+                "title": "Text",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "text"
+            ],
+            "title": "TextBlock",
+            "type": "object"
+          },
+          "ZoLinkMeta": {
+            "additionalProperties": false,
+            "properties": {
+              "file_id": {
+                "description": "The Knowledge file that holds the attachment.",
+                "title": "File Id",
+                "type": "string"
+              }
+            },
+            "required": [
+              "file_id"
+            ],
+            "title": "ZoLinkMeta",
+            "type": "object"
+          }
+        }
+      },
+      "target": {
+        "type": "agent",
+        "input_pointer": "/agent_id"
+      },
+      "additional_checks": [],
+      "effect": "read",
+      "result_kind": "inline",
+      "error_codes": [
+        "implementation_unavailable",
+        "resource_not_found"
+      ],
+      "digest": "sha256:ac04dbbd2642ad79c98bfd056cdef95a2db7538415dba5987ffc4adb2e4868dd"
+    },
+    {
+      "name": "zo.model.generate_text",
+      "version": 1,
+      "publisher": "zo",
+      "description": "Generate text with a model from a prompt or a conversation, or structured data when output is set: an object or a list matching a JSON Schema, one choice from a set, or any JSON. A user message can hold images and text files. One call, with no tools and no memory of earlier calls. Each call is charged to the workspace's credit for the tokens the provider reports and needs V2 billing.",
+      "input_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "workspace_id": {
+            "maxLength": 200,
+            "minLength": 1,
+            "title": "Workspace Id",
+            "type": "string"
+          },
+          "model": {
+            "description": "A model ID from zo.model.list, such as anthropic/claude-sonnet-5-5.",
+            "maxLength": 200,
+            "minLength": 1,
+            "title": "Model",
+            "type": "string"
+          },
+          "prompt": {
+            "anyOf": [
+              {
+                "minLength": 1,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "A single user message. Set this or messages.",
+            "title": "Prompt"
+          },
+          "messages": {
+            "anyOf": [
+              {
+                "items": {
+                  "discriminator": {
+                    "mapping": {
+                      "assistant": "#/$defs/AssistantMessage",
+                      "user": "#/$defs/UserMessage"
+                    },
+                    "propertyName": "role"
+                  },
+                  "oneOf": [
+                    {
+                      "$ref": "#/$defs/UserMessage"
+                    },
+                    {
+                      "$ref": "#/$defs/AssistantMessage"
+                    }
+                  ]
+                },
+                "maxItems": 500,
+                "minItems": 1,
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "A conversation that ends with a user message. Set this or prompt.",
+            "title": "Messages"
+          },
+          "instructions": {
+            "anyOf": [
+              {
+                "minLength": 1,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "System instructions.",
+            "title": "Instructions"
+          },
+          "output": {
+            "anyOf": [
+              {
+                "discriminator": {
+                  "mapping": {
+                    "array": "#/$defs/ArrayOutput",
+                    "choice": "#/$defs/ChoiceOutput",
+                    "json": "#/$defs/JsonOutput",
+                    "object": "#/$defs/ObjectOutput"
+                  },
+                  "propertyName": "type"
+                },
+                "oneOf": [
+                  {
+                    "$ref": "#/$defs/ObjectOutput"
+                  },
+                  {
+                    "$ref": "#/$defs/ArrayOutput"
+                  },
+                  {
+                    "$ref": "#/$defs/ChoiceOutput"
+                  },
+                  {
+                    "$ref": "#/$defs/JsonOutput"
+                  }
+                ]
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "The structured output wanted. Omit for plain text.",
+            "title": "Output"
+          },
+          "reasoning": {
+            "anyOf": [
+              {
+                "maxLength": 32,
+                "minLength": 1,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "Reasoning effort, one of the model's reasoning_levels. Omit for its default.",
+            "title": "Reasoning"
+          },
+          "include": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/Include"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null
+          },
+          "provider_options": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/ProviderOptions"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "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."
+          },
+          "max_output_tokens": {
+            "anyOf": [
+              {
+                "minimum": 1,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "description": "The most tokens to generate.",
+            "title": "Max Output Tokens"
+          },
+          "temperature": {
+            "anyOf": [
+              {
+                "maximum": 2,
+                "minimum": 0,
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Temperature"
+          },
+          "top_p": {
+            "anyOf": [
+              {
+                "maximum": 1,
+                "minimum": 0,
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Top P"
+          },
+          "top_k": {
+            "anyOf": [
+              {
+                "minimum": 1,
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Top K"
+          },
+          "presence_penalty": {
+            "anyOf": [
+              {
+                "maximum": 2,
+                "minimum": -2,
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Presence Penalty"
+          },
+          "frequency_penalty": {
+            "anyOf": [
+              {
+                "maximum": 2,
+                "minimum": -2,
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Frequency Penalty"
+          },
+          "stop_sequences": {
+            "anyOf": [
+              {
+                "items": {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "maxItems": 16,
+                "minItems": 1,
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Stop Sequences"
+          },
+          "seed": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "default": null,
+            "title": "Seed"
+          }
+        },
+        "required": [
+          "workspace_id",
+          "model"
+        ],
+        "title": "GenerateTextInput",
+        "type": "object",
+        "$defs": {
+          "ArrayOutput": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "array",
+                "title": "Type",
+                "type": "string"
+              },
+              "element_schema": {
+                "additionalProperties": {
+                  "x-zo-json-value": true
+                },
+                "description": "A JSON Schema every element of the result matches.",
+                "title": "Element Schema",
+                "type": "object"
+              },
+              "name": {
+                "anyOf": [
+                  {
+                    "maxLength": 64,
+                    "minLength": 1,
+                    "pattern": "^[A-Za-z0-9_-]+$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Name"
+              },
+              "description": {
+                "anyOf": [
+                  {
+                    "maxLength": 1024,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Description"
+              }
+            },
+            "required": [
+              "type",
+              "element_schema"
+            ],
+            "title": "ArrayOutput",
+            "type": "object"
+          },
+          "AssistantMessage": {
+            "additionalProperties": false,
+            "properties": {
+              "role": {
+                "const": "assistant",
+                "title": "Role",
+                "type": "string"
+              },
+              "content": {
+                "items": {
+                  "$ref": "#/$defs/TextPart"
+                },
+                "maxItems": 100,
+                "minItems": 1,
+                "title": "Content",
+                "type": "array"
+              }
+            },
+            "required": [
+              "role",
+              "content"
+            ],
+            "title": "AssistantMessage",
+            "type": "object"
+          },
+          "ChoiceOutput": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "choice",
+                "title": "Type",
+                "type": "string"
+              },
+              "options": {
+                "description": "The result is exactly one of these.",
+                "items": {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "maxItems": 100,
+                "minItems": 2,
+                "title": "Options",
+                "type": "array"
+              }
+            },
+            "required": [
+              "type",
+              "options"
+            ],
+            "title": "ChoiceOutput",
+            "type": "object"
+          },
+          "FilePart": {
+            "additionalProperties": false,
+            "description": "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\ninline as base64. A call may name at most 20 distinct Knowledge files. Other types, PDFs and video included, are\nrefused. Which types a model takes is its `input_media` in `zo.model.list`.",
+            "properties": {
+              "type": {
+                "const": "file",
+                "title": "Type",
+                "type": "string"
+              },
+              "file_id": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "A Knowledge file the caller can read. Set this or data, not both.",
+                "title": "File Id"
+              },
+              "data": {
+                "anyOf": [
+                  {
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "The file's bytes as base64.",
+                "title": "Data"
+              },
+              "media_type": {
+                "anyOf": [
+                  {
+                    "maxLength": 200,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "Required with data, such as image/png or text/plain. Ignored for a Knowledge file, which always uses its stored type.",
+                "title": "Media Type"
+              },
+              "filename": {
+                "anyOf": [
+                  {
+                    "maxLength": 255,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Filename"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "title": "FilePart",
+            "type": "object"
+          },
+          "Include": {
+            "additionalProperties": false,
+            "properties": {
+              "reasoning": {
+                "default": false,
+                "description": "Return the model's reasoning text when it provides one.",
+                "title": "Reasoning",
+                "type": "boolean"
+              }
+            },
+            "title": "Include",
+            "type": "object",
+            "required": []
+          },
+          "JsonOutput": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "json",
+                "title": "Type",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type"
+            ],
+            "title": "JsonOutput",
+            "type": "object"
+          },
+          "ObjectOutput": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "const": "object",
+                "title": "Type",
+                "type": "string"
+              },
+              "schema": {
+                "additionalProperties": {
+                  "x-zo-json-value": true
+                },
+                "description": "A JSON Schema whose root type is object. The result matches it.",
+                "title": "Schema",
+                "type": "object"
+              },
+              "name": {
+                "anyOf": [
+                  {
+                    "maxLength": 64,
+                    "minLength": 1,
+                    "pattern": "^[A-Za-z0-9_-]+$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Name"
+              },
+              "description": {
+                "anyOf": [
+                  {
+                    "maxLength": 1024,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Description"
+              }
+            },
+            "required": [
+              "type",
+              "schema"
+            ],
+            "title": "ObjectOutput",
+            "type": "object"
+          },
+          "ProviderOptions": {
+            "additionalProperties": false,
+            "description": "Settings for one provider, keyed by provider, passed through to that\nprovider's request as the Vercel AI SDK's providerOptions are. Shared by\nevery model action that takes them.",
+            "properties": {
+              "anthropic": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For Anthropic models: thinking, send_reasoning.",
+                "title": "Anthropic"
+              },
+              "openai": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For OpenAI models: reasoning_summary, text_verbosity, service_tier, user, logit_bias.",
+                "title": "Openai"
+              },
+              "google": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For Google models: thinking_config, safety_settings.",
+                "title": "Google"
+              },
+              "xai": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For xAI models. None are accepted yet.",
+                "title": "Xai"
+              },
+              "deepseek": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For DeepSeek models. None are accepted yet.",
+                "title": "Deepseek"
+              },
+              "moonshot": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For Moonshot models. None are accepted yet.",
+                "title": "Moonshot"
+              },
+              "zai": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For Z.ai models. None are accepted yet.",
+                "title": "Zai"
+              },
+              "voyage": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For Voyage models: truncation.",
+                "title": "Voyage"
+              },
+              "bytedance": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For ByteDance models. None are accepted yet.",
+                "title": "Bytedance"
+              },
+              "recraft": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For Recraft models. None are accepted yet.",
+                "title": "Recraft"
+              },
+              "assemblyai": {
+                "anyOf": [
+                  {
+                    "additionalProperties": {
+                      "x-zo-json-value": true
+                    },
+                    "type": "object"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "description": "For AssemblyAI transcription: punctuate, format_text, disfluencies, filter_profanity, word_boost, boost_param.",
+                "title": "Assemblyai"
               }
             },
-            "required": [
-              "type",
-              "uri",
-              "name"
-            ],
-            "title": "ResourceLinkBlock",
-            "type": "object"
+            "title": "ProviderOptions",
+            "type": "object",
+            "required": []
           },
-          "TextBlock": {
+          "TextPart": {
             "additionalProperties": false,
             "properties": {
               "type": {
@@ -22416,8 +23775,6 @@
                 "type": "string"
               },
               "text": {
-                "maxLength": 100000,
-                "minLength": 1,
                 "title": "Text",
                 "type": "string"
               }
@@ -22426,23 +23783,235 @@
               "type",
               "text"
             ],
-            "title": "TextBlock",
+            "title": "TextPart",
+            "type": "object"
+          },
+          "UserMessage": {
+            "additionalProperties": false,
+            "properties": {
+              "role": {
+                "const": "user",
+                "title": "Role",
+                "type": "string"
+              },
+              "content": {
+                "description": "Text and file parts, in order.",
+                "items": {
+                  "discriminator": {
+                    "mapping": {
+                      "file": "#/$defs/FilePart",
+                      "text": "#/$defs/TextPart"
+                    },
+                    "propertyName": "type"
+                  },
+                  "oneOf": [
+                    {
+                      "$ref": "#/$defs/TextPart"
+                    },
+                    {
+                      "$ref": "#/$defs/FilePart"
+                    }
+                  ]
+                },
+                "maxItems": 100,
+                "minItems": 1,
+                "title": "Content",
+                "type": "array"
+              }
+            },
+            "required": [
+              "role",
+              "content"
+            ],
+            "title": "UserMessage",
             "type": "object"
           }
         }
       },
+      "output_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "text": {
+            "description": "The generated text. For structured output, the JSON the model wrote.",
+            "title": "Text",
+            "type": "string"
+          },
+          "output": {
+            "anyOf": [
+              {
+                "x-zo-json-value": true
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The parsed result when output was set, else null."
+          },
+          "reasoning": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The model's reasoning text, when asked for and provided.",
+            "title": "Reasoning"
+          },
+          "finish_reason": {
+            "description": "Why generation ended. deadline: the request ran out of time and text holds what was generated by then.",
+            "enum": [
+              "stop",
+              "length",
+              "content_filter",
+              "deadline",
+              "other"
+            ],
+            "title": "Finish Reason",
+            "type": "string"
+          },
+          "model": {
+            "description": "The model that answered.",
+            "title": "Model",
+            "type": "string"
+          },
+          "usage": {
+            "$ref": "#/$defs/Usage"
+          },
+          "charge": {
+            "$ref": "#/$defs/Charge"
+          }
+        },
+        "required": [
+          "text",
+          "output",
+          "reasoning",
+          "finish_reason",
+          "model",
+          "usage",
+          "charge"
+        ],
+        "title": "GenerateTextResult",
+        "type": "object",
+        "$defs": {
+          "Charge": {
+            "additionalProperties": false,
+            "properties": {
+              "usd": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "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.",
+                "title": "Usd"
+              }
+            },
+            "required": [
+              "usd"
+            ],
+            "title": "Charge",
+            "type": "object"
+          },
+          "Usage": {
+            "additionalProperties": false,
+            "description": "What the provider reported, in the units the model is billed in. A\nmodel action sets only its own units.",
+            "properties": {
+              "input_tokens": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Input Tokens"
+              },
+              "output_tokens": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Output Tokens"
+              },
+              "cache_read_tokens": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Cache Read Tokens"
+              },
+              "cache_write_tokens": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Cache Write Tokens"
+              },
+              "reasoning_tokens": {
+                "anyOf": [
+                  {
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "default": null,
+                "title": "Reasoning Tokens"
+              }
+            },
+            "title": "Usage",
+            "type": "object",
+            "required": []
+          }
+        }
+      },
       "target": {
-        "type": "agent",
-        "input_pointer": "/agent_id"
+        "type": "workspace",
+        "input_pointer": "/workspace_id"
       },
       "additional_checks": [],
-      "effect": "read",
+      "effect": "use",
       "result_kind": "inline",
       "error_codes": [
+        "invalid_input",
+        "conflict",
+        "quota_exceeded",
+        "rate_limited",
+        "execution_deadline_exceeded",
+        "provider_failure",
         "implementation_unavailable",
-        "resource_not_found"
+        "file_too_large",
+        "output_limit_exceeded"
       ],
-      "digest": "sha256:aadcb480b26c475386eb47a4694a413a0b118969638cd9bfd9d9e5d68b5f758e"
+      "digest": "sha256:3b53f6bc7b92dbda22ad01a97d1c69baaf567234ef35d364297f96c979bca184"
     },
     {
       "name": "zo.model.list",
@@ -23025,7 +24594,7 @@
               }
             ],
             "default": null,
-            "description": "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.",
+            "description": "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.",
             "title": "Client Secret"
           }
         },
@@ -23134,7 +24703,7 @@
         "invalid_input",
         "resource_not_found"
       ],
-      "digest": "sha256:36487e5b7a08bfe7fb60077cbdf001f9e49bcdad39180a2f39f4f338198d23ce"
+      "digest": "sha256:d9216f3b7e1c6aa991dfd4572f88a4eff1f97e0bbd08bcaa9b28827d7536a828"
     },
     {
       "name": "zo.oauth_app.delete",
@@ -23561,7 +25130,7 @@
               }
             ],
             "default": null,
-            "description": "Omitted: keep the app's current `manager_ref` (with a new `client_secret`, only its secret id changes).",
+            "description": "Omitted: keep the app's current `manager_ref`. It can't contain `client_secret`, `client_secret_id` or `client_secret_env`.",
             "title": "Manager Ref"
           },
           "visibility": {
@@ -23584,7 +25153,7 @@
               }
             ],
             "default": null,
-            "description": "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.",
+            "description": "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.",
             "title": "Client Secret"
           }
         },
@@ -23717,7 +25286,7 @@
         "conflict",
         "resource_not_found"
       ],
-      "digest": "sha256:f5478f52aaa077c985cab0e10a44a13c9ac72d6dedac67d6974ef831e5aded61"
+      "digest": "sha256:4b2d3c01b760b5007430f546a25fc645ad587fcc8aac0aacaf61bfcdab6c3d1f"
     },
     {
       "name": "zo.quota.get",
@@ -39066,226 +40635,291 @@
         "title": "Website",
         "type": "object",
         "$defs": {
-          "WebsiteHostname": {
+          "WebsiteDnsRecord": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "enum": [
+                  "CNAME",
+                  "TXT"
+                ],
+                "title": "Type",
+                "type": "string"
+              },
+              "name": {
+                "title": "Name",
+                "type": "string"
+              },
+              "value": {
+                "title": "Value",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "name",
+              "value"
+            ],
+            "title": "WebsiteDnsRecord",
+            "type": "object"
+          },
+          "WebsiteHostname": {
+            "additionalProperties": false,
+            "properties": {
+              "hostname": {
+                "title": "Hostname",
+                "type": "string"
+              },
+              "state": {
+                "enum": [
+                  "pending_dns",
+                  "pending_ssl",
+                  "active",
+                  "released"
+                ],
+                "title": "State",
+                "type": "string"
+              },
+              "dns_records": {
+                "description": "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.",
+                "items": {
+                  "$ref": "#/$defs/WebsiteDnsRecord"
+                },
+                "title": "Dns Records",
+                "type": "array"
+              }
+            },
+            "required": [
+              "hostname",
+              "state",
+              "dns_records"
+            ],
+            "title": "WebsiteHostname",
+            "type": "object"
+          }
+        }
+      },
+      "target": {
+        "type": "workspace",
+        "input_pointer": "/workspace_id"
+      },
+      "additional_checks": [],
+      "effect": "create",
+      "result_kind": "inline",
+      "error_codes": [
+        "implementation_unavailable",
+        "invalid_input",
+        "conflict"
+      ],
+      "digest": "sha256:1a383ed93cdc7acb59c8937a36be01157a90dba7923afc6ffc8304a5080475f2"
+    },
+    {
+      "name": "zo.website.delete",
+      "version": 1,
+      "publisher": "zo",
+      "description": "Delete a Website and retire its routes.",
+      "input_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "website_id": {
+            "maxLength": 200,
+            "minLength": 1,
+            "title": "Website Id",
+            "type": "string"
+          },
+          "expected_revision": {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "title": "Expected Revision",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "website_id",
+          "expected_revision"
+        ],
+        "title": "WebsiteRevisionInput",
+        "type": "object"
+      },
+      "output_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "title": "Id",
+            "type": "string"
+          },
+          "deleted": {
+            "const": true,
+            "title": "Deleted",
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "id",
+          "deleted"
+        ],
+        "title": "Deleted",
+        "type": "object"
+      },
+      "target": {
+        "type": "website",
+        "input_pointer": "/website_id"
+      },
+      "additional_checks": [],
+      "effect": "manage",
+      "result_kind": "inline",
+      "error_codes": [
+        "implementation_unavailable",
+        "conflict"
+      ],
+      "digest": "sha256:2db56e54e0b5566279d44af943774876d9996d525a3dab2b7af47389167ec896"
+    },
+    {
+      "name": "zo.website.get",
+      "version": 1,
+      "publisher": "zo",
+      "description": "Read a Website and its hostname.",
+      "input_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "website_id": {
+            "maxLength": 200,
+            "minLength": 1,
+            "title": "Website Id",
+            "type": "string"
+          }
+        },
+        "required": [
+          "website_id"
+        ],
+        "title": "WebsiteGetInput",
+        "type": "object"
+      },
+      "output_schema": {
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "title": "Id",
+            "type": "string"
+          },
+          "workspace_id": {
+            "title": "Workspace Id",
+            "type": "string"
+          },
+          "slug": {
+            "title": "Slug",
+            "type": "string"
+          },
+          "display_name": {
+            "title": "Display Name",
+            "type": "string"
+          },
+          "description": {
+            "title": "Description",
+            "type": "string"
+          },
+          "generated_hostname": {
+            "title": "Generated Hostname",
+            "type": "string"
+          },
+          "custom_hostname": {
+            "anyOf": [
+              {
+                "$ref": "#/$defs/WebsiteHostname"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "access": {
+            "enum": [
+              "public",
+              "authenticated"
+            ],
+            "title": "Access",
+            "type": "string"
+          },
+          "revision": {
+            "exclusiveMinimum": 0,
+            "maximum": 9007199254740991,
+            "title": "Revision",
+            "type": "integer"
+          },
+          "visibility": {
+            "enum": [
+              "workspace",
+              "protected"
+            ],
+            "title": "Visibility",
+            "type": "string"
+          },
+          "owner_user_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Owner User Id"
+          },
+          "created_at": {
+            "title": "Created At",
+            "type": "string"
+          },
+          "updated_at": {
+            "title": "Updated At",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "workspace_id",
+          "slug",
+          "display_name",
+          "description",
+          "generated_hostname",
+          "custom_hostname",
+          "access",
+          "revision",
+          "visibility",
+          "owner_user_id",
+          "created_at",
+          "updated_at"
+        ],
+        "title": "Website",
+        "type": "object",
+        "$defs": {
+          "WebsiteDnsRecord": {
             "additionalProperties": false,
             "properties": {
-              "hostname": {
-                "title": "Hostname",
-                "type": "string"
-              },
-              "state": {
+              "type": {
                 "enum": [
-                  "pending_dns",
-                  "pending_ssl",
-                  "active",
-                  "released"
+                  "CNAME",
+                  "TXT"
                 ],
-                "title": "State",
+                "title": "Type",
                 "type": "string"
-              }
-            },
-            "required": [
-              "hostname",
-              "state"
-            ],
-            "title": "WebsiteHostname",
-            "type": "object"
-          }
-        }
-      },
-      "target": {
-        "type": "workspace",
-        "input_pointer": "/workspace_id"
-      },
-      "additional_checks": [],
-      "effect": "create",
-      "result_kind": "inline",
-      "error_codes": [
-        "implementation_unavailable",
-        "invalid_input",
-        "conflict"
-      ],
-      "digest": "sha256:8c7b48e80e39d01eb6fa121ba0a2688deba2f2ba7396dee8e3f583d7f6c884ff"
-    },
-    {
-      "name": "zo.website.delete",
-      "version": 1,
-      "publisher": "zo",
-      "description": "Delete a Website and retire its routes.",
-      "input_schema": {
-        "additionalProperties": false,
-        "properties": {
-          "website_id": {
-            "maxLength": 200,
-            "minLength": 1,
-            "title": "Website Id",
-            "type": "string"
-          },
-          "expected_revision": {
-            "exclusiveMinimum": 0,
-            "maximum": 9007199254740991,
-            "title": "Expected Revision",
-            "type": "integer"
-          }
-        },
-        "required": [
-          "website_id",
-          "expected_revision"
-        ],
-        "title": "WebsiteRevisionInput",
-        "type": "object"
-      },
-      "output_schema": {
-        "additionalProperties": false,
-        "properties": {
-          "id": {
-            "title": "Id",
-            "type": "string"
-          },
-          "deleted": {
-            "const": true,
-            "title": "Deleted",
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "id",
-          "deleted"
-        ],
-        "title": "Deleted",
-        "type": "object"
-      },
-      "target": {
-        "type": "website",
-        "input_pointer": "/website_id"
-      },
-      "additional_checks": [],
-      "effect": "manage",
-      "result_kind": "inline",
-      "error_codes": [
-        "implementation_unavailable",
-        "conflict"
-      ],
-      "digest": "sha256:2db56e54e0b5566279d44af943774876d9996d525a3dab2b7af47389167ec896"
-    },
-    {
-      "name": "zo.website.get",
-      "version": 1,
-      "publisher": "zo",
-      "description": "Read a Website and its hostname.",
-      "input_schema": {
-        "additionalProperties": false,
-        "properties": {
-          "website_id": {
-            "maxLength": 200,
-            "minLength": 1,
-            "title": "Website Id",
-            "type": "string"
-          }
-        },
-        "required": [
-          "website_id"
-        ],
-        "title": "WebsiteGetInput",
-        "type": "object"
-      },
-      "output_schema": {
-        "additionalProperties": false,
-        "properties": {
-          "id": {
-            "title": "Id",
-            "type": "string"
-          },
-          "workspace_id": {
-            "title": "Workspace Id",
-            "type": "string"
-          },
-          "slug": {
-            "title": "Slug",
-            "type": "string"
-          },
-          "display_name": {
-            "title": "Display Name",
-            "type": "string"
-          },
-          "description": {
-            "title": "Description",
-            "type": "string"
-          },
-          "generated_hostname": {
-            "title": "Generated Hostname",
-            "type": "string"
-          },
-          "custom_hostname": {
-            "anyOf": [
-              {
-                "$ref": "#/$defs/WebsiteHostname"
               },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "access": {
-            "enum": [
-              "public",
-              "authenticated"
-            ],
-            "title": "Access",
-            "type": "string"
-          },
-          "revision": {
-            "exclusiveMinimum": 0,
-            "maximum": 9007199254740991,
-            "title": "Revision",
-            "type": "integer"
-          },
-          "visibility": {
-            "enum": [
-              "workspace",
-              "protected"
-            ],
-            "title": "Visibility",
-            "type": "string"
-          },
-          "owner_user_id": {
-            "anyOf": [
-              {
+              "name": {
+                "title": "Name",
                 "type": "string"
               },
-              {
-                "type": "null"
+              "value": {
+                "title": "Value",
+                "type": "string"
               }
+            },
+            "required": [
+              "type",
+              "name",
+              "value"
             ],
-            "title": "Owner User Id"
-          },
-          "created_at": {
-            "title": "Created At",
-            "type": "string"
+            "title": "WebsiteDnsRecord",
+            "type": "object"
           },
-          "updated_at": {
-            "title": "Updated At",
-            "type": "string"
-          }
-        },
-        "required": [
-          "id",
-          "workspace_id",
-          "slug",
-          "display_name",
-          "description",
-          "generated_hostname",
-          "custom_hostname",
-          "access",
-          "revision",
-          "visibility",
-          "owner_user_id",
-          "created_at",
-          "updated_at"
-        ],
-        "title": "Website",
-        "type": "object",
-        "$defs": {
           "WebsiteHostname": {
             "additionalProperties": false,
             "properties": {
@@ -39302,11 +40936,20 @@
                 ],
                 "title": "State",
                 "type": "string"
+              },
+              "dns_records": {
+                "description": "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.",
+                "items": {
+                  "$ref": "#/$defs/WebsiteDnsRecord"
+                },
+                "title": "Dns Records",
+                "type": "array"
               }
             },
             "required": [
               "hostname",
-              "state"
+              "state",
+              "dns_records"
             ],
             "title": "WebsiteHostname",
             "type": "object"
@@ -39324,7 +40967,7 @@
         "implementation_unavailable",
         "resource_not_found"
       ],
-      "digest": "sha256:e95171ac43bb4bf95e277a4c6777ee8061c728feb119cbfc2354dc45dfb82d49"
+      "digest": "sha256:2ecc0a4426f4cb62d99e7953c7cc2905417f1a97996ed79ad8b2fa5e539aea9c"
     },
     {
       "name": "zo.website.list",
@@ -39492,6 +41135,34 @@
             "title": "MachineRouteConfig",
             "type": "object"
           },
+          "WebsiteDnsRecord": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "enum": [
+                  "CNAME",
+                  "TXT"
+                ],
+                "title": "Type",
+                "type": "string"
+              },
+              "name": {
+                "title": "Name",
+                "type": "string"
+              },
+              "value": {
+                "title": "Value",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "name",
+              "value"
+            ],
+            "title": "WebsiteDnsRecord",
+            "type": "object"
+          },
           "WebsiteHostname": {
             "additionalProperties": false,
             "properties": {
@@ -39508,11 +41179,20 @@
                 ],
                 "title": "State",
                 "type": "string"
+              },
+              "dns_records": {
+                "description": "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.",
+                "items": {
+                  "$ref": "#/$defs/WebsiteDnsRecord"
+                },
+                "title": "Dns Records",
+                "type": "array"
               }
             },
             "required": [
               "hostname",
-              "state"
+              "state",
+              "dns_records"
             ],
             "title": "WebsiteHostname",
             "type": "object"
@@ -39725,7 +41405,7 @@
         "implementation_unavailable",
         "invalid_input"
       ],
-      "digest": "sha256:1acce33b16bd903d94f40273da1785d694f99444facb40e166a061190db1bb74"
+      "digest": "sha256:a4c5d48b532bc4a9323278889bc14679b58e50f189225e2b191408b16cf0e5b2"
     },
     {
       "name": "zo.website.update",
@@ -39932,6 +41612,34 @@
         "title": "Website",
         "type": "object",
         "$defs": {
+          "WebsiteDnsRecord": {
+            "additionalProperties": false,
+            "properties": {
+              "type": {
+                "enum": [
+                  "CNAME",
+                  "TXT"
+                ],
+                "title": "Type",
+                "type": "string"
+              },
+              "name": {
+                "title": "Name",
+                "type": "string"
+              },
+              "value": {
+                "title": "Value",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "name",
+              "value"
+            ],
+            "title": "WebsiteDnsRecord",
+            "type": "object"
+          },
           "WebsiteHostname": {
             "additionalProperties": false,
             "properties": {
@@ -39948,11 +41656,20 @@
                 ],
                 "title": "State",
                 "type": "string"
+              },
+              "dns_records": {
+                "description": "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.",
+                "items": {
+                  "$ref": "#/$defs/WebsiteDnsRecord"
+                },
+                "title": "Dns Records",
+                "type": "array"
               }
             },
             "required": [
               "hostname",
-              "state"
+              "state",
+              "dns_records"
             ],
             "title": "WebsiteHostname",
             "type": "object"
@@ -39971,7 +41688,7 @@
         "invalid_input",
         "conflict"
       ],
-      "digest": "sha256:99ad2a085bd283d6fee339a8c3c1adf1414065e7f0a5714f0292ba352c9d7655"
+      "digest": "sha256:954824c368536054d6b91ed7131afba47b09abd1e5f9cacfc7a89479f2f37133"
     },
     {
       "name": "zo.website_route.create",
@@ -42480,6 +44197,7 @@
           },
           "entry_kind": {
             "const": "direct",
+            "description": "Always `direct`. Read `trigger` on the run for what started it.",
             "title": "Entry Kind",
             "type": "string"
           },
@@ -42535,6 +44253,9 @@
           "result_available": {
             "title": "Result Available",
             "type": "boolean"
+          },
+          "trigger": {
+            "$ref": "#/$defs/RunTrigger"
           }
         },
         "required": [
@@ -42551,7 +44272,8 @@
           "input",
           "steps",
           "result",
-          "result_available"
+          "result_available",
+          "trigger"
         ],
         "title": "WorkflowRun",
         "type": "object",
@@ -42575,6 +44297,47 @@
             "title": "Iterations",
             "type": "object"
           },
+          "RunRef": {
+            "additionalProperties": false,
+            "properties": {
+              "run_id": {
+                "description": "The run that invoked this run.",
+                "title": "Run Id",
+                "type": "string"
+              },
+              "function_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The caller's Function ID, or null for a Workflow run.",
+                "title": "Function Id"
+              },
+              "workflow_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The caller's Workflow ID, or null for a Function run.",
+                "title": "Workflow Id"
+              }
+            },
+            "required": [
+              "run_id",
+              "function_id",
+              "workflow_id"
+            ],
+            "title": "RunRef",
+            "type": "object"
+          },
           "RunState": {
             "enum": [
               "queued",
@@ -42588,6 +44351,93 @@
             ],
             "type": "string"
           },
+          "RunTrigger": {
+            "additionalProperties": false,
+            "properties": {
+              "kind": {
+                "description": "What started the run.",
+                "enum": [
+                  "direct",
+                  "http",
+                  "event",
+                  "workflow_step",
+                  "run",
+                  "agent"
+                ],
+                "title": "Kind",
+                "type": "string"
+              },
+              "subscription_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The event subscription that delivered the run.",
+                "title": "Subscription Id"
+              },
+              "occurrence_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The event occurrence that delivered the run.",
+                "title": "Occurrence Id"
+              },
+              "event_type": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The delivered event type.",
+                "title": "Event Type"
+              },
+              "caller": {
+                "anyOf": [
+                  {
+                    "$ref": "#/$defs/RunRef"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The Function or Workflow run that started this run."
+              },
+              "agent_session_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The Agent session that invoked the run.",
+                "title": "Agent Session Id"
+              }
+            },
+            "required": [
+              "kind",
+              "subscription_id",
+              "occurrence_id",
+              "event_type",
+              "caller",
+              "agent_session_id"
+            ],
+            "title": "RunTrigger",
+            "type": "object"
+          },
           "StepEntry": {
             "additionalProperties": false,
             "properties": {
@@ -42648,15 +44498,195 @@
                 ],
                 "default": null,
                 "title": "Error Code"
+              },
+              "started_at": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The first attempt's start time, or null before the step starts.",
+                "title": "Started At"
+              },
+              "finished_at": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The latest attempt's finish time, or null while the step has not finished.",
+                "title": "Finished At"
+              },
+              "function_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The called Function's ID, or null for wait, Agent, and parallel steps.",
+                "title": "Function Id"
+              },
+              "error_message": {
+                "anyOf": [
+                  {
+                    "maxLength": 300,
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The child run's error message, or null when it has none.",
+                "title": "Error Message"
+              },
+              "agent_session_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The Agent session that replied, or null when no Agent session replied.",
+                "title": "Agent Session Id"
+              },
+              "skip_reason": {
+                "anyOf": [
+                  {
+                    "enum": [
+                      "condition_false",
+                      "parent_skipped"
+                    ],
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Why the step was skipped, or null when it was not skipped.",
+                "title": "Skip Reason"
+              },
+              "continued": {
+                "description": "Whether the step continued after ending failed, cancelled, or unknown under `on_error: continue`.",
+                "title": "Continued",
+                "type": "boolean"
+              },
+              "failed_iterations": {
+                "anyOf": [
+                  {
+                    "items": {
+                      "$ref": "#/$defs/StepIteration"
+                    },
+                    "maxItems": 100,
+                    "type": "array"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "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.",
+                "title": "Failed Iterations"
               }
             },
             "required": [
               "step",
-              "state"
+              "state",
+              "started_at",
+              "finished_at",
+              "function_id",
+              "error_message",
+              "agent_session_id",
+              "skip_reason",
+              "continued",
+              "failed_iterations"
             ],
             "title": "StepEntry",
             "type": "object"
           },
+          "StepIteration": {
+            "additionalProperties": false,
+            "properties": {
+              "iteration": {
+                "description": "The loop iteration's zero-based index.",
+                "title": "Iteration",
+                "type": "integer"
+              },
+              "state": {
+                "description": "The iteration's final state.",
+                "title": "State",
+                "type": "string"
+              },
+              "run_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The child Function run ID, or null when no Function run started.",
+                "title": "Run Id"
+              },
+              "error_code": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The iteration's error code, or null when it has none.",
+                "title": "Error Code"
+              },
+              "error_message": {
+                "anyOf": [
+                  {
+                    "maxLength": 300,
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The child run's error message, or null when it has none.",
+                "title": "Error Message"
+              },
+              "agent_session_id": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "The Agent session that replied, or null when no Agent session replied.",
+                "title": "Agent Session Id"
+              }
+            },
+            "required": [
+              "iteration",
+              "state",
+              "run_id",
+              "error_code",
+              "error_message",
+              "agent_session_id"
+            ],
+            "title": "StepIteration",
+            "type": "object"
+          },
           "WorkflowRunError": {
             "enum": [
               "step_failed",
@@ -42680,7 +44710,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:00478ddd31dbeb45aa4fd30e09eddfd5bec875dbf9257e5a412f51d54cc06e53"
+      "digest": "sha256:3064b3976db41d34bcabbdc4d709195eb7cb0fa9e5b3dfd7b55cf682e91720ab"
     },
     {
       "name": "zo.workflow.invoke",
@@ -43029,6 +45059,7 @@
               },
               "entry_kind": {
                 "const": "direct",
+                "description": "Always `direct`. Read `trigger` on the run for what started it.",
                 "title": "Entry Kind",
                 "type": "string"
               },
@@ -43092,7 +45123,7 @@
         "resource_not_found",
         "implementation_unavailable"
       ],
-      "digest": "sha256:aceef50f9aa81c86aee06efb7adfa831673879888d32e4e3b57ab16387f6cbee"
+      "digest": "sha256:ac1c9dc13fa389ef7a7458da1b2d7a749e7532264aa9f17c14028806fe7be968"
     },
     {
       "name": "zo.workflow.publish",
@@ -44748,6 +46779,7 @@
     "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,
@@ -44874,6 +46906,220 @@
       "digest": "sha256:1d66dd3ea01d21efe43ddda679ea5ec337e720b795620ad6cd8dc49e9443eb47",
       "contract_digest": "sha256:674ad131dbe9510ecaf0a0162ea12b3adf626ad9f14062559d786288d6ff9a8f"
     },
+    {
+      "publisher": "zo",
+      "name": "agent.turn_ended",
+      "version": 1,
+      "description": "An Agent's turn ended. `outcome` is how the runner ended the turn; read the turn's messages from the session's history.",
+      "payload_schema": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "agent_id",
+          "session_id",
+          "turn_id",
+          "outcome",
+          "reason",
+          "trigger",
+          "subscription_id",
+          "subscription_ids",
+          "occurrence_ids",
+          "message_ids",
+          "started_at",
+          "duration_ms",
+          "model",
+          "reasoning",
+          "model_requests",
+          "tool_calls",
+          "input_tokens",
+          "output_tokens"
+        ],
+        "properties": {
+          "agent_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "session_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "turn_id": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "outcome": {
+            "type": "string",
+            "enum": [
+              "completed",
+              "cancelled",
+              "interrupted",
+              "failed"
+            ]
+          },
+          "reason": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 200
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "trigger": {
+            "type": "string",
+            "enum": [
+              "message",
+              "event"
+            ]
+          },
+          "subscription_id": {
+            "anyOf": [
+              {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 200
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "subscription_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            }
+          },
+          "occurrence_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            }
+          },
+          "message_ids": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            }
+          },
+          "started_at": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 40
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "duration_ms": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 0
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "model": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 200
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "reasoning": {
+            "anyOf": [
+              {
+                "type": "string",
+                "maxLength": 200
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "model_requests": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 0
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "tool_calls": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 0
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "input_tokens": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 0
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "output_tokens": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "minimum": 0
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        }
+      },
+      "filter_paths": [
+        "/agent_id",
+        "/session_id",
+        "/outcome",
+        "/trigger",
+        "/subscription_id"
+      ],
+      "disclosure": {
+        "kind": "custom",
+        "subject": {
+          "resource_type": "agent"
+        }
+      },
+      "type": "zo.events.agent.turn_ended@v1",
+      "digest": "sha256:9093ac8382f10341ad7400146243a43a3bd88c3e9b200ceb901169b27bb31a5b",
+      "contract_digest": "sha256:449b282c2fe8cbc0d3aca4221bad11bbb7277578f5001659c17ef96e87ba0ad6"
+    },
     {
       "publisher": "zo",
       "name": "function.run_finished",
@@ -45361,7 +47607,7 @@
                 }
               ],
               "default": null,
-              "description": "Only rows after this time.",
+              "description": "Only rows after this time. A run or turn row's time is when it ended.",
               "title": "Occurred After"
             },
             "occurred_before": {
@@ -45377,9 +47623,21 @@
                 }
               ],
               "default": null,
-              "description": "Only rows before this time.",
+              "description": "Only rows before this time. A run or turn row's time is when it ended.",
               "title": "Occurred Before"
             },
+            "details": {
+              "anyOf": [
+                {
+                  "$ref": "#/$defs/ActivityDetailsFilter"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Match any listed value for each details key; keys combine with AND. Empty is a no-op."
+            },
             "principal": {
               "anyOf": [
                 {
@@ -45493,6 +47751,101 @@
       },
       "required": [],
       "$defs": {
+        "ActivityDetailsFilter": {
+          "additionalProperties": false,
+          "properties": {
+            "turn_outcome": {
+              "anyOf": [
+                {
+                  "items": {
+                    "enum": [
+                      "completed",
+                      "failed",
+                      "cancelled",
+                      "interrupted"
+                    ],
+                    "type": "string"
+                  },
+                  "maxItems": 4,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "system_agent_turn_ended rows carry the runner's turn_outcome.",
+              "title": "Turn Outcome"
+            },
+            "reason": {
+              "anyOf": [
+                {
+                  "items": {
+                    "maxLength": 64,
+                    "minLength": 1,
+                    "pattern": "^[a-z][a-z0-9_]*$",
+                    "type": "string"
+                  },
+                  "maxItems": 20,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "system_agent_turn_ended rows carry reason when the turn has an error reason.",
+              "title": "Reason"
+            },
+            "error_code": {
+              "anyOf": [
+                {
+                  "items": {
+                    "maxLength": 64,
+                    "minLength": 1,
+                    "pattern": "^[a-z][a-z0-9_]*$",
+                    "type": "string"
+                  },
+                  "maxItems": 20,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "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\".",
+              "title": "Error Code"
+            },
+            "trigger": {
+              "anyOf": [
+                {
+                  "items": {
+                    "maxLength": 64,
+                    "minLength": 1,
+                    "pattern": "^[a-z][a-z0-9_]*$",
+                    "type": "string"
+                  },
+                  "maxItems": 20,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "system_agent_turn_ended rows carry message or event; scheduled_runs_summarized rows carry schedule or event.",
+              "title": "Trigger"
+            }
+          },
+          "title": "ActivityDetailsFilter",
+          "type": "object",
+          "required": []
+        },
         "EntityFilter": {
           "additionalProperties": false,
           "properties": {
@@ -45612,6 +47965,70 @@
             "last_activity_at.desc"
           ],
           "default": "id.asc"
+        },
+        "filter": {
+          "additionalProperties": false,
+          "properties": {
+            "last_turn_ended_after": {
+              "anyOf": [
+                {
+                  "description": "An ISO 8601 timestamp with a time zone.",
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only sessions whose last turn ended after this time, exclusively.",
+              "title": "Last Turn Ended After"
+            },
+            "last_turn_ended_before": {
+              "anyOf": [
+                {
+                  "description": "An ISO 8601 timestamp with a time zone.",
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only sessions whose last turn ended before this time, exclusively.",
+              "title": "Last Turn Ended Before"
+            },
+            "last_turn_outcome": {
+              "anyOf": [
+                {
+                  "items": {
+                    "enum": [
+                      "completed",
+                      "cancelled",
+                      "interrupted",
+                      "failed"
+                    ],
+                    "type": "string"
+                  },
+                  "maxItems": 4,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only sessions whose last turn has any of these outcomes.",
+              "title": "Last Turn Outcome"
+            }
+          },
+          "type": "object",
+          "required": [],
+          "default": {}
         }
       },
       "required": []
@@ -45646,6 +48063,62 @@
         "filter": {
           "additionalProperties": false,
           "properties": {
+            "last_turn_ended_after": {
+              "anyOf": [
+                {
+                  "description": "An ISO 8601 timestamp with a time zone.",
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only sessions whose last turn ended after this time, exclusively.",
+              "title": "Last Turn Ended After"
+            },
+            "last_turn_ended_before": {
+              "anyOf": [
+                {
+                  "description": "An ISO 8601 timestamp with a time zone.",
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only sessions whose last turn ended before this time, exclusively.",
+              "title": "Last Turn Ended Before"
+            },
+            "last_turn_outcome": {
+              "anyOf": [
+                {
+                  "items": {
+                    "enum": [
+                      "completed",
+                      "cancelled",
+                      "interrupted",
+                      "failed"
+                    ],
+                    "type": "string"
+                  },
+                  "maxItems": 4,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only sessions whose last turn has any of these outcomes.",
+              "title": "Last Turn Outcome"
+            },
             "agent_id": {
               "anyOf": [
                 {
@@ -46191,95 +48664,350 @@
             "display_name.asc"
           ],
           "default": "id.asc"
-        }
-      },
-      "required": []
-    },
-    "zo.event.list@1": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "limit": {
-          "type": "integer",
-          "minimum": 1,
-          "default": 33,
-          "description": "Rows per page, at most 33; 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."
-        }
-      },
-      "required": []
-    },
-    "zo.function.list@1": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "limit": {
-          "type": "integer",
-          "minimum": 1,
-          "default": 50,
-          "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."
-        }
-      },
-      "required": []
-    },
-    "zo.function.list_runs@1": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "limit": {
-          "type": "integer",
-          "minimum": 1,
-          "default": 50,
-          "description": "Rows per page, at most 200; a larger value is reduced to it."
+        }
+      },
+      "required": []
+    },
+    "zo.event.list@1": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 33,
+          "description": "Rows per page, at most 33; 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."
+        }
+      },
+      "required": []
+    },
+    "zo.function.list@1": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 50,
+          "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."
+        },
+        "filter": {
+          "additionalProperties": false,
+          "properties": {
+            "connection_id": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "title": "Connection Id"
+            }
+          },
+          "type": "object",
+          "required": [],
+          "default": {}
+        }
+      },
+      "required": []
+    },
+    "zo.function.list_runs@1": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 50,
+          "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": [
+            "created_at.desc",
+            "created_at.asc"
+          ],
+          "default": "created_at.desc"
+        },
+        "filter": {
+          "additionalProperties": false,
+          "properties": {
+            "created_after": {
+              "anyOf": [
+                {
+                  "description": "An ISO 8601 timestamp with a time zone.",
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs created after this time.",
+              "title": "Created After"
+            },
+            "created_before": {
+              "anyOf": [
+                {
+                  "description": "An ISO 8601 timestamp with a time zone.",
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs created before this time.",
+              "title": "Created Before"
+            },
+            "state": {
+              "anyOf": [
+                {
+                  "items": {
+                    "$ref": "#/$defs/RunState"
+                  },
+                  "maxItems": 8,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs in any of these states.",
+              "title": "State"
+            },
+            "error_code": {
+              "anyOf": [
+                {
+                  "items": {
+                    "pattern": "^[a-z][a-z0-9_]{0,63}$",
+                    "type": "string"
+                  },
+                  "maxItems": 20,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs with any of these error codes.",
+              "title": "Error Code"
+            },
+            "deployment_id": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs of this deployment.",
+              "title": "Deployment Id"
+            },
+            "entry_kind": {
+              "anyOf": [
+                {
+                  "items": {
+                    "enum": [
+                      "direct",
+                      "connection",
+                      "http"
+                    ],
+                    "type": "string"
+                  },
+                  "maxItems": 3,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs with any of these entry kinds.",
+              "title": "Entry Kind"
+            },
+            "trigger": {
+              "anyOf": [
+                {
+                  "items": {
+                    "enum": [
+                      "direct",
+                      "http",
+                      "event",
+                      "workflow_step",
+                      "run",
+                      "agent"
+                    ],
+                    "type": "string"
+                  },
+                  "maxItems": 6,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs with any of these trigger kinds.",
+              "title": "Trigger"
+            },
+            "subscription_id": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs delivered by this subscription.",
+              "title": "Subscription Id"
+            },
+            "agent_session_id": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs started by this Agent session.",
+              "title": "Agent Session Id"
+            }
+          },
+          "type": "object",
+          "required": [],
+          "default": {}
+        }
+      },
+      "required": [],
+      "$defs": {
+        "RunState": {
+          "enum": [
+            "queued",
+            "starting",
+            "running",
+            "succeeded",
+            "failed",
+            "cancel_requested",
+            "cancelled",
+            "unknown"
+          ],
+          "type": "string"
+        }
+      }
+    },
+    "zo.machine.list@1": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 50,
+          "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",
+            "created_at.desc",
+            "created_at.asc",
+            "display_name.asc"
+          ],
+          "default": "id.asc"
         },
-        "cursor": {
-          "type": "string",
-          "minLength": 1,
-          "maxLength": 5504,
-          "description": "The previous page's next_cursor, sent with the same sort, filter and search."
+        "filter": {
+          "additionalProperties": false,
+          "properties": {
+            "state": {
+              "anyOf": [
+                {
+                  "items": {
+                    "$ref": "#/$defs/ObservedState"
+                  },
+                  "maxItems": 8,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only machines in any of these states.",
+              "title": "State"
+            }
+          },
+          "type": "object",
+          "required": [],
+          "default": {}
         }
       },
-      "required": []
-    },
-    "zo.machine.list@1": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "limit": {
-          "type": "integer",
-          "minimum": 1,
-          "default": 50,
-          "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",
+      "required": [],
+      "$defs": {
+        "ObservedState": {
           "enum": [
-            "id.asc",
-            "created_at.desc",
-            "created_at.asc",
-            "display_name.asc"
+            "creating",
+            "running",
+            "stopping",
+            "stopped",
+            "resuming",
+            "destroying",
+            "destroyed",
+            "failed"
           ],
-          "default": "id.asc"
+          "type": "string"
         }
-      },
-      "required": []
+      }
     },
     "zo.machine.list_files@1": {
       "type": "object",
@@ -46551,6 +49279,21 @@
               "description": "Only subscriptions to this event definition.",
               "title": "Event Id"
             },
+            "schedule_id": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only subscriptions that run for this schedule.",
+              "title": "Schedule Id"
+            },
             "handler": {
               "anyOf": [
                 {
@@ -46631,6 +49374,21 @@
               "description": "Only subscriptions to this event definition.",
               "title": "Event Id"
             },
+            "schedule_id": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only subscriptions that run for this schedule.",
+              "title": "Schedule Id"
+            },
             "handler": {
               "anyOf": [
                 {
@@ -46998,9 +49756,186 @@
           "minLength": 1,
           "maxLength": 5504,
           "description": "The previous page's next_cursor, sent with the same sort, filter and search."
+        },
+        "sort": {
+          "type": "string",
+          "enum": [
+            "created_at.desc",
+            "created_at.asc"
+          ],
+          "default": "created_at.desc"
+        },
+        "filter": {
+          "additionalProperties": false,
+          "properties": {
+            "created_after": {
+              "anyOf": [
+                {
+                  "description": "An ISO 8601 timestamp with a time zone.",
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs created after this time.",
+              "title": "Created After"
+            },
+            "created_before": {
+              "anyOf": [
+                {
+                  "description": "An ISO 8601 timestamp with a time zone.",
+                  "maxLength": 40,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs created before this time.",
+              "title": "Created Before"
+            },
+            "state": {
+              "anyOf": [
+                {
+                  "items": {
+                    "$ref": "#/$defs/WorkflowRunState"
+                  },
+                  "maxItems": 7,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs in any of these states.",
+              "title": "State"
+            },
+            "error_code": {
+              "anyOf": [
+                {
+                  "items": {
+                    "$ref": "#/$defs/WorkflowRunError"
+                  },
+                  "maxItems": 5,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs with any of these error codes.",
+              "title": "Error Code"
+            },
+            "revision_id": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs of this revision.",
+              "title": "Revision Id"
+            },
+            "trigger": {
+              "anyOf": [
+                {
+                  "items": {
+                    "enum": [
+                      "direct",
+                      "event",
+                      "run",
+                      "agent"
+                    ],
+                    "type": "string"
+                  },
+                  "maxItems": 4,
+                  "minItems": 1,
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs with any of these trigger kinds.",
+              "title": "Trigger"
+            },
+            "subscription_id": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs delivered by this subscription.",
+              "title": "Subscription Id"
+            },
+            "agent_session_id": {
+              "anyOf": [
+                {
+                  "maxLength": 200,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "default": null,
+              "description": "Only runs started by this Agent session.",
+              "title": "Agent Session Id"
+            }
+          },
+          "type": "object",
+          "required": [],
+          "default": {}
         }
       },
-      "required": []
+      "required": [],
+      "$defs": {
+        "WorkflowRunError": {
+          "enum": [
+            "step_failed",
+            "deadline_exceeded",
+            "engine_error",
+            "engine_rejected",
+            "engine_unavailable"
+          ],
+          "type": "string"
+        },
+        "WorkflowRunState": {
+          "enum": [
+            "queued",
+            "running",
+            "cancel_requested",
+            "succeeded",
+            "failed",
+            "cancelled",
+            "unknown"
+          ],
+          "type": "string"
+        }
+      }
     },
     "zo.workspace.list_resources@1": {
       "type": "object",