telnyx 5.173.0 → 5.174.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8a0d9edaab7084b74be27c5c41e73fc0089a2ef12cddd59fb974320a0144439
-  data.tar.gz: 5657256ca67f97cade75834a3247666105fdb2e05853aed4a5e54d84f40fefe8
+  metadata.gz: 3fac885ac7ccf74c3f9f991d7dca38d2155d645e1a24cbfb8fa849ff010f78b7
+  data.tar.gz: 75d6ae4f9f701214078d8c9e7a43258b677bb82a29074a26634beaa2c4628738
 SHA512:
-  metadata.gz: 9fae567fb853b28065d5791761ce257b840a971e8628c5b31930b74c7f45b21ee1e707903bf26921eff9f2538249dd55cca5f3c39b8550b038ffd9d33e011d51
-  data.tar.gz: 0073a20d3cf951262e622b5caf07990c4ee8e80085e0c18a6f9e3e6639d5d26cec68f7cb54883a0c48e8c9a2fea22e9a89f8ec9ad98e475cc3c299db27b47784
+  metadata.gz: 137fadbbd6825fe3335c3dc2aad76145d5c9af2c693023ca98905d63ca5ffd87f71d2b3ea56ae6ba0a744cb5d5c09fd2bf6219aad7ae960ed9bd9e3712feaaf0
+  data.tar.gz: 5b42c035897d4698f6ae5c7e6c20ce6305d8dbd7227927305e5825cc5215c587d73b7c5825432c423ff0517943b71d1b804aa88e5d5bda93ed86fc560ae0f5c5

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [5.174.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.173.0...v5.174.0) (2026-10-29)
+
+
+### Features
+
+* promote from staging 458522c ([15f8625](https://github.com/team-telnyx/telnyx-ruby/commit/15f86251ff7ccfc9ec222355907441ddc10b1b07))
+
 ## [5.173.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.172.0...v5.173.0) (2026-10-28)
 
 

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

data/lib/telnyx/client.rb

@@ -824,9 +824,6 @@ module Telnyx
     # @return [Telnyx::Resources::DialMetrics]
     attr_reader :dial_metrics
 
-    # @return [Telnyx::Resources::TtsIntegrations]
-    attr_reader :tts_integrations
-
     # Tailscale Subnet Router operations
     # @return [Telnyx::Resources::TailscaleSubnetRouters]
     attr_reader :tailscale_subnet_routers
@@ -1153,7 +1150,6 @@ module Telnyx
       @llm_token_gateway = Telnyx::Resources::LlmTokenGateway.new(client: self)
       @sip_registration_status = Telnyx::Resources::SipRegistrationStatus.new(client: self)
       @dial_metrics = Telnyx::Resources::DialMetrics.new(client: self)
-      @tts_integrations = Telnyx::Resources::TtsIntegrations.new(client: self)
       @tailscale_subnet_routers = Telnyx::Resources::TailscaleSubnetRouters.new(client: self)
       @artifact_downloads = Telnyx::Resources::ArtifactDownloads.new(client: self)
       @email = Telnyx::Resources::Email.new(client: self)

data/lib/telnyx/lib/access_token.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+require "base64"
+require "json"
+require "openssl"
+
+module Telnyx
+  module Lib
+    # Mints a WebRTC login token for a telephony credential locally, with no
+    # request to Telnyx.
+    #
+    # The token has the same shape as the one `POST /v2/telephony_credentials/:id/token`
+    # (`client.telephony_credentials.create_token`) returns, so it is used the
+    # same way: pass it to the WebRTC SDK as `login_token`. Telnyx verifies it
+    # on login.
+    #
+    # The signing material comes from the credential: `token_material` is in the
+    # response of `POST /v2/telephony_credentials` and of
+    # `GET /v2/telephony_credentials/:id/token_material`. It is as sensitive as
+    # the SIP password, so keep it on the server; never ship it to a browser.
+    #
+    #   credential = client.telephony_credentials.create(connection_id: "123")
+    #   client.telephony_credentials.to_jwt(credential)            # 1 hour
+    #   client.telephony_credentials.to_jwt(credential, ttl: 600)  # 10 minutes
+    #
+    # Or from stored values, with no client at all:
+    #
+    #   Telnyx::Lib::AccessToken.new(
+    #     credential_id: "...", user_id: "...", identity: "gencred...",
+    #     expires_at: "2027-01-01T00:00:00Z",
+    #     token_material: {kid: "v1", tel_token: "...", signing_secret: "..."}
+    #   ).to_jwt
+    class AccessToken
+      DEFAULT_TTL = 3600
+      MAX_TTL = 86_400
+      CONTENT_TYPE = "telnyx-webrtc;v=1"
+      ALGORITHM = "HS256"
+      MATERIAL_FIELDS = [:kid, :tel_token, :signing_secret].freeze
+
+      # Raised by {AccessToken.decode} when the signature does not match.
+      class SignatureError < StandardError
+      end
+
+      attr_reader :credential_id, :user_id, :identity, :expires_at, :ttl
+
+      # @param credential_id [String] the telephony credential `id`
+      # @param user_id [String] the credential's `user_id`
+      # @param identity [String] the credential's `sip_username`
+      # @param token_material [Hash, Telnyx::Internal::Type::BaseModel] `kid`, `tel_token`, `signing_secret`
+      # @param expires_at [String, nil] the credential's `expires_at`, as the API returns it
+      # @param ttl [Integer] token lifetime in seconds, 1..86400; default one hour
+      def initialize(credential_id:, user_id:, identity:, token_material:, expires_at: nil, ttl: DEFAULT_TTL)
+        @credential_id = required(credential_id, "credential_id")
+        @user_id = required(user_id, "user_id")
+        @identity = required(identity, "identity")
+        @expires_at = expires_at
+        @material = normalize_material(token_material)
+        @ttl = Integer(ttl).clamp(1, MAX_TTL)
+      end
+
+      # The signed token, valid from `now` for `ttl` seconds.
+      #
+      # @param now [Time]
+      #
+      # @return [String]
+      def to_jwt(now: Time.now)
+        iat = now.to_i
+        header = {alg: ALGORITHM, typ: "JWT", cty: CONTENT_TYPE, kid: @material.fetch(:kid)}
+        payload = {
+          sub: credential_id,
+          user_id: user_id,
+          identity: identity,
+          cred_exp: expires_at,
+          tel_token: @material.fetch(:tel_token),
+          iat: iat,
+          nbf: iat,
+          exp: iat + ttl,
+          jti: "#{credential_id}-#{iat}"
+        }
+
+        signing_input = "#{encode(JSON.generate(header))}.#{encode(JSON.generate(payload))}"
+        "#{signing_input}.#{encode(self.class.sign(signing_input, @material.fetch(:signing_secret)))}"
+      end
+
+      alias_method :to_s, :to_jwt
+
+      class << self
+        # Decodes a token minted by this class and checks its signature against
+        # `signing_secret`. Meant for tests and debugging: Telnyx does the real
+        # verification on login.
+        #
+        # @param jwt [String]
+        # @param signing_secret [String] base64url, as in `token_material`
+        #
+        # @raise [Telnyx::Lib::AccessToken::SignatureError] if the signature does not match
+        # @return [Hash{String=>Object}] the claims
+        def decode(jwt, signing_secret:)
+          head, body, sig = jwt.to_s.split(".")
+          raise ArgumentError.new("not a JWT") if sig.nil?
+
+          expected = sign("#{head}.#{body}", signing_secret)
+          given = Base64.urlsafe_decode64(sig)
+          valid = given.bytesize == expected.bytesize && OpenSSL.fixed_length_secure_compare(given, expected)
+          raise SignatureError.new("signature does not match the payload") unless valid
+
+          JSON.parse(Base64.urlsafe_decode64(body))
+        end
+
+        # @param signing_input [String]
+        # @param signing_secret [String] base64url
+        #
+        # @return [String] raw HMAC-SHA256 bytes
+        def sign(signing_input, signing_secret)
+          OpenSSL::HMAC.digest("SHA256", Base64.urlsafe_decode64(signing_secret), signing_input)
+        end
+      end
+
+      private
+
+      def encode(bytes) = Base64.urlsafe_encode64(bytes, padding: false)
+
+      def required(value, name)
+        raise ArgumentError.new("#{name} is required to mint a token") if value.nil? || value.to_s.empty?
+
+        value.to_s
+      end
+
+      def normalize_material(material)
+        hash = material.respond_to?(:to_hash) ? material.to_hash : material
+        raise ArgumentError.new("token_material is required to mint a token") unless hash.is_a?(Hash)
+
+        MATERIAL_FIELDS.to_h do |field|
+          value = hash[field] || hash[field.to_s]
+          raise ArgumentError.new("token_material.#{field} is missing") if value.nil? || value.to_s.empty?
+
+          [field, value.to_s]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/lib/telephony_credentials.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require_relative "access_token"
+
+module Telnyx
+  module Lib
+    # Local WebRTC login tokens for `client.telephony_credentials`. Mixed into
+    # the generated {Telnyx::Resources::TelephonyCredentials} from `lib/telnyx/lib.rb`,
+    # so it survives codegen.
+    module TelephonyCredentials
+      # A WebRTC login token for a credential, minted locally with no request
+      # to Telnyx per token. Same use as `create_token`: hand it to the WebRTC
+      # SDK as `login_token`.
+      #
+      # The signing material (`kid`, `tel_token`, `signing_secret`) is read from
+      # the credential's `token_material`, present on the `create` response. A
+      # credential given by id, or one from `retrieve` or `list`, fetches it
+      # with {#fetch_token_material}. Pass `token_material:` to mint from values
+      # stored earlier, with no request at all.
+      #
+      # @param credential [String, Telnyx::Models::TelephonyCredential, Telnyx::Models::TelephonyCredentialCreateResponse, Telnyx::Models::TelephonyCredentialRetrieveResponse]
+      #   the credential id, the credential, or the `create` / `retrieve` response holding it
+      #
+      # @param ttl [Integer] token lifetime in seconds, 1..86400; default one hour
+      #
+      # @param token_material [Hash{Symbol=>String}, nil] `kid`, `tel_token`, `signing_secret` stored earlier
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [String]
+      def to_jwt(
+        credential,
+        ttl: Telnyx::Lib::AccessToken::DEFAULT_TTL,
+        token_material: nil,
+        request_options: {}
+      )
+        model = credential_model(credential, request_options: request_options)
+        material = token_material || model[:token_material] ||
+                   fetch_token_material(model.id, request_options: request_options)
+
+        Telnyx::Lib::AccessToken.new(
+          credential_id: model.id,
+          user_id: model.user_id,
+          identity: model.sip_username,
+          expires_at: model.expires_at,
+          token_material: material,
+          ttl: ttl
+        ).to_jwt
+      end
+
+      # `GET /v2/telephony_credentials/:id/token_material`. Treat the result
+      # like the SIP password: keep it on the server.
+      #
+      # @param id [String] Identifies the resource.
+      #
+      # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Hash{Symbol=>Object}] `kid`, `tel_token`, `signing_secret`
+      def fetch_token_material(id, request_options: {})
+        body = @client.request(
+          method: :get,
+          path: ["telephony_credentials/%1$s/token_material", id],
+          model: Telnyx::Internal::Type::Unknown,
+          options: request_options
+        )
+        body.is_a?(Hash) && body.key?(:data) ? body.fetch(:data) : body
+      end
+
+      private
+
+      # @return [Telnyx::Models::TelephonyCredential]
+      def credential_model(credential, request_options:)
+        model = credential.respond_to?(:data) ? credential.data : credential
+        model = retrieve(model, request_options: request_options).data if model.is_a?(String)
+        return model if model.is_a?(Telnyx::Models::TelephonyCredential)
+
+        raise ArgumentError.new("expected a telephony credential or its id, got #{credential.inspect}")
+      end
+    end
+  end
+
+  module Resources
+    class TelephonyCredentials
+      include Telnyx::Lib::TelephonyCredentials
+    end
+  end
+end

data/lib/telnyx/lib.rb

@@ -14,3 +14,5 @@
 require_relative "lib/webhook_verification_error"
 require_relative "lib/webhook_verification"
 require_relative "lib/websocket"
+require_relative "lib/access_token"
+require_relative "lib/telephony_credentials"

data/lib/telnyx/models/ai/memory/namespaces/namespace_settings.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          class NamespaceSettings < Telnyx::Internal::Type::BaseModel
+            # @!attribute summary
+            #   Settings that shape this namespace's summaries.
+            #
+            #   @return [Telnyx::Models::AI::Memory::Namespaces::SummarySettings, nil]
+            optional :summary, -> { Telnyx::AI::Memory::Namespaces::SummarySettings }
+
+            # @!method initialize(summary: nil)
+            #   A namespace's settings, grouped by what they affect.
+            #
+            #   @param summary [Telnyx::Models::AI::Memory::Namespaces::SummarySettings] Settings that shape this namespace's summaries.
+          end
+        end
+
+        NamespaceSettings = Namespaces::NamespaceSettings
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/memory/namespaces/namespace_settings_response.rb

@@ -10,49 +10,11 @@ module Telnyx
             # @!attribute data
             #   A namespace's settings, grouped by what they affect.
             #
-            #   @return [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data]
-            required :data, -> { Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data }
+            #   @return [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettings]
+            required :data, -> { Telnyx::AI::Memory::Namespaces::NamespaceSettings }
 
             # @!method initialize(data:)
-            #   @param data [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data] A namespace's settings, grouped by what they affect.
-
-            # @see Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse#data
-            class Data < Telnyx::Internal::Type::BaseModel
-              # @!attribute summary
-              #   Settings that shape this namespace's summaries.
-              #
-              #   @return [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary, nil]
-              optional :summary, -> { Telnyx::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary }
-
-              # @!method initialize(summary: nil)
-              #   A namespace's settings, grouped by what they affect.
-              #
-              #   @param summary [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary] Settings that shape this namespace's summaries.
-
-              # @see Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data#summary
-              class Summary < Telnyx::Internal::Type::BaseModel
-                # @!attribute instructions
-                #   Free-form instructions that influence how this namespace's summaries are
-                #   written, shared by every profile in the namespace. How you use them is up to you
-                #   -- they steer the outcome, so try a phrasing and see how the summary comes out.
-                #   Advisory: they steer the summary but never override or deny a profile's own
-                #   facts, and they do not affect recall. Null or empty means none are set, and
-                #   summaries use the neutral default. A change reaches each summary the next time
-                #   it is regenerated.
-                #
-                #   @return [String, nil]
-                optional :instructions, String, nil?: true
-
-                # @!method initialize(instructions: nil)
-                #   Some parameter documentations has been truncated, see
-                #   {Telnyx::Models::AI::Memory::Namespaces::NamespaceSettingsResponse::Data::Summary}
-                #   for more details.
-                #
-                #   Settings that shape this namespace's summaries.
-                #
-                #   @param instructions [String, nil] Free-form instructions that influence how this namespace's summaries are written
-              end
-            end
+            #   @param data [Telnyx::Models::AI::Memory::Namespaces::NamespaceSettings] A namespace's settings, grouped by what they affect.
           end
         end
 

data/lib/telnyx/models/ai/memory/namespaces/summary_settings.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          class SummarySettings < Telnyx::Internal::Type::BaseModel
+            # @!attribute instructions
+            #   Free-form instructions that influence how this namespace's summaries are
+            #   written, shared by every profile in the namespace. How you use them is up to you
+            #   -- they steer the outcome, so try a phrasing and see how the summary comes out.
+            #   Advisory: they steer the summary but never override or deny a profile's own
+            #   facts, and they do not affect recall. Null or empty means none are set, and
+            #   summaries use the neutral default. A change reaches each summary the next time
+            #   it is regenerated.
+            #
+            #   @return [String, nil]
+            optional :instructions, String, nil?: true
+
+            # @!method initialize(instructions: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::Memory::Namespaces::SummarySettings} for more details.
+            #
+            #   A namespace's summary settings, shared by every profile in it.
+            #
+            #   @param instructions [String, nil] Free-form instructions that influence how this namespace's summaries are written
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,148 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      class TranscriptionChallenger < Telnyx::Internal::Type::BaseModel
+        # @!attribute model
+        #   The language booster's model. It must be the same kind of model as
+        #   `transcription.model`: both streaming (`deepgram/flux`, `deepgram/nova-3`,
+        #   `deepgram/nova-2`, `assemblyai/universal-3-6-pro` or its legacy aliases
+        #   `assemblyai/universal-3-5-pro` and `assemblyai/universal-streaming`,
+        #   `xai/grok-stt`, `soniox/stt-rt-v4`, `soniox/stt-rt-v5`, `humain/realtime`,
+        #   `reson8/turns`) or both non-streaming (`azure/fast`, `nvidia/parakeet-v3`,
+        #   `omi-health/omi-med-stt-v1`, `cohere/ar-stt`, `distil-whisper/distil-large-v2`,
+        #   `openai/whisper-large-v3-turbo`, `telnyx/basira`). It can be the same model as
+        #   `transcription.model` on a different `language`.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::TranscriptionChallenger::Model]
+        required :model, enum: -> { Telnyx::AI::TranscriptionChallenger::Model }
+
+        # @!attribute language
+        #   The language this model transcribes. Omit it or set it to `null` to use the
+        #   language of `transcription.model`. The request is rejected when this model
+        #   doesn't support the language it would run. It is also rejected when it would run
+        #   the same model on the same language as `transcription.model`.
+        #
+        #   @return [String, nil]
+        optional :language, String, nil?: true
+
+        # @!attribute rule
+        #   How the assistant picks the transcript it uses. The models are compared on how
+        #   complete and confident their transcripts are, not on language, so the rules work
+        #   best when both models understand the callers' language.
+        #
+        #   - `best_turn` (default): both models transcribe the whole call. Each turn uses
+        #     the language booster's transcript only when it scores higher than the
+        #     transcript of `transcription.model` (clearly higher with non-streaming
+        #     models). With streaming models, `transcription.model` also decides when each
+        #     turn ends. Available for every pair.
+        #   - `best_engine`: both models transcribe the first turns, then the call continues
+        #     alone on the model whose transcripts scored higher. If neither clearly leads,
+        #     `transcription.model` continues. Streaming models only.
+        #   - `merge_words`: both models transcribe each utterance and their words are
+        #     merged, keeping Arabic and English spoken in the same sentence. Available only
+        #     for `telnyx/basira` with `cohere/ar-stt`, in either order. The pair runs on
+        #     the language that applies to `telnyx/basira` (its own, or that of
+        #     `transcription.model`), which must be Arabic (`ar` or an `ar-` locale),
+        #     `multi`, or `auto`.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::TranscriptionChallenger::Rule, nil]
+        optional :rule, enum: -> { Telnyx::AI::TranscriptionChallenger::Rule }
+
+        # @!attribute settings
+        #   Settings for the language booster, with the same fields and limits as
+        #   `transcription.settings`. Fields that don't apply to this model's provider are
+        #   dropped, and the provider's defaults fill in the rest. Omit it or set it to
+        #   `null` to use the settings of `transcription.model` where they apply to this
+        #   model.
+        #
+        #   @return [Telnyx::Models::AI::TranscriptionSettingsConfig, nil]
+        optional :settings, -> { Telnyx::AI::TranscriptionSettingsConfig }, nil?: true
+
+        # @!method initialize(model:, language: nil, rule: nil, settings: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::TranscriptionChallenger} for more details.
+        #
+        #   A second speech-to-text model that transcribes alongside `transcription.model`,
+        #   and the rule that decides which transcript the assistant uses.
+        #
+        #   @param model [Symbol, Telnyx::Models::AI::TranscriptionChallenger::Model] The language booster's model. It must be the same kind of model as `transcriptio
+        #
+        #   @param language [String, nil] The language this model transcribes. Omit it or set it to `null` to use the lang
+        #
+        #   @param rule [Symbol, Telnyx::Models::AI::TranscriptionChallenger::Rule] How the assistant picks the transcript it uses. The models are compared on how c
+        #
+        #   @param settings [Telnyx::Models::AI::TranscriptionSettingsConfig, nil] Settings for the language booster, with the same fields and limits as `transcrip
+
+        # The language booster's model. It must be the same kind of model as
+        # `transcription.model`: both streaming (`deepgram/flux`, `deepgram/nova-3`,
+        # `deepgram/nova-2`, `assemblyai/universal-3-6-pro` or its legacy aliases
+        # `assemblyai/universal-3-5-pro` and `assemblyai/universal-streaming`,
+        # `xai/grok-stt`, `soniox/stt-rt-v4`, `soniox/stt-rt-v5`, `humain/realtime`,
+        # `reson8/turns`) or both non-streaming (`azure/fast`, `nvidia/parakeet-v3`,
+        # `omi-health/omi-med-stt-v1`, `cohere/ar-stt`, `distil-whisper/distil-large-v2`,
+        # `openai/whisper-large-v3-turbo`, `telnyx/basira`). It can be the same model as
+        # `transcription.model` on a different `language`.
+        #
+        # @see Telnyx::Models::AI::TranscriptionChallenger#model
+        module Model
+          extend Telnyx::Internal::Type::Enum
+
+          DEEPGRAM_FLUX = :"deepgram/flux"
+          DEEPGRAM_NOVA_3 = :"deepgram/nova-3"
+          DEEPGRAM_NOVA_2 = :"deepgram/nova-2"
+          AZURE_FAST = :"azure/fast"
+          ASSEMBLYAI_UNIVERSAL_3_6_PRO = :"assemblyai/universal-3-6-pro"
+          ASSEMBLYAI_UNIVERSAL_3_5_PRO = :"assemblyai/universal-3-5-pro"
+          ASSEMBLYAI_UNIVERSAL_STREAMING = :"assemblyai/universal-streaming"
+          XAI_GROK_STT = :"xai/grok-stt"
+          SONIOX_STT_RT_V4 = :"soniox/stt-rt-v4"
+          SONIOX_STT_RT_V5 = :"soniox/stt-rt-v5"
+          NVIDIA_PARAKEET_V3 = :"nvidia/parakeet-v3"
+          OMI_HEALTH_OMI_MED_STT_V1 = :"omi-health/omi-med-stt-v1"
+          HUMAIN_REALTIME = :"humain/realtime"
+          RESON8_TURNS = :"reson8/turns"
+          COHERE_AR_STT = :"cohere/ar-stt"
+          TELNYX_BASIRA = :"telnyx/basira"
+          DISTIL_WHISPER_DISTIL_LARGE_V2 = :"distil-whisper/distil-large-v2"
+          OPENAI_WHISPER_LARGE_V3_TURBO = :"openai/whisper-large-v3-turbo"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # How the assistant picks the transcript it uses. The models are compared on how
+        # complete and confident their transcripts are, not on language, so the rules work
+        # best when both models understand the callers' language.
+        #
+        # - `best_turn` (default): both models transcribe the whole call. Each turn uses
+        #   the language booster's transcript only when it scores higher than the
+        #   transcript of `transcription.model` (clearly higher with non-streaming
+        #   models). With streaming models, `transcription.model` also decides when each
+        #   turn ends. Available for every pair.
+        # - `best_engine`: both models transcribe the first turns, then the call continues
+        #   alone on the model whose transcripts scored higher. If neither clearly leads,
+        #   `transcription.model` continues. Streaming models only.
+        # - `merge_words`: both models transcribe each utterance and their words are
+        #   merged, keeping Arabic and English spoken in the same sentence. Available only
+        #   for `telnyx/basira` with `cohere/ar-stt`, in either order. The pair runs on
+        #   the language that applies to `telnyx/basira` (its own, or that of
+        #   `transcription.model`), which must be Arabic (`ar` or an `ar-` locale),
+        #   `multi`, or `auto`.
+        #
+        # @see Telnyx::Models::AI::TranscriptionChallenger#rule
+        module Rule
+          extend Telnyx::Internal::Type::Enum
+
+          BEST_TURN = :best_turn
+          BEST_ENGINE = :best_engine
+          MERGE_WORDS = :merge_words
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      class TranscriptionFallbackModel < Telnyx::Internal::Type::BaseModel
+        # @!attribute model
+        #   The fallback model. It must be a streaming model other than
+        #   `transcription.model` and the other fallbacks: `deepgram/flux`,
+        #   `deepgram/nova-3`, `deepgram/nova-2`, `assemblyai/universal-3-6-pro` (or its
+        #   legacy aliases `assemblyai/universal-3-5-pro` and
+        #   `assemblyai/universal-streaming`), `xai/grok-stt`, `soniox/stt-rt-v4`,
+        #   `soniox/stt-rt-v5`, `humain/realtime`, or `reson8/turns`.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::TranscriptionFallbackModel::Model]
+        required :model, enum: -> { Telnyx::AI::TranscriptionFallbackModel::Model }
+
+        # @!attribute language
+        #   The language the fallback transcribes. Omit it or set it to `null` to use the
+        #   language of `transcription.model`. The request is rejected when the fallback
+        #   model doesn't support the language it would run.
+        #
+        #   @return [String, nil]
+        optional :language, String, nil?: true
+
+        # @!attribute settings
+        #   Settings for the fallback, with the same fields and limits as
+        #   `transcription.settings`. Fields that don't apply to this model's provider are
+        #   dropped, and the provider's defaults fill in the rest. Omit it or set it to
+        #   `null` to use the settings of `transcription.model` where they apply to this
+        #   model.
+        #
+        #   @return [Telnyx::Models::AI::TranscriptionSettingsConfig, nil]
+        optional :settings, -> { Telnyx::AI::TranscriptionSettingsConfig }, nil?: true
+
+        # @!method initialize(model:, language: nil, settings: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::TranscriptionFallbackModel} for more details.
+        #
+        #   A streaming speech-to-text model that takes over transcription when the model in
+        #   use fails.
+        #
+        #   @param model [Symbol, Telnyx::Models::AI::TranscriptionFallbackModel::Model] The fallback model. It must be a streaming model other than `transcription.model
+        #
+        #   @param language [String, nil] The language the fallback transcribes. Omit it or set it to `null` to use the la
+        #
+        #   @param settings [Telnyx::Models::AI::TranscriptionSettingsConfig, nil] Settings for the fallback, with the same fields and limits as `transcription.set
+
+        # The fallback model. It must be a streaming model other than
+        # `transcription.model` and the other fallbacks: `deepgram/flux`,
+        # `deepgram/nova-3`, `deepgram/nova-2`, `assemblyai/universal-3-6-pro` (or its
+        # legacy aliases `assemblyai/universal-3-5-pro` and
+        # `assemblyai/universal-streaming`), `xai/grok-stt`, `soniox/stt-rt-v4`,
+        # `soniox/stt-rt-v5`, `humain/realtime`, or `reson8/turns`.
+        #
+        # @see Telnyx::Models::AI::TranscriptionFallbackModel#model
+        module Model
+          extend Telnyx::Internal::Type::Enum
+
+          DEEPGRAM_FLUX = :"deepgram/flux"
+          DEEPGRAM_NOVA_3 = :"deepgram/nova-3"
+          DEEPGRAM_NOVA_2 = :"deepgram/nova-2"
+          ASSEMBLYAI_UNIVERSAL_3_6_PRO = :"assemblyai/universal-3-6-pro"
+          ASSEMBLYAI_UNIVERSAL_3_5_PRO = :"assemblyai/universal-3-5-pro"
+          ASSEMBLYAI_UNIVERSAL_STREAMING = :"assemblyai/universal-streaming"
+          XAI_GROK_STT = :"xai/grok-stt"
+          SONIOX_STT_RT_V4 = :"soniox/stt-rt-v4"
+          SONIOX_STT_RT_V5 = :"soniox/stt-rt-v5"
+          HUMAIN_REALTIME = :"humain/realtime"
+          RESON8_TURNS = :"reson8/turns"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end