openai 0.87.0 → 0.89.0

data/lib/openai/models/responses/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::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 button [Symbol, OpenAI::Models::Responses::ComputerAction::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::Responses::ComputerAction::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::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 path [Array<OpenAI::Models::Responses::ComputerAction::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::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 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::Responses::ComputerAction::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::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
+          #   @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::Responses::ComputerAction::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::Responses::ComputerAction::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::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
+          #   @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/responses/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
   end

data/lib/openai/models/responses/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::Responses::ComputerUsePreviewTool::Environment] The type of computer environment to control.
+        #   @param environment [Symbol, OpenAI::Models::Responses::ComputerUsePreviewTool::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/responses/container_auto.rb

@@ -35,15 +35,20 @@ module OpenAI
         optional :skills, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ContainerAuto::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::Responses::ContainerAuto::MemoryLimit, nil] The memory limit for the container.
+        #   @param memory_limit [Symbol, OpenAI::Models::Responses::ContainerAuto::MemoryLimit, nil]
+        #     The memory limit for the container.
         #
-        #   @param network_policy [OpenAI::Models::Responses::ContainerNetworkPolicyDisabled, OpenAI::Models::Responses::ContainerNetworkPolicyAllowlist] Network access policy for the container.
+        #   @param network_policy [OpenAI::Models::Responses::ContainerNetworkPolicyDisabled, OpenAI::Models::Responses::ContainerNetworkPolicyAllowlist]
+        #     Network access policy for the container.
         #
-        #   @param skills [Array<OpenAI::Models::Responses::SkillReference, OpenAI::Models::Responses::InlineSkill>] An optional list of skills referenced by id or inline data.
+        #   @param skills [Array<OpenAI::Models::Responses::SkillReference, OpenAI::Models::Responses::InlineSkill>]
+        #     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/responses/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::Responses::ContainerNetworkPolicyDomainSecret>] Optional domain-scoped secrets for allowlisted domains.
+        #   @param domain_secrets [Array<OpenAI::Models::Responses::ContainerNetworkPolicyDomainSecret>]
+        #     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
   end

data/lib/openai/models/responses/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
   end

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

@@ -23,11 +23,14 @@ module OpenAI
         required :value, String
 
         # @!method initialize(domain:, name:, value:)
-        #   @param domain [String] The domain associated with the secret.
+        #   @param domain [String]
+        #     The domain associated with the secret.
         #
-        #   @param name [String] The name of the secret to inject for the domain.
+        #   @param name [String]
+        #     The name of the secret to inject for the domain.
         #
-        #   @param value [String] The secret value to inject for the domain.
+        #   @param value [String]
+        #     The secret value to inject for the domain.
       end
     end
   end

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

@@ -17,9 +17,11 @@ module OpenAI
         required :type, const: :container_reference
 
         # @!method initialize(container_id:, type: :container_reference)
-        #   @param container_id [String] The ID of the referenced container.
+        #   @param container_id [String]
+        #     The ID of the referenced container.
         #
-        #   @param type [Symbol, :container_reference] References a container created with the /v1/containers endpoint
+        #   @param type [Symbol, :container_reference]
+        #     References a container created with the /v1/containers endpoint
       end
     end
   end

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

@@ -52,26 +52,30 @@ module OpenAI
         optional :format_, union: -> { OpenAI::CustomToolInputFormat }, api_name: :format
 
         # @!method initialize(name:, allowed_callers: nil, async: nil, defer_loading: nil, description: nil, format_: nil, type: :custom)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::CustomTool} for more details.
-        #
         #   A custom tool that processes input using a specified format. Learn more about
-        #   [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+        #   [custom tools](https://developers.openai.com/api/docs/guides/function-calling#custom-tools)
         #
-        #   @param name [String] The name of the custom tool, used to identify it in tool calls.
+        #   @param name [String]
+        #     The name of the custom tool, used to identify it in tool calls.
         #
-        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Responses::CustomTool::AllowedCaller>, nil] The tool invocation context(s).
+        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Responses::CustomTool::AllowedCaller>, nil]
+        #     The tool invocation context(s).
         #
-        #   @param async [Boolean] Whether the tool response can be returned asynchronously versus immediately retu
+        #   @param async [Boolean]
+        #     Whether the tool response can be returned asynchronously versus immediately
+        #     returned on next response creation.
         #
-        #   @param defer_loading [Boolean] Whether this tool should be deferred and discovered via tool search.
+        #   @param defer_loading [Boolean]
+        #     Whether this tool should be deferred and discovered via tool search.
         #
-        #   @param description [String] Optional description of the custom tool, used to provide more context.
+        #   @param description [String]
+        #     Optional description of the custom tool, used to provide more context.
         #
-        #   @param format_ [OpenAI::Models::CustomToolInputFormat::Text, OpenAI::Models::CustomToolInputFormat::Grammar] The input format for the custom tool. Default is unconstrained text.
+        #   @param format_ [OpenAI::Models::CustomToolInputFormat::Text, OpenAI::Models::CustomToolInputFormat::Grammar]
+        #     The input format for the custom tool. Default is unconstrained text.
         #
-        #   @param type [Symbol, :custom] The type of the custom tool. Always `custom`.
-
+        #   @param type [Symbol, :custom]
+        #     The type of the custom tool. Always `custom`.
         module AllowedCaller
           extend OpenAI::Internal::Type::Enum
 

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

@@ -34,22 +34,28 @@ module OpenAI
         optional :type, enum: -> { OpenAI::Responses::EasyInputMessage::Type }
 
         # @!method initialize(content:, role:, phase: nil, type: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::EasyInputMessage} for more details.
-        #
         #   A message input to the model with a role indicating instruction following
         #   hierarchy. Instructions given with the `developer` or `system` role take
         #   precedence over instructions given with the `user` role. Messages with the
         #   `assistant` role are presumed to have been generated by the model in previous
         #   interactions.
         #
-        #   @param content [String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>] Text, image, or audio input to the model, used to generate a response.
+        #   @param content [String, Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>]
+        #     Text, image, or audio input to the model, used to generate a response. Can also
+        #     contain previous assistant responses.
         #
-        #   @param role [Symbol, OpenAI::Models::Responses::EasyInputMessage::Role] The role of the message input. One of `user`, `assistant`, `system`, or
+        #   @param role [Symbol, OpenAI::Models::Responses::EasyInputMessage::Role]
+        #     The role of the message input. One of `user`, `assistant`, `system`, or
+        #     `developer`.
         #
-        #   @param phase [Symbol, OpenAI::Models::Responses::EasyInputMessage::Phase, nil] Labels an `assistant` message as intermediate commentary (`commentary`) or the f
+        #   @param phase [Symbol, OpenAI::Models::Responses::EasyInputMessage::Phase, nil]
+        #     Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        #     final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        #     sending follow-up requests, preserve and resend phase on all assistant messages
+        #     — dropping it can degrade performance. Not used for user messages.
         #
-        #   @param type [Symbol, OpenAI::Models::Responses::EasyInputMessage::Type] The type of the message input. Always `message`.
+        #   @param type [Symbol, OpenAI::Models::Responses::EasyInputMessage::Type]
+        #     The type of the message input. Always `message`.
 
         # Text, image, or audio input to the model, used to generate a response. Can also
         # contain previous assistant responses.

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

@@ -36,22 +36,25 @@ module OpenAI
         optional :ranking_options, -> { OpenAI::Responses::FileSearchTool::RankingOptions }
 
         # @!method initialize(vector_store_ids:, filters: nil, max_num_results: nil, ranking_options: nil, type: :file_search)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::FileSearchTool} for more details.
-        #
         #   A tool that searches for relevant content from uploaded files. Learn more about
         #   the
-        #   [file search tool](https://platform.openai.com/docs/guides/tools-file-search).
+        #   [file search tool](https://developers.openai.com/api/docs/guides/tools-file-search).
         #
-        #   @param vector_store_ids [Array<String>] The IDs of the vector stores to search.
+        #   @param vector_store_ids [Array<String>]
+        #     The IDs of the vector stores to search.
         #
-        #   @param filters [OpenAI::Models::ComparisonFilter, OpenAI::Models::CompoundFilter, nil] A filter to apply.
+        #   @param filters [OpenAI::Models::ComparisonFilter, OpenAI::Models::CompoundFilter, nil]
+        #     A filter to apply.
         #
-        #   @param max_num_results [Integer] The maximum number of results to return. This number should be between 1 and 50
+        #   @param max_num_results [Integer]
+        #     The maximum number of results to return. This number should be between 1 and 50
+        #     inclusive.
         #
-        #   @param ranking_options [OpenAI::Models::Responses::FileSearchTool::RankingOptions] Ranking options for search.
+        #   @param ranking_options [OpenAI::Models::Responses::FileSearchTool::RankingOptions]
+        #     Ranking options for search.
         #
-        #   @param type [Symbol, :file_search] The type of the file search tool. Always `file_search`.
+        #   @param type [Symbol, :file_search]
+        #     The type of the file search tool. Always `file_search`.
 
         # A filter to apply.
         #
@@ -93,16 +96,19 @@ module OpenAI
           optional :score_threshold, Float
 
           # @!method initialize(hybrid_search: nil, ranker: nil, score_threshold: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::FileSearchTool::RankingOptions} for more details.
-          #
           #   Ranking options for search.
           #
-          #   @param hybrid_search [OpenAI::Models::Responses::FileSearchTool::RankingOptions::HybridSearch] Weights that control how reciprocal rank fusion balances semantic embedding matc
+          #   @param hybrid_search [OpenAI::Models::Responses::FileSearchTool::RankingOptions::HybridSearch]
+          #     Weights that control how reciprocal rank fusion balances semantic embedding
+          #     matches versus sparse keyword matches when hybrid search is enabled.
           #
-          #   @param ranker [Symbol, OpenAI::Models::Responses::FileSearchTool::RankingOptions::Ranker] The ranker to use for the file search.
+          #   @param ranker [Symbol, OpenAI::Models::Responses::FileSearchTool::RankingOptions::Ranker]
+          #     The ranker to use for the file search.
           #
-          #   @param score_threshold [Float] The score threshold for the file search, a number between 0 and 1. Numbers close
+          #   @param score_threshold [Float]
+          #     The score threshold for the file search, a number between 0 and 1. Numbers
+          #     closer to 1 will attempt to return only the most relevant results, but may
+          #     return fewer results.
 
           # @see OpenAI::Models::Responses::FileSearchTool::RankingOptions#hybrid_search
           class HybridSearch < OpenAI::Internal::Type::BaseModel
@@ -122,9 +128,11 @@ module OpenAI
             #   Weights that control how reciprocal rank fusion balances semantic embedding
             #   matches versus sparse keyword matches when hybrid search is enabled.
             #
-            #   @param embedding_weight [Float] The weight of the embedding in the reciprocal ranking fusion.
+            #   @param embedding_weight [Float]
+            #     The weight of the embedding in the reciprocal ranking fusion.
             #
-            #   @param text_weight [Float] The weight of the text in the reciprocal ranking fusion.
+            #   @param text_weight [Float]
+            #     The weight of the text in the reciprocal ranking fusion.
           end
 
           # The ranker to use for the file search.

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

@@ -30,12 +30,13 @@ module OpenAI
         # @!method initialize(allowed_callers: nil, environment: nil, type: :shell)
         #   A tool that allows the model to execute shell commands.
         #
-        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Responses::FunctionShellTool::AllowedCaller>, nil] The tool invocation context(s).
+        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Responses::FunctionShellTool::AllowedCaller>, nil]
+        #     The tool invocation context(s).
         #
         #   @param environment [OpenAI::Models::Responses::ContainerAuto, OpenAI::Models::Responses::LocalEnvironment, OpenAI::Models::Responses::ContainerReference, nil]
         #
-        #   @param type [Symbol, :shell] The type of the shell tool. Always `shell`.
-
+        #   @param type [Symbol, :shell]
+        #     The type of the shell tool. Always `shell`.
         module AllowedCaller
           extend OpenAI::Internal::Type::Enum
 

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

@@ -71,31 +71,37 @@ module OpenAI
         optional :output_schema, OpenAI::Internal::Type::HashOf[OpenAI::Internal::Type::Unknown], nil?: true
 
         # @!method initialize(name:, parameters:, strict:, allowed_callers: nil, async: nil, defer_loading: nil, description: nil, output_schema: nil, type: :function)
-        #   Some parameter documentations has been truncated, see
-        #   {OpenAI::Models::Responses::FunctionTool} for more details.
-        #
         #   Defines a function in your own code the model can choose to call. Learn more
         #   about
-        #   [function calling](https://platform.openai.com/docs/guides/function-calling).
+        #   [function calling](https://developers.openai.com/api/docs/guides/function-calling).
         #
-        #   @param name [String] The name of the function to call.
+        #   @param name [String]
+        #     The name of the function to call.
         #
-        #   @param parameters [Hash{Symbol=>Object}, nil] A JSON schema object describing the parameters of the function.
+        #   @param parameters [Hash{Symbol=>Object}, nil]
+        #     A JSON schema object describing the parameters of the function.
         #
-        #   @param strict [Boolean, nil] Whether strict parameter validation is enforced for this function tool.
+        #   @param strict [Boolean, nil]
+        #     Whether strict parameter validation is enforced for this function tool.
         #
-        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Responses::FunctionTool::AllowedCaller>, nil] The tool invocation context(s).
+        #   @param allowed_callers [Array<Symbol, OpenAI::Models::Responses::FunctionTool::AllowedCaller>, nil]
+        #     The tool invocation context(s).
         #
         #   @param async [Boolean]
         #
-        #   @param defer_loading [Boolean] Whether this function is deferred and loaded via tool search.
+        #   @param defer_loading [Boolean]
+        #     Whether this function is deferred and loaded via tool search.
         #
-        #   @param description [String, nil] A description of the function. Used by the model to determine whether or not to
+        #   @param description [String, nil]
+        #     A description of the function. Used by the model to determine whether or not to
+        #     call the function.
         #
-        #   @param output_schema [Hash{Symbol=>Object}, nil] A JSON schema object describing the JSON value encoded in string outputs for thi
+        #   @param output_schema [Hash{Symbol=>Object}, nil]
+        #     A JSON schema object describing the JSON value encoded in string outputs for
+        #     this function.
         #
-        #   @param type [Symbol, :function] The type of the function tool. Always `function`.
-
+        #   @param type [Symbol, :function]
+        #     The type of the function tool. Always `function`.
         module AllowedCaller
           extend OpenAI::Internal::Type::Enum
 

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

@@ -29,13 +29,17 @@ module OpenAI
         required :type, const: :inline
 
         # @!method initialize(description:, name:, source:, type: :inline)
-        #   @param description [String] The description of the skill.
+        #   @param description [String]
+        #     The description of the skill.
         #
-        #   @param name [String] The name of the skill.
+        #   @param name [String]
+        #     The name of the skill.
         #
-        #   @param source [OpenAI::Models::Responses::InlineSkillSource] Inline skill payload
+        #   @param source [OpenAI::Models::Responses::InlineSkillSource]
+        #     Inline skill payload
         #
-        #   @param type [Symbol, :inline] Defines an inline skill for this request.
+        #   @param type [Symbol, :inline]
+        #     Defines an inline skill for this request.
       end
     end
   end

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

@@ -25,11 +25,14 @@ module OpenAI
         # @!method initialize(data:, media_type: :"application/zip", type: :base64)
         #   Inline skill payload
         #
-        #   @param data [String] Base64-encoded skill zip bundle.
+        #   @param data [String]
+        #     Base64-encoded skill zip bundle.
         #
-        #   @param media_type [Symbol, :"application/zip"] The media type of the inline skill payload. Must be `application/zip`.
+        #   @param media_type [Symbol, :"application/zip"]
+        #     The media type of the inline skill payload. Must be `application/zip`.
         #
-        #   @param type [Symbol, :base64] The type of the inline skill source. Must be `base64`.
+        #   @param type [Symbol, :base64]
+        #     The type of the inline skill source. Must be `base64`.
       end
     end
   end