@ellipsis-dev/sdk 0.38.0 → 0.44.0

package/dist/{types-D4cLMGUn.d.ts → types-Dwyd1Aud.d.ts}

@@ -1274,7 +1274,7 @@ interface paths {
         get: operations['get_session'];
         /**
          * Update Session
-         * @description Archive or unarchive a session and return it.
+         * @description Archive or unarchive a session, or set its summary, and return it.
          *
          *     Set archived to true to record the current server time and the
          *     authenticated GitHub user. API-key requests record no user.
@@ -1292,6 +1292,11 @@ interface paths {
          *     take messages again. 409 `session_superseded` when a newer session
          *     now answers the same thread.
          *
+         *     Set summary to name the session. The summary's source becomes
+         *     `user`, and Ellipsis never replaces it with a generated one. With
+         *     both fields, the archive change applies first, and a refused
+         *     archive change leaves the summary as it was.
+         *
          *     Changes are delivered to session and session-list streams.
          */
         put: operations['update_session'];
@@ -1456,6 +1461,27 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/sessions/{id}/proxy': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Session Proxy
+         * @description The requests the session's environment sent to GitHub through
+         *     Ellipsis, newest first. Each is one `proxy_requests` row as stored.
+         */
+        get: operations['get_session_proxy'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/sessions/{id}/records': {
         parameters: {
             query?: never;
@@ -1523,6 +1549,54 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/sessions/{session_id}/images/{id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Session Image
+         * @description Return an image sent with a message to the session.
+         *
+         *     Each message lists its images, with their IDs, in `images`.
+         */
+        get: operations['get_session_image'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/user/settings': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get User Settings
+         * @description Get the signed in user's own settings.
+         */
+        get: operations['get_user_settings'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Patch User Settings
+         * @description Change the signed in user's own settings.
+         *
+         *     Only the keys sent change, and the response is every setting.
+         */
+        patch: operations['patch_user_settings'];
+        trace?: never;
+    };
     '/v1/user/tokens': {
         parameters: {
             query?: never;
@@ -4142,61 +4216,59 @@ interface components {
         };
         /**
          * ComputeConfig
-         * @description Environment compute sizing. Every field is optional; an omitted field
-         *     inherits the platform default (2 vCPU / 4096 MiB / 3600s). A resolved value
-         *     outside the platform bounds fails validation loudly (a sync error on the
-         *     config) rather than being clamped silently.
+         * @description The size and lifetime of the environment. Every field is optional. An
+         *     omitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,
+         *     10m idle). A value outside the platform bounds fails validation.
          *
-         *     `memory` and `timeout` each accept a shorthand string ("8GB", "30m") or an
-         *     explicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /
-         *     `timeout_seconds` properties resolve either form to the canonical integer
-         *     the environment is sized with.
+         *     `memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.
+         *     `timeout` and `idle` accept a duration string such as `30m`, `8h`, or
+         *     `1h30m`.
          *
-         *     `timeout` is the max wall-clock the agent may run in one environment before
-         *     it is stopped, capped at 1h (equal to the default, so today the knob only
-         *     shortens a session; the cap matches the 1-hour validity of the session's
-         *     GitHub token).
+         *     `timeout` is the longest one message's work may run before it is stopped,
+         *     1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.
          *
-         *     Compute currently uses a temporary flat one-cent amount each time an
-         *     environment is started for a session, subject to the account's existing
-         *     free-compute exemptions.
+         *     `idle` is how long the environment stays awake after the agent finishes
+         *     with no message waiting, 10s to 1h, default 10m. Then it pauses, and the
+         *     next message resumes it. Only an interactive session pauses. A session
+         *     that runs once ends when its message ends.
          */
         'ComputeConfig-Input': {
             /** Cpu */
             cpu?: number | null;
+            /** Idle */
+            idle?: string | null;
             /** Memory */
             memory?: string | components['schemas']['MemorySize-Input'] | null;
             /** Timeout */
-            timeout?: string | components['schemas']['Duration-Input'] | null;
+            timeout?: string | null;
         };
         /**
          * ComputeConfig
-         * @description Environment compute sizing. Every field is optional; an omitted field
-         *     inherits the platform default (2 vCPU / 4096 MiB / 3600s). A resolved value
-         *     outside the platform bounds fails validation loudly (a sync error on the
-         *     config) rather than being clamped silently.
+         * @description The size and lifetime of the environment. Every field is optional. An
+         *     omitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,
+         *     10m idle). A value outside the platform bounds fails validation.
          *
-         *     `memory` and `timeout` each accept a shorthand string ("8GB", "30m") or an
-         *     explicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /
-         *     `timeout_seconds` properties resolve either form to the canonical integer
-         *     the environment is sized with.
+         *     `memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.
+         *     `timeout` and `idle` accept a duration string such as `30m`, `8h`, or
+         *     `1h30m`.
          *
-         *     `timeout` is the max wall-clock the agent may run in one environment before
-         *     it is stopped, capped at 1h (equal to the default, so today the knob only
-         *     shortens a session; the cap matches the 1-hour validity of the session's
-         *     GitHub token).
+         *     `timeout` is the longest one message's work may run before it is stopped,
+         *     1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.
          *
-         *     Compute currently uses a temporary flat one-cent amount each time an
-         *     environment is started for a session, subject to the account's existing
-         *     free-compute exemptions.
+         *     `idle` is how long the environment stays awake after the agent finishes
+         *     with no message waiting, 10s to 1h, default 10m. Then it pauses, and the
+         *     next message resumes it. Only an interactive session pauses. A session
+         *     that runs once ends when its message ends.
          */
         'ComputeConfig-Output': {
             /** Cpu */
             cpu: number | null;
+            /** Idle */
+            idle: string | null;
             /** Memory */
             memory: string | components['schemas']['MemorySize-Output'] | null;
             /** Timeout */
-            timeout: string | components['schemas']['Duration-Output'] | null;
+            timeout: string | null;
         };
         /**
          * ConfigManagedBy
@@ -4470,7 +4542,7 @@ interface components {
          * CustomerAuditLogEventType
          * @enum {string}
          */
-        CustomerAuditLogEventType: 'system_limits_updated' | 'webhook_state_changed' | 'github_installation_created' | 'github_installation_removed' | 'github_installation_suspended' | 'github_installation_unsuspended' | 'credit_granted' | 'refund_issued' | 'auto_recharge_updated';
+        CustomerAuditLogEventType: 'system_limits_updated' | 'webhook_state_changed' | 'github_installation_created' | 'github_installation_removed' | 'github_installation_suspended' | 'github_installation_unsuspended' | 'credit_granted' | 'refund_issued' | 'auto_recharge_updated' | 'platform_fee_updated' | 'github_proxy_updated';
         /** DataRetentionSettings */
         'DataRetentionSettings-Input': {
             /**
@@ -4605,34 +4677,6 @@ interface components {
             /** @description The tokens the developer's agent sessions used. */
             tokens: components['schemas']['Tokens'];
         };
-        /**
-         * Duration
-         * @description A duration as explicit units, summed. Set any of `hours`/`minutes`/
-         *     `seconds` (at least one). The alternative to the `30m`-style shorthand
-         *     string wherever a duration is accepted.
-         */
-        'Duration-Input': {
-            /** Hours */
-            hours?: number | null;
-            /** Minutes */
-            minutes?: number | null;
-            /** Seconds */
-            seconds?: number | null;
-        };
-        /**
-         * Duration
-         * @description A duration as explicit units, summed. Set any of `hours`/`minutes`/
-         *     `seconds` (at least one). The alternative to the `30m`-style shorthand
-         *     string wherever a duration is accepted.
-         */
-        'Duration-Output': {
-            /** Hours */
-            hours: number | null;
-            /** Minutes */
-            minutes: number | null;
-            /** Seconds */
-            seconds: number | null;
-        };
         /**
          * EffortLevel
          * @enum {string}
@@ -5354,7 +5398,7 @@ interface components {
          * @description Why a message failed, was stopped, or was cancelled.
          * @enum {string}
          */
-        ErrorReason: 'error' | 'tool_call_failed' | 'budget_hit' | 'payment_required' | 'blocked' | 'contact_email_required' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_environment_variables' | 'missing_github_integration' | 'agent_unavailable' | 'upstream_unavailable' | 'unsupported_configuration' | 'execution_disabled' | 'interrupted' | 'stopped';
+        ErrorReason: 'error' | 'tool_call_failed' | 'budget_hit' | 'payment_required' | 'blocked' | 'contact_email_required' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_environment_variables' | 'missing_github_integration' | 'agent_unavailable' | 'upstream_unavailable' | 'unsupported_configuration' | 'execution_disabled' | 'interrupted' | 'stopped' | 'timeout';
         /**
          * ErrorResponse
          * @description The error envelope every /v1 error returns.
@@ -8068,6 +8112,22 @@ interface components {
             data_retention?: components['schemas']['DataRetentionSettings-Input'] | null;
             notifications?: components['schemas']['NotificationSettings'] | null;
         };
+        /**
+         * PatchUserSettingsRequest
+         * @description Change the keys sent; every other key stays as it is.
+         */
+        PatchUserSettingsRequest: {
+            web?: components['schemas']['PatchUserSettingsWeb'] | null;
+        };
+        /** PatchUserSettingsWeb */
+        PatchUserSettingsWeb: {
+            ui?: components['schemas']['PatchUserSettingsWebUi'] | null;
+        };
+        /** PatchUserSettingsWebUi */
+        PatchUserSettingsWebUi: {
+            density?: components['schemas']['UiSize'] | null;
+            font_size?: components['schemas']['UiSize'] | null;
+        };
         /**
          * PermissionsConfig
          * @description What the agent is allowed to touch, per credential the platform mints
@@ -8139,6 +8199,76 @@ interface components {
          * @enum {string}
          */
         PromptBlockedReason: 'mention_surface' | 'non_interactive' | 'harness_single_turn' | 'budget_exhausted' | 'closed' | 'archived';
+        /**
+         * ProxyRequest
+         * @description One request an environment sent through Ellipsis to GitHub, as the
+         *     proxy recorded it.
+         */
+        ProxyRequest: {
+            /**
+             * Connection
+             * @description Where it went. `github` today.
+             */
+            connection: string;
+            /**
+             * Created At
+             * Format: date-time
+             * @description When the request ended.
+             */
+            created_at: string;
+            /**
+             * Customer Id
+             * @description The account.
+             */
+            customer_id?: string | null;
+            /**
+             * Duration Ms
+             * @description Milliseconds from arrival to the end.
+             */
+            duration_ms: number;
+            /** Id */
+            id: string;
+            /**
+             * Method
+             * @description The HTTP method as the environment sent it.
+             */
+            method: string;
+            /**
+             * Path
+             * @description The path as the environment sent it.
+             */
+            path: string;
+            /**
+             * Reason
+             * @description Why Ellipsis answered itself or the transfer ended early, null when GitHub answered in full.
+             */
+            reason?: string | null;
+            /**
+             * Request Bytes
+             * @description Body bytes sent, null when none was read.
+             */
+            request_bytes?: number | null;
+            /**
+             * Response Bytes
+             * @description Body bytes received, null when nothing was forwarded.
+             */
+            response_bytes?: number | null;
+            /**
+             * Sandbox Id
+             * @description The environment that sent it, the id `GET /v1/vms/{id}` reads.
+             */
+            sandbox_id?: string | null;
+            /**
+             * Status Code
+             * @description The status the environment received.
+             */
+            status_code?: number | null;
+            /**
+             * Upstream Host
+             * @description The host Ellipsis forwarded it to, null when Ellipsis answered itself.
+             */
+            upstream_host?: string | null;
+        };
         /**
          * PublicFeeSchedule
          * @description Rates in millicents. purchase_fee_fraction is a fraction, for example 0.10.
@@ -8710,6 +8840,11 @@ interface components {
         Review: {
             /** Base Sha */
             base_sha: string;
+            /**
+             * Blocking
+             * @description Blocking comments posted to GitHub.
+             */
+            blocking: number;
             /**
              * Budget
              * @description The reviewer sessions' spend budgets together, in millicents.
@@ -8730,11 +8865,6 @@ interface components {
             event?: components['schemas']['CodeReviewEvent'] | null;
             /** Finalized At */
             finalized_at?: string | null;
-            /**
-             * Findings
-             * @description Comments the reviewers returned, posted to GitHub or not.
-             */
-            findings: number;
             /**
              * Github Review Id
              * @description The GitHub review id once posted.
@@ -8747,6 +8877,11 @@ interface components {
             head_sha: string;
             /** Id */
             id: string;
+            /**
+             * Non Blocking
+             * @description Comments posted to GitHub that do not block.
+             */
+            non_blocking: number;
             /** @description The pull request as it was when the review ran. Null for a review Ellipsis ran before it kept the pull request. */
             pull_request: components['schemas']['PullRequest'] | null;
             repository: components['schemas']['GithubRepositorySnippet'];
@@ -8947,6 +9082,11 @@ interface components {
         ReviewSummary: {
             /** Base Sha */
             base_sha: string;
+            /**
+             * Blocking
+             * @description Blocking comments posted to GitHub.
+             */
+            blocking: number;
             /**
              * Created At
              * Format: date-time
@@ -8958,11 +9098,6 @@ interface components {
             event?: components['schemas']['CodeReviewEvent'] | null;
             /** Finalized At */
             finalized_at?: string | null;
-            /**
-             * Findings
-             * @description Comments the reviewers returned, posted to GitHub or not.
-             */
-            findings: number;
             /**
              * Github Review Id
              * @description The GitHub review id once posted.
@@ -8975,6 +9110,11 @@ interface components {
             head_sha: string;
             /** Id */
             id: string;
+            /**
+             * Non Blocking
+             * @description Comments posted to GitHub that do not block.
+             */
+            non_blocking: number;
             /** @description The pull request as it was when the review ran. Null for a review Ellipsis ran before it kept the pull request. */
             pull_request: components['schemas']['PullRequest'] | null;
             repository: components['schemas']['GithubRepositorySnippet'];
@@ -10378,6 +10518,11 @@ interface components {
          *     `[Image #N]` placeholder in the message body.
          */
         SessionMessageImage: {
+            /**
+             * Id
+             * @description The image's ID. `GET /v1/sessions/{session_id}/images/{id}` returns its bytes. Null when the image can't be fetched.
+             */
+            id?: string | null;
             /**
              * Index
              * @description 1-based position: the N in `[Image #N]`.
@@ -10462,6 +10607,22 @@ interface components {
             /** Surface Name */
             surface_name: string | null;
         };
+        /** SessionProxyResponse */
+        SessionProxyResponse: {
+            /**
+             * Has More
+             * @description Whether more results exist past this page.
+             * @default false
+             */
+            has_more: boolean;
+            /**
+             * Next Cursor
+             * @description Pass as `cursor` to fetch the next page. Null on the last page. Opaque — echo it back rather than parsing it.
+             */
+            next_cursor?: string | null;
+            /** Proxy Requests */
+            proxy_requests: components['schemas']['ProxyRequest'][];
+        };
         /** SessionPullRequestReview */
         SessionPullRequestReview: {
             /** Body */
@@ -11308,6 +11469,12 @@ interface components {
              */
             output_tokens: number;
         };
+        /**
+         * UiSize
+         * @description A step on the dashboard's five-step scale, shared by every size setting.
+         * @enum {string}
+         */
+        UiSize: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
         /** UninstallGithubAppRequest */
         UninstallGithubAppRequest: {
             /** Confirm Account Login */
@@ -11401,14 +11568,19 @@ interface components {
         };
         /**
          * UpdateSessionRequest
-         * @description Set the session's archive state.
+         * @description Set the session's archive state, its summary, or both.
          */
         UpdateSessionRequest: {
             /**
              * Archived
              * @description True to archive the session; false to unarchive it.
              */
-            archived: boolean;
+            archived?: boolean | null;
+            /**
+             * Summary
+             * @description A name for the session. It becomes the summary with source `user`, and Ellipsis never replaces it with a generated one.
+             */
+            summary?: string | null;
         };
         /**
          * UsageDay
@@ -11446,6 +11618,36 @@ interface components {
             /** Space */
             space: number;
         };
+        /**
+         * UserSettings
+         * @description One user's own settings.
+         */
+        UserSettings: {
+            web: components['schemas']['UserSettingsWeb'];
+        };
+        /**
+         * UserSettingsWeb
+         * @description Settings for the web dashboard.
+         */
+        UserSettingsWeb: {
+            ui: components['schemas']['UserSettingsWebUi'];
+        };
+        /**
+         * UserSettingsWebUi
+         * @description How the web dashboard looks.
+         */
+        UserSettingsWebUi: {
+            /**
+             * @description How much padding the dashboard uses.
+             * @default md
+             */
+            density: components['schemas']['UiSize'];
+            /**
+             * @description How large the dashboard's text is.
+             * @default md
+             */
+            font_size: components['schemas']['UiSize'];
+        };
         /**
          * UserTokenApi
          * @description A user token as shown in listings -- never includes the secret.
@@ -16034,6 +16236,61 @@ interface operations {
             };
         };
     };
+    get_session_proxy: {
+        parameters: {
+            query?: {
+                limit?: number;
+                /** @description The `next_cursor` of the previous page. */
+                cursor?: string | null;
+            };
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['SessionProxyResponse'];
+                };
+            };
+            /** @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 Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     get_session_records: {
         parameters: {
             query?: {
@@ -16219,6 +16476,169 @@ interface operations {
             };
         };
     };
+    get_session_image: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path: {
+                session_id: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ImageAttachment'];
+                };
+            };
+            /** @description The bearer token is missing, invalid, or revoked. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description The credential may not perform this action, or the account is blocked. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description No such session or image in your account. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ErrorResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    get_user_settings: {
+        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']['UserSettings'];
+                };
+            };
+            /** @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 Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    patch_user_settings: {
+        parameters: {
+            query?: never;
+            header?: {
+                'user-agent'?: string | null;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['PatchUserSettingsRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['UserSettings'];
+                };
+            };
+            /** @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 Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     list_user_tokens: {
         parameters: {
             query?: never;
@@ -17491,7 +17911,7 @@ type EnvironmentSource = 'request' | 'agent' | 'repo_default' | 'account_default
 /**
  * What went wrong.
  */
-type ErrorReason = 'error' | 'tool_call_failed' | 'budget_hit' | 'payment_required' | 'blocked' | 'contact_email_required' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_environment_variables' | 'missing_github_integration' | 'agent_unavailable' | 'upstream_unavailable' | 'unsupported_configuration' | 'execution_disabled' | 'interrupted' | 'stopped';
+type ErrorReason = 'error' | 'tool_call_failed' | 'budget_hit' | 'payment_required' | 'blocked' | 'contact_email_required' | 'lifecycle_hook_failed' | 'missing_repo_access' | 'missing_token_permissions' | 'missing_environment_variables' | 'missing_github_integration' | 'agent_unavailable' | 'upstream_unavailable' | 'unsupported_configuration' | 'execution_disabled' | 'interrupted' | 'stopped' | 'timeout';
 /**
  * The service the handler responds to.
  */
@@ -17701,29 +18121,27 @@ interface EnvironmentConfig {
     variables: EnvironmentVariable[];
 }
 /**
- * Environment compute sizing. Every field is optional; an omitted field
- * inherits the platform default (2 vCPU / 4096 MiB / 3600s). A resolved value
- * outside the platform bounds fails validation loudly (a sync error on the
- * config) rather than being clamped silently.
+ * The size and lifetime of the environment. Every field is optional. An
+ * omitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,
+ * 10m idle). A value outside the platform bounds fails validation.
  *
- * `memory` and `timeout` each accept a shorthand string ("8GB", "30m") or an
- * explicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /
- * `timeout_seconds` properties resolve either form to the canonical integer
- * the environment is sized with.
+ * `memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.
+ * `timeout` and `idle` accept a duration string such as `30m`, `8h`, or
+ * `1h30m`.
  *
- * `timeout` is the max wall-clock the agent may run in one environment before
- * it is stopped, capped at 1h (equal to the default, so today the knob only
- * shortens a session; the cap matches the 1-hour validity of the session's
- * GitHub token).
+ * `timeout` is the longest one message's work may run before it is stopped,
+ * 1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.
  *
- * Compute currently uses a temporary flat one-cent amount each time an
- * environment is started for a session, subject to the account's existing
- * free-compute exemptions.
+ * `idle` is how long the environment stays awake after the agent finishes
+ * with no message waiting, 10s to 1h, default 10m. Then it pauses, and the
+ * next message resumes it. Only an interactive session pauses. A session
+ * that runs once ends when its message ends.
  */
 interface ComputeConfig {
     cpu: number | null;
+    idle: string | null;
     memory: string | MemorySize | null;
-    timeout: string | Duration | null;
+    timeout: string | null;
 }
 /**
  * A memory size as explicit units, summed (binary: 1GB = 1024MB = 1024MiB).
@@ -17734,16 +18152,6 @@ interface MemorySize {
     gb: number | null;
     mb: number | null;
 }
-/**
- * A duration as explicit units, summed. Set any of `hours`/`minutes`/
- * `seconds` (at least one). The alternative to the `30m`-style shorthand
- * string wherever a duration is accepted.
- */
-interface Duration {
-    hours: number | null;
-    minutes: number | null;
-    seconds: number | null;
-}
 /**
  * Environment lifecycle scripts, in order: build_base, after_checkout,
  * before_start, validate. The first two produce reusable snapshots;
@@ -18314,29 +18722,27 @@ interface SessionEnvironment {
     variables: EnvironmentVariable[];
 }
 /**
- * Environment compute sizing. Every field is optional; an omitted field
- * inherits the platform default (2 vCPU / 4096 MiB / 3600s). A resolved value
- * outside the platform bounds fails validation loudly (a sync error on the
- * config) rather than being clamped silently.
+ * The size and lifetime of the environment. Every field is optional. An
+ * omitted field takes the platform default (2 vCPUs, 4096 MiB, a 4h timeout,
+ * 10m idle). A value outside the platform bounds fails validation.
  *
- * `memory` and `timeout` each accept a shorthand string ("8GB", "30m") or an
- * explicit units object ({gb: 8}, {minutes: 30}); the `memory_mib` /
- * `timeout_seconds` properties resolve either form to the canonical integer
- * the environment is sized with.
+ * `memory` accepts a string such as `8GB` or an object such as `{gb: 8}`.
+ * `timeout` and `idle` accept a duration string such as `30m`, `8h`, or
+ * `1h30m`.
  *
- * `timeout` is the max wall-clock the agent may run in one environment before
- * it is stopped, capped at 1h (equal to the default, so today the knob only
- * shortens a session; the cap matches the 1-hour validity of the session's
- * GitHub token).
+ * `timeout` is the longest one message's work may run before it is stopped,
+ * 1m to 22h, default 4h. The message ends `stopped` with reason `timeout`.
  *
- * Compute currently uses a temporary flat one-cent amount each time an
- * environment is started for a session, subject to the account's existing
- * free-compute exemptions.
+ * `idle` is how long the environment stays awake after the agent finishes
+ * with no message waiting, 10s to 1h, default 10m. Then it pauses, and the
+ * next message resumes it. Only an interactive session pauses. A session
+ * that runs once ends when its message ends.
  */
 interface ComputeConfig1 {
     cpu: number | null;
+    idle: string | null;
     memory: string | MemorySize | null;
-    timeout: string | Duration | null;
+    timeout: string | null;
 }
 /**
  * Environment lifecycle scripts, in order: build_base, after_checkout,
@@ -19690,6 +20096,10 @@ interface SessionMessage {
  * `[Image #N]` placeholder in the message body.
  */
 interface SessionMessageImage {
+    /**
+     * The image's ID. `GET /v1/sessions/{session_id}/images/{id}` returns its bytes. Null when the image can't be fetched.
+     */
+    id?: string | null;
     /**
      * 1-based position: the N in `[Image #N]`.
      */
@@ -20153,4 +20563,4 @@ type ReviewsListResponse = components['schemas']['ReviewsListResponse'];
 type ReviewConfig = components['schemas']['ReviewConfig'];
 type ReviewConfigsListResponse = components['schemas']['ReviewConfigsListResponse'];
 
-export type { CodexMcpToolCallResult as $, AgentConfig as A, BudgetConfig as B, CheckRunAction as C, CodexCommandExecution as D, CodexCommandExecutionItem as E, CodexConfig as F, CodexContextCompaction as G, CodexEffortLevel as H, CodexErrorEvent as I, CodexErrorItem as J, CodexErrorParams as K, CodexEvent as L, CodexFileChange as M, CodexFileChangeItem as N, CodexFileUpdate as O, CodexItem as P, CodexItemCompleted as Q, CodexItemCompletedEvent as R, CodexItemParams as S, CodexItemStarted as T, CodexItemStartedEvent as U, CodexItemUpdatedEvent as V, CodexLocalImageInput as W, CodexMcpToolCall as X, CodexMcpToolCallAppContext as Y, CodexMcpToolCallError as Z, CodexMcpToolCallItem as _, AgentIdentity as a, GeminiToolError as a$, CodexPlan as a0, CodexReasoning as a1, CodexReasoningItem as a2, CodexSessionRecord as a3, CodexSubAgentActivity as a4, CodexTextInput as a5, CodexThread as a6, CodexThreadStarted as a7, CodexThreadStartedEvent as a8, CodexThreadStartedParams as a9, EffortLevel as aA, EllipsisGrant as aB, EllipsisPermissions as aC, EnvironmentBaseBuild as aD, EnvironmentConfig as aE, EnvironmentHooks as aF, EnvironmentHooks1 as aG, EnvironmentOutputPayload as aH, EnvironmentOutputRecord as aI, EnvironmentPhasePayload as aJ, EnvironmentPhaseRecord as aK, EnvironmentReadyPayload as aL, EnvironmentReadyRecord as aM, EnvironmentScript as aN, EnvironmentSource as aO, EnvironmentVariable as aP, ErrorFrame as aQ, ErrorReason as aR, GeminiConfig as aS, GeminiErrorEvent as aT, GeminiInitEvent as aU, GeminiMessageEvent as aV, GeminiModelStats as aW, GeminiResultEvent as aX, GeminiSessionRecord as aY, GeminiStreamEvent as aZ, GeminiStreamStats as a_, CodexThreadTokenUsage as aa, CodexTodoListItem as ab, CodexTokenUsageBreakdown as ac, CodexTokenUsageParams as ad, CodexTokenUsageUpdated as ae, CodexTurn as af, CodexTurnCompleted as ag, CodexTurnCompletedEvent as ah, CodexTurnError as ai, CodexTurnFailedEvent as aj, CodexTurnParams as ak, CodexTurnStarted as al, CodexTurnStartedEvent as am, CodexUsage as an, CodexUserInput as ao, CodexUserMessage as ap, CodexWebSearch as aq, CodexWebSearchItem as ar, ComputeConfig as as, ComputeConfig1 as at, ConfigMetadata as au, Cost as av, Cost1 as aw, CronTrigger as ax, DeltaFrame as ay, Duration as az, AttributionType as b, ReactStatus as b$, GeminiToolResultEvent as b0, GeminiToolUseEvent as b1, GithubAccountFilter as b2, GithubAccountSelector as b3, GithubAccountSnippet as b4, GithubAccountType as b5, GithubCheckRunEvent as b6, GithubCheckSuiteEvent as b7, GithubIssueEvent as b8, GithubPermissions as b9, MessageEndedPayload as bA, MessageEndedRecord as bB, MessageQueuedPayload as bC, MessageQueuedRecord as bD, MessageRecord as bE, MessageRequeuedPayload as bF, MessageRequeuedRecord as bG, MessageStartedPayload as bH, MessageStartedRecord as bI, ModelLlmCostSplit as bJ, ModelTokenCounts as bK, OutputConfig as bL, PermissionsConfig as bM, PermissionsConfig1 as bN, PlatformSessionRecord as bO, PromptBlockedReason as bP, PullRequest as bQ, PullRequestAction as bR, ReactCheckRun as bS, ReactCheckSuite as bT, ReactIssue as bU, ReactLinearIssue as bV, ReactPullRequest as bW, ReactPush as bX, ReactRelease as bY, ReactSentry as bZ, ReactSlackChannel as b_, GithubPullRequestEvent as ba, GithubPushEvent as bb, GithubReleaseEvent as bc, GithubStatusEvent as bd, GithubWorkflowRunEvent as be, HandlerService as bf, HeartbeatFrame as bg, InputContract as bh, IssueAction as bi, LegacyAssistantPayload as bj, LegacyNativeUsage as bk, LegacyResultPayload as bl, Level as bm, LifecycleSessionRecord as bn, LinearIssueAction as bo, LinearIssueChanged as bp, LinearIssueEvent as bq, LinearLabelsChange as br, LinearValueChange as bs, LinearValueFilter as bt, LlmCost as bu, LlmCostSplit as bv, McpRemoteServer as bw, McpServerRef as bx, McpStdioServer as by, MemorySize as bz, components as c, SessionSummarySource as c$, ReactTrigger as c0, ReactWorkflowRun as c1, RecordsFrame as c2, ReleaseAction as c3, RepositoryFilter as c4, RepositoryRef as c5, Review as c6, ReviewComment as c7, ReviewConfig as c8, ReviewConfigsListResponse as c9, SessionConfig as cA, SessionConversation as cB, SessionConversationConfig as cC, SessionEnvironment as cD, SessionError as cE, SessionEventActor as cF, SessionFrame as cG, SessionGit as cH, SessionGitCommit as cI, SessionGitFile as cJ, SessionGitPr as cK, SessionGitRepo as cL, SessionHandler as cM, SessionMessage as cN, SessionMessageImage as cO, SessionMessageResponse as cP, SessionOutput as cQ, SessionParent as cR, SessionPrompting as cS, SessionRecord as cT, SessionRecordsListResponse as cU, SessionResponse as cV, SessionReview as cW, SessionSource as cX, SessionStatus as cY, SessionStreamFrame as cZ, SessionSummary as c_, ReviewReviewer as ca, ReviewSummary as cb, ReviewsListResponse as cc, SdkAssistantRecord as cd, SdkCacheCreation as ce, SdkContentBlock as cf, SdkRateLimitRecord as cg, SdkRecord as ch, SdkResultRecord as ci, SdkServerToolResultBlock as cj, SdkServerToolUseBlock as ck, SdkSystemRecord as cl, SdkTextBlock as cm, SdkThinkingBlock as cn, SdkToolResultBlock as co, SdkToolUseBlock as cp, SdkUserRecord as cq, SendSessionMessageRequest as cr, SentryAction as cs, SentryAlertEvent as ct, Session as cu, SessionAgent as cv, SessionArchived as cw, SessionAttribution as cx, SessionClosedPayload as cy, SessionClosedRecord as cz, CheckSuiteAction as d, SessionsListResponse as d0, SettingsRef as d1, SkillRef as d2, SlackChannelCreatedEvent as d3, SlackMessageEvent as d4, StatusAction as d5, StreamFrame as d6, TokenCounts as d7, Tokens as d8, Tokens1 as d9, TokensInfo as da, UnknownSessionRecord as db, UpdateSessionRequest as dc, WorkflowRunAction as dd, paths as de, ClaudeAssistantEvent as e, ClaudeAssistantMessage as f, ClaudeConfig as g, ClaudeConversationResetEvent as h, ClaudeNativeEvent as i, ClaudeNativeSessionRecord as j, ClaudeNativeUsage as k, ClaudeRateLimitEvent as l, ClaudeRateLimitInfo as m, ClaudeResultEvent as n, ClaudeSessionRecord as o, ClaudeSystemEvent as p, ClaudeUserEvent as q, ClaudeUserMessage as r, CodexAgentMessage as s, CodexAgentMessageItem as t, CodexAppServerError as u, CodexAppServerEvent as v, CodexAppServerItem as w, CodexAppServerNotification as x, CodexAppServerSessionRecord as y, CodexCollabAgentToolCall as z };
+export type { CodexMcpToolCallResult as $, AgentConfig as A, BudgetConfig as B, CheckRunAction as C, CodexCommandExecution as D, CodexCommandExecutionItem as E, CodexConfig as F, CodexContextCompaction as G, CodexEffortLevel as H, CodexErrorEvent as I, CodexErrorItem as J, CodexErrorParams as K, CodexEvent as L, CodexFileChange as M, CodexFileChangeItem as N, CodexFileUpdate as O, CodexItem as P, CodexItemCompleted as Q, CodexItemCompletedEvent as R, CodexItemParams as S, CodexItemStarted as T, CodexItemStartedEvent as U, CodexItemUpdatedEvent as V, CodexLocalImageInput as W, CodexMcpToolCall as X, CodexMcpToolCallAppContext as Y, CodexMcpToolCallError as Z, CodexMcpToolCallItem as _, AgentIdentity as a, GeminiToolResultEvent as a$, CodexPlan as a0, CodexReasoning as a1, CodexReasoningItem as a2, CodexSessionRecord as a3, CodexSubAgentActivity as a4, CodexTextInput as a5, CodexThread as a6, CodexThreadStarted as a7, CodexThreadStartedEvent as a8, CodexThreadStartedParams as a9, EllipsisGrant as aA, EllipsisPermissions as aB, EnvironmentBaseBuild as aC, EnvironmentConfig as aD, EnvironmentHooks as aE, EnvironmentHooks1 as aF, EnvironmentOutputPayload as aG, EnvironmentOutputRecord as aH, EnvironmentPhasePayload as aI, EnvironmentPhaseRecord as aJ, EnvironmentReadyPayload as aK, EnvironmentReadyRecord as aL, EnvironmentScript as aM, EnvironmentSource as aN, EnvironmentVariable as aO, ErrorFrame as aP, ErrorReason as aQ, GeminiConfig as aR, GeminiErrorEvent as aS, GeminiInitEvent as aT, GeminiMessageEvent as aU, GeminiModelStats as aV, GeminiResultEvent as aW, GeminiSessionRecord as aX, GeminiStreamEvent as aY, GeminiStreamStats as aZ, GeminiToolError as a_, CodexThreadTokenUsage as aa, CodexTodoListItem as ab, CodexTokenUsageBreakdown as ac, CodexTokenUsageParams as ad, CodexTokenUsageUpdated as ae, CodexTurn as af, CodexTurnCompleted as ag, CodexTurnCompletedEvent as ah, CodexTurnError as ai, CodexTurnFailedEvent as aj, CodexTurnParams as ak, CodexTurnStarted as al, CodexTurnStartedEvent as am, CodexUsage as an, CodexUserInput as ao, CodexUserMessage as ap, CodexWebSearch as aq, CodexWebSearchItem as ar, ComputeConfig as as, ComputeConfig1 as at, ConfigMetadata as au, Cost as av, Cost1 as aw, CronTrigger as ax, DeltaFrame as ay, EffortLevel as az, AttributionType as b, ReactTrigger as b$, GeminiToolUseEvent as b0, GithubAccountFilter as b1, GithubAccountSelector as b2, GithubAccountSnippet as b3, GithubAccountType as b4, GithubCheckRunEvent as b5, GithubCheckSuiteEvent as b6, GithubIssueEvent as b7, GithubPermissions as b8, GithubPullRequestEvent as b9, MessageEndedRecord as bA, MessageQueuedPayload as bB, MessageQueuedRecord as bC, MessageRecord as bD, MessageRequeuedPayload as bE, MessageRequeuedRecord as bF, MessageStartedPayload as bG, MessageStartedRecord as bH, ModelLlmCostSplit as bI, ModelTokenCounts as bJ, OutputConfig as bK, PermissionsConfig as bL, PermissionsConfig1 as bM, PlatformSessionRecord as bN, PromptBlockedReason as bO, PullRequest as bP, PullRequestAction as bQ, ReactCheckRun as bR, ReactCheckSuite as bS, ReactIssue as bT, ReactLinearIssue as bU, ReactPullRequest as bV, ReactPush as bW, ReactRelease as bX, ReactSentry as bY, ReactSlackChannel as bZ, ReactStatus as b_, GithubPushEvent as ba, GithubReleaseEvent as bb, GithubStatusEvent as bc, GithubWorkflowRunEvent as bd, HandlerService as be, HeartbeatFrame as bf, InputContract as bg, IssueAction as bh, LegacyAssistantPayload as bi, LegacyNativeUsage as bj, LegacyResultPayload as bk, Level as bl, LifecycleSessionRecord as bm, LinearIssueAction as bn, LinearIssueChanged as bo, LinearIssueEvent as bp, LinearLabelsChange as bq, LinearValueChange as br, LinearValueFilter as bs, LlmCost as bt, LlmCostSplit as bu, McpRemoteServer as bv, McpServerRef as bw, McpStdioServer as bx, MemorySize as by, MessageEndedPayload as bz, components as c, SessionsListResponse as c$, ReactWorkflowRun as c0, RecordsFrame as c1, ReleaseAction as c2, RepositoryFilter as c3, RepositoryRef as c4, Review as c5, ReviewComment as c6, ReviewConfig as c7, ReviewConfigsListResponse as c8, ReviewReviewer as c9, SessionConversation as cA, SessionConversationConfig as cB, SessionEnvironment as cC, SessionError as cD, SessionEventActor as cE, SessionFrame as cF, SessionGit as cG, SessionGitCommit as cH, SessionGitFile as cI, SessionGitPr as cJ, SessionGitRepo as cK, SessionHandler as cL, SessionMessage as cM, SessionMessageImage as cN, SessionMessageResponse as cO, SessionOutput as cP, SessionParent as cQ, SessionPrompting as cR, SessionRecord as cS, SessionRecordsListResponse as cT, SessionResponse as cU, SessionReview as cV, SessionSource as cW, SessionStatus as cX, SessionStreamFrame as cY, SessionSummary as cZ, SessionSummarySource as c_, ReviewSummary as ca, ReviewsListResponse as cb, SdkAssistantRecord as cc, SdkCacheCreation as cd, SdkContentBlock as ce, SdkRateLimitRecord as cf, SdkRecord as cg, SdkResultRecord as ch, SdkServerToolResultBlock as ci, SdkServerToolUseBlock as cj, SdkSystemRecord as ck, SdkTextBlock as cl, SdkThinkingBlock as cm, SdkToolResultBlock as cn, SdkToolUseBlock as co, SdkUserRecord as cp, SendSessionMessageRequest as cq, SentryAction as cr, SentryAlertEvent as cs, Session as ct, SessionAgent as cu, SessionArchived as cv, SessionAttribution as cw, SessionClosedPayload as cx, SessionClosedRecord as cy, SessionConfig as cz, CheckSuiteAction as d, SettingsRef as d0, SkillRef as d1, SlackChannelCreatedEvent as d2, SlackMessageEvent as d3, StatusAction as d4, StreamFrame as d5, TokenCounts as d6, Tokens as d7, Tokens1 as d8, TokensInfo as d9, UnknownSessionRecord as da, UpdateSessionRequest as db, WorkflowRunAction as dc, paths as dd, ClaudeAssistantEvent as e, ClaudeAssistantMessage as f, ClaudeConfig as g, ClaudeConversationResetEvent as h, ClaudeNativeEvent as i, ClaudeNativeSessionRecord as j, ClaudeNativeUsage as k, ClaudeRateLimitEvent as l, ClaudeRateLimitInfo as m, ClaudeResultEvent as n, ClaudeSessionRecord as o, ClaudeSystemEvent as p, ClaudeUserEvent as q, ClaudeUserMessage as r, CodexAgentMessage as s, CodexAgentMessageItem as t, CodexAppServerError as u, CodexAppServerEvent as v, CodexAppServerItem as w, CodexAppServerNotification as x, CodexAppServerSessionRecord as y, CodexCollabAgentToolCall as z };