openai 0.85.0 → 0.86.0

data/lib/openai/internal/util.rb

@@ -185,7 +185,7 @@ module OpenAI
           in [Hash, Hash, _]
             lhs.merge(rhs) { deep_merge_lr(_2, _3, concat: concat) }
           in [Array, Array, true]
-            lhs.concat(rhs)
+            lhs + rhs
           else
             rhs
           end
@@ -449,6 +449,8 @@ module OpenAI
       JSON_CONTENT = %r{\Aapplication/(?:[a-z0-9.-]+\+)?json[ \t]*(?:;|\z)}i
       # @type [Regexp]
       JSONL_CONTENT = %r{\Aapplication/(?:x-[nl]djson|(?:x-)?jsonl)[ \t]*(?:;|\z)}i
+      # @type [Regexp]
+      MULTIPART_CONTENT = %r{\Amultipart/form-data[ \t]*(?:;|\z)}i
 
       class << self
         # @api private
@@ -555,7 +557,10 @@ module OpenAI
             filename = escape_multipart_header_param(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = escape_multipart_header_param(::File.basename(val.to_path))
+            # Keep raw multipart IO consistent with FileInput.dump: pathless streams
+            # are still file parts and use the same stable fallback filename.
+            filename = val.to_path.nil? ? "upload" : ::File.basename(val.to_path)
+            filename = escape_multipart_header_param(filename)
             y << "; filename=\"#{filename}\""
           else
           end
@@ -631,14 +636,17 @@ module OpenAI
             [headers, JSON.generate(body)]
           in [OpenAI::Internal::Util::JSONL_CONTENT, Enumerable] unless OpenAI::Internal::Type::FileInput === body
             [headers, body.lazy.map { "#{JSON.generate(_1)}\n" }]
-          in [%r{^multipart/form-data}, Hash | OpenAI::Internal::Type::FileInput]
+          in [OpenAI::Internal::Util::MULTIPART_CONTENT, Hash | OpenAI::Internal::Type::FileInput]
             boundary, strio = encode_multipart_streaming(body)
             headers = {**headers, "content-type" => "#{content_type}; boundary=#{boundary}"}
             [headers, strio]
           in [_, Symbol | Numeric]
             [headers, body.to_s]
           in [_, StringIO]
-            [headers, body.string]
+            [headers, body.string.byteslice(body.pos..) || body.string.byteslice(0, 0)]
+          in [_, OpenAI::FilePart] if body.content.is_a?(StringIO)
+            content = body.content
+            [headers, content.string.byteslice(content.pos..) || content.string.byteslice(0, 0)]
           in [_, OpenAI::FilePart]
             [headers, body.content]
           else
@@ -647,6 +655,94 @@ module OpenAI
           # rubocop:enable Style/CaseEquality
         end
 
+        # @api private
+        #
+        # Split a media type on its `;` delimiters, ignoring any that appear inside a
+        # quoted string so that a parameter value may contain one.
+        #
+        # @param content_type [String]
+        #
+        # @return [Array<String>]
+        private def split_media_type_segments(content_type)
+          segments = [String.new]
+          quoted = escaped = false
+
+          content_type.to_s.each_char do |char|
+            if escaped
+              segments.last << char
+              escaped = false
+            elsif quoted && char == "\\"
+              segments.last << char
+              escaped = true
+            elsif char == "\""
+              segments.last << char
+              quoted = !quoted
+            elsif char == ";" && !quoted
+              segments << String.new
+            else
+              segments.last << char
+            end
+          end
+
+          segments
+        end
+
+        # @api private
+        #
+        # Read a media type parameter value: either a token that ends at the first
+        # whitespace, or a quoted string in which `\` escapes the next character.
+        # A quoted string that is never closed, or has non-whitespace after its
+        # closing quote, has no value.
+        #
+        # @param value [String]
+        #
+        # @return [String, nil]
+        private def read_media_type_value(value)
+          return value[/\A[^;\s]+/] unless value.start_with?("\"")
+
+          unquoted = String.new
+          escaped = false
+
+          value[1..].to_s.each_char.with_index do |char, index|
+            if escaped
+              unquoted << char
+              escaped = false
+            elsif char == "\\"
+              escaped = true
+            elsif char == "\""
+              return unquoted if value[(index + 2)..].to_s.match?(/\A\s*\z/)
+
+              return nil
+            else
+              unquoted << char
+            end
+          end
+
+          nil
+        end
+
+        # @api private
+        #
+        # Find the value of the `charset` media type parameter. Parameter names are
+        # case-insensitive, so `Charset` and `CHARSET` name the same parameter, but the
+        # name has to match in full: a `charset` suffix of another parameter's name, or
+        # a `charset=` inside a quoted value, belongs to a different parameter.
+        #
+        # @param content_type [String]
+        #
+        # @return [String, nil]
+        private def media_type_charset(content_type)
+          split_media_type_segments(content_type).each do |segment|
+            name, separator, value = segment.partition("=")
+            next if separator.empty?
+            next unless name.strip.casecmp?("charset")
+
+            return read_media_type_value(value.lstrip)
+          end
+
+          nil
+        end
+
         # @api private
         #
         # https://www.iana.org/assignments/character-sets/character-sets.xhtml
@@ -654,9 +750,9 @@ module OpenAI
         # @param content_type [String]
         # @param text [String]
         def force_charset!(content_type, text:)
-          charset = /charset=([^;\s]+)/.match(content_type)&.captures&.first
+          charset = media_type_charset(content_type)
 
-          return unless charset
+          return if charset.nil? || charset.empty?
 
           begin
             encoding = Encoding.find(charset)
@@ -777,32 +873,37 @@ module OpenAI
       class << self
         # @api private
         #
-        # Assumes Strings have been forced into having `Encoding::BINARY`.
-        #
-        # This decoder is responsible for reassembling lines split across multiple
-        # fragments.
+        # This decoder is responsible for reassembling bytes split across multiple
+        # String fragments without depending on each fragment's encoding label
+        # while preserving the String encoding callers supplied.
         #
         # @param enum [Enumerable<String>]
         #
         # @return [Enumerable<String>]
         def decode_lines(enum)
           re = /(\r\n|\r|\n)/
-          buffer = String.new
+          buffer = String.new(encoding: Encoding::BINARY)
+          encoding = nil
           cr_seen = nil
 
           chain_fused(enum) do |y|
             enum.each do |row|
+              encoding = row.encoding if !row.empty? && (encoding.nil? || encoding == Encoding::US_ASCII)
               offset = buffer.bytesize
-              buffer << row
+              buffer << (row.encoding == Encoding::BINARY ? row : row.b)
               while (match = re.match(buffer, cr_seen&.to_i || offset))
                 case [match.captures.first, cr_seen]
                 in ["\r", nil]
                   cr_seen = match.end(1)
                   next
-                in ["\r" | "\r\n", Integer]
-                  y << buffer.slice!(..(cr_seen.pred))
+                in [terminator, Integer] if terminator != "\n" || match.begin(1) != cr_seen
+                  line = buffer.slice!(..(cr_seen.pred))
+                  line.force_encoding(encoding) unless encoding.nil?
+                  y << line
                 else
-                  y << buffer.slice!(..(match.end(1).pred))
+                  line = buffer.slice!(..(match.end(1).pred))
+                  line.force_encoding(encoding) unless encoding.nil?
+                  y << line
                 end
 
                 offset = 0
@@ -810,8 +911,16 @@ module OpenAI
               end
             end
 
-            y << buffer.slice!(..(cr_seen.pred)) unless cr_seen.nil?
-            y << buffer unless buffer.empty?
+            unless cr_seen.nil?
+              line = buffer.slice!(..(cr_seen.pred))
+              line.force_encoding(encoding) unless encoding.nil?
+              y << line
+            end
+
+            unless buffer.empty?
+              buffer.force_encoding(encoding) unless encoding.nil?
+              y << buffer
+            end
           end
         end
 
@@ -829,8 +938,14 @@ module OpenAI
           chain_fused(lines) do |y|
             blank = {event: nil, data: nil, id: nil, retry: nil}
             current = {}
+            first_line = true
 
             lines.each do |line|
+              if first_line
+                line = line.byteslice(3..) || "" if line.byteslice(0, 3)&.bytes == [0xEF, 0xBB, 0xBF]
+                first_line = false
+              end
+
               case line.sub(/\R$/, "")
               in ""
                 next if current.empty?
@@ -838,17 +953,21 @@ module OpenAI
                 current = {}
               in /^:/
                 next
-              in /^([^:]+):\s?(.*)$/
+              in /^([^:]+)(?::\s?(.*))?$/
                 field, value = Regexp.last_match.captures
+                # A line with no colon names a field whose value is the empty
+                # string, so a bare `data` line still contributes a blank line to
+                # the data buffer.
+                value = value.to_s
                 case field
                 in "event"
                   current.merge!(event: value)
                 in "data"
-                  (current[:data] ||= String.new) << (value << "\n")
+                  (current[:data] ||= String.new) << value << "\n"
                 in "id" unless value.include?("\0")
                   current.merge!(id: value)
                 in "retry" if /^\d+$/ =~ value
-                  current.merge!(retry: Integer(value))
+                  current.merge!(retry: Integer(value, 10))
                 else
                 end
               else

data/lib/openai/models/admin/organization/projects/service_accounts/api_key_create_params.rb

@@ -23,6 +23,12 @@ module OpenAI
               #   @return [String]
               required :service_account_id, String
 
+              # @!attribute expires_in_seconds
+              #   Number of seconds until the API key expires.
+              #
+              #   @return [Integer, nil]
+              optional :expires_in_seconds, Integer, nil?: true
+
               # @!attribute name
               #   API key name.
               #
@@ -35,11 +41,13 @@ module OpenAI
               #   @return [Array<String>, nil]
               optional :scopes, OpenAI::Internal::Type::ArrayOf[String]
 
-              # @!method initialize(project_id:, service_account_id:, name: nil, scopes: nil, request_options: {})
+              # @!method initialize(project_id:, service_account_id:, expires_in_seconds: nil, name: nil, scopes: nil, request_options: {})
               #   @param project_id [String] The ID of the project.
               #
               #   @param service_account_id [String] The ID of the service account.
               #
+              #   @param expires_in_seconds [Integer, nil] Number of seconds until the API key expires.
+              #
               #   @param name [String] API key name.
               #
               #   @param scopes [Array<String>] API key scopes.

data/lib/openai/models/admin/organization/projects/service_accounts/api_key_create_response.rb

@@ -38,7 +38,18 @@ module OpenAI
               #   @return [String]
               required :value, String
 
-              # @!method initialize(id:, created_at:, name:, value:, object: :"organization.project.service_account.api_key")
+              # @!attribute expires_at
+              #   The Unix timestamp (in seconds) when the API key expires, or null if it does not
+              #   expire.
+              #
+              #   @return [Integer, nil]
+              optional :expires_at, Integer, nil?: true
+
+              # @!method initialize(id:, created_at:, name:, value:, expires_at: nil, object: :"organization.project.service_account.api_key")
+              #   Some parameter documentations has been truncated, see
+              #   {OpenAI::Models::Admin::Organization::Projects::ServiceAccounts::APIKeyCreateResponse}
+              #   for more details.
+              #
               #   @param id [String] The identifier of the API key.
               #
               #   @param created_at [Integer] The Unix timestamp (in seconds) when the API key was created.
@@ -47,6 +58,8 @@ module OpenAI
               #
               #   @param value [String] The unredacted API key value.
               #
+              #   @param expires_at [Integer, nil] The Unix timestamp (in seconds) when the API key expires, or null if it does not
+              #
               #   @param object [Symbol, :"organization.project.service_account.api_key"] The object type, which is always `organization.project.service_account.api_key`
             end
           end

data/lib/openai/models/audio/transcription_create_response.rb

@@ -12,17 +12,17 @@ module OpenAI
       module TranscriptionCreateResponse
         extend OpenAI::Internal::Type::Union
 
-        # Represents a transcription response returned by model, based on the provided input.
-        variant -> { OpenAI::Audio::Transcription }
+        # Represents a verbose json transcription response returned by model, based on the provided input.
+        variant -> { OpenAI::Audio::TranscriptionVerbose }
 
         # Represents a diarized transcription response returned by the model, including the combined transcript and speaker-segment annotations.
         variant -> { OpenAI::Audio::TranscriptionDiarized }
 
-        # Represents a verbose json transcription response returned by model, based on the provided input.
-        variant -> { OpenAI::Audio::TranscriptionVerbose }
+        # Represents a transcription response returned by model, based on the provided input.
+        variant -> { OpenAI::Audio::Transcription }
 
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Audio::Transcription, OpenAI::Models::Audio::TranscriptionDiarized, OpenAI::Models::Audio::TranscriptionVerbose)]
+        #   @return [Array(OpenAI::Models::Audio::TranscriptionVerbose, OpenAI::Models::Audio::TranscriptionDiarized, OpenAI::Models::Audio::Transcription)]
       end
     end
   end

data/lib/openai/models/beta/beta_response.rb

@@ -198,6 +198,12 @@ module OpenAI
         #   @return [OpenAI::Models::Beta::BetaResponsePrompt, nil]
         optional :prompt, -> { OpenAI::Beta::BetaResponsePrompt }, nil?: true
 
+        # @!attribute prompt_cache_diagnostics
+        #   Prompt cache diagnostics requested for this response.
+        #
+        #   @return [OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::CacheHit, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::ComparisonResponseNotFound, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::Unavailable, nil]
+        optional :prompt_cache_diagnostics, union: -> { OpenAI::Beta::BetaResponse::PromptCacheDiagnostics }
+
         # @!attribute prompt_cache_key
         #   Used by OpenAI to cache responses for similar requests to optimize your cache
         #   hit rates. Replaces the `user` field.
@@ -344,7 +350,7 @@ module OpenAI
         #   @return [String, nil]
         optional :user, String
 
-        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, completed_at: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, moderation: nil, previous_response_id: nil, prompt: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
+        # @!method initialize(id:, created_at:, error:, incomplete_details:, instructions:, metadata:, model:, output:, parallel_tool_calls:, temperature:, tool_choice:, tools:, top_p:, background: nil, completed_at: nil, conversation: nil, max_output_tokens: nil, max_tool_calls: nil, moderation: nil, previous_response_id: nil, prompt: nil, prompt_cache_diagnostics: nil, prompt_cache_key: nil, prompt_cache_options: nil, prompt_cache_retention: nil, reasoning: nil, safety_identifier: nil, service_tier: nil, status: nil, text: nil, top_logprobs: nil, truncation: nil, usage: nil, user: nil, object: :response)
         #   Some parameter documentations has been truncated, see
         #   {OpenAI::Models::Beta::BetaResponse} for more details.
         #
@@ -390,6 +396,8 @@ module OpenAI
         #
         #   @param prompt [OpenAI::Models::Beta::BetaResponsePrompt, nil] Reference to a prompt template and its variables.
         #
+        #   @param prompt_cache_diagnostics [OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::CacheHit, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::ComparisonResponseNotFound, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::Unavailable] Prompt cache diagnostics requested for this response.
+        #
         #   @param prompt_cache_key [String, nil] Used by OpenAI to cache responses for similar requests to optimize your cache hi
         #
         #   @param prompt_cache_options [OpenAI::Models::Beta::BetaResponse::PromptCacheOptions] The prompt-caching options that were applied to the response. Supported for `gpt
@@ -1158,6 +1166,118 @@ module OpenAI
           end
         end
 
+        # Prompt cache diagnostics requested for this response.
+        #
+        # @see OpenAI::Models::Beta::BetaResponse#prompt_cache_diagnostics
+        module PromptCacheDiagnostics
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          variant :cache_miss, -> { OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss }
+
+          variant :cache_hit, -> { OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheHit }
+
+          variant(
+            :comparison_response_not_found,
+            -> { OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::ComparisonResponseNotFound }
+          )
+
+          variant :unavailable, -> { OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::Unavailable }
+
+          class CacheMiss < OpenAI::Internal::Type::BaseModel
+            # @!attribute cache_missed_tokens
+            #   The estimated number of input tokens affected after the first detected
+            #   divergence.
+            #
+            #   @return [Integer]
+            required :cache_missed_tokens, Integer
+
+            # @!attribute reason
+            #   The reason prompt cache reuse did not occur.
+            #
+            #   @return [Symbol, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason]
+            required :reason, enum: -> { OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason }
+
+            # @!attribute type
+            #
+            #   @return [Symbol, :cache_miss]
+            required :type, const: :cache_miss
+
+            # @!attribute comparison_reusable_tokens
+            #   The raw token count of the reusable prefix in the compared response.
+            #
+            #   @return [Integer, nil]
+            optional :comparison_reusable_tokens, Integer
+
+            # @!method initialize(cache_missed_tokens:, reason:, comparison_reusable_tokens: nil, type: :cache_miss)
+            #   Some parameter documentations has been truncated, see
+            #   {OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss} for more
+            #   details.
+            #
+            #   @param cache_missed_tokens [Integer] The estimated number of input tokens affected after the first detected divergenc
+            #
+            #   @param reason [Symbol, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason] The reason prompt cache reuse did not occur.
+            #
+            #   @param comparison_reusable_tokens [Integer] The raw token count of the reusable prefix in the compared response.
+            #
+            #   @param type [Symbol, :cache_miss]
+
+            # The reason prompt cache reuse did not occur.
+            #
+            # @see OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss#reason
+            module Reason
+              extend OpenAI::Internal::Type::Enum
+
+              MODEL_CHANGED = :model_changed
+              PROMPT_CACHE_KEY_CHANGED = :prompt_cache_key_changed
+              TOOLS_CHANGED = :tools_changed
+              TEXT_FORMAT_CHANGED = :text_format_changed
+              REASONING_EFFORT_CHANGED = :reasoning_effort_changed
+              VERBOSITY_CHANGED = :verbosity_changed
+              CONTEXT_COMPACTED = :context_compacted
+              INPUT_CHANGED = :input_changed
+              SERVICE_TIER_CHANGED = :service_tier_changed
+
+              # @!method self.values
+              #   @return [Array<Symbol>]
+            end
+          end
+
+          class CacheHit < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :cache_hit]
+            required :type, const: :cache_hit
+
+            # @!method initialize(type: :cache_hit)
+            #   @param type [Symbol, :cache_hit]
+          end
+
+          class ComparisonResponseNotFound < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :comparison_response_not_found]
+            required :type, const: :comparison_response_not_found
+
+            # @!method initialize(type: :comparison_response_not_found)
+            #   @param type [Symbol, :comparison_response_not_found]
+          end
+
+          class Unavailable < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :unavailable]
+            required :type, const: :unavailable
+
+            # @!method initialize(type: :unavailable)
+            #   @param type [Symbol, :unavailable]
+          end
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::CacheHit, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::ComparisonResponseNotFound, OpenAI::Models::Beta::BetaResponse::PromptCacheDiagnostics::Unavailable)]
+        end
+
         # @see OpenAI::Models::Beta::BetaResponse#prompt_cache_options
         class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
           # @!attribute mode
@@ -1172,13 +1292,21 @@ module OpenAI
           #   @return [Symbol, OpenAI::Models::Beta::BetaResponse::PromptCacheOptions::Ttl]
           required :ttl, enum: -> { OpenAI::Beta::BetaResponse::PromptCacheOptions::Ttl }
 
-          # @!method initialize(mode:, ttl:)
+          # @!attribute comparison_response_id
+          #   The response ID supplied as the prompt cache diagnostics comparison.
+          #
+          #   @return [String, nil]
+          optional :comparison_response_id, String, nil?: true
+
+          # @!method initialize(mode:, ttl:, comparison_response_id: nil)
           #   The prompt-caching options that were applied to the response. Supported for
           #   `gpt-5.6` and later models.
           #
           #   @param mode [Symbol, OpenAI::Models::Beta::BetaResponse::PromptCacheOptions::Mode] Whether implicit prompt-cache breakpoints were enabled.
           #
           #   @param ttl [Symbol, OpenAI::Models::Beta::BetaResponse::PromptCacheOptions::Ttl] The minimum lifetime applied to each cache breakpoint.
+          #
+          #   @param comparison_response_id [String, nil] The response ID supplied as the prompt cache diagnostics comparison.
 
           # Whether implicit prompt-cache breakpoints were enabled.
           #

data/lib/openai/models/beta/beta_response_function_call_arguments_done_event.rb

@@ -16,12 +16,6 @@ module OpenAI
         #   @return [String]
         required :item_id, String
 
-        # @!attribute name
-        #   The name of the function that was called.
-        #
-        #   @return [String]
-        required :name, String
-
         # @!attribute output_index
         #   The index of the output item.
         #
@@ -45,15 +39,13 @@ module OpenAI
         #   @return [OpenAI::Models::Beta::BetaResponseFunctionCallArgumentsDoneEvent::Agent, nil]
         optional :agent, -> { OpenAI::Beta::BetaResponseFunctionCallArgumentsDoneEvent::Agent }, nil?: true
 
-        # @!method initialize(arguments:, item_id:, name:, output_index:, sequence_number:, agent: nil, type: :"response.function_call_arguments.done")
+        # @!method initialize(arguments:, item_id:, output_index:, sequence_number:, agent: nil, type: :"response.function_call_arguments.done")
         #   Emitted when function-call arguments are finalized.
         #
         #   @param arguments [String] The function-call arguments.
         #
         #   @param item_id [String] The ID of the item.
         #
-        #   @param name [String] The name of the function that was called.
-        #
         #   @param output_index [Integer] The index of the output item.
         #
         #   @param sequence_number [Integer] The sequence number of this event.

data/lib/openai/models/beta/beta_response_function_web_search.rb

@@ -216,6 +216,7 @@ module OpenAI
           SEARCHING = :searching
           COMPLETED = :completed
           FAILED = :failed
+          INCOMPLETE = :incomplete
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/openai/models/beta/beta_responses_client_event.rb

@@ -1279,6 +1279,13 @@ module OpenAI
 
           # @see OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate#prompt_cache_options
           class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+            # @!attribute comparison_response_id
+            #   The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+            #   this field requests prompt cache diagnostics when the feature is enabled.
+            #
+            #   @return [String, nil]
+            optional :comparison_response_id, String, nil?: true
+
             # @!attribute mode
             #   Controls whether OpenAI automatically creates an implicit cache breakpoint.
             #   Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
@@ -1304,7 +1311,7 @@ module OpenAI
               enum: -> { OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl }
             )
 
-            # @!method initialize(mode: nil, ttl: nil)
+            # @!method initialize(comparison_response_id: nil, mode: nil, ttl: nil)
             #   Some parameter documentations has been truncated, see
             #   {OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions}
             #   for more details.
@@ -1319,6 +1326,8 @@ module OpenAI
             #   [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
             #   for current details.
             #
+            #   @param comparison_response_id [String, nil] The ID of a response to compare when diagnosing prompt cache reuse. Supplying th
+            #
             #   @param mode [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode] Controls whether OpenAI automatically creates an implicit cache breakpoint. Defa
             #
             #   @param ttl [Symbol, OpenAI::Models::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl] The minimum lifetime applied to every implicit and explicit cache breakpoint wri

data/lib/openai/models/beta/beta_responses_server_event.rb

@@ -862,7 +862,7 @@ module OpenAI
           #   @return [String, nil]
           optional :stream_id, String
 
-          # @!method initialize(arguments:, item_id:, name:, output_index:, sequence_number:, agent: nil, stream_id: nil, type: :"response.function_call_arguments.done")
+          # @!method initialize(arguments:, item_id:, output_index:, sequence_number:, agent: nil, stream_id: nil, type: :"response.function_call_arguments.done")
           #   Some parameter documentations has been truncated, see
           #   {OpenAI::Models::Beta::BetaResponsesServerEvent::BetaResponseFunctionCallArgumentsWsDone}
           #   for more details.
@@ -873,8 +873,6 @@ module OpenAI
           #
           #   @param item_id [String] The ID of the item.
           #
-          #   @param name [String] The name of the function that was called.
-          #
           #   @param output_index [Integer] The index of the output item.
           #
           #   @param sequence_number [Integer] The sequence number of this event.

data/lib/openai/models/beta/response_compact_params.rb

@@ -90,12 +90,13 @@ module OpenAI
         #   request will be processed with the Flex Processing service tier. - To opt-in to
         #   [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
         #   `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-        #   Completions. The response will show `service_tier=priority` regardless of if you
-        #   specify `service_tier=fast` or `priority` in your request. - When not set, the
-        #   default behavior is 'auto'. When the `service_tier` parameter is set, the
-        #   response body will include the `service_tier` value based on the processing mode
-        #   actually used to serve the request. This response value may be different from
-        #   the value set in the parameter.
+        #   Completions. For models with a dedicated Fast tier, either value resolves to
+        #   `service_tier=fast`; for other models, either value resolves to
+        #   `service_tier=priority`. - When not set, the default behavior is 'auto'. When
+        #   the `service_tier` parameter is set, the response body will include the
+        #   `service_tier` value based on the processing mode actually used to serve the
+        #   request. This response value may be different from the value set in the
+        #   parameter.
         #
         #   @return [Symbol, OpenAI::Models::Beta::ResponseCompactParams::ServiceTier, nil]
         optional :service_tier, enum: -> { OpenAI::Beta::ResponseCompactParams::ServiceTier }, nil?: true
@@ -578,12 +579,13 @@ module OpenAI
         # request will be processed with the Flex Processing service tier. - To opt-in to
         # [Fast mode](/api/docs/guides/fast-mode) at the request level, include the
         # `service_tier=fast` or `service_tier=priority` parameter for Responses or Chat
-        # Completions. The response will show `service_tier=priority` regardless of if you
-        # specify `service_tier=fast` or `priority` in your request. - When not set, the
-        # default behavior is 'auto'. When the `service_tier` parameter is set, the
-        # response body will include the `service_tier` value based on the processing mode
-        # actually used to serve the request. This response value may be different from
-        # the value set in the parameter.
+        # Completions. For models with a dedicated Fast tier, either value resolves to
+        # `service_tier=fast`; for other models, either value resolves to
+        # `service_tier=priority`. - When not set, the default behavior is 'auto'. When
+        # the `service_tier` parameter is set, the response body will include the
+        # `service_tier` value based on the processing mode actually used to serve the
+        # request. This response value may be different from the value set in the
+        # parameter.
         module ServiceTier
           extend OpenAI::Internal::Type::Enum