openai 0.68.0 → 0.69.0

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

@@ -0,0 +1,2819 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Beta
+      # A message input to the model with a role indicating instruction following
+      # hierarchy. Instructions given with the `developer` or `system` role take
+      # precedence over instructions given with the `user` role. Messages with the
+      # `assistant` role are presumed to have been generated by the model in previous
+      # interactions.
+      module BetaResponseInputItem
+        extend OpenAI::Internal::Type::Union
+
+        discriminator :type
+
+        # A message input to the model with a role indicating instruction following
+        # hierarchy. Instructions given with the `developer` or `system` role take
+        # precedence over instructions given with the `user` role. Messages with the
+        # `assistant` role are presumed to have been generated by the model in previous
+        # interactions.
+        variant :message, -> { OpenAI::Beta::BetaEasyInputMessage }
+
+        # 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.
+        variant :message, -> { OpenAI::Beta::BetaResponseInputItem::Message }
+
+        # An output message from the model.
+        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.
+        variant :file_search_call, -> { OpenAI::Beta::BetaResponseFileSearchToolCall }
+
+        # 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.
+        variant :computer_call, -> { OpenAI::Beta::BetaResponseComputerToolCall }
+
+        # The output of a computer tool call.
+        variant :computer_call_output, -> { OpenAI::Beta::BetaResponseInputItem::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.
+        variant :web_search_call, -> { OpenAI::Beta::BetaResponseFunctionWebSearch }
+
+        # A tool call to run a function. See the
+        # [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more information.
+        variant :function_call, -> { OpenAI::Beta::BetaResponseFunctionToolCall }
+
+        # The output of a function tool call.
+        variant :function_call_output, -> { OpenAI::Beta::BetaResponseInputItem::FunctionCallOutput }
+
+        # A message routed between agents.
+        variant :agent_message, -> { OpenAI::Beta::BetaResponseInputItem::AgentMessage }
+
+        variant :multi_agent_call, -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCall }
+
+        variant :multi_agent_call_output, -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput }
+
+        variant :tool_search_call, -> { OpenAI::Beta::BetaResponseInputItem::ToolSearchCall }
+
+        variant :tool_search_output, -> { OpenAI::Beta::BetaResponseToolSearchOutputItemParam }
+
+        variant :additional_tools, -> { OpenAI::Beta::BetaResponseInputItem::AdditionalTools }
+
+        # 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).
+        variant :reasoning, -> { OpenAI::Beta::BetaResponseReasoningItem }
+
+        # A compaction item generated by the [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+        variant :compaction, -> { OpenAI::Beta::BetaResponseCompactionItemParam }
+
+        # An image generation request made by the model.
+        variant :image_generation_call, -> { OpenAI::Beta::BetaResponseInputItem::ImageGenerationCall }
+
+        # A tool call to run code.
+        variant :code_interpreter_call, -> { OpenAI::Beta::BetaResponseCodeInterpreterToolCall }
+
+        # A tool call to run a command on the local shell.
+        variant :local_shell_call, -> { OpenAI::Beta::BetaResponseInputItem::LocalShellCall }
+
+        # The output of a local shell tool call.
+        variant :local_shell_call_output, -> { OpenAI::Beta::BetaResponseInputItem::LocalShellCallOutput }
+
+        # A tool representing a request to execute one or more shell commands.
+        variant :shell_call, -> { OpenAI::Beta::BetaResponseInputItem::ShellCall }
+
+        # The streamed output items emitted by a shell tool call.
+        variant :shell_call_output, -> { OpenAI::Beta::BetaResponseInputItem::ShellCallOutput }
+
+        # A tool call representing a request to create, delete, or update files using diff patches.
+        variant :apply_patch_call, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall }
+
+        # The streamed output emitted by an apply patch tool call.
+        variant :apply_patch_call_output, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCallOutput }
+
+        # A list of tools available on an MCP server.
+        variant :mcp_list_tools, -> { OpenAI::Beta::BetaResponseInputItem::McpListTools }
+
+        # A request for human approval of a tool invocation.
+        variant :mcp_approval_request, -> { OpenAI::Beta::BetaResponseInputItem::McpApprovalRequest }
+
+        # A response to an MCP approval request.
+        variant :mcp_approval_response, -> { OpenAI::Beta::BetaResponseInputItem::McpApprovalResponse }
+
+        # An invocation of a tool on an MCP server.
+        variant :mcp_call, -> { OpenAI::Beta::BetaResponseInputItem::McpCall }
+
+        # The output of a custom tool call from your code, being sent back to the model.
+        variant :custom_tool_call_output, -> { OpenAI::Beta::BetaResponseCustomToolCallOutput }
+
+        # A call to a custom tool created by the model.
+        variant :custom_tool_call, -> { OpenAI::Beta::BetaResponseCustomToolCall }
+
+        # Compacts the current context. Must be the final input item.
+        variant :compaction_trigger, -> { OpenAI::Beta::BetaResponseInputItem::CompactionTrigger }
+
+        # An internal identifier for an item to reference.
+        variant :item_reference, -> { OpenAI::Beta::BetaResponseInputItem::ItemReference }
+
+        variant :program, -> { OpenAI::Beta::BetaResponseInputItem::Program }
+
+        variant :program_output, -> { OpenAI::Beta::BetaResponseInputItem::ProgramOutput }
+
+        class Message < OpenAI::Internal::Type::BaseModel
+          # @!attribute content
+          #   A list of one or many input items to the model, containing different content
+          #   types.
+          #
+          #   @return [Array<OpenAI::Models::Beta::BetaResponseInputText, OpenAI::Models::Beta::BetaResponseInputImage, OpenAI::Models::Beta::BetaResponseInputFile>]
+          required :content, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::BetaResponseInputContent] }
+
+          # @!attribute role
+          #   The role of the message input. One of `user`, `system`, or `developer`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::Message::Role]
+          required :role, enum: -> { OpenAI::Beta::BetaResponseInputItem::Message::Role }
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::Message::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::Message::Agent }, nil?: true
+
+          # @!attribute status
+          #   The status of item. One of `in_progress`, `completed`, or `incomplete`.
+          #   Populated when items are returned via API.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::Message::Status, nil]
+          optional :status, enum: -> { OpenAI::Beta::BetaResponseInputItem::Message::Status }
+
+          # @!attribute type
+          #   The type of the message input. Always set to `message`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::Message::Type, nil]
+          optional :type, enum: -> { OpenAI::Beta::BetaResponseInputItem::Message::Type }
+
+          # @!method initialize(content:, role:, agent: nil, status: nil, type: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Beta::BetaResponseInputItem::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::Beta::BetaResponseInputText, OpenAI::Models::Beta::BetaResponseInputImage, OpenAI::Models::Beta::BetaResponseInputFile>] A list of one or many input items to the model, containing different content
+          #
+          #   @param role [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::Message::Role] The role of the message input. One of `user`, `system`, or `developer`.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::Message::Agent, nil] The agent that produced this item.
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::Message::Status] The status of item. One of `in_progress`, `completed`, or
+          #
+          #   @param type [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::Message::Type] The type of the message input. Always set to `message`.
+
+          # The role of the message input. One of `user`, `system`, or `developer`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::Message#role
+          module Role
+            extend OpenAI::Internal::Type::Enum
+
+            USER = :user
+            SYSTEM = :system
+            DEVELOPER = :developer
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::Message#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+
+          # The status of item. One of `in_progress`, `completed`, or `incomplete`.
+          # Populated when items are returned via API.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::Message#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The type of the message input. Always set to `message`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::Message#type
+          module Type
+            extend OpenAI::Internal::Type::Enum
+
+            MESSAGE = :message
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class ComputerCallOutput < OpenAI::Internal::Type::BaseModel
+          # @!attribute call_id
+          #   The ID of the computer tool call that produced the output.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute output
+          #   A computer screenshot image used with the computer use tool.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseComputerToolCallOutputScreenshot]
+          required :output, -> { OpenAI::Beta::BetaResponseComputerToolCallOutputScreenshot }
+
+          # @!attribute type
+          #   The type of the computer tool call output. Always `computer_call_output`.
+          #
+          #   @return [Symbol, :computer_call_output]
+          required :type, const: :computer_call_output
+
+          # @!attribute id
+          #   The ID of the computer tool call output.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute acknowledged_safety_checks
+          #   The safety checks reported by the API that have been acknowledged by the
+          #   developer.
+          #
+          #   @return [Array<OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput::AcknowledgedSafetyCheck>, nil]
+          optional :acknowledged_safety_checks,
+                   -> {
+                     OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::BetaResponseInputItem::ComputerCallOutput::AcknowledgedSafetyCheck]
+                   },
+                   nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::ComputerCallOutput::Agent }, nil?: true
+
+          # @!attribute status
+          #   The status of the message input. One of `in_progress`, `completed`, or
+          #   `incomplete`. Populated when input items are returned via API.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput::Status, nil]
+          optional :status,
+                   enum: -> {
+                     OpenAI::Beta::BetaResponseInputItem::ComputerCallOutput::Status
+                   },
+                   nil?: true
+
+          # @!method initialize(call_id:, output:, id: nil, acknowledged_safety_checks: nil, agent: nil, status: nil, type: :computer_call_output)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Beta::BetaResponseInputItem::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 output [OpenAI::Models::Beta::BetaResponseComputerToolCallOutputScreenshot] A computer screenshot image used with the computer use tool.
+          #
+          #   @param id [String, nil] The ID of the computer tool call output.
+          #
+          #   @param acknowledged_safety_checks [Array<OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput::AcknowledgedSafetyCheck>, nil] The safety checks reported by the API that have been acknowledged by the develop
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput::Agent, nil] The agent that produced this item.
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput::Status, nil] The status of the message input. One of `in_progress`, `completed`, or `incomple
+          #
+          #   @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.
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute code
+            #   The type of the pending safety check.
+            #
+            #   @return [String, nil]
+            optional :code, String, nil?: true
+
+            # @!attribute message
+            #   Details about the pending safety check.
+            #
+            #   @return [String, nil]
+            optional :message, String, nil?: true
+
+            # @!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 code [String, nil] The type of the pending safety check.
+            #
+            #   @param message [String, nil] Details about the pending safety check.
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   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 message input. One of `in_progress`, `completed`, or
+          # `incomplete`. Populated when input items are returned via API.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class FunctionCallOutput < OpenAI::Internal::Type::BaseModel
+          # @!attribute call_id
+          #   The unique ID of the function tool call generated by the model.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute output
+          #   Text, image, or file output of the function tool call.
+          #
+          #   @return [String, Array<OpenAI::Models::Beta::BetaResponseInputTextContent, OpenAI::Models::Beta::BetaResponseInputImageContent, OpenAI::Models::Beta::BetaResponseInputFileContent>]
+          required :output, union: -> { OpenAI::Beta::BetaResponseInputItem::FunctionCallOutput::Output }
+
+          # @!attribute type
+          #   The type of the function tool call output. Always `function_call_output`.
+          #
+          #   @return [Symbol, :function_call_output]
+          required :type, const: :function_call_output
+
+          # @!attribute id
+          #   The unique ID of the function tool call output. Populated when this item is
+          #   returned via API.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::FunctionCallOutput::Agent }, nil?: true
+
+          # @!attribute caller_
+          #   The execution context that produced this tool call.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::Caller::Program, nil]
+          optional :caller_,
+                   union: -> { OpenAI::Beta::BetaResponseInputItem::FunctionCallOutput::Caller },
+                   api_name: :caller,
+                   nil?: true
+
+          # @!attribute status
+          #   The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          #   Populated when items are returned via API.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::Status, nil]
+          optional :status,
+                   enum: -> {
+                     OpenAI::Beta::BetaResponseInputItem::FunctionCallOutput::Status
+                   },
+                   nil?: true
+
+          # @!method initialize(call_id:, output:, id: nil, agent: nil, caller_: nil, status: nil, type: :function_call_output)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput} for more
+          #   details.
+          #
+          #   The output of a function tool call.
+          #
+          #   @param call_id [String] The unique ID of the function tool call generated by the model.
+          #
+          #   @param output [String, Array<OpenAI::Models::Beta::BetaResponseInputTextContent, OpenAI::Models::Beta::BetaResponseInputImageContent, OpenAI::Models::Beta::BetaResponseInputFileContent>] 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 agent [OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::Agent, nil] The agent that produced this item.
+          #
+          #   @param caller_ [OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::Caller::Program, nil] The execution context that produced this tool call.
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::Status, nil] The status of the item. One of `in_progress`, `completed`, or `incomplete`. Popu
+          #
+          #   @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.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput#output
+          module Output
+            extend OpenAI::Internal::Type::Union
+
+            # A JSON string of the output of the function tool call.
+            variant String
+
+            # An array of content outputs (text, image, file) for the function tool call.
+            variant -> { OpenAI::Beta::BetaResponseFunctionCallOutputItemList }
+
+            # @!method self.variants
+            #   @return [Array(String, Array<OpenAI::Models::Beta::BetaResponseInputTextContent, OpenAI::Models::Beta::BetaResponseInputImageContent, OpenAI::Models::Beta::BetaResponseInputFileContent>)]
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+
+          # The execution context that produced this tool call.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput#caller_
+          module Caller
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            variant :direct, -> { OpenAI::Beta::BetaResponseInputItem::FunctionCallOutput::Caller::Direct }
+
+            variant :program, -> { OpenAI::Beta::BetaResponseInputItem::FunctionCallOutput::Caller::Program }
+
+            class Direct < OpenAI::Internal::Type::BaseModel
+              # @!attribute type
+              #   The caller type. Always `direct`.
+              #
+              #   @return [Symbol, :direct]
+              required :type, const: :direct
+
+              # @!method initialize(type: :direct)
+              #   @param type [Symbol, :direct] The caller type. Always `direct`.
+            end
+
+            class Program < OpenAI::Internal::Type::BaseModel
+              # @!attribute caller_id
+              #   The call ID of the program item that produced this tool call.
+              #
+              #   @return [String]
+              required :caller_id, String
+
+              # @!attribute type
+              #   The caller type. Always `program`.
+              #
+              #   @return [Symbol, :program]
+              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 type [Symbol, :program] The caller type. Always `program`.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput::Caller::Program)]
+          end
+
+          # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          # Populated when items are returned via API.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class AgentMessage < OpenAI::Internal::Type::BaseModel
+          # @!attribute author
+          #   The sending agent identity.
+          #
+          #   @return [String]
+          required :author, String
+
+          # @!attribute content
+          #   Plaintext, image, or encrypted content sent between agents.
+          #
+          #   @return [Array<OpenAI::Models::Beta::BetaResponseInputTextContent, OpenAI::Models::Beta::BetaResponseInputImageContent, OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage::Content::EncryptedContent>]
+          required :content,
+                   -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::BetaResponseInputItem::AgentMessage::Content] }
+
+          # @!attribute recipient
+          #   The destination agent identity.
+          #
+          #   @return [String]
+          required :recipient, String
+
+          # @!attribute type
+          #   The item type. Always `agent_message`.
+          #
+          #   @return [Symbol, :agent_message]
+          required :type, const: :agent_message
+
+          # @!attribute id
+          #   The unique ID of this agent message item.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::AgentMessage::Agent }, nil?: true
+
+          # @!method initialize(author:, content:, recipient:, id: nil, agent: nil, type: :agent_message)
+          #   A message routed between agents.
+          #
+          #   @param author [String] The sending agent identity.
+          #
+          #   @param content [Array<OpenAI::Models::Beta::BetaResponseInputTextContent, OpenAI::Models::Beta::BetaResponseInputImageContent, OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage::Content::EncryptedContent>] Plaintext, image, or encrypted content sent between agents.
+          #
+          #   @param recipient [String] The destination agent identity.
+          #
+          #   @param id [String, nil] The unique ID of this agent message item.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage::Agent, nil] The agent that produced this item.
+          #
+          #   @param type [Symbol, :agent_message] The item type. Always `agent_message`.
+
+          # A plaintext, image, or encrypted agent message content part.
+          module Content
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            # A text input to the model.
+            variant :input_text, -> { OpenAI::Beta::BetaResponseInputTextContent }
+
+            # An image input to the model. Learn about [image inputs](https://platform.openai.com/docs/guides/vision)
+            variant :input_image, -> { OpenAI::Beta::BetaResponseInputImageContent }
+
+            # Opaque encrypted content that Responses API decrypts inside trusted model execution.
+            variant :encrypted_content,
+                    -> { OpenAI::Beta::BetaResponseInputItem::AgentMessage::Content::EncryptedContent }
+
+            class EncryptedContent < OpenAI::Internal::Type::BaseModel
+              # @!attribute encrypted_content
+              #   Opaque encrypted content.
+              #
+              #   @return [String]
+              required :encrypted_content, String
+
+              # @!attribute type
+              #   The type of the input item. Always `encrypted_content`.
+              #
+              #   @return [Symbol, :encrypted_content]
+              required :type, const: :encrypted_content
+
+              # @!method initialize(encrypted_content:, type: :encrypted_content)
+              #   Opaque encrypted content that Responses API decrypts inside trusted model
+              #   execution.
+              #
+              #   @param encrypted_content [String] Opaque encrypted content.
+              #
+              #   @param type [Symbol, :encrypted_content] The type of the input item. Always `encrypted_content`.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::BetaResponseInputTextContent, OpenAI::Models::Beta::BetaResponseInputImageContent, OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage::Content::EncryptedContent)]
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class MultiAgentCall < OpenAI::Internal::Type::BaseModel
+          # @!attribute action
+          #   The multi-agent action that was executed.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall::Action]
+          required :action, enum: -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCall::Action }
+
+          # @!attribute arguments
+          #   The action arguments as a JSON string.
+          #
+          #   @return [String]
+          required :arguments, String
+
+          # @!attribute call_id
+          #   The unique ID linking this call to its output.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute type
+          #   The item type. Always `multi_agent_call`.
+          #
+          #   @return [Symbol, :multi_agent_call]
+          required :type, const: :multi_agent_call
+
+          # @!attribute id
+          #   The unique ID of this multi-agent call.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCall::Agent }, nil?: true
+
+          # @!method initialize(action:, arguments:, call_id:, id: nil, agent: nil, type: :multi_agent_call)
+          #   @param action [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall::Action] The multi-agent action that was executed.
+          #
+          #   @param arguments [String] The action arguments as a JSON string.
+          #
+          #   @param call_id [String] The unique ID linking this call to its output.
+          #
+          #   @param id [String, nil] The unique ID of this multi-agent call.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall::Agent, nil] The agent that produced this item.
+          #
+          #   @param type [Symbol, :multi_agent_call] The item type. Always `multi_agent_call`.
+
+          # The multi-agent action that was executed.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall#action
+          module Action
+            extend OpenAI::Internal::Type::Enum
+
+            SPAWN_AGENT = :spawn_agent
+            INTERRUPT_AGENT = :interrupt_agent
+            LIST_AGENTS = :list_agents
+            SEND_MESSAGE = :send_message
+            FOLLOWUP_TASK = :followup_task
+            WAIT_AGENT = :wait_agent
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class MultiAgentCallOutput < OpenAI::Internal::Type::BaseModel
+          # @!attribute action
+          #   The multi-agent action that produced this result.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Action]
+          required :action, enum: -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Action }
+
+          # @!attribute call_id
+          #   The unique ID of the multi-agent call.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute output
+          #   Text output returned by the multi-agent action.
+          #
+          #   @return [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output>]
+          required :output,
+                   -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output] }
+
+          # @!attribute type
+          #   The item type. Always `multi_agent_call_output`.
+          #
+          #   @return [Symbol, :multi_agent_call_output]
+          required :type, const: :multi_agent_call_output
+
+          # @!attribute id
+          #   The unique ID of this multi-agent call output.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Agent }, nil?: true
+
+          # @!method initialize(action:, call_id:, output:, id: nil, agent: nil, type: :multi_agent_call_output)
+          #   @param action [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Action] The multi-agent action that produced this result.
+          #
+          #   @param call_id [String] The unique ID of the multi-agent call.
+          #
+          #   @param output [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output>] Text output returned by the multi-agent action.
+          #
+          #   @param id [String, nil] The unique ID of this multi-agent call output.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Agent, nil] The agent that produced this item.
+          #
+          #   @param type [Symbol, :multi_agent_call_output] The item type. Always `multi_agent_call_output`.
+
+          # The multi-agent action that produced this result.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput#action
+          module Action
+            extend OpenAI::Internal::Type::Enum
+
+            SPAWN_AGENT = :spawn_agent
+            INTERRUPT_AGENT = :interrupt_agent
+            LIST_AGENTS = :list_agents
+            SEND_MESSAGE = :send_message
+            FOLLOWUP_TASK = :followup_task
+            WAIT_AGENT = :wait_agent
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          class Output < OpenAI::Internal::Type::BaseModel
+            # @!attribute text
+            #   The text content.
+            #
+            #   @return [String]
+            required :text, String
+
+            # @!attribute type
+            #   The content type. Always `output_text`.
+            #
+            #   @return [Symbol, :output_text]
+            required :type, const: :output_text
+
+            # @!attribute annotations
+            #   Citations associated with the text content.
+            #
+            #   @return [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2>, nil]
+            optional :annotations,
+                     union: -> { OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations }
+
+            # @!method initialize(text:, annotations: nil, type: :output_text)
+            #   @param text [String] The text content.
+            #
+            #   @param annotations [Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2>] Citations associated with the text content.
+            #
+            #   @param type [Symbol, :output_text] The content type. Always `output_text`.
+
+            # Citations associated with the text content.
+            #
+            # @see OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output#annotations
+            module Annotations
+              extend OpenAI::Internal::Type::Union
+
+              variant -> { OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0Array }
+
+              variant -> { OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1Array }
+
+              variant -> { OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2Array }
+
+              class UnionMember0 < OpenAI::Internal::Type::BaseModel
+                # @!attribute file_id
+                #   The ID of the file.
+                #
+                #   @return [String]
+                required :file_id, String
+
+                # @!attribute filename
+                #   The filename of the file cited.
+                #
+                #   @return [String]
+                required :filename, String
+
+                # @!attribute index
+                #   The index of the file in the list of files.
+                #
+                #   @return [Integer]
+                required :index, Integer
+
+                # @!attribute type
+                #   The citation type. Always `file_citation`.
+                #
+                #   @return [Symbol, :file_citation]
+                required :type, const: :file_citation
+
+                # @!method initialize(file_id:, filename:, index:, type: :file_citation)
+                #   @param file_id [String] The ID of the file.
+                #
+                #   @param filename [String] The filename of the file cited.
+                #
+                #   @param index [Integer] The index of the file in the list of files.
+                #
+                #   @param type [Symbol, :file_citation] The citation type. Always `file_citation`.
+              end
+
+              class UnionMember1 < OpenAI::Internal::Type::BaseModel
+                # @!attribute end_index
+                #   The index of the last character of the citation in the message.
+                #
+                #   @return [Integer]
+                required :end_index, Integer
+
+                # @!attribute start_index
+                #   The index of the first character of the citation in the message.
+                #
+                #   @return [Integer]
+                required :start_index, Integer
+
+                # @!attribute title
+                #   The title of the cited resource.
+                #
+                #   @return [String]
+                required :title, String
+
+                # @!attribute type
+                #   The citation type. Always `url_citation`.
+                #
+                #   @return [Symbol, :url_citation]
+                required :type, const: :url_citation
+
+                # @!attribute url
+                #   The URL of the cited resource.
+                #
+                #   @return [String]
+                required :url, String
+
+                # @!method initialize(end_index:, start_index:, title:, url:, type: :url_citation)
+                #   @param end_index [Integer] The index of the last character of the citation in the message.
+                #
+                #   @param start_index [Integer] The index of the first character of the citation in the message.
+                #
+                #   @param title [String] The title of the cited resource.
+                #
+                #   @param url [String] The URL of the cited resource.
+                #
+                #   @param type [Symbol, :url_citation] The citation type. Always `url_citation`.
+              end
+
+              class UnionMember2 < OpenAI::Internal::Type::BaseModel
+                # @!attribute container_id
+                #   The ID of the container.
+                #
+                #   @return [String]
+                required :container_id, String
+
+                # @!attribute end_index
+                #   The index of the last character of the citation in the message.
+                #
+                #   @return [Integer]
+                required :end_index, Integer
+
+                # @!attribute file_id
+                #   The ID of the container file.
+                #
+                #   @return [String]
+                required :file_id, String
+
+                # @!attribute filename
+                #   The filename of the container file cited.
+                #
+                #   @return [String]
+                required :filename, String
+
+                # @!attribute start_index
+                #   The index of the first character of the citation in the message.
+                #
+                #   @return [Integer]
+                required :start_index, Integer
+
+                # @!attribute type
+                #   The citation type. Always `container_file_citation`.
+                #
+                #   @return [Symbol, :container_file_citation]
+                required :type, const: :container_file_citation
+
+                # @!method initialize(container_id:, end_index:, file_id:, filename:, start_index:, type: :container_file_citation)
+                #   @param container_id [String] The ID of the container.
+                #
+                #   @param end_index [Integer] The index of the last character of the citation in the message.
+                #
+                #   @param file_id [String] The ID of the container file.
+                #
+                #   @param filename [String] The filename of the container file cited.
+                #
+                #   @param start_index [Integer] The index of the first character of the citation in the message.
+                #
+                #   @param type [Symbol, :container_file_citation] The citation type. Always `container_file_citation`.
+              end
+
+              # @!method self.variants
+              #   @return [Array(Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1>, Array<OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2>)]
+
+              # @type [OpenAI::Internal::Type::Converter]
+              UnionMember0Array =
+                OpenAI::Internal::Type::ArrayOf[-> {
+                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember0
+                }]
+
+              # @type [OpenAI::Internal::Type::Converter]
+              UnionMember1Array =
+                OpenAI::Internal::Type::ArrayOf[-> {
+                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember1
+                }]
+
+              # @type [OpenAI::Internal::Type::Converter]
+              UnionMember2Array =
+                OpenAI::Internal::Type::ArrayOf[-> {
+                  OpenAI::Beta::BetaResponseInputItem::MultiAgentCallOutput::Output::Annotations::UnionMember2
+                }]
+            end
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class ToolSearchCall < OpenAI::Internal::Type::BaseModel
+          # @!attribute arguments
+          #   The arguments supplied to the tool search call.
+          #
+          #   @return [Object]
+          required :arguments, OpenAI::Internal::Type::Unknown
+
+          # @!attribute type
+          #   The item type. Always `tool_search_call`.
+          #
+          #   @return [Symbol, :tool_search_call]
+          required :type, const: :tool_search_call
+
+          # @!attribute id
+          #   The unique ID of this tool search call.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::ToolSearchCall::Agent }, nil?: true
+
+          # @!attribute call_id
+          #   The unique ID of the tool search call generated by the model.
+          #
+          #   @return [String, nil]
+          optional :call_id, String, nil?: true
+
+          # @!attribute execution
+          #   Whether tool search was executed by the server or by the client.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall::Execution, nil]
+          optional :execution, enum: -> { OpenAI::Beta::BetaResponseInputItem::ToolSearchCall::Execution }
+
+          # @!attribute status
+          #   The status of the tool search call.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall::Status, nil]
+          optional :status,
+                   enum: -> {
+                     OpenAI::Beta::BetaResponseInputItem::ToolSearchCall::Status
+                   },
+                   nil?: true
+
+          # @!method initialize(arguments:, id: nil, agent: nil, call_id: nil, execution: nil, status: nil, type: :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 agent [OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall::Agent, nil] The agent that produced this item.
+          #
+          #   @param call_id [String, nil] The unique ID of the tool search call generated by the model.
+          #
+          #   @param execution [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall::Execution] Whether tool search was executed by the server or by the client.
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall::Status, nil] The status of the tool search call.
+          #
+          #   @param type [Symbol, :tool_search_call] The item type. Always `tool_search_call`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+
+          # Whether tool search was executed by the server or by the client.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall#execution
+          module Execution
+            extend OpenAI::Internal::Type::Enum
+
+            SERVER = :server
+            CLIENT = :client
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The status of the tool search call.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class AdditionalTools < OpenAI::Internal::Type::BaseModel
+          # @!attribute role
+          #   The role that provided the additional tools. Only `developer` is supported.
+          #
+          #   @return [Symbol, :developer]
+          required :role, const: :developer
+
+          # @!attribute tools
+          #   A list of additional tools made available at this item.
+          #
+          #   @return [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>]
+          required :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Beta::BetaTool] }
+
+          # @!attribute type
+          #   The item type. Always `additional_tools`.
+          #
+          #   @return [Symbol, :additional_tools]
+          required :type, const: :additional_tools
+
+          # @!attribute id
+          #   The unique ID of this additional tools item.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::AdditionalTools::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::AdditionalTools::Agent }, nil?: true
+
+          # @!method initialize(tools:, id: nil, agent: nil, role: :developer, type: :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>] A list of additional tools made available at this item.
+          #
+          #   @param id [String, nil] The unique ID of this additional tools item.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::AdditionalTools::Agent, nil] The agent that produced this item.
+          #
+          #   @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`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::AdditionalTools#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class ImageGenerationCall < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the image generation call.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute result
+          #   The generated image encoded in base64.
+          #
+          #   @return [String, nil]
+          required :result, String, nil?: true
+
+          # @!attribute status
+          #   The status of the image generation call.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::Status]
+          required :status, enum: -> { OpenAI::Beta::BetaResponseInputItem::ImageGenerationCall::Status }
+
+          # @!attribute type
+          #   The type of the image generation call. Always `image_generation_call`.
+          #
+          #   @return [Symbol, :image_generation_call]
+          required :type, const: :image_generation_call
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::ImageGenerationCall::Agent }, nil?: true
+
+          # @!method initialize(id:, result:, status:, agent: nil, type: :image_generation_call)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall} for more
+          #   details.
+          #
+          #   An image generation request made by the model.
+          #
+          #   @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::Beta::BetaResponseInputItem::ImageGenerationCall::Status] The status of the image generation call.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall::Agent, nil] The agent that produced this item.
+          #
+          #   @param type [Symbol, :image_generation_call] The type of the image generation call. Always `image_generation_call`.
+
+          # The status of the image generation call.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            GENERATING = :generating
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class LocalShellCall < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the local shell call.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute action
+          #   Execute a shell command on the server.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall::Action]
+          required :action, -> { OpenAI::Beta::BetaResponseInputItem::LocalShellCall::Action }
+
+          # @!attribute call_id
+          #   The unique ID of the local shell tool call generated by the model.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute status
+          #   The status of the local shell call.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall::Status]
+          required :status, enum: -> { OpenAI::Beta::BetaResponseInputItem::LocalShellCall::Status }
+
+          # @!attribute type
+          #   The type of the local shell call. Always `local_shell_call`.
+          #
+          #   @return [Symbol, :local_shell_call]
+          required :type, const: :local_shell_call
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::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::BetaResponseInputItem::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 action [OpenAI::Models::Beta::BetaResponseInputItem::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 status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall::Status] The status of the local shell call.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::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`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall#action
+          class Action < OpenAI::Internal::Type::BaseModel
+            # @!attribute command
+            #   The command to run.
+            #
+            #   @return [Array<String>]
+            required :command, OpenAI::Internal::Type::ArrayOf[String]
+
+            # @!attribute env
+            #   Environment variables to set for the command.
+            #
+            #   @return [Hash{Symbol=>String}]
+            required :env, OpenAI::Internal::Type::HashOf[String]
+
+            # @!attribute type
+            #   The type of the local shell action. Always `exec`.
+            #
+            #   @return [Symbol, :exec]
+            required :type, const: :exec
+
+            # @!attribute timeout_ms
+            #   Optional timeout in milliseconds for the command.
+            #
+            #   @return [Integer, nil]
+            optional :timeout_ms, Integer, nil?: true
+
+            # @!attribute user
+            #   Optional user to run the command as.
+            #
+            #   @return [String, nil]
+            optional :user, String, nil?: true
+
+            # @!attribute working_directory
+            #   Optional working directory to run the command in.
+            #
+            #   @return [String, nil]
+            optional :working_directory, String, nil?: true
+
+            # @!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 env [Hash{Symbol=>String}] Environment variables to set 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 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`.
+          end
+
+          # The status of the local shell call.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class LocalShellCallOutput < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the local shell tool call generated by the model.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute output
+          #   A JSON string of the output of the local shell tool call.
+          #
+          #   @return [String]
+          required :output, String
+
+          # @!attribute type
+          #   The type of the local shell tool call output. Always `local_shell_call_output`.
+          #
+          #   @return [Symbol, :local_shell_call_output]
+          required :type, const: :local_shell_call_output
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::LocalShellCallOutput::Agent }, nil?: true
+
+          # @!attribute status
+          #   The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput::Status, nil]
+          optional :status,
+                   enum: -> { OpenAI::Beta::BetaResponseInputItem::LocalShellCallOutput::Status },
+                   nil?: true
+
+          # @!method initialize(id:, output:, agent: nil, status: nil, type: :local_shell_call_output)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Beta::BetaResponseInputItem::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 output [String] A JSON string of the output of the local shell tool call.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput::Agent, nil] The agent that produced this item.
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::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`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   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`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class ShellCall < OpenAI::Internal::Type::BaseModel
+          # @!attribute action
+          #   The shell commands and limits that describe how to run the tool call.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::Action]
+          required :action, -> { OpenAI::Beta::BetaResponseInputItem::ShellCall::Action }
+
+          # @!attribute call_id
+          #   The unique ID of the shell tool call generated by the model.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute type
+          #   The type of the item. Always `shell_call`.
+          #
+          #   @return [Symbol, :shell_call]
+          required :type, const: :shell_call
+
+          # @!attribute id
+          #   The unique ID of the shell tool call. Populated when this item is returned via
+          #   API.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::ShellCall::Agent }, nil?: true
+
+          # @!attribute caller_
+          #   The execution context that produced this tool call.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::Caller::Program, nil]
+          optional :caller_,
+                   union: -> { OpenAI::Beta::BetaResponseInputItem::ShellCall::Caller },
+                   api_name: :caller,
+                   nil?: true
+
+          # @!attribute environment
+          #   The environment to execute the shell commands in.
+          #
+          #   @return [OpenAI::Models::Beta::BetaLocalEnvironment, OpenAI::Models::Beta::BetaContainerReference, nil]
+          optional :environment,
+                   union: -> { OpenAI::Beta::BetaResponseInputItem::ShellCall::Environment },
+                   nil?: true
+
+          # @!attribute status
+          #   The status of the shell call. One of `in_progress`, `completed`, or
+          #   `incomplete`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::Status, nil]
+          optional :status, enum: -> { OpenAI::Beta::BetaResponseInputItem::ShellCall::Status }, nil?: true
+
+          # @!method initialize(action:, call_id:, id: nil, agent: nil, caller_: nil, environment: nil, status: nil, type: :shell_call)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Beta::BetaResponseInputItem::ShellCall} for more details.
+          #
+          #   A tool representing a request to execute one or more shell commands.
+          #
+          #   @param action [OpenAI::Models::Beta::BetaResponseInputItem::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 id [String, nil] The unique ID of the shell tool call. Populated when this item is returned via A
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::Agent, nil] The agent that produced this item.
+          #
+          #   @param caller_ [OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::Caller::Program, nil] The execution context that produced this tool call.
+          #
+          #   @param environment [OpenAI::Models::Beta::BetaLocalEnvironment, OpenAI::Models::Beta::BetaContainerReference, nil] The environment to execute the shell commands in.
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::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`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ShellCall#action
+          class Action < OpenAI::Internal::Type::BaseModel
+            # @!attribute commands
+            #   Ordered shell commands for the execution environment to run.
+            #
+            #   @return [Array<String>]
+            required :commands, OpenAI::Internal::Type::ArrayOf[String]
+
+            # @!attribute max_output_length
+            #   Maximum number of UTF-8 characters to capture from combined stdout and stderr
+            #   output.
+            #
+            #   @return [Integer, nil]
+            optional :max_output_length, Integer, nil?: true
+
+            # @!attribute timeout_ms
+            #   Maximum wall-clock time in milliseconds to allow the shell commands to run.
+            #
+            #   @return [Integer, nil]
+            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::Beta::BetaResponseInputItem::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 max_output_length [Integer, nil] Maximum number of UTF-8 characters to capture from combined stdout and stderr ou
+            #
+            #   @param timeout_ms [Integer, nil] Maximum wall-clock time in milliseconds to allow the shell commands to run.
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ShellCall#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+
+          # The execution context that produced this tool call.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ShellCall#caller_
+          module Caller
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            variant :direct, -> { OpenAI::Beta::BetaResponseInputItem::ShellCall::Caller::Direct }
+
+            variant :program, -> { OpenAI::Beta::BetaResponseInputItem::ShellCall::Caller::Program }
+
+            class Direct < OpenAI::Internal::Type::BaseModel
+              # @!attribute type
+              #   The caller type. Always `direct`.
+              #
+              #   @return [Symbol, :direct]
+              required :type, const: :direct
+
+              # @!method initialize(type: :direct)
+              #   @param type [Symbol, :direct] The caller type. Always `direct`.
+            end
+
+            class Program < OpenAI::Internal::Type::BaseModel
+              # @!attribute caller_id
+              #   The call ID of the program item that produced this tool call.
+              #
+              #   @return [String]
+              required :caller_id, String
+
+              # @!attribute type
+              #   The caller type. Always `program`.
+              #
+              #   @return [Symbol, :program]
+              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 type [Symbol, :program] The caller type. Always `program`.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::ShellCall::Caller::Program)]
+          end
+
+          # The environment to execute the shell commands in.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ShellCall#environment
+          module Environment
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            variant :local, -> { OpenAI::Beta::BetaLocalEnvironment }
+
+            variant :container_reference, -> { OpenAI::Beta::BetaContainerReference }
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::BetaLocalEnvironment, OpenAI::Models::Beta::BetaContainerReference)]
+          end
+
+          # The status of the shell call. One of `in_progress`, `completed`, or
+          # `incomplete`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ShellCall#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class ShellCallOutput < OpenAI::Internal::Type::BaseModel
+          # @!attribute call_id
+          #   The unique ID of the shell tool call generated by the model.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute output
+          #   Captured chunks of stdout and stderr output, along with their associated
+          #   outcomes.
+          #
+          #   @return [Array<OpenAI::Models::Beta::BetaResponseFunctionShellCallOutputContent>]
+          required :output,
+                   -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::BetaResponseFunctionShellCallOutputContent] }
+
+          # @!attribute type
+          #   The type of the item. Always `shell_call_output`.
+          #
+          #   @return [Symbol, :shell_call_output]
+          required :type, const: :shell_call_output
+
+          # @!attribute id
+          #   The unique ID of the shell tool call output. Populated when this item is
+          #   returned via API.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::ShellCallOutput::Agent }, nil?: true
+
+          # @!attribute caller_
+          #   The execution context that produced this tool call.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput::Caller::Program, nil]
+          optional :caller_,
+                   union: -> { OpenAI::Beta::BetaResponseInputItem::ShellCallOutput::Caller },
+                   api_name: :caller,
+                   nil?: true
+
+          # @!attribute max_output_length
+          #   The maximum number of UTF-8 characters captured for this shell call's combined
+          #   output.
+          #
+          #   @return [Integer, nil]
+          optional :max_output_length, Integer, nil?: true
+
+          # @!attribute status
+          #   The status of the shell call output.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput::Status, nil]
+          optional :status,
+                   enum: -> {
+                     OpenAI::Beta::BetaResponseInputItem::ShellCallOutput::Status
+                   },
+                   nil?: true
+
+          # @!method initialize(call_id:, output:, id: nil, agent: nil, caller_: nil, max_output_length: nil, status: nil, type: :shell_call_output)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Beta::BetaResponseInputItem::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 output [Array<OpenAI::Models::Beta::BetaResponseFunctionShellCallOutputContent>] Captured chunks of stdout and stderr output, along with their associated outcome
+          #
+          #   @param id [String, nil] The unique ID of the shell tool call output. Populated when this item is returne
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput::Agent, nil] The agent that produced this item.
+          #
+          #   @param caller_ [OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::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 status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::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`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+
+          # The execution context that produced this tool call.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput#caller_
+          module Caller
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            variant :direct, -> { OpenAI::Beta::BetaResponseInputItem::ShellCallOutput::Caller::Direct }
+
+            variant :program, -> { OpenAI::Beta::BetaResponseInputItem::ShellCallOutput::Caller::Program }
+
+            class Direct < OpenAI::Internal::Type::BaseModel
+              # @!attribute type
+              #   The caller type. Always `direct`.
+              #
+              #   @return [Symbol, :direct]
+              required :type, const: :direct
+
+              # @!method initialize(type: :direct)
+              #   @param type [Symbol, :direct] The caller type. Always `direct`.
+            end
+
+            class Program < OpenAI::Internal::Type::BaseModel
+              # @!attribute caller_id
+              #   The call ID of the program item that produced this tool call.
+              #
+              #   @return [String]
+              required :caller_id, String
+
+              # @!attribute type
+              #   The caller type. Always `program`.
+              #
+              #   @return [Symbol, :program]
+              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 type [Symbol, :program] The caller type. Always `program`.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput::Caller::Program)]
+          end
+
+          # The status of the shell call output.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class ApplyPatchCall < OpenAI::Internal::Type::BaseModel
+          # @!attribute call_id
+          #   The unique ID of the apply patch tool call generated by the model.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute operation
+          #   The specific create, delete, or update instruction for the apply_patch tool
+          #   call.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::CreateFile, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::DeleteFile, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::UpdateFile]
+          required :operation, union: -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall::Operation }
+
+          # @!attribute status
+          #   The status of the apply patch tool call. One of `in_progress` or `completed`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Status]
+          required :status, enum: -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall::Status }
+
+          # @!attribute type
+          #   The type of the item. Always `apply_patch_call`.
+          #
+          #   @return [Symbol, :apply_patch_call]
+          required :type, const: :apply_patch_call
+
+          # @!attribute id
+          #   The unique ID of the apply patch tool call. Populated when this item is returned
+          #   via API.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall::Agent }, nil?: true
+
+          # @!attribute caller_
+          #   The execution context that produced this tool call.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Caller::Program, nil]
+          optional :caller_,
+                   union: -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall::Caller },
+                   api_name: :caller,
+                   nil?: true
+
+          # @!method initialize(call_id:, operation:, status:, id: nil, agent: nil, caller_: nil, type: :apply_patch_call)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Beta::BetaResponseInputItem::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 operation [OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::CreateFile, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::DeleteFile, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::UpdateFile] The specific create, delete, or update instruction for the apply_patch tool call
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::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 agent [OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Agent, nil] The agent that produced this item.
+          #
+          #   @param caller_ [OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::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`.
+
+          # The specific create, delete, or update instruction for the apply_patch tool
+          # call.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall#operation
+          module Operation
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            # Instruction for creating a new file via the apply_patch tool.
+            variant :create_file, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::CreateFile }
+
+            # Instruction for deleting an existing file via the apply_patch tool.
+            variant :delete_file, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::DeleteFile }
+
+            # Instruction for updating an existing file via the apply_patch tool.
+            variant :update_file, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::UpdateFile }
+
+            class CreateFile < OpenAI::Internal::Type::BaseModel
+              # @!attribute diff
+              #   Unified diff content to apply when creating the file.
+              #
+              #   @return [String]
+              required :diff, String
+
+              # @!attribute path
+              #   Path of the file to create relative to the workspace root.
+              #
+              #   @return [String]
+              required :path, String
+
+              # @!attribute type
+              #   The operation type. Always `create_file`.
+              #
+              #   @return [Symbol, :create_file]
+              required :type, const: :create_file
+
+              # @!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 path [String] Path of the file to create relative to the workspace root.
+              #
+              #   @param type [Symbol, :create_file] The operation type. Always `create_file`.
+            end
+
+            class DeleteFile < OpenAI::Internal::Type::BaseModel
+              # @!attribute path
+              #   Path of the file to delete relative to the workspace root.
+              #
+              #   @return [String]
+              required :path, String
+
+              # @!attribute type
+              #   The operation type. Always `delete_file`.
+              #
+              #   @return [Symbol, :delete_file]
+              required :type, const: :delete_file
+
+              # @!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 type [Symbol, :delete_file] The operation type. Always `delete_file`.
+            end
+
+            class UpdateFile < OpenAI::Internal::Type::BaseModel
+              # @!attribute diff
+              #   Unified diff content to apply to the existing file.
+              #
+              #   @return [String]
+              required :diff, String
+
+              # @!attribute path
+              #   Path of the file to update relative to the workspace root.
+              #
+              #   @return [String]
+              required :path, String
+
+              # @!attribute type
+              #   The operation type. Always `update_file`.
+              #
+              #   @return [Symbol, :update_file]
+              required :type, const: :update_file
+
+              # @!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 path [String] Path of the file to update relative to the workspace root.
+              #
+              #   @param type [Symbol, :update_file] The operation type. Always `update_file`.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::CreateFile, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::DeleteFile, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Operation::UpdateFile)]
+          end
+
+          # The status of the apply patch tool call. One of `in_progress` or `completed`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+
+          # The execution context that produced this tool call.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall#caller_
+          module Caller
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            variant :direct, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall::Caller::Direct }
+
+            variant :program, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCall::Caller::Program }
+
+            class Direct < OpenAI::Internal::Type::BaseModel
+              # @!attribute type
+              #   The caller type. Always `direct`.
+              #
+              #   @return [Symbol, :direct]
+              required :type, const: :direct
+
+              # @!method initialize(type: :direct)
+              #   @param type [Symbol, :direct] The caller type. Always `direct`.
+            end
+
+            class Program < OpenAI::Internal::Type::BaseModel
+              # @!attribute caller_id
+              #   The call ID of the program item that produced this tool call.
+              #
+              #   @return [String]
+              required :caller_id, String
+
+              # @!attribute type
+              #   The caller type. Always `program`.
+              #
+              #   @return [Symbol, :program]
+              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 type [Symbol, :program] The caller type. Always `program`.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall::Caller::Program)]
+          end
+        end
+
+        class ApplyPatchCallOutput < OpenAI::Internal::Type::BaseModel
+          # @!attribute call_id
+          #   The unique ID of the apply patch tool call generated by the model.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute status
+          #   The status of the apply patch tool call output. One of `completed` or `failed`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Status]
+          required :status, enum: -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Status }
+
+          # @!attribute type
+          #   The type of the item. Always `apply_patch_call_output`.
+          #
+          #   @return [Symbol, :apply_patch_call_output]
+          required :type, const: :apply_patch_call_output
+
+          # @!attribute id
+          #   The unique ID of the apply patch tool call output. Populated when this item is
+          #   returned via API.
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Agent }, nil?: true
+
+          # @!attribute caller_
+          #   The execution context that produced this tool call.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Caller::Program, nil]
+          optional :caller_,
+                   union: -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Caller },
+                   api_name: :caller,
+                   nil?: true
+
+          # @!attribute output
+          #   Optional human-readable log text from the apply patch tool (e.g., patch results
+          #   or errors).
+          #
+          #   @return [String, nil]
+          optional :output, String, nil?: true
+
+          # @!method initialize(call_id:, status:, id: nil, agent: nil, caller_: nil, output: nil, type: :apply_patch_call_output)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Beta::BetaResponseInputItem::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 status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::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 agent [OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Agent, nil] The agent that produced this item.
+          #
+          #   @param caller_ [OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::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 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`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            COMPLETED = :completed
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+
+          # The execution context that produced this tool call.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput#caller_
+          module Caller
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            variant :direct, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Caller::Direct }
+
+            variant :program, -> { OpenAI::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Caller::Program }
+
+            class Direct < OpenAI::Internal::Type::BaseModel
+              # @!attribute type
+              #   The caller type. Always `direct`.
+              #
+              #   @return [Symbol, :direct]
+              required :type, const: :direct
+
+              # @!method initialize(type: :direct)
+              #   @param type [Symbol, :direct] The caller type. Always `direct`.
+            end
+
+            class Program < OpenAI::Internal::Type::BaseModel
+              # @!attribute caller_id
+              #   The call ID of the program item that produced this tool call.
+              #
+              #   @return [String]
+              required :caller_id, String
+
+              # @!attribute type
+              #   The caller type. Always `program`.
+              #
+              #   @return [Symbol, :program]
+              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 type [Symbol, :program] The caller type. Always `program`.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Caller::Direct, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput::Caller::Program)]
+          end
+        end
+
+        class McpListTools < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the list.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute server_label
+          #   The label of the MCP server.
+          #
+          #   @return [String]
+          required :server_label, String
+
+          # @!attribute tools
+          #   The tools available on the server.
+          #
+          #   @return [Array<OpenAI::Models::Beta::BetaResponseInputItem::McpListTools::Tool>]
+          required :tools,
+                   -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::BetaResponseInputItem::McpListTools::Tool] }
+
+          # @!attribute type
+          #   The type of the item. Always `mcp_list_tools`.
+          #
+          #   @return [Symbol, :mcp_list_tools]
+          required :type, const: :mcp_list_tools
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::McpListTools::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::McpListTools::Agent }, nil?: true
+
+          # @!attribute error
+          #   Error message if the server could not list tools.
+          #
+          #   @return [String, nil]
+          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::BetaResponseInputItem::McpListTools} for more details.
+          #
+          #   A list of tools available on an MCP server.
+          #
+          #   @param id [String] The unique ID of the list.
+          #
+          #   @param server_label [String] The label of the MCP server.
+          #
+          #   @param tools [Array<OpenAI::Models::Beta::BetaResponseInputItem::McpListTools::Tool>] The tools available on the server.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::McpListTools::Agent, nil] The agent that produced this item.
+          #
+          #   @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`.
+
+          class Tool < OpenAI::Internal::Type::BaseModel
+            # @!attribute input_schema
+            #   The JSON schema describing the tool's input.
+            #
+            #   @return [Object]
+            required :input_schema, OpenAI::Internal::Type::Unknown
+
+            # @!attribute name
+            #   The name of the tool.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute annotations
+            #   Additional annotations about the tool.
+            #
+            #   @return [Object, nil]
+            optional :annotations, OpenAI::Internal::Type::Unknown, nil?: true
+
+            # @!attribute description
+            #   The description of the tool.
+            #
+            #   @return [String, nil]
+            optional :description, String, nil?: true
+
+            # @!method initialize(input_schema:, name:, annotations: nil, description: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {OpenAI::Models::Beta::BetaResponseInputItem::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 name [String] The name of the tool.
+            #
+            #   @param annotations [Object, nil] Additional annotations about the tool.
+            #
+            #   @param description [String, nil] The description of the tool.
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::McpListTools#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class McpApprovalRequest < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the approval request.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute arguments
+          #   A JSON string of arguments for the tool.
+          #
+          #   @return [String]
+          required :arguments, String
+
+          # @!attribute name
+          #   The name of the tool to run.
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!attribute server_label
+          #   The label of the MCP server making the request.
+          #
+          #   @return [String]
+          required :server_label, String
+
+          # @!attribute type
+          #   The type of the item. Always `mcp_approval_request`.
+          #
+          #   @return [Symbol, :mcp_approval_request]
+          required :type, const: :mcp_approval_request
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalRequest::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::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::BetaResponseInputItem::McpApprovalRequest} for more
+          #   details.
+          #
+          #   A request for human approval of a tool invocation.
+          #
+          #   @param id [String] The unique ID of the approval request.
+          #
+          #   @param arguments [String] A JSON string of arguments for the tool.
+          #
+          #   @param name [String] The name of the tool to run.
+          #
+          #   @param server_label [String] The label of the MCP server making the request.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalRequest::Agent, nil] The agent that produced this item.
+          #
+          #   @param type [Symbol, :mcp_approval_request] The type of the item. Always `mcp_approval_request`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalRequest#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class McpApprovalResponse < OpenAI::Internal::Type::BaseModel
+          # @!attribute approval_request_id
+          #   The ID of the approval request being answered.
+          #
+          #   @return [String]
+          required :approval_request_id, String
+
+          # @!attribute approve
+          #   Whether the request was approved.
+          #
+          #   @return [Boolean]
+          required :approve, OpenAI::Internal::Type::Boolean
+
+          # @!attribute type
+          #   The type of the item. Always `mcp_approval_response`.
+          #
+          #   @return [Symbol, :mcp_approval_response]
+          required :type, const: :mcp_approval_response
+
+          # @!attribute id
+          #   The unique ID of the approval response
+          #
+          #   @return [String, nil]
+          optional :id, String, nil?: true
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalResponse::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::McpApprovalResponse::Agent }, nil?: true
+
+          # @!attribute reason
+          #   Optional reason for the decision.
+          #
+          #   @return [String, nil]
+          optional :reason, String, nil?: true
+
+          # @!method initialize(approval_request_id:, approve:, id: nil, agent: nil, reason: nil, type: :mcp_approval_response)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Beta::BetaResponseInputItem::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 approve [Boolean] Whether the request was approved.
+          #
+          #   @param id [String, nil] The unique ID of the approval response
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalResponse::Agent, nil] The agent that produced this item.
+          #
+          #   @param reason [String, nil] Optional reason for the decision.
+          #
+          #   @param type [Symbol, :mcp_approval_response] The type of the item. Always `mcp_approval_response`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalResponse#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class McpCall < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of the tool call.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute arguments
+          #   A JSON string of the arguments passed to the tool.
+          #
+          #   @return [String]
+          required :arguments, String
+
+          # @!attribute name
+          #   The name of the tool that was run.
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!attribute server_label
+          #   The label of the MCP server running the tool.
+          #
+          #   @return [String]
+          required :server_label, String
+
+          # @!attribute type
+          #   The type of the item. Always `mcp_call`.
+          #
+          #   @return [Symbol, :mcp_call]
+          required :type, const: :mcp_call
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::McpCall::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::McpCall::Agent }, nil?: true
+
+          # @!attribute approval_request_id
+          #   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.
+          #
+          #   @return [String, nil]
+          optional :approval_request_id, String, nil?: true
+
+          # @!attribute error
+          #   The error from the tool call, if any.
+          #
+          #   @return [String, nil]
+          optional :error, String, nil?: true
+
+          # @!attribute output
+          #   The output from the tool call.
+          #
+          #   @return [String, nil]
+          optional :output, String, nil?: true
+
+          # @!attribute status
+          #   The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+          #   `calling`, or `failed`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::McpCall::Status, nil]
+          optional :status, enum: -> { OpenAI::Beta::BetaResponseInputItem::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::BetaResponseInputItem::McpCall} for more details.
+          #
+          #   An invocation of a tool on an MCP server.
+          #
+          #   @param id [String] The unique ID of the tool call.
+          #
+          #   @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 server_label [String] The label of the MCP server running the tool.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::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 error [String, nil] The error from the tool call, if any.
+          #
+          #   @param output [String, nil] The output from the tool call.
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::McpCall::Status] The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `c
+          #
+          #   @param type [Symbol, :mcp_call] The type of the item. Always `mcp_call`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::McpCall#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   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`,
+          # `calling`, or `failed`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::McpCall#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            IN_PROGRESS = :in_progress
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+            CALLING = :calling
+            FAILED = :failed
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class CompactionTrigger < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the item. Always `compaction_trigger`.
+          #
+          #   @return [Symbol, :compaction_trigger]
+          required :type, const: :compaction_trigger
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::CompactionTrigger::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::CompactionTrigger::Agent }, nil?: true
+
+          # @!method initialize(agent: nil, type: :compaction_trigger)
+          #   Compacts the current context. Must be the final input item.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::CompactionTrigger::Agent, nil] The agent that produced this item.
+          #
+          #   @param type [Symbol, :compaction_trigger] The type of the item. Always `compaction_trigger`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::CompactionTrigger#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class ItemReference < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The ID of the item to reference.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ItemReference::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::ItemReference::Agent }, nil?: true
+
+          # @!attribute type
+          #   The type of item to reference. Always `item_reference`.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ItemReference::Type, nil]
+          optional :type, enum: -> { OpenAI::Beta::BetaResponseInputItem::ItemReference::Type }, nil?: true
+
+          # @!method initialize(id:, agent: nil, type: nil)
+          #   An internal identifier for an item to reference.
+          #
+          #   @param id [String] The ID of the item to reference.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::ItemReference::Agent, nil] The agent that produced this item.
+          #
+          #   @param type [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ItemReference::Type, nil] The type of item to reference. Always `item_reference`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ItemReference#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+
+          # The type of item to reference. Always `item_reference`.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ItemReference#type
+          module Type
+            extend OpenAI::Internal::Type::Enum
+
+            ITEM_REFERENCE = :item_reference
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        class Program < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of this program item.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute call_id
+          #   The stable call ID of the program item.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute code
+          #   The JavaScript source executed by programmatic tool calling.
+          #
+          #   @return [String]
+          required :code, String
+
+          # @!attribute fingerprint
+          #   Opaque program replay fingerprint that must be round-tripped.
+          #
+          #   @return [String]
+          required :fingerprint, String
+
+          # @!attribute type
+          #   The item type. Always `program`.
+          #
+          #   @return [Symbol, :program]
+          required :type, const: :program
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::Program::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::Program::Agent }, nil?: true
+
+          # @!method initialize(id:, call_id:, code:, fingerprint:, agent: nil, type: :program)
+          #   @param id [String] The unique ID of this 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 fingerprint [String] Opaque program replay fingerprint that must be round-tripped.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::Program::Agent, nil] The agent that produced this item.
+          #
+          #   @param type [Symbol, :program] The item type. Always `program`.
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::Program#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        class ProgramOutput < OpenAI::Internal::Type::BaseModel
+          # @!attribute id
+          #   The unique ID of this program output item.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute call_id
+          #   The call ID of the program item.
+          #
+          #   @return [String]
+          required :call_id, String
+
+          # @!attribute result
+          #   The result produced by the program item.
+          #
+          #   @return [String]
+          required :result, String
+
+          # @!attribute status
+          #   The terminal status of the program output.
+          #
+          #   @return [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput::Status]
+          required :status, enum: -> { OpenAI::Beta::BetaResponseInputItem::ProgramOutput::Status }
+
+          # @!attribute type
+          #   The item type. Always `program_output`.
+          #
+          #   @return [Symbol, :program_output]
+          required :type, const: :program_output
+
+          # @!attribute agent
+          #   The agent that produced this item.
+          #
+          #   @return [OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput::Agent, nil]
+          optional :agent, -> { OpenAI::Beta::BetaResponseInputItem::ProgramOutput::Agent }, nil?: true
+
+          # @!method initialize(id:, call_id:, result:, status:, agent: nil, type: :program_output)
+          #   @param id [String] The unique ID of this program output item.
+          #
+          #   @param call_id [String] The call ID of the program item.
+          #
+          #   @param result [String] The result produced by the program item.
+          #
+          #   @param status [Symbol, OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput::Status] The terminal status of the program output.
+          #
+          #   @param agent [OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput::Agent, nil] The agent that produced this item.
+          #
+          #   @param type [Symbol, :program_output] The item type. Always `program_output`.
+
+          # The terminal status of the program output.
+          #
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput#status
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            COMPLETED = :completed
+            INCOMPLETE = :incomplete
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput#agent
+          class Agent < OpenAI::Internal::Type::BaseModel
+            # @!attribute agent_name
+            #   The canonical name of the agent that produced this item.
+            #
+            #   @return [String]
+            required :agent_name, String
+
+            # @!method initialize(agent_name:)
+            #   The agent that produced this item.
+            #
+            #   @param agent_name [String] The canonical name of the agent that produced this item.
+          end
+        end
+
+        # @!method self.variants
+        #   @return [Array(OpenAI::Models::Beta::BetaEasyInputMessage, OpenAI::Models::Beta::BetaResponseInputItem::Message, OpenAI::Models::Beta::BetaResponseOutputMessage, OpenAI::Models::Beta::BetaResponseFileSearchToolCall, OpenAI::Models::Beta::BetaResponseComputerToolCall, OpenAI::Models::Beta::BetaResponseInputItem::ComputerCallOutput, OpenAI::Models::Beta::BetaResponseFunctionWebSearch, OpenAI::Models::Beta::BetaResponseFunctionToolCall, OpenAI::Models::Beta::BetaResponseInputItem::FunctionCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::AgentMessage, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCall, OpenAI::Models::Beta::BetaResponseInputItem::MultiAgentCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ToolSearchCall, OpenAI::Models::Beta::BetaResponseToolSearchOutputItemParam, OpenAI::Models::Beta::BetaResponseInputItem::AdditionalTools, OpenAI::Models::Beta::BetaResponseReasoningItem, OpenAI::Models::Beta::BetaResponseCompactionItemParam, OpenAI::Models::Beta::BetaResponseInputItem::ImageGenerationCall, OpenAI::Models::Beta::BetaResponseCodeInterpreterToolCall, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCall, OpenAI::Models::Beta::BetaResponseInputItem::LocalShellCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ShellCall, OpenAI::Models::Beta::BetaResponseInputItem::ShellCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCall, OpenAI::Models::Beta::BetaResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Beta::BetaResponseInputItem::McpListTools, OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalRequest, OpenAI::Models::Beta::BetaResponseInputItem::McpApprovalResponse, OpenAI::Models::Beta::BetaResponseInputItem::McpCall, OpenAI::Models::Beta::BetaResponseCustomToolCallOutput, OpenAI::Models::Beta::BetaResponseCustomToolCall, OpenAI::Models::Beta::BetaResponseInputItem::CompactionTrigger, OpenAI::Models::Beta::BetaResponseInputItem::ItemReference, OpenAI::Models::Beta::BetaResponseInputItem::Program, OpenAI::Models::Beta::BetaResponseInputItem::ProgramOutput)]
+      end
+    end
+
+    BetaResponseInputItem = Beta::BetaResponseInputItem
+  end
+end