telnyx 5.162.0 → 5.164.0

data/lib/telnyx/models/ai/assistants/tests/run_trigger_params.rb

@@ -23,7 +23,12 @@ module Telnyx
             #   @return [String, nil]
             optional :destination_version_id, String
 
-            # @!method initialize(test_id:, destination_version_id: nil, request_options: {})
+            # @!attribute idempotency_key
+            #
+            #   @return [String, nil]
+            optional :idempotency_key, String
+
+            # @!method initialize(test_id:, destination_version_id: nil, idempotency_key: nil, request_options: {})
             #   Some parameter documentations has been truncated, see
             #   {Telnyx::Models::AI::Assistants::Tests::RunTriggerParams} for more details.
             #
@@ -31,6 +36,8 @@ module Telnyx
             #
             #   @param destination_version_id [String] Optional assistant version ID to use for this test run. If provided, the version
             #
+            #   @param idempotency_key [String]
+            #
             #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
           end
         end

data/lib/telnyx/models/ai/assistants/tests/test_suites/run_trigger_params.rb

@@ -24,7 +24,12 @@ module Telnyx
               #   @return [String, nil]
               optional :destination_version_id, String
 
-              # @!method initialize(suite_name:, destination_version_id: nil, request_options: {})
+              # @!attribute idempotency_key
+              #
+              #   @return [String, nil]
+              optional :idempotency_key, String
+
+              # @!method initialize(suite_name:, destination_version_id: nil, idempotency_key: nil, request_options: {})
               #   Some parameter documentations has been truncated, see
               #   {Telnyx::Models::AI::Assistants::Tests::TestSuites::RunTriggerParams} for more
               #   details.
@@ -33,6 +38,8 @@ module Telnyx
               #
               #   @param destination_version_id [String] Optional assistant version ID to use for all test runs in this suite. If provide
               #
+              #   @param idempotency_key [String]
+              #
               #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
             end
           end

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

@@ -113,6 +113,16 @@ module Telnyx
         #   @return [Float, nil]
         optional :presence_penalty, Float
 
+        # @!attribute reasoning_effort
+        #   Controls the reasoning effort for models that support it. When set, the model
+        #   spends more or less compute on internal reasoning before generating its
+        #   response. Supported values: none, minimal, low, medium, high, xhigh, max. Not
+        #   all models support all values; unsupported values are rejected with a 400 error.
+        #   When omitted, reasoning models use their default effort level.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ReasoningEffort, nil]
+        optional :reasoning_effort, enum: -> { Telnyx::AI::ChatCompletionRequest::ReasoningEffort }
+
         # @!attribute response_format
         #   Use this is you want to guarantee a JSON output without defining a schema. For
         #   control over the schema, use `guided_json`.
@@ -195,7 +205,7 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :use_beam_search, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, response_format: nil, seed: nil, service_tier: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil)
+        # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, reasoning_effort: nil, response_format: nil, seed: nil, service_tier: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ChatCompletionRequest} for more details.
         #
@@ -231,6 +241,8 @@ module Telnyx
         #
         #   @param presence_penalty [Float] Higher values will penalize the model from repeating the same output tokens.
         #
+        #   @param reasoning_effort [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ReasoningEffort] Controls the reasoning effort for models that support it. When set, the model sp
+        #
         #   @param response_format [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat] Use this is you want to guarantee a JSON output without defining a schema. For c
         #
         #   @param seed [Integer] If specified, the system will make a best effort to sample deterministically, su
@@ -333,6 +345,28 @@ module Telnyx
           end
         end
 
+        # Controls the reasoning effort for models that support it. When set, the model
+        # spends more or less compute on internal reasoning before generating its
+        # response. Supported values: none, minimal, low, medium, high, xhigh, max. Not
+        # all models support all values; unsupported values are rejected with a 400 error.
+        # When omitted, reasoning models use their default effort level.
+        #
+        # @see Telnyx::Models::AI::ChatCompletionRequest#reasoning_effort
+        module ReasoningEffort
+          extend Telnyx::Internal::Type::Enum
+
+          NONE = :none
+          MINIMAL = :minimal
+          LOW = :low
+          MEDIUM = :medium
+          HIGH = :high
+          XHIGH = :xhigh
+          MAX = :max
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # @see Telnyx::Models::AI::ChatCompletionRequest#response_format
         class ResponseFormat < Telnyx::Internal::Type::BaseModel
           # @!attribute type

data/lib/telnyx/models/ai/collections/retrieval_settings.rb

@@ -8,6 +8,9 @@ module Telnyx
           # @!attribute retrieval_type
           #   Retrieval strategy. `vector` runs semantic similarity search; `hybrid` combines
           #   vector similarity with keyword matching; `keyword` runs lexical (BM25) matching.
+          #   `keyword` is not accepted yet: setting it returns 422
+          #   `unsupported_retrieval_type`. A collection set to `hybrid` is accepted here but
+          #   cannot be searched until hybrid execution ships.
           #
           #   @return [Symbol, Telnyx::Models::AI::Collections::RetrievalSettings::RetrievalType, nil]
           optional :retrieval_type, enum: -> { Telnyx::AI::Collections::RetrievalSettings::RetrievalType }
@@ -30,6 +33,9 @@ module Telnyx
 
           # Retrieval strategy. `vector` runs semantic similarity search; `hybrid` combines
           # vector similarity with keyword matching; `keyword` runs lexical (BM25) matching.
+          # `keyword` is not accepted yet: setting it returns 422
+          # `unsupported_retrieval_type`. A collection set to `hybrid` is accepted here but
+          # cannot be searched until hybrid execution ships.
           #
           # @see Telnyx::Models::AI::Collections::RetrievalSettings#retrieval_type
           module RetrievalType
@@ -37,7 +43,6 @@ module Telnyx
 
             VECTOR = :vector
             HYBRID = :hybrid
-            KEYWORD = :keyword
 
             # @!method self.values
             #   @return [Array<Symbol>]

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

@@ -56,7 +56,12 @@ module Telnyx
         #   @return [String, Hash{Symbol=>Object}, nil]
         optional :tool_choice, union: -> { Telnyx::AI::ConversationAddMessageParams::ToolChoice }
 
-        # @!method initialize(conversation_id:, role:, content: nil, metadata: nil, name: nil, sent_at: nil, tool_call_id: nil, tool_calls: nil, tool_choice: nil, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!method initialize(conversation_id:, role:, content: nil, metadata: nil, name: nil, sent_at: nil, tool_call_id: nil, tool_calls: nil, tool_choice: nil, idempotency_key: nil, request_options: {})
         #   @param conversation_id [String] The ID of the conversation
         #
         #   @param role [String]
@@ -75,6 +80,8 @@ module Telnyx
         #
         #   @param tool_choice [String, Hash{Symbol=>Object}]
         #
+        #   @param idempotency_key [String]
+        #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
         module Metadata

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

@@ -20,7 +20,12 @@ module Telnyx
         #   @return [String, nil]
         optional :name, String
 
-        # @!method initialize(metadata: nil, name: nil, request_options: {})
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!method initialize(metadata: nil, name: nil, idempotency_key: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ConversationCreateParams} for more details.
         #
@@ -28,6 +33,8 @@ module Telnyx
         #
         #   @param name [String]
         #
+        #   @param idempotency_key [String]
+        #
         #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
       end
     end

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

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      class ConversationFlow < Telnyx::Internal::Type::BaseModel
+        # @!attribute nodes
+        #   All nodes in the flow.
+        #
+        #   @return [Array<Telnyx::Models::AI::FlowNode, Telnyx::Models::AI::ToolNode, Telnyx::Models::AI::SpeakNode>]
+        required :nodes, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::ConversationFlow::Node] }
+
+        # @!attribute start_node_id
+        #   ID of the node where the conversation begins.
+        #
+        #   @return [String]
+        required :start_node_id, String
+
+        # @!attribute edges
+        #   Directed transitions between nodes.
+        #
+        #   @return [Array<Telnyx::Models::AI::FlowEdge>, nil]
+        optional :edges, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::FlowEdge] }
+
+        # @!method initialize(nodes:, start_node_id:, edges: nil)
+        #   Conversation flow as returned by the API.
+        #
+        #   @param nodes [Array<Telnyx::Models::AI::FlowNode, Telnyx::Models::AI::ToolNode, Telnyx::Models::AI::SpeakNode>] All nodes in the flow.
+        #
+        #   @param start_node_id [String] ID of the node where the conversation begins.
+        #
+        #   @param edges [Array<Telnyx::Models::AI::FlowEdge>] Directed transitions between nodes.
+
+        # One step in a conversation flow, as returned by the API.
+        module Node
+          extend Telnyx::Internal::Type::Union
+
+          discriminator :type
+
+          # One step in a conversation flow, as returned by the API.
+          variant :prompt, -> { Telnyx::AI::FlowNode }
+
+          # A standalone tool step in a conversation flow, as returned by the API.
+          variant :tool, -> { Telnyx::AI::ToolNode }
+
+          # A standalone scripted-message step in a flow, as returned by the API.
+          variant :speak, -> { Telnyx::AI::SpeakNode }
+
+          # @!method self.variants
+          #   @return [Array(Telnyx::Models::AI::FlowNode, Telnyx::Models::AI::ToolNode, Telnyx::Models::AI::SpeakNode)]
+        end
+      end
+    end
+  end
+end

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

@@ -8,7 +8,7 @@ module Telnyx
         #   All nodes in the flow. Must contain `start_node_id`. Each node is a prompt node
         #   (`type: prompt`) or a tool node (`type: tool`).
         #
-        #   @return [Array<Telnyx::Models::AI::ConversationFlowReq::Node::Prompt, Telnyx::Models::AI::ConversationFlowReq::Node::Tool, Telnyx::Models::AI::ConversationFlowReq::Node::Speak>]
+        #   @return [Array<Telnyx::Models::AI::FlowNodeReq, Telnyx::Models::AI::ToolNodeReq, Telnyx::Models::AI::SpeakNodeReq>]
         required :nodes, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::ConversationFlowReq::Node] }
 
         # @!attribute start_node_id
@@ -33,7 +33,7 @@ module Telnyx
         #   unique node/edge IDs, that `start_node_id` references a real node, and that
         #   every edge's endpoints reference real nodes.
         #
-        #   @param nodes [Array<Telnyx::Models::AI::ConversationFlowReq::Node::Prompt, Telnyx::Models::AI::ConversationFlowReq::Node::Tool, Telnyx::Models::AI::ConversationFlowReq::Node::Speak>] All nodes in the flow. Must contain `start_node_id`. Each node is a prompt node
+        #   @param nodes [Array<Telnyx::Models::AI::FlowNodeReq, Telnyx::Models::AI::ToolNodeReq, Telnyx::Models::AI::SpeakNodeReq>] All nodes in the flow. Must contain `start_node_id`. Each node is a prompt node
         #
         #   @param start_node_id [String] ID of the node where the conversation begins.
         #
@@ -52,7 +52,7 @@ module Telnyx
           #
           # Each node carries the prompt, tool scope, and optional overrides for
           # model/voice/transcription. Unset overrides cascade from the assistant.
-          variant :prompt, -> { Telnyx::AI::ConversationFlowReq::Node::Prompt }
+          variant :prompt, -> { Telnyx::AI::FlowNodeReq }
 
           # A standalone tool step in a conversation flow, as supplied by clients.
           #
@@ -60,7 +60,7 @@ module Telnyx
           # 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.
-          variant :tool, -> { Telnyx::AI::ConversationFlowReq::Node::Tool }
+          variant :tool, -> { Telnyx::AI::ToolNodeReq }
 
           # A standalone scripted-message step in a flow, as supplied by clients.
           #
@@ -68,331 +68,10 @@ module Telnyx
           # an LLM turn. Reaching it delivers `message` to the user verbatim (with
           # `{{variable}}` interpolation), then routes via outgoing `llm` /
           # `expression` edges.
-          variant :speak, -> { Telnyx::AI::ConversationFlowReq::Node::Speak }
-
-          class Prompt < 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::ConversationFlowReq::Node::Prompt::InstructionsMode, nil]
-            optional :instructions_mode, enum: -> { Telnyx::AI::ConversationFlowReq::Node::Prompt::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::ConversationFlowReq::Node::Prompt::ToolsMode, nil]
-            optional :tools_mode, enum: -> { Telnyx::AI::ConversationFlowReq::Node::Prompt::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::ConversationFlowReq::Node::Prompt::Type, nil]
-            optional :type, enum: -> { Telnyx::AI::ConversationFlowReq::Node::Prompt::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::ConversationFlowReq::Node::Prompt} 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::ConversationFlowReq::Node::Prompt::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::ConversationFlowReq::Node::Prompt::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::ConversationFlowReq::Node::Prompt::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::ConversationFlowReq::Node::Prompt#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::ConversationFlowReq::Node::Prompt#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::ConversationFlowReq::Node::Prompt#type
-            module Type
-              extend Telnyx::Internal::Type::Enum
-
-              PROMPT = :prompt
-
-              # @!method self.values
-              #   @return [Array<Symbol>]
-            end
-          end
-
-          class Tool < Telnyx::Internal::Type::BaseModel
-            # @!attribute id
-            #   Caller-supplied unique identifier for this node within the flow.
-            #
-            #   @return [String]
-            required :id, String
-
-            # @!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.
-            #
-            #   @return [String]
-            required :shared_tool_id, 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 type
-            #   Node kind discriminator. Always `tool` for a tool node.
-            #
-            #   @return [Symbol, Telnyx::Models::AI::ConversationFlowReq::Node::Tool::Type, nil]
-            optional :type, enum: -> { Telnyx::AI::ConversationFlowReq::Node::Tool::Type }
-
-            # @!method initialize(id:, shared_tool_id:, name: nil, position: nil, type: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {Telnyx::Models::AI::ConversationFlowReq::Node::Tool} for more details.
-            #
-            #   A standalone tool step in a conversation flow, as supplied by clients.
-            #
-            #   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.
-            #
-            #   @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 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 type [Symbol, Telnyx::Models::AI::ConversationFlowReq::Node::Tool::Type] Node kind discriminator. Always `tool` for a tool node.
-
-            # Node kind discriminator. Always `tool` for a tool node.
-            #
-            # @see Telnyx::Models::AI::ConversationFlowReq::Node::Tool#type
-            module Type
-              extend Telnyx::Internal::Type::Enum
-
-              TOOL = :tool
-
-              # @!method self.values
-              #   @return [Array<Symbol>]
-            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::NodePosition, nil]
-            optional :position, -> { Telnyx::AI::NodePosition }
-
-            # @!attribute type
-            #   Node kind discriminator. Always `speak` for a speak node.
-            #
-            #   @return [Symbol, Telnyx::Models::AI::ConversationFlowReq::Node::Speak::Type, nil]
-            optional :type, enum: -> { Telnyx::AI::ConversationFlowReq::Node::Speak::Type }
-
-            # @!method initialize(id:, message:, name: nil, position: nil, type: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {Telnyx::Models::AI::ConversationFlowReq::Node::Speak} for more details.
-            #
-            #   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.
-            #
-            #   @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::NodePosition] Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
-            #
-            #   @param type [Symbol, Telnyx::Models::AI::ConversationFlowReq::Node::Speak::Type] Node kind discriminator. Always `speak` for a speak node.
-
-            # Node kind discriminator. Always `speak` for a speak node.
-            #
-            # @see Telnyx::Models::AI::ConversationFlowReq::Node::Speak#type
-            module Type
-              extend Telnyx::Internal::Type::Enum
-
-              SPEAK = :speak
-
-              # @!method self.values
-              #   @return [Array<Symbol>]
-            end
-          end
+          variant :speak, -> { Telnyx::AI::SpeakNodeReq }
 
           # @!method self.variants
-          #   @return [Array(Telnyx::Models::AI::ConversationFlowReq::Node::Prompt, Telnyx::Models::AI::ConversationFlowReq::Node::Tool, Telnyx::Models::AI::ConversationFlowReq::Node::Speak)]
+          #   @return [Array(Telnyx::Models::AI::FlowNodeReq, Telnyx::Models::AI::ToolNodeReq, Telnyx::Models::AI::SpeakNodeReq)]
         end
       end
     end

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

@@ -30,7 +30,12 @@ module Telnyx
           #   @return [String, nil]
           optional :webhook, String
 
-          # @!method initialize(instructions:, name:, json_schema: nil, webhook: nil, request_options: {})
+          # @!attribute idempotency_key
+          #
+          #   @return [String, nil]
+          optional :idempotency_key, String
+
+          # @!method initialize(instructions:, name:, json_schema: nil, webhook: nil, idempotency_key: nil, request_options: {})
           #   @param instructions [String]
           #
           #   @param name [String]
@@ -39,6 +44,8 @@ module Telnyx
           #
           #   @param webhook [String]
           #
+          #   @param idempotency_key [String]
+          #
           #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
 
           # If specified, the output will follow the JSON schema.

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

@@ -24,10 +24,16 @@ module Telnyx
           #   @return [String, nil]
           optional :webhook, String
 
-          # @!method initialize(name:, description: nil, webhook: nil, request_options: {})
+          # @!attribute idempotency_key
+          #
+          #   @return [String, nil]
+          optional :idempotency_key, String
+
+          # @!method initialize(name:, description: nil, webhook: nil, idempotency_key: nil, request_options: {})
           #   @param name [String]
           #   @param description [String]
           #   @param webhook [String]
+          #   @param idempotency_key [String]
           #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
         end
       end