openai 0.51.0 → 0.53.0

data/rbi/openai/models/responses/response_input_file.rbi

@@ -16,6 +16,22 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The detail level of the file to be sent to the model. One of `high` or `low`.
+        # Defaults to `high`.
+        sig do
+          returns(
+            T.nilable(OpenAI::Responses::ResponseInputFile::Detail::OrSymbol)
+          )
+        end
+        attr_reader :detail
+
+        sig do
+          params(
+            detail: OpenAI::Responses::ResponseInputFile::Detail::OrSymbol
+          ).void
+        end
+        attr_writer :detail
+
         # The content of the file to be sent to the model.
         sig { returns(T.nilable(String)) }
         attr_reader :file_data
@@ -44,6 +60,7 @@ module OpenAI
         # A file input to the model.
         sig do
           params(
+            detail: OpenAI::Responses::ResponseInputFile::Detail::OrSymbol,
             file_data: String,
             file_id: T.nilable(String),
             file_url: String,
@@ -52,6 +69,9 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
+          # The detail level of the file to be sent to the model. One of `high` or `low`.
+          # Defaults to `high`.
+          detail: nil,
           # The content of the file to be sent to the model.
           file_data: nil,
           # The ID of the file to be sent to the model.
@@ -69,6 +89,7 @@ module OpenAI
           override.returns(
             {
               type: Symbol,
+              detail: OpenAI::Responses::ResponseInputFile::Detail::OrSymbol,
               file_data: String,
               file_id: T.nilable(String),
               file_url: String,
@@ -78,6 +99,39 @@ module OpenAI
         end
         def to_hash
         end
+
+        # The detail level of the file to be sent to the model. One of `high` or `low`.
+        # Defaults to `high`.
+        module Detail
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Responses::ResponseInputFile::Detail)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          LOW =
+            T.let(
+              :low,
+              OpenAI::Responses::ResponseInputFile::Detail::TaggedSymbol
+            )
+          HIGH =
+            T.let(
+              :high,
+              OpenAI::Responses::ResponseInputFile::Detail::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::ResponseInputFile::Detail::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/openai/models/responses/response_input_file_content.rbi

@@ -16,6 +16,25 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # The detail level of the file to be sent to the model. One of `high` or `low`.
+        # Defaults to `high`.
+        sig do
+          returns(
+            T.nilable(
+              OpenAI::Responses::ResponseInputFileContent::Detail::OrSymbol
+            )
+          )
+        end
+        attr_reader :detail
+
+        sig do
+          params(
+            detail:
+              OpenAI::Responses::ResponseInputFileContent::Detail::OrSymbol
+          ).void
+        end
+        attr_writer :detail
+
         # The base64-encoded data of the file to be sent to the model.
         sig { returns(T.nilable(String)) }
         attr_accessor :file_data
@@ -35,6 +54,8 @@ module OpenAI
         # A file input to the model.
         sig do
           params(
+            detail:
+              OpenAI::Responses::ResponseInputFileContent::Detail::OrSymbol,
             file_data: T.nilable(String),
             file_id: T.nilable(String),
             file_url: T.nilable(String),
@@ -43,6 +64,9 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
+          # The detail level of the file to be sent to the model. One of `high` or `low`.
+          # Defaults to `high`.
+          detail: nil,
           # The base64-encoded data of the file to be sent to the model.
           file_data: nil,
           # The ID of the file to be sent to the model.
@@ -60,6 +84,8 @@ module OpenAI
           override.returns(
             {
               type: Symbol,
+              detail:
+                OpenAI::Responses::ResponseInputFileContent::Detail::OrSymbol,
               file_data: T.nilable(String),
               file_id: T.nilable(String),
               file_url: T.nilable(String),
@@ -69,6 +95,39 @@ module OpenAI
         end
         def to_hash
         end
+
+        # The detail level of the file to be sent to the model. One of `high` or `low`.
+        # Defaults to `high`.
+        module Detail
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, OpenAI::Responses::ResponseInputFileContent::Detail)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          HIGH =
+            T.let(
+              :high,
+              OpenAI::Responses::ResponseInputFileContent::Detail::TaggedSymbol
+            )
+          LOW =
+            T.let(
+              :low,
+              OpenAI::Responses::ResponseInputFileContent::Detail::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                OpenAI::Responses::ResponseInputFileContent::Detail::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
     end
   end

data/rbi/openai/models/responses/response_input_image.rbi

@@ -12,8 +12,8 @@ module OpenAI
             )
           end
 
-        # The detail level of the image to be sent to the model. One of `high`, `low`, or
-        # `auto`. Defaults to `auto`.
+        # The detail level of the image to be sent to the model. One of `high`, `low`,
+        # `auto`, or `original`. Defaults to `auto`.
         sig { returns(OpenAI::Responses::ResponseInputImage::Detail::OrSymbol) }
         attr_accessor :detail
 
@@ -41,8 +41,8 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
-          # The detail level of the image to be sent to the model. One of `high`, `low`, or
-          # `auto`. Defaults to `auto`.
+          # The detail level of the image to be sent to the model. One of `high`, `low`,
+          # `auto`, or `original`. Defaults to `auto`.
           detail:,
           # The ID of the file to be sent to the model.
           file_id: nil,
@@ -67,8 +67,8 @@ module OpenAI
         def to_hash
         end
 
-        # The detail level of the image to be sent to the model. One of `high`, `low`, or
-        # `auto`. Defaults to `auto`.
+        # The detail level of the image to be sent to the model. One of `high`, `low`,
+        # `auto`, or `original`. Defaults to `auto`.
         module Detail
           extend OpenAI::Internal::Type::Enum
 
@@ -93,6 +93,11 @@ module OpenAI
               :auto,
               OpenAI::Responses::ResponseInputImage::Detail::TaggedSymbol
             )
+          ORIGINAL =
+            T.let(
+              :original,
+              OpenAI::Responses::ResponseInputImage::Detail::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/openai/models/responses/response_input_image_content.rbi

@@ -16,8 +16,8 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
-        # The detail level of the image to be sent to the model. One of `high`, `low`, or
-        # `auto`. Defaults to `auto`.
+        # The detail level of the image to be sent to the model. One of `high`, `low`,
+        # `auto`, or `original`. Defaults to `auto`.
         sig do
           returns(
             T.nilable(
@@ -50,8 +50,8 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
-          # The detail level of the image to be sent to the model. One of `high`, `low`, or
-          # `auto`. Defaults to `auto`.
+          # The detail level of the image to be sent to the model. One of `high`, `low`,
+          # `auto`, or `original`. Defaults to `auto`.
           detail: nil,
           # The ID of the file to be sent to the model.
           file_id: nil,
@@ -79,8 +79,8 @@ module OpenAI
         def to_hash
         end
 
-        # The detail level of the image to be sent to the model. One of `high`, `low`, or
-        # `auto`. Defaults to `auto`.
+        # The detail level of the image to be sent to the model. One of `high`, `low`,
+        # `auto`, or `original`. Defaults to `auto`.
         module Detail
           extend OpenAI::Internal::Type::Enum
 
@@ -108,6 +108,11 @@ module OpenAI
               :auto,
               OpenAI::Responses::ResponseInputImageContent::Detail::TaggedSymbol
             )
+          ORIGINAL =
+            T.let(
+              :original,
+              OpenAI::Responses::ResponseInputImageContent::Detail::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/openai/models/responses/response_input_item.rbi

@@ -23,6 +23,8 @@ module OpenAI
               OpenAI::Responses::ResponseFunctionWebSearch,
               OpenAI::Responses::ResponseFunctionToolCall,
               OpenAI::Responses::ResponseInputItem::FunctionCallOutput,
+              OpenAI::Responses::ResponseInputItem::ToolSearchCall,
+              OpenAI::Responses::ResponseToolSearchOutputItemParam,
               OpenAI::Responses::ResponseReasoningItem,
               OpenAI::Responses::ResponseCompactionItemParam,
               OpenAI::Responses::ResponseInputItem::ImageGenerationCall,
@@ -653,6 +655,184 @@ module OpenAI
           end
         end
 
+        class ToolSearchCall < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseInputItem::ToolSearchCall,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The arguments supplied to the tool search call.
+          sig { returns(T.anything) }
+          attr_accessor :arguments
+
+          # The item type. Always `tool_search_call`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          # The unique ID of this tool search call.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :id
+
+          # The unique ID of the tool search call generated by the model.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :call_id
+
+          # Whether tool search was executed by the server or by the client.
+          sig do
+            returns(
+              T.nilable(
+                OpenAI::Responses::ResponseInputItem::ToolSearchCall::Execution::OrSymbol
+              )
+            )
+          end
+          attr_reader :execution
+
+          sig do
+            params(
+              execution:
+                OpenAI::Responses::ResponseInputItem::ToolSearchCall::Execution::OrSymbol
+            ).void
+          end
+          attr_writer :execution
+
+          # The status of the tool search call.
+          sig do
+            returns(
+              T.nilable(
+                OpenAI::Responses::ResponseInputItem::ToolSearchCall::Status::OrSymbol
+              )
+            )
+          end
+          attr_accessor :status
+
+          sig do
+            params(
+              arguments: T.anything,
+              id: T.nilable(String),
+              call_id: T.nilable(String),
+              execution:
+                OpenAI::Responses::ResponseInputItem::ToolSearchCall::Execution::OrSymbol,
+              status:
+                T.nilable(
+                  OpenAI::Responses::ResponseInputItem::ToolSearchCall::Status::OrSymbol
+                ),
+              type: Symbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The arguments supplied to the tool search call.
+            arguments:,
+            # The unique ID of this tool search call.
+            id: nil,
+            # The unique ID of the tool search call generated by the model.
+            call_id: nil,
+            # Whether tool search was executed by the server or by the client.
+            execution: nil,
+            # The status of the tool search call.
+            status: nil,
+            # The item type. Always `tool_search_call`.
+            type: :tool_search_call
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                arguments: T.anything,
+                type: Symbol,
+                id: T.nilable(String),
+                call_id: T.nilable(String),
+                execution:
+                  OpenAI::Responses::ResponseInputItem::ToolSearchCall::Execution::OrSymbol,
+                status:
+                  T.nilable(
+                    OpenAI::Responses::ResponseInputItem::ToolSearchCall::Status::OrSymbol
+                  )
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # Whether tool search was executed by the server or by the client.
+          module Execution
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Responses::ResponseInputItem::ToolSearchCall::Execution
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            SERVER =
+              T.let(
+                :server,
+                OpenAI::Responses::ResponseInputItem::ToolSearchCall::Execution::TaggedSymbol
+              )
+            CLIENT =
+              T.let(
+                :client,
+                OpenAI::Responses::ResponseInputItem::ToolSearchCall::Execution::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::ResponseInputItem::ToolSearchCall::Execution::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+
+          # The status of the tool search call.
+          module Status
+            extend OpenAI::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  OpenAI::Responses::ResponseInputItem::ToolSearchCall::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            IN_PROGRESS =
+              T.let(
+                :in_progress,
+                OpenAI::Responses::ResponseInputItem::ToolSearchCall::Status::TaggedSymbol
+              )
+            COMPLETED =
+              T.let(
+                :completed,
+                OpenAI::Responses::ResponseInputItem::ToolSearchCall::Status::TaggedSymbol
+              )
+            INCOMPLETE =
+              T.let(
+                :incomplete,
+                OpenAI::Responses::ResponseInputItem::ToolSearchCall::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  OpenAI::Responses::ResponseInputItem::ToolSearchCall::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
         class ImageGenerationCall < OpenAI::Internal::Type::BaseModel
           OrHash =
             T.type_alias do

data/rbi/openai/models/responses/response_item.rbi

@@ -18,6 +18,8 @@ module OpenAI
               OpenAI::Responses::ResponseFunctionWebSearch,
               OpenAI::Responses::ResponseFunctionToolCallItem,
               OpenAI::Responses::ResponseFunctionToolCallOutputItem,
+              OpenAI::Responses::ResponseToolSearchCall,
+              OpenAI::Responses::ResponseToolSearchOutputItem,
               OpenAI::Responses::ResponseItem::ImageGenerationCall,
               OpenAI::Responses::ResponseCodeInterpreterToolCall,
               OpenAI::Responses::ResponseItem::LocalShellCall,

data/rbi/openai/models/responses/response_item_list.rbi

@@ -48,6 +48,8 @@ module OpenAI
                   OpenAI::Responses::ResponseFunctionWebSearch::OrHash,
                   OpenAI::Responses::ResponseFunctionToolCallItem::OrHash,
                   OpenAI::Responses::ResponseFunctionToolCallOutputItem::OrHash,
+                  OpenAI::Responses::ResponseToolSearchCall::OrHash,
+                  OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
                   OpenAI::Responses::ResponseItem::ImageGenerationCall::OrHash,
                   OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,
                   OpenAI::Responses::ResponseItem::LocalShellCall::OrHash,

data/rbi/openai/models/responses/response_output_item.rbi

@@ -16,6 +16,8 @@ module OpenAI
               OpenAI::Responses::ResponseFunctionWebSearch,
               OpenAI::Responses::ResponseComputerToolCall,
               OpenAI::Responses::ResponseReasoningItem,
+              OpenAI::Responses::ResponseToolSearchCall,
+              OpenAI::Responses::ResponseToolSearchOutputItem,
               OpenAI::Responses::ResponseCompactionItem,
               OpenAI::Responses::ResponseOutputItem::ImageGenerationCall,
               OpenAI::Responses::ResponseCodeInterpreterToolCall,

data/rbi/openai/models/responses/response_output_item_added_event.rbi

@@ -39,6 +39,8 @@ module OpenAI
                 OpenAI::Responses::ResponseFunctionWebSearch::OrHash,
                 OpenAI::Responses::ResponseComputerToolCall::OrHash,
                 OpenAI::Responses::ResponseReasoningItem::OrHash,
+                OpenAI::Responses::ResponseToolSearchCall::OrHash,
+                OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
                 OpenAI::Responses::ResponseCompactionItem::OrHash,
                 OpenAI::Responses::ResponseOutputItem::ImageGenerationCall::OrHash,
                 OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,

data/rbi/openai/models/responses/response_output_item_done_event.rbi

@@ -39,6 +39,8 @@ module OpenAI
                 OpenAI::Responses::ResponseFunctionWebSearch::OrHash,
                 OpenAI::Responses::ResponseComputerToolCall::OrHash,
                 OpenAI::Responses::ResponseReasoningItem::OrHash,
+                OpenAI::Responses::ResponseToolSearchCall::OrHash,
+                OpenAI::Responses::ResponseToolSearchOutputItem::OrHash,
                 OpenAI::Responses::ResponseCompactionItem::OrHash,
                 OpenAI::Responses::ResponseOutputItem::ImageGenerationCall::OrHash,
                 OpenAI::Responses::ResponseCodeInterpreterToolCall::OrHash,

data/rbi/openai/models/responses/response_output_message.rbi

@@ -44,12 +44,10 @@ module OpenAI
         sig { returns(Symbol) }
         attr_accessor :type
 
-        # The phase of an assistant message.
-        #
-        # Use `commentary` for an intermediate assistant message and `final_answer` for
-        # the final assistant message. For follow-up requests with models like
-        # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
-        # Omitting it can degrade performance. Not used for user messages.
+        # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        # sending follow-up requests, preserve and resend phase on all assistant messages
+        # — dropping it can degrade performance. Not used for user messages.
         sig do
           returns(
             T.nilable(OpenAI::Responses::ResponseOutputMessage::Phase::OrSymbol)
@@ -85,12 +83,10 @@ module OpenAI
           # The status of the message input. One of `in_progress`, `completed`, or
           # `incomplete`. Populated when input items are returned via API.
           status:,
-          # The phase of an assistant message.
-          #
-          # Use `commentary` for an intermediate assistant message and `final_answer` for
-          # the final assistant message. For follow-up requests with models like
-          # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
-          # Omitting it can degrade performance. Not used for user messages.
+          # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+          # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+          # sending follow-up requests, preserve and resend phase on all assistant messages
+          # — dropping it can degrade performance. Not used for user messages.
           phase: nil,
           # The role of the output message. Always `assistant`.
           role: :assistant,
@@ -185,12 +181,10 @@ module OpenAI
           end
         end
 
-        # The phase of an assistant message.
-        #
-        # Use `commentary` for an intermediate assistant message and `final_answer` for
-        # the final assistant message. For follow-up requests with models like
-        # `gpt-5.3-codex` and later, preserve and resend phase on all assistant messages.
-        # Omitting it can degrade performance. Not used for user messages.
+        # Labels an `assistant` message as intermediate commentary (`commentary`) or the
+        # final answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when
+        # sending follow-up requests, preserve and resend phase on all assistant messages
+        # — dropping it can degrade performance. Not used for user messages.
         module Phase
           extend OpenAI::Internal::Type::Enum
 

data/rbi/openai/models/responses/response_retrieve_params.rbi

@@ -15,6 +15,9 @@ module OpenAI
             )
           end
 
+        sig { returns(String) }
+        attr_accessor :response_id
+
         # Additional fields to include in the response. See the `include` parameter for
         # Response creation above for more information.
         sig do
@@ -52,6 +55,7 @@ module OpenAI
 
         sig do
           params(
+            response_id: String,
             include: T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol],
             include_obfuscation: T::Boolean,
             starting_after: Integer,
@@ -59,6 +63,7 @@ module OpenAI
           ).returns(T.attached_class)
         end
         def self.new(
+          response_id:,
           # Additional fields to include in the response. See the `include` parameter for
           # Response creation above for more information.
           include: nil,
@@ -78,6 +83,7 @@ module OpenAI
         sig do
           override.returns(
             {
+              response_id: String,
               include:
                 T::Array[OpenAI::Responses::ResponseIncludable::OrSymbol],
               include_obfuscation: T::Boolean,