@ellipsis-dev/sdk 0.32.0 → 0.34.0

package/schema/frames.schema.json

@@ -197,13 +197,41 @@
       "type": "object"
     },
     "CheckRunAction": {
-      "description": "What a completed check run did. `failed` covers the conclusions that\nmean the check did not pass on its own merits (`failure`, `timed_out`); a\ncancelled, skipped, neutral or stale check is not a failure and never\nfires (see FAILED_CHECK_RUN_CONCLUSIONS).",
+      "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": [
-        "failed"
+        "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": {
@@ -3796,6 +3824,55 @@
       "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.",
@@ -5127,6 +5204,104 @@
       "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": {
@@ -5180,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` 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 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": [
@@ -5405,58 +5580,23 @@
       "title": "GithubReleaseEvent",
       "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.",
+    "GithubStatusEvent": {
       "properties": {
-        "ts": {
-          "description": "Server time when the heartbeat was sent.",
-          "format": "date-time",
-          "title": "Ts",
-          "type": "string"
+        "action": {
+          "$ref": "#/$defs/StatusAction"
         },
-        "type": {
-          "const": "heartbeat",
-          "default": "heartbeat",
-          "title": "Type",
-          "type": "string"
-        }
-      },
-      "required": [
-        "ts",
-        "type"
-      ],
-      "title": "HeartbeatFrame",
-      "type": "object"
-    },
-    "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` (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": {
+        "actor": {
           "anyOf": [
             {
-              "additionalProperties": true,
-              "type": "object"
+              "$ref": "#/$defs/SessionEventActor"
             },
             {
               "type": "null"
             }
           ],
-          "default": null,
-          "title": "Json Schema"
+          "default": null
         },
-        "message": {
+        "branch": {
           "anyOf": [
             {
               "type": "string"
@@ -5466,32 +5606,71 @@
             }
           ],
           "default": null,
-          "title": "Message"
+          "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": [
-        "json_schema",
-        "message"
+        "action",
+        "actor",
+        "branch",
+        "context",
+        "head_sha",
+        "pull_request_number",
+        "repository",
+        "state",
+        "type",
+        "url"
       ],
-      "title": "InputContract",
+      "title": "GithubStatusEvent",
       "type": "object"
     },
-    "IssueAction": {
-      "enum": [
-        "opened",
-        "closed",
-        "commented"
-      ],
-      "title": "IssueAction",
-      "type": "string"
-    },
-    "LegacyAssistantPayload": {
-      "additionalProperties": true,
+    "GithubWorkflowRunEvent": {
       "properties": {
-        "cache_creation": {
+        "action": {
+          "$ref": "#/$defs/WorkflowRunAction"
+        },
+        "actor": {
           "anyOf": [
             {
-              "$ref": "#/$defs/SdkCacheCreation"
+              "$ref": "#/$defs/SessionEventActor"
             },
             {
               "type": "null"
@@ -5499,16 +5678,189 @@
           ],
           "default": null
         },
-        "content": {
-          "default": [],
-          "items": {
-            "discriminator": {
-              "mapping": {
-                "server_tool_result": "#/$defs/SdkServerToolResultBlock",
-                "server_tool_use": "#/$defs/SdkServerToolUseBlock",
-                "text": "#/$defs/SdkTextBlock",
-                "thinking": "#/$defs/SdkThinkingBlock",
-                "tool_result": "#/$defs/SdkToolResultBlock",
+        "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"
+        },
+        "type": {
+          "const": "heartbeat",
+          "default": "heartbeat",
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "ts",
+        "type"
+      ],
+      "title": "HeartbeatFrame",
+      "type": "object"
+    },
+    "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` (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": [
+            {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Json Schema"
+        },
+        "message": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Message"
+        }
+      },
+      "required": [
+        "json_schema",
+        "message"
+      ],
+      "title": "InputContract",
+      "type": "object"
+    },
+    "IssueAction": {
+      "enum": [
+        "opened",
+        "closed",
+        "commented"
+      ],
+      "title": "IssueAction",
+      "type": "string"
+    },
+    "LegacyAssistantPayload": {
+      "additionalProperties": true,
+      "properties": {
+        "cache_creation": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SdkCacheCreation"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "content": {
+          "default": [],
+          "items": {
+            "discriminator": {
+              "mapping": {
+                "server_tool_result": "#/$defs/SdkServerToolResultBlock",
+                "server_tool_use": "#/$defs/SdkServerToolUseBlock",
+                "text": "#/$defs/SdkTextBlock",
+                "thinking": "#/$defs/SdkThinkingBlock",
+                "tool_result": "#/$defs/SdkToolResultBlock",
                 "tool_use": "#/$defs/SdkToolUseBlock"
               },
               "propertyName": "type"
@@ -5920,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.",
@@ -6455,7 +6867,7 @@
     },
     "MessageRequeuedPayload": {
       "additionalProperties": true,
-      "description": "message_requeued: a turn was interrupted before answering, so the\nmessage goes back to the inbox with a new pending turn.",
+      "description": "message_requeued: a turn was interrupted before answering, so the\nmessage goes back to the inbox with a new queued turn.",
       "properties": {
         "message_id": {
           "title": "Message Id",
@@ -6645,42 +7057,135 @@
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
-    "OutputConfig": {
-      "additionalProperties": false,
-      "description": "JSON Schema for the harness's structured result, when certified.",
+    "ModelLlmCostSplit": {
+      "description": "What one model's tokens cost, in millicents, split by who paid.",
       "properties": {
-        "json_schema": {
-          "additionalProperties": true,
-          "title": "Json Schema",
-          "type": "object"
+        "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"
+        },
+        "model": {
+          "description": "The model that used these tokens.",
+          "title": "Model",
+          "type": "string"
+        },
+        "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": [
-        "json_schema"
+        "claude_subscription",
+        "codex_subscription",
+        "model",
+        "platform",
+        "total"
       ],
-      "title": "OutputConfig",
+      "title": "ModelLlmCostSplit",
       "type": "object"
     },
-    "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 `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.",
+    "ModelTokenCounts": {
+      "description": "Token counts for one model.",
       "properties": {
-        "ellipsis": {
-          "anyOf": [
-            {
-              "enum": [
-                true,
-                "all"
-              ]
-            },
-            {
-              "$ref": "#/$defs/EllipsisPermissions"
-            }
-          ],
-          "default": true,
-          "title": "Ellipsis"
-        },
-        "github": {
+        "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": {
+          "description": "The model that used these tokens.",
+          "title": "Model",
+          "type": "string"
+        },
+        "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",
+        "model",
+        "output",
+        "total"
+      ],
+      "title": "ModelTokenCounts",
+      "type": "object"
+    },
+    "OutputConfig": {
+      "additionalProperties": false,
+      "description": "JSON Schema for the harness's structured result, when certified.",
+      "properties": {
+        "json_schema": {
+          "additionalProperties": true,
+          "title": "Json Schema",
+          "type": "object"
+        }
+      },
+      "required": [
+        "json_schema"
+      ],
+      "title": "OutputConfig",
+      "type": "object"
+    },
+    "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 `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": [
+            {
+              "enum": [
+                true,
+                "all"
+              ]
+            },
+            {
+              "$ref": "#/$defs/EllipsisPermissions"
+            }
+          ],
+          "default": true,
+          "title": "Ellipsis"
+        },
+        "github": {
           "$ref": "#/$defs/GithubPermissions",
           "default": {
             "permissions": null,
@@ -6706,6 +7211,7 @@
           "message_requeued": "#/$defs/MessageRequeuedRecord",
           "session_closed": "#/$defs/SessionClosedRecord",
           "turn_ended": "#/$defs/TurnEndedRecord",
+          "turn_queued": "#/$defs/TurnQueuedRecord",
           "turn_started": "#/$defs/TurnStartedRecord"
         },
         "propertyName": "record_type"
@@ -6723,6 +7229,9 @@
         {
           "$ref": "#/$defs/MessageRequeuedRecord"
         },
+        {
+          "$ref": "#/$defs/TurnQueuedRecord"
+        },
         {
           "$ref": "#/$defs/TurnStartedRecord"
         },
@@ -6766,7 +7275,7 @@
     },
     "ReactCheckRun": {
       "additionalProperties": false,
-      "description": "A CI/CD check completing on a commit \u2014 a `check_run` from GitHub\nActions or any other app that reports checks. `names` narrows to the check\nruns whose name matches (exact, or a prefix ending in `*`); `branch` is the\ncheck suite's head branch. The `for:` audience is the commit's author (the\npull request author when the check is attached to one), never the CI app\nthat completed the check \u2014 a check run's sender is always a bot.\n\nDelivery needs the Ellipsis GitHub App's `checks` permission on the\ninstallation; without it GitHub sends no check events and the webhook\nhandler refuses the ones it does see.",
+      "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": [],
@@ -6811,6 +7320,53 @@
       "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": {
@@ -7061,6 +7617,53 @@
       "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).",
@@ -7076,6 +7679,17 @@
           ],
           "default": null
         },
+        "check_suite": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ReactCheckSuite"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "enabled": {
           "default": true,
           "title": "Enabled",
@@ -7158,15 +7772,38 @@
           ],
           "default": null
         },
+        "status": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ReactStatus"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "type": {
           "const": "react",
           "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",
@@ -7175,11 +7812,60 @@
         "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": {
@@ -7890,9 +8576,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": [
@@ -7923,8 +8609,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.",
@@ -7942,10 +8628,13 @@
               "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",
@@ -7966,6 +8655,15 @@
                 {
                   "$ref": "#/$defs/GithubCheckRunEvent"
                 },
+                {
+                  "$ref": "#/$defs/GithubCheckSuiteEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubWorkflowRunEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubStatusEvent"
+                },
                 {
                   "$ref": "#/$defs/GithubReleaseEvent"
                 },
@@ -8082,8 +8780,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": [
@@ -8614,53 +9312,9 @@
       "title": "SessionConversationConfig",
       "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\".",
-      "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"
-        }
-      },
-      "required": [
-        "cpu",
-        "fee",
-        "llm",
-        "memory",
-        "total"
-      ],
-      "title": "SessionCost",
-      "type": "object"
-    },
-    "SessionEnvironment": {
-      "additionalProperties": false,
-      "description": "The environment configuration frozen at session creation, enriched with\nthe saved environment's identity and how it was chosen.",
+    "SessionEnvironment": {
+      "additionalProperties": false,
+      "description": "The environment configuration frozen at session creation, enriched with\nthe saved environment's identity and how it was chosen.",
       "properties": {
         "compute": {
           "$ref": "#/$defs/ComputeConfig",
@@ -9436,62 +10090,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`.",
+      "description": "One message and the agent's answer to it. A turn is `queued` from the\nmoment its message is received, `preparing` while its environment is set\nup, `running` while the agent works, then `completed`, `failed`,\n`stopped`, or `cancelled`.",
       "properties": {
         "cost": {
-          "$ref": "#/$defs/SessionCost",
+          "$ref": "#/$defs/Cost",
           "description": "What the turn cost so far, in millicents, broken down by leg."
         },
         "created_at": {
@@ -9510,7 +10113,7 @@
             }
           ],
           "default": null,
-          "description": "A human-readable explanation of a failed, stopped, or cancelled turn.",
+          "description": "A human-readable explanation of a failed, stopped, or cancelled turn, or of why a queued turn waits.",
           "title": "Detail"
         },
         "ended_at": {
@@ -9580,7 +10183,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."
         }
       },
@@ -9805,7 +10408,7 @@
           "type": "array"
         },
         "protocol": {
-          "default": 6,
+          "default": 7,
           "description": "Echoes the protocol version the server is serving.",
           "title": "Protocol",
           "type": "integer"
@@ -9831,6 +10434,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.",
@@ -10090,6 +10771,191 @@
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
+    "TurnQueuedPayload": {
+      "additionalProperties": true,
+      "description": "turn_queued: the turn waits because the account already has\n`sessions_alive` sessions alive, its limit.",
+      "properties": {
+        "limit": {
+          "title": "Limit",
+          "type": "integer"
+        },
+        "sessions_alive": {
+          "title": "Sessions Alive",
+          "type": "integer"
+        },
+        "turn_id": {
+          "title": "Turn Id",
+          "type": "string"
+        }
+      },
+      "required": [
+        "turn_id",
+        "sessions_alive",
+        "limit"
+      ],
+      "title": "TurnQueuedPayload",
+      "type": "object"
+    },
+    "TurnQueuedRecord": {
+      "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",
+          "type": "integer"
+        },
+        "id": {
+          "description": "Unique identifier of the record.",
+          "title": "Id",
+          "type": "string"
+        },
+        "kind": {
+          "const": "platform",
+          "default": "platform",
+          "title": "Kind",
+          "type": "string"
+        },
+        "model": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Model"
+        },
+        "payload": {
+          "$ref": "#/$defs/TurnQueuedPayload"
+        },
+        "record_format": {
+          "const": "ellipsis_lifecycle@1",
+          "default": "ellipsis_lifecycle@1",
+          "title": "Record Format",
+          "type": "string"
+        },
+        "record_type": {
+          "const": "turn_queued",
+          "default": "turn_queued",
+          "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",
+          "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"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
+        }
+      },
+      "required": [
+        "cost",
+        "created_at",
+        "duration",
+        "feed_seq",
+        "id",
+        "kind",
+        "model",
+        "payload",
+        "record_format",
+        "record_type",
+        "session_id",
+        "session_message_id",
+        "source",
+        "tokens_info",
+        "tools",
+        "turn_id"
+      ],
+      "title": "TurnQueuedRecord",
+      "type": "object",
+      "x-ellipsis-preserve-payload": true
+    },
     "TurnReason": {
       "description": "Why a turn failed or was cancelled. Null on every other outcome.",
       "enum": [
@@ -10294,9 +11160,10 @@
       "x-ellipsis-preserve-payload": true
     },
     "TurnStatus": {
-      "description": "Where one turn is: queued for an agent, being answered, or over.\n\n`pending` covers everything before the agent starts on the message: queued\nbehind another turn, waiting to start, or preparing the environment.\n`stopped` and `cancelled` are their own outcomes; `reason` explains a\n`failed` or `cancelled` turn.",
+      "description": "Where one turn is: waiting, preparing, being answered, or over.\n\n`queued` turns wait to start, behind another turn or for a free session\nslot on the account. `preparing` turns wait while the environment is set\nup. `stopped` and `cancelled` are their own outcomes; `reason` explains a\n`failed` or `cancelled` turn.",
       "enum": [
-        "pending",
+        "queued",
+        "preparing",
         "running",
         "completed",
         "failed",
@@ -10465,10 +11332,31 @@
       "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",
-  "description": "One server-to-client frame of the Ellipsis session stream protocol v6 (WS /v1/sessions/{id}/stream?protocol=6). Clients MUST ignore frames with unknown `type` values \u2014 additive frames are not a protocol break.",
+  "description": "One server-to-client frame of the Ellipsis session stream protocol v7 (WS /v1/sessions/{id}/stream?protocol=7). Clients MUST ignore frames with unknown `type` values \u2014 additive frames are not a protocol break.",
   "oneOf": [
     {
       "$ref": "#/$defs/SnapshotFrame"