telnyx 5.167.0 → 5.169.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f5a7b6ace13da0db2916ffb24b660a9962dfad65f5eb3819e213c8c597f209c
-  data.tar.gz: 644d79c57acf38c80b5999ae6dcf8f0af37f2388eb9dda400a46e278f55eb086
+  metadata.gz: 76b412afdb06cd9324668c45647f9f1ab4045cfe7e4661987dbb3399f7d0b5d6
+  data.tar.gz: 1506a292fecf24c7ce4d8126f65307ed8d86c95d44dd3defa42f793be424988a
 SHA512:
-  metadata.gz: 8a68107acbe2ef210dd4c0805cb2942bf97b013779702c580caa0f09b5a39a571f723c83510ce42f8bc33fb22ab3b693a80076e7337554160c3183684ecbc642
-  data.tar.gz: 404495a79c4f5362bc70cd9377c5f1eb1580b5315612580c1251ffb8ff2e974111840d1134c9311bb39810e62bb66d6fd8ddfd7bf65d8a22906bbdf0c817946a
+  metadata.gz: 50bc3aab30f7bac32f7eb71dcf6b7a7998a7f72413159faf3153282d4b2facf4228d8af53f5a459bcf28a07783c6f630bc8cfa7ff23bfe093c699c34b3f22d0e
+  data.tar.gz: 70985f4731b3c28bea7a97a8993f5c5af3c18e94f6a69424e55853742e9593b873379f2f43fbc5aca61a12cc9e500a8f55db44a6f7637a80a8a3f00007ac0f9f

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [5.169.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.168.0...v5.169.0) (2026-09-23)
+
+
+### Features
+
+* promote from staging 6f6d71d ([a11416d](https://github.com/team-telnyx/telnyx-ruby/commit/a11416d75ef0d775c45e8b94a7fd85e57a2a8df9))
+
+## [5.168.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.167.0...v5.168.0) (2026-09-13)
+
+
+### Features
+
+* promote from staging f4ba656 ([ddd49d8](https://github.com/team-telnyx/telnyx-ruby/commit/ddd49d86929e68d0193fae2edf51e202d5222674))
+
 ## [5.167.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.166.0...v5.167.0) (2026-09-07)
 
 

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.167.0"
+gem "telnyx", "~> 5.169.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/client.rb

@@ -735,6 +735,44 @@ module Telnyx
     # @return [Telnyx::Resources::ExternalRequirements]
     attr_reader :external_requirements
 
+    # @return [Telnyx::Resources::Compute]
+    attr_reader :compute
+
+    # Noise suppression engines that can be selected when configuring noise
+    # suppression on voice connections.
+    # @return [Telnyx::Resources::NoiseSuppressionEngines]
+    attr_reader :noise_suppression_engines
+
+    # Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA
+    # challenge designed to be easy for LLMs and hard for humans, registers an
+    # account, and signs in by consuming a magic link emailed to the account owner.
+    # All endpoints are public and unauthenticated; signup endpoints are additionally
+    # gated by the freemium feature flags and per-country availability.
+    # @return [Telnyx::Resources::BotChallenge]
+    attr_reader :bot_challenge
+
+    # Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA
+    # challenge designed to be easy for LLMs and hard for humans, registers an
+    # account, and signs in by consuming a magic link emailed to the account owner.
+    # All endpoints are public and unauthenticated; signup endpoints are additionally
+    # gated by the freemium feature flags and per-country availability.
+    # @return [Telnyx::Resources::BotSessions]
+    attr_reader :bot_sessions
+
+    # Agentic (bot) signup for Telnyx accounts. An AI agent solves a reverse-CAPTCHA
+    # challenge designed to be easy for LLMs and hard for humans, registers an
+    # account, and signs in by consuming a magic link emailed to the account owner.
+    # All endpoints are public and unauthenticated; signup endpoints are additionally
+    # gated by the freemium feature flags and per-country availability.
+    # @return [Telnyx::Resources::BotSignup]
+    attr_reader :bot_signup
+
+    # Machine payment (MPP) account-credit operations. Fund your Telnyx account
+    # programmatically from a machine or agent using the Machine Payment Protocol, an
+    # HTTP-402 flow settled via Stripe or Tempo.
+    # @return [Telnyx::Resources::MachinePayments]
+    attr_reader :machine_payments
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -1026,6 +1064,12 @@ module Telnyx
       @web_search = Telnyx::Resources::WebSearch.new(client: self)
       @meeting_sessions = Telnyx::Resources::MeetingSessions.new(client: self)
       @external_requirements = Telnyx::Resources::ExternalRequirements.new(client: self)
+      @compute = Telnyx::Resources::Compute.new(client: self)
+      @noise_suppression_engines = Telnyx::Resources::NoiseSuppressionEngines.new(client: self)
+      @bot_challenge = Telnyx::Resources::BotChallenge.new(client: self)
+      @bot_sessions = Telnyx::Resources::BotSessions.new(client: self)
+      @bot_signup = Telnyx::Resources::BotSignup.new(client: self)
+      @machine_payments = Telnyx::Resources::MachinePayments.new(client: self)
     end
   end
 end

data/lib/telnyx/internal/type/union.rb

@@ -8,24 +8,24 @@ module Telnyx
       # @example
       #   # `assistant_tool` is a `Telnyx::AI::AssistantTool`
       #   case assistant_tool
+      #   when Telnyx::AI::AssistantTool::Function
+      #     puts(assistant_tool.function)
       #   when Telnyx::AI::InferenceEmbeddingWebhookToolParams
       #     puts(assistant_tool.type)
       #   when Telnyx::AI::AssistantTool::ClientSideTool
       #     puts(assistant_tool.client_side_tool)
-      #   when Telnyx::AI::RetrievalTool
-      #     puts(assistant_tool.retrieval)
       #   else
       #     puts(assistant_tool)
       #   end
       #
       # @example
       #   case assistant_tool
-      #   in {type: :webhook, webhook: webhook}
+      #   in {type: :function, function: function, shared: shared}
+      #     puts(function)
+      #   in {type: :webhook, webhook: webhook, shared: shared}
       #     puts(webhook)
-      #   in {type: :client_side_tool, client_side_tool: client_side_tool}
+      #   in {type: :client_side_tool, client_side_tool: client_side_tool, shared: shared}
       #     puts(client_side_tool)
-      #   in {type: :retrieval, retrieval: retrieval}
-      #     puts(retrieval)
       #   else
       #     puts(assistant_tool)
       #   end

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

@@ -0,0 +1,195 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      class AssistantA2AAgent < Telnyx::Internal::Type::BaseModel
+        # @!attribute name
+        #   Identifies the agent and seeds the names of the tools derived from its card
+        #   (`a2a_<name>_<skill_id>`). Characters outside `[A-Za-z0-9_]` are replaced with
+        #   `_` before the tool name is built, so two agents whose names differ only in
+        #   punctuation collide and are rejected.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute url
+        #   The agent's base URL, or the URL of its agent card. At most 2,048 bytes once
+        #   UTF-8 encoded. `/.well-known/agent-card.json` is appended to the path unless it
+        #   already ends in `.json`. Must be an `http://` or `https://` URL for an
+        #   externally reachable host: internal destinations (`localhost`, private and
+        #   reserved IP ranges, `.local` domains) are rejected, and the hostname may not
+        #   contain a `{{...}}` placeholder. Placeholders in the path are allowed.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!attribute async
+        #   When `true`, the assistant hands the turn straight back to the model and the
+        #   agent's answer is delivered into the conversation once it arrives, instead of
+        #   the caller waiting for it in silence.
+        #
+        #   @return [Boolean, nil]
+        optional :async, Telnyx::Internal::Type::Boolean
+
+        # @!attribute headers
+        #   Headers sent when fetching this agent's card and on every call made to it. Use
+        #   them to authenticate to the agent.
+        #
+        #   @return [Array<Telnyx::Models::AI::AssistantA2AAgent::Header>, nil]
+        optional :headers, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AssistantA2AAgent::Header] }
+
+        # @!attribute messages
+        #   Filler messages spoken while a call to this agent is in progress.
+        #   `request_start` messages are spoken immediately when the call begins.
+        #   `request_response_delayed` messages are spoken after `timing_ms` has elapsed
+        #   only if the agent has not answered yet. Filler messages are not used when
+        #   `async` is `true`.
+        #
+        #   @return [Array<Telnyx::Models::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage, Telnyx::Models::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage>, nil]
+        optional :messages, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantA2AAgent::Message] }
+
+        # @!attribute poll_interval_ms
+        #   How often, in milliseconds, to poll an agent task that has not finished yet.
+        #   Defaults to 500.
+        #
+        #   @return [Integer, nil]
+        optional :poll_interval_ms, Integer
+
+        # @!attribute timeout_ms
+        #   Total budget, in milliseconds, for one call to this agent, including any time
+        #   spent polling a task that is still running. Omit to inherit the assistant's tool
+        #   timeout.
+        #
+        #   @return [Integer, nil]
+        optional :timeout_ms, Integer
+
+        # @!method initialize(name:, url:, async: nil, headers: nil, messages: nil, poll_interval_ms: nil, timeout_ms: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::AssistantA2AAgent} for more details.
+        #
+        #   A remote agent, reachable over the A2A (Agent2Agent) protocol, that an assistant
+        #   can delegate to. Tools are not configured here: at the start of every
+        #   conversation the agent's card is fetched and one tool is derived per skill the
+        #   card advertises.
+        #
+        #   @param name [String] Identifies the agent and seeds the names of the tools derived from its card (`a2
+        #
+        #   @param url [String] The agent's base URL, or the URL of its agent card. At most 2,048 bytes once UTF
+        #
+        #   @param async [Boolean] When `true`, the assistant hands the turn straight back to the model and the age
+        #
+        #   @param headers [Array<Telnyx::Models::AI::AssistantA2AAgent::Header>] Headers sent when fetching this agent's card and on every call made to it. Use t
+        #
+        #   @param messages [Array<Telnyx::Models::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage, Telnyx::Models::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage>] Filler messages spoken while a call to this agent is in progress. `request_start
+        #
+        #   @param poll_interval_ms [Integer] How often, in milliseconds, to poll an agent task that has not finished yet. Def
+        #
+        #   @param timeout_ms [Integer] Total budget, in milliseconds, for one call to this agent, including any time sp
+
+        class Header < Telnyx::Internal::Type::BaseModel
+          # @!attribute name
+          #   HTTP header name. May only contain alphanumeric characters, hyphens, and
+          #   underscores, or a `{{dynamic_variable}}` placeholder surrounded by those
+          #   characters.
+          #
+          #   @return [String]
+          required :name, String
+
+          # @!attribute value
+          #   Header value, stored exactly as written. It may be a literal, a
+          #   `{{dynamic_variable}}`, or an
+          #   `{{#integration_secret}}identifier{{/integration_secret}}` section that resolves
+          #   to a stored integration secret when the conversation starts. Control characters
+          #   are not allowed. The encrypted `{{variable | encryption_secret_ref}}` form used
+          #   for per-caller credentials is not resolved here and is rejected when the
+          #   assistant is saved.
+          #
+          #   @return [String]
+          required :value, String
+
+          # @!method initialize(name:, value:)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantA2AAgent::Header} for more details.
+          #
+          #   A header sent when fetching an A2A agent's card and on every call made to that
+          #   agent.
+          #
+          #   @param name [String] HTTP header name. May only contain alphanumeric characters, hyphens, and undersc
+          #
+          #   @param value [String] Header value, stored exactly as written. It may be a literal, a `{{dynamic_varia
+        end
+
+        module Message
+          extend Telnyx::Internal::Type::Union
+
+          variant -> { Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage }
+
+          variant -> { Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage }
+
+          class A2AAgentRequestStartMessage < Telnyx::Internal::Type::BaseModel
+            # @!attribute content
+            #   The text the assistant speaks.
+            #
+            #   @return [String]
+            required :content, String
+
+            # @!attribute type
+            #   Speak the filler message immediately when the call to the agent begins.
+            #
+            #   @return [Symbol, :request_start]
+            required :type, const: :request_start
+
+            # @!attribute timing_ms
+            #   An optional delay value. This value is ignored for `request_start` messages.
+            #
+            #   @return [Integer, nil]
+            optional :timing_ms, Integer
+
+            # @!method initialize(content:, timing_ms: nil, type: :request_start)
+            #   @param content [String] The text the assistant speaks.
+            #
+            #   @param timing_ms [Integer] An optional delay value. This value is ignored for `request_start` messages.
+            #
+            #   @param type [Symbol, :request_start] Speak the filler message immediately when the call to the agent begins.
+          end
+
+          class A2AAgentRequestResponseDelayedMessage < Telnyx::Internal::Type::BaseModel
+            # @!attribute content
+            #   The text the assistant speaks.
+            #
+            #   @return [String]
+            required :content, String
+
+            # @!attribute timing_ms
+            #   How long to wait, in milliseconds, before speaking this message.
+            #
+            #   @return [Integer]
+            required :timing_ms, Integer
+
+            # @!attribute type
+            #   Speak the filler message only if the agent has not answered yet after
+            #   `timing_ms`.
+            #
+            #   @return [Symbol, :request_response_delayed]
+            required :type, const: :request_response_delayed
+
+            # @!method initialize(content:, timing_ms:, type: :request_response_delayed)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage}
+            #   for more details.
+            #
+            #   @param content [String] The text the assistant speaks.
+            #
+            #   @param timing_ms [Integer] How long to wait, in milliseconds, before speaking this message.
+            #
+            #   @param type [Symbol, :request_response_delayed] Speak the filler message only if the agent has not answered yet after `timing_ms
+          end
+
+          # @!method self.variants
+          #   @return [Array(Telnyx::Models::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage, Telnyx::Models::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage)]
+        end
+      end
+    end
+  end
+end

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

@@ -20,6 +20,19 @@ module Telnyx
         #   @return [String]
         required :name, String
 
+        # @!attribute a2a_agents
+        #   A2A agents this assistant can delegate to. Tools are not stored here: at the
+        #   start of every conversation each agent's card is fetched and one tool is derived
+        #   per skill the card advertises, named `a2a_<name>_<skill_id>`. The following
+        #   limits are not enforced when the assistant is saved, and anything past them is
+        #   dropped when the conversation starts: 64 agents per assistant, 64 skills per
+        #   card, 128 derived tools per assistant, and a 6 second budget for all card
+        #   fetches combined. An agent whose card cannot be fetched costs the assistant that
+        #   capability for the conversation; it does not fail the call.
+        #
+        #   @return [Array<Telnyx::Models::AI::AssistantA2AAgent>, nil]
+        optional :a2a_agents, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AssistantA2AAgent] }
+
         # @!attribute conversation_flow
         #   Conversation flow as supplied by API clients (create / update).
         #
@@ -155,10 +168,10 @@ module Telnyx
         # @!attribute post_conversation_settings
         #   Configuration for post-conversation processing. When enabled, the assistant
         #   receives one additional LLM turn after the conversation ends, allowing it to
-        #   execute tool calls such as logging to a CRM or sending a summary. The assistant
-        #   can execute multiple parallel or sequential tools during this phase.
-        #   Telephony-control tools (e.g. hangup, transfer) are unavailable
-        #   post-conversation. Beta feature.
+        #   execute final tool calls such as sending a summary or updating a record via
+        #   webhook or function tools. Integration and MCP server tools are not available
+        #   post-conversation; call-control tools (e.g. hangup, transfer) are also
+        #   unavailable. Beta feature.
         #
         #   @return [Telnyx::Models::AI::PostConversationSettingsReq, nil]
         optional :post_conversation_settings, -> { Telnyx::AI::PostConversationSettingsReq }
@@ -192,7 +205,7 @@ module Telnyx
         #   assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
         #   endpoints.
         #
-        #   @return [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]
+        #   @return [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, 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[union: Telnyx::AI::AssistantTool] }
 
         # @!attribute transcription
@@ -216,7 +229,7 @@ module Telnyx
         #   @return [String, nil]
         optional :idempotency_key, String
 
-        # @!method initialize(instructions:, name:, conversation_flow: nil, 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, idempotency_key: nil, request_options: {})
+        # @!method initialize(instructions:, name:, a2a_agents: nil, conversation_flow: nil, 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, idempotency_key: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::AssistantCreateParams} for more details.
         #
@@ -224,6 +237,8 @@ module Telnyx
         #
         #   @param name [String]
         #
+        #   @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] A2A agents this assistant can delegate to. Tools are not stored here: at the sta
+        #
         #   @param conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Conversation flow as supplied by API clients (create / update).
         #
         #   @param description [String]
@@ -268,7 +283,7 @@ module Telnyx
         #
         #   @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::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>] Deprecated for new integrations. Inline tool definitions available to the assist
+        #   @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, 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>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #