@ellipsis-dev/sdk 0.8.1 → 0.9.0

package/dist/{types-Dx0e0Qs_.d.ts → types-CStmnKVu.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;
         };
@@ -1545,6 +1578,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 +1678,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
@@ -1723,19 +1792,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 +1865,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 +2354,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 +2386,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
@@ -3887,7 +3918,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 +4144,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 +4156,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.
@@ -5244,7 +5275,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,7 +5310,7 @@ interface components {
              * Output Prs
              * @description Pull requests the session created or updated.
              */
-            output_prs?: components['schemas']['AgentSessionPr'][] | null;
+            output_prs?: components['schemas']['SessionPr'][] | null;
             /** @description How this session relates to its parent session, if any. */
             parent_kind?: components['schemas']['ParentKind'] | null;
             /**
@@ -5319,9 +5350,9 @@ 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.
@@ -5467,6 +5498,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).
@@ -5581,6 +5623,25 @@ interface components {
          * @enum {string}
          */
         SessionMessageStatus: 'pending' | 'delivered';
+        /**
+         * 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",
@@ -5779,16 +5840,26 @@ 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';
         /**
          * SessionSurface
          * @description The three fields we expose. All `None` for an un-keyed (laptop) session.
@@ -5958,7 +6029,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 +6058,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 +6500,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 +6509,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 +8804,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 +8889,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 +8916,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 +8934,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 +8950,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 +8958,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 +9209,7 @@ interface operations {
             };
         };
     };
-    get_agent_session_ide: {
+    export_agent_session: {
         parameters: {
             query?: never;
             header?: {
@@ -9149,7 +9228,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 +9258,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 +9269,7 @@ interface operations {
             };
         };
     };
-    get_agent_session_log: {
+    get_agent_session_ide: {
         parameters: {
             query?: never;
             header?: {
@@ -9218,7 +9288,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 +9318,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 +9420,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;
@@ -9770,12 +9909,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.
  */
@@ -9803,7 +9942,7 @@ type PromptBlockedReason = 'mention_surface' | 'ephemeral_trigger' | 'non_intera
 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 +9951,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`).
  */
@@ -9954,7 +10093,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,7 +10120,7 @@ interface Session {
     /**
      * Pull requests the session created or updated.
      */
-    output_prs: AgentSessionPr[] | null;
+    output_prs: SessionPr[] | null;
     /**
      * How this session relates to its parent session, if any.
      */
@@ -10016,8 +10155,8 @@ 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.
      */
@@ -10094,7 +10233,7 @@ interface GithubAccountSnippet {
  * 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;
@@ -10295,7 +10434,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,7 +10461,7 @@ interface Session1 {
     /**
      * Pull requests the session created or updated.
      */
-    output_prs: AgentSessionPr[] | null;
+    output_prs: SessionPr[] | null;
     /**
      * How this session relates to its parent session, if any.
      */
@@ -10357,8 +10496,8 @@ 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.
      */
@@ -10495,4 +10634,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 };