openai 0.96.0 → 0.97.0

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

@@ -27,6 +27,18 @@ module OpenAI
         # A call to a tool on an MCP server.
         variant :mcp_call, -> { OpenAI::Beta::AgentMcpCallItem }
 
+        # One execution of the platform-provided computer-use capability.
+        variant :computer_use_call, -> { OpenAI::Beta::AgentSessionItem::ComputerUseCall }
+
+        # A credential-free history record of the emitted login request.
+        variant :computer_use_approval_request, -> { OpenAI::Beta::AgentSessionItem::ComputerUseApprovalRequest }
+
+        # A credential-free record of an admitted response, not proof of completion.
+        variant(
+          :computer_use_approval_request_result,
+          -> { OpenAI::Beta::AgentSessionItem::ComputerUseApprovalRequestResult }
+        )
+
         # A web search call produced by the agent.
         variant :web_search_call, -> { OpenAI::Beta::AgentWebSearchCallItem }
 
@@ -178,8 +190,386 @@ module OpenAI
           #     The item type. Always `agent_message`.
         end
 
+        class ComputerUseCall < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the activity item.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute output
+          #   The last screenshot emitted by the model. Null when screenshot inclusion is
+          #   disabled or the call emitted no screenshot.
+          #
+          #   @return [OpenAI::Models::Beta::AgentSessionItem::ComputerUseCall::Output, nil]
+          required :output, -> { OpenAI::Beta::AgentSessionItem::ComputerUseCall::Output }, nil?: true
+
+          # @!attribute status
+          #   The execution status of the activity.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::AgentFunctionCallStatus]
+          required :status, enum: -> { OpenAI::Beta::AgentFunctionCallStatus }
+
+          # @!attribute title
+          #   A model-generated description of the activity, when available.
+          #
+          #   @return [String, nil]
+          required :title, String, nil?: true
+
+          # @!attribute turn_id
+          #   The ID of the turn that contains this item.
+          #
+          #   @return [String]
+          required :turn_id, String
+
+          # @!attribute type
+          #   The item type. Always `computer_use_call`.
+          #
+          #   @return [Symbol, :computer_use_call]
+          required :type, const: :computer_use_call
+
+          # @!method initialize(id:, output:, status:, title:, turn_id:, type: :computer_use_call)
+          #   One execution of the platform-provided computer-use capability.
+          #
+          #   @param id [String]
+          #     The ID of the activity item.
+          #
+          #   @param output [OpenAI::Models::Beta::AgentSessionItem::ComputerUseCall::Output, nil]
+          #     The last screenshot emitted by the model. Null when screenshot inclusion is
+          #     disabled or the call emitted no screenshot.
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::AgentFunctionCallStatus]
+          #     The execution status of the activity.
+          #
+          #   @param title [String, nil]
+          #     A model-generated description of the activity, when available.
+          #
+          #   @param turn_id [String]
+          #     The ID of the turn that contains this item.
+          #
+          #   @param type [Symbol, :computer_use_call]
+          #     The item type. Always `computer_use_call`.
+
+          # @see OpenAI::Models::Beta::AgentSessionItem::ComputerUseCall#output
+          class Output < OpenAI::Internal::Type::BaseModel
+            # @!attribute image_url
+            #   The complete JPEG image as a base64 data URL.
+            #
+            #   @return [String]
+            required :image_url, String
+
+            # @!attribute type
+            #   The content type. Always `computer_screenshot`.
+            #
+            #   @return [Symbol, :computer_screenshot]
+            required :type, const: :computer_screenshot
+
+            # @!method initialize(image_url:, type: :computer_screenshot)
+            #   The last screenshot emitted by the model. Null when screenshot inclusion is
+            #   disabled or the call emitted no screenshot.
+            #
+            #   @param image_url [String]
+            #     The complete JPEG image as a base64 data URL.
+            #
+            #   @param type [Symbol, :computer_screenshot]
+            #     The content type. Always `computer_screenshot`.
+          end
+        end
+
+        class ComputerUseApprovalRequest < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The stable history item ID.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute request
+          #   A registered form awaiting the application's response.
+          #
+          #   @return [OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest::Request]
+          required :request, -> { OpenAI::Beta::AgentSessionItem::ComputerUseApprovalRequest::Request }
+
+          # @!attribute request_id
+          #
+          #   @return [String]
+          required :request_id, String
+
+          # @!attribute turn_id
+          #
+          #   @return [String]
+          required :turn_id, String
+
+          # @!attribute type
+          #   The item type. Always computer_use_approval_request.
+          #
+          #   @return [Symbol, :computer_use_approval_request]
+          required :type, const: :computer_use_approval_request
+
+          # @!method initialize(id:, request:, request_id:, turn_id:, type: :computer_use_approval_request)
+          #   A credential-free history record of the emitted login request.
+          #
+          #   @param id [String]
+          #     The stable history item ID.
+          #
+          #   @param request [OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest::Request]
+          #     A registered form awaiting the application's response.
+          #
+          #   @param request_id [String]
+          #
+          #   @param turn_id [String]
+          #
+          #   @param type [Symbol, :computer_use_approval_request]
+          #     The item type. Always computer_use_approval_request.
+
+          # @see OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest#request
+          class Request < OpenAI::Internal::Type::BaseModel
+            # @!attribute credential_origin
+            #   The registered form or frame origin where values will be entered.
+            #
+            #   @return [String, nil]
+            required :credential_origin, String, nil?: true
+
+            # @!attribute fields
+            #   Controls to render. All submitted values are sensitive.
+            #
+            #   @return [Array<OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest::Request::Field>]
+            required(
+              :fields,
+              -> {
+                OpenAI::Internal::Type::ArrayOf[
+                  OpenAI::Beta::AgentSessionItem::ComputerUseApprovalRequest::Request::Field
+                ]
+              }
+            )
+
+            # @!attribute options
+            #   Sign-in methods. Empty for a plain form.
+            #
+            #   @return [Array<OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest::Request::Option>]
+            required(
+              :options,
+              -> {
+                OpenAI::Internal::Type::ArrayOf[
+                  OpenAI::Beta::AgentSessionItem::ComputerUseApprovalRequest::Request::Option
+                ]
+              }
+            )
+
+            # @!attribute reason
+            #   Why the agent needs the user to sign in.
+            #
+            #   @return [String, nil]
+            required :reason, String, nil?: true
+
+            # @!attribute type
+            #   The type of the object. Always `browser_authentication`.
+            #
+            #   @return [Symbol, :browser_authentication]
+            required :type, const: :browser_authentication
+
+            # @!method initialize(credential_origin:, fields:, options:, reason:, type: :browser_authentication)
+            #   A registered form awaiting the application's response.
+            #
+            #   @param credential_origin [String, nil]
+            #     The registered form or frame origin where values will be entered.
+            #
+            #   @param fields [Array<OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest::Request::Field>]
+            #     Controls to render. All submitted values are sensitive.
+            #
+            #   @param options [Array<OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequest::Request::Option>]
+            #     Sign-in methods. Empty for a plain form.
+            #
+            #   @param reason [String, nil]
+            #     Why the agent needs the user to sign in.
+            #
+            #   @param type [Symbol, :browser_authentication]
+            #     The type of the object. Always `browser_authentication`.
+            class Field < OpenAI::Internal::Type::BaseModel
+              # @!attribute id
+              #   The field ID to submit as field_id in a fields entry.
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute label
+              #   The label to display beside the control.
+              #
+              #   @return [String]
+              required :label, String
+
+              # @!attribute required
+              #   Whether this control requires a nonempty value.
+              #
+              #   @return [Boolean]
+              required :required, OpenAI::Internal::Type::Boolean
+
+              # @!attribute type
+              #   The rendering type, such as email, password, or text.
+              #
+              #   @return [String]
+              required :type, String
+
+              # @!method initialize(id:, label:, required:, type:)
+              #   A control in a registered browser-login form.
+              #
+              #   @param id [String]
+              #     The field ID to submit as field_id in a fields entry.
+              #
+              #   @param label [String]
+              #     The label to display beside the control.
+              #
+              #   @param required [Boolean]
+              #     Whether this control requires a nonempty value.
+              #
+              #   @param type [String]
+              #     The rendering type, such as email, password, or text.
+            end
+
+            class Option < OpenAI::Internal::Type::BaseModel
+              # @!attribute id
+              #   The option ID to submit as selected_option.
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute field_ids
+              #   IDs from the registered fields that this method accepts.
+              #
+              #   @return [Array<String>]
+              required :field_ids, OpenAI::Internal::Type::ArrayOf[String]
+
+              # @!attribute label
+              #   The method label to display.
+              #
+              #   @return [String]
+              required :label, String
+
+              # @!method initialize(id:, field_ids:, label:)
+              #   A sign-in method and the fields that belong to it.
+              #
+              #   @param id [String]
+              #     The option ID to submit as selected_option.
+              #
+              #   @param field_ids [Array<String>]
+              #     IDs from the registered fields that this method accepts.
+              #
+              #   @param label [String]
+              #     The method label to display.
+            end
+          end
+        end
+
+        class ComputerUseApprovalRequestResult < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The stable history item ID.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute request_id
+          #   The registered request answered by this item.
+          #
+          #   @return [String]
+          required :request_id, String
+
+          # @!attribute response
+          #   The admitted response, without submitted credential values.
+          #
+          #   @return [OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult::Response::Submit, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult::Response::Cancel]
+          required(
+            :response,
+            union: -> { OpenAI::Beta::AgentSessionItem::ComputerUseApprovalRequestResult::Response }
+          )
+
+          # @!attribute turn_id
+          #   The ID of the turn that contains this item.
+          #
+          #   @return [String]
+          required :turn_id, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :computer_use_approval_request_result]
+          required :type, const: :computer_use_approval_request_result
+
+          # @!method initialize(id:, request_id:, response:, turn_id:, type: :computer_use_approval_request_result)
+          #   A credential-free record of an admitted response, not proof of completion.
+          #
+          #   @param id [String]
+          #     The stable history item ID.
+          #
+          #   @param request_id [String]
+          #     The registered request answered by this item.
+          #
+          #   @param response [OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult::Response::Submit, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult::Response::Cancel]
+          #     The admitted response, without submitted credential values.
+          #
+          #   @param turn_id [String]
+          #     The ID of the turn that contains this item.
+          #
+          #   @param type [Symbol, :computer_use_approval_request_result]
+
+          # The admitted response, without submitted credential values.
+          #
+          # @see OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult#response
+          module Response
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :action
+
+            variant :submit, -> { OpenAI::Beta::AgentSessionItem::ComputerUseApprovalRequestResult::Response::Submit }
+
+            variant :cancel, -> { OpenAI::Beta::AgentSessionItem::ComputerUseApprovalRequestResult::Response::Cancel }
+
+            class Submit < OpenAI::Internal::Type::BaseModel
+              # @!attribute action
+              #
+              #   @return [Symbol, :submit]
+              required :action, const: :submit
+
+              # @!attribute selected_option
+              #   The chosen sign-in method, or null when no options were offered.
+              #
+              #   @return [String, nil]
+              required :selected_option, String, nil?: true
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :browser_authentication]
+              required :type, const: :browser_authentication
+
+              # @!method initialize(selected_option:, action: :submit, type: :browser_authentication)
+              #   @param selected_option [String, nil]
+              #     The chosen sign-in method, or null when no options were offered.
+              #
+              #   @param action [Symbol, :submit]
+              #
+              #   @param type [Symbol, :browser_authentication]
+            end
+
+            class Cancel < OpenAI::Internal::Type::BaseModel
+              # @!attribute action
+              #
+              #   @return [Symbol, :cancel]
+              required :action, const: :cancel
+
+              # @!attribute type
+              #
+              #   @return [Symbol, :browser_authentication]
+              required :type, const: :browser_authentication
+
+              # @!method initialize(action: :cancel, type: :browser_authentication)
+              #   @param action [Symbol, :cancel]
+              #   @param type [Symbol, :browser_authentication]
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult::Response::Submit, OpenAI::Models::Beta::AgentSessionItem::ComputerUseApprovalRequestResult::Response::Cancel)]
+          end
+        end
+
         # @!method self.variants
-        #   @return [Array(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 [Array(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)]
       end
     end
   end

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

@@ -13,7 +13,7 @@ module OpenAI
         # @!attribute item
         #   The item that was added.
         #
-        #   @return [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::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]
         required :item, union: -> { OpenAI::Beta::AgentSessionItem }
 
         # @!attribute output_index
@@ -46,7 +46,7 @@ module OpenAI
         #   @param event_id [String]
         #     The unique ID of the event.
         #
-        #   @param item [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]
+        #   @param item [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]
         #     The item that was added.
         #
         #   @param output_index [Integer, nil]

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

@@ -13,7 +13,7 @@ module OpenAI
         # @!attribute item
         #   The completed output item.
         #
-        #   @return [OpenAI::Models::Beta::AgentSessionAssistantMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, 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::Models::Beta::AgentSessionAssistantMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentOutputItem::ComputerUseCall, OpenAI::Models::Beta::AgentOutputItem::ComputerUseApprovalRequest, 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]
         required :item, union: -> { OpenAI::Beta::AgentOutputItem }
 
         # @!attribute output_index
@@ -46,7 +46,7 @@ module OpenAI
         #   @param event_id [String]
         #     The unique ID of the event.
         #
-        #   @param item [OpenAI::Models::Beta::AgentSessionAssistantMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, 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]
+        #   @param item [OpenAI::Models::Beta::AgentSessionAssistantMessage, OpenAI::Models::Beta::AgentReasoningItem, OpenAI::Models::Beta::AgentFunctionCallItem, OpenAI::Models::Beta::AgentMcpCallItem, OpenAI::Models::Beta::AgentOutputItem::ComputerUseCall, OpenAI::Models::Beta::AgentOutputItem::ComputerUseApprovalRequest, 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]
         #     The completed output item.
         #
         #   @param output_index [Integer]

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

@@ -21,6 +21,9 @@ module OpenAI
         # Web search.
         variant :web_search, -> { OpenAI::Beta::AgentTool::WebSearch }
 
+        # Browser use in an OpenAI-hosted session.
+        variant :computer_use, -> { OpenAI::Beta::AgentTool::ComputerUse }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute defer_loading
           #   Whether the function is deferred and discovered through tool search.
@@ -306,8 +309,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::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch)]
+        #   @return [Array(OpenAI::Models::Beta::AgentTool::Function, OpenAI::Models::Beta::AgentTool::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentTool::Mcp, OpenAI::Models::Beta::AgentTool::WebSearch, OpenAI::Models::Beta::AgentTool::ComputerUse)]
       end
     end
   end

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

@@ -24,6 +24,9 @@ module OpenAI
         # Web search.
         variant :web_search, -> { OpenAI::Beta::AgentToolParam::WebSearch }
 
+        # Browser use in an OpenAI-hosted session.
+        variant :computer_use, -> { OpenAI::Beta::AgentToolParam::ComputerUse }
+
         class Function < OpenAI::Internal::Type::BaseModel
           # @!attribute description
           #   A description of what the function does.
@@ -357,8 +360,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::AgentToolParam::Function, OpenAI::Models::Beta::AgentToolParam::ToolSearch, OpenAI::Models::Beta::AgentToolParam::ProgrammaticToolCalling, OpenAI::Models::Beta::AgentToolParam::Mcp, OpenAI::Models::Beta::AgentToolParam::WebSearch)]
+        #   @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)]
       end
     end
   end

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

@@ -68,7 +68,7 @@ module OpenAI
         # @!attribute tools
         #   Tools available to the agent.
         #
-        #   @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>, nil]
+        #   @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>, nil]
         optional(
           :tools,
           -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::PersistedAgentToolParam] },
@@ -106,7 +106,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}]

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

@@ -83,7 +83,13 @@ module OpenAI
             #   @return [Integer]
             required :updated_at, Integer
 
-            # @!method initialize(id:, capability_directories:, created_at:, files:, name:, network:, packages:, plugins:, skills:, updated_at:, object: :"agent.environment.template")
+            # @!attribute desktop
+            #   Desktop configuration for each OpenAI-hosted environment.
+            #
+            #   @return [OpenAI::Models::Beta::Agents::Environments::EnvironmentTemplate::Desktop, nil]
+            optional :desktop, -> { OpenAI::Beta::Agents::Environments::EnvironmentTemplate::Desktop }
+
+            # @!method initialize(id:, capability_directories:, created_at:, files:, name:, network:, packages:, plugins:, skills:, updated_at:, desktop: nil, object: :"agent.environment.template")
             #   Reusable configuration that provisions a fresh OpenAI-hosted environment for
             #   each session.
             #
@@ -117,6 +123,9 @@ module OpenAI
             #   @param updated_at [Integer]
             #     The Unix timestamp, in seconds, when the template was last updated.
             #
+            #   @param desktop [OpenAI::Models::Beta::Agents::Environments::EnvironmentTemplate::Desktop]
+            #     Desktop configuration for each OpenAI-hosted environment.
+            #
             #   @param object [Symbol, :"agent.environment.template"]
             #     The object type. Always `agent.environment.template`.
 
@@ -235,7 +244,7 @@ module OpenAI
                 # Disables network access.
                 DISABLED = :disabled
 
-                # Allows access only to configured domains.
+                # Applies the configured domain restrictions.
                 RESTRICTED = :restricted
 
                 # @!method self.values
@@ -358,6 +367,21 @@ module OpenAI
               # @!method self.variants
               #   @return [Array(OpenAI::Models::Beta::Agents::Environments::EnvironmentTemplate::Skill::SkillReference, OpenAI::Models::Beta::Agents::Environments::EnvironmentTemplate::Skill::Inline)]
             end
+
+            # @see OpenAI::Models::Beta::Agents::Environments::EnvironmentTemplate#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:)
+              #   Desktop configuration for each OpenAI-hosted environment.
+              #
+              #   @param enabled [Boolean]
+              #     Whether the environment provisions a desktop and browser proxy.
+            end
           end
         end