openai 0.88.0 → 0.89.0

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

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class OutputAudioDeltaEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute delta
+        #   Base64-encoded raw audio. Primary WebSocket events use the session's configured
+        #   format; reflected sideband events use mono PCM16LE at 24 kHz.
+        #
+        #   @return [String]
+        required :delta, String
+
+        # @!attribute type
+        #   The event type, always `session.output_audio.delta`.
+        #
+        #   @return [Symbol, :"session.output_audio.delta"]
+        required :type, const: :"session.output_audio.delta"
+
+        # @!attribute end_ms
+        #   Exclusive session-relative end in milliseconds. Required on reflected sideband
+        #   events; omitted on the primary WebSocket. Dropped output frames leave gaps
+        #   between reflected ranges.
+        #
+        #   @return [Integer, nil]
+        optional :end_ms, Integer
+
+        # @!attribute start_ms
+        #   Inclusive session-relative start in milliseconds. Required on reflected sideband
+        #   events; omitted on the primary WebSocket.
+        #
+        #   @return [Integer, nil]
+        optional :start_ms, Integer
+
+        # @!method initialize(delta:, end_ms: nil, start_ms: nil, type: :"session.output_audio.delta")
+        #   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.
+        #
+        #   @param delta [String]
+        #     Base64-encoded raw audio. Primary WebSocket events use the session's configured
+        #     format; reflected sideband events use mono PCM16LE at 24 kHz.
+        #
+        #   @param end_ms [Integer]
+        #     Exclusive session-relative end in milliseconds. Required on reflected sideband
+        #     events; omitted on the primary WebSocket. Dropped output frames leave gaps
+        #     between reflected ranges.
+        #
+        #   @param start_ms [Integer]
+        #     Inclusive session-relative start in milliseconds. Required on reflected sideband
+        #     events; omitted on the primary WebSocket.
+        #
+        #   @param type [Symbol, :"session.output_audio.delta"]
+        #     The event type, always `session.output_audio.delta`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class OutputTranscriptDeltaEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute delta
+        #   The transcript text fragment for the audio in this time range. Append fragments
+        #   in delivery order to build the transcript.
+        #
+        #   @return [String]
+        required :delta, String
+
+        # @!attribute end_ms
+        #   The end of this event on the Live session timeline, in milliseconds from the
+        #   beginning of the session. For appended context, this can equal start_ms.
+        #
+        #   @return [Integer]
+        required :end_ms, Integer
+
+        # @!attribute event_id
+        #   The unique ID of the Live server event.
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute start_ms
+        #   The start of this event on the Live session timeline, in milliseconds from the
+        #   beginning of the session.
+        #
+        #   @return [Integer]
+        required :start_ms, Integer
+
+        # @!attribute type
+        #   The event type, always `session.output_transcript.delta`.
+        #
+        #   @return [Symbol, :"session.output_transcript.delta"]
+        required :type, const: :"session.output_transcript.delta"
+
+        # @!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(delta:, end_ms:, event_id:, start_ms:, client_event_id: nil, type: :"session.output_transcript.delta")
+        #   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.
+        #
+        #   @param delta [String]
+        #     The transcript text fragment for the audio in this time range. Append fragments
+        #     in delivery order to build the transcript.
+        #
+        #   @param end_ms [Integer]
+        #     The end of this event on the Live session timeline, in milliseconds from the
+        #     beginning of the session. For appended context, this can equal start_ms.
+        #
+        #   @param event_id [String]
+        #     The unique ID of the Live server event.
+        #
+        #   @param start_ms [Integer]
+        #     The start of this event on the Live session timeline, in milliseconds from the
+        #     beginning of the session.
+        #
+        #   @param client_event_id [String]
+        #     The event_id of the client command associated with this server event, when
+        #     supplied.
+        #
+        #   @param type [Symbol, :"session.output_transcript.delta"]
+        #     The event type, always `session.output_transcript.delta`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class ResponseCreateEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute type
+        #   The Live client event type. Always `response.create`.
+        #
+        #   @return [Symbol, :"response.create"]
+        required :type, const: :"response.create"
+
+        # @!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: :"response.create")
+        #   Request a response from the Live session’s Responses backend, or continue a
+        #   delegated response waiting for tool results. Requires Responses delegation.
+        #
+        #   @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, :"response.create"]
+        #     The Live client event type. Always `response.create`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class ResponseEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute event
+        #   The nested Responses streaming event. Dispatch on its type field. Response
+        #   lifecycle snapshots omit input and clear instructions, tools, and output to keep
+        #   messages small; consume granular output events for the generated content.
+        #
+        #   @return [Hash{Symbol=>Object}]
+        required :event, OpenAI::Internal::Type::HashOf[OpenAI::Internal::Type::Unknown]
+
+        # @!attribute event_id
+        #   The unique ID of the Live server event.
+        #
+        #   @return [String]
+        required :event_id, String
+
+        # @!attribute type
+        #   The event type, always `response.event`.
+        #
+        #   @return [Symbol, :"response.event"]
+        required :type, const: :"response.event"
+
+        # @!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
+
+        # @!attribute delegation_id
+        #   The Live delegation associated with the nested Responses event. May be null or
+        #   omitted when the event cannot be correlated with a delegation.
+        #
+        #   @return [String, nil]
+        optional :delegation_id, String, nil?: true
+
+        # @!method initialize(event:, event_id:, client_event_id: nil, delegation_id: nil, type: :"response.event")
+        #   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.
+        #
+        #   @param event [Hash{Symbol=>Object}]
+        #     The nested Responses streaming event. Dispatch on its type field. Response
+        #     lifecycle snapshots omit input and clear instructions, tools, and output to keep
+        #     messages small; consume granular output events for the generated content.
+        #
+        #   @param event_id [String]
+        #     The unique ID of the Live server event.
+        #
+        #   @param client_event_id [String]
+        #     The event_id of the client command associated with this server event, when
+        #     supplied.
+        #
+        #   @param delegation_id [String, nil]
+        #     The Live delegation associated with the nested Responses event. May be null or
+        #     omitted when the event cannot be correlated with a delegation.
+        #
+        #   @param type [Symbol, :"response.event"]
+        #     The event type, always `response.event`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class ResponseItemCreateEvent < OpenAI::Internal::Type::BaseModel
+        # @!attribute item
+        #   An input item to append to the Responses backend conversation, such as a user
+        #   message or a function tool result.
+        #
+        #   @return [OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference, OpenAI::Models::Responses::ResponseInputItem::Program, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput]
+        required :item, union: -> { OpenAI::Responses::ResponseInputItem }
+
+        # @!attribute type
+        #   The Live client event type. Always `response.item.create`.
+        #
+        #   @return [Symbol, :"response.item.create"]
+        required :type, const: :"response.item.create"
+
+        # @!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(item:, event_id: nil, type: :"response.item.create")
+        #   Add an input item to the Live session’s Responses backend. Requires Responses
+        #   delegation; use `response.create` to request a response.
+        #
+        #   @param item [OpenAI::Models::Responses::EasyInputMessage, OpenAI::Models::Responses::ResponseInputItem::Message, OpenAI::Models::Responses::ResponseOutputMessage, OpenAI::Models::Responses::ResponseFileSearchToolCall, OpenAI::Models::Responses::ResponseComputerToolCall, OpenAI::Models::Responses::ResponseInputItem::ComputerCallOutput, OpenAI::Models::Responses::ResponseFunctionWebSearch, OpenAI::Models::Responses::ResponseFunctionToolCall, OpenAI::Models::Responses::ResponseInputItem::FunctionCallOutput, OpenAI::Models::Responses::ResponseInputItem::ToolSearchCall, OpenAI::Models::Responses::ResponseToolSearchOutputItemParam, OpenAI::Models::Responses::ResponseInputItem::AdditionalTools, OpenAI::Models::Responses::ResponseConfigurationUpdateItemParam, OpenAI::Models::Responses::ResponseReasoningItem, OpenAI::Models::Responses::ResponseCompactionItemParam, OpenAI::Models::Responses::ResponseInputItem::ImageGenerationCall, OpenAI::Models::Responses::ResponseCodeInterpreterToolCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCall, OpenAI::Models::Responses::ResponseInputItem::LocalShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ShellCall, OpenAI::Models::Responses::ResponseInputItem::ShellCallOutput, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCall, OpenAI::Models::Responses::ResponseInputItem::ApplyPatchCallOutput, OpenAI::Models::Responses::ResponseInputItem::McpListTools, OpenAI::Models::Responses::ResponseInputItem::McpApprovalRequest, OpenAI::Models::Responses::ResponseInputItem::McpApprovalResponse, OpenAI::Models::Responses::ResponseInputItem::McpCall, OpenAI::Models::Responses::ResponseCustomToolCallOutput, OpenAI::Models::Responses::ResponseCustomToolCall, OpenAI::Models::Responses::ResponseInputItem::CompactionTrigger, OpenAI::Models::Responses::ResponseInputItem::ItemReference, OpenAI::Models::Responses::ResponseInputItem::Program, OpenAI::Models::Responses::ResponseInputItem::ProgramOutput]
+        #     An input item to append to the Responses backend conversation, such as a user
+        #     message or a function tool result.
+        #
+        #   @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, :"response.item.create"]
+        #     The Live client event type. Always `response.item.create`.
+      end
+    end
+  end
+end

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

@@ -0,0 +1,332 @@
+# frozen_string_literal: true
+
+module OpenAI
+  module Models
+    module Live
+      class ResponsesDelegationConfig < OpenAI::Internal::Type::BaseModel
+        # @!attribute model
+        #   The model used for server-owned Responses delegations.
+        #
+        #   @return [String]
+        required :model, String
+
+        # @!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 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::ResponsesDelegationConfig::Reasoning, nil]
+        optional :reasoning, -> { OpenAI::Live::ResponsesDelegationConfig::Reasoning }, nil?: true
+
+        # @!attribute service_tier
+        #   Service tier for delegated Responses requests.
+        #
+        #   @return [Symbol, OpenAI::Models::Live::ResponsesDelegationConfig::ServiceTier, nil]
+        optional :service_tier, enum: -> { OpenAI::Live::ResponsesDelegationConfig::ServiceTier }, nil?: true
+
+        # @!attribute text
+        #   Text generation settings passed to each delegated Responses request.
+        #
+        #   @return [OpenAI::Models::Live::ResponsesDelegationConfig::Text, nil]
+        optional :text, -> { OpenAI::Live::ResponsesDelegationConfig::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::ResponsesDelegationConfig::ToolChoice::LiveToolChoiceEnum, OpenAI::Models::Live::ResponsesDelegationConfig::ToolChoice::LiveFunctionToolChoiceParam, OpenAI::Models::Live::ResponsesDelegationConfig::ToolChoice::LiveMCPToolChoiceParam, nil]
+        optional :tool_choice, union: -> { OpenAI::Live::ResponsesDelegationConfig::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::ResponsesDelegationConfig::Tool::WebSearch>, nil]
+        optional(
+          :tools,
+          -> { OpenAI::Internal::Type::ArrayOf[union: OpenAI::Live::ResponsesDelegationConfig::Tool] }
+        )
+
+        # @!method initialize(model:, instructions: nil, max_output_tokens: nil, parallel_tool_calls: nil, reasoning: nil, service_tier: nil, text: nil, tool_choice: nil, tools: nil)
+        #   Model, prompt, and tool settings for tasks delegated by the Live session to a
+        #   Responses backend.
+        #
+        #   @param model [String]
+        #     The model used for server-owned Responses delegations.
+        #
+        #   @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 parallel_tool_calls [Boolean, nil]
+        #     Whether the delegated Responses model may request multiple tool calls in a
+        #     single response.
+        #
+        #   @param reasoning [OpenAI::Models::Live::ResponsesDelegationConfig::Reasoning, nil]
+        #     Reasoning settings passed to each delegated Responses request.
+        #
+        #   @param service_tier [Symbol, OpenAI::Models::Live::ResponsesDelegationConfig::ServiceTier, nil]
+        #     Service tier for delegated Responses requests.
+        #
+        #   @param text [OpenAI::Models::Live::ResponsesDelegationConfig::Text, nil]
+        #     Text generation settings passed to each delegated Responses request.
+        #
+        #   @param tool_choice [Symbol, OpenAI::Models::Live::ResponsesDelegationConfig::ToolChoice::LiveToolChoiceEnum, OpenAI::Models::Live::ResponsesDelegationConfig::ToolChoice::LiveFunctionToolChoiceParam, OpenAI::Models::Live::ResponsesDelegationConfig::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::ResponsesDelegationConfig::Tool::WebSearch>]
+        #     Tools available to the Responses backend while it handles tasks delegated by the
+        #     Live model.
+
+        # @see OpenAI::Models::Live::ResponsesDelegationConfig#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::ResponsesDelegationConfig::Reasoning::Effort, nil]
+          optional(
+            :effort,
+            enum: -> {
+              OpenAI::Live::ResponsesDelegationConfig::Reasoning::Effort
+            },
+            nil?: true
+          )
+
+          # @!attribute summary
+          #   The reasoning summary to request from the delegated Responses model, when
+          #   supported.
+          #
+          #   @return [Symbol, OpenAI::Models::Live::ResponsesDelegationConfig::Reasoning::Summary, nil]
+          optional(
+            :summary,
+            enum: -> {
+              OpenAI::Live::ResponsesDelegationConfig::Reasoning::Summary
+            },
+            nil?: true
+          )
+
+          # @!method initialize(effort: nil, summary: nil)
+          #   Reasoning settings passed to each delegated Responses request.
+          #
+          #   @param effort [Symbol, OpenAI::Models::Live::ResponsesDelegationConfig::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::ResponsesDelegationConfig::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::ResponsesDelegationConfig::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::ResponsesDelegationConfig::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::ResponsesDelegationConfig#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::ResponsesDelegationConfig#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::ResponsesDelegationConfig::Text::Verbosity, nil]
+          optional(
+            :verbosity,
+            enum: -> {
+              OpenAI::Live::ResponsesDelegationConfig::Text::Verbosity
+            },
+            nil?: true
+          )
+
+          # @!method initialize(verbosity: nil)
+          #   Text generation settings passed to each delegated Responses request.
+          #
+          #   @param verbosity [Symbol, OpenAI::Models::Live::ResponsesDelegationConfig::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::ResponsesDelegationConfig::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::ResponsesDelegationConfig#tool_choice
+        module ToolChoice
+          extend OpenAI::Internal::Type::Union
+
+          variant enum: -> { OpenAI::Live::ResponsesDelegationConfig::ToolChoice::LiveToolChoiceEnum }
+
+          variant -> { OpenAI::Live::ResponsesDelegationConfig::ToolChoice::LiveFunctionToolChoiceParam }
+
+          variant -> { OpenAI::Live::ResponsesDelegationConfig::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::ResponsesDelegationConfig::ToolChoice::LiveToolChoiceEnum, OpenAI::Models::Live::ResponsesDelegationConfig::ToolChoice::LiveFunctionToolChoiceParam, OpenAI::Models::Live::ResponsesDelegationConfig::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::ResponsesDelegationConfig::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::ResponsesDelegationConfig::Tool::WebSearch)]
+        end
+      end
+    end
+  end
+end