@ellipsis-dev/sdk 0.9.0 → 0.10.0

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

@@ -1446,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
@@ -1698,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.
@@ -1710,9 +1722,8 @@ interface components {
             /**
              * Ellipsis
              * @default true
-             * @enum {unknown}
              */
-            ellipsis: true | 'all';
+            ellipsis: (true | 'all') | components['schemas']['AgentConfigEllipsisPermissions'];
             /** @default {} */
             github: components['schemas']['AgentConfigGithubPermissions'];
         };
@@ -2656,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: {
             /**
@@ -3345,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.
@@ -4255,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
@@ -5212,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.
@@ -5243,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
@@ -5311,13 +5323,8 @@ interface components {
              * @description Pull requests the session created or updated.
              */
             output_prs?: components['schemas']['SessionPr'][] | 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;
+            /** @description What preceded this session, if anything. */
+            parent?: components['schemas']['SessionParent'];
             /**
              * Prompt
              * @description The per-session prompt the session was started with.
@@ -5325,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.
@@ -5358,68 +5353,99 @@ interface components {
              * @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
@@ -5623,6 +5649,26 @@ interface components {
          * @enum {string}
          */
         SessionMessageStatus: 'pending' | 'delivered';
+        /**
+         * 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.
+         */
+        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
@@ -5860,6 +5906,25 @@ interface components {
          * @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.
@@ -5874,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.
@@ -9898,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
@@ -9936,10 +10053,6 @@ 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 SessionStatus, which is per-execution (one turn's run) and
@@ -10036,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.
      */
@@ -10066,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.
      */
@@ -10121,28 +10209,12 @@ interface Session {
      * Pull requests the session created or updated.
      */
     output_prs: SessionPr[] | 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;
+    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.
      */
@@ -10161,46 +10233,12 @@ interface Session {
      * 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.
      */
@@ -10214,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,
@@ -10227,6 +10282,41 @@ 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
@@ -10239,6 +10329,23 @@ interface SessionPr {
     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.
  */
@@ -10248,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.
  *
@@ -10260,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 —
@@ -10377,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.
      */
@@ -10407,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.
      */
@@ -10462,28 +10590,12 @@ interface Session1 {
      * Pull requests the session created or updated.
      */
     output_prs: SessionPr[] | 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;
+    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.
      */
@@ -10502,46 +10614,12 @@ interface Session1 {
      * 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.
      */