openai 0.100.0 → 0.101.0

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

@@ -7,8 +7,11 @@ module OpenAI
         # @!attribute tools
         #   The loaded tool definitions returned by the tool search output.
         #
-        #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>]
-        required :tools, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::Tool] }
+        #   @return [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::ToolSearchOutputNamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>]
+        required(
+          :tools,
+          -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool] }
+        )
 
         # @!attribute type
         #   The item type. Always `tool_search_output`.
@@ -47,7 +50,7 @@ module OpenAI
         )
 
         # @!method initialize(tools:, id: nil, call_id: nil, execution: nil, status: nil, type: :tool_search_output)
-        #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::NamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>]
+        #   @param tools [Array<OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::ToolSearchOutputNamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool>]
         #     The loaded tool definitions returned by the tool search output.
         #
         #   @param id [String, nil]
@@ -65,6 +68,1166 @@ module OpenAI
         #   @param type [Symbol, :tool_search_output]
         #     The item type. Always `tool_search_output`.
 
+        # A tool definition returned by a tool search output.
+        module Tool
+          extend OpenAI::Internal::Type::Union
+
+          # Defines a function in your own code the model can choose to call. Learn more about [function calling](https://developers.openai.com/api/docs/guides/function-calling).
+          variant -> { OpenAI::Responses::FunctionTool }
+
+          # A tool that searches for relevant content from uploaded files. Learn more about the [file search tool](https://developers.openai.com/api/docs/guides/tools-file-search).
+          variant -> { OpenAI::Responses::FileSearchTool }
+
+          # A tool that controls a virtual computer. Learn more about the [computer tool](https://developers.openai.com/api/docs/guides/tools-computer-use).
+          variant -> { OpenAI::Responses::ComputerTool }
+
+          # A tool that controls a virtual computer. Learn more about the [computer tool](https://developers.openai.com/api/docs/guides/tools-computer-use).
+          variant -> { OpenAI::Responses::ComputerUsePreviewTool }
+
+          # Give the model access to additional tools via remote Model Context Protocol
+          # (MCP) servers. [Learn more about MCP](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
+          variant -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp }
+
+          # A tool that runs Python code to help generate a response to a prompt.
+          variant -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter }
+
+          variant -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ProgrammaticToolCalling }
+
+          # A tool that generates images using the GPT image models.
+          variant -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration }
+
+          # A tool that allows the model to execute shell commands in a local environment.
+          variant -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::LocalShell }
+
+          # A tool that allows the model to execute shell commands.
+          variant -> { OpenAI::Responses::FunctionShellTool }
+
+          # A custom tool that processes input using a specified format. Learn more about   [custom tools](https://developers.openai.com/api/docs/guides/function-calling#custom-tools)
+          variant -> { OpenAI::Responses::CustomTool }
+
+          # Groups function/custom tools under a shared namespace.
+          variant -> { OpenAI::Responses::ToolSearchOutputNamespaceTool }
+
+          # Hosted or BYOT tool search configuration for deferred tools.
+          variant -> { OpenAI::Responses::ToolSearchTool }
+
+          # Allows the assistant to create, delete, or update files using unified diffs.
+          variant -> { OpenAI::Responses::ApplyPatchTool }
+
+          # Search the Internet for sources related to the prompt. Learn more about the
+          # [web search tool](https://developers.openai.com/api/docs/guides/tools-web-search).
+          variant -> { OpenAI::Responses::WebSearchTool }
+
+          # This tool searches the web for relevant results to use in a response. Learn more about the [web search tool](https://developers.openai.com/api/docs/guides/tools-web-search).
+          variant -> { OpenAI::Responses::WebSearchPreviewTool }
+
+          class Mcp < OpenAI::Internal::Type::BaseModel
+            # @!attribute server_label
+            #   A label for this MCP server, used to identify it in tool calls.
+            #
+            #   @return [String]
+            required :server_label, String
+
+            # @!attribute type
+            #   The type of the MCP tool. Always `mcp`.
+            #
+            #   @return [Symbol, :mcp]
+            required :type, const: :mcp
+
+            # @!attribute allowed_callers
+            #   The tool invocation context(s).
+            #
+            #   @return [Array<Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::AllowedCaller>, nil]
+            optional(
+              :allowed_callers,
+              -> {
+                OpenAI::Internal::Type::ArrayOf[
+                  enum: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::AllowedCaller
+                ]
+              },
+              nil?: true
+            )
+
+            # @!attribute allowed_tools
+            #   List of allowed tool names or a filter object.
+            #
+            #   @return [Array<String>, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::AllowedTools::McpToolFilter, nil]
+            optional(
+              :allowed_tools,
+              union: -> {
+                OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::AllowedTools
+              },
+              nil?: true
+            )
+
+            # @!attribute authorization
+            #   An OAuth access token that can be used with a remote MCP server, either with a
+            #   custom MCP server URL or a service connector. Your application must handle the
+            #   OAuth authorization flow and provide the token here.
+            #
+            #   @return [String, nil]
+            optional :authorization, String
+
+            # @!attribute connector_id
+            #   @deprecated
+            #
+            #   Identifier for service connectors, like those available in ChatGPT. One of
+            #   `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+            #   service connectors
+            #   [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
+            #
+            #   This field is deprecated for models released after September 1, 2026. Use
+            #   `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+            #   through a Secure MCP Tunnel.
+            #
+            #   Currently supported `connector_id` values are:
+            #
+            #   - Dropbox: `connector_dropbox`
+            #   - Gmail: `connector_gmail`
+            #   - Google Calendar: `connector_googlecalendar`
+            #   - Google Drive: `connector_googledrive`
+            #   - Microsoft Teams: `connector_microsoftteams`
+            #   - Outlook Calendar: `connector_outlookcalendar`
+            #   - Outlook Email: `connector_outlookemail`
+            #   - SharePoint: `connector_sharepoint`
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::ConnectorID, nil]
+            optional(
+              :connector_id,
+              enum: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::ConnectorID }
+            )
+
+            # @!attribute defer_loading
+            #   Whether this MCP tool is deferred and discovered via tool search.
+            #
+            #   @return [Boolean, nil]
+            optional :defer_loading, OpenAI::Internal::Type::Boolean
+
+            # @!attribute headers
+            #   Optional HTTP headers to send to the MCP server. Use for authentication or other
+            #   purposes.
+            #
+            #   @return [Hash{Symbol=>String}, nil]
+            optional :headers, OpenAI::Internal::Type::HashOf[String], nil?: true
+
+            # @!attribute require_approval
+            #   Specify which of the MCP server's tools require approval.
+            #
+            #   @return [OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter, Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalSetting, nil]
+            optional(
+              :require_approval,
+              union: -> {
+                OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval
+              },
+              nil?: true
+            )
+
+            # @!attribute server_description
+            #   Optional description of the MCP server, used to provide more context.
+            #
+            #   @return [String, nil]
+            optional :server_description, String
+
+            # @!attribute server_url
+            #   The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+            #   must be provided.
+            #
+            #   @return [String, nil]
+            optional :server_url, String
+
+            # @!attribute tunnel_id
+            #   The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+            #   `server_url`, `connector_id`, or `tunnel_id` must be provided.
+            #
+            #   @return [String, nil]
+            optional :tunnel_id, String
+
+            # @!method initialize(server_label:, allowed_callers: nil, allowed_tools: nil, authorization: nil, connector_id: nil, defer_loading: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, tunnel_id: nil, type: :mcp)
+            #   Give the model access to additional tools via remote Model Context Protocol
+            #   (MCP) servers.
+            #   [Learn more about MCP](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).
+            #
+            #   @param server_label [String]
+            #     A label for this MCP server, used to identify it in tool calls.
+            #
+            #   @param allowed_callers [Array<Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::AllowedCaller>, nil]
+            #     The tool invocation context(s).
+            #
+            #   @param allowed_tools [Array<String>, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::AllowedTools::McpToolFilter, nil]
+            #     List of allowed tool names or a filter object.
+            #
+            #   @param authorization [String]
+            #     An OAuth access token that can be used with a remote MCP server, either with a
+            #     custom MCP server URL or a service connector. Your application must handle the
+            #     OAuth authorization flow and provide the token here.
+            #
+            #   @param connector_id [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::ConnectorID]
+            #     Identifier for service connectors, like those available in ChatGPT. One of
+            #     `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+            #     service connectors
+            #     [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
+            #
+            #     This field is deprecated for models released after September 1, 2026. Use
+            #     `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+            #     through a Secure MCP Tunnel.
+            #
+            #     Currently supported `connector_id` values are:
+            #
+            #     - Dropbox: `connector_dropbox`
+            #     - Gmail: `connector_gmail`
+            #     - Google Calendar: `connector_googlecalendar`
+            #     - Google Drive: `connector_googledrive`
+            #     - Microsoft Teams: `connector_microsoftteams`
+            #     - Outlook Calendar: `connector_outlookcalendar`
+            #     - Outlook Email: `connector_outlookemail`
+            #     - SharePoint: `connector_sharepoint`
+            #
+            #   @param defer_loading [Boolean]
+            #     Whether this MCP tool is deferred and discovered via tool search.
+            #
+            #   @param headers [Hash{Symbol=>String}, nil]
+            #     Optional HTTP headers to send to the MCP server. Use for authentication or other
+            #     purposes.
+            #
+            #   @param require_approval [OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter, Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalSetting, nil]
+            #     Specify which of the MCP server's tools require approval.
+            #
+            #   @param server_description [String]
+            #     Optional description of the MCP server, used to provide more context.
+            #
+            #   @param server_url [String]
+            #     The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id`
+            #     must be provided.
+            #
+            #   @param tunnel_id [String]
+            #     The Secure MCP Tunnel ID to use instead of a direct server URL. One of
+            #     `server_url`, `connector_id`, or `tunnel_id` must be provided.
+            #
+            #   @param type [Symbol, :mcp]
+            #     The type of the MCP tool. Always `mcp`.
+            module AllowedCaller
+              extend OpenAI::Internal::Type::Enum
+
+              DIRECT = :direct
+              PROGRAMMATIC = :programmatic
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # List of allowed tool names or a filter object.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp#allowed_tools
+            module AllowedTools
+              extend OpenAI::Internal::Type::Union
+
+              # A string array of allowed tool names
+              variant(
+                -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::AllowedTools::StringArray
+                }
+              )
+
+              # A filter object to specify which tools are allowed.
+              variant(
+                -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::AllowedTools::McpToolFilter }
+              )
+
+              class McpToolFilter < OpenAI::Internal::Type::BaseModel
+                # @!attribute read_only
+                #   Indicates whether or not a tool modifies data or is read-only. If an MCP server
+                #   is
+                #   [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                #   it will match this filter.
+                #
+                #   @return [Boolean, nil]
+                optional :read_only, OpenAI::Internal::Type::Boolean
+
+                # @!attribute tool_names
+                #   List of allowed tool names.
+                #
+                #   @return [Array<String>, nil]
+                optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
+
+                # @!method initialize(read_only: nil, tool_names: nil)
+                #   A filter object to specify which tools are allowed.
+                #
+                #   @param read_only [Boolean]
+                #     Indicates whether or not a tool modifies data or is read-only. If an MCP server
+                #     is
+                #     [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                #     it will match this filter.
+                #
+                #   @param tool_names [Array<String>]
+                #     List of allowed tool names.
+              end
+
+              # @!method self.variants
+              #   @return [Array(Array<String>, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::AllowedTools::McpToolFilter)]
+
+              # @type [OpenAI::Internal::Type::Converter]
+              StringArray = OpenAI::Internal::Type::ArrayOf[String]
+            end
+
+            # @deprecated
+            #
+            # Identifier for service connectors, like those available in ChatGPT. One of
+            # `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+            # service connectors
+            # [here](https://developers.openai.com/api/docs/guides/tools-connectors-mcp#connectors).
+            #
+            # This field is deprecated for models released after September 1, 2026. Use
+            # `server_url` to connect to a remote MCP server, or `tunnel_id` to connect
+            # through a Secure MCP Tunnel.
+            #
+            # Currently supported `connector_id` values are:
+            #
+            # - Dropbox: `connector_dropbox`
+            # - Gmail: `connector_gmail`
+            # - Google Calendar: `connector_googlecalendar`
+            # - Google Drive: `connector_googledrive`
+            # - Microsoft Teams: `connector_microsoftteams`
+            # - Outlook Calendar: `connector_outlookcalendar`
+            # - Outlook Email: `connector_outlookemail`
+            # - SharePoint: `connector_sharepoint`
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp#connector_id
+            module ConnectorID
+              extend OpenAI::Internal::Type::Enum
+
+              CONNECTOR_DROPBOX = :connector_dropbox
+              CONNECTOR_GMAIL = :connector_gmail
+              CONNECTOR_GOOGLECALENDAR = :connector_googlecalendar
+              CONNECTOR_GOOGLEDRIVE = :connector_googledrive
+              CONNECTOR_MICROSOFTTEAMS = :connector_microsoftteams
+              CONNECTOR_OUTLOOKCALENDAR = :connector_outlookcalendar
+              CONNECTOR_OUTLOOKEMAIL = :connector_outlookemail
+              CONNECTOR_SHAREPOINT = :connector_sharepoint
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Specify which of the MCP server's tools require approval.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp#require_approval
+            module RequireApproval
+              extend OpenAI::Internal::Type::Union
+
+              # Specify which of the MCP server's tools require approval. Can be
+              # `always`, `never`, or a filter object associated with tools
+              # that require approval.
+              variant(
+                -> {
+                  OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter
+                }
+              )
+
+              # Specify a single approval policy for all tools. One of `always` or
+              # `never`. When set to `always`, all tools will require approval. When
+              # set to `never`, all tools will not require approval.
+              variant(
+                enum: -> {
+                  OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalSetting
+                }
+              )
+
+              class McpToolApprovalFilter < OpenAI::Internal::Type::BaseModel
+                # @!attribute always
+                #   A filter object to specify which tools are allowed.
+                #
+                #   @return [OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always, nil]
+                optional(
+                  :always,
+                  -> {
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always
+                  }
+                )
+
+                # @!attribute never
+                #   A filter object to specify which tools are allowed.
+                #
+                #   @return [OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never, nil]
+                optional(
+                  :never,
+                  -> {
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never
+                  }
+                )
+
+                # @!method initialize(always: nil, never: nil)
+                #   Specify which of the MCP server's tools require approval. Can be `always`,
+                #   `never`, or a filter object associated with tools that require approval.
+                #
+                #   @param always [OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always]
+                #     A filter object to specify which tools are allowed.
+                #
+                #   @param never [OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never]
+                #     A filter object to specify which tools are allowed.
+
+                # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter#always
+                class Always < OpenAI::Internal::Type::BaseModel
+                  # @!attribute read_only
+                  #   Indicates whether or not a tool modifies data or is read-only. If an MCP server
+                  #   is
+                  #   [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                  #   it will match this filter.
+                  #
+                  #   @return [Boolean, nil]
+                  optional :read_only, OpenAI::Internal::Type::Boolean
+
+                  # @!attribute tool_names
+                  #   List of allowed tool names.
+                  #
+                  #   @return [Array<String>, nil]
+                  optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
+
+                  # @!method initialize(read_only: nil, tool_names: nil)
+                  #   A filter object to specify which tools are allowed.
+                  #
+                  #   @param read_only [Boolean]
+                  #     Indicates whether or not a tool modifies data or is read-only. If an MCP server
+                  #     is
+                  #     [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                  #     it will match this filter.
+                  #
+                  #   @param tool_names [Array<String>]
+                  #     List of allowed tool names.
+                end
+
+                # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter#never
+                class Never < OpenAI::Internal::Type::BaseModel
+                  # @!attribute read_only
+                  #   Indicates whether or not a tool modifies data or is read-only. If an MCP server
+                  #   is
+                  #   [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                  #   it will match this filter.
+                  #
+                  #   @return [Boolean, nil]
+                  optional :read_only, OpenAI::Internal::Type::Boolean
+
+                  # @!attribute tool_names
+                  #   List of allowed tool names.
+                  #
+                  #   @return [Array<String>, nil]
+                  optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
+
+                  # @!method initialize(read_only: nil, tool_names: nil)
+                  #   A filter object to specify which tools are allowed.
+                  #
+                  #   @param read_only [Boolean]
+                  #     Indicates whether or not a tool modifies data or is read-only. If an MCP server
+                  #     is
+                  #     [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                  #     it will match this filter.
+                  #
+                  #   @param tool_names [Array<String>]
+                  #     List of allowed tool names.
+                end
+              end
+
+              # Specify a single approval policy for all tools. One of `always` or `never`. When
+              # set to `always`, all tools will require approval. When set to `never`, all tools
+              # will not require approval.
+              module McpToolApprovalSetting
+                extend OpenAI::Internal::Type::Enum
+
+                ALWAYS = :always
+                NEVER = :never
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+
+              # @!method self.variants
+              #   @return [Array(OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalFilter, Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp::RequireApproval::McpToolApprovalSetting)]
+            end
+          end
+
+          class CodeInterpreter < OpenAI::Internal::Type::BaseModel
+            # @!attribute container
+            #   The code interpreter container. Can be a container ID or an object that
+            #   specifies uploaded file IDs to make available to your code, along with an
+            #   optional `memory_limit` setting.
+            #
+            #   @return [String, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container::CodeInterpreterToolAuto]
+            required(
+              :container,
+              union: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container }
+            )
+
+            # @!attribute type
+            #   The type of the code interpreter tool. Always `code_interpreter`.
+            #
+            #   @return [Symbol, :code_interpreter]
+            required :type, const: :code_interpreter
+
+            # @!attribute allowed_callers
+            #   The tool invocation context(s).
+            #
+            #   @return [Array<Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::AllowedCaller>, nil]
+            optional(
+              :allowed_callers,
+              -> {
+                OpenAI::Internal::Type::ArrayOf[
+                  enum: OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::AllowedCaller
+                ]
+              },
+              nil?: true
+            )
+
+            # @!method initialize(container:, allowed_callers: nil, type: :code_interpreter)
+            #   A tool that runs Python code to help generate a response to a prompt.
+            #
+            #   @param container [String, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container::CodeInterpreterToolAuto]
+            #     The code interpreter container. Can be a container ID or an object that
+            #     specifies uploaded file IDs to make available to your code, along with an
+            #     optional `memory_limit` setting.
+            #
+            #   @param allowed_callers [Array<Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::AllowedCaller>, nil]
+            #     The tool invocation context(s).
+            #
+            #   @param type [Symbol, :code_interpreter]
+            #     The type of the code interpreter tool. Always `code_interpreter`.
+
+            # The code interpreter container. Can be a container ID or an object that
+            # specifies uploaded file IDs to make available to your code, along with an
+            # optional `memory_limit` setting.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter#container
+            module Container
+              extend OpenAI::Internal::Type::Union
+
+              # The container ID.
+              variant String
+
+              # Configuration for a code interpreter container. Optionally specify the IDs of the files to run the code on.
+              variant(
+                -> {
+                  OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container::CodeInterpreterToolAuto
+                }
+              )
+
+              class CodeInterpreterToolAuto < OpenAI::Internal::Type::BaseModel
+                # @!attribute type
+                #   Always `auto`.
+                #
+                #   @return [Symbol, :auto]
+                required :type, const: :auto
+
+                # @!attribute file_ids
+                #   An optional list of uploaded files to make available to your code.
+                #
+                #   @return [Array<String>, nil]
+                optional :file_ids, OpenAI::Internal::Type::ArrayOf[String]
+
+                # @!attribute memory_limit
+                #   The memory limit for the code interpreter container.
+                #
+                #   @return [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container::CodeInterpreterToolAuto::MemoryLimit, nil]
+                optional(
+                  :memory_limit,
+                  enum: -> {
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container::CodeInterpreterToolAuto::MemoryLimit
+                  },
+                  nil?: true
+                )
+
+                # @!attribute network_policy
+                #   Network access policy for the container.
+                #
+                #   @return [OpenAI::Models::Responses::ContainerNetworkPolicyDisabled, OpenAI::Models::Responses::ContainerNetworkPolicyAllowlist, nil]
+                optional(
+                  :network_policy,
+                  union: -> {
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container::CodeInterpreterToolAuto::NetworkPolicy
+                  }
+                )
+
+                # @!method initialize(file_ids: nil, memory_limit: nil, network_policy: nil, type: :auto)
+                #   Configuration for a code interpreter container. Optionally specify the IDs of
+                #   the files to run the code on.
+                #
+                #   @param file_ids [Array<String>]
+                #     An optional list of uploaded files to make available to your code.
+                #
+                #   @param memory_limit [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container::CodeInterpreterToolAuto::MemoryLimit, nil]
+                #     The memory limit for the code interpreter container.
+                #
+                #   @param network_policy [OpenAI::Models::Responses::ContainerNetworkPolicyDisabled, OpenAI::Models::Responses::ContainerNetworkPolicyAllowlist]
+                #     Network access policy for the container.
+                #
+                #   @param type [Symbol, :auto]
+                #     Always `auto`.
+
+                # The memory limit for the code interpreter container.
+                #
+                # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container::CodeInterpreterToolAuto#memory_limit
+                module MemoryLimit
+                  extend OpenAI::Internal::Type::Enum
+
+                  MEMORY_LIMIT_1G = :"1g"
+                  MEMORY_LIMIT_4G = :"4g"
+                  MEMORY_LIMIT_16G = :"16g"
+                  MEMORY_LIMIT_64G = :"64g"
+
+                  # @!method self.values
+                  #   @return [Array<Symbol>]
+                end
+
+                # Network access policy for the container.
+                #
+                # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container::CodeInterpreterToolAuto#network_policy
+                module NetworkPolicy
+                  extend OpenAI::Internal::Type::Union
+
+                  discriminator :type
+
+                  variant :disabled, -> { OpenAI::Responses::ContainerNetworkPolicyDisabled }
+
+                  variant :allowlist, -> { OpenAI::Responses::ContainerNetworkPolicyAllowlist }
+
+                  # @!method self.variants
+                  #   @return [Array(OpenAI::Models::Responses::ContainerNetworkPolicyDisabled, OpenAI::Models::Responses::ContainerNetworkPolicyAllowlist)]
+                end
+              end
+
+              # @!method self.variants
+              #   @return [Array(String, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter::Container::CodeInterpreterToolAuto)]
+            end
+
+            module AllowedCaller
+              extend OpenAI::Internal::Type::Enum
+
+              DIRECT = :direct
+              PROGRAMMATIC = :programmatic
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          class ProgrammaticToolCalling < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #   The type of the tool. Always `programmatic_tool_calling`.
+            #
+            #   @return [Symbol, :programmatic_tool_calling]
+            required :type, const: :programmatic_tool_calling
+
+            # @!method initialize(type: :programmatic_tool_calling)
+            #   @param type [Symbol, :programmatic_tool_calling]
+            #     The type of the tool. Always `programmatic_tool_calling`.
+          end
+
+          class ImageGeneration < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #   The type of the image generation tool. Always `image_generation`.
+            #
+            #   @return [Symbol, :image_generation]
+            required :type, const: :image_generation
+
+            # @!attribute action
+            #   Whether to generate a new image or edit an existing image. Default: `auto`.
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Action, nil]
+            optional(
+              :action,
+              enum: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Action }
+            )
+
+            # @!attribute background
+            #   Allows to set transparency for the background of the generated image(s). Must be
+            #   one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
+            #   the model will automatically determine the best background for the image.
+            #
+            #   `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+            #   snapshots, support `opaque` and `transparent` backgrounds. Transparent
+            #   backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+            #   `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+            #   set the output format to `png` or `webp`.
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Background, nil]
+            optional(
+              :background,
+              enum: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Background }
+            )
+
+            # @!attribute input_fidelity
+            #   Control how much effort the model will exert to match the style and features,
+            #   especially facial features, of input images. Supports `high` and `low` on
+            #   `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+            #   `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity, nil]
+            optional(
+              :input_fidelity,
+              enum: -> {
+                OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity
+              },
+              nil?: true
+            )
+
+            # @!attribute input_image_mask
+            #   Optional mask for inpainting. Contains `image_url` (string, optional) and
+            #   `file_id` (string, optional).
+            #
+            #   @return [OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputImageMask, nil]
+            optional(
+              :input_image_mask,
+              -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputImageMask }
+            )
+
+            # @!attribute model
+            #   The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
+            #   `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+            #   `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+            #   `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
+            #   `chatgpt-image-latest`. Default: `gpt-image-1`.
+            #
+            #   @return [String, Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model, nil]
+            optional(
+              :model,
+              union: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model }
+            )
+
+            # @!attribute moderation
+            #   Moderation level for the generated image. Default: `auto`.
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Moderation, nil]
+            optional(
+              :moderation,
+              enum: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Moderation }
+            )
+
+            # @!attribute output_compression
+            #   Compression level for the output image. Default: 100.
+            #
+            #   @return [Integer, nil]
+            optional :output_compression, Integer
+
+            # @!attribute output_format
+            #   The output format of the generated image. One of `png`, `webp`, or `jpeg`.
+            #   Default: `png`.
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::OutputFormat, nil]
+            optional(
+              :output_format,
+              enum: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::OutputFormat }
+            )
+
+            # @!attribute partial_images
+            #   Number of partial images to generate in streaming mode, from 0 (default value)
+            #   to 3.
+            #
+            #   @return [Integer, nil]
+            optional :partial_images, Integer
+
+            # @!attribute quality
+            #   The quality of the generated image. The GPT image models support `low`,
+            #   `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+            #   including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+            #   `auto`.
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Quality, nil]
+            optional(
+              :quality,
+              enum: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Quality }
+            )
+
+            # @!attribute size
+            #   The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+            #   `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+            #   `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+            #   resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+            #   Width and height must both be divisible by 16 and the requested aspect ratio
+            #   must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+            #   the maximum supported resolution is `3840x2160`. The requested size must also
+            #   satisfy the model's current pixel and edge limits. The standard sizes
+            #   `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+            #   `auto` is supported for models that allow automatic sizing.
+            #
+            #   @return [String, Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size, nil]
+            optional(
+              :size,
+              union: -> { OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size }
+            )
+
+            # @!method initialize(action: nil, background: nil, input_fidelity: nil, input_image_mask: nil, model: nil, moderation: nil, output_compression: nil, output_format: nil, partial_images: nil, quality: nil, size: nil, type: :image_generation)
+            #   A tool that generates images using the GPT image models.
+            #
+            #   @param action [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Action]
+            #     Whether to generate a new image or edit an existing image. Default: `auto`.
+            #
+            #   @param background [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Background]
+            #     Allows to set transparency for the background of the generated image(s). Must be
+            #     one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
+            #     the model will automatically determine the best background for the image.
+            #
+            #     `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+            #     snapshots, support `opaque` and `transparent` backgrounds. Transparent
+            #     backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+            #     `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+            #     set the output format to `png` or `webp`.
+            #
+            #   @param input_fidelity [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputFidelity, nil]
+            #     Control how much effort the model will exert to match the style and features,
+            #     especially facial features, of input images. Supports `high` and `low` on
+            #     `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+            #     `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            #
+            #   @param input_image_mask [OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::InputImageMask]
+            #     Optional mask for inpainting. Contains `image_url` (string, optional) and
+            #     `file_id` (string, optional).
+            #
+            #   @param model [String, Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model]
+            #     The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
+            #     `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+            #     `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+            #     `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
+            #     `chatgpt-image-latest`. Default: `gpt-image-1`.
+            #
+            #   @param moderation [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Moderation]
+            #     Moderation level for the generated image. Default: `auto`.
+            #
+            #   @param output_compression [Integer]
+            #     Compression level for the output image. Default: 100.
+            #
+            #   @param output_format [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::OutputFormat]
+            #     The output format of the generated image. One of `png`, `webp`, or `jpeg`.
+            #     Default: `png`.
+            #
+            #   @param partial_images [Integer]
+            #     Number of partial images to generate in streaming mode, from 0 (default value)
+            #     to 3.
+            #
+            #   @param quality [Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Quality]
+            #     The quality of the generated image. The GPT image models support `low`,
+            #     `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+            #     including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+            #     `auto`.
+            #
+            #   @param size [String, Symbol, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size]
+            #     The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+            #     `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+            #     `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+            #     resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+            #     Width and height must both be divisible by 16 and the requested aspect ratio
+            #     must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+            #     the maximum supported resolution is `3840x2160`. The requested size must also
+            #     satisfy the model's current pixel and edge limits. The standard sizes
+            #     `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+            #     `auto` is supported for models that allow automatic sizing.
+            #
+            #   @param type [Symbol, :image_generation]
+            #     The type of the image generation tool. Always `image_generation`.
+
+            # Whether to generate a new image or edit an existing image. Default: `auto`.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#action
+            module Action
+              extend OpenAI::Internal::Type::Enum
+
+              GENERATE = :generate
+              EDIT = :edit
+              AUTO = :auto
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Allows to set transparency for the background of the generated image(s). Must be
+            # one of `transparent`, `opaque`, or `auto` (default value). When `auto` is used,
+            # the model will automatically determine the best background for the image.
+            #
+            # `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08`
+            # snapshots, support `opaque` and `transparent` backgrounds. Transparent
+            # backgrounds are available for supported GPT Image models. For `gpt-image-2` and
+            # `gpt-image-2-2026-04-21`, this support is in preview. When using `transparent`,
+            # set the output format to `png` or `webp`.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#background
+            module Background
+              extend OpenAI::Internal::Type::Enum
+
+              TRANSPARENT = :transparent
+              OPAQUE = :opaque
+              AUTO = :auto
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # Control how much effort the model will exert to match the style and features,
+            # especially facial features, of input images. Supports `high` and `low` on
+            # `gpt-image-1` and `gpt-image-1.5`; `gpt-image-1-mini` supports only `low`. For
+            # `gpt-image-2`, omit this parameter. Defaults to `low` on supported models.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#input_fidelity
+            module InputFidelity
+              extend OpenAI::Internal::Type::Enum
+
+              HIGH = :high
+              LOW = :low
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#input_image_mask
+            class InputImageMask < OpenAI::Internal::Type::BaseModel
+              # @!attribute file_id
+              #   File ID for the mask image.
+              #
+              #   @return [String, nil]
+              optional :file_id, String
+
+              # @!attribute image_url
+              #   Base64-encoded mask image.
+              #
+              #   @return [String, nil]
+              optional :image_url, String
+
+              # @!method initialize(file_id: nil, image_url: nil)
+              #   Optional mask for inpainting. Contains `image_url` (string, optional) and
+              #   `file_id` (string, optional).
+              #
+              #   @param file_id [String]
+              #     File ID for the mask image.
+              #
+              #   @param image_url [String]
+              #     Base64-encoded mask image.
+            end
+
+            # The image generation model to use. One of `gpt-image-1`, `gpt-image-1-mini`,
+            # `gpt-image-1.5`, `gpt-image-2`, `gpt-image-2-2026-04-21`,
+            # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+            # `gpt-image-2.5-flare`, `gpt-image-2.5-flare-2026-09-08`, or
+            # `chatgpt-image-latest`. Default: `gpt-image-1`.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#model
+            module Model
+              extend OpenAI::Internal::Type::Union
+
+              variant String
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_1
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_1_MINI
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_2
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_2_2026_04_21
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_2_5_SUNBURST
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_2_5_SUNBURST_2026_09_08
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_2_5_FLARE
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_2_5_FLARE_2026_09_08
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::GPT_IMAGE_1_5
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::CHATGPT_IMAGE_LATEST
+                }
+              )
+
+              # @!method self.variants
+              #   @return [Array(String, Symbol)]
+
+              define_sorbet_constant!(:Variants) do
+                T.type_alias {
+                  T.any(
+                    String,
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Model::TaggedSymbol
+                  )
+                }
+              end
+
+              # @!group
+
+              GPT_IMAGE_1 = :"gpt-image-1"
+              GPT_IMAGE_1_MINI = :"gpt-image-1-mini"
+              GPT_IMAGE_2 = :"gpt-image-2"
+              GPT_IMAGE_2_2026_04_21 = :"gpt-image-2-2026-04-21"
+              GPT_IMAGE_2_5_SUNBURST = :"gpt-image-2.5-sunburst"
+              GPT_IMAGE_2_5_SUNBURST_2026_09_08 = :"gpt-image-2.5-sunburst-2026-09-08"
+              GPT_IMAGE_2_5_FLARE = :"gpt-image-2.5-flare"
+              GPT_IMAGE_2_5_FLARE_2026_09_08 = :"gpt-image-2.5-flare-2026-09-08"
+              GPT_IMAGE_1_5 = :"gpt-image-1.5"
+              CHATGPT_IMAGE_LATEST = :"chatgpt-image-latest"
+
+              # @!endgroup
+            end
+
+            # Moderation level for the generated image. Default: `auto`.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#moderation
+            module Moderation
+              extend OpenAI::Internal::Type::Enum
+
+              AUTO = :auto
+              LOW = :low
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # The output format of the generated image. One of `png`, `webp`, or `jpeg`.
+            # Default: `png`.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#output_format
+            module OutputFormat
+              extend OpenAI::Internal::Type::Enum
+
+              PNG = :png
+              WEBP = :webp
+              JPEG = :jpeg
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # The quality of the generated image. The GPT image models support `low`,
+            # `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`,
+            # including their `2026-09-08` snapshots, also support `xhigh` and `max`. Default:
+            # `auto`.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#quality
+            module Quality
+              extend OpenAI::Internal::Type::Enum
+
+              LOW = :low
+              MEDIUM = :medium
+              HIGH = :high
+              XHIGH = :xhigh
+              MAX = :max
+              AUTO = :auto
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+
+            # The size of the generated images. For `gpt-image-2`, `gpt-image-2-2026-04-21`,
+            # `gpt-image-2.5-sunburst`, `gpt-image-2.5-sunburst-2026-09-08`,
+            # `gpt-image-2.5-flare`, and `gpt-image-2.5-flare-2026-09-08`, arbitrary
+            # resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+            # Width and height must both be divisible by 16 and the requested aspect ratio
+            # must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and
+            # the maximum supported resolution is `3840x2160`. The requested size must also
+            # satisfy the model's current pixel and edge limits. The standard sizes
+            # `1024x1024`, `1536x1024`, and `1024x1536` are supported by the GPT image models;
+            # `auto` is supported for models that allow automatic sizing.
+            #
+            # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration#size
+            module Size
+              extend OpenAI::Internal::Type::Union
+
+              variant String
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size::SIZE_1024X1024
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size::SIZE_1024X1536
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size::SIZE_1536X1024
+                }
+              )
+
+              variant(
+                const: -> {
+                  OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size::AUTO
+                }
+              )
+
+              # @!method self.variants
+              #   @return [Array(String, Symbol)]
+
+              define_sorbet_constant!(:Variants) do
+                T.type_alias {
+                  T.any(
+                    String,
+                    OpenAI::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration::Size::TaggedSymbol
+                  )
+                }
+              end
+
+              # @!group
+
+              SIZE_1024X1024 = :"1024x1024"
+              SIZE_1024X1536 = :"1024x1536"
+              SIZE_1536X1024 = :"1536x1024"
+              AUTO = :auto
+
+              # @!endgroup
+            end
+          end
+
+          class LocalShell < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #   The type of the local shell tool. Always `local_shell`.
+            #
+            #   @return [Symbol, :local_shell]
+            required :type, const: :local_shell
+
+            # @!method initialize(type: :local_shell)
+            #   A tool that allows the model to execute shell commands in a local environment.
+            #
+            #   @param type [Symbol, :local_shell]
+            #     The type of the local shell tool. Always `local_shell`.
+          end
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::ComputerUsePreviewTool, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::Mcp, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::CodeInterpreter, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ProgrammaticToolCalling, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::ImageGeneration, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam::Tool::LocalShell, OpenAI::Models::Responses::FunctionShellTool, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::ToolSearchOutputNamespaceTool, OpenAI::Models::Responses::ToolSearchTool, OpenAI::Models::Responses::ApplyPatchTool, OpenAI::Models::Responses::WebSearchTool, OpenAI::Models::Responses::WebSearchPreviewTool)]
+        end
+
         # Whether tool search was executed by the server or by the client.
         #
         # @see OpenAI::Models::Responses::ResponseToolSearchOutputItemParam#execution