telnyx 5.167.0 → 5.168.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f5a7b6ace13da0db2916ffb24b660a9962dfad65f5eb3819e213c8c597f209c
-  data.tar.gz: 644d79c57acf38c80b5999ae6dcf8f0af37f2388eb9dda400a46e278f55eb086
+  metadata.gz: 360829c3c2b34713bbae9a6a999389a66e6a7cd09004ba4a44c873472b407fe0
+  data.tar.gz: 6d3229995295c12147c3ebd8f8beb46d88fc855ab41098c89861316721ce1687
 SHA512:
-  metadata.gz: 8a68107acbe2ef210dd4c0805cb2942bf97b013779702c580caa0f09b5a39a571f723c83510ce42f8bc33fb22ab3b693a80076e7337554160c3183684ecbc642
-  data.tar.gz: 404495a79c4f5362bc70cd9377c5f1eb1580b5315612580c1251ffb8ff2e974111840d1134c9311bb39810e62bb66d6fd8ddfd7bf65d8a22906bbdf0c817946a
+  metadata.gz: 2c20e1e1b3c3c5776bf3c54b0d55eb4a37c26f2cb8bcb10a752fb2608f9c4ddad1c70bafbbc7364effec7693985dae05b44952e321226c66bacedd448ee7ccfe
+  data.tar.gz: 8812060e1369748da186af9db57e077df3eee3e04c9cc076f158ebe405e98a8442991a5ac2219d4a42687deed6ed110c5d4ff2e49657ba8606a6d9b5fc113565

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [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.168.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/client.rb

@@ -735,6 +735,9 @@ module Telnyx
     # @return [Telnyx::Resources::ExternalRequirements]
     attr_reader :external_requirements
 
+    # @return [Telnyx::Resources::Compute]
+    attr_reader :compute
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -1026,6 +1029,7 @@ 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)
     end
   end
 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).
         #
@@ -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]

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

@@ -13,6 +13,20 @@ module Telnyx
         #   @return [String]
         required :assistant_id, 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. Omit this field to
+        #   leave the assistant's agents unchanged; send an empty array to remove them all.
+        #
+        #   @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).
         #
@@ -229,12 +243,14 @@ module Telnyx
         #   @return [Telnyx::Models::AI::WidgetSettings, nil]
         optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-        # @!method initialize(assistant_id:, 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, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, promote_to_main: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, widget_settings: nil, request_options: {})
+        # @!method initialize(assistant_id:, 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, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, promote_to_main: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, widget_settings: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::AssistantUpdateParams} for more details.
         #
         #   @param assistant_id [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]

data/lib/telnyx/models/ai/assistants/update_assistant.rb

@@ -5,6 +5,20 @@ module Telnyx
     module AI
       module Assistants
         class UpdateAssistant < Telnyx::Internal::Type::BaseModel
+          # @!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. Omit this field to
+          #   leave the assistant's agents unchanged; send an empty array to remove them all.
+          #
+          #   @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).
           #
@@ -214,10 +228,12 @@ module Telnyx
           #   @return [Telnyx::Models::AI::WidgetSettings, nil]
           optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-          # @!method initialize(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, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, widget_settings: nil)
+          # @!method initialize(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, instructions: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, model: nil, name: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, tags: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, version_name: nil, voice_settings: nil, widget_settings: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::AI::Assistants::UpdateAssistant} for more details.
           #
+          #   @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]

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

@@ -48,25 +48,6 @@ module Telnyx
         #   @return [Float, nil]
         optional :frequency_penalty, Float
 
-        # @!attribute guided_choice
-        #   If specified, the output will be exactly one of the choices.
-        #
-        #   @return [Array<String>, nil]
-        optional :guided_choice, Telnyx::Internal::Type::ArrayOf[String]
-
-        # @!attribute guided_json
-        #   Must be a valid JSON schema. If specified, the output will follow the JSON
-        #   schema.
-        #
-        #   @return [Hash{Symbol=>Object}, nil]
-        optional :guided_json, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
-
-        # @!attribute guided_regex
-        #   If specified, the output will follow the regex pattern.
-        #
-        #   @return [String, nil]
-        optional :guided_regex, String
-
         # @!attribute length_penalty
         #   This is used with `use_beam_search` to prefer shorter or longer completions.
         #
@@ -144,11 +125,13 @@ module Telnyx
         optional :region, enum: -> { Telnyx::AI::ChatCompletionRequest::Region }
 
         # @!attribute response_format
-        #   Use this is you want to guarantee a JSON output without defining a schema. For
-        #   control over the schema, use `guided_json`.
+        #   Controls the format of the model output. `json_object` guarantees valid JSON
+        #   output without defining a schema; `json_schema` constrains the output to the
+        #   JSON schema you supply via the `json_schema` property and is the supported way
+        #   to get guaranteed structured output on Telnyx-hosted models.
         #
-        #   @return [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat, nil]
-        optional :response_format, -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat }
+        #   @return [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatText, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonObject, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam, nil]
+        optional :response_format, union: -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat }
 
         # @!attribute seed
         #   If specified, the system will make a best effort to sample deterministically,
@@ -225,7 +208,7 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :use_beam_search, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, mode: nil, model: nil, n: nil, presence_penalty: nil, reasoning_effort: nil, region: nil, response_format: nil, seed: nil, service_tier: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil)
+        # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, mode: nil, model: nil, n: nil, presence_penalty: nil, reasoning_effort: nil, region: nil, response_format: nil, seed: nil, service_tier: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ChatCompletionRequest} for more details.
         #
@@ -241,12 +224,6 @@ module Telnyx
         #
         #   @param frequency_penalty [Float] Higher values will penalize the model from repeating the same output tokens.
         #
-        #   @param guided_choice [Array<String>] If specified, the output will be exactly one of the choices.
-        #
-        #   @param guided_json [Hash{Symbol=>Object}] Must be a valid JSON schema. If specified, the output will follow the JSON schem
-        #
-        #   @param guided_regex [String] If specified, the output will follow the regex pattern.
-        #
         #   @param length_penalty [Float] This is used with `use_beam_search` to prefer shorter or longer completions.
         #
         #   @param logprobs [Boolean] Whether to return log probabilities of the output tokens or not. If true, return
@@ -267,7 +244,7 @@ module Telnyx
         #
         #   @param region [Symbol, Telnyx::Models::AI::ChatCompletionRequest::Region] Optional data-residency region the request should be served from, using the same
         #
-        #   @param response_format [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat] Use this is you want to guarantee a JSON output without defining a schema. For c
+        #   @param response_format [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatText, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonObject, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam] Controls the format of the model output. `json_object` guarantees valid JSON out
         #
         #   @param seed [Integer] If specified, the system will make a best effort to sample deterministically, su
         #
@@ -427,29 +404,129 @@ module Telnyx
           #   @return [Array<Symbol>]
         end
 
+        # Controls the format of the model output. `json_object` guarantees valid JSON
+        # output without defining a schema; `json_schema` constrains the output to the
+        # JSON schema you supply via the `json_schema` property and is the supported way
+        # to get guaranteed structured output on Telnyx-hosted models.
+        #
         # @see Telnyx::Models::AI::ChatCompletionRequest#response_format
-        class ResponseFormat < Telnyx::Internal::Type::BaseModel
-          # @!attribute type
-          #
-          #   @return [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::Type]
-          required :type, enum: -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat::Type }
+        module ResponseFormat
+          extend Telnyx::Internal::Type::Union
 
-          # @!method initialize(type:)
-          #   Use this is you want to guarantee a JSON output without defining a schema. For
-          #   control over the schema, use `guided_json`.
-          #
-          #   @param type [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::Type]
+          # Plain text output.
+          variant -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatText }
 
-          # @see Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat#type
-          module Type
-            extend Telnyx::Internal::Type::Enum
+          # JSON mode: the model output is valid JSON, without a schema.
+          variant -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonObject }
 
-            TEXT = :text
-            JSON_OBJECT = :json_object
+          # Structured output: the model output is constrained to the JSON schema supplied in `json_schema`.
+          variant -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam }
 
-            # @!method self.values
-            #   @return [Array<Symbol>]
+          class ResponseFormatText < Telnyx::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :text]
+            required :type, const: :text
+
+            # @!method initialize(type: :text)
+            #   Plain text output.
+            #
+            #   @param type [Symbol, :text]
           end
+
+          class ResponseFormatJsonObject < Telnyx::Internal::Type::BaseModel
+            # @!attribute type
+            #
+            #   @return [Symbol, :json_object]
+            required :type, const: :json_object
+
+            # @!method initialize(type: :json_object)
+            #   JSON mode: the model output is valid JSON, without a schema.
+            #
+            #   @param type [Symbol, :json_object]
+          end
+
+          class ResponseFormatJsonSchemaParam < Telnyx::Internal::Type::BaseModel
+            # @!attribute json_schema
+            #   The JSON schema configuration, required when `type` is `json_schema`. Matches
+            #   the
+            #   [OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs)
+            #   `json_schema` response format.
+            #
+            #   @return [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam::JsonSchema]
+            required :json_schema,
+                     -> { Telnyx::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam::JsonSchema }
+
+            # @!attribute type
+            #
+            #   @return [Symbol, :json_schema]
+            required :type, const: :json_schema
+
+            # @!method initialize(json_schema:, type: :json_schema)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam}
+            #   for more details.
+            #
+            #   Structured output: the model output is constrained to the JSON schema supplied
+            #   in `json_schema`.
+            #
+            #   @param json_schema [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam::JsonSchema] The JSON schema configuration, required when `type` is `json_schema`. Matches th
+            #
+            #   @param type [Symbol, :json_schema]
+
+            # @see Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam#json_schema
+            class JsonSchema < Telnyx::Internal::Type::BaseModel
+              # @!attribute name
+              #   The name of the response format. Used for clarity only.
+              #
+              #   @return [String]
+              required :name, String
+
+              # @!attribute description
+              #   A description of what the response format is for, typically used to guide the
+              #   model.
+              #
+              #   @return [String, nil]
+              optional :description, String
+
+              # @!attribute schema
+              #   The JSON schema the model output must conform to. A valid
+              #   [JSON Schema](https://json-schema.org) object, e.g. a Pydantic
+              #   `model_json_schema()` export.
+              #
+              #   @return [Hash{Symbol=>Object}, nil]
+              optional :schema, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+              # @!attribute strict
+              #   Enables strict schema adherence when supported by the model. If the generated
+              #   output does not match the provided schema, the request fails instead of
+              #   returning non-conformant output.
+              #
+              #   @return [Boolean, nil]
+              optional :strict, Telnyx::Internal::Type::Boolean
+
+              # @!method initialize(name:, description: nil, schema: nil, strict: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam::JsonSchema}
+              #   for more details.
+              #
+              #   The JSON schema configuration, required when `type` is `json_schema`. Matches
+              #   the
+              #   [OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs)
+              #   `json_schema` response format.
+              #
+              #   @param name [String] The name of the response format. Used for clarity only.
+              #
+              #   @param description [String] A description of what the response format is for, typically used to guide the mo
+              #
+              #   @param schema [Hash{Symbol=>Object}] The JSON schema the model output must conform to. A valid [JSON Schema](https://
+              #
+              #   @param strict [Boolean] Enables strict schema adherence when supported by the model. If the generated ou
+            end
+          end
+
+          # @!method self.variants
+          #   @return [Array(Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatText, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonObject, Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat::ResponseFormatJsonSchemaParam)]
         end
 
         # Up to 4 sequences where the API will stop generating further tokens. The

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

@@ -37,6 +37,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 returned by the API.
         #
@@ -237,7 +250,7 @@ module Telnyx
         #   @return [Telnyx::Models::AI::WidgetSettings, nil]
         optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-        # @!method initialize(id:, created_at:, instructions:, model:, 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, import_metadata: nil, insight_settings: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, related_mission_ids: nil, tags: nil, telephony_settings: nil, tools: nil, transcription: nil, version_created_at: nil, version_id: nil, version_name: nil, voice_settings: nil, widget_settings: nil)
+        # @!method initialize(id:, created_at:, instructions:, model:, 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, import_metadata: nil, insight_settings: nil, integrations: nil, interruption_settings: nil, llm_api_key_ref: nil, mcp_servers: nil, messaging_settings: nil, observability_settings: nil, post_conversation_settings: nil, privacy_settings: nil, related_mission_ids: nil, tags: nil, telephony_settings: nil, tools: nil, transcription: nil, version_created_at: nil, version_id: nil, version_name: nil, voice_settings: nil, widget_settings: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::InferenceEmbedding} for more details.
         #
@@ -251,6 +264,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::ConversationFlow] Conversation flow as returned by the API.
         #
         #   @param description [String]