telnyx 5.70.0 → 5.71.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ac9a07c8a853ece2ee38dc9271bc8aede4cdc909f634b11f547d24a01906726
-  data.tar.gz: 6ad873c682fd93b981dbca7a48f83bef3c1b43e29a6722c2e72bf46f6b20b79a
+  metadata.gz: 55892760f556bee9521d8c638235b5dce702cea3c1766f230318952e9db8f8ab
+  data.tar.gz: bfa439dd1d25de410cd87030b3a86f119b068e922ed4f74821c6028fc9beb3bf
 SHA512:
-  metadata.gz: 7cd372e02874a4654b037003c200e382104128701fb6e521882853e81a7671d6faa00e51e8dc28f9d58f69a38a2edcbcb1c473642e1ddcf979d6cf9718aaf3c9
-  data.tar.gz: 71b0c0af94329048ed0920882d23d0cd41c8e5d231e7004de41196dc05f08c1231ce8ec3a4e6f8f4f4cae7a223a5c93a756acd68bcc4ea406844ac62b7c41f82
+  metadata.gz: ed548d98590649ba4b7e628a4f2955f1a40c6ba9e78b6268d396a7ed400e6e6870c39951bdb70fdd21f0ab10187767a752b59fba7e493539c37fd26d996a438b
+  data.tar.gz: d8ae515be892c263d2a85a0ee1b60531aca724fe39973e5b148c32bfa6cb5c58ce37a7bf3ae5d92d41f146c4cdc5bd887970cf9df3dd246ce8d17a9b89c20da9

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 5.71.0 (2026-04-11)
+
+Full Changelog: [v5.70.0...v5.71.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.70.0...v5.71.0)
+
+### Features
+
+* add shared CallAssistantRequest schema for call-control assistant object ([67a2157](https://github.com/team-telnyx/telnyx-ruby/commit/67a2157455d5a6e5138f89e54479977f108605a7))
+* **api:** manual updates ([0000b53](https://github.com/team-telnyx/telnyx-ruby/commit/0000b5378d0f1dfeb46f1b5670933819fa935d5a))
+* **api:** Merge pull request [#46](https://github.com/team-telnyx/telnyx-ruby/issues/46) from stainless-sdks/FixModelRecommendation ([4b3ea59](https://github.com/team-telnyx/telnyx-ruby/commit/4b3ea599a86f9279f139cbb7868da79079685846))
+* MSG-6846: add GET /profile/photo docs for whatsapp API ([d06a131](https://github.com/team-telnyx/telnyx-ruby/commit/d06a131d943549a7a744a3968e116480d986fc8e))
+
+
+### Bug Fixes
+
+* correct Provider constant reference in VoiceCloneCreateFromDesignParams RBI/RBS ([6c66dd2](https://github.com/team-telnyx/telnyx-ruby/commit/6c66dd2ebf03c26eeeadadb0a93f5828134d0492))
+
+
+### Reverts
+
+* restore stainless.yml to pre-6a6df5b state ([d7e3266](https://github.com/team-telnyx/telnyx-ruby/commit/d7e3266c5593d4163184b2cdcff260aa281843d7))
+
+
+### Documentation
+
+* improve examples ([ecc0d15](https://github.com/team-telnyx/telnyx-ruby/commit/ecc0d1599570e1bbeb73c2db47b05a3a9c0e7a00))
+
 ## 5.70.0 (2026-04-08)
 
 Full Changelog: [v5.69.0...v5.70.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.69.0...v5.70.0)

data/README.md

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

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

@@ -29,7 +29,7 @@ module Telnyx
         # @!attribute tools
         #   The tools that the voice assistant can use.
         #
-        #   @return [Array<Telnyx::Models::AI::Assistant::Tool::BookAppointment, Telnyx::Models::AI::Assistant::Tool::CheckAvailability, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::AI::Assistant::Tool::Retrieval>, nil]
+        #   @return [Array<Telnyx::Models::BookAppointmentTool, Telnyx::Models::CheckAvailabilityTool, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::CallControlRetrievalTool>, nil]
         optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::Assistant::Tool] }
 
         # @!method initialize(instructions: nil, model: nil, openai_api_key_ref: nil, tools: nil)
@@ -44,16 +44,16 @@ module Telnyx
         #
         #   @param openai_api_key_ref [String] This is necessary only if the model selected is from OpenAI. You would pass the
         #
-        #   @param tools [Array<Telnyx::Models::AI::Assistant::Tool::BookAppointment, Telnyx::Models::AI::Assistant::Tool::CheckAvailability, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::AI::Assistant::Tool::Retrieval>] The tools that the voice assistant can use.
+        #   @param tools [Array<Telnyx::Models::BookAppointmentTool, Telnyx::Models::CheckAvailabilityTool, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::CallControlRetrievalTool>] The tools that the voice assistant can use.
 
         module Tool
           extend Telnyx::Internal::Type::Union
 
           discriminator :type
 
-          variant :book_appointment, -> { Telnyx::AI::Assistant::Tool::BookAppointment }
+          variant :book_appointment, -> { Telnyx::BookAppointmentTool }
 
-          variant :check_availability, -> { Telnyx::AI::Assistant::Tool::CheckAvailability }
+          variant :check_availability, -> { Telnyx::CheckAvailabilityTool }
 
           variant :webhook, -> { Telnyx::AI::WebhookTool }
 
@@ -61,153 +61,10 @@ module Telnyx
 
           variant :transfer, -> { Telnyx::AI::TransferTool }
 
-          variant :retrieval, -> { Telnyx::AI::Assistant::Tool::Retrieval }
-
-          class BookAppointment < Telnyx::Internal::Type::BaseModel
-            # @!attribute book_appointment
-            #
-            #   @return [Telnyx::Models::AI::Assistant::Tool::BookAppointment::BookAppointment]
-            required :book_appointment, -> { Telnyx::AI::Assistant::Tool::BookAppointment::BookAppointment }
-
-            # @!attribute type
-            #
-            #   @return [Symbol, :book_appointment]
-            required :type, const: :book_appointment
-
-            # @!method initialize(book_appointment:, type: :book_appointment)
-            #   @param book_appointment [Telnyx::Models::AI::Assistant::Tool::BookAppointment::BookAppointment]
-            #   @param type [Symbol, :book_appointment]
-
-            # @see Telnyx::Models::AI::Assistant::Tool::BookAppointment#book_appointment
-            class BookAppointment < Telnyx::Internal::Type::BaseModel
-              # @!attribute api_key_ref
-              #   Reference to an integration secret that contains your Cal.com API key. You would
-              #   pass the `identifier` for an integration secret
-              #   [/v2/integration_secrets](https://developers.telnyx.com/api/secrets-manager/integration-secrets/create-integration-secret)
-              #   that refers to your Cal.com API key.
-              #
-              #   @return [String]
-              required :api_key_ref, String
-
-              # @!attribute event_type_id
-              #   Event Type ID for which slots are being fetched.
-              #   [cal.com](https://cal.com/docs/api-reference/v2/bookings/create-a-booking#body-event-type-id)
-              #
-              #   @return [Integer]
-              required :event_type_id, Integer
-
-              # @!attribute attendee_name
-              #   The name of the attendee
-              #   [cal.com](https://cal.com/docs/api-reference/v2/bookings/create-a-booking#body-attendee-name).
-              #   If not provided, the assistant will ask for the attendee's name.
-              #
-              #   @return [String, nil]
-              optional :attendee_name, String
-
-              # @!attribute attendee_timezone
-              #   The timezone of the attendee
-              #   [cal.com](https://cal.com/docs/api-reference/v2/bookings/create-a-booking#body-attendee-timezone).
-              #   If not provided, the assistant will ask for the attendee's timezone.
-              #
-              #   @return [String, nil]
-              optional :attendee_timezone, String
-
-              # @!method initialize(api_key_ref:, event_type_id:, attendee_name: nil, attendee_timezone: nil)
-              #   Some parameter documentations has been truncated, see
-              #   {Telnyx::Models::AI::Assistant::Tool::BookAppointment::BookAppointment} for more
-              #   details.
-              #
-              #   @param api_key_ref [String] Reference to an integration secret that contains your Cal.com API key. You would
-              #
-              #   @param event_type_id [Integer] Event Type ID for which slots are being fetched. [cal.com](https://cal.com/docs/
-              #
-              #   @param attendee_name [String] The name of the attendee [cal.com](https://cal.com/docs/api-reference/v2/booking
-              #
-              #   @param attendee_timezone [String] The timezone of the attendee [cal.com](https://cal.com/docs/api-reference/v2/boo
-            end
-          end
-
-          class CheckAvailability < Telnyx::Internal::Type::BaseModel
-            # @!attribute check_availability
-            #
-            #   @return [Telnyx::Models::AI::Assistant::Tool::CheckAvailability::CheckAvailability]
-            required :check_availability, -> { Telnyx::AI::Assistant::Tool::CheckAvailability::CheckAvailability }
-
-            # @!attribute type
-            #
-            #   @return [Symbol, :check_availability]
-            required :type, const: :check_availability
-
-            # @!method initialize(check_availability:, type: :check_availability)
-            #   @param check_availability [Telnyx::Models::AI::Assistant::Tool::CheckAvailability::CheckAvailability]
-            #   @param type [Symbol, :check_availability]
-
-            # @see Telnyx::Models::AI::Assistant::Tool::CheckAvailability#check_availability
-            class CheckAvailability < Telnyx::Internal::Type::BaseModel
-              # @!attribute api_key_ref
-              #   Reference to an integration secret that contains your Cal.com API key. You would
-              #   pass the `identifier` for an integration secret
-              #   [/v2/integration_secrets](https://developers.telnyx.com/api/secrets-manager/integration-secrets/create-integration-secret)
-              #   that refers to your Cal.com API key.
-              #
-              #   @return [String]
-              required :api_key_ref, String
-
-              # @!attribute event_type_id
-              #   Event Type ID for which slots are being fetched.
-              #   [cal.com](https://cal.com/docs/api-reference/v2/slots/get-available-slots#parameter-event-type-id)
-              #
-              #   @return [Integer]
-              required :event_type_id, Integer
-
-              # @!method initialize(api_key_ref:, event_type_id:)
-              #   Some parameter documentations has been truncated, see
-              #   {Telnyx::Models::AI::Assistant::Tool::CheckAvailability::CheckAvailability} for
-              #   more details.
-              #
-              #   @param api_key_ref [String] Reference to an integration secret that contains your Cal.com API key. You would
-              #
-              #   @param event_type_id [Integer] Event Type ID for which slots are being fetched. [cal.com](https://cal.com/docs/
-            end
-          end
-
-          class Retrieval < Telnyx::Internal::Type::BaseModel
-            # @!attribute retrieval
-            #
-            #   @return [Telnyx::Models::AI::Assistant::Tool::Retrieval::Retrieval]
-            required :retrieval, -> { Telnyx::AI::Assistant::Tool::Retrieval::Retrieval }
-
-            # @!attribute type
-            #
-            #   @return [Symbol, :retrieval]
-            required :type, const: :retrieval
-
-            # @!method initialize(retrieval:, type: :retrieval)
-            #   @param retrieval [Telnyx::Models::AI::Assistant::Tool::Retrieval::Retrieval]
-            #   @param type [Symbol, :retrieval]
-
-            # @see Telnyx::Models::AI::Assistant::Tool::Retrieval#retrieval
-            class Retrieval < Telnyx::Internal::Type::BaseModel
-              # @!attribute bucket_ids
-              #
-              #   @return [Array<String>]
-              required :bucket_ids, Telnyx::Internal::Type::ArrayOf[String]
-
-              # @!attribute max_num_results
-              #   The maximum number of results to retrieve as context for the language model.
-              #
-              #   @return [Integer, nil]
-              optional :max_num_results, Integer
-
-              # @!method initialize(bucket_ids:, max_num_results: nil)
-              #   @param bucket_ids [Array<String>]
-              #
-              #   @param max_num_results [Integer] The maximum number of results to retrieve as context for the language model.
-            end
-          end
+          variant :retrieval, -> { Telnyx::CallControlRetrievalTool }
 
           # @!method self.variants
-          #   @return [Array(Telnyx::Models::AI::Assistant::Tool::BookAppointment, Telnyx::Models::AI::Assistant::Tool::CheckAvailability, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::AI::Assistant::Tool::Retrieval)]
+          #   @return [Array(Telnyx::Models::BookAppointmentTool, Telnyx::Models::CheckAvailabilityTool, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::CallControlRetrievalTool)]
         end
       end
     end

data/lib/telnyx/models/book_appointment_tool.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class BookAppointmentTool < Telnyx::Internal::Type::BaseModel
+      # @!attribute book_appointment
+      #
+      #   @return [Telnyx::Models::BookAppointmentToolParams]
+      required :book_appointment, -> { Telnyx::BookAppointmentToolParams }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Telnyx::Models::BookAppointmentTool::Type]
+      required :type, enum: -> { Telnyx::BookAppointmentTool::Type }
+
+      # @!method initialize(book_appointment:, type:)
+      #   @param book_appointment [Telnyx::Models::BookAppointmentToolParams]
+      #   @param type [Symbol, Telnyx::Models::BookAppointmentTool::Type]
+
+      # @see Telnyx::Models::BookAppointmentTool#type
+      module Type
+        extend Telnyx::Internal::Type::Enum
+
+        BOOK_APPOINTMENT = :book_appointment
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/book_appointment_tool_params.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class BookAppointmentToolParams < Telnyx::Internal::Type::BaseModel
+      # @!attribute api_key_ref
+      #   Reference to an integration secret that contains your Cal.com API key. You would
+      #   pass the `identifier` for an integration secret
+      #   [/v2/integration_secrets](https://developers.telnyx.com/api/secrets-manager/integration-secrets/create-integration-secret)
+      #   that refers to your Cal.com API key.
+      #
+      #   @return [String]
+      required :api_key_ref, String
+
+      # @!attribute event_type_id
+      #   Event Type ID for which slots are being fetched.
+      #   [cal.com](https://cal.com/docs/api-reference/v2/bookings/create-a-booking#body-event-type-id)
+      #
+      #   @return [Integer]
+      required :event_type_id, Integer
+
+      # @!attribute attendee_name
+      #   The name of the attendee
+      #   [cal.com](https://cal.com/docs/api-reference/v2/bookings/create-a-booking#body-attendee-name).
+      #   If not provided, the assistant will ask for the attendee's name.
+      #
+      #   @return [String, nil]
+      optional :attendee_name, String
+
+      # @!attribute attendee_timezone
+      #   The timezone of the attendee
+      #   [cal.com](https://cal.com/docs/api-reference/v2/bookings/create-a-booking#body-attendee-timezone).
+      #   If not provided, the assistant will ask for the attendee's timezone.
+      #
+      #   @return [String, nil]
+      optional :attendee_timezone, String
+
+      # @!method initialize(api_key_ref:, event_type_id:, attendee_name: nil, attendee_timezone: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::BookAppointmentToolParams} for more details.
+      #
+      #   @param api_key_ref [String] Reference to an integration secret that contains your Cal.com API key. You would
+      #
+      #   @param event_type_id [Integer] Event Type ID for which slots are being fetched. [cal.com](https://cal.com/docs/
+      #
+      #   @param attendee_name [String] The name of the attendee [cal.com](https://cal.com/docs/api-reference/v2/booking
+      #
+      #   @param attendee_timezone [String] The timezone of the attendee [cal.com](https://cal.com/docs/api-reference/v2/boo
+    end
+  end
+end

data/lib/telnyx/models/call_assistant_request.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class CallAssistantRequest < Telnyx::Internal::Type::BaseModel
+      # @!attribute id
+      #   The identifier of the AI assistant to use.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute dynamic_variables
+      #   Map of dynamic variables and their default values. Dynamic variables can be
+      #   referenced in instructions, greeting, and tool definitions using the
+      #   `{{variable_name}}` syntax. Call-control-agent automatically merges in
+      #   `telnyx_call_*` variables (telnyx_call_to, telnyx_call_from,
+      #   telnyx_conversation_channel, telnyx_agent_target, telnyx_end_user_target,
+      #   telnyx_call_caller_id_name) and custom header variables.
+      #
+      #   @return [Hash{Symbol=>String, Float, Boolean}, nil]
+      optional :dynamic_variables,
+               -> { Telnyx::Internal::Type::HashOf[union: Telnyx::CallAssistantRequest::DynamicVariable] }
+
+      # @!attribute external_llm
+      #   External LLM configuration for bringing your own LLM endpoint.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :external_llm, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+      # @!attribute fallback_config
+      #   Fallback LLM configuration used when the primary LLM provider is unavailable.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :fallback_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+      # @!attribute greeting
+      #   Initial greeting text spoken when the assistant starts. Can be plain text for
+      #   any voice or SSML for `AWS.Polly.<voice_id>` voices. There is a 3,000 character
+      #   limit.
+      #
+      #   @return [String, nil]
+      optional :greeting, String
+
+      # @!attribute instructions
+      #   System instructions for the voice assistant. Can be templated with
+      #   [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables).
+      #   This will overwrite the instructions set in the assistant configuration.
+      #
+      #   @return [String, nil]
+      optional :instructions, String
+
+      # @!attribute llm_api_key_ref
+      #   Integration secret identifier for the LLM provider API key. Use this field to
+      #   reference an
+      #   [integration secret](https://developers.telnyx.com/api/secrets-manager/integration-secrets/create-integration-secret)
+      #   containing your LLM provider API key. Supports any LLM provider (OpenAI,
+      #   Anthropic, etc.).
+      #
+      #   @return [String, nil]
+      optional :llm_api_key_ref, String
+
+      # @!attribute mcp_servers
+      #   MCP (Model Context Protocol) server configurations for extending the assistant's
+      #   capabilities with external tools and data sources.
+      #
+      #   @return [Array<Hash{Symbol=>Object}>, nil]
+      optional :mcp_servers,
+               Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]]
+
+      # @!attribute model
+      #   LLM model override for this call. If omitted, the assistant's configured model
+      #   is used.
+      #
+      #   @return [String, nil]
+      optional :model, String
+
+      # @!attribute name
+      #   Assistant name override for this call.
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!attribute observability_settings
+      #   Observability configuration for the assistant session, including Langfuse
+      #   integration for tracing and monitoring.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :observability_settings, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+      # @!attribute openai_api_key_ref
+      #   @deprecated This field is deprecated and will be removed soon
+      #
+      #   Deprecated — use `llm_api_key_ref` instead. Integration secret identifier for
+      #   the OpenAI API key. This field is maintained for backward compatibility;
+      #   `llm_api_key_ref` is the canonical field name and supports all LLM providers.
+      #
+      #   @return [String, nil]
+      optional :openai_api_key_ref, String
+
+      # @!attribute tools
+      #   Inline tool definitions available to the assistant (webhook, retrieval,
+      #   transfer, hangup, etc.). Overrides the assistant's stored tools if provided.
+      #
+      #   @return [Array<Telnyx::Models::BookAppointmentTool, Telnyx::Models::CheckAvailabilityTool, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::CallControlRetrievalTool>, nil]
+      optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::CallAssistantRequest::Tool] }
+
+      # @!method initialize(id:, dynamic_variables: nil, external_llm: nil, fallback_config: nil, greeting: nil, instructions: nil, llm_api_key_ref: nil, mcp_servers: nil, model: nil, name: nil, observability_settings: nil, openai_api_key_ref: nil, tools: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::CallAssistantRequest} for more details.
+      #
+      #   AI Assistant configuration. All fields except `id` are optional — the
+      #   assistant's stored configuration will be used as fallback for any omitted
+      #   fields.
+      #
+      #   @param id [String] The identifier of the AI assistant to use.
+      #
+      #   @param dynamic_variables [Hash{Symbol=>String, Float, Boolean}] Map of dynamic variables and their default values. Dynamic variables can be refe
+      #
+      #   @param external_llm [Hash{Symbol=>Object}] External LLM configuration for bringing your own LLM endpoint.
+      #
+      #   @param fallback_config [Hash{Symbol=>Object}] Fallback LLM configuration used when the primary LLM provider is unavailable.
+      #
+      #   @param greeting [String] Initial greeting text spoken when the assistant starts. Can be plain text for an
+      #
+      #   @param instructions [String] System instructions for the voice assistant. Can be templated with [dynamic vari
+      #
+      #   @param llm_api_key_ref [String] Integration secret identifier for the LLM provider API key. Use this field to re
+      #
+      #   @param mcp_servers [Array<Hash{Symbol=>Object}>] MCP (Model Context Protocol) server configurations for extending the assistant's
+      #
+      #   @param model [String] LLM model override for this call. If omitted, the assistant's configured model i
+      #
+      #   @param name [String] Assistant name override for this call.
+      #
+      #   @param observability_settings [Hash{Symbol=>Object}] Observability configuration for the assistant session, including Langfuse integr
+      #
+      #   @param openai_api_key_ref [String] Deprecated — use `llm_api_key_ref` instead. Integration secret identifier for th
+      #
+      #   @param tools [Array<Telnyx::Models::BookAppointmentTool, Telnyx::Models::CheckAvailabilityTool, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::CallControlRetrievalTool>] Inline tool definitions available to the assistant (webhook, retrieval, transfer
+
+      module DynamicVariable
+        extend Telnyx::Internal::Type::Union
+
+        variant String
+
+        variant Float
+
+        variant Telnyx::Internal::Type::Boolean
+
+        # @!method self.variants
+        #   @return [Array(String, Float, Boolean)]
+      end
+
+      module Tool
+        extend Telnyx::Internal::Type::Union
+
+        discriminator :type
+
+        variant :book_appointment, -> { Telnyx::BookAppointmentTool }
+
+        variant :check_availability, -> { Telnyx::CheckAvailabilityTool }
+
+        variant :webhook, -> { Telnyx::AI::WebhookTool }
+
+        variant :hangup, -> { Telnyx::AI::HangupTool }
+
+        variant :transfer, -> { Telnyx::AI::TransferTool }
+
+        variant :retrieval, -> { Telnyx::CallControlRetrievalTool }
+
+        # @!method self.variants
+        #   @return [Array(Telnyx::Models::BookAppointmentTool, Telnyx::Models::CheckAvailabilityTool, Telnyx::Models::AI::WebhookTool, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::TransferTool, Telnyx::Models::CallControlRetrievalTool)]
+      end
+    end
+  end
+end

data/lib/telnyx/models/call_control_bucket_ids.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class CallControlBucketIDs < Telnyx::Internal::Type::BaseModel
+      # @!attribute bucket_ids
+      #
+      #   @return [Array<String>]
+      required :bucket_ids, Telnyx::Internal::Type::ArrayOf[String]
+
+      # @!attribute max_num_results
+      #   The maximum number of results to retrieve as context for the language model.
+      #
+      #   @return [Integer, nil]
+      optional :max_num_results, Integer
+
+      # @!method initialize(bucket_ids:, max_num_results: nil)
+      #   @param bucket_ids [Array<String>]
+      #
+      #   @param max_num_results [Integer] The maximum number of results to retrieve as context for the language model.
+    end
+  end
+end

data/lib/telnyx/models/call_control_retrieval_tool.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class CallControlRetrievalTool < Telnyx::Internal::Type::BaseModel
+      # @!attribute retrieval
+      #
+      #   @return [Telnyx::Models::CallControlBucketIDs]
+      required :retrieval, -> { Telnyx::CallControlBucketIDs }
+
+      # @!attribute type
+      #
+      #   @return [Symbol, Telnyx::Models::CallControlRetrievalTool::Type]
+      required :type, enum: -> { Telnyx::CallControlRetrievalTool::Type }
+
+      # @!method initialize(retrieval:, type:)
+      #   @param retrieval [Telnyx::Models::CallControlBucketIDs]
+      #   @param type [Symbol, Telnyx::Models::CallControlRetrievalTool::Type]
+
+      # @see Telnyx::Models::CallControlRetrievalTool#type
+      module Type
+        extend Telnyx::Internal::Type::Enum
+
+        RETRIEVAL = :retrieval
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/call_dial_params.rb

@@ -58,6 +58,14 @@ module Telnyx
       optional :answering_machine_detection_config,
                -> { Telnyx::CallDialParams::AnsweringMachineDetectionConfig }
 
+      # @!attribute assistant
+      #   AI Assistant configuration. All fields except `id` are optional — the
+      #   assistant's stored configuration will be used as fallback for any omitted
+      #   fields.
+      #
+      #   @return [Telnyx::Models::CallAssistantRequest, nil]
+      optional :assistant, -> { Telnyx::CallAssistantRequest }
+
       # @!attribute audio_url
       #   The URL of a file to be played back to the callee when the call is answered. The
       #   URL can point to either a WAV or MP3 file. media_name and audio_url cannot be
@@ -407,7 +415,7 @@ module Telnyx
       #   @return [Symbol, Telnyx::Models::CallDialParams::WebhookURLMethod, nil]
       optional :webhook_url_method, enum: -> { Telnyx::CallDialParams::WebhookURLMethod }
 
-      # @!method initialize(connection_id:, from:, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, audio_url: nil, billing_group_id: nil, bridge_intent: nil, bridge_on_answer: nil, client_state: nil, command_id: nil, conference_config: nil, custom_headers: nil, dialogflow_config: nil, enable_dialogflow: nil, from_display_name: nil, link_to: nil, media_encryption: nil, media_name: nil, park_after_unbridge: nil, preferred_codecs: nil, prevent_double_bridge: nil, privacy: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, send_silence_when_idle: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, stream_auth_token: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_sampling_rate: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_establish_before_call_originate: nil, stream_track: nil, stream_url: nil, supervise_call_control_id: nil, supervisor_role: nil, time_limit_secs: nil, timeout_secs: nil, transcription: nil, transcription_config: nil, webhook_url: nil, webhook_url_method: nil, request_options: {})
+      # @!method initialize(connection_id:, from:, to:, answering_machine_detection: nil, answering_machine_detection_config: nil, assistant: nil, audio_url: nil, billing_group_id: nil, bridge_intent: nil, bridge_on_answer: nil, client_state: nil, command_id: nil, conference_config: nil, custom_headers: nil, dialogflow_config: nil, enable_dialogflow: nil, from_display_name: nil, link_to: nil, media_encryption: nil, media_name: nil, park_after_unbridge: nil, preferred_codecs: nil, prevent_double_bridge: nil, privacy: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, send_silence_when_idle: nil, sip_auth_password: nil, sip_auth_username: nil, sip_headers: nil, sip_region: nil, sip_transport_protocol: nil, sound_modifications: nil, stream_auth_token: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_sampling_rate: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_establish_before_call_originate: nil, stream_track: nil, stream_url: nil, supervise_call_control_id: nil, supervisor_role: nil, time_limit_secs: nil, timeout_secs: nil, transcription: nil, transcription_config: nil, webhook_url: nil, webhook_url_method: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::CallDialParams} for more details.
       #
@@ -421,6 +429,8 @@ module Telnyx
       #
       #   @param answering_machine_detection_config [Telnyx::Models::CallDialParams::AnsweringMachineDetectionConfig] Optional configuration parameters to modify 'answering_machine_detection' perfor
       #
+      #   @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration. All fields except `id` are optional — the assistant'
+      #
       #   @param audio_url [String] The URL of a file to be played back to the callee when the call is answered. The
       #
       #   @param billing_group_id [String] Use this field to set the Billing Group ID for the call. Must be a valid and exi

data/lib/telnyx/models/calls/action_answer_params.rb

@@ -13,6 +13,14 @@ module Telnyx
         #   @return [String]
         required :call_control_id, String
 
+        # @!attribute assistant
+        #   AI Assistant configuration. All fields except `id` are optional — the
+        #   assistant's stored configuration will be used as fallback for any omitted
+        #   fields.
+        #
+        #   @return [Telnyx::Models::CallAssistantRequest, nil]
+        optional :assistant, -> { Telnyx::CallAssistantRequest }
+
         # @!attribute billing_group_id
         #   Use this field to set the Billing Group ID for the call. Must be a valid and
         #   existing Billing Group ID.
@@ -210,12 +218,14 @@ module Telnyx
         #   @return [Symbol, Telnyx::Models::Calls::ActionAnswerParams::WebhookURLsMethod, nil]
         optional :webhook_urls_method, enum: -> { Telnyx::Calls::ActionAnswerParams::WebhookURLsMethod }
 
-        # @!method initialize(call_control_id:, billing_group_id: nil, client_state: nil, command_id: nil, custom_headers: nil, preferred_codecs: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, send_silence_when_idle: nil, sip_headers: nil, sound_modifications: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_track: nil, stream_url: nil, transcription: nil, transcription_config: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
+        # @!method initialize(call_control_id:, assistant: nil, billing_group_id: nil, client_state: nil, command_id: nil, custom_headers: nil, preferred_codecs: nil, record: nil, record_channels: nil, record_custom_file_name: nil, record_format: nil, record_max_length: nil, record_timeout_secs: nil, record_track: nil, record_trim: nil, send_silence_when_idle: nil, sip_headers: nil, sound_modifications: nil, stream_bidirectional_codec: nil, stream_bidirectional_mode: nil, stream_bidirectional_target_legs: nil, stream_codec: nil, stream_track: nil, stream_url: nil, transcription: nil, transcription_config: nil, webhook_retries_policies: nil, webhook_url: nil, webhook_url_method: nil, webhook_urls: nil, webhook_urls_method: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::Calls::ActionAnswerParams} for more details.
         #
         #   @param call_control_id [String]
         #
+        #   @param assistant [Telnyx::Models::CallAssistantRequest] AI Assistant configuration. All fields except `id` are optional — the assistant'
+        #
         #   @param billing_group_id [String] Use this field to set the Billing Group ID for the call. Must be a valid and exi
         #
         #   @param client_state [String] Use this field to add state to every subsequent webhook. It must be a valid Base