telnyx 5.87.0 → 5.89.0

data/rbi/telnyx/models/ai/inference_embedding.rbi

@@ -66,6 +66,29 @@ module Telnyx
         end
         attr_writer :enabled_features
 
+        sig { returns(T.nilable(Telnyx::AI::InferenceEmbedding::ExternalLlm)) }
+        attr_reader :external_llm
+
+        sig do
+          params(
+            external_llm: Telnyx::AI::InferenceEmbedding::ExternalLlm::OrHash
+          ).void
+        end
+        attr_writer :external_llm
+
+        sig do
+          returns(T.nilable(Telnyx::AI::InferenceEmbedding::FallbackConfig))
+        end
+        attr_reader :fallback_config
+
+        sig do
+          params(
+            fallback_config:
+              Telnyx::AI::InferenceEmbedding::FallbackConfig::OrHash
+          ).void
+        end
+        attr_writer :fallback_config
+
         # Text that the assistant will use to start the conversation. This may be
         # templated with
         # [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables).
@@ -216,6 +239,9 @@ module Telnyx
             dynamic_variables: T::Hash[Symbol, T.anything],
             dynamic_variables_webhook_url: String,
             enabled_features: T::Array[Telnyx::AI::EnabledFeatures::OrSymbol],
+            external_llm: Telnyx::AI::InferenceEmbedding::ExternalLlm::OrHash,
+            fallback_config:
+              Telnyx::AI::InferenceEmbedding::FallbackConfig::OrHash,
             greeting: String,
             import_metadata: Telnyx::AI::ImportMetadata::OrHash,
             insight_settings: Telnyx::AI::InsightSettings::OrHash,
@@ -266,6 +292,8 @@ module Telnyx
           # for more information.
           dynamic_variables_webhook_url: nil,
           enabled_features: nil,
+          external_llm: nil,
+          fallback_config: nil,
           # Text that the assistant will use to start the conversation. This may be
           # templated with
           # [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables).
@@ -315,6 +343,8 @@ module Telnyx
               dynamic_variables_webhook_url: String,
               enabled_features:
                 T::Array[Telnyx::AI::EnabledFeatures::TaggedSymbol],
+              external_llm: Telnyx::AI::InferenceEmbedding::ExternalLlm,
+              fallback_config: Telnyx::AI::InferenceEmbedding::FallbackConfig,
               greeting: String,
               import_metadata: Telnyx::AI::ImportMetadata,
               insight_settings: Telnyx::AI::InsightSettings,
@@ -335,6 +365,391 @@ module Telnyx
         def to_hash
         end
 
+        class ExternalLlm < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::AI::InferenceEmbedding::ExternalLlm,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # Base URL for the external LLM endpoint.
+          sig { returns(String) }
+          attr_accessor :base_url
+
+          # Model identifier to use with the external LLM endpoint.
+          sig { returns(String) }
+          attr_accessor :model
+
+          # Authentication method used when connecting to the external LLM endpoint.
+          sig do
+            returns(
+              T.nilable(
+                Telnyx::AI::InferenceEmbedding::ExternalLlm::AuthenticationMethod::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :authentication_method
+
+          sig do
+            params(
+              authentication_method:
+                Telnyx::AI::InferenceEmbedding::ExternalLlm::AuthenticationMethod::OrSymbol
+            ).void
+          end
+          attr_writer :authentication_method
+
+          # Integration secret identifier for the client certificate used with certificate
+          # authentication.
+          sig { returns(T.nilable(String)) }
+          attr_reader :certificate_ref
+
+          sig { params(certificate_ref: String).void }
+          attr_writer :certificate_ref
+
+          # When enabled, Telnyx forwards the assistant's dynamic variables to the external
+          # LLM endpoint. Defaults to false. The chat completion request includes a
+          # top-level `extra_metadata` object when dynamic variables are available. For
+          # example:
+          # `{"extra_metadata":{"customer_name":"Jane","account_id":"acct_789","telnyx_agent_target":"+13125550100","telnyx_end_user_target":"+13125550123"}}`.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :forward_metadata
+
+          sig { params(forward_metadata: T::Boolean).void }
+          attr_writer :forward_metadata
+
+          # Integration secret identifier for the external LLM API key.
+          sig { returns(T.nilable(String)) }
+          attr_reader :llm_api_key_ref
+
+          sig { params(llm_api_key_ref: String).void }
+          attr_writer :llm_api_key_ref
+
+          # URL used to retrieve an access token when certificate authentication is enabled.
+          sig { returns(T.nilable(String)) }
+          attr_reader :token_retrieval_url
+
+          sig { params(token_retrieval_url: String).void }
+          attr_writer :token_retrieval_url
+
+          sig do
+            params(
+              base_url: String,
+              model: String,
+              authentication_method:
+                Telnyx::AI::InferenceEmbedding::ExternalLlm::AuthenticationMethod::OrSymbol,
+              certificate_ref: String,
+              forward_metadata: T::Boolean,
+              llm_api_key_ref: String,
+              token_retrieval_url: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Base URL for the external LLM endpoint.
+            base_url:,
+            # Model identifier to use with the external LLM endpoint.
+            model:,
+            # Authentication method used when connecting to the external LLM endpoint.
+            authentication_method: nil,
+            # Integration secret identifier for the client certificate used with certificate
+            # authentication.
+            certificate_ref: nil,
+            # When enabled, Telnyx forwards the assistant's dynamic variables to the external
+            # LLM endpoint. Defaults to false. The chat completion request includes a
+            # top-level `extra_metadata` object when dynamic variables are available. For
+            # example:
+            # `{"extra_metadata":{"customer_name":"Jane","account_id":"acct_789","telnyx_agent_target":"+13125550100","telnyx_end_user_target":"+13125550123"}}`.
+            forward_metadata: nil,
+            # Integration secret identifier for the external LLM API key.
+            llm_api_key_ref: nil,
+            # URL used to retrieve an access token when certificate authentication is enabled.
+            token_retrieval_url: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                base_url: String,
+                model: String,
+                authentication_method:
+                  Telnyx::AI::InferenceEmbedding::ExternalLlm::AuthenticationMethod::TaggedSymbol,
+                certificate_ref: String,
+                forward_metadata: T::Boolean,
+                llm_api_key_ref: String,
+                token_retrieval_url: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # Authentication method used when connecting to the external LLM endpoint.
+          module AuthenticationMethod
+            extend Telnyx::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Telnyx::AI::InferenceEmbedding::ExternalLlm::AuthenticationMethod
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            TOKEN =
+              T.let(
+                :token,
+                Telnyx::AI::InferenceEmbedding::ExternalLlm::AuthenticationMethod::TaggedSymbol
+              )
+            CERTIFICATE =
+              T.let(
+                :certificate,
+                Telnyx::AI::InferenceEmbedding::ExternalLlm::AuthenticationMethod::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::AI::InferenceEmbedding::ExternalLlm::AuthenticationMethod::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
+
+        class FallbackConfig < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::AI::InferenceEmbedding::FallbackConfig,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          sig do
+            returns(
+              T.nilable(
+                Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm
+              )
+            )
+          end
+          attr_reader :external_llm
+
+          sig do
+            params(
+              external_llm:
+                Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm::OrHash
+            ).void
+          end
+          attr_writer :external_llm
+
+          # Integration secret identifier for the fallback model API key.
+          sig { returns(T.nilable(String)) }
+          attr_reader :llm_api_key_ref
+
+          sig { params(llm_api_key_ref: String).void }
+          attr_writer :llm_api_key_ref
+
+          # Fallback Telnyx-hosted model to use when the primary LLM provider is
+          # unavailable.
+          sig { returns(T.nilable(String)) }
+          attr_reader :model
+
+          sig { params(model: String).void }
+          attr_writer :model
+
+          sig do
+            params(
+              external_llm:
+                Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm::OrHash,
+              llm_api_key_ref: String,
+              model: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            external_llm: nil,
+            # Integration secret identifier for the fallback model API key.
+            llm_api_key_ref: nil,
+            # Fallback Telnyx-hosted model to use when the primary LLM provider is
+            # unavailable.
+            model: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                external_llm:
+                  Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm,
+                llm_api_key_ref: String,
+                model: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          class ExternalLlm < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            # Base URL for the external LLM endpoint.
+            sig { returns(String) }
+            attr_accessor :base_url
+
+            # Model identifier to use with the external LLM endpoint.
+            sig { returns(String) }
+            attr_accessor :model
+
+            # Authentication method used when connecting to the external LLM endpoint.
+            sig do
+              returns(
+                T.nilable(
+                  Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm::AuthenticationMethod::TaggedSymbol
+                )
+              )
+            end
+            attr_reader :authentication_method
+
+            sig do
+              params(
+                authentication_method:
+                  Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm::AuthenticationMethod::OrSymbol
+              ).void
+            end
+            attr_writer :authentication_method
+
+            # Integration secret identifier for the client certificate used with certificate
+            # authentication.
+            sig { returns(T.nilable(String)) }
+            attr_reader :certificate_ref
+
+            sig { params(certificate_ref: String).void }
+            attr_writer :certificate_ref
+
+            # When enabled, Telnyx forwards the assistant's dynamic variables to the external
+            # LLM endpoint. Defaults to false. The chat completion request includes a
+            # top-level `extra_metadata` object when dynamic variables are available. For
+            # example:
+            # `{"extra_metadata":{"customer_name":"Jane","account_id":"acct_789","telnyx_agent_target":"+13125550100","telnyx_end_user_target":"+13125550123"}}`.
+            sig { returns(T.nilable(T::Boolean)) }
+            attr_reader :forward_metadata
+
+            sig { params(forward_metadata: T::Boolean).void }
+            attr_writer :forward_metadata
+
+            # Integration secret identifier for the external LLM API key.
+            sig { returns(T.nilable(String)) }
+            attr_reader :llm_api_key_ref
+
+            sig { params(llm_api_key_ref: String).void }
+            attr_writer :llm_api_key_ref
+
+            # URL used to retrieve an access token when certificate authentication is enabled.
+            sig { returns(T.nilable(String)) }
+            attr_reader :token_retrieval_url
+
+            sig { params(token_retrieval_url: String).void }
+            attr_writer :token_retrieval_url
+
+            sig do
+              params(
+                base_url: String,
+                model: String,
+                authentication_method:
+                  Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm::AuthenticationMethod::OrSymbol,
+                certificate_ref: String,
+                forward_metadata: T::Boolean,
+                llm_api_key_ref: String,
+                token_retrieval_url: String
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              # Base URL for the external LLM endpoint.
+              base_url:,
+              # Model identifier to use with the external LLM endpoint.
+              model:,
+              # Authentication method used when connecting to the external LLM endpoint.
+              authentication_method: nil,
+              # Integration secret identifier for the client certificate used with certificate
+              # authentication.
+              certificate_ref: nil,
+              # When enabled, Telnyx forwards the assistant's dynamic variables to the external
+              # LLM endpoint. Defaults to false. The chat completion request includes a
+              # top-level `extra_metadata` object when dynamic variables are available. For
+              # example:
+              # `{"extra_metadata":{"customer_name":"Jane","account_id":"acct_789","telnyx_agent_target":"+13125550100","telnyx_end_user_target":"+13125550123"}}`.
+              forward_metadata: nil,
+              # Integration secret identifier for the external LLM API key.
+              llm_api_key_ref: nil,
+              # URL used to retrieve an access token when certificate authentication is enabled.
+              token_retrieval_url: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  base_url: String,
+                  model: String,
+                  authentication_method:
+                    Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm::AuthenticationMethod::TaggedSymbol,
+                  certificate_ref: String,
+                  forward_metadata: T::Boolean,
+                  llm_api_key_ref: String,
+                  token_retrieval_url: String
+                }
+              )
+            end
+            def to_hash
+            end
+
+            # Authentication method used when connecting to the external LLM endpoint.
+            module AuthenticationMethod
+              extend Telnyx::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm::AuthenticationMethod
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              TOKEN =
+                T.let(
+                  :token,
+                  Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm::AuthenticationMethod::TaggedSymbol
+                )
+              CERTIFICATE =
+                T.let(
+                  :certificate,
+                  Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm::AuthenticationMethod::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Telnyx::AI::InferenceEmbedding::FallbackConfig::ExternalLlm::AuthenticationMethod::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
+        end
+
         class PostConversationSettings < Telnyx::Internal::Type::BaseModel
           OrHash =
             T.type_alias do

data/rbi/telnyx/models/ai/transcription_settings.rbi

@@ -18,7 +18,10 @@ module Telnyx
         attr_writer :api_key_ref
 
         # The language of the audio to be transcribed. If not set, or if set to `auto`,
-        # the model will automatically detect the language.
+        # supported models will automatically detect the language. For `deepgram/flux`,
+        # supported values are: `auto` (Telnyx language detection controls the language
+        # hint), `multi` (no language hint), and language-specific hints `en`, `es`, `fr`,
+        # `de`, `hi`, `ru`, `pt`, `ja`, `it`, and `nl`.
         sig { returns(T.nilable(String)) }
         attr_reader :language
 
@@ -28,7 +31,7 @@ module Telnyx
         # The speech to text model to be used by the voice assistant. All Deepgram models
         # are run on-premise.
         #
-        # - `deepgram/flux` is optimized for turn-taking but is English-only.
+        # - `deepgram/flux` is optimized for turn-taking with multilingual language hints.
         # - `deepgram/nova-3` is multilingual with automatic language detection.
         # - `deepgram/nova-2` is Deepgram's previous-generation multilingual model.
         # - `azure/fast` is a multilingual Azure transcription model.
@@ -75,12 +78,15 @@ module Telnyx
           # used for Azure transcription regions that require a customer-provided API key.
           api_key_ref: nil,
           # The language of the audio to be transcribed. If not set, or if set to `auto`,
-          # the model will automatically detect the language.
+          # supported models will automatically detect the language. For `deepgram/flux`,
+          # supported values are: `auto` (Telnyx language detection controls the language
+          # hint), `multi` (no language hint), and language-specific hints `en`, `es`, `fr`,
+          # `de`, `hi`, `ru`, `pt`, `ja`, `it`, and `nl`.
           language: nil,
           # The speech to text model to be used by the voice assistant. All Deepgram models
           # are run on-premise.
           #
-          # - `deepgram/flux` is optimized for turn-taking but is English-only.
+          # - `deepgram/flux` is optimized for turn-taking with multilingual language hints.
           # - `deepgram/nova-3` is multilingual with automatic language detection.
           # - `deepgram/nova-2` is Deepgram's previous-generation multilingual model.
           # - `azure/fast` is a multilingual Azure transcription model.
@@ -112,7 +118,7 @@ module Telnyx
         # The speech to text model to be used by the voice assistant. All Deepgram models
         # are run on-premise.
         #
-        # - `deepgram/flux` is optimized for turn-taking but is English-only.
+        # - `deepgram/flux` is optimized for turn-taking with multilingual language hints.
         # - `deepgram/nova-3` is multilingual with automatic language detection.
         # - `deepgram/nova-2` is Deepgram's previous-generation multilingual model.
         # - `azure/fast` is a multilingual Azure transcription model.