openai 0.105.0 → 0.106.0

data/lib/openai/models/live/sideband_server_event.rb

@@ -3,8 +3,8 @@
 module OpenAI
   module Models
     module Live
-      # Server events received by an attached Live sideband WebSocket. Audio deltas are
-      # delivered over the primary connection.
+      # Server events received by an attached Live sideband WebSocket, including
+      # reflected input and output audio and transport notifications.
       module SidebandServerEvent
         extend OpenAI::Internal::Type::Union
 
@@ -70,8 +70,248 @@ module OpenAI
         # An informational notice about the Live session, such as the event permissions applied to a frontend data channel.
         variant :info, -> { OpenAI::Live::InfoEvent }
 
+        # Input audio received from the primary transport and reflected to a Live sideband connection before model-input muting.
+        variant :"session.input_audio.append", -> { OpenAI::Live::SidebandServerEvent::SessionInputAudioAppend }
+
+        # An audio chunk generated by the Live model. Decode and play primary WebSocket chunks in delivery order using the configured session audio format. Sideband connections receive reflected output audio with timestamps.
+        variant :"session.output_audio.delta", -> { OpenAI::Live::OutputAudioDeltaEvent }
+
+        # A SIP DTMF keypress received from the caller. Delivered only to sideband observers.
+        variant :"transport.dtmf.received", -> { OpenAI::Live::SidebandServerEvent::TransportDtmfReceived }
+
+        # A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to sideband observers; this is not a client command.
+        variant :"transport.dtmf.send", -> { OpenAI::Live::SidebandServerEvent::TransportDtmfSend }
+
+        # The outbound SIP provider leg is ringing or providing early media. Delivered only to sideband observers.
+        variant :"transport.ringing", -> { OpenAI::Live::SidebandServerEvent::TransportRinging }
+
+        # The outbound SIP provider leg answered and media is established. Delivered only to sideband observers.
+        variant :"transport.answered", -> { OpenAI::Live::SidebandServerEvent::TransportAnswered }
+
+        # An asynchronous outbound SIP setup failure. Delivered only to sideband observers.
+        variant :"transport.failed", -> { OpenAI::Live::SidebandServerEvent::TransportFailed }
+
+        class SessionInputAudioAppend < OpenAI::Internal::Type::BaseModel
+          # @!attribute audio
+          #   Base64-encoded raw mono PCM16LE at 24 kHz received from the primary transport,
+          #   reflected to the sideband before model-input muting. This server event uses the
+          #   same audio key as the client command, but is not an acknowledgment of it.
+          #
+          #   @return [String]
+          required :audio, String
+
+          # @!attribute type
+          #   The event type, always `session.input_audio.append`.
+          #
+          #   @return [Symbol, :"session.input_audio.append"]
+          required :type, const: :"session.input_audio.append"
+
+          # @!method initialize(audio:, type: :"session.input_audio.append")
+          #   Input audio received from the primary transport and reflected to a Live sideband
+          #   connection before model-input muting.
+          #
+          #   @param audio [String]
+          #     Base64-encoded raw mono PCM16LE at 24 kHz received from the primary transport,
+          #     reflected to the sideband before model-input muting. This server event uses the
+          #     same audio key as the client command, but is not an acknowledgment of it.
+          #
+          #   @param type [Symbol, :"session.input_audio.append"]
+          #     The event type, always `session.input_audio.append`.
+        end
+
+        class TransportDtmfReceived < OpenAI::Internal::Type::BaseModel
+          # @!attribute event
+          #
+          #   @return [String]
+          required :event, String
+
+          # @!attribute event_id
+          #
+          #   @return [String]
+          required :event_id, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :"transport.dtmf.received"]
+          required :type, const: :"transport.dtmf.received"
+
+          # @!method initialize(event:, event_id:, type: :"transport.dtmf.received")
+          #   A SIP DTMF keypress received from the caller. Delivered only to sideband
+          #   observers.
+          #
+          #   @param event [String]
+          #   @param event_id [String]
+          #   @param type [Symbol, :"transport.dtmf.received"]
+        end
+
+        class TransportDtmfSend < OpenAI::Internal::Type::BaseModel
+          # @!attribute event
+          #
+          #   @return [String]
+          required :event, String
+
+          # @!attribute event_id
+          #
+          #   @return [String]
+          required :event_id, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :"transport.dtmf.send"]
+          required :type, const: :"transport.dtmf.send"
+
+          # @!attribute client_event_id
+          #   The event_id of the client command, when supplied.
+          #
+          #   @return [String, nil]
+          optional :client_event_id, String
+
+          # @!method initialize(event:, event_id:, client_event_id: nil, type: :"transport.dtmf.send")
+          #   A SIP DTMF keypress successfully sent to the SIP trunk. Delivered only to
+          #   sideband observers; this is not a client command.
+          #
+          #   @param event [String]
+          #
+          #   @param event_id [String]
+          #
+          #   @param client_event_id [String]
+          #     The event_id of the client command, when supplied.
+          #
+          #   @param type [Symbol, :"transport.dtmf.send"]
+        end
+
+        class TransportRinging < OpenAI::Internal::Type::BaseModel
+          # @!attribute event_id
+          #
+          #   @return [String]
+          required :event_id, String
+
+          # @!attribute session_id
+          #   The canonical Live session ID.
+          #
+          #   @return [String]
+          required :session_id, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :"transport.ringing"]
+          required :type, const: :"transport.ringing"
+
+          # @!method initialize(event_id:, session_id:, type: :"transport.ringing")
+          #   The outbound SIP provider leg is ringing or providing early media. Delivered
+          #   only to sideband observers.
+          #
+          #   @param event_id [String]
+          #
+          #   @param session_id [String]
+          #     The canonical Live session ID.
+          #
+          #   @param type [Symbol, :"transport.ringing"]
+        end
+
+        class TransportAnswered < OpenAI::Internal::Type::BaseModel
+          # @!attribute event_id
+          #
+          #   @return [String]
+          required :event_id, String
+
+          # @!attribute session_id
+          #   The canonical Live session ID.
+          #
+          #   @return [String]
+          required :session_id, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :"transport.answered"]
+          required :type, const: :"transport.answered"
+
+          # @!method initialize(event_id:, session_id:, type: :"transport.answered")
+          #   The outbound SIP provider leg answered and media is established. Delivered only
+          #   to sideband observers.
+          #
+          #   @param event_id [String]
+          #
+          #   @param session_id [String]
+          #     The canonical Live session ID.
+          #
+          #   @param type [Symbol, :"transport.answered"]
+        end
+
+        class TransportFailed < OpenAI::Internal::Type::BaseModel
+          # @!attribute error
+          #
+          #   @return [OpenAI::Models::Live::SidebandServerEvent::TransportFailed::Error]
+          required :error, -> { OpenAI::Live::SidebandServerEvent::TransportFailed::Error }
+
+          # @!attribute event_id
+          #
+          #   @return [String]
+          required :event_id, String
+
+          # @!attribute session_id
+          #   The canonical Live session ID.
+          #
+          #   @return [String]
+          required :session_id, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :"transport.failed"]
+          required :type, const: :"transport.failed"
+
+          # @!method initialize(error:, event_id:, session_id:, type: :"transport.failed")
+          #   An asynchronous outbound SIP setup failure. Delivered only to sideband
+          #   observers.
+          #
+          #   @param error [OpenAI::Models::Live::SidebandServerEvent::TransportFailed::Error]
+          #
+          #   @param event_id [String]
+          #
+          #   @param session_id [String]
+          #     The canonical Live session ID.
+          #
+          #   @param type [Symbol, :"transport.failed"]
+
+          # @see OpenAI::Models::Live::SidebandServerEvent::TransportFailed#error
+          class Error < OpenAI::Internal::Type::BaseModel
+            # @!attribute code
+            #   The call setup failure code.
+            #
+            #   @return [String]
+            required :code, String
+
+            # @!attribute message
+            #
+            #   @return [String]
+            required :message, String
+
+            # @!attribute type
+            #
+            #   @return [Symbol, :call_error]
+            required :type, const: :call_error
+
+            # @!attribute param
+            #   The parameter related to the error, if any. Empty when no parameter applies.
+            #
+            #   @return [String, nil]
+            optional :param, String
+
+            # @!method initialize(code:, message:, param: nil, type: :call_error)
+            #   @param code [String]
+            #     The call setup failure code.
+            #
+            #   @param message [String]
+            #
+            #   @param param [String]
+            #     The parameter related to the error, if any. Empty when no parameter applies.
+            #
+            #   @param type [Symbol, :call_error]
+          end
+        end
+
         # @!method self.variants
-        #   @return [Array(OpenAI::Models::Live::SessionStartedEvent, OpenAI::Models::Live::SessionUpdatedEvent, OpenAI::Models::Live::InputAudioMutedEvent, OpenAI::Models::Live::InputAudioUnmutedEvent, OpenAI::Models::Live::OutputAudioFixturePlayingEvent, OpenAI::Models::Live::OutputAudioFixturePlayedEvent, OpenAI::Models::Live::InstructionsAppendedEvent, OpenAI::Models::Live::ThinkingAppendedEvent, OpenAI::Models::Live::CommentaryAppendedEvent, OpenAI::Models::Live::InputTranscriptDeltaEvent, OpenAI::Models::Live::OutputTranscriptDeltaEvent, OpenAI::Models::Live::DelegationCreatedEvent, OpenAI::Models::Live::DecisionEvent, OpenAI::Models::Live::DecisionItemCreatedEvent, OpenAI::Models::Live::DecisionItemDeletedEvent, OpenAI::Models::Live::ResponseEvent, OpenAI::Models::Live::SessionUsageUpdatedEvent, OpenAI::Models::Live::SessionClosedEvent, OpenAI::Models::Live::ErrorEvent, OpenAI::Models::Live::InfoEvent)]
+        #   @return [Array(OpenAI::Models::Live::SessionStartedEvent, OpenAI::Models::Live::SessionUpdatedEvent, OpenAI::Models::Live::InputAudioMutedEvent, OpenAI::Models::Live::InputAudioUnmutedEvent, OpenAI::Models::Live::OutputAudioFixturePlayingEvent, OpenAI::Models::Live::OutputAudioFixturePlayedEvent, OpenAI::Models::Live::InstructionsAppendedEvent, OpenAI::Models::Live::ThinkingAppendedEvent, OpenAI::Models::Live::CommentaryAppendedEvent, OpenAI::Models::Live::InputTranscriptDeltaEvent, OpenAI::Models::Live::OutputTranscriptDeltaEvent, OpenAI::Models::Live::DelegationCreatedEvent, OpenAI::Models::Live::DecisionEvent, OpenAI::Models::Live::DecisionItemCreatedEvent, OpenAI::Models::Live::DecisionItemDeletedEvent, OpenAI::Models::Live::ResponseEvent, OpenAI::Models::Live::SessionUsageUpdatedEvent, OpenAI::Models::Live::SessionClosedEvent, OpenAI::Models::Live::ErrorEvent, OpenAI::Models::Live::InfoEvent, OpenAI::Models::Live::SidebandServerEvent::SessionInputAudioAppend, OpenAI::Models::Live::OutputAudioDeltaEvent, OpenAI::Models::Live::SidebandServerEvent::TransportDtmfReceived, OpenAI::Models::Live::SidebandServerEvent::TransportDtmfSend, OpenAI::Models::Live::SidebandServerEvent::TransportRinging, OpenAI::Models::Live::SidebandServerEvent::TransportAnswered, OpenAI::Models::Live::SidebandServerEvent::TransportFailed)]
       end
     end
   end

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

@@ -486,7 +486,13 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           GPT_5_CHAT_LATEST = :"gpt-5-chat-latest"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1 = :"gpt-4.1"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4_1_MINI = :"gpt-4.1-mini"
           # @deprecated Announced shutdown date: 2026-10-23. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -552,6 +558,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           O1_MINI_2024_09_12 = :"o1-mini-2024-09-12"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O = :"gpt-4o"
           # @deprecated Announced shutdown date: 2027-01-14. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended
@@ -621,6 +630,9 @@ module OpenAI
           # https://developers.openai.com/api/docs/deprecations for details and recommended
           # replacements.
           CODEX_MINI_LATEST = :"codex-mini-latest"
+          # @deprecated Announced shutdown date: 2027-01-14. See
+          # https://developers.openai.com/api/docs/deprecations for details and recommended
+          # replacements.
           GPT_4O_MINI = :"gpt-4o-mini"
           # @deprecated Announced shutdown date: 2027-01-14. See
           # https://developers.openai.com/api/docs/deprecations for details and recommended

data/lib/openai/models.rb

@@ -125,6 +125,8 @@ module OpenAI
 
   DecisionInputText = OpenAI::Models::DecisionInputText
 
+  DecisionPromptCacheBreakpoint = OpenAI::Models::DecisionPromptCacheBreakpoint
+
   DeletedSkill = OpenAI::Models::DeletedSkill
 
   Embedding = OpenAI::Models::Embedding

data/lib/openai/resources/beta/responses.rb

@@ -1,10 +1,29 @@
 # frozen_string_literal: true
 
+require_relative "../../helpers/websocket/resource"
+
 module OpenAI
   module Resources
     class Beta
       # Create and manage model responses.
       class Responses
+        include OpenAI::WebSocket::Resource
+
+        # @api private
+        def __websocket_request(query: {})
+          {method: :get, path: "responses", query: query, security: {bearer_auth: true}}
+        end
+
+        # @api private
+        def __websocket_client_event
+          OpenAI::Models::Beta::BetaResponsesClientEvent
+        end
+
+        # @api private
+        def __websocket_server_event
+          OpenAI::Models::Beta::BetaResponsesServerEvent
+        end
+
         # Create and manage model responses.
         # @return [OpenAI::Resources::Beta::Responses::InputItems]
         attr_reader :input_items

data/lib/openai/resources/decisions.rb

@@ -6,7 +6,7 @@ module OpenAI
       # Use this endpoint to quickly answer classification or scoring questions about
       # some input. You can ask multiple questions in one request.
       #
-      # @overload create(input:, model:, questions:, safety_identifier: nil, request_options: {})
+      # @overload create(input:, model:, questions:, prompt_cache_key: nil, prompt_cache_options: nil, safety_identifier: nil, request_options: {})
       #
       # @param input [String, Array<OpenAI::Models::DecisionInputMessage>]
       #   The text or images to evaluate for every question. Provide a text string or user
@@ -21,6 +21,20 @@ module OpenAI
       #   Ask 1–200 questions about the input. Each question can be a predicate, choice,
       #   or score. Answers come back in the same order.
       #
+      # @param prompt_cache_key [String, nil]
+      #   Partition prompt cache reuse by caller-provided key.
+      #
+      # @param prompt_cache_options [OpenAI::Models::DecisionCreateParams::PromptCacheOptions, 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.
+      #
       # @param safety_identifier [String, nil]
       #   Opaque caller-provided end-user identifier, scoped by the verified org. Match
       #   Responses' limit; this is never the authenticated user identity.

data/lib/openai/version.rb

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

data/lib/openai.rb

@@ -973,6 +973,7 @@ require_relative "openai/models/decision_input_image"
 require_relative "openai/models/decision_input_message"
 require_relative "openai/models/decision_input_part"
 require_relative "openai/models/decision_input_text"
+require_relative "openai/models/decision_prompt_cache_breakpoint"
 require_relative "openai/models/deleted_skill"
 require_relative "openai/models/embedding"
 require_relative "openai/models/embedding_create_params"

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

@@ -128,6 +128,7 @@ module OpenAI
               :validated,
               OpenAI::Admin::Organization::ExternalStorageConfiguration::Status::TaggedSymbol
             )
+            DEGRADED = T.let(:degraded, OpenAI::Admin::Organization::ExternalStorageConfiguration::Status::TaggedSymbol)
             UNHEALTHY = T.let(
               :unhealthy,
               OpenAI::Admin::Organization::ExternalStorageConfiguration::Status::TaggedSymbol

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/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

data/rbi/openai/models/decision_input_image.rbi

@@ -24,6 +24,15 @@ module OpenAI
       sig { returns(T.nilable(OpenAI::DecisionInputImage::Detail::OrSymbol)) }
       attr_accessor :detail
 
+      # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+      # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+      # token block.
+      sig { returns(T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash)) }
+      attr_reader :prompt_cache_breakpoint
+
+      sig { params(prompt_cache_breakpoint: T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash)).void }
+      attr_writer :prompt_cache_breakpoint
+
       # An image provided as a base64 data URL or a publicly accessible HTTP(S) URL.
       # File IDs are not supported.
       sig do
@@ -33,6 +42,8 @@ module OpenAI
 
           detail: T.nilable(OpenAI::DecisionInputImage::Detail::OrSymbol),
 
+          prompt_cache_breakpoint: T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash),
+
           type: Symbol
         )
           .returns(T.attached_class)
@@ -46,13 +57,23 @@ module OpenAI
         # auto.
         detail: nil,
 
+        # Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+        # from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+        # token block.
+        prompt_cache_breakpoint: nil,
+
         type: :input_image
       )
       end
 
       sig do
         override.returns(
-          {image_url: String, type: Symbol, detail: T.nilable(OpenAI::DecisionInputImage::Detail::OrSymbol)}
+          {
+            image_url: String,
+            type: Symbol,
+            detail: T.nilable(OpenAI::DecisionInputImage::Detail::OrSymbol),
+            prompt_cache_breakpoint: T.nilable(OpenAI::DecisionPromptCacheBreakpoint::OrHash)
+          }
         )
       end
       def to_hash