telnyx 5.171.0 → 5.174.0

data/rbi/telnyx/models/ai/tests/test_framework/v1_retrieve_personalities_params.rbi

@@ -0,0 +1,38 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      module Tests
+        module TestFramework
+          class V1RetrievePersonalitiesParams < Telnyx::Internal::Type::BaseModel
+            extend Telnyx::Internal::Type::RequestParameters::Converter
+            include Telnyx::Internal::Type::RequestParameters
+
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::Tests::TestFramework::V1RetrievePersonalitiesParams,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            sig do
+              params(request_options: Telnyx::RequestOptions::OrHash).returns(
+                T.attached_class
+              )
+            end
+            def self.new(request_options: {})
+            end
+
+            sig do
+              override.returns({ request_options: Telnyx::RequestOptions })
+            end
+            def to_hash
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/tests/test_framework/v1_retrieve_personalities_response.rbi

@@ -0,0 +1,237 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      module Tests
+        module TestFramework
+          class V1RetrievePersonalitiesResponseItem < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            sig { returns(Integer) }
+            attr_accessor :id
+
+            sig { returns(T::Boolean) }
+            attr_accessor :end_call_enabled
+
+            # ISO language code the simulated caller speaks.
+            sig { returns(String) }
+            attr_accessor :language
+
+            # Display name of the personality.
+            sig { returns(String) }
+            attr_accessor :name
+
+            # Instructions the simulated caller follows.
+            sig { returns(String) }
+            attr_accessor :prompt
+
+            sig { returns(T.nilable(String)) }
+            attr_reader :accent
+
+            sig { params(accent: String).void }
+            attr_writer :accent
+
+            sig { returns(T.nilable(String)) }
+            attr_accessor :background_noise
+
+            sig { returns(T.nilable(Float)) }
+            attr_accessor :background_sound_volume
+
+            sig { returns(T.nilable(Float)) }
+            attr_accessor :effective_voice_volume
+
+            # ID of the personality this one was forked from.
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :forked_from
+
+            sig { returns(T.nilable(T.anything)) }
+            attr_accessor :generation_config
+
+            # How aggressively the personality interrupts the assistant.
+            sig { returns(T.nilable(String)) }
+            attr_accessor :interruption_level
+
+            # Idle-timeout plan for messages during a call.
+            sig { returns(T.nilable(T.anything)) }
+            attr_accessor :message_plan
+
+            sig { returns(T.nilable(T.anything)) }
+            attr_accessor :network_simulation
+
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :organization
+
+            sig { returns(T.nilable(Integer)) }
+            attr_accessor :project
+
+            sig do
+              returns(
+                T.nilable(
+                  Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem::Speed::Variants
+                )
+              )
+            end
+            attr_accessor :speed
+
+            sig do
+              returns(
+                T.nilable(
+                  Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem::StartSpeakingPlan::Variants
+                )
+              )
+            end
+            attr_accessor :start_speaking_plan
+
+            sig { returns(T.nilable(T.anything)) }
+            attr_accessor :stop_speaking_plan
+
+            sig { returns(T.nilable(Float)) }
+            attr_accessor :voice_volume
+
+            sig do
+              params(
+                id: Integer,
+                end_call_enabled: T::Boolean,
+                language: String,
+                name: String,
+                prompt: String,
+                accent: String,
+                background_noise: T.nilable(String),
+                background_sound_volume: T.nilable(Float),
+                effective_voice_volume: T.nilable(Float),
+                forked_from: T.nilable(Integer),
+                generation_config: T.nilable(T.anything),
+                interruption_level: T.nilable(String),
+                message_plan: T.nilable(T.anything),
+                network_simulation: T.nilable(T.anything),
+                organization: T.nilable(Integer),
+                project: T.nilable(Integer),
+                speed:
+                  T.nilable(
+                    Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem::Speed::Variants
+                  ),
+                start_speaking_plan:
+                  T.nilable(
+                    Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem::StartSpeakingPlan::Variants
+                  ),
+                stop_speaking_plan: T.nilable(T.anything),
+                voice_volume: T.nilable(Float)
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              id:,
+              end_call_enabled:,
+              # ISO language code the simulated caller speaks.
+              language:,
+              # Display name of the personality.
+              name:,
+              # Instructions the simulated caller follows.
+              prompt:,
+              accent: nil,
+              background_noise: nil,
+              background_sound_volume: nil,
+              effective_voice_volume: nil,
+              # ID of the personality this one was forked from.
+              forked_from: nil,
+              generation_config: nil,
+              # How aggressively the personality interrupts the assistant.
+              interruption_level: nil,
+              # Idle-timeout plan for messages during a call.
+              message_plan: nil,
+              network_simulation: nil,
+              organization: nil,
+              project: nil,
+              speed: nil,
+              start_speaking_plan: nil,
+              stop_speaking_plan: nil,
+              voice_volume: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  id: Integer,
+                  end_call_enabled: T::Boolean,
+                  language: String,
+                  name: String,
+                  prompt: String,
+                  accent: String,
+                  background_noise: T.nilable(String),
+                  background_sound_volume: T.nilable(Float),
+                  effective_voice_volume: T.nilable(Float),
+                  forked_from: T.nilable(Integer),
+                  generation_config: T.nilable(T.anything),
+                  interruption_level: T.nilable(String),
+                  message_plan: T.nilable(T.anything),
+                  network_simulation: T.nilable(T.anything),
+                  organization: T.nilable(Integer),
+                  project: T.nilable(Integer),
+                  speed:
+                    T.nilable(
+                      Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem::Speed::Variants
+                    ),
+                  start_speaking_plan:
+                    T.nilable(
+                      Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem::StartSpeakingPlan::Variants
+                    ),
+                  stop_speaking_plan: T.nilable(T.anything),
+                  voice_volume: T.nilable(Float)
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module Speed
+              extend Telnyx::Internal::Type::Union
+
+              Variants = T.type_alias { T.any(Float, String) }
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem::Speed::Variants
+                  ]
+                )
+              end
+              def self.variants
+              end
+            end
+
+            module StartSpeakingPlan
+              extend Telnyx::Internal::Type::Union
+
+              Variants = T.type_alias { T.any(Float, T.anything) }
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem::StartSpeakingPlan::Variants
+                  ]
+                )
+              end
+              def self.variants
+              end
+            end
+          end
+
+          V1RetrievePersonalitiesResponse =
+            T.let(
+              Telnyx::Internal::Type::ArrayOf[
+                Telnyx::Models::AI::Tests::TestFramework::V1RetrievePersonalitiesResponseItem
+              ],
+              Telnyx::Internal::Type::Converter
+            )
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/tool_create_params.rbi

@@ -72,6 +72,12 @@ module Telnyx
         end
         attr_writer :update_dynamic_variables
 
+        sig { returns(T.nilable(Telnyx::AI::VisionToolParams)) }
+        attr_reader :vision
+
+        sig { params(vision: Telnyx::AI::VisionToolParams::OrHash).void }
+        attr_writer :vision
+
         sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
         attr_reader :webhook
 
@@ -97,6 +103,7 @@ module Telnyx
             timeout_ms: Integer,
             update_dynamic_variables:
               Telnyx::AI::UpdateDynamicVariablesToolParams::OrHash,
+            vision: Telnyx::AI::VisionToolParams::OrHash,
             webhook: T::Hash[Symbol, T.anything],
             idempotency_key: String,
             request_options: Telnyx::RequestOptions::OrHash
@@ -114,6 +121,7 @@ module Telnyx
           timeout_ms: nil,
           # Configuration for an update_dynamic_variables tool.
           update_dynamic_variables: nil,
+          vision: nil,
           webhook: nil,
           idempotency_key: nil,
           request_options: {}
@@ -134,6 +142,7 @@ module Telnyx
               timeout_ms: Integer,
               update_dynamic_variables:
                 Telnyx::AI::UpdateDynamicVariablesToolParams,
+              vision: Telnyx::AI::VisionToolParams,
               webhook: T::Hash[Symbol, T.anything],
               idempotency_key: String,
               request_options: Telnyx::RequestOptions

data/rbi/telnyx/models/ai/tool_node.rbi

@@ -76,6 +76,7 @@ module Telnyx
                   Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                   Telnyx::AI::AssistantTool::SendMessage::OrHash,
                   Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                  Telnyx::AI::AssistantTool::Vision::OrHash,
                   Telnyx::AI::AssistantTool::Pay::OrHash,
                   Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                 )
@@ -114,6 +115,7 @@ module Telnyx
                   Telnyx::AI::AssistantTool::SendDtmf::OrHash,
                   Telnyx::AI::AssistantTool::SendMessage::OrHash,
                   Telnyx::AI::AssistantTool::SkipTurn::OrHash,
+                  Telnyx::AI::AssistantTool::Vision::OrHash,
                   Telnyx::AI::AssistantTool::Pay::OrHash,
                   Telnyx::AI::AssistantTool::UpdateDynamicVariables::OrHash
                 )

data/rbi/telnyx/models/ai/tool_update_params.rbi

@@ -81,6 +81,12 @@ module Telnyx
         end
         attr_writer :update_dynamic_variables
 
+        sig { returns(T.nilable(Telnyx::AI::VisionToolParams)) }
+        attr_reader :vision
+
+        sig { params(vision: Telnyx::AI::VisionToolParams::OrHash).void }
+        attr_writer :vision
+
         sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
         attr_reader :webhook
 
@@ -101,6 +107,7 @@ module Telnyx
             type: String,
             update_dynamic_variables:
               Telnyx::AI::UpdateDynamicVariablesToolParams::OrHash,
+            vision: Telnyx::AI::VisionToolParams::OrHash,
             webhook: T::Hash[Symbol, T.anything],
             request_options: Telnyx::RequestOptions::OrHash
           ).returns(T.attached_class)
@@ -118,6 +125,7 @@ module Telnyx
           type: nil,
           # Configuration for an update_dynamic_variables tool.
           update_dynamic_variables: nil,
+          vision: nil,
           webhook: nil,
           request_options: {}
         )
@@ -138,6 +146,7 @@ module Telnyx
               type: String,
               update_dynamic_variables:
                 Telnyx::AI::UpdateDynamicVariablesToolParams,
+              vision: Telnyx::AI::VisionToolParams,
               webhook: T::Hash[Symbol, T.anything],
               request_options: Telnyx::RequestOptions
             }

data/rbi/telnyx/models/ai/transcription_challenger.rbi

@@ -0,0 +1,318 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      class TranscriptionChallenger < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::AI::TranscriptionChallenger,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        # 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`.
+        sig { returns(Telnyx::AI::TranscriptionChallenger::Model::OrSymbol) }
+        attr_accessor :model
+
+        # 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`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :language
+
+        # 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`.
+        sig do
+          returns(
+            T.nilable(Telnyx::AI::TranscriptionChallenger::Rule::OrSymbol)
+          )
+        end
+        attr_reader :rule
+
+        sig do
+          params(rule: Telnyx::AI::TranscriptionChallenger::Rule::OrSymbol).void
+        end
+        attr_writer :rule
+
+        # 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.
+        sig { returns(T.nilable(Telnyx::AI::TranscriptionSettingsConfig)) }
+        attr_reader :settings
+
+        sig do
+          params(
+            settings: T.nilable(Telnyx::AI::TranscriptionSettingsConfig::OrHash)
+          ).void
+        end
+        attr_writer :settings
+
+        # A second speech-to-text model that transcribes alongside `transcription.model`,
+        # and the rule that decides which transcript the assistant uses.
+        sig do
+          params(
+            model: Telnyx::AI::TranscriptionChallenger::Model::OrSymbol,
+            language: T.nilable(String),
+            rule: Telnyx::AI::TranscriptionChallenger::Rule::OrSymbol,
+            settings: T.nilable(Telnyx::AI::TranscriptionSettingsConfig::OrHash)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # 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`.
+          model:,
+          # 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`.
+          language: nil,
+          # 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`.
+          rule: nil,
+          # 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.
+          settings: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              model: Telnyx::AI::TranscriptionChallenger::Model::OrSymbol,
+              language: T.nilable(String),
+              rule: Telnyx::AI::TranscriptionChallenger::Rule::OrSymbol,
+              settings: T.nilable(Telnyx::AI::TranscriptionSettingsConfig)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # 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`.
+        module Model
+          extend Telnyx::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Telnyx::AI::TranscriptionChallenger::Model)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          DEEPGRAM_FLUX =
+            T.let(
+              :"deepgram/flux",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          DEEPGRAM_NOVA_3 =
+            T.let(
+              :"deepgram/nova-3",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          DEEPGRAM_NOVA_2 =
+            T.let(
+              :"deepgram/nova-2",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          AZURE_FAST =
+            T.let(
+              :"azure/fast",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          ASSEMBLYAI_UNIVERSAL_3_6_PRO =
+            T.let(
+              :"assemblyai/universal-3-6-pro",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          ASSEMBLYAI_UNIVERSAL_3_5_PRO =
+            T.let(
+              :"assemblyai/universal-3-5-pro",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          ASSEMBLYAI_UNIVERSAL_STREAMING =
+            T.let(
+              :"assemblyai/universal-streaming",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          XAI_GROK_STT =
+            T.let(
+              :"xai/grok-stt",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          SONIOX_STT_RT_V4 =
+            T.let(
+              :"soniox/stt-rt-v4",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          SONIOX_STT_RT_V5 =
+            T.let(
+              :"soniox/stt-rt-v5",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          NVIDIA_PARAKEET_V3 =
+            T.let(
+              :"nvidia/parakeet-v3",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          OMI_HEALTH_OMI_MED_STT_V1 =
+            T.let(
+              :"omi-health/omi-med-stt-v1",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          HUMAIN_REALTIME =
+            T.let(
+              :"humain/realtime",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          RESON8_TURNS =
+            T.let(
+              :"reson8/turns",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          COHERE_AR_STT =
+            T.let(
+              :"cohere/ar-stt",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          TELNYX_BASIRA =
+            T.let(
+              :"telnyx/basira",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          DISTIL_WHISPER_DISTIL_LARGE_V2 =
+            T.let(
+              :"distil-whisper/distil-large-v2",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+          OPENAI_WHISPER_LARGE_V3_TURBO =
+            T.let(
+              :"openai/whisper-large-v3-turbo",
+              Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[Telnyx::AI::TranscriptionChallenger::Model::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        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`.
+        module Rule
+          extend Telnyx::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Telnyx::AI::TranscriptionChallenger::Rule)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          BEST_TURN =
+            T.let(
+              :best_turn,
+              Telnyx::AI::TranscriptionChallenger::Rule::TaggedSymbol
+            )
+          BEST_ENGINE =
+            T.let(
+              :best_engine,
+              Telnyx::AI::TranscriptionChallenger::Rule::TaggedSymbol
+            )
+          MERGE_WORDS =
+            T.let(
+              :merge_words,
+              Telnyx::AI::TranscriptionChallenger::Rule::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[Telnyx::AI::TranscriptionChallenger::Rule::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end