openai 7.24.0 → 7.25.0

package/resources/beta/agents/agents.d.mts

@@ -143,6 +143,49 @@ export interface Agent {
      */
     updated_at: number;
 }
+export interface AgentBrowserAuthenticationCancelParam {
+    action: 'cancel';
+    type: 'browser_authentication';
+}
+export interface AgentBrowserAuthenticationSubmitParam {
+    action: 'submit';
+    /**
+     * Values for up to six active fields in the required action. The submitted
+     * field-value mapping and selected option must fit within 120 KiB of JSON.
+     */
+    fields: Array<AgentBrowserAuthenticationSubmitParam.Field>;
+    type: 'browser_authentication';
+    /**
+     * The chosen method. Required when the required action contains options.
+     */
+    selected_option?: string | null;
+}
+export declare namespace AgentBrowserAuthenticationSubmitParam {
+    /**
+     * One user-entered value, including non-password fields such as an email address.
+     */
+    interface Field {
+        /**
+         * The field ID from the required action.
+         */
+        field_id: string;
+        /**
+         * The value to enter into the registered control.
+         */
+        value: string;
+    }
+}
+export interface AgentBrowserOriginAccessParam {
+    /**
+     * Whether to allow, deny, or cancel the requested origin access.
+     *
+     * - `approve` - Allow the browser to access this origin.
+     * - `deny` - Deny access to this origin.
+     * - `cancel` - Dismiss this request without approving access.
+     */
+    decision: 'approve' | 'deny' | 'cancel';
+    type: 'browser_origin_access';
+}
 /**
  * A request to close a subagent.
  */
@@ -443,7 +486,141 @@ export interface AgentOutputCommandExecutionOutputDeltaEvent {
 /**
  * An output item produced by an agent.
  */
-export type AgentOutputItem = AgentSessionAssistantMessage | AgentReasoningItem | AgentFunctionCallItem | AgentMcpCallItem | AgentWebSearchCallItem | AgentCommandExecutionItem | AgentCreateSubagentCallItem | AgentSendSubagentInputCallItem | AgentResumeSubagentCallItem | AgentWaitForSubagentsCallItem | AgentInterruptSubagentCallItem | AgentCloseSubagentCallItem;
+export type AgentOutputItem = AgentSessionAssistantMessage | AgentReasoningItem | AgentFunctionCallItem | AgentMcpCallItem | AgentOutputItem.ComputerUseCallItemResource | AgentOutputItem.BrowserAuthenticationRequestItemResource | AgentWebSearchCallItem | AgentCommandExecutionItem | AgentCreateSubagentCallItem | AgentSendSubagentInputCallItem | AgentResumeSubagentCallItem | AgentWaitForSubagentsCallItem | AgentInterruptSubagentCallItem | AgentCloseSubagentCallItem;
+export declare namespace AgentOutputItem {
+    /**
+     * One execution of the platform-provided computer-use capability.
+     */
+    interface ComputerUseCallItemResource {
+        /**
+         * The ID of the activity item.
+         */
+        id: string;
+        /**
+         * The last screenshot emitted by the model. Null when screenshot inclusion is
+         * disabled or the call emitted no screenshot.
+         */
+        output: ComputerUseCallItemResource.Output | null;
+        /**
+         * The execution status of the activity.
+         */
+        status: AgentsAPI.AgentFunctionCallStatus;
+        /**
+         * A model-generated description of the activity, when available.
+         */
+        title: string | null;
+        /**
+         * The ID of the turn that contains this item.
+         */
+        turn_id: string;
+        /**
+         * The item type. Always `computer_use_call`.
+         */
+        type: 'computer_use_call';
+    }
+    namespace ComputerUseCallItemResource {
+        /**
+         * The last screenshot emitted by the model. Null when screenshot inclusion is
+         * disabled or the call emitted no screenshot.
+         */
+        interface Output {
+            /**
+             * The complete JPEG image as a base64 data URL.
+             */
+            image_url: string;
+            /**
+             * The content type. Always `computer_screenshot`.
+             */
+            type: 'computer_screenshot';
+        }
+    }
+    /**
+     * A credential-free history record of the emitted login request.
+     */
+    interface BrowserAuthenticationRequestItemResource {
+        /**
+         * The stable history item ID.
+         */
+        id: string;
+        /**
+         * A registered form awaiting the application's response.
+         */
+        request: BrowserAuthenticationRequestItemResource.Request;
+        request_id: string;
+        turn_id: string;
+        /**
+         * The item type. Always computer_use_approval_request.
+         */
+        type: 'computer_use_approval_request';
+    }
+    namespace BrowserAuthenticationRequestItemResource {
+        /**
+         * A registered form awaiting the application's response.
+         */
+        interface Request {
+            /**
+             * The registered form or frame origin where values will be entered.
+             */
+            credential_origin: string | null;
+            /**
+             * Controls to render. All submitted values are sensitive.
+             */
+            fields: Array<Request.Field>;
+            /**
+             * Sign-in methods. Empty for a plain form.
+             */
+            options: Array<Request.Option>;
+            /**
+             * Why the agent needs the user to sign in.
+             */
+            reason: string | null;
+            /**
+             * The type of the object. Always `browser_authentication`.
+             */
+            type: 'browser_authentication';
+        }
+        namespace Request {
+            /**
+             * A control in a registered browser-login form.
+             */
+            interface Field {
+                /**
+                 * The field ID to submit as field_id in a fields entry.
+                 */
+                id: string;
+                /**
+                 * The label to display beside the control.
+                 */
+                label: string;
+                /**
+                 * Whether this control requires a nonempty value.
+                 */
+                required: boolean;
+                /**
+                 * The rendering type, such as email, password, or text.
+                 */
+                type: string;
+            }
+            /**
+             * A sign-in method and the fields that belong to it.
+             */
+            interface Option {
+                /**
+                 * The option ID to submit as selected_option.
+                 */
+                id: string;
+                /**
+                 * IDs from the registered fields that this method accepts.
+                 */
+                field_ids: Array<string>;
+                /**
+                 * The method label to display.
+                 */
+                label: string;
+            }
+        }
+    }
+}
 /**
  * The status of an agent output item.
  *
@@ -618,7 +795,7 @@ export interface AgentSession {
     /**
      * Actions that must be completed before the session can continue.
      */
-    required_actions: Array<AgentSession.SessionRequiredActionResourceFunctionCall | AgentSession.SessionRequiredActionResourceEnvironmentConnection>;
+    required_actions: Array<AgentSession.SessionRequiredActionResourceComputerUseApprovalRequest | AgentSession.SessionRequiredActionResourceFunctionCall | AgentSession.SessionRequiredActionResourceEnvironmentConnection>;
     /**
      * The current status of the session.
      *
@@ -682,6 +859,111 @@ export declare namespace AgentSession {
          */
         tools: Array<AgentsAPI.AgentTool>;
     }
+    /**
+     * Respond to a computer-use request.
+     */
+    interface SessionRequiredActionResourceComputerUseApprovalRequest {
+        /**
+         * The information needed to render the request.
+         */
+        request: SessionRequiredActionResourceComputerUseApprovalRequest.ComputerUseApprovalRequestKindResourceBrowserAuthentication | SessionRequiredActionResourceComputerUseApprovalRequest.ComputerUseApprovalRequestKindResourceBrowserOriginAccess;
+        /**
+         * The registered request ID to echo when responding.
+         */
+        request_id: string;
+        /**
+         * The turn that requested approval.
+         */
+        turn_id: string;
+        /**
+         * The type of the object. Always `computer_use_approval_request`.
+         */
+        type: 'computer_use_approval_request';
+    }
+    namespace SessionRequiredActionResourceComputerUseApprovalRequest {
+        /**
+         * A registered form awaiting the application's response.
+         */
+        interface ComputerUseApprovalRequestKindResourceBrowserAuthentication {
+            /**
+             * The registered form or frame origin where values will be entered.
+             */
+            credential_origin: string | null;
+            /**
+             * Controls to render. All submitted values are sensitive.
+             */
+            fields: Array<ComputerUseApprovalRequestKindResourceBrowserAuthentication.Field>;
+            /**
+             * Sign-in methods. Empty for a plain form.
+             */
+            options: Array<ComputerUseApprovalRequestKindResourceBrowserAuthentication.Option>;
+            /**
+             * Why the agent needs the user to sign in.
+             */
+            reason: string | null;
+            /**
+             * The type of the object. Always `browser_authentication`.
+             */
+            type: 'browser_authentication';
+        }
+        namespace ComputerUseApprovalRequestKindResourceBrowserAuthentication {
+            /**
+             * A control in a registered browser-login form.
+             */
+            interface Field {
+                /**
+                 * The field ID to submit as field_id in a fields entry.
+                 */
+                id: string;
+                /**
+                 * The label to display beside the control.
+                 */
+                label: string;
+                /**
+                 * Whether this control requires a nonempty value.
+                 */
+                required: boolean;
+                /**
+                 * The rendering type, such as email, password, or text.
+                 */
+                type: string;
+            }
+            /**
+             * A sign-in method and the fields that belong to it.
+             */
+            interface Option {
+                /**
+                 * The option ID to submit as selected_option.
+                 */
+                id: string;
+                /**
+                 * IDs from the registered fields that this method accepts.
+                 */
+                field_ids: Array<string>;
+                /**
+                 * The method label to display.
+                 */
+                label: string;
+            }
+        }
+        /**
+         * A browser origin awaiting the application's approval decision.
+         */
+        interface ComputerUseApprovalRequestKindResourceBrowserOriginAccess {
+            /**
+             * The origin the browser needs permission to access.
+             */
+            origin: string;
+            /**
+             * The browser's explanation for this request, or null when unavailable.
+             */
+            reason: string | null;
+            /**
+             * The type of the object. Always `browser_origin_access`.
+             */
+            type: 'browser_origin_access';
+        }
+    }
     /**
      * Run a function tool and submit its result.
      */
@@ -1090,8 +1372,26 @@ export interface AgentSessionInputMessageParam {
 /**
  * Input submitted to an existing session.
  */
-export type AgentSessionInputParam = AgentSessionInputParam.SessionInputParamAgentSessionInputMessage | AgentSessionInputParam.SessionInputParamAgentSessionInputCancel | AgentSessionInputParam.SessionInputParamAgentSessionInputToolResult;
+export type AgentSessionInputParam = AgentSessionInputParam.SessionInputParamAgentSessionInputComputerUseApprovalRequestResult | AgentSessionInputParam.SessionInputParamAgentSessionInputMessage | AgentSessionInputParam.SessionInputParamAgentSessionInputCancel | AgentSessionInputParam.SessionInputParamAgentSessionInputToolResult;
 export declare namespace AgentSessionInputParam {
+    /**
+     * Responds to a pending Computer Use approval request.
+     */
+    interface SessionInputParamAgentSessionInputComputerUseApprovalRequestResult {
+        /**
+         * The registered request ID from the required action.
+         */
+        request_id: string;
+        /**
+         * The response for this request type.
+         */
+        response: AgentsAPI.AgentBrowserAuthenticationSubmitParam | AgentsAPI.AgentBrowserAuthenticationCancelParam | AgentsAPI.AgentBrowserOriginAccessParam;
+        /**
+         * The type of the object. Always
+         * `agent.session.input.computer_use_approval_request_result`.
+         */
+        type: 'agent.session.input.computer_use_approval_request_result';
+    }
     /**
      * Adds one or more user messages and starts a turn.
      */
@@ -1147,7 +1447,7 @@ export declare namespace AgentSessionInputParam {
 /**
  * An item associated with a session turn.
  */
-export type AgentSessionItem = AgentSessionMessage | AgentReasoningItem | AgentFunctionCallItem | AgentSessionItem.FunctionCallOutputItemResource | AgentSessionItem.AgentMessageItemResource | AgentMcpCallItem | AgentWebSearchCallItem | AgentCommandExecutionItem | AgentCreateSubagentCallItem | AgentSendSubagentInputCallItem | AgentResumeSubagentCallItem | AgentWaitForSubagentsCallItem | AgentInterruptSubagentCallItem | AgentCloseSubagentCallItem;
+export type AgentSessionItem = AgentSessionMessage | AgentReasoningItem | AgentFunctionCallItem | AgentSessionItem.FunctionCallOutputItemResource | AgentSessionItem.AgentMessageItemResource | AgentMcpCallItem | AgentSessionItem.ComputerUseCallItemResource | AgentSessionItem.BrowserAuthenticationRequestItemResource | AgentSessionItem.ComputerUseApprovalRequestResultItemResource | AgentWebSearchCallItem | AgentCommandExecutionItem | AgentCreateSubagentCallItem | AgentSendSubagentInputCallItem | AgentResumeSubagentCallItem | AgentWaitForSubagentsCallItem | AgentInterruptSubagentCallItem | AgentCloseSubagentCallItem;
 export declare namespace AgentSessionItem {
     /**
      * The result supplied for a function call.
@@ -1211,6 +1511,174 @@ export declare namespace AgentSessionItem {
          */
         type: 'agent_message';
     }
+    /**
+     * One execution of the platform-provided computer-use capability.
+     */
+    interface ComputerUseCallItemResource {
+        /**
+         * The ID of the activity item.
+         */
+        id: string;
+        /**
+         * The last screenshot emitted by the model. Null when screenshot inclusion is
+         * disabled or the call emitted no screenshot.
+         */
+        output: ComputerUseCallItemResource.Output | null;
+        /**
+         * The execution status of the activity.
+         */
+        status: AgentsAPI.AgentFunctionCallStatus;
+        /**
+         * A model-generated description of the activity, when available.
+         */
+        title: string | null;
+        /**
+         * The ID of the turn that contains this item.
+         */
+        turn_id: string;
+        /**
+         * The item type. Always `computer_use_call`.
+         */
+        type: 'computer_use_call';
+    }
+    namespace ComputerUseCallItemResource {
+        /**
+         * The last screenshot emitted by the model. Null when screenshot inclusion is
+         * disabled or the call emitted no screenshot.
+         */
+        interface Output {
+            /**
+             * The complete JPEG image as a base64 data URL.
+             */
+            image_url: string;
+            /**
+             * The content type. Always `computer_screenshot`.
+             */
+            type: 'computer_screenshot';
+        }
+    }
+    /**
+     * A credential-free history record of the emitted login request.
+     */
+    interface BrowserAuthenticationRequestItemResource {
+        /**
+         * The stable history item ID.
+         */
+        id: string;
+        /**
+         * A registered form awaiting the application's response.
+         */
+        request: BrowserAuthenticationRequestItemResource.Request;
+        request_id: string;
+        turn_id: string;
+        /**
+         * The item type. Always computer_use_approval_request.
+         */
+        type: 'computer_use_approval_request';
+    }
+    namespace BrowserAuthenticationRequestItemResource {
+        /**
+         * A registered form awaiting the application's response.
+         */
+        interface Request {
+            /**
+             * The registered form or frame origin where values will be entered.
+             */
+            credential_origin: string | null;
+            /**
+             * Controls to render. All submitted values are sensitive.
+             */
+            fields: Array<Request.Field>;
+            /**
+             * Sign-in methods. Empty for a plain form.
+             */
+            options: Array<Request.Option>;
+            /**
+             * Why the agent needs the user to sign in.
+             */
+            reason: string | null;
+            /**
+             * The type of the object. Always `browser_authentication`.
+             */
+            type: 'browser_authentication';
+        }
+        namespace Request {
+            /**
+             * A control in a registered browser-login form.
+             */
+            interface Field {
+                /**
+                 * The field ID to submit as field_id in a fields entry.
+                 */
+                id: string;
+                /**
+                 * The label to display beside the control.
+                 */
+                label: string;
+                /**
+                 * Whether this control requires a nonempty value.
+                 */
+                required: boolean;
+                /**
+                 * The rendering type, such as email, password, or text.
+                 */
+                type: string;
+            }
+            /**
+             * A sign-in method and the fields that belong to it.
+             */
+            interface Option {
+                /**
+                 * The option ID to submit as selected_option.
+                 */
+                id: string;
+                /**
+                 * IDs from the registered fields that this method accepts.
+                 */
+                field_ids: Array<string>;
+                /**
+                 * The method label to display.
+                 */
+                label: string;
+            }
+        }
+    }
+    /**
+     * A credential-free record of an admitted response, not proof of completion.
+     */
+    interface ComputerUseApprovalRequestResultItemResource {
+        /**
+         * The stable history item ID.
+         */
+        id: string;
+        /**
+         * The registered request answered by this item.
+         */
+        request_id: string;
+        /**
+         * The admitted response, without submitted credential values.
+         */
+        response: ComputerUseApprovalRequestResultItemResource.ComputerUseApprovalResponseKindResourceBrowserAuthenticationSubmitResource | ComputerUseApprovalRequestResultItemResource.ComputerUseApprovalResponseKindResourceBrowserAuthenticationCancelResource;
+        /**
+         * The ID of the turn that contains this item.
+         */
+        turn_id: string;
+        type: 'computer_use_approval_request_result';
+    }
+    namespace ComputerUseApprovalRequestResultItemResource {
+        interface ComputerUseApprovalResponseKindResourceBrowserAuthenticationSubmitResource {
+            action: 'submit';
+            /**
+             * The chosen sign-in method, or null when no options were offered.
+             */
+            selected_option: string | null;
+            type: 'browser_authentication';
+        }
+        interface ComputerUseApprovalResponseKindResourceBrowserAuthenticationCancelResource {
+            action: 'cancel';
+            type: 'browser_authentication';
+        }
+    }
 }
 /**
  * A user or assistant message recorded in a session.
@@ -1894,7 +2362,7 @@ export interface AgentTextParam {
 /**
  * A tool available to the agent.
  */
-export type AgentTool = AgentTool.AgentToolResourceFunction | AgentTool.AgentToolResourceProgrammaticToolCalling | AgentTool.AgentToolResourceMcp | AgentTool.AgentToolResourceWebSearch;
+export type AgentTool = AgentTool.AgentToolResourceFunction | AgentTool.AgentToolResourceProgrammaticToolCalling | AgentTool.AgentToolResourceMcp | AgentTool.AgentToolResourceWebSearch | AgentTool.AgentToolResourceComputerUse;
 export declare namespace AgentTool {
     /**
      * A function defined by the application.
@@ -2024,11 +2492,24 @@ export declare namespace AgentTool {
             timezone: string | null;
         }
     }
+    /**
+     * Browser use in an OpenAI-hosted session.
+     */
+    interface AgentToolResourceComputerUse {
+        /**
+         * Whether computer tool outputs include screenshots.
+         */
+        include_screenshots: boolean;
+        /**
+         * The type of the object. Always `computer_use`.
+         */
+        type: 'computer_use';
+    }
 }
 /**
  * A tool available to the agent.
  */
-export type AgentToolParam = AgentToolParam.AgentToolConfigParamFunction | AgentToolParam.AgentToolConfigParamToolSearch | AgentToolParam.AgentToolConfigParamProgrammaticToolCalling | AgentToolParam.AgentToolConfigParamMcp | AgentToolParam.AgentToolConfigParamWebSearch;
+export type AgentToolParam = AgentToolParam.AgentToolConfigParamFunction | AgentToolParam.AgentToolConfigParamToolSearch | AgentToolParam.AgentToolConfigParamProgrammaticToolCalling | AgentToolParam.AgentToolConfigParamMcp | AgentToolParam.AgentToolConfigParamWebSearch | AgentToolParam.AgentToolConfigParamComputerUse;
 export declare namespace AgentToolParam {
     /**
      * A function defined by the application.
@@ -2178,6 +2659,19 @@ export declare namespace AgentToolParam {
             timezone?: string | null;
         }
     }
+    /**
+     * Browser use in an OpenAI-hosted session.
+     */
+    interface AgentToolConfigParamComputerUse {
+        /**
+         * The type of the object. Always `computer_use`.
+         */
+        type: 'computer_use';
+        /**
+         * Whether computer tool outputs include screenshots. Defaults to `false`.
+         */
+        include_screenshots?: boolean;
+    }
 }
 /**
  * A request to wait for one or more subagents.
@@ -2284,6 +2778,10 @@ export declare namespace Environment {
          * The type of the object. Always `openai_hosted`.
          */
         type: 'openai_hosted';
+        /**
+         * The effective desktop configuration.
+         */
+        desktop?: EnvironmentResourceOpenAIHosted.Desktop;
     }
     namespace EnvironmentResourceOpenAIHosted {
         /**
@@ -2295,7 +2793,7 @@ export declare namespace Environment {
              *
              * - `enabled` - Allows unrestricted network access.
              * - `disabled` - Disables network access.
-             * - `restricted` - Allows access only to configured domains.
+             * - `restricted` - Applies the configured domain restrictions.
              */
             access: 'enabled' | 'disabled' | 'restricted';
             /**
@@ -2320,6 +2818,15 @@ export declare namespace Environment {
              */
             system: Array<string>;
         }
+        /**
+         * The effective desktop configuration.
+         */
+        interface Desktop {
+            /**
+             * Whether the environment provisions a desktop and browser proxy.
+             */
+            enabled: boolean;
+        }
     }
     /**
      * An environment hosted by the application.
@@ -2376,6 +2883,11 @@ export declare namespace EnvironmentParam {
          * list.
          */
         capability_directories?: Array<string> | null;
+        /**
+         * Desktop provisioning. Omission or null inherits the template setting, or
+         * defaults to disabled.
+         */
+        desktop?: EnvironmentParamOpenAIHosted.Desktop | null;
         /**
          * Environment variables made available to the agent.
          */
@@ -2415,6 +2927,16 @@ export declare namespace EnvironmentParam {
         skills?: Array<AgentsAPI.HostedSkillParam> | null;
     }
     namespace EnvironmentParamOpenAIHosted {
+        /**
+         * Desktop provisioning. Omission or null inherits the template setting, or
+         * defaults to disabled.
+         */
+        interface Desktop {
+            /**
+             * Whether to provision the desktop and its browser proxy.
+             */
+            enabled: boolean;
+        }
         /**
          * Network access policy for the environment. Defaults to disabled for GA requests
          * and enabled for beta requests.
@@ -2425,13 +2947,19 @@ export declare namespace EnvironmentParam {
              *
              * - `enabled` - Allows unrestricted network access.
              * - `disabled` - Disables network access.
-             * - `restricted` - Allows access only to configured domains.
+             * - `restricted` - Applies the configured domain restrictions.
              */
             access: 'enabled' | 'disabled' | 'restricted';
             /**
              * Domains the environment may access when network access is restricted.
              */
             allowed_domains?: Array<string> | null;
+            /**
+             * Domains blocked for both executor and browser when access is restricted. A
+             * nonempty list requires `access: restricted` and cannot be combined with nonempty
+             * `allowed_domains`. Wildcard domains are not supported.
+             */
+            blocked_domains?: Array<string> | null;
         }
         /**
          * Packages to install in the environment. Defaults to empty package lists.
@@ -2921,7 +3449,7 @@ export interface OutputText {
 /**
  * A credential-free tool available to a reusable agent.
  */
-export type PersistedAgentTool = PersistedAgentTool.PersistedAgentToolResourceFunction | PersistedAgentTool.PersistedAgentToolResourceToolSearch | PersistedAgentTool.PersistedAgentToolResourceProgrammaticToolCalling | PersistedAgentTool.PersistedAgentToolResourceMcp | PersistedAgentTool.PersistedAgentToolResourceWebSearch;
+export type PersistedAgentTool = PersistedAgentTool.PersistedAgentToolResourceFunction | PersistedAgentTool.PersistedAgentToolResourceToolSearch | PersistedAgentTool.PersistedAgentToolResourceProgrammaticToolCalling | PersistedAgentTool.PersistedAgentToolResourceMcp | PersistedAgentTool.PersistedAgentToolResourceWebSearch | PersistedAgentTool.PersistedAgentToolResourceComputerUse;
 export declare namespace PersistedAgentTool {
     /**
      * A function defined by the application.
@@ -3059,11 +3587,24 @@ export declare namespace PersistedAgentTool {
             timezone: string | null;
         }
     }
+    /**
+     * Browser use in an OpenAI-hosted session.
+     */
+    interface PersistedAgentToolResourceComputerUse {
+        /**
+         * Whether computer tool outputs include screenshots.
+         */
+        include_screenshots: boolean;
+        /**
+         * The type of the object. Always `computer_use`.
+         */
+        type: 'computer_use';
+    }
 }
 /**
  * A tool that can be stored on a reusable agent without session credentials.
  */
-export type PersistedAgentToolParam = PersistedAgentToolParam.PersistedAgentToolConfigParamFunction | PersistedAgentToolParam.PersistedAgentToolConfigParamToolSearch | PersistedAgentToolParam.PersistedAgentToolConfigParamProgrammaticToolCalling | PersistedAgentToolParam.PersistedAgentToolConfigParamMcp | PersistedAgentToolParam.PersistedAgentToolConfigParamWebSearch;
+export type PersistedAgentToolParam = PersistedAgentToolParam.PersistedAgentToolConfigParamFunction | PersistedAgentToolParam.PersistedAgentToolConfigParamToolSearch | PersistedAgentToolParam.PersistedAgentToolConfigParamProgrammaticToolCalling | PersistedAgentToolParam.PersistedAgentToolConfigParamMcp | PersistedAgentToolParam.PersistedAgentToolConfigParamWebSearch | PersistedAgentToolParam.PersistedAgentToolConfigParamComputerUse;
 export declare namespace PersistedAgentToolParam {
     /**
      * A function defined by the application.
@@ -3211,6 +3752,19 @@ export declare namespace PersistedAgentToolParam {
             timezone?: string | null;
         }
     }
+    /**
+     * Browser use in an OpenAI-hosted session.
+     */
+    interface PersistedAgentToolConfigParamComputerUse {
+        /**
+         * The type of the object. Always `computer_use`.
+         */
+        type: 'computer_use';
+        /**
+         * Whether computer tool outputs include screenshots. Defaults to `false`.
+         */
+        include_screenshots?: boolean;
+    }
 }
 /**
  * A credential-free transport used to connect to an MCP server.
@@ -3728,7 +4282,7 @@ export interface AgentListParams extends Omit<CursorPageParams, 'limit'> {
     order?: 'asc' | 'desc';
 }
 export declare namespace Agents {
-    export { type Agent as Agent, type AgentCloseSubagentCallItem as AgentCloseSubagentCallItem, type AgentCommandExecutionItem as AgentCommandExecutionItem, type AgentContent as AgentContent, type AgentCreateSubagentCallItem as AgentCreateSubagentCallItem, type AgentDeleted as AgentDeleted, type AgentFunctionCallItem as AgentFunctionCallItem, type AgentFunctionCallOutput as AgentFunctionCallOutput, type AgentFunctionCallOutputParam as AgentFunctionCallOutputParam, type AgentFunctionCallStatus as AgentFunctionCallStatus, type AgentInterruptSubagentCallItem as AgentInterruptSubagentCallItem, type AgentMcpCallItem as AgentMcpCallItem, type AgentOutputCommandExecutionOutputDeltaEvent as AgentOutputCommandExecutionOutputDeltaEvent, type AgentOutputItem as AgentOutputItem, type AgentOutputItemStatus as AgentOutputItemStatus, type AgentReasoning as AgentReasoning, type AgentReasoningItem as AgentReasoningItem, type AgentReasoningParam as AgentReasoningParam, type AgentResumeSubagentCallItem as AgentResumeSubagentCallItem, type AgentSendSubagentInputCallItem as AgentSendSubagentInputCallItem, type AgentSession as AgentSession, type AgentSessionAssistantMessage as AgentSessionAssistantMessage, type AgentSessionCreatedEvent as AgentSessionCreatedEvent, type AgentSessionDeleted as AgentSessionDeleted, type AgentSessionEnvironmentConnectedEvent as AgentSessionEnvironmentConnectedEvent, type AgentSessionEnvironmentDisconnectedEvent as AgentSessionEnvironmentDisconnectedEvent, type AgentSessionEnvironmentFailedEvent as AgentSessionEnvironmentFailedEvent, type AgentSessionEnvironmentPendingEvent as AgentSessionEnvironmentPendingEvent, type AgentSessionEnvironmentReadyEvent as AgentSessionEnvironmentReadyEvent, type AgentSessionEnvironmentResetEvent as AgentSessionEnvironmentResetEvent, type AgentSessionEnvironmentState as AgentSessionEnvironmentState, type AgentSessionErrorEvent as AgentSessionErrorEvent, type AgentSessionEvent as AgentSessionEvent, type AgentSessionFailedEvent as AgentSessionFailedEvent, type AgentSessionIdleEvent as AgentSessionIdleEvent, type AgentSessionInProgressEvent as AgentSessionInProgressEvent, type AgentSessionInputMessageParam as AgentSessionInputMessageParam, type AgentSessionInputParam as AgentSessionInputParam, type AgentSessionItem as AgentSessionItem, type AgentSessionMessage as AgentSessionMessage, type AgentSessionMessageContent as AgentSessionMessageContent, type AgentSessionRequiresActionEvent as AgentSessionRequiresActionEvent, type AgentSessionSubagentActiveEvent as AgentSessionSubagentActiveEvent, type AgentSessionSubagentClosedEvent as AgentSessionSubagentClosedEvent, type AgentSessionSubagentCreatedEvent as AgentSessionSubagentCreatedEvent, type AgentSessionTurnCancelledEvent as AgentSessionTurnCancelledEvent, type AgentSessionTurnCompletedEvent as AgentSessionTurnCompletedEvent, type AgentSessionTurnContentPartAddedEvent as AgentSessionTurnContentPartAddedEvent, type AgentSessionTurnContentPartDoneEvent as AgentSessionTurnContentPartDoneEvent, type AgentSessionTurnCreatedEvent as AgentSessionTurnCreatedEvent, type AgentSessionTurnFailedEvent as AgentSessionTurnFailedEvent, type AgentSessionTurnInProgressEvent as AgentSessionTurnInProgressEvent, type AgentSessionTurnItemAddedEvent as AgentSessionTurnItemAddedEvent, type AgentSessionTurnItemDoneEvent as AgentSessionTurnItemDoneEvent, type AgentSessionTurnOutputTextDeltaEvent as AgentSessionTurnOutputTextDeltaEvent, type AgentSessionTurnOutputTextDoneEvent as AgentSessionTurnOutputTextDoneEvent, type AgentSessionTurnReasoningSummaryPartAddedEvent as AgentSessionTurnReasoningSummaryPartAddedEvent, type AgentSessionTurnReasoningSummaryPartDoneEvent as AgentSessionTurnReasoningSummaryPartDoneEvent, type AgentSessionTurnReasoningSummaryTextDeltaEvent as AgentSessionTurnReasoningSummaryTextDeltaEvent, type AgentSessionTurnReasoningSummaryTextDoneEvent as AgentSessionTurnReasoningSummaryTextDoneEvent, type AgentText as AgentText, type AgentTextParam as AgentTextParam, type AgentTool as AgentTool, type AgentToolParam as AgentToolParam, type AgentWaitForSubagentsCallItem as AgentWaitForSubagentsCallItem, type AgentWebSearchCallItem as AgentWebSearchCallItem, type Environment as Environment, type EnvironmentParam as EnvironmentParam, type HostedEnvironmentFile as HostedEnvironmentFile, type HostedEnvironmentFileID as HostedEnvironmentFileID, type HostedEnvironmentFileParam as HostedEnvironmentFileParam, type HostedPlugin as HostedPlugin, type HostedPluginParam as HostedPluginParam, type HostedSkill as HostedSkill, type HostedSkillParam as HostedSkillParam, type HostedSkillReference as HostedSkillReference, type InlineCapabilitySourceParam as InlineCapabilitySourceParam, type InputContent as InputContent, type InputContentParam as InputContentParam, type McpTransport as McpTransport, type McpTransportParam as McpTransportParam, type MultiAgentConfig as MultiAgentConfig, type MultiAgentConfigParam as MultiAgentConfigParam, type OutputText as OutputText, type PersistedAgentTool as PersistedAgentTool, type PersistedAgentToolParam as PersistedAgentToolParam, type PersistedMcpTransport as PersistedMcpTransport, type PersistedMcpTransportParam as PersistedMcpTransportParam, type SessionError as SessionError, type SessionTurnError as SessionTurnError, type SetupCommandParam as SetupCommandParam, type Subagent as Subagent, type SummaryText as SummaryText, type TextFormat as TextFormat, type TextFormatParam as TextFormatParam, type TokenUsage as TokenUsage, type WebSearchAction as WebSearchAction, type AgentsPage as AgentsPage, type AgentCreateParams as AgentCreateParams, type AgentUpdateParams as AgentUpdateParams, type AgentListParams as AgentListParams, };
+    export { type Agent as Agent, type AgentBrowserAuthenticationCancelParam as AgentBrowserAuthenticationCancelParam, type AgentBrowserAuthenticationSubmitParam as AgentBrowserAuthenticationSubmitParam, type AgentBrowserOriginAccessParam as AgentBrowserOriginAccessParam, type AgentCloseSubagentCallItem as AgentCloseSubagentCallItem, type AgentCommandExecutionItem as AgentCommandExecutionItem, type AgentContent as AgentContent, type AgentCreateSubagentCallItem as AgentCreateSubagentCallItem, type AgentDeleted as AgentDeleted, type AgentFunctionCallItem as AgentFunctionCallItem, type AgentFunctionCallOutput as AgentFunctionCallOutput, type AgentFunctionCallOutputParam as AgentFunctionCallOutputParam, type AgentFunctionCallStatus as AgentFunctionCallStatus, type AgentInterruptSubagentCallItem as AgentInterruptSubagentCallItem, type AgentMcpCallItem as AgentMcpCallItem, type AgentOutputCommandExecutionOutputDeltaEvent as AgentOutputCommandExecutionOutputDeltaEvent, type AgentOutputItem as AgentOutputItem, type AgentOutputItemStatus as AgentOutputItemStatus, type AgentReasoning as AgentReasoning, type AgentReasoningItem as AgentReasoningItem, type AgentReasoningParam as AgentReasoningParam, type AgentResumeSubagentCallItem as AgentResumeSubagentCallItem, type AgentSendSubagentInputCallItem as AgentSendSubagentInputCallItem, type AgentSession as AgentSession, type AgentSessionAssistantMessage as AgentSessionAssistantMessage, type AgentSessionCreatedEvent as AgentSessionCreatedEvent, type AgentSessionDeleted as AgentSessionDeleted, type AgentSessionEnvironmentConnectedEvent as AgentSessionEnvironmentConnectedEvent, type AgentSessionEnvironmentDisconnectedEvent as AgentSessionEnvironmentDisconnectedEvent, type AgentSessionEnvironmentFailedEvent as AgentSessionEnvironmentFailedEvent, type AgentSessionEnvironmentPendingEvent as AgentSessionEnvironmentPendingEvent, type AgentSessionEnvironmentReadyEvent as AgentSessionEnvironmentReadyEvent, type AgentSessionEnvironmentResetEvent as AgentSessionEnvironmentResetEvent, type AgentSessionEnvironmentState as AgentSessionEnvironmentState, type AgentSessionErrorEvent as AgentSessionErrorEvent, type AgentSessionEvent as AgentSessionEvent, type AgentSessionFailedEvent as AgentSessionFailedEvent, type AgentSessionIdleEvent as AgentSessionIdleEvent, type AgentSessionInProgressEvent as AgentSessionInProgressEvent, type AgentSessionInputMessageParam as AgentSessionInputMessageParam, type AgentSessionInputParam as AgentSessionInputParam, type AgentSessionItem as AgentSessionItem, type AgentSessionMessage as AgentSessionMessage, type AgentSessionMessageContent as AgentSessionMessageContent, type AgentSessionRequiresActionEvent as AgentSessionRequiresActionEvent, type AgentSessionSubagentActiveEvent as AgentSessionSubagentActiveEvent, type AgentSessionSubagentClosedEvent as AgentSessionSubagentClosedEvent, type AgentSessionSubagentCreatedEvent as AgentSessionSubagentCreatedEvent, type AgentSessionTurnCancelledEvent as AgentSessionTurnCancelledEvent, type AgentSessionTurnCompletedEvent as AgentSessionTurnCompletedEvent, type AgentSessionTurnContentPartAddedEvent as AgentSessionTurnContentPartAddedEvent, type AgentSessionTurnContentPartDoneEvent as AgentSessionTurnContentPartDoneEvent, type AgentSessionTurnCreatedEvent as AgentSessionTurnCreatedEvent, type AgentSessionTurnFailedEvent as AgentSessionTurnFailedEvent, type AgentSessionTurnInProgressEvent as AgentSessionTurnInProgressEvent, type AgentSessionTurnItemAddedEvent as AgentSessionTurnItemAddedEvent, type AgentSessionTurnItemDoneEvent as AgentSessionTurnItemDoneEvent, type AgentSessionTurnOutputTextDeltaEvent as AgentSessionTurnOutputTextDeltaEvent, type AgentSessionTurnOutputTextDoneEvent as AgentSessionTurnOutputTextDoneEvent, type AgentSessionTurnReasoningSummaryPartAddedEvent as AgentSessionTurnReasoningSummaryPartAddedEvent, type AgentSessionTurnReasoningSummaryPartDoneEvent as AgentSessionTurnReasoningSummaryPartDoneEvent, type AgentSessionTurnReasoningSummaryTextDeltaEvent as AgentSessionTurnReasoningSummaryTextDeltaEvent, type AgentSessionTurnReasoningSummaryTextDoneEvent as AgentSessionTurnReasoningSummaryTextDoneEvent, type AgentText as AgentText, type AgentTextParam as AgentTextParam, type AgentTool as AgentTool, type AgentToolParam as AgentToolParam, type AgentWaitForSubagentsCallItem as AgentWaitForSubagentsCallItem, type AgentWebSearchCallItem as AgentWebSearchCallItem, type Environment as Environment, type EnvironmentParam as EnvironmentParam, type HostedEnvironmentFile as HostedEnvironmentFile, type HostedEnvironmentFileID as HostedEnvironmentFileID, type HostedEnvironmentFileParam as HostedEnvironmentFileParam, type HostedPlugin as HostedPlugin, type HostedPluginParam as HostedPluginParam, type HostedSkill as HostedSkill, type HostedSkillParam as HostedSkillParam, type HostedSkillReference as HostedSkillReference, type InlineCapabilitySourceParam as InlineCapabilitySourceParam, type InputContent as InputContent, type InputContentParam as InputContentParam, type McpTransport as McpTransport, type McpTransportParam as McpTransportParam, type MultiAgentConfig as MultiAgentConfig, type MultiAgentConfigParam as MultiAgentConfigParam, type OutputText as OutputText, type PersistedAgentTool as PersistedAgentTool, type PersistedAgentToolParam as PersistedAgentToolParam, type PersistedMcpTransport as PersistedMcpTransport, type PersistedMcpTransportParam as PersistedMcpTransportParam, type SessionError as SessionError, type SessionTurnError as SessionTurnError, type SetupCommandParam as SetupCommandParam, type Subagent as Subagent, type SummaryText as SummaryText, type TextFormat as TextFormat, type TextFormatParam as TextFormatParam, type TokenUsage as TokenUsage, type WebSearchAction as WebSearchAction, type AgentsPage as AgentsPage, type AgentCreateParams as AgentCreateParams, type AgentUpdateParams as AgentUpdateParams, type AgentListParams as AgentListParams, };
     export { Environments as Environments, type EnvironmentInfo as EnvironmentInfo };
     export { Vaults as Vaults, type Vault as Vault, type VaultDeleted as VaultDeleted, type VaultStatus as VaultStatus, type VaultStatusFilter as VaultStatusFilter, type VaultsPage as VaultsPage, type VaultCreateParams as VaultCreateParams, type VaultListParams as VaultListParams, };
     export { Sessions as Sessions, type SessionCreateParams as SessionCreateParams, type SessionCreateParamsNonStreaming as SessionCreateParamsNonStreaming, type SessionCreateParamsStreaming as SessionCreateParamsStreaming, type SessionUpdateParams as SessionUpdateParams, type SessionListParams as SessionListParams, };