openai 0.86.0 → 0.88.0

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

@@ -12,8 +12,8 @@ module OpenAI
         #   Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
         #   range of models with different capabilities, performance characteristics, and
         #   price points. Refer to the
-        #   [model guide](https://platform.openai.com/docs/models) to browse and compare
-        #   available models.
+        #   [model guide](https://developers.openai.com/api/docs/models) to browse and
+        #   compare available models.
         #
         #   @return [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil]
         required :model, union: -> { OpenAI::Responses::ResponseCompactParams::Model }, nil?: true
@@ -36,7 +36,7 @@ module OpenAI
         # @!attribute previous_response_id
         #   The unique ID of the previous response to the model. Use this to create
         #   multi-turn conversations. Learn more about
-        #   [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+        #   [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
         #   Cannot be used in conjunction with `conversation`.
         #
         #   @return [String, nil]
@@ -56,7 +56,7 @@ module OpenAI
         #   up to the latest 80 breakpoints in the conversation, without a content-block
         #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
         #   `ttl` defaults to `30m`, which is currently the only supported value. See the
-        #   [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+        #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
         #   for current details.
         #
         #   @return [OpenAI::Models::Responses::ResponseCompactParams::PromptCacheOptions, nil]
@@ -84,48 +84,86 @@ module OpenAI
         #   Project settings. Unless otherwise configured, the Project will use 'default'. -
         #   If set to 'default', then the request will be processed with the standard
         #   pricing and performance for the selected model. - If set to
-        #   '[flex](https://platform.openai.com/docs/guides/flex-processing)', then the
-        #   request will be processed with the Flex Processing service tier. - To opt-in to
-        #   [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
-        #   `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-        #   Completions. For models with a dedicated Fast tier, either value resolves to
-        #   `service_tier=fast`; for other models, either value resolves to
-        #   `service_tier=priority`. - When not set, the default behavior is 'auto'. When
-        #   the `service_tier` parameter is set, the response body will include the
-        #   `service_tier` value based on the processing mode actually used to serve the
-        #   request. This response value may be different from the value set in the
-        #   parameter.
+        #   '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+        #   the request will be processed with the Flex Processing service tier. - To opt-in
+        #   to [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+        #   request level, include the `service_tier=fast` or `service_tier=priority`
+        #   parameter for Responses or Chat Completions. For models with a dedicated Fast
+        #   tier, either value resolves to `service_tier=fast`; for other models, either
+        #   value resolves to `service_tier=priority`. - When not set, the default behavior
+        #   is 'auto'. When the `service_tier` parameter is set, the response body will
+        #   include the `service_tier` value based on the processing mode actually used to
+        #   serve the request. This response value may be different from the value set in
+        #   the parameter.
         #
         #   @return [Symbol, OpenAI::Models::Responses::ResponseCompactParams::ServiceTier, nil]
         optional :service_tier, enum: -> { OpenAI::Responses::ResponseCompactParams::ServiceTier }, nil?: true
 
         # @!method initialize(model:, input: nil, instructions: nil, previous_response_id: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, service_tier: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::ResponseCompactParams} for more details.
+        #   @param model [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil]
+        #     Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
+        #     range of models with different capabilities, performance characteristics, and
+        #     price points. Refer to the
+        #     [model guide](https://developers.openai.com/api/docs/models) to browse and
+        #     compare available models.
         #
-        #   @param model [Symbol, String, OpenAI::Models::Responses::ResponseCompactParams::Model, nil] Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
+        #   @param input [String, Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference, OpenAI::Models::Responses::ResponseInputItem::Program, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput>, nil]
+        #     Text, image, or file inputs to the model, used to generate a response
         #
-        #   @param input [String, Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference, OpenAI::Models::Responses::ResponseInputItem::Program, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput>, nil] Text, image, or file inputs to the model, used to generate a response
+        #   @param instructions [String, nil]
+        #     A system (or developer) message inserted into the model's context. When used
+        #     along with `previous_response_id`, the instructions from a previous response
+        #     will not be carried over to the next response. This makes it simple to swap out
+        #     system (or developer) messages in new responses.
         #
-        #   @param instructions [String, nil] A system (or developer) message inserted into the model's context.
+        #   @param previous_response_id [String, nil]
+        #     The unique ID of the previous response to the model. Use this to create
+        #     multi-turn conversations. Learn more about
+        #     [conversation state](https://developers.openai.com/api/docs/guides/conversation-state).
+        #     Cannot be used in conjunction with `conversation`.
         #
-        #   @param previous_response_id [String, nil] The unique ID of the previous response to the model. Use this to create multi-tu
+        #   @param prompt_cache_key [String, nil]
+        #     A key to use when reading from or writing to the prompt cache.
         #
-        #   @param prompt_cache_key [String, nil] A key to use when reading from or writing to the prompt cache.
+        #   @param prompt_cache_options [OpenAI::Models::Responses::ResponseCompactParams::PromptCacheOptions, nil]
+        #     Options for prompt caching. Supported for `gpt-5.6` and later models. By
+        #     default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+        #     explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+        #     request can write up to four breakpoints. For cache matching, OpenAI considers
+        #     up to the latest 80 breakpoints in the conversation, without a content-block
+        #     lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+        #     `ttl` defaults to `30m`, which is currently the only supported value. See the
+        #     [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
+        #     for current details.
         #
-        #   @param prompt_cache_options [OpenAI::Models::Responses::ResponseCompactParams::PromptCacheOptions, nil] Options for prompt caching. Supported for `gpt-5.6` and later models. By default
+        #   @param prompt_cache_retention [Symbol, OpenAI::Models::Responses::ResponseCompactParams::PromptCacheRetention, nil]
+        #     How long to retain a prompt cache entry created by this request.
         #
-        #   @param prompt_cache_retention [Symbol, OpenAI::Models::Responses::ResponseCompactParams::PromptCacheRetention, nil] How long to retain a prompt cache entry created by this request.
-        #
-        #   @param service_tier [Symbol, OpenAI::Models::Responses::ResponseCompactParams::ServiceTier, nil] Specifies the processing type used for serving the request. - If set to 'auto'
+        #   @param service_tier [Symbol, OpenAI::Models::Responses::ResponseCompactParams::ServiceTier, nil]
+        #     Specifies the processing type used for serving the request. - If set to 'auto',
+        #     then the request will be processed with the service tier configured in the
+        #     Project settings. Unless otherwise configured, the Project will use 'default'. -
+        #     If set to 'default', then the request will be processed with the standard
+        #     pricing and performance for the selected model. - If set to
+        #     '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+        #     the request will be processed with the Flex Processing service tier. - To opt-in
+        #     to [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+        #     request level, include the `service_tier=fast` or `service_tier=priority`
+        #     parameter for Responses or Chat Completions. For models with a dedicated Fast
+        #     tier, either value resolves to `service_tier=fast`; for other models, either
+        #     value resolves to `service_tier=priority`. - When not set, the default behavior
+        #     is 'auto'. When the `service_tier` parameter is set, the response body will
+        #     include the `service_tier` value based on the processing mode actually used to
+        #     serve the request. This response value may be different from the value set in
+        #     the parameter.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
         # Model ID used to generate the response, like `gpt-6-astra`. OpenAI offers a wide
         # range of models with different capabilities, performance characteristics, and
         # price points. Refer to the
-        # [model guide](https://platform.openai.com/docs/models) to browse and compare
-        # available models.
+        # [model guide](https://developers.openai.com/api/docs/models) to browse and
+        # compare available models.
         module Model
           extend OpenAI::Internal::Type::Union
 
@@ -509,10 +547,6 @@ module OpenAI
           optional :ttl, enum: -> { OpenAI::Responses::ResponseCompactParams::PromptCacheOptions::Ttl }
 
           # @!method initialize(mode: nil, ttl: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseCompactParams::PromptCacheOptions} for more
-          #   details.
-          #
           #   Options for prompt caching. Supported for `gpt-5.6` and later models. By
           #   default, OpenAI automatically chooses one implicit cache breakpoint. You can add
           #   explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
@@ -520,12 +554,21 @@ module OpenAI
           #   up to the latest 80 breakpoints in the conversation, without a content-block
           #   lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
           #   `ttl` defaults to `30m`, which is currently the only supported value. See the
-          #   [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+          #   [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
           #   for current details.
           #
-          #   @param mode [Symbol, OpenAI::Models::Responses::ResponseCompactParams::PromptCacheOptions::Mode] Controls whether OpenAI automatically creates an implicit cache breakpoint. Defa
+          #   @param mode [Symbol, OpenAI::Models::Responses::ResponseCompactParams::PromptCacheOptions::Mode]
+          #     Controls whether OpenAI automatically creates an implicit cache breakpoint.
+          #     Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
+          #     and writes up to the latest three explicit breakpoints in the request. With
+          #     `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+          #     latest four explicit breakpoints. If there are no explicit breakpoints, the
+          #     request does not use prompt caching.
           #
-          #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseCompactParams::PromptCacheOptions::Ttl] The minimum lifetime applied to every implicit and explicit cache breakpoint wri
+          #   @param ttl [Symbol, OpenAI::Models::Responses::ResponseCompactParams::PromptCacheOptions::Ttl]
+          #     The minimum lifetime applied to every implicit and explicit cache breakpoint
+          #     written by the request. Defaults to `30m`, which is currently the only supported
+          #     value. The backend may retain cache entries for longer.
 
           # Controls whether OpenAI automatically creates an implicit cache breakpoint.
           # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -578,17 +621,17 @@ module OpenAI
         # Project settings. Unless otherwise configured, the Project will use 'default'. -
         # If set to 'default', then the request will be processed with the standard
         # pricing and performance for the selected model. - If set to
-        # '[flex](https://platform.openai.com/docs/guides/flex-processing)', then the
-        # request will be processed with the Flex Processing service tier. - To opt-in to
-        # [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
-        # `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-        # Completions. For models with a dedicated Fast tier, either value resolves to
-        # `service_tier=fast`; for other models, either value resolves to
-        # `service_tier=priority`. - When not set, the default behavior is 'auto'. When
-        # the `service_tier` parameter is set, the response body will include the
-        # `service_tier` value based on the processing mode actually used to serve the
-        # request. This response value may be different from the value set in the
-        # parameter.
+        # '[flex](https://developers.openai.com/api/docs/guides/flex-processing)', then
+        # the request will be processed with the Flex Processing service tier. - To opt-in
+        # to [Fast mode](https://developers.openai.com/api/docs/guides/fast-mode) at the
+        # request level, include the `service_tier=fast` or `service_tier=priority`
+        # parameter for Responses or Chat Completions. For models with a dedicated Fast
+        # tier, either value resolves to `service_tier=fast`; for other models, either
+        # value resolves to `service_tier=priority`. - When not set, the default behavior
+        # is 'auto'. When the `service_tier` parameter is set, the response body will
+        # include the `service_tier` value based on the processing mode actually used to
+        # serve the request. This response value may be different from the value set in
+        # the parameter.
         module ServiceTier
           extend OpenAI::Internal::Type::Enum
 

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

@@ -30,15 +30,19 @@ module OpenAI
 
         # @!method initialize(id:, encrypted_content:, created_by: nil, type: :compaction)
         #   A compaction item generated by the
-        #   [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+        #   [`v1/responses/compact` API](https://developers.openai.com/api/reference/resources/responses/methods/compact).
         #
-        #   @param id [String] The unique ID of the compaction item.
+        #   @param id [String]
+        #     The unique ID of the compaction item.
         #
-        #   @param encrypted_content [String] The encrypted content that was produced by compaction.
+        #   @param encrypted_content [String]
+        #     The encrypted content that was produced by compaction.
         #
-        #   @param created_by [String] The identifier of the actor that created the item.
+        #   @param created_by [String]
+        #     The identifier of the actor that created the item.
         #
-        #   @param type [Symbol, :compaction] The type of the item. Always `compaction`.
+        #   @param type [Symbol, :compaction]
+        #     The type of the item. Always `compaction`.
       end
     end
   end

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

@@ -24,13 +24,16 @@ module OpenAI
 
         # @!method initialize(encrypted_content:, id: nil, type: :compaction)
         #   A compaction item generated by the
-        #   [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+        #   [`v1/responses/compact` API](https://developers.openai.com/api/reference/resources/responses/methods/compact).
         #
-        #   @param encrypted_content [String] The encrypted content of the compaction summary.
+        #   @param encrypted_content [String]
+        #     The encrypted content of the compaction summary.
         #
-        #   @param id [String, nil] The ID of the compaction item.
+        #   @param id [String, nil]
+        #     The ID of the compaction item.
         #
-        #   @param type [Symbol, :compaction] The type of the item. Always `compaction`.
+        #   @param type [Symbol, :compaction]
+        #     The type of the item. Always `compaction`.
       end
     end
   end

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

@@ -23,16 +23,16 @@ module OpenAI
         required :type, const: :"response.completed"
 
         # @!method initialize(response:, sequence_number:, type: :"response.completed")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::ResponseCompletedEvent} for more details.
-        #
         #   Emitted when the model response is complete.
         #
-        #   @param response [OpenAI::Models::Responses::Response] Properties of the completed response.
+        #   @param response [OpenAI::Models::Responses::Response]
+        #     Properties of the completed response.
         #
-        #   @param sequence_number [Integer] The sequence number for this event.
+        #   @param sequence_number [Integer]
+        #     The sequence number for this event.
         #
-        #   @param type [Symbol, :"response.completed"] The type of the event. Always `response.completed`.
+        #   @param type [Symbol, :"response.completed"]
+        #     The type of the event. Always `response.completed`.
       end
     end
   end

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

@@ -52,27 +52,32 @@ module OpenAI
         optional :actions, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ComputerAction] }
 
         # @!method initialize(id:, call_id:, pending_safety_checks:, status:, type:, action: nil, actions: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::ResponseComputerToolCall} for more details.
-        #
         #   A tool call to a computer use tool. See the
-        #   [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use)
+        #   [computer use guide](https://developers.openai.com/api/docs/guides/tools-computer-use)
         #   for more information.
         #
-        #   @param id [String] The unique ID of the computer call.
+        #   @param id [String]
+        #     The unique ID of the computer call.
         #
-        #   @param call_id [String] An identifier used when responding to the tool call with output.
+        #   @param call_id [String]
+        #     An identifier used when responding to the tool call with output.
         #
-        #   @param pending_safety_checks [Array<OpenAI::Models::Responses::ResponseComputerToolCall::PendingSafetyCheck>] The pending safety checks for the computer call.
+        #   @param pending_safety_checks [Array<OpenAI::Models::Responses::ResponseComputerToolCall::PendingSafetyCheck>]
+        #     The pending safety checks for the computer call.
         #
-        #   @param status [Symbol, OpenAI::Models::Responses::ResponseComputerToolCall::Status] The status of the item. One of `in_progress`, `completed`, or
+        #   @param status [Symbol, OpenAI::Models::Responses::ResponseComputerToolCall::Status]
+        #     The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+        #     Populated when items are returned via API.
         #
-        #   @param type [Symbol, OpenAI::Models::Responses::ResponseComputerToolCall::Type] The type of the computer call. Always `computer_call`.
+        #   @param type [Symbol, OpenAI::Models::Responses::ResponseComputerToolCall::Type]
+        #     The type of the computer call. Always `computer_call`.
         #
-        #   @param action [OpenAI::Models::Responses::ResponseComputerToolCall::Action::Click, OpenAI::Models::Responses::ResponseComputerToolCall::Action::DoubleClick, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Drag, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Keypress, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Move, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Screenshot, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Scroll, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Type, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Wait] A click action.
+        #   @param action [OpenAI::Models::Responses::ResponseComputerToolCall::Action::Click, OpenAI::Models::Responses::ResponseComputerToolCall::Action::DoubleClick, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Drag, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Keypress, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Move, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Screenshot, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Scroll, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Type, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Wait]
+        #     A click action.
         #
-        #   @param actions [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>] Flattened batched actions for `computer_use`. Each action includes an
-
+        #   @param actions [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>]
+        #     Flattened batched actions for `computer_use`. Each action includes an `type`
+        #     discriminator and action-specific fields.
         class PendingSafetyCheck < OpenAI::Internal::Type::BaseModel
           # @!attribute id
           #   The ID of the pending safety check.
@@ -95,11 +100,14 @@ module OpenAI
           # @!method initialize(id:, code: nil, message: nil)
           #   A pending safety check for the computer call.
           #
-          #   @param id [String] The ID of the pending safety check.
+          #   @param id [String]
+          #     The ID of the pending safety check.
           #
-          #   @param code [String, nil] The type of the pending safety check.
+          #   @param code [String, nil]
+          #     The type of the pending safety check.
           #
-          #   @param message [String, nil] Details about the pending safety check.
+          #   @param message [String, nil]
+          #     Details about the pending safety check.
         end
 
         # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
@@ -197,21 +205,23 @@ module OpenAI
             optional :keys, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
             # @!method initialize(button:, x:, y_:, keys: nil, type: :click)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseComputerToolCall::Action::Click} for more
-            #   details.
-            #
             #   A click action.
             #
-            #   @param button [Symbol, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Click::Button] Indicates which mouse button was pressed during the click. One of `left`, `right
+            #   @param button [Symbol, OpenAI::Models::Responses::ResponseComputerToolCall::Action::Click::Button]
+            #     Indicates which mouse button was pressed during the click. One of `left`,
+            #     `right`, `wheel`, `back`, or `forward`.
             #
-            #   @param x [Integer] The x-coordinate where the click occurred.
+            #   @param x [Integer]
+            #     The x-coordinate where the click occurred.
             #
-            #   @param y_ [Integer] The y-coordinate where the click occurred.
+            #   @param y_ [Integer]
+            #     The y-coordinate where the click occurred.
             #
-            #   @param keys [Array<String>, nil] The keys being held while clicking.
+            #   @param keys [Array<String>, nil]
+            #     The keys being held while clicking.
             #
-            #   @param type [Symbol, :click] Specifies the event type. For a click action, this property is always `click`.
+            #   @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`.
@@ -258,19 +268,20 @@ module OpenAI
             required :y_, Integer, api_name: :y
 
             # @!method initialize(keys:, x:, y_:, type: :double_click)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseComputerToolCall::Action::DoubleClick} for
-            #   more details.
-            #
             #   A double click action.
             #
-            #   @param keys [Array<String>, nil] The keys being held while double-clicking.
+            #   @param keys [Array<String>, nil]
+            #     The keys being held while double-clicking.
             #
-            #   @param x [Integer] The x-coordinate where the double click occurred.
+            #   @param x [Integer]
+            #     The x-coordinate where the double click occurred.
             #
-            #   @param y_ [Integer] The y-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
+            #   @param type [Symbol, :double_click]
+            #     Specifies the event type. For a double click action, this property is always set
+            #     to `double_click`.
           end
 
           class Drag < OpenAI::Internal::Type::BaseModel
@@ -305,18 +316,25 @@ module OpenAI
             optional :keys, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
             # @!method initialize(path:, keys: nil, type: :drag)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseComputerToolCall::Action::Drag} for more
-            #   details.
-            #
             #   A drag action.
             #
-            #   @param path [Array<OpenAI::Models::Responses::ResponseComputerToolCall::Action::Drag::Path>] An array of coordinates representing the path of the drag action. Coordinates wi
+            #   @param path [Array<OpenAI::Models::Responses::ResponseComputerToolCall::Action::Drag::Path>]
+            #     An array of coordinates representing the path of the drag action. Coordinates
+            #     will appear as an array of objects, eg
             #
-            #   @param keys [Array<String>, nil] The keys being held while dragging the mouse.
+            #     ```
+            #     [
+            #       { x: 100, y: 200 },
+            #       { x: 200, y: 300 }
+            #     ]
+            #     ```
             #
-            #   @param type [Symbol, :drag] Specifies the event type. For a drag action, this property is always set to `dra
-
+            #   @param keys [Array<String>, nil]
+            #     The keys being held while dragging the mouse.
+            #
+            #   @param type [Symbol, :drag]
+            #     Specifies the event type. For a drag action, this property is always set to
+            #     `drag`.
             class Path < OpenAI::Internal::Type::BaseModel
               # @!attribute x
               #   The x-coordinate.
@@ -333,9 +351,11 @@ module OpenAI
               # @!method initialize(x:, y_:)
               #   An x/y coordinate pair, e.g. `{ x: 100, y: 200 }`.
               #
-              #   @param x [Integer] The x-coordinate.
+              #   @param x [Integer]
+              #     The x-coordinate.
               #
-              #   @param y_ [Integer] The y-coordinate.
+              #   @param y_ [Integer]
+              #     The y-coordinate.
             end
           end
 
@@ -355,15 +375,15 @@ module OpenAI
             required :type, const: :keypress
 
             # @!method initialize(keys:, type: :keypress)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseComputerToolCall::Action::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 keys [Array<String>]
+            #     The combination of keys the model is requesting to be pressed. This is an array
+            #     of strings, each representing a key.
             #
-            #   @param type [Symbol, :keypress] Specifies the event type. For a keypress action, this property is always set to
+            #   @param type [Symbol, :keypress]
+            #     Specifies the event type. For a keypress action, this property is always set to
+            #     `keypress`.
           end
 
           class Move < OpenAI::Internal::Type::BaseModel
@@ -393,19 +413,20 @@ module OpenAI
             optional :keys, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
             # @!method initialize(x:, y_:, keys: nil, type: :move)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseComputerToolCall::Action::Move} for more
-            #   details.
-            #
             #   A mouse move action.
             #
-            #   @param x [Integer] The x-coordinate to move to.
+            #   @param x [Integer]
+            #     The x-coordinate to move to.
             #
-            #   @param y_ [Integer] The y-coordinate to move to.
+            #   @param y_ [Integer]
+            #     The y-coordinate to move to.
             #
-            #   @param keys [Array<String>, nil] The keys being held while moving the mouse.
+            #   @param keys [Array<String>, nil]
+            #     The keys being held while moving the mouse.
             #
-            #   @param type [Symbol, :move] Specifies the event type. For a move action, this property is always set to `mov
+            #   @param type [Symbol, :move]
+            #     Specifies the event type. For a move action, this property is always set to
+            #     `move`.
           end
 
           class Screenshot < OpenAI::Internal::Type::BaseModel
@@ -417,13 +438,11 @@ module OpenAI
             required :type, const: :screenshot
 
             # @!method initialize(type: :screenshot)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseComputerToolCall::Action::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
+            #   @param type [Symbol, :screenshot]
+            #     Specifies the event type. For a screenshot action, this property is always set
+            #     to `screenshot`.
           end
 
           class Scroll < OpenAI::Internal::Type::BaseModel
@@ -465,23 +484,26 @@ module OpenAI
             optional :keys, OpenAI::Internal::Type::ArrayOf[String], nil?: true
 
             # @!method initialize(scroll_x:, scroll_y:, x:, y_:, keys: nil, type: :scroll)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseComputerToolCall::Action::Scroll} for more
-            #   details.
-            #
             #   A scroll action.
             #
-            #   @param scroll_x [Integer] The horizontal scroll distance.
+            #   @param scroll_x [Integer]
+            #     The horizontal scroll distance.
             #
-            #   @param scroll_y [Integer] The vertical scroll distance.
+            #   @param scroll_y [Integer]
+            #     The vertical scroll distance.
             #
-            #   @param x [Integer] The x-coordinate where the scroll occurred.
+            #   @param x [Integer]
+            #     The x-coordinate where the scroll occurred.
             #
-            #   @param y_ [Integer] The y-coordinate where the scroll occurred.
+            #   @param y_ [Integer]
+            #     The y-coordinate where the scroll occurred.
             #
-            #   @param keys [Array<String>, nil] The keys being held while scrolling.
+            #   @param keys [Array<String>, nil]
+            #     The keys being held while scrolling.
             #
-            #   @param type [Symbol, :scroll] Specifies the event type. For a scroll action, this property is always set to `s
+            #   @param type [Symbol, :scroll]
+            #     Specifies the event type. For a scroll action, this property is always set to
+            #     `scroll`.
           end
 
           class Type < OpenAI::Internal::Type::BaseModel
@@ -499,15 +521,14 @@ module OpenAI
             required :type, const: :type
 
             # @!method initialize(text:, type: :type)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseComputerToolCall::Action::Type} for more
-            #   details.
-            #
             #   An action to type in text.
             #
-            #   @param text [String] The text to type.
+            #   @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
+            #   @param type [Symbol, :type]
+            #     Specifies the event type. For a type action, this property is always set to
+            #     `type`.
           end
 
           class Wait < OpenAI::Internal::Type::BaseModel
@@ -519,13 +540,11 @@ module OpenAI
             required :type, const: :wait
 
             # @!method initialize(type: :wait)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseComputerToolCall::Action::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
+            #   @param type [Symbol, :wait]
+            #     Specifies the event type. For a wait action, this property is always set to
+            #     `wait`.
           end
 
           # @!method self.variants