@ellipsis-dev/sdk 0.36.0 → 0.37.0

package/schema/openapi.v1.json

@@ -2226,7 +2226,7 @@
                 "type": "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": {
@@ -2297,7 +2297,7 @@
                 "type": "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": {
@@ -2411,6 +2411,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -2472,18 +2484,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "claude_code",
             "default": "claude_code",
@@ -2513,25 +2513,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -2646,7 +2633,7 @@
                 "type": "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": {
@@ -2966,6 +2953,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -3023,18 +3022,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "claude_code",
             "default": "claude_code",
@@ -3064,25 +3051,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -3701,6 +3675,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -3731,18 +3717,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "codex",
             "default": "codex",
@@ -3772,25 +3746,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -4041,7 +4002,7 @@
                 "type": "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.",
@@ -4057,7 +4018,7 @@
                 "type": "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"
           }
         },
@@ -4080,7 +4041,7 @@
                 "type": "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.",
@@ -4096,7 +4057,7 @@
                 "type": "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"
           }
         },
@@ -4904,7 +4865,7 @@
                 "type": "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": {
             "anyOf": [
@@ -4926,7 +4887,7 @@
                 "type": "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"
           }
         },
@@ -5090,6 +5051,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -5159,18 +5132,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "codex",
             "default": "codex",
@@ -5200,25 +5161,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -7814,7 +7762,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",
@@ -7901,6 +7849,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -7932,18 +7892,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "lifecycle",
             "default": "lifecycle",
@@ -7973,25 +7921,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -8108,6 +8043,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -8139,18 +8086,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "lifecycle",
             "default": "lifecycle",
@@ -8180,25 +8115,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -8290,6 +8212,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -8321,18 +8255,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "lifecycle",
             "default": "lifecycle",
@@ -8362,25 +8284,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -8544,6 +8453,30 @@
         "title": "ErrorInfo",
         "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"
+      },
       "ErrorResponse": {
         "description": "The error envelope every /v1 error returns.",
         "properties": {
@@ -8587,7 +8520,7 @@
                 "type": "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"
           }
         },
@@ -8615,7 +8548,7 @@
                 "type": "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"
           }
         },
@@ -8797,7 +8730,7 @@
                 "type": "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"
           }
         },
@@ -8899,6 +8832,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -8929,18 +8874,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "gemini",
             "default": "gemini",
@@ -8970,25 +8903,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -13047,27 +12967,54 @@
         "title": "MentionSettings",
         "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": "#/components/schemas/Cost"
+          },
+          "duration_ms": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Duration Ms"
+          },
+          "error": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/SessionError"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
           "message_id": {
             "title": "Message Id",
             "type": "string"
           },
-          "turn_id": {
-            "title": "Turn Id",
+          "status": {
+            "title": "Status",
             "type": "string"
+          },
+          "tokens": {
+            "$ref": "#/components/schemas/Tokens"
           }
         },
         "required": [
           "message_id",
-          "turn_id"
+          "status"
         ],
-        "title": "MessageDeliveredPayload",
+        "title": "MessageEndedPayload",
         "type": "object"
       },
-      "MessageDeliveredRecord": {
+      "MessageEndedRecord": {
         "properties": {
           "cost": {
             "anyOf": [
@@ -13112,6 +13059,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -13124,7 +13083,7 @@
             "title": "Model"
           },
           "payload": {
-            "$ref": "#/components/schemas/MessageDeliveredPayload"
+            "$ref": "#/components/schemas/MessageEndedPayload"
           },
           "record_format": {
             "const": "ellipsis_lifecycle@1",
@@ -13133,8 +13092,8 @@
             "type": "string"
           },
           "record_type": {
-            "const": "message_delivered",
-            "default": "message_delivered",
+            "const": "message_ended",
+            "default": "message_ended",
             "title": "Record Type",
             "type": "string"
           },
@@ -13143,18 +13102,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "lifecycle",
             "default": "lifecycle",
@@ -13184,25 +13131,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -13216,39 +13150,81 @@
           "created_at",
           "kind"
         ],
-        "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"
               }
             ],
-            "title": "Author"
+            "title": "Cost"
           },
-          "body": {
-            "title": "Body",
+          "created_at": {
+            "format": "date-time",
+            "title": "Created At",
             "type": "string"
           },
-          "closes_session": {
-            "default": false,
-            "title": "Closes Session",
-            "type": "boolean"
+          "duration": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Duration"
           },
-          "message_id": {
-            "title": "Message Id",
+          "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"
           },
-          "sender_attribution_id": {
+          "message_id": {
             "anyOf": [
               {
                 "type": "string"
@@ -13257,9 +13233,10 @@
                 "type": "null"
               }
             ],
-            "title": "Sender Attribution Id"
+            "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"
           },
-          "sender_attribution_type": {
+          "model": {
             "anyOf": [
               {
                 "type": "string"
@@ -13268,28 +13245,81 @@
                 "type": "null"
               }
             ],
-            "title": "Sender Attribution Type"
+            "title": "Model"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/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"
           },
-          "turn_id": {
+          "tokens_info": {
             "anyOf": [
               {
-                "type": "string"
+                "$ref": "#/components/schemas/TokensInfo"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "tools": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
               },
               {
                 "type": "null"
               }
             ],
-            "title": "Turn Id"
+            "title": "Tools"
           }
         },
         "required": [
+          "id",
+          "session_id",
           "message_id",
-          "body"
+          "feed_seq",
+          "source",
+          "record_type",
+          "record_format",
+          "payload",
+          "tools",
+          "tokens_info",
+          "cost",
+          "duration",
+          "model",
+          "created_at",
+          "kind"
         ],
-        "title": "MessageReceivedPayload",
-        "type": "object"
+        "title": "MessageQueuedRecord",
+        "type": "object",
+        "x-ellipsis-preserve-payload": true
       },
-      "MessageReceivedRecord": {
+      "MessageRecord": {
         "properties": {
           "cost": {
             "anyOf": [
@@ -13334,6 +13364,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -13346,7 +13388,7 @@
             "title": "Model"
           },
           "payload": {
-            "$ref": "#/components/schemas/MessageReceivedPayload"
+            "$ref": "#/components/schemas/SessionMessage"
           },
           "record_format": {
             "const": "ellipsis_lifecycle@1",
@@ -13355,8 +13397,8 @@
             "type": "string"
           },
           "record_type": {
-            "const": "message_received",
-            "default": "message_received",
+            "const": "message",
+            "default": "message",
             "title": "Record Type",
             "type": "string"
           },
@@ -13365,18 +13407,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "lifecycle",
             "default": "lifecycle",
@@ -13406,25 +13436,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -13438,37 +13455,21 @@
           "created_at",
           "kind"
         ],
-        "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"
-              }
-            ],
-            "title": "Requeued Turn Id"
-          },
-          "turn_id": {
-            "title": "Turn Id",
-            "type": "string"
           }
         },
         "required": [
-          "message_id",
-          "turn_id"
+          "message_id"
         ],
         "title": "MessageRequeuedPayload",
         "type": "object"
@@ -13518,6 +13519,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -13549,18 +13562,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "lifecycle",
             "default": "lifecycle",
@@ -13590,8 +13591,102 @@
               }
             ],
             "title": "Tools"
+          }
+        },
+        "required": [
+          "id",
+          "session_id",
+          "message_id",
+          "feed_seq",
+          "source",
+          "record_type",
+          "record_format",
+          "payload",
+          "tools",
+          "tokens_info",
+          "cost",
+          "duration",
+          "model",
+          "created_at",
+          "kind"
+        ],
+        "title": "MessageRequeuedRecord",
+        "type": "object",
+        "x-ellipsis-preserve-payload": true
+      },
+      "MessageStartedPayload": {
+        "additionalProperties": true,
+        "description": "message_started: the agent started on the message.",
+        "properties": {
+          "message_id": {
+            "title": "Message Id",
+            "type": "string"
+          }
+        },
+        "required": [
+          "message_id"
+        ],
+        "title": "MessageStartedPayload",
+        "type": "object"
+      },
+      "MessageStartedRecord": {
+        "properties": {
+          "cost": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Cost"
+          },
+          "created_at": {
+            "format": "date-time",
+            "title": "Created At",
+            "type": "string"
+          },
+          "duration": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "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"
+          },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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"
           },
-          "turn_id": {
+          "model": {
             "anyOf": [
               {
                 "type": "string"
@@ -13600,15 +13695,63 @@
                 "type": "null"
               }
             ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
+            "title": "Model"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/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": "#/components/schemas/TokensInfo"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "tools": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Tools"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -13622,7 +13765,7 @@
           "created_at",
           "kind"
         ],
-        "title": "MessageRequeuedRecord",
+        "title": "MessageStartedRecord",
         "type": "object",
         "x-ellipsis-preserve-payload": true
       },
@@ -14121,13 +14264,12 @@
             "environment_output": "#/components/schemas/EnvironmentOutputRecord",
             "environment_phase": "#/components/schemas/EnvironmentPhaseRecord",
             "environment_ready": "#/components/schemas/EnvironmentReadyRecord",
-            "message_delivered": "#/components/schemas/MessageDeliveredRecord",
-            "message_received": "#/components/schemas/MessageReceivedRecord",
+            "message": "#/components/schemas/MessageRecord",
+            "message_ended": "#/components/schemas/MessageEndedRecord",
+            "message_queued": "#/components/schemas/MessageQueuedRecord",
             "message_requeued": "#/components/schemas/MessageRequeuedRecord",
-            "session_closed": "#/components/schemas/SessionClosedRecord",
-            "turn_ended": "#/components/schemas/TurnEndedRecord",
-            "turn_queued": "#/components/schemas/TurnQueuedRecord",
-            "turn_started": "#/components/schemas/TurnStartedRecord"
+            "message_started": "#/components/schemas/MessageStartedRecord",
+            "session_closed": "#/components/schemas/SessionClosedRecord"
           },
           "propertyName": "record_type"
         },
@@ -14136,22 +14278,19 @@
             "$ref": "#/components/schemas/SessionClosedRecord"
           },
           {
-            "$ref": "#/components/schemas/MessageReceivedRecord"
+            "$ref": "#/components/schemas/MessageRecord"
           },
           {
-            "$ref": "#/components/schemas/MessageDeliveredRecord"
+            "$ref": "#/components/schemas/MessageQueuedRecord"
           },
           {
-            "$ref": "#/components/schemas/MessageRequeuedRecord"
-          },
-          {
-            "$ref": "#/components/schemas/TurnQueuedRecord"
+            "$ref": "#/components/schemas/MessageStartedRecord"
           },
           {
-            "$ref": "#/components/schemas/TurnStartedRecord"
+            "$ref": "#/components/schemas/MessageEndedRecord"
           },
           {
-            "$ref": "#/components/schemas/TurnEndedRecord"
+            "$ref": "#/components/schemas/MessageRequeuedRecord"
           },
           {
             "$ref": "#/components/schemas/EnvironmentPhaseRecord"
@@ -18485,7 +18624,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": [
@@ -18559,6 +18698,17 @@
             "$ref": "#/components/schemas/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": "#/components/schemas/SessionError"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Why the last message failed, was stopped, or was cancelled; null otherwise."
+          },
           "event": {
             "anyOf": [
               {
@@ -18681,7 +18831,7 @@
                 "type": "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": [
@@ -18710,6 +18860,10 @@
             "$ref": "#/components/schemas/SessionSource",
             "description": "Where the session came from (e.g. react, web, api, cli, mention, cron)."
           },
+          "status": {
+            "$ref": "#/components/schemas/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": [
               {
@@ -18725,17 +18879,6 @@
             "$ref": "#/components/schemas/Tokens",
             "description": "The tokens the session has used so far."
           },
-          "turn": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/SessionTurn"
-              },
-              {
-                "type": "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",
@@ -18754,6 +18897,7 @@
           "cost",
           "created_at",
           "environment",
+          "error",
           "event",
           "gemini",
           "git",
@@ -18765,9 +18909,9 @@
           "permissions",
           "skills",
           "source",
+          "status",
           "summary",
           "tokens",
-          "turn",
           "updated_at"
         ],
         "title": "Session",
@@ -19003,7 +19147,7 @@
       },
       "SessionClosedPayload": {
         "additionalProperties": true,
-        "description": "session_closed: the conversation closed permanently.",
+        "description": "session_closed: the session closed permanently.",
         "properties": {},
         "title": "SessionClosedPayload",
         "type": "object"
@@ -19053,6 +19197,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -19084,18 +19240,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Message this record receives, delivers, requeues, or echoes.",
-            "title": "Session Message Id"
-          },
           "source": {
             "const": "lifecycle",
             "default": "lifecycle",
@@ -19125,25 +19269,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -19486,7 +19617,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"
           },
@@ -19494,10 +19625,6 @@
             "$ref": "#/components/schemas/SessionPrompting",
             "description": "The session's policy for direct messages. Caller authorization and message validation are checked separately."
           },
-          "state": {
-            "$ref": "#/components/schemas/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",
@@ -19507,7 +19634,6 @@
         "required": [
           "interactive",
           "prompting",
-          "state",
           "warm"
         ],
         "title": "SessionConversation",
@@ -19518,7 +19644,7 @@
         "description": "Conversation settings for a session, set on a saved agent or sent when starting a session or running an agent.",
         "properties": {
           "interactive": {
-            "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"
           }
@@ -19532,7 +19658,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"
           }
@@ -19686,6 +19812,33 @@
         "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"
+              }
+            ],
+            "description": "A human-readable explanation.",
+            "title": "Detail"
+          },
+          "reason": {
+            "$ref": "#/components/schemas/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": {
@@ -20082,7 +20235,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": [
@@ -20102,36 +20255,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"
-              }
-            ],
-            "description": "When the message was delivered to the agent, if it has been.",
-            "title": "Delivered At"
-          },
-          "feed_seq": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "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",
@@ -20145,55 +20273,21 @@
             "title": "Images",
             "type": "array"
           },
-          "sender_attribution_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Identifier of the principal that sent the message, if attributed.",
-            "title": "Sender Attribution Id"
-          },
-          "sender_attribution_type": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/AttributionType"
-              },
-              {
-                "type": "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": "#/components/schemas/SessionMessageStatus",
-            "description": "Delivery status of the message."
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "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": [
           "id",
           "session_id",
-          "status",
+          "index",
           "body",
           "created_at"
         ],
@@ -20228,34 +20322,21 @@
         "type": "object"
       },
       "SessionMessageResponse": {
-        "description": "One inbox message and the turn created to answer it.",
+        "description": "One message sent to a session.",
         "properties": {
           "message": {
             "$ref": "#/components/schemas/SessionMessage",
-            "description": "The message."
-          },
-          "turn": {
-            "$ref": "#/components/schemas/SessionTurn",
-            "description": "The turn that will answer the message. Wait on it: poll GET /v1/sessions/{session_id}/turns/{id} or watch the stream's session frames until its status is final."
+            "description": "The message. It is answered once the session's status is `idle` or `closed`; its `message_ended` record says how."
           }
         },
         "required": [
-          "message",
-          "turn"
+          "message"
         ],
         "title": "SessionMessageResponse",
         "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,
@@ -20273,7 +20354,7 @@
                 "type": "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"
           }
         },
@@ -20729,7 +20810,7 @@
         "type": "object"
       },
       "SessionRecordsListResponse": {
-        "description": "A session's stored transcript records, plus its pending inbox\nmessages.",
+        "description": "A session's log: everything that happened, oldest first.",
         "properties": {
           "earliest_feed_seq": {
             "anyOf": [
@@ -20749,15 +20830,6 @@
             "title": "Has More",
             "type": "boolean"
           },
-          "messages": {
-            "default": [],
-            "description": "The open inbox slice (pending rows only): queued messages not yet consumed by a turn. Delivered history comes from the records themselves.",
-            "items": {
-              "$ref": "#/components/schemas/SessionMessage"
-            },
-            "title": "Messages",
-            "type": "array"
-          },
           "next_cursor": {
             "anyOf": [
               {
@@ -20771,7 +20843,7 @@
             "title": "Next Cursor"
           },
           "records": {
-            "description": "The session's records (transcript + lifecycle), ordered by feed_seq. Clients render each by (source, record_format, record_type). Pagination is opt-in (`cursor` + `limit`); a bare call returns the full retained transcript.",
+            "description": "The session's records, ordered by feed_seq: the messages sent to it, the platform's own events, and the agent's output. Clients render each by (source, record_format, record_type). Pagination is opt-in (`cursor` + `limit`); a bare call returns the full retained log.",
             "items": {
               "$ref": "#/components/schemas/SessionRecord"
             },
@@ -20917,43 +20989,18 @@
         "title": "SessionSpendItem",
         "type": "object"
       },
-      "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": "#/components/schemas/GithubAccountSnippet"
-              },
-              {
-                "type": "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": {
@@ -21001,155 +21048,6 @@
         "title": "SessionToolCount",
         "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": "#/components/schemas/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"
-              }
-            ],
-            "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"
-              }
-            ],
-            "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": "#/components/schemas/TurnReason"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Why the turn failed or was cancelled; null on every other status."
-          },
-          "started_at": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "When the agent started on the message.",
-            "title": "Started At"
-          },
-          "status": {
-            "$ref": "#/components/schemas/TurnStatus",
-            "description": "Where the turn is."
-          },
-          "stopped": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/SessionStopped"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "When and by whom a stop was requested; null when none was."
-          },
-          "tokens": {
-            "$ref": "#/components/schemas/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"
-      },
-      "SessionTurnResponse": {
-        "description": "One turn.",
-        "properties": {
-          "turn": {
-            "$ref": "#/components/schemas/SessionTurn",
-            "description": "The turn."
-          }
-        },
-        "required": [
-          "turn"
-        ],
-        "title": "SessionTurnResponse",
-        "type": "object"
-      },
-      "SessionTurnsListResponse": {
-        "description": "A session's turns and its whole inbox, oldest first.",
-        "properties": {
-          "messages": {
-            "description": "Every message, delivered and pending, oldest first.",
-            "items": {
-              "$ref": "#/components/schemas/SessionMessage"
-            },
-            "title": "Messages",
-            "type": "array"
-          },
-          "turns": {
-            "description": "Every turn, ordered by index.",
-            "items": {
-              "$ref": "#/components/schemas/SessionTurn"
-            },
-            "title": "Turns",
-            "type": "array"
-          }
-        },
-        "required": [
-          "turns",
-          "messages"
-        ],
-        "title": "SessionTurnsListResponse",
-        "type": "object"
-      },
       "SessionUsageBucket": {
         "properties": {
           "cache_read_tokens": {
@@ -21203,6 +21101,14 @@
             "title": "Has More",
             "type": "boolean"
           },
+          "message_counts": {
+            "additionalProperties": {
+              "type": "integer"
+            },
+            "description": "How many messages each listed session has received, by session id.",
+            "title": "Message Counts",
+            "type": "object"
+          },
           "next_cursor": {
             "anyOf": [
               {
@@ -21229,13 +21135,6 @@
             },
             "title": "Sessions",
             "type": "array"
-          },
-          "turn_counts": {
-            "additionalProperties": {
-              "type": "integer"
-            },
-            "title": "Turn Counts",
-            "type": "object"
           }
         },
         "required": [
@@ -22090,7 +21989,7 @@
           },
           "conversation": {
             "$ref": "#/components/schemas/SessionConversationConfig-Input",
-            "description": "Conversation settings. Omitted, a raw session is interactive and an agent session keeps the agent's setting. State, warmth, prompting, and the turn are server-owned response fields."
+            "description": "Conversation settings. Omitted, a raw session is interactive and an agent session keeps the agent's setting. Warmth and prompting are server-owned response fields."
           },
           "environment": {
             "anyOf": [
@@ -22124,7 +22023,7 @@
             "description": "Gemini CLI options for this session. Sent fields replace the agent's; naming Gemini CLI on an agent that runs another harness replaces its harness and requires a model. Set at most one of claude_code, codex, or gemini."
           },
           "images": {
-            "description": "Images attached to the first message, base64 inline. Requires the model's `images` capability, listed by `/v1/account/models`. Each becomes an `[Image #N]` placeholder in the prompt and an image block on turn 0. Up to 10, 5 MiB each; PNG, JPEG, GIF, or WebP.",
+            "description": "Images attached to the first message, base64 inline. Requires the model's `images` capability, listed by `/v1/account/models`. Each becomes an `[Image #N]` placeholder in the prompt and an image block the model sees with it. Up to 10, 5 MiB each; PNG, JPEG, GIF, or WebP.",
             "items": {
               "$ref": "#/components/schemas/ImageAttachment"
             },
@@ -22341,7 +22240,7 @@
           },
           "conversation": {
             "$ref": "#/components/schemas/SessionConversationConfig-Input",
-            "description": "Conversation settings. Omitted, a raw session is interactive and an agent session keeps the agent's setting. State, warmth, prompting, and the turn are server-owned response fields."
+            "description": "Conversation settings. Omitted, a raw session is interactive and an agent session keeps the agent's setting. Warmth and prompting are server-owned response fields."
           },
           "environment": {
             "anyOf": [
@@ -22375,7 +22274,7 @@
             "description": "Gemini CLI input and native options. Set exactly one of claude_code, codex, or gemini."
           },
           "images": {
-            "description": "Images attached to the first message, base64 inline. Requires the model's `images` capability, listed by `/v1/account/models`. Each becomes an `[Image #N]` placeholder in the prompt and an image block on turn 0. Up to 10, 5 MiB each; PNG, JPEG, GIF, or WebP.",
+            "description": "Images attached to the first message, base64 inline. Requires the model's `images` capability, listed by `/v1/account/models`. Each becomes an `[Image #N]` placeholder in the prompt and an image block the model sees with it. Up to 10, 5 MiB each; PNG, JPEG, GIF, or WebP.",
             "items": {
               "$ref": "#/components/schemas/ImageAttachment"
             },
@@ -22605,605 +22504,6 @@
         "title": "TranscriptIngestResult",
         "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.",
-        "properties": {
-          "detail": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Detail"
-          },
-          "duration_ms": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Duration Ms"
-          },
-          "reason": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "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"
-              }
-            ],
-            "title": "Cost"
-          },
-          "created_at": {
-            "format": "date-time",
-            "title": "Created At",
-            "type": "string"
-          },
-          "duration": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "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"
-              }
-            ],
-            "title": "Model"
-          },
-          "payload": {
-            "$ref": "#/components/schemas/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"
-              }
-            ],
-            "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": "#/components/schemas/TokensInfo"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "tools": {
-            "anyOf": [
-              {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
-          }
-        },
-        "required": [
-          "id",
-          "session_id",
-          "turn_id",
-          "session_message_id",
-          "feed_seq",
-          "source",
-          "record_type",
-          "record_format",
-          "payload",
-          "tools",
-          "tokens_info",
-          "cost",
-          "duration",
-          "model",
-          "created_at",
-          "kind"
-        ],
-        "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"
-              }
-            ],
-            "title": "Cost"
-          },
-          "created_at": {
-            "format": "date-time",
-            "title": "Created At",
-            "type": "string"
-          },
-          "duration": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "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"
-              }
-            ],
-            "title": "Model"
-          },
-          "payload": {
-            "$ref": "#/components/schemas/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"
-              }
-            ],
-            "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": "#/components/schemas/TokensInfo"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "tools": {
-            "anyOf": [
-              {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
-          }
-        },
-        "required": [
-          "id",
-          "session_id",
-          "turn_id",
-          "session_message_id",
-          "feed_seq",
-          "source",
-          "record_type",
-          "record_format",
-          "payload",
-          "tools",
-          "tokens_info",
-          "cost",
-          "duration",
-          "model",
-          "created_at",
-          "kind"
-        ],
-        "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"
-              }
-            ],
-            "title": "Cost"
-          },
-          "created_at": {
-            "format": "date-time",
-            "title": "Created At",
-            "type": "string"
-          },
-          "duration": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "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"
-              }
-            ],
-            "title": "Model"
-          },
-          "payload": {
-            "$ref": "#/components/schemas/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"
-              }
-            ],
-            "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": "#/components/schemas/TokensInfo"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "tools": {
-            "anyOf": [
-              {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
-          }
-        },
-        "required": [
-          "id",
-          "session_id",
-          "turn_id",
-          "session_message_id",
-          "feed_seq",
-          "source",
-          "record_type",
-          "record_format",
-          "payload",
-          "tools",
-          "tokens_info",
-          "cost",
-          "duration",
-          "model",
-          "created_at",
-          "kind"
-        ],
-        "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"
-      },
       "UninstallGithubAppRequest": {
         "properties": {
           "confirm_account_login": {
@@ -23263,6 +22563,18 @@
             "title": "Kind",
             "type": "string"
           },
+          "message_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "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": [
               {
@@ -23294,18 +22606,6 @@
             "title": "Session Id",
             "type": "string"
           },
-          "session_message_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "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",
@@ -23334,25 +22634,12 @@
               }
             ],
             "title": "Tools"
-          },
-          "turn_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Turn containing this record, when applicable.",
-            "title": "Turn Id"
           }
         },
         "required": [
           "id",
           "session_id",
-          "turn_id",
-          "session_message_id",
+          "message_id",
           "feed_seq",
           "source",
           "record_type",
@@ -34278,7 +33565,7 @@
     },
     "/v1/sessions": {
       "get": {
-        "description": "List cloud agent sessions, newest first.\n\nOptionally filtered by agent (id or name), source, service, handler, time\nwindow, attributed author, repository, and whether the session is\nstill going.",
+        "description": "List cloud agent sessions, newest first.\n\nOptionally filtered by agent (id or name), source, service, handler, time\nwindow, attributed author, repository, and status.",
         "operationId": "list_sessions",
         "parameters": [
           {
@@ -34469,15 +33756,24 @@
             }
           },
           {
-            "description": "Keep only sessions whose current turn is queued, preparing, or running.",
+            "description": "Keep only sessions in these statuses.",
             "in": "query",
-            "name": "unfinished",
+            "name": "status",
             "required": false,
             "schema": {
-              "default": false,
-              "description": "Keep only sessions whose current turn is queued, preparing, or running.",
-              "title": "Unfinished",
-              "type": "boolean"
+              "anyOf": [
+                {
+                  "items": {
+                    "$ref": "#/components/schemas/SessionStatus"
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Keep only sessions in these statuses.",
+              "title": "Status"
             }
           },
           {
@@ -34899,7 +34195,7 @@
             }
           },
           {
-            "description": "Current turn statuses to keep.",
+            "description": "Keep only sessions in these statuses.",
             "in": "query",
             "name": "status",
             "required": false,
@@ -34907,7 +34203,7 @@
               "anyOf": [
                 {
                   "items": {
-                    "$ref": "#/components/schemas/TurnStatus"
+                    "$ref": "#/components/schemas/SessionStatus"
                   },
                   "type": "array"
                 },
@@ -34915,7 +34211,7 @@
                   "type": "null"
                 }
               ],
-              "description": "Current turn statuses to keep.",
+              "description": "Keep only sessions in these statuses.",
               "title": "Status"
             }
           },
@@ -36009,7 +35305,7 @@
     },
     "/v1/sessions/{id}/messages": {
       "post": {
-        "description": "Send a message to a session.\n\n409 for mention, non-interactive, closed, and out-of-budget\nsessions. Returns the created message and its turn; a retried send\nwith the same idempotency_key returns the original ones.",
+        "description": "Send a message to a session.\n\n409 for mention, non-interactive, closed, and out-of-budget\nsessions. Returns the created message; a retried send with the\nsame idempotency_key returns the original one. The message is\nanswered once the session's status is `idle` or `closed`.",
         "operationId": "send_session_message",
         "parameters": [
           {
@@ -36351,6 +35647,24 @@
               "title": "Limit"
             }
           },
+          {
+            "description": "Keep only the records of this message.",
+            "in": "query",
+            "name": "message_id",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Keep only the records of this message.",
+              "title": "Message Id"
+            }
+          },
           {
             "in": "header",
             "name": "user-agent",
@@ -36476,7 +35790,7 @@
     },
     "/v1/sessions/{id}/stop": {
       "post": {
-        "description": "Stop the turn in progress and return the session.\n\nThe turn ends `stopped`; the conversation stays open. 409 when no\nturn is queued, preparing, or running. The stopping user is recorded only\nwhen the caller's credential maps to a GitHub account.",
+        "description": "Stop the session's work and return it.\n\nThe running message ends `stopped` and every queued message is\ncancelled, so the session goes `idle` (or `closed` when it was\nnot interactive). 409 when the session is idle or closed already.",
         "operationId": "stop_session",
         "parameters": [
           {
@@ -36554,7 +35868,7 @@
                 }
               }
             },
-            "description": "No turn is queued, preparing, or running."
+            "description": "The session is idle or closed."
           },
           "422": {
             "content": {
@@ -36906,289 +36220,6 @@
         "x-ellipsis-undocumented": true
       }
     },
-    "/v1/sessions/{id}/turns": {
-      "get": {
-        "description": "Return the session's turns and messages, oldest first.\n\nOne turn per message: pending until the agent starts on it,\nrunning while it works, then completed, failed, stopped, or\ncancelled.",
-        "operationId": "get_session_turns",
-        "parameters": [
-          {
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "title": "Id",
-              "type": "string"
-            }
-          },
-          {
-            "in": "header",
-            "name": "user-agent",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "User-Agent"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/SessionTurnsListResponse"
-                }
-              }
-            },
-            "description": "Successful Response"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The bearer token is missing, invalid, or revoked."
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The credential may not perform this action, or the account is blocked."
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "No such session in your account."
-          },
-          "422": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
-                }
-              }
-            },
-            "description": "Validation Error"
-          }
-        },
-        "security": [
-          {
-            "HTTPBearer": []
-          }
-        ],
-        "summary": "Get Session Turns",
-        "tags": [
-          "v1"
-        ],
-        "x-ellipsis-permissions": {
-          "constraints": [
-            {
-              "account_admin_fields": [],
-              "identity": null,
-              "sandbox_scope": null
-            }
-          ],
-          "description": "Required permissions: read:sessions.\nAPI key: Supported.\nCLI user token: Supported.\nSession token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.\nHigher permission levels include lower levels: read < write < delete.\nGrant match patterns can further restrict access to individual resources.",
-          "notes": [
-            "Higher permission levels include lower levels: read < write < delete.",
-            "Grant match patterns can further restrict access to individual resources."
-          ],
-          "required": [
-            {
-              "level": "read",
-              "resource": "sessions"
-            }
-          ],
-          "tokens": [
-            {
-              "available": true,
-              "conditions": [],
-              "kind": "api_key",
-              "label": "API key"
-            },
-            {
-              "available": true,
-              "conditions": [],
-              "kind": "user_token",
-              "label": "CLI user token"
-            },
-            {
-              "available": true,
-              "conditions": [
-                "Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration."
-              ],
-              "kind": "sandbox_token",
-              "label": "Session token"
-            }
-          ]
-        },
-        "x-ellipsis-sdk-method": "sessions.turns.list"
-      }
-    },
-    "/v1/sessions/{session_id}/turns/{id}": {
-      "get": {
-        "description": "Return one turn.\n\nPoll this after sending a message: the message is answered when\nthe turn's status is completed, failed, stopped, or cancelled.",
-        "operationId": "get_session_turn",
-        "parameters": [
-          {
-            "in": "path",
-            "name": "session_id",
-            "required": true,
-            "schema": {
-              "title": "Session Id",
-              "type": "string"
-            }
-          },
-          {
-            "in": "path",
-            "name": "id",
-            "required": true,
-            "schema": {
-              "title": "Id",
-              "type": "string"
-            }
-          },
-          {
-            "in": "header",
-            "name": "user-agent",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "User-Agent"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/SessionTurnResponse"
-                }
-              }
-            },
-            "description": "Successful Response"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The bearer token is missing, invalid, or revoked."
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The credential may not perform this action, or the account is blocked."
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "No such session or turn in your account."
-          },
-          "422": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
-                }
-              }
-            },
-            "description": "Validation Error"
-          }
-        },
-        "security": [
-          {
-            "HTTPBearer": []
-          }
-        ],
-        "summary": "Get Session Turn",
-        "tags": [
-          "v1"
-        ],
-        "x-ellipsis-permissions": {
-          "constraints": [
-            {
-              "account_admin_fields": [],
-              "identity": null,
-              "sandbox_scope": null
-            }
-          ],
-          "description": "Required permissions: read:sessions.\nAPI key: Supported.\nCLI user token: Supported.\nSession token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.\nHigher permission levels include lower levels: read < write < delete.\nGrant match patterns can further restrict access to individual resources.",
-          "notes": [
-            "Higher permission levels include lower levels: read < write < delete.",
-            "Grant match patterns can further restrict access to individual resources."
-          ],
-          "required": [
-            {
-              "level": "read",
-              "resource": "sessions"
-            }
-          ],
-          "tokens": [
-            {
-              "available": true,
-              "conditions": [],
-              "kind": "api_key",
-              "label": "API key"
-            },
-            {
-              "available": true,
-              "conditions": [],
-              "kind": "user_token",
-              "label": "CLI user token"
-            },
-            {
-              "available": true,
-              "conditions": [
-                "Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration."
-              ],
-              "kind": "sandbox_token",
-              "label": "Session token"
-            }
-          ]
-        },
-        "x-ellipsis-sdk-method": "sessions.turns.get"
-      }
-    },
     "/v1/support/slack": {
       "get": {
         "operationId": "get_slack_help",