openai 0.88.0 → 0.89.0

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

@@ -0,0 +1,332 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class ResponsesDelegationUpdateConfig < OpenAI::Internal::Type::BaseModel
+        # @!attribute instructions
+        #   Instructions for the delegated Responses model, separate from Live instructions.
+        #   See
+        #   [backend prompting](https://developers.openai.com/api/docs/guides/live-delegation#start-with-your-existing-backend-prompt).
+        #
+        #   @return [String, nil]
+        optional :instructions, String, nil?: true
+
+        # @!attribute max_output_tokens
+        #   Maximum number of output tokens for each delegated response.
+        #
+        #   @return [Integer, nil]
+        optional :max_output_tokens, Integer, nil?: true
+
+        # @!attribute model
+        #   The Responses backend model to use for subsequent delegated requests. Omit to
+        #   keep the current backend model.
+        #
+        #   @return [String, nil]
+        optional :model, String
+
+        # @!attribute parallel_tool_calls
+        #   Whether the delegated Responses model may request multiple tool calls in a
+        #   single response.
+        #
+        #   @return [Boolean, nil]
+        optional :parallel_tool_calls, OpenAI::Internal::Type::Boolean, nil?: true
+
+        # @!attribute reasoning
+        #   Reasoning settings passed to each delegated Responses request.
+        #
+        #   @return [OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Reasoning, nil]
+        optional :reasoning, -> { OpenAI::Live::ResponsesDelegationUpdateConfig::Reasoning }, nil?: true
+
+        # @!attribute service_tier
+        #   Service tier for delegated Responses requests.
+        #
+        #   @return [Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ServiceTier, nil]
+        optional(
+          :service_tier,
+          enum: -> { OpenAI::Live::ResponsesDelegationUpdateConfig::ServiceTier },
+          nil?: true
+        )
+
+        # @!attribute text
+        #   Text generation settings passed to each delegated Responses request.
+        #
+        #   @return [OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Text, nil]
+        optional :text, -> { OpenAI::Live::ResponsesDelegationUpdateConfig::Text }, nil?: true
+
+        # @!attribute tool_choice
+        #   Controls which tool the Responses backend uses when handling a task delegated by
+        #   the Live model.
+        #
+        #   @return [Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveToolChoiceEnum, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveFunctionToolChoiceParam, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveMCPToolChoiceParam, nil]
+        optional :tool_choice, union: -> { OpenAI::Live::ResponsesDelegationUpdateConfig::ToolChoice }
+
+        # @!attribute tools
+        #   Tools available to the Responses backend while it handles tasks delegated by the
+        #   Live model.
+        #
+        #   @return [Array<OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::WebSearch>, nil]
+        optional(
+          :tools,
+          -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Live::ResponsesDelegationUpdateConfig::Tool] }
+        )
+
+        # @!method initialize(instructions: nil, max_output_tokens: nil, model: nil, parallel_tool_calls: nil, reasoning: nil, service_tier: nil, text: nil, tool_choice: nil, tools: nil)
+        #   Updates to the Responses backend of an existing Live session. Omitted settings
+        #   retain their current values.
+        #
+        #   @param instructions [String, nil]
+        #     Instructions for the delegated Responses model, separate from Live instructions.
+        #     See
+        #     [backend prompting](https://developers.openai.com/api/docs/guides/live-delegation#start-with-your-existing-backend-prompt).
+        #
+        #   @param max_output_tokens [Integer, nil]
+        #     Maximum number of output tokens for each delegated response.
+        #
+        #   @param model [String]
+        #     The Responses backend model to use for subsequent delegated requests. Omit to
+        #     keep the current backend model.
+        #
+        #   @param parallel_tool_calls [Boolean, nil]
+        #     Whether the delegated Responses model may request multiple tool calls in a
+        #     single response.
+        #
+        #   @param reasoning [OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Reasoning, nil]
+        #     Reasoning settings passed to each delegated Responses request.
+        #
+        #   @param service_tier [Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ServiceTier, nil]
+        #     Service tier for delegated Responses requests.
+        #
+        #   @param text [OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Text, nil]
+        #     Text generation settings passed to each delegated Responses request.
+        #
+        #   @param tool_choice [Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveToolChoiceEnum, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveFunctionToolChoiceParam, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveMCPToolChoiceParam]
+        #     Controls which tool the Responses backend uses when handling a task delegated by
+        #     the Live model.
+        #
+        #   @param tools [Array<OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::WebSearch>]
+        #     Tools available to the Responses backend while it handles tasks delegated by the
+        #     Live model.
+
+        # @see OpenAI::Models::Live::ResponsesDelegationUpdateConfig#reasoning
+        class Reasoning < OpenAI::Internal::Type::BaseModel
+          # @!attribute effort
+          #   How much reasoning effort the delegated Responses model should use. Supported
+          #   values depend on the backend model.
+          #
+          #   @return [Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Reasoning::Effort, nil]
+          optional(
+            :effort,
+            enum: -> { OpenAI::Live::ResponsesDelegationUpdateConfig::Reasoning::Effort },
+            nil?: true
+          )
+
+          # @!attribute summary
+          #   The reasoning summary to request from the delegated Responses model, when
+          #   supported.
+          #
+          #   @return [Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Reasoning::Summary, nil]
+          optional(
+            :summary,
+            enum: -> { OpenAI::Live::ResponsesDelegationUpdateConfig::Reasoning::Summary },
+            nil?: true
+          )
+
+          # @!method initialize(effort: nil, summary: nil)
+          #   Reasoning settings passed to each delegated Responses request.
+          #
+          #   @param effort [Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Reasoning::Effort, nil]
+          #     How much reasoning effort the delegated Responses model should use. Supported
+          #     values depend on the backend model.
+          #
+          #   @param summary [Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Reasoning::Summary, nil]
+          #     The reasoning summary to request from the delegated Responses model, when
+          #     supported.
+
+          # How much reasoning effort the delegated Responses model should use. Supported
+          # values depend on the backend model.
+          #
+          # @see OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Reasoning#effort
+          module Effort
+            extend OpenAI::Internal::Type::Enum
+
+            NONE = :none
+            MINIMAL = :minimal
+            LOW = :low
+            MEDIUM = :medium
+            HIGH = :high
+            XHIGH = :xhigh
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The reasoning summary to request from the delegated Responses model, when
+          # supported.
+          #
+          # @see OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Reasoning#summary
+          module Summary
+            extend OpenAI::Internal::Type::Enum
+
+            CONCISE = :concise
+            DETAILED = :detailed
+            AUTO = :auto
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # Service tier for delegated Responses requests.
+        #
+        # @see OpenAI::Models::Live::ResponsesDelegationUpdateConfig#service_tier
+        module ServiceTier
+          extend OpenAI::Internal::Type::Enum
+
+          AUTO = :auto
+          DEFAULT = :default
+          FAST_TIER_TEMP_PILOT = :fast_tier_temp_pilot
+          FLEX = :flex
+          PRIORITY = :priority
+          ULTRAFAST = :ultrafast
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see OpenAI::Models::Live::ResponsesDelegationUpdateConfig#text
+        class Text < OpenAI::Internal::Type::BaseModel
+          # @!attribute verbosity
+          #   The amount of detail in text generated by the Responses backend. This does not
+          #   configure the Live model’s spoken delivery.
+          #
+          #   @return [Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Text::Verbosity, nil]
+          optional(
+            :verbosity,
+            enum: -> { OpenAI::Live::ResponsesDelegationUpdateConfig::Text::Verbosity },
+            nil?: true
+          )
+
+          # @!method initialize(verbosity: nil)
+          #   Text generation settings passed to each delegated Responses request.
+          #
+          #   @param verbosity [Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Text::Verbosity, nil]
+          #     The amount of detail in text generated by the Responses backend. This does not
+          #     configure the Live model’s spoken delivery.
+
+          # The amount of detail in text generated by the Responses backend. This does not
+          # configure the Live model’s spoken delivery.
+          #
+          # @see OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Text#verbosity
+          module Verbosity
+            extend OpenAI::Internal::Type::Enum
+
+            LOW = :low
+            MEDIUM = :medium
+            HIGH = :high
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+
+        # Controls which tool the Responses backend uses when handling a task delegated by
+        # the Live model.
+        #
+        # @see OpenAI::Models::Live::ResponsesDelegationUpdateConfig#tool_choice
+        module ToolChoice
+          extend OpenAI::Internal::Type::Union
+
+          variant enum: -> { OpenAI::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveToolChoiceEnum }
+
+          variant -> { OpenAI::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveFunctionToolChoiceParam }
+
+          variant -> { OpenAI::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveMCPToolChoiceParam }
+
+          module LiveToolChoiceEnum
+            extend OpenAI::Internal::Type::Enum
+
+            AUTO = :auto
+            NONE = :none
+            REQUIRED = :required
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          class LiveFunctionToolChoiceParam < OpenAI::Internal::Type::BaseModel
+            # @!attribute name
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute type
+            #
+            #   @return [Symbol, :function]
+            required :type, const: :function
+
+            # @!method initialize(name:, type: :function)
+            #   @param name [String]
+            #   @param type [Symbol, :function]
+          end
+
+          class LiveMCPToolChoiceParam < OpenAI::Internal::Type::BaseModel
+            # @!attribute name
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute server_label
+            #
+            #   @return [String]
+            required :server_label, String
+
+            # @!attribute type
+            #
+            #   @return [Symbol, :mcp]
+            required :type, const: :mcp
+
+            # @!method initialize(name:, server_label:, type: :mcp)
+            #   @param name [String]
+            #   @param server_label [String]
+            #   @param type [Symbol, :mcp]
+          end
+
+          # @!method self.variants
+          #   @return [Array(Symbol, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveToolChoiceEnum, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveFunctionToolChoiceParam, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::ToolChoice::LiveMCPToolChoiceParam)]
+        end
+
+        # A function tool available to the Responses backend when the Live model delegates
+        # a task.
+        module Tool
+          extend OpenAI::Internal::Type::Union
+
+          discriminator :type
+
+          # A function tool available to the Responses backend when the Live model delegates a task.
+          variant :function, -> { OpenAI::Live::FunctionTool }
+
+          # A web search tool available to the Live session’s Responses backend.
+          variant :web_search, -> { OpenAI::Live::ResponsesDelegationUpdateConfig::Tool::WebSearch }
+
+          class WebSearch < OpenAI::Internal::Type::BaseModel
+            # @!attribute type
+            #   The tool type. Always `web_search`.
+            #
+            #   @return [Symbol, :web_search]
+            required :type, const: :web_search
+
+            # @!method initialize(type: :web_search)
+            #   A web search tool available to the Live session’s Responses backend.
+            #
+            #   @param type [Symbol, :web_search]
+            #     The tool type. Always `web_search`.
+          end
+
+          # @!method self.variants
+          #   @return [Array(OpenAI::Models::Live::FunctionTool, OpenAI::Models::Live::ResponsesDelegationUpdateConfig::Tool::WebSearch)]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,295 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      # Server events for Live. Response lifecycle events are wrapped inside
+      # response.event; dispatch the nested event by its full type and tolerate new
+      # response event types. Follow the
+      # [Live prompting guide](https://developers.openai.com/api/docs/guides/live-prompting)
+      # when designing the conversation and delegation policy.
+      module ServerEvent
+        extend OpenAI::Internal::Type::Union
+
+        discriminator :type
+
+        # Returned when a Live session has started. Contains the resolved session configuration, including server defaults.
+        variant :"session.started", -> { OpenAI::Live::SessionStartedEvent }
+
+        # Returned when a Live session update is accepted. Contains the resolved session configuration after the update.
+        variant :"session.updated", -> { OpenAI::Live::SessionUpdatedEvent }
+
+        # Returned when a session.input_audio.mute command is accepted. Input audio is no longer sent to the model; sideband audio reflection continues.
+        variant :"session.input_audio.muted", -> { OpenAI::Live::InputAudioMutedEvent }
+
+        # Returned when a session.input_audio.unmute command is accepted. Input audio is sent to the model again.
+        variant :"session.input_audio.unmuted", -> { OpenAI::Live::InputAudioUnmutedEvent }
+
+        # Returned when a session.instructions.append command is accepted into the Live session timeline. Acknowledges the appended instructions without guaranteeing that the model has acted on them.
+        variant :"session.instructions.appended", -> { OpenAI::Live::InstructionsAppendedEvent }
+
+        # Returned when a session.thinking.append command is accepted into the Live session timeline. Acknowledges the added reasoning context without guaranteeing any spoken output.
+        variant :"session.thinking.appended", -> { OpenAI::Live::ThinkingAppendedEvent }
+
+        # Returned when a session.commentary.append command is accepted into the Live session timeline. Acknowledges the added commentary without guaranteeing exact wording or completed audio playback.
+        variant :"session.commentary.appended", -> { OpenAI::Live::CommentaryAppendedEvent }
+
+        # 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::ServerEvent::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 transcript fragment for user input audio in the Live session. Accumulate fragments in delivery order; these events do not define complete turns or include a transcript-done event.
+        variant :"session.input_transcript.delta", -> { OpenAI::Live::InputTranscriptDeltaEvent }
+
+        # A transcript fragment for assistant output audio in the Live session. Accumulate fragments in delivery order; these events do not define complete turns or include a transcript-done event.
+        variant :"session.output_transcript.delta", -> { OpenAI::Live::OutputTranscriptDeltaEvent }
+
+        # Returned when the Live model delegates work to your application or a Responses backend. Contains delegation metadata and the position on the session timeline where the work was delegated.
+        variant :"session.delegation.created", -> { OpenAI::Live::DelegationCreatedEvent }
+
+        # A streaming Responses API event from a backend delegated to by the Live session. Use the outer delegation_id to associate the nested stream with its Live delegation.
+        variant :"response.event", -> { OpenAI::Live::ResponseEvent }
+
+        # Reports cumulative Live audio usage and, when available, the most recent context-window usage. Delegated Responses token usage is reported separately in response.event events.
+        variant :"session.usage.updated", -> { OpenAI::Live::SessionUsageUpdatedEvent }
+
+        # 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.
+        variant :"session.closed", -> { OpenAI::Live::SessionClosedEvent }
+
+        # Reports an error in the Live session, such as an invalid client command. Use error.client_event_id, when present, to identify the command that caused the error.
+        variant :error, -> { OpenAI::Live::ErrorEvent }
+
+        # An informational notice about the Live session, such as the event permissions applied to a frontend data channel.
+        variant :info, -> { OpenAI::Live::InfoEvent }
+
+        # A SIP DTMF keypress received from the caller. Delivered only to sideband observers.
+        variant :"transport.dtmf.received", -> { OpenAI::Live::ServerEvent::TransportDtmfReceived }
+
+        # A SIP DTMF keypress successfully sent by the hosted tool. Delivered only to sideband observers; this is not a client command.
+        variant :"transport.dtmf.send", -> { OpenAI::Live::ServerEvent::TransportDtmfSend }
+
+        # The outbound SIP provider leg is ringing or providing early media. Delivered only to sideband observers.
+        variant :"transport.ringing", -> { OpenAI::Live::ServerEvent::TransportRinging }
+
+        # The outbound SIP provider leg answered and media is established. Delivered only to sideband observers.
+        variant :"transport.answered", -> { OpenAI::Live::ServerEvent::TransportAnswered }
+
+        # An asynchronous outbound SIP setup failure. Delivered only to sideband observers.
+        variant :"transport.failed", -> { OpenAI::Live::ServerEvent::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"
+
+          # @!method initialize(event:, event_id:, type: :"transport.dtmf.send")
+          #   A SIP DTMF keypress successfully sent by the hosted tool. Delivered only to
+          #   sideband observers; this is not a client command.
+          #
+          #   @param event [String]
+          #   @param event_id [String]
+          #   @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::ServerEvent::TransportFailed::Error]
+          required :error, -> { OpenAI::Live::ServerEvent::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::ServerEvent::TransportFailed::Error]
+          #
+          #   @param event_id [String]
+          #
+          #   @param session_id [String]
+          #     The canonical Live session ID.
+          #
+          #   @param type [Symbol, :"transport.failed"]
+
+          # @see OpenAI::Models::Live::ServerEvent::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::InstructionsAppendedEvent, OpenAI::Models::Live::ThinkingAppendedEvent, OpenAI::Models::Live::CommentaryAppendedEvent, OpenAI::Models::Live::ServerEvent::SessionInputAudioAppend, OpenAI::Models::Live::OutputAudioDeltaEvent, OpenAI::Models::Live::InputTranscriptDeltaEvent, OpenAI::Models::Live::OutputTranscriptDeltaEvent, OpenAI::Models::Live::DelegationCreatedEvent, OpenAI::Models::Live::ResponseEvent, OpenAI::Models::Live::SessionUsageUpdatedEvent, OpenAI::Models::Live::SessionClosedEvent, OpenAI::Models::Live::ErrorEvent, OpenAI::Models::Live::InfoEvent, OpenAI::Models::Live::ServerEvent::TransportDtmfReceived, OpenAI::Models::Live::ServerEvent::TransportDtmfSend, OpenAI::Models::Live::ServerEvent::TransportRinging, OpenAI::Models::Live::ServerEvent::TransportAnswered, OpenAI::Models::Live::ServerEvent::TransportFailed)]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class ServerEventSelector < OpenAI::Internal::Type::BaseModel
+        # @!attribute type
+        #   The outer Live server event type. Use 'response.event' for Responses events.
+        #
+        #   @return [String]
+        required :type, String
+
+        # @!attribute response_event
+        #   The nested Responses event type. Required when type is 'response.event';
+        #   forbidden for other event types.
+        #
+        #   @return [String, nil]
+        optional :response_event, String
+
+        # @!method initialize(type:, response_event: nil)
+        #   A Live server event selector for the WebRTC frontend data channel.
+        #
+        #   @param type [String]
+        #     The outer Live server event type. Use 'response.event' for Responses events.
+        #
+        #   @param response_event [String]
+        #     The nested Responses event type. Required when type is 'response.event';
+        #     forbidden for other event types.
+      end
+    end
+  end
+end