openai 0.85.0 → 0.86.0

data/rbi/openai/models/beta/beta_responses_server_event.rbi

@@ -139,7 +139,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseAudioDeltaEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -202,7 +202,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseAudioDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -271,7 +271,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseAudioTranscriptDeltaEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -334,7 +334,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseAudioTranscriptDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -416,7 +416,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseCodeInterpreterCallCodeDeltaEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -497,7 +497,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseCodeInterpreterCallCodeDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -573,7 +573,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseCodeInterpreterCallCompletedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -649,7 +649,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseCodeInterpreterCallInProgressEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -725,7 +725,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseCodeInterpreterCallInterpretingEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -794,7 +794,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseCompletedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -885,7 +885,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseContentPartAddedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -976,7 +976,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseContentPartDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1045,7 +1045,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseCreatedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1120,7 +1120,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseFileSearchCallCompletedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1195,7 +1195,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseFileSearchCallInProgressEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1270,7 +1270,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseFileSearchCallSearchingEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1351,7 +1351,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseFunctionCallArgumentsDeltaEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1384,8 +1384,6 @@ module OpenAI
 
               item_id: String,
 
-              name: String,
-
               output_index: Integer,
 
               sequence_number: Integer,
@@ -1406,9 +1404,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:,
 
@@ -1431,12 +1426,11 @@ module OpenAI
               {
                 arguments: String,
                 item_id: String,
-                name: String,
                 output_index: Integer,
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseFunctionCallArgumentsDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1516,8 +1510,8 @@ module OpenAI
                 output_index: Integer,
                 sequence_number: Integer,
                 type: Symbol,
-                agent: OpenAI::Beta::BetaResponseShellCallCommandAddedEvent::Agent,
-                stream_id: String
+                agent: T.nilable(OpenAI::Beta::BetaResponseShellCallCommandAddedEvent::Agent),
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1602,9 +1596,9 @@ module OpenAI
                 output_index: Integer,
                 sequence_number: Integer,
                 type: Symbol,
-                agent: OpenAI::Beta::BetaResponseShellCallCommandDeltaEvent::Agent,
-                obfuscation: String,
-                stream_id: String
+                agent: T.nilable(OpenAI::Beta::BetaResponseShellCallCommandDeltaEvent::Agent),
+                obfuscation: T.nilable(String),
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1684,8 +1678,8 @@ module OpenAI
                 output_index: Integer,
                 sequence_number: Integer,
                 type: Symbol,
-                agent: OpenAI::Beta::BetaResponseShellCallCommandDoneEvent::Agent,
-                stream_id: String
+                agent: T.nilable(OpenAI::Beta::BetaResponseShellCallCommandDoneEvent::Agent),
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1771,8 +1765,8 @@ module OpenAI
                 output_index: Integer,
                 sequence_number: Integer,
                 type: Symbol,
-                agent: OpenAI::Beta::BetaResponseShellCallOutputContentDeltaEvent::Agent,
-                stream_id: String
+                agent: T.nilable(OpenAI::Beta::BetaResponseShellCallOutputContentDeltaEvent::Agent),
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1858,8 +1852,8 @@ module OpenAI
                 output_index: Integer,
                 sequence_number: Integer,
                 type: Symbol,
-                agent: OpenAI::Beta::BetaResponseShellCallOutputContentDoneEvent::Agent,
-                stream_id: String
+                agent: T.nilable(OpenAI::Beta::BetaResponseShellCallOutputContentDoneEvent::Agent),
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1928,7 +1922,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseInProgressEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -1997,7 +1991,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseFailedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2070,7 +2064,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseIncompleteEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2180,7 +2174,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseOutputItemAddedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2287,7 +2281,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseOutputItemDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2374,7 +2368,7 @@ module OpenAI
                 summary_index: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseReasoningSummaryPartAddedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2467,8 +2461,8 @@ module OpenAI
                 summary_index: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseReasoningSummaryPartDoneEvent::Agent),
-                status: OpenAI::Beta::BetaResponseReasoningSummaryPartDoneEvent::Status::TaggedSymbol,
-                stream_id: String
+                status: T.nilable(OpenAI::Beta::BetaResponseReasoningSummaryPartDoneEvent::Status::TaggedSymbol),
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2555,7 +2549,7 @@ module OpenAI
                 summary_index: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseReasoningSummaryTextDeltaEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2642,7 +2636,7 @@ module OpenAI
                 text: String,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseReasoningSummaryTextDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2729,7 +2723,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseReasoningTextDeltaEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2816,7 +2810,7 @@ module OpenAI
                 text: String,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseReasoningTextDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2903,7 +2897,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseRefusalDeltaEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -2990,7 +2984,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseRefusalDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3083,7 +3077,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseTextDeltaEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3176,7 +3170,7 @@ module OpenAI
                 text: String,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseTextDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3251,7 +3245,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseWebSearchCallCompletedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3326,7 +3320,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseWebSearchCallInProgressEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3401,7 +3395,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseWebSearchCallSearchingEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3477,7 +3471,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseImageGenCallCompletedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3553,7 +3547,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseImageGenCallGeneratingEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3628,7 +3622,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseImageGenCallInProgressEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3736,11 +3730,11 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseImageGenCallPartialImageEvent::Agent),
-                background: String,
-                output_format: String,
-                quality: String,
-                size: String,
-                stream_id: String
+                background: T.nilable(String),
+                output_format: T.nilable(String),
+                quality: T.nilable(String),
+                size: T.nilable(String),
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3823,7 +3817,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseMcpCallArgumentsDeltaEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3904,7 +3898,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseMcpCallArgumentsDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -3979,7 +3973,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseMcpCallCompletedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4054,7 +4048,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseMcpCallFailedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4129,7 +4123,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseMcpCallInProgressEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4204,7 +4198,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseMcpListToolsCompletedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4279,7 +4273,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseMcpListToolsFailedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4355,7 +4349,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseMcpListToolsInProgressEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4455,7 +4449,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseOutputTextAnnotationAddedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4524,7 +4518,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseQueuedEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4605,7 +4599,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseCustomToolCallInputDeltaEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4686,7 +4680,7 @@ module OpenAI
                 sequence_number: Integer,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponseCustomToolCallInputDoneEvent::Agent),
-                stream_id: String
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4793,9 +4787,9 @@ module OpenAI
                 error: OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error,
                 type: Symbol,
                 agent: T.nilable(OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Agent),
-                sequence_number: Integer,
-                status: Integer,
-                stream_id: String
+                sequence_number: T.nilable(Integer),
+                status: T.nilable(Integer),
+                stream_id: T.nilable(String)
               }
             )
           end
@@ -4892,8 +4886,10 @@ module OpenAI
                   message: String,
                   param: T.nilable(String),
                   type: String,
-                  headers: T::Hash[Symbol, String],
-                  misalignment: OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment
+                  headers: T.nilable(T::Hash[Symbol, String]),
+                  misalignment: T.nilable(
+                    OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment
+                  )
                 }
               )
             end
@@ -4983,9 +4979,13 @@ module OpenAI
               sig do
                 override.returns(
                   {
-                    detailed_explanation: String,
-                    error_type: OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::ErrorType::Variants,
-                    steer: OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::Steer
+                    detailed_explanation: T.nilable(String),
+                    error_type: T.nilable(
+                      OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::ErrorType::Variants
+                    ),
+                    steer: T.nilable(
+                      OpenAI::Beta::BetaResponsesServerEvent::BetaResponseWsError::Error::Misalignment::Steer
+                    )
                   }
                 )
               end

data/rbi/openai/models/beta/response_compact_params.rbi

@@ -77,12 +77,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.
         sig { returns(T.nilable(OpenAI::Beta::ResponseCompactParams::ServiceTier::OrSymbol)) }
         attr_accessor :service_tier
 
@@ -167,12 +168,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.
           service_tier: nil,
 
           betas: nil,
@@ -582,12 +584,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
 

data/rbi/openai/models/beta/response_create_params.rbi

@@ -1413,6 +1413,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
@@ -1446,6 +1451,8 @@ module OpenAI
           sig do
             params(
 
+              comparison_response_id: T.nilable(String),
+
               mode: OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Mode::OrSymbol,
 
               ttl: OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl::OrSymbol
@@ -1454,6 +1461,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
@@ -1473,6 +1484,7 @@ module OpenAI
           sig do
             override.returns(
               {
+                comparison_response_id: T.nilable(String),
                 mode: OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Mode::OrSymbol,
                 ttl: OpenAI::Beta::ResponseCreateParams::PromptCacheOptions::Ttl::OrSymbol
               }