openai 0.102.0 → 0.104.0

data/rbi/openai/models/live/session_resource.rbi

@@ -52,13 +52,14 @@ module OpenAI
         attr_writer :client
 
         # Who handles tasks delegated by the Live model. Omitted or null selects your
-        # application; use `responses` to let the API manage a Responses backend.
+        # application; use `responses` or `decisions` to delegate to the corresponding
+        # API.
         sig { returns(T.nilable(OpenAI::Live::SessionResource::Delegation::Variants)) }
         attr_accessor :delegation
 
         # Ordered text-only history supplied before startup. Supports developer, user, and
-        # assistant messages with one text part each; at most 128 messages and 8,192
-        # rendered tokens in total.
+        # assistant messages with one text part each; at most 128 messages and a
+        # configured rendered-token limit (8,192 by default).
         sig {
           returns(
             T.nilable(
@@ -106,6 +107,16 @@ module OpenAI
         sig { params(store: T::Boolean).void }
         attr_writer :store
 
+        # At most one Decisions trigger per transcript event type. Triggers run
+        # independently of delegation. On update, omit triggers to keep the current
+        # configuration, send a list to replace it, or send an empty list to disable
+        # triggers.
+        sig { returns(T.nilable(T::Array[OpenAI::Live::DecisionTrigger])) }
+        attr_reader :triggers
+
+        sig { params(triggers: T::Array[OpenAI::Live::DecisionTrigger::OrHash]).void }
+        attr_writer :triggers
+
         # The resolved Live session configuration and server-assigned session metadata.
         sig do
           params(
@@ -123,7 +134,8 @@ module OpenAI
             delegation: T.nilable(
               T.any(
                 OpenAI::Live::ClientDelegation::OrHash,
-                OpenAI::Live::SessionResource::Delegation::Responses::OrHash
+                OpenAI::Live::SessionResource::Delegation::Responses::OrHash,
+                OpenAI::Live::SessionResource::Delegation::Decisions::OrHash
               )
             ),
 
@@ -139,6 +151,8 @@ module OpenAI
 
             store: T::Boolean,
 
+            triggers: T::Array[OpenAI::Live::DecisionTrigger::OrHash],
+
             status: Symbol
           )
             .returns(T.attached_class)
@@ -166,12 +180,13 @@ module OpenAI
           client: nil,
 
           # Who handles tasks delegated by the Live model. Omitted or null selects your
-          # application; use `responses` to let the API manage a Responses backend.
+          # application; use `responses` or `decisions` to delegate to the corresponding
+          # API.
           delegation: nil,
 
           # Ordered text-only history supplied before startup. Supports developer, user, and
-          # assistant messages with one text part each; at most 128 messages and 8,192
-          # rendered tokens in total.
+          # assistant messages with one text part each; at most 128 messages and a
+          # configured rendered-token limit (8,192 by default).
           input: nil,
 
           # Frontend instructions for voice, conversation, interruptions, and when to
@@ -187,6 +202,12 @@ module OpenAI
           # to false for new sessions.
           store: nil,
 
+          # At most one Decisions trigger per transcript event type. Triggers run
+          # independently of delegation. On update, omit triggers to keep the current
+          # configuration, send a list to replace it, or send an empty list to disable
+          # triggers.
+          triggers: nil,
+
           # The status of the session snapshot. Always `active`, including the final
           # snapshot in session.closed; use the event type to determine that the session has
           # closed.
@@ -213,7 +234,8 @@ module OpenAI
                 )
               ],
               instructions: T.nilable(String),
-              store: T::Boolean
+              store: T::Boolean,
+              triggers: T::Array[OpenAI::Live::DecisionTrigger]
             }
           )
         end
@@ -387,12 +409,17 @@ module OpenAI
         end
 
         # Who handles tasks delegated by the Live model. Omitted or null selects your
-        # application; use `responses` to let the API manage a Responses backend.
+        # application; use `responses` or `decisions` to delegate to the corresponding
+        # API.
         module Delegation
           extend OpenAI::Internal::Type::Union
 
           Variants = T.type_alias {
-            T.any(OpenAI::Live::ClientDelegation, OpenAI::Live::SessionResource::Delegation::Responses)
+            T.any(
+              OpenAI::Live::ClientDelegation,
+              OpenAI::Live::SessionResource::Delegation::Responses,
+              OpenAI::Live::SessionResource::Delegation::Decisions
+            )
           }
 
           class Responses < OpenAI::Internal::Type::BaseModel
@@ -447,6 +474,50 @@ module OpenAI
 
           end
 
+          class Decisions < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Live::SessionResource::Delegation::Decisions,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            sig { returns(OpenAI::Live::DecisionsDelegationConfig) }
+            attr_reader :decisions
+
+            sig { params(decisions: OpenAI::Live::DecisionsDelegationConfig::OrHash).void }
+            attr_writer :decisions
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            sig do
+              params(
+
+                decisions: OpenAI::Live::DecisionsDelegationConfig::OrHash,
+
+                type: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              decisions:,
+
+              type: :decisions
+            )
+            end
+
+            sig do
+              override.returns(
+                {decisions: OpenAI::Live::DecisionsDelegationConfig, type: Symbol}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
           sig { override.returns(T::Array[OpenAI::Live::SessionResource::Delegation::Variants]) }
           def self.variants
           end

data/rbi/openai/models/live/session_update_config.rbi

@@ -18,22 +18,40 @@ module OpenAI
         # session; omitted settings retain their values.
         sig {
           returns(
-            T.nilable(T.any(OpenAI::Live::ClientDelegation, OpenAI::Live::SessionUpdateConfig::Delegation::Responses))
+            T.nilable(
+              T.any(
+                OpenAI::Live::ClientDelegation,
+                OpenAI::Live::SessionUpdateConfig::Delegation::Responses,
+                OpenAI::Live::SessionUpdateConfig::Delegation::Decisions
+              )
+            )
           )
         }
         attr_accessor :delegation
 
-        # Changes to an active Live session. Only delegation backend settings can be
-        # updated after startup.
+        # At most one Decisions trigger per transcript event type. Triggers run
+        # independently of delegation. On update, omit triggers to keep the current
+        # configuration, send a list to replace it, or send an empty list to disable
+        # triggers.
+        sig { returns(T.nilable(T::Array[OpenAI::Live::DecisionTrigger])) }
+        attr_reader :triggers
+
+        sig { params(triggers: T::Array[OpenAI::Live::DecisionTrigger::OrHash]).void }
+        attr_writer :triggers
+
+        # Changes to an active Live session's delegation settings and transcript triggers.
         sig do
           params(
 
             delegation: T.nilable(
               T.any(
                 OpenAI::Live::ClientDelegation::OrHash,
-                OpenAI::Live::SessionUpdateConfig::Delegation::Responses::OrHash
+                OpenAI::Live::SessionUpdateConfig::Delegation::Responses::OrHash,
+                OpenAI::Live::SessionUpdateConfig::Delegation::Decisions::OrHash
               )
-            )
+            ),
+
+            triggers: T::Array[OpenAI::Live::DecisionTrigger::OrHash]
           )
             .returns(T.attached_class)
         end
@@ -41,8 +59,14 @@ module OpenAI
 
           # Delegation settings to update. The delegation type must match the current
           # session; omitted settings retain their values.
+          delegation: nil,
+
+          # At most one Decisions trigger per transcript event type. Triggers run
+          # independently of delegation. On update, omit triggers to keep the current
+          # configuration, send a list to replace it, or send an empty list to disable
+          # triggers.
 
-          delegation: nil
+          triggers: nil
         )
         end
 
@@ -50,8 +74,13 @@ module OpenAI
           override.returns(
             {
               delegation: T.nilable(
-                T.any(OpenAI::Live::ClientDelegation, OpenAI::Live::SessionUpdateConfig::Delegation::Responses)
-              )
+                T.any(
+                  OpenAI::Live::ClientDelegation,
+                  OpenAI::Live::SessionUpdateConfig::Delegation::Responses,
+                  OpenAI::Live::SessionUpdateConfig::Delegation::Decisions
+                )
+              ),
+              triggers: T::Array[OpenAI::Live::DecisionTrigger]
             }
           )
         end
@@ -64,7 +93,11 @@ module OpenAI
           extend OpenAI::Internal::Type::Union
 
           Variants = T.type_alias {
-            T.any(OpenAI::Live::ClientDelegation, OpenAI::Live::SessionUpdateConfig::Delegation::Responses)
+            T.any(
+              OpenAI::Live::ClientDelegation,
+              OpenAI::Live::SessionUpdateConfig::Delegation::Responses,
+              OpenAI::Live::SessionUpdateConfig::Delegation::Decisions
+            )
           }
 
           class Responses < OpenAI::Internal::Type::BaseModel
@@ -120,6 +153,50 @@ module OpenAI
 
           end
 
+          class Decisions < OpenAI::Internal::Type::BaseModel
+            OrHash = T.type_alias do
+              T.any(
+                OpenAI::Live::SessionUpdateConfig::Delegation::Decisions,
+                OpenAI::Internal::AnyHash
+              )
+            end
+
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            sig { returns(T.nilable(OpenAI::Live::DecisionsDelegationUpdateConfig)) }
+            attr_reader :decisions
+
+            sig { params(decisions: OpenAI::Live::DecisionsDelegationUpdateConfig::OrHash).void }
+            attr_writer :decisions
+
+            sig do
+              params(
+
+                decisions: OpenAI::Live::DecisionsDelegationUpdateConfig::OrHash,
+
+                type: Symbol
+              )
+                .returns(T.attached_class)
+            end
+            def self.new(
+
+              decisions: nil,
+
+              type: :decisions
+            )
+            end
+
+            sig do
+              override.returns(
+                {type: Symbol, decisions: OpenAI::Live::DecisionsDelegationUpdateConfig}
+              )
+            end
+            def to_hash
+            end
+
+          end
+
           sig { override.returns(T::Array[OpenAI::Live::SessionUpdateConfig::Delegation::Variants]) }
           def self.variants
           end

data/rbi/openai/models/live/session_update_event.rbi

@@ -14,9 +14,9 @@ module OpenAI
           )
         end
 
-        # Sparse delegation updates. Omitted settings retain their values. The delegation
-        # type cannot change, including resetting Responses delegation to null or client.
-        # Model, frontend instructions, audio, and startup input are immutable.
+        # Sparse delegation and trigger updates. Omitted settings retain their values. The
+        # delegation type cannot change. Model, frontend instructions, audio, and startup
+        # input are immutable.
         sig { returns(OpenAI::Live::SessionUpdateConfig) }
         attr_reader :session
 
@@ -32,8 +32,8 @@ module OpenAI
         sig { returns(T.nilable(String)) }
         attr_accessor :event_id
 
-        # Update the delegation settings of an active Live session. The server
-        # acknowledges accepted changes with `session.updated`.
+        # Update the delegation settings or transcript triggers of an active Live session.
+        # The server acknowledges accepted changes with `session.updated`.
         sig do
           params(
 
@@ -47,9 +47,9 @@ module OpenAI
         end
         def self.new(
 
-          # Sparse delegation updates. Omitted settings retain their values. The delegation
-          # type cannot change, including resetting Responses delegation to null or client.
-          # Model, frontend instructions, audio, and startup input are immutable.
+          # Sparse delegation and trigger updates. Omitted settings retain their values. The
+          # delegation type cannot change. Model, frontend instructions, audio, and startup
+          # input are immutable.
           session:,
 
           # Optional client identifier for correlating this command with a server event's

data/rbi/openai/models/live/sideband_client_event.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Live
+
+      # Client events accepted by an attached Live sideband WebSocket. The session has
+      # already started. Send input audio over the primary connection.
+      module SidebandClientEvent
+        extend OpenAI::Internal::Type::Union
+
+        Variants = T.type_alias do
+          T.any(
+            OpenAI::Live::SessionUpdateEvent,
+            OpenAI::Live::InputAudioMuteEvent,
+            OpenAI::Live::InputAudioUnmuteEvent,
+            OpenAI::Live::OutputAudioFixturePlayEvent,
+            OpenAI::Live::InstructionsAppendEvent,
+            OpenAI::Live::ThinkingAppendEvent,
+            OpenAI::Live::CommentaryAppendEvent,
+            OpenAI::Live::DecisionCreateEvent,
+            OpenAI::Live::DecisionItemCreateEvent,
+            OpenAI::Live::DecisionItemDeleteEvent,
+            OpenAI::Live::ResponseItemCreateEvent,
+            OpenAI::Live::ResponseCreateEvent,
+            OpenAI::Live::SessionCloseEvent
+          )
+        end
+
+        sig { override.returns(T::Array[OpenAI::Live::SidebandClientEvent::Variants]) }
+        def self.variants
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/live/sideband_server_event.rbi

@@ -0,0 +1,47 @@
+# typed: strong
+
+module OpenAI
+  module Models
+
+    module Live
+
+      # Server events received by an attached Live sideband WebSocket. Audio deltas are
+      # delivered over the primary connection.
+      module SidebandServerEvent
+        extend OpenAI::Internal::Type::Union
+
+        Variants = T.type_alias do
+          T.any(
+            OpenAI::Live::SessionStartedEvent,
+            OpenAI::Live::SessionUpdatedEvent,
+            OpenAI::Live::InputAudioMutedEvent,
+            OpenAI::Live::InputAudioUnmutedEvent,
+            OpenAI::Live::OutputAudioFixturePlayingEvent,
+            OpenAI::Live::OutputAudioFixturePlayedEvent,
+            OpenAI::Live::InstructionsAppendedEvent,
+            OpenAI::Live::ThinkingAppendedEvent,
+            OpenAI::Live::CommentaryAppendedEvent,
+            OpenAI::Live::InputTranscriptDeltaEvent,
+            OpenAI::Live::OutputTranscriptDeltaEvent,
+            OpenAI::Live::DelegationCreatedEvent,
+            OpenAI::Live::DecisionEvent,
+            OpenAI::Live::DecisionItemCreatedEvent,
+            OpenAI::Live::DecisionItemDeletedEvent,
+            OpenAI::Live::ResponseEvent,
+            OpenAI::Live::SessionUsageUpdatedEvent,
+            OpenAI::Live::SessionClosedEvent,
+            OpenAI::Live::ErrorEvent,
+            OpenAI::Live::InfoEvent
+          )
+        end
+
+        sig { override.returns(T::Array[OpenAI::Live::SidebandServerEvent::Variants]) }
+        def self.variants
+        end
+
+      end
+
+    end
+
+  end
+end

data/rbi/openai/models/realtime/realtime_audio_config_output.rbi

@@ -58,7 +58,8 @@ module OpenAI
         # `cedar`. You may also provide a custom voice object with an `id`, for example
         # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
         # model has responded with audio at least once. Custom voices must be created from
-        # audio samples. We recommend `marin` and `cedar` for best quality.
+        # audio samples. Voices created from text prompts are supported only in Live. We
+        # recommend `marin` and `cedar` for best quality.
         sig {
           returns(
             T.nilable(
@@ -122,7 +123,8 @@ module OpenAI
           # `cedar`. You may also provide a custom voice object with an `id`, for example
           # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
           # model has responded with audio at least once. Custom voices must be created from
-          # audio samples. We recommend `marin` and `cedar` for best quality.
+          # audio samples. Voices created from text prompts are supported only in Live. We
+          # recommend `marin` and `cedar` for best quality.
 
           voice: nil
         )
@@ -153,7 +155,8 @@ module OpenAI
         # `cedar`. You may also provide a custom voice object with an `id`, for example
         # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
         # model has responded with audio at least once. Custom voices must be created from
-        # audio samples. We recommend `marin` and `cedar` for best quality.
+        # audio samples. Voices created from text prompts are supported only in Live. We
+        # recommend `marin` and `cedar` for best quality.
         module Voice
           extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/realtime/realtime_response_create_audio_output.rbi

@@ -81,7 +81,8 @@ module OpenAI
           # `cedar`. You may also provide a custom voice object with an `id`, for example
           # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
           # model has responded with audio at least once. Custom voices must be created from
-          # audio samples. We recommend `marin` and `cedar` for best quality.
+          # audio samples. Voices created from text prompts are supported only in Live. We
+          # recommend `marin` and `cedar` for best quality.
           sig {
             returns(
               T.nilable(
@@ -134,7 +135,8 @@ module OpenAI
             # `cedar`. You may also provide a custom voice object with an `id`, for example
             # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
             # model has responded with audio at least once. Custom voices must be created from
-            # audio samples. We recommend `marin` and `cedar` for best quality.
+            # audio samples. Voices created from text prompts are supported only in Live. We
+            # recommend `marin` and `cedar` for best quality.
 
             voice: nil
           )
@@ -164,7 +166,8 @@ module OpenAI
           # `cedar`. You may also provide a custom voice object with an `id`, for example
           # `{ "id": "voice_1234" }`. Voice cannot be changed during the session once the
           # model has responded with audio at least once. Custom voices must be created from
-          # audio samples. We recommend `marin` and `cedar` for best quality.
+          # audio samples. Voices created from text prompts are supported only in Live. We
+          # recommend `marin` and `cedar` for best quality.
           module Voice
             extend OpenAI::Internal::Type::Union
 

data/rbi/openai/models/realtime/realtime_response_status.rbi

@@ -100,6 +100,13 @@ module OpenAI
           sig { params(code: String).void }
           attr_writer :code
 
+          # A human-readable error message.
+          sig { returns(T.nilable(String)) }
+          attr_reader :message
+
+          sig { params(message: String).void }
+          attr_writer :message
+
           # The type of error.
           sig { returns(T.nilable(String)) }
           attr_reader :type
@@ -114,6 +121,8 @@ module OpenAI
 
               code: String,
 
+              message: String,
+
               type: String
             )
               .returns(T.attached_class)
@@ -123,6 +132,9 @@ module OpenAI
             # Error code, if any.
             code: nil,
 
+            # A human-readable error message.
+            message: nil,
+
             # The type of error.
 
             type: nil
@@ -131,7 +143,7 @@ module OpenAI
 
           sig do
             override.returns(
-              {code: String, type: String}
+              {code: String, message: String, type: String}
             )
           end
           def to_hash

data/rbi/openai/models/realtime/realtime_translation_input_audio_buffer_append_event.rbi

@@ -72,7 +72,7 @@ module OpenAI
 
         sig do
           override.returns(
-            {audio: String, type: Symbol, event_id: String}
+            {audio: String, type: Symbol, event_id: T.nilable(String)}
           )
         end
         def to_hash

data/rbi/openai/models/realtime/realtime_translation_output_audio_delta_event.rbi

@@ -109,10 +109,10 @@ module OpenAI
               delta: String,
               event_id: String,
               type: Symbol,
-              channels: Integer,
+              channels: T.nilable(Integer),
               elapsed_ms: T.nilable(Integer),
-              format_: OpenAI::Realtime::RealtimeTranslationOutputAudioDeltaEvent::Format::OrSymbol,
-              sample_rate: Integer
+              format_: T.nilable(OpenAI::Realtime::RealtimeTranslationOutputAudioDeltaEvent::Format::OrSymbol),
+              sample_rate: T.nilable(Integer)
             }
           )
         end

data/rbi/openai/models/realtime/realtime_translation_session_close_event.rbi

@@ -50,7 +50,7 @@ module OpenAI
 
         sig do
           override.returns(
-            {type: Symbol, event_id: String}
+            {type: Symbol, event_id: T.nilable(String)}
           )
         end
         def to_hash

data/rbi/openai/models/realtime/realtime_translation_session_update_event.rbi

@@ -64,7 +64,11 @@ module OpenAI
 
         sig do
           override.returns(
-            {session: OpenAI::Realtime::RealtimeTranslationSessionUpdateRequest, type: Symbol, event_id: String}
+            {
+              session: OpenAI::Realtime::RealtimeTranslationSessionUpdateRequest,
+              type: Symbol,
+              event_id: T.nilable(String)
+            }
           )
         end
         def to_hash

data/rbi/openai/models/responses/response.rbi

@@ -81,11 +81,6 @@ module OpenAI
         sig { returns(T::Array[OpenAI::Responses::ResponseOutputItem::Variants]) }
         attr_accessor :output
 
-        # Concatenates text from all output messages.
-        sig { returns(String) }
-        def output_text
-        end
-
         # Whether to allow the model to run tool calls in parallel.
         sig { returns(T::Boolean) }
         attr_accessor :parallel_tool_calls
@@ -249,7 +244,7 @@ module OpenAI
 
         # A stable identifier used to help detect users of your application that may be
         # violating OpenAI's usage policies. The IDs should be a string that uniquely
-        # identifies each user, with a maximum length of 64 characters. We recommend
+        # identifies each user, with a maximum length of 128 characters. We recommend
         # hashing their username or email address, in order to avoid sending us any
         # identifying information.
         # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -645,7 +640,7 @@ module OpenAI
 
           # A stable identifier used to help detect users of your application that may be
           # violating OpenAI's usage policies. The IDs should be a string that uniquely
-          # identifies each user, with a maximum length of 64 characters. We recommend
+          # identifies each user, with a maximum length of 128 characters. We recommend
           # hashing their username or email address, in order to avoid sending us any
           # identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).

data/rbi/openai/models/responses/response_create_params.rbi

@@ -203,7 +203,7 @@ module OpenAI
 
         # A stable identifier used to help detect users of your application that may be
         # violating OpenAI's usage policies. The IDs should be a string that uniquely
-        # identifies each user, with a maximum length of 64 characters. We recommend
+        # identifies each user, with a maximum length of 128 characters. We recommend
         # hashing their username or email address, in order to avoid sending us any
         # identifying information.
         # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
@@ -268,16 +268,12 @@ module OpenAI
         sig { returns(T.nilable(OpenAI::Responses::ResponseTextConfig)) }
         attr_reader :text
 
-        sig do
+        sig {
           params(
-            text: T.any(
-              OpenAI::Responses::ResponseTextConfig::OrHash,
-              OpenAI::StructuredOutput::JsonSchemaConverter
-            )
+            text: T.any(OpenAI::Responses::ResponseTextConfig::OrHash, OpenAI::StructuredOutput::JsonSchemaConverter)
           )
             .void
-        end
-
+        }
         attr_writer :text
 
         # How the model should select which tool (or tools) to use when generating a
@@ -667,7 +663,7 @@ module OpenAI
 
           # A stable identifier used to help detect users of your application that may be
           # violating OpenAI's usage policies. The IDs should be a string that uniquely
-          # identifies each user, with a maximum length of 64 characters. We recommend
+          # identifies each user, with a maximum length of 128 characters. We recommend
           # hashing their username or email address, in order to avoid sending us any
           # identifying information.
           # [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).