telnyx 5.92.0 → 5.94.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7221f8fcb13d30fb968c42120f4cae29c5ba92368dfb36bf64b410ea0368db2f
-  data.tar.gz: 508f1acdf88318ee46178cd233ba7ea30164f505d13bc77195b8ef11d9728715
+  metadata.gz: 99ee1431030d5e934cef1f55e43d65d5ec32a16385dc59b7b1935468a942f2b8
+  data.tar.gz: 43ac6b2527321cd883735d0e566b7ca8c6bbe96eec82990c5eeb085021151fdb
 SHA512:
-  metadata.gz: 00dcc00ec7124899d505d1e194e338d7eb3364802cee4ff92b679dafc0b862264c41689fa423731c75fc263c009c9d6941353d67727f3e6030f835fe5ead7145
-  data.tar.gz: b5fda3951738d0d6fe716a3719babb78dc1bcf11d95ff395be1cd39e1a6f611002ca94c44ef5c659e9f87c232eef1e262e6dd6494008338c7b8b5982cb48384f
+  metadata.gz: 790b845d4bb2eb03ed6142139cebff3595b0334439697a89911cad8f63b7f60ef8b1ba9dccce1c1f216c98d073b96e3e821cd188c4d48a2391dbf6e5820c00d9
+  data.tar.gz: fb1c8230ec6bb4de8b91006449bcb401789a2b3e9116639e602fd4a9bd6ff2415f44563c1c2f6141cf3f2e51610ff5aa290b5dbcd49fc71fb6e3fd1f811c27ff

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 5.94.0 (2026-04-30)
+
+Full Changelog: [v5.93.0...v5.94.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.93.0...v5.94.0)
+
+### Features
+
+* Assistant tool targets master ([b06b562](https://github.com/team-telnyx/telnyx-ruby/commit/b06b562ff66c80a5afd7f0c82a2aa42241f7811c))
+
+## 5.93.0 (2026-04-29)
+
+Full Changelog: [v5.92.0...v5.93.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.92.0...v5.93.0)
+
+### Features
+
+* Document assistant CRUD fields ([10e9601](https://github.com/team-telnyx/telnyx-ruby/commit/10e9601fe87a10dd015d455f23b81156e5a05612))
+
 ## 5.92.0 (2026-04-29)
 
 Full Changelog: [v5.91.0...v5.92.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.91.0...v5.92.0)

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.92.0"
+gem "telnyx", "~> 5.94.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -15,14 +15,6 @@ module Telnyx
         #   @return [String]
         required :instructions, String
 
-        # @!attribute model
-        #   ID of the model to use. You can use the
-        #   [Get models API](https://developers.telnyx.com/api-reference/chat/get-available-models)
-        #   to see all of your available models,
-        #
-        #   @return [String]
-        required :model, String
-
         # @!attribute name
         #
         #   @return [String]
@@ -39,11 +31,24 @@ module Telnyx
         #   @return [Hash{Symbol=>Object}, nil]
         optional :dynamic_variables, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
 
+        # @!attribute dynamic_variables_webhook_timeout_ms
+        #   Timeout in milliseconds for the dynamic variables webhook. Must be between 1 and
+        #   10000 ms. If the webhook does not respond within this timeout, the call proceeds
+        #   with default values. See the
+        #   [dynamic variables guide](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables).
+        #
+        #   @return [Integer, nil]
+        optional :dynamic_variables_webhook_timeout_ms, Integer
+
         # @!attribute dynamic_variables_webhook_url
-        #   If the dynamic_variables_webhook_url is set for the assistant, we will send a
-        #   request at the start of the conversation. See our
-        #   [guide](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
-        #   for more information.
+        #   If `dynamic_variables_webhook_url` is set, Telnyx sends a POST request to this
+        #   URL at the start of the conversation to resolve dynamic variables. **Gotcha:**
+        #   the webhook response must wrap variables under a top-level `dynamic_variables`
+        #   object, e.g. `{"dynamic_variables": {"customer_name": "Jane"}}`. Returning a
+        #   flat object will be ignored and variables will fall back to their defaults. See
+        #   the
+        #   [dynamic variables guide](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
+        #   for the full request/response format and timeout behavior.
         #
         #   @return [String, nil]
         optional :dynamic_variables_webhook_url, String
@@ -79,21 +84,61 @@ module Telnyx
         #   @return [Telnyx::Models::AI::InsightSettings, nil]
         optional :insight_settings, -> { Telnyx::AI::InsightSettings }
 
+        # @!attribute integrations
+        #   Connected integrations attached to the assistant. The catalog of available
+        #   integrations is at `/ai/integrations`; the user's connected integrations are at
+        #   `/ai/integrations/connections`. Each item references a catalog integration by
+        #   `integration_id`.
+        #
+        #   @return [Array<Telnyx::Models::AI::AssistantCreateParams::Integration>, nil]
+        optional :integrations,
+                 -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AssistantCreateParams::Integration] }
+
+        # @!attribute interruption_settings
+        #   Settings for interruptions and how the assistant decides the user has finished
+        #   speaking. These timings are most relevant when using non turn-taking
+        #   transcription models. For turn-taking models like `deepgram/flux`, end-of-turn
+        #   behavior is controlled by the transcription end-of-turn settings under
+        #   `transcription.settings` (`eot_threshold`, `eot_timeout_ms`,
+        #   `eager_eot_threshold`).
+        #
+        #   @return [Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings, nil]
+        optional :interruption_settings, -> { Telnyx::AI::AssistantCreateParams::InterruptionSettings }
+
         # @!attribute llm_api_key_ref
-        #   This is only needed when using third-party inference providers. The `identifier`
-        #   for an integration secret
+        #   This is only needed when using third-party inference providers selected by
+        #   `model`. The `identifier` for an integration secret
         #   [/v2/integration_secrets](https://developers.telnyx.com/api-reference/integration-secrets/create-a-secret)
-        #   that refers to your LLM provider's API key. Warning: Free plans are unlikely to
-        #   work with this integration.
+        #   that refers to your LLM provider's API key. For bring-your-own endpoint
+        #   authentication, use `external_llm.llm_api_key_ref` instead. Warning: Free plans
+        #   are unlikely to work with this integration.
         #
         #   @return [String, nil]
         optional :llm_api_key_ref, String
 
+        # @!attribute mcp_servers
+        #   MCP servers attached to the assistant. Create MCP servers with
+        #   `/ai/mcp_servers`, then reference them by `id` here.
+        #
+        #   @return [Array<Telnyx::Models::AI::AssistantCreateParams::McpServer>, nil]
+        optional :mcp_servers,
+                 -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AssistantCreateParams::McpServer] }
+
         # @!attribute messaging_settings
         #
         #   @return [Telnyx::Models::AI::MessagingSettings, nil]
         optional :messaging_settings, -> { Telnyx::AI::MessagingSettings }
 
+        # @!attribute model
+        #   ID of the model to use when `external_llm` is not set. You can use the
+        #   [Get models API](https://developers.telnyx.com/api-reference/chat/get-available-models)
+        #   to see available models. If `external_llm` is provided, the assistant uses
+        #   `external_llm` instead of this field. If neither `model` nor `external_llm` is
+        #   provided, Telnyx applies the default model.
+        #
+        #   @return [String, nil]
+        optional :model, String
+
         # @!attribute observability_settings
         #
         #   @return [Telnyx::Models::AI::ObservabilityReq, nil]
@@ -115,19 +160,29 @@ module Telnyx
         #   @return [Telnyx::Models::AI::PrivacySettings, nil]
         optional :privacy_settings, -> { Telnyx::AI::PrivacySettings }
 
+        # @!attribute tags
+        #   Tags associated with the assistant. Tags can also be managed with the assistant
+        #   tag endpoints.
+        #
+        #   @return [Array<String>, nil]
+        optional :tags, Telnyx::Internal::Type::ArrayOf[String]
+
         # @!attribute telephony_settings
         #
         #   @return [Telnyx::Models::AI::TelephonySettings, nil]
         optional :telephony_settings, -> { Telnyx::AI::TelephonySettings }
 
         # @!attribute tool_ids
+        #   IDs of shared tools to attach to the assistant. New integrations should prefer
+        #   `tool_ids` over inline `tools`.
         #
         #   @return [Array<String>, nil]
         optional :tool_ids, Telnyx::Internal::Type::ArrayOf[String]
 
         # @!attribute tools
-        #   The tools that the assistant can use. These may be templated with
-        #   [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
+        #   Deprecated for new integrations. Inline tool definitions available to the
+        #   assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
+        #   endpoints.
         #
         #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, 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>, nil]
         optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
@@ -148,21 +203,21 @@ module Telnyx
         #   @return [Telnyx::Models::AI::WidgetSettings, nil]
         optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-        # @!method initialize(instructions:, model:, name:, description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, llm_api_key_ref: nil, messaging_settings: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, request_options: {})
+        # @!method initialize(instructions:, name:, description: nil, dynamic_variables: nil, dynamic_variables_webhook_timeout_ms: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, external_llm: nil, fallback_config: nil, greeting: nil, insight_settings: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::AssistantCreateParams} for more details.
         #
         #   @param instructions [String] System instructions for the assistant. These may be templated with [dynamic vari
         #
-        #   @param model [String] ID of the model to use. You can use the [Get models API](https://developers.teln
-        #
         #   @param name [String]
         #
         #   @param description [String]
         #
         #   @param dynamic_variables [Hash{Symbol=>Object}] Map of dynamic variables and their default values
         #
-        #   @param dynamic_variables_webhook_url [String] If the dynamic_variables_webhook_url is set for the assistant, we will send a re
+        #   @param dynamic_variables_webhook_timeout_ms [Integer] Timeout in milliseconds for the dynamic variables webhook. Must be between 1 and
+        #
+        #   @param dynamic_variables_webhook_url [String] If `dynamic_variables_webhook_url` is set, Telnyx sends a POST request to this U
         #
         #   @param enabled_features [Array<Symbol, Telnyx::Models::AI::EnabledFeatures>]
         #
@@ -174,21 +229,31 @@ module Telnyx
         #
         #   @param insight_settings [Telnyx::Models::AI::InsightSettings]
         #
-        #   @param llm_api_key_ref [String] This is only needed when using third-party inference providers. The `identifier`
+        #   @param integrations [Array<Telnyx::Models::AI::AssistantCreateParams::Integration>] Connected integrations attached to the assistant. The catalog of available integ
+        #
+        #   @param interruption_settings [Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings] Settings for interruptions and how the assistant decides the user has finished s
+        #
+        #   @param llm_api_key_ref [String] This is only needed when using third-party inference providers selected by `mode
+        #
+        #   @param mcp_servers [Array<Telnyx::Models::AI::AssistantCreateParams::McpServer>] MCP servers attached to the assistant. Create MCP servers with `/ai/mcp_servers`
         #
         #   @param messaging_settings [Telnyx::Models::AI::MessagingSettings]
         #
+        #   @param model [String] ID of the model to use when `external_llm` is not set. You can use the [Get mode
+        #
         #   @param observability_settings [Telnyx::Models::AI::ObservabilityReq]
         #
         #   @param post_conversation_settings [Telnyx::Models::AI::AssistantCreateParams::PostConversationSettings] Configuration for post-conversation processing. When enabled, the assistant rece
         #
         #   @param privacy_settings [Telnyx::Models::AI::PrivacySettings]
         #
+        #   @param tags [Array<String>] Tags associated with the assistant. Tags can also be managed with the assistant
+        #
         #   @param telephony_settings [Telnyx::Models::AI::TelephonySettings]
         #
-        #   @param tool_ids [Array<String>]
+        #   @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
         #
-        #   @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, 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>] The tools that the assistant can use. These may be templated with [dynamic varia
+        #   @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, 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>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #
@@ -226,11 +291,13 @@ module Telnyx
           optional :certificate_ref, String
 
           # @!attribute forward_metadata
-          #   When enabled, Telnyx forwards the assistant's dynamic variables to the external
-          #   LLM endpoint. Defaults to false. The chat completion request includes a
-          #   top-level `extra_metadata` object when dynamic variables are available. For
-          #   example:
-          #   `{"extra_metadata":{"customer_name":"Jane","account_id":"acct_789","telnyx_agent_target":"+13125550100","telnyx_end_user_target":"+13125550123"}}`.
+          #   When `true`, Telnyx forwards the assistant's dynamic variables to the external
+          #   LLM endpoint as a top-level `extra_metadata` object on the chat completion
+          #   request body. Defaults to `false`. Example payload sent to the external
+          #   endpoint:
+          #   `{"extra_metadata": {"customer_name": "Jane", "account_id": "acct_789", "telnyx_agent_target": "+13125550100", "telnyx_end_user_target": "+13125550123"}}`.
+          #   Distinct from OpenAI's native `metadata` field, which has its own size and type
+          #   limits.
           #
           #   @return [Boolean, nil]
           optional :forward_metadata, Telnyx::Internal::Type::Boolean
@@ -259,7 +326,7 @@ module Telnyx
           #
           #   @param certificate_ref [String] Integration secret identifier for the client certificate used with certificate a
           #
-          #   @param forward_metadata [Boolean] When enabled, Telnyx forwards the assistant's dynamic variables to the external
+          #   @param forward_metadata [Boolean] When `true`, Telnyx forwards the assistant's dynamic variables to the external L
           #
           #   @param llm_api_key_ref [String] Integration secret identifier for the external LLM API key.
           #
@@ -337,11 +404,13 @@ module Telnyx
             optional :certificate_ref, String
 
             # @!attribute forward_metadata
-            #   When enabled, Telnyx forwards the assistant's dynamic variables to the external
-            #   LLM endpoint. Defaults to false. The chat completion request includes a
-            #   top-level `extra_metadata` object when dynamic variables are available. For
-            #   example:
-            #   `{"extra_metadata":{"customer_name":"Jane","account_id":"acct_789","telnyx_agent_target":"+13125550100","telnyx_end_user_target":"+13125550123"}}`.
+            #   When `true`, Telnyx forwards the assistant's dynamic variables to the external
+            #   LLM endpoint as a top-level `extra_metadata` object on the chat completion
+            #   request body. Defaults to `false`. Example payload sent to the external
+            #   endpoint:
+            #   `{"extra_metadata": {"customer_name": "Jane", "account_id": "acct_789", "telnyx_agent_target": "+13125550100", "telnyx_end_user_target": "+13125550123"}}`.
+            #   Distinct from OpenAI's native `metadata` field, which has its own size and type
+            #   limits.
             #
             #   @return [Boolean, nil]
             optional :forward_metadata, Telnyx::Internal::Type::Boolean
@@ -371,7 +440,7 @@ module Telnyx
             #
             #   @param certificate_ref [String] Integration secret identifier for the client certificate used with certificate a
             #
-            #   @param forward_metadata [Boolean] When enabled, Telnyx forwards the assistant's dynamic variables to the external
+            #   @param forward_metadata [Boolean] When `true`, Telnyx forwards the assistant's dynamic variables to the external L
             #
             #   @param llm_api_key_ref [String] Integration secret identifier for the external LLM API key.
             #
@@ -392,6 +461,165 @@ module Telnyx
           end
         end
 
+        class Integration < Telnyx::Internal::Type::BaseModel
+          # @!attribute integration_id
+          #   Catalog integration ID to attach. This is the `id` from the integrations catalog
+          #   at `/ai/integrations` (the same value also appears as `integration_id` on
+          #   entries returned by `/ai/integrations/connections`). It is **not** the
+          #   connection-level `id` from `/ai/integrations/connections`.
+          #
+          #   @return [String]
+          required :integration_id, String
+
+          # @!attribute allowed_list
+          #   Optional per-assistant allowlist of integration tool names. When omitted or
+          #   empty, all tools allowed by the connected integration are available to the
+          #   assistant.
+          #
+          #   @return [Array<String>, nil]
+          optional :allowed_list, Telnyx::Internal::Type::ArrayOf[String]
+
+          # @!method initialize(integration_id:, allowed_list: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantCreateParams::Integration} for more details.
+          #
+          #   Reference to a connected integration attached to an assistant. Discover
+          #   available integrations with `/ai/integrations` and connected integrations with
+          #   `/ai/integrations/connections`.
+          #
+          #   @param integration_id [String] Catalog integration ID to attach. This is the `id` from the integrations catalog
+          #
+          #   @param allowed_list [Array<String>] Optional per-assistant allowlist of integration tool names. When omitted or empt
+        end
+
+        class InterruptionSettings < Telnyx::Internal::Type::BaseModel
+          # @!attribute enable
+          #   Whether users can interrupt the assistant while it is speaking.
+          #
+          #   @return [Boolean, nil]
+          optional :enable, Telnyx::Internal::Type::Boolean
+
+          # @!attribute start_speaking_plan
+          #   Controls when the assistant starts speaking after the user stops. These
+          #   thresholds primarily apply to non turn-taking transcription models. For
+          #   turn-taking models like `deepgram/flux`, end-of-turn detection is driven by the
+          #   transcription end-of-turn settings under `transcription.settings` instead.
+          #
+          #   @return [Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings::StartSpeakingPlan, nil]
+          optional :start_speaking_plan,
+                   -> { Telnyx::AI::AssistantCreateParams::InterruptionSettings::StartSpeakingPlan }
+
+          # @!method initialize(enable: nil, start_speaking_plan: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings} for more
+          #   details.
+          #
+          #   Settings for interruptions and how the assistant decides the user has finished
+          #   speaking. These timings are most relevant when using non turn-taking
+          #   transcription models. For turn-taking models like `deepgram/flux`, end-of-turn
+          #   behavior is controlled by the transcription end-of-turn settings under
+          #   `transcription.settings` (`eot_threshold`, `eot_timeout_ms`,
+          #   `eager_eot_threshold`).
+          #
+          #   @param enable [Boolean] Whether users can interrupt the assistant while it is speaking.
+          #
+          #   @param start_speaking_plan [Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings::StartSpeakingPlan] Controls when the assistant starts speaking after the user stops. These threshol
+
+          # @see Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings#start_speaking_plan
+          class StartSpeakingPlan < Telnyx::Internal::Type::BaseModel
+            # @!attribute transcription_endpointing_plan
+            #   Endpointing thresholds used to decide when the user has finished speaking.
+            #   Applies to non turn-taking transcription models. For `deepgram/flux`, use
+            #   `transcription.settings.eot_threshold` / `eot_timeout_ms` /
+            #   `eager_eot_threshold`.
+            #
+            #   @return [Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings::StartSpeakingPlan::TranscriptionEndpointingPlan, nil]
+            optional :transcription_endpointing_plan,
+                     -> { Telnyx::AI::AssistantCreateParams::InterruptionSettings::StartSpeakingPlan::TranscriptionEndpointingPlan }
+
+            # @!attribute wait_seconds
+            #   Minimum seconds to wait before the assistant starts speaking.
+            #
+            #   @return [Float, nil]
+            optional :wait_seconds, Float
+
+            # @!method initialize(transcription_endpointing_plan: nil, wait_seconds: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings::StartSpeakingPlan}
+            #   for more details.
+            #
+            #   Controls when the assistant starts speaking after the user stops. These
+            #   thresholds primarily apply to non turn-taking transcription models. For
+            #   turn-taking models like `deepgram/flux`, end-of-turn detection is driven by the
+            #   transcription end-of-turn settings under `transcription.settings` instead.
+            #
+            #   @param transcription_endpointing_plan [Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings::StartSpeakingPlan::TranscriptionEndpointingPlan] Endpointing thresholds used to decide when the user has finished speaking. Appli
+            #
+            #   @param wait_seconds [Float] Minimum seconds to wait before the assistant starts speaking.
+
+            # @see Telnyx::Models::AI::AssistantCreateParams::InterruptionSettings::StartSpeakingPlan#transcription_endpointing_plan
+            class TranscriptionEndpointingPlan < Telnyx::Internal::Type::BaseModel
+              # @!attribute on_no_punctuation_seconds
+              #   Seconds to wait after the transcript ends without punctuation.
+              #
+              #   @return [Float, nil]
+              optional :on_no_punctuation_seconds, Float
+
+              # @!attribute on_number_seconds
+              #   Seconds to wait after the transcript ends with a number.
+              #
+              #   @return [Float, nil]
+              optional :on_number_seconds, Float
+
+              # @!attribute on_punctuation_seconds
+              #   Seconds to wait after the transcript ends with punctuation.
+              #
+              #   @return [Float, nil]
+              optional :on_punctuation_seconds, Float
+
+              # @!method initialize(on_no_punctuation_seconds: nil, on_number_seconds: nil, on_punctuation_seconds: nil)
+              #   Endpointing thresholds used to decide when the user has finished speaking.
+              #   Applies to non turn-taking transcription models. For `deepgram/flux`, use
+              #   `transcription.settings.eot_threshold` / `eot_timeout_ms` /
+              #   `eager_eot_threshold`.
+              #
+              #   @param on_no_punctuation_seconds [Float] Seconds to wait after the transcript ends without punctuation.
+              #
+              #   @param on_number_seconds [Float] Seconds to wait after the transcript ends with a number.
+              #
+              #   @param on_punctuation_seconds [Float] Seconds to wait after the transcript ends with punctuation.
+            end
+          end
+        end
+
+        class McpServer < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #   ID of the MCP server to attach. This must be the `id` of an MCP server returned
+          #   by the `/ai/mcp_servers` endpoints.
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute allowed_tools
+          #   Optional per-assistant allowlist of MCP tool names. When omitted, the assistant
+          #   uses the MCP server's configured `allowed_tools`.
+          #
+          #   @return [Array<String>, nil]
+          optional :allowed_tools, Telnyx::Internal::Type::ArrayOf[String]
+
+          # @!method initialize(id:, allowed_tools: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantCreateParams::McpServer} for more details.
+          #
+          #   Reference to an MCP server attached to an assistant. Create and manage MCP
+          #   servers with the `/ai/mcp_servers` endpoints, then attach them to assistants by
+          #   ID.
+          #
+          #   @param id [String] ID of the MCP server to attach. This must be the `id` of an MCP server returned
+          #
+          #   @param allowed_tools [Array<String>] Optional per-assistant allowlist of MCP tool names. When omitted, the assistant
+        end
+
         class PostConversationSettings < Telnyx::Internal::Type::BaseModel
           # @!attribute enabled
           #   Whether post-conversation processing is enabled. When true, the assistant will

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

@@ -140,11 +140,12 @@ module Telnyx
 
             # @!attribute targets
             #   The different possible targets of the transfer. The assistant will be able to
-            #   choose one of the targets to transfer the call to.
+            #   choose one of the targets to transfer the call to. This can also be a dynamic
+            #   variable string like `{{ targets }}` where `targets` is returned by the dynamic
+            #   variables webhook and resolves to an array of target objects at runtime.
             #
-            #   @return [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Target>]
-            required :targets,
-                     -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AssistantTool::Transfer::Transfer::Target] }
+            #   @return [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Targets::UnionMember0>, String]
+            required :targets, union: -> { Telnyx::AI::AssistantTool::Transfer::Transfer::Targets }
 
             # @!attribute custom_headers
             #   Custom headers to be added to the SIP INVITE for the transfer command.
@@ -183,7 +184,7 @@ module Telnyx
             #
             #   @param from [String] Number or SIP URI placing the call.
             #
-            #   @param targets [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Target>] The different possible targets of the transfer. The assistant will be able to ch
+            #   @param targets [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Targets::UnionMember0>, String] The different possible targets of the transfer. The assistant will be able to ch
             #
             #   @param custom_headers [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::CustomHeader>] Custom headers to be added to the SIP INVITE for the transfer command.
             #
@@ -193,23 +194,47 @@ module Telnyx
             #
             #   @param warm_transfer_instructions [String] Natural language instructions for your agent for how to provide context for the
 
-            class Target < Telnyx::Internal::Type::BaseModel
-              # @!attribute name
-              #   The name of the target.
-              #
-              #   @return [String, nil]
-              optional :name, String
+            # The different possible targets of the transfer. The assistant will be able to
+            # choose one of the targets to transfer the call to. This can also be a dynamic
+            # variable string like `{{ targets }}` where `targets` is returned by the dynamic
+            # variables webhook and resolves to an array of target objects at runtime.
+            #
+            # @see Telnyx::Models::AI::AssistantTool::Transfer::Transfer#targets
+            module Targets
+              extend Telnyx::Internal::Type::Union
 
-              # @!attribute to
-              #   The destination number or SIP URI of the call.
-              #
-              #   @return [String, nil]
-              optional :to, String
+              variant -> { Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Targets::UnionMember0Array }
 
-              # @!method initialize(name: nil, to: nil)
-              #   @param name [String] The name of the target.
-              #
-              #   @param to [String] The destination number or SIP URI of the call.
+              # A dynamic variable string like `{{ targets }}` where `targets` is returned by the dynamic variables webhook and resolves to an array of target objects at runtime.
+              variant String
+
+              class UnionMember0 < Telnyx::Internal::Type::BaseModel
+                # @!attribute to
+                #   The destination number or SIP URI of the call.
+                #
+                #   @return [String]
+                required :to, String
+
+                # @!attribute name
+                #   The name of the target.
+                #
+                #   @return [String, nil]
+                optional :name, String
+
+                # @!method initialize(to:, name: nil)
+                #   @param to [String] The destination number or SIP URI of the call.
+                #
+                #   @param name [String] The name of the target.
+              end
+
+              # @!method self.variants
+              #   @return [Array(Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Targets::UnionMember0>, String)]
+
+              # @type [Telnyx::Internal::Type::Converter]
+              UnionMember0Array =
+                Telnyx::Internal::Type::ArrayOf[-> {
+                  Telnyx::AI::AssistantTool::Transfer::Transfer::Targets::UnionMember0
+                }]
             end
 
             class CustomHeader < Telnyx::Internal::Type::BaseModel
@@ -512,6 +537,21 @@ module Telnyx
             #   @return [String, nil]
             optional :from, String
 
+            # @!attribute targets
+            #   The different possible targets of the invite. The assistant will be able to
+            #   choose one of the targets to invite to the call. This can also be a dynamic
+            #   variable string like `{{ targets }}` where `targets` is returned by the dynamic
+            #   variables webhook and resolves to an array of target objects at runtime. If
+            #   omitted or null, the invite tool can still be configured and targets may be
+            #   supplied dynamically at runtime.
+            #
+            #   @return [Array<Telnyx::Models::AI::AssistantTool::Invite::InviteConfig::Targets::UnionMember0>, String, nil]
+            optional :targets,
+                     union: -> {
+                       Telnyx::AI::AssistantTool::Invite::InviteConfig::Targets
+                     },
+                     nil?: true
+
             # @!attribute voicemail_detection
             #   Configuration for voicemail detection (AMD - Answering Machine Detection) on the
             #   invited call.
@@ -519,7 +559,7 @@ module Telnyx
             #   @return [Telnyx::Models::AI::AssistantTool::Invite::InviteConfig::VoicemailDetection, nil]
             optional :voicemail_detection, -> { Telnyx::AI::AssistantTool::Invite::InviteConfig::VoicemailDetection }
 
-            # @!method initialize(custom_headers: nil, from: nil, voicemail_detection: nil)
+            # @!method initialize(custom_headers: nil, from: nil, targets: nil, voicemail_detection: nil)
             #   Some parameter documentations has been truncated, see
             #   {Telnyx::Models::AI::AssistantTool::Invite::InviteConfig} for more details.
             #
@@ -527,6 +567,8 @@ module Telnyx
             #
             #   @param from [String] Number or SIP URI placing the call.
             #
+            #   @param targets [Array<Telnyx::Models::AI::AssistantTool::Invite::InviteConfig::Targets::UnionMember0>, String, nil] The different possible targets of the invite. The assistant will be able to choo
+            #
             #   @param voicemail_detection [Telnyx::Models::AI::AssistantTool::Invite::InviteConfig::VoicemailDetection] Configuration for voicemail detection (AMD - Answering Machine Detection) on the
 
             class CustomHeader < Telnyx::Internal::Type::BaseModel
@@ -554,6 +596,51 @@ module Telnyx
               #   @param value [String] The value of the header. Note that we support mustache templating for the value.
             end
 
+            # The different possible targets of the invite. The assistant will be able to
+            # choose one of the targets to invite to the call. This can also be a dynamic
+            # variable string like `{{ targets }}` where `targets` is returned by the dynamic
+            # variables webhook and resolves to an array of target objects at runtime. If
+            # omitted or null, the invite tool can still be configured and targets may be
+            # supplied dynamically at runtime.
+            #
+            # @see Telnyx::Models::AI::AssistantTool::Invite::InviteConfig#targets
+            module Targets
+              extend Telnyx::Internal::Type::Union
+
+              variant -> { Telnyx::Models::AI::AssistantTool::Invite::InviteConfig::Targets::UnionMember0Array }
+
+              # A dynamic variable string like `{{ targets }}` where `targets` is returned by the dynamic variables webhook and resolves to an array of target objects at runtime.
+              variant String
+
+              class UnionMember0 < Telnyx::Internal::Type::BaseModel
+                # @!attribute to
+                #   The destination number or SIP URI of the call.
+                #
+                #   @return [String]
+                required :to, String
+
+                # @!attribute name
+                #   The name of the target.
+                #
+                #   @return [String, nil]
+                optional :name, String
+
+                # @!method initialize(to:, name: nil)
+                #   @param to [String] The destination number or SIP URI of the call.
+                #
+                #   @param name [String] The name of the target.
+              end
+
+              # @!method self.variants
+              #   @return [Array(Array<Telnyx::Models::AI::AssistantTool::Invite::InviteConfig::Targets::UnionMember0>, String)]
+
+              # @type [Telnyx::Internal::Type::Converter]
+              UnionMember0Array =
+                Telnyx::Internal::Type::ArrayOf[-> {
+                  Telnyx::AI::AssistantTool::Invite::InviteConfig::Targets::UnionMember0
+                }]
+            end
+
             # @see Telnyx::Models::AI::AssistantTool::Invite::InviteConfig#voicemail_detection
             class VoicemailDetection < Telnyx::Internal::Type::BaseModel
               # @!attribute detection_mode