telnyx 5.167.0 → 5.168.0

data/lib/telnyx/resources/x402/credit_account/payments.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class X402
+      class CreditAccount
+        # Operations for x402 cryptocurrency payment transactions. Fund your Telnyx
+        # account using USDC stablecoin payments via the x402 protocol.
+        class Payments
+          # Returns a single x402 payment transaction by ID. The transaction must belong to
+          # the authenticated user; organization sub-users must have read permission on
+          # transactions. Returns 404 if the transaction does not exist or belongs to
+          # another user.
+          #
+          # @overload retrieve(id, request_options: {})
+          #
+          # @param id [String] The x402 payment transaction ID.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Models::X402::CreditAccount::PaymentRetrieveResponse]
+          #
+          # @see Telnyx::Models::X402::CreditAccount::PaymentRetrieveParams
+          def retrieve(id, params = {})
+            @client.request(
+              method: :get,
+              path: ["x402/credit_account/payments/%1$s", id],
+              model: Telnyx::Models::X402::CreditAccount::PaymentRetrieveResponse,
+              options: params[:request_options]
+            )
+          end
+
+          # Returns a paginated list of the authenticated user's x402 payment transactions,
+          # newest first. Organization sub-users must have read permission on transactions;
+          # without it the list is empty.
+          #
+          # @overload list(page_number: nil, page_size: nil, request_options: {})
+          #
+          # @param page_number [Integer] The page number to load.
+          #
+          # @param page_size [Integer] The size of the page.
+          #
+          # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::X402::CreditAccount::X402TransactionRecord>]
+          #
+          # @see Telnyx::Models::X402::CreditAccount::PaymentListParams
+          def list(params = {})
+            parsed, options = Telnyx::X402::CreditAccount::PaymentListParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "x402/credit_account/payments",
+              query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+              page: Telnyx::Internal::DefaultFlatPagination,
+              model: Telnyx::X402::CreditAccount::X402TransactionRecord,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/x402/credit_account.rb

@@ -6,6 +6,11 @@ module Telnyx
       # Operations for x402 cryptocurrency payment transactions. Fund your Telnyx
       # account using USDC stablecoin payments via the x402 protocol.
       class CreditAccount
+        # Operations for x402 cryptocurrency payment transactions. Fund your Telnyx
+        # account using USDC stablecoin payments via the x402 protocol.
+        # @return [Telnyx::Resources::X402::CreditAccount::Payments]
+        attr_reader :payments
+
         # Creates a payment quote for the specified USD amount. Returns payment details
         # including the x402 payment requirements, network, and expiration time. The quote
         # must be settled before it expires.
@@ -23,7 +28,7 @@ module Telnyx
           parsed, options = Telnyx::X402::CreditAccountCreateQuoteParams.dump_request(params)
           @client.request(
             method: :post,
-            path: "v2/x402/credit_account/quote",
+            path: "x402/credit_account/quote",
             body: parsed,
             model: Telnyx::Models::X402::CreditAccountCreateQuoteResponse,
             options: options
@@ -56,7 +61,7 @@ module Telnyx
           header_params = {header_payment_signature: "payment-signature"}
           @client.request(
             method: :post,
-            path: "v2/x402/credit_account",
+            path: "x402/credit_account",
             headers: parsed.slice(*header_params.keys).transform_keys(header_params),
             body: parsed.except(*header_params.keys),
             model: Telnyx::Models::X402::CreditAccountSettleResponse,
@@ -69,6 +74,7 @@ module Telnyx
         # @param client [Telnyx::Client]
         def initialize(client:)
           @client = client
+          @payments = Telnyx::Resources::X402::CreditAccount::Payments.new(client: client)
         end
       end
     end

data/lib/telnyx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telnyx
-  VERSION = "5.167.0"
+  VERSION = "5.168.0"
 end

data/lib/telnyx.rb

@@ -159,6 +159,7 @@ require_relative "telnyx/models/ai/anthropic/v1_messages_params"
 require_relative "telnyx/models/ai/anthropic/v1_messages_response"
 require_relative "telnyx/models/ai/arithmetic_expression"
 require_relative "telnyx/models/ai/assistant"
+require_relative "telnyx/models/ai/assistant_a2_a_agent"
 require_relative "telnyx/models/ai/assistant_chat_params"
 require_relative "telnyx/models/ai/assistant_chat_response"
 require_relative "telnyx/models/ai/assistant_clone_params"
@@ -791,6 +792,16 @@ require_relative "telnyx/models/comment_mark_as_read_params"
 require_relative "telnyx/models/comment_mark_as_read_response"
 require_relative "telnyx/models/comment_retrieve_params"
 require_relative "telnyx/models/comment_retrieve_response"
+require_relative "telnyx/models/compute/func_retrieve_logs_params"
+require_relative "telnyx/models/compute/func_retrieve_logs_response"
+require_relative "telnyx/models/compute/func_retrieve_metric_aggregates_params"
+require_relative "telnyx/models/compute/func_retrieve_metric_aggregates_response"
+require_relative "telnyx/models/compute/func_retrieve_revisions_params"
+require_relative "telnyx/models/compute/func_retrieve_revisions_response"
+require_relative "telnyx/models/compute/func_retrieve_ship_inspection_params"
+require_relative "telnyx/models/compute/func_retrieve_ship_inspection_response"
+require_relative "telnyx/models/compute/functions_observability_pagination_meta"
+require_relative "telnyx/models/compute/logs_meta"
 require_relative "telnyx/models/conference"
 require_relative "telnyx/models/conference_created"
 require_relative "telnyx/models/conference_created_webhook_event"
@@ -1668,6 +1679,7 @@ require_relative "telnyx/models/messaging_profile_create_params"
 require_relative "telnyx/models/messaging_profile_create_response"
 require_relative "telnyx/models/messaging_profile_delete_params"
 require_relative "telnyx/models/messaging_profile_delete_response"
+require_relative "telnyx/models/messaging_profile_features"
 require_relative "telnyx/models/messaging_profile_list_alphanumeric_sender_ids_params"
 require_relative "telnyx/models/messaging_profile_list_params"
 require_relative "telnyx/models/messaging_profile_list_phone_numbers_params"
@@ -2810,6 +2822,8 @@ require_relative "telnyx/models/whatsapp/phone_number_list_response"
 require_relative "telnyx/models/whatsapp/phone_number_resend_verification_params"
 require_relative "telnyx/models/whatsapp/phone_number_retrieve_conversation_window_params"
 require_relative "telnyx/models/whatsapp/phone_number_retrieve_conversation_window_response"
+require_relative "telnyx/models/whatsapp/phone_number_retrieve_phone_number_params"
+require_relative "telnyx/models/whatsapp/phone_number_retrieve_phone_number_response"
 require_relative "telnyx/models/whatsapp/phone_numbers/calling_setting_retrieve_params"
 require_relative "telnyx/models/whatsapp/phone_numbers/calling_setting_retrieve_response"
 require_relative "telnyx/models/whatsapp/phone_numbers/calling_setting_update_params"
@@ -2844,11 +2858,13 @@ require_relative "telnyx/models/whatsapp/whatsapp_template_carousel_component"
 require_relative "telnyx/models/whatsapp/whatsapp_template_footer_component"
 require_relative "telnyx/models/whatsapp/whatsapp_template_header_component"
 require_relative "telnyx/models/whatsapp/whatsapp_user_data"
+require_relative "telnyx/models/whatsapp_account_update"
 require_relative "telnyx/models/whatsapp_contact"
 require_relative "telnyx/models/whatsapp_interactive"
 require_relative "telnyx/models/whatsapp_location"
 require_relative "telnyx/models/whatsapp_media"
 require_relative "telnyx/models/whatsapp_message_content"
+require_relative "telnyx/models/whatsapp_message_echo"
 require_relative "telnyx/models/whatsapp_message_template_delete_params"
 require_relative "telnyx/models/whatsapp_message_template_retrieve_params"
 require_relative "telnyx/models/whatsapp_message_template_retrieve_response"
@@ -2899,6 +2915,10 @@ require_relative "telnyx/models/wireless_error"
 require_relative "telnyx/models/wireless_retrieve_regions_params"
 require_relative "telnyx/models/wireless_retrieve_regions_response"
 require_relative "telnyx/models/wireless_wireless_blocklist"
+require_relative "telnyx/models/x402/credit_account/payment_list_params"
+require_relative "telnyx/models/x402/credit_account/payment_retrieve_params"
+require_relative "telnyx/models/x402/credit_account/payment_retrieve_response"
+require_relative "telnyx/models/x402/credit_account/x402_transaction_record"
 require_relative "telnyx/models/x402/credit_account_create_quote_params"
 require_relative "telnyx/models/x402/credit_account_create_quote_response"
 require_relative "telnyx/models/x402/credit_account_settle_params"
@@ -2980,6 +3000,8 @@ require_relative "telnyx/resources/channel_zones"
 require_relative "telnyx/resources/charges_breakdown"
 require_relative "telnyx/resources/charges_summary"
 require_relative "telnyx/resources/comments"
+require_relative "telnyx/resources/compute"
+require_relative "telnyx/resources/compute/funcs"
 require_relative "telnyx/resources/conferences"
 require_relative "telnyx/resources/conferences/actions"
 require_relative "telnyx/resources/connections"
@@ -3293,5 +3315,6 @@ require_relative "telnyx/resources/wireless_blocklists"
 require_relative "telnyx/resources/wireless_blocklist_values"
 require_relative "telnyx/resources/x402"
 require_relative "telnyx/resources/x402/credit_account"
+require_relative "telnyx/resources/x402/credit_account/payments"
 
 require_relative "telnyx/lib"

data/rbi/telnyx/client.rbi

@@ -730,6 +730,9 @@ module Telnyx
     sig { returns(Telnyx::Resources::ExternalRequirements) }
     attr_reader :external_requirements
 
+    sig { returns(Telnyx::Resources::Compute) }
+    attr_reader :compute
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers

data/rbi/telnyx/models/ai/assistant_a2_a_agent.rbi

@@ -0,0 +1,345 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      class AssistantA2AAgent < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Telnyx::AI::AssistantA2AAgent, Telnyx::Internal::AnyHash)
+          end
+
+        # 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.
+        sig { returns(String) }
+        attr_accessor :name
+
+        # 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.
+        sig { returns(String) }
+        attr_accessor :url
+
+        # 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.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :async
+
+        sig { params(async: T::Boolean).void }
+        attr_writer :async
+
+        # Headers sent when fetching this agent's card and on every call made to it. Use
+        # them to authenticate to the agent.
+        sig do
+          returns(T.nilable(T::Array[Telnyx::AI::AssistantA2AAgent::Header]))
+        end
+        attr_reader :headers
+
+        sig do
+          params(
+            headers: T::Array[Telnyx::AI::AssistantA2AAgent::Header::OrHash]
+          ).void
+        end
+        attr_writer :headers
+
+        # 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`.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                T.any(
+                  Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage,
+                  Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage
+                )
+              ]
+            )
+          )
+        end
+        attr_reader :messages
+
+        sig do
+          params(
+            messages:
+              T::Array[
+                T.any(
+                  Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage::OrHash,
+                  Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage::OrHash
+                )
+              ]
+          ).void
+        end
+        attr_writer :messages
+
+        # How often, in milliseconds, to poll an agent task that has not finished yet.
+        # Defaults to 500.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :poll_interval_ms
+
+        sig { params(poll_interval_ms: Integer).void }
+        attr_writer :poll_interval_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.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :timeout_ms
+
+        sig { params(timeout_ms: Integer).void }
+        attr_writer :timeout_ms
+
+        # 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.
+        sig do
+          params(
+            name: String,
+            url: String,
+            async: T::Boolean,
+            headers: T::Array[Telnyx::AI::AssistantA2AAgent::Header::OrHash],
+            messages:
+              T::Array[
+                T.any(
+                  Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage::OrHash,
+                  Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage::OrHash
+                )
+              ],
+            poll_interval_ms: Integer,
+            timeout_ms: Integer
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # 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.
+          name:,
+          # 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.
+          url:,
+          # 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.
+          async: nil,
+          # Headers sent when fetching this agent's card and on every call made to it. Use
+          # them to authenticate to the agent.
+          headers: nil,
+          # 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`.
+          messages: nil,
+          # How often, in milliseconds, to poll an agent task that has not finished yet.
+          # Defaults to 500.
+          poll_interval_ms: nil,
+          # 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.
+          timeout_ms: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              name: String,
+              url: String,
+              async: T::Boolean,
+              headers: T::Array[Telnyx::AI::AssistantA2AAgent::Header],
+              messages:
+                T::Array[
+                  T.any(
+                    Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage,
+                    Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage
+                  )
+                ],
+              poll_interval_ms: Integer,
+              timeout_ms: Integer
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Header < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::AI::AssistantA2AAgent::Header,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # HTTP header name. May only contain alphanumeric characters, hyphens, and
+          # underscores, or a `{{dynamic_variable}}` placeholder surrounded by those
+          # characters.
+          sig { returns(String) }
+          attr_accessor :name
+
+          # 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.
+          sig { returns(String) }
+          attr_accessor :value
+
+          # A header sent when fetching an A2A agent's card and on every call made to that
+          # agent.
+          sig { params(name: String, value: String).returns(T.attached_class) }
+          def self.new(
+            # HTTP header name. May only contain alphanumeric characters, hyphens, and
+            # underscores, or a `{{dynamic_variable}}` placeholder surrounded by those
+            # characters.
+            name:,
+            # 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.
+            value:
+          )
+          end
+
+          sig { override.returns({ name: String, value: String }) }
+          def to_hash
+          end
+        end
+
+        module Message
+          extend Telnyx::Internal::Type::Union
+
+          Variants =
+            T.type_alias do
+              T.any(
+                Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage,
+                Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage
+              )
+            end
+
+          class A2AAgentRequestStartMessage < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestStartMessage,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # The text the assistant speaks.
+            sig { returns(String) }
+            attr_accessor :content
+
+            # Speak the filler message immediately when the call to the agent begins.
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            # An optional delay value. This value is ignored for `request_start` messages.
+            sig { returns(T.nilable(Integer)) }
+            attr_reader :timing_ms
+
+            sig { params(timing_ms: Integer).void }
+            attr_writer :timing_ms
+
+            sig do
+              params(content: String, timing_ms: Integer, type: Symbol).returns(
+                T.attached_class
+              )
+            end
+            def self.new(
+              # The text the assistant speaks.
+              content:,
+              # An optional delay value. This value is ignored for `request_start` messages.
+              timing_ms: nil,
+              # Speak the filler message immediately when the call to the agent begins.
+              type: :request_start
+            )
+            end
+
+            sig do
+              override.returns(
+                { content: String, type: Symbol, timing_ms: Integer }
+              )
+            end
+            def to_hash
+            end
+          end
+
+          class A2AAgentRequestResponseDelayedMessage < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::AssistantA2AAgent::Message::A2AAgentRequestResponseDelayedMessage,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # The text the assistant speaks.
+            sig { returns(String) }
+            attr_accessor :content
+
+            # How long to wait, in milliseconds, before speaking this message.
+            sig { returns(Integer) }
+            attr_accessor :timing_ms
+
+            # Speak the filler message only if the agent has not answered yet after
+            # `timing_ms`.
+            sig { returns(Symbol) }
+            attr_accessor :type
+
+            sig do
+              params(content: String, timing_ms: Integer, type: Symbol).returns(
+                T.attached_class
+              )
+            end
+            def self.new(
+              # The text the assistant speaks.
+              content:,
+              # How long to wait, in milliseconds, before speaking this message.
+              timing_ms:,
+              # Speak the filler message only if the agent has not answered yet after
+              # `timing_ms`.
+              type: :request_response_delayed
+            )
+            end
+
+            sig do
+              override.returns(
+                { content: String, timing_ms: Integer, type: Symbol }
+              )
+            end
+            def to_hash
+            end
+          end
+
+          sig do
+            override.returns(
+              T::Array[Telnyx::AI::AssistantA2AAgent::Message::Variants]
+            )
+          end
+          def self.variants
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/assistant_create_params.rbi

@@ -20,6 +20,24 @@ module Telnyx
         sig { returns(String) }
         attr_accessor :name
 
+        # 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.
+        sig { returns(T.nilable(T::Array[Telnyx::AI::AssistantA2AAgent])) }
+        attr_reader :a2a_agents
+
+        sig do
+          params(
+            a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash]
+          ).void
+        end
+        attr_writer :a2a_agents
+
         # Conversation flow as supplied by API clients (create / update).
         #
         # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
@@ -336,6 +354,7 @@ module Telnyx
           params(
             instructions: String,
             name: String,
+            a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash],
             conversation_flow: Telnyx::AI::ConversationFlowReq::OrHash,
             description: String,
             dynamic_variables: T::Hash[Symbol, T.anything],
@@ -390,6 +409,15 @@ module Telnyx
           # [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
           instructions:,
           name:,
+          # 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.
+          a2a_agents: nil,
           # Conversation flow as supplied by API clients (create / update).
           #
           # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
@@ -487,6 +515,7 @@ module Telnyx
             {
               instructions: String,
               name: String,
+              a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent],
               conversation_flow: Telnyx::AI::ConversationFlowReq,
               description: String,
               dynamic_variables: T::Hash[Symbol, T.anything],

data/rbi/telnyx/models/ai/assistant_update_params.rbi

@@ -15,6 +15,25 @@ module Telnyx
         sig { returns(String) }
         attr_accessor :assistant_id
 
+        # 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. Omit this field to
+        # leave the assistant's agents unchanged; send an empty array to remove them all.
+        sig { returns(T.nilable(T::Array[Telnyx::AI::AssistantA2AAgent])) }
+        attr_reader :a2a_agents
+
+        sig do
+          params(
+            a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash]
+          ).void
+        end
+        attr_writer :a2a_agents
+
         # Conversation flow as supplied by API clients (create / update).
         #
         # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
@@ -353,6 +372,7 @@ module Telnyx
         sig do
           params(
             assistant_id: String,
+            a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent::OrHash],
             conversation_flow: Telnyx::AI::ConversationFlowReq::OrHash,
             description: String,
             dynamic_variables: T::Hash[Symbol, T.anything],
@@ -407,6 +427,16 @@ module Telnyx
         end
         def self.new(
           assistant_id:,
+          # 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. Omit this field to
+          # leave the assistant's agents unchanged; send an empty array to remove them all.
+          a2a_agents: nil,
           # Conversation flow as supplied by API clients (create / update).
           #
           # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
@@ -511,6 +541,7 @@ module Telnyx
           override.returns(
             {
               assistant_id: String,
+              a2a_agents: T::Array[Telnyx::AI::AssistantA2AAgent],
               conversation_flow: Telnyx::AI::ConversationFlowReq,
               description: String,
               dynamic_variables: T::Hash[Symbol, T.anything],