@ellipsis-dev/sdk 0.28.0 → 0.30.0

package/schema/frames.schema.json

@@ -1,31 +1,11 @@
 {
   "$defs": {
-    "AttributionType": {
-      "enum": [
-        "github_user",
-        "linear_user",
-        "slack_user",
-        "api_key"
-      ],
-      "title": "AttributionType",
-      "type": "string"
-    },
-    "AutomationConfig": {
+    "AgentConfig": {
       "additionalProperties": false,
-      "description": "A saved automation, as written in its YAML file: identity\n(`ellipsis`), when it runs (`trigger`), what goes in (`input`), and the\n`session:` block every session it starts is frozen from. Field order is\nthe canonical key order for files and `to_yaml` exports.",
+      "description": "A saved agent, as written in its YAML file: identity\n(`ellipsis`), when it runs (`trigger`), what goes in (`input`), and the\n`session:` block every session it starts is frozen from. Field order is\nthe canonical key order for files and `to_yaml` exports.",
       "properties": {
         "ellipsis": {
-          "$ref": "#/$defs/AutomationIdentity",
-          "default": {
-            "description": null,
-            "enabled": true,
-            "metadata": {
-              "annotations": {},
-              "labels": []
-            },
-            "name": null,
-            "version": "v1"
-          }
+          "$ref": "#/$defs/AgentIdentity"
         },
         "input": {
           "anyOf": [
@@ -69,14 +49,17 @@
         }
       },
       "required": [
-        "session"
+        "ellipsis",
+        "input",
+        "session",
+        "trigger"
       ],
-      "title": "AutomationConfig",
+      "title": "AgentConfig",
       "type": "object"
     },
-    "AutomationIdentity": {
+    "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 automation (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). Whether a session\naccepts messages is a per-run choice (POST /v1/sessions `interactive`),\nnot a config one.",
       "properties": {
         "description": {
           "anyOf": [
@@ -95,6 +78,11 @@
           "title": "Enabled",
           "type": "boolean"
         },
+        "kind": {
+          "const": "agent",
+          "title": "Kind",
+          "type": "string"
+        },
         "metadata": {
           "$ref": "#/$defs/ConfigMetadata",
           "default": {
@@ -120,9 +108,27 @@
           "type": "string"
         }
       },
-      "title": "AutomationIdentity",
+      "required": [
+        "description",
+        "enabled",
+        "kind",
+        "metadata",
+        "name",
+        "version"
+      ],
+      "title": "AgentIdentity",
       "type": "object"
     },
+    "AttributionType": {
+      "enum": [
+        "github_user",
+        "linear_user",
+        "slack_user",
+        "api_key"
+      ],
+      "title": "AttributionType",
+      "type": "string"
+    },
     "BudgetConfig": {
       "additionalProperties": false,
       "properties": {
@@ -153,6 +159,7 @@
         "session": {
           "anyOf": [
             {
+              "exclusiveMinimum": 0,
               "type": "number"
             },
             {
@@ -175,20 +182,15 @@
           "title": "Week"
         }
       },
+      "required": [
+        "day",
+        "month",
+        "session",
+        "week"
+      ],
       "title": "BudgetConfig",
       "type": "object"
     },
-    "BudgetSource": {
-      "description": "Which layer actually determined the enforced budget.\n\nNot derivable from the run row alone (the run does not store the config\ncents or the account default), so we persist it for the UI / audit.",
-      "enum": [
-        "system",
-        "account",
-        "config",
-        "run"
-      ],
-      "title": "BudgetSource",
-      "type": "string"
-    },
     "ClaudeAssistantEvent": {
       "additionalProperties": true,
       "properties": {
@@ -420,6 +422,19 @@
           "default": null,
           "title": "Model"
         },
+        "prompt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The initial user message, passed verbatim. Omit to start an interactive session idle.",
+          "title": "Prompt"
+        },
         "settings": {
           "anyOf": [
             {
@@ -430,15 +445,15 @@
             }
           ],
           "default": null
-        },
-        "type": {
-          "const": "claude_code",
-          "title": "Type",
-          "type": "string"
         }
       },
       "required": [
-        "type"
+        "effort",
+        "fallback_model",
+        "max_turns",
+        "model",
+        "prompt",
+        "settings"
       ],
       "title": "ClaudeConfig",
       "type": "object"
@@ -491,19 +506,6 @@
     "ClaudeNativeSessionRecord": {
       "description": "Complete native Claude Code message, before SDK projection.",
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -686,10 +688,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -707,7 +721,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "ClaudeNativeSessionRecord",
       "type": "object",
@@ -1031,19 +1046,6 @@
     "ClaudeSessionRecord": {
       "description": "Historical Claude SDK projection, retained for existing session history.",
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -1222,10 +1224,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -1243,7 +1257,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "ClaudeSessionRecord",
       "type": "object",
@@ -1602,19 +1617,6 @@
     },
     "CodexAppServerSessionRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -1766,10 +1768,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -1787,7 +1801,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "CodexAppServerSessionRecord",
       "type": "object",
@@ -1982,14 +1997,24 @@
           "title": "Model",
           "type": "string"
         },
-        "type": {
-          "const": "codex",
-          "title": "Type",
-          "type": "string"
+        "prompt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The initial user message, passed verbatim. Omit to start an interactive session idle.",
+          "title": "Prompt"
         }
       },
       "required": [
-        "type"
+        "effort",
+        "model",
+        "prompt"
       ],
       "title": "CodexConfig",
       "type": "object"
@@ -2917,19 +2942,6 @@
     },
     "CodexSessionRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -3120,10 +3132,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -3141,7 +3165,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "CodexSessionRecord",
       "type": "object",
@@ -3819,7 +3844,7 @@
     },
     "ComputeConfig": {
       "additionalProperties": false,
-      "description": "Sandbox compute sizing. Every field is optional; None inherits the\nplatform default (2 vCPU / 4096 MiB / 3600s \u2014 see DEFAULT_SANDBOX_* in\nmodels/ellipsis/sandboxes/sandbox.py). A resolved value outside the platform\nbounds fails validation loudly (a sync error on the config) rather than\nbeing clamped silently.\n\n`memory` and `timeout` each accept a shorthand string (\"8GB\", \"30m\") or an\nexplicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /\n`timeout_seconds` properties resolve either form to the canonical integer\nthe sandbox driver consumes.\n\n`timeout` is the max wall-clock the agent may run before its execution is\nstopped, capped at 1h (MAX_SANDBOX_TIMEOUT_SECONDS \u2014 equal to the default, so\ntoday the knob only shortens a session; the cap matches the 1-hour validity\nof the sandbox's GitHub token). The worker's lease/visibility heartbeat\nceiling is derived from that cap, so a run at the max stays owned by its\nworker for its whole life.\n\nCompute currently uses a temporary flat one-cent amount per allocated\nexecution, subject to the account's existing free-compute exemptions.",
+      "description": "Sandbox compute sizing. Every field is optional; None inherits the\nplatform default (2 vCPU / 4096 MiB / 3600s \u2014 see DEFAULT_SANDBOX_* in\nmodels/ellipsis/vms/vm_execution.py). A resolved value outside the platform\nbounds fails validation loudly (a sync error on the config) rather than\nbeing clamped silently.\n\n`memory` and `timeout` each accept a shorthand string (\"8GB\", \"30m\") or an\nexplicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /\n`timeout_seconds` properties resolve either form to the canonical integer\nthe sandbox driver consumes.\n\n`timeout` is the max wall-clock the agent may run before its execution is\nstopped, capped at 1h (MAX_SANDBOX_TIMEOUT_SECONDS \u2014 equal to the default, so\ntoday the knob only shortens a session; the cap matches the 1-hour validity\nof the sandbox's GitHub token). The worker's lease/visibility heartbeat\nceiling is derived from that cap, so a run at the max stays owned by its\nworker for its whole life.\n\nCompute currently uses a temporary flat one-cent amount per allocated\nexecution, subject to the account's existing free-compute exemptions.",
       "properties": {
         "cpu": {
           "anyOf": [
@@ -3866,6 +3891,11 @@
           "title": "Timeout"
         }
       },
+      "required": [
+        "cpu",
+        "memory",
+        "timeout"
+      ],
       "title": "ComputeConfig",
       "type": "object"
     },
@@ -3889,9 +3919,21 @@
           "type": "array"
         }
       },
+      "required": [
+        "annotations",
+        "labels"
+      ],
       "title": "ConfigMetadata",
       "type": "object"
     },
+    "ConversationState": {
+      "enum": [
+        "open",
+        "closed"
+      ],
+      "title": "ConversationState",
+      "type": "string"
+    },
     "CronTrigger": {
       "additionalProperties": false,
       "properties": {
@@ -3907,7 +3949,8 @@
         }
       },
       "required": [
-        "schedule"
+        "schedule",
+        "type"
       ],
       "title": "CronTrigger",
       "type": "object"
@@ -3915,21 +3958,8 @@
     "DeltaFrame": {
       "description": "Fire-and-forget partial assistant output for the current response.\nCarries no sequence number and is never resumable; superseded by the\ncommitted record.",
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Identifier of the turn the delta belongs to, if known.",
-          "title": "Agent Turn Id"
-        },
         "kind": {
-          "description": "What the partial text is. Known values: text ('thinking' reserved). Open vocabulary: ignore deltas with unknown kinds.",
+          "description": "Known values: text (append assistant output), thinking (replace the readable reasoning-summary preview). Open vocabulary: ignore deltas with unknown kinds.",
           "type": "string"
         },
         "output_tokens": {
@@ -3968,9 +3998,22 @@
             }
           ],
           "default": null,
-          "description": "The partial output text.",
+          "description": "For \"text\", an append-only fragment. For \"thinking\", the first-line prefix of the latest summary section (at most 512 characters); replace the preview, and clear it on an empty string. Null means no text update.",
           "title": "Text"
         },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Identifier of the turn the delta belongs to, if known.",
+          "title": "Turn Id"
+        },
         "type": {
           "const": "delta",
           "default": "delta",
@@ -3979,11 +4022,11 @@
         }
       },
       "required": [
-        "agent_turn_id",
         "kind",
         "output_tokens",
         "session_execution_id",
         "text",
+        "turn_id",
         "type"
       ],
       "title": "DeltaFrame",
@@ -4049,6 +4092,11 @@
           "title": "Seconds"
         }
       },
+      "required": [
+        "hours",
+        "minutes",
+        "seconds"
+      ],
       "title": "Duration",
       "type": "object"
     },
@@ -4087,7 +4135,8 @@
         }
       },
       "required": [
-        "level"
+        "level",
+        "match"
       ],
       "title": "EllipsisGrant",
       "type": "object"
@@ -4123,9 +4172,43 @@
       "title": "EllipsisPermissions",
       "type": "object"
     },
+    "EnvironmentBaseBuild": {
+      "additionalProperties": false,
+      "description": "Create a reusable base, optionally using only selected repository files.",
+      "properties": {
+        "inputs": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Exact files relative to /sandbox, including the repository name. Only these files are available during build_base and their contents and modes determine reuse. Omit to use all repositories and invalidate on any source change; [] means no repository files.",
+          "title": "Inputs"
+        },
+        "run": {
+          "description": "Shell script to run in /sandbox.",
+          "minLength": 1,
+          "title": "Run",
+          "type": "string"
+        }
+      },
+      "required": [
+        "inputs",
+        "run"
+      ],
+      "title": "EnvironmentBaseBuild",
+      "type": "object"
+    },
     "EnvironmentConfig": {
       "additionalProperties": false,
-      "description": "Everything about the environment (the sandbox) the agent runs in: which\n`repositories` are cloned into it, which environment `variables` it gets,\nits `compute` sizing, how its `image` is customized, and lifecycle `hooks`.\nWhat the agent may *do* from that environment is the top-level\n`permissions:` block, not this one.\n\nEach `variables` entry names a variable to inject; with an inline `value` it\nis hardcoded, without one it is resolved from the account's sandbox-secrets\nstore. Only the named variables reach this agent; the rest of the account's\nstored variables never do. This is how a config brings in the config and\ncredentials a custom CLI needs.",
+      "description": "Everything about the environment (the sandbox) the agent runs in: which\n`repositories` are cloned into it, which environment `variables` it gets,\nits `compute` sizing, and lifecycle `hooks`.\nWhat the agent may *do* from that environment is the top-level\n`permissions:` block, not this one.\n\nEach `variables` entry names a variable to inject; with an inline `value` it\nis hardcoded, without one it is resolved from the account's sandbox-secrets\nstore. Only the named variables reach this agent; the rest of the account's\nstored variables never do. This is how a config brings in the config and\ncredentials a custom CLI needs.",
       "properties": {
         "compute": {
           "$ref": "#/$defs/ComputeConfig",
@@ -4138,17 +4221,13 @@
         "hooks": {
           "$ref": "#/$defs/EnvironmentHooks",
           "default": {
+            "after_checkout": null,
+            "before_start": null,
+            "build_base": null,
             "post_clone": null,
             "post_start": null
           }
         },
-        "image": {
-          "$ref": "#/$defs/EnvironmentImage",
-          "default": {
-            "dockerfile_append": null,
-            "setup": null
-          }
-        },
         "mcp_servers": {
           "default": [],
           "items": {
@@ -4187,15 +4266,25 @@
           "type": "array"
         }
       },
+      "required": [
+        "compute",
+        "hooks",
+        "mcp_servers",
+        "repositories",
+        "variables"
+      ],
       "title": "EnvironmentConfig",
       "type": "object"
     },
     "EnvironmentHooks": {
       "additionalProperties": false,
-      "description": "Shell scripts run at points in the sandbox lifecycle, each as the sandbox\nuser with the sandbox's environment variables available. A non-zero exit\nfails the run (exit_status = LIFECYCLE_HOOK_FAILED) and is not retried.\n\n`post_start` runs after the container starts, before any repo is cloned \u2014\nrepo-independent setup (authenticate a CLI, e.g. `doppler setup`). On Freestyle\nthe repo is baked into the image so it is incidentally present, but\n`post_start` must not depend on repo contents (that's `post_clone`).\n\n`post_clone` runs after all repos are cloned/checked out, before the agent \u2014\nrepo-dependent setup (`pip install -r requirements.txt`, codegen).\n\nHooks run on every run and their output is never cached. A dependency\ninstall whose result should be reused across runs belongs in `image.setup`\n(baked into the cached image) instead; keep hooks for per-run work \u2014 e.g.\nanything that touches run-scoped credentials.",
+      "description": "Environment lifecycle scripts, in order: build_base, after_checkout,\nbefore_start. The first two produce reusable snapshots; before_start runs\nbefore an agent starts or resumes its session. Scripts run as the sandbox\nuser in /sandbox. A nonzero exit fails the session.\n\nLegacy post_start/post_clone scripts remain supported for existing configs;\nboth run after workspace preparation, before the agent starts or resumes.\nThey cannot be combined with the new lifecycle fields.",
       "properties": {
-        "post_clone": {
+        "after_checkout": {
           "anyOf": [
+            {
+              "$ref": "#/$defs/EnvironmentScript"
+            },
             {
               "type": "string"
             },
@@ -4204,10 +4293,14 @@
             }
           ],
           "default": null,
-          "title": "Post Clone"
+          "description": "Prepare the requested source revision after Ellipsis checks out all repositories, before saving the prepared sandbox. Skipped when that prepared sandbox is reused.",
+          "title": "After Checkout"
         },
-        "post_start": {
+        "before_start": {
           "anyOf": [
+            {
+              "$ref": "#/$defs/EnvironmentScript"
+            },
             {
               "type": "string"
             },
@@ -4216,17 +4309,26 @@
             }
           ],
           "default": null,
-          "title": "Post Start"
-        }
-      },
-      "title": "EnvironmentHooks",
-      "type": "object"
-    },
-    "EnvironmentImage": {
-      "additionalProperties": false,
-      "description": "How to customize the container image the agent runs in. You\ncontribute appended layers (`dockerfile_append`) and a build-time script\n(`setup`) only \u2014 Ellipsis owns FROM / base tooling / entrypoint / user.\nToday only inline bodies are supported; a file reference (resolved at the\nrun's SHA) will come later.\n\nThe split: `dockerfile_append` runs when the image is assembled, before any\nrepo exists \u2014 toolchain installs (a package manager binary, apt packages).\n`setup` runs at image-build time *after* the configured repositories are\nchecked out, and its output is captured by the filesystem snapshot that\nbecomes the cached image \u2014 dependency installs (`poetry install`,\n`npm install`), so later runs start with deps already on disk. Neither runs\nper run; that's `hooks.post_start` / `hooks.post_clone`.",
-      "properties": {
-        "dockerfile_append": {
+          "description": "Run before the agent starts or resumes a session, after the sandbox is ready. This hook is not cached and adds to session startup time.",
+          "title": "Before Start"
+        },
+        "build_base": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/EnvironmentBaseBuild"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Build a reusable environment before full checkout. Cached by declared inputs, script, toolchain, resources, and build configuration. A string is shorthand for run with all repositories as inputs.",
+          "title": "Build Base"
+        },
+        "post_clone": {
           "anyOf": [
             {
               "type": "string"
@@ -4236,9 +4338,10 @@
             }
           ],
           "default": null,
-          "title": "Dockerfile Append"
+          "description": "Legacy session startup script. Use before_start for session setup or after_checkout for cached source preparation.",
+          "title": "Post Clone"
         },
-        "setup": {
+        "post_start": {
           "anyOf": [
             {
               "type": "string"
@@ -4248,17 +4351,42 @@
             }
           ],
           "default": null,
-          "title": "Setup"
+          "description": "Legacy session startup script. Use before_start in new configurations.",
+          "title": "Post Start"
+        }
+      },
+      "required": [
+        "after_checkout",
+        "before_start",
+        "build_base",
+        "post_clone",
+        "post_start"
+      ],
+      "title": "EnvironmentHooks",
+      "type": "object"
+    },
+    "EnvironmentScript": {
+      "additionalProperties": false,
+      "description": "An inline shell script run as the sandbox user, with /sandbox as cwd.",
+      "properties": {
+        "run": {
+          "description": "Shell script to run in /sandbox.",
+          "minLength": 1,
+          "title": "Run",
+          "type": "string"
         }
       },
-      "title": "EnvironmentImage",
+      "required": [
+        "run"
+      ],
+      "title": "EnvironmentScript",
       "type": "object"
     },
     "EnvironmentSource": {
       "description": "How a session's environment was chosen. None (the field is nullable)\nwhen the config carried an inline environment block and no resolution ran \u2014\nan inline environment is not a reference, so there is nothing to record.\n\nNot derivable from the row: `environment_id` says WHICH environment, not\nhow it was chosen, and is null for the built-in basic sandbox.",
       "enum": [
         "request",
-        "automation",
+        "agent",
         "repo_default",
         "account_default",
         "platform_default"
@@ -4288,7 +4416,8 @@
         }
       },
       "required": [
-        "name"
+        "name",
+        "value"
       ],
       "title": "EnvironmentVariable",
       "type": "object"
@@ -4345,6 +4474,10 @@
               "title": "Include"
             }
           },
+          "required": [
+            "exclude",
+            "include"
+          ],
           "title": "GithubAccountFilter",
           "type": "object"
         },
@@ -4370,6 +4503,10 @@
           "$ref": "#/$defs/GithubAccountFilter"
         }
       },
+      "required": [
+        "bots",
+        "users"
+      ],
       "title": "GithubAccountSelector",
       "type": "object"
     },
@@ -4393,10 +4530,10 @@
         }
       },
       "required": [
+        "avatar_url",
         "id",
         "login",
-        "type",
-        "avatar_url"
+        "type"
       ],
       "title": "GithubAccountSnippet",
       "type": "object"
@@ -4411,6 +4548,57 @@
       "title": "GithubAccountType",
       "type": "string"
     },
+    "GithubIssueEvent": {
+      "properties": {
+        "action": {
+          "$ref": "#/$defs/IssueAction"
+        },
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "number": {
+          "title": "Number",
+          "type": "integer"
+        },
+        "repository": {
+          "title": "Repository",
+          "type": "string"
+        },
+        "title": {
+          "title": "Title",
+          "type": "string"
+        },
+        "type": {
+          "const": "github.issue",
+          "default": "github.issue",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "number",
+        "repository",
+        "title",
+        "type",
+        "url"
+      ],
+      "title": "GithubIssueEvent",
+      "type": "object"
+    },
     "GithubPermissions": {
       "additionalProperties": false,
       "description": "The agent's GitHub access: the scope of the installation token minted for\nits sandbox \u2014 the credential `git`, `gh`, and the GitHub MCP server\nauthenticate 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 sandbox can\nexceed it.",
@@ -4450,33 +4638,140 @@
           "title": "Repositories"
         }
       },
+      "required": [
+        "permissions",
+        "repositories"
+      ],
       "title": "GithubPermissions",
       "type": "object"
     },
-    "Harness": {
-      "enum": [
-        "claude_code",
-        "codex"
+    "GithubPullRequestEvent": {
+      "properties": {
+        "action": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/PullRequestAction"
+            },
+            {
+              "const": "review_commented",
+              "type": "string"
+            }
+          ],
+          "title": "Action"
+        },
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "branch": {
+          "title": "Branch",
+          "type": "string"
+        },
+        "number": {
+          "title": "Number",
+          "type": "integer"
+        },
+        "repository": {
+          "title": "Repository",
+          "type": "string"
+        },
+        "title": {
+          "title": "Title",
+          "type": "string"
+        },
+        "type": {
+          "const": "github.pull_request",
+          "default": "github.pull_request",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "branch",
+        "number",
+        "repository",
+        "title",
+        "type",
+        "url"
       ],
-      "title": "Harness",
-      "type": "string"
+      "title": "GithubPullRequestEvent",
+      "type": "object"
     },
-    "HarnessOptions": {
-      "discriminator": {
-        "mapping": {
-          "claude_code": "#/$defs/ClaudeConfig",
-          "codex": "#/$defs/CodexConfig"
+    "GithubPushEvent": {
+      "properties": {
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
         },
-        "propertyName": "type"
-      },
-      "oneOf": [
-        {
-          "$ref": "#/$defs/ClaudeConfig"
+        "after": {
+          "title": "After",
+          "type": "string"
         },
-        {
-          "$ref": "#/$defs/CodexConfig"
+        "before": {
+          "title": "Before",
+          "type": "string"
+        },
+        "branch": {
+          "title": "Branch",
+          "type": "string"
+        },
+        "repository": {
+          "title": "Repository",
+          "type": "string"
+        },
+        "type": {
+          "const": "github.push",
+          "default": "github.push",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
         }
-      ]
+      },
+      "required": [
+        "actor",
+        "after",
+        "before",
+        "branch",
+        "repository",
+        "type",
+        "url"
+      ],
+      "title": "GithubPushEvent",
+      "type": "object"
+    },
+    "HandlerService": {
+      "description": "The service whose events a handler responds to.",
+      "enum": [
+        "slack",
+        "github",
+        "linear",
+        "sentry"
+      ],
+      "title": "HandlerService",
+      "type": "string"
     },
     "HeartbeatFrame": {
       "description": "A keepalive sent after a period of idleness; doubles as the dead-socket\nprobe. Clients should treat roughly twice the heartbeat interval of\nsilence as a dead connection.",
@@ -4503,7 +4798,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` types the payload a caller-started session takes\n(`POST /v1/sessions` `input`, validated at the door; required when\ndeclared). It is illegal on a react-triggered agent \u2014 react payloads are\nplatform-shaped (the published surface field sets), not caller-shaped.\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 AutomationConfig'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` 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`).",
       "properties": {
         "json_schema": {
           "anyOf": [
@@ -4531,32 +4826,13 @@
           "title": "Message"
         }
       },
+      "required": [
+        "json_schema",
+        "message"
+      ],
       "title": "InputContract",
       "type": "object"
     },
-    "Instructions": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "$ref": "#/$defs/SystemFileRef"
-        },
-        {
-          "items": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "$ref": "#/$defs/SystemFileRef"
-              }
-            ]
-          },
-          "type": "array"
-        }
-      ]
-    },
     "IssueAction": {
       "enum": [
         "opened",
@@ -4930,6 +5206,74 @@
       "title": "LinearIssueAction",
       "type": "string"
     },
+    "LinearIssueEvent": {
+      "properties": {
+        "action": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/LinearIssueAction"
+            },
+            {
+              "const": "commented",
+              "type": "string"
+            }
+          ],
+          "title": "Action"
+        },
+        "actor": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionEventActor"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "identifier": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Identifier"
+        },
+        "number": {
+          "title": "Number",
+          "type": "integer"
+        },
+        "title": {
+          "title": "Title",
+          "type": "string"
+        },
+        "type": {
+          "const": "linear.issue",
+          "default": "linear.issue",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "identifier",
+        "number",
+        "title",
+        "type",
+        "url"
+      ],
+      "title": "LinearIssueEvent",
+      "type": "object"
+    },
     "McpRemoteServer": {
       "additionalProperties": false,
       "description": "A bring-your-own remote MCP server: the harness talks HTTP to `url`.\nNothing runs in the sandbox 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.",
@@ -4952,6 +5296,7 @@
         }
       },
       "required": [
+        "headers",
         "name",
         "url"
       ],
@@ -4975,7 +5320,7 @@
     },
     "McpStdioServer": {
       "additionalProperties": false,
-      "description": "A bring-your-own stdio MCP server: the harness spawns `command` inside\nthe sandbox and speaks JSON-RPC over its stdin/stdout. The command must be\nrunnable in the sandbox image \u2014 install its runtime via `image.setup` /\n`image.dockerfile_append` if the base image lacks it.\n\n`env` values may embed `${NAME}` references, resolved at run time from the\naccount's secrets store (see `mcp_secret_refs`); everything else is passed\nliterally.",
+      "description": "A bring-your-own stdio MCP server: the harness spawns `command` inside\nthe sandbox and speaks JSON-RPC over its stdin/stdout. The command must be\nrunnable in the sandbox image \u2014 install its runtime via `hooks.build_base` /\n`hooks.after_checkout` if the managed environment lacks it.\n\n`env` values may embed `${NAME}` references, resolved at run time from the\naccount's secrets store (see `mcp_secret_refs`); everything else is passed\nliterally.",
       "properties": {
         "args": {
           "default": [],
@@ -5003,9 +5348,11 @@
         }
       },
       "required": [
-        "name",
-        "command"
-      ],
+        "args",
+        "command",
+        "env",
+        "name"
+      ],
       "title": "McpStdioServer",
       "type": "object"
     },
@@ -5040,6 +5387,10 @@
           "title": "Mb"
         }
       },
+      "required": [
+        "gb",
+        "mb"
+      ],
       "title": "MemorySize",
       "type": "object"
     },
@@ -5065,19 +5416,6 @@
     },
     "MessageDeliveredRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -5230,10 +5568,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -5251,7 +5601,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "MessageDeliveredRecord",
       "type": "object",
@@ -5320,19 +5671,6 @@
     },
     "MessageReceivedRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -5485,10 +5823,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -5506,7 +5856,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "MessageReceivedRecord",
       "type": "object",
@@ -5534,19 +5885,6 @@
     },
     "MessageRequeuedRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -5699,10 +6037,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -5720,7 +6070,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "MessageRequeuedRecord",
       "type": "object",
@@ -5769,19 +6120,6 @@
     },
     "OutboxCollectedRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -5934,10 +6272,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -5955,7 +6305,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "OutboxCollectedRecord",
       "type": "object",
@@ -5977,15 +6328,6 @@
       "title": "OutputConfig",
       "type": "object"
     },
-    "ParentKind": {
-      "description": "How a session relates to its predecessor (parent_agent_session_id) \u2014\nthe ONE \"preceded-by\" chain for every predecessor relationship. Routing\nreads this when the distinction matters.\n\nCONTINUATION \u2014 a follow-up in the same conversation surface (e.g. a Slack\nthread reply spawning a fresh session on the same thread).\nRESUME \u2014 a conversation re-hosted on a new box after its sandbox was torn\ndown (interactive platform; later phase).",
-      "enum": [
-        "continuation",
-        "resume"
-      ],
-      "title": "ParentKind",
-      "type": "string"
-    },
     "PermissionsConfig": {
       "additionalProperties": false,
       "description": "What the agent is allowed to touch, per credential the platform mints\ninto its sandbox. Distinct from `environment:`, which is where the agent\nruns; this is what it may do from there.\n\n`ellipsis` scopes the sandbox's Ellipsis API token\n(`ELLIPSIS_API_TOKEN`, what the in-sandbox `agent` CLI authenticates\nwith). `true` / the string `all` (the default) grant the full sandbox\nceiling \u2014 everything a sandbox 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 sandbox's GitHub installation token (`GH_TOKEN`) \u2014\nsee `GithubPermissions`. GitHub enforces it at mint time.",
@@ -6013,6 +6355,10 @@
           }
         }
       },
+      "required": [
+        "ellipsis",
+        "github"
+      ],
       "title": "PermissionsConfig",
       "type": "object"
     },
@@ -6147,7 +6493,10 @@
         }
       },
       "required": [
-        "on"
+        "for",
+        "labels",
+        "on",
+        "repositories"
       ],
       "title": "ReactIssue",
       "type": "object"
@@ -6169,6 +6518,10 @@
           "type": "array"
         }
       },
+      "required": [
+        "for",
+        "on"
+      ],
       "title": "ReactLinearIssue",
       "type": "object"
     },
@@ -6234,7 +6587,14 @@
         }
       },
       "required": [
-        "on"
+        "base",
+        "draft",
+        "for",
+        "head",
+        "labels",
+        "on",
+        "paths",
+        "repositories"
       ],
       "title": "ReactPullRequest",
       "type": "object"
@@ -6265,6 +6625,12 @@
           "$ref": "#/$defs/RepositoryFilter"
         }
       },
+      "required": [
+        "branch",
+        "for",
+        "paths",
+        "repositories"
+      ],
       "title": "ReactPush",
       "type": "object"
     },
@@ -6288,7 +6654,8 @@
         }
       },
       "required": [
-        "on"
+        "on",
+        "projects"
       ],
       "title": "ReactSentry",
       "type": "object"
@@ -6375,6 +6742,15 @@
           "type": "string"
         }
       },
+      "required": [
+        "issue",
+        "linear_issue",
+        "pull_request",
+        "push",
+        "sentry",
+        "slack_channel",
+        "type"
+      ],
       "title": "ReactTrigger",
       "type": "object"
     },
@@ -6426,6 +6802,10 @@
               "type": "array"
             }
           },
+          "required": [
+            "exclude",
+            "include"
+          ],
           "title": "RepositoryFilter",
           "type": "object"
         },
@@ -6470,7 +6850,9 @@
         }
       },
       "required": [
-        "name"
+        "name",
+        "owner",
+        "ref"
       ],
       "title": "RepositoryRef",
       "type": "object"
@@ -6497,22 +6879,6 @@
       "title": "Resource",
       "type": "string"
     },
-    "RunStatus": {
-      "description": "What the current (or most recent) execution is doing (backs `run`).",
-      "enum": [
-        "scheduled",
-        "starting",
-        "working",
-        "waiting",
-        "done",
-        "failed",
-        "stopped",
-        "cancelled",
-        "retrying"
-      ],
-      "title": "RunStatus",
-      "type": "string"
-    },
     "SandboxOutputPayload": {
       "additionalProperties": true,
       "description": "sandbox_output \u2014 one chunk of provisioning/lifecycle-script output.\nMany fire per execution; `chunk` rides the idempotency key. These records\nARE the durable copy (archived into the session log's S3 segments), under\na high per-session cap + truncation marker.",
@@ -6560,19 +6926,6 @@
     },
     "SandboxOutputRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -6725,10 +7078,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -6746,7 +7111,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "SandboxOutputRecord",
       "type": "object",
@@ -6811,19 +7177,6 @@
     },
     "SandboxPhaseRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -6976,10 +7329,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -6997,7 +7362,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "SandboxPhaseRecord",
       "type": "object",
@@ -7043,19 +7409,6 @@
     },
     "SandboxReadyRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -7208,10 +7561,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -7229,7 +7594,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "SandboxReadyRecord",
       "type": "object",
@@ -7255,19 +7621,6 @@
     },
     "SandboxStartingRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -7420,10 +7773,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -7441,7 +7806,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "SandboxStartingRecord",
       "type": "object",
@@ -7881,34 +8247,39 @@
       "title": "SentryAction",
       "type": "string"
     },
-    "Session": {
-      "description": "An agent session: one conversation with an agent, from trigger to\nterminal state. Returned by `GET /v1/sessions/{id}` and carried by the\nsession stream's `session`/`snapshot` frames \u2014 REST and stream never\ndisagree about what a session looks like.",
+    "SentryAlertEvent": {
       "properties": {
-        "attribution": {
-          "$ref": "#/$defs/SessionAttribution",
-          "description": "The principal this session is attributed to."
+        "action": {
+          "$ref": "#/$defs/SentryAction"
         },
-        "automation": {
+        "actor": {
           "anyOf": [
             {
-              "$ref": "#/$defs/SessionAutomation"
+              "$ref": "#/$defs/SessionEventActor"
             },
             {
               "type": "null"
             }
           ],
-          "default": null,
-          "description": "The automation the session was started from, or null for a raw session started with POST /v1/sessions."
+          "default": null
         },
-        "budget": {
-          "$ref": "#/$defs/SessionBudget",
-          "description": "The spend budget enforced for this session."
+        "organization_slug": {
+          "title": "Organization Slug",
+          "type": "string"
         },
-        "config": {
-          "$ref": "#/$defs/SessionConfig",
-          "description": "What the session ran on, frozen when it was created: the harness block, the resolved environment, permissions, skills, output contract, and budget."
+        "project_slug": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Project Slug"
         },
-        "context_repository": {
+        "title": {
           "anyOf": [
             {
               "type": "string"
@@ -7918,226 +8289,311 @@
             }
           ],
           "default": null,
-          "description": "The \"owner/name\" repository context the session was started in, if any.",
-          "title": "Context Repository"
+          "title": "Title"
         },
-        "cost": {
-          "$ref": "#/$defs/SessionCost",
-          "description": "What the session cost, in millicents, broken down by leg and carrying its own total."
-        },
-        "created_at": {
-          "description": "When the session was created.",
-          "format": "date-time",
-          "title": "Created At",
+        "type": {
+          "const": "sentry.alert",
+          "default": "sentry.alert",
+          "title": "Type",
           "type": "string"
         },
-        "environment": {
-          "$ref": "#/$defs/SessionEnvironment",
-          "description": "The environment the session resolved: the saved environment's id and how it was chosen. The environment's frozen body is `config.environment`."
-        },
-        "exit_status": {
+        "url": {
           "anyOf": [
             {
-              "$ref": "#/$defs/SessionExitStatus"
+              "type": "string"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "How the session ended; null until it is terminal."
-        },
-        "git": {
+          "title": "Url"
+        }
+      },
+      "required": [
+        "action",
+        "actor",
+        "organization_slug",
+        "project_slug",
+        "title",
+        "type",
+        "url"
+      ],
+      "title": "SentryAlertEvent",
+      "type": "object"
+    },
+    "Session": {
+      "additionalProperties": false,
+      "allOf": [
+        {
+          "oneOf": [
+            {
+              "properties": {
+                "claude_code": {
+                  "additionalProperties": true,
+                  "type": "object"
+                },
+                "codex": {
+                  "type": "null"
+                }
+              },
+              "required": [
+                "claude_code",
+                "codex"
+              ]
+            },
+            {
+              "properties": {
+                "claude_code": {
+                  "type": "null"
+                },
+                "codex": {
+                  "additionalProperties": true,
+                  "type": "object"
+                }
+              },
+              "required": [
+                "claude_code",
+                "codex"
+              ]
+            }
+          ]
+        }
+      ],
+      "description": "An agent session: one conversation with an agent, from trigger to\nterminal state. Returned by `GET /v1/sessions/{id}` and carried by the\nsession stream's `session`/`snapshot` frames \u2014 REST and stream never\ndisagree about what a session looks like.",
+      "properties": {
+        "agent": {
           "anyOf": [
             {
-              "$ref": "#/$defs/SessionGit"
+              "$ref": "#/$defs/SessionAgent"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "What the session did to git, one entry per repository in its workspace: the commit and branch it sits on, per-file line counts for its uncommitted changes, and the pull requests it opened. Null if nothing was ever captured."
+          "description": "The agent the session was started from, or null for a raw session started with POST /v1/sessions."
         },
-        "harness": {
-          "$ref": "#/$defs/Harness",
-          "description": "The coding-agent harness the session runs on."
+        "attribution": {
+          "$ref": "#/$defs/SessionAttribution",
+          "description": "The principal this session is attributed to."
         },
-        "id": {
-          "description": "Unique identifier of the session.",
-          "title": "Id",
-          "type": "string"
+        "budget": {
+          "default": 0,
+          "description": "The spend budget enforced for this session, in US dollars, after resolving defaults and ceilings.",
+          "title": "Budget",
+          "type": "number"
         },
-        "last_activity_at": {
+        "claude_code": {
           "anyOf": [
             {
-              "format": "date-time",
-              "type": "string"
+              "$ref": "#/$defs/ClaudeConfig"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "When the session last showed activity.",
-          "title": "Last Activity At"
+          "description": "Claude Code input and native options. Set exactly one of claude_code or codex."
         },
-        "last_message_at": {
+        "codex": {
           "anyOf": [
             {
-              "format": "date-time",
-              "type": "string"
+              "$ref": "#/$defs/CodexConfig"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "When the session last received a message.",
-          "title": "Last Message At"
+          "description": "Codex input and native options. Set exactly one of claude_code or codex."
         },
-        "metadata": {
-          "additionalProperties": {
-            "type": "string"
-          },
-          "default": {},
-          "description": "Caller-supplied metadata key-value pairs.",
-          "title": "Metadata",
-          "type": "object"
+        "cost": {
+          "$ref": "#/$defs/SessionCost",
+          "description": "What the session cost, in millicents, broken down by leg and carrying its own total."
         },
-        "parent": {
-          "$ref": "#/$defs/SessionParent",
-          "description": "What preceded this session, if anything."
+        "environment": {
+          "$ref": "#/$defs/SessionEnvironment",
+          "description": "The full environment configuration frozen when the session was created, with the saved environment's id and how it was chosen."
         },
-        "prompt": {
+        "event": {
           "anyOf": [
             {
-              "type": "string"
+              "discriminator": {
+                "mapping": {
+                  "github.issue": "#/$defs/GithubIssueEvent",
+                  "github.pull_request": "#/$defs/GithubPullRequestEvent",
+                  "github.push": "#/$defs/GithubPushEvent",
+                  "linear.issue": "#/$defs/LinearIssueEvent",
+                  "sentry.alert": "#/$defs/SentryAlertEvent",
+                  "slack.channel_created": "#/$defs/SlackChannelCreatedEvent",
+                  "slack.message": "#/$defs/SlackMessageEvent"
+                },
+                "propertyName": "type"
+              },
+              "oneOf": [
+                {
+                  "$ref": "#/$defs/GithubPullRequestEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubIssueEvent"
+                },
+                {
+                  "$ref": "#/$defs/GithubPushEvent"
+                },
+                {
+                  "$ref": "#/$defs/LinearIssueEvent"
+                },
+                {
+                  "$ref": "#/$defs/SlackMessageEvent"
+                },
+                {
+                  "$ref": "#/$defs/SlackChannelCreatedEvent"
+                },
+                {
+                  "$ref": "#/$defs/SentryAlertEvent"
+                }
+              ]
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "The per-session prompt the session was started with.",
-          "title": "Prompt"
+          "description": "The typed external event that started the session; null for direct and scheduled starts.",
+          "title": "Event"
         },
-        "prompting": {
-          "$ref": "#/$defs/SessionPrompting",
-          "description": "Whether a client may send this session a message and, when it may not, the reason to show instead of a composer."
+        "git": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionGit"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "What the session did to git, one entry per repository in its workspace: the commit and branch it sits on, per-file line counts for its uncommitted changes, and the pull requests it opened. Null if nothing was ever captured."
         },
-        "session_state": {
+        "handler": {
           "anyOf": [
             {
-              "$ref": "#/$defs/SessionState"
+              "$ref": "#/$defs/SessionHandler"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "Lifecycle state of the durable conversation, or null for sessions without one."
+          "description": "The saved handler and its effective display name when this session started, frozen at creation. Null for built-in responders, legacy sessions, and sessions started without a handler."
         },
-        "source": {
-          "$ref": "#/$defs/SessionSource",
-          "description": "Where the session came from (e.g. react, web, api, cli, mention, cron)."
+        "id": {
+          "description": "Unique identifier of the session.",
+          "title": "Id",
+          "type": "string"
         },
-        "status": {
-          "$ref": "#/$defs/SessionStatus",
-          "description": "Execution status of the session."
+        "lifecycle": {
+          "$ref": "#/$defs/SessionLifecycle",
+          "description": "The session's activity, conversation state, messaging policy, outcomes, and timestamps."
+        },
+        "metadata": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "default": {},
+          "description": "Caller-supplied metadata key-value pairs.",
+          "title": "Metadata",
+          "type": "object"
         },
-        "status_reason": {
+        "output": {
           "anyOf": [
             {
-              "type": "string"
+              "$ref": "#/$defs/OutputConfig"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "Human-readable reason for the current status, when there is one.",
-          "title": "Status Reason"
+          "description": "The structured-output exit contract for this session."
         },
-        "stopped": {
-          "$ref": "#/$defs/SessionStopped",
-          "description": "The stop request, if the session was stopped."
-        },
-        "summary": {
+        "parent": {
           "anyOf": [
             {
-              "$ref": "#/$defs/SessionSummary"
+              "$ref": "#/$defs/SessionParent"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "The latest live summary of the session's progress while it runs, and when it was generated."
+          "description": "The predecessor session this session continues; null when there is none."
         },
-        "surface": {
-          "$ref": "#/$defs/SessionSurface",
-          "description": "The public status projection: the durable conversation (`session`), the current execution (`run`), and the one derived `status` word."
+        "permissions": {
+          "$ref": "#/$defs/PermissionsConfig",
+          "description": "What the session may touch, per minted credential."
         },
-        "tokens": {
-          "$ref": "#/$defs/SessionTokens",
-          "description": "The tokens the session spent and the model they went to. `total` includes the prompt-cache lanes."
+        "skills": {
+          "description": "Skills installed for this session.",
+          "items": {
+            "$ref": "#/$defs/SkillRef"
+          },
+          "title": "Skills",
+          "type": "array"
         },
-        "trigger": {
+        "source": {
+          "$ref": "#/$defs/SessionSource",
+          "description": "Where the session came from (e.g. react, web, api, cli, mention, cron)."
+        },
+        "summary": {
           "anyOf": [
             {
-              "$ref": "#/$defs/SessionTrigger"
+              "$ref": "#/$defs/SessionSummary"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "The external event that started the session."
+          "description": "The latest live summary of the session's progress while it runs, and when it was generated."
         },
-        "updated_at": {
-          "description": "When the session was last updated.",
-          "format": "date-time",
-          "title": "Updated At",
-          "type": "string"
+        "tokens": {
+          "$ref": "#/$defs/SessionTokens",
+          "description": "The tokens the session spent and the model they went to. `total` includes the prompt-cache lanes."
         }
       },
       "required": [
+        "agent",
         "attribution",
-        "automation",
         "budget",
-        "config",
-        "context_repository",
+        "claude_code",
+        "codex",
         "cost",
-        "created_at",
         "environment",
-        "exit_status",
+        "event",
         "git",
-        "harness",
+        "handler",
         "id",
-        "last_activity_at",
-        "last_message_at",
+        "lifecycle",
         "metadata",
+        "output",
         "parent",
-        "prompt",
-        "prompting",
-        "session_state",
+        "permissions",
+        "skills",
         "source",
-        "status",
-        "status_reason",
-        "stopped",
         "summary",
-        "surface",
-        "tokens",
-        "trigger",
-        "updated_at"
+        "tokens"
       ],
       "title": "Session",
       "type": "object"
     },
-    "SessionAttribution": {
-      "description": "The principal a session is attributed to: what kind, its id, and \u2014 when\nthe kind is a GitHub user \u2014 the resolved display snippet.",
+    "SessionAgent": {
+      "description": "The agent this session was started from: the definition frozen\nwhen the session was created, and the saved agent it came from as it\nexists NOW. They diverge legitimately \u2014 a YAML edit after the session\nstarted leaves the pointer describing something the session never ran.",
       "properties": {
+        "config": {
+          "$ref": "#/$defs/AgentConfig",
+          "description": "The agent definition the session was started from, frozen when the session was created."
+        },
         "id": {
           "anyOf": [
             {
@@ -8148,80 +8604,93 @@
             }
           ],
           "default": null,
-          "description": "Identifier of the principal the session is attributed to.",
+          "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.",
           "title": "Id"
+        }
+      },
+      "required": [
+        "config",
+        "id"
+      ],
+      "title": "SessionAgent",
+      "type": "object"
+    },
+    "SessionArchived": {
+      "description": "When the session was archived and the GitHub user who archived it.",
+      "properties": {
+        "at": {
+          "description": "When the session was archived.",
+          "format": "date-time",
+          "title": "At",
+          "type": "string"
         },
-        "type": {
+        "by": {
           "anyOf": [
             {
-              "$ref": "#/$defs/AttributionType"
+              "$ref": "#/$defs/GithubAccountSnippet"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "Kind of principal the session is attributed to (e.g. a GitHub user or an API key)."
+          "description": "The GitHub user who archived the session; null if unknown or unavailable."
+        }
+      },
+      "required": [
+        "at",
+        "by"
+      ],
+      "title": "SessionArchived",
+      "type": "object"
+    },
+    "SessionAttribution": {
+      "description": "The principal a session is attributed to: what kind, its id, and \u2014 when\nthe kind is a GitHub user \u2014 the resolved display snippet.",
+      "properties": {
+        "id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Identifier of the principal the session is attributed to.",
+          "title": "Id"
         },
-        "user": {
+        "type": {
           "anyOf": [
             {
-              "$ref": "#/$defs/GithubAccountSnippet"
+              "$ref": "#/$defs/AttributionType"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "The GitHub user the session is attributed to, resolved at read time. Null when the attribution is not a GitHub user."
-        }
-      },
-      "title": "SessionAttribution",
-      "type": "object"
-    },
-    "SessionAutomation": {
-      "description": "The automation this session was started from: the definition frozen\nwhen the session was created, and the saved automation it came from as it\nexists NOW. They diverge legitimately \u2014 a YAML edit after the session\nstarted leaves the pointer describing something the session never ran.",
-      "properties": {
-        "config": {
-          "$ref": "#/$defs/AutomationConfig",
-          "description": "The automation definition the session was started from, frozen when the session was created."
+          "description": "Kind of principal the session is attributed to (e.g. a GitHub user or an API key)."
         },
-        "id": {
+        "user": {
           "anyOf": [
             {
-              "type": "string"
+              "$ref": "#/$defs/GithubAccountSnippet"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "Identifier of the saved automation 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 automation behind them. Points at the automation as it exists now, which may have changed since.",
-          "title": "Id"
+          "description": "The GitHub user the session is attributed to, resolved at read time. Null when the attribution is not a GitHub user."
         }
       },
       "required": [
-        "config"
+        "id",
+        "type",
+        "user"
       ],
-      "title": "SessionAutomation",
-      "type": "object"
-    },
-    "SessionBudget": {
-      "description": "The spend budget actually enforced for this session, and which layer of\nthe cascade set it.",
-      "properties": {
-        "cents": {
-          "default": 0,
-          "description": "The spend budget resolved for this session, in cents.",
-          "title": "Cents",
-          "type": "integer"
-        },
-        "source": {
-          "$ref": "#/$defs/BudgetSource",
-          "default": "account",
-          "description": "Where the resolved budget came from."
-        }
-      },
-      "title": "SessionBudget",
+      "title": "SessionAttribution",
       "type": "object"
     },
     "SessionCancelledPayload": {
@@ -8241,19 +8710,6 @@
     },
     "SessionCancelledRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -8406,10 +8862,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -8427,7 +8895,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "SessionCancelledRecord",
       "type": "object",
@@ -8442,19 +8911,6 @@
     },
     "SessionClosedRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -8607,10 +9063,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -8628,7 +9096,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "SessionClosedRecord",
       "type": "object",
@@ -8636,7 +9105,43 @@
     },
     "SessionConfig": {
       "additionalProperties": false,
-      "description": "What one session runs on: its selected harness, where it runs, what it\nmay touch, its skills, its exit contract, and its spend cap. Every session\nfreezes one of these (`agent_sessions.session_config`); an automation\ncarries one under `session:` (`AutomationConfig.session`); and\n`POST /v1/sessions` is this shape flattened onto the request body, plus the\nrun settings. Nothing in here is an automation's identity or trigger \u2014\nthose belong to `AutomationConfig`.\n\nField order is the canonical key order for `session:` blocks and YAML\nexports: what runs (`harness`, `instructions`), where (`environment`), what it may\ntouch (`permissions`), then the rest.",
+      "allOf": [
+        {
+          "oneOf": [
+            {
+              "properties": {
+                "claude_code": {
+                  "additionalProperties": true,
+                  "type": "object"
+                },
+                "codex": {
+                  "type": "null"
+                }
+              },
+              "required": [
+                "claude_code",
+                "codex"
+              ]
+            },
+            {
+              "properties": {
+                "claude_code": {
+                  "type": "null"
+                },
+                "codex": {
+                  "additionalProperties": true,
+                  "type": "object"
+                }
+              },
+              "required": [
+                "claude_code",
+                "codex"
+              ]
+            }
+          ]
+        }
+      ],
+      "description": "What one session runs on: its selected harness, where it runs, what it\nmay touch, its skills, its exit contract, and its spend cap. Every session\nfreezes one of these (`sessions.session_config`); an agent\ncarries one under `session:` (`AgentConfig.session`); and\n`POST /v1/sessions` is this shape flattened onto the request body, plus the\nrun settings. Nothing in here is an agent's identity or trigger \u2014\nthose belong to `AgentConfig`.\n\nField order is the canonical key order for `session:` blocks and YAML\nexports: what runs (`claude_code` or `codex`), where (`environment`), what it may\ntouch (`permissions`), then the rest.",
       "properties": {
         "budget": {
           "$ref": "#/$defs/BudgetConfig",
@@ -8647,6 +9152,30 @@
             "week": null
           }
         },
+        "claude_code": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/ClaudeConfig"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Claude Code input and native options. Set exactly one of claude_code or codex."
+        },
+        "codex": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/CodexConfig"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Codex input and native options. Set exactly one of claude_code or codex."
+        },
         "environment": {
           "anyOf": [
             {
@@ -8663,28 +9192,18 @@
               "timeout": null
             },
             "hooks": {
+              "after_checkout": null,
+              "before_start": null,
+              "build_base": null,
               "post_clone": null,
               "post_start": null
             },
-            "image": {
-              "dockerfile_append": null,
-              "setup": null
-            },
             "mcp_servers": [],
             "repositories": [],
             "variables": []
           },
           "title": "Environment"
         },
-        "harness": {
-          "$ref": "#/$defs/HarnessOptions",
-          "description": "The explicitly selected harness and its native options."
-        },
-        "instructions": {
-          "$ref": "#/$defs/Instructions",
-          "default": "",
-          "description": "Instructions appended to the harness's own prompt. Text and repository file references are resolved in order."
-        },
         "output": {
           "anyOf": [
             {
@@ -8716,7 +9235,13 @@
         }
       },
       "required": [
-        "harness"
+        "budget",
+        "claude_code",
+        "codex",
+        "environment",
+        "output",
+        "permissions",
+        "skills"
       ],
       "title": "SessionConfig",
       "type": "object"
@@ -8724,6 +9249,12 @@
     "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": "Sandbox CPU spend in millicents.",
+          "title": "Cpu",
+          "type": "integer"
+        },
         "fee": {
           "default": 0,
           "description": "Platform fee in millicents.",
@@ -8736,32 +9267,52 @@
           "title": "Llm",
           "type": "integer"
         },
-        "sandbox_cpu": {
-          "default": 0,
-          "description": "Sandbox CPU spend in millicents.",
-          "title": "Sandbox Cpu",
-          "type": "integer"
-        },
-        "sandbox_memory": {
+        "memory": {
           "default": 0,
           "description": "Sandbox memory spend in millicents.",
-          "title": "Sandbox Memory",
+          "title": "Memory",
           "type": "integer"
         },
         "total": {
           "default": 0,
-          "description": "The grand total in millicents: llm + sandbox_cpu + sandbox_memory + fee.",
+          "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": {
-      "description": "The environment this session resolved: which saved environment (as it\nexists now) and how it was chosen. The environment's frozen BODY rides\ninside `config.environment` \u2014 substitution happens before the config\nsnapshot freezes \u2014 so this object is provenance, not payload.",
+      "additionalProperties": false,
+      "description": "The environment configuration frozen at session creation, enriched with\nthe saved environment's identity and how it was chosen.",
       "properties": {
-        "environment_id": {
+        "compute": {
+          "$ref": "#/$defs/ComputeConfig",
+          "default": {
+            "cpu": null,
+            "memory": null,
+            "timeout": null
+          }
+        },
+        "hooks": {
+          "$ref": "#/$defs/EnvironmentHooks",
+          "default": {
+            "after_checkout": null,
+            "before_start": null,
+            "build_base": null,
+            "post_clone": null,
+            "post_start": null
+          }
+        },
+        "id": {
           "anyOf": [
             {
               "type": "string"
@@ -8772,7 +9323,36 @@
           ],
           "default": null,
           "description": "Identifier of the saved environment the session's config resolved. Null for an inline environment block or the built-in basic sandbox.",
-          "title": "Environment Id"
+          "title": "Id"
+        },
+        "mcp_servers": {
+          "default": [],
+          "items": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "$ref": "#/$defs/McpServerRef"
+              },
+              {
+                "$ref": "#/$defs/McpStdioServer"
+              },
+              {
+                "$ref": "#/$defs/McpRemoteServer"
+              }
+            ]
+          },
+          "title": "Mcp Servers",
+          "type": "array"
+        },
+        "repositories": {
+          "default": [],
+          "items": {
+            "$ref": "#/$defs/RepositoryRef"
+          },
+          "title": "Repositories",
+          "type": "array"
         },
         "source": {
           "anyOf": [
@@ -8784,12 +9364,97 @@
             }
           ],
           "default": null,
-          "description": "How the environment was chosen (request, automation, platform_default; repo_default and account_default on sessions from before those ladders were removed). Null when the config carried its own inline environment."
+          "description": "How the environment was chosen (request, agent, platform_default; repo_default and account_default on sessions from before those ladders were removed). An inline request uses request; an inline environment declared in session configuration has no source."
+        },
+        "variables": {
+          "default": [],
+          "items": {
+            "$ref": "#/$defs/EnvironmentVariable"
+          },
+          "title": "Variables",
+          "type": "array"
         }
       },
+      "required": [
+        "compute",
+        "hooks",
+        "id",
+        "mcp_servers",
+        "repositories",
+        "source",
+        "variables"
+      ],
       "title": "SessionEnvironment",
       "type": "object"
     },
+    "SessionEventActor": {
+      "description": "The event's initiator, when known; never inferred from resource ownership.",
+      "properties": {
+        "avatar_url": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Avatar Url"
+        },
+        "is_bot": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Is Bot"
+        },
+        "name": {
+          "title": "Name",
+          "type": "string"
+        }
+      },
+      "required": [
+        "avatar_url",
+        "is_bot",
+        "name"
+      ],
+      "title": "SessionEventActor",
+      "type": "object"
+    },
+    "SessionExecutionResult": {
+      "description": "Outcome of the last finished execution, retained across subsequent resumes.\n\nAn execution spans a start or resume through parking or termination, and may\ncontain several turns. Admission failures also produce a result, even when\nprovisioning never starts.",
+      "properties": {
+        "completion_reason": {
+          "$ref": "#/$defs/SessionExitStatus",
+          "description": "Why the last execution ended; completed also includes parking an open conversation."
+        },
+        "detail": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Human-readable explanation of that outcome.",
+          "title": "Detail"
+        }
+      },
+      "required": [
+        "completion_reason",
+        "detail"
+      ],
+      "title": "SessionExecutionResult",
+      "type": "object"
+    },
     "SessionExitStatus": {
       "description": "Why a terminal agent session ended \u2014 a finer-grained reason than `status`.\n\n`status` (SessionStatus) is the lifecycle state: COMPLETED / ERROR /\nCANCELLED. `exit_status` explains *why* a run reached that terminal state, so\nthe UI and metrics can tell a budget cutoff apart from a crashed tool call or\na deliberate cancellation. It is None until the run reaches a terminal state.",
       "enum": [
@@ -8833,7 +9498,7 @@
       "type": "object"
     },
     "SessionGit": {
-      "description": "Every repo the session touched. Small enough to ride on `agent_sessions`\nand be returned by every session read.",
+      "description": "Every repo the session touched. Small enough to ride on `sessions`\nand be returned by every session read.",
       "properties": {
         "repos": {
           "default": [],
@@ -8844,6 +9509,9 @@
           "type": "array"
         }
       },
+      "required": [
+        "repos"
+      ],
       "title": "SessionGit",
       "type": "object"
     },
@@ -8869,10 +9537,10 @@
         }
       },
       "required": [
-        "sha",
-        "subject",
         "committed_at",
-        "pushed"
+        "pushed",
+        "sha",
+        "subject"
       ],
       "title": "SessionGitCommit",
       "type": "object"
@@ -8898,10 +9566,10 @@
         }
       },
       "required": [
-        "path",
-        "status",
         "additions",
-        "deletions"
+        "deletions",
+        "path",
+        "status"
       ],
       "title": "SessionGitFile",
       "type": "object"
@@ -8943,7 +9611,9 @@
         }
       },
       "required": [
+        "gh_pr_id",
         "number",
+        "title",
         "url"
       ],
       "title": "SessionGitPr",
@@ -9023,11 +9693,53 @@
         }
       },
       "required": [
-        "full_name"
+        "commits",
+        "commits_total",
+        "full_name",
+        "local_commit",
+        "local_uncommitted_files",
+        "prs",
+        "remote_branch",
+        "remote_commit"
       ],
       "title": "SessionGitRepo",
       "type": "object"
     },
+    "SessionHandler": {
+      "description": "The saved handler and its display name when the session started.",
+      "properties": {
+        "agent_name": {
+          "description": "The handler's effective display name when the session started: ellipsis.name, or the service default (Slack, GitHub, Linear, or sentry).",
+          "minLength": 1,
+          "title": "Agent Name",
+          "type": "string"
+        },
+        "id": {
+          "description": "Identifier of the saved handler.",
+          "minLength": 1,
+          "title": "Id",
+          "type": "string"
+        },
+        "service": {
+          "$ref": "#/$defs/HandlerService",
+          "description": "The service the handler responds to."
+        },
+        "sha": {
+          "description": "Content fingerprint of the validated handler configuration used when the session started. This is not the Git commit SHA.",
+          "minLength": 1,
+          "title": "Sha",
+          "type": "string"
+        }
+      },
+      "required": [
+        "agent_name",
+        "id",
+        "service",
+        "sha"
+      ],
+      "title": "SessionHandler",
+      "type": "object"
+    },
     "SessionIdlePayload": {
       "additionalProperties": true,
       "description": "session_idle \u2014 the warm loop ended and the durable conversation is\nparked; the next message wakes it.",
@@ -9037,19 +9749,6 @@
     },
     "SessionIdleRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -9202,10 +9901,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -9223,20 +9934,114 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
+      ],
+      "title": "SessionIdleRecord",
+      "type": "object",
+      "x-ellipsis-preserve-payload": true
+    },
+    "SessionLifecycle": {
+      "description": "Current activity, conversation state, messaging policy, and lifecycle history.",
+      "properties": {
+        "archived": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionArchived"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "When and by whom the session was archived; null when unarchived. Archiving does not stop or close a session."
+        },
+        "conversation": {
+          "$ref": "#/$defs/ConversationState",
+          "description": "Whether the conversation is open or permanently closed. Open does not imply direct messages are permitted."
+        },
+        "detail": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Explanation of the current status, when applicable.",
+          "title": "Detail"
+        },
+        "interactive": {
+          "description": "Whether the session stays open after its first turn.",
+          "title": "Interactive",
+          "type": "boolean"
+        },
+        "last_execution_result": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionExecutionResult"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The last finished execution's outcome, retained across resumes; null until an outcome has been recorded."
+        },
+        "prompting": {
+          "$ref": "#/$defs/SessionPrompting",
+          "description": "The session's policy for direct messages. Caller authorization and message validation are checked separately."
+        },
+        "status": {
+          "$ref": "#/$defs/SessionLifecycleStatus",
+          "description": "Canonical current activity. working means a turn is in progress; waiting means the worker is warm and awaiting input; idle means parked. A failed, stopped, or cancelled execution may leave an open conversation."
+        },
+        "stopped": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionStopped"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "When and by whom a stop was requested; null when no stop is pending for this execution."
+        },
+        "timestamps": {
+          "$ref": "#/$defs/SessionTimestamps"
+        }
+      },
+      "required": [
+        "archived",
+        "conversation",
+        "detail",
+        "interactive",
+        "last_execution_result",
+        "prompting",
+        "status",
+        "stopped",
+        "timestamps"
       ],
-      "title": "SessionIdleRecord",
-      "type": "object",
-      "x-ellipsis-preserve-payload": true
+      "title": "SessionLifecycle",
+      "type": "object"
     },
-    "SessionLiveness": {
-      "description": "The durable conversation axis (backs the surfaced `session` field).",
+    "SessionLifecycleStatus": {
       "enum": [
-        "alive",
+        "scheduled",
+        "starting",
+        "working",
+        "waiting",
+        "retrying",
         "idle",
-        "closed"
+        "closed",
+        "failed",
+        "stopped",
+        "cancelled"
       ],
-      "title": "SessionLiveness",
+      "title": "SessionLifecycleStatus",
       "type": "string"
     },
     "SessionMessage": {
@@ -9407,33 +10212,8 @@
       "type": "string"
     },
     "SessionParent": {
-      "description": "The ONE \"preceded-by\" chain: the predecessor session and how this one\nrelates to it. Not a parent that orchestrates children \u2014 a session never\nspawns sub-sessions.",
+      "description": "The predecessor session this session continues.",
       "properties": {
-        "kind": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/ParentKind"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "How this session relates to its parent session, if any."
-        },
-        "replayed_from_session_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Identifier of the original session this one was replayed from, if it was started via replay.",
-          "title": "Replayed From Session Id"
-        },
         "session_id": {
           "anyOf": [
             {
@@ -9444,10 +10224,13 @@
             }
           ],
           "default": null,
-          "description": "Identifier of the parent session that spawned this one, if any.",
+          "description": "Identifier of the predecessor session this session continues, if any.",
           "title": "Session Id"
         }
       },
+      "required": [
+        "session_id"
+      ],
       "title": "SessionParent",
       "type": "object"
     },
@@ -9495,7 +10278,10 @@
         }
       },
       "required": [
-        "enabled"
+        "blocked_reason",
+        "detail",
+        "enabled",
+        "surface_name"
       ],
       "title": "SessionPrompting",
       "type": "object"
@@ -9539,19 +10325,6 @@
     },
     "SessionResumedRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -9704,10 +10477,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -9725,7 +10510,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "SessionResumedRecord",
       "type": "object",
@@ -9753,19 +10539,6 @@
     },
     "SessionRetryingRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -9918,10 +10691,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -9939,7 +10724,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "SessionRetryingRecord",
       "type": "object",
@@ -9986,19 +10772,6 @@
     },
     "SessionScheduledRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -10151,10 +10924,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -10172,7 +10957,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "SessionScheduledRecord",
       "type": "object",
@@ -10213,19 +10999,6 @@
     },
     "SessionStartingRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -10378,10 +11151,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -10399,67 +11184,23 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "SessionStartingRecord",
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
-    "SessionState": {
-      "description": "Lifecycle of a keyed (multi-turn) session \u2014 the durable conversation.\nDistinct from SessionStatus, which is per-execution (one turn's run) and\nmoves to agent_turns in a later slice. IDLE: alive, waiting for the next\nmessage. RUNNING: a turn is executing. CLOSED: the conversation is done and\nits sandbox/snapshots are torn down.",
-      "enum": [
-        "idle",
-        "running",
-        "closed"
-      ],
-      "title": "SessionState",
-      "type": "string"
-    },
-    "SessionStatus": {
-      "enum": [
-        "scheduled",
-        "creating_sandbox",
-        "running",
-        "retrying",
-        "completed",
-        "error",
-        "cancelled",
-        "stopped"
-      ],
-      "title": "SessionStatus",
-      "type": "string"
-    },
     "SessionStopped": {
-      "description": "The stop request, if there was one: when, by which GitHub account id,\nand that account resolved to a display snippet.",
+      "description": "When a stop was requested and the GitHub user who requested it.",
       "properties": {
         "at": {
-          "anyOf": [
-            {
-              "format": "date-time",
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "When a stop was requested, if one was.",
-          "title": "At"
+          "description": "When a stop was requested.",
+          "format": "date-time",
+          "title": "At",
+          "type": "string"
         },
         "by": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "GitHub account id of the user who stopped the session, if known.",
-          "title": "By"
-        },
-        "by_user": {
           "anyOf": [
             {
               "$ref": "#/$defs/GithubAccountSnippet"
@@ -10469,9 +11210,13 @@
             }
           ],
           "default": null,
-          "description": "The GitHub user who stopped the session, resolved at read time."
+          "description": "The GitHub user who stopped the session, resolved at read time. Null if the user is unknown or unavailable."
         }
       },
+      "required": [
+        "at",
+        "by"
+      ],
       "title": "SessionStopped",
       "type": "object"
     },
@@ -10499,52 +11244,62 @@
         }
       },
       "required": [
+        "created_at",
         "description"
       ],
       "title": "SessionSummary",
       "type": "object"
     },
-    "SessionSurface": {
-      "description": "The three fields we expose.\n\n`use_enum_values=True` (from CustomBaseModel) stores the members as their\nstring values, so this serializes to `{\"session\": \"alive\", \"run\": \"waiting\",\n\"status\": \"waiting\"}` \u2014 a plain object, not enum names.",
+    "SessionTimestamps": {
       "properties": {
-        "run": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/RunStatus"
-            },
-            {
-              "type": "null"
-            }
-          ]
+        "created_at": {
+          "description": "When the session was created.",
+          "format": "date-time",
+          "title": "Created At",
+          "type": "string"
         },
-        "session": {
+        "last_activity_at": {
           "anyOf": [
             {
-              "$ref": "#/$defs/SessionLiveness"
+              "format": "date-time",
+              "type": "string"
             },
             {
               "type": "null"
             }
-          ]
+          ],
+          "default": null,
+          "description": "When the session last showed agent activity.",
+          "title": "Last Activity At"
         },
-        "status": {
+        "last_message_at": {
           "anyOf": [
             {
+              "format": "date-time",
               "type": "string"
             },
             {
               "type": "null"
             }
           ],
-          "title": "Status"
+          "default": null,
+          "description": "When the session last received a message.",
+          "title": "Last Message At"
+        },
+        "updated_at": {
+          "description": "When the session was last updated.",
+          "format": "date-time",
+          "title": "Updated At",
+          "type": "string"
         }
       },
       "required": [
-        "session",
-        "run",
-        "status"
+        "created_at",
+        "last_activity_at",
+        "last_message_at",
+        "updated_at"
       ],
-      "title": "SessionSurface",
+      "title": "SessionTimestamps",
       "type": "object"
     },
     "SessionTokens": {
@@ -10587,84 +11342,89 @@
           "type": "integer"
         }
       },
+      "required": [
+        "cache_creation",
+        "cache_read",
+        "input",
+        "model",
+        "output",
+        "total"
+      ],
       "title": "SessionTokens",
-      "type": "object"
-    },
-    "SessionTrigger": {
-      "description": "The external event that started a session, without raw webhook payloads.",
-      "properties": {
-        "action": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Action"
-        },
-        "actor": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/SessionTriggerActor"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null
-        },
-        "branch": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Branch"
+      "type": "object"
+    },
+    "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.",
+      "properties": {
+        "path": {
+          "title": "Path",
+          "type": "string"
         },
-        "number": {
+        "repository": {
           "anyOf": [
             {
-              "type": "integer"
+              "$ref": "#/$defs/RepositoryRef"
             },
             {
               "type": "null"
             }
           ],
-          "default": null,
-          "title": "Number"
+          "default": null
+        }
+      },
+      "required": [
+        "path",
+        "repository"
+      ],
+      "title": "SettingsRef",
+      "type": "object"
+    },
+    "SkillRef": {
+      "additionalProperties": false,
+      "description": "A repository directory containing SKILL.md and supporting UTF-8 files.\nResolved at run start and installed in the selected harness's skill directory.\nExplicit skill references require a model with the skills capability.",
+      "properties": {
+        "path": {
+          "title": "Path",
+          "type": "string"
         },
         "repository": {
           "anyOf": [
             {
-              "type": "string"
+              "$ref": "#/$defs/RepositoryRef"
             },
             {
               "type": "null"
             }
           ],
-          "default": null,
-          "title": "Repository"
-        },
-        "surface": {
+          "default": null
+        }
+      },
+      "required": [
+        "path",
+        "repository"
+      ],
+      "title": "SkillRef",
+      "type": "object"
+    },
+    "SlackChannelCreatedEvent": {
+      "properties": {
+        "actor": {
           "anyOf": [
             {
-              "type": "string"
+              "$ref": "#/$defs/SessionEventActor"
             },
             {
               "type": "null"
             }
           ],
-          "default": null,
-          "title": "Surface"
+          "default": null
         },
-        "title": {
+        "channel_id": {
+          "title": "Channel Id",
+          "type": "string"
+        },
+        "channel_name": {
           "anyOf": [
             {
               "type": "string"
@@ -10674,104 +11434,104 @@
             }
           ],
           "default": null,
-          "title": "Title"
+          "title": "Channel Name"
+        },
+        "type": {
+          "const": "slack.channel_created",
+          "default": "slack.channel_created",
+          "title": "Type",
+          "type": "string"
         },
         "url": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Url"
+          "title": "Url",
+          "type": "string"
         }
       },
-      "title": "SessionTrigger",
+      "required": [
+        "actor",
+        "channel_id",
+        "channel_name",
+        "type",
+        "url"
+      ],
+      "title": "SlackChannelCreatedEvent",
       "type": "object"
     },
-    "SessionTriggerActor": {
+    "SlackMessageEvent": {
       "properties": {
-        "avatar_url": {
+        "action": {
+          "enum": [
+            "message",
+            "app_mention"
+          ],
+          "title": "Action",
+          "type": "string"
+        },
+        "actor": {
           "anyOf": [
             {
-              "type": "string"
+              "$ref": "#/$defs/SessionEventActor"
             },
             {
               "type": "null"
             }
           ],
-          "default": null,
-          "title": "Avatar Url"
-        },
-        "is_bot": {
-          "default": false,
-          "title": "Is Bot",
-          "type": "boolean"
+          "default": null
         },
-        "name": {
-          "title": "Name",
-          "type": "string"
-        }
-      },
-      "required": [
-        "name"
-      ],
-      "title": "SessionTriggerActor",
-      "type": "object"
-    },
-    "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.",
-      "properties": {
-        "path": {
-          "title": "Path",
+        "channel_id": {
+          "title": "Channel Id",
           "type": "string"
         },
-        "repository": {
+        "channel_name": {
           "anyOf": [
             {
-              "$ref": "#/$defs/RepositoryRef"
+              "type": "string"
             },
             {
               "type": "null"
             }
           ],
-          "default": null
-        }
-      },
-      "required": [
-        "path"
-      ],
-      "title": "SettingsRef",
-      "type": "object"
-    },
-    "SkillRef": {
-      "additionalProperties": false,
-      "description": "A repository directory containing SKILL.md and supporting UTF-8 files.\nResolved at run start and installed in the selected harness's skill directory.\nExplicit skill references require a model with the skills capability.",
-      "properties": {
-        "path": {
-          "title": "Path",
+          "default": null,
+          "title": "Channel Name"
+        },
+        "message_ts": {
+          "title": "Message Ts",
           "type": "string"
         },
-        "repository": {
+        "thread_ts": {
           "anyOf": [
             {
-              "$ref": "#/$defs/RepositoryRef"
+              "type": "string"
             },
             {
               "type": "null"
             }
           ],
-          "default": null
+          "default": null,
+          "title": "Thread Ts"
+        },
+        "type": {
+          "const": "slack.message",
+          "default": "slack.message",
+          "title": "Type",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
         }
       },
       "required": [
-        "path"
+        "action",
+        "actor",
+        "channel_id",
+        "channel_name",
+        "message_ts",
+        "thread_ts",
+        "type",
+        "url"
       ],
-      "title": "SkillRef",
+      "title": "SlackMessageEvent",
       "type": "object"
     },
     "SnapshotFrame": {
@@ -10798,7 +11558,7 @@
           "type": "array"
         },
         "protocol": {
-          "default": 4,
+          "default": 6,
           "description": "Echoes the protocol version the server is serving.",
           "title": "Protocol",
           "type": "integer"
@@ -10824,31 +11584,6 @@
       "title": "SnapshotFrame",
       "type": "object"
     },
-    "SystemFileRef": {
-      "additionalProperties": false,
-      "properties": {
-        "file": {
-          "title": "File",
-          "type": "string"
-        },
-        "repository": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/RepositoryRef"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null
-        }
-      },
-      "required": [
-        "file"
-      ],
-      "title": "SystemFileRef",
-      "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 execution/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 lives on\n`execution.model_usage` (CC's modelUsage, verbatim).",
@@ -10921,19 +11656,6 @@
     },
     "TurnCompletedRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -11086,10 +11808,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -11107,7 +11841,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "TurnCompletedRecord",
       "type": "object",
@@ -11135,19 +11870,6 @@
     },
     "TurnFailedRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -11300,10 +12022,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -11321,7 +12055,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "TurnFailedRecord",
       "type": "object",
@@ -11349,19 +12084,6 @@
     },
     "TurnStartedRecord": {
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -11514,10 +12236,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -11535,7 +12269,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "TurnStartedRecord",
       "type": "object",
@@ -11544,19 +12279,6 @@
     "UnknownSessionRecord": {
       "description": "Unrecognized or unparseable payload; the complete original stays readable.",
       "properties": {
-        "agent_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Agent Turn Id"
-        },
         "cost": {
           "anyOf": [
             {
@@ -11708,10 +12430,22 @@
           ],
           "default": null,
           "title": "Tools"
+        },
+        "turn_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Turn containing this record, when applicable.",
+          "title": "Turn Id"
         }
       },
       "required": [
-        "agent_turn_id",
         "cost",
         "created_at",
         "duration",
@@ -11729,7 +12463,8 @@
         "source",
         "stream_seq",
         "tokens_info",
-        "tools"
+        "tools",
+        "turn_id"
       ],
       "title": "UnknownSessionRecord",
       "type": "object",
@@ -11737,7 +12472,7 @@
     }
   },
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "description": "One server-to-client frame of the Ellipsis session stream protocol v4 (WS /v1/sessions/{id}/stream?protocol=4). 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 v6 (WS /v1/sessions/{id}/stream?protocol=6). Clients MUST ignore frames with unknown `type` values \u2014 additive frames are not a protocol break.",
   "oneOf": [
     {
       "$ref": "#/$defs/SnapshotFrame"