@ellipsis-dev/sdk 0.32.0 → 0.34.0

package/schema/collection_frames.schema.json

@@ -126,6 +126,11 @@
           "description": "The open pull request that adds this agent's file. Non-null means the agent is not live yet: it starts running once the pull request merges and syncs.",
           "title": "Pending Pull Request Url"
         },
+        "raw_yaml": {
+          "description": "The agent's YAML: the file as written for agents defined in a repository, or the definition rendered as YAML for agents managed through the API. A failed sync keeps the last valid YAML.",
+          "title": "Raw Yaml",
+          "type": "string"
+        },
         "sha": {
           "description": "The definition's content identity: the version fingerprint frozen onto each session that runs it.",
           "title": "Sha",
@@ -163,6 +168,7 @@
         "managed_by",
         "name",
         "pending_pull_request_url",
+        "raw_yaml",
         "sha",
         "source_details",
         "updated_at"
@@ -390,13 +396,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"
+    },
     "ClaudeConfig": {
       "additionalProperties": false,
       "description": "Native Claude Code options for an explicitly selected harness.",
@@ -641,6 +675,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.",
@@ -1259,6 +1342,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": {
@@ -1312,7 +1493,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": [
@@ -1561,6 +1742,183 @@
       "title": "GithubSourceDetails",
       "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": [
@@ -1706,6 +2064,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.",
@@ -1826,6 +2244,99 @@
       "title": "MemorySize",
       "type": "object"
     },
+    "ModelLlmCostSplit": {
+      "description": "What one model's tokens cost, in millicents, split by who paid.",
+      "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"
+        },
+        "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": [
+        "claude_subscription",
+        "codex_subscription",
+        "model",
+        "platform",
+        "total"
+      ],
+      "title": "ModelLlmCostSplit",
+      "type": "object"
+    },
+    "ModelTokenCounts": {
+      "description": "Token counts for one model.",
+      "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": {
+          "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.",
@@ -1902,7 +2413,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": [],
@@ -1947,6 +2458,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": {
@@ -2172,29 +2730,76 @@
           "items": {
             "$ref": "#/$defs/SentryAction"
           },
-          "title": "On",
+          "title": "On",
+          "type": "array"
+        },
+        "projects": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Projects",
+          "type": "array"
+        }
+      },
+      "required": [
+        "on",
+        "projects"
+      ],
+      "title": "ReactSentry",
+      "type": "object"
+    },
+    "ReactSlackChannel": {
+      "additionalProperties": false,
+      "properties": {},
+      "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"
         },
-        "projects": {
-          "default": [],
+        "on": {
+          "default": [
+            "failed"
+          ],
           "items": {
-            "type": "string"
+            "$ref": "#/$defs/StatusAction"
           },
-          "title": "Projects",
+          "title": "On",
           "type": "array"
+        },
+        "repositories": {
+          "$ref": "#/$defs/RepositoryFilter"
         }
       },
       "required": [
+        "branch",
+        "for",
+        "names",
         "on",
-        "projects"
+        "repositories"
       ],
-      "title": "ReactSentry",
-      "type": "object"
-    },
-    "ReactSlackChannel": {
-      "additionalProperties": false,
-      "properties": {},
-      "title": "ReactSlackChannel",
+      "title": "ReactStatus",
       "type": "object"
     },
     "ReactTrigger": {
@@ -2212,6 +2817,17 @@
           ],
           "default": null
         },
+        "check_suite": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ReactCheckSuite"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "enabled": {
           "default": true,
           "title": "Enabled",
@@ -2294,15 +2910,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",
@@ -2311,11 +2950,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"
+    },
     "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": [
@@ -2767,9 +3455,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": [
@@ -2800,8 +3488,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.",
@@ -2819,10 +3507,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",
@@ -2843,6 +3534,15 @@
                 {
                   "$ref": "#/$defs/GithubCheckRunEvent"
                 },
+                {
+                  "$ref": "#/$defs/GithubCheckSuiteEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubWorkflowRunEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubStatusEvent"
+                },
                 {
                   "$ref": "#/$defs/GithubReleaseEvent"
                 },
@@ -2959,8 +3659,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": [
@@ -3324,50 +4024,6 @@
       "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.",
@@ -3955,62 +4611,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": {
@@ -4029,7 +4634,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": {
@@ -4099,7 +4704,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."
         }
       },
@@ -4300,6 +4905,84 @@
       "title": "SlackMessageEvent",
       "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"
+    },
     "TurnReason": {
       "description": "Why a turn failed or was cancelled. Null on every other outcome.",
       "enum": [
@@ -4324,9 +5007,10 @@
       "type": "string"
     },
     "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",
@@ -4549,6 +5233,27 @@
       ],
       "title": "VMExecutionResponse",
       "type": "object"
+    },
+    "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",