openai 0.87.0 → 0.89.0

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

@@ -0,0 +1,257 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      # @see OpenAI::Resources::Live::Sessions#accept
+      class SessionAcceptParams < OpenAI::Internal::Type::BaseModel
+        extend OpenAI::Internal::Type::RequestParameters::Converter
+        include OpenAI::Internal::Type::RequestParameters
+
+        # @!attribute session_id
+        #
+        #   @return [String]
+        required :session_id, String
+
+        # @!attribute session
+        #   Model and startup configuration for the Live session that answers the incoming
+        #   SIP call.
+        #
+        #   @return [OpenAI::Models::Live::SessionAcceptParams::Session]
+        required :session, -> { OpenAI::Live::SessionAcceptParams::Session }
+
+        # @!method initialize(session_id:, session:, request_options: {})
+        #   @param session_id [String]
+        #
+        #   @param session [OpenAI::Models::Live::SessionAcceptParams::Session]
+        #     Model and startup configuration for the Live session that answers the incoming
+        #     SIP call.
+        #
+        #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+
+        class Session < OpenAI::Internal::Type::BaseModel
+          # @!attribute model
+          #   The Live model to use for the accepted call.
+          #
+          #   @return [String, Symbol, OpenAI::Models::Live::SessionAcceptParams::Session::Model]
+          required :model, union: -> { OpenAI::Live::SessionAcceptParams::Session::Model }
+
+          # @!attribute type
+          #   The session type. Always `live`.
+          #
+          #   @return [Symbol, :live]
+          required :type, const: :live
+
+          # @!attribute audio
+          #   Startup audio output configuration. SIP negotiates the media format;
+          #   audio.format is only accepted for primary WebSockets. Voice cannot change after
+          #   startup.
+          #
+          #   @return [OpenAI::Models::Live::SessionAcceptParams::Session::Audio, nil]
+          optional :audio, -> { OpenAI::Live::SessionAcceptParams::Session::Audio }
+
+          # @!attribute delegation
+          #   Who handles tasks delegated by the Live model. Omitted or null selects your
+          #   application; use `responses` to let the API manage a Responses backend.
+          #
+          #   @return [OpenAI::Models::Live::ClientDelegation, OpenAI::Models::Live::SessionAcceptParams::Session::Delegation::Responses, nil]
+          optional(
+            :delegation,
+            union: -> {
+              OpenAI::Live::SessionAcceptParams::Session::Delegation
+            },
+            nil?: true
+          )
+
+          # @!attribute input
+          #   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.
+          #
+          #   @return [Array<OpenAI::Models::Live::InitialItem::Developer, OpenAI::Models::Live::InitialItem::User, OpenAI::Models::Live::InitialItem::Assistant>, nil]
+          optional :input, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Live::InitialItem] }
+
+          # @!attribute instructions
+          #   Frontend instructions for voice, conversation, interruptions, and when to
+          #   delegate. Start with the
+          #   [Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting);
+          #   put business rules and tool workflows in a separate
+          #   [backend prompt](https://developers.openai.com/api/docs/guides/live-delegation#start-with-your-existing-backend-prompt).
+          #   Limited to 16,384 client-supplied tokens. Omitted or blank instructions use
+          #   server defaults. Immutable after startup.
+          #
+          #   @return [String, nil]
+          optional :instructions, String, nil?: true
+
+          # @!attribute store
+          #   Whether to store the session for later forking and recording download. Defaults
+          #   to false for new sessions.
+          #
+          #   @return [Boolean, nil]
+          optional :store, OpenAI::Internal::Type::Boolean
+
+          # @!method initialize(model:, audio: nil, delegation: nil, input: nil, instructions: nil, store: nil, type: :live)
+          #   Model and startup configuration for the Live session that answers the incoming
+          #   SIP call.
+          #
+          #   @param model [String, Symbol, OpenAI::Models::Live::SessionAcceptParams::Session::Model]
+          #     The Live model to use for the accepted call.
+          #
+          #   @param audio [OpenAI::Models::Live::SessionAcceptParams::Session::Audio]
+          #     Startup audio output configuration. SIP negotiates the media format;
+          #     audio.format is only accepted for primary WebSockets. Voice cannot change after
+          #     startup.
+          #
+          #   @param delegation [OpenAI::Models::Live::ClientDelegation, OpenAI::Models::Live::SessionAcceptParams::Session::Delegation::Responses, 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.
+          #
+          #   @param input [Array<OpenAI::Models::Live::InitialItem::Developer, OpenAI::Models::Live::InitialItem::User, OpenAI::Models::Live::InitialItem::Assistant>]
+          #     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.
+          #
+          #   @param instructions [String, nil]
+          #     Frontend instructions for voice, conversation, interruptions, and when to
+          #     delegate. Start with the
+          #     [Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting);
+          #     put business rules and tool workflows in a separate
+          #     [backend prompt](https://developers.openai.com/api/docs/guides/live-delegation#start-with-your-existing-backend-prompt).
+          #     Limited to 16,384 client-supplied tokens. Omitted or blank instructions use
+          #     server defaults. Immutable after startup.
+          #
+          #   @param store [Boolean]
+          #     Whether to store the session for later forking and recording download. Defaults
+          #     to false for new sessions.
+          #
+          #   @param type [Symbol, :live]
+          #     The session type. Always `live`.
+
+          # The Live model to use for the accepted call.
+          #
+          # @see OpenAI::Models::Live::SessionAcceptParams::Session#model
+          module Model
+            extend OpenAI::Internal::Type::Union
+
+            variant String
+
+            # The Live model. Required in the session configuration for every transport; do not pass it as a URL query parameter.
+            variant const: -> { OpenAI::Models::Live::SessionAcceptParams::Session::Model::GPT_LIVE_1 }
+
+            # @!method self.variants
+            #   @return [Array(String, Symbol)]
+
+            define_sorbet_constant!(:Variants) do
+              T.type_alias { T.any(String, OpenAI::Live::SessionAcceptParams::Session::Model::TaggedSymbol) }
+            end
+
+            # @!group
+
+            GPT_LIVE_1 = :"gpt-live-1"
+
+            # @!endgroup
+          end
+
+          # @see OpenAI::Models::Live::SessionAcceptParams::Session#audio
+          class Audio < OpenAI::Internal::Type::BaseModel
+            # @!attribute output
+            #   Settings for speech generated by the Live model. Choose the voice before
+            #   starting the session.
+            #
+            #   @return [OpenAI::Models::Live::SessionAcceptParams::Session::Audio::Output, nil]
+            optional :output, -> { OpenAI::Live::SessionAcceptParams::Session::Audio::Output }
+
+            # @!method initialize(output: nil)
+            #   Startup audio output configuration. SIP negotiates the media format;
+            #   audio.format is only accepted for primary WebSockets. Voice cannot change after
+            #   startup.
+            #
+            #   @param output [OpenAI::Models::Live::SessionAcceptParams::Session::Audio::Output]
+            #     Settings for speech generated by the Live model. Choose the voice before
+            #     starting the session.
+
+            # @see OpenAI::Models::Live::SessionAcceptParams::Session::Audio#output
+            class Output < OpenAI::Internal::Type::BaseModel
+              # @!attribute voice
+              #   The voice used for Live speech, as a built-in voice name or a custom voice
+              #   object containing its ID. Defaults to `marin` and cannot change after startup.
+              #
+              #   @return [String, Symbol, OpenAI::Models::Live::BuiltInVoice, OpenAI::Models::Live::CustomVoice, nil]
+              optional :voice, union: -> { OpenAI::Live::SessionAcceptParams::Session::Audio::Output::Voice }
+
+              # @!method initialize(voice: nil)
+              #   Settings for speech generated by the Live model. Choose the voice before
+              #   starting the session.
+              #
+              #   @param voice [String, Symbol, OpenAI::Models::Live::BuiltInVoice, OpenAI::Models::Live::CustomVoice]
+              #     The voice used for Live speech, as a built-in voice name or a custom voice
+              #     object containing its ID. Defaults to `marin` and cannot change after startup.
+
+              # The voice used for Live speech, as a built-in voice name or a custom voice
+              # object containing its ID. Defaults to `marin` and cannot change after startup.
+              #
+              # @see OpenAI::Models::Live::SessionAcceptParams::Session::Audio::Output#voice
+              module Voice
+                extend OpenAI::Internal::Type::Union
+
+                variant String
+
+                # A built-in voice available for Live speech.
+                variant enum: -> { OpenAI::Live::BuiltInVoice }
+
+                variant -> { OpenAI::Live::CustomVoice }
+
+                # @!method self.variants
+                #   @return [Array(String, Symbol, OpenAI::Models::Live::BuiltInVoice, OpenAI::Models::Live::CustomVoice)]
+              end
+            end
+          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.
+          #
+          # @see OpenAI::Models::Live::SessionAcceptParams::Session#delegation
+          module Delegation
+            extend OpenAI::Internal::Type::Union
+
+            discriminator :type
+
+            # Delegate tasks to your application. The Live session emits delegation events that your backend handles.
+            variant :client, -> { OpenAI::Live::ClientDelegation }
+
+            # Delegate tasks to a Responses model managed by the Live session.
+            variant :responses, -> { OpenAI::Live::SessionAcceptParams::Session::Delegation::Responses }
+
+            class Responses < OpenAI::Internal::Type::BaseModel
+              # @!attribute responses
+              #   Backend model, prompt, and tools used when the Live session delegates a task to
+              #   Responses.
+              #
+              #   @return [OpenAI::Models::Live::ResponsesDelegationConfig]
+              required :responses, -> { OpenAI::Live::ResponsesDelegationConfig }
+
+              # @!attribute type
+              #   The delegation owner. Always `responses` for tasks handled by the Responses API.
+              #
+              #   @return [Symbol, :responses]
+              required :type, const: :responses
+
+              # @!method initialize(responses:, type: :responses)
+              #   Delegate tasks to a Responses model managed by the Live session.
+              #
+              #   @param responses [OpenAI::Models::Live::ResponsesDelegationConfig]
+              #     Backend model, prompt, and tools used when the Live session delegates a task to
+              #     Responses.
+              #
+              #   @param type [Symbol, :responses]
+              #     The delegation owner. Always `responses` for tasks handled by the Responses API.
+            end
+
+            # @!method self.variants
+            #   @return [Array(OpenAI::Models::Live::ClientDelegation, OpenAI::Models::Live::SessionAcceptParams::Session::Delegation::Responses)]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class SessionCloseEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute type
+        #   The Live client event type. Always `session.close`.
+        #
+        #   @return [Symbol, :"session.close"]
+        required :type, const: :"session.close"
+
+        # @!attribute event_id
+        #   Optional client identifier for correlating this command with a server event's
+        #   client_event_id or error.client_event_id.
+        #
+        #   @return [String, nil]
+        optional :event_id, String, nil?: true
+
+        # @!method initialize(event_id: nil, type: :"session.close")
+        #   Request that the Live session close. The terminal `session.closed` event
+        #   contains the close reason and final usage.
+        #
+        #   @param event_id [String, nil]
+        #     Optional client identifier for correlating this command with a server event's
+        #     client_event_id or error.client_event_id.
+        #
+        #   @param type [Symbol, :"session.close"]
+        #     The Live client event type. Always `session.close`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class SessionClosedEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute event_id
+        #   The unique ID of the Live server event.
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute reason
+        #   Why the Live session ended: `close_requested` for an application close or hangup
+        #   request, `expired` for the session duration limit, `content` for a safety
+        #   filter, `remote_hangup` for a graceful remote disconnect, or `connection_lost`
+        #   for an unexpected primary or upstream disconnection.
+        #
+        #   @return [Symbol, OpenAI::Models::Live::SessionClosedEvent::Reason]
+        required :reason, union: -> { OpenAI::Live::SessionClosedEvent::Reason }
+
+        # @!attribute session
+        #   The resolved Live session configuration and server-assigned session metadata.
+        #
+        #   @return [OpenAI::Models::Live::SessionResource]
+        required :session, -> { OpenAI::Live::SessionResource }
+
+        # @!attribute type
+        #   The event type, always `session.closed`.
+        #
+        #   @return [Symbol, :"session.closed"]
+        required :type, const: :"session.closed"
+
+        # @!attribute usage
+        #   The final cumulative Live audio usage after session finalization.
+        #
+        #   @return [OpenAI::Models::Live::SessionUsage]
+        required :usage, -> { OpenAI::Live::SessionUsage }
+
+        # @!attribute client_event_id
+        #   The event_id of the client command associated with this server event, when
+        #   supplied.
+        #
+        #   @return [String, nil]
+        optional :client_event_id, String
+
+        # @!method initialize(event_id:, reason:, session:, usage:, client_event_id: nil, type: :"session.closed")
+        #   Returned after the Live session finishes finalizing, with the close reason,
+        #   final session snapshot, and cumulative audio usage. A connection closing without
+        #   this event does not confirm successful finalization.
+        #
+        #   @param event_id [String]
+        #     The unique ID of the Live server event.
+        #
+        #   @param reason [Symbol, OpenAI::Models::Live::SessionClosedEvent::Reason]
+        #     Why the Live session ended: `close_requested` for an application close or hangup
+        #     request, `expired` for the session duration limit, `content` for a safety
+        #     filter, `remote_hangup` for a graceful remote disconnect, or `connection_lost`
+        #     for an unexpected primary or upstream disconnection.
+        #
+        #   @param session [OpenAI::Models::Live::SessionResource]
+        #     The resolved Live session configuration and server-assigned session metadata.
+        #
+        #   @param usage [OpenAI::Models::Live::SessionUsage]
+        #     The final cumulative Live audio usage after session finalization.
+        #
+        #   @param client_event_id [String]
+        #     The event_id of the client command associated with this server event, when
+        #     supplied.
+        #
+        #   @param type [Symbol, :"session.closed"]
+        #     The event type, always `session.closed`.
+
+        # Why the Live session ended: `close_requested` for an application close or hangup
+        # request, `expired` for the session duration limit, `content` for a safety
+        # filter, `remote_hangup` for a graceful remote disconnect, or `connection_lost`
+        # for an unexpected primary or upstream disconnection.
+        #
+        # @see OpenAI::Models::Live::SessionClosedEvent#reason
+        module Reason
+          extend OpenAI::Internal::Type::Union
+
+          variant const: -> { OpenAI::Models::Live::SessionClosedEvent::Reason::CLOSE_REQUESTED }
+
+          variant const: -> { OpenAI::Models::Live::SessionClosedEvent::Reason::EXPIRED }
+
+          variant const: -> { OpenAI::Models::Live::SessionClosedEvent::Reason::CONTENT }
+
+          variant const: -> { OpenAI::Models::Live::SessionClosedEvent::Reason::REMOTE_HANGUP }
+
+          variant const: -> { OpenAI::Models::Live::SessionClosedEvent::Reason::CONNECTION_LOST }
+
+          # @!method self.variants
+          #   @return [Array(Symbol)]
+
+          define_sorbet_constant!(:Variants) do
+            T.type_alias { OpenAI::Live::SessionClosedEvent::Reason::TaggedSymbol }
+          end
+
+          # @!group
+
+          CLOSE_REQUESTED = :close_requested
+          EXPIRED = :expired
+          CONTENT = :content
+          REMOTE_HANGUP = :remote_hangup
+          CONNECTION_LOST = :connection_lost
+
+          # @!endgroup
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,236 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class SessionConfig < OpenAI::Internal::Type::BaseModel
+        # @!attribute model
+        #   The Live model. Required in the session configuration for every transport; do
+        #   not pass it as a URL query parameter.
+        #
+        #   @return [String, Symbol, OpenAI::Models::Live::SessionConfig::Model]
+        required :model, union: -> { OpenAI::Live::SessionConfig::Model }
+
+        # @!attribute audio
+        #   Startup audio configuration. Only primary WebSockets accept audio.format; WebRTC
+        #   and SIP negotiate their media format. Voice and format are immutable after
+        #   startup.
+        #
+        #   @return [OpenAI::Models::Live::SessionConfig::Audio, nil]
+        optional :audio, -> { OpenAI::Live::SessionConfig::Audio }
+
+        # @!attribute client
+        #   Startup-only capabilities for an untrusted frontend attached to a unified WebRTC
+        #   session. Trusted sideband connections are unaffected.
+        #
+        #   @return [OpenAI::Models::Live::ClientConfig, nil]
+        optional :client, -> { OpenAI::Live::ClientConfig }
+
+        # @!attribute delegation
+        #   Who handles tasks delegated by the Live model. Omitted or null selects your
+        #   application; use `responses` to let the API manage a Responses backend.
+        #
+        #   @return [OpenAI::Models::Live::ClientDelegation, OpenAI::Models::Live::SessionConfig::Delegation::Responses, nil]
+        optional :delegation, union: -> { OpenAI::Live::SessionConfig::Delegation }, nil?: true
+
+        # @!attribute input
+        #   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.
+        #
+        #   @return [Array<OpenAI::Models::Live::InitialItem::Developer, OpenAI::Models::Live::InitialItem::User, OpenAI::Models::Live::InitialItem::Assistant>, nil]
+        optional :input, -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Live::InitialItem] }
+
+        # @!attribute instructions
+        #   Frontend instructions for voice, conversation, interruptions, and when to
+        #   delegate. Start with the
+        #   [Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting);
+        #   put business rules and tool workflows in a separate
+        #   [backend prompt](https://developers.openai.com/api/docs/guides/live-delegation#start-with-your-existing-backend-prompt).
+        #   Limited to 16,384 client-supplied tokens. Omitted or blank instructions use
+        #   server defaults. Immutable after startup.
+        #
+        #   @return [String, nil]
+        optional :instructions, String, nil?: true
+
+        # @!attribute store
+        #   Whether to store the session for later forking and recording download. Defaults
+        #   to false for new sessions.
+        #
+        #   @return [Boolean, nil]
+        optional :store, OpenAI::Internal::Type::Boolean
+
+        # @!method initialize(model:, audio: nil, client: nil, delegation: nil, input: nil, instructions: nil, store: nil)
+        #   Initial configuration for a Live session, including its model, conversation
+        #   instructions, audio, and delegated task handling.
+        #
+        #   @param model [String, Symbol, OpenAI::Models::Live::SessionConfig::Model]
+        #     The Live model. Required in the session configuration for every transport; do
+        #     not pass it as a URL query parameter.
+        #
+        #   @param audio [OpenAI::Models::Live::SessionConfig::Audio]
+        #     Startup audio configuration. Only primary WebSockets accept audio.format; WebRTC
+        #     and SIP negotiate their media format. Voice and format are immutable after
+        #     startup.
+        #
+        #   @param client [OpenAI::Models::Live::ClientConfig]
+        #     Startup-only capabilities for an untrusted frontend attached to a unified WebRTC
+        #     session. Trusted sideband connections are unaffected.
+        #
+        #   @param delegation [OpenAI::Models::Live::ClientDelegation, OpenAI::Models::Live::SessionConfig::Delegation::Responses, 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.
+        #
+        #   @param input [Array<OpenAI::Models::Live::InitialItem::Developer, OpenAI::Models::Live::InitialItem::User, OpenAI::Models::Live::InitialItem::Assistant>]
+        #     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.
+        #
+        #   @param instructions [String, nil]
+        #     Frontend instructions for voice, conversation, interruptions, and when to
+        #     delegate. Start with the
+        #     [Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting);
+        #     put business rules and tool workflows in a separate
+        #     [backend prompt](https://developers.openai.com/api/docs/guides/live-delegation#start-with-your-existing-backend-prompt).
+        #     Limited to 16,384 client-supplied tokens. Omitted or blank instructions use
+        #     server defaults. Immutable after startup.
+        #
+        #   @param store [Boolean]
+        #     Whether to store the session for later forking and recording download. Defaults
+        #     to false for new sessions.
+
+        # The Live model. Required in the session configuration for every transport; do
+        # not pass it as a URL query parameter.
+        #
+        # @see OpenAI::Models::Live::SessionConfig#model
+        module Model
+          extend OpenAI::Internal::Type::Union
+
+          variant String
+
+          variant const: -> { OpenAI::Models::Live::SessionConfig::Model::GPT_LIVE_1 }
+
+          # @!method self.variants
+          #   @return [Array(String, Symbol)]
+
+          define_sorbet_constant!(:Variants) do
+            T.type_alias { T.any(String, OpenAI::Live::SessionConfig::Model::TaggedSymbol) }
+          end
+
+          # @!group
+
+          GPT_LIVE_1 = :"gpt-live-1"
+
+          # @!endgroup
+        end
+
+        # @see OpenAI::Models::Live::SessionConfig#audio
+        class Audio < OpenAI::Internal::Type::BaseModel
+          # @!attribute format_
+          #   Audio encoding and sample rate for audio sent and received over a Live WebSocket
+          #   connection. WebRTC and SIP negotiate their media format separately.
+          #
+          #   @return [OpenAI::Models::Live::AudioFormat::AudioPCM, OpenAI::Models::Live::AudioFormat::AudioPCMU, OpenAI::Models::Live::AudioFormat::AudioPCMA, nil]
+          optional :format_, union: -> { OpenAI::Live::AudioFormat }, api_name: :format
+
+          # @!attribute output
+          #   The voice used for speech generated by the Live model.
+          #
+          #   @return [OpenAI::Models::Live::SessionConfig::Audio::Output, nil]
+          optional :output, -> { OpenAI::Live::SessionConfig::Audio::Output }
+
+          # @!method initialize(format_: nil, output: nil)
+          #   Startup audio configuration. Only primary WebSockets accept audio.format; WebRTC
+          #   and SIP negotiate their media format. Voice and format are immutable after
+          #   startup.
+          #
+          #   @param format_ [OpenAI::Models::Live::AudioFormat::AudioPCM, OpenAI::Models::Live::AudioFormat::AudioPCMU, OpenAI::Models::Live::AudioFormat::AudioPCMA]
+          #     Audio encoding and sample rate for audio sent and received over a Live WebSocket
+          #     connection. WebRTC and SIP negotiate their media format separately.
+          #
+          #   @param output [OpenAI::Models::Live::SessionConfig::Audio::Output]
+          #     The voice used for speech generated by the Live model.
+
+          # @see OpenAI::Models::Live::SessionConfig::Audio#output
+          class Output < OpenAI::Internal::Type::BaseModel
+            # @!attribute voice
+            #   The voice used for Live speech, as a built-in voice name or a custom voice
+            #   object containing its ID. Defaults to `marin` and cannot change after startup.
+            #
+            #   @return [String, Symbol, OpenAI::Models::Live::BuiltInVoice, OpenAI::Models::Live::CustomVoice, nil]
+            optional :voice, union: -> { OpenAI::Live::SessionConfig::Audio::Output::Voice }
+
+            # @!method initialize(voice: nil)
+            #   The voice used for speech generated by the Live model.
+            #
+            #   @param voice [String, Symbol, OpenAI::Models::Live::BuiltInVoice, OpenAI::Models::Live::CustomVoice]
+            #     The voice used for Live speech, as a built-in voice name or a custom voice
+            #     object containing its ID. Defaults to `marin` and cannot change after startup.
+
+            # The voice used for Live speech, as a built-in voice name or a custom voice
+            # object containing its ID. Defaults to `marin` and cannot change after startup.
+            #
+            # @see OpenAI::Models::Live::SessionConfig::Audio::Output#voice
+            module Voice
+              extend OpenAI::Internal::Type::Union
+
+              variant String
+
+              # A built-in voice available for Live speech.
+              variant enum: -> { OpenAI::Live::BuiltInVoice }
+
+              variant -> { OpenAI::Live::CustomVoice }
+
+              # @!method self.variants
+              #   @return [Array(String, Symbol, OpenAI::Models::Live::BuiltInVoice, OpenAI::Models::Live::CustomVoice)]
+            end
+          end
+        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.
+        #
+        # @see OpenAI::Models::Live::SessionConfig#delegation
+        module Delegation
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          # Delegate tasks to your application. The Live session emits delegation events that your backend handles.
+          variant :client, -> { OpenAI::Live::ClientDelegation }
+
+          # Delegate tasks to a Responses model managed by the Live session.
+          variant :responses, -> { OpenAI::Live::SessionConfig::Delegation::Responses }
+
+          class Responses < OpenAI::Internal::Type::BaseModel
+            # @!attribute responses
+            #   Backend model, prompt, and tools used when the Live session delegates a task to
+            #   Responses.
+            #
+            #   @return [OpenAI::Models::Live::ResponsesDelegationConfig]
+            required :responses, -> { OpenAI::Live::ResponsesDelegationConfig }
+
+            # @!attribute type
+            #   The delegation owner. Always `responses` for tasks handled by the Responses API.
+            #
+            #   @return [Symbol, :responses]
+            required :type, const: :responses
+
+            # @!method initialize(responses:, type: :responses)
+            #   Delegate tasks to a Responses model managed by the Live session.
+            #
+            #   @param responses [OpenAI::Models::Live::ResponsesDelegationConfig]
+            #     Backend model, prompt, and tools used when the Live session delegates a task to
+            #     Responses.
+            #
+            #   @param type [Symbol, :responses]
+            #     The delegation owner. Always `responses` for tasks handled by the Responses API.
+          end
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Live::ClientDelegation, OpenAI::Models::Live::SessionConfig::Delegation::Responses)]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      # @see OpenAI::Resources::Live::Sessions#download_recording
+      class SessionDownloadRecordingParams < OpenAI::Internal::Type::BaseModel
+        extend OpenAI::Internal::Type::RequestParameters::Converter
+        include OpenAI::Internal::Type::RequestParameters
+
+        # @!attribute session_id
+        #   The ID of the stored Live session to download. Use the session ID returned when
+        #   the session started with storage enabled.
+        #
+        #   @return [String]
+        required :session_id, String
+
+        # @!method initialize(session_id:, request_options: {})
+        #   @param session_id [String]
+        #     The ID of the stored Live session to download. Use the session ID returned when
+        #     the session started with storage enabled.
+        #
+        #   @param request_options [OpenAI::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end