telnyx 5.122.0 → 5.124.0

data/rbi/telnyx/models/speech_to_text_list_providers_response.rbi

@@ -62,11 +62,6 @@ module Telnyx
             )
           end
 
-        # Languages this (provider, model) accepts, in the provider's native code format.
-        # `auto` indicates the provider performs language detection.
-        sig { returns(T::Array[String]) }
-        attr_accessor :languages
-
         # Provider-scoped model name.
         sig { returns(String) }
         attr_accessor :model
@@ -75,37 +70,38 @@ module Telnyx
         sig { returns(String) }
         attr_accessor :provider
 
-        # Service surfaces this (provider, model) supports.
+        # Service surfaces this (provider, model) supports. When the request filters by
+        # `service_type`, only the matching nested entry is returned for each matching
+        # model.
         sig do
           returns(
             T::Array[
-              Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::TaggedSymbol
+              Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType
             ]
           )
         end
         attr_accessor :service_types
 
-        # A (provider, model) tuple along with its supported service types and languages.
+        # A (provider, model) tuple along with the service surfaces it supports. Each
+        # entry in `service_types` describes one surface and the languages accepted on it.
         sig do
           params(
-            languages: T::Array[String],
             model: String,
             provider: String,
             service_types:
               T::Array[
-                Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::OrSymbol
+                Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::OrHash
               ]
           ).returns(T.attached_class)
         end
         def self.new(
-          # Languages this (provider, model) accepts, in the provider's native code format.
-          # `auto` indicates the provider performs language detection.
-          languages:,
           # Provider-scoped model name.
           model:,
           # STT provider name.
           provider:,
-          # Service surfaces this (provider, model) supports.
+          # Service surfaces this (provider, model) supports. When the request filters by
+          # `service_type`, only the matching nested entry is returned for each matching
+          # model.
           service_types:
         )
         end
@@ -113,12 +109,11 @@ module Telnyx
         sig do
           override.returns(
             {
-              languages: T::Array[String],
               model: String,
               provider: String,
               service_types:
                 T::Array[
-                  Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::TaggedSymbol
+                  Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType
                 ]
             }
           )
@@ -126,43 +121,112 @@ module Telnyx
         def to_hash
         end
 
-        # Service surface a model is available on.
-        module ServiceType
-          extend Telnyx::Internal::Type::Enum
-
-          TaggedSymbol =
+        class ServiceType < Telnyx::Internal::Type::BaseModel
+          OrHash =
             T.type_alias do
-              T.all(
-                Symbol,
-                Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType
+              T.any(
+                Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType,
+                Telnyx::Internal::AnyHash
               )
             end
-          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
-          STREAMING =
-            T.let(
-              :streaming,
-              Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::TaggedSymbol
-            )
-          FILE_TRANSCRIPTION =
-            T.let(
-              :file_transcription,
-              Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::TaggedSymbol
-            )
-          IN_CALL_TRANSCRIPTION =
-            T.let(
-              :in_call_transcription,
-              Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::TaggedSymbol
+          # Languages accepted on this service surface, in the provider's native code
+          # format. `auto` indicates the provider performs language detection.
+          sig { returns(T::Array[String]) }
+          attr_accessor :languages
+
+          # Service surface a model is available on. `ai_assistant` is the STT surface
+          # configured via Call Control voice-assistant transcription; it covers both
+          # live-streaming and non-streaming/batch models (matching the
+          # `TranscriptionConfig.model` enum on `call-control` voice assistants).
+          sig do
+            returns(
+              Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::Type::TaggedSymbol
             )
+          end
+          attr_accessor :type
+
+          # A supported service surface for a given (provider, model), along with the
+          # language codes accepted on that surface. Language support can differ per surface
+          # — for example, a model may accept a narrower language set for streaming than for
+          # file transcription.
+          sig do
+            params(
+              languages: T::Array[String],
+              type:
+                Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::Type::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Languages accepted on this service surface, in the provider's native code
+            # format. `auto` indicates the provider performs language detection.
+            languages:,
+            # Service surface a model is available on. `ai_assistant` is the STT surface
+            # configured via Call Control voice-assistant transcription; it covers both
+            # live-streaming and non-streaming/batch models (matching the
+            # `TranscriptionConfig.model` enum on `call-control` voice assistants).
+            type:
+          )
+          end
 
           sig do
             override.returns(
-              T::Array[
-                Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::TaggedSymbol
-              ]
+              {
+                languages: T::Array[String],
+                type:
+                  Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::Type::TaggedSymbol
+              }
             )
           end
-          def self.values
+          def to_hash
+          end
+
+          # Service surface a model is available on. `ai_assistant` is the STT surface
+          # configured via Call Control voice-assistant transcription; it covers both
+          # live-streaming and non-streaming/batch models (matching the
+          # `TranscriptionConfig.model` enum on `call-control` voice assistants).
+          module Type
+            extend Telnyx::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::Type
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            STREAMING =
+              T.let(
+                :streaming,
+                Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::Type::TaggedSymbol
+              )
+            FILE_BASED =
+              T.let(
+                :file_based,
+                Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::Type::TaggedSymbol
+              )
+            IN_CALL =
+              T.let(
+                :in_call,
+                Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::Type::TaggedSymbol
+              )
+            AI_ASSISTANT =
+              T.let(
+                :ai_assistant,
+                Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::Type::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::Models::SpeechToTextListProvidersResponse::Data::ServiceType::Type::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
           end
         end
       end

data/rbi/telnyx/models.rbi

@@ -46,7 +46,8 @@ module Telnyx
 
   AI = Telnyx::Models::AI
 
-  AICreateResponseParams = Telnyx::Models::AICreateResponseParams
+  AICreateResponseDeprecatedParams =
+    Telnyx::Models::AICreateResponseDeprecatedParams
 
   AIRetrieveModelsParams = Telnyx::Models::AIRetrieveModelsParams
 
@@ -1682,6 +1683,9 @@ module Telnyx
 
   SiprecConnectorUpdateParams = Telnyx::Models::SiprecConnectorUpdateParams
 
+  SipRegistrationStatusRetrieveParams =
+    Telnyx::Models::SipRegistrationStatusRetrieveParams
+
   SoundModifications = Telnyx::Models::SoundModifications
 
   SpeechToTextListProvidersParams =

data/rbi/telnyx/resources/ai/assistants/versions.rbi

@@ -32,6 +32,8 @@ module Telnyx
             params(
               version_id: String,
               assistant_id: String,
+              conversation_flow:
+                Telnyx::AI::Assistants::UpdateAssistant::ConversationFlow::OrHash,
               description: String,
               dynamic_variables: T::Hash[Symbol, T.anything],
               dynamic_variables_webhook_timeout_ms: Integer,
@@ -84,6 +86,12 @@ module Telnyx
             version_id,
             # Path param
             assistant_id:,
+            # Body param: Conversation flow as supplied by API clients (create / update).
+            #
+            # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
+            # unique node/edge IDs, that `start_node_id` references a real node, and that
+            # every edge's endpoints reference real nodes.
+            conversation_flow: nil,
             # Body param
             description: nil,
             # Body param: Map of dynamic variables and their default values

data/rbi/telnyx/resources/ai/assistants.rbi

@@ -34,6 +34,8 @@ module Telnyx
           params(
             instructions: String,
             name: String,
+            conversation_flow:
+              Telnyx::AI::AssistantCreateParams::ConversationFlow::OrHash,
             description: String,
             dynamic_variables: T::Hash[Symbol, T.anything],
             dynamic_variables_webhook_timeout_ms: Integer,
@@ -83,6 +85,12 @@ module Telnyx
           # [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
           instructions:,
           name:,
+          # Conversation flow as supplied by API clients (create / update).
+          #
+          # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
+          # unique node/edge IDs, that `start_node_id` references a real node, and that
+          # every edge's endpoints reference real nodes.
+          conversation_flow: nil,
           description: nil,
           # Map of dynamic variables and their default values
           dynamic_variables: nil,
@@ -193,6 +201,8 @@ module Telnyx
         sig do
           params(
             assistant_id: String,
+            conversation_flow:
+              Telnyx::AI::AssistantUpdateParams::ConversationFlow::OrHash,
             description: String,
             dynamic_variables: T::Hash[Symbol, T.anything],
             dynamic_variables_webhook_timeout_ms: Integer,
@@ -243,6 +253,12 @@ module Telnyx
         end
         def update(
           assistant_id,
+          # Conversation flow as supplied by API clients (create / update).
+          #
+          # A directed graph of `FlowNodeReq` connected by `FlowEdge`s. Validation enforces
+          # unique node/edge IDs, that `start_node_id` references a real node, and that
+          # every edge's endpoints reference real nodes.
+          conversation_flow: nil,
           description: nil,
           # Map of dynamic variables and their default values
           dynamic_variables: nil,

data/rbi/telnyx/resources/ai.rbi

@@ -58,7 +58,7 @@ module Telnyx
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(T::Hash[Symbol, T.anything])
       end
-      def create_response(body:, request_options: {})
+      def create_response_deprecated(body:, request_options: {})
       end
 
       # **Deprecated**: Use `GET /v2/ai/openai/models` instead.

data/rbi/telnyx/resources/messaging_profiles.rbi

@@ -113,6 +113,7 @@ module Telnyx
       sig do
         params(
           messaging_profile_id: String,
+          ai_assistant_id: T.nilable(String),
           alpha_sender: T.nilable(String),
           daily_spend_limit: String,
           daily_spend_limit_enabled: T::Boolean,
@@ -137,6 +138,8 @@ module Telnyx
       def update(
         # The id of the messaging profile to retrieve
         messaging_profile_id,
+        # The ID of the AI assistant associated with this messaging profile.
+        ai_assistant_id: nil,
         # The alphanumeric sender ID to use when sending to destinations that require an
         # alphanumeric sender ID.
         alpha_sender: nil,

data/rbi/telnyx/resources/sip_registration_status.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    # UAC connection operations
+    class SipRegistrationStatus
+      # Returns the live SIP registration state of a UAC connection: whether it is
+      # currently registered, when it last registered, and the last response Telnyx
+      # received from the registrar. Only `uac_external_credential` is supported today.
+      sig do
+        params(
+          connection_id: String,
+          credential_type:
+            Telnyx::SipRegistrationStatusRetrieveParams::CredentialType::OrSymbol,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(Telnyx::Models::SipRegistrationStatusRetrieveResponse)
+      end
+      def retrieve(
+        # Identifier of the UAC connection to look up.
+        connection_id:,
+        # The kind of credential to look up. Only `uac_external_credential` is supported
+        # today.
+        credential_type:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Telnyx::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/speech_to_text.rbi

@@ -11,10 +11,11 @@ module Telnyx
       #
       # - `streaming` — standalone WebSocket transcription via
       #   `/speech-to-text/transcription`.
-      # - `file_transcription` — file-based transcription via
-      #   `/ai/audio/transcriptions`.
-      # - `in_call_transcription` — live call transcription via Call Control
-      #   `transcription_start`.
+      # - `file_based` — file-based transcription via `/ai/audio/transcriptions`.
+      # - `in_call` — live call transcription via Call Control `transcription_start`.
+      # - `ai_assistant` — STT configured on a Call Control AI Assistant via
+      #   voice-assistant `TranscriptionConfig` (covers both live-streaming and
+      #   non-streaming/batch models).
       #
       # Use this endpoint to discover which (provider, model) combinations are available
       # for the surface you need, and which language codes each accepts. `auto` in a
@@ -34,7 +35,12 @@ module Telnyx
         # models currently registered for any service type will return an empty `data`
         # array rather than an error.
         provider: nil,
-        # Filter to entries that support the given service type.
+        # Filter to entries that support the given service type. For backward
+        # compatibility with the values that briefly shipped before the product-aligned
+        # rename, the legacy aliases `file_transcription`, `in_call_transcription`, and
+        # `ai_assistant_transcription` are silently accepted and normalized to
+        # `file_based`, `in_call`, and `ai_assistant` respectively. The response always
+        # emits the canonical (post-rename) values.
         service_type: nil,
         request_options: {}
       )

data/sig/telnyx/client.rbs

@@ -344,6 +344,8 @@ module Telnyx
 
     attr_reader uac_connections: Telnyx::Resources::UacConnections
 
+    attr_reader sip_registration_status: Telnyx::Resources::SipRegistrationStatus
+
     attr_reader speech_to_text: Telnyx::Resources::SpeechToText
 
     attr_reader voice_sdk_call_reports: Telnyx::Resources::VoiceSDKCallReports