telnyx 5.170.0 → 5.171.0

data/rbi/telnyx/models/ai/tool_node_req.rbi

@@ -15,13 +15,26 @@ module Telnyx
 
         # 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.
+        # `llm` / `expression` edges route the flow on the tool's 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 message delivered to the user verbatim immediately before the tool
+        # executes — an announcement such as 'One moment while I look that up.' No LLM
+        # turn and no customer turn: the message is spoken/sent, then the tool runs, in
+        # the same deterministic step. `{{variable}}` placeholders are interpolated from
+        # the conversation's dynamic variables (unresolved → empty string); the tool's own
+        # result is not yet available when the message is rendered. Omit for a silent tool
+        # step.
+        sig { returns(T.nilable(String)) }
+        attr_reader :message
+
+        sig { params(message: String).void }
+        attr_writer :message
+
         # Optional human-readable label, displayed in authoring UIs.
         sig { returns(T.nilable(String)) }
         attr_reader :name
@@ -49,12 +62,15 @@ module Telnyx
         #
         # 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.
+        # matching dynamic variables by name), then routes via outgoing `llm` /
+        # `expression` edges, with exactly one `default` fallback edge required when the
+        # node has any outgoing edges (the tool's outcome is readable as
+        # `telnyx_last_tool_status_code` in `expression` conditions).
         sig do
           params(
             id: String,
             shared_tool_id: String,
+            message: String,
             name: String,
             position: Telnyx::AI::NodePosition::OrHash,
             type: Telnyx::AI::ToolNodeReq::Type::OrSymbol
@@ -65,11 +81,19 @@ module Telnyx
           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.
+          # `llm` / `expression` edges route the flow on the tool's 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 message delivered to the user verbatim immediately before the tool
+          # executes — an announcement such as 'One moment while I look that up.' No LLM
+          # turn and no customer turn: the message is spoken/sent, then the tool runs, in
+          # the same deterministic step. `{{variable}}` placeholders are interpolated from
+          # the conversation's dynamic variables (unresolved → empty string); the tool's own
+          # result is not yet available when the message is rendered. Omit for a silent tool
+          # step.
+          message: nil,
           # Optional human-readable label, displayed in authoring UIs.
           name: nil,
           # Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
@@ -86,6 +110,7 @@ module Telnyx
             {
               id: String,
               shared_tool_id: String,
+              message: String,
               name: String,
               position: Telnyx::AI::NodePosition,
               type: Telnyx::AI::ToolNodeReq::Type::OrSymbol