openai 0.50.0 → 0.52.0

data/lib/openai/models/beta/threads/run_list_params.rb

@@ -9,6 +9,11 @@ module OpenAI
           extend OpenAI::Internal::Type::RequestParameters::Converter
           include OpenAI::Internal::Type::RequestParameters
 
+          # @!attribute thread_id
+          #
+          #   @return [String]
+          required :thread_id, String
+
           # @!attribute after
           #   A cursor for use in pagination. `after` is an object ID that defines your place
           #   in the list. For instance, if you make a list request and receive 100 objects,
@@ -41,10 +46,12 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Beta::Threads::RunListParams::Order, nil]
           optional :order, enum: -> { OpenAI::Beta::Threads::RunListParams::Order }
 
-          # @!method initialize(after: nil, before: nil, limit: nil, order: nil, request_options: {})
+          # @!method initialize(thread_id:, after: nil, before: nil, limit: nil, order: nil, request_options: {})
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Beta::Threads::RunListParams} for more details.
           #
+          #   @param thread_id [String]
+          #
           #   @param after [String] A cursor for use in pagination. `after` is an object ID that defines your place
           #
           #   @param before [String] A cursor for use in pagination. `before` is an object ID that defines your place

data/lib/openai/models/beta/threads/run_retrieve_params.rb

@@ -14,8 +14,14 @@ module OpenAI
           #   @return [String]
           required :thread_id, String
 
-          # @!method initialize(thread_id:, request_options: {})
+          # @!attribute run_id
+          #
+          #   @return [String]
+          required :run_id, String
+
+          # @!method initialize(thread_id:, run_id:, request_options: {})
           #   @param thread_id [String]
+          #   @param run_id [String]
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
         end
       end

data/lib/openai/models/beta/threads/run_submit_tool_outputs_params.rb

@@ -16,6 +16,11 @@ module OpenAI
           #   @return [String]
           required :thread_id, String
 
+          # @!attribute run_id
+          #
+          #   @return [String]
+          required :run_id, String
+
           # @!attribute tool_outputs
           #   A list of tools for which the outputs are being submitted.
           #
@@ -23,9 +28,11 @@ module OpenAI
           required :tool_outputs,
                    -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Beta::Threads::RunSubmitToolOutputsParams::ToolOutput] }
 
-          # @!method initialize(thread_id:, tool_outputs:, request_options: {})
+          # @!method initialize(thread_id:, run_id:, tool_outputs:, request_options: {})
           #   @param thread_id [String]
           #
+          #   @param run_id [String]
+          #
           #   @param tool_outputs [Array<OpenAI::Models::Beta::Threads::RunSubmitToolOutputsParams::ToolOutput>] A list of tools for which the outputs are being submitted.
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/beta/threads/run_update_params.rb

@@ -14,6 +14,11 @@ module OpenAI
           #   @return [String]
           required :thread_id, String
 
+          # @!attribute run_id
+          #
+          #   @return [String]
+          required :run_id, String
+
           # @!attribute metadata
           #   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
@@ -25,12 +30,14 @@ module OpenAI
           #   @return [Hash{Symbol=>String}, nil]
           optional :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
-          # @!method initialize(thread_id:, metadata: nil, request_options: {})
+          # @!method initialize(thread_id:, run_id:, metadata: nil, request_options: {})
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Beta::Threads::RunUpdateParams} for more details.
           #
           #   @param thread_id [String]
           #
+          #   @param run_id [String]
+          #
           #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
           #
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/beta/threads/runs/step_list_params.rb

@@ -15,6 +15,11 @@ module OpenAI
             #   @return [String]
             required :thread_id, String
 
+            # @!attribute run_id
+            #
+            #   @return [String]
+            required :run_id, String
+
             # @!attribute after
             #   A cursor for use in pagination. `after` is an object ID that defines your place
             #   in the list. For instance, if you make a list request and receive 100 objects,
@@ -60,12 +65,14 @@ module OpenAI
             #   @return [Symbol, OpenAI::Models::Beta::Threads::Runs::StepListParams::Order, nil]
             optional :order, enum: -> { OpenAI::Beta::Threads::Runs::StepListParams::Order }
 
-            # @!method initialize(thread_id:, after: nil, before: nil, include: nil, limit: nil, order: nil, request_options: {})
+            # @!method initialize(thread_id:, run_id:, after: nil, before: nil, include: nil, limit: nil, order: nil, request_options: {})
             #   Some parameter documentations has been truncated, see
             #   {OpenAI::Models::Beta::Threads::Runs::StepListParams} for more details.
             #
             #   @param thread_id [String]
             #
+            #   @param run_id [String]
+            #
             #   @param after [String] A cursor for use in pagination. `after` is an object ID that defines your place
             #
             #   @param before [String] A cursor for use in pagination. `before` is an object ID that defines your place

data/lib/openai/models/beta/threads/runs/step_retrieve_params.rb

@@ -20,6 +20,11 @@ module OpenAI
             #   @return [String]
             required :run_id, String
 
+            # @!attribute step_id
+            #
+            #   @return [String]
+            required :step_id, String
+
             # @!attribute include
             #   A list of additional fields to include in the response. Currently the only
             #   supported value is `step_details.tool_calls[*].file_search.results[*].content`
@@ -33,7 +38,7 @@ module OpenAI
             optional :include,
                      -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Beta::Threads::Runs::RunStepInclude] }
 
-            # @!method initialize(thread_id:, run_id:, include: nil, request_options: {})
+            # @!method initialize(thread_id:, run_id:, step_id:, include: nil, request_options: {})
             #   Some parameter documentations has been truncated, see
             #   {OpenAI::Models::Beta::Threads::Runs::StepRetrieveParams} for more details.
             #
@@ -41,6 +46,8 @@ module OpenAI
             #
             #   @param run_id [String]
             #
+            #   @param step_id [String]
+            #
             #   @param include [Array<Symbol, OpenAI::Models::Beta::Threads::Runs::RunStepInclude>] A list of additional fields to include in the response. Currently the only suppo
             #
             #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/chat/completion_delete_params.rb

@@ -8,7 +8,13 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute completion_id
+        #
+        #   @return [String]
+        required :completion_id, String
+
+        # @!method initialize(completion_id:, request_options: {})
+        #   @param completion_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/chat/completion_retrieve_params.rb

@@ -8,7 +8,13 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute completion_id
+        #
+        #   @return [String]
+        required :completion_id, String
+
+        # @!method initialize(completion_id:, request_options: {})
+        #   @param completion_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/chat/completion_update_params.rb

@@ -8,6 +8,11 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # @!attribute completion_id
+        #
+        #   @return [String]
+        required :completion_id, String
+
         # @!attribute metadata
         #   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
@@ -19,10 +24,12 @@ module OpenAI
         #   @return [Hash{Symbol=>String}, nil]
         required :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
-        # @!method initialize(metadata:, request_options: {})
+        # @!method initialize(completion_id:, metadata:, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Chat::CompletionUpdateParams} for more details.
         #
+        #   @param completion_id [String]
+        #
         #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/chat/completions/message_list_params.rb

@@ -9,6 +9,11 @@ module OpenAI
           extend OpenAI::Internal::Type::RequestParameters::Converter
           include OpenAI::Internal::Type::RequestParameters
 
+          # @!attribute completion_id
+          #
+          #   @return [String]
+          required :completion_id, String
+
           # @!attribute after
           #   Identifier for the last message from the previous pagination request.
           #
@@ -28,10 +33,12 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Chat::Completions::MessageListParams::Order, nil]
           optional :order, enum: -> { OpenAI::Chat::Completions::MessageListParams::Order }
 
-          # @!method initialize(after: nil, limit: nil, order: nil, request_options: {})
+          # @!method initialize(completion_id:, after: nil, limit: nil, order: nil, request_options: {})
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Chat::Completions::MessageListParams} for more details.
           #
+          #   @param completion_id [String]
+          #
           #   @param after [String] Identifier for the last message from the previous pagination request.
           #
           #   @param limit [Integer] Number of messages to retrieve.

data/lib/openai/models/chat_model.rb

@@ -5,6 +5,8 @@ module OpenAI
     module ChatModel
       extend OpenAI::Internal::Type::Enum
 
+      GPT_5_4 = :"gpt-5.4"
+      GPT_5_3_CHAT_LATEST = :"gpt-5.3-chat-latest"
       GPT_5_2 = :"gpt-5.2"
       GPT_5_2_2025_12_11 = :"gpt-5.2-2025-12-11"
       GPT_5_2_CHAT_LATEST = :"gpt-5.2-chat-latest"

data/lib/openai/models/container_delete_params.rb

@@ -7,7 +7,13 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute container_id
+      #
+      #   @return [String]
+      required :container_id, String
+
+      # @!method initialize(container_id:, request_options: {})
+      #   @param container_id [String]
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/openai/models/container_retrieve_params.rb

@@ -7,7 +7,13 @@ module OpenAI
       extend OpenAI::Internal::Type::RequestParameters::Converter
       include OpenAI::Internal::Type::RequestParameters
 
-      # @!method initialize(request_options: {})
+      # @!attribute container_id
+      #
+      #   @return [String]
+      required :container_id, String
+
+      # @!method initialize(container_id:, request_options: {})
+      #   @param container_id [String]
       #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/openai/models/containers/file_create_params.rb

@@ -8,6 +8,11 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # @!attribute container_id
+        #
+        #   @return [String]
+        required :container_id, String
+
         # @!attribute file
         #   The File object (not file name) to be uploaded.
         #
@@ -20,10 +25,12 @@ module OpenAI
         #   @return [String, nil]
         optional :file_id, String
 
-        # @!method initialize(file: nil, file_id: nil, request_options: {})
+        # @!method initialize(container_id:, file: nil, file_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Containers::FileCreateParams} for more details.
         #
+        #   @param container_id [String]
+        #
         #   @param file [Pathname, StringIO, IO, String, OpenAI::FilePart] The File object (not file name) to be uploaded.
         #
         #   @param file_id [String] Name of the file to create.

data/lib/openai/models/containers/file_delete_params.rb

@@ -13,8 +13,14 @@ module OpenAI
         #   @return [String]
         required :container_id, String
 
-        # @!method initialize(container_id:, request_options: {})
+        # @!attribute file_id
+        #
+        #   @return [String]
+        required :file_id, String
+
+        # @!method initialize(container_id:, file_id:, request_options: {})
         #   @param container_id [String]
+        #   @param file_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/containers/file_list_params.rb

@@ -8,6 +8,11 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # @!attribute container_id
+        #
+        #   @return [String]
+        required :container_id, String
+
         # @!attribute after
         #   A cursor for use in pagination. `after` is an object ID that defines your place
         #   in the list. For instance, if you make a list request and receive 100 objects,
@@ -31,10 +36,12 @@ module OpenAI
         #   @return [Symbol, OpenAI::Models::Containers::FileListParams::Order, nil]
         optional :order, enum: -> { OpenAI::Containers::FileListParams::Order }
 
-        # @!method initialize(after: nil, limit: nil, order: nil, request_options: {})
+        # @!method initialize(container_id:, after: nil, limit: nil, order: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Containers::FileListParams} for more details.
         #
+        #   @param container_id [String]
+        #
         #   @param after [String] A cursor for use in pagination. `after` is an object ID that defines your place
         #
         #   @param limit [Integer] A limit on the number of objects to be returned. Limit can range between 1 and 1

data/lib/openai/models/containers/file_retrieve_params.rb

@@ -13,8 +13,14 @@ module OpenAI
         #   @return [String]
         required :container_id, String
 
-        # @!method initialize(container_id:, request_options: {})
+        # @!attribute file_id
+        #
+        #   @return [String]
+        required :file_id, String
+
+        # @!method initialize(container_id:, file_id:, request_options: {})
         #   @param container_id [String]
+        #   @param file_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/containers/files/content_retrieve_params.rb

@@ -14,8 +14,14 @@ module OpenAI
           #   @return [String]
           required :container_id, String
 
-          # @!method initialize(container_id:, request_options: {})
+          # @!attribute file_id
+          #
+          #   @return [String]
+          required :file_id, String
+
+          # @!method initialize(container_id:, file_id:, request_options: {})
           #   @param container_id [String]
+          #   @param file_id [String]
           #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
         end
       end

data/lib/openai/models/conversations/computer_screenshot_content.rb

@@ -4,6 +4,13 @@ module OpenAI
   module Models
     module Conversations
       class ComputerScreenshotContent < OpenAI::Internal::Type::BaseModel
+        # @!attribute detail
+        #   The detail level of the screenshot image to be sent to the model. One of `high`,
+        #   `low`, `auto`, or `original`. Defaults to `auto`.
+        #
+        #   @return [Symbol, OpenAI::Models::Conversations::ComputerScreenshotContent::Detail]
+        required :detail, enum: -> { OpenAI::Conversations::ComputerScreenshotContent::Detail }
+
         # @!attribute file_id
         #   The identifier of an uploaded file that contains the screenshot.
         #
@@ -23,17 +30,35 @@ module OpenAI
         #   @return [Symbol, :computer_screenshot]
         required :type, const: :computer_screenshot
 
-        # @!method initialize(file_id:, image_url:, type: :computer_screenshot)
+        # @!method initialize(detail:, file_id:, image_url:, type: :computer_screenshot)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Conversations::ComputerScreenshotContent} for more details.
         #
         #   A screenshot of a computer.
         #
+        #   @param detail [Symbol, OpenAI::Models::Conversations::ComputerScreenshotContent::Detail] The detail level of the screenshot image to be sent to the model. One of `high`,
+        #
         #   @param file_id [String, nil] The identifier of an uploaded file that contains the screenshot.
         #
         #   @param image_url [String, nil] The URL of the screenshot image.
         #
         #   @param type [Symbol, :computer_screenshot] Specifies the event type. For a computer screenshot, this property is always set
+
+        # The detail level of the screenshot image to be sent to the model. One of `high`,
+        # `low`, `auto`, or `original`. Defaults to `auto`.
+        #
+        # @see OpenAI::Models::Conversations::ComputerScreenshotContent#detail
+        module Detail
+          extend OpenAI::Internal::Type::Enum
+
+          LOW = :low
+          HIGH = :high
+          AUTO = :auto
+          ORIGINAL = :original
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

data/lib/openai/models/conversations/conversation_create_params.rb

@@ -12,7 +12,7 @@ module OpenAI
         #   Initial items to include in the conversation context. You may add up to 20 items
         #   at a time.
         #
-        #   @return [Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, 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]
+        #   @return [Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, 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]
         optional :items,
                  -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseInputItem] },
                  nil?: true
@@ -32,7 +32,7 @@ module OpenAI
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Conversations::ConversationCreateParams} for more details.
         #
-        #   @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::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, 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. You may add up to 20 items
+        #   @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::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, 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. You may add up to 20 items
         #
         #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
         #

data/lib/openai/models/conversations/conversation_delete_params.rb

@@ -8,7 +8,13 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute conversation_id
+        #
+        #   @return [String]
+        required :conversation_id, String
+
+        # @!method initialize(conversation_id:, request_options: {})
+        #   @param conversation_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/conversations/conversation_item.rb

@@ -39,6 +39,10 @@ module OpenAI
 
         variant :computer_call_output, -> { OpenAI::Responses::ResponseComputerToolCallOutputItem }
 
+        variant :tool_search_call, -> { OpenAI::Responses::ResponseToolSearchCall }
+
+        variant :tool_search_output, -> { OpenAI::Responses::ResponseToolSearchOutputItem }
+
         # A description of the chain of thought used by a reasoning model while generating
         # a response. Be sure to include these items in your `input` to the Responses API
         # for subsequent turns of a conversation if you are manually
@@ -604,7 +608,7 @@ module OpenAI
         end
 
         # @!method self.variants
-        #   @return [Array(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::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, 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)]
+        #   @return [Array(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::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, 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)]
       end
     end
 

data/lib/openai/models/conversations/conversation_item_list.rb

@@ -8,7 +8,7 @@ module OpenAI
         # @!attribute data
         #   A list of conversation items.
         #
-        #   @return [Array<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::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, 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>]
+        #   @return [Array<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::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, 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>]
         required :data, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Conversations::ConversationItem] }
 
         # @!attribute first_id
@@ -38,7 +38,7 @@ module OpenAI
         # @!method initialize(data:, first_id:, has_more:, last_id:, object: :list)
         #   A list of Conversation items.
         #
-        #   @param data [Array<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::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, 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>] A list of conversation items.
+        #   @param data [Array<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::ResponseToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItem, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCall, OpenAI::Models::Conversations::ConversationItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseFunctionShellToolCall, OpenAI::Models::Responses::ResponseFunctionShellToolCallOutput, OpenAI::Models::Responses::ResponseApplyPatchToolCall, OpenAI::Models::Responses::ResponseApplyPatchToolCallOutput, 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>] A list of conversation items.
         #
         #   @param first_id [String] The ID of the first item in the list.
         #

data/lib/openai/models/conversations/conversation_retrieve_params.rb

@@ -8,7 +8,13 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
-        # @!method initialize(request_options: {})
+        # @!attribute conversation_id
+        #
+        #   @return [String]
+        required :conversation_id, String
+
+        # @!method initialize(conversation_id:, request_options: {})
+        #   @param conversation_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end

data/lib/openai/models/conversations/conversation_update_params.rb

@@ -8,6 +8,11 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # @!attribute conversation_id
+        #
+        #   @return [String]
+        required :conversation_id, String
+
         # @!attribute metadata
         #   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
@@ -19,10 +24,12 @@ module OpenAI
         #   @return [Hash{Symbol=>String}, nil]
         required :metadata, OpenAI::Internal::Type::HashOf[String], nil?: true
 
-        # @!method initialize(metadata:, request_options: {})
+        # @!method initialize(conversation_id:, metadata:, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Conversations::ConversationUpdateParams} for more details.
         #
+        #   @param conversation_id [String]
+        #
         #   @param metadata [Hash{Symbol=>String}, nil] Set of 16 key-value pairs that can be attached to an object. This can be
         #
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]

data/lib/openai/models/conversations/item_create_params.rb

@@ -8,10 +8,15 @@ module OpenAI
         extend OpenAI::Internal::Type::RequestParameters::Converter
         include OpenAI::Internal::Type::RequestParameters
 
+        # @!attribute conversation_id
+        #
+        #   @return [String]
+        required :conversation_id, String
+
         # @!attribute items
         #   The items to add to the conversation. You may add up to 20 items at a time.
         #
-        #   @return [Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, 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>]
+        #   @return [Array<OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, 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>]
         required :items, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Responses::ResponseInputItem] }
 
         # @!attribute include
@@ -22,11 +27,13 @@ module OpenAI
         #   @return [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>, nil]
         optional :include, -> { OpenAI::Internal::Type::ArrayOf[enum: OpenAI::Responses::ResponseIncludable] }
 
-        # @!method initialize(items:, include: nil, request_options: {})
+        # @!method initialize(conversation_id:, items:, include: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Conversations::ItemCreateParams} for more details.
         #
-        #   @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::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, 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>] The items to add to the conversation. You may add up to 20 items at a time.
+        #   @param conversation_id [String]
+        #
+        #   @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::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, 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>] The items to add to the conversation. You may add up to 20 items at a time.
         #
         #   @param include [Array<Symbol, OpenAI::Models::Responses::ResponseIncludable>] Additional fields to include in the response. See the `include`
         #

data/lib/openai/models/conversations/item_delete_params.rb

@@ -13,8 +13,14 @@ module OpenAI
         #   @return [String]
         required :conversation_id, String
 
-        # @!method initialize(conversation_id:, request_options: {})
+        # @!attribute item_id
+        #
+        #   @return [String]
+        required :item_id, String
+
+        # @!method initialize(conversation_id:, item_id:, request_options: {})
         #   @param conversation_id [String]
+        #   @param item_id [String]
         #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
       end
     end