telnyx 5.169.0 → 5.171.0

data/lib/telnyx/models/ai/memory/namespaces/profiles/source_list_params.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Sources#list
+            class SourceListParams < Telnyx::Internal::Type::BaseModel
+              extend Telnyx::Internal::Type::RequestParameters::Converter
+              include Telnyx::Internal::Type::RequestParameters
+
+              # @!attribute namespace
+              #
+              #   @return [String]
+              required :namespace, String
+
+              # @!attribute profile_id
+              #
+              #   @return [String]
+              required :profile_id, String
+
+              # @!attribute page_number
+              #   The page to return, counting from 1. Bounded in depth: (page[number] - 1) \*
+              #   page[size] may be at most 10000.
+              #
+              #   @return [Integer, nil]
+              optional :page_number, Integer
+
+              # @!attribute page_size
+              #   How many results a page holds.
+              #
+              #   @return [Integer, nil]
+              optional :page_size, Integer
+
+              # @!attribute session_id
+              #   An ingested session, by the `session_id` it was ingested with. Narrows the
+              #   request to the source that session was stored as.
+              #
+              #   @return [String, nil]
+              optional :session_id, String, nil?: true
+
+              # @!method initialize(namespace:, profile_id:, page_number: nil, page_size: nil, session_id: nil, request_options: {})
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceListParams} for more
+              #   details.
+              #
+              #   @param namespace [String]
+              #
+              #   @param profile_id [String]
+              #
+              #   @param page_number [Integer] The page to return, counting from 1. Bounded in depth: (page[number] - 1) \*
+              #   page
+              #
+              #   @param page_size [Integer] How many results a page holds.
+              #
+              #   @param session_id [String, nil] An ingested session, by the `session_id` it was ingested with. Narrows the reque
+              #
+              #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/profiles/source_retrieve_params.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Sources#retrieve
+            class SourceRetrieveParams < Telnyx::Internal::Type::BaseModel
+              extend Telnyx::Internal::Type::RequestParameters::Converter
+              include Telnyx::Internal::Type::RequestParameters
+
+              # @!attribute namespace
+              #   The namespace. `default` exists for every organization.
+              #
+              #   @return [String]
+              required :namespace, String
+
+              # @!attribute profile_id
+              #   The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              #   @return [String]
+              required :profile_id, String
+
+              # @!attribute source_id
+              #   Identifies one source within its profile: an ingested session, or one remembered
+              #   fact. Returned by `ingest` and `remember` when the write is accepted.
+              #   Re-ingesting a session keeps its source id.
+              #
+              #   @return [String]
+              required :source_id, String
+
+              # @!method initialize(namespace:, profile_id:, source_id:, request_options: {})
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveParams} for
+              #   more details.
+              #
+              #   @param namespace [String] The namespace. `default` exists for every organization.
+              #
+              #   @param profile_id [String] The profile: your identifier for the user, caller or agent this memory is about.
+              #
+              #   @param source_id [String] Identifies one source within its profile: an ingested session, or one remembered
+              #
+              #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/profiles/source_retrieve_response.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          module Profiles
+            # @see Telnyx::Resources::AI::Memory::Namespaces::Profiles::Sources#retrieve
+            class SourceRetrieveResponse < Telnyx::Internal::Type::BaseModel
+              # @!attribute data
+              #
+              #   @return [Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data]
+              required :data, -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data }
+
+              # @!method initialize(data:)
+              #   @param data [Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data]
+
+              # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse#data
+              class Data < Telnyx::Internal::Type::BaseModel
+                # @!attribute id
+                #   Identifies one source within its profile: an ingested session, or one remembered
+                #   fact. Returned by `ingest` and `remember` when the write is accepted.
+                #   Re-ingesting a session keeps its source id.
+                #
+                #   @return [String]
+                required :id, String
+
+                # @!attribute content
+                #   What was stored, in the shape it was sent: an ingested JSON body as JSON, a
+                #   string body or a remembered fact as a string. A session ingested before formats
+                #   were recorded is returned as the text it was stored as.
+                #
+                #   @return [Hash{Symbol=>Object}, Array<Object>, String, Float, Boolean]
+                required :content,
+                         union: -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content }
+
+                # @!attribute memory_count
+                #   Memories extracted from this source. A memory derived from several sources is
+                #   not counted here.
+                #
+                #   @return [Integer]
+                required :memory_count, Integer
+
+                # @!attribute session_id
+                #   The session this source was ingested as. Null for a remembered fact.
+                #
+                #   @return [String, nil]
+                required :session_id, String, nil?: true
+
+                # @!attribute created_at
+                #   When the source was first stored.
+                #
+                #   @return [String, nil]
+                optional :created_at, String, nil?: true
+
+                # @!attribute updated_at
+                #   When the source was last written; re-ingesting moves it.
+                #
+                #   @return [String, nil]
+                optional :updated_at, String, nil?: true
+
+                # @!method initialize(id:, content:, memory_count:, session_id:, created_at: nil, updated_at: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data}
+                #   for more details.
+                #
+                #   @param id [String] Identifies one source within its profile: an ingested session, or one remembered
+                #
+                #   @param content [Hash{Symbol=>Object}, Array<Object>, String, Float, Boolean] What was stored, in the shape it was sent: an ingested JSON body as JSON, a stri
+                #
+                #   @param memory_count [Integer] Memories extracted from this source. A memory derived from several sources is no
+                #
+                #   @param session_id [String, nil] The session this source was ingested as. Null for a remembered fact.
+                #
+                #   @param created_at [String, nil] When the source was first stored.
+                #
+                #   @param updated_at [String, nil] When the source was last written; re-ingesting moves it.
+
+                # What was stored, in the shape it was sent: an ingested JSON body as JSON, a
+                # string body or a remembered fact as a string. A session ingested before formats
+                # were recorded is returned as the text it was stored as.
+                #
+                # @see Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data#content
+                module Content
+                  extend Telnyx::Internal::Type::Union
+
+                  variant -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::UnionMember0Map }
+
+                  variant union: -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::UnionMember1 }
+
+                  module UnionMember1
+                    extend Telnyx::Internal::Type::Union
+
+                    variant -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::UnionMember1::UnionMember0Array }
+
+                    variant String
+
+                    variant Float
+
+                    variant Telnyx::Internal::Type::Boolean
+
+                    # @!method self.variants
+                    #   @return [Array(Array<Object>, String, Float, Boolean)]
+
+                    # @type [Telnyx::Internal::Type::Converter]
+                    UnionMember0Array = Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
+                  end
+
+                  # @!method self.variants
+                  #   @return [Array(Hash{Symbol=>Object}, Array<Object>, String, Float, Boolean)]
+
+                  # @type [Telnyx::Internal::Type::Converter]
+                  UnionMember0Map = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/setting_list_params.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          # @see Telnyx::Resources::AI::Memory::Namespaces::Settings#list
+          class SettingListParams < Telnyx::Internal::Type::BaseModel
+            extend Telnyx::Internal::Type::RequestParameters::Converter
+            include Telnyx::Internal::Type::RequestParameters
+
+            # @!attribute namespace
+            #   The namespace. `default` exists for every organization.
+            #
+            #   @return [String]
+            required :namespace, String
+
+            # @!method initialize(namespace:, request_options: {})
+            #   @param namespace [String] The namespace. `default` exists for every organization.
+            #
+            #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/setting_patch_all_params.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          # @see Telnyx::Resources::AI::Memory::Namespaces::Settings#patch_all
+          class SettingPatchAllParams < Telnyx::Internal::Type::BaseModel
+            extend Telnyx::Internal::Type::RequestParameters::Converter
+            include Telnyx::Internal::Type::RequestParameters
+
+            # @!attribute namespace
+            #   The namespace. `default` exists for every organization.
+            #
+            #   @return [String]
+            required :namespace, String
+
+            # @!attribute summary
+            #   A partial update to a namespace's summary settings.
+            #
+            #   Only the fields present in the request are changed; the rest are left as they
+            #   are. Sending `instructions: null` (or empty) clears the instructions.
+            #
+            #   @return [Telnyx::Models::AI::Memory::Namespaces::SettingPatchAllParams::Summary, nil]
+            optional :summary,
+                     -> {
+                       Telnyx::AI::Memory::Namespaces::SettingPatchAllParams::Summary
+                     },
+                     nil?: true
+
+            # @!method initialize(namespace:, summary: nil, request_options: {})
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::Memory::Namespaces::SettingPatchAllParams} for more
+            #   details.
+            #
+            #   @param namespace [String] The namespace. `default` exists for every organization.
+            #
+            #   @param summary [Telnyx::Models::AI::Memory::Namespaces::SettingPatchAllParams::Summary, nil] A partial update to a namespace's summary settings.
+            #
+            #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+            class Summary < Telnyx::Internal::Type::BaseModel
+              # @!attribute instructions
+              #   Replace the namespace's summary instructions. Null or empty clears them and
+              #   returns to the neutral default. Omit the field to leave the current instructions
+              #   unchanged.
+              #
+              #   @return [String, nil]
+              optional :instructions, String, nil?: true
+
+              # @!method initialize(instructions: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::Memory::Namespaces::SettingPatchAllParams::Summary} for
+              #   more details.
+              #
+              #   A partial update to a namespace's summary settings.
+              #
+              #   Only the fields present in the request are changed; the rest are left as they
+              #   are. Sending `instructions: null` (or empty) clears the instructions.
+              #
+              #   @param instructions [String, nil] Replace the namespace's summary instructions. Null or empty clears them and retu
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -11,6 +11,14 @@ module Telnyx
         #   @return [String]
         required :connector_name, String
 
+        # @!attribute connector_parameters
+        #   Custom key/value parameters forwarded to the pay connector as `parameters` in
+        #   the processor request. String values may use `{{dynamic_variable}}` templating,
+        #   resolved per call.
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :connector_parameters, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
         # @!attribute currency
         #   Default currency for payments processed by this tool.
         #
@@ -18,7 +26,9 @@ module Telnyx
         optional :currency, String
 
         # @!attribute description
-        #   Optional description of the pay tool that will be passed to the assistant.
+        #   Description of the pay tool shown to the assistant so it knows when to call the
+        #   tool. Not sent to the payment connector — the per-call `description` argument
+        #   the assistant passes is what reaches the processor.
         #
         #   @return [String, nil]
         optional :description, String, nil?: true
@@ -29,17 +39,47 @@ module Telnyx
         #   @return [String, nil]
         optional :payment_method, String
 
-        # @!method initialize(connector_name:, currency: nil, description: nil, payment_method: nil)
+        # @!attribute valid_card_types
+        #   Restricts accepted card numbers to the listed card types. When the caller enters
+        #   a card number that does not match one of the listed types, Pay treats the input
+        #   as invalid and re-prompts for the card number.
+        #
+        #   @return [Array<Symbol, Telnyx::Models::AI::PayToolParams::ValidCardType>, nil]
+        optional :valid_card_types,
+                 -> { Telnyx::Internal::Type::ArrayOf[enum: Telnyx::AI::PayToolParams::ValidCardType] }
+
+        # @!method initialize(connector_name:, connector_parameters: nil, currency: nil, description: nil, payment_method: nil, valid_card_types: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::PayToolParams} for more details.
         #
         #   @param connector_name [String] The name of the pay connector configured in the Telnyx API. Must reference an ex
         #
+        #   @param connector_parameters [Hash{Symbol=>Object}] Custom key/value parameters forwarded to the pay connector as `parameters` in th
+        #
         #   @param currency [String] Default currency for payments processed by this tool.
         #
-        #   @param description [String, nil] Optional description of the pay tool that will be passed to the assistant.
+        #   @param description [String, nil] Description of the pay tool shown to the assistant so it knows when to call the
         #
         #   @param payment_method [String] Default payment method for payments processed by this tool.
+        #
+        #   @param valid_card_types [Array<Symbol, Telnyx::Models::AI::PayToolParams::ValidCardType>] Restricts accepted card numbers to the listed card types. When the caller enters
+
+        module ValidCardType
+          extend Telnyx::Internal::Type::Enum
+
+          VISA = :visa
+          MASTERCARD = :mastercard
+          AMEX = :amex
+          MAESTRO = :maestro
+          DISCOVER = :discover
+          OPTIMA = :optima
+          JCB = :jcb
+          DINERS_CLUB = :"diners-club"
+          ENROUTE = :enroute
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

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

@@ -4,6 +4,17 @@ module Telnyx
   module Models
     module AI
       class TelephonySettings < Telnyx::Internal::Type::BaseModel
+        # @!attribute conversation_ended_full_history
+        #   When enabled, the `messages` array of the `call.conversation.ended` webhook
+        #   contains the full conversation history in order: user and assistant turns,
+        #   assistant tool calls (`tool_calls`), tool results (`role: tool` with
+        #   `tool_call_id`), and informational `system` and `developer` entries. The
+        #   assistant's instructions are never included. When disabled, `messages` contains
+        #   only user and assistant text turns.
+        #
+        #   @return [Boolean, nil]
+        optional :conversation_ended_full_history, Telnyx::Internal::Type::Boolean
+
         # @!attribute default_texml_app_id
         #   Default Texml App used for voice calls with your assistant. This will be created
         #   automatically on assistant creation.
@@ -112,10 +123,12 @@ module Telnyx
         #   @return [Telnyx::Models::AI::TelephonySettings::VoicemailDetection, nil]
         optional :voicemail_detection, -> { Telnyx::AI::TelephonySettings::VoicemailDetection }
 
-        # @!method initialize(default_texml_app_id: nil, disable_dtmf: nil, fallback_destination: nil, noise_suppression: nil, noise_suppression_config: nil, recording_settings: nil, send_message_history_updates: nil, supports_unauthenticated_web_calls: nil, time_limit_secs: nil, user_idle_reply_secs: nil, user_idle_timeout_secs: nil, voicemail_detection: nil)
+        # @!method initialize(conversation_ended_full_history: nil, default_texml_app_id: nil, disable_dtmf: nil, fallback_destination: nil, noise_suppression: nil, noise_suppression_config: nil, recording_settings: nil, send_message_history_updates: nil, supports_unauthenticated_web_calls: nil, time_limit_secs: nil, user_idle_reply_secs: nil, user_idle_timeout_secs: nil, voicemail_detection: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::TelephonySettings} for more details.
         #
+        #   @param conversation_ended_full_history [Boolean] When enabled, the `messages` array of the `call.conversation.ended` webhook cont
+        #
         #   @param default_texml_app_id [String] Default Texml App used for voice calls with your assistant. This will be created
         #
         #   @param disable_dtmf [Boolean] Disable inbound DTMF for the entire call. Must be set to true if a 'pay' tool is

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

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      class TelnyxAvatarSettings < Telnyx::Internal::Type::BaseModel
+        # @!attribute avatar_id
+        #   The Telnyx avatar to render.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::TelnyxAvatarSettings::AvatarID]
+        required :avatar_id, enum: -> { Telnyx::AI::TelnyxAvatarSettings::AvatarID }
+
+        # @!attribute background_id
+        #   The background to render.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::TelnyxAvatarSettings::BackgroundID]
+        required :background_id, enum: -> { Telnyx::AI::TelnyxAvatarSettings::BackgroundID }
+
+        # @!attribute model
+        #   Required avatar model identifier, separate from `avatar_id`. The supported value
+        #   is `foxtrot-1`. Omission, null, and unsupported model identifiers are rejected.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::TelnyxAvatarSettings::Model]
+        required :model, enum: -> { Telnyx::AI::TelnyxAvatarSettings::Model }
+
+        # @!attribute provider
+        #   Selects the Telnyx open-source avatar provider.
+        #
+        #   @return [Symbol, :telnyx]
+        required :provider, const: :telnyx
+
+        # @!method initialize(avatar_id:, background_id:, model:, provider: :telnyx)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::TelnyxAvatarSettings} for more details.
+        #
+        #   **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
+        #   catalog supports six avatars and office, studio, or reception backgrounds.
+        #
+        #   @param avatar_id [Symbol, Telnyx::Models::AI::TelnyxAvatarSettings::AvatarID] The Telnyx avatar to render.
+        #
+        #   @param background_id [Symbol, Telnyx::Models::AI::TelnyxAvatarSettings::BackgroundID] The background to render.
+        #
+        #   @param model [Symbol, Telnyx::Models::AI::TelnyxAvatarSettings::Model] Required avatar model identifier, separate from `avatar_id`. The supported value
+        #
+        #   @param provider [Symbol, :telnyx] Selects the Telnyx open-source avatar provider.
+
+        # The Telnyx avatar to render.
+        #
+        # @see Telnyx::Models::AI::TelnyxAvatarSettings#avatar_id
+        module AvatarID
+          extend Telnyx::Internal::Type::Enum
+
+          ELENA = :elena
+          BEN = :ben
+          JORDAN = :jordan
+          LIN = :lin
+          AVERY = :avery
+          RAPHAEL = :raphael
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # The background to render.
+        #
+        # @see Telnyx::Models::AI::TelnyxAvatarSettings#background_id
+        module BackgroundID
+          extend Telnyx::Internal::Type::Enum
+
+          OFFICE = :office
+          STUDIO = :studio
+          RECEPTION = :reception
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Required avatar model identifier, separate from `avatar_id`. The supported value
+        # is `foxtrot-1`. Omission, null, and unsupported model identifiers are rejected.
+        #
+        # @see Telnyx::Models::AI::TelnyxAvatarSettings#model
+        module Model
+          extend Telnyx::Internal::Type::Enum
+
+          FOXTROT_1 = :"foxtrot-1"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -13,14 +13,26 @@ module Telnyx
         # @!attribute shared_tool_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.
         #
         #   @return [String]
         required :shared_tool_id, String
 
+        # @!attribute message
+        #   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.
+        #
+        #   @return [String, nil]
+        optional :message, String
+
         # @!attribute name
         #   Optional human-readable label, displayed in authoring UIs.
         #
@@ -49,7 +61,7 @@ module Telnyx
         #   @return [Symbol, Telnyx::Models::AI::ToolNode::Type, nil]
         optional :type, enum: -> { Telnyx::AI::ToolNode::Type }
 
-        # @!method initialize(id:, shared_tool_id:, name: nil, position: nil, tool: nil, type: nil)
+        # @!method initialize(id:, shared_tool_id:, message: nil, name: nil, position: nil, tool: nil, type: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ToolNode} for more details.
         #
@@ -59,6 +71,8 @@ module Telnyx
         #
         #   @param shared_tool_id [String] ID of the single shared (org-level) tool this node executes. When the flow reach
         #
+        #   @param message [String] Optional message delivered to the user verbatim immediately before the tool exec
+        #
         #   @param name [String] Optional human-readable label, displayed in authoring UIs.
         #
         #   @param position [Telnyx::Models::AI::NodePosition] Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored

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

@@ -13,14 +13,26 @@ module Telnyx
         # @!attribute shared_tool_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.
         #
         #   @return [String]
         required :shared_tool_id, String
 
+        # @!attribute message
+        #   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.
+        #
+        #   @return [String, nil]
+        optional :message, String
+
         # @!attribute name
         #   Optional human-readable label, displayed in authoring UIs.
         #
@@ -41,7 +53,7 @@ module Telnyx
         #   @return [Symbol, Telnyx::Models::AI::ToolNodeReq::Type, nil]
         optional :type, enum: -> { Telnyx::AI::ToolNodeReq::Type }
 
-        # @!method initialize(id:, shared_tool_id:, name: nil, position: nil, type: nil)
+        # @!method initialize(id:, shared_tool_id:, message: nil, name: nil, position: nil, type: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ToolNodeReq} for more details.
         #
@@ -49,13 +61,17 @@ 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).
         #
         #   @param id [String] Caller-supplied unique identifier for this node within the flow.
         #
         #   @param shared_tool_id [String] ID of the single shared (org-level) tool this node executes. When the flow reach
         #
+        #   @param message [String] Optional message delivered to the user verbatim immediately before the tool exec
+        #
         #   @param name [String] Optional human-readable label, displayed in authoring UIs.
         #
         #   @param position [Telnyx::Models::AI::NodePosition] Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored