telnyx 5.125.0 → 5.126.0

data/lib/telnyx/models/ai/inference_embedding.rb

@@ -314,7 +314,7 @@ module Telnyx
           # @!attribute nodes
           #   All nodes in the flow.
           #
-          #   @return [Array<Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Prompt, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Tool>]
+          #   @return [Array<Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Prompt, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Tool, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Speak>]
           required :nodes,
                    -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::InferenceEmbedding::ConversationFlow::Node] }
 
@@ -334,7 +334,7 @@ module Telnyx
           # @!method initialize(nodes:, start_node_id:, edges: nil)
           #   Conversation flow as returned by the API.
           #
-          #   @param nodes [Array<Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Prompt, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Tool>] All nodes in the flow.
+          #   @param nodes [Array<Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Prompt, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Tool, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Speak>] All nodes in the flow.
           #
           #   @param start_node_id [String] ID of the node where the conversation begins.
           #
@@ -352,6 +352,9 @@ module Telnyx
             # A standalone tool step in a conversation flow, as returned by the API.
             variant :tool, -> { Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Tool }
 
+            # A standalone scripted-message step in a flow, as returned by the API.
+            variant :speak, -> { Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Speak }
+
             class Prompt < Telnyx::Internal::Type::BaseModel
               # @!attribute id
               #   Caller-supplied unique identifier for this node within the flow.
@@ -663,8 +666,100 @@ module Telnyx
               end
             end
 
+            class Speak < Telnyx::Internal::Type::BaseModel
+              # @!attribute id
+              #   Caller-supplied unique identifier for this node within the flow.
+              #
+              #   @return [String]
+              required :id, String
+
+              # @!attribute message
+              #   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).
+              #
+              #   @return [String]
+              required :message, String
+
+              # @!attribute name
+              #   Optional human-readable label, displayed in authoring UIs.
+              #
+              #   @return [String, nil]
+              optional :name, String
+
+              # @!attribute position
+              #   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.
+              #
+              #   @return [Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Speak::Position, nil]
+              optional :position, -> { Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Speak::Position }
+
+              # @!attribute type
+              #   Node kind discriminator. Always `speak` for a speak node.
+              #
+              #   @return [Symbol, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Speak::Type, nil]
+              optional :type, enum: -> { Telnyx::AI::InferenceEmbedding::ConversationFlow::Node::Speak::Type }
+
+              # @!method initialize(id:, message:, name: nil, position: nil, type: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Speak} for more
+              #   details.
+              #
+              #   A standalone scripted-message step in a flow, as returned by the API.
+              #
+              #   @param id [String] Caller-supplied unique identifier for this node within the flow.
+              #
+              #   @param message [String] Message delivered to the user verbatim when the flow reaches this node. No LLM t
+              #
+              #   @param name [String] Optional human-readable label, displayed in authoring UIs.
+              #
+              #   @param position [Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Speak::Position] Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
+              #
+              #   @param type [Symbol, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Speak::Type] Node kind discriminator. Always `speak` for a speak node.
+
+              # @see Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Speak#position
+              class Position < Telnyx::Internal::Type::BaseModel
+                # @!attribute x
+                #   Horizontal coordinate in the authoring canvas.
+                #
+                #   @return [Float]
+                required :x, Float
+
+                # @!attribute y_
+                #   Vertical coordinate in the authoring canvas.
+                #
+                #   @return [Float]
+                required :y_, Float, api_name: :y
+
+                # @!method initialize(x:, 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.
+                #
+                #   @param x [Float] Horizontal coordinate in the authoring canvas.
+                #
+                #   @param y_ [Float] Vertical coordinate in the authoring canvas.
+              end
+
+              # Node kind discriminator. Always `speak` for a speak node.
+              #
+              # @see Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Speak#type
+              module Type
+                extend Telnyx::Internal::Type::Enum
+
+                SPEAK = :speak
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
             # @!method self.variants
-            #   @return [Array(Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Prompt, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Tool)]
+            #   @return [Array(Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Prompt, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Tool, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Speak)]
           end
 
           class Edge < Telnyx::Internal::Type::BaseModel
@@ -678,7 +773,7 @@ module Telnyx
             #   Condition that gates the transition. Discriminated by `type`: `llm`,
             #   `expression`.
             #
-            #   @return [Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Llm, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression]
+            #   @return [Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Llm, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Default]
             required :condition, union: -> { Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition }
 
             # @!attribute start_node_id
@@ -708,7 +803,7 @@ module Telnyx
             #
             #   @param id [String] Caller-supplied unique identifier for this edge within the flow.
             #
-            #   @param condition [Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Llm, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression] Condition that gates the transition. Discriminated by `type`: `llm`, `expression
+            #   @param condition [Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Llm, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Default] Condition that gates the transition. Discriminated by `type`: `llm`, `expression
             #
             #   @param start_node_id [String] ID of the node this edge transitions away from.
             #
@@ -737,6 +832,17 @@ module Telnyx
               # a clean function of known variables — it's cheaper and predictable.
               variant :expression, -> { Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression }
 
+              # 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.
+              variant :default, -> { Telnyx::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Default }
+
               class Llm < Telnyx::Internal::Type::BaseModel
                 # @!attribute prompt
                 #   Natural-language criterion the LLM judges as true/false.
@@ -912,8 +1018,28 @@ module Telnyx
                 end
               end
 
+              class Default < Telnyx::Internal::Type::BaseModel
+                # @!attribute type
+                #
+                #   @return [Symbol, :default]
+                required :type, const: :default
+
+                # @!method initialize(type: :default)
+                #   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.
+                #
+                #   @param type [Symbol, :default]
+              end
+
               # @!method self.variants
-              #   @return [Array(Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Llm, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression)]
+              #   @return [Array(Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Llm, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Expression, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Edge::Condition::Default)]
             end
 
             # Destination of the transition. Discriminated by `type`: `node` (jump to another

data/lib/telnyx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telnyx
-  VERSION = "5.125.0"
+  VERSION = "5.126.0"
 end

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[