openai 0.87.0 → 0.89.0

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

@@ -19,7 +19,8 @@ module OpenAI
         #   Specifies a tool the model should use. Use to force the model to call a specific
         #   tool.
         #
-        #   @param type [Symbol, OpenAI::Models::Beta::AssistantToolChoice::Type] The type of the tool. If type is `function`, the function name must be set
+        #   @param type [Symbol, OpenAI::Models::Beta::AssistantToolChoice::Type]
+        #     The type of the tool. If type is `function`, the function name must be set
         #
         #   @param function [OpenAI::Models::Beta::AssistantToolChoiceFunction]
 

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

@@ -11,7 +11,8 @@ module OpenAI
         required :name, String
 
         # @!method initialize(name:)
-        #   @param name [String] The name of the function to call.
+        #   @param name [String]
+        #     The name of the function to call.
       end
     end
   end

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

@@ -39,10 +39,10 @@ module OpenAI
 
         # @!attribute model
         #   ID of the model to use. You can use the
-        #   [List models](https://platform.openai.com/docs/api-reference/models/list) API to
-        #   see all of your available models, or see our
-        #   [Model overview](https://platform.openai.com/docs/models) for descriptions of
-        #   them.
+        #   [List models](https://developers.openai.com/api/reference/resources/models/methods/list)
+        #   API to see all of your available models, or see our
+        #   [Model overview](https://developers.openai.com/api/docs/models) for descriptions
+        #   of them.
         #
         #   @return [String, Symbol, OpenAI::Models::Beta::AssistantUpdateParams::Model, nil]
         optional :model, union: -> { OpenAI::Beta::AssistantUpdateParams::Model }
@@ -58,7 +58,7 @@ module OpenAI
         #   are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
         #   reasoning effort can result in faster responses and fewer tokens used on
         #   reasoning in a response. Not all reasoning models support every value. See the
-        #   [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+        #   [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
         #   model-specific support.
         #
         #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
@@ -66,14 +66,14 @@ module OpenAI
 
         # @!attribute response_format
         #   Specifies the format that the model must output. Compatible with
-        #   [GPT-4o](https://platform.openai.com/docs/models#gpt-4o),
-        #   [GPT-4 Turbo](https://platform.openai.com/docs/models#gpt-4-turbo-and-gpt-4),
-        #   and all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
+        #   [GPT-4o](https://developers.openai.com/api/docs/models/gpt-4o),
+        #   [GPT-4 Turbo](https://developers.openai.com/api/docs/models/gpt-4-turbo), and
+        #   all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
         #
         #   Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
         #   Outputs which ensures the model will match your supplied JSON schema. Learn more
         #   in the
-        #   [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+        #   [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
         #
         #   Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the
         #   message the model generates is valid JSON.
@@ -125,40 +125,93 @@ module OpenAI
         optional :top_p, Float, nil?: true
 
         # @!method initialize(assistant_id:, description: nil, instructions: nil, metadata: nil, model: nil, name: nil, reasoning_effort: nil, response_format: nil, temperature: nil, tool_resources: nil, tools: nil, top_p: nil, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::AssistantUpdateParams} for more details.
-        #
         #   @param assistant_id [String]
         #
-        #   @param description [String, nil] The description of the assistant. The maximum length is 512 characters.
+        #   @param description [String, nil]
+        #     The description of the assistant. The maximum length is 512 characters.
+        #
+        #   @param instructions [String, nil]
+        #     The system instructions that the assistant uses. The maximum length is 256,000
+        #     characters.
+        #
+        #   @param metadata [Hash{Symbol=>String}, nil]
+        #     Set of 16 key-value pairs that can be attached to an object. This can be useful
+        #     for storing additional information about the object in a structured format, and
+        #     querying for objects via API or the dashboard.
+        #
+        #     Keys are strings with a maximum length of 64 characters. Values are strings with
+        #     a maximum length of 512 characters.
         #
-        #   @param instructions [String, nil] The system instructions that the assistant uses. The maximum length is 256,000 c
+        #   @param model [String, Symbol, OpenAI::Models::Beta::AssistantUpdateParams::Model]
+        #     ID of the model to use. You can use the
+        #     [List models](https://developers.openai.com/api/reference/resources/models/methods/list)
+        #     API to see all of your available models, or see our
+        #     [Model overview](https://developers.openai.com/api/docs/models) for descriptions
+        #     of them.
         #
-        #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
+        #   @param name [String, nil]
+        #     The name of the assistant. The maximum length is 256 characters.
         #
-        #   @param model [String, Symbol, OpenAI::Models::Beta::AssistantUpdateParams::Model] ID of the model to use. You can use the [List models](https://platform.openai.co
+        #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil]
+        #     Constrains effort on reasoning for reasoning models. Currently supported values
+        #     are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+        #     reasoning effort can result in faster responses and fewer tokens used on
+        #     reasoning in a response. Not all reasoning models support every value. See the
+        #     [reasoning guide](https://developers.openai.com/api/docs/guides/reasoning) for
+        #     model-specific support.
         #
-        #   @param name [String, nil] The name of the assistant. The maximum length is 256 characters.
+        #   @param response_format [Symbol, :auto, OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONObject, OpenAI::Models::ResponseFormatJSONSchema, nil]
+        #     Specifies the format that the model must output. Compatible with
+        #     [GPT-4o](https://developers.openai.com/api/docs/models/gpt-4o),
+        #     [GPT-4 Turbo](https://developers.openai.com/api/docs/models/gpt-4-turbo), and
+        #     all GPT-3.5 Turbo models since `gpt-3.5-turbo-1106`.
         #
-        #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for reasoning models. Currently supported
+        #     Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured
+        #     Outputs which ensures the model will match your supplied JSON schema. Learn more
+        #     in the
+        #     [Structured Outputs guide](https://developers.openai.com/api/docs/guides/structured-outputs).
         #
-        #   @param response_format [Symbol, :auto, OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONObject, OpenAI::Models::ResponseFormatJSONSchema, nil] Specifies the format that the model must output. Compatible with [GPT-4o](https:
+        #     Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the
+        #     message the model generates is valid JSON.
         #
-        #   @param temperature [Float, nil] What sampling temperature to use, between 0 and 2. Higher values like 0.8 will m
+        #     **Important:** when using JSON mode, you **must** also instruct the model to
+        #     produce JSON yourself via a system or user message. Without this, the model may
+        #     generate an unending stream of whitespace until the generation reaches the token
+        #     limit, resulting in a long-running and seemingly "stuck" request. Also note that
+        #     the message content may be partially cut off if `finish_reason="length"`, which
+        #     indicates the generation exceeded `max_tokens` or the conversation exceeded the
+        #     max context length.
         #
-        #   @param tool_resources [OpenAI::Models::Beta::AssistantUpdateParams::ToolResources, nil] A set of resources that are used by the assistant's tools. The resources are spe
+        #   @param temperature [Float, nil]
+        #     What sampling temperature to use, between 0 and 2. Higher values like 0.8 will
+        #     make the output more random, while lower values like 0.2 will make it more
+        #     focused and deterministic.
         #
-        #   @param tools [Array<OpenAI::Models::Beta::CodeInterpreterTool, OpenAI::Models::Beta::FileSearchTool, OpenAI::Models::Beta::FunctionTool>] A list of tool enabled on the assistant. There can be a maximum of 128 tools per
+        #   @param tool_resources [OpenAI::Models::Beta::AssistantUpdateParams::ToolResources, nil]
+        #     A set of resources that are used by the assistant's tools. The resources are
+        #     specific to the type of tool. For example, the `code_interpreter` tool requires
+        #     a list of file IDs, while the `file_search` tool requires a list of vector store
+        #     IDs.
         #
-        #   @param top_p [Float, nil] An alternative to sampling with temperature, called nucleus sampling, where the
+        #   @param tools [Array<OpenAI::Models::Beta::CodeInterpreterTool, OpenAI::Models::Beta::FileSearchTool, OpenAI::Models::Beta::FunctionTool>]
+        #     A list of tool enabled on the assistant. There can be a maximum of 128 tools per
+        #     assistant. Tools can be of types `code_interpreter`, `file_search`, or
+        #     `function`.
+        #
+        #   @param top_p [Float, nil]
+        #     An alternative to sampling with temperature, called nucleus sampling, where the
+        #     model considers the results of the tokens with top_p probability mass. So 0.1
+        #     means only the tokens comprising the top 10% probability mass are considered.
+        #
+        #     We generally recommend altering this or temperature but not both.
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
 
         # ID of the model to use. You can use the
-        # [List models](https://platform.openai.com/docs/api-reference/models/list) API to
-        # see all of your available models, or see our
-        # [Model overview](https://platform.openai.com/docs/models) for descriptions of
-        # them.
+        # [List models](https://developers.openai.com/api/reference/resources/models/methods/list)
+        # API to see all of your available models, or see our
+        # [Model overview](https://developers.openai.com/api/docs/models) for descriptions
+        # of them.
         module Model
           extend OpenAI::Internal::Type::Union
 
@@ -327,26 +380,26 @@ module OpenAI
           class CodeInterpreter < OpenAI::Internal::Type::BaseModel
             # @!attribute file_ids
             #   Overrides the list of
-            #   [file](https://platform.openai.com/docs/api-reference/files) IDs made available
-            #   to the `code_interpreter` tool. There can be a maximum of 20 files associated
-            #   with the tool.
+            #   [file](https://developers.openai.com/api/reference/resources/files) IDs made
+            #   available to the `code_interpreter` tool. There can be a maximum of 20 files
+            #   associated with the tool.
             #
             #   @return [Array<String>, nil]
             optional :file_ids, OpenAI::Internal::Type::ArrayOf[String]
 
             # @!method initialize(file_ids: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::AssistantUpdateParams::ToolResources::CodeInterpreter}
-            #   for more details.
-            #
-            #   @param file_ids [Array<String>] Overrides the list of [file](https://platform.openai.com/docs/api-reference/file
+            #   @param file_ids [Array<String>]
+            #     Overrides the list of
+            #     [file](https://developers.openai.com/api/reference/resources/files) IDs made
+            #     available to the `code_interpreter` tool. There can be a maximum of 20 files
+            #     associated with the tool.
           end
 
           # @see OpenAI::Models::Beta::AssistantUpdateParams::ToolResources#file_search
           class FileSearch < OpenAI::Internal::Type::BaseModel
             # @!attribute vector_store_ids
             #   Overrides the
-            #   [vector store](https://platform.openai.com/docs/api-reference/vector-stores/object)
+            #   [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
             #   attached to this assistant. There can be a maximum of 1 vector store attached to
             #   the assistant.
             #
@@ -354,11 +407,11 @@ module OpenAI
             optional :vector_store_ids, OpenAI::Internal::Type::ArrayOf[String]
 
             # @!method initialize(vector_store_ids: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Beta::AssistantUpdateParams::ToolResources::FileSearch} for
-            #   more details.
-            #
-            #   @param vector_store_ids [Array<String>] Overrides the [vector store](https://platform.openai.com/docs/api-reference/vect
+            #   @param vector_store_ids [Array<String>]
+            #     Overrides the
+            #     [vector store](https://developers.openai.com/api/reference/resources/vector_stores)
+            #     attached to this assistant. There can be a maximum of 1 vector store attached to
+            #     the assistant.
           end
         end
       end

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

@@ -25,10 +25,11 @@ module OpenAI
         # @!method initialize(allowed_callers: nil, type: :apply_patch)
         #   Allows the assistant to create, delete, or update files using unified diffs.
         #
-        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Beta::BetaApplyPatchTool::AllowedCaller>, nil] The tool invocation context(s).
+        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Beta::BetaApplyPatchTool::AllowedCaller>, nil]
+        #     The tool invocation context(s).
         #
-        #   @param type [Symbol, :apply_patch] The type of the tool. Always `apply_patch`.
-
+        #   @param type [Symbol, :apply_patch]
+        #     The type of the tool. Always `apply_patch`.
         module AllowedCaller
           extend OpenAI::Internal::Type::Enum
 

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

@@ -38,18 +38,22 @@ module OpenAI
         required :usage, -> { OpenAI::Beta::BetaResponseUsage }
 
         # @!method initialize(id:, created_at:, output:, usage:, object: :"response.compaction")
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Beta::BetaCompactedResponse} for more details.
+        #   @param id [String]
+        #     The unique identifier for the compacted response.
         #
-        #   @param id [String] The unique identifier for the compacted response.
+        #   @param created_at [Integer]
+        #     Unix timestamp (in seconds) when the compacted conversation was created.
         #
-        #   @param created_at [Integer] Unix timestamp (in seconds) when the compacted conversation was created.
+        #   @param output [Array<OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseFunctionToolCall, OpenAI::Models::Beta::BetaResponseFunctionToolCallOutputItem, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCallOutputItem, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseOutputItem::Program, OpenAI::Models::Beta::BetaResponseOutputItem::ProgramOutput, OpenAI::Models::Beta::BetaResponseToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItem, OpenAI::Models::Beta::BetaResponseOutputItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseCompactionItem, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseFunctionShellToolCall, OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput, OpenAI::Models::Beta::BetaResponseApplyPatchToolCall, OpenAI::Models::Beta::BetaResponseApplyPatchToolCallOutput, OpenAI::Models::Beta::BetaResponseOutputItem::McpCall, OpenAI::Models::Beta::BetaResponseOutputItem::McpListTools, OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseCustomToolCall, OpenAI::Models::Beta::BetaResponseCustomToolCallOutputItem>]
+        #     The compacted list of output items. This is a list of all user messages,
+        #     followed by a single compaction item.
         #
-        #   @param output [Array<OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseFunctionToolCall, OpenAI::Models::Beta::BetaResponseFunctionToolCallOutputItem, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCallOutputItem, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseOutputItem::Program, OpenAI::Models::Beta::BetaResponseOutputItem::ProgramOutput, OpenAI::Models::Beta::BetaResponseToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItem, OpenAI::Models::Beta::BetaResponseOutputItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseCompactionItem, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseFunctionShellToolCall, OpenAI::Models::Beta::BetaResponseFunctionShellToolCallOutput, OpenAI::Models::Beta::BetaResponseApplyPatchToolCall, OpenAI::Models::Beta::BetaResponseApplyPatchToolCallOutput, OpenAI::Models::Beta::BetaResponseOutputItem::McpCall, OpenAI::Models::Beta::BetaResponseOutputItem::McpListTools, OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseCustomToolCall, OpenAI::Models::Beta::BetaResponseCustomToolCallOutputItem>] The compacted list of output items. This is a list of all user messages, followe
+        #   @param usage [OpenAI::Models::Beta::BetaResponseUsage]
+        #     Token accounting for the compaction pass, including cached, reasoning, and total
+        #     tokens.
         #
-        #   @param usage [OpenAI::Models::Beta::BetaResponseUsage] Token accounting for the compaction pass, including cached, reasoning, and total
-        #
-        #   @param object [Symbol, :"response.compaction"] The object type. Always `response.compaction`.
+        #   @param object [Symbol, :"response.compaction"]
+        #     The object type. Always `response.compaction`.
       end
     end
 

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

@@ -69,20 +69,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::Beta::BetaComputerAction::Click} for more details.
-          #
           #   A click action.
           #
-          #   @param button [Symbol, OpenAI::Models::Beta::BetaComputerAction::Click::Button] Indicates which mouse button was pressed during the click. One of `left`, `right
+          #   @param button [Symbol, OpenAI::Models::Beta::BetaComputerAction::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`.
@@ -129,18 +132,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::Beta::BetaComputerAction::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
@@ -172,17 +177,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::Beta::BetaComputerAction::Drag} for more details.
-          #
           #   A drag action.
           #
-          #   @param path [Array<OpenAI::Models::Beta::BetaComputerAction::Drag::Path>] An array of coordinates representing the path of the drag action. Coordinates wi
+          #   @param path [Array<OpenAI::Models::Beta::BetaComputerAction::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.
@@ -199,9 +212,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
 
@@ -221,14 +236,15 @@ module OpenAI
           required :type, const: :keypress
 
           # @!method initialize(keys:, type: :keypress)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaComputerAction::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
@@ -258,18 +274,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::Beta::BetaComputerAction::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
@@ -281,12 +299,11 @@ module OpenAI
           required :type, const: :screenshot
 
           # @!method initialize(type: :screenshot)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaComputerAction::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
@@ -328,22 +345,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::Beta::BetaComputerAction::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
@@ -361,14 +382,14 @@ module OpenAI
           required :type, const: :type
 
           # @!method initialize(text:, type: :type)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaComputerAction::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
@@ -380,12 +401,11 @@ module OpenAI
           required :type, const: :wait
 
           # @!method initialize(type: :wait)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaComputerAction::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

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

@@ -12,9 +12,10 @@ module OpenAI
 
         # @!method initialize(type: :computer)
         #   A tool that controls a virtual computer. Learn more about the
-        #   [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+        #   [computer tool](https://developers.openai.com/api/docs/guides/tools-computer-use).
         #
-        #   @param type [Symbol, :computer] The type of the computer tool. Always `computer`.
+        #   @param type [Symbol, :computer]
+        #     The type of the computer tool. Always `computer`.
       end
     end
 

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

@@ -30,15 +30,19 @@ module OpenAI
 
         # @!method initialize(display_height:, display_width:, environment:, type: :computer_use_preview)
         #   A tool that controls a virtual computer. Learn more about the
-        #   [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+        #   [computer tool](https://developers.openai.com/api/docs/guides/tools-computer-use).
         #
-        #   @param display_height [Integer] The height of the computer display.
+        #   @param display_height [Integer]
+        #     The height of the computer display.
         #
-        #   @param display_width [Integer] The width of the computer display.
+        #   @param display_width [Integer]
+        #     The width of the computer display.
         #
-        #   @param environment [Symbol, OpenAI::Models::Beta::BetaComputerUsePreviewTool::Environment] The type of computer environment to control.
+        #   @param environment [Symbol, OpenAI::Models::Beta::BetaComputerUsePreviewTool::Environment]
+        #     The type of computer environment to control.
         #
-        #   @param type [Symbol, :computer_use_preview] The type of the computer use tool. Always `computer_use_preview`.
+        #   @param type [Symbol, :computer_use_preview]
+        #     The type of the computer use tool. Always `computer_use_preview`.
 
         # The type of computer environment to control.
         #

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

@@ -35,15 +35,20 @@ module OpenAI
         optional :skills, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::BetaContainerAuto::Skill] }
 
         # @!method initialize(file_ids: nil, memory_limit: nil, network_policy: nil, skills: nil, type: :container_auto)
-        #   @param file_ids [Array<String>] An optional list of uploaded files to make available to your code.
+        #   @param file_ids [Array<String>]
+        #     An optional list of uploaded files to make available to your code.
         #
-        #   @param memory_limit [Symbol, OpenAI::Models::Beta::BetaContainerAuto::MemoryLimit, nil] The memory limit for the container.
+        #   @param memory_limit [Symbol, OpenAI::Models::Beta::BetaContainerAuto::MemoryLimit, nil]
+        #     The memory limit for the container.
         #
-        #   @param network_policy [OpenAI::Models::Beta::BetaContainerNetworkPolicyDisabled, OpenAI::Models::Beta::BetaContainerNetworkPolicyAllowlist] Network access policy for the container.
+        #   @param network_policy [OpenAI::Models::Beta::BetaContainerNetworkPolicyDisabled, OpenAI::Models::Beta::BetaContainerNetworkPolicyAllowlist]
+        #     Network access policy for the container.
         #
-        #   @param skills [Array<OpenAI::Models::Beta::BetaSkillReference, OpenAI::Models::Beta::BetaInlineSkill>] An optional list of skills referenced by id or inline data.
+        #   @param skills [Array<OpenAI::Models::Beta::BetaSkillReference, OpenAI::Models::Beta::BetaInlineSkill>]
+        #     An optional list of skills referenced by id or inline data.
         #
-        #   @param type [Symbol, :container_auto] Automatically creates a container for this request
+        #   @param type [Symbol, :container_auto]
+        #     Automatically creates a container for this request
 
         # The memory limit for the container.
         #

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

@@ -26,11 +26,14 @@ module OpenAI
         )
 
         # @!method initialize(allowed_domains:, domain_secrets: nil, type: :allowlist)
-        #   @param allowed_domains [Array<String>] A list of allowed domains when type is `allowlist`.
+        #   @param allowed_domains [Array<String>]
+        #     A list of allowed domains when type is `allowlist`.
         #
-        #   @param domain_secrets [Array<OpenAI::Models::Beta::BetaContainerNetworkPolicyDomainSecret>] Optional domain-scoped secrets for allowlisted domains.
+        #   @param domain_secrets [Array<OpenAI::Models::Beta::BetaContainerNetworkPolicyDomainSecret>]
+        #     Optional domain-scoped secrets for allowlisted domains.
         #
-        #   @param type [Symbol, :allowlist] Allow outbound network access only to specified domains. Always `allowlist`.
+        #   @param type [Symbol, :allowlist]
+        #     Allow outbound network access only to specified domains. Always `allowlist`.
       end
     end
 

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

@@ -11,7 +11,8 @@ module OpenAI
         required :type, const: :disabled
 
         # @!method initialize(type: :disabled)
-        #   @param type [Symbol, :disabled] Disable outbound network access. Always `disabled`.
+        #   @param type [Symbol, :disabled]
+        #     Disable outbound network access. Always `disabled`.
       end
     end