@ellipsis-dev/sdk 0.8.1 → 0.10.0

package/dist/{types-Dx0e0Qs_.d.ts → types-BME-7Lbt.d.ts}

@@ -17,9 +17,10 @@ interface paths {
          * @description Create an agent config via pull request.
          *
          *     The PR adds the config file to agents/ on the target
-         *     repository.
+         *     repository; the agent goes live when it merges.
          *
-         *     Accepts an inline config or a gallery template slug.
+         *     Accepts an inline config or a gallery template slug. 409 when
+         *     another live agent already holds the name.
          */
         post: operations['create_agent_config'];
         delete?: never;
@@ -37,7 +38,7 @@ interface paths {
         };
         /**
          * Get Agent Config
-         * @description Return one saved agent config by id.
+         * @description Return one saved agent config, by id or by the agent's name.
          */
         get: operations['get_agent_config'];
         put?: never;
@@ -70,7 +71,8 @@ interface paths {
          * @description Set a default agent config.
          *
          *     Addressed by rung: the account rung (repository omitted) or a
-         *     repository rung ("owner/name").
+         *     repository rung ("owner/name"); the config by id or by the
+         *     agent's name.
          *
          *     Refused for sandbox tokens (potentially prompt-injected code
          *     must not repoint the account's ambient default); an unknown or
@@ -830,8 +832,9 @@ interface paths {
          * List Agent Sessions
          * @description List cloud agent sessions, newest first.
          *
-         *     Optionally filtered by config, source, time window, attributed
-         *     author, repository, and whether the session is still going.
+         *     Optionally filtered by config (id or `ellipsis.name`), source, time
+         *     window, attributed author, repository, and whether the session is
+         *     still going.
          */
         get: operations['list_agent_sessions'];
         put?: never;
@@ -839,10 +842,13 @@ interface paths {
          * Start Agent Session
          * @description Start a cloud agent session.
          *
-         *     Provide at most one of config_id, config, or template_id; with
-         *     none, the account's default-config ladder resolves the config.
-         *     400 when idle_start is combined with prompt or handoff, or when
-         *     a handoff is combined with any config source or override.
+         *     Provide at most one of config_id (an id or an agent name),
+         *     config, or
+         *     template_id; with none, the account's default-config ladder
+         *     resolves the config. 400 when idle_start is combined with
+         *     prompt, input, or handoff, or when a handoff is combined with
+         *     any config source or override. 422 when the agent declares an
+         *     input schema and the request's input is absent or invalid.
          */
         post: operations['start_agent_session'];
         delete?: never;
@@ -958,7 +964,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/sessions/{session_id}/ide': {
+    '/sessions/{session_id}/export': {
         parameters: {
             query?: never;
             header?: never;
@@ -966,18 +972,19 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Get Agent Session Ide
-         * @description Return the IDE link for the session's sandbox.
+         * Export Agent Session
+         * @description Export the complete session history.
          *
-         *     The membership-gated dashboard page, which performs the sandbox
-         *     proxy handoff itself.
+         *     The complete, ordered history of the session (agent output, tool calls, thinking,
+         *     lifecycle events, sandbox output, message events) as an ordered
+         *     manifest of presigned segment URLs.
          *
-         *     No credential is minted here — the URL grants nothing by
-         *     possession. 409 when the sandbox isn't running (send the
-         *     session a message to wake it first). Backs the `agent session
-         *     ide` CLI verb.
+         *     Segments are gzip members: download in order and concatenate
+         *     for one file. The JSON API never carries the bytes (same
+         *     two-step as files). /records is the paged live view of the
+         *     same data.
          */
-        get: operations['get_agent_session_ide'];
+        get: operations['export_agent_session'];
         put?: never;
         post?: never;
         delete?: never;
@@ -986,7 +993,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/sessions/{session_id}/log': {
+    '/sessions/{session_id}/ide': {
         parameters: {
             query?: never;
             header?: never;
@@ -994,19 +1001,18 @@ interface paths {
             cookie?: never;
         };
         /**
-         * Get Agent Session Log
-         * @description Download the complete session log.
+         * Get Agent Session Ide
+         * @description Return the IDE link for the session's sandbox.
          *
-         *     The complete, ordered history of the session (agent output, tool calls, thinking,
-         *     lifecycle events, sandbox output, message events) as an ordered
-         *     manifest of presigned segment URLs.
+         *     The membership-gated dashboard page, which performs the sandbox
+         *     proxy handoff itself.
          *
-         *     Segments are gzip members: download in order and concatenate
-         *     for one file. The JSON API never carries the bytes (same
-         *     two-step as files). /records is the paged live view of the
-         *     same data.
+         *     No credential is minted here — the URL grants nothing by
+         *     possession. 409 when the sandbox isn't running (send the
+         *     session a message to wake it first). Backs the `agent session
+         *     ide` CLI verb.
          */
-        get: operations['get_agent_session_log'];
+        get: operations['get_agent_session_ide'];
         put?: never;
         post?: never;
         delete?: never;
@@ -1040,6 +1046,32 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/sessions/{session_id}/output': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Agent Session Output
+         * @description Return the session's typed output.
+         *
+         *     The payload the agent submitted through its config-declared
+         *     output.json_schema, as the raw JSON body with no envelope. 404
+         *     while the session is still running (poll GET /sessions/{id}),
+         *     when the agent declares no output block, or when no execution
+         *     produced output.
+         */
+        get: operations['get_agent_session_output'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/sessions/{session_id}/ports/{port}': {
         parameters: {
             query?: never;
@@ -1229,6 +1261,7 @@ interface components {
              *     }
              */
             environment: components['schemas']['AgentConfigEnvironment'];
+            input?: components['schemas']['AgentConfigInput'] | null;
             /** @default {} */
             llm: components['schemas']['AgentConfigLlm'];
             /**
@@ -1236,6 +1269,7 @@ interface components {
              * @default []
              */
             mcp_servers: (string | components['schemas']['AgentConfigMcpServer'])[];
+            output?: components['schemas']['AgentConfigOutput'] | null;
             /**
              * @default {
              *       "ellipsis": true,
@@ -1248,7 +1282,6 @@ interface components {
              * @default []
              */
             skills: components['schemas']['AgentConfigSkill'][];
-            structured_output?: components['schemas']['AgentConfigStructuredOutput'] | null;
             /** Trigger */
             trigger?: (components['schemas']['AgentConfigCronTrigger'] | components['schemas']['AgentConfigReactTrigger'] | components['schemas']['AgentConfigMentionTrigger']) | null;
         };
@@ -1413,6 +1446,17 @@ interface components {
              */
             version: string;
         };
+        /**
+         * AgentConfigEllipsisPermissions
+         * @description `permissions.ellipsis` as a map: resource → level | grant | list of
+         *     grants. Levels are hierarchical (read < write < delete), so `write`
+         *     includes `read`. An unlisted resource is denied. The whole block is
+         *     intersected with the platform's sandbox ceiling at token mint — it can
+         *     narrow what a sandbox token may do, never exceed it.
+         */
+        AgentConfigEllipsisPermissions: {
+            [key: string]: components['schemas']['Level'] | components['schemas']['EllipsisGrant'] | (components['schemas']['Level'] | components['schemas']['EllipsisGrant'])[];
+        };
         /**
          * AgentConfigEnvironment
          * @description Everything about the environment (the sandbox) the agent runs in: which
@@ -1545,6 +1589,30 @@ interface components {
             /** Repositories */
             repositories?: string[] | null;
         };
+        /**
+         * AgentConfigInput
+         * @description The typed input contract: what goes INTO a session (the trigger is
+         *     when it happens; this is what goes in).
+         *
+         *     `json_schema` types the payload a caller-started session takes
+         *     (`POST /sessions` `input`, validated at the door; required when
+         *     declared). It is illegal on a react-triggered agent — react payloads are
+         *     platform-shaped (the published surface field sets), not caller-shaped.
+         *
+         *     `message` is the initial-message template: exact `{{path}}` substitution
+         *     over the caller payload (or, on a react agent, over the surface's
+         *     published fields), no conditionals/loops/filters. Refs are validated at
+         *     deploy time against the governing field set (see AgentConfig's
+         *     `_check_input`).
+         */
+        AgentConfigInput: {
+            /** Json Schema */
+            json_schema?: {
+                [key: string]: unknown;
+            } | null;
+            /** Message */
+            message?: string | null;
+        };
         /**
          * AgentConfigLlm
          * @description Where this agent's completions go.
@@ -1621,6 +1689,18 @@ interface components {
              */
             labels: string[];
         };
+        /**
+         * AgentConfigOutput
+         * @description The typed output contract: the JSON Schema the agent must exit through
+         *     (the StructuredOutput exit tool). Read back via
+         *     GET /sessions/{id}/output.
+         */
+        AgentConfigOutput: {
+            /** Json Schema */
+            json_schema: {
+                [key: string]: unknown;
+            };
+        };
         /**
          * AgentConfigPermissions
          * @description What the agent is allowed to touch, per credential the platform mints
@@ -1629,10 +1709,11 @@ interface components {
          *
          *     `ellipsis` scopes the sandbox's Ellipsis API token
          *     (`ELLIPSIS_API_TOKEN`, what the in-sandbox `agent` CLI authenticates
-         *     with). Only full access exists today — `true` or the string `all`, both
-         *     meaning the token may call any Ellipsis API a sandbox token can. The key
-         *     is declarative for now; it reserves the spot for narrowing later, and
-         *     anything other than true/`all` (including `false`) fails validation.
+         *     with). `true` / the string `all` (the default) grant the full sandbox
+         *     ceiling — everything a sandbox token can ever do. A map narrows it per
+         *     resource (see `AgentConfigEllipsisPermissions`); the minted token carries
+         *     the intersection, so a config can only ever reduce access. `false` fails
+         *     validation — an agent with no API token cannot report its own progress.
          *
          *     `github` scopes the sandbox's GitHub installation token (`GH_TOKEN`) —
          *     see `AgentConfigGithubPermissions`. GitHub enforces it at mint time.
@@ -1641,9 +1722,8 @@ interface components {
             /**
              * Ellipsis
              * @default true
-             * @enum {unknown}
              */
-            ellipsis: true | 'all';
+            ellipsis: (true | 'all') | components['schemas']['AgentConfigEllipsisPermissions'];
             /** @default {} */
             github: components['schemas']['AgentConfigGithubPermissions'];
         };
@@ -1723,19 +1803,6 @@ interface components {
             /** Repo Id */
             repo_id: number;
         };
-        /** AgentConfigStructuredOutput */
-        AgentConfigStructuredOutput: {
-            /** Json Schema */
-            json_schema: {
-                [key: string]: unknown;
-            };
-            /**
-             * Type
-             * @default json_schema
-             * @constant
-             */
-            type: 'json_schema';
-        };
         /** AgentConfigSystemFileRef */
         AgentConfigSystemFileRef: {
             /** File */
@@ -1809,46 +1876,6 @@ interface components {
              */
             defaults: components['schemas']['AgentDefault'][];
         };
-        /**
-         * AgentSessionExitStatus
-         * @description Why a terminal agent session ended — a finer-grained reason than `status`.
-         *
-         *     `status` (AgentSessionStatus) is the lifecycle state: COMPLETED / ERROR /
-         *     CANCELLED. `exit_status` explains *why* a run reached that terminal state, so
-         *     the UI and metrics can tell a budget cutoff apart from a crashed tool call or
-         *     a deliberate cancellation. It is None until the run reaches a terminal state.
-         * @enum {string}
-         */
-        AgentSessionExitStatus: 'completed' | 'budget_hit' | 'payment_required' | 'tool_call_failed' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_sandbox_variables' | 'cancelled' | 'interrupted' | 'error' | 'stopped';
-        /**
-         * AgentSessionPr
-         * @description A pull request this session created, denormalized at capture time so
-         *     session surfaces render a labeled link without joining gh_prs. Live PR
-         *     state (open/merged/closed) is not stored here — read it from gh_prs where
-         *     a view needs it.
-         */
-        AgentSessionPr: {
-            /** Gh Pr Id */
-            gh_pr_id?: number | null;
-            /** Number */
-            number: number;
-            /** Repo Full Name */
-            repo_full_name: string;
-            /** Title */
-            title?: string | null;
-            /** Url */
-            url: string;
-        };
-        /**
-         * AgentSessionSource
-         * @enum {string}
-         */
-        AgentSessionSource: 'react' | 'manual' | 'api' | 'cli' | 'mention' | 'cron' | 'laptop';
-        /**
-         * AgentSessionStatus
-         * @enum {string}
-         */
-        AgentSessionStatus: 'scheduled' | 'creating_sandbox' | 'running' | 'retrying' | 'completed' | 'error' | 'cancelled' | 'stopped';
         /**
          * AgentTemplate
          * @description A built-in agent template: a ready-to-use agent config plus the
@@ -2338,6 +2365,11 @@ interface components {
              * @description When the config was created.
              */
             created_at: string;
+            /**
+             * Display Name
+             * @description The raw ellipsis.name display text from the config file.
+             */
+            display_name?: string | null;
             /** @description The GitHub account that last edited the config, when the edit came from a known user. */
             edited_by?: components['schemas']['GithubAccountSnippet'] | null;
             /**
@@ -2365,11 +2397,21 @@ interface components {
              * @description The last commit the config was synced from.
              */
             last_synced_commit_sha?: string | null;
+            /**
+             * Name
+             * @description The agent's customer-unique addressable name (a slug of its display name); usable anywhere an agent is referenced, interchangeably with the id.
+             */
+            name?: string | null;
             /**
              * Pending Pull Request Url
              * @description The open pull request that adds this config's file. Non-null means the agent is not live yet: it starts running once the pull request merges and syncs.
              */
             pending_pull_request_url?: string | null;
+            /**
+             * Sha
+             * @description The config's content identity: the version fingerprint frozen onto each session that runs it.
+             */
+            sha: string;
             /**
              * Updated At
              * Format: date-time
@@ -2625,6 +2667,17 @@ interface components {
          * @enum {string}
          */
         EffortLevel: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+        /**
+         * EllipsisGrant
+         * @description One grant entry: a level, optionally narrowed to instances whose
+         *     natural key (a file's name, a memory's path, a secret's name, a config's
+         *     name, a session's id) matches any of the `match` globs.
+         */
+        EllipsisGrant: {
+            level: components['schemas']['Level'];
+            /** Match */
+            match?: string[] | null;
+        };
         /** ErrorInfo */
         ErrorInfo: {
             /**
@@ -3314,6 +3367,14 @@ interface components {
              */
             cloud_id: string;
         };
+        /**
+         * Level
+         * @description What may be done to a resource. Strictly ordered: a grant at one level
+         *     includes every level below it (write-only would be a phantom capability —
+         *     no real client can create what it cannot read back).
+         * @enum {string}
+         */
+        Level: 'read' | 'write' | 'delete';
         /**
          * LinearIntegrationSummary
          * @description The account's connected Linear organization and its teams.
@@ -3887,7 +3948,7 @@ interface components {
         PutAgentDefaultRequest: {
             /**
              * Config Id
-             * @description The saved config to make the default.
+             * @description The config to make the default: a config id, or the agent's customer-unique `ellipsis.name`.
              */
             config_id: string;
             /**
@@ -4113,7 +4174,7 @@ interface components {
              * Output Prs
              * @description Pull requests the session created, so a result row can show what it shipped without fetching the session.
              */
-            output_prs?: components['schemas']['AgentSessionPr'][] | null;
+            output_prs?: components['schemas']['SessionPr'][] | null;
             /**
              * Record Type
              * @description The record's event type.
@@ -4125,9 +4186,9 @@ interface components {
              */
             session_id: string;
             /** @description Where the matching session came from. */
-            session_source?: components['schemas']['AgentSessionSource'] | null;
+            session_source?: components['schemas']['SessionSource'] | null;
             /** @description The matching session's status. */
-            session_status?: components['schemas']['AgentSessionStatus'] | null;
+            session_status?: components['schemas']['SessionStatus'] | null;
             /**
              * Snippet
              * @description A short window of the indexed text around the first match.
@@ -4224,6 +4285,14 @@ interface components {
             /** Watermark */
             watermark: string | null;
         };
+        /**
+         * Resource
+         * @description Everything a credential can be granted access to, one value per /v1
+         *     resource family. `TOKENS` is reserved for the future token-management
+         *     routes; nothing maps to it yet.
+         * @enum {string}
+         */
+        Resource: 'account' | 'alerts' | 'sessions' | 'files' | 'memories' | 'reviews' | 'configs' | 'defaults' | 'secrets' | 'templates' | 'integrations' | 'tokens';
         /**
          * Review
          * @description One code review: one pipeline iteration over one commit range of a pull
@@ -5181,15 +5250,10 @@ interface components {
          *     disagree about what a session looks like.
          */
         Session: {
-            /** @description The GitHub user the session is attributed to, when the attribution is a GitHub user. */
-            attributed_user?: components['schemas']['GithubAccountSnippet'] | null;
-            /**
-             * Attribution Id
-             * @description Identifier of the principal the session is attributed to.
-             */
-            attribution_id?: string | null;
-            /** @description Kind of principal the session is attributed to (e.g. a GitHub user or an API key). */
-            attribution_type?: components['schemas']['AttributionType'] | null;
+            /** @description The principal this session is attributed to. */
+            attribution?: components['schemas']['SessionAttribution'];
+            /** @description The spend budget enforced for this session. */
+            budget?: components['schemas']['SessionBudget'];
             /**
              * Client Version
              * @description Version of the client that started the session, if reported.
@@ -5212,29 +5276,8 @@ interface components {
              * @description The "owner/name" repository context the session was started in, if any.
              */
             context_repository?: string | null;
-            /**
-             * Cost Fee
-             * @description Platform fee in millicents.
-             * @default 0
-             */
-            cost_fee: number;
-            /**
-             * Cost Sandbox Cpu
-             * @description Sandbox CPU spend in millicents.
-             * @default 0
-             */
-            cost_sandbox_cpu: number;
-            /**
-             * Cost Sandbox Memory
-             * @description Sandbox memory spend in millicents.
-             * @default 0
-             */
-            cost_sandbox_memory: number;
-            /**
-             * Cost Tokens
-             * @description Token spend in millicents. The session's grand total cost is the sum of cost_tokens, cost_sandbox_cpu, cost_sandbox_memory, and cost_fee.
-             */
-            cost_tokens: number;
+            /** @description What the session cost, in millicents, broken down by leg and carrying its own total. */
+            cost?: components['schemas']['SessionCost'];
             /**
              * Created At
              * Format: date-time
@@ -5244,7 +5287,7 @@ interface components {
             /** @description How the session's config was resolved from the account's defaults, when no explicit config was given. */
             default_resolution?: components['schemas']['DefaultResolution'] | null;
             /** @description How the session ended; null until it is terminal. */
-            exit_status?: components['schemas']['AgentSessionExitStatus'] | null;
+            exit_status?: components['schemas']['SessionExitStatus'] | null;
             /** @description The coding-agent harness the session runs on. */
             harness: components['schemas']['Harness'];
             /**
@@ -5279,14 +5322,9 @@ interface components {
              * Output Prs
              * @description Pull requests the session created or updated.
              */
-            output_prs?: components['schemas']['AgentSessionPr'][] | null;
-            /** @description How this session relates to its parent session, if any. */
-            parent_kind?: components['schemas']['ParentKind'] | null;
-            /**
-             * Parent Session Id
-             * @description Identifier of the parent session that spawned this one, if any.
-             */
-            parent_session_id?: string | null;
+            output_prs?: components['schemas']['SessionPr'][] | null;
+            /** @description What preceded this session, if anything. */
+            parent?: components['schemas']['SessionParent'];
             /**
              * Prompt
              * @description The per-session prompt the session was started with.
@@ -5294,18 +5332,6 @@ interface components {
             prompt?: string | null;
             /** @description Whether a client may send this session a message and, when it may not, the reason to show instead of a composer. */
             prompting: components['schemas']['SessionPrompting'];
-            /**
-             * Replayed From Session Id
-             * @description Identifier of the original session this one was replayed from, if it was started via replay.
-             */
-            replayed_from_session_id?: string | null;
-            /**
-             * Resolved Budget Cents
-             * @description The spend budget resolved for this session, in cents.
-             */
-            resolved_budget_cents: number;
-            /** @description Where the resolved budget came from. */
-            resolved_budget_source: components['schemas']['BudgetSource'];
             /**
              * Sandbox Id
              * @description Identifier of the sandbox the session runs in, if any.
@@ -5319,76 +5345,107 @@ interface components {
             /** @description Lifecycle state of the durable conversation, or null for sessions without one. */
             session_state?: components['schemas']['SessionState'] | null;
             /** @description Where the session came from (e.g. react, manual, api, cli, mention, cron, laptop). */
-            source: components['schemas']['AgentSessionSource'];
+            source: components['schemas']['SessionSource'];
             /** @description Execution status of the session. */
-            status: components['schemas']['AgentSessionStatus'];
+            status: components['schemas']['SessionStatus'];
             /**
              * Status Reason
              * @description Human-readable reason for the current status, when there is one.
              */
             status_reason?: string | null;
+            /** @description The stop request, if the session was stopped. */
+            stopped?: components['schemas']['SessionStopped'];
+            /** @description The public status projection; null for laptop-synced sessions. */
+            surface?: components['schemas']['SessionSurface'] | null;
+            /** @description The tokens the session spent and the model they went to. `total` includes the prompt-cache lanes. */
+            tokens?: components['schemas']['SessionTokens'];
             /**
-             * Stopped At
-             * @description When a stop was requested, if one was.
+             * Updated At
+             * Format: date-time
+             * @description When the session was last updated.
              */
-            stopped_at?: string | null;
+            updated_at: string;
             /**
-             * Stopped By
-             * @description GitHub account id of the user who stopped the session, if known.
+             * Webhook Id
+             * @description Identifier of the webhook event that triggered the session, if any.
              */
-            stopped_by?: number | null;
-            /** @description The GitHub user who stopped the session, if it was stopped. */
-            stopped_by_user?: components['schemas']['GithubAccountSnippet'] | null;
-            /** @description The public status projection; null for laptop-synced sessions. */
-            surface?: components['schemas']['SessionSurface'] | null;
+            webhook_id?: string | null;
+            /** @description Type of the webhook event that triggered the session, if any. */
+            webhook_type?: components['schemas']['WebhookType'] | null;
+        };
+        /**
+         * SessionAttribution
+         * @description The principal a session is attributed to: what kind, its id, and — when
+         *     the kind is a GitHub user — the resolved display snippet.
+         */
+        SessionAttribution: {
             /**
-             * Tokens Cache Creation
-             * @description Tokens written to the prompt cache.
-             * @default 0
+             * Id
+             * @description Identifier of the principal the session is attributed to.
              */
-            tokens_cache_creation: number;
+            id?: string | null;
+            /** @description Kind of principal the session is attributed to (e.g. a GitHub user or an API key). */
+            type?: components['schemas']['AttributionType'] | null;
+            /** @description The GitHub user the session is attributed to, resolved at read time. Null when the attribution is not a GitHub user. */
+            user?: components['schemas']['GithubAccountSnippet'] | null;
+        };
+        /**
+         * SessionBudget
+         * @description The spend budget actually enforced for this session, and which layer of
+         *     the cascade set it.
+         */
+        SessionBudget: {
             /**
-             * Tokens Cache Read
-             * @description Tokens read from the prompt cache.
+             * Cents
+             * @description The spend budget resolved for this session, in cents.
              * @default 0
              */
-            tokens_cache_read: number;
+            cents: number;
             /**
-             * Tokens Input
-             * @description Input tokens used.
-             * @default 0
+             * @description Where the resolved budget came from.
+             * @default account
              */
-            tokens_input: number;
+            source: components['schemas']['BudgetSource'];
+        };
+        /**
+         * SessionCost
+         * @description What a session (or one turn of it) cost, in millicents.
+         *
+         *     `llm` is deliberately NOT called `tokens`: it would sit beside the `tokens`
+         *     object and read as "the token count's cost" rather than "the cost of the
+         *     LLM leg".
+         */
+        SessionCost: {
             /**
-             * Tokens Model
-             * @description The model the token counts are attributed to.
+             * Fee
+             * @description Platform fee in millicents.
+             * @default 0
              */
-            tokens_model: string;
+            fee: number;
             /**
-             * Tokens Output
-             * @description Output tokens used.
+             * Llm
+             * @description LLM spend in millicents.
              * @default 0
              */
-            tokens_output: number;
+            llm: number;
             /**
-             * Tokens Total
-             * @description Total tokens used by the session.
+             * Sandbox Cpu
+             * @description Sandbox CPU spend in millicents.
              * @default 0
              */
-            tokens_total: number;
+            sandbox_cpu: number;
             /**
-             * Updated At
-             * Format: date-time
-             * @description When the session was last updated.
+             * Sandbox Memory
+             * @description Sandbox memory spend in millicents.
+             * @default 0
              */
-            updated_at: string;
+            sandbox_memory: number;
             /**
-             * Webhook Id
-             * @description Identifier of the webhook event that triggered the session, if any.
+             * Total
+             * @description The grand total in millicents: llm + sandbox_cpu + sandbox_memory + fee.
+             * @default 0
              */
-            webhook_id?: string | null;
-            /** @description Type of the webhook event that triggered the session, if any. */
-            webhook_type?: components['schemas']['WebhookType'] | null;
+            total: number;
         };
         /**
          * SessionExecution
@@ -5467,6 +5524,17 @@ interface components {
              */
             executions: components['schemas']['SessionExecution'][];
         };
+        /**
+         * SessionExitStatus
+         * @description Why a terminal agent session ended — a finer-grained reason than `status`.
+         *
+         *     `status` (SessionStatus) is the lifecycle state: COMPLETED / ERROR /
+         *     CANCELLED. `exit_status` explains *why* a run reached that terminal state, so
+         *     the UI and metrics can tell a budget cutoff apart from a crashed tool call or
+         *     a deliberate cancellation. It is None until the run reaches a terminal state.
+         * @enum {string}
+         */
+        SessionExitStatus: 'completed' | 'budget_hit' | 'payment_required' | 'tool_call_failed' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_sandbox_variables' | 'cancelled' | 'interrupted' | 'error' | 'stopped';
         /**
          * SessionLiveness
          * @description The durable conversation axis (backs the surfaced `session` field).
@@ -5582,20 +5650,59 @@ interface components {
          */
         SessionMessageStatus: 'pending' | 'delivered';
         /**
-         * SessionPrompting
-         * @description The prompt-affordance projection. `enabled` answers "would a send work",
-         *     and when it wouldn't, `blocked_reason` + `detail` say why.
-         *
-         *     `surface_name` is set only for MENTION_SURFACE, naming where to reply.
+         * SessionParent
+         * @description The ONE "preceded-by" chain: the predecessor session and how this one
+         *     relates to it. Not a parent that orchestrates children — a session never
+         *     spawns sub-sessions.
          */
-        SessionPrompting: {
-            blocked_reason?: components['schemas']['PromptBlockedReason'] | null;
-            /** Detail */
-            detail?: string | null;
-            /** Enabled */
-            enabled: boolean;
-            /** Surface Name */
-            surface_name?: string | null;
+        SessionParent: {
+            /** @description How this session relates to its parent session, if any. */
+            kind?: components['schemas']['ParentKind'] | null;
+            /**
+             * Replayed From Session Id
+             * @description Identifier of the original session this one was replayed from, if it was started via replay.
+             */
+            replayed_from_session_id?: string | null;
+            /**
+             * Session Id
+             * @description Identifier of the parent session that spawned this one, if any.
+             */
+            session_id?: string | null;
+        };
+        /**
+         * SessionPr
+         * @description A pull request this session created, denormalized at capture time so
+         *     session surfaces render a labeled link without joining gh_prs. Live PR
+         *     state (open/merged/closed) is not stored here — read it from gh_prs where
+         *     a view needs it.
+         */
+        SessionPr: {
+            /** Gh Pr Id */
+            gh_pr_id?: number | null;
+            /** Number */
+            number: number;
+            /** Repo Full Name */
+            repo_full_name: string;
+            /** Title */
+            title?: string | null;
+            /** Url */
+            url: string;
+        };
+        /**
+         * SessionPrompting
+         * @description The prompt-affordance projection. `enabled` answers "would a send work",
+         *     and when it wouldn't, `blocked_reason` + `detail` say why.
+         *
+         *     `surface_name` is set only for MENTION_SURFACE, naming where to reply.
+         */
+        SessionPrompting: {
+            blocked_reason?: components['schemas']['PromptBlockedReason'] | null;
+            /** Detail */
+            detail?: string | null;
+            /** Enabled */
+            enabled: boolean;
+            /** Surface Name */
+            surface_name?: string | null;
         };
         /**
          * SessionRecord
@@ -5779,16 +5886,45 @@ interface components {
          * @enum {string}
          */
         SessionSearchScope: 'records' | 'recaps' | 'both';
+        /**
+         * SessionSource
+         * @enum {string}
+         */
+        SessionSource: 'react' | 'manual' | 'api' | 'cli' | 'mention' | 'cron' | 'laptop';
         /**
          * SessionState
          * @description Lifecycle of a keyed (multi-turn) session — the durable conversation.
-         *     Distinct from AgentSessionStatus, which is per-execution (one turn's run) and
+         *     Distinct from SessionStatus, which is per-execution (one turn's run) and
          *     moves to agent_turns in a later slice. IDLE: alive, waiting for the next
          *     message. RUNNING: a turn is executing. CLOSED: the conversation is done and
          *     its sandbox/snapshots are torn down.
          * @enum {string}
          */
         SessionState: 'idle' | 'running' | 'closed';
+        /**
+         * SessionStatus
+         * @enum {string}
+         */
+        SessionStatus: 'scheduled' | 'creating_sandbox' | 'running' | 'retrying' | 'completed' | 'error' | 'cancelled' | 'stopped';
+        /**
+         * SessionStopped
+         * @description The stop request, if there was one: when, by which GitHub account id,
+         *     and that account resolved to a display snippet.
+         */
+        SessionStopped: {
+            /**
+             * At
+             * @description When a stop was requested, if one was.
+             */
+            at?: string | null;
+            /**
+             * By
+             * @description GitHub account id of the user who stopped the session, if known.
+             */
+            by?: number | null;
+            /** @description The GitHub user who stopped the session, resolved at read time. */
+            by_user?: components['schemas']['GithubAccountSnippet'] | null;
+        };
         /**
          * SessionSurface
          * @description The three fields we expose. All `None` for an un-keyed (laptop) session.
@@ -5803,6 +5939,54 @@ interface components {
             /** Status */
             status: string | null;
         };
+        /**
+         * SessionTokens
+         * @description The token counts a session (or turn) spent, and the model they went to.
+         *
+         *     `total` INCLUDES the cache lanes, unlike the old flat `tokens_total` which
+         *     counted input+output+thinking only and left callers to add cache reads and
+         *     writes back themselves (the deleted `tokensTotalAll` helper). Cache tokens
+         *     dominate an agent run's token bill, so a "total" that omits them is the
+         *     wrong default and produced two competing totals in the dashboard.
+         */
+        SessionTokens: {
+            /**
+             * Cache Creation
+             * @description Tokens written to the prompt cache.
+             * @default 0
+             */
+            cache_creation: number;
+            /**
+             * Cache Read
+             * @description Tokens read from the prompt cache.
+             * @default 0
+             */
+            cache_read: number;
+            /**
+             * Input
+             * @description Input tokens used.
+             * @default 0
+             */
+            input: number;
+            /**
+             * Model
+             * @description The model the token counts are attributed to.
+             * @default
+             */
+            model: string;
+            /**
+             * Output
+             * @description Output tokens used.
+             * @default 0
+             */
+            output: number;
+            /**
+             * Total
+             * @description Total tokens consumed, INCLUDING the prompt-cache reads and writes — the same basis the token cost is priced on.
+             * @default 0
+             */
+            total: number;
+        };
         /**
          * SessionsListResponse
          * @description A page of sessions in the lean wire shape.
@@ -5958,7 +6142,7 @@ interface components {
             config?: components['schemas']['AgentConfig'] | null;
             /**
              * Config Id
-             * @description A saved agent config id to run under.
+             * @description A saved agent config to run under: its id, or the agent's customer-unique `ellipsis.name`.
              */
             config_id?: string | null;
             /**
@@ -5987,6 +6171,13 @@ interface components {
              * @default false
              */
             idle_start: boolean;
+            /**
+             * Input
+             * @description The typed payload for an agent that declares input.json_schema: validated against the effective config's schema (422 on mismatch), rendered into the session's initial message (the agent's input.message template, or a JSON block). Required when the agent declares a schema; rejected when it does not.
+             */
+            input?: {
+                [key: string]: unknown;
+            } | null;
             /**
              * Metadata
              * @description Arbitrary string key/value metadata stored on the session.
@@ -6422,7 +6613,7 @@ interface operations {
                     'application/json': components['schemas']['ErrorResponse'];
                 };
             };
-            /** @description Another agent is already synced from that path, or a file already exists there. */
+            /** @description An agent with that name already exists, another agent is already synced from that path, or a file already exists there. */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -6431,13 +6622,13 @@ interface operations {
                     'application/json': components['schemas']['ErrorResponse'];
                 };
             };
-            /** @description Validation Error */
+            /** @description The agent's name contains no usable characters. */
             422: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
+                    'application/json': components['schemas']['ErrorResponse'];
                 };
             };
         };
@@ -8726,8 +8917,9 @@ interface operations {
     list_agent_sessions: {
         parameters: {
             query?: {
+                /** @description A saved config id, or the agent's `ellipsis.name`. */
                 config_id?: string | null;
-                source?: components['schemas']['AgentSessionSource'][] | null;
+                source?: components['schemas']['SessionSource'][] | null;
                 days?: number | null;
                 start?: string | null;
                 end?: string | null;
@@ -8810,7 +9002,7 @@ interface operations {
                     'application/json': components['schemas']['StartAgentSessionResponse'];
                 };
             };
-            /** @description The request combines incompatible fields (multiple config sources, idle_start with prompt/handoff, a handoff with a config source, or both override forms), or the config override / handoff repo/sha is invalid. */
+            /** @description The request combines incompatible fields (multiple config sources, idle_start with prompt/input/handoff, a handoff with a config source, or both override forms), or the config override / handoff repo/sha is invalid. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8837,7 +9029,7 @@ interface operations {
                     'application/json': components['schemas']['ErrorResponse'];
                 };
             };
-            /** @description The named config, template, or handoff parent session does not exist in your account. */
+            /** @description The named agent, template, or handoff parent session does not exist in your account. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -8855,13 +9047,13 @@ interface operations {
                     'application/json': components['schemas']['ErrorResponse'];
                 };
             };
-            /** @description Validation Error */
+            /** @description The agent requires 'input' matching its input schema (missing or failed validation), or declares no input schema and 'input' was sent. */
             422: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
+                    'application/json': components['schemas']['ErrorResponse'];
                 };
             };
         };
@@ -8871,7 +9063,7 @@ interface operations {
             query: {
                 q: string;
                 scope?: components['schemas']['SessionSearchScope'];
-                source?: components['schemas']['AgentSessionSource'][] | null;
+                source?: components['schemas']['SessionSource'][] | null;
                 /** @description Attributed GitHub user account ids. */
                 author_id?: number[] | null;
                 /** @description Saved agent config ids (ORed with author_id). */
@@ -8879,7 +9071,7 @@ interface operations {
                 session_ids?: string[] | null;
                 /** @description "owner/name" (exact) or a bare repo name. */
                 repo?: string | null;
-                status?: components['schemas']['AgentSessionStatus'][] | null;
+                status?: components['schemas']['SessionStatus'][] | null;
                 start?: string | null;
                 end?: string | null;
                 limit?: number;
@@ -9130,7 +9322,7 @@ interface operations {
             };
         };
     };
-    get_agent_session_ide: {
+    export_agent_session: {
         parameters: {
             query?: never;
             header?: {
@@ -9149,7 +9341,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['GetSessionIdeResponse'];
+                    'application/json': components['schemas']['GetSessionLogResponse'];
                 };
             };
             /** @description The bearer token is missing, invalid, or revoked. */
@@ -9179,15 +9371,6 @@ interface operations {
                     'application/json': components['schemas']['ErrorResponse'];
                 };
             };
-            /** @description The session's sandbox is not running; send it a message to wake it first. */
-            409: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['ErrorResponse'];
-                };
-            };
             /** @description Validation Error */
             422: {
                 headers: {
@@ -9199,7 +9382,7 @@ interface operations {
             };
         };
     };
-    get_agent_session_log: {
+    get_agent_session_ide: {
         parameters: {
             query?: never;
             header?: {
@@ -9218,7 +9401,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['GetSessionLogResponse'];
+                    'application/json': components['schemas']['GetSessionIdeResponse'];
                 };
             };
             /** @description The bearer token is missing, invalid, or revoked. */
@@ -9248,6 +9431,15 @@ interface operations {
                     'application/json': components['schemas']['ErrorResponse'];
                 };
             };
+            /** @description The session's sandbox is not running; send it a message to wake it first. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
             /** @description Validation Error */
             422: {
                 headers: {
@@ -9341,6 +9533,66 @@ interface operations {
             };
         };
     };
+    get_agent_session_output: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                session_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The session's typed output, exactly as the agent submitted it — the shape is the agent's own output.json_schema, with no envelope. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': Record<string, never>;
+                };
+            };
+            /** @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, the agent declares no output schema, the session has not completed, or it produced no output. */
+            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_agent_session_port: {
         parameters: {
             query?: never;
@@ -9759,6 +10011,10 @@ type AttributionType = 'github_user' | 'linear_user' | 'slack_user' | 'api_key';
  */
 type SessionMessageStatus = 'pending' | 'delivered';
 type GithubAccountType = 'User' | 'Organization' | 'Bot' | 'Mannequin';
+/**
+ * Where the resolved budget came from.
+ */
+type BudgetSource = 'system' | 'account' | 'config' | 'run';
 /**
  * How a session that arrived with no explicit config source resolved its
  * config (documents/eng/DEFAULT_CONFIGS.md §4). Persisted on the session so
@@ -9770,12 +10026,12 @@ type DefaultResolution = 'repo_default' | 'account_default' | 'none';
 /**
  * Why a terminal agent session ended — a finer-grained reason than `status`.
  *
- * `status` (AgentSessionStatus) is the lifecycle state: COMPLETED / ERROR /
+ * `status` (SessionStatus) is the lifecycle state: COMPLETED / ERROR /
  * CANCELLED. `exit_status` explains *why* a run reached that terminal state, so
  * the UI and metrics can tell a budget cutoff apart from a crashed tool call or
  * a deliberate cancellation. It is None until the run reaches a terminal state.
  */
-type AgentSessionExitStatus = 'completed' | 'budget_hit' | 'payment_required' | 'tool_call_failed' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_sandbox_variables' | 'cancelled' | 'interrupted' | 'error' | 'stopped';
+type SessionExitStatus = 'completed' | 'budget_hit' | 'payment_required' | 'tool_call_failed' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_sandbox_variables' | 'cancelled' | 'interrupted' | 'error' | 'stopped';
 /**
  * The coding-agent harness the session runs on.
  */
@@ -9797,13 +10053,9 @@ type ParentKind = 'continuation' | 'handoff' | 'resume';
  * Why direct prompting is refused. Absent when prompting is allowed.
  */
 type PromptBlockedReason = 'mention_surface' | 'ephemeral_trigger' | 'non_interactive' | 'harness_single_turn' | 'closed' | 'laptop';
-/**
- * Where the resolved budget came from.
- */
-type BudgetSource = 'system' | 'account' | 'config' | 'run';
 /**
  * Lifecycle of a keyed (multi-turn) session — the durable conversation.
- * Distinct from AgentSessionStatus, which is per-execution (one turn's run) and
+ * Distinct from SessionStatus, which is per-execution (one turn's run) and
  * moves to agent_turns in a later slice. IDLE: alive, waiting for the next
  * message. RUNNING: a turn is executing. CLOSED: the conversation is done and
  * its sandbox/snapshots are torn down.
@@ -9812,11 +10064,11 @@ type SessionState = 'idle' | 'running' | 'closed';
 /**
  * Where the session came from (e.g. react, manual, api, cli, mention, cron, laptop).
  */
-type AgentSessionSource = 'react' | 'manual' | 'api' | 'cli' | 'mention' | 'cron' | 'laptop';
+type SessionSource = 'react' | 'manual' | 'api' | 'cli' | 'mention' | 'cron' | 'laptop';
 /**
  * Execution status of the session.
  */
-type AgentSessionStatus = 'scheduled' | 'creating_sandbox' | 'running' | 'retrying' | 'completed' | 'error' | 'cancelled' | 'stopped';
+type SessionStatus = 'scheduled' | 'creating_sandbox' | 'running' | 'retrying' | 'completed' | 'error' | 'cancelled' | 'stopped';
 /**
  * What the current (or most recent) execution is doing (backs `run`).
  */
@@ -9897,18 +10149,8 @@ interface SessionMessage {
  * The session's current state.
  */
 interface Session {
-    /**
-     * The GitHub user the session is attributed to, when the attribution is a GitHub user.
-     */
-    attributed_user: GithubAccountSnippet | null;
-    /**
-     * Identifier of the principal the session is attributed to.
-     */
-    attribution_id: string | null;
-    /**
-     * Kind of principal the session is attributed to (e.g. a GitHub user or an API key).
-     */
-    attribution_type: AttributionType | null;
+    attribution: SessionAttribution;
+    budget: SessionBudget;
     /**
      * Version of the client that started the session, if reported.
      */
@@ -9927,22 +10169,7 @@ interface Session {
      * The "owner/name" repository context the session was started in, if any.
      */
     context_repository: string | null;
-    /**
-     * Platform fee in millicents.
-     */
-    cost_fee: number;
-    /**
-     * Sandbox CPU spend in millicents.
-     */
-    cost_sandbox_cpu: number;
-    /**
-     * Sandbox memory spend in millicents.
-     */
-    cost_sandbox_memory: number;
-    /**
-     * Token spend in millicents. The session's grand total cost is the sum of cost_tokens, cost_sandbox_cpu, cost_sandbox_memory, and cost_fee.
-     */
-    cost_tokens: number;
+    cost: SessionCost;
     /**
      * When the session was created.
      */
@@ -9954,7 +10181,7 @@ interface Session {
     /**
      * How the session ended; null until it is terminal.
      */
-    exit_status: AgentSessionExitStatus | null;
+    exit_status: SessionExitStatus | null;
     harness: Harness;
     /**
      * Unique identifier of the session.
@@ -9981,29 +10208,13 @@ interface Session {
     /**
      * Pull requests the session created or updated.
      */
-    output_prs: AgentSessionPr[] | null;
-    /**
-     * How this session relates to its parent session, if any.
-     */
-    parent_kind: ParentKind | null;
-    /**
-     * Identifier of the parent session that spawned this one, if any.
-     */
-    parent_session_id: string | null;
+    output_prs: SessionPr[] | null;
+    parent: SessionParent;
     /**
      * The per-session prompt the session was started with.
      */
     prompt: string | null;
     prompting: SessionPrompting;
-    /**
-     * Identifier of the original session this one was replayed from, if it was started via replay.
-     */
-    replayed_from_session_id: string | null;
-    /**
-     * The spend budget resolved for this session, in cents.
-     */
-    resolved_budget_cents: number;
-    resolved_budget_source: BudgetSource;
     /**
      * Identifier of the sandbox the session runs in, if any.
      */
@@ -10016,52 +10227,18 @@ interface Session {
      * Lifecycle state of the durable conversation, or null for sessions without one.
      */
     session_state: SessionState | null;
-    source: AgentSessionSource;
-    status: AgentSessionStatus;
+    source: SessionSource;
+    status: SessionStatus;
     /**
      * Human-readable reason for the current status, when there is one.
      */
     status_reason: string | null;
-    /**
-     * When a stop was requested, if one was.
-     */
-    stopped_at: string | null;
-    /**
-     * GitHub account id of the user who stopped the session, if known.
-     */
-    stopped_by: number | null;
-    /**
-     * The GitHub user who stopped the session, if it was stopped.
-     */
-    stopped_by_user: GithubAccountSnippet | null;
+    stopped: SessionStopped;
     /**
      * The public status projection; null for laptop-synced sessions.
      */
     surface: SessionSurface | null;
-    /**
-     * Tokens written to the prompt cache.
-     */
-    tokens_cache_creation: number;
-    /**
-     * Tokens read from the prompt cache.
-     */
-    tokens_cache_read: number;
-    /**
-     * Input tokens used.
-     */
-    tokens_input: number;
-    /**
-     * The model the token counts are attributed to.
-     */
-    tokens_model: string;
-    /**
-     * Output tokens used.
-     */
-    tokens_output: number;
-    /**
-     * Total tokens used by the session.
-     */
-    tokens_total: number;
+    tokens: SessionTokens;
     /**
      * When the session was last updated.
      */
@@ -10075,6 +10252,23 @@ interface Session {
      */
     webhook_type: WebhookType | null;
 }
+/**
+ * The principal this session is attributed to.
+ */
+interface SessionAttribution {
+    /**
+     * Identifier of the principal the session is attributed to.
+     */
+    id: string | null;
+    /**
+     * Kind of principal the session is attributed to (e.g. a GitHub user or an API key).
+     */
+    type: AttributionType | null;
+    /**
+     * The GitHub user the session is attributed to, resolved at read time. Null when the attribution is not a GitHub user.
+     */
+    user: GithubAccountSnippet | null;
+}
 /**
  * Sometimes the GitHub API returns a user of github (can include bots)
  * using this snippet instead of the full GithubAccount model. One example,
@@ -10088,18 +10282,70 @@ interface GithubAccountSnippet {
     login: string;
     type: GithubAccountType;
 }
+/**
+ * The spend budget enforced for this session.
+ */
+interface SessionBudget {
+    /**
+     * The spend budget resolved for this session, in cents.
+     */
+    cents: number;
+    source: BudgetSource;
+}
+/**
+ * What the session cost, in millicents, broken down by leg and carrying its own total.
+ */
+interface SessionCost {
+    /**
+     * Platform fee in millicents.
+     */
+    fee: number;
+    /**
+     * LLM spend in millicents.
+     */
+    llm: number;
+    /**
+     * Sandbox CPU spend in millicents.
+     */
+    sandbox_cpu: number;
+    /**
+     * Sandbox memory spend in millicents.
+     */
+    sandbox_memory: number;
+    /**
+     * The grand total in millicents: llm + sandbox_cpu + sandbox_memory + fee.
+     */
+    total: number;
+}
 /**
  * A pull request this session created, denormalized at capture time so
  * session surfaces render a labeled link without joining gh_prs. Live PR
  * state (open/merged/closed) is not stored here — read it from gh_prs where
  * a view needs it.
  */
-interface AgentSessionPr {
+interface SessionPr {
     gh_pr_id: number | null;
     number: number;
     repo_full_name: string;
     url: string;
 }
+/**
+ * What preceded this session, if anything.
+ */
+interface SessionParent {
+    /**
+     * How this session relates to its parent session, if any.
+     */
+    kind: ParentKind | null;
+    /**
+     * Identifier of the original session this one was replayed from, if it was started via replay.
+     */
+    replayed_from_session_id: string | null;
+    /**
+     * Identifier of the parent session that spawned this one, if any.
+     */
+    session_id: string | null;
+}
 /**
  * Whether a client may send this session a message and, when it may not, the reason to show instead of a composer.
  */
@@ -10109,6 +10355,23 @@ interface SessionPrompting {
     enabled: boolean;
     surface_name: string | null;
 }
+/**
+ * The stop request, if the session was stopped.
+ */
+interface SessionStopped {
+    /**
+     * When a stop was requested, if one was.
+     */
+    at: string | null;
+    /**
+     * GitHub account id of the user who stopped the session, if known.
+     */
+    by: number | null;
+    /**
+     * The GitHub user who stopped the session, resolved at read time.
+     */
+    by_user: GithubAccountSnippet | null;
+}
 /**
  * The three fields we expose. All `None` for an un-keyed (laptop) session.
  *
@@ -10121,6 +10384,35 @@ interface SessionSurface {
     session: SessionLiveness | null;
     status: string | null;
 }
+/**
+ * The tokens the session spent and the model they went to. `total` includes the prompt-cache lanes.
+ */
+interface SessionTokens {
+    /**
+     * Tokens written to the prompt cache.
+     */
+    cache_creation: number;
+    /**
+     * Tokens read from the prompt cache.
+     */
+    cache_read: number;
+    /**
+     * Input tokens used.
+     */
+    input: number;
+    /**
+     * The model the token counts are attributed to.
+     */
+    model: string;
+    /**
+     * Output tokens used.
+     */
+    output: number;
+    /**
+     * Total tokens consumed, INCLUDING the prompt-cache reads and writes — the same basis the token cost is priced on.
+     */
+    total: number;
+}
 /**
  * Cursored append-only delivery of session records, ordered by feed_seq,
  * from all sources. Every record in the frame advances the resume cursor —
@@ -10238,18 +10530,8 @@ interface SessionFrame {
  * The session's current state.
  */
 interface Session1 {
-    /**
-     * The GitHub user the session is attributed to, when the attribution is a GitHub user.
-     */
-    attributed_user: GithubAccountSnippet | null;
-    /**
-     * Identifier of the principal the session is attributed to.
-     */
-    attribution_id: string | null;
-    /**
-     * Kind of principal the session is attributed to (e.g. a GitHub user or an API key).
-     */
-    attribution_type: AttributionType | null;
+    attribution: SessionAttribution;
+    budget: SessionBudget;
     /**
      * Version of the client that started the session, if reported.
      */
@@ -10268,22 +10550,7 @@ interface Session1 {
      * The "owner/name" repository context the session was started in, if any.
      */
     context_repository: string | null;
-    /**
-     * Platform fee in millicents.
-     */
-    cost_fee: number;
-    /**
-     * Sandbox CPU spend in millicents.
-     */
-    cost_sandbox_cpu: number;
-    /**
-     * Sandbox memory spend in millicents.
-     */
-    cost_sandbox_memory: number;
-    /**
-     * Token spend in millicents. The session's grand total cost is the sum of cost_tokens, cost_sandbox_cpu, cost_sandbox_memory, and cost_fee.
-     */
-    cost_tokens: number;
+    cost: SessionCost;
     /**
      * When the session was created.
      */
@@ -10295,7 +10562,7 @@ interface Session1 {
     /**
      * How the session ended; null until it is terminal.
      */
-    exit_status: AgentSessionExitStatus | null;
+    exit_status: SessionExitStatus | null;
     harness: Harness;
     /**
      * Unique identifier of the session.
@@ -10322,29 +10589,13 @@ interface Session1 {
     /**
      * Pull requests the session created or updated.
      */
-    output_prs: AgentSessionPr[] | null;
-    /**
-     * How this session relates to its parent session, if any.
-     */
-    parent_kind: ParentKind | null;
-    /**
-     * Identifier of the parent session that spawned this one, if any.
-     */
-    parent_session_id: string | null;
+    output_prs: SessionPr[] | null;
+    parent: SessionParent;
     /**
      * The per-session prompt the session was started with.
      */
     prompt: string | null;
     prompting: SessionPrompting;
-    /**
-     * Identifier of the original session this one was replayed from, if it was started via replay.
-     */
-    replayed_from_session_id: string | null;
-    /**
-     * The spend budget resolved for this session, in cents.
-     */
-    resolved_budget_cents: number;
-    resolved_budget_source: BudgetSource;
     /**
      * Identifier of the sandbox the session runs in, if any.
      */
@@ -10357,52 +10608,18 @@ interface Session1 {
      * Lifecycle state of the durable conversation, or null for sessions without one.
      */
     session_state: SessionState | null;
-    source: AgentSessionSource;
-    status: AgentSessionStatus;
+    source: SessionSource;
+    status: SessionStatus;
     /**
      * Human-readable reason for the current status, when there is one.
      */
     status_reason: string | null;
-    /**
-     * When a stop was requested, if one was.
-     */
-    stopped_at: string | null;
-    /**
-     * GitHub account id of the user who stopped the session, if known.
-     */
-    stopped_by: number | null;
-    /**
-     * The GitHub user who stopped the session, if it was stopped.
-     */
-    stopped_by_user: GithubAccountSnippet | null;
+    stopped: SessionStopped;
     /**
      * The public status projection; null for laptop-synced sessions.
      */
     surface: SessionSurface | null;
-    /**
-     * Tokens written to the prompt cache.
-     */
-    tokens_cache_creation: number;
-    /**
-     * Tokens read from the prompt cache.
-     */
-    tokens_cache_read: number;
-    /**
-     * Input tokens used.
-     */
-    tokens_input: number;
-    /**
-     * The model the token counts are attributed to.
-     */
-    tokens_model: string;
-    /**
-     * Output tokens used.
-     */
-    tokens_output: number;
-    /**
-     * Total tokens used by the session.
-     */
-    tokens_total: number;
+    tokens: SessionTokens;
     /**
      * When the session was last updated.
      */
@@ -10495,4 +10712,4 @@ type ReviewRequester = components['schemas']['ReviewRequester'];
 type ReviewFinding = components['schemas']['ReviewFinding'];
 type Finding = ReviewFinding;
 
-export type { AgentSessionExitStatus as A, BudgetSource as B, CreateReviewRequest as C, DefaultResolution as D, ErrorFrame as E, Finding as F, GithubAccountSnippet as G, Harness as H, SessionMessage as I, SessionMessageResponse as J, SessionMessageStatus as K, SessionPrompting as L, SessionRecord as M, SessionRecordsListResponse as N, SessionResponse as O, ParentKind as P, SessionState as Q, RecordsAppendFrame as R, SendSessionMessageRequest as S, SessionStreamFrame as T, SessionSurface as U, SessionsListResponse as V, SnapshotFrame as W, StreamFrame as X, TokensInfo as Y, paths as Z, AgentSessionPr as a, AgentSessionSource as b, components as c, AgentSessionStatus as d, AttributionType as e, DeltaFrame as f, DoneFrame as g, GithubAccountType as h, HeartbeatFrame as i, PromptBlockedReason as j, ResolvedReviewScope as k, Review as l, ReviewConfiguration as m, ReviewCounters as n, ReviewFinding as o, ReviewRequester as p, ReviewScope as q, ReviewScopeKind as r, ReviewStage as s, ReviewedCommit as t, ReviewsListResponse as u, Session as v, SessionExecution as w, SessionExecutionsListResponse as x, SessionFrame as y, SessionLiveness as z };
+export type { AttributionType as A, BudgetSource as B, CreateReviewRequest as C, DefaultResolution as D, ErrorFrame as E, Finding as F, GithubAccountSnippet as G, Harness as H, SessionPr as I, SessionPrompting as J, SessionRecord as K, SessionRecordsListResponse as L, SessionResponse as M, SessionSource as N, SessionState as O, ParentKind as P, SessionStatus as Q, RecordsAppendFrame as R, SendSessionMessageRequest as S, SessionStreamFrame as T, SessionSurface as U, SessionsListResponse as V, SnapshotFrame as W, StreamFrame as X, TokensInfo as Y, paths as Z, DeltaFrame as a, DoneFrame as b, components as c, GithubAccountType as d, HeartbeatFrame as e, PromptBlockedReason as f, ResolvedReviewScope as g, Review as h, ReviewConfiguration as i, ReviewCounters as j, ReviewFinding as k, ReviewRequester as l, ReviewScope as m, ReviewScopeKind as n, ReviewStage as o, ReviewedCommit as p, ReviewsListResponse as q, Session as r, SessionExecution as s, SessionExecutionsListResponse as t, SessionExitStatus as u, SessionFrame as v, SessionLiveness as w, SessionMessage as x, SessionMessageResponse as y, SessionMessageStatus as z };