openai 0.96.0 → 0.97.0

data/lib/openai/models/beta/agents/environments/template_create_params.rb

@@ -17,6 +17,19 @@ module OpenAI
             #   @return [Array<String>, nil]
             optional :capability_directories, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
+            # @!attribute desktop
+            #   Desktop provisioning. Omission or null inherits the template setting, or
+            #   defaults to disabled.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Desktop, nil]
+            optional(
+              :desktop,
+              -> {
+                OpenAI::Beta::Agents::Environments::TemplateCreateParams::Desktop
+              },
+              nil?: true
+            )
+
             # @!attribute env
             #   Environment variables made available to the agent.
             #
@@ -97,11 +110,15 @@ module OpenAI
               nil?: true
             )
 
-            # @!method initialize(capability_directories: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
+            # @!method initialize(capability_directories: nil, desktop: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
             #   @param capability_directories [Array<String>, nil]
             #     Directories that contain capabilities exposed to the agent. Defaults to an empty
             #     list.
             #
+            #   @param desktop [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Desktop, nil]
+            #     Desktop provisioning. Omission or null inherits the template setting, or
+            #     defaults to disabled.
+            #
             #   @param env [Hash{Symbol=>String}, nil]
             #     Environment variables made available to the agent.
             #
@@ -130,6 +147,21 @@ module OpenAI
             #
             #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
+            class Desktop < OpenAI::Internal::Type::BaseModel
+              # @!attribute enabled
+              #   Whether to provision the desktop and its browser proxy.
+              #
+              #   @return [Boolean]
+              required :enabled, OpenAI::Internal::Type::Boolean
+
+              # @!method initialize(enabled:)
+              #   Desktop provisioning. Omission or null inherits the template setting, or
+              #   defaults to disabled.
+              #
+              #   @param enabled [Boolean]
+              #     Whether to provision the desktop and its browser proxy.
+            end
+
             class Network < OpenAI::Internal::Type::BaseModel
               # @!attribute access
               #   The environment's network access mode.
@@ -143,7 +175,15 @@ module OpenAI
               #   @return [Array<String>, nil]
               optional :allowed_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
-              # @!method initialize(access:, allowed_domains: nil)
+              # @!attribute blocked_domains
+              #   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.
+              #
+              #   @return [Array<String>, nil]
+              optional :blocked_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+              # @!method initialize(access:, allowed_domains: nil, blocked_domains: nil)
               #   Network access policy for the environment. Defaults to disabled for GA requests
               #   and enabled for beta requests.
               #
@@ -152,6 +192,11 @@ module OpenAI
               #
               #   @param allowed_domains [Array<String>, nil]
               #     Domains the environment may access when network access is restricted.
+              #
+              #   @param blocked_domains [Array<String>, nil]
+              #     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.
 
               # The environment's network access mode.
               #
@@ -165,7 +210,7 @@ module OpenAI
                 # Disables network access.
                 DISABLED = :disabled
 
-                # Allows access only to configured domains.
+                # Applies the configured domain restrictions.
                 RESTRICTED = :restricted
 
                 # @!method self.values

data/lib/openai/models/beta/agents/environments/template_update_params.rb

@@ -21,6 +21,18 @@ module OpenAI
             #   @return [Array<String>, nil]
             optional :capability_directories, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
+            # @!attribute desktop
+            #   Replacement desktop configuration, or null to disable the desktop.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Desktop, nil]
+            optional(
+              :desktop,
+              -> {
+                OpenAI::Beta::Agents::Environments::TemplateUpdateParams::Desktop
+              },
+              nil?: true
+            )
+
             # @!attribute env
             #   Replacement confidential environment values.
             #
@@ -101,12 +113,15 @@ module OpenAI
               nil?: true
             )
 
-            # @!method initialize(environment_template_id:, capability_directories: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
+            # @!method initialize(environment_template_id:, capability_directories: nil, desktop: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
             #   @param environment_template_id [String]
             #
             #   @param capability_directories [Array<String>, nil]
             #     Directories that expose capabilities to the agent.
             #
+            #   @param desktop [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Desktop, nil]
+            #     Replacement desktop configuration, or null to disable the desktop.
+            #
             #   @param env [Hash{Symbol=>String}, nil]
             #     Replacement confidential environment values.
             #
@@ -135,6 +150,20 @@ module OpenAI
             #
             #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
+            class Desktop < OpenAI::Internal::Type::BaseModel
+              # @!attribute enabled
+              #   Whether to provision the desktop and its browser proxy.
+              #
+              #   @return [Boolean]
+              required :enabled, OpenAI::Internal::Type::Boolean
+
+              # @!method initialize(enabled:)
+              #   Replacement desktop configuration, or null to disable the desktop.
+              #
+              #   @param enabled [Boolean]
+              #     Whether to provision the desktop and its browser proxy.
+            end
+
             class Network < OpenAI::Internal::Type::BaseModel
               # @!attribute access
               #   The environment's network access mode.
@@ -148,7 +177,15 @@ module OpenAI
               #   @return [Array<String>, nil]
               optional :allowed_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
-              # @!method initialize(access:, allowed_domains: nil)
+              # @!attribute blocked_domains
+              #   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.
+              #
+              #   @return [Array<String>, nil]
+              optional :blocked_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+              # @!method initialize(access:, allowed_domains: nil, blocked_domains: nil)
               #   Network access available after setup completes. Omit to preserve the current
               #   policy, or pass `null` to reset to disabled for GA requests or enabled for beta
               #   requests.
@@ -158,6 +195,11 @@ module OpenAI
               #
               #   @param allowed_domains [Array<String>, nil]
               #     Domains the environment may access when network access is restricted.
+              #
+              #   @param blocked_domains [Array<String>, nil]
+              #     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.
 
               # The environment's network access mode.
               #
@@ -171,7 +213,7 @@ module OpenAI
                 # Disables network access.
                 DISABLED = :disabled
 
-                # Allows access only to configured domains.
+                # Applies the configured domain restrictions.
                 RESTRICTED = :restricted
 
                 # @!method self.values

data/lib/openai/models/beta/agents/session_create_params.rb

@@ -126,7 +126,7 @@ module OpenAI
             # @!attribute tools
             #   Tools available to the agent. Omit to inherit, or pass null to clear them.
             #
-            #   @return [Array<OpenAI::Models::Beta::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch>, nil]
+            #   @return [Array<OpenAI::Models::Beta::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch, OpenAI::Models::Beta::AgentToolParam::ComputerUse>, nil]
             optional(
               :tools,
               -> {
@@ -159,7 +159,7 @@ module OpenAI
             #   @param text [OpenAI::Models::Beta::AgentTextParam, nil]
             #     Configuration for text generated by the agent.
             #
-            #   @param tools [Array<OpenAI::Models::Beta::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch>, nil]
+            #   @param tools [Array<OpenAI::Models::Beta::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch, OpenAI::Models::Beta::AgentToolParam::ComputerUse>, nil]
             #     Tools available to the agent. Omit to inherit, or pass null to clear them.
 
             # The service tier used for model requests.

data/lib/openai/models/beta/agents/sessions/event_create_params.rb

@@ -18,7 +18,7 @@ module OpenAI
             # @!attribute events
             #   The input events to submit to the session.
             #
-            #   @return [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
+            #   @return [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
             required :events, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::AgentSessionInputParam] }
 
             # @!attribute idempotency_key
@@ -29,7 +29,7 @@ module OpenAI
             # @!method initialize(session_id:, events:, idempotency_key: nil, request_options: {})
             #   @param session_id [String]
             #
-            #   @param events [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
+            #   @param events [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
             #     The input events to submit to the session.
             #
             #   @param idempotency_key [String]

data/lib/openai/models/beta/environment.rb

@@ -82,7 +82,13 @@ module OpenAI
           #   @return [Symbol, :openai_hosted]
           required :type, const: :openai_hosted
 
-          # @!method initialize(id:, capability_directories:, files:, network:, packages:, plugins:, skills:, type: :openai_hosted)
+          # @!attribute desktop
+          #   The effective desktop configuration.
+          #
+          #   @return [OpenAI::Models::Beta::Environment::OpenAIHosted::Desktop, nil]
+          optional :desktop, -> { OpenAI::Beta::Environment::OpenAIHosted::Desktop }
+
+          # @!method initialize(id:, capability_directories:, files:, network:, packages:, plugins:, skills:, desktop: nil, type: :openai_hosted)
           #   An environment hosted by OpenAI.
           #
           #   @param id [String]
@@ -106,6 +112,9 @@ module OpenAI
           #   @param skills [Array<OpenAI::Models::Beta::HostedSkillReference, OpenAI::Models::Beta::HostedSkill::Inline>]
           #     Skills installed in the environment, excluding their archive contents.
           #
+          #   @param desktop [OpenAI::Models::Beta::Environment::OpenAIHosted::Desktop]
+          #     The effective desktop configuration.
+          #
           #   @param type [Symbol, :openai_hosted]
           #     The type of the object. Always `openai_hosted`.
 
@@ -144,7 +153,7 @@ module OpenAI
               # Disables network access.
               DISABLED = :disabled
 
-              # Allows access only to configured domains.
+              # Applies the configured domain restrictions.
               RESTRICTED = :restricted
 
               # @!method self.values
@@ -184,6 +193,21 @@ module OpenAI
             #   @param system_ [Array<String>]
             #     System packages installed in the environment.
           end
+
+          # @see OpenAI::Models::Beta::Environment::OpenAIHosted#desktop
+          class Desktop < OpenAI::Internal::Type::BaseModel
+            # @!attribute enabled
+            #   Whether the environment provisions a desktop and browser proxy.
+            #
+            #   @return [Boolean]
+            required :enabled, OpenAI::Internal::Type::Boolean
+
+            # @!method initialize(enabled:)
+            #   The effective desktop configuration.
+            #
+            #   @param enabled [Boolean]
+            #     Whether the environment provisions a desktop and browser proxy.
+          end
         end
 
         class SelfHosted < OpenAI::Internal::Type::BaseModel

data/lib/openai/models/beta/environment_param.rb

@@ -46,6 +46,13 @@ module OpenAI
           #   @return [Array<String>, nil]
           optional :capability_directories, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
+          # @!attribute desktop
+          #   Desktop provisioning. Omission or null inherits the template setting, or
+          #   defaults to disabled.
+          #
+          #   @return [OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Desktop, nil]
+          optional :desktop, -> { OpenAI::Beta::EnvironmentParam::OpenAIHosted::Desktop }, nil?: true
+
           # @!attribute env
           #   Environment variables made available to the agent.
           #
@@ -115,7 +122,7 @@ module OpenAI
             nil?: true
           )
 
-          # @!method initialize(capability_directories: nil, env: nil, environment_template_id: nil, files: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, type: :openai_hosted)
+          # @!method initialize(capability_directories: nil, desktop: nil, env: nil, environment_template_id: nil, files: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, type: :openai_hosted)
           #   An existing OpenAI-hosted environment or new inline/template-based hosted
           #   configuration.
           #
@@ -123,6 +130,10 @@ module OpenAI
           #     Directories that contain capabilities exposed to the agent. Defaults to an empty
           #     list.
           #
+          #   @param desktop [OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted::Desktop, nil]
+          #     Desktop provisioning. Omission or null inherits the template setting, or
+          #     defaults to disabled.
+          #
           #   @param env [Hash{Symbol=>String}, nil]
           #     Environment variables made available to the agent.
           #
@@ -153,6 +164,22 @@ module OpenAI
           #   @param type [Symbol, :openai_hosted]
           #     The type of the object. Always `openai_hosted`.
 
+          # @see OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted#desktop
+          class Desktop < OpenAI::Internal::Type::BaseModel
+            # @!attribute enabled
+            #   Whether to provision the desktop and its browser proxy.
+            #
+            #   @return [Boolean]
+            required :enabled, OpenAI::Internal::Type::Boolean
+
+            # @!method initialize(enabled:)
+            #   Desktop provisioning. Omission or null inherits the template setting, or
+            #   defaults to disabled.
+            #
+            #   @param enabled [Boolean]
+            #     Whether to provision the desktop and its browser proxy.
+          end
+
           # @see OpenAI::Models::Beta::EnvironmentParam::OpenAIHosted#network
           class Network < OpenAI::Internal::Type::BaseModel
             # @!attribute access
@@ -167,7 +194,15 @@ module OpenAI
             #   @return [Array<String>, nil]
             optional :allowed_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
-            # @!method initialize(access:, allowed_domains: nil)
+            # @!attribute blocked_domains
+            #   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.
+            #
+            #   @return [Array<String>, nil]
+            optional :blocked_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!method initialize(access:, allowed_domains: nil, blocked_domains: nil)
             #   Network access policy for the environment. Defaults to disabled for GA requests
             #   and enabled for beta requests.
             #
@@ -176,6 +211,11 @@ module OpenAI
             #
             #   @param allowed_domains [Array<String>, nil]
             #     Domains the environment may access when network access is restricted.
+            #
+            #   @param blocked_domains [Array<String>, nil]
+            #     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.
 
             # The environment's network access mode.
             #
@@ -189,7 +229,7 @@ module OpenAI
               # Disables network access.
               DISABLED = :disabled
 
-              # Allows access only to configured domains.
+              # Applies the configured domain restrictions.
               RESTRICTED = :restricted
 
               # @!method self.values

data/lib/openai/models/beta/persisted_agent_tool.rb

@@ -24,6 +24,9 @@ module OpenAI
         # Web search.
         variant :web_search, -> { OpenAI::Beta::PersistedAgentTool::WebSearch }
 
+        # Browser use in an OpenAI-hosted session.
+        variant :computer_use, -> { OpenAI::Beta::PersistedAgentTool::ComputerUse }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute defer_loading
           #   Whether the function is deferred and discovered through tool search.
@@ -321,8 +324,31 @@ module OpenAI
           end
         end
 
+        class ComputerUse < OpenAI::Internal::Type::BaseModel
+          # @!attribute include_screenshots
+          #   Whether computer tool outputs include screenshots.
+          #
+          #   @return [Boolean]
+          required :include_screenshots, OpenAI::Internal::Type::Boolean
+
+          # @!attribute type
+          #   The type of the object. Always `computer_use`.
+          #
+          #   @return [Symbol, :computer_use]
+          required :type, const: :computer_use
+
+          # @!method initialize(include_screenshots:, type: :computer_use)
+          #   Browser use in an OpenAI-hosted session.
+          #
+          #   @param include_screenshots [Boolean]
+          #     Whether computer tool outputs include screenshots.
+          #
+          #   @param type [Symbol, :computer_use]
+          #     The type of the object. Always `computer_use`.
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Beta::PersistedAgentTool::Function, OpenAI::Models::Beta::PersistedAgentTool::ToolSearch, OpenAI::Models::Beta::PersistedAgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentTool::Mcp, OpenAI::Models::Beta::PersistedAgentTool::WebSearch)]
+        #   @return [Array(OpenAI::Models::Beta::PersistedAgentTool::Function, OpenAI::Models::Beta::PersistedAgentTool::ToolSearch, OpenAI::Models::Beta::PersistedAgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentTool::Mcp, OpenAI::Models::Beta::PersistedAgentTool::WebSearch, OpenAI::Models::Beta::PersistedAgentTool::ComputerUse)]
       end
     end
   end

data/lib/openai/models/beta/persisted_agent_tool_param.rb

@@ -24,6 +24,9 @@ module OpenAI
         # Web search.
         variant :web_search, -> { OpenAI::Beta::PersistedAgentToolParam::WebSearch }
 
+        # Browser use in an OpenAI-hosted session.
+        variant :computer_use, -> { OpenAI::Beta::PersistedAgentToolParam::ComputerUse }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute description
           #   A description of what the function does.
@@ -347,8 +350,31 @@ module OpenAI
           end
         end
 
+        class ComputerUse < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the object. Always `computer_use`.
+          #
+          #   @return [Symbol, :computer_use]
+          required :type, const: :computer_use
+
+          # @!attribute include_screenshots
+          #   Whether computer tool outputs include screenshots. Defaults to `false`.
+          #
+          #   @return [Boolean, nil]
+          optional :include_screenshots, OpenAI::Internal::Type::Boolean
+
+          # @!method initialize(include_screenshots: nil, type: :computer_use)
+          #   Browser use in an OpenAI-hosted session.
+          #
+          #   @param include_screenshots [Boolean]
+          #     Whether computer tool outputs include screenshots. Defaults to `false`.
+          #
+          #   @param type [Symbol, :computer_use]
+          #     The type of the object. Always `computer_use`.
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch)]
+        #   @return [Array(OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse)]
       end
     end
   end

data/lib/openai/resources/beta/agents/environments/templates.rb

@@ -10,12 +10,16 @@ module OpenAI
             # commands or environment values. See
             # [reusing a hosted setup](https://developers.openai.com/api/docs/guides/agents-api/tools#reuse-a-hosted-plugin-setup).
             #
-            # @overload create(capability_directories: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
+            # @overload create(capability_directories: nil, desktop: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
             #
             # @param capability_directories [Array<String>, nil]
             #   Directories that contain capabilities exposed to the agent. Defaults to an empty
             #   list.
             #
+            # @param desktop [OpenAI::Models::Beta::Agents::Environments::TemplateCreateParams::Desktop, nil]
+            #   Desktop provisioning. Omission or null inherits the template setting, or
+            #   defaults to disabled.
+            #
             # @param env [Hash{Symbol=>String}, nil]
             #   Environment variables made available to the agent.
             #
@@ -87,7 +91,7 @@ module OpenAI
             # values. See
             # [reusing a hosted setup](https://developers.openai.com/api/docs/guides/agents-api/tools#reuse-a-hosted-plugin-setup).
             #
-            # @overload update(environment_template_id, capability_directories: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
+            # @overload update(environment_template_id, capability_directories: nil, desktop: nil, env: nil, files: nil, name: nil, network: nil, packages: nil, plugins: nil, setup_commands: nil, skills: nil, request_options: {})
             #
             # @param environment_template_id [String]
             #   The ID of the reusable environment template.
@@ -95,6 +99,9 @@ module OpenAI
             # @param capability_directories [Array<String>, nil]
             #   Directories that expose capabilities to the agent.
             #
+            # @param desktop [OpenAI::Models::Beta::Agents::Environments::TemplateUpdateParams::Desktop, nil]
+            #   Replacement desktop configuration, or null to disable the desktop.
+            #
             # @param env [Hash{Symbol=>String}, nil]
             #   Replacement confidential environment values.
             #

data/lib/openai/resources/beta/agents/sessions/events.rb

@@ -18,7 +18,7 @@ module OpenAI
             # @param session_id [String]
             #   Path param: The ID of the session.
             #
-            # @param events [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
+            # @param events [Array<OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputMessage, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputCancel, OpenAI::Models::Beta::AgentSessionInputParam::AgentSessionInputToolResult>]
             #   Body param: The input events to submit to the session.
             #
             # @param idempotency_key [String]

data/lib/openai/resources/beta/agents/sessions/items.rb

@@ -26,7 +26,7 @@ module OpenAI
             #
             # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
             #
-            # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
+            # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentSessionItem::ComputerUseCall, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
             #
             # @see OpenAI::Models::Beta::Agents::Sessions::ItemListParams
             def list(session_id, params = {})

data/lib/openai/resources/beta/agents/sessions/subagents/items.rb

@@ -30,7 +30,7 @@ module OpenAI
               #
               # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
               #
-              # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
+              # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentSessionItem::ComputerUseCall, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
               #
               # @see OpenAI::Models::Beta::Agents::Sessions::Subagents::ItemListParams
               def list(subagent_id, params)

data/lib/openai/resources/beta/agents/sessions/subagents/turns/items.rb

@@ -34,7 +34,7 @@ module OpenAI
                 #
                 # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
                 #
-                # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
+                # @return [OpenAI::Internal::CursorPage<OpenAI::Models::Beta::AgentSessionMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentSessionItem::FunctionCallOutput, OpenAI::Models::Beta::AgentSessionItem::AgentMessage, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentSessionItem::ComputerUseCall, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult, OpenAI::Models::Beta::AgentWebSearchCallItem, OpenAI::Models::Beta::AgentCommandExecutionItem, OpenAI::Models::Beta::AgentCreateSubagentCallItem, OpenAI::Models::Beta::AgentSendSubagentInputCallItem, OpenAI::Models::Beta::AgentResumeSubagentCallItem, OpenAI::Models::Beta::AgentWaitForSubagentsCallItem, OpenAI::Models::Beta::AgentInterruptSubagentCallItem, OpenAI::Models::Beta::AgentCloseSubagentCallItem>]
                 #
                 # @see OpenAI::Models::Beta::Agents::Sessions::Subagents::Turns::ItemListParams
                 def list(turn_id, params)

data/lib/openai/resources/beta/agents.rb

@@ -46,7 +46,7 @@ module OpenAI
         #   Configuration for generated text. Defaults to the `text` format and medium
         #   verbosity.
         #
-        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch>, nil]
+        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, nil]
         #   Tools available to the agent. Defaults to an empty list.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
@@ -125,7 +125,7 @@ module OpenAI
         # @param text [OpenAI::Models::Beta::AgentTextParam, nil]
         #   Configuration for text generated by the agent.
         #
-        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch>, nil]
+        # @param tools [Array<OpenAI::Models::Beta::PersistedAgentToolParam::Function, OpenAI::Models::Beta::PersistedAgentToolParam::ToolSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::PersistedAgentToolParam::Mcp, OpenAI::Models::Beta::PersistedAgentToolParam::WebSearch, OpenAI::Models::Beta::PersistedAgentToolParam::ComputerUse>, nil]
         #   Tools available to the agent.
         #
         # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.96.0"
+  VERSION = "0.97.0"
 end

data/lib/openai.rb

@@ -465,6 +465,9 @@ require_relative "openai/models/batch_request_counts"
 require_relative "openai/models/batch_retrieve_params"
 require_relative "openai/models/batch_usage"
 require_relative "openai/models/beta/agent"
+require_relative "openai/models/beta/agent_browser_authentication_cancel_param"
+require_relative "openai/models/beta/agent_browser_authentication_submit_param"
+require_relative "openai/models/beta/agent_browser_origin_access_param"
 require_relative "openai/models/beta/agent_close_subagent_call_item"
 require_relative "openai/models/beta/agent_command_execution_item"
 require_relative "openai/models/beta/agent_content"

data/rbi/openai/models/beta/agent.rbi

@@ -106,7 +106,8 @@ module OpenAI
                 OpenAI::Beta::PersistedAgentTool::ToolSearch::OrHash,
                 OpenAI::Beta::PersistedAgentTool::ProgrammaticToolCalling::OrHash,
                 OpenAI::Beta::PersistedAgentTool::Mcp::OrHash,
-                OpenAI::Beta::PersistedAgentTool::WebSearch::OrHash
+                OpenAI::Beta::PersistedAgentTool::WebSearch::OrHash,
+                OpenAI::Beta::PersistedAgentTool::ComputerUse::OrHash
               )
             ],
 

data/rbi/openai/models/beta/agent_browser_authentication_cancel_param.rbi

@@ -0,0 +1,53 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Beta
+
+      class AgentBrowserAuthenticationCancelParam < OpenAI::Internal::Type::BaseModel
+
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::Beta::AgentBrowserAuthenticationCancelParam,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        sig { returns(Symbol) }
+        attr_accessor :action
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig do
+          params(
+
+            action: Symbol,
+
+            type: Symbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          action: :cancel,
+
+          type: :browser_authentication
+        )
+        end
+
+        sig do
+          override.returns(
+            {action: Symbol, type: Symbol}
+          )
+        end
+        def to_hash
+        end
+
+      end
+
+    end
+
+  end
+end