openai 0.23.3 → 0.25.0

data/rbi/openai/models/graders/score_model_grader.rbi

@@ -35,10 +35,17 @@ module OpenAI
         attr_writer :range
 
         # The sampling parameters for the model.
-        sig { returns(T.nilable(T.anything)) }
+        sig do
+          returns(T.nilable(OpenAI::Graders::ScoreModelGrader::SamplingParams))
+        end
         attr_reader :sampling_params
 
-        sig { params(sampling_params: T.anything).void }
+        sig do
+          params(
+            sampling_params:
+              OpenAI::Graders::ScoreModelGrader::SamplingParams::OrHash
+          ).void
+        end
         attr_writer :sampling_params
 
         # A ScoreModelGrader object that uses a model to assign a score to the input.
@@ -48,7 +55,8 @@ module OpenAI
             model: String,
             name: String,
             range: T::Array[Float],
-            sampling_params: T.anything,
+            sampling_params:
+              OpenAI::Graders::ScoreModelGrader::SamplingParams::OrHash,
             type: Symbol
           ).returns(T.attached_class)
         end
@@ -76,7 +84,7 @@ module OpenAI
               name: String,
               type: Symbol,
               range: T::Array[Float],
-              sampling_params: T.anything
+              sampling_params: OpenAI::Graders::ScoreModelGrader::SamplingParams
             }
           )
         end
@@ -372,6 +380,82 @@ module OpenAI
             end
           end
         end
+
+        class SamplingParams < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Graders::ScoreModelGrader::SamplingParams,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The maximum number of tokens the grader model may generate in its response.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :max_completions_tokens
+
+          # Constrains effort on reasoning for
+          # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+          # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+          # effort can result in faster responses and fewer tokens used on reasoning in a
+          # response.
+          sig { returns(T.nilable(OpenAI::ReasoningEffort::OrSymbol)) }
+          attr_accessor :reasoning_effort
+
+          # A seed value to initialize the randomness, during sampling.
+          sig { returns(T.nilable(Integer)) }
+          attr_accessor :seed
+
+          # A higher temperature increases randomness in the outputs.
+          sig { returns(T.nilable(Float)) }
+          attr_accessor :temperature
+
+          # An alternative to temperature for nucleus sampling; 1.0 includes all tokens.
+          sig { returns(T.nilable(Float)) }
+          attr_accessor :top_p
+
+          # The sampling parameters for the model.
+          sig do
+            params(
+              max_completions_tokens: T.nilable(Integer),
+              reasoning_effort: T.nilable(OpenAI::ReasoningEffort::OrSymbol),
+              seed: T.nilable(Integer),
+              temperature: T.nilable(Float),
+              top_p: T.nilable(Float)
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # The maximum number of tokens the grader model may generate in its response.
+            max_completions_tokens: nil,
+            # Constrains effort on reasoning for
+            # [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+            # supported values are `minimal`, `low`, `medium`, and `high`. Reducing reasoning
+            # effort can result in faster responses and fewer tokens used on reasoning in a
+            # response.
+            reasoning_effort: nil,
+            # A seed value to initialize the randomness, during sampling.
+            seed: nil,
+            # A higher temperature increases randomness in the outputs.
+            temperature: nil,
+            # An alternative to temperature for nucleus sampling; 1.0 includes all tokens.
+            top_p: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                max_completions_tokens: T.nilable(Integer),
+                reasoning_effort: T.nilable(OpenAI::ReasoningEffort::OrSymbol),
+                seed: T.nilable(Integer),
+                temperature: T.nilable(Float),
+                top_p: T.nilable(Float)
+              }
+            )
+          end
+          def to_hash
+          end
+        end
       end
     end
   end

data/rbi/openai/models/responses/response_content.rbi

@@ -15,10 +15,43 @@ module OpenAI
               OpenAI::Responses::ResponseInputFile,
               OpenAI::Responses::ResponseInputAudio,
               OpenAI::Responses::ResponseOutputText,
-              OpenAI::Responses::ResponseOutputRefusal
+              OpenAI::Responses::ResponseOutputRefusal,
+              OpenAI::Responses::ResponseContent::ReasoningTextContent
             )
           end
 
+        class ReasoningTextContent < OpenAI::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                OpenAI::Responses::ResponseContent::ReasoningTextContent,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+          # The reasoning text from the model.
+          sig { returns(String) }
+          attr_accessor :text
+
+          # The type of the reasoning text. Always `reasoning_text`.
+          sig { returns(Symbol) }
+          attr_accessor :type
+
+          # Reasoning text from the model.
+          sig { params(text: String, type: Symbol).returns(T.attached_class) }
+          def self.new(
+            # The reasoning text from the model.
+            text:,
+            # The type of the reasoning text. Always `reasoning_text`.
+            type: :reasoning_text
+          )
+          end
+
+          sig { override.returns({ text: String, type: Symbol }) }
+          def to_hash
+          end
+        end
+
         sig do
           override.returns(
             T::Array[OpenAI::Responses::ResponseContent::Variants]

data/rbi/openai/models/responses/response_content_part_added_event.rbi

@@ -49,7 +49,8 @@ module OpenAI
             part:
               T.any(
                 OpenAI::Responses::ResponseOutputText::OrHash,
-                OpenAI::Responses::ResponseOutputRefusal::OrHash
+                OpenAI::Responses::ResponseOutputRefusal::OrHash,
+                OpenAI::Responses::ResponseContentPartAddedEvent::Part::ReasoningText::OrHash
               ),
             sequence_number: Integer,
             type: Symbol
@@ -95,10 +96,43 @@ module OpenAI
             T.type_alias do
               T.any(
                 OpenAI::Responses::ResponseOutputText,
-                OpenAI::Responses::ResponseOutputRefusal
+                OpenAI::Responses::ResponseOutputRefusal,
+                OpenAI::Responses::ResponseContentPartAddedEvent::Part::ReasoningText
               )
             end
 
+          class ReasoningText < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Responses::ResponseContentPartAddedEvent::Part::ReasoningText,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # The reasoning text from the model.
+            sig { returns(String) }
+            attr_accessor :text
+
+            # The type of the reasoning text. Always `reasoning_text`.
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # Reasoning text from the model.
+            sig { params(text: String, type: Symbol).returns(T.attached_class) }
+            def self.new(
+              # The reasoning text from the model.
+              text:,
+              # The type of the reasoning text. Always `reasoning_text`.
+              type: :reasoning_text
+            )
+            end
+
+            sig { override.returns({ text: String, type: Symbol }) }
+            def to_hash
+            end
+          end
+
           sig do
             override.returns(
               T::Array[

data/rbi/openai/models/responses/response_content_part_done_event.rbi

@@ -49,7 +49,8 @@ module OpenAI
             part:
               T.any(
                 OpenAI::Responses::ResponseOutputText::OrHash,
-                OpenAI::Responses::ResponseOutputRefusal::OrHash
+                OpenAI::Responses::ResponseOutputRefusal::OrHash,
+                OpenAI::Responses::ResponseContentPartDoneEvent::Part::ReasoningText::OrHash
               ),
             sequence_number: Integer,
             type: Symbol
@@ -95,10 +96,43 @@ module OpenAI
             T.type_alias do
               T.any(
                 OpenAI::Responses::ResponseOutputText,
-                OpenAI::Responses::ResponseOutputRefusal
+                OpenAI::Responses::ResponseOutputRefusal,
+                OpenAI::Responses::ResponseContentPartDoneEvent::Part::ReasoningText
               )
             end
 
+          class ReasoningText < OpenAI::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  OpenAI::Responses::ResponseContentPartDoneEvent::Part::ReasoningText,
+                  OpenAI::Internal::AnyHash
+                )
+              end
+
+            # The reasoning text from the model.
+            sig { returns(String) }
+            attr_accessor :text
+
+            # The type of the reasoning text. Always `reasoning_text`.
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # Reasoning text from the model.
+            sig { params(text: String, type: Symbol).returns(T.attached_class) }
+            def self.new(
+              # The reasoning text from the model.
+              text:,
+              # The type of the reasoning text. Always `reasoning_text`.
+              type: :reasoning_text
+            )
+            end
+
+            sig { override.returns({ text: String, type: Symbol }) }
+            def to_hash
+            end
+          end
+
           sig do
             override.returns(
               T::Array[

data/rbi/openai/models/responses/response_reasoning_item.rbi

@@ -141,6 +141,7 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :type
 
+          # A summary text from the model.
           sig { params(text: String, type: Symbol).returns(T.attached_class) }
           def self.new(
             # A summary of the reasoning output from the model so far.
@@ -164,19 +165,20 @@ module OpenAI
               )
             end
 
-          # Reasoning text output from the model.
+          # The reasoning text from the model.
           sig { returns(String) }
           attr_accessor :text
 
-          # The type of the object. Always `reasoning_text`.
+          # The type of the reasoning text. Always `reasoning_text`.
           sig { returns(Symbol) }
           attr_accessor :type
 
+          # Reasoning text from the model.
           sig { params(text: String, type: Symbol).returns(T.attached_class) }
           def self.new(
-            # Reasoning text output from the model.
+            # The reasoning text from the model.
             text:,
-            # The type of the object. Always `reasoning_text`.
+            # The type of the reasoning text. Always `reasoning_text`.
             type: :reasoning_text
           )
           end

data/sig/openai/errors.rbs

@@ -21,6 +21,8 @@ module OpenAI
 
       attr_accessor status: Integer?
 
+      attr_accessor headers: ::Hash[String, String]?
+
       attr_accessor body: top?
 
       attr_accessor code: String?
@@ -32,6 +34,7 @@ module OpenAI
       def initialize: (
         url: URI::Generic,
         ?status: Integer?,
+        ?headers: ::Hash[String, String]?,
         ?body: Object?,
         ?request: nil,
         ?response: nil,
@@ -43,6 +46,7 @@ module OpenAI
       def initialize: (
         url: URI::Generic,
         ?status: nil,
+        ?headers: ::Hash[String, String]?,
         ?body: nil,
         ?request: nil,
         ?response: nil,
@@ -54,6 +58,7 @@ module OpenAI
       def initialize: (
         url: URI::Generic,
         ?status: nil,
+        ?headers: ::Hash[String, String]?,
         ?body: nil,
         ?request: nil,
         ?response: nil,
@@ -65,6 +70,7 @@ module OpenAI
       def self.for: (
         url: URI::Generic,
         status: Integer,
+        headers: ::Hash[String, String]?,
         body: Object?,
         request: nil,
         response: nil,
@@ -74,6 +80,7 @@ module OpenAI
       def initialize: (
         url: URI::Generic,
         status: Integer,
+        headers: ::Hash[String, String]?,
         body: Object?,
         request: nil,
         response: nil,

data/sig/openai/internal/type/base_stream.rbs

@@ -8,6 +8,10 @@ module OpenAI
           Enumerable[top] stream
         ) -> (^(Integer arg0) -> void)
 
+        attr_reader status: Integer
+
+        attr_reader headers: ::Hash[String, String]
+
         def close: -> void
 
         private def iterator: -> Enumerable[Elem]
@@ -22,6 +26,7 @@ module OpenAI
           model: Class | OpenAI::Internal::Type::Converter,
           url: URI::Generic,
           status: Integer,
+          headers: ::Hash[String, String],
           response: top,
           unwrap: Symbol
           | Integer

data/sig/openai/models/conversations/input_file_content.rbs

@@ -1,41 +1,7 @@
 module OpenAI
   module Models
     module Conversations
-      type input_file_content =
-        {
-          file_id: String?,
-          type: :input_file,
-          file_url: String,
-          filename: String
-        }
-
-      class InputFileContent < OpenAI::Internal::Type::BaseModel
-        attr_accessor file_id: String?
-
-        attr_accessor type: :input_file
-
-        attr_reader file_url: String?
-
-        def file_url=: (String) -> String
-
-        attr_reader filename: String?
-
-        def filename=: (String) -> String
-
-        def initialize: (
-          file_id: String?,
-          ?file_url: String,
-          ?filename: String,
-          ?type: :input_file
-        ) -> void
-
-        def to_hash: -> {
-          file_id: String?,
-          type: :input_file,
-          file_url: String,
-          filename: String
-        }
-      end
+      class InputFileContent = OpenAI::Models::Responses::ResponseInputFile
     end
   end
 end

data/sig/openai/models/conversations/input_image_content.rbs

@@ -1,49 +1,7 @@
 module OpenAI
   module Models
     module Conversations
-      type input_image_content =
-        {
-          detail: OpenAI::Models::Conversations::InputImageContent::detail,
-          file_id: String?,
-          image_url: String?,
-          type: :input_image
-        }
-
-      class InputImageContent < OpenAI::Internal::Type::BaseModel
-        attr_accessor detail: OpenAI::Models::Conversations::InputImageContent::detail
-
-        attr_accessor file_id: String?
-
-        attr_accessor image_url: String?
-
-        attr_accessor type: :input_image
-
-        def initialize: (
-          detail: OpenAI::Models::Conversations::InputImageContent::detail,
-          file_id: String?,
-          image_url: String?,
-          ?type: :input_image
-        ) -> void
-
-        def to_hash: -> {
-          detail: OpenAI::Models::Conversations::InputImageContent::detail,
-          file_id: String?,
-          image_url: String?,
-          type: :input_image
-        }
-
-        type detail = :low | :high | :auto
-
-        module Detail
-          extend OpenAI::Internal::Type::Enum
-
-          LOW: :low
-          HIGH: :high
-          AUTO: :auto
-
-          def self?.values: -> ::Array[OpenAI::Models::Conversations::InputImageContent::detail]
-        end
-      end
+      class InputImageContent = OpenAI::Models::Responses::ResponseInputImage
     end
   end
 end

data/sig/openai/models/conversations/input_text_content.rbs

@@ -1,17 +1,7 @@
 module OpenAI
   module Models
     module Conversations
-      type input_text_content = { text: String, type: :input_text }
-
-      class InputTextContent < OpenAI::Internal::Type::BaseModel
-        attr_accessor text: String
-
-        attr_accessor type: :input_text
-
-        def initialize: (text: String, ?type: :input_text) -> void
-
-        def to_hash: -> { text: String, type: :input_text }
-      end
+      class InputTextContent = OpenAI::Models::Responses::ResponseInputText
     end
   end
 end

data/sig/openai/models/conversations/message.rbs

@@ -38,18 +38,31 @@ module OpenAI
         }
 
         type content =
-          OpenAI::Conversations::InputTextContent
-          | OpenAI::Conversations::OutputTextContent
+          OpenAI::Responses::ResponseInputText
+          | OpenAI::Responses::ResponseOutputText
           | OpenAI::Conversations::TextContent
           | OpenAI::Conversations::SummaryTextContent
-          | OpenAI::Conversations::RefusalContent
-          | OpenAI::Conversations::InputImageContent
+          | OpenAI::Conversations::Message::Content::ReasoningText
+          | OpenAI::Responses::ResponseOutputRefusal
+          | OpenAI::Responses::ResponseInputImage
           | OpenAI::Conversations::ComputerScreenshotContent
-          | OpenAI::Conversations::InputFileContent
+          | OpenAI::Responses::ResponseInputFile
 
         module Content
           extend OpenAI::Internal::Type::Union
 
+          type reasoning_text = { text: String, type: :reasoning_text }
+
+          class ReasoningText < OpenAI::Internal::Type::BaseModel
+            attr_accessor text: String
+
+            attr_accessor type: :reasoning_text
+
+            def initialize: (text: String, ?type: :reasoning_text) -> void
+
+            def to_hash: -> { text: String, type: :reasoning_text }
+          end
+
           def self?.variants: -> ::Array[OpenAI::Models::Conversations::Message::content]
         end
 

data/sig/openai/models/conversations/output_text_content.rbs

@@ -1,52 +1,7 @@
 module OpenAI
   module Models
     module Conversations
-      type output_text_content =
-        {
-          annotations: ::Array[OpenAI::Models::Conversations::OutputTextContent::annotation],
-          text: String,
-          type: :output_text,
-          logprobs: ::Array[OpenAI::Conversations::LobProb]
-        }
-
-      class OutputTextContent < OpenAI::Internal::Type::BaseModel
-        attr_accessor annotations: ::Array[OpenAI::Models::Conversations::OutputTextContent::annotation]
-
-        attr_accessor text: String
-
-        attr_accessor type: :output_text
-
-        attr_reader logprobs: ::Array[OpenAI::Conversations::LobProb]?
-
-        def logprobs=: (
-          ::Array[OpenAI::Conversations::LobProb]
-        ) -> ::Array[OpenAI::Conversations::LobProb]
-
-        def initialize: (
-          annotations: ::Array[OpenAI::Models::Conversations::OutputTextContent::annotation],
-          text: String,
-          ?logprobs: ::Array[OpenAI::Conversations::LobProb],
-          ?type: :output_text
-        ) -> void
-
-        def to_hash: -> {
-          annotations: ::Array[OpenAI::Models::Conversations::OutputTextContent::annotation],
-          text: String,
-          type: :output_text,
-          logprobs: ::Array[OpenAI::Conversations::LobProb]
-        }
-
-        type annotation =
-          OpenAI::Conversations::FileCitationBody
-          | OpenAI::Conversations::URLCitationBody
-          | OpenAI::Conversations::ContainerFileCitationBody
-
-        module Annotation
-          extend OpenAI::Internal::Type::Union
-
-          def self?.variants: -> ::Array[OpenAI::Models::Conversations::OutputTextContent::annotation]
-        end
-      end
+      class OutputTextContent = OpenAI::Models::Responses::ResponseOutputText
     end
   end
 end

data/sig/openai/models/conversations/refusal_content.rbs

@@ -1,17 +1,7 @@
 module OpenAI
   module Models
     module Conversations
-      type refusal_content = { refusal: String, type: :refusal }
-
-      class RefusalContent < OpenAI::Internal::Type::BaseModel
-        attr_accessor refusal: String
-
-        attr_accessor type: :refusal
-
-        def initialize: (refusal: String, ?type: :refusal) -> void
-
-        def to_hash: -> { refusal: String, type: :refusal }
-      end
+      class RefusalContent = OpenAI::Models::Responses::ResponseOutputRefusal
     end
   end
 end

data/sig/openai/models/evals/create_eval_completions_run_data_source.rbs

@@ -333,6 +333,7 @@ module OpenAI
         type sampling_params =
           {
             max_completion_tokens: Integer,
+            reasoning_effort: OpenAI::Models::reasoning_effort?,
             response_format: OpenAI::Models::Evals::CreateEvalCompletionsRunDataSource::SamplingParams::response_format,
             seed: Integer,
             temperature: Float,
@@ -345,6 +346,8 @@ module OpenAI
 
           def max_completion_tokens=: (Integer) -> Integer
 
+          attr_accessor reasoning_effort: OpenAI::Models::reasoning_effort?
+
           attr_reader response_format: OpenAI::Models::Evals::CreateEvalCompletionsRunDataSource::SamplingParams::response_format?
 
           def response_format=: (
@@ -371,6 +374,7 @@ module OpenAI
 
           def initialize: (
             ?max_completion_tokens: Integer,
+            ?reasoning_effort: OpenAI::Models::reasoning_effort?,
             ?response_format: OpenAI::Models::Evals::CreateEvalCompletionsRunDataSource::SamplingParams::response_format,
             ?seed: Integer,
             ?temperature: Float,
@@ -380,6 +384,7 @@ module OpenAI
 
           def to_hash: -> {
             max_completion_tokens: Integer,
+            reasoning_effort: OpenAI::Models::reasoning_effort?,
             response_format: OpenAI::Models::Evals::CreateEvalCompletionsRunDataSource::SamplingParams::response_format,
             seed: Integer,
             temperature: Float,

data/sig/openai/models/evals/run_cancel_response.rbs

@@ -459,6 +459,7 @@ module OpenAI
             type sampling_params =
               {
                 max_completion_tokens: Integer,
+                reasoning_effort: OpenAI::Models::reasoning_effort?,
                 seed: Integer,
                 temperature: Float,
                 text: OpenAI::Models::Evals::RunCancelResponse::DataSource::Responses::SamplingParams::Text,
@@ -471,6 +472,8 @@ module OpenAI
 
               def max_completion_tokens=: (Integer) -> Integer
 
+              attr_accessor reasoning_effort: OpenAI::Models::reasoning_effort?
+
               attr_reader seed: Integer?
 
               def seed=: (Integer) -> Integer
@@ -497,6 +500,7 @@ module OpenAI
 
               def initialize: (
                 ?max_completion_tokens: Integer,
+                ?reasoning_effort: OpenAI::Models::reasoning_effort?,
                 ?seed: Integer,
                 ?temperature: Float,
                 ?text: OpenAI::Models::Evals::RunCancelResponse::DataSource::Responses::SamplingParams::Text,
@@ -506,6 +510,7 @@ module OpenAI
 
               def to_hash: -> {
                 max_completion_tokens: Integer,
+                reasoning_effort: OpenAI::Models::reasoning_effort?,
                 seed: Integer,
                 temperature: Float,
                 text: OpenAI::Models::Evals::RunCancelResponse::DataSource::Responses::SamplingParams::Text,