openai 0.85.0 → 0.86.0

data/rbi/openai/models/beta/beta_response.rbi

@@ -178,6 +178,23 @@ module OpenAI
         sig { params(prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt::OrHash)).void }
         attr_writer :prompt
 
+        # Prompt cache diagnostics requested for this response.
+        sig { returns(T.nilable(OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::Variants)) }
+        attr_reader :prompt_cache_diagnostics
+
+        sig {
+          params(
+            prompt_cache_diagnostics: T.any(
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::OrHash,
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheHit::OrHash,
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::ComparisonResponseNotFound::OrHash,
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::Unavailable::OrHash
+            )
+          )
+            .void
+        }
+        attr_writer :prompt_cache_diagnostics
+
         # Used by OpenAI to cache responses for similar requests to optimize your cache
         # hit rates. Replaces the `user` field.
         # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
@@ -418,6 +435,13 @@ module OpenAI
 
             prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt::OrHash),
 
+            prompt_cache_diagnostics: T.any(
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::OrHash,
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheHit::OrHash,
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::ComparisonResponseNotFound::OrHash,
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::Unavailable::OrHash
+            ),
+
             prompt_cache_key: T.nilable(String),
 
             prompt_cache_options: OpenAI::Beta::BetaResponse::PromptCacheOptions::OrHash,
@@ -570,6 +594,9 @@ module OpenAI
           # [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
           prompt: nil,
 
+          # Prompt cache diagnostics requested for this response.
+          prompt_cache_diagnostics: nil,
+
           # Used by OpenAI to cache responses for similar requests to optimize your cache
           # hit rates. Replaces the `user` field.
           # [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
@@ -703,6 +730,7 @@ module OpenAI
               moderation: T.nilable(OpenAI::Beta::BetaResponse::Moderation),
               previous_response_id: T.nilable(String),
               prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt),
+              prompt_cache_diagnostics: OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::Variants,
               prompt_cache_key: T.nilable(String),
               prompt_cache_options: OpenAI::Beta::BetaResponse::PromptCacheOptions,
               prompt_cache_retention: T.nilable(OpenAI::Beta::BetaResponse::PromptCacheRetention::TaggedSymbol),
@@ -1557,6 +1585,252 @@ module OpenAI
           end
         end
 
+        # Prompt cache diagnostics requested for this response.
+        module PromptCacheDiagnostics
+          extend OpenAI::Internal::Type::Union
+
+          Variants = T.type_alias {
+            T.any(
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss,
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheHit,
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::ComparisonResponseNotFound,
+              OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::Unavailable
+            )
+          }
+
+          class CacheMiss < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            # The estimated number of input tokens affected after the first detected
+            # divergence.
+            sig { returns(Integer) }
+            attr_accessor :cache_missed_tokens
+
+            # The reason prompt cache reuse did not occur.
+            sig { returns(OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol) }
+            attr_accessor :reason
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # The raw token count of the reusable prefix in the compared response.
+            sig { returns(T.nilable(Integer)) }
+            attr_reader :comparison_reusable_tokens
+
+            sig { params(comparison_reusable_tokens: Integer).void }
+            attr_writer :comparison_reusable_tokens
+
+            sig do
+              params(
+
+                cache_missed_tokens: Integer,
+
+                reason: OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::OrSymbol,
+
+                comparison_reusable_tokens: Integer,
+
+                type: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              # The estimated number of input tokens affected after the first detected
+              # divergence.
+              cache_missed_tokens:,
+
+              # The reason prompt cache reuse did not occur.
+              reason:,
+
+              # The raw token count of the reusable prefix in the compared response.
+              comparison_reusable_tokens: nil,
+
+              type: :cache_miss
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  cache_missed_tokens: Integer,
+                  reason: OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol,
+                  type: Symbol,
+                  comparison_reusable_tokens: Integer
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # The reason prompt cache reuse did not occur.
+            module Reason
+              extend OpenAI::Internal::Type::Enum
+
+              TaggedSymbol = T.type_alias {
+                T.all(Symbol, OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason)
+              }
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              MODEL_CHANGED = T.let(
+                :model_changed,
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol
+              )
+              PROMPT_CACHE_KEY_CHANGED = T.let(
+                :prompt_cache_key_changed,
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol
+              )
+              TOOLS_CHANGED = T.let(
+                :tools_changed,
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol
+              )
+              TEXT_FORMAT_CHANGED = T.let(
+                :text_format_changed,
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol
+              )
+              REASONING_EFFORT_CHANGED = T.let(
+                :reasoning_effort_changed,
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol
+              )
+              VERBOSITY_CHANGED = T.let(
+                :verbosity_changed,
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol
+              )
+              CONTEXT_COMPACTED = T.let(
+                :context_compacted,
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol
+              )
+              INPUT_CHANGED = T.let(
+                :input_changed,
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol
+              )
+              SERVICE_TIER_CHANGED = T.let(
+                :service_tier_changed,
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol
+              )
+
+              sig {
+                override.returns(
+                  T::Array[OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheMiss::Reason::TaggedSymbol]
+                )
+              }
+              def self.values
+              end
+            end
+          end
+
+          class CacheHit < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::CacheHit,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            sig do
+              params(
+
+                type: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              type: :cache_hit
+            )
+            end
+
+            sig do
+              override.returns(
+                {type: Symbol}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
+          class ComparisonResponseNotFound < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::ComparisonResponseNotFound,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            sig do
+              params(
+
+                type: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              type: :comparison_response_not_found
+            )
+            end
+
+            sig do
+              override.returns(
+                {type: Symbol}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
+          class Unavailable < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::Unavailable,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            sig do
+              params(
+
+                type: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              type: :unavailable
+            )
+            end
+
+            sig do
+              override.returns(
+                {type: Symbol}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
+          sig { override.returns(T::Array[OpenAI::Beta::BetaResponse::PromptCacheDiagnostics::Variants]) }
+          def self.variants
+          end
+
+        end
+
         class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
           OrHash = T.type_alias do
             T.any(
@@ -1573,6 +1847,10 @@ module OpenAI
           sig { returns(OpenAI::Beta::BetaResponse::PromptCacheOptions::Ttl::TaggedSymbol) }
           attr_accessor :ttl
 
+          # The response ID supplied as the prompt cache diagnostics comparison.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :comparison_response_id
+
           # The prompt-caching options that were applied to the response. Supported for
           # `gpt-5.6` and later models.
           sig do
@@ -1580,7 +1858,9 @@ module OpenAI
 
               mode: OpenAI::Beta::BetaResponse::PromptCacheOptions::Mode::OrSymbol,
 
-              ttl: OpenAI::Beta::BetaResponse::PromptCacheOptions::Ttl::OrSymbol
+              ttl: OpenAI::Beta::BetaResponse::PromptCacheOptions::Ttl::OrSymbol,
+
+              comparison_response_id: T.nilable(String)
             )
               .returns(T.attached_class)
           end
@@ -1590,8 +1870,11 @@ module OpenAI
             mode:,
 
             # The minimum lifetime applied to each cache breakpoint.
+            ttl:,
+
+            # The response ID supplied as the prompt cache diagnostics comparison.
 
-            ttl:
+            comparison_response_id: nil
           )
           end
 
@@ -1599,7 +1882,8 @@ module OpenAI
             override.returns(
               {
                 mode: OpenAI::Beta::BetaResponse::PromptCacheOptions::Mode::TaggedSymbol,
-                ttl: OpenAI::Beta::BetaResponse::PromptCacheOptions::Ttl::TaggedSymbol
+                ttl: OpenAI::Beta::BetaResponse::PromptCacheOptions::Ttl::TaggedSymbol,
+                comparison_response_id: T.nilable(String)
               }
             )
           end

data/rbi/openai/models/beta/beta_response_function_call_arguments_done_event.rbi

@@ -24,10 +24,6 @@ module OpenAI
         sig { returns(String) }
         attr_accessor :item_id
 
-        # The name of the function that was called.
-        sig { returns(String) }
-        attr_accessor :name
-
         # The index of the output item.
         sig { returns(Integer) }
         attr_accessor :output_index
@@ -54,8 +50,6 @@ module OpenAI
 
             item_id: String,
 
-            name: String,
-
             output_index: Integer,
 
             sequence_number: Integer,
@@ -74,9 +68,6 @@ module OpenAI
           # The ID of the item.
           item_id:,
 
-          # The name of the function that was called.
-          name:,
-
           # The index of the output item.
           output_index:,
 
@@ -95,7 +86,6 @@ module OpenAI
             {
               arguments: String,
               item_id: String,
-              name: String,
               output_index: Integer,
               sequence_number: Integer,
               type: Symbol,

data/rbi/openai/models/beta/beta_response_function_web_search.rbi

@@ -370,6 +370,7 @@ module OpenAI
           SEARCHING = T.let(:searching, OpenAI::Beta::BetaResponseFunctionWebSearch::Status::TaggedSymbol)
           COMPLETED = T.let(:completed, OpenAI::Beta::BetaResponseFunctionWebSearch::Status::TaggedSymbol)
           FAILED = T.let(:failed, OpenAI::Beta::BetaResponseFunctionWebSearch::Status::TaggedSymbol)
+          INCOMPLETE = T.let(:incomplete, OpenAI::Beta::BetaResponseFunctionWebSearch::Status::TaggedSymbol)
 
           sig { override.returns(T::Array[OpenAI::Beta::BetaResponseFunctionWebSearch::Status::TaggedSymbol]) }
           def self.values

data/rbi/openai/models/beta/beta_response_inject_created_event.rbi

@@ -71,7 +71,7 @@ module OpenAI
 
         sig do
           override.returns(
-            {response_id: String, sequence_number: Integer, type: Symbol, stream_id: String}
+            {response_id: String, sequence_number: Integer, type: Symbol, stream_id: T.nilable(String)}
           )
         end
         def to_hash

data/rbi/openai/models/beta/beta_response_inject_failed_event.rbi

@@ -220,7 +220,7 @@ module OpenAI
               response_id: String,
               sequence_number: Integer,
               type: Symbol,
-              stream_id: String
+              stream_id: T.nilable(String)
             }
           )
         end

data/rbi/openai/models/beta/beta_response_steer_accepted_event.rbi

@@ -86,7 +86,7 @@ module OpenAI
               sequence_number: Integer,
               steer: OpenAI::Beta::BetaResponseSteerAcceptedEvent::Steer,
               type: Symbol,
-              stream_id: String
+              stream_id: T.nilable(String)
             }
           )
         end

data/rbi/openai/models/beta/beta_response_steer_failed_event.rbi

@@ -97,7 +97,7 @@ module OpenAI
               sequence_number: Integer,
               steer: OpenAI::Beta::BetaResponseSteerFailedEvent::Steer,
               type: Symbol,
-              stream_id: String
+              stream_id: T.nilable(String)
             }
           )
         end
@@ -251,7 +251,11 @@ module OpenAI
 
           sig do
             override.returns(
-              {input: OpenAI::Beta::BetaResponseSteerInput::Variants, previous_response_id: String, id: String}
+              {
+                input: OpenAI::Beta::BetaResponseSteerInput::Variants,
+                previous_response_id: String,
+                id: T.nilable(String)
+              }
             )
           end
           def to_hash

data/rbi/openai/models/beta/beta_response_steer_pending_event.rbi

@@ -160,7 +160,7 @@ module OpenAI
               sequence_number: Integer,
               steer: OpenAI::Beta::BetaResponseSteerPendingEvent::Steer,
               type: Symbol,
-              stream_id: String
+              stream_id: T.nilable(String)
             }
           )
         end

data/rbi/openai/models/beta/beta_responses_client_event.rbi

@@ -856,19 +856,21 @@ module OpenAI
                 ),
                 conversation: T.nilable(T.any(String, OpenAI::Beta::BetaResponseConversationParam)),
                 include: T.nilable(T::Array[OpenAI::Beta::BetaResponseIncludable::OrSymbol]),
-                input: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Input::Variants,
+                input: T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Input::Variants),
                 instructions: T.nilable(String),
                 max_output_tokens: T.nilable(Integer),
                 max_tool_calls: T.nilable(Integer),
                 metadata: T.nilable(T::Hash[Symbol, String]),
-                model: T.any(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Model::OrSymbol, String),
+                model: T.nilable(T.any(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Model::OrSymbol, String)),
                 moderation: T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Moderation),
                 multi_agent: T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::MultiAgent),
                 parallel_tool_calls: T.nilable(T::Boolean),
                 previous_response_id: T.nilable(String),
                 prompt: T.nilable(OpenAI::Beta::BetaResponsePrompt),
                 prompt_cache_key: T.nilable(String),
-                prompt_cache_options: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions,
+                prompt_cache_options: T.nilable(
+                  OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions
+                ),
                 prompt_cache_retention: T.nilable(
                   OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheRetention::OrSymbol
                 ),
@@ -877,45 +879,49 @@ module OpenAI
                 service_tier: T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ServiceTier::OrSymbol),
                 store: T.nilable(T::Boolean),
                 stream: T.nilable(T::Boolean),
-                stream_id: String,
+                stream_id: T.nilable(String),
                 stream_options: T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::StreamOptions),
                 temperature: T.nilable(Float),
-                text: OpenAI::Beta::BetaResponseTextConfig,
-                tool_choice: T.any(
-                  OpenAI::Beta::BetaToolChoiceOptions::OrSymbol,
-                  OpenAI::Beta::BetaToolChoiceAllowed,
-                  OpenAI::Beta::BetaToolChoiceTypes,
-                  OpenAI::Beta::BetaToolChoiceFunction,
-                  OpenAI::Beta::BetaToolChoiceMcp,
-                  OpenAI::Beta::BetaToolChoiceCustom,
-                  OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ToolChoice::BetaSpecificProgrammaticToolCallingParam,
-                  OpenAI::Beta::BetaToolChoiceApplyPatch,
-                  OpenAI::Beta::BetaToolChoiceShell
-                ),
-                tools: T::Array[
+                text: T.nilable(OpenAI::Beta::BetaResponseTextConfig),
+                tool_choice: T.nilable(
                   T.any(
-                    OpenAI::Beta::BetaFunctionTool,
-                    OpenAI::Beta::BetaFileSearchTool,
-                    OpenAI::Beta::BetaComputerTool,
-                    OpenAI::Beta::BetaComputerUsePreviewTool,
-                    OpenAI::Beta::BetaTool::Mcp,
-                    OpenAI::Beta::BetaTool::CodeInterpreter,
-                    OpenAI::Beta::BetaTool::ProgrammaticToolCalling,
-                    OpenAI::Beta::BetaTool::ImageGeneration,
-                    OpenAI::Beta::BetaTool::LocalShell,
-                    OpenAI::Beta::BetaFunctionShellTool,
-                    OpenAI::Beta::BetaCustomTool,
-                    OpenAI::Beta::BetaNamespaceTool,
-                    OpenAI::Beta::BetaToolSearchTool,
-                    OpenAI::Beta::BetaApplyPatchTool,
-                    OpenAI::Beta::BetaWebSearchTool,
-                    OpenAI::Beta::BetaWebSearchPreviewTool
+                    OpenAI::Beta::BetaToolChoiceOptions::OrSymbol,
+                    OpenAI::Beta::BetaToolChoiceAllowed,
+                    OpenAI::Beta::BetaToolChoiceTypes,
+                    OpenAI::Beta::BetaToolChoiceFunction,
+                    OpenAI::Beta::BetaToolChoiceMcp,
+                    OpenAI::Beta::BetaToolChoiceCustom,
+                    OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::ToolChoice::BetaSpecificProgrammaticToolCallingParam,
+                    OpenAI::Beta::BetaToolChoiceApplyPatch,
+                    OpenAI::Beta::BetaToolChoiceShell
                   )
-                ],
+                ),
+                tools: T.nilable(
+                  T::Array[
+                    T.any(
+                      OpenAI::Beta::BetaFunctionTool,
+                      OpenAI::Beta::BetaFileSearchTool,
+                      OpenAI::Beta::BetaComputerTool,
+                      OpenAI::Beta::BetaComputerUsePreviewTool,
+                      OpenAI::Beta::BetaTool::Mcp,
+                      OpenAI::Beta::BetaTool::CodeInterpreter,
+                      OpenAI::Beta::BetaTool::ProgrammaticToolCalling,
+                      OpenAI::Beta::BetaTool::ImageGeneration,
+                      OpenAI::Beta::BetaTool::LocalShell,
+                      OpenAI::Beta::BetaFunctionShellTool,
+                      OpenAI::Beta::BetaCustomTool,
+                      OpenAI::Beta::BetaNamespaceTool,
+                      OpenAI::Beta::BetaToolSearchTool,
+                      OpenAI::Beta::BetaApplyPatchTool,
+                      OpenAI::Beta::BetaWebSearchTool,
+                      OpenAI::Beta::BetaWebSearchPreviewTool
+                    )
+                  ]
+                ),
                 top_logprobs: T.nilable(Integer),
                 top_p: T.nilable(Float),
                 truncation: T.nilable(OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Truncation::OrSymbol),
-                user: String
+                user: T.nilable(String)
               }
             )
           end
@@ -1723,7 +1729,7 @@ module OpenAI
 
             sig do
               override.returns(
-                {enabled: T::Boolean, max_concurrent_subagents: Integer}
+                {enabled: T::Boolean, max_concurrent_subagents: T.nilable(Integer)}
               )
             end
             def to_hash
@@ -1739,6 +1745,11 @@ module OpenAI
               )
             end
 
+            # The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+            # this field requests prompt cache diagnostics when the feature is enabled.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :comparison_response_id
+
             # Controls whether OpenAI automatically creates an implicit cache breakpoint.
             # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
             # and writes up to the latest three explicit breakpoints in the request. With
@@ -1786,6 +1797,8 @@ module OpenAI
             sig do
               params(
 
+                comparison_response_id: T.nilable(String),
+
                 mode: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode::OrSymbol,
 
                 ttl: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl::OrSymbol
@@ -1794,6 +1807,10 @@ module OpenAI
             end
             def self.new(
 
+              # The ID of a response to compare when diagnosing prompt cache reuse. Supplying
+              # this field requests prompt cache diagnostics when the feature is enabled.
+              comparison_response_id: nil,
+
               # Controls whether OpenAI automatically creates an implicit cache breakpoint.
               # Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
               # and writes up to the latest three explicit breakpoints in the request. With
@@ -1813,8 +1830,13 @@ module OpenAI
             sig do
               override.returns(
                 {
-                  mode: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode::OrSymbol,
-                  ttl: OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl::OrSymbol
+                  comparison_response_id: T.nilable(String),
+                  mode: T.nilable(
+                    OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Mode::OrSymbol
+                  ),
+                  ttl: T.nilable(
+                    OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::PromptCacheOptions::Ttl::OrSymbol
+                  )
                 }
               )
             end
@@ -2069,7 +2091,9 @@ module OpenAI
                   generate_summary: T.nilable(
                     OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::GenerateSummary::OrSymbol
                   ),
-                  mode: T.any(String, OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Mode::OrSymbol),
+                  mode: T.nilable(
+                    T.any(String, OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Mode::OrSymbol)
+                  ),
                   summary: T.nilable(
                     OpenAI::Beta::BetaResponsesClientEvent::ResponseCreate::Reasoning::Summary::OrSymbol
                   )
@@ -2365,7 +2389,7 @@ module OpenAI
 
             sig do
               override.returns(
-                {include_obfuscation: T::Boolean}
+                {include_obfuscation: T.nilable(T::Boolean)}
               )
             end
             def to_hash