telnyx 5.162.0 → 5.164.0

data/lib/telnyx/models/ai/conversations/message_list_response.rb

@@ -26,6 +26,12 @@ module Telnyx
           #   @return [Time, nil]
           optional :created_at, Time
 
+          # @!attribute metadata
+          #
+          #   @return [Hash{Symbol=>String, Integer, Boolean, Array<String, Integer, Boolean>}, nil]
+          optional :metadata,
+                   -> { Telnyx::Internal::Type::HashOf[union: Telnyx::Models::AI::Conversations::MessageListResponse::Metadata] }
+
           # @!attribute sent_at
           #   The datetime the message was sent to the end user.
           #
@@ -39,7 +45,7 @@ module Telnyx
           optional :tool_calls,
                    -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall] }
 
-          # @!method initialize(role:, text:, created_at: nil, sent_at: nil, tool_calls: nil)
+          # @!method initialize(role:, text:, created_at: nil, metadata: nil, sent_at: nil, tool_calls: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::AI::Conversations::MessageListResponse} for more details.
           #
@@ -49,6 +55,8 @@ module Telnyx
           #
           #   @param created_at [Time] The datetime the message was created on the conversation. This does not necesari
           #
+          #   @param metadata [Hash{Symbol=>String, Integer, Boolean, Array<String, Integer, Boolean>}]
+          #
           #   @param sent_at [Time] The datetime the message was sent to the end user.
           #
           #   @param tool_calls [Array<Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall>] Optional tool calls made by the assistant.
@@ -67,6 +75,40 @@ module Telnyx
             #   @return [Array<Symbol>]
           end
 
+          module Metadata
+            extend Telnyx::Internal::Type::Union
+
+            variant String
+
+            variant Integer
+
+            variant Telnyx::Internal::Type::Boolean
+
+            variant -> { Telnyx::Models::AI::Conversations::MessageListResponse::Metadata::ConversationMetadataListValueArray }
+
+            module ConversationMetadataListValue
+              extend Telnyx::Internal::Type::Union
+
+              variant String
+
+              variant Integer
+
+              variant Telnyx::Internal::Type::Boolean
+
+              # @!method self.variants
+              #   @return [Array(String, Integer, Boolean)]
+            end
+
+            # @!method self.variants
+            #   @return [Array(String, Integer, Boolean, Array<String, Integer, Boolean>)]
+
+            # @type [Telnyx::Internal::Type::Converter]
+            ConversationMetadataListValueArray =
+              Telnyx::Internal::Type::ArrayOf[
+                union: -> { Telnyx::Models::AI::Conversations::MessageListResponse::Metadata::ConversationMetadataListValue }
+              ]
+          end
+
           class ToolCall < Telnyx::Internal::Type::BaseModel
             # @!attribute id
             #   Unique identifier for the tool call.

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

@@ -35,7 +35,12 @@ module Telnyx
         #   @return [Symbol, Telnyx::Models::AI::EmbeddingCreateParams::Loader, nil]
         optional :loader, enum: -> { Telnyx::AI::EmbeddingCreateParams::Loader }
 
-        # @!method initialize(bucket_name:, document_chunk_overlap_size: nil, document_chunk_size: nil, embedding_model: nil, loader: nil, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!method initialize(bucket_name:, document_chunk_overlap_size: nil, document_chunk_size: nil, embedding_model: nil, loader: nil, idempotency_key: nil, request_options: {})
         #   @param bucket_name [String]
         #
         #   @param document_chunk_overlap_size [Integer]
@@ -46,6 +51,8 @@ module Telnyx
         #
         #   @param loader [Symbol, Telnyx::Models::AI::EmbeddingCreateParams::Loader] Supported types of custom document loaders for embeddings.
         #
+        #   @param idempotency_key [String]
+        #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
         # Supported models to vectorize and embed documents.

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

@@ -20,11 +20,18 @@ module Telnyx
         #   @return [String]
         required :url, String
 
-        # @!method initialize(bucket_name:, url:, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!method initialize(bucket_name:, url:, idempotency_key: nil, request_options: {})
         #   @param bucket_name [String] Name of the bucket to store the embeddings. This bucket must already exist.
         #
         #   @param url [String] The URL of the webpage to embed
         #
+        #   @param idempotency_key [String]
+        #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
       end
     end

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

@@ -14,7 +14,7 @@ module Telnyx
         #   Condition that gates the transition. Discriminated by `type`: `llm`,
         #   `expression`.
         #
-        #   @return [Telnyx::Models::AI::FlowEdge::Condition::Llm, Telnyx::Models::AI::FlowEdge::Condition::Expression, Telnyx::Models::AI::FlowEdge::Condition::Default]
+        #   @return [Telnyx::Models::AI::FlowEdge::Condition::Llm, Telnyx::Models::AI::FlowEdge::Condition::Expression, Telnyx::Models::AI::FlowEdge::Condition::DefaultCondition]
         required :condition, union: -> { Telnyx::AI::FlowEdge::Condition }
 
         # @!attribute start_node_id
@@ -43,7 +43,7 @@ module Telnyx
         #
         #   @param id [String] Caller-supplied unique identifier for this edge within the flow.
         #
-        #   @param condition [Telnyx::Models::AI::FlowEdge::Condition::Llm, Telnyx::Models::AI::FlowEdge::Condition::Expression, Telnyx::Models::AI::FlowEdge::Condition::Default] Condition that gates the transition. Discriminated by `type`: `llm`, `expression
+        #   @param condition [Telnyx::Models::AI::FlowEdge::Condition::Llm, Telnyx::Models::AI::FlowEdge::Condition::Expression, Telnyx::Models::AI::FlowEdge::Condition::DefaultCondition] Condition that gates the transition. Discriminated by `type`: `llm`, `expression
         #
         #   @param start_node_id [String] ID of the node this edge transitions away from.
         #
@@ -81,7 +81,7 @@ module Telnyx
           # 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::FlowEdge::Condition::Default }
+          variant :default, -> { Telnyx::AI::FlowEdge::Condition::DefaultCondition }
 
           class Llm < Telnyx::Internal::Type::BaseModel
             # @!attribute prompt
@@ -136,7 +136,7 @@ module Telnyx
             #   @param type [Symbol, :expression]
           end
 
-          class Default < Telnyx::Internal::Type::BaseModel
+          class DefaultCondition < Telnyx::Internal::Type::BaseModel
             # @!attribute type
             #
             #   @return [Symbol, :default]
@@ -157,7 +157,7 @@ module Telnyx
           end
 
           # @!method self.variants
-          #   @return [Array(Telnyx::Models::AI::FlowEdge::Condition::Llm, Telnyx::Models::AI::FlowEdge::Condition::Expression, Telnyx::Models::AI::FlowEdge::Condition::Default)]
+          #   @return [Array(Telnyx::Models::AI::FlowEdge::Condition::Llm, Telnyx::Models::AI::FlowEdge::Condition::Expression, Telnyx::Models::AI::FlowEdge::Condition::DefaultCondition)]
         end
 
         # Destination of the transition. Discriminated by `type`: `node` (jump to another

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

@@ -0,0 +1,189 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      class FlowNode < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Caller-supplied unique identifier for this node within the flow.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute instructions
+        #   Prompt that drives the LLM while this node is active. Required.
+        #
+        #   @return [String]
+        required :instructions, String
+
+        # @!attribute external_llm
+        #   Override for `Assistant.external_llm` while this node is active. Use this to
+        #   route a node's turns to a different external LLM (different `model`, `base_url`,
+        #   credentials). Part of the LLM bundle — see `model` for cascade semantics.
+        #   Mutually exclusive with `model` on the node (a single LLM identity per node).
+        #
+        #   @return [Telnyx::Models::AI::ExternalLlm, nil]
+        optional :external_llm, -> { Telnyx::AI::ExternalLlm }
+
+        # @!attribute instructions_mode
+        #   How `instructions` combine with the assistant-level instructions. `replace`
+        #   (default): the node's instructions are used alone. `append`: the node's
+        #   instructions are concatenated after the assistant's instructions.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::FlowNode::InstructionsMode, nil]
+        optional :instructions_mode, enum: -> { Telnyx::AI::FlowNode::InstructionsMode }
+
+        # @!attribute llm_api_key_ref
+        #   Override for `Assistant.llm_api_key_ref` while this node is active. Part of the
+        #   LLM bundle — see `model` for cascade semantics.
+        #
+        #   @return [String, nil]
+        optional :llm_api_key_ref, String
+
+        # @!attribute model
+        #   Override for `Assistant.model` while this node is active. Part of the LLM bundle
+        #   (`model` + `llm_api_key_ref` + `external_llm`): when any of the three is set on
+        #   the node, all three are taken from the node and the assistant-level LLM identity
+        #   is not consulted. When none of the three is set, the assistant's bundle cascades
+        #   unchanged.
+        #
+        #   @return [String, nil]
+        optional :model, 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::NodePosition, nil]
+        optional :position, -> { Telnyx::AI::NodePosition }
+
+        # @!attribute shared_tool_ids
+        #   IDs of shared (org-level) tools available at this node. Knowledge bases are
+        #   attached the same way — via a shared retrieval tool. Tools not listed here are
+        #   not callable while this node is active.
+        #
+        #   @return [Array<String>, nil]
+        optional :shared_tool_ids, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!attribute tools
+        #   Full tool definitions for this node, resolved from `shared_tool_ids`
+        #   server-side. Populated on responses so clients can render the flow without a
+        #   follow-up fetch per shared tool. Ignored on input — set `shared_tool_ids` to
+        #   configure a node's tools.
+        #
+        #   @return [Array<Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>>, nil]
+        optional :tools,
+                 -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool]] }
+
+        # @!attribute tools_mode
+        #   How `shared_tool_ids` combine with the assistant-level tool set. `replace`
+        #   (default): only the node's tools are callable. `append`: the node's tools are
+        #   added to the assistant's tools. Ignored when `shared_tool_ids` is null.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::FlowNode::ToolsMode, nil]
+        optional :tools_mode, enum: -> { Telnyx::AI::FlowNode::ToolsMode }
+
+        # @!attribute transcription
+        #   Per-node transcription override (response form).
+        #
+        #   @return [Telnyx::Models::AI::TranscriptionSettings, nil]
+        optional :transcription, -> { Telnyx::AI::TranscriptionSettings }
+
+        # @!attribute type
+        #   Node kind discriminator. `prompt` is an LLM-driven step.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::FlowNode::Type, nil]
+        optional :type, enum: -> { Telnyx::AI::FlowNode::Type }
+
+        # @!attribute voice_settings
+        #   Per-node voice override (response form).
+        #
+        #   @return [Telnyx::Models::AI::VoiceSettings, nil]
+        optional :voice_settings, -> { Telnyx::AI::VoiceSettings }
+
+        # @!method initialize(id:, instructions:, external_llm: nil, instructions_mode: nil, llm_api_key_ref: nil, model: nil, name: nil, position: nil, shared_tool_ids: nil, tools: nil, tools_mode: nil, transcription: nil, type: nil, voice_settings: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::FlowNode} for more details.
+        #
+        #   One step in a conversation flow, as returned by the API.
+        #
+        #   @param id [String] Caller-supplied unique identifier for this node within the flow.
+        #
+        #   @param instructions [String] Prompt that drives the LLM while this node is active. Required.
+        #
+        #   @param external_llm [Telnyx::Models::AI::ExternalLlm] Override for `Assistant.external_llm` while this node is active. Use this to rou
+        #
+        #   @param instructions_mode [Symbol, Telnyx::Models::AI::FlowNode::InstructionsMode] How `instructions` combine with the assistant-level instructions. `replace` (def
+        #
+        #   @param llm_api_key_ref [String] Override for `Assistant.llm_api_key_ref` while this node is active. Part of the
+        #
+        #   @param model [String] Override for `Assistant.model` while this node is active. Part of the LLM bundle
+        #
+        #   @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
+        #
+        #   @param shared_tool_ids [Array<String>] IDs of shared (org-level) tools available at this node. Knowledge bases are atta
+        #
+        #   @param tools [Array<Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>>] Full tool definitions for this node, resolved from `shared_tool_ids` server-side
+        #
+        #   @param tools_mode [Symbol, Telnyx::Models::AI::FlowNode::ToolsMode] How `shared_tool_ids` combine with the assistant-level tool set. `replace` (defa
+        #
+        #   @param transcription [Telnyx::Models::AI::TranscriptionSettings] Per-node transcription override (response form).
+        #
+        #   @param type [Symbol, Telnyx::Models::AI::FlowNode::Type] Node kind discriminator. `prompt` is an LLM-driven step.
+        #
+        #   @param voice_settings [Telnyx::Models::AI::VoiceSettings] Per-node voice override (response form).
+
+        # How `instructions` combine with the assistant-level instructions. `replace`
+        # (default): the node's instructions are used alone. `append`: the node's
+        # instructions are concatenated after the assistant's instructions.
+        #
+        # @see Telnyx::Models::AI::FlowNode#instructions_mode
+        module InstructionsMode
+          extend Telnyx::Internal::Type::Enum
+
+          REPLACE = :replace
+          APPEND = :append
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # How `shared_tool_ids` combine with the assistant-level tool set. `replace`
+        # (default): only the node's tools are callable. `append`: the node's tools are
+        # added to the assistant's tools. Ignored when `shared_tool_ids` is null.
+        #
+        # @see Telnyx::Models::AI::FlowNode#tools_mode
+        module ToolsMode
+          extend Telnyx::Internal::Type::Enum
+
+          REPLACE = :replace
+          APPEND = :append
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Node kind discriminator. `prompt` is an LLM-driven step.
+        #
+        # @see Telnyx::Models::AI::FlowNode#type
+        module Type
+          extend Telnyx::Internal::Type::Enum
+
+          PROMPT = :prompt
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,184 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      class FlowNodeReq < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Caller-supplied unique identifier for this node within the flow.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute instructions
+        #   Prompt that drives the LLM while this node is active. Required.
+        #
+        #   @return [String]
+        required :instructions, String
+
+        # @!attribute external_llm
+        #   Override for `Assistant.external_llm` while this node is active. Use this to
+        #   route a node's turns to a different external LLM (different `model`, `base_url`,
+        #   credentials). Part of the LLM bundle — see `model` for cascade semantics.
+        #   Mutually exclusive with `model` on the node (a single LLM identity per node).
+        #
+        #   @return [Telnyx::Models::AI::ExternalLlmReq, nil]
+        optional :external_llm, -> { Telnyx::AI::ExternalLlmReq }
+
+        # @!attribute instructions_mode
+        #   How `instructions` combine with the assistant-level instructions. `replace`
+        #   (default): the node's instructions are used alone. `append`: the node's
+        #   instructions are concatenated after the assistant's instructions.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::FlowNodeReq::InstructionsMode, nil]
+        optional :instructions_mode, enum: -> { Telnyx::AI::FlowNodeReq::InstructionsMode }
+
+        # @!attribute llm_api_key_ref
+        #   Override for `Assistant.llm_api_key_ref` while this node is active. Part of the
+        #   LLM bundle — see `model` for cascade semantics.
+        #
+        #   @return [String, nil]
+        optional :llm_api_key_ref, String
+
+        # @!attribute model
+        #   Override for `Assistant.model` while this node is active. Part of the LLM bundle
+        #   (`model` + `llm_api_key_ref` + `external_llm`): when any of the three is set on
+        #   the node, all three are taken from the node and the assistant-level LLM identity
+        #   is not consulted. When none of the three is set, the assistant's bundle cascades
+        #   unchanged.
+        #
+        #   @return [String, nil]
+        optional :model, 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::NodePosition, nil]
+        optional :position, -> { Telnyx::AI::NodePosition }
+
+        # @!attribute shared_tool_ids
+        #   IDs of shared (org-level) tools available at this node. Knowledge bases are
+        #   attached the same way — via a shared retrieval tool. Tools not listed here are
+        #   not callable while this node is active.
+        #
+        #   @return [Array<String>, nil]
+        optional :shared_tool_ids, Telnyx::Internal::Type::ArrayOf[String]
+
+        # @!attribute tools_mode
+        #   How `shared_tool_ids` combine with the assistant-level tool set. `replace`
+        #   (default): only the node's tools are callable. `append`: the node's tools are
+        #   added to the assistant's tools. Ignored when `shared_tool_ids` is null.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::FlowNodeReq::ToolsMode, nil]
+        optional :tools_mode, enum: -> { Telnyx::AI::FlowNodeReq::ToolsMode }
+
+        # @!attribute transcription
+        #   Per-node transcription override (model/language/region). Unset fields cascade
+        #   from the assistant-level transcription.
+        #
+        #   @return [Telnyx::Models::AI::TranscriptionSettings, nil]
+        optional :transcription, -> { Telnyx::AI::TranscriptionSettings }
+
+        # @!attribute type
+        #   Node kind discriminator. `prompt` (default) is an LLM-driven step; `tool` is a
+        #   standalone tool execution (see `ToolNodeReq`).
+        #
+        #   @return [Symbol, Telnyx::Models::AI::FlowNodeReq::Type, nil]
+        optional :type, enum: -> { Telnyx::AI::FlowNodeReq::Type }
+
+        # @!attribute voice_settings
+        #   Per-node voice override. Only fields set here override the assistant-level voice
+        #   settings; unset fields cascade.
+        #
+        #   @return [Telnyx::Models::AI::VoiceSettings, nil]
+        optional :voice_settings, -> { Telnyx::AI::VoiceSettings }
+
+        # @!method initialize(id:, instructions:, external_llm: nil, instructions_mode: nil, llm_api_key_ref: nil, model: nil, name: nil, position: nil, shared_tool_ids: nil, tools_mode: nil, transcription: nil, type: nil, voice_settings: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::FlowNodeReq} for more details.
+        #
+        #   One step in a conversation flow, as supplied by API clients.
+        #
+        #   Each node carries the prompt, tool scope, and optional overrides for
+        #   model/voice/transcription. Unset overrides cascade from the assistant.
+        #
+        #   @param id [String] Caller-supplied unique identifier for this node within the flow.
+        #
+        #   @param instructions [String] Prompt that drives the LLM while this node is active. Required.
+        #
+        #   @param external_llm [Telnyx::Models::AI::ExternalLlmReq] Override for `Assistant.external_llm` while this node is active. Use this to rou
+        #
+        #   @param instructions_mode [Symbol, Telnyx::Models::AI::FlowNodeReq::InstructionsMode] How `instructions` combine with the assistant-level instructions. `replace` (def
+        #
+        #   @param llm_api_key_ref [String] Override for `Assistant.llm_api_key_ref` while this node is active. Part of the
+        #
+        #   @param model [String] Override for `Assistant.model` while this node is active. Part of the LLM bundle
+        #
+        #   @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
+        #
+        #   @param shared_tool_ids [Array<String>] IDs of shared (org-level) tools available at this node. Knowledge bases are atta
+        #
+        #   @param tools_mode [Symbol, Telnyx::Models::AI::FlowNodeReq::ToolsMode] How `shared_tool_ids` combine with the assistant-level tool set. `replace` (defa
+        #
+        #   @param transcription [Telnyx::Models::AI::TranscriptionSettings] Per-node transcription override (model/language/region). Unset fields cascade fr
+        #
+        #   @param type [Symbol, Telnyx::Models::AI::FlowNodeReq::Type] Node kind discriminator. `prompt` (default) is an LLM-driven step; `tool` is a s
+        #
+        #   @param voice_settings [Telnyx::Models::AI::VoiceSettings] Per-node voice override. Only fields set here override the assistant-level voice
+
+        # How `instructions` combine with the assistant-level instructions. `replace`
+        # (default): the node's instructions are used alone. `append`: the node's
+        # instructions are concatenated after the assistant's instructions.
+        #
+        # @see Telnyx::Models::AI::FlowNodeReq#instructions_mode
+        module InstructionsMode
+          extend Telnyx::Internal::Type::Enum
+
+          REPLACE = :replace
+          APPEND = :append
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # How `shared_tool_ids` combine with the assistant-level tool set. `replace`
+        # (default): only the node's tools are callable. `append`: the node's tools are
+        # added to the assistant's tools. Ignored when `shared_tool_ids` is null.
+        #
+        # @see Telnyx::Models::AI::FlowNodeReq#tools_mode
+        module ToolsMode
+          extend Telnyx::Internal::Type::Enum
+
+          REPLACE = :replace
+          APPEND = :append
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Node kind discriminator. `prompt` (default) is an LLM-driven step; `tool` is a
+        # standalone tool execution (see `ToolNodeReq`).
+        #
+        # @see Telnyx::Models::AI::FlowNodeReq#type
+        module Type
+          extend Telnyx::Internal::Type::Enum
+
+          PROMPT = :prompt
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end