openai 0.87.0 → 0.89.0

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

@@ -13,11 +13,11 @@ module OpenAI
         variant :message, -> { OpenAI::Beta::BetaResponseOutputMessage }
 
         # 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::Beta::BetaResponseFileSearchToolCall }
 
         # 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::Beta::BetaResponseFunctionToolCall }
 
         variant :function_call_output, -> { OpenAI::Beta::BetaResponseFunctionToolCallOutputItem }
@@ -29,11 +29,11 @@ module OpenAI
         variant :multi_agent_call_output, -> { OpenAI::Beta::BetaResponseOutputItem::MultiAgentCallOutput }
 
         # 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::Beta::BetaResponseFunctionWebSearch }
 
         # 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::Beta::BetaResponseComputerToolCall }
 
         variant :computer_call_output, -> { OpenAI::Beta::BetaResponseComputerToolCallOutputItem }
@@ -41,7 +41,7 @@ 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::Beta::BetaResponseReasoningItem }
 
         variant :program, -> { OpenAI::Beta::BetaResponseOutputItem::Program }
@@ -54,7 +54,7 @@ module OpenAI
 
         variant :additional_tools, -> { OpenAI::Beta::BetaResponseOutputItem::AdditionalTools }
 
-        # 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::Beta::BetaResponseCompactionItem }
 
         # An image generation request made by the model.
@@ -140,17 +140,23 @@ module OpenAI
           optional :agent, -> { OpenAI::Beta::BetaResponseOutputItem::AgentMessage::Agent }
 
           # @!method initialize(id:, author:, content:, recipient:, agent: nil, type: :agent_message)
-          #   @param id [String] The unique ID of the agent message.
+          #   @param id [String]
+          #     The unique ID of the agent message.
           #
-          #   @param author [String] The sending agent identity.
+          #   @param author [String]
+          #     The sending agent identity.
           #
-          #   @param content [Array<OpenAI::Models::Beta::BetaResponseInputText, OpenAI::Models::Beta::BetaResponseOutputText, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::Text, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::SummaryText, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ReasoningText, OpenAI::Models::Beta::BetaResponseOutputRefusal, OpenAI::Models::Beta::BetaResponseInputImage, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot, OpenAI::Models::Beta::BetaResponseInputFile, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::EncryptedContent>] Encrypted content sent between agents.
+          #   @param content [Array<OpenAI::Models::Beta::BetaResponseInputText, OpenAI::Models::Beta::BetaResponseOutputText, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::Text, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::SummaryText, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ReasoningText, OpenAI::Models::Beta::BetaResponseOutputRefusal, OpenAI::Models::Beta::BetaResponseInputImage, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot, OpenAI::Models::Beta::BetaResponseInputFile, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::EncryptedContent>]
+          #     Encrypted content sent between agents.
           #
-          #   @param recipient [String] The destination agent identity.
+          #   @param recipient [String]
+          #     The destination agent identity.
           #
-          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Agent] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Agent]
+          #     The agent that produced this item.
           #
-          #   @param type [Symbol, :agent_message] The type of the item. Always `agent_message`.
+          #   @param type [Symbol, :agent_message]
+          #     The type of the item. Always `agent_message`.
 
           # A content part that makes up an input or output item.
           module Content
@@ -176,7 +182,7 @@ module OpenAI
             # A refusal from the model.
             variant :refusal, -> { OpenAI::Beta::BetaResponseOutputRefusal }
 
-            # An image input to the model. Learn about [image inputs](https://platform.openai.com/docs/guides/vision).
+            # An image input to the model. Learn about [image inputs](https://developers.openai.com/api/docs/guides/images-vision).
             variant :input_image, -> { OpenAI::Beta::BetaResponseInputImage }
 
             # A screenshot of a computer.
@@ -228,9 +234,11 @@ module OpenAI
               # @!method initialize(text:, type: :summary_text)
               #   A summary text from the model.
               #
-              #   @param text [String] A summary of the reasoning output from the model so far.
+              #   @param text [String]
+              #     A summary of the reasoning output from the model so far.
               #
-              #   @param type [Symbol, :summary_text] The type of the object. Always `summary_text`.
+              #   @param type [Symbol, :summary_text]
+              #     The type of the object. Always `summary_text`.
             end
 
             class ReasoningText < OpenAI::Internal::Type::BaseModel
@@ -249,9 +257,11 @@ module OpenAI
               # @!method initialize(text:, type: :reasoning_text)
               #   Reasoning text from the model.
               #
-              #   @param text [String] The reasoning text from the model.
+              #   @param text [String]
+              #     The reasoning text from the model.
               #
-              #   @param type [Symbol, :reasoning_text] The type of the reasoning text. Always `reasoning_text`.
+              #   @param type [Symbol, :reasoning_text]
+              #     The type of the reasoning text. Always `reasoning_text`.
             end
 
             class ComputerScreenshot < OpenAI::Internal::Type::BaseModel
@@ -298,21 +308,26 @@ module OpenAI
               )
 
               # @!method initialize(detail:, file_id:, image_url:, prompt_cache_breakpoint: nil, type: :computer_screenshot)
-              #   Some parameter documentations has been truncated, see
-              #   {OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot}
-              #   for more details.
-              #
               #   A screenshot of a computer.
               #
-              #   @param detail [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::Detail] The detail level of the screenshot image to be sent to the model. One of `high`,
+              #   @param detail [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::Detail]
+              #     The detail level of the screenshot image to be sent to the model. One of `high`,
+              #     `low`, `auto`, or `original`. Defaults to `auto`.
               #
-              #   @param file_id [String, nil] The identifier of an uploaded file that contains the screenshot.
+              #   @param file_id [String, nil]
+              #     The identifier of an uploaded file that contains the screenshot.
               #
-              #   @param image_url [String, nil] The URL of the screenshot image.
+              #   @param image_url [String, nil]
+              #     The URL of the screenshot image.
               #
-              #   @param prompt_cache_breakpoint [OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::PromptCacheBreakpoint] Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+              #   @param prompt_cache_breakpoint [OpenAI::Models::Beta::BetaResponseOutputItem::AgentMessage::Content::ComputerScreenshot::PromptCacheBreakpoint]
+              #     Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+              #     from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+              #     token block.
               #
-              #   @param type [Symbol, :computer_screenshot] Specifies the event type. For a computer screenshot, this property is always set
+              #   @param type [Symbol, :computer_screenshot]
+              #     Specifies the event type. For a computer screenshot, this property is always set
+              #     to `computer_screenshot`.
 
               # The detail level of the screenshot image to be sent to the model. One of `high`,
               # `low`, `auto`, or `original`. Defaults to `auto`.
@@ -343,7 +358,8 @@ module OpenAI
                 #   from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
                 #   token block.
                 #
-                #   @param mode [Symbol, :explicit] The breakpoint mode. Always `explicit`.
+                #   @param mode [Symbol, :explicit]
+                #     The breakpoint mode. Always `explicit`.
               end
             end
 
@@ -364,9 +380,11 @@ module OpenAI
               #   Opaque encrypted content that Responses API decrypts inside trusted model
               #   execution.
               #
-              #   @param encrypted_content [String] Opaque encrypted content.
+              #   @param encrypted_content [String]
+              #     Opaque encrypted content.
               #
-              #   @param type [Symbol, :encrypted_content] The type of the input item. Always `encrypted_content`.
+              #   @param type [Symbol, :encrypted_content]
+              #     The type of the input item. Always `encrypted_content`.
             end
 
             # @!method self.variants
@@ -384,7 +402,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
         end
 
@@ -426,17 +445,23 @@ module OpenAI
           optional :agent, -> { OpenAI::Beta::BetaResponseOutputItem::MultiAgentCall::Agent }
 
           # @!method initialize(id:, action:, arguments:, call_id:, agent: nil, type: :multi_agent_call)
-          #   @param id [String] The unique ID of the multi-agent call item.
+          #   @param id [String]
+          #     The unique ID of the multi-agent call item.
           #
-          #   @param action [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCall::Action] The multi-agent action to execute.
+          #   @param action [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCall::Action]
+          #     The multi-agent action to execute.
           #
-          #   @param arguments [String] The JSON string of arguments generated for the action.
+          #   @param arguments [String]
+          #     The JSON string of arguments generated for the action.
           #
-          #   @param call_id [String] The unique ID linking this call to its output.
+          #   @param call_id [String]
+          #     The unique ID linking this call to its output.
           #
-          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCall::Agent] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCall::Agent]
+          #     The agent that produced this item.
           #
-          #   @param type [Symbol, :multi_agent_call] The type of the multi-agent call. Always `multi_agent_call`.
+          #   @param type [Symbol, :multi_agent_call]
+          #     The type of the multi-agent call. Always `multi_agent_call`.
 
           # The multi-agent action to execute.
           #
@@ -466,7 +491,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
         end
 
@@ -508,17 +534,23 @@ module OpenAI
           optional :agent, -> { OpenAI::Beta::BetaResponseOutputItem::MultiAgentCallOutput::Agent }
 
           # @!method initialize(id:, action:, call_id:, output:, agent: nil, type: :multi_agent_call_output)
-          #   @param id [String] The unique ID of the multi-agent call output item.
+          #   @param id [String]
+          #     The unique ID of the multi-agent call output item.
           #
-          #   @param action [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCallOutput::Action] The multi-agent action that produced this result.
+          #   @param action [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCallOutput::Action]
+          #     The multi-agent action that produced this result.
           #
-          #   @param call_id [String] The unique ID of the multi-agent call.
+          #   @param call_id [String]
+          #     The unique ID of the multi-agent call.
           #
-          #   @param output [Array<OpenAI::Models::Beta::BetaResponseOutputText>] Text output returned by the multi-agent action.
+          #   @param output [Array<OpenAI::Models::Beta::BetaResponseOutputText>]
+          #     Text output returned by the multi-agent action.
           #
-          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCallOutput::Agent] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::MultiAgentCallOutput::Agent]
+          #     The agent that produced this item.
           #
-          #   @param type [Symbol, :multi_agent_call_output] The type of the multi-agent result. Always `multi_agent_call_output`.
+          #   @param type [Symbol, :multi_agent_call_output]
+          #     The type of the multi-agent result. Always `multi_agent_call_output`.
 
           # The multi-agent action that produced this result.
           #
@@ -548,7 +580,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
         end
 
@@ -590,17 +623,23 @@ module OpenAI
           optional :agent, -> { OpenAI::Beta::BetaResponseOutputItem::Program::Agent }
 
           # @!method initialize(id:, call_id:, code:, fingerprint:, agent: nil, type: :program)
-          #   @param id [String] The unique ID of the program item.
+          #   @param id [String]
+          #     The unique ID of the 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 agent [OpenAI::Models::Beta::BetaResponseOutputItem::Program::Agent] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::Program::Agent]
+          #     The agent that produced this item.
           #
-          #   @param type [Symbol, :program] The type of the item. Always `program`.
+          #   @param type [Symbol, :program]
+          #     The type of the item. Always `program`.
 
           # @see OpenAI::Models::Beta::BetaResponseOutputItem::Program#agent
           class Agent < OpenAI::Internal::Type::BaseModel
@@ -613,7 +652,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
         end
 
@@ -655,17 +695,23 @@ module OpenAI
           optional :agent, -> { OpenAI::Beta::BetaResponseOutputItem::ProgramOutput::Agent }
 
           # @!method initialize(id:, call_id:, result:, status:, agent: nil, type: :program_output)
-          #   @param id [String] The unique ID of the program output item.
+          #   @param id [String]
+          #     The unique ID of the 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::Beta::BetaResponseOutputItem::ProgramOutput::Status] The terminal status of the program output item.
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ProgramOutput::Status]
+          #     The terminal status of the program output item.
           #
-          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::ProgramOutput::Agent] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::ProgramOutput::Agent]
+          #     The agent that produced this item.
           #
-          #   @param type [Symbol, :program_output] The type of the item. Always `program_output`.
+          #   @param type [Symbol, :program_output]
+          #     The type of the item. Always `program_output`.
 
           # The terminal status of the program output item.
           #
@@ -691,7 +737,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
         end
 
@@ -727,15 +774,20 @@ module OpenAI
           optional :agent, -> { OpenAI::Beta::BetaResponseOutputItem::AdditionalTools::Agent }
 
           # @!method initialize(id:, role:, tools:, agent: nil, type: :additional_tools)
-          #   @param id [String] The unique ID of the additional tools item.
+          #   @param id [String]
+          #     The unique ID of the additional tools item.
           #
-          #   @param role [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::AdditionalTools::Role] The role that provided the additional tools.
+          #   @param role [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::AdditionalTools::Role]
+          #     The role that provided the additional tools.
           #
-          #   @param tools [Array<OpenAI::Models::Beta::BetaFunctionTool, OpenAI::Models::Beta::BetaFileSearchTool, OpenAI::Models::Beta::BetaComputerTool, OpenAI::Models::Beta::BetaComputerUsePreviewTool, OpenAI::Models::Beta::BetaTool::Mcp, OpenAI::Models::Beta::BetaTool::CodeInterpreter, OpenAI::Models::Beta::BetaTool::ProgrammaticToolCalling, OpenAI::Models::Beta::BetaTool::ImageGeneration, OpenAI::Models::Beta::BetaTool::LocalShell, OpenAI::Models::Beta::BetaFunctionShellTool, OpenAI::Models::Beta::BetaCustomTool, OpenAI::Models::Beta::BetaNamespaceTool, OpenAI::Models::Beta::BetaToolSearchTool, OpenAI::Models::Beta::BetaApplyPatchTool, OpenAI::Models::Beta::BetaWebSearchTool, OpenAI::Models::Beta::BetaWebSearchPreviewTool>] The additional tool definitions made available at this item.
+          #   @param tools [Array<OpenAI::Models::Beta::BetaFunctionTool, OpenAI::Models::Beta::BetaFileSearchTool, OpenAI::Models::Beta::BetaComputerTool, OpenAI::Models::Beta::BetaComputerUsePreviewTool, OpenAI::Models::Beta::BetaTool::Mcp, OpenAI::Models::Beta::BetaTool::CodeInterpreter, OpenAI::Models::Beta::BetaTool::ProgrammaticToolCalling, OpenAI::Models::Beta::BetaTool::ImageGeneration, OpenAI::Models::Beta::BetaTool::LocalShell, OpenAI::Models::Beta::BetaFunctionShellTool, OpenAI::Models::Beta::BetaCustomTool, OpenAI::Models::Beta::BetaNamespaceTool, OpenAI::Models::Beta::BetaToolSearchTool, OpenAI::Models::Beta::BetaApplyPatchTool, OpenAI::Models::Beta::BetaWebSearchTool, OpenAI::Models::Beta::BetaWebSearchPreviewTool>]
+          #     The additional tool definitions made available at this item.
           #
-          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::AdditionalTools::Agent] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::AdditionalTools::Agent]
+          #     The agent that produced this item.
           #
-          #   @param type [Symbol, :additional_tools] The type of the item. Always `additional_tools`.
+          #   @param type [Symbol, :additional_tools]
+          #     The type of the item. Always `additional_tools`.
 
           # The role that provided the additional tools.
           #
@@ -767,7 +819,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
         end
 
@@ -796,12 +849,42 @@ 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::Beta::BetaResponseOutputItem::ImageGenerationCall::Action, nil]
+          optional(
+            :action,
+            enum: -> { OpenAI::Beta::BetaResponseOutputItem::ImageGenerationCall::Action },
+            nil?: true
+          )
+
           # @!attribute agent
           #   The agent that produced this item.
           #
           #   @return [OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Agent, nil]
           optional :agent, -> { OpenAI::Beta::BetaResponseOutputItem::ImageGenerationCall::Agent }, nil?: true
 
+          # @!attribute background
+          #   The background setting used for generation.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Background, nil]
+          optional(
+            :background,
+            enum: -> { OpenAI::Beta::BetaResponseOutputItem::ImageGenerationCall::Background },
+            nil?: true
+          )
+
+          # @!attribute output_format
+          #   The output format used for generation.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::OutputFormat, nil]
+          optional(
+            :output_format,
+            enum: -> { OpenAI::Beta::BetaResponseOutputItem::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`.
@@ -813,6 +896,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`.
           #
@@ -825,26 +914,42 @@ module OpenAI
             nil?: true
           )
 
-          # @!method initialize(id:, result:, status:, agent: nil, quality: nil, size: nil, type: :image_generation_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall} for more
-          #   details.
-          #
+          # @!method initialize(id:, result:, status:, action: nil, agent: 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 result [String, nil] The generated image encoded in base64.
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Status]
+          #     The status of the image generation call.
           #
-          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Status] The status of the image generation call.
+          #   @param action [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Action, nil]
+          #     The action used for image generation.
           #
-          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Agent, nil] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Agent, nil]
+          #     The agent that produced this item.
           #
-          #   @param quality [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Quality, nil] The quality of the image generated by the image generation tool call. One of `lo
+          #   @param background [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Background, nil]
+          #     The background setting used for generation.
           #
-          #   @param size [String, Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::Size, nil] The image dimensions as a `WIDTHxHEIGHT` string, for example `1536x864`.
+          #   @param output_format [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall::OutputFormat, nil]
+          #     The output format used for generation.
           #
-          #   @param type [Symbol, :image_generation_call] The type of the image generation call. Always `image_generation_call`.
+          #   @param quality [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::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 revised_prompt [String, nil]
+          #     The prompt that was used after any model prompt rewriting.
+          #
+          #   @param size [String, Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::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.
           #
@@ -861,6 +966,20 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
 
+          # The action used for image generation.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall#action
+          module Action
+            extend OpenAI::Internal::Type::Enum
+
+            GENERATE = :generate
+            EDIT = :edit
+            AUTO = :auto
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # @see OpenAI::Models::Beta::BetaResponseOutputItem::ImageGenerationCall#agent
           class Agent < OpenAI::Internal::Type::BaseModel
             # @!attribute agent_name
@@ -872,7 +991,36 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
+          end
+
+          # The background setting used for generation.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseOutputItem::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::Beta::BetaResponseOutputItem::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
@@ -970,22 +1118,25 @@ module OpenAI
           optional :agent, -> { OpenAI::Beta::BetaResponseOutputItem::LocalShellCall::Agent }, nil?: true
 
           # @!method initialize(id:, action:, call_id:, status:, agent: nil, type: :local_shell_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaResponseOutputItem::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::Beta::BetaResponseOutputItem::LocalShellCall::Action] Execute a shell command on the server.
+          #   @param action [OpenAI::Models::Beta::BetaResponseOutputItem::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::Beta::BetaResponseOutputItem::LocalShellCall::Status] The status of the local shell call.
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCall::Status]
+          #     The status of the local shell call.
           #
-          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCall::Agent, nil] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCall::Agent, nil]
+          #     The agent that produced this item.
           #
-          #   @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::Beta::BetaResponseOutputItem::LocalShellCall#action
           class Action < OpenAI::Internal::Type::BaseModel
@@ -1028,17 +1179,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.
@@ -1066,7 +1223,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
         end
 
@@ -1112,21 +1270,22 @@ module OpenAI
           )
 
           # @!method initialize(id:, output:, agent: nil, status: nil, type: :local_shell_call_output)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaResponseOutputItem::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 agent [OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCallOutput::Agent, nil] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCallOutput::Agent, nil]
+          #     The agent that produced this item.
           #
-          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCallOutput::Status, nil] The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::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`.
 
           # @see OpenAI::Models::Beta::BetaResponseOutputItem::LocalShellCallOutput#agent
           class Agent < OpenAI::Internal::Type::BaseModel
@@ -1139,7 +1298,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
 
           # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
@@ -1222,30 +1382,40 @@ module OpenAI
           optional :status, enum: -> { OpenAI::Beta::BetaResponseOutputItem::McpCall::Status }
 
           # @!method initialize(id:, arguments:, name:, server_label:, agent: nil, approval_request_id: nil, error: nil, output: nil, status: nil, type: :mcp_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaResponseOutputItem::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 agent [OpenAI::Models::Beta::BetaResponseOutputItem::McpCall::Agent, nil] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::McpCall::Agent, nil]
+          #     The agent that produced this item.
           #
-          #   @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::Beta::BetaMcpToolCallError::McpProtocolError, OpenAI::Models::Beta::BetaMcpToolCallError::McpToolExecutionError, OpenAI::Models::Beta::BetaMcpToolCallError::HTTPError, nil] The error from the tool call, if any.
+          #   @param error [OpenAI::Models::Beta::BetaMcpToolCallError::McpProtocolError, OpenAI::Models::Beta::BetaMcpToolCallError::McpToolExecutionError, OpenAI::Models::Beta::BetaMcpToolCallError::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::Beta::BetaResponseOutputItem::McpCall::Status] The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `c
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseOutputItem::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`.
 
           # @see OpenAI::Models::Beta::BetaResponseOutputItem::McpCall#agent
           class Agent < OpenAI::Internal::Type::BaseModel
@@ -1258,7 +1428,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
 
           # The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
@@ -1320,23 +1491,25 @@ module OpenAI
           optional :error, String, nil?: true
 
           # @!method initialize(id:, server_label:, tools:, agent: nil, error: nil, type: :mcp_list_tools)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaResponseOutputItem::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::Beta::BetaResponseOutputItem::McpListTools::Tool>] The tools available on the server.
+          #   @param tools [Array<OpenAI::Models::Beta::BetaResponseOutputItem::McpListTools::Tool>]
+          #     The tools available on the server.
           #
-          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::McpListTools::Agent, nil] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::McpListTools::Agent, nil]
+          #     The agent that produced this item.
           #
-          #   @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.
@@ -1363,19 +1536,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::Beta::BetaResponseOutputItem::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
 
           # @see OpenAI::Models::Beta::BetaResponseOutputItem::McpListTools#agent
@@ -1389,7 +1562,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
         end
 
@@ -1431,23 +1605,25 @@ module OpenAI
           optional :agent, -> { OpenAI::Beta::BetaResponseOutputItem::McpApprovalRequest::Agent }, nil?: true
 
           # @!method initialize(id:, arguments:, name:, server_label:, agent: nil, type: :mcp_approval_request)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaResponseOutputItem::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 agent [OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalRequest::Agent, nil] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalRequest::Agent, nil]
+          #     The agent that produced this item.
           #
-          #   @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`.
 
           # @see OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalRequest#agent
           class Agent < OpenAI::Internal::Type::BaseModel
@@ -1460,7 +1636,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
         end
 
@@ -1502,23 +1679,25 @@ module OpenAI
           optional :reason, String, nil?: true
 
           # @!method initialize(id:, approval_request_id:, approve:, agent: nil, reason: nil, type: :mcp_approval_response)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalResponse} for more
-          #   details.
-          #
           #   A response to an MCP approval request.
           #
-          #   @param id [String] The unique ID of the approval response
+          #   @param id [String]
+          #     The unique ID of the approval response
           #
-          #   @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 agent [OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalResponse::Agent, nil] The agent that produced this item.
+          #   @param agent [OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalResponse::Agent, nil]
+          #     The agent that produced this item.
           #
-          #   @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`.
 
           # @see OpenAI::Models::Beta::BetaResponseOutputItem::McpApprovalResponse#agent
           class Agent < OpenAI::Internal::Type::BaseModel
@@ -1531,7 +1710,8 @@ module OpenAI
             # @!method initialize(agent_name:)
             #   The agent that produced this item.
             #
-            #   @param agent_name [String] The canonical name of the agent that produced this item.
+            #   @param agent_name [String]
+            #     The canonical name of the agent that produced this item.
           end
         end