@ellipsis-dev/sdk 0.36.0 → 0.37.0

package/dist/{types-CbePyY-S.d.ts → types-BXbnHOQe.d.ts}

@@ -1420,8 +1420,7 @@ interface paths {
          * @description List cloud agent sessions, newest first.
          *
          *     Optionally filtered by agent (id or name), source, service, handler, time
-         *     window, attributed author, repository, and whether the session is
-         *     still going.
+         *     window, attributed author, repository, and status.
          */
         get: operations['list_sessions'];
         put?: never;
@@ -1642,8 +1641,9 @@ interface paths {
          * @description Send a message to a session.
          *
          *     409 for mention, non-interactive, closed, and out-of-budget
-         *     sessions. Returns the created message and its turn; a retried send
-         *     with the same idempotency_key returns the original ones.
+         *     sessions. Returns the created message; a retried send with the
+         *     same idempotency_key returns the original one. The message is
+         *     answered once the session's status is `idle` or `closed`.
          */
         post: operations['send_session_message'];
         delete?: never;
@@ -1712,11 +1712,11 @@ interface paths {
         put?: never;
         /**
          * Stop Session
-         * @description Stop the turn in progress and return the session.
+         * @description Stop the session's work and return it.
          *
-         *     The turn ends `stopped`; the conversation stays open. 409 when no
-         *     turn is queued, preparing, or running. The stopping user is recorded only
-         *     when the caller's credential maps to a GitHub account.
+         *     The running message ends `stopped` and every queued message is
+         *     cancelled, so the session goes `idle` (or `closed` when it was
+         *     not interactive). 409 when the session is idle or closed already.
          */
         post: operations['stop_session'];
         delete?: never;
@@ -1768,53 +1768,6 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/sessions/{id}/turns': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Session Turns
-         * @description Return the session's turns and messages, oldest first.
-         *
-         *     One turn per message: pending until the agent starts on it,
-         *     running while it works, then completed, failed, stopped, or
-         *     cancelled.
-         */
-        get: operations['get_session_turns'];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    '/v1/sessions/{session_id}/turns/{id}': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Session Turn
-         * @description Return one turn.
-         *
-         *     Poll this after sending a message: the message is answered when
-         *     the turn's status is completed, failed, stopped, or cancelled.
-         */
-        get: operations['get_session_turn'];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     '/v1/support/slack': {
         parameters: {
             query?: never;
@@ -3269,7 +3222,7 @@ interface components {
             model: string;
             /**
              * Prompt
-             * @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.
              */
             prompt?: string | null;
             settings?: components['schemas']['SettingsRef-Input'] | null;
@@ -3291,7 +3244,7 @@ interface components {
             model: string;
             /**
              * Prompt
-             * @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.
              */
             prompt: string | null;
             settings: components['schemas']['SettingsRef-Output'] | null;
@@ -3342,6 +3295,11 @@ interface components {
              * @constant
              */
             kind: 'claude_code';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             /** Payload */
@@ -3362,11 +3320,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default claude_code
@@ -3376,11 +3329,6 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         /** ClaudeNativeUsage */
         ClaudeNativeUsage: {
@@ -3426,7 +3374,7 @@ interface components {
             model?: string | null;
             /**
              * Prompt
-             * @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.
              */
             prompt?: string | null;
             settings?: components['schemas']['SettingsRef-Input'] | null;
@@ -3534,6 +3482,11 @@ interface components {
              * @constant
              */
             kind: 'claude_sdk';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             /** Payload */
@@ -3554,11 +3507,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default claude_code
@@ -3568,11 +3516,6 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         /** ClaudeSystemEvent */
         ClaudeSystemEvent: {
@@ -3806,6 +3749,11 @@ interface components {
              * @constant
              */
             kind: 'codex_app_server';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             payload: components['schemas']['CodexAppServerNotification'];
@@ -3825,11 +3773,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default codex
@@ -3839,11 +3782,6 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         /** CodexCollabAgentToolCall */
         CodexCollabAgentToolCall: {
@@ -3931,7 +3869,7 @@ interface components {
          * @description Native options supported by the current Codex adapter.
          */
         'CodexConfig-Input': {
-            /** @description Reasoning effort for every turn. Omit to use the model default. */
+            /** @description Reasoning effort for every message. Omit to use the model default. */
             effort?: components['schemas']['CodexEffortLevel'] | null;
             /**
              * Model
@@ -3940,7 +3878,7 @@ interface components {
             model: string;
             /**
              * Prompt
-             * @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.
              */
             prompt?: string | null;
         };
@@ -3949,7 +3887,7 @@ interface components {
          * @description Native options supported by the current Codex adapter.
          */
         'CodexConfig-Output': {
-            /** @description Reasoning effort for every turn. Omit to use the model default. */
+            /** @description Reasoning effort for every message. Omit to use the model default. */
             effort: components['schemas']['CodexEffortLevel'] | null;
             /**
              * Model
@@ -3958,7 +3896,7 @@ interface components {
             model: string;
             /**
              * Prompt
-             * @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.
              */
             prompt: string | null;
         };
@@ -4241,13 +4179,13 @@ interface components {
          *     Unknown options are rejected instead of silently ignored.
          */
         CodexOverrides: {
-            /** @description Reasoning effort for every turn. Omit to use the model default. */
+            /** @description Reasoning effort for every message. Omit to use the model default. */
             effort?: components['schemas']['CodexEffortLevel'] | null;
             /** Model */
             model?: string | null;
             /**
              * Prompt
-             * @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.
              */
             prompt?: string | null;
         };
@@ -4330,6 +4268,11 @@ interface components {
              * @constant
              */
             kind: 'codex';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             /** Payload */
@@ -4350,11 +4293,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default codex
@@ -4364,11 +4302,6 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         /**
          * CodexSubAgentActivity
@@ -5623,8 +5556,8 @@ interface components {
         /**
          * EnvironmentOutputPayload
          * @description environment_output: one chunk of output from preparing the environment,
-         *     including the customer's own hooks. Many fire per turn; `chunk` orders them
-         *     within a step.
+         *     including the customer's own hooks. Many fire per message; `chunk` orders
+         *     them within a step.
          */
         EnvironmentOutputPayload: {
             /** Chunk */
@@ -5670,6 +5603,11 @@ interface components {
              * @constant
              */
             kind: 'platform';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             payload: components['schemas']['EnvironmentOutputPayload'];
@@ -5689,11 +5627,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default lifecycle
@@ -5703,11 +5636,6 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         /**
          * EnvironmentPhasePayload
@@ -5758,6 +5686,11 @@ interface components {
              * @constant
              */
             kind: 'platform';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             payload: components['schemas']['EnvironmentPhasePayload'];
@@ -5777,11 +5710,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default lifecycle
@@ -5791,11 +5719,6 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         /**
          * EnvironmentReadyPayload
@@ -5837,6 +5760,11 @@ interface components {
              * @constant
              */
             kind: 'platform';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             payload: components['schemas']['EnvironmentReadyPayload'];
@@ -5856,11 +5784,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default lifecycle
@@ -5870,11 +5793,6 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         /**
          * EnvironmentResponse
@@ -5970,6 +5888,12 @@ interface components {
              */
             request_id?: string | null;
         };
+        /**
+         * ErrorReason
+         * @description Why a message failed, was stopped, or was cancelled.
+         * @enum {string}
+         */
+        ErrorReason: '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';
         /**
          * ErrorResponse
          * @description The error envelope every /v1 error returns.
@@ -5993,7 +5917,7 @@ interface components {
             model: string;
             /**
              * Prompt
-             * @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.
              */
             prompt?: string | null;
         };
@@ -6009,7 +5933,7 @@ interface components {
             model: string;
             /**
              * Prompt
-             * @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.
              */
             prompt: string | null;
         };
@@ -6106,7 +6030,7 @@ interface components {
             model?: string | null;
             /**
              * Prompt
-             * @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.
              */
             prompt?: string | null;
         };
@@ -6156,6 +6080,11 @@ interface components {
              * @constant
              */
             kind: 'gemini';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             payload: components['schemas']['GeminiStreamEvent'];
@@ -6175,11 +6104,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default gemini
@@ -6189,11 +6113,6 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         GeminiStreamEvent: components['schemas']['GeminiInitEvent'] | components['schemas']['GeminiMessageEvent'] | components['schemas']['GeminiToolUseEvent'] | components['schemas']['GeminiToolResultEvent'] | components['schemas']['GeminiErrorEvent'] | components['schemas']['GeminiResultEvent'];
         /** GeminiStreamStats */
@@ -8131,19 +8050,28 @@ interface components {
             trigger_on_user_mention_public_repo: boolean;
         };
         /**
-         * MessageDeliveredPayload
-         * @description message_delivered: the agent started on the message.
+         * MessageEndedPayload
+         * @description message_ended: the message was answered, or its answer failed, was
+         *     stopped, or was cancelled. `error` is the same object as the session's
+         *     `error`, null when the message was answered. `cost` and `tokens` are what
+         *     answering it spent. Messages answered together report the spend once, on
+         *     the last of them.
          */
-        MessageDeliveredPayload: {
+        MessageEndedPayload: {
+            cost?: components['schemas']['Cost'];
+            /** Duration Ms */
+            duration_ms?: number | null;
+            error?: components['schemas']['SessionError'] | null;
             /** Message Id */
             message_id: string;
-            /** Turn Id */
-            turn_id: string;
+            /** Status */
+            status: string;
+            tokens?: components['schemas']['Tokens'];
         } & {
             [key: string]: unknown;
         };
-        /** MessageDeliveredRecord */
-        MessageDeliveredRecord: {
+        /** MessageEndedRecord */
+        MessageEndedRecord: {
             /** Cost */
             cost: number | null;
             /**
@@ -8169,9 +8097,14 @@ interface components {
              * @constant
              */
             kind: 'platform';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
-            payload: components['schemas']['MessageDeliveredPayload'];
+            payload: components['schemas']['MessageEndedPayload'];
             /**
              * Record Format
              * @default ellipsis_lifecycle@1
@@ -8182,17 +8115,12 @@ interface components {
              * @description discriminator enum property added by openapi-typescript
              * @enum {string}
              */
-            record_type: 'message_delivered';
+            record_type: 'message_ended';
             /**
              * Session Id
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default lifecycle
@@ -8202,40 +8130,24 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         /**
-         * MessageReceivedPayload
-         * @description message_received: a message landed in the session inbox and its turn was
-         *     created. `turn_id` is the turn that will answer it.
+         * MessageQueuedPayload
+         * @description message_queued: the message waits because the account already has
+         *     `sessions_alive` sessions alive, its limit.
          */
-        MessageReceivedPayload: {
-            /** Author */
-            author?: string | null;
-            /** Body */
-            body: string;
-            /**
-             * Closes Session
-             * @default false
-             */
-            closes_session: boolean;
+        MessageQueuedPayload: {
+            /** Limit */
+            limit: number;
             /** Message Id */
             message_id: string;
-            /** Sender Attribution Id */
-            sender_attribution_id?: string | null;
-            /** Sender Attribution Type */
-            sender_attribution_type?: string | null;
-            /** Turn Id */
-            turn_id?: string | null;
+            /** Sessions Alive */
+            sessions_alive: number;
         } & {
             [key: string]: unknown;
         };
-        /** MessageReceivedRecord */
-        MessageReceivedRecord: {
+        /** MessageQueuedRecord */
+        MessageQueuedRecord: {
             /** Cost */
             cost: number | null;
             /**
@@ -8261,9 +8173,14 @@ interface components {
              * @constant
              */
             kind: 'platform';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
-            payload: components['schemas']['MessageReceivedPayload'];
+            payload: components['schemas']['MessageQueuedPayload'];
             /**
              * Record Format
              * @default ellipsis_lifecycle@1
@@ -8274,17 +8191,12 @@ interface components {
              * @description discriminator enum property added by openapi-typescript
              * @enum {string}
              */
-            record_type: 'message_received';
+            record_type: 'message_queued';
             /**
              * Session Id
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default lifecycle
@@ -8294,24 +8206,76 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
+        };
+        /** MessageRecord */
+        MessageRecord: {
+            /** Cost */
+            cost: number | null;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /** Duration */
+            duration: number | null;
+            /**
+             * Feed Seq
+             * @description Position in the session feed and the stream's resume cursor.
+             */
+            feed_seq: number;
+            /**
+             * Id
+             * @description Unique identifier of the record.
+             */
+            id: string;
+            /**
+             * Kind
+             * @default platform
+             * @constant
+             */
+            kind: 'platform';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
+            /** Model */
+            model: string | null;
+            payload: components['schemas']['SessionMessage'];
+            /**
+             * Record Format
+             * @default ellipsis_lifecycle@1
+             * @constant
+             */
+            record_format: 'ellipsis_lifecycle@1';
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            record_type: 'message';
+            /**
+             * Session Id
+             * @description Session containing this record.
+             */
+            session_id: string;
             /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
+             * Source
+             * @default lifecycle
+             * @constant
              */
-            turn_id: string | null;
+            source: 'lifecycle';
+            tokens_info: components['schemas']['TokensInfo'] | null;
+            /** Tools */
+            tools: string[] | null;
         };
         /**
          * MessageRequeuedPayload
-         * @description message_requeued: a turn was interrupted before answering, so the
-         *     message goes back to the inbox with a new queued turn.
+         * @description message_requeued: the agent was interrupted before answering, so the
+         *     message goes back to the inbox and starts again on a fresh environment.
          */
         MessageRequeuedPayload: {
             /** Message Id */
             message_id: string;
-            /** Requeued Turn Id */
-            requeued_turn_id?: string | null;
-            /** Turn Id */
-            turn_id: string;
         } & {
             [key: string]: unknown;
         };
@@ -8342,6 +8306,11 @@ interface components {
              * @constant
              */
             kind: 'platform';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             payload: components['schemas']['MessageRequeuedPayload'];
@@ -8361,11 +8330,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default lifecycle
@@ -8375,11 +8339,77 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
+        };
+        /**
+         * MessageStartedPayload
+         * @description message_started: the agent started on the message.
+         */
+        MessageStartedPayload: {
+            /** Message Id */
+            message_id: string;
+        } & {
+            [key: string]: unknown;
+        };
+        /** MessageStartedRecord */
+        MessageStartedRecord: {
+            /** Cost */
+            cost: number | null;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /** Duration */
+            duration: number | null;
+            /**
+             * Feed Seq
+             * @description Position in the session feed and the stream's resume cursor.
+             */
+            feed_seq: number;
+            /**
+             * Id
+             * @description Unique identifier of the record.
+             */
+            id: string;
+            /**
+             * Kind
+             * @default platform
+             * @constant
+             */
+            kind: 'platform';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
+            /** Model */
+            model: string | null;
+            payload: components['schemas']['MessageStartedPayload'];
+            /**
+             * Record Format
+             * @default ellipsis_lifecycle@1
+             * @constant
+             */
+            record_format: 'ellipsis_lifecycle@1';
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            record_type: 'message_started';
+            /**
+             * Session Id
+             * @description Session containing this record.
+             */
+            session_id: string;
             /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
+             * Source
+             * @default lifecycle
+             * @constant
              */
-            turn_id: string | null;
+            source: 'lifecycle';
+            tokens_info: components['schemas']['TokensInfo'] | null;
+            /** Tools */
+            tools: string[] | null;
         };
         /** Model */
         Model: {
@@ -8649,7 +8679,7 @@ interface components {
             /** @default {} */
             github: components['schemas']['GithubPermissions-Output'];
         };
-        PlatformSessionRecord: components['schemas']['SessionClosedRecord'] | components['schemas']['MessageReceivedRecord'] | components['schemas']['MessageDeliveredRecord'] | components['schemas']['MessageRequeuedRecord'] | components['schemas']['TurnQueuedRecord'] | components['schemas']['TurnStartedRecord'] | components['schemas']['TurnEndedRecord'] | components['schemas']['EnvironmentPhaseRecord'] | components['schemas']['EnvironmentOutputRecord'] | components['schemas']['EnvironmentReadyRecord'];
+        PlatformSessionRecord: components['schemas']['SessionClosedRecord'] | components['schemas']['MessageRecord'] | components['schemas']['MessageQueuedRecord'] | components['schemas']['MessageStartedRecord'] | components['schemas']['MessageEndedRecord'] | components['schemas']['MessageRequeuedRecord'] | components['schemas']['EnvironmentPhaseRecord'] | components['schemas']['EnvironmentOutputRecord'] | components['schemas']['EnvironmentReadyRecord'];
         /**
          * PollCliAuthResponse
          * @description The state of a device-code flow. Poll until `status` leaves `pending`.
@@ -10797,7 +10827,7 @@ interface components {
          * Session
          * @description An agent session: one conversation with an agent. Returned by
          *     `GET /v1/sessions/{id}` and carried by the session stream's
-         *     `session`/`snapshot` frames; REST and stream never disagree about what a
+         *     `session` frames; REST and stream never disagree about what a
          *     session looks like.
          */
         Session: {
@@ -10829,6 +10859,8 @@ interface components {
             created_at: string;
             /** @description The full environment configuration frozen when the session was created, with the saved environment's id and how it was chosen. */
             environment: components['schemas']['SessionEnvironment'];
+            /** @description Why the last message failed, was stopped, or was cancelled; null otherwise. */
+            error: components['schemas']['SessionError'] | null;
             /**
              * Event
              * @description The typed external event that started the session; null for direct and scheduled starts.
@@ -10853,7 +10885,7 @@ interface components {
             metadata: {
                 [key: string]: string;
             };
-            /** @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`. */
             output: components['schemas']['SessionOutput'] | null;
             /** @description The predecessor session this session continues; null when there is none. */
             parent: components['schemas']['SessionParent'] | null;
@@ -10866,12 +10898,12 @@ interface components {
             skills: components['schemas']['SkillRef-Output'][];
             /** @description Where the session came from (e.g. react, web, api, cli, mention, cron). */
             source: components['schemas']['SessionSource'];
+            /** @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. */
+            status: components['schemas']['SessionStatus'];
             /** @description The latest live summary of the session's progress while it runs, and when it was generated. */
             summary: components['schemas']['SessionSummary'] | null;
             /** @description The tokens the session has used so far. */
             tokens: components['schemas']['Tokens'];
-            /** @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. */
-            turn: components['schemas']['SessionTurn'] | null;
             /**
              * Updated At
              * Format: date-time
@@ -11004,7 +11036,7 @@ interface components {
         SessionCapability: 'coding' | 'interactive' | 'agent' | 'structured_input' | 'structured_output' | 'system_files' | 'images' | 'mcp' | 'skills' | 'settings' | 'fallback_model' | 'effort';
         /**
          * SessionClosedPayload
-         * @description session_closed: the conversation closed permanently.
+         * @description session_closed: the session closed permanently.
          */
         SessionClosedPayload: {
             [key: string]: unknown;
@@ -11036,6 +11068,11 @@ interface components {
              * @constant
              */
             kind: 'platform';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             payload: components['schemas']['SessionClosedPayload'];
@@ -11055,11 +11092,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @default lifecycle
@@ -11069,11 +11101,6 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         /**
          * SessionConfig
@@ -11218,13 +11245,11 @@ interface components {
         SessionConversation: {
             /**
              * Interactive
-             * @description Whether the session stays open after its first turn.
+             * @description Whether the session stays open after its first message is answered.
              */
             interactive: boolean;
             /** @description The session's policy for direct messages. Caller authorization and message validation are checked separately. */
             prompting: components['schemas']['SessionPrompting'];
-            /** @description `open` while the session can take messages; `closed` is permanent. */
-            state: components['schemas']['SessionState'];
             /**
              * 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.
@@ -11238,7 +11263,7 @@ interface components {
         'SessionConversationConfig-Input': {
             /**
              * 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.
              */
             interactive?: boolean;
         };
@@ -11249,7 +11274,7 @@ interface components {
         'SessionConversationConfig-Output': {
             /**
              * 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.
              * @default true
              */
             interactive: boolean;
@@ -11314,6 +11339,20 @@ interface components {
              */
             variables: components['schemas']['EnvironmentVariable-Output'][];
         };
+        /**
+         * SessionError
+         * @description Why the last message failed, was stopped, or was cancelled. Cleared
+         *     when the next message starts.
+         */
+        SessionError: {
+            /**
+             * Detail
+             * @description A human-readable explanation.
+             */
+            detail: string | null;
+            /** @description What went wrong. */
+            reason: components['schemas']['ErrorReason'];
+        };
         /**
          * SessionEventActor
          * @description The event's initiator, when known; never inferred from resource ownership.
@@ -11527,8 +11566,7 @@ interface components {
         };
         /**
          * SessionMessage
-         * @description One message in a session's inbox: what a queued message renders and
-         *     retires on. The webhook provenance internals stay off the wire.
+         * @description One message sent to a session.
          */
         SessionMessage: {
             /**
@@ -11544,19 +11582,9 @@ interface components {
             /**
              * Created At
              * Format: date-time
-             * @description When the message was created.
+             * @description When the message was received.
              */
             created_at: string;
-            /**
-             * Delivered At
-             * @description When the message was delivered to the agent, if it has been.
-             */
-            delivered_at?: string | null;
-            /**
-             * Feed Seq
-             * @description Where the message sits in the session's feed — placement metadata only, NOT a resume cursor (only records_append frames advance the cursor). Null for older rows.
-             */
-            feed_seq?: number | null;
             /**
              * Id
              * @description Unique identifier of the message.
@@ -11568,24 +11596,15 @@ interface components {
              */
             images?: components['schemas']['SessionMessageImage'][];
             /**
-             * Sender Attribution Id
-             * @description Identifier of the principal that sent the message, if attributed.
+             * Index
+             * @description Position in the session, starting at 0.
              */
-            sender_attribution_id?: string | null;
-            /** @description Kind of principal that sent the message, if attributed. */
-            sender_attribution_type?: components['schemas']['AttributionType'] | null;
+            index: number;
             /**
              * Session Id
              * @description Identifier of the session the message belongs to.
              */
             session_id: string;
-            /** @description Delivery status of the message. */
-            status: components['schemas']['SessionMessageStatus'];
-            /**
-             * Turn Id
-             * @description The turn created to answer this message. Wait on it: the message is answered when that turn reaches a final status.
-             */
-            turn_id?: string | null;
         };
         /**
          * SessionMessageImage
@@ -11611,24 +11630,17 @@ interface components {
         };
         /**
          * SessionMessageResponse
-         * @description One inbox message and the turn created to answer it.
+         * @description One message sent to a session.
          */
         SessionMessageResponse: {
-            /** @description The message. */
+            /** @description The message. It is answered once the session's status is `idle` or `closed`; its `message_ended` record says how. */
             message: components['schemas']['SessionMessage'];
-            /** @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. */
-            turn: components['schemas']['SessionTurn'];
         };
-        /**
-         * SessionMessageStatus
-         * @enum {string}
-         */
-        SessionMessageStatus: 'pending' | 'delivered';
         /**
          * SessionOutput
-         * @description Structured output on the wire: the contract and, when a turn has
+         * @description Structured output on the wire: the contract and, when the agent has
          *     submitted one, the payload. `result` is None while the session runs and
-         *     when no turn submitted anything; it is the agent's own JSON, in the
+         *     when the agent submitted nothing; it is the agent's own JSON, in the
          *     shape of `json_schema`.
          */
         SessionOutput: {
@@ -11641,7 +11653,7 @@ interface components {
             };
             /**
              * Result
-             * @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.
              */
             result: {
                 [key: string]: unknown;
@@ -11790,8 +11802,7 @@ interface components {
         };
         /**
          * SessionRecordsListResponse
-         * @description A session's stored transcript records, plus its pending inbox
-         *     messages.
+         * @description A session's log: everything that happened, oldest first.
          */
         SessionRecordsListResponse: {
             /**
@@ -11805,12 +11816,6 @@ interface components {
              * @default false
              */
             has_more: boolean;
-            /**
-             * Messages
-             * @description The open inbox slice (pending rows only): queued messages not yet consumed by a turn. Delivered history comes from the records themselves.
-             * @default []
-             */
-            messages: components['schemas']['SessionMessage'][];
             /**
              * Next Cursor
              * @description Pass as `cursor` to fetch the next page. Null on the last page. Opaque — echo it back rather than parsing it.
@@ -11818,7 +11823,7 @@ interface components {
             next_cursor?: string | null;
             /**
              * 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.
              */
             records: components['schemas']['SessionRecord'][];
         };
@@ -11885,27 +11890,15 @@ interface components {
             tokens: number;
         };
         /**
-         * SessionState
-         * @description Whether the conversation can still take messages. `closed` is permanent:
-         *     a session with interactive false closes when its turn ends, and a conversation closes
-         *     after its closing message's turn.
+         * SessionStatus
+         * @description Where the session is. `queued` while a message waits for a worker,
+         *     `preparing` while its environment is set up, `running` while the agent
+         *     works, `idle` when every message has been answered and the session can
+         *     take another, and `closed` when it can take no more. `closed` is
+         *     permanent.
          * @enum {string}
          */
-        SessionState: 'open' | 'closed';
-        /**
-         * SessionStopped
-         * @description When a stop was requested and the GitHub user who requested it.
-         */
-        SessionStopped: {
-            /**
-             * At
-             * Format: date-time
-             * @description When a stop was requested.
-             */
-            at: string;
-            /** @description The GitHub user who stopped the session, resolved at read time. Null if the user is unknown or unavailable. */
-            by: components['schemas']['GithubAccountSnippet'] | null;
-        };
+        SessionStatus: 'queued' | 'preparing' | 'running' | 'idle' | 'closed';
         /**
          * SessionSummary
          * @description A live one-line summary of what the session is doing, refreshed
@@ -11930,80 +11923,6 @@ interface components {
             /** Name */
             name: string;
         };
-        /**
-         * SessionTurn
-         * @description One message and the agent's answer to it. A turn is `queued` from the
-         *     moment its message is received, `preparing` while its environment is set
-         *     up, `running` while the agent works, then `completed`, `failed`,
-         *     `stopped`, or `cancelled`.
-         */
-        SessionTurn: {
-            /** @description What the turn cost so far, in millicents, broken down by leg. */
-            cost: components['schemas']['Cost'];
-            /**
-             * Created At
-             * Format: date-time
-             * @description When the turn's message was received.
-             */
-            created_at: string;
-            /**
-             * Detail
-             * @description A human-readable explanation of a failed, stopped, or cancelled turn, or of why a queued turn waits.
-             */
-            detail: string | null;
-            /**
-             * Ended At
-             * @description When the turn reached its final status.
-             */
-            ended_at: string | null;
-            /**
-             * Id
-             * @description Unique identifier of the turn.
-             */
-            id: string;
-            /**
-             * Index
-             * @description Position in the session, starting at 0.
-             */
-            index: number;
-            /** @description Why the turn failed or was cancelled; null on every other status. */
-            reason: components['schemas']['TurnReason'] | null;
-            /**
-             * Started At
-             * @description When the agent started on the message.
-             */
-            started_at: string | null;
-            /** @description Where the turn is. */
-            status: components['schemas']['TurnStatus'];
-            /** @description When and by whom a stop was requested; null when none was. */
-            stopped: components['schemas']['SessionStopped'] | null;
-            /** @description The tokens the turn spent and the model they went to. */
-            tokens: components['schemas']['Tokens'];
-        };
-        /**
-         * SessionTurnResponse
-         * @description One turn.
-         */
-        SessionTurnResponse: {
-            /** @description The turn. */
-            turn: components['schemas']['SessionTurn'];
-        };
-        /**
-         * SessionTurnsListResponse
-         * @description A session's turns and its whole inbox, oldest first.
-         */
-        SessionTurnsListResponse: {
-            /**
-             * Messages
-             * @description Every message, delivered and pending, oldest first.
-             */
-            messages: components['schemas']['SessionMessage'][];
-            /**
-             * Turns
-             * @description Every turn, ordered by index.
-             */
-            turns: components['schemas']['SessionTurn'][];
-        };
         /** SessionUsageBucket */
         SessionUsageBucket: {
             /**
@@ -12053,6 +11972,13 @@ interface components {
              * @default false
              */
             has_more: boolean;
+            /**
+             * Message Counts
+             * @description How many messages each listed session has received, by session id.
+             */
+            message_counts?: {
+                [key: string]: number;
+            };
             /**
              * Next Cursor
              * @description Pass as `cursor` to fetch the next page. Null on the last page. Opaque — echo it back rather than parsing it.
@@ -12067,10 +11993,6 @@ interface components {
              * @description Lean wire rows — the same shape GET /v1/sessions/{id} and the stream's session frames carry. The heavy blobs (config snapshot, input/output) live on the detail endpoints.
              */
             sessions: components['schemas']['Session'][];
-            /** Turn Counts */
-            turn_counts?: {
-                [key: string]: number;
-            };
         };
         /**
          * SettingsRef
@@ -12485,7 +12407,7 @@ interface components {
             claude_code?: components['schemas']['ClaudeOverrides'] | null;
             /** @description Codex options for this session. Sent fields replace the agent's; naming Codex on an agent that runs another harness replaces its harness and requires a model. Set at most one of claude_code, codex, or gemini. */
             codex?: components['schemas']['CodexOverrides'] | null;
-            /** @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. */
             conversation?: components['schemas']['SessionConversationConfig-Input'];
             /**
              * Environment
@@ -12501,7 +12423,7 @@ interface components {
             gemini?: components['schemas']['GeminiOverrides'] | null;
             /**
              * 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.
              */
             images?: components['schemas']['ImageAttachment'][];
             /**
@@ -12585,7 +12507,7 @@ interface components {
             claude_code?: components['schemas']['ClaudeConfig-Input'] | null;
             /** @description Codex input and native options. Set exactly one of claude_code, codex, or gemini. */
             codex?: components['schemas']['CodexConfig-Input'] | null;
-            /** @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. */
             conversation?: components['schemas']['SessionConversationConfig-Input'];
             /**
              * Environment
@@ -12601,7 +12523,7 @@ interface components {
             gemini?: components['schemas']['GeminiConfig-Input'] | null;
             /**
              * 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.
              */
             images?: components['schemas']['ImageAttachment'][];
             /**
@@ -12771,269 +12693,6 @@ interface components {
             /** Skipped */
             skipped: number;
         };
-        /**
-         * TurnEndedPayload
-         * @description turn_ended: the turn reached its final status. `status`, `reason`, and
-         *     `detail` match the turn on the session object.
-         */
-        TurnEndedPayload: {
-            /** Detail */
-            detail?: string | null;
-            /** Duration Ms */
-            duration_ms?: number | null;
-            /** Reason */
-            reason?: string | null;
-            /** Status */
-            status: string;
-            /** Turn Id */
-            turn_id: string;
-            /** Turn Index */
-            turn_index: number;
-        } & {
-            [key: string]: unknown;
-        };
-        /** TurnEndedRecord */
-        TurnEndedRecord: {
-            /** Cost */
-            cost: number | null;
-            /**
-             * Created At
-             * Format: date-time
-             */
-            created_at: string;
-            /** Duration */
-            duration: number | null;
-            /**
-             * Feed Seq
-             * @description Position in the session feed and the stream's resume cursor.
-             */
-            feed_seq: number;
-            /**
-             * Id
-             * @description Unique identifier of the record.
-             */
-            id: string;
-            /**
-             * Kind
-             * @default platform
-             * @constant
-             */
-            kind: 'platform';
-            /** Model */
-            model: string | null;
-            payload: components['schemas']['TurnEndedPayload'];
-            /**
-             * Record Format
-             * @default ellipsis_lifecycle@1
-             * @constant
-             */
-            record_format: 'ellipsis_lifecycle@1';
-            /**
-             * @description discriminator enum property added by openapi-typescript
-             * @enum {string}
-             */
-            record_type: 'turn_ended';
-            /**
-             * Session Id
-             * @description Session containing this record.
-             */
-            session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
-            /**
-             * Source
-             * @default lifecycle
-             * @constant
-             */
-            source: 'lifecycle';
-            tokens_info: components['schemas']['TokensInfo'] | null;
-            /** Tools */
-            tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
-        };
-        /**
-         * TurnQueuedPayload
-         * @description turn_queued: the turn waits because the account already has
-         *     `sessions_alive` sessions alive, its limit.
-         */
-        TurnQueuedPayload: {
-            /** Limit */
-            limit: number;
-            /** Sessions Alive */
-            sessions_alive: number;
-            /** Turn Id */
-            turn_id: string;
-        } & {
-            [key: string]: unknown;
-        };
-        /** TurnQueuedRecord */
-        TurnQueuedRecord: {
-            /** Cost */
-            cost: number | null;
-            /**
-             * Created At
-             * Format: date-time
-             */
-            created_at: string;
-            /** Duration */
-            duration: number | null;
-            /**
-             * Feed Seq
-             * @description Position in the session feed and the stream's resume cursor.
-             */
-            feed_seq: number;
-            /**
-             * Id
-             * @description Unique identifier of the record.
-             */
-            id: string;
-            /**
-             * Kind
-             * @default platform
-             * @constant
-             */
-            kind: 'platform';
-            /** Model */
-            model: string | null;
-            payload: components['schemas']['TurnQueuedPayload'];
-            /**
-             * Record Format
-             * @default ellipsis_lifecycle@1
-             * @constant
-             */
-            record_format: 'ellipsis_lifecycle@1';
-            /**
-             * @description discriminator enum property added by openapi-typescript
-             * @enum {string}
-             */
-            record_type: 'turn_queued';
-            /**
-             * Session Id
-             * @description Session containing this record.
-             */
-            session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
-            /**
-             * Source
-             * @default lifecycle
-             * @constant
-             */
-            source: 'lifecycle';
-            tokens_info: components['schemas']['TokensInfo'] | null;
-            /** Tools */
-            tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
-        };
-        /**
-         * TurnReason
-         * @description Why a turn failed or was cancelled. Null on every other outcome.
-         * @enum {string}
-         */
-        TurnReason: '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';
-        /**
-         * TurnStartedPayload
-         * @description turn_started: the agent started on the turn's message.
-         */
-        TurnStartedPayload: {
-            /** Turn Id */
-            turn_id: string;
-            /** Turn Index */
-            turn_index: number;
-        } & {
-            [key: string]: unknown;
-        };
-        /** TurnStartedRecord */
-        TurnStartedRecord: {
-            /** Cost */
-            cost: number | null;
-            /**
-             * Created At
-             * Format: date-time
-             */
-            created_at: string;
-            /** Duration */
-            duration: number | null;
-            /**
-             * Feed Seq
-             * @description Position in the session feed and the stream's resume cursor.
-             */
-            feed_seq: number;
-            /**
-             * Id
-             * @description Unique identifier of the record.
-             */
-            id: string;
-            /**
-             * Kind
-             * @default platform
-             * @constant
-             */
-            kind: 'platform';
-            /** Model */
-            model: string | null;
-            payload: components['schemas']['TurnStartedPayload'];
-            /**
-             * Record Format
-             * @default ellipsis_lifecycle@1
-             * @constant
-             */
-            record_format: 'ellipsis_lifecycle@1';
-            /**
-             * @description discriminator enum property added by openapi-typescript
-             * @enum {string}
-             */
-            record_type: 'turn_started';
-            /**
-             * Session Id
-             * @description Session containing this record.
-             */
-            session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
-            /**
-             * Source
-             * @default lifecycle
-             * @constant
-             */
-            source: 'lifecycle';
-            tokens_info: components['schemas']['TokensInfo'] | null;
-            /** Tools */
-            tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
-        };
-        /**
-         * TurnStatus
-         * @description Where one turn is: waiting, preparing, being answered, or over.
-         *
-         *     `queued` turns wait to start, behind another turn or for a free session
-         *     slot on the account. `preparing` turns wait while the environment is set
-         *     up. `stopped` and `cancelled` are their own outcomes; `reason` explains a
-         *     `failed` or `cancelled` turn.
-         * @enum {string}
-         */
-        TurnStatus: 'queued' | 'preparing' | 'running' | 'completed' | 'failed' | 'stopped' | 'cancelled';
         /** UninstallGithubAppRequest */
         UninstallGithubAppRequest: {
             /** Confirm Account Login */
@@ -13069,6 +12728,11 @@ interface components {
              * @constant
              */
             kind: 'unknown';
+            /**
+             * Message 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.
+             */
+            message_id: string | null;
             /** Model */
             model: string | null;
             /** Payload */
@@ -13090,11 +12754,6 @@ interface components {
              * @description Session containing this record.
              */
             session_id: string;
-            /**
-             * Session Message Id
-             * @description Message this record receives, delivers, requeues, or echoes.
-             */
-            session_message_id: string | null;
             /**
              * Source
              * @description Original producer. Unknown producers remain readable as unknown records.
@@ -13103,11 +12762,6 @@ interface components {
             tokens_info: components['schemas']['TokensInfo'] | null;
             /** Tools */
             tools: string[] | null;
-            /**
-             * Turn Id
-             * @description Turn containing this record, when applicable.
-             */
-            turn_id: string | null;
         };
         /**
          * UpdateAgentRequest
@@ -17641,8 +17295,8 @@ interface operations {
                 author_id?: number | null;
                 /** @description "owner/name" (exact) or a bare repo name. Sessions whose repository is named only inside their agent — dashboard starts, cron — do not match. */
                 repo?: string | null;
-                /** @description Keep only sessions whose current turn is queued, preparing, or running. */
-                unfinished?: boolean;
+                /** @description Keep only sessions in these statuses. */
+                status?: components['schemas']['SessionStatus'][] | null;
             };
             header?: {
                 'user-agent'?: string | null;
@@ -17778,8 +17432,8 @@ interface operations {
                 session_ids?: string[] | null;
                 /** @description "owner/name" (exact) or a bare repo name; ORed. */
                 repo?: string[] | null;
-                /** @description Current turn statuses to keep. */
-                status?: components['schemas']['TurnStatus'][] | null;
+                /** @description Keep only sessions in these statuses. */
+                status?: components['schemas']['SessionStatus'][] | null;
                 start?: string | null;
                 end?: string | null;
                 limit?: number;
@@ -18363,6 +18017,8 @@ interface operations {
             query?: {
                 cursor?: string | null;
                 limit?: number | null;
+                /** @description Keep only the records of this message. */
+                message_id?: string | null;
             };
             header?: {
                 'user-agent'?: string | null;
@@ -18470,7 +18126,7 @@ interface operations {
                     'application/json': components['schemas']['ErrorResponse'];
                 };
             };
-            /** @description No turn is queued, preparing, or running. */
+            /** @description The session is idle or closed. */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -18614,127 +18270,6 @@ interface operations {
             };
         };
     };
-    get_session_turns: {
-        parameters: {
-            query?: never;
-            header?: {
-                'user-agent'?: string | null;
-            };
-            path: {
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['SessionTurnsListResponse'];
-                };
-            };
-            /** @description The bearer token is missing, invalid, or revoked. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description The credential may not perform this action, or the account is blocked. */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description No such session in your account. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description Validation Error */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
-                };
-            };
-        };
-    };
-    get_session_turn: {
-        parameters: {
-            query?: never;
-            header?: {
-                'user-agent'?: string | null;
-            };
-            path: {
-                session_id: string;
-                id: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['SessionTurnResponse'];
-                };
-            };
-            /** @description The bearer token is missing, invalid, or revoked. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description The credential may not perform this action, or the account is blocked. */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description No such session or turn in your account. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
-            /** @description Validation Error */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
-                };
-            };
-        };
-    };
     get_slack_help: {
         parameters: {
             query?: never;
@@ -19923,12 +19458,7 @@ interface operations {
 /**
  * One server-to-client frame of the Ellipsis session stream (WS /v1/sessions/{id}/stream). Clients ignore frames with unknown `type` values.
  */
-type SessionStreamFrame = SnapshotFrame | RecordsAppendFrame | SessionFrame | DeltaFrame | HeartbeatFrame | DoneFrame | ErrorFrame;
-type AttributionType = 'github_user' | 'linear_user' | 'slack_user' | 'api_key';
-/**
- * Delivery status of the message.
- */
-type SessionMessageStatus = 'pending' | 'delivered';
+type SessionStreamFrame = SessionFrame | RecordsFrame | DeltaFrame | HeartbeatFrame | ErrorFrame;
 /**
  * The session's current state.
  */
@@ -19961,6 +19491,10 @@ type Session = {
      */
     created_at: string;
     environment: SessionEnvironment;
+    /**
+     * Why the last message failed, was stopped, or was cancelled; null otherwise.
+     */
+    error: SessionError | null;
     /**
      * The typed external event that started the session; null for direct and scheduled starts.
      */
@@ -19988,7 +19522,7 @@ type Session = {
         [k: string]: string;
     };
     /**
-     * The session's structured output: the `json_schema` the agent must satisfy and, once a turn has submitted it, the `result`.
+     * The session's structured output: the `json_schema` the agent must satisfy and, once the agent has submitted it, the `result`.
      */
     output: SessionOutput | null;
     /**
@@ -20001,15 +19535,12 @@ type Session = {
      */
     skills: SkillRef[];
     source: SessionSource;
+    status: SessionStatus;
     /**
      * The latest live summary of the session's progress while it runs, and when it was generated.
      */
     summary: SessionSummary | null;
     tokens: Tokens;
-    /**
-     * 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.
-     */
-    turn: SessionTurn | null;
     /**
      * When the session was last updated.
      */
@@ -20133,14 +19664,11 @@ type StatusAction = 'pending' | 'passed' | 'failed' | 'errored';
  */
 type WorkflowRunAction = 'requested' | 'queued' | 'waiting' | 'pending' | 'started' | 'passed' | 'failed' | 'timed_out' | 'cancelled' | 'skipped' | 'neutral' | 'action_required' | 'stale' | 'startup_failure';
 type GithubAccountType = 'User' | 'Organization' | 'Bot' | 'Mannequin';
+type AttributionType = 'github_user' | 'linear_user' | 'slack_user' | 'api_key';
 /**
  * Why direct prompting is refused. Absent when prompting is allowed.
  */
 type PromptBlockedReason = 'mention_surface' | 'non_interactive' | 'harness_single_turn' | 'budget_exhausted' | 'closed';
-/**
- * `open` while the session can take messages; `closed` is permanent.
- */
-type SessionState = 'open' | 'closed';
 /**
  * How a session's environment was chosen. None (the field is nullable)
  * when the config carried an inline environment block and no resolution ran —
@@ -20150,6 +19678,10 @@ type SessionState = 'open' | 'closed';
  * how it was chosen, and is null for the built-in basic environment.
  */
 type EnvironmentSource = 'request' | 'agent' | 'repo_default' | 'account_default' | 'platform_default';
+/**
+ * What went wrong.
+ */
+type ErrorReason = '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';
 /**
  * The service the handler responds to.
  */
@@ -20159,320 +19691,136 @@ type HandlerService = 'slack' | 'github' | 'linear' | 'sentry';
  */
 type SessionSource = 'react' | 'code_review' | 'web' | 'api' | 'cli' | 'mention' | 'cron';
 /**
- * Why a turn failed or was cancelled. Null on every other outcome.
- */
-type TurnReason = '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';
-/**
- * Where the turn is.
+ * 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.
  */
-type TurnStatus = 'queued' | 'preparing' | 'running' | 'completed' | 'failed' | 'stopped' | 'cancelled';
+type SessionStatus = 'queued' | 'preparing' | 'running' | 'idle' | 'closed';
 type SessionRecord$1 = ClaudeSessionRecord | ClaudeNativeSessionRecord | CodexSessionRecord | CodexAppServerSessionRecord | GeminiSessionRecord | PlatformSessionRecord | UnknownSessionRecord;
 type CodexAppServerNotification = CodexThreadStarted | CodexTurnStarted | CodexTurnCompleted | CodexItemStarted | CodexItemCompleted | CodexTokenUsageUpdated | CodexAppServerError;
 type CodexAppServerItem = CodexUserMessage | CodexAgentMessage | CodexReasoning | CodexPlan | CodexCommandExecution | CodexFileChange | CodexWebSearch | CodexMcpToolCall | CodexContextCompaction | CodexSubAgentActivity | CodexCollabAgentToolCall;
 type CodexUserInput = CodexTextInput | CodexLocalImageInput;
 type GeminiStreamEvent$1 = GeminiInitEvent | GeminiMessageEvent | GeminiToolUseEvent | GeminiToolResultEvent | GeminiErrorEvent | GeminiResultEvent;
-type PlatformSessionRecord = SessionClosedRecord | MessageReceivedRecord | MessageDeliveredRecord | MessageRequeuedRecord | TurnQueuedRecord | TurnStartedRecord | TurnEndedRecord | EnvironmentPhaseRecord | EnvironmentOutputRecord | EnvironmentReadyRecord;
+type PlatformSessionRecord = SessionClosedRecord | MessageRecord | MessageQueuedRecord | MessageStartedRecord | MessageEndedRecord | MessageRequeuedRecord | EnvironmentPhaseRecord | EnvironmentOutputRecord | EnvironmentReadyRecord;
 /**
- * The session's current state.
+ * The whole session, last writer wins: the first frame after the stream
+ * connects, and resent whole whenever any field changes (status, error,
+ * cost). A `closed` status is the last one; a normal close (1000) follows.
  */
-type Session1 = {
-    /**
-     * The agent the session was started from, or null for a raw session started with POST /v1/sessions.
-     */
-    agent: SessionAgent | null;
+interface SessionFrame {
+    session: Session;
+    type: 'session';
+}
+/**
+ * The agent this session was started from: the definition frozen
+ * when the session was created, and the saved agent it came from as it
+ * exists NOW. They diverge legitimately — a YAML edit after the session
+ * started leaves the pointer describing something the session never ran.
+ */
+interface SessionAgent {
+    config: AgentConfig;
     /**
-     * When and by whom the session was archived; null when unarchived. Archiving does not stop or close a session.
+     * Identifier of the saved agent this session's snapshot was taken from. Null for a routing-file agent or the built-in mention agent, which have no saved agent behind them. Points at the agent as it exists now, which may have changed since.
      */
-    archived: SessionArchived | null;
-    attribution: SessionAttribution;
+    id: string | null;
+}
+/**
+ * The agent definition the session was started from, frozen when the session was created.
+ */
+interface AgentConfig {
+    ellipsis: AgentIdentity;
+    input: InputContract | null;
+    session: SessionConfig;
+    trigger: (CronTrigger | ReactTrigger) | null;
+}
+/**
+ * The Ellipsis product namespace for a config file: which schema this is
+ * (`version`), the human-facing identity (`name`/`description`), freeform
+ * organizational `metadata`, and whether the agent is `enabled`. The
+ * presence of a top-level `ellipsis:` mapping is what marks a YAML file as
+ * an Ellipsis agent (vs arbitrary YAML that merely lives under a
+ * config directory) — see `yaml_is_ellipsis_config`.
+ *
+ * `enabled` is agent behavior, not freeform metadata, so it stays inside
+ * the config `sha` (only `metadata` is sha-excluded).
+ */
+interface AgentIdentity {
+    description: string | null;
+    enabled: boolean;
+    kind: 'agent';
+    metadata: ConfigMetadata;
+    name: string | null;
+    version: string;
+}
+interface ConfigMetadata {
+    annotations: {
+        [k: string]: string;
+    };
+    labels: string[];
+}
+/**
+ * The typed input contract: what goes INTO a session (the trigger is
+ * when it happens; this is what goes in).
+ *
+ * `json_schema` validates customer data sent as `input` to
+ * `POST /v1/agents/{id}/sessions` (the dashboard and the CLI start
+ * through the same door) and stored as `session.input`. An on-demand
+ * start requires input when a schema is declared. A trigger fires
+ * without it: a cron fire has no payload and a react fire carries the
+ * platform-shaped event, so an agent may declare a schema alongside
+ * either trigger and the schema governs only its on-demand starts.
+ *
+ * `message` is the initial-message template: exact `{{path}}` substitution
+ * over the payload the session has (the caller payload on an on-demand
+ * start, the surface's published fields on a react fire, the empty
+ * object on a cron fire), no conditionals/loops/filters. Refs are
+ * validated at deploy time against every governing field set (see
+ * AgentConfig's `_check_input`): the caller schema's paths, the react
+ * surface's published fields, and both when the agent has a react trigger
+ * and a schema, so one template renders fully on either door (declare the
+ * surface's field names in the schema). Omit `message` to let each door
+ * render its default. An unresolved ref renders as the empty string (a
+ * cron fire, an optional field the payload omitted).
+ */
+interface InputContract {
+    json_schema: {
+        [k: string]: unknown;
+    } | null;
+    message: string | null;
+}
+/**
+ * A saved agent's spend limits: the per-session cap plus its total spend
+ * over the trailing 1, 7, and 28 days.
+ */
+interface BudgetConfig {
     /**
-     * The spend budget enforced for this session, in millicents, after resolving defaults and ceilings.
+     * The most the agent may spend over the last day, in US dollars.
      */
-    budget: number;
+    day: number | null;
     /**
-     * Claude Code input and native options. Set exactly one of claude_code, codex, or gemini.
+     * The most the agent may spend over the last 28 days, in US dollars.
      */
-    claude_code: ClaudeConfig | null;
+    month: number | null;
     /**
-     * Codex input and native options. Set exactly one of claude_code, codex, or gemini.
+     * The most one session may spend, in US dollars.
      */
-    codex: CodexConfig | null;
-    conversation: SessionConversation;
-    cost: Cost;
+    session: number | null;
     /**
-     * When the session was created.
+     * The most the agent may spend over the last 7 days, in US dollars.
      */
-    created_at: string;
-    environment: SessionEnvironment;
+    week: number | null;
+}
+/**
+ * Native Claude Code options for an explicitly selected harness.
+ */
+interface ClaudeConfig {
+    effort: EffortLevel | null;
+    fallback_model: string | null;
+    max_turns: number | null;
     /**
-     * The typed external event that started the session; null for direct and scheduled starts.
+     * The model the session runs on: an alias or canonical id from the models table. Required.
      */
-    event: (GithubPullRequestEvent | GithubIssueEvent | GithubPushEvent | GithubCheckRunEvent | GithubCheckSuiteEvent | GithubWorkflowRunEvent | GithubStatusEvent | GithubReleaseEvent | LinearIssueEvent | SlackMessageEvent | SlackChannelCreatedEvent | SentryAlertEvent) | null;
+    model: string;
     /**
-     * Gemini CLI input and native options. Set exactly one of claude_code, codex, or gemini.
-     */
-    gemini: GeminiConfig | null;
-    /**
-     * What the session did to git, one entry per repository in its workspace: the commit and branch it sits on, per-file line counts for its uncommitted changes, and the pull requests it opened. Null if nothing was ever captured.
-     */
-    git: SessionGit | null;
-    /**
-     * The saved handler and its effective display name when this session started, frozen at creation. Null for built-in responders, legacy sessions, and sessions started without a handler.
-     */
-    handler: SessionHandler | null;
-    /**
-     * Unique identifier of the session.
-     */
-    id: string;
-    /**
-     * Caller-supplied metadata key-value pairs.
-     */
-    metadata: {
-        [k: string]: string;
-    };
-    /**
-     * The session's structured output: the `json_schema` the agent must satisfy and, once a turn has submitted it, the `result`.
-     */
-    output: SessionOutput | null;
-    /**
-     * The predecessor session this session continues; null when there is none.
-     */
-    parent: SessionParent | null;
-    permissions: PermissionsConfig1;
-    /**
-     * Skills installed for this session.
-     */
-    skills: SkillRef[];
-    source: SessionSource;
-    /**
-     * The latest live summary of the session's progress while it runs, and when it was generated.
-     */
-    summary: SessionSummary | null;
-    tokens: Tokens;
-    /**
-     * 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.
-     */
-    turn: SessionTurn | null;
-    /**
-     * When the session was last updated.
-     */
-    updated_at: string;
-} & ({
-    claude_code: {
-        [k: string]: unknown;
-    };
-    codex: null;
-    gemini: null;
-} | {
-    claude_code: null;
-    codex: {
-        [k: string]: unknown;
-    };
-    gemini: null;
-} | {
-    claude_code: null;
-    codex: null;
-    gemini: {
-        [k: string]: unknown;
-    };
-});
-/**
- * The first frame after the stream connects: the session plus its open
- * inbox. Records always arrive separately via records_append frames.
- */
-interface SnapshotFrame {
-    /**
-     * The retention head: the lowest feed_seq still stored for this session, or null when it has no stored records. A client resuming from after_seq < earliest_feed_seq - 1 knows history is truncated.
-     */
-    earliest_feed_seq: number | null;
-    /**
-     * The session's open (pending) inbox messages.
-     */
-    messages: SessionMessage[];
-    session: Session;
-    type: 'snapshot';
-}
-/**
- * One message in a session's inbox: what a queued message renders and
- * retires on. The webhook provenance internals stay off the wire.
- */
-interface SessionMessage {
-    /**
-     * Display attribution of the message's sender.
-     */
-    author: string | null;
-    /**
-     * The message text, with one `[Image #N]` placeholder per attached image.
-     */
-    body: string;
-    /**
-     * When the message was created.
-     */
-    created_at: string;
-    /**
-     * When the message was delivered to the agent, if it has been.
-     */
-    delivered_at: string | null;
-    /**
-     * Where the message sits in the session's feed — placement metadata only, NOT a resume cursor (only records_append frames advance the cursor). Null for older rows.
-     */
-    feed_seq: number | null;
-    /**
-     * Unique identifier of the message.
-     */
-    id: string;
-    /**
-     * Images attached to the message, metadata only: index, media type, size. The bytes go to the model, never over the stream.
-     */
-    images: SessionMessageImage[];
-    /**
-     * Identifier of the principal that sent the message, if attributed.
-     */
-    sender_attribution_id: string | null;
-    /**
-     * Kind of principal that sent the message, if attributed.
-     */
-    sender_attribution_type: AttributionType | null;
-    /**
-     * Identifier of the session the message belongs to.
-     */
-    session_id: string;
-    status: SessionMessageStatus;
-    /**
-     * The turn created to answer this message. Wait on it: the message is answered when that turn reaches a final status.
-     */
-    turn_id: string | null;
-}
-/**
- * One image on a message, metadata only. `index` is the N in the
- * `[Image #N]` placeholder in the message body.
- */
-interface SessionMessageImage {
-    /**
-     * 1-based position: the N in `[Image #N]`.
-     */
-    index: number;
-    /**
-     * The image's MIME type.
-     */
-    media_type: string;
-    /**
-     * Size of the decoded image, in bytes.
-     */
-    size_bytes: number;
-}
-/**
- * The agent this session was started from: the definition frozen
- * when the session was created, and the saved agent it came from as it
- * exists NOW. They diverge legitimately — a YAML edit after the session
- * started leaves the pointer describing something the session never ran.
- */
-interface SessionAgent {
-    config: AgentConfig;
-    /**
-     * Identifier of the saved agent this session's snapshot was taken from. Null for a routing-file agent or the built-in mention agent, which have no saved agent behind them. Points at the agent as it exists now, which may have changed since.
-     */
-    id: string | null;
-}
-/**
- * The agent definition the session was started from, frozen when the session was created.
- */
-interface AgentConfig {
-    ellipsis: AgentIdentity;
-    input: InputContract | null;
-    session: SessionConfig;
-    trigger: (CronTrigger | ReactTrigger) | null;
-}
-/**
- * The Ellipsis product namespace for a config file: which schema this is
- * (`version`), the human-facing identity (`name`/`description`), freeform
- * organizational `metadata`, and whether the agent is `enabled`. The
- * presence of a top-level `ellipsis:` mapping is what marks a YAML file as
- * an Ellipsis agent (vs arbitrary YAML that merely lives under a
- * config directory) — see `yaml_is_ellipsis_config`.
- *
- * `enabled` is agent behavior, not freeform metadata, so it stays inside
- * the config `sha` (only `metadata` is sha-excluded).
- */
-interface AgentIdentity {
-    description: string | null;
-    enabled: boolean;
-    kind: 'agent';
-    metadata: ConfigMetadata;
-    name: string | null;
-    version: string;
-}
-interface ConfigMetadata {
-    annotations: {
-        [k: string]: string;
-    };
-    labels: string[];
-}
-/**
- * The typed input contract: what goes INTO a session (the trigger is
- * when it happens; this is what goes in).
- *
- * `json_schema` validates customer data sent as `input` to
- * `POST /v1/agents/{id}/sessions` (the dashboard and the CLI start
- * through the same door) and stored as `session.input`. An on-demand
- * start requires input when a schema is declared. A trigger fires
- * without it: a cron fire has no payload and a react fire carries the
- * platform-shaped event, so an agent may declare a schema alongside
- * either trigger and the schema governs only its on-demand starts.
- *
- * `message` is the initial-message template: exact `{{path}}` substitution
- * over the payload the session has (the caller payload on an on-demand
- * start, the surface's published fields on a react fire, the empty
- * object on a cron fire), no conditionals/loops/filters. Refs are
- * validated at deploy time against every governing field set (see
- * AgentConfig's `_check_input`): the caller schema's paths, the react
- * surface's published fields, and both when the agent has a react trigger
- * and a schema, so one template renders fully on either door (declare the
- * surface's field names in the schema). Omit `message` to let each door
- * render its default. An unresolved ref renders as the empty string (a
- * cron fire, an optional field the payload omitted).
- */
-interface InputContract {
-    json_schema: {
-        [k: string]: unknown;
-    } | null;
-    message: string | null;
-}
-/**
- * A saved agent's spend limits: the per-session cap plus its total spend
- * over the trailing 1, 7, and 28 days.
- */
-interface BudgetConfig {
-    /**
-     * The most the agent may spend over the last day, in US dollars.
-     */
-    day: number | null;
-    /**
-     * The most the agent may spend over the last 28 days, in US dollars.
-     */
-    month: number | null;
-    /**
-     * The most one session may spend, in US dollars.
-     */
-    session: number | null;
-    /**
-     * The most the agent may spend over the last 7 days, in US dollars.
-     */
-    week: number | null;
-}
-/**
- * Native Claude Code options for an explicitly selected harness.
- */
-interface ClaudeConfig {
-    effort: EffortLevel | null;
-    fallback_model: string | null;
-    max_turns: number | null;
-    /**
-     * The model the session runs on: an alias or canonical id from the models table. Required.
-     */
-    model: string;
-    /**
-     * The initial user message, passed verbatim. Omit to start an interactive session with no turn, waiting for a message.
+     * The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.
      */
     prompt: string | null;
     settings: SettingsRef | null;
@@ -20497,7 +19845,7 @@ interface RepositoryRef {
  */
 interface CodexConfig {
     /**
-     * Reasoning effort for every turn. Omit to use the model default.
+     * Reasoning effort for every message. Omit to use the model default.
      */
     effort: CodexEffortLevel | null;
     /**
@@ -20505,7 +19853,7 @@ interface CodexConfig {
      */
     model: string;
     /**
-     * The initial user message, passed verbatim. Omit to start an interactive session with no turn, waiting for a message.
+     * The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.
      */
     prompt: string | null;
 }
@@ -20514,7 +19862,7 @@ interface CodexConfig {
  */
 interface SessionConversationConfig {
     /**
-     * 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.
+     * 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.
      */
     interactive: boolean;
 }
@@ -20708,7 +20056,7 @@ interface GeminiConfig {
      */
     model: string;
     /**
-     * The initial user message, passed verbatim. Omit to start an interactive session with no turn, waiting for a message.
+     * The initial user message, passed verbatim. Omit to start an interactive session with no message, waiting for one.
      */
     prompt: string | null;
 }
@@ -20985,11 +20333,10 @@ interface SessionAttribution {
  */
 interface SessionConversation {
     /**
-     * Whether the session stays open after its first turn.
+     * Whether the session stays open after its first message is answered.
      */
     interactive: boolean;
     prompting: SessionPrompting;
-    state: SessionState;
     /**
      * 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.
      */
@@ -21005,7 +20352,7 @@ interface SessionPrompting {
     surface_name: string | null;
 }
 /**
- * What the session has cost so far.
+ * What something cost, in millicents.
  */
 interface Cost {
     /**
@@ -21167,6 +20514,17 @@ interface EnvironmentHooks1 {
      */
     validate: EnvironmentScript | string | null;
 }
+/**
+ * Why the last message failed, was stopped, or was cancelled. Cleared
+ * when the next message starts.
+ */
+interface SessionError {
+    /**
+     * A human-readable explanation.
+     */
+    detail: string | null;
+    reason: ErrorReason;
+}
 interface GithubPullRequestEvent {
     action: PullRequestAction | 'review_commented';
     actor: SessionEventActor | null;
@@ -21372,9 +20730,9 @@ interface SessionHandler {
     sha: string;
 }
 /**
- * Structured output on the wire: the contract and, when a turn has
+ * Structured output on the wire: the contract and, when the agent has
  * submitted one, the payload. `result` is None while the session runs and
- * when no turn submitted anything; it is the agent's own JSON, in the
+ * when the agent submitted nothing; it is the agent's own JSON, in the
  * shape of `json_schema`.
  */
 interface SessionOutput {
@@ -21385,7 +20743,7 @@ interface SessionOutput {
         [k: string]: unknown;
     };
     /**
-     * The payload the agent submitted, or null until a turn submits one.
+     * The payload the agent submitted, or null until it submits one.
      */
     result: {
         [k: string]: unknown;
@@ -21422,7 +20780,7 @@ interface SessionSummary {
     description: string;
 }
 /**
- * The tokens the session has used so far.
+ * Tokens used, in total and by model.
  */
 interface Tokens {
     all: TokenCounts;
@@ -21485,109 +20843,17 @@ interface ModelTokenCounts {
      */
     total: number;
 }
-/**
- * One message and the agent's answer to it. A turn is `queued` from the
- * moment its message is received, `preparing` while its environment is set
- * up, `running` while the agent works, then `completed`, `failed`,
- * `stopped`, or `cancelled`.
- */
-interface SessionTurn {
-    cost: Cost1;
-    /**
-     * When the turn's message was received.
-     */
-    created_at: string;
-    /**
-     * A human-readable explanation of a failed, stopped, or cancelled turn, or of why a queued turn waits.
-     */
-    detail: string | null;
-    /**
-     * When the turn reached its final status.
-     */
-    ended_at: string | null;
-    /**
-     * Unique identifier of the turn.
-     */
-    id: string;
-    /**
-     * Position in the session, starting at 0.
-     */
-    index: number;
-    /**
-     * Why the turn failed or was cancelled; null on every other status.
-     */
-    reason: TurnReason | null;
-    /**
-     * When the agent started on the message.
-     */
-    started_at: string | null;
-    status: TurnStatus;
-    /**
-     * When and by whom a stop was requested; null when none was.
-     */
-    stopped: SessionStopped | null;
-    tokens: Tokens1;
-}
-/**
- * What the turn cost so far, in millicents, broken down by leg.
- */
-interface Cost1 {
-    /**
-     * What Ellipsis charged to credit, in millicents. It is everything except subscription tokens.
-     */
-    charged: number;
-    /**
-     * CPU spend in millicents.
-     */
-    cpu: number;
-    /**
-     * Platform fee in millicents.
-     */
-    fee: number;
-    llm: LlmCost;
-    /**
-     * Memory spend in millicents.
-     */
-    memory: number;
-    /**
-     * Everything it cost, whoever paid, in millicents. It is the sum of llm.all.total, cpu, memory, and fee, and it is what the budget caps.
-     */
-    total: number;
-}
-/**
- * When a stop was requested and the GitHub user who requested it.
- */
-interface SessionStopped {
-    /**
-     * When a stop was requested.
-     */
-    at: string;
-    /**
-     * The GitHub user who stopped the session, resolved at read time. Null if the user is unknown or unavailable.
-     */
-    by: GithubAccountSnippet | null;
-}
-/**
- * The tokens the turn spent and the model they went to.
- */
-interface Tokens1 {
-    all: TokenCounts;
-    /**
-     * Token counts for each model that used tokens.
-     */
-    by_model: ModelTokenCounts[];
-}
 /**
  * Cursored append-only delivery of session records, ordered by feed_seq,
- * from all sources. Every record in the frame advances the resume cursor —
+ * from all sources. Every record in the frame advances the resume cursor,
  * including ones a client renders as nothing.
  */
-interface RecordsAppendFrame {
+interface RecordsFrame {
     /**
      * New session records, ordered by feed_seq.
      */
     records: SessionRecord$1[];
-    type: 'records_append';
+    type: 'records';
 }
 /**
  * Historical Claude SDK projection, retained for existing session history.
@@ -21605,6 +20871,10 @@ interface ClaudeSessionRecord {
      */
     id: string;
     kind: 'claude_sdk';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
     payload: LegacyAssistantPayload | SdkUserRecord$1 | SdkSystemRecord$1 | LegacyResultPayload | SdkRateLimitRecord$1;
     record_format: 'claude_sdk@1';
@@ -21616,17 +20886,9 @@ interface ClaudeSessionRecord {
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'claude_code';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 interface LegacyAssistantPayload {
     cache_creation?: SdkCacheCreation | null;
@@ -21803,6 +21065,10 @@ interface ClaudeNativeSessionRecord {
      */
     id: string;
     kind: 'claude_code';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
     payload: ClaudeAssistantEvent | ClaudeUserEvent | ClaudeSystemEvent | ClaudeResultEvent | ClaudeRateLimitEvent | ClaudeConversationResetEvent;
     record_format: 'claude_jsonl@1';
@@ -21814,17 +21080,9 @@ interface ClaudeNativeSessionRecord {
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'claude_code';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 interface ClaudeAssistantEvent {
     error?: string | null;
@@ -21936,6 +21194,10 @@ interface CodexSessionRecord {
      */
     id: string;
     kind: 'codex';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
     payload: CodexThreadStartedEvent | CodexTurnStartedEvent | CodexTurnCompletedEvent | CodexTurnFailedEvent | CodexErrorEvent | CodexItemStartedEvent | CodexItemUpdatedEvent | CodexItemCompletedEvent;
     record_format: 'codex_jsonl@1';
@@ -21947,17 +21209,9 @@ interface CodexSessionRecord {
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'codex';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 interface CodexThreadStartedEvent {
     thread_id?: string | null;
@@ -22092,6 +21346,10 @@ interface CodexAppServerSessionRecord {
      */
     id: string;
     kind: 'codex_app_server';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
     payload: CodexAppServerNotification;
     record_format: 'codex_app_server@1';
@@ -22103,17 +21361,9 @@ interface CodexAppServerSessionRecord {
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'codex';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 interface CodexThreadStarted {
     method: 'thread/started';
@@ -22372,6 +21622,10 @@ interface GeminiSessionRecord {
      */
     id: string;
     kind: 'gemini';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
     payload: GeminiStreamEvent$1;
     record_format: 'gemini_stream_json@1';
@@ -22383,17 +21637,9 @@ interface GeminiSessionRecord {
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'gemini';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 interface GeminiInitEvent {
     model: string;
@@ -22483,6 +21729,10 @@ interface SessionClosedRecord {
      */
     id: string;
     kind: 'platform';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
     payload: SessionClosedPayload;
     record_format: 'ellipsis_lifecycle@1';
@@ -22491,25 +21741,17 @@ interface SessionClosedRecord {
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'lifecycle';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 /**
- * session_closed: the conversation closed permanently.
+ * session_closed: the session closed permanently.
  */
 interface SessionClosedPayload {
     [k: string]: unknown;
 }
-interface MessageReceivedRecord {
+interface MessageRecord {
     cost: number | null;
     created_at: string;
     duration: number | null;
@@ -22522,41 +21764,74 @@ interface MessageReceivedRecord {
      */
     id: string;
     kind: 'platform';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
-    payload: MessageReceivedPayload;
+    payload: SessionMessage;
     record_format: 'ellipsis_lifecycle@1';
-    record_type: 'message_received';
+    record_type: 'message';
     /**
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'lifecycle';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
+}
+/**
+ * One message sent to a session.
+ */
+interface SessionMessage {
     /**
-     * Turn containing this record, when applicable.
+     * Display attribution of the message's sender.
+     */
+    author: string | null;
+    /**
+     * The message text, with one `[Image #N]` placeholder per attached image.
+     */
+    body: string;
+    /**
+     * When the message was received.
+     */
+    created_at: string;
+    /**
+     * Unique identifier of the message.
+     */
+    id: string;
+    /**
+     * Images attached to the message, metadata only: index, media type, size. The bytes go to the model, never over the stream.
      */
-    turn_id: string | null;
+    images: SessionMessageImage[];
+    /**
+     * Position in the session, starting at 0.
+     */
+    index: number;
+    /**
+     * Identifier of the session the message belongs to.
+     */
+    session_id: string;
 }
 /**
- * message_received: a message landed in the session inbox and its turn was
- * created. `turn_id` is the turn that will answer it.
+ * One image on a message, metadata only. `index` is the N in the
+ * `[Image #N]` placeholder in the message body.
  */
-interface MessageReceivedPayload {
-    author?: string | null;
-    body: string;
-    closes_session?: boolean;
-    message_id: string;
-    sender_attribution_id?: string | null;
-    sender_attribution_type?: string | null;
-    turn_id?: string | null;
-    [k: string]: unknown;
+interface SessionMessageImage {
+    /**
+     * 1-based position: the N in `[Image #N]`.
+     */
+    index: number;
+    /**
+     * The image's MIME type.
+     */
+    media_type: string;
+    /**
+     * Size of the decoded image, in bytes.
+     */
+    size_bytes: number;
 }
-interface MessageDeliveredRecord {
+interface MessageQueuedRecord {
     cost: number | null;
     created_at: string;
     duration: number | null;
@@ -22569,35 +21844,33 @@ interface MessageDeliveredRecord {
      */
     id: string;
     kind: 'platform';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
-    payload: MessageDeliveredPayload;
+    payload: MessageQueuedPayload;
     record_format: 'ellipsis_lifecycle@1';
-    record_type: 'message_delivered';
+    record_type: 'message_queued';
     /**
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'lifecycle';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 /**
- * message_delivered: the agent started on the message.
+ * message_queued: the message waits because the account already has
+ * `sessions_alive` sessions alive, its limit.
  */
-interface MessageDeliveredPayload {
+interface MessageQueuedPayload {
+    limit: number;
     message_id: string;
-    turn_id: string;
+    sessions_alive: number;
     [k: string]: unknown;
 }
-interface MessageRequeuedRecord {
+interface MessageStartedRecord {
     cost: number | null;
     created_at: string;
     duration: number | null;
@@ -22610,37 +21883,30 @@ interface MessageRequeuedRecord {
      */
     id: string;
     kind: 'platform';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
-    payload: MessageRequeuedPayload;
+    payload: MessageStartedPayload;
     record_format: 'ellipsis_lifecycle@1';
-    record_type: 'message_requeued';
+    record_type: 'message_started';
     /**
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'lifecycle';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 /**
- * message_requeued: a turn was interrupted before answering, so the
- * message goes back to the inbox with a new queued turn.
+ * message_started: the agent started on the message.
  */
-interface MessageRequeuedPayload {
+interface MessageStartedPayload {
     message_id: string;
-    requeued_turn_id?: string | null;
-    turn_id: string;
     [k: string]: unknown;
 }
-interface TurnQueuedRecord {
+interface MessageEndedRecord {
     cost: number | null;
     created_at: string;
     duration: number | null;
@@ -22653,78 +21919,75 @@ interface TurnQueuedRecord {
      */
     id: string;
     kind: 'platform';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
-    payload: TurnQueuedPayload;
+    payload: MessageEndedPayload$1;
     record_format: 'ellipsis_lifecycle@1';
-    record_type: 'turn_queued';
+    record_type: 'message_ended';
     /**
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'lifecycle';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 /**
- * turn_queued: the turn waits because the account already has
- * `sessions_alive` sessions alive, its limit.
+ * message_ended: the message was answered, or its answer failed, was
+ * stopped, or was cancelled. `error` is the same object as the session's
+ * `error`, null when the message was answered. `cost` and `tokens` are what
+ * answering it spent. Messages answered together report the spend once, on
+ * the last of them.
  */
-interface TurnQueuedPayload {
-    limit: number;
-    sessions_alive: number;
-    turn_id: string;
+interface MessageEndedPayload$1 {
+    cost?: Cost1;
+    duration_ms?: number | null;
+    error?: SessionError | null;
+    message_id: string;
+    status: string;
+    tokens?: Tokens1;
     [k: string]: unknown;
 }
-interface TurnStartedRecord {
-    cost: number | null;
-    created_at: string;
-    duration: number | null;
+/**
+ * What something cost, in millicents.
+ */
+interface Cost1 {
     /**
-     * Position in the session feed and the stream's resume cursor.
+     * What Ellipsis charged to credit, in millicents. It is everything except subscription tokens.
      */
-    feed_seq: number;
+    charged: number;
     /**
-     * Unique identifier of the record.
+     * CPU spend in millicents.
      */
-    id: string;
-    kind: 'platform';
-    model: string | null;
-    payload: TurnStartedPayload;
-    record_format: 'ellipsis_lifecycle@1';
-    record_type: 'turn_started';
+    cpu: number;
     /**
-     * Session containing this record.
+     * Platform fee in millicents.
      */
-    session_id: string;
+    fee: number;
+    llm: LlmCost;
     /**
-     * Message this record receives, delivers, requeues, or echoes.
+     * Memory spend in millicents.
      */
-    session_message_id: string | null;
-    source: 'lifecycle';
-    tokens_info: TokensInfo | null;
-    tools: string[] | null;
+    memory: number;
     /**
-     * Turn containing this record, when applicable.
+     * Everything it cost, whoever paid, in millicents. It is the sum of llm.all.total, cpu, memory, and fee, and it is what the budget caps.
      */
-    turn_id: string | null;
+    total: number;
 }
 /**
- * turn_started: the agent started on the turn's message.
+ * Tokens used, in total and by model.
  */
-interface TurnStartedPayload {
-    turn_id: string;
-    turn_index: number;
-    [k: string]: unknown;
+interface Tokens1 {
+    all: TokenCounts;
+    /**
+     * Token counts for each model that used tokens.
+     */
+    by_model: ModelTokenCounts[];
 }
-interface TurnEndedRecord {
+interface MessageRequeuedRecord {
     cost: number | null;
     created_at: string;
     duration: number | null;
@@ -22737,37 +22000,28 @@ interface TurnEndedRecord {
      */
     id: string;
     kind: 'platform';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
-    payload: TurnEndedPayload;
+    payload: MessageRequeuedPayload;
     record_format: 'ellipsis_lifecycle@1';
-    record_type: 'turn_ended';
+    record_type: 'message_requeued';
     /**
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'lifecycle';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 /**
- * turn_ended: the turn reached its final status. `status`, `reason`, and
- * `detail` match the turn on the session object.
+ * message_requeued: the agent was interrupted before answering, so the
+ * message goes back to the inbox and starts again on a fresh environment.
  */
-interface TurnEndedPayload {
-    detail?: string | null;
-    duration_ms?: number | null;
-    reason?: string | null;
-    status: string;
-    turn_id: string;
-    turn_index: number;
+interface MessageRequeuedPayload {
+    message_id: string;
     [k: string]: unknown;
 }
 interface EnvironmentPhaseRecord {
@@ -22783,6 +22037,10 @@ interface EnvironmentPhaseRecord {
      */
     id: string;
     kind: 'platform';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
     payload: EnvironmentPhasePayload;
     record_format: 'ellipsis_lifecycle@1';
@@ -22791,17 +22049,9 @@ interface EnvironmentPhaseRecord {
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'lifecycle';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 /**
  * environment_phase: one transition of environment preparation, so clients
@@ -22831,6 +22081,10 @@ interface EnvironmentOutputRecord {
      */
     id: string;
     kind: 'platform';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
     payload: EnvironmentOutputPayload;
     record_format: 'ellipsis_lifecycle@1';
@@ -22839,22 +22093,14 @@ interface EnvironmentOutputRecord {
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'lifecycle';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 /**
  * environment_output: one chunk of output from preparing the environment,
- * including the customer's own hooks. Many fire per turn; `chunk` orders them
- * within a step.
+ * including the customer's own hooks. Many fire per message; `chunk` orders
+ * them within a step.
  */
 interface EnvironmentOutputPayload {
     chunk: number;
@@ -22877,6 +22123,10 @@ interface EnvironmentReadyRecord {
      */
     id: string;
     kind: 'platform';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
     payload: EnvironmentReadyPayload;
     record_format: 'ellipsis_lifecycle@1';
@@ -22885,17 +22135,9 @@ interface EnvironmentReadyRecord {
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     source: 'lifecycle';
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
 }
 /**
  * environment_ready: the environment is prepared and the agent is about
@@ -22922,6 +22164,10 @@ interface UnknownSessionRecord {
      */
     id: string;
     kind: 'unknown';
+    /**
+     * 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.
+     */
+    message_id: string | null;
     model: string | null;
     payload: {
         [k: string]: unknown;
@@ -22938,28 +22184,12 @@ interface UnknownSessionRecord {
      * Session containing this record.
      */
     session_id: string;
-    /**
-     * Message this record receives, delivers, requeues, or echoes.
-     */
-    session_message_id: string | null;
     /**
      * Original producer. Unknown producers remain readable as unknown records.
      */
     source: string;
     tokens_info: TokensInfo | null;
     tools: string[] | null;
-    /**
-     * Turn containing this record, when applicable.
-     */
-    turn_id: string | null;
-}
-/**
- * A last-writer-wins snapshot of the session: the only way turn,
- * conversation, and cost updates arrive. Resent whole on any field change.
- */
-interface SessionFrame {
-    session: Session1;
-    type: 'session';
 }
 /**
  * Fire-and-forget partial assistant output for the current response.
@@ -22971,6 +22201,10 @@ interface DeltaFrame {
      * Known values: text (append assistant output), thinking (replace the readable reasoning-summary preview). Open vocabulary: ignore deltas with unknown kinds.
      */
     kind: string;
+    /**
+     * Identifier of the message being answered, if known.
+     */
+    message_id: string | null;
     /**
      * Output tokens generated so far for the current response.
      */
@@ -22979,10 +22213,6 @@ interface DeltaFrame {
      * For "text", an append-only fragment. For "thinking", the first-line prefix of the latest summary section (at most 512 characters); replace the preview, and clear it on an empty string. Null means no text update.
      */
     text: string | null;
-    /**
-     * Identifier of the turn the delta belongs to, if known.
-     */
-    turn_id: string | null;
     type: 'delta';
 }
 /**
@@ -22997,13 +22227,6 @@ interface HeartbeatFrame {
     ts: string;
     type: 'heartbeat';
 }
-/**
- * Terminal marker: the conversation is over, after the final session
- * frame carried the end state. Followed by a normal close (1000).
- */
-interface DoneFrame {
-    type: 'done';
-}
 /**
  * Terminal error marker, sent before the server closes with code 1011.
  */
@@ -23015,7 +22238,7 @@ interface ErrorFrame {
     type: 'error';
 }
 
-type SessionRecord = RecordsAppendFrame['records'][number];
+type SessionRecord = RecordsFrame['records'][number];
 type LifecycleSessionRecord = PlatformSessionRecord;
 type ClaudeNativeEvent = ClaudeNativeSessionRecord['payload'];
 type SdkRecord = ClaudeSessionRecord['payload'];
@@ -23045,8 +22268,7 @@ type StreamFrame = SessionStreamFrame;
 type SendSessionMessageRequest = components['schemas']['SendSessionMessageRequest'];
 type SessionRecordsListResponse = components['schemas']['SessionRecordsListResponse'];
 type SessionResponse = components['schemas']['SessionResponse'];
-type SessionTurnResponse = components['schemas']['SessionTurnResponse'];
-type SessionTurnsListResponse = components['schemas']['SessionTurnsListResponse'];
+type MessageEndedPayload = components['schemas']['MessageEndedPayload'];
 type UpdateSessionRequest = components['schemas']['UpdateSessionRequest'];
 type SessionMessageResponse = components['schemas']['SessionMessageResponse'];
 type SessionsListResponse = components['schemas']['SessionsListResponse'];
@@ -23060,4 +22282,4 @@ type ReviewsListResponse = components['schemas']['ReviewsListResponse'];
 type ReviewConfig = components['schemas']['ReviewConfig'];
 type ReviewConfigsListResponse = components['schemas']['ReviewConfigsListResponse'];
 
-export type { CodexMcpToolCallResult as $, AgentConfig as A, BudgetConfig as B, CheckRunAction as C, CodexCommandExecution as D, CodexCommandExecutionItem as E, CodexConfig as F, CodexContextCompaction as G, CodexEffortLevel as H, CodexErrorEvent as I, CodexErrorItem as J, CodexErrorParams as K, CodexEvent as L, CodexFileChange as M, CodexFileChangeItem as N, CodexFileUpdate as O, CodexItem as P, CodexItemCompleted as Q, CodexItemCompletedEvent as R, CodexItemParams as S, CodexItemStarted as T, CodexItemStartedEvent as U, CodexItemUpdatedEvent as V, CodexLocalImageInput as W, CodexMcpToolCall as X, CodexMcpToolCallAppContext as Y, CodexMcpToolCallError as Z, CodexMcpToolCallItem as _, AgentIdentity as a, GeminiToolError as a$, CodexPlan as a0, CodexReasoning as a1, CodexReasoningItem as a2, CodexSessionRecord as a3, CodexSubAgentActivity as a4, CodexTextInput as a5, CodexThread as a6, CodexThreadStarted as a7, CodexThreadStartedEvent as a8, CodexThreadStartedParams as a9, Duration as aA, EffortLevel as aB, EllipsisGrant as aC, EllipsisPermissions as aD, EnvironmentBaseBuild as aE, EnvironmentConfig as aF, EnvironmentHooks as aG, EnvironmentHooks1 as aH, EnvironmentOutputPayload as aI, EnvironmentOutputRecord as aJ, EnvironmentPhasePayload as aK, EnvironmentPhaseRecord as aL, EnvironmentReadyPayload as aM, EnvironmentReadyRecord as aN, EnvironmentScript as aO, EnvironmentSource as aP, EnvironmentVariable as aQ, ErrorFrame as aR, GeminiConfig as aS, GeminiErrorEvent as aT, GeminiInitEvent as aU, GeminiMessageEvent as aV, GeminiModelStats as aW, GeminiResultEvent as aX, GeminiSessionRecord as aY, GeminiStreamEvent as aZ, GeminiStreamStats as a_, CodexThreadTokenUsage as aa, CodexTodoListItem as ab, CodexTokenUsageBreakdown as ac, CodexTokenUsageParams as ad, CodexTokenUsageUpdated as ae, CodexTurn as af, CodexTurnCompleted as ag, CodexTurnCompletedEvent as ah, CodexTurnError as ai, CodexTurnFailedEvent as aj, CodexTurnParams as ak, CodexTurnStarted as al, CodexTurnStartedEvent as am, CodexUsage as an, CodexUserInput as ao, CodexUserMessage as ap, CodexWebSearch as aq, CodexWebSearchItem as ar, ComputeConfig as as, ComputeConfig1 as at, ConfigMetadata as au, Cost as av, Cost1 as aw, CronTrigger as ax, DeltaFrame as ay, DoneFrame as az, AttributionType as b, ReviewComment as b$, GeminiToolResultEvent as b0, GeminiToolUseEvent as b1, GithubAccountFilter as b2, GithubAccountSelector as b3, GithubAccountSnippet as b4, GithubAccountType as b5, GithubCheckRunEvent as b6, GithubCheckSuiteEvent as b7, GithubIssueEvent as b8, GithubPermissions as b9, MessageRequeuedPayload as bA, MessageRequeuedRecord as bB, ModelLlmCostSplit as bC, ModelTokenCounts as bD, OutputConfig as bE, PermissionsConfig as bF, PermissionsConfig1 as bG, PlatformSessionRecord as bH, PromptBlockedReason as bI, PullRequestAction as bJ, ReactCheckRun as bK, ReactCheckSuite as bL, ReactIssue as bM, ReactLinearIssue as bN, ReactPullRequest as bO, ReactPush as bP, ReactRelease as bQ, ReactSentry as bR, ReactSlackChannel as bS, ReactStatus as bT, ReactTrigger as bU, ReactWorkflowRun as bV, RecordsAppendFrame as bW, ReleaseAction as bX, RepositoryFilter as bY, RepositoryRef as bZ, Review as b_, GithubPullRequestEvent as ba, GithubPushEvent as bb, GithubReleaseEvent as bc, GithubStatusEvent as bd, GithubWorkflowRunEvent as be, HandlerService as bf, HeartbeatFrame as bg, InputContract as bh, IssueAction as bi, LegacyAssistantPayload as bj, LegacyNativeUsage as bk, LegacyResultPayload as bl, Level as bm, LifecycleSessionRecord as bn, LinearIssueAction as bo, LinearIssueEvent as bp, LlmCost as bq, LlmCostSplit as br, McpRemoteServer as bs, McpServerRef as bt, McpStdioServer as bu, MemorySize as bv, MessageDeliveredPayload as bw, MessageDeliveredRecord as bx, MessageReceivedPayload as by, MessageReceivedRecord as bz, components as c, SkillRef as c$, ReviewConfig as c0, ReviewConfigsListResponse as c1, ReviewPullRequest as c2, ReviewPullRequestAuthor as c3, ReviewReviewer as c4, ReviewSummary as c5, ReviewsListResponse as c6, SdkAssistantRecord as c7, SdkCacheCreation as c8, SdkContentBlock as c9, SessionFrame as cA, SessionGit as cB, SessionGitCommit as cC, SessionGitFile as cD, SessionGitPr as cE, SessionGitRepo as cF, SessionHandler as cG, SessionMessage as cH, SessionMessageImage as cI, SessionMessageResponse as cJ, SessionMessageStatus as cK, SessionOutput as cL, SessionParent as cM, SessionPrompting as cN, SessionRecord as cO, SessionRecordsListResponse as cP, SessionResponse as cQ, SessionSource as cR, SessionState as cS, SessionStopped as cT, SessionStreamFrame as cU, SessionSummary as cV, SessionTurn as cW, SessionTurnResponse as cX, SessionTurnsListResponse as cY, SessionsListResponse as cZ, SettingsRef as c_, SdkRateLimitRecord as ca, SdkRecord as cb, SdkResultRecord as cc, SdkServerToolResultBlock as cd, SdkServerToolUseBlock as ce, SdkSystemRecord as cf, SdkTextBlock as cg, SdkThinkingBlock as ch, SdkToolResultBlock as ci, SdkToolUseBlock as cj, SdkUserRecord as ck, SendSessionMessageRequest as cl, SentryAction as cm, SentryAlertEvent as cn, Session as co, Session1 as cp, SessionAgent as cq, SessionArchived as cr, SessionAttribution as cs, SessionClosedPayload as ct, SessionClosedRecord as cu, SessionConfig as cv, SessionConversation as cw, SessionConversationConfig as cx, SessionEnvironment as cy, SessionEventActor as cz, CheckSuiteAction as d, SlackChannelCreatedEvent as d0, SlackMessageEvent as d1, SnapshotFrame as d2, StatusAction as d3, StreamFrame as d4, TokenCounts as d5, Tokens as d6, Tokens1 as d7, TokensInfo as d8, TurnEndedPayload as d9, TurnEndedRecord as da, TurnQueuedPayload as db, TurnQueuedRecord as dc, TurnReason as dd, TurnStartedPayload as de, TurnStartedRecord as df, TurnStatus as dg, UnknownSessionRecord as dh, UpdateSessionRequest as di, WorkflowRunAction as dj, paths as dk, ClaudeAssistantEvent as e, ClaudeAssistantMessage as f, ClaudeConfig as g, ClaudeConversationResetEvent as h, ClaudeNativeEvent as i, ClaudeNativeSessionRecord as j, ClaudeNativeUsage as k, ClaudeRateLimitEvent as l, ClaudeRateLimitInfo as m, ClaudeResultEvent as n, ClaudeSessionRecord as o, ClaudeSystemEvent as p, ClaudeUserEvent as q, ClaudeUserMessage as r, CodexAgentMessage as s, CodexAgentMessageItem as t, CodexAppServerError as u, CodexAppServerEvent as v, CodexAppServerItem as w, CodexAppServerNotification as x, CodexAppServerSessionRecord as y, CodexCollabAgentToolCall as z };
+export type { CodexMcpToolCallResult as $, AgentConfig as A, BudgetConfig as B, CheckRunAction as C, CodexCommandExecution as D, CodexCommandExecutionItem as E, CodexConfig as F, CodexContextCompaction as G, CodexEffortLevel as H, CodexErrorEvent as I, CodexErrorItem as J, CodexErrorParams as K, CodexEvent as L, CodexFileChange as M, CodexFileChangeItem as N, CodexFileUpdate as O, CodexItem as P, CodexItemCompleted as Q, CodexItemCompletedEvent as R, CodexItemParams as S, CodexItemStarted as T, CodexItemStartedEvent as U, CodexItemUpdatedEvent as V, CodexLocalImageInput as W, CodexMcpToolCall as X, CodexMcpToolCallAppContext as Y, CodexMcpToolCallError as Z, CodexMcpToolCallItem as _, AgentIdentity as a, GeminiToolError as a$, CodexPlan as a0, CodexReasoning as a1, CodexReasoningItem as a2, CodexSessionRecord as a3, CodexSubAgentActivity as a4, CodexTextInput as a5, CodexThread as a6, CodexThreadStarted as a7, CodexThreadStartedEvent as a8, CodexThreadStartedParams as a9, EffortLevel as aA, EllipsisGrant as aB, EllipsisPermissions as aC, EnvironmentBaseBuild as aD, EnvironmentConfig as aE, EnvironmentHooks as aF, EnvironmentHooks1 as aG, EnvironmentOutputPayload as aH, EnvironmentOutputRecord as aI, EnvironmentPhasePayload as aJ, EnvironmentPhaseRecord as aK, EnvironmentReadyPayload as aL, EnvironmentReadyRecord as aM, EnvironmentScript as aN, EnvironmentSource as aO, EnvironmentVariable as aP, ErrorFrame as aQ, ErrorReason as aR, GeminiConfig as aS, GeminiErrorEvent as aT, GeminiInitEvent as aU, GeminiMessageEvent as aV, GeminiModelStats as aW, GeminiResultEvent as aX, GeminiSessionRecord as aY, GeminiStreamEvent as aZ, GeminiStreamStats as a_, CodexThreadTokenUsage as aa, CodexTodoListItem as ab, CodexTokenUsageBreakdown as ac, CodexTokenUsageParams as ad, CodexTokenUsageUpdated as ae, CodexTurn as af, CodexTurnCompleted as ag, CodexTurnCompletedEvent as ah, CodexTurnError as ai, CodexTurnFailedEvent as aj, CodexTurnParams as ak, CodexTurnStarted as al, CodexTurnStartedEvent as am, CodexUsage as an, CodexUserInput as ao, CodexUserMessage as ap, CodexWebSearch as aq, CodexWebSearchItem as ar, ComputeConfig as as, ComputeConfig1 as at, ConfigMetadata as au, Cost as av, Cost1 as aw, CronTrigger as ax, DeltaFrame as ay, Duration as az, AttributionType as b, RepositoryFilter as b$, GeminiToolResultEvent as b0, GeminiToolUseEvent as b1, GithubAccountFilter as b2, GithubAccountSelector as b3, GithubAccountSnippet as b4, GithubAccountType as b5, GithubCheckRunEvent as b6, GithubCheckSuiteEvent as b7, GithubIssueEvent as b8, GithubPermissions as b9, MessageRecord as bA, MessageRequeuedPayload as bB, MessageRequeuedRecord as bC, MessageStartedPayload as bD, MessageStartedRecord as bE, ModelLlmCostSplit as bF, ModelTokenCounts as bG, OutputConfig as bH, PermissionsConfig as bI, PermissionsConfig1 as bJ, PlatformSessionRecord as bK, PromptBlockedReason as bL, PullRequestAction as bM, ReactCheckRun as bN, ReactCheckSuite as bO, ReactIssue as bP, ReactLinearIssue as bQ, ReactPullRequest as bR, ReactPush as bS, ReactRelease as bT, ReactSentry as bU, ReactSlackChannel as bV, ReactStatus as bW, ReactTrigger as bX, ReactWorkflowRun as bY, RecordsFrame as bZ, ReleaseAction as b_, GithubPullRequestEvent as ba, GithubPushEvent as bb, GithubReleaseEvent as bc, GithubStatusEvent as bd, GithubWorkflowRunEvent as be, HandlerService as bf, HeartbeatFrame as bg, InputContract as bh, IssueAction as bi, LegacyAssistantPayload as bj, LegacyNativeUsage as bk, LegacyResultPayload as bl, Level as bm, LifecycleSessionRecord as bn, LinearIssueAction as bo, LinearIssueEvent as bp, LlmCost as bq, LlmCostSplit as br, McpRemoteServer as bs, McpServerRef as bt, McpStdioServer as bu, MemorySize as bv, MessageEndedPayload as bw, MessageEndedRecord as bx, MessageQueuedPayload as by, MessageQueuedRecord as bz, components as c, SlackMessageEvent as c$, RepositoryRef as c0, Review as c1, ReviewComment as c2, ReviewConfig as c3, ReviewConfigsListResponse as c4, ReviewPullRequest as c5, ReviewPullRequestAuthor as c6, ReviewReviewer as c7, ReviewSummary as c8, ReviewsListResponse as c9, SessionEnvironment as cA, SessionError as cB, SessionEventActor as cC, SessionFrame as cD, SessionGit as cE, SessionGitCommit as cF, SessionGitFile as cG, SessionGitPr as cH, SessionGitRepo as cI, SessionHandler as cJ, SessionMessage as cK, SessionMessageImage as cL, SessionMessageResponse as cM, SessionOutput as cN, SessionParent as cO, SessionPrompting as cP, SessionRecord as cQ, SessionRecordsListResponse as cR, SessionResponse as cS, SessionSource as cT, SessionStatus as cU, SessionStreamFrame as cV, SessionSummary as cW, SessionsListResponse as cX, SettingsRef as cY, SkillRef as cZ, SlackChannelCreatedEvent as c_, SdkAssistantRecord as ca, SdkCacheCreation as cb, SdkContentBlock as cc, SdkRateLimitRecord as cd, SdkRecord as ce, SdkResultRecord as cf, SdkServerToolResultBlock as cg, SdkServerToolUseBlock as ch, SdkSystemRecord as ci, SdkTextBlock as cj, SdkThinkingBlock as ck, SdkToolResultBlock as cl, SdkToolUseBlock as cm, SdkUserRecord as cn, SendSessionMessageRequest as co, SentryAction as cp, SentryAlertEvent as cq, Session as cr, SessionAgent as cs, SessionArchived as ct, SessionAttribution as cu, SessionClosedPayload as cv, SessionClosedRecord as cw, SessionConfig as cx, SessionConversation as cy, SessionConversationConfig as cz, CheckSuiteAction as d, StatusAction as d0, StreamFrame as d1, TokenCounts as d2, Tokens as d3, Tokens1 as d4, TokensInfo as d5, UnknownSessionRecord as d6, UpdateSessionRequest as d7, WorkflowRunAction as d8, paths as d9, ClaudeAssistantEvent as e, ClaudeAssistantMessage as f, ClaudeConfig as g, ClaudeConversationResetEvent as h, ClaudeNativeEvent as i, ClaudeNativeSessionRecord as j, ClaudeNativeUsage as k, ClaudeRateLimitEvent as l, ClaudeRateLimitInfo as m, ClaudeResultEvent as n, ClaudeSessionRecord as o, ClaudeSystemEvent as p, ClaudeUserEvent as q, ClaudeUserMessage as r, CodexAgentMessage as s, CodexAgentMessageItem as t, CodexAppServerError as u, CodexAppServerEvent as v, CodexAppServerItem as w, CodexAppServerNotification as x, CodexAppServerSessionRecord as y, CodexCollabAgentToolCall as z };