@ellipsis-dev/sdk 0.31.0 → 0.33.0

package/schema/frames.schema.json

@@ -59,7 +59,7 @@
     },
     "AgentIdentity": {
       "additionalProperties": false,
-      "description": "The Ellipsis product namespace for a config file: which schema this is\n(`version`), the human-facing identity (`name`/`description`), freeform\norganizational `metadata`, and whether the agent is `enabled`. The\npresence of a top-level `ellipsis:` mapping is what marks a YAML file as\nan Ellipsis agent (vs arbitrary YAML that merely lives under a\nconfig directory) \u2014 see `yaml_is_ellipsis_config`.\n\n`enabled` is agent behavior, not freeform metadata, so it stays inside\nthe config `sha` (only `metadata` is sha-excluded). Whether a session\naccepts messages is a per-run choice (POST /v1/sessions `interactive`),\nnot a config one.",
+      "description": "The Ellipsis product namespace for a config file: which schema this is\n(`version`), the human-facing identity (`name`/`description`), freeform\norganizational `metadata`, and whether the agent is `enabled`. The\npresence of a top-level `ellipsis:` mapping is what marks a YAML file as\nan Ellipsis agent (vs arbitrary YAML that merely lives under a\nconfig directory) \u2014 see `yaml_is_ellipsis_config`.\n\n`enabled` is agent behavior, not freeform metadata, so it stays inside\nthe config `sha` (only `metadata` is sha-excluded).",
       "properties": {
         "description": {
           "anyOf": [
@@ -131,6 +131,7 @@
     },
     "BudgetConfig": {
       "additionalProperties": false,
+      "description": "A saved agent's spend limits: the per-session cap plus its total spend\nover the trailing 1, 7, and 28 days.",
       "properties": {
         "day": {
           "anyOf": [
@@ -142,6 +143,7 @@
             }
           ],
           "default": null,
+          "description": "The most the agent may spend over the last day, in US dollars.",
           "title": "Day"
         },
         "month": {
@@ -154,6 +156,7 @@
             }
           ],
           "default": null,
+          "description": "The most the agent may spend over the last 28 days, in US dollars.",
           "title": "Month"
         },
         "session": {
@@ -167,6 +170,7 @@
             }
           ],
           "default": null,
+          "description": "The most one session may spend, in US dollars.",
           "title": "Session"
         },
         "week": {
@@ -179,6 +183,7 @@
             }
           ],
           "default": null,
+          "description": "The most the agent may spend over the last 7 days, in US dollars.",
           "title": "Week"
         }
       },
@@ -191,6 +196,42 @@
       "title": "BudgetConfig",
       "type": "object"
     },
+    "CheckRunAction": {
+      "description": "The state of a check run when GitHub reports it. A run created before it finishes fires its status, and `in_progress` is `started`. A finished run fires its conclusion, `success` is `passed` and `failure` is `failed`. Every other value is the GitHub word.",
+      "enum": [
+        "requested",
+        "queued",
+        "waiting",
+        "pending",
+        "started",
+        "passed",
+        "failed",
+        "timed_out",
+        "cancelled",
+        "skipped",
+        "neutral",
+        "action_required",
+        "stale"
+      ],
+      "title": "CheckRunAction",
+      "type": "string"
+    },
+    "CheckSuiteAction": {
+      "description": "The conclusion of a finished check suite. `success` is `passed` and `failure` is `failed`. Every other value is the GitHub word.",
+      "enum": [
+        "passed",
+        "failed",
+        "timed_out",
+        "cancelled",
+        "skipped",
+        "neutral",
+        "action_required",
+        "stale",
+        "startup_failure"
+      ],
+      "title": "CheckSuiteAction",
+      "type": "string"
+    },
     "ClaudeAssistantEvent": {
       "additionalProperties": true,
       "properties": {
@@ -411,16 +452,9 @@
           "title": "Max Turns"
         },
         "model": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Model"
+          "description": "The model the session runs on: an alias or canonical id from the models table. Required.",
+          "title": "Model",
+          "type": "string"
         },
         "prompt": {
           "anyOf": [
@@ -1876,7 +1910,7 @@
     },
     "CodexConfig": {
       "additionalProperties": false,
-      "description": "Native options supported by the current Codex adapter.\n\nOptions and capabilities expand only when their runtime behavior is tested.\nUnknown options are rejected instead of silently ignored.",
+      "description": "Native options supported by the current Codex adapter.",
       "properties": {
         "effort": {
           "anyOf": [
@@ -1891,7 +1925,7 @@
           "description": "Reasoning effort for every turn. Omit to use the model default."
         },
         "model": {
-          "default": "gpt-6-sol",
+          "description": "The model the session runs on: a Responses-capable id from the models table. Required.",
           "title": "Model",
           "type": "string"
         },
@@ -3790,9 +3824,64 @@
       "title": "ConfigMetadata",
       "type": "object"
     },
+    "Cost": {
+      "description": "What something cost, in millicents.",
+      "properties": {
+        "charged": {
+          "default": 0,
+          "description": "What Ellipsis charged to credit, in millicents. It is everything except subscription tokens, and it is what the budget caps.",
+          "title": "Charged",
+          "type": "integer"
+        },
+        "cpu": {
+          "default": 0,
+          "description": "CPU spend in millicents.",
+          "title": "Cpu",
+          "type": "integer"
+        },
+        "fee": {
+          "default": 0,
+          "description": "Platform fee in millicents.",
+          "title": "Fee",
+          "type": "integer"
+        },
+        "llm": {
+          "$ref": "#/$defs/LlmCost",
+          "description": "LLM token cost, in total and by model, split by who paid."
+        },
+        "memory": {
+          "default": 0,
+          "description": "Memory spend in millicents.",
+          "title": "Memory",
+          "type": "integer"
+        },
+        "total": {
+          "default": 0,
+          "description": "Everything it cost, whoever paid, in millicents. It is the sum of llm.all.total, cpu, memory, and fee.",
+          "title": "Total",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "charged",
+        "cpu",
+        "fee",
+        "llm",
+        "memory",
+        "total"
+      ],
+      "title": "Cost",
+      "type": "object"
+    },
     "CronTrigger": {
       "additionalProperties": false,
+      "description": "A schedule: `schedule` is a five-field cron expression in UTC.\n\n`enabled: false` pauses the trigger and keeps its definition: the schedule\nstops firing while the agent stays live for on-demand starts and open\nsessions keep taking follow-ups (`ellipsis.enabled: false` pauses the\nwhole file instead). Re-enabling resumes at the next scheduled time; runs\nmissed while paused are not made up.",
       "properties": {
+        "enabled": {
+          "default": true,
+          "title": "Enabled",
+          "type": "boolean"
+        },
         "schedule": {
           "title": "Schedule",
           "type": "string"
@@ -3805,6 +3894,7 @@
         }
       },
       "required": [
+        "enabled",
         "schedule",
         "type"
       ],
@@ -3955,7 +4045,7 @@
     },
     "EllipsisGrant": {
       "additionalProperties": false,
-      "description": "One grant entry: a level, optionally narrowed to instances whose\nnatural key (a file's name, a memory's path, a secret's name, a config's\nname, a session's id) matches any of the `match` globs.",
+      "description": "One grant entry: a level, optionally narrowed to instances whose\nnatural key (a file's name, a secret's name, a config's name, a session's\nid) matches any of the `match` globs.",
       "properties": {
         "level": {
           "$ref": "#/$defs/Level"
@@ -4948,17 +5038,26 @@
     },
     "GithubAccountSelector": {
       "additionalProperties": false,
-      "description": "A selector of GitHub accounts \u2014 the `for:` audience gate on react\nsurfaces and code review pipelines, classified on the stable entity author\n(the pusher for `push`, the PR author for a review). `users` selects human\naccounts, `bots` selects bot accounts; each is a `GithubAccountFilter`\n(include minus exclude, with bare bool/list shorthand).",
+      "description": "A selector of GitHub accounts \u2014 the `for:` audience gate on react\nsurfaces, classified on the stable entity author (the pusher for `push`,\nthe PR author for a pull request). `users` selects human\naccounts, `bots` selects bot accounts; each is a `GithubAccountFilter`\n(include minus exclude, with bare bool/list shorthand).\n\n`teams` narrows further to members of any of the listed GitHub teams of\nthe installation's organization, by slug (`platform` for\n`@org/platform`). It applies on top of `users`: the author must pass the\nusers filter AND belong to a listed team. A bot is never a team member,\nso a selector with `teams` never admits one. Membership is resolved live\nat match time (see `TriggerEventContext.is_author_team_member`), and the\nconfig sync refuses a team that does not exist when the file is\naccepted.",
       "properties": {
         "bots": {
           "$ref": "#/$defs/GithubAccountFilter"
         },
+        "teams": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Teams",
+          "type": "array"
+        },
         "users": {
           "$ref": "#/$defs/GithubAccountFilter"
         }
       },
       "required": [
         "bots",
+        "teams",
         "users"
       ],
       "title": "GithubAccountSelector",
@@ -4979,6 +5078,18 @@
           "title": "Login",
           "type": "string"
         },
+        "name": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Name"
+        },
         "type": {
           "$ref": "#/$defs/GithubAccountType"
         }
@@ -4987,6 +5098,7 @@
         "avatar_url",
         "id",
         "login",
+        "name",
         "type"
       ],
       "title": "GithubAccountSnippet",
@@ -5002,6 +5114,194 @@
       "title": "GithubAccountType",
       "type": "string"
     },
+    "GithubCheckRunEvent": {
+      "properties": {
+        "action": {
+          "$ref": "#/$defs/CheckRunAction"
+        },
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "branch": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Branch"
+        },
+        "conclusion": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Conclusion"
+        },
+        "head_sha": {
+          "title": "Head Sha",
+          "type": "string"
+        },
+        "name": {
+          "title": "Name",
+          "type": "string"
+        },
+        "pull_request_number": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Pull Request Number"
+        },
+        "repository": {
+          "title": "Repository",
+          "type": "string"
+        },
+        "type": {
+          "const": "github.check_run",
+          "default": "github.check_run",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "branch",
+        "conclusion",
+        "head_sha",
+        "name",
+        "pull_request_number",
+        "repository",
+        "type",
+        "url"
+      ],
+      "title": "GithubCheckRunEvent",
+      "type": "object"
+    },
+    "GithubCheckSuiteEvent": {
+      "properties": {
+        "action": {
+          "$ref": "#/$defs/CheckSuiteAction"
+        },
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "app": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "App"
+        },
+        "branch": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Branch"
+        },
+        "conclusion": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Conclusion"
+        },
+        "head_sha": {
+          "title": "Head Sha",
+          "type": "string"
+        },
+        "pull_request_number": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Pull Request Number"
+        },
+        "repository": {
+          "title": "Repository",
+          "type": "string"
+        },
+        "type": {
+          "const": "github.check_suite",
+          "default": "github.check_suite",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "app",
+        "branch",
+        "conclusion",
+        "head_sha",
+        "pull_request_number",
+        "repository",
+        "type",
+        "url"
+      ],
+      "title": "GithubCheckSuiteEvent",
+      "type": "object"
+    },
     "GithubIssueEvent": {
       "properties": {
         "action": {
@@ -5055,7 +5355,7 @@
     },
     "GithubPermissions": {
       "additionalProperties": false,
-      "description": "The agent's GitHub access: the scope of the installation token minted for\nits session's environment \u2014 the credential `git`, `gh`, and the GitHub MCP\nserver authenticate with.\n\nBy default the token carries the installation's full permissions on all of\nthe installation's repositories. `permissions` narrows what it may do:\nthe string `read_only` grants read access to contents, issues, metadata and\npull requests; a map requests explicit levels per GitHub App permission\nscope (e.g. `{contents: read, pull_requests: write}`) and may never exceed\nwhat the installation granted. `repositories` scopes the token to exactly\nthe listed repos, by name (they must belong to the installation).\n\nRestriction is enforced by GitHub, not by Ellipsis: the token itself is\nminted with the reduced scope, so nothing running in the environment can\nexceed it.",
+      "description": "The agent's GitHub access: the scope of the installation token minted for\nits session's environment \u2014 the credential `git` and `gh` authenticate\nwith.\n\nBy default the token carries the installation's full permissions on all of\nthe installation's repositories. `permissions` narrows what it may do:\nthe string `read_only` grants read access to every scope the installation\ngranted; a map requests explicit levels per GitHub App permission\nscope (e.g. `{contents: read, pull_requests: write}`) and may never exceed\nwhat the installation granted. `repositories` scopes the token to exactly\nthe listed repos, by name (they must belong to the installation).\n\nRestriction is enforced by GitHub, not by Ellipsis: the token itself is\nminted with the reduced scope, so nothing running in the environment can\nexceed it.",
       "properties": {
         "permissions": {
           "anyOf": [
@@ -5216,23 +5516,264 @@
       "title": "GithubPushEvent",
       "type": "object"
     },
-    "HandlerService": {
-      "description": "The service whose events a handler responds to.",
-      "enum": [
-        "slack",
-        "github",
-        "linear",
-        "sentry"
-      ],
-      "title": "HandlerService",
-      "type": "string"
-    },
-    "HeartbeatFrame": {
-      "description": "A keepalive sent after a period of idleness; doubles as the dead-socket\nprobe. Clients should treat roughly twice the heartbeat interval of\nsilence as a dead connection.",
+    "GithubReleaseEvent": {
       "properties": {
-        "ts": {
-          "description": "Server time when the heartbeat was sent.",
-          "format": "date-time",
+        "action": {
+          "$ref": "#/$defs/ReleaseAction"
+        },
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "name": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Name"
+        },
+        "prerelease": {
+          "title": "Prerelease",
+          "type": "boolean"
+        },
+        "repository": {
+          "title": "Repository",
+          "type": "string"
+        },
+        "tag": {
+          "title": "Tag",
+          "type": "string"
+        },
+        "type": {
+          "const": "github.release",
+          "default": "github.release",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "name",
+        "prerelease",
+        "repository",
+        "tag",
+        "type",
+        "url"
+      ],
+      "title": "GithubReleaseEvent",
+      "type": "object"
+    },
+    "GithubStatusEvent": {
+      "properties": {
+        "action": {
+          "$ref": "#/$defs/StatusAction"
+        },
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "branch": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Branch"
+        },
+        "context": {
+          "title": "Context",
+          "type": "string"
+        },
+        "head_sha": {
+          "title": "Head Sha",
+          "type": "string"
+        },
+        "pull_request_number": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Pull Request Number"
+        },
+        "repository": {
+          "title": "Repository",
+          "type": "string"
+        },
+        "state": {
+          "title": "State",
+          "type": "string"
+        },
+        "type": {
+          "const": "github.status",
+          "default": "github.status",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "branch",
+        "context",
+        "head_sha",
+        "pull_request_number",
+        "repository",
+        "state",
+        "type",
+        "url"
+      ],
+      "title": "GithubStatusEvent",
+      "type": "object"
+    },
+    "GithubWorkflowRunEvent": {
+      "properties": {
+        "action": {
+          "$ref": "#/$defs/WorkflowRunAction"
+        },
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "branch": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Branch"
+        },
+        "conclusion": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Conclusion"
+        },
+        "head_sha": {
+          "title": "Head Sha",
+          "type": "string"
+        },
+        "name": {
+          "title": "Name",
+          "type": "string"
+        },
+        "pull_request_number": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Pull Request Number"
+        },
+        "repository": {
+          "title": "Repository",
+          "type": "string"
+        },
+        "run_number": {
+          "title": "Run Number",
+          "type": "integer"
+        },
+        "type": {
+          "const": "github.workflow_run",
+          "default": "github.workflow_run",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "branch",
+        "conclusion",
+        "head_sha",
+        "name",
+        "pull_request_number",
+        "repository",
+        "run_number",
+        "type",
+        "url"
+      ],
+      "title": "GithubWorkflowRunEvent",
+      "type": "object"
+    },
+    "HandlerService": {
+      "description": "The service whose events a handler responds to.",
+      "enum": [
+        "slack",
+        "github",
+        "linear",
+        "sentry"
+      ],
+      "title": "HandlerService",
+      "type": "string"
+    },
+    "HeartbeatFrame": {
+      "description": "A keepalive sent after a period of idleness; doubles as the dead-socket\nprobe. Clients should treat roughly twice the heartbeat interval of\nsilence as a dead connection.",
+      "properties": {
+        "ts": {
+          "description": "Server time when the heartbeat was sent.",
+          "format": "date-time",
           "title": "Ts",
           "type": "string"
         },
@@ -5252,7 +5793,7 @@
     },
     "InputContract": {
       "additionalProperties": false,
-      "description": "The typed input contract: what goes INTO a session (the trigger is\nwhen it happens; this is what goes in).\n\n`json_schema` validates customer data sent as `input` to\n`POST /v1/agents/{id}/sessions` and stored as `session.input`.\nInvocations require input when a schema is declared. React agents\ncannot declare schemas: the platform defines their event payloads.\n\n`message` is the initial-message template: exact `{{path}}` substitution\nover the caller payload (or, on a react agent, over the surface's\npublished fields), no conditionals/loops/filters. Refs are validated at\ndeploy time against the governing field set (see AgentConfig's\n`_check_input`).",
+      "description": "The typed input contract: what goes INTO a session (the trigger is\nwhen it happens; this is what goes in).\n\n`json_schema` validates customer data sent as `input` to\n`POST /v1/agents/{id}/sessions` (the dashboard and the CLI start\nthrough the same door) and stored as `session.input`. An on-demand\nstart requires input when a schema is declared. A trigger fires\nwithout it: a cron fire has no payload and a react fire carries the\nplatform-shaped event, so an agent may declare a schema alongside\neither trigger and the schema governs only its on-demand starts.\n\n`message` is the initial-message template: exact `{{path}}` substitution\nover the payload the session has (the caller payload on an on-demand\nstart, the surface's published fields on a react fire, the empty\nobject on a cron fire), no conditionals/loops/filters. Refs are\nvalidated at deploy time against every governing field set (see\nAgentConfig's `_check_input`): the caller schema's paths, the react\nsurface's published fields, and both when the agent has a react trigger\nand a schema, so one template renders fully on either door (declare the\nsurface's field names in the schema). Omit `message` to let each door\nrender its default. An unresolved ref renders as the empty string (a\ncron fire, an optional field the payload omitted).",
       "properties": {
         "json_schema": {
           "anyOf": [
@@ -5668,7 +6209,10 @@
               "$ref": "#/$defs/LinearIssueAction"
             },
             {
-              "const": "commented",
+              "enum": [
+                "commented",
+                "delegated"
+              ],
               "type": "string"
             }
           ],
@@ -5728,6 +6272,66 @@
       "title": "LinearIssueEvent",
       "type": "object"
     },
+    "LlmCost": {
+      "description": "What LLM tokens cost, in total and by model.",
+      "properties": {
+        "all": {
+          "$ref": "#/$defs/LlmCostSplit",
+          "description": "Token cost across every model."
+        },
+        "by_model": {
+          "description": "Token cost for each model that used tokens.",
+          "items": {
+            "$ref": "#/$defs/ModelLlmCostSplit"
+          },
+          "title": "By Model",
+          "type": "array"
+        }
+      },
+      "required": [
+        "all",
+        "by_model"
+      ],
+      "title": "LlmCost",
+      "type": "object"
+    },
+    "LlmCostSplit": {
+      "description": "What LLM tokens cost, in millicents, split by who paid (Ellipsis credit or the user's own subscription).",
+      "properties": {
+        "claude_subscription": {
+          "default": 0,
+          "description": "Token cost paid by a Claude subscription, at Ellipsis rates, in millicents.",
+          "title": "Claude Subscription",
+          "type": "integer"
+        },
+        "codex_subscription": {
+          "default": 0,
+          "description": "Token cost paid by a Codex subscription, at Ellipsis rates, in millicents.",
+          "title": "Codex Subscription",
+          "type": "integer"
+        },
+        "platform": {
+          "default": 0,
+          "description": "Token cost charged to Ellipsis credit, in millicents.",
+          "title": "Platform",
+          "type": "integer"
+        },
+        "total": {
+          "default": 0,
+          "description": "All token cost, in millicents. It is the sum of platform, claude_subscription, and codex_subscription.",
+          "title": "Total",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "claude_subscription",
+        "codex_subscription",
+        "platform",
+        "total"
+      ],
+      "title": "LlmCostSplit",
+      "type": "object"
+    },
     "McpRemoteServer": {
       "additionalProperties": false,
       "description": "A bring-your-own remote MCP server: the harness talks HTTP to `url`.\nNothing runs in the environment image. `headers` carry static auth (e.g.\n`Authorization: Bearer ${TOKEN}`); values may embed `${NAME}` secret\nreferences, resolved at run time from the account's secrets store.",
@@ -5759,7 +6363,7 @@
     },
     "McpServerRef": {
       "additionalProperties": false,
-      "description": "One built-in MCP server this agent opts into by name (`linear`/`slack`).\nA name reference over the connected built-in set \u2014 the platform manages the\nserver's transport and credentials. It only matters when the named\nintegration is set to `opt_in` inclusion; an integration in the default\n`all_sessions` mode is added regardless. For a server the platform does not\nprovide, define it instead (`McpStdioServer` /\n`McpRemoteServer`).",
+      "description": "One built-in MCP server this agent attaches by name (`linear`/`slack`).\nA name reference over the connected built-in set \u2014 the platform manages the\nserver's transport and credentials. A session gets a built-in server only\nwhen its config names it here or the session started from that server's\nown surface. For a server the platform does not provide, define it instead\n(`McpStdioServer` / `McpRemoteServer`).",
       "properties": {
         "name": {
           "title": "Name",
@@ -6453,206 +7057,98 @@
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
-    "OutboxCollectedPayload": {
-      "additionalProperties": true,
-      "description": "outbox_collected: the platform read a code_review session's\n/ellipsis/outbox/* when its turn ended. Carries both raw and parsed so\nthe feed alone tells the whole delivery story; the code_review_outbox\ntable is the queryable projection of this record.",
+    "ModelLlmCostSplit": {
+      "description": "What one model's tokens cost, in millicents, split by who paid.",
       "properties": {
-        "findings": {
-          "default": [],
-          "items": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "title": "Findings",
-          "type": "array"
+        "claude_subscription": {
+          "default": 0,
+          "description": "Token cost paid by a Claude subscription, at Ellipsis rates, in millicents.",
+          "title": "Claude Subscription",
+          "type": "integer"
         },
-        "parse_errors": {
-          "default": [],
-          "items": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "title": "Parse Errors",
-          "type": "array"
+        "codex_subscription": {
+          "default": 0,
+          "description": "Token cost paid by a Codex subscription, at Ellipsis rates, in millicents.",
+          "title": "Codex Subscription",
+          "type": "integer"
         },
-        "parser_version": {
-          "title": "Parser Version",
+        "model": {
+          "description": "The model that used these tokens.",
+          "title": "Model",
           "type": "string"
         },
-        "raw": {
-          "additionalProperties": {
-            "type": "string"
-          },
-          "default": {},
-          "title": "Raw",
-          "type": "object"
+        "platform": {
+          "default": 0,
+          "description": "Token cost charged to Ellipsis credit, in millicents.",
+          "title": "Platform",
+          "type": "integer"
+        },
+        "total": {
+          "default": 0,
+          "description": "All token cost, in millicents. It is the sum of platform, claude_subscription, and codex_subscription.",
+          "title": "Total",
+          "type": "integer"
         }
       },
       "required": [
-        "parser_version"
+        "claude_subscription",
+        "codex_subscription",
+        "model",
+        "platform",
+        "total"
       ],
-      "title": "OutboxCollectedPayload",
+      "title": "ModelLlmCostSplit",
       "type": "object"
     },
-    "OutboxCollectedRecord": {
+    "ModelTokenCounts": {
+      "description": "Token counts for one model.",
       "properties": {
-        "cost": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Cost"
-        },
-        "created_at": {
-          "format": "date-time",
-          "title": "Created At",
-          "type": "string"
-        },
-        "duration": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Duration"
-        },
-        "feed_seq": {
-          "description": "Position in the session feed and the stream's resume cursor.",
-          "title": "Feed Seq",
+        "cache_creation": {
+          "default": 0,
+          "description": "Tokens written to the prompt cache.",
+          "title": "Cache Creation",
           "type": "integer"
         },
-        "id": {
-          "description": "Unique identifier of the record.",
-          "title": "Id",
-          "type": "string"
+        "cache_read": {
+          "default": 0,
+          "description": "Tokens read from the prompt cache.",
+          "title": "Cache Read",
+          "type": "integer"
         },
-        "kind": {
-          "const": "platform",
-          "default": "platform",
-          "title": "Kind",
-          "type": "string"
+        "input": {
+          "default": 0,
+          "description": "Input tokens used.",
+          "title": "Input",
+          "type": "integer"
         },
         "model": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Model"
-        },
-        "payload": {
-          "$ref": "#/$defs/OutboxCollectedPayload"
-        },
-        "record_format": {
-          "const": "ellipsis_lifecycle@1",
-          "default": "ellipsis_lifecycle@1",
-          "title": "Record Format",
-          "type": "string"
-        },
-        "record_type": {
-          "const": "outbox_collected",
-          "default": "outbox_collected",
-          "title": "Record Type",
-          "type": "string"
-        },
-        "session_id": {
-          "description": "Session containing this record.",
-          "title": "Session Id",
-          "type": "string"
-        },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
-        "source": {
-          "const": "lifecycle",
-          "default": "lifecycle",
-          "title": "Source",
+          "description": "The model that used these tokens.",
+          "title": "Model",
           "type": "string"
         },
-        "tokens_info": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/TokensInfo"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null
-        },
-        "tools": {
-          "anyOf": [
-            {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Tools"
+        "output": {
+          "default": 0,
+          "description": "Output tokens used.",
+          "title": "Output",
+          "type": "integer"
         },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
+        "total": {
+          "default": 0,
+          "description": "All tokens used, including prompt cache reads and writes. Token cost is priced on this.",
+          "title": "Total",
+          "type": "integer"
         }
       },
       "required": [
-        "cost",
-        "created_at",
-        "duration",
-        "feed_seq",
-        "id",
-        "kind",
+        "cache_creation",
+        "cache_read",
+        "input",
         "model",
-        "payload",
-        "record_format",
-        "record_type",
-        "session_id",
-        "session_message_id",
-        "source",
-        "tokens_info",
-        "tools",
-        "turn_id"
+        "output",
+        "total"
       ],
-      "title": "OutboxCollectedRecord",
-      "type": "object",
-      "x-ellipsis-preserve-payload": true
+      "title": "ModelTokenCounts",
+      "type": "object"
     },
     "OutputConfig": {
       "additionalProperties": false,
@@ -6672,7 +7168,7 @@
     },
     "PermissionsConfig": {
       "additionalProperties": false,
-      "description": "What the agent is allowed to touch, per credential the platform mints\ninto its session's environment. Distinct from `environment:`, which is\nwhere the agent runs; this is what it may do from there.\n\n`ellipsis` scopes the session's Ellipsis API token (`ELLIPSIS_API_TOKEN`,\nwhat the `agent` CLI running inside the session authenticates with).\n`true` / the string `all` (the default) grant the full session token\nceiling \u2014 everything a session token can ever do. A map narrows it per\nresource (see `EllipsisPermissions`); the minted token carries\nthe intersection, so a config can only ever reduce access. `false` fails\nvalidation \u2014 an agent with no API token cannot report its own progress.\n\n`github` scopes the session's GitHub installation token (`GH_TOKEN`) \u2014\nsee `GithubPermissions`. GitHub enforces it at mint time.",
+      "description": "What the agent is allowed to touch, per credential the platform mints\ninto its session's environment. Distinct from `environment:`, which is\nwhere the agent runs; this is what it may do from there.\n\n`ellipsis` scopes the session's Ellipsis API token (`ELLIPSIS_API_TOKEN`,\nwhat the `ellipsis` CLI running inside the session authenticates with).\n`true` / the string `all` (the default) grant the full session token\nceiling \u2014 everything a session token can ever do. A map narrows it per\nresource (see `EllipsisPermissions`); the minted token carries\nthe intersection, so a config can only ever reduce access. `false` fails\nvalidation \u2014 an agent with no API token cannot report its own progress.\n\n`github` scopes the session's GitHub installation token (`GH_TOKEN`) \u2014\nsee `GithubPermissions`. GitHub enforces it at mint time.",
       "properties": {
         "ellipsis": {
           "anyOf": [
@@ -6713,7 +7209,6 @@
           "message_delivered": "#/$defs/MessageDeliveredRecord",
           "message_received": "#/$defs/MessageReceivedRecord",
           "message_requeued": "#/$defs/MessageRequeuedRecord",
-          "outbox_collected": "#/$defs/OutboxCollectedRecord",
           "session_closed": "#/$defs/SessionClosedRecord",
           "turn_ended": "#/$defs/TurnEndedRecord",
           "turn_started": "#/$defs/TurnStartedRecord"
@@ -6747,9 +7242,6 @@
         },
         {
           "$ref": "#/$defs/EnvironmentReadyRecord"
-        },
-        {
-          "$ref": "#/$defs/OutboxCollectedRecord"
         }
       ]
     },
@@ -6757,7 +7249,6 @@
       "description": "Why direct prompting is refused. Absent when prompting is allowed.",
       "enum": [
         "mention_surface",
-        "ephemeral_trigger",
         "non_interactive",
         "harness_single_turn",
         "budget_exhausted",
@@ -6778,6 +7269,100 @@
       "title": "PullRequestAction",
       "type": "string"
     },
+    "ReactCheckRun": {
+      "additionalProperties": false,
+      "description": "A check run changing state on a commit. A check run is a GitHub Actions job or a check another CI app reports. `on` lists the states that fire. `names` matches check names exactly or by a prefix ending in `*`. `branch` is the branch the check ran on. `for` is the author of the commit the check ran on. Needs the Checks permission.",
+      "properties": {
+        "branch": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Branch",
+          "type": "array"
+        },
+        "for": {
+          "$ref": "#/$defs/GithubAccountSelector"
+        },
+        "names": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Names",
+          "type": "array"
+        },
+        "on": {
+          "default": [
+            "failed"
+          ],
+          "items": {
+            "$ref": "#/$defs/CheckRunAction"
+          },
+          "title": "On",
+          "type": "array"
+        },
+        "repositories": {
+          "$ref": "#/$defs/RepositoryFilter"
+        }
+      },
+      "required": [
+        "branch",
+        "for",
+        "names",
+        "on",
+        "repositories"
+      ],
+      "title": "ReactCheckRun",
+      "type": "object"
+    },
+    "ReactCheckSuite": {
+      "additionalProperties": false,
+      "description": "Every check one CI app reported on a commit finishing. GitHub reports a check suite only when it finishes, so `on` takes only finished states. `apps` matches the reporting app slug, such as `github-actions`, exactly or by a prefix ending in `*`. `branch` and `for` work as on `check_run`. Needs the Checks permission.",
+      "properties": {
+        "apps": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Apps",
+          "type": "array"
+        },
+        "branch": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Branch",
+          "type": "array"
+        },
+        "for": {
+          "$ref": "#/$defs/GithubAccountSelector"
+        },
+        "on": {
+          "default": [
+            "failed"
+          ],
+          "items": {
+            "$ref": "#/$defs/CheckSuiteAction"
+          },
+          "title": "On",
+          "type": "array"
+        },
+        "repositories": {
+          "$ref": "#/$defs/RepositoryFilter"
+        }
+      },
+      "required": [
+        "apps",
+        "branch",
+        "for",
+        "on",
+        "repositories"
+      ],
+      "title": "ReactCheckSuite",
+      "type": "object"
+    },
     "ReactIssue": {
       "additionalProperties": false,
       "properties": {
@@ -6945,6 +7530,57 @@
       "title": "ReactPush",
       "type": "object"
     },
+    "ReactRelease": {
+      "additionalProperties": false,
+      "description": "A GitHub release being published \u2014 a release or prerelease published\ndirectly, or a draft published later. `tag` narrows to the release tags\nthat match (exact, or a prefix ending in `*`, so `v*`); `prerelease`\nselects prereleases or full releases, like `draft` on pull requests. The\n`for:` audience is the release's author, which for a release cut by CI is\na bot and needs `bots` to opt in.",
+      "properties": {
+        "for": {
+          "$ref": "#/$defs/GithubAccountSelector"
+        },
+        "on": {
+          "default": [
+            "published"
+          ],
+          "items": {
+            "$ref": "#/$defs/ReleaseAction"
+          },
+          "title": "On",
+          "type": "array"
+        },
+        "prerelease": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Prerelease"
+        },
+        "repositories": {
+          "$ref": "#/$defs/RepositoryFilter"
+        },
+        "tag": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Tag",
+          "type": "array"
+        }
+      },
+      "required": [
+        "for",
+        "on",
+        "prerelease",
+        "repositories",
+        "tag"
+      ],
+      "title": "ReactRelease",
+      "type": "object"
+    },
     "ReactSentry": {
       "additionalProperties": false,
       "properties": {
@@ -6977,9 +7613,84 @@
       "title": "ReactSlackChannel",
       "type": "object"
     },
+    "ReactStatus": {
+      "additionalProperties": false,
+      "description": "A commit status changing state, from CI that posts statuses instead of checks. `names` matches status contexts exactly or by a prefix ending in `*`. `branch` matches when any branch GitHub lists for the commit matches. `for` works as on `check_run`. Needs the Commit statuses permission.",
+      "properties": {
+        "branch": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Branch",
+          "type": "array"
+        },
+        "for": {
+          "$ref": "#/$defs/GithubAccountSelector"
+        },
+        "names": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Names",
+          "type": "array"
+        },
+        "on": {
+          "default": [
+            "failed"
+          ],
+          "items": {
+            "$ref": "#/$defs/StatusAction"
+          },
+          "title": "On",
+          "type": "array"
+        },
+        "repositories": {
+          "$ref": "#/$defs/RepositoryFilter"
+        }
+      },
+      "required": [
+        "branch",
+        "for",
+        "names",
+        "on",
+        "repositories"
+      ],
+      "title": "ReactStatus",
+      "type": "object"
+    },
     "ReactTrigger": {
       "additionalProperties": false,
+      "description": "An event trigger: exactly one surface block names the events to match.\n\n`enabled: false` pauses the trigger and keeps its definition: events stop\nmatching while the agent stays live for on-demand starts and open\nsessions keep taking follow-ups (`ellipsis.enabled: false` pauses the\nwhole file instead).",
       "properties": {
+        "check_run": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ReactCheckRun"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "check_suite": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ReactCheckSuite"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "enabled": {
+          "default": true,
+          "title": "Enabled",
+          "type": "boolean"
+        },
         "issue": {
           "anyOf": [
             {
@@ -7024,6 +7735,17 @@
           ],
           "default": null
         },
+        "release": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ReactRelease"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "sentry": {
           "anyOf": [
             {
@@ -7038,7 +7760,18 @@
         "slack_channel": {
           "anyOf": [
             {
-              "$ref": "#/$defs/ReactSlackChannel"
+              "$ref": "#/$defs/ReactSlackChannel"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "status": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ReactStatus"
             },
             {
               "type": "null"
@@ -7051,20 +7784,84 @@
           "default": "react",
           "title": "Type",
           "type": "string"
+        },
+        "workflow_run": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ReactWorkflowRun"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
         }
       },
       "required": [
+        "check_run",
+        "check_suite",
+        "enabled",
         "issue",
         "linear_issue",
         "pull_request",
         "push",
+        "release",
         "sentry",
         "slack_channel",
-        "type"
+        "status",
+        "type",
+        "workflow_run"
       ],
       "title": "ReactTrigger",
       "type": "object"
     },
+    "ReactWorkflowRun": {
+      "additionalProperties": false,
+      "description": "A GitHub Actions workflow run changing state. `names` matches workflow names exactly or by a prefix ending in `*`. `branch` is the branch the run is for. `for` works as on `check_run`. Needs the Actions permission.",
+      "properties": {
+        "branch": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Branch",
+          "type": "array"
+        },
+        "for": {
+          "$ref": "#/$defs/GithubAccountSelector"
+        },
+        "names": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Names",
+          "type": "array"
+        },
+        "on": {
+          "default": [
+            "failed"
+          ],
+          "items": {
+            "$ref": "#/$defs/WorkflowRunAction"
+          },
+          "title": "On",
+          "type": "array"
+        },
+        "repositories": {
+          "$ref": "#/$defs/RepositoryFilter"
+        }
+      },
+      "required": [
+        "branch",
+        "for",
+        "names",
+        "on",
+        "repositories"
+      ],
+      "title": "ReactWorkflowRun",
+      "type": "object"
+    },
     "RecordsAppendFrame": {
       "description": "Cursored append-only delivery of session records, ordered by feed_seq,\nfrom all sources. Every record in the frame advances the resume cursor \u2014\nincluding ones a client renders as nothing.",
       "properties": {
@@ -7090,6 +7887,14 @@
       "title": "RecordsAppendFrame",
       "type": "object"
     },
+    "ReleaseAction": {
+      "description": "What happened to a GitHub release. `published` is the one moment a\nrelease becomes visible: a release or prerelease published directly, or a\ndraft published later. Edits, deletions, and unpublishes never fire.",
+      "enum": [
+        "published"
+      ],
+      "title": "ReleaseAction",
+      "type": "string"
+    },
     "RepositoryFilter": {
       "anyOf": [
         {
@@ -7174,14 +7979,13 @@
         "account",
         "alerts",
         "sessions",
-        "memories",
-        "reviews",
         "configs",
         "defaults",
         "environments",
         "secrets",
         "templates",
         "integrations",
+        "reviews",
         "tokens",
         "webhooks",
         "user"
@@ -7768,9 +8572,9 @@
         },
         "budget": {
           "default": 0,
-          "description": "The spend budget enforced for this session, in US dollars, after resolving defaults and ceilings.",
+          "description": "The spend budget enforced for this session, in millicents, after resolving defaults and ceilings.",
           "title": "Budget",
-          "type": "number"
+          "type": "integer"
         },
         "claude_code": {
           "anyOf": [
@@ -7801,8 +8605,8 @@
           "description": "Whether the session can take more messages, and whether an agent is warm to answer one."
         },
         "cost": {
-          "$ref": "#/$defs/SessionCost",
-          "description": "What the session has cost so far, in millicents, broken down by leg and carrying its own total."
+          "$ref": "#/$defs/Cost",
+          "description": "What the session has cost so far."
         },
         "created_at": {
           "description": "When the session was created.",
@@ -7819,9 +8623,14 @@
             {
               "discriminator": {
                 "mapping": {
+                  "github.check_run": "#/$defs/GithubCheckRunEvent",
+                  "github.check_suite": "#/$defs/GithubCheckSuiteEvent",
                   "github.issue": "#/$defs/GithubIssueEvent",
                   "github.pull_request": "#/$defs/GithubPullRequestEvent",
                   "github.push": "#/$defs/GithubPushEvent",
+                  "github.release": "#/$defs/GithubReleaseEvent",
+                  "github.status": "#/$defs/GithubStatusEvent",
+                  "github.workflow_run": "#/$defs/GithubWorkflowRunEvent",
                   "linear.issue": "#/$defs/LinearIssueEvent",
                   "sentry.alert": "#/$defs/SentryAlertEvent",
                   "slack.channel_created": "#/$defs/SlackChannelCreatedEvent",
@@ -7839,6 +8648,21 @@
                 {
                   "$ref": "#/$defs/GithubPushEvent"
                 },
+                {
+                  "$ref": "#/$defs/GithubCheckRunEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubCheckSuiteEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubWorkflowRunEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubStatusEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubReleaseEvent"
+                },
                 {
                   "$ref": "#/$defs/LinearIssueEvent"
                 },
@@ -7902,14 +8726,14 @@
         "output": {
           "anyOf": [
             {
-              "$ref": "#/$defs/OutputConfig"
+              "$ref": "#/$defs/SessionOutput"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "The structured-output exit contract for this session."
+          "description": "The session's structured output: the `json_schema` the agent must satisfy and, once a turn has submitted it, the `result`."
         },
         "parent": {
           "anyOf": [
@@ -7952,8 +8776,8 @@
           "description": "The latest live summary of the session's progress while it runs, and when it was generated."
         },
         "tokens": {
-          "$ref": "#/$defs/SessionTokens",
-          "description": "The tokens the session spent and the model they went to. `total` includes the prompt-cache lanes."
+          "$ref": "#/$defs/Tokens",
+          "description": "The tokens the session has used so far."
         },
         "turn": {
           "anyOf": [
@@ -8020,7 +8844,7 @@
             }
           ],
           "default": null,
-          "description": "Identifier of the saved agent this session's snapshot was taken from. Null for a routing-file agent, a code-review stage agent, or the built-in mention agent, which have no saved agent behind them. Points at the agent as it exists now, which may have changed since.",
+          "description": "Identifier of the saved agent this session's snapshot was taken from. Null for a routing-file agent or the built-in mention agent, which have no saved agent behind them. Points at the agent as it exists now, which may have changed since.",
           "title": "Id"
         }
       },
@@ -8349,6 +9173,12 @@
           "default": null,
           "description": "Codex input and native options. Set exactly one of claude_code or codex."
         },
+        "conversation": {
+          "$ref": "#/$defs/SessionConversationConfig",
+          "default": {
+            "interactive": true
+          }
+        },
         "environment": {
           "anyOf": [
             {
@@ -8377,6 +9207,15 @@
           },
           "title": "Environment"
         },
+        "metadata": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "default": {},
+          "description": "Arbitrary string key/value metadata stored on every session.",
+          "title": "Metadata",
+          "type": "object"
+        },
         "output": {
           "anyOf": [
             {
@@ -8411,7 +9250,9 @@
         "budget",
         "claude_code",
         "codex",
+        "conversation",
         "environment",
+        "metadata",
         "output",
         "permissions",
         "skills"
@@ -8450,48 +9291,21 @@
       "title": "SessionConversation",
       "type": "object"
     },
-    "SessionCost": {
-      "description": "What a session (or one turn of it) cost, in millicents.\n\n`llm` is deliberately NOT called `tokens`: it would sit beside the `tokens`\nobject and read as \"the token count's cost\" rather than \"the cost of the\nLLM leg\".",
+    "SessionConversationConfig": {
+      "additionalProperties": false,
+      "description": "Conversation settings for a session, set on a saved agent or sent when starting a session or running an agent.",
       "properties": {
-        "cpu": {
-          "default": 0,
-          "description": "CPU spend in millicents.",
-          "title": "Cpu",
-          "type": "integer"
-        },
-        "fee": {
-          "default": 0,
-          "description": "Platform fee in millicents.",
-          "title": "Fee",
-          "type": "integer"
-        },
-        "llm": {
-          "default": 0,
-          "description": "LLM spend in millicents.",
-          "title": "Llm",
-          "type": "integer"
-        },
-        "memory": {
-          "default": 0,
-          "description": "Memory spend in millicents.",
-          "title": "Memory",
-          "type": "integer"
-        },
-        "total": {
-          "default": 0,
-          "description": "The grand total in millicents: llm + cpu + memory + fee.",
-          "title": "Total",
-          "type": "integer"
+        "interactive": {
+          "default": true,
+          "description": "Whether the session stays open after its first turn. Defaults to true; false runs once and requires a prompt. Requires the model's interactive capability when true. Direct message acceptance is reported separately in conversation.prompting.",
+          "title": "Interactive",
+          "type": "boolean"
         }
       },
       "required": [
-        "cpu",
-        "fee",
-        "llm",
-        "memory",
-        "total"
+        "interactive"
       ],
-      "title": "SessionCost",
+      "title": "SessionConversationConfig",
       "type": "object"
     },
     "SessionEnvironment": {
@@ -9062,6 +9876,37 @@
       "title": "SessionMessageStatus",
       "type": "string"
     },
+    "SessionOutput": {
+      "description": "Structured output on the wire: the contract and, when a turn has\nsubmitted one, the payload. `result` is None while the session runs and\nwhen no turn submitted anything; it is the agent's own JSON, in the\nshape of `json_schema`.",
+      "properties": {
+        "json_schema": {
+          "additionalProperties": true,
+          "description": "JSON Schema the agent's result must satisfy.",
+          "title": "Json Schema",
+          "type": "object"
+        },
+        "result": {
+          "anyOf": [
+            {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The payload the agent submitted, or null until a turn submits one.",
+          "title": "Result"
+        }
+      },
+      "required": [
+        "json_schema",
+        "result"
+      ],
+      "title": "SessionOutput",
+      "type": "object"
+    },
     "SessionParent": {
       "description": "The predecessor session this session continues.",
       "properties": {
@@ -9160,9 +10005,10 @@
       ]
     },
     "SessionSource": {
-      "description": "Where a session came from: the credential that started it (web app,\nAPI key, CLI) or the trigger that fired (react, mention, cron). Never\ntaken from a request body.",
+      "description": "Where a session came from: the credential that started it (web app,\nAPI key, CLI) or the trigger that fired (react, mention, cron, code\nreview). Never taken from a request body.",
       "enum": [
         "react",
+        "code_review",
         "web",
         "api",
         "cli",
@@ -9240,62 +10086,11 @@
       "title": "SessionSummary",
       "type": "object"
     },
-    "SessionTokens": {
-      "description": "The token counts a session (or turn) spent, and the model they went to.\n\n`total` INCLUDES the cache lanes, unlike the old flat `tokens_total` which\ncounted input+output+thinking only and left callers to add cache reads and\nwrites back themselves (the deleted `tokensTotalAll` helper). Cache tokens\ndominate an agent run's token bill, so a \"total\" that omits them is the\nwrong default and produced two competing totals in the dashboard.",
-      "properties": {
-        "cache_creation": {
-          "default": 0,
-          "description": "Tokens written to the prompt cache.",
-          "title": "Cache Creation",
-          "type": "integer"
-        },
-        "cache_read": {
-          "default": 0,
-          "description": "Tokens read from the prompt cache.",
-          "title": "Cache Read",
-          "type": "integer"
-        },
-        "input": {
-          "default": 0,
-          "description": "Input tokens used.",
-          "title": "Input",
-          "type": "integer"
-        },
-        "model": {
-          "default": "",
-          "description": "The model the token counts are attributed to.",
-          "title": "Model",
-          "type": "string"
-        },
-        "output": {
-          "default": 0,
-          "description": "Output tokens used.",
-          "title": "Output",
-          "type": "integer"
-        },
-        "total": {
-          "default": 0,
-          "description": "Total tokens consumed, INCLUDING the prompt-cache reads and writes \u2014 the same basis the token cost is priced on.",
-          "title": "Total",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "cache_creation",
-        "cache_read",
-        "input",
-        "model",
-        "output",
-        "total"
-      ],
-      "title": "SessionTokens",
-      "type": "object"
-    },
     "SessionTurn": {
       "description": "One message and the agent's answer to it. A turn is `pending` from the\nmoment its message is received until the agent starts on it, `running`\nwhile the agent works, then `completed`, `failed`, `stopped`, or\n`cancelled`.",
       "properties": {
         "cost": {
-          "$ref": "#/$defs/SessionCost",
+          "$ref": "#/$defs/Cost",
           "description": "What the turn cost so far, in millicents, broken down by leg."
         },
         "created_at": {
@@ -9384,7 +10179,7 @@
           "description": "When and by whom a stop was requested; null when none was."
         },
         "tokens": {
-          "$ref": "#/$defs/SessionTokens",
+          "$ref": "#/$defs/Tokens",
           "description": "The tokens the turn spent and the model they went to."
         }
       },
@@ -9406,7 +10201,7 @@
     },
     "SettingsRef": {
       "additionalProperties": false,
-      "description": "A config-declared Claude Code settings.json, resolved at run start and\npassed to `claude --settings <path>`. That is the CLI settings tier \u2014 BELOW\nEllipsis's managed-settings.json floor \u2014 so it customizes behavior (model\npermissions, includeCoAuthoredBy, statusLine, ...) but can never weaken a\nsecurity setting. Lets a team point the cloud agent at the same settings file\nthey already use with Claude Code locally instead of re-encoding it as YAML.",
+      "description": "A Claude Code settings.json read from a repository and applied to the\nsession. It adds permission rules and other Claude Code settings; rules the\nplatform sets stay in force. Supported models list `settings` in\n`/v1/account/models`.",
       "properties": {
         "path": {
           "title": "Path",
@@ -9635,6 +10430,84 @@
       "title": "SnapshotFrame",
       "type": "object"
     },
+    "StatusAction": {
+      "description": "The state of a commit status. `success` is `passed`, `failure` is `failed`, and `error` is `errored`.",
+      "enum": [
+        "pending",
+        "passed",
+        "failed",
+        "errored"
+      ],
+      "title": "StatusAction",
+      "type": "string"
+    },
+    "TokenCounts": {
+      "description": "Token counts.",
+      "properties": {
+        "cache_creation": {
+          "default": 0,
+          "description": "Tokens written to the prompt cache.",
+          "title": "Cache Creation",
+          "type": "integer"
+        },
+        "cache_read": {
+          "default": 0,
+          "description": "Tokens read from the prompt cache.",
+          "title": "Cache Read",
+          "type": "integer"
+        },
+        "input": {
+          "default": 0,
+          "description": "Input tokens used.",
+          "title": "Input",
+          "type": "integer"
+        },
+        "output": {
+          "default": 0,
+          "description": "Output tokens used.",
+          "title": "Output",
+          "type": "integer"
+        },
+        "total": {
+          "default": 0,
+          "description": "All tokens used, including prompt cache reads and writes. Token cost is priced on this.",
+          "title": "Total",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "cache_creation",
+        "cache_read",
+        "input",
+        "output",
+        "total"
+      ],
+      "title": "TokenCounts",
+      "type": "object"
+    },
+    "Tokens": {
+      "description": "Tokens used, in total and by model.",
+      "properties": {
+        "all": {
+          "$ref": "#/$defs/TokenCounts",
+          "description": "Token counts across every model."
+        },
+        "by_model": {
+          "description": "Token counts for each model that used tokens.",
+          "items": {
+            "$ref": "#/$defs/ModelTokenCounts"
+          },
+          "title": "By Model",
+          "type": "array"
+        }
+      },
+      "required": [
+        "all",
+        "by_model"
+      ],
+      "title": "Tokens",
+      "type": "object"
+    },
     "TokensInfo": {
       "additionalProperties": false,
       "description": "Token/cost usage, per record (one API call's counts, aggregate fields at\ntheir zero defaults) or aggregated per turn/session\n(compute_spend_from_records derives num_turns and cost_usd).\n\nStrict on purpose: this is our own persisted schema, so an unknown key is a\nwriter bug (the num_turns=0 bug shipped because a Claude Code usage dict\nvalidated leniently against this model, silently zeroing every\nnon-overlapping field). Legacy keys were dropped from persisted blobs by\nthe 2026-07-26 tokens_info migration; per-model usage (CC's modelUsage,\nverbatim) is stored separately, not here.",
@@ -10269,6 +11142,27 @@
       "title": "UnknownSessionRecord",
       "type": "object",
       "x-ellipsis-preserve-payload": true
+    },
+    "WorkflowRunAction": {
+      "description": "The state of a GitHub Actions workflow run when GitHub reports it. Before the run finishes it is the status, and `in_progress` is `started`. After it finishes it is the conclusion, `success` is `passed` and `failure` is `failed`. Every other value is the GitHub word.",
+      "enum": [
+        "requested",
+        "queued",
+        "waiting",
+        "pending",
+        "started",
+        "passed",
+        "failed",
+        "timed_out",
+        "cancelled",
+        "skipped",
+        "neutral",
+        "action_required",
+        "stale",
+        "startup_failure"
+      ],
+      "title": "WorkflowRunAction",
+      "type": "string"
     }
   },
   "$schema": "https://json-schema.org/draft/2020-12/schema",