telnyx 5.171.0 → 5.174.0

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

@@ -37,6 +37,9 @@ module Telnyx
 
         variant :skip_turn, -> { Telnyx::AI::AssistantTool::SkipTurn }
 
+        # (BETA) Lets the assistant look at recent image frames the client sent into the conversation (for example webcam or screen-share frames). Frames are sent with `conversation.item.create` and `item.buffer: true`; they never trigger a response on their own. The assistant decides when to look and which frames it needs. Requires a model that supports image input.
+        variant :vision, -> { Telnyx::AI::AssistantTool::Vision }
+
         # (BETA) The pay tool allows the assistant to collect card payments from the caller via DTMF during the conversation. Recording is automatically paused while the pay tool is active and resumes when the payment flow completes. The connector_name must reference a pay connector configured in the Telnyx API.
         variant :pay, -> { Telnyx::AI::AssistantTool::Pay }
 
@@ -380,6 +383,15 @@ module Telnyx
             #   @return [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Targets::TargetsList>, String]
             required :targets, union: -> { Telnyx::AI::AssistantTool::Transfer::Transfer::Targets }
 
+            # @!attribute bridge_beep
+            #   Plays a short beep once the transfer completes and the calls are bridged, so the
+            #   transfer destination knows the caller is now on the line. The warm transfer
+            #   message plays before the bridge; this marks the moment the caller actually
+            #   joins. Works with and without `warm_transfer_acceptance`.
+            #
+            #   @return [Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep, nil]
+            optional :bridge_beep, -> { Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep }
+
             # @!attribute custom_headers
             #   Custom headers to be added to the SIP INVITE for the transfer command.
             #
@@ -449,7 +461,7 @@ module Telnyx
             #   @return [String, nil]
             optional :warm_transfer_instructions, String
 
-            # @!method initialize(from:, targets:, custom_headers: nil, description: nil, diversion: nil, voicemail_detection: nil, warm_message_delay_ms: nil, warm_transfer_acceptance: nil, warm_transfer_instructions: nil)
+            # @!method initialize(from:, targets:, bridge_beep: nil, custom_headers: nil, description: nil, diversion: nil, voicemail_detection: nil, warm_message_delay_ms: nil, warm_transfer_acceptance: nil, warm_transfer_instructions: nil)
             #   Some parameter documentations has been truncated, see
             #   {Telnyx::Models::AI::AssistantTool::Transfer::Transfer} for more details.
             #
@@ -457,6 +469,8 @@ module Telnyx
             #
             #   @param targets [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Targets::TargetsList>, String] The different possible targets of the transfer. The assistant will be able to ch
             #
+            #   @param bridge_beep [Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep] Plays a short beep once the transfer completes and the calls are bridged, so the
+            #
             #   @param custom_headers [Array<Telnyx::Models::AI::AssistantTool::Transfer::Transfer::CustomHeader>] Custom headers to be added to the SIP INVITE for the transfer command.
             #
             #   @param description [String] A description of the transfer tool. By default, Telnyx generates this automatica
@@ -558,6 +572,50 @@ module Telnyx
                 }]
             end
 
+            # @see Telnyx::Models::AI::AssistantTool::Transfer::Transfer#bridge_beep
+            class BridgeBeep < Telnyx::Internal::Type::BaseModel
+              # @!attribute enabled
+              #   Whether to play the beep when the calls are bridged.
+              #
+              #   @return [Boolean, nil]
+              optional :enabled, Telnyx::Internal::Type::Boolean
+
+              # @!attribute target_legs
+              #   Who hears the beep. `self` plays it to the transfer destination only; `both`
+              #   plays it to the destination and the original caller.
+              #
+              #   @return [Symbol, Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs, nil]
+              optional :target_legs, enum: -> { Telnyx::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs }
+
+              # @!method initialize(enabled: nil, target_legs: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep} for more
+              #   details.
+              #
+              #   Plays a short beep once the transfer completes and the calls are bridged, so the
+              #   transfer destination knows the caller is now on the line. The warm transfer
+              #   message plays before the bridge; this marks the moment the caller actually
+              #   joins. Works with and without `warm_transfer_acceptance`.
+              #
+              #   @param enabled [Boolean] Whether to play the beep when the calls are bridged.
+              #
+              #   @param target_legs [Symbol, Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep::TargetLegs] Who hears the beep. `self` plays it to the transfer destination only; `both` pla
+
+              # Who hears the beep. `self` plays it to the transfer destination only; `both`
+              # plays it to the destination and the original caller.
+              #
+              # @see Telnyx::Models::AI::AssistantTool::Transfer::Transfer::BridgeBeep#target_legs
+              module TargetLegs
+                extend Telnyx::Internal::Type::Enum
+
+                SELF = :self
+                BOTH = :both
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+
             class CustomHeader < Telnyx::Internal::Type::BaseModel
               # @!attribute name
               #
@@ -845,7 +903,35 @@ module Telnyx
               optional :end_user_target_context_mode,
                        enum: -> { Telnyx::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode }
 
-              # @!method initialize(enabled: nil, end_user_target_context_mode: nil)
+              # @!attribute require_acceptance
+              #   Fail closed when the acceptance consult cannot run. Off by default: if the
+              #   consult cannot be set up for any reason — including where acceptance is
+              #   unavailable at all (`gather_using_ai`, Conversation Relay or web calls, a
+              #   conference, or additional invited participants) — the transfer degrades to a
+              #   plain warm transfer (the warm transfer message is played to the destination as
+              #   audio and the calls are bridged anyway). Set to true to treat those paths as a
+              #   decline instead: the destination is disconnected without being asked, the
+              #   assistant returns to the caller, and no bridge happens without an acceptance.
+              #   Only consult-setup failures are affected; the destination must still explicitly
+              #   accept on every consult that does run.
+              #
+              #   @return [Boolean, nil]
+              optional :require_acceptance, Telnyx::Internal::Type::Boolean
+
+              # @!attribute timeout_secs
+              #   How long, in seconds, the destination has to accept the transfer, counted from
+              #   when the private consult starts (right after the destination answers, or after
+              #   `warm_message_delay_ms`). The caller keeps hearing ringback the whole time. If
+              #   no acceptance arrives in time, the destination is hung up and the assistant
+              #   returns to the caller (the transfer fails as a timeout). Raise it for
+              #   destinations that answer before a human is on the line, such as a call-center
+              #   queue/ACD or an IVR playing hold audio; keep it as short as practical, since the
+              #   caller waits on ringback until it expires.
+              #
+              #   @return [Integer, nil]
+              optional :timeout_secs, Integer
+
+              # @!method initialize(enabled: nil, end_user_target_context_mode: nil, require_acceptance: nil, timeout_secs: nil)
               #   Some parameter documentations has been truncated, see
               #   {Telnyx::Models::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance}
               #   for more details.
@@ -865,6 +951,10 @@ module Telnyx
               #   @param enabled [Boolean] Whether the destination must accept the transfer before the calls are bridged.
               #
               #   @param end_user_target_context_mode [Symbol, Telnyx::Models::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode] Controls whether the private exchange between the assistant and the transfer des
+              #
+              #   @param require_acceptance [Boolean] Fail closed when the acceptance consult cannot run. Off by default: if the consu
+              #
+              #   @param timeout_secs [Integer] How long, in seconds, the destination has to accept the transfer, counted from w
 
               # Controls whether the private exchange between the assistant and the transfer
               # destination is kept out of the conversation. With `private` (default) the
@@ -1419,6 +1509,48 @@ module Telnyx
           end
         end
 
+        class Vision < Telnyx::Internal::Type::BaseModel
+          # @!attribute type
+          #
+          #   @return [Symbol, :vision]
+          required :type, const: :vision
+
+          # @!attribute vision
+          #
+          #   @return [Telnyx::Models::AI::VisionToolParams, nil]
+          optional :vision, -> { Telnyx::AI::VisionToolParams }
+
+          response_only do
+            # @!attribute shared
+            #   Whether this tool comes from the shared Tools Library. Responses merge shared
+            #   tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+            #   Read-only: set by the server, not accepted in requests. When updating an
+            #   assistant, omit `shared: true` tools from the request `tools` array and manage
+            #   them through `tool_ids` instead — re-sending their definitions creates an inline
+            #   duplicate (rejected with error code 10015 when the type allows only one instance
+            #   per assistant).
+            #
+            #   @return [Boolean, nil]
+            optional :shared, Telnyx::Internal::Type::Boolean
+          end
+
+          # @!method initialize(shared: nil, vision: nil, type: :vision)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::AssistantTool::Vision} for more details.
+          #
+          #   (BETA) Lets the assistant look at recent image frames the client sent into the
+          #   conversation (for example webcam or screen-share frames). Frames are sent with
+          #   `conversation.item.create` and `item.buffer: true`; they never trigger a
+          #   response on their own. The assistant decides when to look and which frames it
+          #   needs. Requires a model that supports image input.
+          #
+          #   @param shared [Boolean] Whether this tool comes from the shared Tools Library. Responses merge shared to
+          #
+          #   @param vision [Telnyx::Models::AI::VisionToolParams]
+          #
+          #   @param type [Symbol, :vision]
+        end
+
         class Pay < Telnyx::Internal::Type::BaseModel
           # @!attribute pay
           #
@@ -1504,7 +1636,7 @@ module Telnyx
         end
 
         # @!method self.variants
-        #   @return [Array(Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables)]
+        #   @return [Array(Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables)]
       end
     end
   end

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

@@ -28,8 +28,10 @@ module Telnyx
         optional :a2a_agents, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AssistantA2AAgent] }
 
         # @!attribute avatar_settings
-        #   **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-        #   catalog supports six avatars and office, studio, or reception backgrounds.
+        #   **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+        #   avatar or an organization-owned custom avatar returned by the Avatars API.
+        #   Discover the available stock catalog with GET /v2/ai/avatars and
+        #   filter[avatar_type]=stock; follow meta.total_pages to load every page.
         #
         #   @return [Telnyx::Models::AI::AvatarSettingsRequest, nil]
         optional :avatar_settings, -> { Telnyx::AI::AvatarSettingsRequest }, nil?: true
@@ -248,7 +250,7 @@ module Telnyx
         #   omit those tools from the `tools` array and manage them through `tool_ids`
         #   instead.
         #
-        #   @return [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
+        #   @return [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
         optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
         # @!attribute transcription
@@ -291,7 +293,7 @@ module Telnyx
         #
         #   @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] A2A agents this assistant can delegate to. Tools are not stored here: at the sta
         #
-        #   @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. The launch c
+        #   @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
         #
         #   @param conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Conversation flow as supplied by API clients (create / update).
         #
@@ -345,7 +347,7 @@ module Telnyx
         #
         #   @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
         #
-        #   @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
+        #   @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #

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

@@ -20,8 +20,10 @@ module Telnyx
           optional :a2a_agents, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AssistantA2AAgent] }
 
           # @!attribute avatar_settings
-          #   **Beta:** Configuration for the Telnyx open-source avatar provider. The launch
-          #   catalog supports six avatars and office, studio, or reception backgrounds.
+          #   **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
+          #   avatar or an organization-owned custom avatar returned by the Avatars API.
+          #   Discover the available stock catalog with GET /v2/ai/avatars and
+          #   filter[avatar_type]=stock; follow meta.total_pages to load every page.
           #
           #   @return [Telnyx::Models::AI::AvatarSettingsRequest, nil]
           optional :avatar_settings, -> { Telnyx::AI::AvatarSettingsRequest }, nil?: true
@@ -233,7 +235,7 @@ module Telnyx
           #   omit those tools from the `tools` array and manage them through `tool_ids`
           #   instead.
           #
-          #   @return [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
+          #   @return [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, nil]
           optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
           # @!attribute transcription
@@ -274,7 +276,7 @@ module Telnyx
           #
           #   @param a2a_agents [Array<Telnyx::Models::AI::AssistantA2AAgent>] A2A agents this assistant can delegate to. Tools are not stored here: at the sta
           #
-          #   @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. The launch c
+          #   @param avatar_settings [Telnyx::Models::AI::AvatarSettingsRequest, nil] **Beta:** Configuration for the Telnyx open-source avatar provider. Use a stock
           #
           #   @param conversation_flow [Telnyx::Models::AI::ConversationFlowReq] Conversation flow as supplied by API clients (create / update).
           #
@@ -326,7 +328,7 @@ module Telnyx
           #
           #   @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
           #
-          #   @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
+          #   @param tools [Array<Telnyx::Models::AI::AssistantTool::Function, Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::AssistantTool::Hangup, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Vision, Telnyx::Models::AI::AssistantTool::Pay, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
           #
           #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
           #

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

@@ -17,6 +17,8 @@ module Telnyx
         #   English only (`en` and its regional variants, e.g. `en-US`, `en-GB`).
         #   `nvidia/parakeet-v3` is multilingual with automatic language detection;
         #   `omi-health/omi-med-stt-v1` is a medical model, English only.
+        #   `reson8/prerecorded` covers 10 languages, returns word timestamps, and labels
+        #   speakers via `model_config`.
         #
         #   @return [Symbol, Telnyx::Models::AI::AudioTranscribeParams::Model]
         required :model, enum: -> { Telnyx::AI::AudioTranscribeParams::Model }
@@ -49,17 +51,25 @@ module Telnyx
         #   `openai/whisper-large-v3-turbo`, supports multiple languages.
         #   `distil-whisper/distil-large-v2` does not support language parameter.
         #   `nvidia/parakeet-v3` detects the language automatically;
-        #   `omi-health/omi-med-stt-v1` is English only.
+        #   `omi-health/omi-med-stt-v1` is English only. `reson8/prerecorded` accepts `nl`,
+        #   `en`, `fr`, `fy`, `de`, `it`, `pl`, `pt`, `es` and `sv` (regional variants are
+        #   transcribed as the base language) and detects the language when it is omitted.
         #
         #   @return [String, nil]
         optional :language, String
 
         # @!attribute model_config
         #   Additional model-specific configuration parameters. Only allowed with the
-        #   `deepgram/*` models. Can include Deepgram-specific options such as
-        #   `smart_format`, `punctuate`, `diarize`, `utterance`, `numerals`, and `language`.
-        #   If `language` is provided both as a top-level parameter and in `model_config`,
-        #   the top-level parameter takes precedence.
+        #   `deepgram/*` models and `reson8/prerecorded`. Sent as a JSON string in multipart
+        #   requests; for the `deepgram/*` models it is passed through to Deepgram as query
+        #   parameters, while `reson8/prerecorded` accepts only `diarize` (speaker labels)
+        #   and `max_speakers` (1 to 8). Any other model with `model_config` returns 400.
+        #   Can include Deepgram-specific options such as `smart_format`, `punctuate`,
+        #   `diarize` (speaker labels), `multichannel` (transcribe each channel
+        #   independently; billed duration is file duration multiplied by the number of
+        #   channels), `utterances`, `numerals`, and `language`. If `language` is provided
+        #   both as a top-level parameter and in `model_config`, the top-level parameter
+        #   takes precedence.
         #
         #   @return [Hash{Symbol=>Object}, nil]
         optional :model_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
@@ -109,6 +119,8 @@ module Telnyx
         # English only (`en` and its regional variants, e.g. `en-US`, `en-GB`).
         # `nvidia/parakeet-v3` is multilingual with automatic language detection;
         # `omi-health/omi-med-stt-v1` is a medical model, English only.
+        # `reson8/prerecorded` covers 10 languages, returns word timestamps, and labels
+        # speakers via `model_config`.
         module Model
           extend Telnyx::Internal::Type::Enum
 
@@ -120,6 +132,7 @@ module Telnyx
           DEEPGRAM_NOVA_3_MEDICAL = :"deepgram/nova-3-medical"
           NVIDIA_PARAKEET_V3 = :"nvidia/parakeet-v3"
           OMI_HEALTH_OMI_MED_STT_V1 = :"omi-health/omi-med-stt-v1"
+          RESON8_PRERECORDED = :"reson8/prerecorded"
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -47,6 +47,9 @@ module Telnyx
         #   return `text` and, depending on `model_config`, may include `words` with
         #   per-word timestamps and speaker labels. The Parakeet models
         #   (`nvidia/parakeet-v3`, `omi-health/omi-med-stt-v1`) return `text` only.
+        #   `reson8/prerecorded` returns `text` and, in `verbose_json` mode, `duration` and
+        #   `segments` with `words`; with `diarize`, one segment per speaker turn with
+        #   speaker labels.
         #
         #   @param text [String] The transcribed text for the audio file.
         #
@@ -81,21 +84,33 @@ module Telnyx
           #   @return [String]
           required :text, String
 
+          # @!attribute channel
+          #   Zero-indexed audio channel of this segment. Returned by the `deepgram/*` models
+          #   when `multichannel` is enabled via `model_config` and the file has more than one
+          #   channel. Segments from all channels are merged in one list ordered by start
+          #   time.
+          #
+          #   @return [Integer, nil]
+          optional :channel, Integer
+
           # @!attribute speakers
-          #   Speaker indices heard in this segment. Returned by the `deepgram/*` models when
-          #   `diarize` is enabled via `model_config`.
+          #   Speaker indices heard in this segment. Returned by the `deepgram/*` models and
+          #   `reson8/prerecorded` when `diarize` is enabled via `model_config`. With
+          #   `multichannel`, speakers are numbered per channel from 0, so identify a speaker
+          #   by (`channel`, speaker).
           #
           #   @return [Array<Integer>, nil]
           optional :speakers, Telnyx::Internal::Type::ArrayOf[Integer]
 
           # @!attribute words
           #   Word-level timing detail for this segment. Returned by the `deepgram/*` models
-          #   when word-level output is enabled via `model_config`.
+          #   when word-level output is enabled via `model_config`, and by
+          #   `reson8/prerecorded`.
           #
           #   @return [Array<Telnyx::Models::AI::AudioTranscriptionResponseWord>, nil]
           optional :words, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::AudioTranscriptionResponseWord] }
 
-          # @!method initialize(id:, end_:, start:, text:, speakers: nil, words: nil)
+          # @!method initialize(id:, end_:, start:, text:, channel: nil, speakers: nil, words: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::AI::AudioTranscribeResponse::Segment} for more details.
           #
@@ -107,7 +122,9 @@ module Telnyx
           #
           #   @param text [String] Text content of the segment.
           #
-          #   @param speakers [Array<Integer>] Speaker indices heard in this segment. Returned by the `deepgram/*` models when
+          #   @param channel [Integer] Zero-indexed audio channel of this segment. Returned by the `deepgram/*` models
+          #
+          #   @param speakers [Array<Integer>] Speaker indices heard in this segment. Returned by the `deepgram/*` models and `
           #
           #   @param words [Array<Telnyx::Models::AI::AudioTranscriptionResponseWord>] Word-level timing detail for this segment. Returned by the `deepgram/*` models w
         end

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

@@ -53,7 +53,7 @@ module Telnyx
         #   {Telnyx::Models::AI::AudioTranscriptionResponseWord} for more details.
         #
         #   Word-level timing detail. Only present when using a `deepgram/*` model with
-        #   `model_config` options that enable word timestamps.
+        #   `model_config` options that enable word timestamps, or `reson8/prerecorded`.
         #
         #   @param end_ [Float] End time of the word in seconds.
         #

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

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#list
+      class Avatar < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #   GET /v2/ai/avatars and filter[avatar_type]=stock rather than maintaining a fixed
+        #   list. Custom avatar IDs use the `avatar_` prefix and must belong to the
+        #   authenticated organization. The service validates that the selected avatar is
+        #   available.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute avatar_type
+        #   Whether the avatar is provided by Telnyx or was uploaded by the authenticated
+        #   organization.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::AvatarType]
+        required :avatar_type, enum: -> { Telnyx::AI::AvatarType }
+
+        # @!attribute hosted
+        #   Indicates that avatar rendering runs on Telnyx-operated infrastructure.
+        #
+        #   @return [Boolean, true]
+        required :hosted, const: true
+
+        # @!attribute image_url
+        #   HTTPS image URL suitable for an avatar selection thumbnail. If the URL expires,
+        #   list or retrieve the avatar again to refresh it.
+        #
+        #   @return [String]
+        required :image_url, String
+
+        # @!attribute name
+        #   Customer-facing avatar name.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute provider
+        #   Avatar provider. The first release supports Telnyx avatars.
+        #
+        #   @return [Symbol, :telnyx]
+        required :provider, const: :telnyx
+
+        # @!attribute content_type
+        #   MIME type of a custom avatar image.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::Avatar::ContentType, nil]
+        optional :content_type, enum: -> { Telnyx::AI::Avatar::ContentType }
+
+        # @!attribute created_at
+        #   Time when the custom avatar was created.
+        #
+        #   @return [Time, nil]
+        optional :created_at, Time
+
+        # @!attribute height_px
+        #   Decoded height of a custom avatar image.
+        #
+        #   @return [Integer, nil]
+        optional :height_px, Integer
+
+        # @!attribute image_url_expires_at
+        #   Expiration time of `image_url`. Omitted when the URL does not expire.
+        #
+        #   @return [Time, nil]
+        optional :image_url_expires_at, Time
+
+        # @!attribute size_bytes
+        #   Size of a custom avatar image in bytes.
+        #
+        #   @return [Integer, nil]
+        optional :size_bytes, Integer
+
+        # @!attribute updated_at
+        #   Time when the custom avatar was last updated.
+        #
+        #   @return [Time, nil]
+        optional :updated_at, Time
+
+        # @!attribute width_px
+        #   Decoded width of a custom avatar image.
+        #
+        #   @return [Integer, nil]
+        optional :width_px, Integer
+
+        response_only do
+          # @!attribute suggested_voice_id
+          #   Optional recommended Telnyx text-to-speech voice for this avatar. An omitted
+          #   field or empty string means no recommendation is available. Custom avatars have
+          #   no suggested voice. It is informational and selecting the avatar does not
+          #   automatically change the AI Assistant's configured voice.
+          #
+          #   @return [String, nil]
+          optional :suggested_voice_id, String
+        end
+
+        # @!method initialize(id:, avatar_type:, image_url:, name:, content_type: nil, created_at: nil, height_px: nil, image_url_expires_at: nil, size_bytes: nil, suggested_voice_id: nil, updated_at: nil, width_px: nil, hosted: true, provider: :telnyx)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::Avatar} for more details.
+        #
+        #   @param id [String] Stable identifier returned by the Avatars API. Discover available stock IDs with
+        #
+        #   @param avatar_type [Symbol, Telnyx::Models::AI::AvatarType] Whether the avatar is provided by Telnyx or was uploaded by the authenticated or
+        #
+        #   @param image_url [String] HTTPS image URL suitable for an avatar selection thumbnail. If the URL expires,
+        #
+        #   @param name [String] Customer-facing avatar name.
+        #
+        #   @param content_type [Symbol, Telnyx::Models::AI::Avatar::ContentType] MIME type of a custom avatar image.
+        #
+        #   @param created_at [Time] Time when the custom avatar was created.
+        #
+        #   @param height_px [Integer] Decoded height of a custom avatar image.
+        #
+        #   @param image_url_expires_at [Time] Expiration time of `image_url`. Omitted when the URL does not expire.
+        #
+        #   @param size_bytes [Integer] Size of a custom avatar image in bytes.
+        #
+        #   @param suggested_voice_id [String] Optional recommended Telnyx text-to-speech voice for this avatar. An omitted fie
+        #
+        #   @param updated_at [Time] Time when the custom avatar was last updated.
+        #
+        #   @param width_px [Integer] Decoded width of a custom avatar image.
+        #
+        #   @param hosted [Boolean, true] Indicates that avatar rendering runs on Telnyx-operated infrastructure.
+        #
+        #   @param provider [Symbol, :telnyx] Avatar provider. The first release supports Telnyx avatars.
+
+        # MIME type of a custom avatar image.
+        #
+        # @see Telnyx::Models::AI::Avatar#content_type
+        module ContentType
+          extend Telnyx::Internal::Type::Enum
+
+          IMAGE_JPEG = :"image/jpeg"
+          IMAGE_PNG = :"image/png"
+          IMAGE_WEBP = :"image/webp"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Avatars#create
+      class AvatarCreateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute image_file
+        #   JPEG, PNG, or WebP image file. The maximum file size is 10 MiB.
+        #
+        #   @return [Pathname, StringIO, IO, String, Telnyx::FilePart]
+        required :image_file, Telnyx::Internal::Type::FileInput
+
+        # @!attribute name
+        #   Customer-facing name of the custom avatar.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!method initialize(image_file:, name:, request_options: {})
+        #   @param image_file [Pathname, StringIO, IO, String, Telnyx::FilePart] JPEG, PNG, or WebP image file. The maximum file size is 10 MiB.
+        #
+        #   @param name [String] Customer-facing name of the custom avatar.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      AvatarID = String
+    end
+  end
+end