openai 0.23.3 → 0.24.0

data/lib/openai/models/evals/create_eval_completions_run_data_source.rb

@@ -459,6 +459,16 @@ module OpenAI
           #   @return [Integer, nil]
           optional :max_completion_tokens, Integer
 
+          # @!attribute reasoning_effort
+          #   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.
+          #
+          #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
+          optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
+
           # @!attribute response_format
           #   An object specifying the format that the model must output.
           #
@@ -501,13 +511,15 @@ module OpenAI
           #   @return [Float, nil]
           optional :top_p, Float
 
-          # @!method initialize(max_completion_tokens: nil, response_format: nil, seed: nil, temperature: nil, tools: nil, top_p: nil)
+          # @!method initialize(max_completion_tokens: nil, reasoning_effort: nil, response_format: nil, seed: nil, temperature: nil, tools: nil, top_p: nil)
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Evals::CreateEvalCompletionsRunDataSource::SamplingParams} for
           #   more details.
           #
           #   @param max_completion_tokens [Integer] The maximum number of tokens in the generated output.
           #
+          #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+          #
           #   @param response_format [OpenAI::Models::ResponseFormatText, OpenAI::Models::ResponseFormatJSONSchema, OpenAI::Models::ResponseFormatJSONObject] An object specifying the format that the model must output.
           #
           #   @param seed [Integer] A seed value to initialize the randomness, during sampling.

data/lib/openai/models/evals/run_cancel_response.rb

@@ -654,6 +654,16 @@ module OpenAI
               #   @return [Integer, nil]
               optional :max_completion_tokens, Integer
 
+              # @!attribute reasoning_effort
+              #   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.
+              #
+              #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
+              optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
+
               # @!attribute seed
               #   A seed value to initialize the randomness, during sampling.
               #
@@ -702,13 +712,15 @@ module OpenAI
               #   @return [Float, nil]
               optional :top_p, Float
 
-              # @!method initialize(max_completion_tokens: nil, seed: nil, temperature: nil, text: nil, tools: nil, top_p: nil)
+              # @!method initialize(max_completion_tokens: nil, reasoning_effort: nil, seed: nil, temperature: nil, text: nil, tools: nil, top_p: nil)
               #   Some parameter documentations has been truncated, see
               #   {OpenAI::Models::Evals::RunCancelResponse::DataSource::Responses::SamplingParams}
               #   for more details.
               #
               #   @param max_completion_tokens [Integer] The maximum number of tokens in the generated output.
               #
+              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+              #
               #   @param seed [Integer] A seed value to initialize the randomness, during sampling.
               #
               #   @param temperature [Float] A higher temperature increases randomness in the outputs.

data/lib/openai/models/evals/run_create_params.rb

@@ -582,6 +582,16 @@ module OpenAI
               #   @return [Integer, nil]
               optional :max_completion_tokens, Integer
 
+              # @!attribute reasoning_effort
+              #   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.
+              #
+              #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
+              optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
+
               # @!attribute seed
               #   A seed value to initialize the randomness, during sampling.
               #
@@ -630,13 +640,15 @@ module OpenAI
               #   @return [Float, nil]
               optional :top_p, Float
 
-              # @!method initialize(max_completion_tokens: nil, seed: nil, temperature: nil, text: nil, tools: nil, top_p: nil)
+              # @!method initialize(max_completion_tokens: nil, reasoning_effort: nil, seed: nil, temperature: nil, text: nil, tools: nil, top_p: nil)
               #   Some parameter documentations has been truncated, see
               #   {OpenAI::Models::Evals::RunCreateParams::DataSource::CreateEvalResponsesRunDataSource::SamplingParams}
               #   for more details.
               #
               #   @param max_completion_tokens [Integer] The maximum number of tokens in the generated output.
               #
+              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+              #
               #   @param seed [Integer] A seed value to initialize the randomness, during sampling.
               #
               #   @param temperature [Float] A higher temperature increases randomness in the outputs.

data/lib/openai/models/evals/run_create_response.rb

@@ -654,6 +654,16 @@ module OpenAI
               #   @return [Integer, nil]
               optional :max_completion_tokens, Integer
 
+              # @!attribute reasoning_effort
+              #   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.
+              #
+              #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
+              optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
+
               # @!attribute seed
               #   A seed value to initialize the randomness, during sampling.
               #
@@ -702,13 +712,15 @@ module OpenAI
               #   @return [Float, nil]
               optional :top_p, Float
 
-              # @!method initialize(max_completion_tokens: nil, seed: nil, temperature: nil, text: nil, tools: nil, top_p: nil)
+              # @!method initialize(max_completion_tokens: nil, reasoning_effort: nil, seed: nil, temperature: nil, text: nil, tools: nil, top_p: nil)
               #   Some parameter documentations has been truncated, see
               #   {OpenAI::Models::Evals::RunCreateResponse::DataSource::Responses::SamplingParams}
               #   for more details.
               #
               #   @param max_completion_tokens [Integer] The maximum number of tokens in the generated output.
               #
+              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+              #
               #   @param seed [Integer] A seed value to initialize the randomness, during sampling.
               #
               #   @param temperature [Float] A higher temperature increases randomness in the outputs.

data/lib/openai/models/evals/run_list_response.rb

@@ -654,6 +654,16 @@ module OpenAI
               #   @return [Integer, nil]
               optional :max_completion_tokens, Integer
 
+              # @!attribute reasoning_effort
+              #   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.
+              #
+              #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
+              optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
+
               # @!attribute seed
               #   A seed value to initialize the randomness, during sampling.
               #
@@ -701,13 +711,15 @@ module OpenAI
               #   @return [Float, nil]
               optional :top_p, Float
 
-              # @!method initialize(max_completion_tokens: nil, seed: nil, temperature: nil, text: nil, tools: nil, top_p: nil)
+              # @!method initialize(max_completion_tokens: nil, reasoning_effort: nil, seed: nil, temperature: nil, text: nil, tools: nil, top_p: nil)
               #   Some parameter documentations has been truncated, see
               #   {OpenAI::Models::Evals::RunListResponse::DataSource::Responses::SamplingParams}
               #   for more details.
               #
               #   @param max_completion_tokens [Integer] The maximum number of tokens in the generated output.
               #
+              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+              #
               #   @param seed [Integer] A seed value to initialize the randomness, during sampling.
               #
               #   @param temperature [Float] A higher temperature increases randomness in the outputs.

data/lib/openai/models/evals/run_retrieve_response.rb

@@ -658,6 +658,16 @@ module OpenAI
               #   @return [Integer, nil]
               optional :max_completion_tokens, Integer
 
+              # @!attribute reasoning_effort
+              #   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.
+              #
+              #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
+              optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
+
               # @!attribute seed
               #   A seed value to initialize the randomness, during sampling.
               #
@@ -706,13 +716,15 @@ module OpenAI
               #   @return [Float, nil]
               optional :top_p, Float
 
-              # @!method initialize(max_completion_tokens: nil, seed: nil, temperature: nil, text: nil, tools: nil, top_p: nil)
+              # @!method initialize(max_completion_tokens: nil, reasoning_effort: nil, seed: nil, temperature: nil, text: nil, tools: nil, top_p: nil)
               #   Some parameter documentations has been truncated, see
               #   {OpenAI::Models::Evals::RunRetrieveResponse::DataSource::Responses::SamplingParams}
               #   for more details.
               #
               #   @param max_completion_tokens [Integer] The maximum number of tokens in the generated output.
               #
+              #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+              #
               #   @param seed [Integer] A seed value to initialize the randomness, during sampling.
               #
               #   @param temperature [Float] A higher temperature increases randomness in the outputs.

data/lib/openai/models/evals/runs/output_item_list_response.rb

@@ -43,11 +43,11 @@ module OpenAI
           required :object, const: :"eval.run.output_item"
 
           # @!attribute results
-          #   A list of results from the evaluation run.
+          #   A list of grader results for this output item.
           #
-          #   @return [Array<Hash{Symbol=>Object}>]
+          #   @return [Array<OpenAI::Models::Evals::Runs::OutputItemListResponse::Result>]
           required :results,
-                   OpenAI::Internal::Type::ArrayOf[OpenAI::Internal::Type::HashOf[OpenAI::Internal::Type::Unknown]]
+                   -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Models::Evals::Runs::OutputItemListResponse::Result] }
 
           # @!attribute run_id
           #   The identifier of the evaluation run associated with this output item.
@@ -80,7 +80,7 @@ module OpenAI
           #
           #   @param eval_id [String] The identifier of the evaluation group.
           #
-          #   @param results [Array<Hash{Symbol=>Object}>] A list of results from the evaluation run.
+          #   @param results [Array<OpenAI::Models::Evals::Runs::OutputItemListResponse::Result>] A list of grader results for this output item.
           #
           #   @param run_id [String] The identifier of the evaluation run associated with this output item.
           #
@@ -90,6 +90,51 @@ module OpenAI
           #
           #   @param object [Symbol, :"eval.run.output_item"] The type of the object. Always "eval.run.output_item".
 
+          class Result < OpenAI::Internal::Type::BaseModel
+            # @!attribute name
+            #   The name of the grader.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute passed
+            #   Whether the grader considered the output a pass.
+            #
+            #   @return [Boolean]
+            required :passed, OpenAI::Internal::Type::Boolean
+
+            # @!attribute score
+            #   The numeric score produced by the grader.
+            #
+            #   @return [Float]
+            required :score, Float
+
+            # @!attribute sample
+            #   Optional sample or intermediate data produced by the grader.
+            #
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional :sample, OpenAI::Internal::Type::HashOf[OpenAI::Internal::Type::Unknown], nil?: true
+
+            # @!attribute type
+            #   The grader type (for example, "string-check-grader").
+            #
+            #   @return [String, nil]
+            optional :type, String
+
+            # @!method initialize(name:, passed:, score:, sample: nil, type: nil)
+            #   A single grader result for an evaluation run output item.
+            #
+            #   @param name [String] The name of the grader.
+            #
+            #   @param passed [Boolean] Whether the grader considered the output a pass.
+            #
+            #   @param score [Float] The numeric score produced by the grader.
+            #
+            #   @param sample [Hash{Symbol=>Object}, nil] Optional sample or intermediate data produced by the grader.
+            #
+            #   @param type [String] The grader type (for example, "string-check-grader").
+          end
+
           # @see OpenAI::Models::Evals::Runs::OutputItemListResponse#sample
           class Sample < OpenAI::Internal::Type::BaseModel
             # @!attribute error

data/lib/openai/models/evals/runs/output_item_retrieve_response.rb

@@ -43,11 +43,11 @@ module OpenAI
           required :object, const: :"eval.run.output_item"
 
           # @!attribute results
-          #   A list of results from the evaluation run.
+          #   A list of grader results for this output item.
           #
-          #   @return [Array<Hash{Symbol=>Object}>]
+          #   @return [Array<OpenAI::Models::Evals::Runs::OutputItemRetrieveResponse::Result>]
           required :results,
-                   OpenAI::Internal::Type::ArrayOf[OpenAI::Internal::Type::HashOf[OpenAI::Internal::Type::Unknown]]
+                   -> { OpenAI::Internal::Type::ArrayOf[OpenAI::Models::Evals::Runs::OutputItemRetrieveResponse::Result] }
 
           # @!attribute run_id
           #   The identifier of the evaluation run associated with this output item.
@@ -80,7 +80,7 @@ module OpenAI
           #
           #   @param eval_id [String] The identifier of the evaluation group.
           #
-          #   @param results [Array<Hash{Symbol=>Object}>] A list of results from the evaluation run.
+          #   @param results [Array<OpenAI::Models::Evals::Runs::OutputItemRetrieveResponse::Result>] A list of grader results for this output item.
           #
           #   @param run_id [String] The identifier of the evaluation run associated with this output item.
           #
@@ -90,6 +90,51 @@ module OpenAI
           #
           #   @param object [Symbol, :"eval.run.output_item"] The type of the object. Always "eval.run.output_item".
 
+          class Result < OpenAI::Internal::Type::BaseModel
+            # @!attribute name
+            #   The name of the grader.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute passed
+            #   Whether the grader considered the output a pass.
+            #
+            #   @return [Boolean]
+            required :passed, OpenAI::Internal::Type::Boolean
+
+            # @!attribute score
+            #   The numeric score produced by the grader.
+            #
+            #   @return [Float]
+            required :score, Float
+
+            # @!attribute sample
+            #   Optional sample or intermediate data produced by the grader.
+            #
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional :sample, OpenAI::Internal::Type::HashOf[OpenAI::Internal::Type::Unknown], nil?: true
+
+            # @!attribute type
+            #   The grader type (for example, "string-check-grader").
+            #
+            #   @return [String, nil]
+            optional :type, String
+
+            # @!method initialize(name:, passed:, score:, sample: nil, type: nil)
+            #   A single grader result for an evaluation run output item.
+            #
+            #   @param name [String] The name of the grader.
+            #
+            #   @param passed [Boolean] Whether the grader considered the output a pass.
+            #
+            #   @param score [Float] The numeric score produced by the grader.
+            #
+            #   @param sample [Hash{Symbol=>Object}, nil] Optional sample or intermediate data produced by the grader.
+            #
+            #   @param type [String] The grader type (for example, "string-check-grader").
+          end
+
           # @see OpenAI::Models::Evals::Runs::OutputItemRetrieveResponse#sample
           class Sample < OpenAI::Internal::Type::BaseModel
             # @!attribute error

data/lib/openai/models/graders/score_model_grader.rb

@@ -37,8 +37,8 @@ module OpenAI
         # @!attribute sampling_params
         #   The sampling parameters for the model.
         #
-        #   @return [Object, nil]
-        optional :sampling_params, OpenAI::Internal::Type::Unknown
+        #   @return [OpenAI::Models::Graders::ScoreModelGrader::SamplingParams, nil]
+        optional :sampling_params, -> { OpenAI::Graders::ScoreModelGrader::SamplingParams }
 
         # @!method initialize(input:, model:, name:, range: nil, sampling_params: nil, type: :score_model)
         #   A ScoreModelGrader object that uses a model to assign a score to the input.
@@ -51,7 +51,7 @@ module OpenAI
         #
         #   @param range [Array<Float>] The range of the score. Defaults to `[0, 1]`.
         #
-        #   @param sampling_params [Object] The sampling parameters for the model.
+        #   @param sampling_params [OpenAI::Models::Graders::ScoreModelGrader::SamplingParams] The sampling parameters for the model.
         #
         #   @param type [Symbol, :score_model] The object type, which is always `score_model`.
 
@@ -210,6 +210,59 @@ module OpenAI
             #   @return [Array<Symbol>]
           end
         end
+
+        # @see OpenAI::Models::Graders::ScoreModelGrader#sampling_params
+        class SamplingParams < OpenAI::Internal::Type::BaseModel
+          # @!attribute max_completions_tokens
+          #   The maximum number of tokens the grader model may generate in its response.
+          #
+          #   @return [Integer, nil]
+          optional :max_completions_tokens, Integer, nil?: true
+
+          # @!attribute reasoning_effort
+          #   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.
+          #
+          #   @return [Symbol, OpenAI::Models::ReasoningEffort, nil]
+          optional :reasoning_effort, enum: -> { OpenAI::ReasoningEffort }, nil?: true
+
+          # @!attribute seed
+          #   A seed value to initialize the randomness, during sampling.
+          #
+          #   @return [Integer, nil]
+          optional :seed, Integer, nil?: true
+
+          # @!attribute temperature
+          #   A higher temperature increases randomness in the outputs.
+          #
+          #   @return [Float, nil]
+          optional :temperature, Float, nil?: true
+
+          # @!attribute top_p
+          #   An alternative to temperature for nucleus sampling; 1.0 includes all tokens.
+          #
+          #   @return [Float, nil]
+          optional :top_p, Float, nil?: true
+
+          # @!method initialize(max_completions_tokens: nil, reasoning_effort: nil, seed: nil, temperature: nil, top_p: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {OpenAI::Models::Graders::ScoreModelGrader::SamplingParams} for more details.
+          #
+          #   The sampling parameters for the model.
+          #
+          #   @param max_completions_tokens [Integer, nil] The maximum number of tokens the grader model may generate in its response.
+          #
+          #   @param reasoning_effort [Symbol, OpenAI::Models::ReasoningEffort, nil] Constrains effort on reasoning for
+          #
+          #   @param seed [Integer, nil] A seed value to initialize the randomness, during sampling.
+          #
+          #   @param temperature [Float, nil] A higher temperature increases randomness in the outputs.
+          #
+          #   @param top_p [Float, nil] An alternative to temperature for nucleus sampling; 1.0 includes all tokens.
+        end
       end
     end
 

data/lib/openai/version.rb

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

data/lib/openai.rb

@@ -62,6 +62,11 @@ require_relative "openai/helpers/structured_output"
 require_relative "openai/structured_output"
 require_relative "openai/models/reasoning_effort"
 require_relative "openai/models/chat/chat_completion_message"
+require_relative "openai/models/responses/response_input_file"
+require_relative "openai/models/responses/response_input_image"
+require_relative "openai/models/responses/response_input_text"
+require_relative "openai/models/responses/response_output_text"
+require_relative "openai/models/responses/response_output_refusal"
 require_relative "openai/models/graders/score_model_grader"
 require_relative "openai/models/graders/python_grader"
 require_relative "openai/models/graders/text_similarity_grader"
@@ -248,7 +253,6 @@ require_relative "openai/models/containers/file_retrieve_params"
 require_relative "openai/models/containers/file_retrieve_response"
 require_relative "openai/models/containers/files/content_retrieve_params"
 require_relative "openai/models/conversations/computer_screenshot_content"
-require_relative "openai/models/conversations/container_file_citation_body"
 require_relative "openai/models/conversations/conversation"
 require_relative "openai/models/conversations/conversation_create_params"
 require_relative "openai/models/conversations/conversation_deleted"
@@ -258,7 +262,6 @@ require_relative "openai/models/conversations/conversation_item"
 require_relative "openai/models/conversations/conversation_item_list"
 require_relative "openai/models/conversations/conversation_retrieve_params"
 require_relative "openai/models/conversations/conversation_update_params"
-require_relative "openai/models/conversations/file_citation_body"
 require_relative "openai/models/conversations/input_file_content"
 require_relative "openai/models/conversations/input_image_content"
 require_relative "openai/models/conversations/input_text_content"
@@ -266,14 +269,11 @@ require_relative "openai/models/conversations/item_create_params"
 require_relative "openai/models/conversations/item_delete_params"
 require_relative "openai/models/conversations/item_list_params"
 require_relative "openai/models/conversations/item_retrieve_params"
-require_relative "openai/models/conversations/lob_prob"
 require_relative "openai/models/conversations/message"
 require_relative "openai/models/conversations/output_text_content"
 require_relative "openai/models/conversations/refusal_content"
 require_relative "openai/models/conversations/summary_text_content"
 require_relative "openai/models/conversations/text_content"
-require_relative "openai/models/conversations/top_log_prob"
-require_relative "openai/models/conversations/url_citation_body"
 require_relative "openai/models/create_embedding_response"
 require_relative "openai/models/custom_tool_input_format"
 require_relative "openai/models/embedding"
@@ -549,12 +549,9 @@ require_relative "openai/models/responses/response_in_progress_event"
 require_relative "openai/models/responses/response_input"
 require_relative "openai/models/responses/response_input_audio"
 require_relative "openai/models/responses/response_input_content"
-require_relative "openai/models/responses/response_input_file"
-require_relative "openai/models/responses/response_input_image"
 require_relative "openai/models/responses/response_input_item"
 require_relative "openai/models/responses/response_input_message_content_list"
 require_relative "openai/models/responses/response_input_message_item"
-require_relative "openai/models/responses/response_input_text"
 require_relative "openai/models/responses/response_item"
 require_relative "openai/models/responses/response_item_list"
 require_relative "openai/models/responses/response_mcp_call_arguments_delta_event"
@@ -570,8 +567,6 @@ require_relative "openai/models/responses/response_output_item"
 require_relative "openai/models/responses/response_output_item_added_event"
 require_relative "openai/models/responses/response_output_item_done_event"
 require_relative "openai/models/responses/response_output_message"
-require_relative "openai/models/responses/response_output_refusal"
-require_relative "openai/models/responses/response_output_text"
 require_relative "openai/models/responses/response_output_text_annotation_added_event"
 require_relative "openai/models/responses/response_prompt"
 require_relative "openai/models/responses/response_queued_event"

data/rbi/openai/errors.rbi

@@ -33,6 +33,9 @@ module OpenAI
       sig { returns(T.nilable(Integer)) }
       attr_accessor :status
 
+      sig { returns(T.nilable(T::Hash[String, String])) }
+      attr_accessor :headers
+
       sig { returns(T.nilable(T.anything)) }
       attr_accessor :body
 
@@ -50,6 +53,7 @@ module OpenAI
         params(
           url: URI::Generic,
           status: T.nilable(Integer),
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
@@ -59,6 +63,7 @@ module OpenAI
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -88,6 +93,7 @@ module OpenAI
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -97,6 +103,7 @@ module OpenAI
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -111,6 +118,7 @@ module OpenAI
         params(
           url: URI::Generic,
           status: NilClass,
+          headers: T.nilable(T::Hash[String, String]),
           body: NilClass,
           request: NilClass,
           response: NilClass,
@@ -120,6 +128,7 @@ module OpenAI
       def self.new(
         url:,
         status: nil,
+        headers: nil,
         body: nil,
         request: nil,
         response: nil,
@@ -134,13 +143,22 @@ module OpenAI
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.for(url:, status:, body:, request:, response:, message: nil)
+      def self.for(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
 
       sig { returns(Integer) }
@@ -160,13 +178,22 @@ module OpenAI
         params(
           url: URI::Generic,
           status: Integer,
+          headers: T.nilable(T::Hash[String, String]),
           body: T.nilable(Object),
           request: NilClass,
           response: NilClass,
           message: T.nilable(String)
         ).returns(T.attached_class)
       end
-      def self.new(url:, status:, body:, request:, response:, message: nil)
+      def self.new(
+        url:,
+        status:,
+        headers:,
+        body:,
+        request:,
+        response:,
+        message: nil
+      )
       end
     end
 

data/rbi/openai/internal/transport/base_client.rbi

@@ -92,10 +92,9 @@ module OpenAI
 
           # @api private
           sig do
-            params(
-              status: Integer,
-              headers: T.any(T::Hash[String, String], Net::HTTPHeader)
-            ).returns(T::Boolean)
+            params(status: Integer, headers: T::Hash[String, String]).returns(
+              T::Boolean
+            )
           end
           def should_retry?(status, headers:)
           end
@@ -105,7 +104,7 @@ module OpenAI
             params(
               request: OpenAI::Internal::Transport::BaseClient::RequestInput,
               status: Integer,
-              response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+              response_headers: T::Hash[String, String]
             ).returns(OpenAI::Internal::Transport::BaseClient::RequestInput)
           end
           def follow_redirect(request, status:, response_headers:)

data/rbi/openai/internal/type/base_page.rbi

@@ -30,7 +30,7 @@ module OpenAI
           params(
             client: OpenAI::Internal::Transport::BaseClient,
             req: OpenAI::Internal::Transport::BaseClient::RequestComponents,
-            headers: T.any(T::Hash[String, String], Net::HTTPHeader),
+            headers: T::Hash[String, String],
             page_data: T.anything
           ).void
         end