telnyx 5.124.0 → 5.126.0

data/rbi/telnyx/models/ai/assistant_create_params.rbi

@@ -542,7 +542,8 @@ module Telnyx
               T::Array[
                 T.any(
                   Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Prompt,
-                  Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Tool
+                  Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Tool,
+                  Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak
                 )
               ]
             )
@@ -586,7 +587,8 @@ module Telnyx
                 T::Array[
                   T.any(
                     Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Prompt::OrHash,
-                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Tool::OrHash
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Tool::OrHash,
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::OrHash
                   )
                 ],
               start_node_id: String,
@@ -614,7 +616,8 @@ module Telnyx
                   T::Array[
                     T.any(
                       Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Prompt,
-                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Tool
+                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Tool,
+                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak
                     )
                   ],
                 start_node_id: String,
@@ -639,7 +642,8 @@ module Telnyx
               T.type_alias do
                 T.any(
                   Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Prompt,
-                  Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Tool
+                  Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Tool,
+                  Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak
                 )
               end
 
@@ -1234,6 +1238,192 @@ module Telnyx
               end
             end
 
+            class Speak < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak,
+                    Telnyx::Internal::AnyHash
+                  )
+                end
+
+              # Caller-supplied unique identifier for this node within the flow.
+              sig { returns(String) }
+              attr_accessor :id
+
+              # Message delivered to the user verbatim when the flow reaches this node. No LLM
+              # turn — the text is spoken/sent exactly as written. `{{variable}}` placeholders
+              # are interpolated from the conversation's dynamic variables; an unresolved
+              # placeholder renders as an empty string. After delivering, the flow routes via
+              # the node's outgoing `llm` / `expression` edges (commonly a single unconditional
+              # edge).
+              sig { returns(String) }
+              attr_accessor :message
+
+              # 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::AssistantCreateParams::ConversationFlow::Node::Speak::Position
+                  )
+                )
+              end
+              attr_reader :position
+
+              sig do
+                params(
+                  position:
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::Position::OrHash
+                ).void
+              end
+              attr_writer :position
+
+              # Node kind discriminator. Always `speak` for a speak node.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::Type::OrSymbol
+                  )
+                )
+              end
+              attr_reader :type
+
+              sig do
+                params(
+                  type:
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::Type::OrSymbol
+                ).void
+              end
+              attr_writer :type
+
+              # A standalone scripted-message step in a flow, as supplied by clients.
+              #
+              # Unlike a prompt node, a speak node has no instructions or model — it isn't an
+              # LLM turn. Reaching it delivers `message` to the user verbatim (with
+              # `{{variable}}` interpolation), then routes via outgoing `llm` / `expression`
+              # edges.
+              sig do
+                params(
+                  id: String,
+                  message: String,
+                  name: String,
+                  position:
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::Position::OrHash,
+                  type:
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::Type::OrSymbol
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # Caller-supplied unique identifier for this node within the flow.
+                id:,
+                # Message delivered to the user verbatim when the flow reaches this node. No LLM
+                # turn — the text is spoken/sent exactly as written. `{{variable}}` placeholders
+                # are interpolated from the conversation's dynamic variables; an unresolved
+                # placeholder renders as an empty string. After delivering, the flow routes via
+                # the node's outgoing `llm` / `expression` edges (commonly a single unconditional
+                # edge).
+                message:,
+                # 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 `speak` for a speak node.
+                type: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    id: String,
+                    message: String,
+                    name: String,
+                    position:
+                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::Position,
+                    type:
+                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::Type::OrSymbol
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Position < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::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 `speak` for a speak node.
+              module Type
+                extend Telnyx::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::Type
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                SPEAK =
+                  T.let(
+                    :speak,
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::Type::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Node::Speak::Type::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+            end
+
             sig do
               override.returns(
                 T::Array[
@@ -1264,7 +1454,8 @@ module Telnyx
               returns(
                 T.any(
                   Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Llm,
-                  Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Expression
+                  Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Expression,
+                  Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Default
                 )
               )
             end
@@ -1298,7 +1489,8 @@ module Telnyx
                 condition:
                   T.any(
                     Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Llm::OrHash,
-                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Expression::OrHash
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Expression::OrHash,
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Default::OrHash
                   ),
                 start_node_id: String,
                 target:
@@ -1329,7 +1521,8 @@ module Telnyx
                   condition:
                     T.any(
                       Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Llm,
-                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Expression
+                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Expression,
+                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Default
                     ),
                   start_node_id: String,
                   target:
@@ -1352,7 +1545,8 @@ module Telnyx
                 T.type_alias do
                   T.any(
                     Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Llm,
-                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Expression
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Expression,
+                    Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Default
                   )
                 end
 
@@ -1647,6 +1841,36 @@ module Telnyx
                 end
               end
 
+              class Default < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::AssistantCreateParams::ConversationFlow::Edge::Condition::Default,
+                      Telnyx::Internal::AnyHash
+                    )
+                  end
+
+                sig { returns(Symbol) }
+                attr_accessor :type
+
+                # Fallback edge condition: fires only when no other edge's condition is true.
+                #
+                # Evaluated after every conditioned (`llm` / `expression`) edge regardless of
+                # declaration order, so it routes the flow whenever none of the node's other
+                # outgoing edges match. Valid **only** on edges leaving a `tool` or `speak` node,
+                # where the deterministic step auto-advances and must always have somewhere to go.
+                # A tool/speak node with any outgoing edge is required to carry exactly one
+                # `default` edge so it never dead-ends; a tool/speak node with no outgoing edges
+                # is a valid terminal step. Carries no parameters.
+                sig { params(type: Symbol).returns(T.attached_class) }
+                def self.new(type: :default)
+                end
+
+                sig { override.returns({ type: Symbol }) }
+                def to_hash
+                end
+              end
+
               sig do
                 override.returns(
                   T::Array[

data/rbi/telnyx/models/ai/assistant_tool.rbi

@@ -305,6 +305,17 @@ module Telnyx
             end
             attr_writer :custom_headers
 
+            # A description of the transfer tool. By default, Telnyx generates this
+            # automatically based on the configured targets. Typically only set when importing
+            # an assistant from another provider that allowed a custom description; in that
+            # case the provided value is preserved. Most users should leave this empty and let
+            # Telnyx manage it.
+            sig { returns(T.nilable(String)) }
+            attr_reader :description
+
+            sig { params(description: String).void }
+            attr_writer :description
+
             # Configuration for voicemail detection (AMD - Answering Machine Detection) on the
             # transferred call. Allows the assistant to detect when a voicemail system answers
             # the transferred call and take appropriate action.
@@ -349,6 +360,7 @@ module Telnyx
                   T::Array[
                     Telnyx::AI::AssistantTool::Transfer::Transfer::CustomHeader::OrHash
                   ],
+                description: String,
                 voicemail_detection:
                   Telnyx::AI::AssistantTool::Transfer::Transfer::VoicemailDetection::OrHash,
                 warm_message_delay_ms: T.nilable(Integer),
@@ -365,6 +377,12 @@ module Telnyx
               targets:,
               # Custom headers to be added to the SIP INVITE for the transfer command.
               custom_headers: nil,
+              # A description of the transfer tool. By default, Telnyx generates this
+              # automatically based on the configured targets. Typically only set when importing
+              # an assistant from another provider that allowed a custom description; in that
+              # case the provided value is preserved. Most users should leave this empty and let
+              # Telnyx manage it.
+              description: nil,
               # Configuration for voicemail detection (AMD - Answering Machine Detection) on the
               # transferred call. Allows the assistant to detect when a voicemail system answers
               # the transferred call and take appropriate action.
@@ -390,6 +408,7 @@ module Telnyx
                     T::Array[
                       Telnyx::AI::AssistantTool::Transfer::Transfer::CustomHeader
                     ],
+                  description: String,
                   voicemail_detection:
                     Telnyx::AI::AssistantTool::Transfer::Transfer::VoicemailDetection,
                   warm_message_delay_ms: T.nilable(Integer),

data/rbi/telnyx/models/ai/assistant_update_params.rbi

@@ -578,7 +578,8 @@ module Telnyx
               T::Array[
                 T.any(
                   Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Prompt,
-                  Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Tool
+                  Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Tool,
+                  Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak
                 )
               ]
             )
@@ -622,7 +623,8 @@ module Telnyx
                 T::Array[
                   T.any(
                     Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Prompt::OrHash,
-                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Tool::OrHash
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Tool::OrHash,
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::OrHash
                   )
                 ],
               start_node_id: String,
@@ -650,7 +652,8 @@ module Telnyx
                   T::Array[
                     T.any(
                       Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Prompt,
-                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Tool
+                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Tool,
+                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak
                     )
                   ],
                 start_node_id: String,
@@ -675,7 +678,8 @@ module Telnyx
               T.type_alias do
                 T.any(
                   Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Prompt,
-                  Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Tool
+                  Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Tool,
+                  Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak
                 )
               end
 
@@ -1270,6 +1274,192 @@ module Telnyx
               end
             end
 
+            class Speak < Telnyx::Internal::Type::BaseModel
+              OrHash =
+                T.type_alias do
+                  T.any(
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak,
+                    Telnyx::Internal::AnyHash
+                  )
+                end
+
+              # Caller-supplied unique identifier for this node within the flow.
+              sig { returns(String) }
+              attr_accessor :id
+
+              # Message delivered to the user verbatim when the flow reaches this node. No LLM
+              # turn — the text is spoken/sent exactly as written. `{{variable}}` placeholders
+              # are interpolated from the conversation's dynamic variables; an unresolved
+              # placeholder renders as an empty string. After delivering, the flow routes via
+              # the node's outgoing `llm` / `expression` edges (commonly a single unconditional
+              # edge).
+              sig { returns(String) }
+              attr_accessor :message
+
+              # 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::AssistantUpdateParams::ConversationFlow::Node::Speak::Position
+                  )
+                )
+              end
+              attr_reader :position
+
+              sig do
+                params(
+                  position:
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::Position::OrHash
+                ).void
+              end
+              attr_writer :position
+
+              # Node kind discriminator. Always `speak` for a speak node.
+              sig do
+                returns(
+                  T.nilable(
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::Type::OrSymbol
+                  )
+                )
+              end
+              attr_reader :type
+
+              sig do
+                params(
+                  type:
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::Type::OrSymbol
+                ).void
+              end
+              attr_writer :type
+
+              # A standalone scripted-message step in a flow, as supplied by clients.
+              #
+              # Unlike a prompt node, a speak node has no instructions or model — it isn't an
+              # LLM turn. Reaching it delivers `message` to the user verbatim (with
+              # `{{variable}}` interpolation), then routes via outgoing `llm` / `expression`
+              # edges.
+              sig do
+                params(
+                  id: String,
+                  message: String,
+                  name: String,
+                  position:
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::Position::OrHash,
+                  type:
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::Type::OrSymbol
+                ).returns(T.attached_class)
+              end
+              def self.new(
+                # Caller-supplied unique identifier for this node within the flow.
+                id:,
+                # Message delivered to the user verbatim when the flow reaches this node. No LLM
+                # turn — the text is spoken/sent exactly as written. `{{variable}}` placeholders
+                # are interpolated from the conversation's dynamic variables; an unresolved
+                # placeholder renders as an empty string. After delivering, the flow routes via
+                # the node's outgoing `llm` / `expression` edges (commonly a single unconditional
+                # edge).
+                message:,
+                # 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 `speak` for a speak node.
+                type: nil
+              )
+              end
+
+              sig do
+                override.returns(
+                  {
+                    id: String,
+                    message: String,
+                    name: String,
+                    position:
+                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::Position,
+                    type:
+                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::Type::OrSymbol
+                  }
+                )
+              end
+              def to_hash
+              end
+
+              class Position < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::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 `speak` for a speak node.
+              module Type
+                extend Telnyx::Internal::Type::Enum
+
+                TaggedSymbol =
+                  T.type_alias do
+                    T.all(
+                      Symbol,
+                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::Type
+                    )
+                  end
+                OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+                SPEAK =
+                  T.let(
+                    :speak,
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::Type::TaggedSymbol
+                  )
+
+                sig do
+                  override.returns(
+                    T::Array[
+                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Node::Speak::Type::TaggedSymbol
+                    ]
+                  )
+                end
+                def self.values
+                end
+              end
+            end
+
             sig do
               override.returns(
                 T::Array[
@@ -1300,7 +1490,8 @@ module Telnyx
               returns(
                 T.any(
                   Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Llm,
-                  Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Expression
+                  Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Expression,
+                  Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Default
                 )
               )
             end
@@ -1334,7 +1525,8 @@ module Telnyx
                 condition:
                   T.any(
                     Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Llm::OrHash,
-                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Expression::OrHash
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Expression::OrHash,
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Default::OrHash
                   ),
                 start_node_id: String,
                 target:
@@ -1365,7 +1557,8 @@ module Telnyx
                   condition:
                     T.any(
                       Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Llm,
-                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Expression
+                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Expression,
+                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Default
                     ),
                   start_node_id: String,
                   target:
@@ -1388,7 +1581,8 @@ module Telnyx
                 T.type_alias do
                   T.any(
                     Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Llm,
-                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Expression
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Expression,
+                    Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Default
                   )
                 end
 
@@ -1683,6 +1877,36 @@ module Telnyx
                 end
               end
 
+              class Default < Telnyx::Internal::Type::BaseModel
+                OrHash =
+                  T.type_alias do
+                    T.any(
+                      Telnyx::AI::AssistantUpdateParams::ConversationFlow::Edge::Condition::Default,
+                      Telnyx::Internal::AnyHash
+                    )
+                  end
+
+                sig { returns(Symbol) }
+                attr_accessor :type
+
+                # Fallback edge condition: fires only when no other edge's condition is true.
+                #
+                # Evaluated after every conditioned (`llm` / `expression`) edge regardless of
+                # declaration order, so it routes the flow whenever none of the node's other
+                # outgoing edges match. Valid **only** on edges leaving a `tool` or `speak` node,
+                # where the deterministic step auto-advances and must always have somewhere to go.
+                # A tool/speak node with any outgoing edge is required to carry exactly one
+                # `default` edge so it never dead-ends; a tool/speak node with no outgoing edges
+                # is a valid terminal step. Carries no parameters.
+                sig { params(type: Symbol).returns(T.attached_class) }
+                def self.new(type: :default)
+                end
+
+                sig { override.returns({ type: Symbol }) }
+                def to_hash
+                end
+              end
+
               sig do
                 override.returns(
                   T::Array[