openai 0.105.0 → 0.107.0

data/rbi/openai/models/admin/organization/usage_code_interpreter_sessions_response.rbi

@@ -231,6 +231,11 @@ module OpenAI
                 sig { params(input_cache_write_12h_tokens: Integer).void }
                 attr_writer :input_cache_write_12h_tokens
 
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period. May be absent or null for older responses.
+                sig { returns(T.nilable(Integer)) }
+                attr_accessor :input_cache_write_30m_tokens
+
                 # The aggregated number of input tokens written to the cache with a 30-minute
                 # retention period.
                 sig { returns(T.nilable(Integer)) }
@@ -354,6 +359,8 @@ module OpenAI
 
                     input_cache_write_12h_tokens: Integer,
 
+                    input_cache_write_30m_tokens: T.nilable(Integer),
+
                     input_cache_write_tokens: Integer,
 
                     input_cached_audio_tokens: Integer,
@@ -424,6 +431,10 @@ module OpenAI
                   # retention period.
                   input_cache_write_12h_tokens: nil,
 
+                  # The aggregated number of input tokens written to the cache with a 30-minute
+                  # retention period. May be absent or null for older responses.
+                  input_cache_write_30m_tokens: nil,
+
                   # The aggregated number of input tokens written to the cache with a 30-minute
                   # retention period.
                   input_cache_write_tokens: nil,
@@ -495,6 +506,7 @@ module OpenAI
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
+                      input_cache_write_30m_tokens: T.nilable(Integer),
                       input_cache_write_tokens: Integer,
                       input_cached_audio_tokens: Integer,
                       input_cached_image_tokens: Integer,

data/rbi/openai/models/admin/organization/usage_completions_response.rbi

@@ -227,6 +227,11 @@ module OpenAI
                 sig { params(input_cache_write_12h_tokens: Integer).void }
                 attr_writer :input_cache_write_12h_tokens
 
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period. May be absent or null for older responses.
+                sig { returns(T.nilable(Integer)) }
+                attr_accessor :input_cache_write_30m_tokens
+
                 # The aggregated number of input tokens written to the cache with a 30-minute
                 # retention period.
                 sig { returns(T.nilable(Integer)) }
@@ -350,6 +355,8 @@ module OpenAI
 
                     input_cache_write_12h_tokens: Integer,
 
+                    input_cache_write_30m_tokens: T.nilable(Integer),
+
                     input_cache_write_tokens: Integer,
 
                     input_cached_audio_tokens: Integer,
@@ -420,6 +427,10 @@ module OpenAI
                   # retention period.
                   input_cache_write_12h_tokens: nil,
 
+                  # The aggregated number of input tokens written to the cache with a 30-minute
+                  # retention period. May be absent or null for older responses.
+                  input_cache_write_30m_tokens: nil,
+
                   # The aggregated number of input tokens written to the cache with a 30-minute
                   # retention period.
                   input_cache_write_tokens: nil,
@@ -491,6 +502,7 @@ module OpenAI
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
+                      input_cache_write_30m_tokens: T.nilable(Integer),
                       input_cache_write_tokens: Integer,
                       input_cached_audio_tokens: Integer,
                       input_cached_image_tokens: Integer,

data/rbi/openai/models/admin/organization/usage_costs_response.rbi

@@ -223,6 +223,11 @@ module OpenAI
                 sig { params(input_cache_write_12h_tokens: Integer).void }
                 attr_writer :input_cache_write_12h_tokens
 
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period. May be absent or null for older responses.
+                sig { returns(T.nilable(Integer)) }
+                attr_accessor :input_cache_write_30m_tokens
+
                 # The aggregated number of input tokens written to the cache with a 30-minute
                 # retention period.
                 sig { returns(T.nilable(Integer)) }
@@ -346,6 +351,8 @@ module OpenAI
 
                     input_cache_write_12h_tokens: Integer,
 
+                    input_cache_write_30m_tokens: T.nilable(Integer),
+
                     input_cache_write_tokens: Integer,
 
                     input_cached_audio_tokens: Integer,
@@ -416,6 +423,10 @@ module OpenAI
                   # retention period.
                   input_cache_write_12h_tokens: nil,
 
+                  # The aggregated number of input tokens written to the cache with a 30-minute
+                  # retention period. May be absent or null for older responses.
+                  input_cache_write_30m_tokens: nil,
+
                   # The aggregated number of input tokens written to the cache with a 30-minute
                   # retention period.
                   input_cache_write_tokens: nil,
@@ -487,6 +498,7 @@ module OpenAI
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
+                      input_cache_write_30m_tokens: T.nilable(Integer),
                       input_cache_write_tokens: Integer,
                       input_cached_audio_tokens: Integer,
                       input_cached_image_tokens: Integer,

data/rbi/openai/models/admin/organization/usage_decisions_response.rbi

@@ -183,6 +183,11 @@ module OpenAI
               sig { returns(T.nilable(Integer)) }
               attr_accessor :input_cache_write_12h_tokens
 
+              # The aggregated number of input tokens written to the cache with a 30-minute
+              # retention period.
+              sig { returns(T.nilable(Integer)) }
+              attr_accessor :input_cache_write_30m_tokens
+
               # The aggregated number of input tokens written to the cache with a 30-minute
               # retention period.
               sig { returns(T.nilable(Integer)) }
@@ -273,6 +278,8 @@ module OpenAI
 
                   input_cache_write_12h_tokens: T.nilable(Integer),
 
+                  input_cache_write_30m_tokens: T.nilable(Integer),
+
                   input_cache_write_tokens: T.nilable(Integer),
 
                   input_cached_audio_tokens: T.nilable(Integer),
@@ -343,6 +350,10 @@ module OpenAI
                 # retention period.
                 input_cache_write_12h_tokens: nil,
 
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period.
+                input_cache_write_30m_tokens: nil,
+
                 # The aggregated number of input tokens written to the cache with a 30-minute
                 # retention period.
                 input_cache_write_tokens: nil,
@@ -414,6 +425,7 @@ module OpenAI
                     batch: T.nilable(T::Boolean),
                     input_audio_tokens: T.nilable(Integer),
                     input_cache_write_12h_tokens: T.nilable(Integer),
+                    input_cache_write_30m_tokens: T.nilable(Integer),
                     input_cache_write_tokens: T.nilable(Integer),
                     input_cached_audio_tokens: T.nilable(Integer),
                     input_cached_image_tokens: T.nilable(Integer),

data/rbi/openai/models/admin/organization/usage_embeddings_response.rbi

@@ -227,6 +227,11 @@ module OpenAI
                 sig { params(input_cache_write_12h_tokens: Integer).void }
                 attr_writer :input_cache_write_12h_tokens
 
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period. May be absent or null for older responses.
+                sig { returns(T.nilable(Integer)) }
+                attr_accessor :input_cache_write_30m_tokens
+
                 # The aggregated number of input tokens written to the cache with a 30-minute
                 # retention period.
                 sig { returns(T.nilable(Integer)) }
@@ -350,6 +355,8 @@ module OpenAI
 
                     input_cache_write_12h_tokens: Integer,
 
+                    input_cache_write_30m_tokens: T.nilable(Integer),
+
                     input_cache_write_tokens: Integer,
 
                     input_cached_audio_tokens: Integer,
@@ -420,6 +427,10 @@ module OpenAI
                   # retention period.
                   input_cache_write_12h_tokens: nil,
 
+                  # The aggregated number of input tokens written to the cache with a 30-minute
+                  # retention period. May be absent or null for older responses.
+                  input_cache_write_30m_tokens: nil,
+
                   # The aggregated number of input tokens written to the cache with a 30-minute
                   # retention period.
                   input_cache_write_tokens: nil,
@@ -491,6 +502,7 @@ module OpenAI
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
+                      input_cache_write_30m_tokens: T.nilable(Integer),
                       input_cache_write_tokens: Integer,
                       input_cached_audio_tokens: Integer,
                       input_cached_image_tokens: Integer,

data/rbi/openai/models/admin/organization/usage_file_search_calls_response.rbi

@@ -229,6 +229,11 @@ module OpenAI
                 sig { params(input_cache_write_12h_tokens: Integer).void }
                 attr_writer :input_cache_write_12h_tokens
 
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period. May be absent or null for older responses.
+                sig { returns(T.nilable(Integer)) }
+                attr_accessor :input_cache_write_30m_tokens
+
                 # The aggregated number of input tokens written to the cache with a 30-minute
                 # retention period.
                 sig { returns(T.nilable(Integer)) }
@@ -352,6 +357,8 @@ module OpenAI
 
                     input_cache_write_12h_tokens: Integer,
 
+                    input_cache_write_30m_tokens: T.nilable(Integer),
+
                     input_cache_write_tokens: Integer,
 
                     input_cached_audio_tokens: Integer,
@@ -422,6 +429,10 @@ module OpenAI
                   # retention period.
                   input_cache_write_12h_tokens: nil,
 
+                  # The aggregated number of input tokens written to the cache with a 30-minute
+                  # retention period. May be absent or null for older responses.
+                  input_cache_write_30m_tokens: nil,
+
                   # The aggregated number of input tokens written to the cache with a 30-minute
                   # retention period.
                   input_cache_write_tokens: nil,
@@ -493,6 +504,7 @@ module OpenAI
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
+                      input_cache_write_30m_tokens: T.nilable(Integer),
                       input_cache_write_tokens: Integer,
                       input_cached_audio_tokens: Integer,
                       input_cached_image_tokens: Integer,

data/rbi/openai/models/admin/organization/usage_images_response.rbi

@@ -223,6 +223,11 @@ module OpenAI
                 sig { params(input_cache_write_12h_tokens: Integer).void }
                 attr_writer :input_cache_write_12h_tokens
 
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period. May be absent or null for older responses.
+                sig { returns(T.nilable(Integer)) }
+                attr_accessor :input_cache_write_30m_tokens
+
                 # The aggregated number of input tokens written to the cache with a 30-minute
                 # retention period.
                 sig { returns(T.nilable(Integer)) }
@@ -346,6 +351,8 @@ module OpenAI
 
                     input_cache_write_12h_tokens: Integer,
 
+                    input_cache_write_30m_tokens: T.nilable(Integer),
+
                     input_cache_write_tokens: Integer,
 
                     input_cached_audio_tokens: Integer,
@@ -416,6 +423,10 @@ module OpenAI
                   # retention period.
                   input_cache_write_12h_tokens: nil,
 
+                  # The aggregated number of input tokens written to the cache with a 30-minute
+                  # retention period. May be absent or null for older responses.
+                  input_cache_write_30m_tokens: nil,
+
                   # The aggregated number of input tokens written to the cache with a 30-minute
                   # retention period.
                   input_cache_write_tokens: nil,
@@ -487,6 +498,7 @@ module OpenAI
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
+                      input_cache_write_30m_tokens: T.nilable(Integer),
                       input_cache_write_tokens: Integer,
                       input_cached_audio_tokens: Integer,
                       input_cached_image_tokens: Integer,

data/rbi/openai/models/admin/organization/usage_moderations_response.rbi

@@ -227,6 +227,11 @@ module OpenAI
                 sig { params(input_cache_write_12h_tokens: Integer).void }
                 attr_writer :input_cache_write_12h_tokens
 
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period. May be absent or null for older responses.
+                sig { returns(T.nilable(Integer)) }
+                attr_accessor :input_cache_write_30m_tokens
+
                 # The aggregated number of input tokens written to the cache with a 30-minute
                 # retention period.
                 sig { returns(T.nilable(Integer)) }
@@ -350,6 +355,8 @@ module OpenAI
 
                     input_cache_write_12h_tokens: Integer,
 
+                    input_cache_write_30m_tokens: T.nilable(Integer),
+
                     input_cache_write_tokens: Integer,
 
                     input_cached_audio_tokens: Integer,
@@ -420,6 +427,10 @@ module OpenAI
                   # retention period.
                   input_cache_write_12h_tokens: nil,
 
+                  # The aggregated number of input tokens written to the cache with a 30-minute
+                  # retention period. May be absent or null for older responses.
+                  input_cache_write_30m_tokens: nil,
+
                   # The aggregated number of input tokens written to the cache with a 30-minute
                   # retention period.
                   input_cache_write_tokens: nil,
@@ -491,6 +502,7 @@ module OpenAI
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
+                      input_cache_write_30m_tokens: T.nilable(Integer),
                       input_cache_write_tokens: Integer,
                       input_cached_audio_tokens: Integer,
                       input_cached_image_tokens: Integer,

data/rbi/openai/models/admin/organization/usage_vector_stores_response.rbi

@@ -227,6 +227,11 @@ module OpenAI
                 sig { params(input_cache_write_12h_tokens: Integer).void }
                 attr_writer :input_cache_write_12h_tokens
 
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period. May be absent or null for older responses.
+                sig { returns(T.nilable(Integer)) }
+                attr_accessor :input_cache_write_30m_tokens
+
                 # The aggregated number of input tokens written to the cache with a 30-minute
                 # retention period.
                 sig { returns(T.nilable(Integer)) }
@@ -350,6 +355,8 @@ module OpenAI
 
                     input_cache_write_12h_tokens: Integer,
 
+                    input_cache_write_30m_tokens: T.nilable(Integer),
+
                     input_cache_write_tokens: Integer,
 
                     input_cached_audio_tokens: Integer,
@@ -420,6 +427,10 @@ module OpenAI
                   # retention period.
                   input_cache_write_12h_tokens: nil,
 
+                  # The aggregated number of input tokens written to the cache with a 30-minute
+                  # retention period. May be absent or null for older responses.
+                  input_cache_write_30m_tokens: nil,
+
                   # The aggregated number of input tokens written to the cache with a 30-minute
                   # retention period.
                   input_cache_write_tokens: nil,
@@ -491,6 +502,7 @@ module OpenAI
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
+                      input_cache_write_30m_tokens: T.nilable(Integer),
                       input_cache_write_tokens: Integer,
                       input_cached_audio_tokens: Integer,
                       input_cached_image_tokens: Integer,

data/rbi/openai/models/admin/organization/usage_web_search_calls_response.rbi

@@ -229,6 +229,11 @@ module OpenAI
                 sig { params(input_cache_write_12h_tokens: Integer).void }
                 attr_writer :input_cache_write_12h_tokens
 
+                # The aggregated number of input tokens written to the cache with a 30-minute
+                # retention period. May be absent or null for older responses.
+                sig { returns(T.nilable(Integer)) }
+                attr_accessor :input_cache_write_30m_tokens
+
                 # The aggregated number of input tokens written to the cache with a 30-minute
                 # retention period.
                 sig { returns(T.nilable(Integer)) }
@@ -352,6 +357,8 @@ module OpenAI
 
                     input_cache_write_12h_tokens: Integer,
 
+                    input_cache_write_30m_tokens: T.nilable(Integer),
+
                     input_cache_write_tokens: Integer,
 
                     input_cached_audio_tokens: Integer,
@@ -422,6 +429,10 @@ module OpenAI
                   # retention period.
                   input_cache_write_12h_tokens: nil,
 
+                  # The aggregated number of input tokens written to the cache with a 30-minute
+                  # retention period. May be absent or null for older responses.
+                  input_cache_write_30m_tokens: nil,
+
                   # The aggregated number of input tokens written to the cache with a 30-minute
                   # retention period.
                   input_cache_write_tokens: nil,
@@ -493,6 +504,7 @@ module OpenAI
                       batch: T.nilable(T::Boolean),
                       input_audio_tokens: Integer,
                       input_cache_write_12h_tokens: Integer,
+                      input_cache_write_30m_tokens: T.nilable(Integer),
                       input_cache_write_tokens: Integer,
                       input_cached_audio_tokens: Integer,
                       input_cached_image_tokens: Integer,

data/rbi/openai/models/beta/agent_create_params.rbi

@@ -208,6 +208,9 @@ module OpenAI
           # Uses the fast service tier.
           FAST = T.let(:fast, OpenAI::Beta::AgentCreateParams::ServiceTier::TaggedSymbol)
 
+          # Uses the ultrafast service tier.
+          ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::AgentCreateParams::ServiceTier::TaggedSymbol)
+
           sig { override.returns(T::Array[OpenAI::Beta::AgentCreateParams::ServiceTier::TaggedSymbol]) }
           def self.values
           end

data/rbi/openai/models/beta/agent_update_params.rbi

@@ -219,6 +219,9 @@ module OpenAI
           # Uses the fast service tier.
           FAST = T.let(:fast, OpenAI::Beta::AgentUpdateParams::ServiceTier::TaggedSymbol)
 
+          # Uses the ultrafast service tier.
+          ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::AgentUpdateParams::ServiceTier::TaggedSymbol)
+
           sig { override.returns(T::Array[OpenAI::Beta::AgentUpdateParams::ServiceTier::TaggedSymbol]) }
           def self.values
           end

data/rbi/openai/models/beta/agents/session_create_params.rbi

@@ -333,6 +333,9 @@ module OpenAI
               # Uses the fast service tier.
               FAST = T.let(:fast, OpenAI::Beta::Agents::SessionCreateParams::Agent::ServiceTier::TaggedSymbol)
 
+              # Uses the ultrafast service tier.
+              ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::Agents::SessionCreateParams::Agent::ServiceTier::TaggedSymbol)
+
               sig {
                 override.returns(T::Array[OpenAI::Beta::Agents::SessionCreateParams::Agent::ServiceTier::TaggedSymbol])
               }

data/rbi/openai/models/beta/agents/session_update_params.rbi

@@ -251,6 +251,9 @@ module OpenAI
               # Uses the fast service tier.
               FAST = T.let(:fast, OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::TaggedSymbol)
 
+              # Uses the ultrafast service tier.
+              ULTRAFAST = T.let(:ultrafast, OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::TaggedSymbol)
+
               sig {
                 override.returns(T::Array[OpenAI::Beta::Agents::SessionUpdateParams::Agent::ServiceTier::TaggedSymbol])
               }

data/rbi/openai/models/beta/beta_response_input_item.rbi

@@ -5130,6 +5130,10 @@ module OpenAI
           sig { returns(Symbol) }
           attr_accessor :type
 
+          # The unique ID of this compaction trigger.
+          sig { returns(T.nilable(String)) }
+          attr_accessor :id
+
           # The agent that produced this item.
           sig { returns(T.nilable(OpenAI::Beta::BetaResponseInputItem::CompactionTrigger::Agent)) }
           attr_reader :agent
@@ -5141,6 +5145,8 @@ module OpenAI
           sig do
             params(
 
+              id: T.nilable(String),
+
               agent: T.nilable(OpenAI::Beta::BetaResponseInputItem::CompactionTrigger::Agent::OrHash),
 
               type: Symbol
@@ -5149,6 +5155,9 @@ module OpenAI
           end
           def self.new(
 
+            # The unique ID of this compaction trigger.
+            id: nil,
+
             # The agent that produced this item.
             agent: nil,
 
@@ -5160,7 +5169,11 @@ module OpenAI
 
           sig do
             override.returns(
-              {type: Symbol, agent: T.nilable(OpenAI::Beta::BetaResponseInputItem::CompactionTrigger::Agent)}
+              {
+                type: Symbol,
+                id: T.nilable(String),
+                agent: T.nilable(OpenAI::Beta::BetaResponseInputItem::CompactionTrigger::Agent)
+              }
             )
           end
           def to_hash

data/rbi/openai/models/decision_create_params.rbi

@@ -41,6 +41,22 @@ module OpenAI
       }
       attr_accessor :questions
 
+      # Partition prompt cache reuse by caller-provided key.
+      sig { returns(T.nilable(String)) }
+      attr_accessor :prompt_cache_key
+
+      # Options for prompt caching. Supported for `gpt-5.6` and later models. By
+      # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+      # explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+      # request can write up to four breakpoints. For cache matching, OpenAI considers
+      # up to the latest 80 breakpoints in the conversation, without a content-block
+      # lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+      # `ttl` defaults to `30m`, which is currently the only supported value. See the
+      # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
+      # for current details.
+      sig { returns(T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::OrHash)) }
+      attr_accessor :prompt_cache_options
+
       # Opaque caller-provided end-user identifier, scoped by the verified org. Match
       # Responses' limit; this is never the authenticated user identity.
       sig { returns(T.nilable(String)) }
@@ -61,6 +77,10 @@ module OpenAI
             )
           ],
 
+          prompt_cache_key: T.nilable(String),
+
+          prompt_cache_options: T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::OrHash),
+
           safety_identifier: T.nilable(String),
 
           request_options: OpenAI::RequestOptions::OrHash
@@ -82,6 +102,20 @@ module OpenAI
         # or score. Answers come back in the same order.
         questions:,
 
+        # Partition prompt cache reuse by caller-provided key.
+        prompt_cache_key: nil,
+
+        # Options for prompt caching. Supported for `gpt-5.6` and later models. By
+        # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+        # explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+        # request can write up to four breakpoints. For cache matching, OpenAI considers
+        # up to the latest 80 breakpoints in the conversation, without a content-block
+        # lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+        # `ttl` defaults to `30m`, which is currently the only supported value. See the
+        # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
+        # for current details.
+        prompt_cache_options: nil,
+
         # Opaque caller-provided end-user identifier, scoped by the verified org. Match
         # Responses' limit; this is never the authenticated user identity.
         safety_identifier: nil,
@@ -102,6 +136,8 @@ module OpenAI
                 OpenAI::DecisionCreateParams::Question::Score
               )
             ],
+            prompt_cache_key: T.nilable(String),
+            prompt_cache_options: T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::OrHash),
             safety_identifier: T.nilable(String),
             request_options: OpenAI::RequestOptions
           }
@@ -440,6 +476,116 @@ module OpenAI
 
       end
 
+      class PromptCacheOptions < OpenAI::Internal::Type::BaseModel
+        OrHash = T.type_alias do
+          T.any(
+            OpenAI::DecisionCreateParams::PromptCacheOptions,
+            OpenAI::Internal::AnyHash
+          )
+        end
+
+        # 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
+        # `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+        # latest four explicit breakpoints. If there are no explicit breakpoints, the
+        # request does not use prompt caching.
+        sig { returns(T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::OrSymbol)) }
+        attr_accessor :mode
+
+        # The minimum lifetime applied to every implicit and explicit cache breakpoint
+        # written by the request. Defaults to `30m`, which is currently the only supported
+        # value. The backend may retain cache entries for longer.
+        sig { returns(T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::OrSymbol)) }
+        attr_reader :ttl
+
+        sig { params(ttl: OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::OrSymbol).void }
+        attr_writer :ttl
+
+        # Options for prompt caching. Supported for `gpt-5.6` and later models. By
+        # default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+        # explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+        # request can write up to four breakpoints. For cache matching, OpenAI considers
+        # up to the latest 80 breakpoints in the conversation, without a content-block
+        # lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+        # `ttl` defaults to `30m`, which is currently the only supported value. See the
+        # [prompt caching guide](https://developers.openai.com/api/docs/guides/prompt-caching)
+        # for current details.
+        sig do
+          params(
+
+            mode: T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::OrSymbol),
+
+            ttl: OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::OrSymbol
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+
+          # 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
+          # `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+          # latest four explicit breakpoints. If there are no explicit breakpoints, the
+          # request does not use prompt caching.
+          mode: nil,
+
+          # The minimum lifetime applied to every implicit and explicit cache breakpoint
+          # written by the request. Defaults to `30m`, which is currently the only supported
+          # value. The backend may retain cache entries for longer.
+
+          ttl: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              mode: T.nilable(OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::OrSymbol),
+              ttl: OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # 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
+        # `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+        # latest four explicit breakpoints. If there are no explicit breakpoints, the
+        # request does not use prompt caching.
+        module Mode
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::DecisionCreateParams::PromptCacheOptions::Mode) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          IMPLICIT = T.let(:implicit, OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::TaggedSymbol)
+          EXPLICIT = T.let(:explicit, OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::TaggedSymbol)
+
+          sig { override.returns(T::Array[OpenAI::DecisionCreateParams::PromptCacheOptions::Mode::TaggedSymbol]) }
+          def self.values
+          end
+        end
+
+        # The minimum lifetime applied to every implicit and explicit cache breakpoint
+        # written by the request. Defaults to `30m`, which is currently the only supported
+        # value. The backend may retain cache entries for longer.
+        module Ttl
+          extend OpenAI::Internal::Type::Enum
+
+          TaggedSymbol = T.type_alias { T.all(Symbol, OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          TTL_30M = T.let(:"30m", OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::TaggedSymbol)
+
+          sig { override.returns(T::Array[OpenAI::DecisionCreateParams::PromptCacheOptions::Ttl::TaggedSymbol]) }
+          def self.values
+          end
+        end
+      end
+
     end
 
   end