openai 0.50.0 → 0.52.0

data/lib/openai/models/fine_tuning/job_pause_params.rb

@@ -8,7 +8,13 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute fine_tuning_job_id
+        #
+        #   @return [String]
+        required :fine_tuning_job_id, String
+
+        # @!method initialize(fine_tuning_job_id:, request_options: {})
+        #   @param fine_tuning_job_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/fine_tuning/job_resume_params.rb

@@ -8,7 +8,13 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute fine_tuning_job_id
+        #
+        #   @return [String]
+        required :fine_tuning_job_id, String
+
+        # @!method initialize(fine_tuning_job_id:, request_options: {})
+        #   @param fine_tuning_job_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/fine_tuning/job_retrieve_params.rb

@@ -8,7 +8,13 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute fine_tuning_job_id
+        #
+        #   @return [String]
+        required :fine_tuning_job_id, String
+
+        # @!method initialize(fine_tuning_job_id:, request_options: {})
+        #   @param fine_tuning_job_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/fine_tuning/jobs/checkpoint_list_params.rb

@@ -9,6 +9,11 @@ module OpenAI
           extend OpenAI::Internal::Type::RequestParameters::Converter
           include OpenAI::Internal::Type::RequestParameters
 
+          # @!attribute fine_tuning_job_id
+          #
+          #   @return [String]
+          required :fine_tuning_job_id, String
+
           # @!attribute after
           #   Identifier for the last checkpoint ID from the previous pagination request.
           #
@@ -21,7 +26,9 @@ module OpenAI
           #   @return [Integer, nil]
           optional :limit, Integer
 
-          # @!method initialize(after: nil, limit: nil, request_options: {})
+          # @!method initialize(fine_tuning_job_id:, after: nil, limit: nil, request_options: {})
+          #   @param fine_tuning_job_id [String]
+          #
           #   @param after [String] Identifier for the last checkpoint ID from the previous pagination request.
           #
           #   @param limit [Integer] Number of checkpoints to retrieve.

data/lib/openai/models/model_delete_params.rb

@@ -7,7 +7,13 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute model
+      #
+      #   @return [String]
+      required :model, String
+
+      # @!method initialize(model:, request_options: {})
+      #   @param model [String]
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/openai/models/model_retrieve_params.rb

@@ -7,7 +7,13 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute model
+      #
+      #   @return [String]
+      required :model, String
+
+      # @!method initialize(model:, request_options: {})
+      #   @param model [String]
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/openai/models/realtime/call_accept_params.rb

@@ -8,7 +8,13 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute call_id
+        #
+        #   @return [String]
+        required :call_id, String
+
+        # @!method initialize(call_id:, request_options: {})
+        #   @param call_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/realtime/call_hangup_params.rb

@@ -8,7 +8,13 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute call_id
+        #
+        #   @return [String]
+        required :call_id, String
+
+        # @!method initialize(call_id:, request_options: {})
+        #   @param call_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/realtime/call_refer_params.rb

@@ -8,6 +8,11 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # @!attribute call_id
+        #
+        #   @return [String]
+        required :call_id, String
+
         # @!attribute target_uri
         #   URI that should appear in the SIP Refer-To header. Supports values like
         #   `tel:+14155550123` or `sip:agent@example.com`.
@@ -15,10 +20,12 @@ module OpenAI
         #   @return [String]
         required :target_uri, String
 
-        # @!method initialize(target_uri:, request_options: {})
+        # @!method initialize(call_id:, target_uri:, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Realtime::CallReferParams} for more details.
         #
+        #   @param call_id [String]
+        #
         #   @param target_uri [String] URI that should appear in the SIP Refer-To header. Supports values like
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/realtime/call_reject_params.rb

@@ -8,6 +8,11 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # @!attribute call_id
+        #
+        #   @return [String]
+        required :call_id, String
+
         # @!attribute status_code
         #   SIP response code to send back to the caller. Defaults to `603` (Decline) when
         #   omitted.
@@ -15,10 +20,12 @@ module OpenAI
         #   @return [Integer, nil]
         optional :status_code, Integer
 
-        # @!method initialize(status_code: nil, request_options: {})
+        # @!method initialize(call_id:, status_code: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Realtime::CallRejectParams} for more details.
         #
+        #   @param call_id [String]
+        #
         #   @param status_code [Integer] SIP response code to send back to the caller. Defaults to `603` (Decline)
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/realtime/realtime_response_create_mcp_tool.rb

@@ -52,6 +52,12 @@ module OpenAI
         #   @return [Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::ConnectorID, nil]
         optional :connector_id, enum: -> { OpenAI::Realtime::RealtimeResponseCreateMcpTool::ConnectorID }
 
+        # @!attribute defer_loading
+        #   Whether this MCP tool is deferred and discovered via tool search.
+        #
+        #   @return [Boolean, nil]
+        optional :defer_loading, OpenAI::Internal::Type::Boolean
+
         # @!attribute headers
         #   Optional HTTP headers to send to the MCP server. Use for authentication or other
         #   purposes.
@@ -80,7 +86,7 @@ module OpenAI
         #   @return [String, nil]
         optional :server_url, String
 
-        # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
+        # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool} for more details.
         #
@@ -96,6 +102,8 @@ module OpenAI
         #
         #   @param connector_id [Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::ConnectorID] Identifier for service connectors, like those available in ChatGPT. One of
         #
+        #   @param defer_loading [Boolean] Whether this MCP tool is deferred and discovered via tool search.
+        #
         #   @param headers [Hash{Symbol=>String}, nil] Optional HTTP headers to send to the MCP server. Use for authentication
         #
         #   @param require_approval [OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalFilter, Symbol, OpenAI::Models::Realtime::RealtimeResponseCreateMcpTool::RequireApproval::McpToolApprovalSetting, nil] Specify which of the MCP server's tools require approval.

data/lib/openai/models/realtime/realtime_session_create_response.rb

@@ -754,6 +754,12 @@ module OpenAI
             optional :connector_id,
                      enum: -> { OpenAI::Realtime::RealtimeSessionCreateResponse::Tool::McpTool::ConnectorID }
 
+            # @!attribute defer_loading
+            #   Whether this MCP tool is deferred and discovered via tool search.
+            #
+            #   @return [Boolean, nil]
+            optional :defer_loading, OpenAI::Internal::Type::Boolean
+
             # @!attribute headers
             #   Optional HTTP headers to send to the MCP server. Use for authentication or other
             #   purposes.
@@ -784,7 +790,7 @@ module OpenAI
             #   @return [String, nil]
             optional :server_url, String
 
-            # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
+            # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
             #   Some parameter documentations has been truncated, see
             #   {OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Tool::McpTool} for
             #   more details.
@@ -801,6 +807,8 @@ module OpenAI
             #
             #   @param connector_id [Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Tool::McpTool::ConnectorID] Identifier for service connectors, like those available in ChatGPT. One of
             #
+            #   @param defer_loading [Boolean] Whether this MCP tool is deferred and discovered via tool search.
+            #
             #   @param headers [Hash{Symbol=>String}, nil] Optional HTTP headers to send to the MCP server. Use for authentication
             #
             #   @param require_approval [OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Tool::McpTool::RequireApproval::McpToolApprovalFilter, Symbol, OpenAI::Models::Realtime::RealtimeSessionCreateResponse::Tool::McpTool::RequireApproval::McpToolApprovalSetting, nil] Specify which of the MCP server's tools require approval.

data/lib/openai/models/realtime/realtime_tools_config_union.rb

@@ -66,6 +66,12 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp::ConnectorID, nil]
           optional :connector_id, enum: -> { OpenAI::Realtime::RealtimeToolsConfigUnion::Mcp::ConnectorID }
 
+          # @!attribute defer_loading
+          #   Whether this MCP tool is deferred and discovered via tool search.
+          #
+          #   @return [Boolean, nil]
+          optional :defer_loading, OpenAI::Internal::Type::Boolean
+
           # @!attribute headers
           #   Optional HTTP headers to send to the MCP server. Use for authentication or other
           #   purposes.
@@ -94,7 +100,7 @@ module OpenAI
           #   @return [String, nil]
           optional :server_url, String
 
-          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
+          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp} for more details.
           #
@@ -110,6 +116,8 @@ module OpenAI
           #
           #   @param connector_id [Symbol, OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp::ConnectorID] Identifier for service connectors, like those available in ChatGPT. One of
           #
+          #   @param defer_loading [Boolean] Whether this MCP tool is deferred and discovered via tool search.
+          #
           #   @param headers [Hash{Symbol=>String}, nil] Optional HTTP headers to send to the MCP server. Use for authentication
           #
           #   @param require_approval [OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp::RequireApproval::McpToolApprovalFilter, Symbol, OpenAI::Models::Realtime::RealtimeToolsConfigUnion::Mcp::RequireApproval::McpToolApprovalSetting, nil] Specify which of the MCP server's tools require approval.

data/lib/openai/models/responses/compacted_response.rb

@@ -27,7 +27,7 @@ module OpenAI
         #   The compacted list of output items. This is a list of all user messages,
         #   followed by a single compaction item.
         #
-        #   @return [Array<OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseCustomToolCall>]
+        #   @return [Array<OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseCustomToolCall>]
         required :output, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseOutputItem] }
 
         # @!attribute usage
@@ -45,7 +45,7 @@ module OpenAI
         #
         #   @param created_at [Integer] Unix timestamp (in seconds) when the compacted conversation was created.
         #
-        #   @param output [Array<OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseCustomToolCall>] The compacted list of output items. This is a list of all user messages, followe
+        #   @param output [Array<OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseCompactionItem, OpenAI::Models::Responses::ResponseOutputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseOutputItem::LocalShellCall, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, OpenAI::Models::Responses::ResponseOutputItem::McpCall, OpenAI::Models::Responses::ResponseOutputItem::McpListTools, OpenAI::Models::Responses::ResponseOutputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseCustomToolCall>] The compacted list of output items. This is a list of all user messages, followe
         #
         #   @param usage [OpenAI::Models::Responses::ResponseUsage] Token accounting for the compaction pass, including cached, reasoning, and total
         #

data/lib/openai/models/responses/computer_action.rb

@@ -0,0 +1,356 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      # A click action.
+      module ComputerAction
+        extend OpenAI::Internal::Type::Union
+
+        discriminator :type
+
+        # A click action.
+        variant :click, -> { OpenAI::Responses::ComputerAction::Click }
+
+        # A double click action.
+        variant :double_click, -> { OpenAI::Responses::ComputerAction::DoubleClick }
+
+        # A drag action.
+        variant :drag, -> { OpenAI::Responses::ComputerAction::Drag }
+
+        # A collection of keypresses the model would like to perform.
+        variant :keypress, -> { OpenAI::Responses::ComputerAction::Keypress }
+
+        # A mouse move action.
+        variant :move, -> { OpenAI::Responses::ComputerAction::Move }
+
+        # A screenshot action.
+        variant :screenshot, -> { OpenAI::Responses::ComputerAction::Screenshot }
+
+        # A scroll action.
+        variant :scroll, -> { OpenAI::Responses::ComputerAction::Scroll }
+
+        # An action to type in text.
+        variant :type, -> { OpenAI::Responses::ComputerAction::Type }
+
+        # A wait action.
+        variant :wait, -> { OpenAI::Responses::ComputerAction::Wait }
+
+        class Click < OpenAI::Internal::Type::BaseModel
+          # @!attribute button
+          #   Indicates which mouse button was pressed during the click. One of `left`,
+          #   `right`, `wheel`, `back`, or `forward`.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ComputerAction::Click::Button]
+          required :button, enum: -> { OpenAI::Responses::ComputerAction::Click::Button }
+
+          # @!attribute type
+          #   Specifies the event type. For a click action, this property is always `click`.
+          #
+          #   @return [Symbol, :click]
+          required :type, const: :click
+
+          # @!attribute x
+          #   The x-coordinate where the click occurred.
+          #
+          #   @return [Integer]
+          required :x, Integer
+
+          # @!attribute y_
+          #   The y-coordinate where the click occurred.
+          #
+          #   @return [Integer]
+          required :y_, Integer, api_name: :y
+
+          # @!method initialize(button:, x:, y_:, type: :click)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ComputerAction::Click} for more details.
+          #
+          #   A click action.
+          #
+          #   @param button [Symbol, OpenAI::Models::Responses::ComputerAction::Click::Button] Indicates which mouse button was pressed during the click. One of `left`, `right
+          #
+          #   @param x [Integer] The x-coordinate where the click occurred.
+          #
+          #   @param y_ [Integer] The y-coordinate where the click occurred.
+          #
+          #   @param type [Symbol, :click] Specifies the event type. For a click action, this property is always `click`.
+
+          # Indicates which mouse button was pressed during the click. One of `left`,
+          # `right`, `wheel`, `back`, or `forward`.
+          #
+          # @see OpenAI::Models::Responses::ComputerAction::Click#button
+          module Button
+            extend OpenAI::Internal::Type::Enum
+
+            LEFT = :left
+            RIGHT = :right
+            WHEEL = :wheel
+            BACK = :back
+            FORWARD = :forward
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class DoubleClick < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   Specifies the event type. For a double click action, this property is always set
+          #   to `double_click`.
+          #
+          #   @return [Symbol, :double_click]
+          required :type, const: :double_click
+
+          # @!attribute x
+          #   The x-coordinate where the double click occurred.
+          #
+          #   @return [Integer]
+          required :x, Integer
+
+          # @!attribute y_
+          #   The y-coordinate where the double click occurred.
+          #
+          #   @return [Integer]
+          required :y_, Integer, api_name: :y
+
+          # @!method initialize(x:, y_:, type: :double_click)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ComputerAction::DoubleClick} for more details.
+          #
+          #   A double click action.
+          #
+          #   @param x [Integer] The x-coordinate where the double click occurred.
+          #
+          #   @param y_ [Integer] The y-coordinate where the double click occurred.
+          #
+          #   @param type [Symbol, :double_click] Specifies the event type. For a double click action, this property is always set
+        end
+
+        class Drag < OpenAI::Internal::Type::BaseModel
+          # @!attribute path
+          #   An array of coordinates representing the path of the drag action. Coordinates
+          #   will appear as an array of objects, eg
+          #
+          #   ```
+          #   [
+          #     { x: 100, y: 200 },
+          #     { x: 200, y: 300 }
+          #   ]
+          #   ```
+          #
+          #   @return [Array<OpenAI::Models::Responses::ComputerAction::Drag::Path>]
+          required :path, -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ComputerAction::Drag::Path] }
+
+          # @!attribute type
+          #   Specifies the event type. For a drag action, this property is always set to
+          #   `drag`.
+          #
+          #   @return [Symbol, :drag]
+          required :type, const: :drag
+
+          # @!method initialize(path:, type: :drag)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ComputerAction::Drag} for more details.
+          #
+          #   A drag action.
+          #
+          #   @param path [Array<OpenAI::Models::Responses::ComputerAction::Drag::Path>] An array of coordinates representing the path of the drag action. Coordinates wi
+          #
+          #   @param type [Symbol, :drag] Specifies the event type. For a drag action, this property is always set to `dra
+
+          class Path < OpenAI::Internal::Type::BaseModel
+            # @!attribute x
+            #   The x-coordinate.
+            #
+            #   @return [Integer]
+            required :x, Integer
+
+            # @!attribute y_
+            #   The y-coordinate.
+            #
+            #   @return [Integer]
+            required :y_, Integer, api_name: :y
+
+            # @!method initialize(x:, y_:)
+            #   An x/y coordinate pair, e.g. `{ x: 100, y: 200 }`.
+            #
+            #   @param x [Integer] The x-coordinate.
+            #
+            #   @param y_ [Integer] The y-coordinate.
+          end
+        end
+
+        class Keypress < OpenAI::Internal::Type::BaseModel
+          # @!attribute keys
+          #   The combination of keys the model is requesting to be pressed. This is an array
+          #   of strings, each representing a key.
+          #
+          #   @return [Array<String>]
+          required :keys, OpenAI::Internal::Type::ArrayOf[String]
+
+          # @!attribute type
+          #   Specifies the event type. For a keypress action, this property is always set to
+          #   `keypress`.
+          #
+          #   @return [Symbol, :keypress]
+          required :type, const: :keypress
+
+          # @!method initialize(keys:, type: :keypress)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ComputerAction::Keypress} for more details.
+          #
+          #   A collection of keypresses the model would like to perform.
+          #
+          #   @param keys [Array<String>] The combination of keys the model is requesting to be pressed. This is an array
+          #
+          #   @param type [Symbol, :keypress] Specifies the event type. For a keypress action, this property is always set to
+        end
+
+        class Move < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   Specifies the event type. For a move action, this property is always set to
+          #   `move`.
+          #
+          #   @return [Symbol, :move]
+          required :type, const: :move
+
+          # @!attribute x
+          #   The x-coordinate to move to.
+          #
+          #   @return [Integer]
+          required :x, Integer
+
+          # @!attribute y_
+          #   The y-coordinate to move to.
+          #
+          #   @return [Integer]
+          required :y_, Integer, api_name: :y
+
+          # @!method initialize(x:, y_:, type: :move)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ComputerAction::Move} for more details.
+          #
+          #   A mouse move action.
+          #
+          #   @param x [Integer] The x-coordinate to move to.
+          #
+          #   @param y_ [Integer] The y-coordinate to move to.
+          #
+          #   @param type [Symbol, :move] Specifies the event type. For a move action, this property is always set to `mov
+        end
+
+        class Screenshot < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   Specifies the event type. For a screenshot action, this property is always set
+          #   to `screenshot`.
+          #
+          #   @return [Symbol, :screenshot]
+          required :type, const: :screenshot
+
+          # @!method initialize(type: :screenshot)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ComputerAction::Screenshot} for more details.
+          #
+          #   A screenshot action.
+          #
+          #   @param type [Symbol, :screenshot] Specifies the event type. For a screenshot action, this property is always set t
+        end
+
+        class Scroll < OpenAI::Internal::Type::BaseModel
+          # @!attribute scroll_x
+          #   The horizontal scroll distance.
+          #
+          #   @return [Integer]
+          required :scroll_x, Integer
+
+          # @!attribute scroll_y
+          #   The vertical scroll distance.
+          #
+          #   @return [Integer]
+          required :scroll_y, Integer
+
+          # @!attribute type
+          #   Specifies the event type. For a scroll action, this property is always set to
+          #   `scroll`.
+          #
+          #   @return [Symbol, :scroll]
+          required :type, const: :scroll
+
+          # @!attribute x
+          #   The x-coordinate where the scroll occurred.
+          #
+          #   @return [Integer]
+          required :x, Integer
+
+          # @!attribute y_
+          #   The y-coordinate where the scroll occurred.
+          #
+          #   @return [Integer]
+          required :y_, Integer, api_name: :y
+
+          # @!method initialize(scroll_x:, scroll_y:, x:, y_:, type: :scroll)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ComputerAction::Scroll} for more details.
+          #
+          #   A scroll action.
+          #
+          #   @param scroll_x [Integer] The horizontal scroll distance.
+          #
+          #   @param scroll_y [Integer] The vertical scroll distance.
+          #
+          #   @param x [Integer] The x-coordinate where the scroll occurred.
+          #
+          #   @param y_ [Integer] The y-coordinate where the scroll occurred.
+          #
+          #   @param type [Symbol, :scroll] Specifies the event type. For a scroll action, this property is always set to `s
+        end
+
+        class Type < OpenAI::Internal::Type::BaseModel
+          # @!attribute text
+          #   The text to type.
+          #
+          #   @return [String]
+          required :text, String
+
+          # @!attribute type
+          #   Specifies the event type. For a type action, this property is always set to
+          #   `type`.
+          #
+          #   @return [Symbol, :type]
+          required :type, const: :type
+
+          # @!method initialize(text:, type: :type)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ComputerAction::Type} for more details.
+          #
+          #   An action to type in text.
+          #
+          #   @param text [String] The text to type.
+          #
+          #   @param type [Symbol, :type] Specifies the event type. For a type action, this property is always set to `typ
+        end
+
+        class Wait < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   Specifies the event type. For a wait action, this property is always set to
+          #   `wait`.
+          #
+          #   @return [Symbol, :wait]
+          required :type, const: :wait
+
+          # @!method initialize(type: :wait)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::ComputerAction::Wait} for more details.
+          #
+          #   A wait action.
+          #
+          #   @param type [Symbol, :wait] Specifies the event type. For a wait action, this property is always set to `wai
+        end
+
+        # @!method self.variants
+        #   @return [Array(OpenAI::Models::Responses::ComputerAction::Click, OpenAI::Models::Responses::ComputerAction::DoubleClick, OpenAI::Models::Responses::ComputerAction::Drag, OpenAI::Models::Responses::ComputerAction::Keypress, OpenAI::Models::Responses::ComputerAction::Move, OpenAI::Models::Responses::ComputerAction::Screenshot, OpenAI::Models::Responses::ComputerAction::Scroll, OpenAI::Models::Responses::ComputerAction::Type, OpenAI::Models::Responses::ComputerAction::Wait)]
+      end
+    end
+  end
+end

data/lib/openai/models/responses/computer_action_list.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Responses
+      # @type [OpenAI::Internal::Type::Converter]
+      ComputerActionList = OpenAI::Internal::Type::ArrayOf[union: -> { OpenAI::Responses::ComputerAction }]
+    end
+  end
+end