@ellipsis-dev/sdk 0.31.0 → 0.32.0

package/schema/frames.schema.json

@@ -59,7 +59,7 @@
     },
     "AgentIdentity": {
       "additionalProperties": false,
-      "description": "The Ellipsis product namespace for a config file: which schema this is\n(`version`), the human-facing identity (`name`/`description`), freeform\norganizational `metadata`, and whether the agent is `enabled`. The\npresence of a top-level `ellipsis:` mapping is what marks a YAML file as\nan Ellipsis agent (vs arbitrary YAML that merely lives under a\nconfig directory) \u2014 see `yaml_is_ellipsis_config`.\n\n`enabled` is agent behavior, not freeform metadata, so it stays inside\nthe config `sha` (only `metadata` is sha-excluded). Whether a session\naccepts messages is a per-run choice (POST /v1/sessions `interactive`),\nnot a config one.",
+      "description": "The Ellipsis product namespace for a config file: which schema this is\n(`version`), the human-facing identity (`name`/`description`), freeform\norganizational `metadata`, and whether the agent is `enabled`. The\npresence of a top-level `ellipsis:` mapping is what marks a YAML file as\nan Ellipsis agent (vs arbitrary YAML that merely lives under a\nconfig directory) \u2014 see `yaml_is_ellipsis_config`.\n\n`enabled` is agent behavior, not freeform metadata, so it stays inside\nthe config `sha` (only `metadata` is sha-excluded).",
       "properties": {
         "description": {
           "anyOf": [
@@ -131,6 +131,7 @@
     },
     "BudgetConfig": {
       "additionalProperties": false,
+      "description": "A saved agent's spend limits: the per-session cap plus its total spend\nover the trailing 1, 7, and 28 days.",
       "properties": {
         "day": {
           "anyOf": [
@@ -142,6 +143,7 @@
             }
           ],
           "default": null,
+          "description": "The most the agent may spend over the last day, in US dollars.",
           "title": "Day"
         },
         "month": {
@@ -154,6 +156,7 @@
             }
           ],
           "default": null,
+          "description": "The most the agent may spend over the last 28 days, in US dollars.",
           "title": "Month"
         },
         "session": {
@@ -167,6 +170,7 @@
             }
           ],
           "default": null,
+          "description": "The most one session may spend, in US dollars.",
           "title": "Session"
         },
         "week": {
@@ -179,6 +183,7 @@
             }
           ],
           "default": null,
+          "description": "The most the agent may spend over the last 7 days, in US dollars.",
           "title": "Week"
         }
       },
@@ -191,6 +196,14 @@
       "title": "BudgetConfig",
       "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).",
+      "enum": [
+        "failed"
+      ],
+      "title": "CheckRunAction",
+      "type": "string"
+    },
     "ClaudeAssistantEvent": {
       "additionalProperties": true,
       "properties": {
@@ -411,16 +424,9 @@
           "title": "Max Turns"
         },
         "model": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Model"
+          "description": "The model the session runs on: an alias or canonical id from the models table. Required.",
+          "title": "Model",
+          "type": "string"
         },
         "prompt": {
           "anyOf": [
@@ -1876,7 +1882,7 @@
     },
     "CodexConfig": {
       "additionalProperties": false,
-      "description": "Native options supported by the current Codex adapter.\n\nOptions and capabilities expand only when their runtime behavior is tested.\nUnknown options are rejected instead of silently ignored.",
+      "description": "Native options supported by the current Codex adapter.",
       "properties": {
         "effort": {
           "anyOf": [
@@ -1891,7 +1897,7 @@
           "description": "Reasoning effort for every turn. Omit to use the model default."
         },
         "model": {
-          "default": "gpt-6-sol",
+          "description": "The model the session runs on: a Responses-capable id from the models table. Required.",
           "title": "Model",
           "type": "string"
         },
@@ -3792,7 +3798,13 @@
     },
     "CronTrigger": {
       "additionalProperties": false,
+      "description": "A schedule: `schedule` is a five-field cron expression in UTC.\n\n`enabled: false` pauses the trigger and keeps its definition: the schedule\nstops firing while the agent stays live for on-demand starts and open\nsessions keep taking follow-ups (`ellipsis.enabled: false` pauses the\nwhole file instead). Re-enabling resumes at the next scheduled time; runs\nmissed while paused are not made up.",
       "properties": {
+        "enabled": {
+          "default": true,
+          "title": "Enabled",
+          "type": "boolean"
+        },
         "schedule": {
           "title": "Schedule",
           "type": "string"
@@ -3805,6 +3817,7 @@
         }
       },
       "required": [
+        "enabled",
         "schedule",
         "type"
       ],
@@ -3955,7 +3968,7 @@
     },
     "EllipsisGrant": {
       "additionalProperties": false,
-      "description": "One grant entry: a level, optionally narrowed to instances whose\nnatural key (a file's name, a memory's path, a secret's name, a config's\nname, a session's id) matches any of the `match` globs.",
+      "description": "One grant entry: a level, optionally narrowed to instances whose\nnatural key (a file's name, a secret's name, a config's name, a session's\nid) matches any of the `match` globs.",
       "properties": {
         "level": {
           "$ref": "#/$defs/Level"
@@ -4948,17 +4961,26 @@
     },
     "GithubAccountSelector": {
       "additionalProperties": false,
-      "description": "A selector of GitHub accounts \u2014 the `for:` audience gate on react\nsurfaces and code review pipelines, classified on the stable entity author\n(the pusher for `push`, the PR author for a review). `users` selects human\naccounts, `bots` selects bot accounts; each is a `GithubAccountFilter`\n(include minus exclude, with bare bool/list shorthand).",
+      "description": "A selector of GitHub accounts \u2014 the `for:` audience gate on react\nsurfaces, classified on the stable entity author (the pusher for `push`,\nthe PR author for a pull request). `users` selects human\naccounts, `bots` selects bot accounts; each is a `GithubAccountFilter`\n(include minus exclude, with bare bool/list shorthand).\n\n`teams` narrows further to members of any of the listed GitHub teams of\nthe installation's organization, by slug (`platform` for\n`@org/platform`). It applies on top of `users`: the author must pass the\nusers filter AND belong to a listed team. A bot is never a team member,\nso a selector with `teams` never admits one. Membership is resolved live\nat match time (see `TriggerEventContext.is_author_team_member`), and the\nconfig sync refuses a team that does not exist when the file is\naccepted.",
       "properties": {
         "bots": {
           "$ref": "#/$defs/GithubAccountFilter"
         },
+        "teams": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Teams",
+          "type": "array"
+        },
         "users": {
           "$ref": "#/$defs/GithubAccountFilter"
         }
       },
       "required": [
         "bots",
+        "teams",
         "users"
       ],
       "title": "GithubAccountSelector",
@@ -4979,6 +5001,18 @@
           "title": "Login",
           "type": "string"
         },
+        "name": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Name"
+        },
         "type": {
           "$ref": "#/$defs/GithubAccountType"
         }
@@ -4987,6 +5021,7 @@
         "avatar_url",
         "id",
         "login",
+        "name",
         "type"
       ],
       "title": "GithubAccountSnippet",
@@ -5002,6 +5037,96 @@
       "title": "GithubAccountType",
       "type": "string"
     },
+    "GithubCheckRunEvent": {
+      "properties": {
+        "action": {
+          "$ref": "#/$defs/CheckRunAction"
+        },
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "branch": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Branch"
+        },
+        "conclusion": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Conclusion"
+        },
+        "head_sha": {
+          "title": "Head Sha",
+          "type": "string"
+        },
+        "name": {
+          "title": "Name",
+          "type": "string"
+        },
+        "pull_request_number": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Pull Request Number"
+        },
+        "repository": {
+          "title": "Repository",
+          "type": "string"
+        },
+        "type": {
+          "const": "github.check_run",
+          "default": "github.check_run",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "branch",
+        "conclusion",
+        "head_sha",
+        "name",
+        "pull_request_number",
+        "repository",
+        "type",
+        "url"
+      ],
+      "title": "GithubCheckRunEvent",
+      "type": "object"
+    },
     "GithubIssueEvent": {
       "properties": {
         "action": {
@@ -5055,7 +5180,7 @@
     },
     "GithubPermissions": {
       "additionalProperties": false,
-      "description": "The agent's GitHub access: the scope of the installation token minted for\nits session's environment \u2014 the credential `git`, `gh`, and the GitHub MCP\nserver authenticate with.\n\nBy default the token carries the installation's full permissions on all of\nthe installation's repositories. `permissions` narrows what it may do:\nthe string `read_only` grants read access to contents, issues, metadata and\npull requests; a map requests explicit levels per GitHub App permission\nscope (e.g. `{contents: read, pull_requests: write}`) and may never exceed\nwhat the installation granted. `repositories` scopes the token to exactly\nthe listed repos, by name (they must belong to the installation).\n\nRestriction is enforced by GitHub, not by Ellipsis: the token itself is\nminted with the reduced scope, so nothing running in the environment can\nexceed it.",
+      "description": "The agent's GitHub access: the scope of the installation token minted for\nits session's environment \u2014 the credential `git` and `gh` authenticate\nwith.\n\nBy default the token carries the installation's full permissions on all of\nthe installation's repositories. `permissions` narrows what it may do:\nthe string `read_only` grants read access to 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.",
       "properties": {
         "permissions": {
           "anyOf": [
@@ -5216,6 +5341,70 @@
       "title": "GithubPushEvent",
       "type": "object"
     },
+    "GithubReleaseEvent": {
+      "properties": {
+        "action": {
+          "$ref": "#/$defs/ReleaseAction"
+        },
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "name": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Name"
+        },
+        "prerelease": {
+          "title": "Prerelease",
+          "type": "boolean"
+        },
+        "repository": {
+          "title": "Repository",
+          "type": "string"
+        },
+        "tag": {
+          "title": "Tag",
+          "type": "string"
+        },
+        "type": {
+          "const": "github.release",
+          "default": "github.release",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "name",
+        "prerelease",
+        "repository",
+        "tag",
+        "type",
+        "url"
+      ],
+      "title": "GithubReleaseEvent",
+      "type": "object"
+    },
     "HandlerService": {
       "description": "The service whose events a handler responds to.",
       "enum": [
@@ -5252,7 +5441,7 @@
     },
     "InputContract": {
       "additionalProperties": false,
-      "description": "The typed input contract: what goes INTO a session (the trigger is\nwhen it happens; this is what goes in).\n\n`json_schema` validates customer data sent as `input` to\n`POST /v1/agents/{id}/sessions` and stored as `session.input`.\nInvocations require input when a schema is declared. React agents\ncannot declare schemas: the platform defines their event payloads.\n\n`message` is the initial-message template: exact `{{path}}` substitution\nover the caller payload (or, on a react agent, over the surface's\npublished fields), no conditionals/loops/filters. Refs are validated at\ndeploy time against the governing field set (see AgentConfig's\n`_check_input`).",
+      "description": "The typed input contract: what goes INTO a session (the trigger is\nwhen it happens; this is what goes in).\n\n`json_schema` validates customer data sent as `input` to\n`POST /v1/agents/{id}/sessions` (the dashboard and the CLI start\nthrough the same door) and stored as `session.input`. An on-demand\nstart requires input when a schema is declared. A trigger fires\nwithout it: a cron fire has no payload and a react fire carries the\nplatform-shaped event, so an agent may declare a schema alongside\neither trigger and the schema governs only its on-demand starts.\n\n`message` is the initial-message template: exact `{{path}}` substitution\nover the payload the session has (the caller payload on an on-demand\nstart, the surface's published fields on a react fire, the empty\nobject on a cron fire), no conditionals/loops/filters. Refs are\nvalidated at deploy time against every governing field set (see\nAgentConfig's `_check_input`): the caller schema's paths, the react\nsurface's published fields, and both when the agent has a react trigger\nand a schema, so one template renders fully on either door (declare the\nsurface's field names in the schema). Omit `message` to let each door\nrender its default. An unresolved ref renders as the empty string (a\ncron fire, an optional field the payload omitted).",
       "properties": {
         "json_schema": {
           "anyOf": [
@@ -5668,7 +5857,10 @@
               "$ref": "#/$defs/LinearIssueAction"
             },
             {
-              "const": "commented",
+              "enum": [
+                "commented",
+                "delegated"
+              ],
               "type": "string"
             }
           ],
@@ -5759,7 +5951,7 @@
     },
     "McpServerRef": {
       "additionalProperties": false,
-      "description": "One built-in MCP server this agent opts into by name (`linear`/`slack`).\nA name reference over the connected built-in set \u2014 the platform manages the\nserver's transport and credentials. It only matters when the named\nintegration is set to `opt_in` inclusion; an integration in the default\n`all_sessions` mode is added regardless. For a server the platform does not\nprovide, define it instead (`McpStdioServer` /\n`McpRemoteServer`).",
+      "description": "One built-in MCP server this agent attaches by name (`linear`/`slack`).\nA name reference over the connected built-in set \u2014 the platform manages the\nserver's transport and credentials. A session gets a built-in server only\nwhen its config names it here or the session started from that server's\nown surface. For a server the platform does not provide, define it instead\n(`McpStdioServer` / `McpRemoteServer`).",
       "properties": {
         "name": {
           "title": "Name",
@@ -6453,270 +6645,68 @@
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
-    "OutboxCollectedPayload": {
-      "additionalProperties": true,
-      "description": "outbox_collected: the platform read a code_review session's\n/ellipsis/outbox/* when its turn ended. Carries both raw and parsed so\nthe feed alone tells the whole delivery story; the code_review_outbox\ntable is the queryable projection of this record.",
+    "OutputConfig": {
+      "additionalProperties": false,
+      "description": "JSON Schema for the harness's structured result, when certified.",
       "properties": {
-        "findings": {
-          "default": [],
-          "items": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "title": "Findings",
-          "type": "array"
-        },
-        "parse_errors": {
-          "default": [],
-          "items": {
-            "additionalProperties": true,
-            "type": "object"
-          },
-          "title": "Parse Errors",
-          "type": "array"
-        },
-        "parser_version": {
-          "title": "Parser Version",
-          "type": "string"
-        },
-        "raw": {
-          "additionalProperties": {
-            "type": "string"
-          },
-          "default": {},
-          "title": "Raw",
+        "json_schema": {
+          "additionalProperties": true,
+          "title": "Json Schema",
           "type": "object"
         }
       },
       "required": [
-        "parser_version"
+        "json_schema"
       ],
-      "title": "OutboxCollectedPayload",
+      "title": "OutputConfig",
       "type": "object"
     },
-    "OutboxCollectedRecord": {
+    "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": {
-        "cost": {
+        "ellipsis": {
           "anyOf": [
             {
-              "type": "integer"
+              "enum": [
+                true,
+                "all"
+              ]
             },
             {
-              "type": "null"
+              "$ref": "#/$defs/EllipsisPermissions"
             }
           ],
-          "default": null,
-          "title": "Cost"
+          "default": true,
+          "title": "Ellipsis"
         },
-        "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/OutboxCollectedPayload"
-        },
-        "record_format": {
-          "const": "ellipsis_lifecycle@1",
-          "default": "ellipsis_lifecycle@1",
-          "title": "Record Format",
-          "type": "string"
-        },
-        "record_type": {
-          "const": "outbox_collected",
-          "default": "outbox_collected",
-          "title": "Record Type",
-          "type": "string"
-        },
-        "session_id": {
-          "description": "Session containing this record.",
-          "title": "Session Id",
-          "type": "string"
-        },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
-        "source": {
-          "const": "lifecycle",
-          "default": "lifecycle",
-          "title": "Source",
-          "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": "OutboxCollectedRecord",
-      "type": "object",
-      "x-ellipsis-preserve-payload": true
-    },
-    "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 `agent` CLI running inside the session authenticates with).\n`true` / the string `all` (the default) grant the full session token\nceiling \u2014 everything a session token can ever do. A map narrows it per\nresource (see `EllipsisPermissions`); the minted token carries\nthe intersection, so a config can only ever reduce access. `false` fails\nvalidation \u2014 an agent with no API token cannot report its own progress.\n\n`github` scopes the session's GitHub installation token (`GH_TOKEN`) \u2014\nsee `GithubPermissions`. GitHub enforces it at mint time.",
-      "properties": {
-        "ellipsis": {
-          "anyOf": [
-            {
-              "enum": [
-                true,
-                "all"
-              ]
-            },
-            {
-              "$ref": "#/$defs/EllipsisPermissions"
-            }
-          ],
-          "default": true,
-          "title": "Ellipsis"
-        },
-        "github": {
-          "$ref": "#/$defs/GithubPermissions",
-          "default": {
-            "permissions": null,
-            "repositories": null
-          }
-        }
-      },
-      "required": [
-        "ellipsis",
-        "github"
-      ],
-      "title": "PermissionsConfig",
-      "type": "object"
-    },
-    "PlatformSessionRecord": {
-      "discriminator": {
-        "mapping": {
-          "environment_output": "#/$defs/EnvironmentOutputRecord",
-          "environment_phase": "#/$defs/EnvironmentPhaseRecord",
-          "environment_ready": "#/$defs/EnvironmentReadyRecord",
-          "message_delivered": "#/$defs/MessageDeliveredRecord",
-          "message_received": "#/$defs/MessageReceivedRecord",
-          "message_requeued": "#/$defs/MessageRequeuedRecord",
-          "outbox_collected": "#/$defs/OutboxCollectedRecord",
-          "session_closed": "#/$defs/SessionClosedRecord",
-          "turn_ended": "#/$defs/TurnEndedRecord",
-          "turn_started": "#/$defs/TurnStartedRecord"
+        "github": {
+          "$ref": "#/$defs/GithubPermissions",
+          "default": {
+            "permissions": null,
+            "repositories": null
+          }
+        }
+      },
+      "required": [
+        "ellipsis",
+        "github"
+      ],
+      "title": "PermissionsConfig",
+      "type": "object"
+    },
+    "PlatformSessionRecord": {
+      "discriminator": {
+        "mapping": {
+          "environment_output": "#/$defs/EnvironmentOutputRecord",
+          "environment_phase": "#/$defs/EnvironmentPhaseRecord",
+          "environment_ready": "#/$defs/EnvironmentReadyRecord",
+          "message_delivered": "#/$defs/MessageDeliveredRecord",
+          "message_received": "#/$defs/MessageReceivedRecord",
+          "message_requeued": "#/$defs/MessageRequeuedRecord",
+          "session_closed": "#/$defs/SessionClosedRecord",
+          "turn_ended": "#/$defs/TurnEndedRecord",
+          "turn_started": "#/$defs/TurnStartedRecord"
         },
         "propertyName": "record_type"
       },
@@ -6747,9 +6737,6 @@
         },
         {
           "$ref": "#/$defs/EnvironmentReadyRecord"
-        },
-        {
-          "$ref": "#/$defs/OutboxCollectedRecord"
         }
       ]
     },
@@ -6757,7 +6744,6 @@
       "description": "Why direct prompting is refused. Absent when prompting is allowed.",
       "enum": [
         "mention_surface",
-        "ephemeral_trigger",
         "non_interactive",
         "harness_single_turn",
         "budget_exhausted",
@@ -6778,6 +6764,53 @@
       "title": "PullRequestAction",
       "type": "string"
     },
+    "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.",
+      "properties": {
+        "branch": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Branch",
+          "type": "array"
+        },
+        "for": {
+          "$ref": "#/$defs/GithubAccountSelector"
+        },
+        "names": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Names",
+          "type": "array"
+        },
+        "on": {
+          "default": [
+            "failed"
+          ],
+          "items": {
+            "$ref": "#/$defs/CheckRunAction"
+          },
+          "title": "On",
+          "type": "array"
+        },
+        "repositories": {
+          "$ref": "#/$defs/RepositoryFilter"
+        }
+      },
+      "required": [
+        "branch",
+        "for",
+        "names",
+        "on",
+        "repositories"
+      ],
+      "title": "ReactCheckRun",
+      "type": "object"
+    },
     "ReactIssue": {
       "additionalProperties": false,
       "properties": {
@@ -6945,6 +6978,57 @@
       "title": "ReactPush",
       "type": "object"
     },
+    "ReactRelease": {
+      "additionalProperties": false,
+      "description": "A GitHub release being published \u2014 a release or prerelease published\ndirectly, or a draft published later. `tag` narrows to the release tags\nthat match (exact, or a prefix ending in `*`, so `v*`); `prerelease`\nselects prereleases or full releases, like `draft` on pull requests. The\n`for:` audience is the release's author, which for a release cut by CI is\na bot and needs `bots` to opt in.",
+      "properties": {
+        "for": {
+          "$ref": "#/$defs/GithubAccountSelector"
+        },
+        "on": {
+          "default": [
+            "published"
+          ],
+          "items": {
+            "$ref": "#/$defs/ReleaseAction"
+          },
+          "title": "On",
+          "type": "array"
+        },
+        "prerelease": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Prerelease"
+        },
+        "repositories": {
+          "$ref": "#/$defs/RepositoryFilter"
+        },
+        "tag": {
+          "default": [],
+          "items": {
+            "type": "string"
+          },
+          "title": "Tag",
+          "type": "array"
+        }
+      },
+      "required": [
+        "for",
+        "on",
+        "prerelease",
+        "repositories",
+        "tag"
+      ],
+      "title": "ReactRelease",
+      "type": "object"
+    },
     "ReactSentry": {
       "additionalProperties": false,
       "properties": {
@@ -6979,7 +7063,24 @@
     },
     "ReactTrigger": {
       "additionalProperties": false,
+      "description": "An event trigger: exactly one surface block names the events to match.\n\n`enabled: false` pauses the trigger and keeps its definition: events stop\nmatching while the agent stays live for on-demand starts and open\nsessions keep taking follow-ups (`ellipsis.enabled: false` pauses the\nwhole file instead).",
       "properties": {
+        "check_run": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ReactCheckRun"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "enabled": {
+          "default": true,
+          "title": "Enabled",
+          "type": "boolean"
+        },
         "issue": {
           "anyOf": [
             {
@@ -7024,6 +7125,17 @@
           ],
           "default": null
         },
+        "release": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ReactRelease"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "sentry": {
           "anyOf": [
             {
@@ -7054,10 +7166,13 @@
         }
       },
       "required": [
+        "check_run",
+        "enabled",
         "issue",
         "linear_issue",
         "pull_request",
         "push",
+        "release",
         "sentry",
         "slack_channel",
         "type"
@@ -7090,6 +7205,14 @@
       "title": "RecordsAppendFrame",
       "type": "object"
     },
+    "ReleaseAction": {
+      "description": "What happened to a GitHub release. `published` is the one moment a\nrelease becomes visible: a release or prerelease published directly, or a\ndraft published later. Edits, deletions, and unpublishes never fire.",
+      "enum": [
+        "published"
+      ],
+      "title": "ReleaseAction",
+      "type": "string"
+    },
     "RepositoryFilter": {
       "anyOf": [
         {
@@ -7174,14 +7297,13 @@
         "account",
         "alerts",
         "sessions",
-        "memories",
-        "reviews",
         "configs",
         "defaults",
         "environments",
         "secrets",
         "templates",
         "integrations",
+        "reviews",
         "tokens",
         "webhooks",
         "user"
@@ -7819,9 +7941,11 @@
             {
               "discriminator": {
                 "mapping": {
+                  "github.check_run": "#/$defs/GithubCheckRunEvent",
                   "github.issue": "#/$defs/GithubIssueEvent",
                   "github.pull_request": "#/$defs/GithubPullRequestEvent",
                   "github.push": "#/$defs/GithubPushEvent",
+                  "github.release": "#/$defs/GithubReleaseEvent",
                   "linear.issue": "#/$defs/LinearIssueEvent",
                   "sentry.alert": "#/$defs/SentryAlertEvent",
                   "slack.channel_created": "#/$defs/SlackChannelCreatedEvent",
@@ -7839,6 +7963,12 @@
                 {
                   "$ref": "#/$defs/GithubPushEvent"
                 },
+                {
+                  "$ref": "#/$defs/GithubCheckRunEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubReleaseEvent"
+                },
                 {
                   "$ref": "#/$defs/LinearIssueEvent"
                 },
@@ -7902,14 +8032,14 @@
         "output": {
           "anyOf": [
             {
-              "$ref": "#/$defs/OutputConfig"
+              "$ref": "#/$defs/SessionOutput"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "The structured-output exit contract for this session."
+          "description": "The session's structured output: the `json_schema` the agent must satisfy and, once a turn has submitted it, the `result`."
         },
         "parent": {
           "anyOf": [
@@ -8020,7 +8150,7 @@
             }
           ],
           "default": null,
-          "description": "Identifier of the saved agent this session's snapshot was taken from. Null for a routing-file agent, a code-review stage agent, or the built-in mention agent, which have no saved agent behind them. Points at the agent as it exists now, which may have changed since.",
+          "description": "Identifier of the saved agent this session's snapshot was taken from. Null for a routing-file agent or the built-in mention agent, which have no saved agent behind them. Points at the agent as it exists now, which may have changed since.",
           "title": "Id"
         }
       },
@@ -8349,6 +8479,12 @@
           "default": null,
           "description": "Codex input and native options. Set exactly one of claude_code or codex."
         },
+        "conversation": {
+          "$ref": "#/$defs/SessionConversationConfig",
+          "default": {
+            "interactive": true
+          }
+        },
         "environment": {
           "anyOf": [
             {
@@ -8377,6 +8513,15 @@
           },
           "title": "Environment"
         },
+        "metadata": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "default": {},
+          "description": "Arbitrary string key/value metadata stored on every session.",
+          "title": "Metadata",
+          "type": "object"
+        },
         "output": {
           "anyOf": [
             {
@@ -8411,7 +8556,9 @@
         "budget",
         "claude_code",
         "codex",
+        "conversation",
         "environment",
+        "metadata",
         "output",
         "permissions",
         "skills"
@@ -8450,6 +8597,23 @@
       "title": "SessionConversation",
       "type": "object"
     },
+    "SessionConversationConfig": {
+      "additionalProperties": false,
+      "description": "Conversation settings for a session, set on a saved agent or sent when starting a session or running an agent.",
+      "properties": {
+        "interactive": {
+          "default": true,
+          "description": "Whether the session stays open after its first turn. Defaults to true; false runs once and requires a prompt. Requires the model's interactive capability when true. Direct message acceptance is reported separately in conversation.prompting.",
+          "title": "Interactive",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "interactive"
+      ],
+      "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": {
@@ -9062,6 +9226,37 @@
       "title": "SessionMessageStatus",
       "type": "string"
     },
+    "SessionOutput": {
+      "description": "Structured output on the wire: the contract and, when a turn has\nsubmitted one, the payload. `result` is None while the session runs and\nwhen no turn submitted anything; it is the agent's own JSON, in the\nshape of `json_schema`.",
+      "properties": {
+        "json_schema": {
+          "additionalProperties": true,
+          "description": "JSON Schema the agent's result must satisfy.",
+          "title": "Json Schema",
+          "type": "object"
+        },
+        "result": {
+          "anyOf": [
+            {
+              "additionalProperties": true,
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The payload the agent submitted, or null until a turn submits one.",
+          "title": "Result"
+        }
+      },
+      "required": [
+        "json_schema",
+        "result"
+      ],
+      "title": "SessionOutput",
+      "type": "object"
+    },
     "SessionParent": {
       "description": "The predecessor session this session continues.",
       "properties": {
@@ -9160,9 +9355,10 @@
       ]
     },
     "SessionSource": {
-      "description": "Where a session came from: the credential that started it (web app,\nAPI key, CLI) or the trigger that fired (react, mention, cron). Never\ntaken from a request body.",
+      "description": "Where a session came from: the credential that started it (web app,\nAPI key, CLI) or the trigger that fired (react, mention, cron, code\nreview). Never taken from a request body.",
       "enum": [
         "react",
+        "code_review",
         "web",
         "api",
         "cli",
@@ -9406,7 +9602,7 @@
     },
     "SettingsRef": {
       "additionalProperties": false,
-      "description": "A config-declared Claude Code settings.json, resolved at run start and\npassed to `claude --settings <path>`. That is the CLI settings tier \u2014 BELOW\nEllipsis's managed-settings.json floor \u2014 so it customizes behavior (model\npermissions, includeCoAuthoredBy, statusLine, ...) but can never weaken a\nsecurity setting. Lets a team point the cloud agent at the same settings file\nthey already use with Claude Code locally instead of re-encoding it as YAML.",
+      "description": "A Claude Code settings.json read from a repository and applied to the\nsession. It adds permission rules and other Claude Code settings; rules the\nplatform sets stay in force. Supported models list `settings` in\n`/v1/account/models`.",
       "properties": {
         "path": {
           "title": "Path",