telnyx 5.122.0 → 5.124.0

data/rbi/telnyx/models/ai/inference_embedding.rbi

@@ -31,6 +31,20 @@ module Telnyx
         sig { returns(String) }
         attr_accessor :name
 
+        # Conversation flow as returned by the API.
+        sig do
+          returns(T.nilable(Telnyx::AI::InferenceEmbedding::ConversationFlow))
+        end
+        attr_reader :conversation_flow
+
+        sig do
+          params(
+            conversation_flow:
+              Telnyx::AI::InferenceEmbedding::ConversationFlow::OrHash
+          ).void
+        end
+        attr_writer :conversation_flow
+
         sig { returns(T.nilable(String)) }
         attr_reader :description
 
@@ -320,6 +334,8 @@ module Telnyx
             instructions: String,
             model: String,
             name: String,
+            conversation_flow:
+              Telnyx::AI::InferenceEmbedding::ConversationFlow::OrHash,
             description: String,
             dynamic_variables: T::Hash[Symbol, T.anything],
             dynamic_variables_webhook_timeout_ms: Integer,
@@ -379,6 +395,8 @@ module Telnyx
           # provided, Telnyx applies the default model.
           model:,
           name:,
+          # Conversation flow as returned by the API.
+          conversation_flow: nil,
           description: nil,
           # Map of dynamic variables and their values
           dynamic_variables: nil,
@@ -472,6 +490,8 @@ module Telnyx
               instructions: String,
               model: String,
               name: String,
+              conversation_flow:
+                Telnyx::AI::InferenceEmbedding::ConversationFlow,
               description: String,
               dynamic_variables: T::Hash[Symbol, T.anything],
               dynamic_variables_webhook_timeout_ms: Integer,
@@ -507,6 +527,1440 @@ module Telnyx
         end
         def to_hash
         end
+
+        class ConversationFlow < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::AI::InferenceEmbedding::ConversationFlow,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # All nodes in the flow.
+          sig do
+            returns(
+              T::Array[
+                Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Variants
+              ]
+            )
+          end
+          attr_accessor :nodes
+
+          # ID of the node where the conversation begins.
+          sig { returns(String) }
+          attr_accessor :start_node_id
+
+          # Directed transitions between nodes.
+          sig do
+            returns(
+              T.nilable(
+                T::Array[Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge]
+              )
+            )
+          end
+          attr_reader :edges
+
+          sig do
+            params(
+              edges:
+                T::Array[
+                  Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::OrHash
+                ]
+            ).void
+          end
+          attr_writer :edges
+
+          # Conversation flow as returned by the API.
+          sig do
+            params(
+              nodes:
+                T::Array[
+                  T.any(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::OrHash,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::OrHash
+                  )
+                ],
+              start_node_id: String,
+              edges:
+                T::Array[
+                  Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::OrHash
+                ]
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # All nodes in the flow.
+            nodes:,
+            # ID of the node where the conversation begins.
+            start_node_id:,
+            # Directed transitions between nodes.
+            edges: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                nodes:
+                  T::Array[
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Variants
+                  ],
+                start_node_id: String,
+                edges:
+                  T::Array[
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge
+                  ]
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # One step in a conversation flow, as returned by the API.
+          module Node
+            extend Telnyx::Internal::Type::Union
+
+            Variants =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt,
+                  Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool
+                )
+              end
+
+            class Prompt < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt,
+                    Telnyx::Internal::AnyHash
+                  )
+                end
+
+              # Caller-supplied unique identifier for this node within the flow.
+              sig { returns(String) }
+              attr_accessor :id
+
+              # Prompt that drives the LLM while this node is active. Required.
+              sig { returns(String) }
+              attr_accessor :instructions
+
+              # Override for `Assistant.external_llm` while this node is active. Use this to
+              # route a node's turns to a different external LLM (different `model`, `base_url`,
+              # credentials). Part of the LLM bundle — see `model` for cascade semantics.
+              # Mutually exclusive with `model` on the node (a single LLM identity per node).
+              sig { returns(T.nilable(Telnyx::AI::ExternalLlm)) }
+              attr_reader :external_llm
+
+              sig { params(external_llm: Telnyx::AI::ExternalLlm::OrHash).void }
+              attr_writer :external_llm
+
+              # How `instructions` combine with the assistant-level instructions. `replace`
+              # (default): the node's instructions are used alone. `append`: the node's
+              # instructions are concatenated after the assistant's instructions.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::InstructionsMode::TaggedSymbol
+                  )
+                )
+              end
+              attr_reader :instructions_mode
+
+              sig do
+                params(
+                  instructions_mode:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::InstructionsMode::OrSymbol
+                ).void
+              end
+              attr_writer :instructions_mode
+
+              # Override for `Assistant.llm_api_key_ref` while this node is active. Part of the
+              # LLM bundle — see `model` for cascade semantics.
+              sig { returns(T.nilable(String)) }
+              attr_reader :llm_api_key_ref
+
+              sig { params(llm_api_key_ref: String).void }
+              attr_writer :llm_api_key_ref
+
+              # Override for `Assistant.model` while this node is active. Part of the LLM bundle
+              # (`model` + `llm_api_key_ref` + `external_llm`): when any of the three is set on
+              # the node, all three are taken from the node and the assistant-level LLM identity
+              # is not consulted. When none of the three is set, the assistant's bundle cascades
+              # unchanged.
+              sig { returns(T.nilable(String)) }
+              attr_reader :model
+
+              sig { params(model: String).void }
+              attr_writer :model
+
+              # Optional human-readable label, displayed in authoring UIs.
+              sig { returns(T.nilable(String)) }
+              attr_reader :name
+
+              sig { params(name: String).void }
+              attr_writer :name
+
+              # Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
+              # by the runtime; round-trips so frontends can persist graph layout across
+              # reloads.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Position
+                  )
+                )
+              end
+              attr_reader :position
+
+              sig do
+                params(
+                  position:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Position::OrHash
+                ).void
+              end
+              attr_writer :position
+
+              # IDs of shared (org-level) tools available at this node. Knowledge bases are
+              # attached the same way — via a shared retrieval tool. Tools not listed here are
+              # not callable while this node is active.
+              sig { returns(T.nilable(T::Array[String])) }
+              attr_reader :shared_tool_ids
+
+              sig { params(shared_tool_ids: T::Array[String]).void }
+              attr_writer :shared_tool_ids
+
+              # Full tool definitions for this node, resolved from `shared_tool_ids`
+              # server-side. Populated on responses so clients can render the flow without a
+              # follow-up fetch per shared tool. Ignored on input — set `shared_tool_ids` to
+              # configure a node's tools.
+              sig do
+                returns(
+                  T.nilable(
+                    T::Array[T::Array[Telnyx::AI::AssistantTool::Variants]]
+                  )
+                )
+              end
+              attr_reader :tools
+
+              sig do
+                params(
+                  tools:
+                    T::Array[
+                      T::Array[
+                        T.any(
+                          Telnyx::AI::InferenceEmbeddingWebhookToolParams::OrHash,
+                          Telnyx::AI::RetrievalTool::OrHash,
+                          Telnyx::AI::AssistantTool::Handoff::OrHash,
+                          Telnyx::AI::HangupTool::OrHash,
+                          Telnyx::AI::AssistantTool::Transfer::OrHash,
+                          Telnyx::AI::AssistantTool::Invite::OrHash,
+                          Telnyx::AI::AssistantTool::Refer::OrHash,
+                          Telnyx::AI::AssistantTool::SendDtmf::OrHash,
+                          Telnyx::AI::AssistantTool::SendMessage::OrHash,
+                          Telnyx::AI::AssistantTool::SkipTurn::OrHash
+                        )
+                      ]
+                    ]
+                ).void
+              end
+              attr_writer :tools
+
+              # How `shared_tool_ids` combine with the assistant-level tool set. `replace`
+              # (default): only the node's tools are callable. `append`: the node's tools are
+              # added to the assistant's tools. Ignored when `shared_tool_ids` is null.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::ToolsMode::TaggedSymbol
+                  )
+                )
+              end
+              attr_reader :tools_mode
+
+              sig do
+                params(
+                  tools_mode:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::ToolsMode::OrSymbol
+                ).void
+              end
+              attr_writer :tools_mode
+
+              # Per-node transcription override (response form).
+              sig { returns(T.nilable(Telnyx::AI::TranscriptionSettings)) }
+              attr_reader :transcription
+
+              sig do
+                params(
+                  transcription: Telnyx::AI::TranscriptionSettings::OrHash
+                ).void
+              end
+              attr_writer :transcription
+
+              # Node kind discriminator. `prompt` is an LLM-driven step.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Type::TaggedSymbol
+                  )
+                )
+              end
+              attr_reader :type
+
+              sig do
+                params(
+                  type:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Type::OrSymbol
+                ).void
+              end
+              attr_writer :type
+
+              # Per-node voice override (response form).
+              sig { returns(T.nilable(Telnyx::AI::VoiceSettings)) }
+              attr_reader :voice_settings
+
+              sig do
+                params(voice_settings: Telnyx::AI::VoiceSettings::OrHash).void
+              end
+              attr_writer :voice_settings
+
+              # One step in a conversation flow, as returned by the API.
+              sig do
+                params(
+                  id: String,
+                  instructions: String,
+                  external_llm: Telnyx::AI::ExternalLlm::OrHash,
+                  instructions_mode:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::InstructionsMode::OrSymbol,
+                  llm_api_key_ref: String,
+                  model: String,
+                  name: String,
+                  position:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Position::OrHash,
+                  shared_tool_ids: T::Array[String],
+                  tools:
+                    T::Array[
+                      T::Array[
+                        T.any(
+                          Telnyx::AI::InferenceEmbeddingWebhookToolParams::OrHash,
+                          Telnyx::AI::RetrievalTool::OrHash,
+                          Telnyx::AI::AssistantTool::Handoff::OrHash,
+                          Telnyx::AI::HangupTool::OrHash,
+                          Telnyx::AI::AssistantTool::Transfer::OrHash,
+                          Telnyx::AI::AssistantTool::Invite::OrHash,
+                          Telnyx::AI::AssistantTool::Refer::OrHash,
+                          Telnyx::AI::AssistantTool::SendDtmf::OrHash,
+                          Telnyx::AI::AssistantTool::SendMessage::OrHash,
+                          Telnyx::AI::AssistantTool::SkipTurn::OrHash
+                        )
+                      ]
+                    ],
+                  tools_mode:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::ToolsMode::OrSymbol,
+                  transcription: Telnyx::AI::TranscriptionSettings::OrHash,
+                  type:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Type::OrSymbol,
+                  voice_settings: Telnyx::AI::VoiceSettings::OrHash
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # Caller-supplied unique identifier for this node within the flow.
+                id:,
+                # Prompt that drives the LLM while this node is active. Required.
+                instructions:,
+                # Override for `Assistant.external_llm` while this node is active. Use this to
+                # route a node's turns to a different external LLM (different `model`, `base_url`,
+                # credentials). Part of the LLM bundle — see `model` for cascade semantics.
+                # Mutually exclusive with `model` on the node (a single LLM identity per node).
+                external_llm: nil,
+                # How `instructions` combine with the assistant-level instructions. `replace`
+                # (default): the node's instructions are used alone. `append`: the node's
+                # instructions are concatenated after the assistant's instructions.
+                instructions_mode: nil,
+                # Override for `Assistant.llm_api_key_ref` while this node is active. Part of the
+                # LLM bundle — see `model` for cascade semantics.
+                llm_api_key_ref: nil,
+                # Override for `Assistant.model` while this node is active. Part of the LLM bundle
+                # (`model` + `llm_api_key_ref` + `external_llm`): when any of the three is set on
+                # the node, all three are taken from the node and the assistant-level LLM identity
+                # is not consulted. When none of the three is set, the assistant's bundle cascades
+                # unchanged.
+                model: nil,
+                # Optional human-readable label, displayed in authoring UIs.
+                name: nil,
+                # Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
+                # by the runtime; round-trips so frontends can persist graph layout across
+                # reloads.
+                position: nil,
+                # IDs of shared (org-level) tools available at this node. Knowledge bases are
+                # attached the same way — via a shared retrieval tool. Tools not listed here are
+                # not callable while this node is active.
+                shared_tool_ids: nil,
+                # Full tool definitions for this node, resolved from `shared_tool_ids`
+                # server-side. Populated on responses so clients can render the flow without a
+                # follow-up fetch per shared tool. Ignored on input — set `shared_tool_ids` to
+                # configure a node's tools.
+                tools: nil,
+                # How `shared_tool_ids` combine with the assistant-level tool set. `replace`
+                # (default): only the node's tools are callable. `append`: the node's tools are
+                # added to the assistant's tools. Ignored when `shared_tool_ids` is null.
+                tools_mode: nil,
+                # Per-node transcription override (response form).
+                transcription: nil,
+                # Node kind discriminator. `prompt` is an LLM-driven step.
+                type: nil,
+                # Per-node voice override (response form).
+                voice_settings: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    id: String,
+                    instructions: String,
+                    external_llm: Telnyx::AI::ExternalLlm,
+                    instructions_mode:
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::InstructionsMode::TaggedSymbol,
+                    llm_api_key_ref: String,
+                    model: String,
+                    name: String,
+                    position:
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Position,
+                    shared_tool_ids: T::Array[String],
+                    tools:
+                      T::Array[T::Array[Telnyx::AI::AssistantTool::Variants]],
+                    tools_mode:
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::ToolsMode::TaggedSymbol,
+                    transcription: Telnyx::AI::TranscriptionSettings,
+                    type:
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Type::TaggedSymbol,
+                    voice_settings: Telnyx::AI::VoiceSettings
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              # How `instructions` combine with the assistant-level instructions. `replace`
+              # (default): the node's instructions are used alone. `append`: the node's
+              # instructions are concatenated after the assistant's instructions.
+              module InstructionsMode
+                extend Telnyx::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::InstructionsMode
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                REPLACE =
+                  T.let(
+                    :replace,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::InstructionsMode::TaggedSymbol
+                  )
+                APPEND =
+                  T.let(
+                    :append,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::InstructionsMode::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::InstructionsMode::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+
+              class Position < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Position,
+                      Telnyx::Internal::AnyHash
+                    )
+                  end
+
+                # Horizontal coordinate in the authoring canvas.
+                sig { returns(Float) }
+                attr_accessor :x
+
+                # Vertical coordinate in the authoring canvas.
+                sig { returns(Float) }
+                attr_accessor :y_
+
+                # Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
+                # by the runtime; round-trips so frontends can persist graph layout across
+                # reloads.
+                sig { params(x: Float, y_: Float).returns(T.attached_class) }
+                def self.new(
+                  # Horizontal coordinate in the authoring canvas.
+                  x:,
+                  # Vertical coordinate in the authoring canvas.
+                  y_:
+                )
+                end
+
+                sig { override.returns({ x: Float, y_: Float }) }
+                def to_hash
+                end
+              end
+
+              # How `shared_tool_ids` combine with the assistant-level tool set. `replace`
+              # (default): only the node's tools are callable. `append`: the node's tools are
+              # added to the assistant's tools. Ignored when `shared_tool_ids` is null.
+              module ToolsMode
+                extend Telnyx::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::ToolsMode
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                REPLACE =
+                  T.let(
+                    :replace,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::ToolsMode::TaggedSymbol
+                  )
+                APPEND =
+                  T.let(
+                    :append,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::ToolsMode::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::ToolsMode::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+
+              # Node kind discriminator. `prompt` is an LLM-driven step.
+              module Type
+                extend Telnyx::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Type
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                PROMPT =
+                  T.let(
+                    :prompt,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Type::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::Type::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+            end
+
+            class Tool < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool,
+                    Telnyx::Internal::AnyHash
+                  )
+                end
+
+              # Caller-supplied unique identifier for this node within the flow.
+              sig { returns(String) }
+              attr_accessor :id
+
+              # ID of the single shared (org-level) tool this node executes. When the flow
+              # reaches this node the tool runs as a deliberate step (no LLM turn); its outgoing
+              # `tool_result` edges then route on the outcome. Arguments are filled from the
+              # conversation's dynamic variables by name — a dynamic variable whose name matches
+              # one of the tool's parameters supplies that argument. Cross-validated against the
+              # org's shared tools on write.
+              sig { returns(String) }
+              attr_accessor :shared_tool_id
+
+              # Optional human-readable label, displayed in authoring UIs.
+              sig { returns(T.nilable(String)) }
+              attr_reader :name
+
+              sig { params(name: String).void }
+              attr_writer :name
+
+              # Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
+              # by the runtime; round-trips so frontends can persist graph layout across
+              # reloads.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Position
+                  )
+                )
+              end
+              attr_reader :position
+
+              sig do
+                params(
+                  position:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Position::OrHash
+                ).void
+              end
+              attr_writer :position
+
+              # Full tool definition resolved from `shared_tool_id` server-side. Populated on
+              # responses so clients can render the node without a follow-up fetch. Ignored on
+              # input — set `shared_tool_id`.
+              sig do
+                returns(
+                  T.nilable(T::Array[Telnyx::AI::AssistantTool::Variants])
+                )
+              end
+              attr_reader :tool
+
+              sig do
+                params(
+                  tool:
+                    T::Array[
+                      T.any(
+                        Telnyx::AI::InferenceEmbeddingWebhookToolParams::OrHash,
+                        Telnyx::AI::RetrievalTool::OrHash,
+                        Telnyx::AI::AssistantTool::Handoff::OrHash,
+                        Telnyx::AI::HangupTool::OrHash,
+                        Telnyx::AI::AssistantTool::Transfer::OrHash,
+                        Telnyx::AI::AssistantTool::Invite::OrHash,
+                        Telnyx::AI::AssistantTool::Refer::OrHash,
+                        Telnyx::AI::AssistantTool::SendDtmf::OrHash,
+                        Telnyx::AI::AssistantTool::SendMessage::OrHash,
+                        Telnyx::AI::AssistantTool::SkipTurn::OrHash
+                      )
+                    ]
+                ).void
+              end
+              attr_writer :tool
+
+              # Node kind discriminator. Always `tool` for a tool node.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Type::TaggedSymbol
+                  )
+                )
+              end
+              attr_reader :type
+
+              sig do
+                params(
+                  type:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Type::OrSymbol
+                ).void
+              end
+              attr_writer :type
+
+              # A standalone tool step in a conversation flow, as returned by the API.
+              sig do
+                params(
+                  id: String,
+                  shared_tool_id: String,
+                  name: String,
+                  position:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Position::OrHash,
+                  tool:
+                    T::Array[
+                      T.any(
+                        Telnyx::AI::InferenceEmbeddingWebhookToolParams::OrHash,
+                        Telnyx::AI::RetrievalTool::OrHash,
+                        Telnyx::AI::AssistantTool::Handoff::OrHash,
+                        Telnyx::AI::HangupTool::OrHash,
+                        Telnyx::AI::AssistantTool::Transfer::OrHash,
+                        Telnyx::AI::AssistantTool::Invite::OrHash,
+                        Telnyx::AI::AssistantTool::Refer::OrHash,
+                        Telnyx::AI::AssistantTool::SendDtmf::OrHash,
+                        Telnyx::AI::AssistantTool::SendMessage::OrHash,
+                        Telnyx::AI::AssistantTool::SkipTurn::OrHash
+                      )
+                    ],
+                  type:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Type::OrSymbol
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # Caller-supplied unique identifier for this node within the flow.
+                id:,
+                # ID of the single shared (org-level) tool this node executes. When the flow
+                # reaches this node the tool runs as a deliberate step (no LLM turn); its outgoing
+                # `tool_result` edges then route on the outcome. Arguments are filled from the
+                # conversation's dynamic variables by name — a dynamic variable whose name matches
+                # one of the tool's parameters supplies that argument. Cross-validated against the
+                # org's shared tools on write.
+                shared_tool_id:,
+                # Optional human-readable label, displayed in authoring UIs.
+                name: nil,
+                # Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
+                # by the runtime; round-trips so frontends can persist graph layout across
+                # reloads.
+                position: nil,
+                # Full tool definition resolved from `shared_tool_id` server-side. Populated on
+                # responses so clients can render the node without a follow-up fetch. Ignored on
+                # input — set `shared_tool_id`.
+                tool: nil,
+                # Node kind discriminator. Always `tool` for a tool node.
+                type: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    id: String,
+                    shared_tool_id: String,
+                    name: String,
+                    position:
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Position,
+                    tool: T::Array[Telnyx::AI::AssistantTool::Variants],
+                    type:
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Type::TaggedSymbol
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Position < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Position,
+                      Telnyx::Internal::AnyHash
+                    )
+                  end
+
+                # Horizontal coordinate in the authoring canvas.
+                sig { returns(Float) }
+                attr_accessor :x
+
+                # Vertical coordinate in the authoring canvas.
+                sig { returns(Float) }
+                attr_accessor :y_
+
+                # Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
+                # by the runtime; round-trips so frontends can persist graph layout across
+                # reloads.
+                sig { params(x: Float, y_: Float).returns(T.attached_class) }
+                def self.new(
+                  # Horizontal coordinate in the authoring canvas.
+                  x:,
+                  # Vertical coordinate in the authoring canvas.
+                  y_:
+                )
+                end
+
+                sig { override.returns({ x: Float, y_: Float }) }
+                def to_hash
+                end
+              end
+
+              # Node kind discriminator. Always `tool` for a tool node.
+              module Type
+                extend Telnyx::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Type
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                TOOL =
+                  T.let(
+                    :tool,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Type::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Type::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+            end
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Variants
+                ]
+              )
+            end
+            def self.variants
+            end
+          end
+
+          class Edge < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # Caller-supplied unique identifier for this edge within the flow.
+            sig { returns(String) }
+            attr_accessor :id
+
+            # Condition that gates the transition. Discriminated by `type`: `llm`,
+            # `expression`.
+            sig do
+              returns(
+                Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Variants
+              )
+            end
+            attr_accessor :condition
+
+            # ID of the node this edge transitions away from.
+            sig { returns(String) }
+            attr_accessor :start_node_id
+
+            # Destination of the transition. Discriminated by `type`: `node` (jump to another
+            # node in this flow) or `assistant` (hand off to a different assistant).
+            sig do
+              returns(
+                Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Variants
+              )
+            end
+            attr_accessor :target
+
+            # Directed transition from one node to a target, gated by a condition.
+            #
+            # The target is either another node in the same flow (`NodeTarget`) or a different
+            # assistant (`AssistantTarget`). Multiple edges may share a `start_node_id`; the
+            # runtime evaluates them in the order they're declared and takes the first whose
+            # condition is true.
+            sig do
+              params(
+                id: String,
+                condition:
+                  T.any(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Llm::OrHash,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::OrHash
+                  ),
+                start_node_id: String,
+                target:
+                  T.any(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Node::OrHash,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::OrHash
+                  )
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Caller-supplied unique identifier for this edge within the flow.
+              id:,
+              # Condition that gates the transition. Discriminated by `type`: `llm`,
+              # `expression`.
+              condition:,
+              # ID of the node this edge transitions away from.
+              start_node_id:,
+              # Destination of the transition. Discriminated by `type`: `node` (jump to another
+              # node in this flow) or `assistant` (hand off to a different assistant).
+              target:
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  id: String,
+                  condition:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Variants,
+                  start_node_id: String,
+                  target:
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Variants
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # Condition that gates the transition. Discriminated by `type`: `llm`,
+            # `expression`.
+            module Condition
+              extend Telnyx::Internal::Type::Union
+
+              Variants =
+                T.type_alias do
+                  T.any(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Llm,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression
+                  )
+                end
+
+              class Llm < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Llm,
+                      Telnyx::Internal::AnyHash
+                    )
+                  end
+
+                # Natural-language criterion the LLM judges as true/false.
+                sig { returns(String) }
+                attr_accessor :prompt
+
+                sig { returns(Symbol) }
+                attr_accessor :type
+
+                # Edge condition evaluated by the LLM from a natural-language prompt.
+                #
+                # The model is asked to judge the prompt against conversation context and returns
+                # true/false. Use this for fuzzy intents that aren't expressible as a
+                # deterministic expression (e.g. 'user wants to escalate to a human').
+                sig do
+                  params(prompt: String, type: Symbol).returns(T.attached_class)
+                end
+                def self.new(
+                  # Natural-language criterion the LLM judges as true/false.
+                  prompt:,
+                  type: :llm
+                )
+                end
+
+                sig { override.returns({ prompt: String, type: Symbol }) }
+                def to_hash
+                end
+              end
+
+              class Expression < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression,
+                      Telnyx::Internal::AnyHash
+                    )
+                  end
+
+                # A node in a deterministic expression AST. Exactly one variant is selected by the
+                # `type` discriminator. Terminal variants (`number_literal`, `string_literal`,
+                # `bool_literal`, `variable`) bottom out the recursion; `arithmetic`, `bool_op`,
+                # and `comparison` nest further sub-expressions.
+                #
+                # Extracted into a single named schema so the recursive union is defined once (was
+                # previously inlined at every operand site).
+                sig do
+                  returns(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::Variants
+                  )
+                end
+                attr_accessor :expression
+
+                sig { returns(Symbol) }
+                attr_accessor :type
+
+                # Edge condition evaluated as a deterministic expression AST.
+                #
+                # The expression is computed against runtime dynamic variables and must evaluate
+                # to a boolean. Prefer this over `LLMCondition` when the rule is a clean function
+                # of known variables — it's cheaper and predictable.
+                sig do
+                  params(
+                    expression:
+                      T.any(
+                        T.anything,
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::DynamicVariableExpression::OrHash,
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::StringLiteralExpression::OrHash,
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::NumberLiteralExpression::OrHash,
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::BooleanLiteralExpression::OrHash
+                      ),
+                    type: Symbol
+                  ).returns(T.attached_class)
+                end
+                def self.new(
+                  # A node in a deterministic expression AST. Exactly one variant is selected by the
+                  # `type` discriminator. Terminal variants (`number_literal`, `string_literal`,
+                  # `bool_literal`, `variable`) bottom out the recursion; `arithmetic`, `bool_op`,
+                  # and `comparison` nest further sub-expressions.
+                  #
+                  # Extracted into a single named schema so the recursive union is defined once (was
+                  # previously inlined at every operand site).
+                  expression:,
+                  type: :expression
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      expression:
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::Variants,
+                      type: Symbol
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                # A node in a deterministic expression AST. Exactly one variant is selected by the
+                # `type` discriminator. Terminal variants (`number_literal`, `string_literal`,
+                # `bool_literal`, `variable`) bottom out the recursion; `arithmetic`, `bool_op`,
+                # and `comparison` nest further sub-expressions.
+                #
+                # Extracted into a single named schema so the recursive union is defined once (was
+                # previously inlined at every operand site).
+                module Expression
+                  extend Telnyx::Internal::Type::Union
+
+                  Variants =
+                    T.type_alias do
+                      T.any(
+                        T.anything,
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::DynamicVariableExpression,
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::StringLiteralExpression,
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::NumberLiteralExpression,
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::BooleanLiteralExpression
+                      )
+                    end
+
+                  class DynamicVariableExpression < Telnyx::Internal::Type::BaseModel
+                    OrHash =
+                      T.type_alias do
+                        T.any(
+                          Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::DynamicVariableExpression,
+                          Telnyx::Internal::AnyHash
+                        )
+                      end
+
+                    # Variable name to look up in the runtime context.
+                    sig { returns(String) }
+                    attr_accessor :name
+
+                    sig { returns(Symbol) }
+                    attr_accessor :type
+
+                    # Reference a dynamic variable by name.
+                    #
+                    # Resolved at runtime from the assistant's dynamic-variables context (see
+                    # `Assistant.dynamic_variables` and the dynamic-variables webhook).
+                    sig do
+                      params(name: String, type: Symbol).returns(
+                        T.attached_class
+                      )
+                    end
+                    def self.new(
+                      # Variable name to look up in the runtime context.
+                      name:,
+                      type: :variable
+                    )
+                    end
+
+                    sig { override.returns({ name: String, type: Symbol }) }
+                    def to_hash
+                    end
+                  end
+
+                  class StringLiteralExpression < Telnyx::Internal::Type::BaseModel
+                    OrHash =
+                      T.type_alias do
+                        T.any(
+                          Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::StringLiteralExpression,
+                          Telnyx::Internal::AnyHash
+                        )
+                      end
+
+                    sig { returns(Symbol) }
+                    attr_accessor :type
+
+                    # Literal string value.
+                    sig { returns(String) }
+                    attr_accessor :value
+
+                    # Constant string value.
+                    sig do
+                      params(value: String, type: Symbol).returns(
+                        T.attached_class
+                      )
+                    end
+                    def self.new(
+                      # Literal string value.
+                      value:,
+                      type: :string_literal
+                    )
+                    end
+
+                    sig { override.returns({ type: Symbol, value: String }) }
+                    def to_hash
+                    end
+                  end
+
+                  class NumberLiteralExpression < Telnyx::Internal::Type::BaseModel
+                    OrHash =
+                      T.type_alias do
+                        T.any(
+                          Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::NumberLiteralExpression,
+                          Telnyx::Internal::AnyHash
+                        )
+                      end
+
+                    sig { returns(Symbol) }
+                    attr_accessor :type
+
+                    # Literal numeric value.
+                    sig { returns(Float) }
+                    attr_accessor :value
+
+                    # Constant numeric value (float; integers are accepted and stored as float).
+                    sig do
+                      params(value: Float, type: Symbol).returns(
+                        T.attached_class
+                      )
+                    end
+                    def self.new(
+                      # Literal numeric value.
+                      value:,
+                      type: :number_literal
+                    )
+                    end
+
+                    sig { override.returns({ type: Symbol, value: Float }) }
+                    def to_hash
+                    end
+                  end
+
+                  class BooleanLiteralExpression < Telnyx::Internal::Type::BaseModel
+                    OrHash =
+                      T.type_alias do
+                        T.any(
+                          Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::BooleanLiteralExpression,
+                          Telnyx::Internal::AnyHash
+                        )
+                      end
+
+                    sig { returns(Symbol) }
+                    attr_accessor :type
+
+                    # Literal boolean value.
+                    sig { returns(T::Boolean) }
+                    attr_accessor :value
+
+                    # Constant boolean value. Useful for unconditional ('always') edges.
+                    sig do
+                      params(value: T::Boolean, type: Symbol).returns(
+                        T.attached_class
+                      )
+                    end
+                    def self.new(
+                      # Literal boolean value.
+                      value:,
+                      type: :bool_literal
+                    )
+                    end
+
+                    sig do
+                      override.returns({ type: Symbol, value: T::Boolean })
+                    end
+                    def to_hash
+                    end
+                  end
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression::Expression::Variants
+                      ]
+                    )
+                  end
+                  def self.variants
+                  end
+                end
+              end
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Variants
+                  ]
+                )
+              end
+              def self.variants
+              end
+            end
+
+            # Destination of the transition. Discriminated by `type`: `node` (jump to another
+            # node in this flow) or `assistant` (hand off to a different assistant).
+            module Target
+              extend Telnyx::Internal::Type::Union
+
+              Variants =
+                T.type_alias do
+                  T.any(
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Node,
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant
+                  )
+                end
+
+              class Node < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Node,
+                      Telnyx::Internal::AnyHash
+                    )
+                  end
+
+                # ID of the node this edge transitions into.
+                sig { returns(String) }
+                attr_accessor :node_id
+
+                sig { returns(Symbol) }
+                attr_accessor :type
+
+                # Edge target referencing another node within the same flow.
+                #
+                # The runtime transitions the active node to `node_id` and continues processing
+                # within the current assistant's flow.
+                sig do
+                  params(node_id: String, type: Symbol).returns(
+                    T.attached_class
+                  )
+                end
+                def self.new(
+                  # ID of the node this edge transitions into.
+                  node_id:,
+                  type: :node
+                )
+                end
+
+                sig { override.returns({ node_id: String, type: Symbol }) }
+                def to_hash
+                end
+              end
+
+              class Assistant < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant,
+                      Telnyx::Internal::AnyHash
+                    )
+                  end
+
+                # ID of the assistant the conversation transitions to.
+                sig { returns(String) }
+                attr_accessor :assistant_id
+
+                sig { returns(Symbol) }
+                attr_accessor :type
+
+                # Optional canvas coordinates for rendering the target assistant as a node in
+                # authoring UIs. Pure presentation — the runtime ignores it; round-trips so
+                # frontends can persist graph layout across reloads. When multiple edges target
+                # the same assistant, each edge's `position` is independent (frontends typically
+                # use the first non-null one).
+                sig do
+                  returns(
+                    T.nilable(
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::Position
+                    )
+                  )
+                end
+                attr_reader :position
+
+                sig do
+                  params(
+                    position:
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::Position::OrHash
+                  ).void
+                end
+                attr_writer :position
+
+                # Voice behavior when handing off to the target assistant, mirroring the handoff
+                # tool's `voice_mode`. `unified` (default) keeps the current voice across the
+                # handoff; `distinct` lets the target assistant speak with its own configured
+                # voice. Only applies to assistant targets — node targets override voice via the
+                # node's own `voice_settings`.
+                sig do
+                  returns(
+                    T.nilable(
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::VoiceMode::TaggedSymbol
+                    )
+                  )
+                end
+                attr_reader :voice_mode
+
+                sig do
+                  params(
+                    voice_mode:
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::VoiceMode::OrSymbol
+                  ).void
+                end
+                attr_writer :voice_mode
+
+                # Edge target referencing a different assistant.
+                #
+                # When the edge fires, the conversation hands off to `assistant_id`: the active
+                # assistant on the conversation row is rewritten and the new assistant's flow
+                # starts at its own `start_node_id`. The current turn's LLM response is delivered
+                # to the user as-is; subsequent turns route to the new assistant.
+                sig do
+                  params(
+                    assistant_id: String,
+                    position:
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::Position::OrHash,
+                    voice_mode:
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::VoiceMode::OrSymbol,
+                    type: Symbol
+                  ).returns(T.attached_class)
+                end
+                def self.new(
+                  # ID of the assistant the conversation transitions to.
+                  assistant_id:,
+                  # Optional canvas coordinates for rendering the target assistant as a node in
+                  # authoring UIs. Pure presentation — the runtime ignores it; round-trips so
+                  # frontends can persist graph layout across reloads. When multiple edges target
+                  # the same assistant, each edge's `position` is independent (frontends typically
+                  # use the first non-null one).
+                  position: nil,
+                  # Voice behavior when handing off to the target assistant, mirroring the handoff
+                  # tool's `voice_mode`. `unified` (default) keeps the current voice across the
+                  # handoff; `distinct` lets the target assistant speak with its own configured
+                  # voice. Only applies to assistant targets — node targets override voice via the
+                  # node's own `voice_settings`.
+                  voice_mode: nil,
+                  type: :assistant
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      assistant_id: String,
+                      type: Symbol,
+                      position:
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::Position,
+                      voice_mode:
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::VoiceMode::TaggedSymbol
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                class Position < Telnyx::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::Position,
+                        Telnyx::Internal::AnyHash
+                      )
+                    end
+
+                  # Horizontal coordinate in the authoring canvas.
+                  sig { returns(Float) }
+                  attr_accessor :x
+
+                  # Vertical coordinate in the authoring canvas.
+                  sig { returns(Float) }
+                  attr_accessor :y_
+
+                  # Optional canvas coordinates for rendering the target assistant as a node in
+                  # authoring UIs. Pure presentation — the runtime ignores it; round-trips so
+                  # frontends can persist graph layout across reloads. When multiple edges target
+                  # the same assistant, each edge's `position` is independent (frontends typically
+                  # use the first non-null one).
+                  sig { params(x: Float, y_: Float).returns(T.attached_class) }
+                  def self.new(
+                    # Horizontal coordinate in the authoring canvas.
+                    x:,
+                    # Vertical coordinate in the authoring canvas.
+                    y_:
+                  )
+                  end
+
+                  sig { override.returns({ x: Float, y_: Float }) }
+                  def to_hash
+                  end
+                end
+
+                # Voice behavior when handing off to the target assistant, mirroring the handoff
+                # tool's `voice_mode`. `unified` (default) keeps the current voice across the
+                # handoff; `distinct` lets the target assistant speak with its own configured
+                # voice. Only applies to assistant targets — node targets override voice via the
+                # node's own `voice_settings`.
+                module VoiceMode
+                  extend Telnyx::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::VoiceMode
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  UNIFIED =
+                    T.let(
+                      :unified,
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::VoiceMode::TaggedSymbol
+                    )
+                  DISTINCT =
+                    T.let(
+                      :distinct,
+                      Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::VoiceMode::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Assistant::VoiceMode::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+              end
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Target::Variants
+                  ]
+                )
+              end
+              def self.variants
+              end
+            end
+          end
+        end
       end
     end
   end