@ellipsis-dev/sdk 0.35.0 → 0.37.0

package/schema/frames.schema.json

@@ -466,7 +466,7 @@
             }
           ],
           "default": null,
-          "description": "The initial user message, passed verbatim. Omit to start an interactive session with no turn, waiting for a message.",
+          "description": "The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.",
           "title": "Prompt"
         },
         "settings": {
@@ -585,6 +585,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -647,19 +660,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "claude_code",
           "default": "claude_code",
@@ -691,19 +691,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -713,16 +700,15 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "ClaudeNativeSessionRecord",
       "type": "object",
@@ -1091,6 +1077,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -1149,19 +1148,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "claude_code",
           "default": "claude_code",
@@ -1193,19 +1179,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -1215,16 +1188,15 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "ClaudeSessionRecord",
       "type": "object",
@@ -1503,12 +1475,14 @@
       "discriminator": {
         "mapping": {
           "agentMessage": "#/$defs/CodexAgentMessage",
+          "collabAgentToolCall": "#/$defs/CodexCollabAgentToolCall",
           "commandExecution": "#/$defs/CodexCommandExecution",
           "contextCompaction": "#/$defs/CodexContextCompaction",
           "fileChange": "#/$defs/CodexFileChange",
           "mcpToolCall": "#/$defs/CodexMcpToolCall",
           "plan": "#/$defs/CodexPlan",
           "reasoning": "#/$defs/CodexReasoning",
+          "subAgentActivity": "#/$defs/CodexSubAgentActivity",
           "userMessage": "#/$defs/CodexUserMessage",
           "webSearch": "#/$defs/CodexWebSearch"
         },
@@ -1541,6 +1515,12 @@
         },
         {
           "$ref": "#/$defs/CodexContextCompaction"
+        },
+        {
+          "$ref": "#/$defs/CodexSubAgentActivity"
+        },
+        {
+          "$ref": "#/$defs/CodexCollabAgentToolCall"
         }
       ]
     },
@@ -1628,6 +1608,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -1659,19 +1652,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "codex",
           "default": "codex",
@@ -1703,19 +1683,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -1725,21 +1692,81 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "CodexAppServerSessionRecord",
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
+    "CodexCollabAgentToolCall": {
+      "additionalProperties": true,
+      "properties": {
+        "id": {
+          "title": "Id",
+          "type": "string"
+        },
+        "prompt": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Prompt"
+        },
+        "receiverThreadIds": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Receiverthreadids",
+          "type": "array"
+        },
+        "senderThreadId": {
+          "title": "Senderthreadid",
+          "type": "string"
+        },
+        "status": {
+          "enum": [
+            "inProgress",
+            "completed",
+            "failed"
+          ],
+          "title": "Status",
+          "type": "string"
+        },
+        "tool": {
+          "title": "Tool",
+          "type": "string"
+        },
+        "type": {
+          "const": "collabAgentToolCall",
+          "default": "collabAgentToolCall",
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "receiverThreadIds",
+        "senderThreadId",
+        "status",
+        "tool",
+        "type"
+      ],
+      "title": "CodexCollabAgentToolCall",
+      "type": "object"
+    },
     "CodexCommandExecution": {
       "additionalProperties": true,
       "properties": {
@@ -1922,7 +1949,7 @@
             }
           ],
           "default": null,
-          "description": "Reasoning effort for every turn. Omit to use the model default."
+          "description": "Reasoning effort for every message. Omit to use the model default."
         },
         "model": {
           "description": "The model the session runs on: a Responses-capable id from the models table. Required.",
@@ -1939,7 +1966,7 @@
             }
           ],
           "default": null,
-          "description": "The initial user message, passed verbatim. Omit to start an interactive session with no turn, waiting for a message.",
+          "description": "The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.",
           "title": "Prompt"
         }
       },
@@ -2919,6 +2946,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -2989,19 +3029,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "codex",
           "default": "codex",
@@ -3033,19 +3060,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -3055,21 +3069,64 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "CodexSessionRecord",
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
+    "CodexSubAgentActivity": {
+      "additionalProperties": true,
+      "description": "A subagent's spawn or completion, recorded on the spawning thread.",
+      "properties": {
+        "agentPath": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Agentpath"
+        },
+        "agentThreadId": {
+          "title": "Agentthreadid",
+          "type": "string"
+        },
+        "id": {
+          "title": "Id",
+          "type": "string"
+        },
+        "kind": {
+          "title": "Kind",
+          "type": "string"
+        },
+        "type": {
+          "const": "subAgentActivity",
+          "default": "subAgentActivity",
+          "title": "Type",
+          "type": "string"
+        }
+      },
+      "required": [
+        "agentThreadId",
+        "id",
+        "kind",
+        "type"
+      ],
+      "title": "CodexSubAgentActivity",
+      "type": "object"
+    },
     "CodexTextInput": {
       "additionalProperties": true,
       "properties": {
@@ -3908,33 +3965,33 @@
           "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": {
+        "message_id": {
           "anyOf": [
             {
-              "type": "integer"
+              "type": "string"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "description": "Output tokens generated so far for the current response.",
-          "title": "Output Tokens"
+          "description": "Identifier of the message being answered, if known.",
+          "title": "Message Id"
         },
-        "text": {
+        "output_tokens": {
           "anyOf": [
             {
-              "type": "string"
+              "type": "integer"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "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"
+          "description": "Output tokens generated so far for the current response.",
+          "title": "Output Tokens"
         },
-        "turn_id": {
+        "text": {
           "anyOf": [
             {
               "type": "string"
@@ -3944,8 +4001,8 @@
             }
           ],
           "default": null,
-          "description": "Identifier of the turn the delta belongs to, if known.",
-          "title": "Turn Id"
+          "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"
         },
         "type": {
           "const": "delta",
@@ -3956,30 +4013,14 @@
       },
       "required": [
         "kind",
+        "message_id",
         "output_tokens",
         "text",
-        "turn_id",
         "type"
       ],
       "title": "DeltaFrame",
       "type": "object"
     },
-    "DoneFrame": {
-      "description": "Terminal marker: the conversation is over, after the final session\nframe carried the end state. Followed by a normal close (1000).",
-      "properties": {
-        "type": {
-          "const": "done",
-          "default": "done",
-          "title": "Type",
-          "type": "string"
-        }
-      },
-      "required": [
-        "type"
-      ],
-      "title": "DoneFrame",
-      "type": "object"
-    },
     "Duration": {
       "additionalProperties": false,
       "description": "A duration as explicit units, summed. Set any of `hours`/`minutes`/\n`seconds` (at least one). The alternative to the `30m`-style shorthand\nstring wherever a duration is accepted.",
@@ -4317,7 +4358,7 @@
     },
     "EnvironmentOutputPayload": {
       "additionalProperties": true,
-      "description": "environment_output: one chunk of output from preparing the environment,\nincluding the customer's own hooks. Many fire per turn; `chunk` orders them\nwithin a step.",
+      "description": "environment_output: one chunk of output from preparing the environment,\nincluding the customer's own hooks. Many fire per message; `chunk` orders\nthem within a step.",
       "properties": {
         "chunk": {
           "title": "Chunk",
@@ -4407,7 +4448,7 @@
           "title": "Kind",
           "type": "string"
         },
-        "model": {
+        "message_id": {
           "anyOf": [
             {
               "type": "string"
@@ -4417,9 +4458,22 @@
             }
           ],
           "default": null,
-          "title": "Model"
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
         },
-        "payload": {
+        "model": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Model"
+        },
+        "payload": {
           "$ref": "#/$defs/EnvironmentOutputPayload"
         },
         "record_format": {
@@ -4439,19 +4493,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "lifecycle",
           "default": "lifecycle",
@@ -4483,19 +4524,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -4505,16 +4533,15 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "EnvironmentOutputRecord",
       "type": "object",
@@ -4624,6 +4651,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -4656,19 +4696,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "lifecycle",
           "default": "lifecycle",
@@ -4700,19 +4727,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -4722,16 +4736,15 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "EnvironmentPhaseRecord",
       "type": "object",
@@ -4814,6 +4827,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -4846,19 +4872,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "lifecycle",
           "default": "lifecycle",
@@ -4890,19 +4903,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -4912,16 +4912,15 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "EnvironmentReadyRecord",
       "type": "object",
@@ -5006,6 +5005,30 @@
       "title": "ErrorFrame",
       "type": "object"
     },
+    "ErrorReason": {
+      "description": "Why a message failed, was stopped, or was cancelled.",
+      "enum": [
+        "error",
+        "tool_call_failed",
+        "budget_hit",
+        "payment_required",
+        "blocked",
+        "contact_email_required",
+        "lifecycle_hook_failed",
+        "missing_repo_access",
+        "missing_token_permissions",
+        "missing_environment_variables",
+        "missing_github_integration",
+        "agent_unavailable",
+        "upstream_unavailable",
+        "unsupported_configuration",
+        "execution_disabled",
+        "interrupted",
+        "stopped"
+      ],
+      "title": "ErrorReason",
+      "type": "string"
+    },
     "GeminiConfig": {
       "additionalProperties": false,
       "description": "Native options supported by the current Gemini CLI adapter.",
@@ -5025,7 +5048,7 @@
             }
           ],
           "default": null,
-          "description": "The initial user message, passed verbatim. Omit to start an interactive session with no turn, waiting for a message.",
+          "description": "The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.",
           "title": "Prompt"
         }
       },
@@ -5284,6 +5307,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -5315,19 +5351,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "gemini",
           "default": "gemini",
@@ -5359,19 +5382,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -5381,16 +5391,15 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "GeminiSessionRecord",
       "type": "object",
@@ -7058,27 +7067,56 @@
       "title": "MemorySize",
       "type": "object"
     },
-    "MessageDeliveredPayload": {
+    "MessageEndedPayload": {
       "additionalProperties": true,
-      "description": "message_delivered: the agent started on the message.",
+      "description": "message_ended: the message was answered, or its answer failed, was\nstopped, or was cancelled. `error` is the same object as the session's\n`error`, null when the message was answered. `cost` and `tokens` are what\nanswering it spent. Messages answered together report the spend once, on\nthe last of them.",
       "properties": {
+        "cost": {
+          "$ref": "#/$defs/Cost"
+        },
+        "duration_ms": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Duration Ms"
+        },
+        "error": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionError"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
         "message_id": {
           "title": "Message Id",
           "type": "string"
         },
-        "turn_id": {
-          "title": "Turn Id",
+        "status": {
+          "title": "Status",
           "type": "string"
+        },
+        "tokens": {
+          "$ref": "#/$defs/Tokens"
         }
       },
       "required": [
         "message_id",
-        "turn_id"
+        "status"
       ],
-      "title": "MessageDeliveredPayload",
+      "title": "MessageEndedPayload",
       "type": "object"
     },
-    "MessageDeliveredRecord": {
+    "MessageEndedRecord": {
       "properties": {
         "cost": {
           "anyOf": [
@@ -7125,6 +7163,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -7138,7 +7189,7 @@
           "title": "Model"
         },
         "payload": {
-          "$ref": "#/$defs/MessageDeliveredPayload"
+          "$ref": "#/$defs/MessageEndedPayload"
         },
         "record_format": {
           "const": "ellipsis_lifecycle@1",
@@ -7147,8 +7198,8 @@
           "type": "string"
         },
         "record_type": {
-          "const": "message_delivered",
-          "default": "message_delivered",
+          "const": "message_ended",
+          "default": "message_ended",
           "title": "Record Type",
           "type": "string"
         },
@@ -7157,19 +7208,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "lifecycle",
           "default": "lifecycle",
@@ -7201,19 +7239,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -7223,63 +7248,93 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
-      "title": "MessageDeliveredRecord",
+      "title": "MessageEndedRecord",
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
-    "MessageReceivedPayload": {
+    "MessageQueuedPayload": {
       "additionalProperties": true,
-      "description": "message_received: a message landed in the session inbox and its turn was\ncreated. `turn_id` is the turn that will answer it.",
+      "description": "message_queued: the message waits because the account already has\n`sessions_alive` sessions alive, its limit.",
       "properties": {
-        "author": {
+        "limit": {
+          "title": "Limit",
+          "type": "integer"
+        },
+        "message_id": {
+          "title": "Message Id",
+          "type": "string"
+        },
+        "sessions_alive": {
+          "title": "Sessions Alive",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "message_id",
+        "sessions_alive",
+        "limit"
+      ],
+      "title": "MessageQueuedPayload",
+      "type": "object"
+    },
+    "MessageQueuedRecord": {
+      "properties": {
+        "cost": {
           "anyOf": [
             {
-              "type": "string"
+              "type": "integer"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "title": "Author"
-        },
-        "body": {
-          "title": "Body",
-          "type": "string"
-        },
-        "closes_session": {
-          "default": false,
-          "title": "Closes Session",
-          "type": "boolean"
+          "title": "Cost"
         },
-        "message_id": {
-          "title": "Message Id",
+        "created_at": {
+          "format": "date-time",
+          "title": "Created At",
           "type": "string"
         },
-        "sender_attribution_id": {
+        "duration": {
           "anyOf": [
             {
-              "type": "string"
+              "type": "integer"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "title": "Sender Attribution Id"
+          "title": "Duration"
         },
-        "sender_attribution_type": {
+        "feed_seq": {
+          "description": "Position in the session feed and the stream's resume cursor.",
+          "title": "Feed Seq",
+          "type": "integer"
+        },
+        "id": {
+          "description": "Unique identifier of the record.",
+          "title": "Id",
+          "type": "string"
+        },
+        "kind": {
+          "const": "platform",
+          "default": "platform",
+          "title": "Kind",
+          "type": "string"
+        },
+        "message_id": {
           "anyOf": [
             {
               "type": "string"
@@ -7289,9 +7344,10 @@
             }
           ],
           "default": null,
-          "title": "Sender Attribution Type"
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
         },
-        "turn_id": {
+        "model": {
           "anyOf": [
             {
               "type": "string"
@@ -7301,17 +7357,83 @@
             }
           ],
           "default": null,
-          "title": "Turn Id"
+          "title": "Model"
+        },
+        "payload": {
+          "$ref": "#/$defs/MessageQueuedPayload"
+        },
+        "record_format": {
+          "const": "ellipsis_lifecycle@1",
+          "default": "ellipsis_lifecycle@1",
+          "title": "Record Format",
+          "type": "string"
+        },
+        "record_type": {
+          "const": "message_queued",
+          "default": "message_queued",
+          "title": "Record Type",
+          "type": "string"
+        },
+        "session_id": {
+          "description": "Session containing this record.",
+          "title": "Session Id",
+          "type": "string"
+        },
+        "source": {
+          "const": "lifecycle",
+          "default": "lifecycle",
+          "title": "Source",
+          "type": "string"
+        },
+        "tokens_info": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/TokensInfo"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "tools": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Tools"
         }
       },
       "required": [
+        "cost",
+        "created_at",
+        "duration",
+        "feed_seq",
+        "id",
+        "kind",
         "message_id",
-        "body"
+        "model",
+        "payload",
+        "record_format",
+        "record_type",
+        "session_id",
+        "source",
+        "tokens_info",
+        "tools"
       ],
-      "title": "MessageReceivedPayload",
-      "type": "object"
+      "title": "MessageQueuedRecord",
+      "type": "object",
+      "x-ellipsis-preserve-payload": true
     },
-    "MessageReceivedRecord": {
+    "MessageRecord": {
       "properties": {
         "cost": {
           "anyOf": [
@@ -7358,6 +7480,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -7371,7 +7506,7 @@
           "title": "Model"
         },
         "payload": {
-          "$ref": "#/$defs/MessageReceivedPayload"
+          "$ref": "#/$defs/SessionMessage"
         },
         "record_format": {
           "const": "ellipsis_lifecycle@1",
@@ -7380,8 +7515,8 @@
           "type": "string"
         },
         "record_type": {
-          "const": "message_received",
-          "default": "message_received",
+          "const": "message",
+          "default": "message",
           "title": "Record Type",
           "type": "string"
         },
@@ -7390,19 +7525,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "lifecycle",
           "default": "lifecycle",
@@ -7434,19 +7556,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -7456,49 +7565,31 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
-      "title": "MessageReceivedRecord",
+      "title": "MessageRecord",
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
     "MessageRequeuedPayload": {
       "additionalProperties": true,
-      "description": "message_requeued: a turn was interrupted before answering, so the\nmessage goes back to the inbox with a new queued turn.",
+      "description": "message_requeued: the agent was interrupted before answering, so the\nmessage goes back to the inbox and starts again on a fresh environment.",
       "properties": {
         "message_id": {
           "title": "Message Id",
           "type": "string"
-        },
-        "requeued_turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Requeued Turn Id"
-        },
-        "turn_id": {
-          "title": "Turn Id",
-          "type": "string"
         }
       },
       "required": [
-        "message_id",
-        "turn_id"
+        "message_id"
       ],
       "title": "MessageRequeuedPayload",
       "type": "object"
@@ -7550,6 +7641,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -7582,19 +7686,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "lifecycle",
           "default": "lifecycle",
@@ -7626,19 +7717,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -7648,88 +7726,248 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "MessageRequeuedRecord",
       "type": "object",
       "x-ellipsis-preserve-payload": true
     },
-    "ModelLlmCostSplit": {
-      "description": "What one model's tokens cost, in millicents, split by who paid.",
+    "MessageStartedPayload": {
+      "additionalProperties": true,
+      "description": "message_started: the agent started on the message.",
       "properties": {
-        "claude_subscription": {
-          "default": 0,
-          "description": "Token cost paid by a Claude subscription, at Ellipsis rates, in millicents.",
-          "title": "Claude Subscription",
-          "type": "integer"
-        },
-        "codex_subscription": {
-          "default": 0,
-          "description": "Token cost paid by a Codex subscription, at Ellipsis rates, in millicents.",
-          "title": "Codex Subscription",
-          "type": "integer"
-        },
-        "model": {
-          "description": "The model that used these tokens.",
-          "title": "Model",
+        "message_id": {
+          "title": "Message Id",
           "type": "string"
-        },
-        "platform": {
-          "default": 0,
-          "description": "Token cost charged to Ellipsis credit, in millicents.",
-          "title": "Platform",
-          "type": "integer"
-        },
-        "total": {
-          "default": 0,
-          "description": "All token cost, in millicents. It is the sum of platform, claude_subscription, and codex_subscription.",
-          "title": "Total",
-          "type": "integer"
         }
       },
       "required": [
-        "claude_subscription",
-        "codex_subscription",
-        "model",
-        "platform",
-        "total"
+        "message_id"
       ],
-      "title": "ModelLlmCostSplit",
+      "title": "MessageStartedPayload",
       "type": "object"
     },
-    "ModelTokenCounts": {
-      "description": "Token counts for one model.",
+    "MessageStartedRecord": {
       "properties": {
-        "cache_creation": {
-          "default": 0,
-          "description": "Tokens written to the prompt cache.",
-          "title": "Cache Creation",
-          "type": "integer"
+        "cost": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Cost"
         },
-        "cache_read": {
-          "default": 0,
-          "description": "Tokens read from the prompt cache.",
-          "title": "Cache Read",
-          "type": "integer"
+        "created_at": {
+          "format": "date-time",
+          "title": "Created At",
+          "type": "string"
         },
-        "input": {
-          "default": 0,
-          "description": "Input tokens used.",
-          "title": "Input",
+        "duration": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Duration"
+        },
+        "feed_seq": {
+          "description": "Position in the session feed and the stream's resume cursor.",
+          "title": "Feed Seq",
           "type": "integer"
         },
-        "model": {
-          "description": "The model that used these tokens.",
-          "title": "Model",
+        "id": {
+          "description": "Unique identifier of the record.",
+          "title": "Id",
+          "type": "string"
+        },
+        "kind": {
+          "const": "platform",
+          "default": "platform",
+          "title": "Kind",
+          "type": "string"
+        },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
+        "model": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Model"
+        },
+        "payload": {
+          "$ref": "#/$defs/MessageStartedPayload"
+        },
+        "record_format": {
+          "const": "ellipsis_lifecycle@1",
+          "default": "ellipsis_lifecycle@1",
+          "title": "Record Format",
+          "type": "string"
+        },
+        "record_type": {
+          "const": "message_started",
+          "default": "message_started",
+          "title": "Record Type",
+          "type": "string"
+        },
+        "session_id": {
+          "description": "Session containing this record.",
+          "title": "Session Id",
+          "type": "string"
+        },
+        "source": {
+          "const": "lifecycle",
+          "default": "lifecycle",
+          "title": "Source",
+          "type": "string"
+        },
+        "tokens_info": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/TokensInfo"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "tools": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Tools"
+        }
+      },
+      "required": [
+        "cost",
+        "created_at",
+        "duration",
+        "feed_seq",
+        "id",
+        "kind",
+        "message_id",
+        "model",
+        "payload",
+        "record_format",
+        "record_type",
+        "session_id",
+        "source",
+        "tokens_info",
+        "tools"
+      ],
+      "title": "MessageStartedRecord",
+      "type": "object",
+      "x-ellipsis-preserve-payload": true
+    },
+    "ModelLlmCostSplit": {
+      "description": "What one model's tokens cost, in millicents, split by who paid.",
+      "properties": {
+        "claude_subscription": {
+          "default": 0,
+          "description": "Token cost paid by a Claude subscription, at Ellipsis rates, in millicents.",
+          "title": "Claude Subscription",
+          "type": "integer"
+        },
+        "codex_subscription": {
+          "default": 0,
+          "description": "Token cost paid by a Codex subscription, at Ellipsis rates, in millicents.",
+          "title": "Codex Subscription",
+          "type": "integer"
+        },
+        "model": {
+          "description": "The model that used these tokens.",
+          "title": "Model",
+          "type": "string"
+        },
+        "platform": {
+          "default": 0,
+          "description": "Token cost charged to Ellipsis credit, in millicents.",
+          "title": "Platform",
+          "type": "integer"
+        },
+        "total": {
+          "default": 0,
+          "description": "All token cost, in millicents. It is the sum of platform, claude_subscription, and codex_subscription.",
+          "title": "Total",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "claude_subscription",
+        "codex_subscription",
+        "model",
+        "platform",
+        "total"
+      ],
+      "title": "ModelLlmCostSplit",
+      "type": "object"
+    },
+    "ModelTokenCounts": {
+      "description": "Token counts for one model.",
+      "properties": {
+        "cache_creation": {
+          "default": 0,
+          "description": "Tokens written to the prompt cache.",
+          "title": "Cache Creation",
+          "type": "integer"
+        },
+        "cache_read": {
+          "default": 0,
+          "description": "Tokens read from the prompt cache.",
+          "title": "Cache Read",
+          "type": "integer"
+        },
+        "input": {
+          "default": 0,
+          "description": "Input tokens used.",
+          "title": "Input",
+          "type": "integer"
+        },
+        "model": {
+          "description": "The model that used these tokens.",
+          "title": "Model",
           "type": "string"
         },
         "output": {
@@ -7812,13 +8050,12 @@
           "environment_output": "#/$defs/EnvironmentOutputRecord",
           "environment_phase": "#/$defs/EnvironmentPhaseRecord",
           "environment_ready": "#/$defs/EnvironmentReadyRecord",
-          "message_delivered": "#/$defs/MessageDeliveredRecord",
-          "message_received": "#/$defs/MessageReceivedRecord",
+          "message": "#/$defs/MessageRecord",
+          "message_ended": "#/$defs/MessageEndedRecord",
+          "message_queued": "#/$defs/MessageQueuedRecord",
           "message_requeued": "#/$defs/MessageRequeuedRecord",
-          "session_closed": "#/$defs/SessionClosedRecord",
-          "turn_ended": "#/$defs/TurnEndedRecord",
-          "turn_queued": "#/$defs/TurnQueuedRecord",
-          "turn_started": "#/$defs/TurnStartedRecord"
+          "message_started": "#/$defs/MessageStartedRecord",
+          "session_closed": "#/$defs/SessionClosedRecord"
         },
         "propertyName": "record_type"
       },
@@ -7827,22 +8064,19 @@
           "$ref": "#/$defs/SessionClosedRecord"
         },
         {
-          "$ref": "#/$defs/MessageReceivedRecord"
+          "$ref": "#/$defs/MessageRecord"
         },
         {
-          "$ref": "#/$defs/MessageDeliveredRecord"
+          "$ref": "#/$defs/MessageQueuedRecord"
         },
         {
-          "$ref": "#/$defs/MessageRequeuedRecord"
-        },
-        {
-          "$ref": "#/$defs/TurnQueuedRecord"
+          "$ref": "#/$defs/MessageStartedRecord"
         },
         {
-          "$ref": "#/$defs/TurnStartedRecord"
+          "$ref": "#/$defs/MessageEndedRecord"
         },
         {
-          "$ref": "#/$defs/TurnEndedRecord"
+          "$ref": "#/$defs/MessageRequeuedRecord"
         },
         {
           "$ref": "#/$defs/EnvironmentPhaseRecord"
@@ -8472,8 +8706,8 @@
       "title": "ReactWorkflowRun",
       "type": "object"
     },
-    "RecordsAppendFrame": {
-      "description": "Cursored append-only delivery of session records, ordered by feed_seq,\nfrom all sources. Every record in the frame advances the resume cursor \u2014\nincluding ones a client renders as nothing.",
+    "RecordsFrame": {
+      "description": "Cursored append-only delivery of session records, ordered by feed_seq,\nfrom all sources. Every record in the frame advances the resume cursor,\nincluding ones a client renders as nothing.",
       "properties": {
         "records": {
           "description": "New session records, ordered by feed_seq.",
@@ -8484,8 +8718,8 @@
           "type": "array"
         },
         "type": {
-          "const": "records_append",
-          "default": "records_append",
+          "const": "records",
+          "default": "records",
           "title": "Type",
           "type": "string"
         }
@@ -8494,7 +8728,7 @@
         "records",
         "type"
       ],
-      "title": "RecordsAppendFrame",
+      "title": "RecordsFrame",
       "type": "object"
     },
     "ReleaseAction": {
@@ -9176,7 +9410,7 @@
           ]
         }
       ],
-      "description": "An agent session: one conversation with an agent. Returned by\n`GET /v1/sessions/{id}` and carried by the session stream's\n`session`/`snapshot` frames; REST and stream never disagree about what a\nsession looks like.",
+      "description": "An agent session: one conversation with an agent. Returned by\n`GET /v1/sessions/{id}` and carried by the session stream's\n`session` frames; REST and stream never disagree about what a\nsession looks like.",
       "properties": {
         "agent": {
           "anyOf": [
@@ -9254,6 +9488,18 @@
           "$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."
         },
+        "error": {
+          "anyOf": [
+            {
+              "$ref": "#/$defs/SessionError"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "Why the last message failed, was stopped, or was cancelled; null otherwise."
+        },
         "event": {
           "anyOf": [
             {
@@ -9381,7 +9627,7 @@
             }
           ],
           "default": null,
-          "description": "The session's structured output: the `json_schema` the agent must satisfy and, once a turn has submitted it, the `result`."
+          "description": "The session's structured output: the `json_schema` the agent must satisfy and, once the agent has submitted it, the `result`."
         },
         "parent": {
           "anyOf": [
@@ -9411,6 +9657,10 @@
           "$ref": "#/$defs/SessionSource",
           "description": "Where the session came from (e.g. react, web, api, cli, mention, cron)."
         },
+        "status": {
+          "$ref": "#/$defs/SessionStatus",
+          "description": "Where the session is. A message you sent is answered once the status is `idle` or `closed`; its `message_ended` record in GET /v1/sessions/{id}/records says how."
+        },
         "summary": {
           "anyOf": [
             {
@@ -9427,18 +9677,6 @@
           "$ref": "#/$defs/Tokens",
           "description": "The tokens the session has used so far."
         },
-        "turn": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/SessionTurn"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "The turn in progress, or the latest one when none is running. Null until the session has a message. Wait on it: the message you sent is answered when the turn with your message's `turn_id` reaches a final status."
-        },
         "updated_at": {
           "description": "When the session was last updated.",
           "format": "date-time",
@@ -9457,6 +9695,7 @@
         "cost",
         "created_at",
         "environment",
+        "error",
         "event",
         "gemini",
         "git",
@@ -9468,9 +9707,9 @@
         "permissions",
         "skills",
         "source",
+        "status",
         "summary",
         "tokens",
-        "turn",
         "updated_at"
       ],
       "title": "Session",
@@ -9584,7 +9823,7 @@
     },
     "SessionClosedPayload": {
       "additionalProperties": true,
-      "description": "session_closed: the conversation closed permanently.",
+      "description": "session_closed: the session closed permanently.",
       "properties": {},
       "title": "SessionClosedPayload",
       "type": "object"
@@ -9636,6 +9875,19 @@
           "title": "Kind",
           "type": "string"
         },
+        "message_id": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
+        },
         "model": {
           "anyOf": [
             {
@@ -9668,19 +9920,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "const": "lifecycle",
           "default": "lifecycle",
@@ -9712,19 +9951,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -9734,16 +9960,15 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "SessionClosedRecord",
       "type": "object",
@@ -9954,7 +10179,7 @@
       "description": "Whether the session can take more messages, and how quickly it would\nanswer one.",
       "properties": {
         "interactive": {
-          "description": "Whether the session stays open after its first turn.",
+          "description": "Whether the session stays open after its first message is answered.",
           "title": "Interactive",
           "type": "boolean"
         },
@@ -9962,10 +10187,6 @@
           "$ref": "#/$defs/SessionPrompting",
           "description": "The session's policy for direct messages. Caller authorization and message validation are checked separately."
         },
-        "state": {
-          "$ref": "#/$defs/SessionState",
-          "description": "`open` while the session can take messages; `closed` is permanent."
-        },
         "warm": {
           "description": "Whether an agent is ready to answer the next message right away. When false, the next message first prepares an environment, which takes longer. A hint only; clients need no logic on it.",
           "title": "Warm",
@@ -9975,7 +10196,6 @@
       "required": [
         "interactive",
         "prompting",
-        "state",
         "warm"
       ],
       "title": "SessionConversation",
@@ -9987,7 +10207,7 @@
       "properties": {
         "interactive": {
           "default": true,
-          "description": "Whether the session stays open after its first turn. Defaults to true; false runs once and requires a prompt. Requires the model's interactive capability when true. Direct message acceptance is reported separately in conversation.prompting.",
+          "description": "Whether the session stays open after its first message is answered. Defaults to true; false runs once and requires a prompt. Requires the model's interactive capability when true. Direct message acceptance is reported separately in conversation.prompting.",
           "title": "Interactive",
           "type": "boolean"
         }
@@ -10096,6 +10316,34 @@
       "title": "SessionEnvironment",
       "type": "object"
     },
+    "SessionError": {
+      "description": "Why the last message failed, was stopped, or was cancelled. Cleared\nwhen the next message starts.",
+      "properties": {
+        "detail": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "description": "A human-readable explanation.",
+          "title": "Detail"
+        },
+        "reason": {
+          "$ref": "#/$defs/ErrorReason",
+          "description": "What went wrong."
+        }
+      },
+      "required": [
+        "detail",
+        "reason"
+      ],
+      "title": "SessionError",
+      "type": "object"
+    },
     "SessionEventActor": {
       "description": "The event's initiator, when known; never inferred from resource ownership.",
       "properties": {
@@ -10137,7 +10385,7 @@
       "type": "object"
     },
     "SessionFrame": {
-      "description": "A last-writer-wins snapshot of the session: the only way turn,\nconversation, and cost updates arrive. Resent whole on any field change.",
+      "description": "The whole session, last writer wins: the first frame after the stream\nconnects, and resent whole whenever any field changes (status, error,\ncost). A `closed` status is the last one; a normal close (1000) follows.",
       "properties": {
         "session": {
           "$ref": "#/$defs/Session",
@@ -10401,7 +10649,7 @@
       "type": "object"
     },
     "SessionMessage": {
-      "description": "One message in a session's inbox: what a queued message renders and\nretires on. The webhook provenance internals stay off the wire.",
+      "description": "One message sent to a session.",
       "properties": {
         "author": {
           "anyOf": [
@@ -10422,38 +10670,11 @@
           "type": "string"
         },
         "created_at": {
-          "description": "When the message was created.",
+          "description": "When the message was received.",
           "format": "date-time",
           "title": "Created At",
           "type": "string"
         },
-        "delivered_at": {
-          "anyOf": [
-            {
-              "format": "date-time",
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "When the message was delivered to the agent, if it has been.",
-          "title": "Delivered At"
-        },
-        "feed_seq": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Where the message sits in the session's feed \u2014 placement metadata only, NOT a resume cursor (only records_append frames advance the cursor). Null for older rows.",
-          "title": "Feed Seq"
-        },
         "id": {
           "description": "Unique identifier of the message.",
           "title": "Id",
@@ -10467,67 +10688,25 @@
           "title": "Images",
           "type": "array"
         },
-        "sender_attribution_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Identifier of the principal that sent the message, if attributed.",
-          "title": "Sender Attribution Id"
-        },
-        "sender_attribution_type": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/AttributionType"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Kind of principal that sent the message, if attributed."
+        "index": {
+          "description": "Position in the session, starting at 0.",
+          "title": "Index",
+          "type": "integer"
         },
         "session_id": {
           "description": "Identifier of the session the message belongs to.",
           "title": "Session Id",
           "type": "string"
-        },
-        "status": {
-          "$ref": "#/$defs/SessionMessageStatus",
-          "description": "Delivery status of the message."
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "The turn created to answer this message. Wait on it: the message is answered when that turn reaches a final status.",
-          "title": "Turn Id"
         }
       },
       "required": [
         "author",
         "body",
         "created_at",
-        "delivered_at",
-        "feed_seq",
         "id",
         "images",
-        "sender_attribution_id",
-        "sender_attribution_type",
-        "session_id",
-        "status",
-        "turn_id"
+        "index",
+        "session_id"
       ],
       "title": "SessionMessage",
       "type": "object"
@@ -10559,16 +10738,8 @@
       "title": "SessionMessageImage",
       "type": "object"
     },
-    "SessionMessageStatus": {
-      "enum": [
-        "pending",
-        "delivered"
-      ],
-      "title": "SessionMessageStatus",
-      "type": "string"
-    },
     "SessionOutput": {
-      "description": "Structured output on the wire: the contract and, when a turn has\nsubmitted one, the payload. `result` is None while the session runs and\nwhen no turn submitted anything; it is the agent's own JSON, in the\nshape of `json_schema`.",
+      "description": "Structured output on the wire: the contract and, when the agent has\nsubmitted one, the payload. `result` is None while the session runs and\nwhen the agent submitted nothing; it is the agent's own JSON, in the\nshape of `json_schema`.",
       "properties": {
         "json_schema": {
           "additionalProperties": true,
@@ -10587,7 +10758,7 @@
             }
           ],
           "default": null,
-          "description": "The payload the agent submitted, or null until a turn submits one.",
+          "description": "The payload the agent submitted, or null until it submits one.",
           "title": "Result"
         }
       },
@@ -10712,44 +10883,18 @@
       "title": "SessionSource",
       "type": "string"
     },
-    "SessionState": {
-      "description": "Whether the conversation can still take messages. `closed` is permanent:\na session with interactive false closes when its turn ends, and a conversation closes\nafter its closing message's turn.",
+    "SessionStatus": {
+      "description": "Where the session is. `queued` while a message waits for a worker,\n`preparing` while its environment is set up, `running` while the agent\nworks, `idle` when every message has been answered and the session can\ntake another, and `closed` when it can take no more. `closed` is\npermanent.",
       "enum": [
-        "open",
+        "queued",
+        "preparing",
+        "running",
+        "idle",
         "closed"
       ],
-      "title": "SessionState",
+      "title": "SessionStatus",
       "type": "string"
     },
-    "SessionStopped": {
-      "description": "When a stop was requested and the GitHub user who requested it.",
-      "properties": {
-        "at": {
-          "description": "When a stop was requested.",
-          "format": "date-time",
-          "title": "At",
-          "type": "string"
-        },
-        "by": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/GithubAccountSnippet"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "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"
-    },
     "SessionSummary": {
       "description": "A live one-line summary of what the session is doing, refreshed\nevery few steps while it runs.",
       "properties": {
@@ -10780,119 +10925,6 @@
       "title": "SessionSummary",
       "type": "object"
     },
-    "SessionTurn": {
-      "description": "One message and the agent's answer to it. A turn is `queued` from the\nmoment its message is received, `preparing` while its environment is set\nup, `running` while the agent works, then `completed`, `failed`,\n`stopped`, or `cancelled`.",
-      "properties": {
-        "cost": {
-          "$ref": "#/$defs/Cost",
-          "description": "What the turn cost so far, in millicents, broken down by leg."
-        },
-        "created_at": {
-          "description": "When the turn's message was received.",
-          "format": "date-time",
-          "title": "Created At",
-          "type": "string"
-        },
-        "detail": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "A human-readable explanation of a failed, stopped, or cancelled turn, or of why a queued turn waits.",
-          "title": "Detail"
-        },
-        "ended_at": {
-          "anyOf": [
-            {
-              "format": "date-time",
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "When the turn reached its final status.",
-          "title": "Ended At"
-        },
-        "id": {
-          "description": "Unique identifier of the turn.",
-          "title": "Id",
-          "type": "string"
-        },
-        "index": {
-          "description": "Position in the session, starting at 0.",
-          "title": "Index",
-          "type": "integer"
-        },
-        "reason": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/TurnReason"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Why the turn failed or was cancelled; null on every other status."
-        },
-        "started_at": {
-          "anyOf": [
-            {
-              "format": "date-time",
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "When the agent started on the message.",
-          "title": "Started At"
-        },
-        "status": {
-          "$ref": "#/$defs/TurnStatus",
-          "description": "Where the turn is."
-        },
-        "stopped": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/SessionStopped"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "When and by whom a stop was requested; null when none was."
-        },
-        "tokens": {
-          "$ref": "#/$defs/Tokens",
-          "description": "The tokens the turn spent and the model they went to."
-        }
-      },
-      "required": [
-        "cost",
-        "created_at",
-        "detail",
-        "ended_at",
-        "id",
-        "index",
-        "reason",
-        "started_at",
-        "status",
-        "stopped",
-        "tokens"
-      ],
-      "title": "SessionTurn",
-      "type": "object"
-    },
     "SettingsRef": {
       "additionalProperties": false,
       "description": "A Claude Code settings.json read from a repository and applied to the\nsession. It adds permission rules and other Claude Code settings; rules the\nplatform sets stay in force. Supported models list `settings` in\n`/v1/account/models`.",
@@ -11074,49 +11106,6 @@
       "title": "SlackMessageEvent",
       "type": "object"
     },
-    "SnapshotFrame": {
-      "description": "The first frame after the stream connects: the session plus its open\ninbox. Records always arrive separately via records_append frames.",
-      "properties": {
-        "earliest_feed_seq": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "description": "The retention head: the lowest feed_seq still stored for this session, or null when it has no stored records. A client resuming from after_seq < earliest_feed_seq - 1 knows history is truncated.",
-          "title": "Earliest Feed Seq"
-        },
-        "messages": {
-          "description": "The session's open (pending) inbox messages.",
-          "items": {
-            "$ref": "#/$defs/SessionMessage"
-          },
-          "title": "Messages",
-          "type": "array"
-        },
-        "session": {
-          "$ref": "#/$defs/Session",
-          "description": "The session's current state."
-        },
-        "type": {
-          "const": "snapshot",
-          "default": "snapshot",
-          "title": "Type",
-          "type": "string"
-        }
-      },
-      "required": [
-        "earliest_feed_seq",
-        "messages",
-        "session",
-        "type"
-      ],
-      "title": "SnapshotFrame",
-      "type": "object"
-    },
     "StatusAction": {
       "description": "The state of a commit status. `success` is `passed`, `failure` is `failed`, and `error` is `errored`.",
       "enum": [
@@ -11233,23 +11222,27 @@
       "title": "TokensInfo",
       "type": "object"
     },
-    "TurnEndedPayload": {
-      "additionalProperties": true,
-      "description": "turn_ended: the turn reached its final status. `status`, `reason`, and\n`detail` match the turn on the session object.",
+    "UnknownSessionRecord": {
+      "description": "Unrecognized or unparseable payload; the complete original stays readable.",
       "properties": {
-        "detail": {
+        "cost": {
           "anyOf": [
             {
-              "type": "string"
+              "type": "integer"
             },
             {
               "type": "null"
             }
           ],
           "default": null,
-          "title": "Detail"
+          "title": "Cost"
         },
-        "duration_ms": {
+        "created_at": {
+          "format": "date-time",
+          "title": "Created At",
+          "type": "string"
+        },
+        "duration": {
           "anyOf": [
             {
               "type": "integer"
@@ -11259,9 +11252,25 @@
             }
           ],
           "default": null,
-          "title": "Duration Ms"
+          "title": "Duration"
         },
-        "reason": {
+        "feed_seq": {
+          "description": "Position in the session feed and the stream's resume cursor.",
+          "title": "Feed Seq",
+          "type": "integer"
+        },
+        "id": {
+          "description": "Unique identifier of the record.",
+          "title": "Id",
+          "type": "string"
+        },
+        "kind": {
+          "const": "unknown",
+          "default": "unknown",
+          "title": "Kind",
+          "type": "string"
+        },
+        "message_id": {
           "anyOf": [
             {
               "type": "string"
@@ -11271,638 +11280,8 @@
             }
           ],
           "default": null,
-          "title": "Reason"
-        },
-        "status": {
-          "title": "Status",
-          "type": "string"
-        },
-        "turn_id": {
-          "title": "Turn Id",
-          "type": "string"
-        },
-        "turn_index": {
-          "title": "Turn Index",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "turn_id",
-        "turn_index",
-        "status"
-      ],
-      "title": "TurnEndedPayload",
-      "type": "object"
-    },
-    "TurnEndedRecord": {
-      "properties": {
-        "cost": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Cost"
-        },
-        "created_at": {
-          "format": "date-time",
-          "title": "Created At",
-          "type": "string"
-        },
-        "duration": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Duration"
-        },
-        "feed_seq": {
-          "description": "Position in the session feed and the stream's resume cursor.",
-          "title": "Feed Seq",
-          "type": "integer"
-        },
-        "id": {
-          "description": "Unique identifier of the record.",
-          "title": "Id",
-          "type": "string"
-        },
-        "kind": {
-          "const": "platform",
-          "default": "platform",
-          "title": "Kind",
-          "type": "string"
-        },
-        "model": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Model"
-        },
-        "payload": {
-          "$ref": "#/$defs/TurnEndedPayload"
-        },
-        "record_format": {
-          "const": "ellipsis_lifecycle@1",
-          "default": "ellipsis_lifecycle@1",
-          "title": "Record Format",
-          "type": "string"
-        },
-        "record_type": {
-          "const": "turn_ended",
-          "default": "turn_ended",
-          "title": "Record Type",
-          "type": "string"
-        },
-        "session_id": {
-          "description": "Session containing this record.",
-          "title": "Session Id",
-          "type": "string"
-        },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
-        "source": {
-          "const": "lifecycle",
-          "default": "lifecycle",
-          "title": "Source",
-          "type": "string"
-        },
-        "tokens_info": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/TokensInfo"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null
-        },
-        "tools": {
-          "anyOf": [
-            {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
-        }
-      },
-      "required": [
-        "cost",
-        "created_at",
-        "duration",
-        "feed_seq",
-        "id",
-        "kind",
-        "model",
-        "payload",
-        "record_format",
-        "record_type",
-        "session_id",
-        "session_message_id",
-        "source",
-        "tokens_info",
-        "tools",
-        "turn_id"
-      ],
-      "title": "TurnEndedRecord",
-      "type": "object",
-      "x-ellipsis-preserve-payload": true
-    },
-    "TurnQueuedPayload": {
-      "additionalProperties": true,
-      "description": "turn_queued: the turn waits because the account already has\n`sessions_alive` sessions alive, its limit.",
-      "properties": {
-        "limit": {
-          "title": "Limit",
-          "type": "integer"
-        },
-        "sessions_alive": {
-          "title": "Sessions Alive",
-          "type": "integer"
-        },
-        "turn_id": {
-          "title": "Turn Id",
-          "type": "string"
-        }
-      },
-      "required": [
-        "turn_id",
-        "sessions_alive",
-        "limit"
-      ],
-      "title": "TurnQueuedPayload",
-      "type": "object"
-    },
-    "TurnQueuedRecord": {
-      "properties": {
-        "cost": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Cost"
-        },
-        "created_at": {
-          "format": "date-time",
-          "title": "Created At",
-          "type": "string"
-        },
-        "duration": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Duration"
-        },
-        "feed_seq": {
-          "description": "Position in the session feed and the stream's resume cursor.",
-          "title": "Feed Seq",
-          "type": "integer"
-        },
-        "id": {
-          "description": "Unique identifier of the record.",
-          "title": "Id",
-          "type": "string"
-        },
-        "kind": {
-          "const": "platform",
-          "default": "platform",
-          "title": "Kind",
-          "type": "string"
-        },
-        "model": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Model"
-        },
-        "payload": {
-          "$ref": "#/$defs/TurnQueuedPayload"
-        },
-        "record_format": {
-          "const": "ellipsis_lifecycle@1",
-          "default": "ellipsis_lifecycle@1",
-          "title": "Record Format",
-          "type": "string"
-        },
-        "record_type": {
-          "const": "turn_queued",
-          "default": "turn_queued",
-          "title": "Record Type",
-          "type": "string"
-        },
-        "session_id": {
-          "description": "Session containing this record.",
-          "title": "Session Id",
-          "type": "string"
-        },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
-        "source": {
-          "const": "lifecycle",
-          "default": "lifecycle",
-          "title": "Source",
-          "type": "string"
-        },
-        "tokens_info": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/TokensInfo"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null
-        },
-        "tools": {
-          "anyOf": [
-            {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
-        }
-      },
-      "required": [
-        "cost",
-        "created_at",
-        "duration",
-        "feed_seq",
-        "id",
-        "kind",
-        "model",
-        "payload",
-        "record_format",
-        "record_type",
-        "session_id",
-        "session_message_id",
-        "source",
-        "tokens_info",
-        "tools",
-        "turn_id"
-      ],
-      "title": "TurnQueuedRecord",
-      "type": "object",
-      "x-ellipsis-preserve-payload": true
-    },
-    "TurnReason": {
-      "description": "Why a turn failed or was cancelled. Null on every other outcome.",
-      "enum": [
-        "error",
-        "tool_call_failed",
-        "budget_hit",
-        "payment_required",
-        "blocked",
-        "contact_email_required",
-        "lifecycle_hook_failed",
-        "missing_repo_access",
-        "missing_token_permissions",
-        "missing_environment_variables",
-        "missing_github_integration",
-        "agent_unavailable",
-        "upstream_unavailable",
-        "unsupported_configuration",
-        "execution_disabled",
-        "interrupted"
-      ],
-      "title": "TurnReason",
-      "type": "string"
-    },
-    "TurnStartedPayload": {
-      "additionalProperties": true,
-      "description": "turn_started: the agent started on the turn's message.",
-      "properties": {
-        "turn_id": {
-          "title": "Turn Id",
-          "type": "string"
-        },
-        "turn_index": {
-          "title": "Turn Index",
-          "type": "integer"
-        }
-      },
-      "required": [
-        "turn_id",
-        "turn_index"
-      ],
-      "title": "TurnStartedPayload",
-      "type": "object"
-    },
-    "TurnStartedRecord": {
-      "properties": {
-        "cost": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Cost"
-        },
-        "created_at": {
-          "format": "date-time",
-          "title": "Created At",
-          "type": "string"
-        },
-        "duration": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Duration"
-        },
-        "feed_seq": {
-          "description": "Position in the session feed and the stream's resume cursor.",
-          "title": "Feed Seq",
-          "type": "integer"
-        },
-        "id": {
-          "description": "Unique identifier of the record.",
-          "title": "Id",
-          "type": "string"
-        },
-        "kind": {
-          "const": "platform",
-          "default": "platform",
-          "title": "Kind",
-          "type": "string"
-        },
-        "model": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Model"
-        },
-        "payload": {
-          "$ref": "#/$defs/TurnStartedPayload"
-        },
-        "record_format": {
-          "const": "ellipsis_lifecycle@1",
-          "default": "ellipsis_lifecycle@1",
-          "title": "Record Format",
-          "type": "string"
-        },
-        "record_type": {
-          "const": "turn_started",
-          "default": "turn_started",
-          "title": "Record Type",
-          "type": "string"
-        },
-        "session_id": {
-          "description": "Session containing this record.",
-          "title": "Session Id",
-          "type": "string"
-        },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
-        "source": {
-          "const": "lifecycle",
-          "default": "lifecycle",
-          "title": "Source",
-          "type": "string"
-        },
-        "tokens_info": {
-          "anyOf": [
-            {
-              "$ref": "#/$defs/TokensInfo"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null
-        },
-        "tools": {
-          "anyOf": [
-            {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
-        }
-      },
-      "required": [
-        "cost",
-        "created_at",
-        "duration",
-        "feed_seq",
-        "id",
-        "kind",
-        "model",
-        "payload",
-        "record_format",
-        "record_type",
-        "session_id",
-        "session_message_id",
-        "source",
-        "tokens_info",
-        "tools",
-        "turn_id"
-      ],
-      "title": "TurnStartedRecord",
-      "type": "object",
-      "x-ellipsis-preserve-payload": true
-    },
-    "TurnStatus": {
-      "description": "Where one turn is: waiting, preparing, being answered, or over.\n\n`queued` turns wait to start, behind another turn or for a free session\nslot on the account. `preparing` turns wait while the environment is set\nup. `stopped` and `cancelled` are their own outcomes; `reason` explains a\n`failed` or `cancelled` turn.",
-      "enum": [
-        "queued",
-        "preparing",
-        "running",
-        "completed",
-        "failed",
-        "stopped",
-        "cancelled"
-      ],
-      "title": "TurnStatus",
-      "type": "string"
-    },
-    "UnknownSessionRecord": {
-      "description": "Unrecognized or unparseable payload; the complete original stays readable.",
-      "properties": {
-        "cost": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Cost"
-        },
-        "created_at": {
-          "format": "date-time",
-          "title": "Created At",
-          "type": "string"
-        },
-        "duration": {
-          "anyOf": [
-            {
-              "type": "integer"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "title": "Duration"
-        },
-        "feed_seq": {
-          "description": "Position in the session feed and the stream's resume cursor.",
-          "title": "Feed Seq",
-          "type": "integer"
-        },
-        "id": {
-          "description": "Unique identifier of the record.",
-          "title": "Id",
-          "type": "string"
-        },
-        "kind": {
-          "const": "unknown",
-          "default": "unknown",
-          "title": "Kind",
-          "type": "string"
+          "description": "The message this record belongs to: the message itself, or what happened while answering it. Null for records outside any message, such as the session closing.",
+          "title": "Message Id"
         },
         "model": {
           "anyOf": [
@@ -11936,19 +11315,6 @@
           "title": "Session Id",
           "type": "string"
         },
-        "session_message_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Message this record receives, delivers, requeues, or echoes.",
-          "title": "Session Message Id"
-        },
         "source": {
           "description": "Original producer. Unknown producers remain readable as unknown records.",
           "title": "Source",
@@ -11979,19 +11345,6 @@
           ],
           "default": null,
           "title": "Tools"
-        },
-        "turn_id": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "null"
-            }
-          ],
-          "default": null,
-          "description": "Turn containing this record, when applicable.",
-          "title": "Turn Id"
         }
       },
       "required": [
@@ -12001,16 +11354,15 @@
         "feed_seq",
         "id",
         "kind",
+        "message_id",
         "model",
         "payload",
         "record_format",
         "record_type",
         "session_id",
-        "session_message_id",
         "source",
         "tokens_info",
-        "tools",
-        "turn_id"
+        "tools"
       ],
       "title": "UnknownSessionRecord",
       "type": "object",
@@ -12042,13 +11394,10 @@
   "description": "One server-to-client frame of the Ellipsis session stream (WS /v1/sessions/{id}/stream). Clients ignore frames with unknown `type` values.",
   "oneOf": [
     {
-      "$ref": "#/$defs/SnapshotFrame"
-    },
-    {
-      "$ref": "#/$defs/RecordsAppendFrame"
+      "$ref": "#/$defs/SessionFrame"
     },
     {
-      "$ref": "#/$defs/SessionFrame"
+      "$ref": "#/$defs/RecordsFrame"
     },
     {
       "$ref": "#/$defs/DeltaFrame"
@@ -12056,9 +11405,6 @@
     {
       "$ref": "#/$defs/HeartbeatFrame"
     },
-    {
-      "$ref": "#/$defs/DoneFrame"
-    },
     {
       "$ref": "#/$defs/ErrorFrame"
     }