@ellipsis-dev/sdk 0.9.0 → 0.11.0

package/dist/{types-CStmnKVu.d.ts → types-DDQQ1Yfh.d.ts}

@@ -14,10 +14,13 @@ interface paths {
         put?: never;
         /**
          * Create Agent Config
-         * @description Create an agent config via pull request.
+         * @description Create an agent config.
          *
-         *     The PR adds the config file to agents/ on the target
-         *     repository; the agent goes live when it merges.
+         *     Name a repository and Ellipsis opens a pull request adding the
+         *     config file to agents/ there; the agent goes live when it
+         *     merges. Omit it and the agent is created here, with no file,
+         *     live immediately — and every file reference in it must name the
+         *     repository it lives in.
          *
          *     Accepts an inline config or a gallery template slug. 409 when
          *     another live agent already holds the name.
@@ -41,8 +44,75 @@ interface paths {
          * @description Return one saved agent config, by id or by the agent's name.
          */
         get: operations['get_agent_config'];
-        put?: never;
+        /**
+         * Update Agent Config
+         * @description Replace an agent's definition, by id or by the agent's name.
+         *
+         *     The whole definition is replaced, and the change is live at
+         *     once. Only for agents managed through this API: one defined by a
+         *     repository file is a 409, since the next push to that file would
+         *     revert the change — unlink it first to take ownership.
+         */
+        put: operations['update_agent_config'];
         post?: never;
+        /**
+         * Delete Agent Config
+         * @description Delete an agent, by id or by the agent's name.
+         *
+         *     The agent stops running and its name is freed immediately; its
+         *     past sessions remain readable. Only for agents managed through
+         *     this API — delete the file to remove one defined by a
+         *     repository.
+         */
+        delete: operations['delete_agent_config'];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/agents/configs/{config_id}/link': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Link Agent Config
+         * @description Move an agent into a repository, by id or by the agent's name.
+         *
+         *     Opens a pull request adding the agent's config file. The agent
+         *     keeps running unchanged meanwhile; merging hands it over to the
+         *     file, after which the file is what changes it. Nothing happens
+         *     if the pull request is never merged.
+         */
+        post: operations['link_agent_config'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/agents/configs/{config_id}/unlink': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Unlink Agent Config
+         * @description Take over an agent from its file, by id or by the agent's name.
+         *
+         *     The file stops governing the agent immediately and further
+         *     changes go through this API. The file is left in place, inert —
+         *     delete it whenever you like.
+         */
+        post: operations['unlink_agent_config'];
         delete?: never;
         options?: never;
         head?: never;
@@ -1446,6 +1516,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 +1779,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 +1792,8 @@ interface components {
             /**
              * Ellipsis
              * @default true
-             * @enum {unknown}
              */
-            ellipsis: true | 'all';
+            ellipsis: (true | 'all') | components['schemas']['AgentConfigEllipsisPermissions'];
             /** @default {} */
             github: components['schemas']['AgentConfigGithubPermissions'];
         };
@@ -1796,6 +1877,7 @@ interface components {
         AgentConfigSystemFileRef: {
             /** File */
             file: string;
+            repository?: components['schemas']['AgentConfigRepository'] | null;
         };
         /**
          * AgentConfigsListResponse
@@ -2386,6 +2468,8 @@ interface components {
              * @description The last commit the config was synced from.
              */
             last_synced_commit_sha?: string | null;
+            /** @description Which writer owns this agent. "github" agents are defined by a file in a repository and are changed by editing that file; "api" agents have no file and are changed through this API. */
+            managed_by: components['schemas']['ConfigManagedBy'];
             /**
              * 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.
@@ -2408,6 +2492,14 @@ interface components {
              */
             updated_at: string;
         };
+        /**
+         * ConfigManagedBy
+         * @description Which writer owns an agent: the repository file it is defined in, or
+         *     this API. Every agent has exactly one owner, fixed when it is created and
+         *     changed only by linking or unlinking it.
+         * @enum {string}
+         */
+        ConfigManagedBy: 'github' | 'api';
         /**
          * ContributorUsage
          * @description An author who merged a pull request in the window. The pull-request and
@@ -2453,22 +2545,22 @@ interface components {
         };
         /**
          * CreateAgentConfigRequest
-         * @description Parameters for creating an agent config via a pull request. Exactly
-         *     one of config or template_id must be set.
+         * @description Parameters for creating an agent config. Exactly one of config or
+         *     template_id must be set.
          */
         CreateAgentConfigRequest: {
             /** @description An inline agent config. */
             config?: components['schemas']['AgentConfig'] | null;
             /**
              * Path
-             * @description File path within the repo. Omit for the default agents/<slug>.yaml; if set it must be a location the config sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).
+             * @description File path within the repo, when a repository is named. Omit for the default agents/<slug>.yaml; if set it must be a location the config sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).
              */
             path?: string | null;
             /**
              * Repository
-             * @description Target repository name within the caller's account; the owner is always the account, so pass a bare name (e.g. "my-service"), not "owner/my-service".
+             * @description Define the agent as a file in this repository: Ellipsis opens a pull request adding it, and the agent goes live when that merges. Repository name within the caller's account; the owner is always the account, so pass a bare name (e.g. "my-service"), not "owner/my-service". Omit to create the agent through the API alone, with no file and live immediately.
              */
-            repository: string;
+            repository?: string | null;
             /**
              * Template Id
              * @description A gallery template slug (see GET /agents/templates).
@@ -2477,21 +2569,22 @@ interface components {
         };
         /**
          * CreateAgentConfigResponse
-         * @description The created agent config and the pull request that adds its file.
+         * @description The created agent config, plus the pull request that adds its file when
+         *     one was opened.
          */
         CreateAgentConfigResponse: {
             /** @description The created agent config. */
             config: components['schemas']['Config'];
             /**
              * Path
-             * @description The file path the config was written to.
+             * @description The file path the config was written to, or null when the agent has no file.
              */
-            path: string;
+            path?: string | null;
             /**
              * Pull Request Url
-             * @description The pull request that adds the config file. The agent becomes live once it merges and syncs.
+             * @description The pull request that adds the config file. The agent becomes live once it merges and syncs. Null when no repository was named: the agent is already live.
              */
-            pull_request_url: string;
+            pull_request_url?: string | null;
         };
         /**
          * CreateFileRequest
@@ -2656,6 +2749,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 +3449,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.
@@ -3408,6 +3520,40 @@ interface components {
              */
             teams: components['schemas']['LinearTeam'][];
         };
+        /**
+         * LinkAgentConfigRequest
+         * @description Where to put the config file of an agent being moved into a repository.
+         */
+        LinkAgentConfigRequest: {
+            /**
+             * Path
+             * @description File path within the repo. Omit for the default agents/<slug>.yaml; if set it must be a location the config sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).
+             */
+            path?: string | null;
+            /**
+             * Repository
+             * @description Repository name within the caller's account; the owner is always the account, so pass a bare name (e.g. "my-service"), not "owner/my-service".
+             */
+            repository: string;
+        };
+        /**
+         * LinkAgentConfigResponse
+         * @description The agent and the pull request that would put it in a repository.
+         */
+        LinkAgentConfigResponse: {
+            /** @description The agent, still managed through the API until the pull request merges. */
+            config: components['schemas']['Config'];
+            /**
+             * Path
+             * @description The file path the config will be written to.
+             */
+            path: string;
+            /**
+             * Pull Request Url
+             * @description The pull request that adds the config file. The agent becomes managed by that file once it merges.
+             */
+            pull_request_url: string;
+        };
         /**
          * LinkedGithubIdentity
          * @description The GitHub identity linked to a Slack member.
@@ -4255,6 +4401,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 +5366,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 +5392,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 +5439,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 +5448,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 +5469,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 +5765,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 +6022,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 +6055,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.
@@ -6264,6 +6493,14 @@ interface components {
             /** Skipped */
             skipped: number;
         };
+        /**
+         * UpdateAgentConfigRequest
+         * @description A replacement definition for an agent managed through the API.
+         */
+        UpdateAgentConfigRequest: {
+            /** @description The agent's new definition. Replaces the previous one wholesale — this is not a partial update. */
+            config: components['schemas']['AgentConfig'];
+        };
         /**
          * UsageDailyPoint
          * @description One day's usage: tokens split by type, and cost split into the four
@@ -6509,7 +6746,7 @@ interface operations {
                     'application/json': components['schemas']['ErrorResponse'];
                 };
             };
-            /** @description The agent's name contains no usable characters. */
+            /** @description The agent's name contains no usable characters, or a file reference names no repository. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -6580,16 +6817,22 @@ interface operations {
             };
         };
     };
-    list_agent_defaults: {
+    update_agent_config: {
         parameters: {
             query?: never;
             header?: {
                 'user-agent'?: string | null;
             };
-            path?: never;
+            path: {
+                config_id: string;
+            };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['UpdateAgentConfigRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -6597,7 +6840,301 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['AgentDefaultsListResponse'];
+                    'application/json': components['schemas']['AgentConfigResponse'];
+                };
+            };
+            /** @description The config is invalid (for example an unschedulable cron expression). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @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 config in your account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The agent is defined by a file in a repository, or another live agent already holds the new name. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The agent's name is missing or malformed, or a file reference names no repository. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+        };
+    };
+    delete_agent_config: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                config_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: 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 config in your account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The agent is defined by a file in a repository; delete that file instead. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    link_agent_config: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                config_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['LinkAgentConfigRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['LinkAgentConfigResponse'];
+                };
+            };
+            /** @description The path is not a synced config location, or the repository has no commits. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @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 The config or repository was not found in your account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The agent is already defined by a file, a link is already open for it, a file already exists at that path, or another agent syncs from it. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description GitHub rejected the pull request. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+        };
+    };
+    unlink_agent_config: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                config_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['AgentConfigResponse'];
+                };
+            };
+            /** @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 config in your account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The agent is already managed through the API. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The config has a file reference that names no repository, so it cannot resolve without its source repository. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+        };
+    };
+    list_agent_defaults: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['AgentDefaultsListResponse'];
                 };
             };
             /** @description The bearer token is missing, invalid, or revoked. */
@@ -9898,6 +10435,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 +10477,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 +10573,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 +10593,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 +10633,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 +10657,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 +10676,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 +10706,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 +10753,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 +10779,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 +10808,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 +10954,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 +10974,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 +11014,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 +11038,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.
      */