openai 0.1.0.pre.beta.2 → 0.1.0

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

@@ -1,876 +0,0 @@
-# frozen_string_literal: true
-
-module OpenAI
-  module Models
-    module Responses
-      # 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 ResponseInputItem
-        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::Responses::EasyInputMessage }
-
-        # 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::Responses::ResponseInputItem::Message }
-
-        # An output message from the model.
-        variant :message, -> { OpenAI::Responses::ResponseOutputMessage }
-
-        # The results of a file search tool call. See the
-        # [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more information.
-        variant :file_search_call, -> { OpenAI::Responses::ResponseFileSearchToolCall }
-
-        # A tool call to a computer use tool. See the
-        # [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more information.
-        variant :computer_call, -> { OpenAI::Responses::ResponseComputerToolCall }
-
-        # The output of a computer tool call.
-        variant :computer_call_output, -> { OpenAI::Responses::ResponseInputItem::ComputerCallOutput }
-
-        # The results of a web search tool call. See the
-        # [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more information.
-        variant :web_search_call, -> { OpenAI::Responses::ResponseFunctionWebSearch }
-
-        # A tool call to run a function. See the
-        # [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more information.
-        variant :function_call, -> { OpenAI::Responses::ResponseFunctionToolCall }
-
-        # The output of a function tool call.
-        variant :function_call_output, -> { OpenAI::Responses::ResponseInputItem::FunctionCallOutput }
-
-        # 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::Responses::ResponseReasoningItem }
-
-        # An image generation request made by the model.
-        variant :image_generation_call, -> { OpenAI::Responses::ResponseInputItem::ImageGenerationCall }
-
-        # A tool call to run code.
-        variant :code_interpreter_call, -> { OpenAI::Responses::ResponseCodeInterpreterToolCall }
-
-        # A tool call to run a command on the local shell.
-        variant :local_shell_call, -> { OpenAI::Responses::ResponseInputItem::LocalShellCall }
-
-        # The output of a local shell tool call.
-        variant :local_shell_call_output, -> { OpenAI::Responses::ResponseInputItem::LocalShellCallOutput }
-
-        # A list of tools available on an MCP server.
-        variant :mcp_list_tools, -> { OpenAI::Responses::ResponseInputItem::McpListTools }
-
-        # A request for human approval of a tool invocation.
-        variant :mcp_approval_request, -> { OpenAI::Responses::ResponseInputItem::McpApprovalRequest }
-
-        # A response to an MCP approval request.
-        variant :mcp_approval_response, -> { OpenAI::Responses::ResponseInputItem::McpApprovalResponse }
-
-        # An invocation of a tool on an MCP server.
-        variant :mcp_call, -> { OpenAI::Responses::ResponseInputItem::McpCall }
-
-        # An internal identifier for an item to reference.
-        variant :item_reference, -> { OpenAI::Responses::ResponseInputItem::ItemReference }
-
-        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::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>]
-          required :content,
-                   -> {
-                     OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseInputContent]
-                   }
-
-          # @!attribute role
-          #   The role of the message input. One of `user`, `system`, or `developer`.
-          #
-          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Role]
-          required :role, enum: -> { OpenAI::Responses::ResponseInputItem::Message::Role }
-
-          # @!attribute status
-          #   The status of item. One of `in_progress`, `completed`, or `incomplete`.
-          #   Populated when items are returned via API.
-          #
-          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Status, nil]
-          optional :status, enum: -> { OpenAI::Responses::ResponseInputItem::Message::Status }
-
-          # @!attribute type
-          #   The type of the message input. Always set to `message`.
-          #
-          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Type, nil]
-          optional :type, enum: -> { OpenAI::Responses::ResponseInputItem::Message::Type }
-
-          # @!method initialize(content:, role:, status: nil, type: nil)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::Message} for more details.
-          #
-          #   A message input to the model with a role indicating instruction following
-          #   hierarchy. Instructions given with the `developer` or `system` role take
-          #   precedence over instructions given with the `user` role.
-          #
-          #   @param content [Array<OpenAI::Models::Responses::ResponseInputText, OpenAI::Models::Responses::ResponseInputImage, OpenAI::Models::Responses::ResponseInputFile>] A list of one or many input items to the model, containing different content
-          #
-          #   @param role [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Role] The role of the message input. One of `user`, `system`, or `developer`.
-          #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Status] The status of item. One of `in_progress`, `completed`, or
-          #
-          #   @param type [Symbol, OpenAI::Models::Responses::ResponseInputItem::Message::Type] The type of the message input. Always set to `message`.
-
-          # The role of the message input. One of `user`, `system`, or `developer`.
-          #
-          # @see OpenAI::Models::Responses::ResponseInputItem::Message#role
-          module Role
-            extend OpenAI::Internal::Type::Enum
-
-            USER = :user
-            SYSTEM = :system
-            DEVELOPER = :developer
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
-
-          # The status of item. One of `in_progress`, `completed`, or `incomplete`.
-          # Populated when items are returned via API.
-          #
-          # @see OpenAI::Models::Responses::ResponseInputItem::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::Responses::ResponseInputItem::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::Responses::ResponseComputerToolCallOutputScreenshot]
-          required :output, -> { OpenAI::Responses::ResponseComputerToolCallOutputScreenshot }
-
-          # @!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::Responses::ResponseInputItem::ComputerCallOutput::AcknowledgedSafetyCheck>, nil]
-          optional :acknowledged_safety_checks,
-                   -> {
-                     OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseInputItem::ComputerCallOutput::AcknowledgedSafetyCheck]
-                   },
-                   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::Responses::ResponseInputItem::ComputerCallOutput::Status, nil]
-          optional :status,
-                   enum: -> { OpenAI::Responses::ResponseInputItem::ComputerCallOutput::Status },
-                   nil?: true
-
-          # @!method initialize(call_id:, output:, id: nil, acknowledged_safety_checks: nil, status: nil, type: :computer_call_output)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput} for more
-          #   details.
-          #
-          #   The output of a computer tool call.
-          #
-          #   @param call_id [String] The ID of the computer tool call that produced the output.
-          #
-          #   @param output [OpenAI::Models::Responses::ResponseComputerToolCallOutputScreenshot] A computer screenshot image used with the computer use tool.
-          #
-          #   @param id [String, nil] The ID of the computer tool call output.
-          #
-          #   @param acknowledged_safety_checks [Array<OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput::AcknowledgedSafetyCheck>, nil] The safety checks reported by the API that have been acknowledged by the develop
-          #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::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
-
-          # The status of the message input. One of `in_progress`, `completed`, or
-          # `incomplete`. Populated when input items are returned via API.
-          #
-          # @see OpenAI::Models::Responses::ResponseInputItem::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
-          #   A JSON string of the output of the function tool call.
-          #
-          #   @return [String]
-          required :output, String
-
-          # @!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 status
-          #   The status of the item. One of `in_progress`, `completed`, or `incomplete`.
-          #   Populated when items are returned via API.
-          #
-          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput::Status, nil]
-          optional :status,
-                   enum: -> { OpenAI::Responses::ResponseInputItem::FunctionCallOutput::Status },
-                   nil?: true
-
-          # @!method initialize(call_id:, output:, id: nil, status: nil, type: :function_call_output)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput} for more
-          #   details.
-          #
-          #   The output of a function tool call.
-          #
-          #   @param call_id [String] The unique ID of the function tool call generated by the model.
-          #
-          #   @param output [String] A JSON string of the 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 status [Symbol, OpenAI::Models::Responses::ResponseInputItem::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`.
-
-          # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
-          # Populated when items are returned via API.
-          #
-          # @see OpenAI::Models::Responses::ResponseInputItem::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 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::Responses::ResponseInputItem::ImageGenerationCall::Status]
-          required :status, enum: -> { OpenAI::Responses::ResponseInputItem::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
-
-          # @!method initialize(id:, result:, status:, type: :image_generation_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::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::Responses::ResponseInputItem::ImageGenerationCall::Status] The status of the image generation call.
-          #
-          #   @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::Responses::ResponseInputItem::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
-        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::Responses::ResponseInputItem::LocalShellCall::Action]
-          required :action, -> { OpenAI::Responses::ResponseInputItem::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::Responses::ResponseInputItem::LocalShellCall::Status]
-          required :status, enum: -> { OpenAI::Responses::ResponseInputItem::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
-
-          # @!method initialize(id:, action:, call_id:, status:, type: :local_shell_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::LocalShellCall} for more details.
-          #
-          #   A tool call to run a command on the local shell.
-          #
-          #   @param id [String] The unique ID of the local shell call.
-          #
-          #   @param action [OpenAI::Models::Responses::ResponseInputItem::LocalShellCall::Action] Execute a shell command on the server.
-          #
-          #   @param call_id [String] The unique ID of the local shell tool call generated by the model.
-          #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall::Status] The status of the local shell call.
-          #
-          #   @param type [Symbol, :local_shell_call] The type of the local shell call. Always `local_shell_call`.
-
-          # @see OpenAI::Models::Responses::ResponseInputItem::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)
-            #   Some parameter documentations has been truncated, see
-            #   {OpenAI::Models::Responses::ResponseInputItem::LocalShellCall::Action} for more
-            #   details.
-            #
-            #   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::Responses::ResponseInputItem::LocalShellCall#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 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 status
-          #   The status of the item. One of `in_progress`, `completed`, or `incomplete`.
-          #
-          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput::Status, nil]
-          optional :status,
-                   enum: -> { OpenAI::Responses::ResponseInputItem::LocalShellCallOutput::Status },
-                   nil?: true
-
-          # @!method initialize(id:, output:, status: nil, type: :local_shell_call_output)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput} for more
-          #   details.
-          #
-          #   The output of a local shell tool call.
-          #
-          #   @param id [String] The unique ID of the local shell tool call generated by the model.
-          #
-          #   @param output [String] A JSON string of the output of the local shell tool call.
-          #
-          #   @param status [Symbol, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput::Status, nil] The status of the item. One of `in_progress`, `completed`, or `incomplete`.
-          #
-          #   @param type [Symbol, :local_shell_call_output] The type of the local shell tool call output. Always `local_shell_call_output`.
-
-          # The status of the item. One of `in_progress`, `completed`, or `incomplete`.
-          #
-          # @see OpenAI::Models::Responses::ResponseInputItem::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 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::Responses::ResponseInputItem::McpListTools::Tool>]
-          required :tools,
-                   -> {
-                     OpenAI::Internal::Type::ArrayOf[OpenAI::Responses::ResponseInputItem::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 error
-          #   Error message if the server could not list tools.
-          #
-          #   @return [String, nil]
-          optional :error, String, nil?: true
-
-          # @!method initialize(id:, server_label:, tools:, error: nil, type: :mcp_list_tools)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::McpListTools} for more details.
-          #
-          #   A list of tools available on an MCP server.
-          #
-          #   @param id [String] The unique ID of the list.
-          #
-          #   @param server_label [String] The label of the MCP server.
-          #
-          #   @param tools [Array<OpenAI::Models::Responses::ResponseInputItem::McpListTools::Tool>] The tools available on the server.
-          #
-          #   @param 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::Responses::ResponseInputItem::McpListTools::Tool} for more
-            #   details.
-            #
-            #   A tool available on an MCP server.
-            #
-            #   @param input_schema [Object] The JSON schema describing the tool's input.
-            #
-            #   @param 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
-        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
-
-          # @!method initialize(id:, arguments:, name:, server_label:, type: :mcp_approval_request)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest} for more
-          #   details.
-          #
-          #   A request for human approval of a tool invocation.
-          #
-          #   @param id [String] The unique ID of the approval request.
-          #
-          #   @param 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 type [Symbol, :mcp_approval_request] The type of the item. Always `mcp_approval_request`.
-        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 reason
-          #   Optional reason for the decision.
-          #
-          #   @return [String, nil]
-          optional :reason, String, nil?: true
-
-          # @!method initialize(approval_request_id:, approve:, id: nil, reason: nil, type: :mcp_approval_response)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse} for more
-          #   details.
-          #
-          #   A response to an MCP approval request.
-          #
-          #   @param approval_request_id [String] The ID of the approval request being answered.
-          #
-          #   @param approve [Boolean] Whether the request was approved.
-          #
-          #   @param id [String, nil] The unique ID of the approval response
-          #
-          #   @param reason [String, nil] Optional reason for the decision.
-          #
-          #   @param type [Symbol, :mcp_approval_response] The type of the item. Always `mcp_approval_response`.
-        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 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
-
-          # @!method initialize(id:, arguments:, name:, server_label:, error: nil, output: nil, type: :mcp_call)
-          #   Some parameter documentations has been truncated, see
-          #   {OpenAI::Models::Responses::ResponseInputItem::McpCall} for more details.
-          #
-          #   An invocation of a tool on an MCP server.
-          #
-          #   @param id [String] The unique ID of the tool call.
-          #
-          #   @param 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 error [String, nil] The error from the tool call, if any.
-          #
-          #   @param output [String, nil] The output from the tool call.
-          #
-          #   @param type [Symbol, :mcp_call] The type of the item. Always `mcp_call`.
-        end
-
-        class ItemReference < OpenAI::Internal::Type::BaseModel
-          # @!attribute id
-          #   The ID of the item to reference.
-          #
-          #   @return [String]
-          required :id, String
-
-          # @!attribute type
-          #   The type of item to reference. Always `item_reference`.
-          #
-          #   @return [Symbol, OpenAI::Models::Responses::ResponseInputItem::ItemReference::Type, nil]
-          optional :type, enum: -> { OpenAI::Responses::ResponseInputItem::ItemReference::Type }, nil?: true
-
-          # @!method initialize(id:, type: nil)
-          #   An internal identifier for an item to reference.
-          #
-          #   @param id [String] The ID of the item to reference.
-          #
-          #   @param type [Symbol, OpenAI::Models::Responses::ResponseInputItem::ItemReference::Type, nil] The type of item to reference. Always `item_reference`.
-
-          # The type of item to reference. Always `item_reference`.
-          #
-          # @see OpenAI::Models::Responses::ResponseInputItem::ItemReference#type
-          module Type
-            extend OpenAI::Internal::Type::Enum
-
-            ITEM_REFERENCE = :item_reference
-
-            # @!method self.values
-            #   @return [Array<Symbol>]
-          end
-        end
-
-        # @!method self.variants
-        #   @return [Array(OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference)]
-      end
-    end
-  end
-end