openai 0.18.1 → 0.20.0

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

@@ -37,9 +37,166 @@ module OpenAI
         # [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools).
         variant :custom, -> { OpenAI::Responses::CustomTool }
 
+        # Search the Internet for sources related to the prompt. Learn more about the
+        # [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+        variant -> { OpenAI::Responses::Tool::WebSearchTool }
+
         # This tool searches the web for relevant results to use in a response. Learn more about the [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
         variant -> { OpenAI::Responses::WebSearchTool }
 
+        class WebSearchTool < OpenAI::Internal::Type::BaseModel
+          # @!attribute type
+          #   The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::Tool::WebSearchTool::Type]
+          required :type, enum: -> { OpenAI::Responses::Tool::WebSearchTool::Type }
+
+          # @!attribute filters
+          #   Filters for the search.
+          #
+          #   @return [OpenAI::Models::Responses::Tool::WebSearchTool::Filters, nil]
+          optional :filters, -> { OpenAI::Responses::Tool::WebSearchTool::Filters }, nil?: true
+
+          # @!attribute search_context_size
+          #   High level guidance for the amount of context window space to use for the
+          #   search. One of `low`, `medium`, or `high`. `medium` is the default.
+          #
+          #   @return [Symbol, OpenAI::Models::Responses::Tool::WebSearchTool::SearchContextSize, nil]
+          optional :search_context_size, enum: -> { OpenAI::Responses::Tool::WebSearchTool::SearchContextSize }
+
+          # @!attribute user_location
+          #   The approximate location of the user.
+          #
+          #   @return [OpenAI::Models::Responses::Tool::WebSearchTool::UserLocation, nil]
+          optional :user_location, -> { OpenAI::Responses::Tool::WebSearchTool::UserLocation }, nil?: true
+
+          # @!method initialize(type:, filters: nil, search_context_size: nil, user_location: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Responses::Tool::WebSearchTool} for more details.
+          #
+          #   Search the Internet for sources related to the prompt. Learn more about the
+          #   [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+          #
+          #   @param type [Symbol, OpenAI::Models::Responses::Tool::WebSearchTool::Type] The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
+          #
+          #   @param filters [OpenAI::Models::Responses::Tool::WebSearchTool::Filters, nil] Filters for the search.
+          #
+          #   @param search_context_size [Symbol, OpenAI::Models::Responses::Tool::WebSearchTool::SearchContextSize] High level guidance for the amount of context window space to use for the search
+          #
+          #   @param user_location [OpenAI::Models::Responses::Tool::WebSearchTool::UserLocation, nil] The approximate location of the user.
+
+          # The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
+          #
+          # @see OpenAI::Models::Responses::Tool::WebSearchTool#type
+          module Type
+            extend OpenAI::Internal::Type::Enum
+
+            WEB_SEARCH = :web_search
+            WEB_SEARCH_2025_08_26 = :web_search_2025_08_26
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see OpenAI::Models::Responses::Tool::WebSearchTool#filters
+          class Filters < OpenAI::Internal::Type::BaseModel
+            # @!attribute allowed_domains
+            #   Allowed domains for the search. If not provided, all domains are allowed.
+            #   Subdomains of the provided domains are allowed as well.
+            #
+            #   Example: `["pubmed.ncbi.nlm.nih.gov"]`
+            #
+            #   @return [Array<String>, nil]
+            optional :allowed_domains, OpenAI::Internal::Type::ArrayOf[String], nil?: true
+
+            # @!method initialize(allowed_domains: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {OpenAI::Models::Responses::Tool::WebSearchTool::Filters} for more details.
+            #
+            #   Filters for the search.
+            #
+            #   @param allowed_domains [Array<String>, nil] Allowed domains for the search. If not provided, all domains are allowed.
+          end
+
+          # High level guidance for the amount of context window space to use for the
+          # search. One of `low`, `medium`, or `high`. `medium` is the default.
+          #
+          # @see OpenAI::Models::Responses::Tool::WebSearchTool#search_context_size
+          module SearchContextSize
+            extend OpenAI::Internal::Type::Enum
+
+            LOW = :low
+            MEDIUM = :medium
+            HIGH = :high
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @see OpenAI::Models::Responses::Tool::WebSearchTool#user_location
+          class UserLocation < OpenAI::Internal::Type::BaseModel
+            # @!attribute city
+            #   Free text input for the city of the user, e.g. `San Francisco`.
+            #
+            #   @return [String, nil]
+            optional :city, String, nil?: true
+
+            # @!attribute country
+            #   The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of
+            #   the user, e.g. `US`.
+            #
+            #   @return [String, nil]
+            optional :country, String, nil?: true
+
+            # @!attribute region
+            #   Free text input for the region of the user, e.g. `California`.
+            #
+            #   @return [String, nil]
+            optional :region, String, nil?: true
+
+            # @!attribute timezone
+            #   The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the
+            #   user, e.g. `America/Los_Angeles`.
+            #
+            #   @return [String, nil]
+            optional :timezone, String, nil?: true
+
+            # @!attribute type
+            #   The type of location approximation. Always `approximate`.
+            #
+            #   @return [Symbol, OpenAI::Models::Responses::Tool::WebSearchTool::UserLocation::Type, nil]
+            optional :type, enum: -> { OpenAI::Responses::Tool::WebSearchTool::UserLocation::Type }
+
+            # @!method initialize(city: nil, country: nil, region: nil, timezone: nil, type: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {OpenAI::Models::Responses::Tool::WebSearchTool::UserLocation} for more details.
+            #
+            #   The approximate location of the user.
+            #
+            #   @param city [String, nil] Free text input for the city of the user, e.g. `San Francisco`.
+            #
+            #   @param country [String, nil] The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of t
+            #
+            #   @param region [String, nil] Free text input for the region of the user, e.g. `California`.
+            #
+            #   @param timezone [String, nil] The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the user
+            #
+            #   @param type [Symbol, OpenAI::Models::Responses::Tool::WebSearchTool::UserLocation::Type] The type of location approximation. Always `approximate`.
+
+            # The type of location approximation. Always `approximate`.
+            #
+            # @see OpenAI::Models::Responses::Tool::WebSearchTool::UserLocation#type
+            module Type
+              extend OpenAI::Internal::Type::Enum
+
+              APPROXIMATE = :approximate
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+        end
+
         class Mcp < OpenAI::Internal::Type::BaseModel
           # @!attribute server_label
           #   A label for this MCP server, used to identify it in tool calls.
@@ -47,12 +204,6 @@ module OpenAI
           #   @return [String]
           required :server_label, String
 
-          # @!attribute server_url
-          #   The URL for the MCP server.
-          #
-          #   @return [String]
-          required :server_url, String
-
           # @!attribute type
           #   The type of the MCP tool. Always `mcp`.
           #
@@ -62,9 +213,37 @@ module OpenAI
           # @!attribute allowed_tools
           #   List of allowed tool names or a filter object.
           #
-          #   @return [Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter, nil]
+          #   @return [Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpToolFilter, nil]
           optional :allowed_tools, union: -> { OpenAI::Responses::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
+          #   Identifier for service connectors, like those available in ChatGPT. One of
+          #   `server_url` or `connector_id` must be provided. Learn more about service
+          #   connectors
+          #   [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+          #
+          #   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::Tool::Mcp::ConnectorID, nil]
+          optional :connector_id, enum: -> { OpenAI::Responses::Tool::Mcp::ConnectorID }
+
           # @!attribute headers
           #   Optional HTTP headers to send to the MCP server. Use for authentication or other
           #   purposes.
@@ -84,7 +263,14 @@ module OpenAI
           #   @return [String, nil]
           optional :server_description, String
 
-          # @!method initialize(server_label:, server_url:, allowed_tools: nil, headers: nil, require_approval: nil, server_description: nil, type: :mcp)
+          # @!attribute server_url
+          #   The URL for the MCP server. One of `server_url` or `connector_id` must be
+          #   provided.
+          #
+          #   @return [String, nil]
+          optional :server_url, String
+
+          # @!method initialize(server_label:, allowed_tools: nil, authorization: nil, connector_id: nil, headers: nil, require_approval: nil, server_description: nil, server_url: nil, type: :mcp)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Responses::Tool::Mcp} for more details.
           #
@@ -94,9 +280,11 @@ module OpenAI
           #
           #   @param server_label [String] A label for this MCP server, used to identify it in tool calls.
           #
-          #   @param server_url [String] The URL for the MCP server.
+          #   @param allowed_tools [Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpToolFilter, nil] List of allowed tool names or a filter object.
           #
-          #   @param allowed_tools [Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter, 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
+          #
+          #   @param connector_id [Symbol, OpenAI::Models::Responses::Tool::Mcp::ConnectorID] Identifier for service connectors, like those available in ChatGPT. One of
           #
           #   @param headers [Hash{Symbol=>String}, nil] Optional HTTP headers to send to the MCP server. Use for authentication
           #
@@ -104,6 +292,8 @@ module OpenAI
           #
           #   @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` or `connector_id` must be
+          #
           #   @param type [Symbol, :mcp] The type of the MCP tool. Always `mcp`.
 
           # List of allowed tool names or a filter object.
@@ -116,34 +306,85 @@ module OpenAI
             variant -> { OpenAI::Models::Responses::Tool::Mcp::AllowedTools::StringArray }
 
             # A filter object to specify which tools are allowed.
-            variant -> { OpenAI::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter }
+            variant -> { OpenAI::Responses::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
 
-            class McpAllowedToolsFilter < OpenAI::Internal::Type::BaseModel
               # @!attribute tool_names
               #   List of allowed tool names.
               #
               #   @return [Array<String>, nil]
               optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
 
-              # @!method initialize(tool_names: nil)
+              # @!method initialize(read_only: nil, tool_names: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpToolFilter} for more
+              #   details.
+              #
               #   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
+              #
               #   @param tool_names [Array<String>] List of allowed tool names.
             end
 
             # @!method self.variants
-            #   @return [Array(Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter)]
+            #   @return [Array(Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpToolFilter)]
 
             # @type [OpenAI::Internal::Type::Converter]
             StringArray = OpenAI::Internal::Type::ArrayOf[String]
           end
 
+          # Identifier for service connectors, like those available in ChatGPT. One of
+          # `server_url` or `connector_id` must be provided. Learn more about service
+          # connectors
+          # [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+          #
+          # 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::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::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::Tool::Mcp::RequireApproval::McpToolApprovalFilter }
 
             # Specify a single approval policy for all tools. One of `always` or
@@ -153,58 +394,85 @@ module OpenAI
 
             class McpToolApprovalFilter < OpenAI::Internal::Type::BaseModel
               # @!attribute always
-              #   A list of tools that always require approval.
+              #   A filter object to specify which tools are allowed.
               #
               #   @return [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always, nil]
-              optional :always,
-                       -> {
-                         OpenAI::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always
-                       }
+              optional :always, -> { OpenAI::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always }
 
               # @!attribute never
-              #   A list of tools that never require approval.
+              #   A filter object to specify which tools are allowed.
               #
               #   @return [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never, nil]
-              optional :never,
-                       -> {
-                         OpenAI::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never
-                       }
+              optional :never, -> { OpenAI::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never }
 
               # @!method initialize(always: nil, never: nil)
               #   Some parameter documentations has been truncated, see
               #   {OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter}
               #   for more details.
               #
-              #   @param always [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always] A list of tools that always require approval.
+              #   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::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always] A filter object to specify which tools are allowed.
               #
-              #   @param never [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never] A list of tools that never require approval.
+              #   @param never [OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never] A filter object to specify which tools are allowed.
 
               # @see OpenAI::Models::Responses::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 tools that require approval.
+                #   List of allowed tool names.
                 #
                 #   @return [Array<String>, nil]
                 optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
 
-                # @!method initialize(tool_names: nil)
-                #   A list of tools that always require approval.
+                # @!method initialize(read_only: nil, tool_names: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Always}
+                #   for more details.
+                #
+                #   A filter object to specify which tools are allowed.
                 #
-                #   @param tool_names [Array<String>] List of tools that require approval.
+                #   @param read_only [Boolean] Indicates whether or not a tool modifies data or is read-only. If an
+                #
+                #   @param tool_names [Array<String>] List of allowed tool names.
               end
 
               # @see OpenAI::Models::Responses::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 tools that do not require approval.
+                #   List of allowed tool names.
                 #
                 #   @return [Array<String>, nil]
                 optional :tool_names, OpenAI::Internal::Type::ArrayOf[String]
 
-                # @!method initialize(tool_names: nil)
-                #   A list of tools that never require approval.
+                # @!method initialize(read_only: nil, tool_names: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {OpenAI::Models::Responses::Tool::Mcp::RequireApproval::McpToolApprovalFilter::Never}
+                #   for more details.
+                #
+                #   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
                 #
-                #   @param tool_names [Array<String>] List of tools that do not require approval.
+                #   @param tool_names [Array<String>] List of allowed tool names.
               end
             end
 
@@ -546,7 +814,7 @@ module OpenAI
         end
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::WebSearchTool)]
+        #   @return [Array(OpenAI::Models::Responses::FunctionTool, OpenAI::Models::Responses::FileSearchTool, OpenAI::Models::Responses::ComputerTool, OpenAI::Models::Responses::Tool::Mcp, OpenAI::Models::Responses::Tool::CodeInterpreter, OpenAI::Models::Responses::Tool::ImageGeneration, OpenAI::Models::Responses::Tool::LocalShell, OpenAI::Models::Responses::CustomTool, OpenAI::Models::Responses::Tool::WebSearchTool, OpenAI::Models::Responses::WebSearchTool)]
       end
     end
   end

data/lib/openai/models.rb

@@ -91,6 +91,8 @@ module OpenAI
 
   Containers = OpenAI::Models::Containers
 
+  Conversations = OpenAI::Models::Conversations
+
   CreateEmbeddingResponse = OpenAI::Models::CreateEmbeddingResponse
 
   CustomToolInputFormat = OpenAI::Models::CustomToolInputFormat

data/lib/openai/resources/conversations/items.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Conversations
+      class Items
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::Conversations::ItemCreateParams} for more details.
+        #
+        # Create items in a conversation with the given ID.
+        #
+        # @overload create(conversation_id, items:, include: nil, request_options: {})
+        #
+        # @param conversation_id [String] Path param: The ID of the conversation to add the item to.
+        #
+        # @param items [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::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::ItemReference>] Body param: The items to add to the conversation. You may add up to 20 items at
+        #
+        # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>] Query param: Additional fields to include in the response. See the `include`
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::Conversations::ConversationItemList]
+        #
+        # @see OpenAI::Models::Conversations::ItemCreateParams
+        def create(conversation_id, params)
+          parsed, options = OpenAI::Conversations::ItemCreateParams.dump_request(params)
+          query_params = [:include]
+          @client.request(
+            method: :post,
+            path: ["conversations/%1$s/items", conversation_id],
+            query: parsed.slice(*query_params),
+            body: parsed.except(*query_params),
+            model: OpenAI::Conversations::ConversationItemList,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::Conversations::ItemRetrieveParams} for more details.
+        #
+        # Get a single item from a conversation with the given IDs.
+        #
+        # @overload retrieve(item_id, conversation_id:, include: nil, request_options: {})
+        #
+        # @param item_id [String] Path param: The ID of the item to retrieve.
+        #
+        # @param conversation_id [String] Path param: The ID of the conversation that contains the item.
+        #
+        # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>] Query param: Additional fields to include in the response. See the `include`
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput]
+        #
+        # @see OpenAI::Models::Conversations::ItemRetrieveParams
+        def retrieve(item_id, params)
+          parsed, options = OpenAI::Conversations::ItemRetrieveParams.dump_request(params)
+          conversation_id =
+            parsed.delete(:conversation_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["conversations/%1$s/items/%2$s", conversation_id, item_id],
+            query: parsed,
+            model: OpenAI::Conversations::ConversationItem,
+            options: options
+          )
+        end
+
+        # Some parameter documentations has been truncated, see
+        # {OpenAI::Models::Conversations::ItemListParams} for more details.
+        #
+        # List all items for a conversation with the given ID.
+        #
+        # @overload list(conversation_id, after: nil, include: nil, limit: nil, order: nil, request_options: {})
+        #
+        # @param conversation_id [String] The ID of the conversation to list items for.
+        #
+        # @param after [String] An item ID to list items after, used in pagination.
+        #
+        # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>] Specify additional output data to include in the model response. Currently
+        #
+        # @param limit [Integer] A limit on the number of objects to be returned. Limit can range between
+        #
+        # @param order [Symbol, OpenAI::Models::Conversations::ItemListParams::Order] The order to return the input items in. Default is `desc`.
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Internal::ConversationCursorPage<OpenAI::Models::Conversations::Message, OpenAI::Models::Responses::ResponseFunctionToolCallItem, OpenAI::Models::Responses::ResponseFunctionToolCallOutputItem, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Conversations::ConversationItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseComputerToolCallOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Conversations::ConversationItem::McpListTools, OpenAI::Models::Conversations::ConversationItem::McpApprovalRequest, OpenAI::Models::Conversations::ConversationItem::McpApprovalResponse, OpenAI::Models::Conversations::ConversationItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput>]
+        #
+        # @see OpenAI::Models::Conversations::ItemListParams
+        def list(conversation_id, params = {})
+          parsed, options = OpenAI::Conversations::ItemListParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["conversations/%1$s/items", conversation_id],
+            query: parsed,
+            page: OpenAI::Internal::ConversationCursorPage,
+            model: OpenAI::Conversations::ConversationItem,
+            options: options
+          )
+        end
+
+        # Delete an item from a conversation with the given IDs.
+        #
+        # @overload delete(item_id, conversation_id:, request_options: {})
+        #
+        # @param item_id [String] The ID of the item to delete.
+        #
+        # @param conversation_id [String] The ID of the conversation that contains the item.
+        #
+        # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [OpenAI::Models::Conversations::Conversation]
+        #
+        # @see OpenAI::Models::Conversations::ItemDeleteParams
+        def delete(item_id, params)
+          parsed, options = OpenAI::Conversations::ItemDeleteParams.dump_request(params)
+          conversation_id =
+            parsed.delete(:conversation_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: ["conversations/%1$s/items/%2$s", conversation_id, item_id],
+            model: OpenAI::Conversations::Conversation,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [OpenAI::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end