openai 0.18.1 → 0.19.0

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/responses/input_items.rb

@@ -9,14 +9,12 @@ module OpenAI
         #
         # Returns a list of input items for a given response.
         #
-        # @overload list(response_id, after: nil, before: nil, include: nil, limit: nil, order: nil, request_options: {})
+        # @overload list(response_id, after: nil, include: nil, limit: nil, order: nil, request_options: {})
         #
         # @param response_id [String] The ID of the response to retrieve input items for.
         #
         # @param after [String] An item ID to list items after, used in pagination.
         #
-        # @param before [String] An item ID to list items before, used in pagination.
-        #
         # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>] Additional fields to include in the response. See the `include`
         #
         # @param limit [Integer] A limit on the number of objects to be returned. Limit can range between

data/lib/openai/resources/responses.rb

@@ -23,10 +23,12 @@ module OpenAI
       # [file search](https://platform.openai.com/docs/guides/tools-file-search) to use
       # your own data as input for the model's response.
       #
-      # @overload create(background: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
+      # @overload create(background: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
       #
       # @param background [Boolean, nil] Whether to run the model response in the background.
       #
+      # @param conversation [String, OpenAI::Models::Responses::ResponseConversationParam, nil] The conversation that this response belongs to. Items from this conversation are
+      #
       # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>, nil] Specify additional output data to include in the model response. Currently
       #
       # @param input [String, 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>] Text, image, or file inputs to the model, used to generate a response.
@@ -120,10 +122,12 @@ module OpenAI
       # [file search](https://platform.openai.com/docs/guides/tools-file-search) to use
       # your own data as input for the model's response.
       #
-      # @overload stream(background: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
+      # @overload stream(background: nil, conversation: nil, include: nil, input: nil, instructions: nil, max_output_tokens: nil, max_tool_calls: nil, metadata: nil, model: nil, parallel_tool_calls: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, store: nil, stream_options: nil, temperature: nil, text: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, truncation: nil, user: nil, request_options: {})
       #
       # @param background [Boolean, nil] Whether to run the model response in the background.
       #
+      # @param conversation [String, OpenAI::Models::Responses::ResponseConversationParam, nil] The conversation that this response belongs to. Items from this conversation are
+      #
       # @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>, nil] Specify additional output data to include in the model response. Currently
       #
       # @param input [String, 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>] Text, image, or file inputs to the model, used to generate a response.

data/lib/openai/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OpenAI
-  VERSION = "0.18.1"
+  VERSION = "0.19.0"
 end

data/lib/openai.rb

@@ -48,6 +48,7 @@ require_relative "openai/internal/transport/base_client"
 require_relative "openai/internal/transport/pooled_net_requester"
 require_relative "openai/client"
 require_relative "openai/internal/stream"
+require_relative "openai/internal/conversation_cursor_page"
 require_relative "openai/internal/cursor_page"
 require_relative "openai/internal/page"
 require_relative "openai/helpers/structured_output/json_schema_converter"
@@ -246,6 +247,33 @@ require_relative "openai/models/containers/file_list_response"
 require_relative "openai/models/containers/file_retrieve_params"
 require_relative "openai/models/containers/file_retrieve_response"
 require_relative "openai/models/containers/files/content_retrieve_params"
+require_relative "openai/models/conversations/computer_screenshot_content"
+require_relative "openai/models/conversations/container_file_citation_body"
+require_relative "openai/models/conversations/conversation"
+require_relative "openai/models/conversations/conversation_create_params"
+require_relative "openai/models/conversations/conversation_deleted"
+require_relative "openai/models/conversations/conversation_deleted_resource"
+require_relative "openai/models/conversations/conversation_delete_params"
+require_relative "openai/models/conversations/conversation_item"
+require_relative "openai/models/conversations/conversation_item_list"
+require_relative "openai/models/conversations/conversation_retrieve_params"
+require_relative "openai/models/conversations/conversation_update_params"
+require_relative "openai/models/conversations/file_citation_body"
+require_relative "openai/models/conversations/input_file_content"
+require_relative "openai/models/conversations/input_image_content"
+require_relative "openai/models/conversations/input_text_content"
+require_relative "openai/models/conversations/item_create_params"
+require_relative "openai/models/conversations/item_delete_params"
+require_relative "openai/models/conversations/item_list_params"
+require_relative "openai/models/conversations/item_retrieve_params"
+require_relative "openai/models/conversations/lob_prob"
+require_relative "openai/models/conversations/message"
+require_relative "openai/models/conversations/output_text_content"
+require_relative "openai/models/conversations/refusal_content"
+require_relative "openai/models/conversations/summary_text_content"
+require_relative "openai/models/conversations/text_content"
+require_relative "openai/models/conversations/top_log_prob"
+require_relative "openai/models/conversations/url_citation_body"
 require_relative "openai/models/create_embedding_response"
 require_relative "openai/models/custom_tool_input_format"
 require_relative "openai/models/embedding"
@@ -383,6 +411,7 @@ require_relative "openai/models/responses/response_computer_tool_call_output_scr
 require_relative "openai/models/responses/response_content"
 require_relative "openai/models/responses/response_content_part_added_event"
 require_relative "openai/models/responses/response_content_part_done_event"
+require_relative "openai/models/responses/response_conversation_param"
 require_relative "openai/models/responses/response_created_event"
 require_relative "openai/models/responses/response_create_params"
 require_relative "openai/models/responses/response_custom_tool_call"
@@ -535,6 +564,8 @@ require_relative "openai/resources/completions"
 require_relative "openai/resources/containers"
 require_relative "openai/resources/containers/files"
 require_relative "openai/resources/containers/files/content"
+require_relative "openai/resources/conversations"
+require_relative "openai/resources/conversations/items"
 require_relative "openai/resources/embeddings"
 require_relative "openai/resources/evals"
 require_relative "openai/resources/evals/runs"

data/rbi/openai/client.rbi

@@ -67,6 +67,9 @@ module OpenAI
     sig { returns(OpenAI::Resources::Responses) }
     attr_reader :responses
 
+    sig { returns(OpenAI::Resources::Conversations) }
+    attr_reader :conversations
+
     sig { returns(OpenAI::Resources::Evals) }
     attr_reader :evals
 

data/rbi/openai/errors.rbi

@@ -68,19 +68,19 @@ module OpenAI
     end
 
     class APIConnectionError < OpenAI::Errors::APIError
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :status
 
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :body
 
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :code
 
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :param
 
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :type
 
       # @api private

data/rbi/openai/internal/conversation_cursor_page.rbi

@@ -0,0 +1,25 @@
+# typed: strong
+
+module OpenAI
+  module Internal
+    class ConversationCursorPage
+      include OpenAI::Internal::Type::BasePage
+
+      Elem = type_member
+
+      sig { returns(T.nilable(T::Array[Elem])) }
+      attr_accessor :data
+
+      sig { returns(T::Boolean) }
+      attr_accessor :has_more
+
+      sig { returns(String) }
+      attr_accessor :last_id
+
+      # @api private
+      sig { returns(String) }
+      def inspect
+      end
+    end
+  end
+end

data/rbi/openai/models/conversations/computer_screenshot_content.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Conversations
+      class ComputerScreenshotContent < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Conversations::ComputerScreenshotContent,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # The identifier of an uploaded file that contains the screenshot.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :file_id
+
+        # The URL of the screenshot image.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :image_url
+
+        # Specifies the event type. For a computer screenshot, this property is always set
+        # to `computer_screenshot`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig do
+          params(
+            file_id: T.nilable(String),
+            image_url: T.nilable(String),
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The identifier of an uploaded file that contains the screenshot.
+          file_id:,
+          # The URL of the screenshot image.
+          image_url:,
+          # Specifies the event type. For a computer screenshot, this property is always set
+          # to `computer_screenshot`.
+          type: :computer_screenshot
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              file_id: T.nilable(String),
+              image_url: T.nilable(String),
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/conversations/container_file_citation_body.rbi

@@ -0,0 +1,82 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Conversations
+      class ContainerFileCitationBody < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Conversations::ContainerFileCitationBody,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # The ID of the container file.
+        sig { returns(String) }
+        attr_accessor :container_id
+
+        # The index of the last character of the container file citation in the message.
+        sig { returns(Integer) }
+        attr_accessor :end_index
+
+        # The ID of the file.
+        sig { returns(String) }
+        attr_accessor :file_id
+
+        # The filename of the container file cited.
+        sig { returns(String) }
+        attr_accessor :filename
+
+        # The index of the first character of the container file citation in the message.
+        sig { returns(Integer) }
+        attr_accessor :start_index
+
+        # The type of the container file citation. Always `container_file_citation`.
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig do
+          params(
+            container_id: String,
+            end_index: Integer,
+            file_id: String,
+            filename: String,
+            start_index: Integer,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The ID of the container file.
+          container_id:,
+          # The index of the last character of the container file citation in the message.
+          end_index:,
+          # The ID of the file.
+          file_id:,
+          # The filename of the container file cited.
+          filename:,
+          # The index of the first character of the container file citation in the message.
+          start_index:,
+          # The type of the container file citation. Always `container_file_citation`.
+          type: :container_file_citation
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              container_id: String,
+              end_index: Integer,
+              file_id: String,
+              filename: String,
+              start_index: Integer,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/openai/models/conversations/conversation.rbi

@@ -0,0 +1,76 @@
+# typed: strong
+
+module OpenAI
+  module Models
+    module Conversations
+      class Conversation < OpenAI::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              OpenAI::Conversations::Conversation,
+              OpenAI::Internal::AnyHash
+            )
+          end
+
+        # The unique ID of the conversation.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The time at which the conversation was created, measured in seconds since the
+        # Unix epoch.
+        sig { returns(Integer) }
+        attr_accessor :created_at
+
+        # Set of 16 key-value pairs that can be attached to an object. This can be useful
+        # for storing additional information about the object in a structured format, and
+        # querying for objects via API or the dashboard. Keys are strings with a maximum
+        # length of 64 characters. Values are strings with a maximum length of 512
+        # characters.
+        sig { returns(T.anything) }
+        attr_accessor :metadata
+
+        # The object type, which is always `conversation`.
+        sig { returns(Symbol) }
+        attr_accessor :object
+
+        sig do
+          params(
+            id: String,
+            created_at: Integer,
+            metadata: T.anything,
+            object: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The unique ID of the conversation.
+          id:,
+          # The time at which the conversation was created, measured in seconds since the
+          # Unix epoch.
+          created_at:,
+          # Set of 16 key-value pairs that can be attached to an object. This can be useful
+          # for storing additional information about the object in a structured format, and
+          # querying for objects via API or the dashboard. Keys are strings with a maximum
+          # length of 64 characters. Values are strings with a maximum length of 512
+          # characters.
+          metadata:,
+          # The object type, which is always `conversation`.
+          object: :conversation
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              created_at: Integer,
+              metadata: T.anything,
+              object: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end