openai 0.87.0 → 0.89.0

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

@@ -29,22 +29,22 @@ module OpenAI
         variant :message, -> { OpenAI::Responses::ResponseOutputMessage }
 
         # The results of a file search tool call. See the
-        # [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more information.
+        # [file search guide](https://developers.openai.com/api/docs/guides/tools-file-search) for more information.
         variant :file_search_call, -> { OpenAI::Responses::ResponseFileSearchToolCall }
 
         # A tool call to a computer use tool. See the
-        # [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more information.
+        # [computer use guide](https://developers.openai.com/api/docs/guides/tools-computer-use) for more information.
         variant :computer_call, -> { OpenAI::Responses::ResponseComputerToolCall }
 
         # The output of a computer tool call.
         variant :computer_call_output, -> { OpenAI::Responses::ResponseInputItem::ComputerCallOutput }
 
         # The results of a web search tool call. See the
-        # [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more information.
+        # [web search guide](https://developers.openai.com/api/docs/guides/tools-web-search) for more information.
         variant :web_search_call, -> { OpenAI::Responses::ResponseFunctionWebSearch }
 
         # A tool call to run a function. See the
-        # [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more information.
+        # [function calling guide](https://developers.openai.com/api/docs/guides/function-calling) for more information.
         variant :function_call, -> { OpenAI::Responses::ResponseFunctionToolCall }
 
         # The output of a function tool call.
@@ -64,10 +64,10 @@ module OpenAI
         # A description of the chain of thought used by a reasoning model while generating
         # a response. Be sure to include these items in your `input` to the Responses API
         # for subsequent turns of a conversation if you are manually
-        # [managing context](https://platform.openai.com/docs/guides/conversation-state).
+        # [managing context](https://developers.openai.com/api/docs/guides/conversation-state).
         variant :reasoning, -> { OpenAI::Responses::ResponseReasoningItem }
 
-        # A compaction item generated by the [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+        # A compaction item generated by the [`v1/responses/compact` API](https://developers.openai.com/api/reference/resources/responses/methods/compact).
         variant :compaction, -> { OpenAI::Responses::ResponseCompactionItemParam }
 
         # An image generation request made by the model.
@@ -150,20 +150,23 @@ module OpenAI
           optional :type, enum: -> { OpenAI::Responses::ResponseInputItem::Message::Type }
 
           # @!method initialize(content:, role:, status: nil, type: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::Message} 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.
           #
-          #   @param content [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>] A list of one or many input items to the model, containing different content
+          #   @param content [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>]
+          #     A list of one or many input items to the model, containing different content
+          #     types.
           #
-          #   @param role [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Role] The role of the message input. One of `user`, `system`, or `developer`.
+          #   @param role [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Role]
+          #     The role of the message input. One of `user`, `system`, or `developer`.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Status] The status of item. One of `in_progress`, `completed`, or
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Status]
+          #     The status of item. One of `in_progress`, `completed`, or `incomplete`.
+          #     Populated when items are returned via API.
           #
-          #   @param type [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Type] The type of the message input. Always set to `message`.
+          #   @param type [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Type]
+          #     The type of the message input. Always set to `message`.
 
           # The role of the message input. One of `user`, `system`, or `developer`.
           #
@@ -259,24 +262,27 @@ module OpenAI
           )
 
           # @!method initialize(call_id:, output:, id: nil, acknowledged_safety_checks: nil, status: nil, type: :computer_call_output)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput} for more
-          #   details.
-          #
           #   The output of a computer tool call.
           #
-          #   @param call_id [String] The ID of the computer tool call that produced the output.
+          #   @param call_id [String]
+          #     The ID of the computer tool call that produced the output.
           #
-          #   @param output [OpenAI::Models::Responses::ResponseComputerToolCallOutputScreenshot] A computer screenshot image used with the computer use tool.
+          #   @param output [OpenAI::Models::Responses::ResponseComputerToolCallOutputScreenshot]
+          #     A computer screenshot image used with the computer use tool.
           #
-          #   @param id [String, nil] The ID of the computer tool call output.
+          #   @param id [String, nil]
+          #     The ID of the computer tool call output.
           #
-          #   @param acknowledged_safety_checks [Array<OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput::AcknowledgedSafetyCheck>, nil] The safety checks reported by the API that have been acknowledged by the develop
+          #   @param acknowledged_safety_checks [Array<OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput::AcknowledgedSafetyCheck>, nil]
+          #     The safety checks reported by the API that have been acknowledged by the
+          #     developer.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput::Status, nil] The status of the message input. One of `in_progress`, `completed`, or `incomple
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput::Status, nil]
+          #     The status of the message input. One of `in_progress`, `completed`, or
+          #     `incomplete`. Populated when input items are returned via API.
           #
-          #   @param type [Symbol, :computer_call_output] The type of the computer tool call output. Always `computer_call_output`.
-
+          #   @param type [Symbol, :computer_call_output]
+          #     The type of the computer tool call output. Always `computer_call_output`.
           class AcknowledgedSafetyCheck < OpenAI::Internal::Type::BaseModel
             # @!attribute id
             #   The ID of the pending safety check.
@@ -299,11 +305,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 message input. One of `in_progress`, `completed`, or
@@ -383,27 +392,33 @@ module OpenAI
           )
 
           # @!method initialize(output:, id: nil, call_id: nil, caller_: nil, name: nil, namespace: nil, status: nil, type: :function_call_output)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput} for more
-          #   details.
-          #
           #   The output of a function tool call.
           #
-          #   @param output [String, Array<OpenAI::Models::Responses::ResponseInputTextContent, OpenAI::Models::Responses::ResponseInputImageContent, OpenAI::Models::Responses::ResponseInputFileContent>] Text, image, or file output of the function tool call.
+          #   @param output [String, Array<OpenAI::Models::Responses::ResponseInputTextContent, OpenAI::Models::Responses::ResponseInputImageContent, OpenAI::Models::Responses::ResponseInputFileContent>]
+          #     Text, image, or file output of the function tool call.
           #
-          #   @param id [String, nil] The unique ID of the function tool call output. Populated when this item is retu
+          #   @param id [String, nil]
+          #     The unique ID of the function tool call output. Populated when this item is
+          #     returned via API.
           #
-          #   @param call_id [String, nil] The unique ID of the function tool call generated by the model.
+          #   @param call_id [String, nil]
+          #     The unique ID of the function tool call generated by the model.
           #
-          #   @param caller_ [OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput::Caller::Direct, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput::Caller::Program, nil] The execution context that produced this tool call.
+          #   @param caller_ [OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput::Caller::Direct, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput::Caller::Program, nil]
+          #     The execution context that produced this tool call.
           #
-          #   @param name [String, nil] The name of the tool that produced the output.
+          #   @param name [String, nil]
+          #     The name of the tool that produced the output.
           #
-          #   @param namespace [String, nil] The namespace of the tool that produced the output.
+          #   @param namespace [String, nil]
+          #     The namespace of the tool that produced the output.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput::Status, nil] The status of the item. One of `in_progress`, `completed`, or `incomplete`. Popu
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput::Status, nil]
+          #     The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          #     Populated when items are returned via API.
           #
-          #   @param type [Symbol, :function_call_output] The type of the function tool call output. Always `function_call_output`.
+          #   @param type [Symbol, :function_call_output]
+          #     The type of the function tool call output. Always `function_call_output`.
 
           # Text, image, or file output of the function tool call.
           #
@@ -441,7 +456,8 @@ module OpenAI
               required :type, const: :direct
 
               # @!method initialize(type: :direct)
-              #   @param type [Symbol, :direct] The caller type. Always `direct`.
+              #   @param type [Symbol, :direct]
+              #     The caller type. Always `direct`.
             end
 
             class Program < OpenAI::Internal::Type::BaseModel
@@ -458,9 +474,11 @@ module OpenAI
               required :type, const: :program
 
               # @!method initialize(caller_id:, type: :program)
-              #   @param caller_id [String] The call ID of the program item that produced this tool call.
+              #   @param caller_id [String]
+              #     The call ID of the program item that produced this tool call.
               #
-              #   @param type [Symbol, :program] The caller type. Always `program`.
+              #   @param type [Symbol, :program]
+              #     The caller type. Always `program`.
             end
 
             # @!method self.variants
@@ -527,17 +545,23 @@ module OpenAI
           )
 
           # @!method initialize(arguments:, id: nil, call_id: nil, execution: nil, status: nil, type: :tool_search_call)
-          #   @param arguments [Object] The arguments supplied to the tool search call.
+          #   @param arguments [Object]
+          #     The arguments supplied to the tool search call.
           #
-          #   @param id [String, nil] The unique ID of this tool search call.
+          #   @param id [String, nil]
+          #     The unique ID of this tool search call.
           #
-          #   @param call_id [String, nil] The unique ID of the tool search call generated by the model.
+          #   @param call_id [String, nil]
+          #     The unique ID of the tool search call generated by the model.
           #
-          #   @param execution [Symbol, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall::Execution] Whether tool search was executed by the server or by the client.
+          #   @param execution [Symbol, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall::Execution]
+          #     Whether tool search was executed by the server or by the client.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall::Status, nil] The status of the tool search call.
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall::Status, nil]
+          #     The status of the tool search call.
           #
-          #   @param type [Symbol, :tool_search_call] The item type. Always `tool_search_call`.
+          #   @param type [Symbol, :tool_search_call]
+          #     The item type. Always `tool_search_call`.
 
           # Whether tool search was executed by the server or by the client.
           #
@@ -593,13 +617,17 @@ module OpenAI
           optional :id, String, nil?: true
 
           # @!method initialize(tools:, id: nil, role: :developer, type: :additional_tools)
-          #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>] A list of additional tools made available at this item.
+          #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>]
+          #     A list of additional tools made available at this item.
           #
-          #   @param id [String, nil] The unique ID of this additional tools item.
+          #   @param id [String, nil]
+          #     The unique ID of this additional tools item.
           #
-          #   @param role [Symbol, :developer] The role that provided the additional tools. Only `developer` is supported.
+          #   @param role [Symbol, :developer]
+          #     The role that provided the additional tools. Only `developer` is supported.
           #
-          #   @param type [Symbol, :additional_tools] The item type. Always `additional_tools`.
+          #   @param type [Symbol, :additional_tools]
+          #     The item type. Always `additional_tools`.
         end
 
         class ImageGenerationCall < OpenAI::Internal::Type::BaseModel
@@ -627,6 +655,36 @@ module OpenAI
           #   @return [Symbol, :image_generation_call]
           required :type, const: :image_generation_call
 
+          # @!attribute action
+          #   The action used for image generation.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::Action, nil]
+          optional(
+            :action,
+            enum: -> { OpenAI::Responses::ResponseInputItem::ImageGenerationCall::Action },
+            nil?: true
+          )
+
+          # @!attribute background
+          #   The background setting used for generation.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::Background, nil]
+          optional(
+            :background,
+            enum: -> { OpenAI::Responses::ResponseInputItem::ImageGenerationCall::Background },
+            nil?: true
+          )
+
+          # @!attribute output_format
+          #   The output format used for generation.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::OutputFormat, nil]
+          optional(
+            :output_format,
+            enum: -> { OpenAI::Responses::ResponseInputItem::ImageGenerationCall::OutputFormat },
+            nil?: true
+          )
+
           # @!attribute quality
           #   The quality of the image generated by the image generation tool call. One of
           #   `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
@@ -638,6 +696,12 @@ module OpenAI
             nil?: true
           )
 
+          # @!attribute revised_prompt
+          #   The prompt that was used after any model prompt rewriting.
+          #
+          #   @return [String, nil]
+          optional :revised_prompt, String, nil?: true
+
           # @!attribute size
           #   The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
           #
@@ -650,24 +714,39 @@ module OpenAI
             nil?: true
           )
 
-          # @!method initialize(id:, result:, status:, quality: nil, size: nil, type: :image_generation_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall} for more
-          #   details.
-          #
+          # @!method initialize(id:, result:, status:, action: nil, background: nil, output_format: nil, quality: nil, revised_prompt: nil, size: nil, type: :image_generation_call)
           #   An image generation request made by the model.
           #
-          #   @param id [String] The unique ID of the image generation call.
+          #   @param id [String]
+          #     The unique ID of the image generation call.
+          #
+          #   @param result [String, nil]
+          #     The generated image encoded in base64.
+          #
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::Status]
+          #     The status of the image generation call.
           #
-          #   @param result [String, nil] The generated image encoded in base64.
+          #   @param action [Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::Action, nil]
+          #     The action used for image generation.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::Status] The status of the image generation call.
+          #   @param background [Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::Background, nil]
+          #     The background setting used for generation.
           #
-          #   @param quality [Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::Quality, nil] The quality of the image generated by the image generation tool call. One of `lo
+          #   @param output_format [Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::OutputFormat, nil]
+          #     The output format used for generation.
           #
-          #   @param size [String, Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::Size, nil] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #   @param quality [Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::Quality, nil]
+          #     The quality of the image generated by the image generation tool call. One of
+          #     `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
           #
-          #   @param type [Symbol, :image_generation_call] The type of the image generation call. Always `image_generation_call`.
+          #   @param revised_prompt [String, nil]
+          #     The prompt that was used after any model prompt rewriting.
+          #
+          #   @param size [String, Symbol, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall::Size, nil]
+          #     The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #
+          #   @param type [Symbol, :image_generation_call]
+          #     The type of the image generation call. Always `image_generation_call`.
 
           # The status of the image generation call.
           #
@@ -684,6 +763,48 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
 
+          # The action used for image generation.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall#action
+          module Action
+            extend OpenAI::Internal::Type::Enum
+
+            GENERATE = :generate
+            EDIT = :edit
+            AUTO = :auto
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The background setting used for generation.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall#background
+          module Background
+            extend OpenAI::Internal::Type::Enum
+
+            TRANSPARENT = :transparent
+            OPAQUE = :opaque
+            AUTO = :auto
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The output format used for generation.
+          #
+          # @see OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall#output_format
+          module OutputFormat
+            extend OpenAI::Internal::Type::Enum
+
+            PNG = :png
+            WEBP = :webp
+            JPEG = :jpeg
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # The quality of the image generated by the image generation tool call. One of
           # `low`, `medium`, `high`, `xhigh`, `max`, or `auto`.
           #
@@ -773,20 +894,22 @@ module OpenAI
           required :type, const: :local_shell_call
 
           # @!method initialize(id:, action:, call_id:, status:, type: :local_shell_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::LocalShellCall} for more details.
-          #
           #   A tool call to run a command on the local shell.
           #
-          #   @param id [String] The unique ID of the local shell call.
+          #   @param id [String]
+          #     The unique ID of the local shell call.
           #
-          #   @param action [OpenAI::Models::Responses::ResponseInputItem::LocalShellCall::Action] Execute a shell command on the server.
+          #   @param action [OpenAI::Models::Responses::ResponseInputItem::LocalShellCall::Action]
+          #     Execute a shell command on the server.
           #
-          #   @param call_id [String] The unique ID of the local shell tool call generated by the model.
+          #   @param call_id [String]
+          #     The unique ID of the local shell tool call generated by the model.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall::Status] The status of the local shell call.
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall::Status]
+          #     The status of the local shell call.
           #
-          #   @param type [Symbol, :local_shell_call] The type of the local shell call. Always `local_shell_call`.
+          #   @param type [Symbol, :local_shell_call]
+          #     The type of the local shell call. Always `local_shell_call`.
 
           # @see OpenAI::Models::Responses::ResponseInputItem::LocalShellCall#action
           class Action < OpenAI::Internal::Type::BaseModel
@@ -829,17 +952,23 @@ module OpenAI
             # @!method initialize(command:, env:, timeout_ms: nil, user: nil, working_directory: nil, type: :exec)
             #   Execute a shell command on the server.
             #
-            #   @param command [Array<String>] The command to run.
+            #   @param command [Array<String>]
+            #     The command to run.
             #
-            #   @param env [Hash{Symbol=>String}] Environment variables to set for the command.
+            #   @param env [Hash{Symbol=>String}]
+            #     Environment variables to set for the command.
             #
-            #   @param timeout_ms [Integer, nil] Optional timeout in milliseconds for the command.
+            #   @param timeout_ms [Integer, nil]
+            #     Optional timeout in milliseconds for the command.
             #
-            #   @param user [String, nil] Optional user to run the command as.
+            #   @param user [String, nil]
+            #     Optional user to run the command as.
             #
-            #   @param working_directory [String, nil] Optional working directory to run the command in.
+            #   @param working_directory [String, nil]
+            #     Optional working directory to run the command in.
             #
-            #   @param type [Symbol, :exec] The type of the local shell action. Always `exec`.
+            #   @param type [Symbol, :exec]
+            #     The type of the local shell action. Always `exec`.
           end
 
           # The status of the local shell call.
@@ -887,19 +1016,19 @@ module OpenAI
           )
 
           # @!method initialize(id:, output:, status: nil, type: :local_shell_call_output)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput} for more
-          #   details.
-          #
           #   The output of a local shell tool call.
           #
-          #   @param id [String] The unique ID of the local shell tool call generated by the model.
+          #   @param id [String]
+          #     The unique ID of the local shell tool call generated by the model.
           #
-          #   @param output [String] A JSON string of the output of the local shell tool call.
+          #   @param output [String]
+          #     A JSON string of the output of the local shell tool call.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput::Status, nil] The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput::Status, nil]
+          #     The status of the item. One of `in_progress`, `completed`, or `incomplete`.
           #
-          #   @param type [Symbol, :local_shell_call_output] The type of the local shell tool call output. Always `local_shell_call_output`.
+          #   @param type [Symbol, :local_shell_call_output]
+          #     The type of the local shell tool call output. Always `local_shell_call_output`.
 
           # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
           #
@@ -971,24 +1100,30 @@ module OpenAI
           optional :status, enum: -> { OpenAI::Responses::ResponseInputItem::ShellCall::Status }, nil?: true
 
           # @!method initialize(action:, call_id:, id: nil, caller_: nil, environment: nil, status: nil, type: :shell_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::ShellCall} for more details.
-          #
           #   A tool representing a request to execute one or more shell commands.
           #
-          #   @param action [OpenAI::Models::Responses::ResponseInputItem::ShellCall::Action] The shell commands and limits that describe how to run the tool call.
+          #   @param action [OpenAI::Models::Responses::ResponseInputItem::ShellCall::Action]
+          #     The shell commands and limits that describe how to run the tool call.
           #
-          #   @param call_id [String] The unique ID of the shell tool call generated by the model.
+          #   @param call_id [String]
+          #     The unique ID of the shell tool call generated by the model.
           #
-          #   @param id [String, nil] The unique ID of the shell tool call. Populated when this item is returned via A
+          #   @param id [String, nil]
+          #     The unique ID of the shell tool call. Populated when this item is returned via
+          #     API.
           #
-          #   @param caller_ [OpenAI::Models::Responses::ResponseInputItem::ShellCall::Caller::Direct, OpenAI::Models::Responses::ResponseInputItem::ShellCall::Caller::Program, nil] The execution context that produced this tool call.
+          #   @param caller_ [OpenAI::Models::Responses::ResponseInputItem::ShellCall::Caller::Direct, OpenAI::Models::Responses::ResponseInputItem::ShellCall::Caller::Program, nil]
+          #     The execution context that produced this tool call.
           #
-          #   @param environment [OpenAI::Models::Responses::LocalEnvironment, OpenAI::Models::Responses::ContainerReference, nil] The environment to execute the shell commands in.
+          #   @param environment [OpenAI::Models::Responses::LocalEnvironment, OpenAI::Models::Responses::ContainerReference, nil]
+          #     The environment to execute the shell commands in.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ShellCall::Status, nil] The status of the shell call. One of `in_progress`, `completed`, or `incomplete`
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ShellCall::Status, nil]
+          #     The status of the shell call. One of `in_progress`, `completed`, or
+          #     `incomplete`.
           #
-          #   @param type [Symbol, :shell_call] The type of the item. Always `shell_call`.
+          #   @param type [Symbol, :shell_call]
+          #     The type of the item. Always `shell_call`.
 
           # @see OpenAI::Models::Responses::ResponseInputItem::ShellCall#action
           class Action < OpenAI::Internal::Type::BaseModel
@@ -1012,17 +1147,17 @@ module OpenAI
             optional :timeout_ms, Integer, nil?: true
 
             # @!method initialize(commands:, max_output_length: nil, timeout_ms: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseInputItem::ShellCall::Action} for more
-            #   details.
-            #
             #   The shell commands and limits that describe how to run the tool call.
             #
-            #   @param commands [Array<String>] Ordered shell commands for the execution environment to run.
+            #   @param commands [Array<String>]
+            #     Ordered shell commands for the execution environment to run.
             #
-            #   @param max_output_length [Integer, nil] Maximum number of UTF-8 characters to capture from combined stdout and stderr ou
+            #   @param max_output_length [Integer, nil]
+            #     Maximum number of UTF-8 characters to capture from combined stdout and stderr
+            #     output.
             #
-            #   @param timeout_ms [Integer, nil] Maximum wall-clock time in milliseconds to allow the shell commands to run.
+            #   @param timeout_ms [Integer, nil]
+            #     Maximum wall-clock time in milliseconds to allow the shell commands to run.
           end
 
           # The execution context that produced this tool call.
@@ -1045,7 +1180,8 @@ module OpenAI
               required :type, const: :direct
 
               # @!method initialize(type: :direct)
-              #   @param type [Symbol, :direct] The caller type. Always `direct`.
+              #   @param type [Symbol, :direct]
+              #     The caller type. Always `direct`.
             end
 
             class Program < OpenAI::Internal::Type::BaseModel
@@ -1062,9 +1198,11 @@ module OpenAI
               required :type, const: :program
 
               # @!method initialize(caller_id:, type: :program)
-              #   @param caller_id [String] The call ID of the program item that produced this tool call.
+              #   @param caller_id [String]
+              #     The call ID of the program item that produced this tool call.
               #
-              #   @param type [Symbol, :program] The caller type. Always `program`.
+              #   @param type [Symbol, :program]
+              #     The caller type. Always `program`.
             end
 
             # @!method self.variants
@@ -1164,25 +1302,31 @@ module OpenAI
           )
 
           # @!method initialize(call_id:, output:, id: nil, caller_: nil, max_output_length: nil, status: nil, type: :shell_call_output)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput} for more
-          #   details.
-          #
           #   The streamed output items emitted by a shell tool call.
           #
-          #   @param call_id [String] The unique ID of the shell tool call generated by the model.
+          #   @param call_id [String]
+          #     The unique ID of the shell tool call generated by the model.
           #
-          #   @param output [Array<OpenAI::Models::Responses::ResponseFunctionShellCallOutputContent>] Captured chunks of stdout and stderr output, along with their associated outcome
+          #   @param output [Array<OpenAI::Models::Responses::ResponseFunctionShellCallOutputContent>]
+          #     Captured chunks of stdout and stderr output, along with their associated
+          #     outcomes.
           #
-          #   @param id [String, nil] The unique ID of the shell tool call output. Populated when this item is returne
+          #   @param id [String, nil]
+          #     The unique ID of the shell tool call output. Populated when this item is
+          #     returned via API.
           #
-          #   @param caller_ [OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput::Caller::Direct, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput::Caller::Program, nil] The execution context that produced this tool call.
+          #   @param caller_ [OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput::Caller::Direct, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput::Caller::Program, nil]
+          #     The execution context that produced this tool call.
           #
-          #   @param max_output_length [Integer, nil] The maximum number of UTF-8 characters captured for this shell call's combined o
+          #   @param max_output_length [Integer, nil]
+          #     The maximum number of UTF-8 characters captured for this shell call's combined
+          #     output.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput::Status, nil] The status of the shell call output.
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput::Status, nil]
+          #     The status of the shell call output.
           #
-          #   @param type [Symbol, :shell_call_output] The type of the item. Always `shell_call_output`.
+          #   @param type [Symbol, :shell_call_output]
+          #     The type of the item. Always `shell_call_output`.
 
           # The execution context that produced this tool call.
           #
@@ -1204,7 +1348,8 @@ module OpenAI
               required :type, const: :direct
 
               # @!method initialize(type: :direct)
-              #   @param type [Symbol, :direct] The caller type. Always `direct`.
+              #   @param type [Symbol, :direct]
+              #     The caller type. Always `direct`.
             end
 
             class Program < OpenAI::Internal::Type::BaseModel
@@ -1221,9 +1366,11 @@ module OpenAI
               required :type, const: :program
 
               # @!method initialize(caller_id:, type: :program)
-              #   @param caller_id [String] The call ID of the program item that produced this tool call.
+              #   @param caller_id [String]
+              #     The call ID of the program item that produced this tool call.
               #
-              #   @param type [Symbol, :program] The caller type. Always `program`.
+              #   @param type [Symbol, :program]
+              #     The caller type. Always `program`.
             end
 
             # @!method self.variants
@@ -1290,23 +1437,28 @@ module OpenAI
           )
 
           # @!method initialize(call_id:, operation:, status:, id: nil, caller_: nil, type: :apply_patch_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall} for more details.
-          #
           #   A tool call representing a request to create, delete, or update files using diff
           #   patches.
           #
-          #   @param call_id [String] The unique ID of the apply patch tool call generated by the model.
+          #   @param call_id [String]
+          #     The unique ID of the apply patch tool call generated by the model.
           #
-          #   @param operation [OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Operation::CreateFile, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Operation::DeleteFile, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Operation::UpdateFile] The specific create, delete, or update instruction for the apply_patch tool call
+          #   @param operation [OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Operation::CreateFile, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Operation::DeleteFile, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Operation::UpdateFile]
+          #     The specific create, delete, or update instruction for the apply_patch tool
+          #     call.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Status] The status of the apply patch tool call. One of `in_progress` or `completed`.
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Status]
+          #     The status of the apply patch tool call. One of `in_progress` or `completed`.
           #
-          #   @param id [String, nil] The unique ID of the apply patch tool call. Populated when this item is returned
+          #   @param id [String, nil]
+          #     The unique ID of the apply patch tool call. Populated when this item is returned
+          #     via API.
           #
-          #   @param caller_ [OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Caller::Direct, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Caller::Program, nil] The execution context that produced this tool call.
+          #   @param caller_ [OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Caller::Direct, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall::Caller::Program, nil]
+          #     The execution context that produced this tool call.
           #
-          #   @param type [Symbol, :apply_patch_call] The type of the item. Always `apply_patch_call`.
+          #   @param type [Symbol, :apply_patch_call]
+          #     The type of the item. Always `apply_patch_call`.
 
           # The specific create, delete, or update instruction for the apply_patch tool
           # call.
@@ -1348,11 +1500,14 @@ module OpenAI
               # @!method initialize(diff:, path:, type: :create_file)
               #   Instruction for creating a new file via the apply_patch tool.
               #
-              #   @param diff [String] Unified diff content to apply when creating the file.
+              #   @param diff [String]
+              #     Unified diff content to apply when creating the file.
               #
-              #   @param path [String] Path of the file to create relative to the workspace root.
+              #   @param path [String]
+              #     Path of the file to create relative to the workspace root.
               #
-              #   @param type [Symbol, :create_file] The operation type. Always `create_file`.
+              #   @param type [Symbol, :create_file]
+              #     The operation type. Always `create_file`.
             end
 
             class DeleteFile < OpenAI::Internal::Type::BaseModel
@@ -1371,9 +1526,11 @@ module OpenAI
               # @!method initialize(path:, type: :delete_file)
               #   Instruction for deleting an existing file via the apply_patch tool.
               #
-              #   @param path [String] Path of the file to delete relative to the workspace root.
+              #   @param path [String]
+              #     Path of the file to delete relative to the workspace root.
               #
-              #   @param type [Symbol, :delete_file] The operation type. Always `delete_file`.
+              #   @param type [Symbol, :delete_file]
+              #     The operation type. Always `delete_file`.
             end
 
             class UpdateFile < OpenAI::Internal::Type::BaseModel
@@ -1398,11 +1555,14 @@ module OpenAI
               # @!method initialize(diff:, path:, type: :update_file)
               #   Instruction for updating an existing file via the apply_patch tool.
               #
-              #   @param diff [String] Unified diff content to apply to the existing file.
+              #   @param diff [String]
+              #     Unified diff content to apply to the existing file.
               #
-              #   @param path [String] Path of the file to update relative to the workspace root.
+              #   @param path [String]
+              #     Path of the file to update relative to the workspace root.
               #
-              #   @param type [Symbol, :update_file] The operation type. Always `update_file`.
+              #   @param type [Symbol, :update_file]
+              #     The operation type. Always `update_file`.
             end
 
             # @!method self.variants
@@ -1442,7 +1602,8 @@ module OpenAI
               required :type, const: :direct
 
               # @!method initialize(type: :direct)
-              #   @param type [Symbol, :direct] The caller type. Always `direct`.
+              #   @param type [Symbol, :direct]
+              #     The caller type. Always `direct`.
             end
 
             class Program < OpenAI::Internal::Type::BaseModel
@@ -1459,9 +1620,11 @@ module OpenAI
               required :type, const: :program
 
               # @!method initialize(caller_id:, type: :program)
-              #   @param caller_id [String] The call ID of the program item that produced this tool call.
+              #   @param caller_id [String]
+              #     The call ID of the program item that produced this tool call.
               #
-              #   @param type [Symbol, :program] The caller type. Always `program`.
+              #   @param type [Symbol, :program]
+              #     The caller type. Always `program`.
             end
 
             # @!method self.variants
@@ -1514,23 +1677,27 @@ module OpenAI
           optional :output, String, nil?: true
 
           # @!method initialize(call_id:, status:, id: nil, caller_: nil, output: nil, type: :apply_patch_call_output)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput} for more
-          #   details.
-          #
           #   The streamed output emitted by an apply patch tool call.
           #
-          #   @param call_id [String] The unique ID of the apply patch tool call generated by the model.
+          #   @param call_id [String]
+          #     The unique ID of the apply patch tool call generated by the model.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput::Status] The status of the apply patch tool call output. One of `completed` or `failed`.
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput::Status]
+          #     The status of the apply patch tool call output. One of `completed` or `failed`.
           #
-          #   @param id [String, nil] The unique ID of the apply patch tool call output. Populated when this item is r
+          #   @param id [String, nil]
+          #     The unique ID of the apply patch tool call output. Populated when this item is
+          #     returned via API.
           #
-          #   @param caller_ [OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput::Caller::Direct, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput::Caller::Program, nil] The execution context that produced this tool call.
+          #   @param caller_ [OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput::Caller::Direct, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput::Caller::Program, nil]
+          #     The execution context that produced this tool call.
           #
-          #   @param output [String, nil] Optional human-readable log text from the apply patch tool (e.g., patch results
+          #   @param output [String, nil]
+          #     Optional human-readable log text from the apply patch tool (e.g., patch results
+          #     or errors).
           #
-          #   @param type [Symbol, :apply_patch_call_output] The type of the item. Always `apply_patch_call_output`.
+          #   @param type [Symbol, :apply_patch_call_output]
+          #     The type of the item. Always `apply_patch_call_output`.
 
           # The status of the apply patch tool call output. One of `completed` or `failed`.
           #
@@ -1565,7 +1732,8 @@ module OpenAI
               required :type, const: :direct
 
               # @!method initialize(type: :direct)
-              #   @param type [Symbol, :direct] The caller type. Always `direct`.
+              #   @param type [Symbol, :direct]
+              #     The caller type. Always `direct`.
             end
 
             class Program < OpenAI::Internal::Type::BaseModel
@@ -1582,9 +1750,11 @@ module OpenAI
               required :type, const: :program
 
               # @!method initialize(caller_id:, type: :program)
-              #   @param caller_id [String] The call ID of the program item that produced this tool call.
+              #   @param caller_id [String]
+              #     The call ID of the program item that produced this tool call.
               #
-              #   @param type [Symbol, :program] The caller type. Always `program`.
+              #   @param type [Symbol, :program]
+              #     The caller type. Always `program`.
             end
 
             # @!method self.variants
@@ -1627,21 +1797,22 @@ module OpenAI
           optional :error, String, nil?: true
 
           # @!method initialize(id:, server_label:, tools:, error: nil, type: :mcp_list_tools)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::McpListTools} for more details.
-          #
           #   A list of tools available on an MCP server.
           #
-          #   @param id [String] The unique ID of the list.
+          #   @param id [String]
+          #     The unique ID of the list.
           #
-          #   @param server_label [String] The label of the MCP server.
+          #   @param server_label [String]
+          #     The label of the MCP server.
           #
-          #   @param tools [Array<OpenAI::Models::Responses::ResponseInputItem::McpListTools::Tool>] The tools available on the server.
+          #   @param tools [Array<OpenAI::Models::Responses::ResponseInputItem::McpListTools::Tool>]
+          #     The tools available on the server.
           #
-          #   @param error [String, nil] Error message if the server could not list tools.
+          #   @param error [String, nil]
+          #     Error message if the server could not list tools.
           #
-          #   @param type [Symbol, :mcp_list_tools] The type of the item. Always `mcp_list_tools`.
-
+          #   @param type [Symbol, :mcp_list_tools]
+          #     The type of the item. Always `mcp_list_tools`.
           class Tool < OpenAI::Internal::Type::BaseModel
             # @!attribute input_schema
             #   The JSON schema describing the tool's input.
@@ -1668,19 +1839,19 @@ module OpenAI
             optional :description, String, nil?: true
 
             # @!method initialize(input_schema:, name:, annotations: nil, description: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseInputItem::McpListTools::Tool} for more
-            #   details.
-            #
             #   A tool available on an MCP server.
             #
-            #   @param input_schema [Object] The JSON schema describing the tool's input.
+            #   @param input_schema [Object]
+            #     The JSON schema describing the tool's input.
             #
-            #   @param name [String] The name of the tool.
+            #   @param name [String]
+            #     The name of the tool.
             #
-            #   @param annotations [Object, nil] Additional annotations about the tool.
+            #   @param annotations [Object, nil]
+            #     Additional annotations about the tool.
             #
-            #   @param description [String, nil] The description of the tool.
+            #   @param description [String, nil]
+            #     The description of the tool.
           end
         end
 
@@ -1716,21 +1887,22 @@ module OpenAI
           required :type, const: :mcp_approval_request
 
           # @!method initialize(id:, arguments:, name:, server_label:, type: :mcp_approval_request)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest} for more
-          #   details.
-          #
           #   A request for human approval of a tool invocation.
           #
-          #   @param id [String] The unique ID of the approval request.
+          #   @param id [String]
+          #     The unique ID of the approval request.
           #
-          #   @param arguments [String] A JSON string of arguments for the tool.
+          #   @param arguments [String]
+          #     A JSON string of arguments for the tool.
           #
-          #   @param name [String] The name of the tool to run.
+          #   @param name [String]
+          #     The name of the tool to run.
           #
-          #   @param server_label [String] The label of the MCP server making the request.
+          #   @param server_label [String]
+          #     The label of the MCP server making the request.
           #
-          #   @param type [Symbol, :mcp_approval_request] The type of the item. Always `mcp_approval_request`.
+          #   @param type [Symbol, :mcp_approval_request]
+          #     The type of the item. Always `mcp_approval_request`.
         end
 
         class McpApprovalResponse < OpenAI::Internal::Type::BaseModel
@@ -1765,21 +1937,22 @@ module OpenAI
           optional :reason, String, nil?: true
 
           # @!method initialize(approval_request_id:, approve:, id: nil, reason: nil, type: :mcp_approval_response)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse} for more
-          #   details.
-          #
           #   A response to an MCP approval request.
           #
-          #   @param approval_request_id [String] The ID of the approval request being answered.
+          #   @param approval_request_id [String]
+          #     The ID of the approval request being answered.
           #
-          #   @param approve [Boolean] Whether the request was approved.
+          #   @param approve [Boolean]
+          #     Whether the request was approved.
           #
-          #   @param id [String, nil] The unique ID of the approval response
+          #   @param id [String, nil]
+          #     The unique ID of the approval response
           #
-          #   @param reason [String, nil] Optional reason for the decision.
+          #   @param reason [String, nil]
+          #     Optional reason for the decision.
           #
-          #   @param type [Symbol, :mcp_approval_response] The type of the item. Always `mcp_approval_response`.
+          #   @param type [Symbol, :mcp_approval_response]
+          #     The type of the item. Always `mcp_approval_response`.
         end
 
         class McpCall < OpenAI::Internal::Type::BaseModel
@@ -1841,28 +2014,37 @@ module OpenAI
           optional :status, enum: -> { OpenAI::Responses::ResponseInputItem::McpCall::Status }
 
           # @!method initialize(id:, arguments:, name:, server_label:, approval_request_id: nil, error: nil, output: nil, status: nil, type: :mcp_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::McpCall} for more details.
-          #
           #   An invocation of a tool on an MCP server.
           #
-          #   @param id [String] The unique ID of the tool call.
+          #   @param id [String]
+          #     The unique ID of the tool call.
           #
-          #   @param arguments [String] A JSON string of the arguments passed to the tool.
+          #   @param arguments [String]
+          #     A JSON string of the arguments passed to the tool.
           #
-          #   @param name [String] The name of the tool that was run.
+          #   @param name [String]
+          #     The name of the tool that was run.
           #
-          #   @param server_label [String] The label of the MCP server running the tool.
+          #   @param server_label [String]
+          #     The label of the MCP server running the tool.
           #
-          #   @param approval_request_id [String, nil] Unique identifier for the MCP tool call approval request.
+          #   @param approval_request_id [String, nil]
+          #     Unique identifier for the MCP tool call approval request. Include this value in
+          #     a subsequent `mcp_approval_response` input to approve or reject the
+          #     corresponding tool call.
           #
-          #   @param error [OpenAI::Models::Responses::McpToolCallError::McpProtocolError, OpenAI::Models::Responses::McpToolCallError::McpToolExecutionError, OpenAI::Models::Responses::McpToolCallError::HTTPError, nil] The error from the tool call, if any.
+          #   @param error [OpenAI::Models::Responses::McpToolCallError::McpProtocolError, OpenAI::Models::Responses::McpToolCallError::McpToolExecutionError, OpenAI::Models::Responses::McpToolCallError::HTTPError, nil]
+          #     The error from the tool call, if any.
           #
-          #   @param output [String, nil] The output from the tool call.
+          #   @param output [String, nil]
+          #     The output from the tool call.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::McpCall::Status] The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `c
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::McpCall::Status]
+          #     The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          #     `calling`, or `failed`.
           #
-          #   @param type [Symbol, :mcp_call] The type of the item. Always `mcp_call`.
+          #   @param type [Symbol, :mcp_call]
+          #     The type of the item. Always `mcp_call`.
 
           # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
           # `calling`, or `failed`.
@@ -1892,7 +2074,8 @@ module OpenAI
           # @!method initialize(type: :compaction_trigger)
           #   Compacts the current context. Must be the final input item.
           #
-          #   @param type [Symbol, :compaction_trigger] The type of the item. Always `compaction_trigger`.
+          #   @param type [Symbol, :compaction_trigger]
+          #     The type of the item. Always `compaction_trigger`.
         end
 
         class ItemReference < OpenAI::Internal::Type::BaseModel
@@ -1911,9 +2094,11 @@ module OpenAI
           # @!method initialize(id:, type: nil)
           #   An internal identifier for an item to reference.
           #
-          #   @param id [String] The ID of the item to reference.
+          #   @param id [String]
+          #     The ID of the item to reference.
           #
-          #   @param type [Symbol, OpenAI::Models::Responses::ResponseInputItem::ItemReference::Type, nil] The type of item to reference. Always `item_reference`.
+          #   @param type [Symbol, OpenAI::Models::Responses::ResponseInputItem::ItemReference::Type, nil]
+          #     The type of item to reference. Always `item_reference`.
 
           # The type of item to reference. Always `item_reference`.
           #
@@ -1960,15 +2145,20 @@ module OpenAI
           required :type, const: :program
 
           # @!method initialize(id:, call_id:, code:, fingerprint:, type: :program)
-          #   @param id [String] The unique ID of this program item.
+          #   @param id [String]
+          #     The unique ID of this program item.
           #
-          #   @param call_id [String] The stable call ID of the program item.
+          #   @param call_id [String]
+          #     The stable call ID of the program item.
           #
-          #   @param code [String] The JavaScript source executed by programmatic tool calling.
+          #   @param code [String]
+          #     The JavaScript source executed by programmatic tool calling.
           #
-          #   @param fingerprint [String] Opaque program replay fingerprint that must be round-tripped.
+          #   @param fingerprint [String]
+          #     Opaque program replay fingerprint that must be round-tripped.
           #
-          #   @param type [Symbol, :program] The item type. Always `program`.
+          #   @param type [Symbol, :program]
+          #     The item type. Always `program`.
         end
 
         class ProgramOutput < OpenAI::Internal::Type::BaseModel
@@ -2003,15 +2193,20 @@ module OpenAI
           required :type, const: :program_output
 
           # @!method initialize(id:, call_id:, result:, status:, type: :program_output)
-          #   @param id [String] The unique ID of this program output item.
+          #   @param id [String]
+          #     The unique ID of this program output item.
           #
-          #   @param call_id [String] The call ID of the program item.
+          #   @param call_id [String]
+          #     The call ID of the program item.
           #
-          #   @param result [String] The result produced by the program item.
+          #   @param result [String]
+          #     The result produced by the program item.
           #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput::Status] The terminal status of the program output.
+          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput::Status]
+          #     The terminal status of the program output.
           #
-          #   @param type [Symbol, :program_output] The item type. Always `program_output`.
+          #   @param type [Symbol, :program_output]
+          #     The item type. Always `program_output`.
 
           # The terminal status of the program output.
           #