telnyx 5.122.0 → 5.124.0

data/rbi/telnyx/models/ai/assistants/update_assistant.rbi

@@ -15,6 +15,28 @@ module Telnyx
               )
             end
 
+          # Conversation flow as supplied by API clients (create / update).
+          #
+          # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
+          # unique node/edge IDs, that `start_node_id` references a real node, and that
+          # every edge's endpoints reference real nodes.
+          sig do
+            returns(
+              T.nilable(
+                Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow
+              )
+            )
+          end
+          attr_reader :conversation_flow
+
+          sig do
+            params(
+              conversation_flow:
+                Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::OrHash
+            ).void
+          end
+          attr_writer :conversation_flow
+
           sig { returns(T.nilable(String)) }
           attr_reader :description
 
@@ -333,6 +355,8 @@ module Telnyx
 
           sig do
             params(
+              conversation_flow:
+                Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::OrHash,
               description: String,
               dynamic_variables: T::Hash[Symbol, T.anything],
               dynamic_variables_webhook_timeout_ms: Integer,
@@ -380,6 +404,12 @@ module Telnyx
             ).returns(T.attached_class)
           end
           def self.new(
+            # Conversation flow as supplied by API clients (create / update).
+            #
+            # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
+            # unique node/edge IDs, that `start_node_id` references a real node, and that
+            # every edge's endpoints reference real nodes.
+            conversation_flow: nil,
             description: nil,
             # Map of dynamic variables and their default values
             dynamic_variables: nil,
@@ -473,6 +503,8 @@ module Telnyx
           sig do
             override.returns(
               {
+                conversation_flow:
+                  Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow,
                 description: String,
                 dynamic_variables: T::Hash[Symbol, T.anything],
                 dynamic_variables_webhook_timeout_ms: Integer,
@@ -523,6 +555,1391 @@ module Telnyx
           end
           def to_hash
           end
+
+          class ConversationFlow < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # All nodes in the flow. Must contain `start_node_id`. Each node is a prompt node
+            # (`type: prompt`) or a tool node (`type: tool`).
+            sig do
+              returns(
+                T::Array[
+                  T.any(
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt,
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool
+                  )
+                ]
+              )
+            end
+            attr_accessor :nodes
+
+            # ID of the node where the conversation begins.
+            sig { returns(String) }
+            attr_accessor :start_node_id
+
+            # Directed transitions between nodes. May be empty for a single-node flow.
+            sig do
+              returns(
+                T.nilable(
+                  T::Array[
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge
+                  ]
+                )
+              )
+            end
+            attr_reader :edges
+
+            sig do
+              params(
+                edges:
+                  T::Array[
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::OrHash
+                  ]
+              ).void
+            end
+            attr_writer :edges
+
+            # Conversation flow as supplied by API clients (create / update).
+            #
+            # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
+            # unique node/edge IDs, that `start_node_id` references a real node, and that
+            # every edge's endpoints reference real nodes.
+            sig do
+              params(
+                nodes:
+                  T::Array[
+                    T.any(
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::OrHash,
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::OrHash
+                    )
+                  ],
+                start_node_id: String,
+                edges:
+                  T::Array[
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::OrHash
+                  ]
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # All nodes in the flow. Must contain `start_node_id`. Each node is a prompt node
+              # (`type: prompt`) or a tool node (`type: tool`).
+              nodes:,
+              # ID of the node where the conversation begins.
+              start_node_id:,
+              # Directed transitions between nodes. May be empty for a single-node flow.
+              edges: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  nodes:
+                    T::Array[
+                      T.any(
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt,
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool
+                      )
+                    ],
+                  start_node_id: String,
+                  edges:
+                    T::Array[
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge
+                    ]
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # One step in a conversation flow, as supplied by API clients.
+            #
+            # Each node carries the prompt, tool scope, and optional overrides for
+            # model/voice/transcription. Unset overrides cascade from the assistant.
+            module Node
+              extend Telnyx::Internal::Type::Union
+
+              Variants =
+                T.type_alias do
+                  T.any(
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt,
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool
+                  )
+                end
+
+              class Prompt < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::Assistants::UpdateAssistant::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::ExternalLlmReq)) }
+                attr_reader :external_llm
+
+                sig do
+                  params(external_llm: Telnyx::AI::ExternalLlmReq::OrHash).void
+                end
+                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::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::InstructionsMode::OrSymbol
+                    )
+                  )
+                end
+                attr_reader :instructions_mode
+
+                sig do
+                  params(
+                    instructions_mode:
+                      Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::Position
+                    )
+                  )
+                end
+                attr_reader :position
+
+                sig do
+                  params(
+                    position:
+                      Telnyx::AI::Assistants::UpdateAssistant::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
+
+                # 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::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::ToolsMode::OrSymbol
+                    )
+                  )
+                end
+                attr_reader :tools_mode
+
+                sig do
+                  params(
+                    tools_mode:
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::ToolsMode::OrSymbol
+                  ).void
+                end
+                attr_writer :tools_mode
+
+                # Per-node transcription override (model/language/region). Unset fields cascade
+                # from the assistant-level transcription.
+                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` (default) is an LLM-driven step; `tool` is a
+                # standalone tool execution (see `ToolNodeReq`).
+                sig do
+                  returns(
+                    T.nilable(
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::Type::OrSymbol
+                    )
+                  )
+                end
+                attr_reader :type
+
+                sig do
+                  params(
+                    type:
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::Type::OrSymbol
+                  ).void
+                end
+                attr_writer :type
+
+                # Per-node voice override. Only fields set here override the assistant-level voice
+                # settings; unset fields cascade.
+                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 supplied by API clients.
+                #
+                # Each node carries the prompt, tool scope, and optional overrides for
+                # model/voice/transcription. Unset overrides cascade from the assistant.
+                sig do
+                  params(
+                    id: String,
+                    instructions: String,
+                    external_llm: Telnyx::AI::ExternalLlmReq::OrHash,
+                    instructions_mode:
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::InstructionsMode::OrSymbol,
+                    llm_api_key_ref: String,
+                    model: String,
+                    name: String,
+                    position:
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::Position::OrHash,
+                    shared_tool_ids: T::Array[String],
+                    tools_mode:
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::ToolsMode::OrSymbol,
+                    transcription: Telnyx::AI::TranscriptionSettings::OrHash,
+                    type:
+                      Telnyx::AI::Assistants::UpdateAssistant::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,
+                  # 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 (model/language/region). Unset fields cascade
+                  # from the assistant-level transcription.
+                  transcription: nil,
+                  # Node kind discriminator. `prompt` (default) is an LLM-driven step; `tool` is a
+                  # standalone tool execution (see `ToolNodeReq`).
+                  type: nil,
+                  # Per-node voice override. Only fields set here override the assistant-level voice
+                  # settings; unset fields cascade.
+                  voice_settings: nil
+                )
+                end
+
+                sig do
+                  override.returns(
+                    {
+                      id: String,
+                      instructions: String,
+                      external_llm: Telnyx::AI::ExternalLlmReq,
+                      instructions_mode:
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::InstructionsMode::OrSymbol,
+                      llm_api_key_ref: String,
+                      model: String,
+                      name: String,
+                      position:
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::Position,
+                      shared_tool_ids: T::Array[String],
+                      tools_mode:
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::ToolsMode::OrSymbol,
+                      transcription: Telnyx::AI::TranscriptionSettings,
+                      type:
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::Type::OrSymbol,
+                      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::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::InstructionsMode
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  REPLACE =
+                    T.let(
+                      :replace,
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::InstructionsMode::TaggedSymbol
+                    )
+                  APPEND =
+                    T.let(
+                      :append,
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::InstructionsMode::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::ToolsMode
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  REPLACE =
+                    T.let(
+                      :replace,
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::ToolsMode::TaggedSymbol
+                    )
+                  APPEND =
+                    T.let(
+                      :append,
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::ToolsMode::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::ToolsMode::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+
+                # Node kind discriminator. `prompt` (default) is an LLM-driven step; `tool` is a
+                # standalone tool execution (see `ToolNodeReq`).
+                module Type
+                  extend Telnyx::Internal::Type::Enum
+
+                  TaggedSymbol =
+                    T.type_alias do
+                      T.all(
+                        Symbol,
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::Type
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  PROMPT =
+                    T.let(
+                      :prompt,
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Prompt::Type::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::Position
+                    )
+                  )
+                end
+                attr_reader :position
+
+                sig do
+                  params(
+                    position:
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::Position::OrHash
+                  ).void
+                end
+                attr_writer :position
+
+                # Node kind discriminator. Always `tool` for a tool node.
+                sig do
+                  returns(
+                    T.nilable(
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::Type::OrSymbol
+                    )
+                  )
+                end
+                attr_reader :type
+
+                sig do
+                  params(
+                    type:
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::Type::OrSymbol
+                  ).void
+                end
+                attr_writer :type
+
+                # A standalone tool step in a conversation flow, as supplied by clients.
+                #
+                # Unlike a prompt node, a tool node has no instructions or model — it isn't an LLM
+                # turn. Reaching it deterministically runs one shared tool (arguments filled from
+                # matching dynamic variables by name), then routes on the result via outgoing
+                # `tool_result` edges.
+                sig do
+                  params(
+                    id: String,
+                    shared_tool_id: String,
+                    name: String,
+                    position:
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::Position::OrHash,
+                    type:
+                      Telnyx::AI::Assistants::UpdateAssistant::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,
+                  # 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::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::Position,
+                      type:
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::Type::OrSymbol
+                    }
+                  )
+                end
+                def to_hash
+                end
+
+                class Position < Telnyx::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::Type
+                      )
+                    end
+                  OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                  TOOL =
+                    T.let(
+                      :tool,
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::Type::TaggedSymbol
+                    )
+
+                  sig do
+                    override.returns(
+                      T::Array[
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Tool::Type::TaggedSymbol
+                      ]
+                    )
+                  end
+                  def self.values
+                  end
+                end
+              end
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Node::Variants
+                  ]
+                )
+              end
+              def self.variants
+              end
+            end
+
+            class Edge < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::AI::Assistants::UpdateAssistant::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(
+                  T.any(
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Llm,
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression
+                  )
+                )
+              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(
+                  T.any(
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Node,
+                    Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant
+                  )
+                )
+              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::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Llm::OrHash,
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::OrHash
+                    ),
+                  start_node_id: String,
+                  target:
+                    T.any(
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Node::OrHash,
+                      Telnyx::AI::Assistants::UpdateAssistant::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:
+                      T.any(
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Llm,
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression
+                      ),
+                    start_node_id: String,
+                    target:
+                      T.any(
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Node,
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant
+                      )
+                  }
+                )
+              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::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Llm,
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression
+                    )
+                  end
+
+                class Llm < Telnyx::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::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(
+                      T.any(
+                        T.anything,
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::DynamicVariableExpression,
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::StringLiteralExpression,
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::NumberLiteralExpression,
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::BooleanLiteralExpression
+                      )
+                    )
+                  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::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::DynamicVariableExpression::OrHash,
+                          Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::StringLiteralExpression::OrHash,
+                          Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::NumberLiteralExpression::OrHash,
+                          Telnyx::AI::Assistants::UpdateAssistant::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:
+                          T.any(
+                            T.anything,
+                            Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::DynamicVariableExpression,
+                            Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::StringLiteralExpression,
+                            Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::NumberLiteralExpression,
+                            Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::BooleanLiteralExpression
+                          ),
+                        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::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::DynamicVariableExpression,
+                          Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::StringLiteralExpression,
+                          Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::NumberLiteralExpression,
+                          Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::BooleanLiteralExpression
+                        )
+                      end
+
+                    class DynamicVariableExpression < Telnyx::Internal::Type::BaseModel
+                      OrHash =
+                        T.type_alias do
+                          T.any(
+                            Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::ConversationFlow::Edge::Condition::Expression::Expression::Variants
+                        ]
+                      )
+                    end
+                    def self.variants
+                    end
+                  end
+                end
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Node,
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant
+                    )
+                  end
+
+                class Node < Telnyx::Internal::Type::BaseModel
+                  OrHash =
+                    T.type_alias do
+                      T.any(
+                        Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant::Position
+                      )
+                    )
+                  end
+                  attr_reader :position
+
+                  sig do
+                    params(
+                      position:
+                        Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant::VoiceMode::OrSymbol
+                      )
+                    )
+                  end
+                  attr_reader :voice_mode
+
+                  sig do
+                    params(
+                      voice_mode:
+                        Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant::Position::OrHash,
+                      voice_mode:
+                        Telnyx::AI::Assistants::UpdateAssistant::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::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant::Position,
+                        voice_mode:
+                          Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant::VoiceMode::OrSymbol
+                      }
+                    )
+                  end
+                  def to_hash
+                  end
+
+                  class Position < Telnyx::Internal::Type::BaseModel
+                    OrHash =
+                      T.type_alias do
+                        T.any(
+                          Telnyx::AI::Assistants::UpdateAssistant::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 do
+                      params(x: Float, y_: Float).returns(T.attached_class)
+                    end
+                    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::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant::VoiceMode
+                        )
+                      end
+                    OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                    UNIFIED =
+                      T.let(
+                        :unified,
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant::VoiceMode::TaggedSymbol
+                      )
+                    DISTINCT =
+                      T.let(
+                        :distinct,
+                        Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant::VoiceMode::TaggedSymbol
+                      )
+
+                    sig do
+                      override.returns(
+                        T::Array[
+                          Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Assistant::VoiceMode::TaggedSymbol
+                        ]
+                      )
+                    end
+                    def self.values
+                    end
+                  end
+                end
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::Edge::Target::Variants
+                    ]
+                  )
+                end
+                def self.variants
+                end
+              end
+            end
+          end
         end
       end
     end