openai 0.17.1 → 0.19.0

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

@@ -47,12 +47,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 +56,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 +106,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 +123,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 authorization [String] An OAuth access token that can be used with a remote MCP server, either
           #
-          #   @param allowed_tools [Array<String>, OpenAI::Models::Responses::Tool::Mcp::AllowedTools::McpAllowedToolsFilter, nil] List of allowed tool names or a filter object.
+          #   @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 +135,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 +149,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 +237,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
 

data/lib/openai/models/upload_create_params.rb

@@ -37,7 +37,14 @@ module OpenAI
       #   @return [Symbol, OpenAI::Models::FilePurpose]
       required :purpose, enum: -> { OpenAI::FilePurpose }
 
-      # @!method initialize(bytes:, filename:, mime_type:, purpose:, request_options: {})
+      # @!attribute expires_after
+      #   The expiration policy for a file. By default, files with `purpose=batch` expire
+      #   after 30 days and all other files are persisted until they are manually deleted.
+      #
+      #   @return [OpenAI::Models::UploadCreateParams::ExpiresAfter, nil]
+      optional :expires_after, -> { OpenAI::UploadCreateParams::ExpiresAfter }
+
+      # @!method initialize(bytes:, filename:, mime_type:, purpose:, expires_after: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {OpenAI::Models::UploadCreateParams} for more details.
       #
@@ -49,7 +56,36 @@ module OpenAI
       #
       #   @param purpose [Symbol, OpenAI::Models::FilePurpose] The intended purpose of the uploaded file.
       #
+      #   @param expires_after [OpenAI::Models::UploadCreateParams::ExpiresAfter] The expiration policy for a file. By default, files with `purpose=batch` expire
+      #
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+      class ExpiresAfter < OpenAI::Internal::Type::BaseModel
+        # @!attribute anchor
+        #   Anchor timestamp after which the expiration policy applies. Supported anchors:
+        #   `created_at`.
+        #
+        #   @return [Symbol, :created_at]
+        required :anchor, const: :created_at
+
+        # @!attribute seconds
+        #   The number of seconds after the anchor time that the file will expire. Must be
+        #   between 3600 (1 hour) and 2592000 (30 days).
+        #
+        #   @return [Integer]
+        required :seconds, Integer
+
+        # @!method initialize(seconds:, anchor: :created_at)
+        #   Some parameter documentations has been truncated, see
+        #   {OpenAI::Models::UploadCreateParams::ExpiresAfter} for more details.
+        #
+        #   The expiration policy for a file. By default, files with `purpose=batch` expire
+        #   after 30 days and all other files are persisted until they are manually deleted.
+        #
+        #   @param seconds [Integer] The number of seconds after the anchor time that the file will expire. Must be b
+        #
+        #   @param anchor [Symbol, :created_at] Anchor timestamp after which the expiration policy applies. Supported anchors: `
+      end
     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/batches.rb

@@ -8,7 +8,7 @@ module OpenAI
       #
       # Creates and executes a batch from an uploaded file of requests
       #
-      # @overload create(completion_window:, endpoint:, input_file_id:, metadata: nil, request_options: {})
+      # @overload create(completion_window:, endpoint:, input_file_id:, metadata: nil, output_expires_after: nil, request_options: {})
       #
       # @param completion_window [Symbol, OpenAI::Models::BatchCreateParams::CompletionWindow] The time frame within which the batch should be processed. Currently only `24h`
       #
@@ -18,6 +18,8 @@ module OpenAI
       #
       # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
       #
+      # @param output_expires_after [OpenAI::Models::BatchCreateParams::OutputExpiresAfter] The expiration policy for the output and/or error file that are generated for a
+      #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [OpenAI::Models::Batch]

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

data/lib/openai/resources/conversations.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Resources
+    class Conversations
+      # @return [OpenAI::Resources::Conversations::Items]
+      attr_reader :items
+
+      # Some parameter documentations has been truncated, see
+      # {OpenAI::Models::Conversations::ConversationCreateParams} for more details.
+      #
+      # Create a conversation with the given ID.
+      #
+      # @overload create(items: nil, metadata: nil, request_options: {})
+      #
+      # @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>, nil] Initial items to include in the conversation context.
+      #
+      # @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. Useful for
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::Conversations::Conversation]
+      #
+      # @see OpenAI::Models::Conversations::ConversationCreateParams
+      def create(params = {})
+        parsed, options = OpenAI::Conversations::ConversationCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "conversations",
+          body: parsed,
+          model: OpenAI::Conversations::Conversation,
+          options: options
+        )
+      end
+
+      # Get a conversation with the given ID.
+      #
+      # @overload retrieve(conversation_id, request_options: {})
+      #
+      # @param conversation_id [String] The ID of the conversation to retrieve.
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::Conversations::Conversation]
+      #
+      # @see OpenAI::Models::Conversations::ConversationRetrieveParams
+      def retrieve(conversation_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["conversations/%1$s", conversation_id],
+          model: OpenAI::Conversations::Conversation,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {OpenAI::Models::Conversations::ConversationUpdateParams} for more details.
+      #
+      # Update a conversation's metadata with the given ID.
+      #
+      # @overload update(conversation_id, metadata:, request_options: {})
+      #
+      # @param conversation_id [String] The ID of the conversation to update.
+      #
+      # @param metadata [Hash{Symbol=>String}] Set of 16 key-value pairs that can be attached to an object. This can be
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::Conversations::Conversation]
+      #
+      # @see OpenAI::Models::Conversations::ConversationUpdateParams
+      def update(conversation_id, params)
+        parsed, options = OpenAI::Conversations::ConversationUpdateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["conversations/%1$s", conversation_id],
+          body: parsed,
+          model: OpenAI::Conversations::Conversation,
+          options: options
+        )
+      end
+
+      # Delete a conversation with the given ID.
+      #
+      # @overload delete(conversation_id, request_options: {})
+      #
+      # @param conversation_id [String] The ID of the conversation to delete.
+      #
+      # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [OpenAI::Models::Conversations::ConversationDeletedResource]
+      #
+      # @see OpenAI::Models::Conversations::ConversationDeleteParams
+      def delete(conversation_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["conversations/%1$s", conversation_id],
+          model: OpenAI::Conversations::ConversationDeletedResource,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [OpenAI::Client]
+      def initialize(client:)
+        @client = client
+        @items = OpenAI::Resources::Conversations::Items.new(client: client)
+      end
+    end
+  end
+end

data/lib/openai/resources/files.rb

@@ -8,7 +8,7 @@ module OpenAI
       #
       # Upload a file that can be used across various endpoints. Individual files can be
       # up to 512 MB, and the size of all files uploaded by one organization can be up
-      # to 100 GB.
+      # to 1 TB.
       #
       # The Assistants API supports files up to 2 million tokens and of specific file
       # types. See the
@@ -28,12 +28,14 @@ module OpenAI
       # Please [contact us](https://help.openai.com/) if you need to increase these
       # storage limits.
       #
-      # @overload create(file:, purpose:, request_options: {})
+      # @overload create(file:, purpose:, expires_after: nil, request_options: {})
       #
       # @param file [Pathname, StringIO, IO, String, OpenAI::FilePart] The File object (not file name) to be uploaded.
       #
       # @param purpose [Symbol, OpenAI::Models::FilePurpose] The intended purpose of the uploaded file. One of: - `assistants`: Used in the A
       #
+      # @param expires_after [OpenAI::Models::FileCreateParams::ExpiresAfter] The expiration policy for a file. By default, files with `purpose=batch` expire
+      #
       # @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [OpenAI::Models::FileObject]