telnyx 5.68.2 → 5.69.0

data/rbi/telnyx/models/ai/assistant_update_params.rbi

@@ -112,6 +112,21 @@ module Telnyx
         sig { params(name: String).void }
         attr_writer :name
 
+        sig do
+          returns(
+            T.nilable(Telnyx::AI::AssistantUpdateParams::ObservabilitySettings)
+          )
+        end
+        attr_reader :observability_settings
+
+        sig do
+          params(
+            observability_settings:
+              Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::OrHash
+          ).void
+        end
+        attr_writer :observability_settings
+
         sig { returns(T.nilable(Telnyx::AI::PrivacySettings)) }
         attr_reader :privacy_settings
 
@@ -222,6 +237,8 @@ module Telnyx
             messaging_settings: Telnyx::AI::MessagingSettings::OrHash,
             model: String,
             name: String,
+            observability_settings:
+              Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::OrHash,
             privacy_settings: Telnyx::AI::PrivacySettings::OrHash,
             promote_to_main: T::Boolean,
             telephony_settings: Telnyx::AI::TelephonySettings::OrHash,
@@ -281,6 +298,7 @@ module Telnyx
           # to see all of your available models,
           model: nil,
           name: nil,
+          observability_settings: nil,
           privacy_settings: nil,
           # Indicates whether the assistant should be promoted to the main version. Defaults
           # to true.
@@ -313,6 +331,8 @@ module Telnyx
               messaging_settings: Telnyx::AI::MessagingSettings,
               model: String,
               name: String,
+              observability_settings:
+                Telnyx::AI::AssistantUpdateParams::ObservabilitySettings,
               privacy_settings: Telnyx::AI::PrivacySettings,
               promote_to_main: T::Boolean,
               telephony_settings: Telnyx::AI::TelephonySettings,
@@ -341,6 +361,116 @@ module Telnyx
         end
         def to_hash
         end
+
+        class ObservabilitySettings < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::AI::AssistantUpdateParams::ObservabilitySettings,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :host
+
+          sig { params(host: String).void }
+          attr_writer :host
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :public_key_ref
+
+          sig { params(public_key_ref: String).void }
+          attr_writer :public_key_ref
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :secret_key_ref
+
+          sig { params(secret_key_ref: String).void }
+          attr_writer :secret_key_ref
+
+          sig do
+            returns(
+              T.nilable(
+                Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::Status::OrSymbol
+              )
+            )
+          end
+          attr_reader :status
+
+          sig do
+            params(
+              status:
+                Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::Status::OrSymbol
+            ).void
+          end
+          attr_writer :status
+
+          sig do
+            params(
+              host: String,
+              public_key_ref: String,
+              secret_key_ref: String,
+              status:
+                Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::Status::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            host: nil,
+            public_key_ref: nil,
+            secret_key_ref: nil,
+            status: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                host: String,
+                public_key_ref: String,
+                secret_key_ref: String,
+                status:
+                  Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::Status::OrSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module Status
+            extend Telnyx::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ENABLED =
+              T.let(
+                :enabled,
+                Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::Status::TaggedSymbol
+              )
+            DISABLED =
+              T.let(
+                :disabled,
+                Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::AI::AssistantUpdateParams::ObservabilitySettings::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
       end
     end
   end

data/rbi/telnyx/models/ai/assistants/update_assistant.rbi

@@ -114,6 +114,23 @@ module Telnyx
           sig { params(name: String).void }
           attr_writer :name
 
+          sig do
+            returns(
+              T.nilable(
+                Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings
+              )
+            )
+          end
+          attr_reader :observability_settings
+
+          sig do
+            params(
+              observability_settings:
+                Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::OrHash
+            ).void
+          end
+          attr_writer :observability_settings
+
           sig { returns(T.nilable(Telnyx::AI::PrivacySettings)) }
           attr_reader :privacy_settings
 
@@ -221,6 +238,8 @@ module Telnyx
               messaging_settings: Telnyx::AI::MessagingSettings::OrHash,
               model: String,
               name: String,
+              observability_settings:
+                Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::OrHash,
               privacy_settings: Telnyx::AI::PrivacySettings::OrHash,
               telephony_settings: Telnyx::AI::TelephonySettings::OrHash,
               tool_ids: T::Array[String],
@@ -277,6 +296,7 @@ module Telnyx
             # to see all of your available models,
             model: nil,
             name: nil,
+            observability_settings: nil,
             privacy_settings: nil,
             telephony_settings: nil,
             tool_ids: nil,
@@ -305,6 +325,8 @@ module Telnyx
                 messaging_settings: Telnyx::AI::MessagingSettings,
                 model: String,
                 name: String,
+                observability_settings:
+                  Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings,
                 privacy_settings: Telnyx::AI::PrivacySettings,
                 telephony_settings: Telnyx::AI::TelephonySettings,
                 tool_ids: T::Array[String],
@@ -331,6 +353,116 @@ module Telnyx
           end
           def to_hash
           end
+
+          class ObservabilitySettings < Telnyx::Internal::Type::BaseModel
+            OrHash =
+              T.type_alias do
+                T.any(
+                  Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings,
+                  Telnyx::Internal::AnyHash
+                )
+              end
+
+            sig { returns(T.nilable(String)) }
+            attr_reader :host
+
+            sig { params(host: String).void }
+            attr_writer :host
+
+            sig { returns(T.nilable(String)) }
+            attr_reader :public_key_ref
+
+            sig { params(public_key_ref: String).void }
+            attr_writer :public_key_ref
+
+            sig { returns(T.nilable(String)) }
+            attr_reader :secret_key_ref
+
+            sig { params(secret_key_ref: String).void }
+            attr_writer :secret_key_ref
+
+            sig do
+              returns(
+                T.nilable(
+                  Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status::OrSymbol
+                )
+              )
+            end
+            attr_reader :status
+
+            sig do
+              params(
+                status:
+                  Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status::OrSymbol
+              ).void
+            end
+            attr_writer :status
+
+            sig do
+              params(
+                host: String,
+                public_key_ref: String,
+                secret_key_ref: String,
+                status:
+                  Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status::OrSymbol
+              ).returns(T.attached_class)
+            end
+            def self.new(
+              host: nil,
+              public_key_ref: nil,
+              secret_key_ref: nil,
+              status: nil
+            )
+            end
+
+            sig do
+              override.returns(
+                {
+                  host: String,
+                  public_key_ref: String,
+                  secret_key_ref: String,
+                  status:
+                    Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status::OrSymbol
+                }
+              )
+            end
+            def to_hash
+            end
+
+            module Status
+              extend Telnyx::Internal::Type::Enum
+
+              TaggedSymbol =
+                T.type_alias do
+                  T.all(
+                    Symbol,
+                    Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status
+                  )
+                end
+              OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+              ENABLED =
+                T.let(
+                  :enabled,
+                  Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status::TaggedSymbol
+                )
+              DISABLED =
+                T.let(
+                  :disabled,
+                  Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status::TaggedSymbol
+                )
+
+              sig do
+                override.returns(
+                  T::Array[
+                    Telnyx::AI::Assistants::UpdateAssistant::ObservabilitySettings::Status::TaggedSymbol
+                  ]
+                )
+              end
+              def self.values
+              end
+            end
+          end
         end
       end
     end

data/rbi/telnyx/models/ai/audio_transcribe_response.rbi

@@ -16,16 +16,18 @@ module Telnyx
         sig { returns(String) }
         attr_accessor :text
 
-        # The duration of the audio file in seconds. This is only included if
-        # `response_format` is set to `verbose_json`.
+        # The duration of the audio file in seconds. Returned by
+        # `distil-whisper/distil-large-v2` and `deepgram/nova-3` when `response_format` is
+        # `verbose_json`. Not returned by `openai/whisper-large-v3-turbo`.
         sig { returns(T.nilable(Float)) }
         attr_reader :duration
 
         sig { params(duration: Float).void }
         attr_writer :duration
 
-        # Segments of the transcribed text and their corresponding details. This is only
-        # included if `response_format` is set to `verbose_json`.
+        # Segments of the transcribed text and their corresponding details. Returned by
+        # `distil-whisper/distil-large-v2` when `response_format` is `verbose_json`. Not
+        # returned by `openai/whisper-large-v3-turbo`.
         sig do
           returns(
             T.nilable(
@@ -45,6 +47,32 @@ module Telnyx
         end
         attr_writer :segments
 
+        # Word-level timestamps and optional speaker labels. Only returned by
+        # `deepgram/nova-3` when word-level output is enabled via `model_config`.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[Telnyx::Models::AI::AudioTranscribeResponse::Word]
+            )
+          )
+        end
+        attr_reader :words
+
+        sig do
+          params(
+            words:
+              T::Array[
+                Telnyx::Models::AI::AudioTranscribeResponse::Word::OrHash
+              ]
+          ).void
+        end
+        attr_writer :words
+
+        # Response fields vary by model. `distil-whisper/distil-large-v2` returns `text`,
+        # `duration`, and `segments` in `verbose_json` mode.
+        # `openai/whisper-large-v3-turbo` returns `text` only. `deepgram/nova-3` returns
+        # `text` and, depending on `model_config`, may include `words` with per-word
+        # timestamps and speaker labels.
         sig do
           params(
             text: String,
@@ -52,18 +80,27 @@ module Telnyx
             segments:
               T::Array[
                 Telnyx::Models::AI::AudioTranscribeResponse::Segment::OrHash
+              ],
+            words:
+              T::Array[
+                Telnyx::Models::AI::AudioTranscribeResponse::Word::OrHash
               ]
           ).returns(T.attached_class)
         end
         def self.new(
           # The transcribed text for the audio file.
           text:,
-          # The duration of the audio file in seconds. This is only included if
-          # `response_format` is set to `verbose_json`.
+          # The duration of the audio file in seconds. Returned by
+          # `distil-whisper/distil-large-v2` and `deepgram/nova-3` when `response_format` is
+          # `verbose_json`. Not returned by `openai/whisper-large-v3-turbo`.
           duration: nil,
-          # Segments of the transcribed text and their corresponding details. This is only
-          # included if `response_format` is set to `verbose_json`.
-          segments: nil
+          # Segments of the transcribed text and their corresponding details. Returned by
+          # `distil-whisper/distil-large-v2` when `response_format` is `verbose_json`. Not
+          # returned by `openai/whisper-large-v3-turbo`.
+          segments: nil,
+          # Word-level timestamps and optional speaker labels. Only returned by
+          # `deepgram/nova-3` when word-level output is enabled via `model_config`.
+          words: nil
         )
         end
 
@@ -73,7 +110,8 @@ module Telnyx
               text: String,
               duration: Float,
               segments:
-                T::Array[Telnyx::Models::AI::AudioTranscribeResponse::Segment]
+                T::Array[Telnyx::Models::AI::AudioTranscribeResponse::Segment],
+              words: T::Array[Telnyx::Models::AI::AudioTranscribeResponse::Word]
             }
           )
         end
@@ -130,6 +168,81 @@ module Telnyx
           def to_hash
           end
         end
+
+        class Word < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::Models::AI::AudioTranscribeResponse::Word,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # End time of the word in seconds.
+          sig { returns(Float) }
+          attr_accessor :end_
+
+          # Start time of the word in seconds.
+          sig { returns(Float) }
+          attr_accessor :start
+
+          # The transcribed word.
+          sig { returns(String) }
+          attr_accessor :word
+
+          # Confidence score for the word (0.0 to 1.0).
+          sig { returns(T.nilable(Float)) }
+          attr_reader :confidence
+
+          sig { params(confidence: Float).void }
+          attr_writer :confidence
+
+          # Speaker index. Only present when diarization is enabled via `model_config`.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :speaker
+
+          sig { params(speaker: Integer).void }
+          attr_writer :speaker
+
+          # Word-level timing detail. Only present when using `deepgram/nova-3` with
+          # `model_config` options that enable word timestamps.
+          sig do
+            params(
+              end_: Float,
+              start: Float,
+              word: String,
+              confidence: Float,
+              speaker: Integer
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # End time of the word in seconds.
+            end_:,
+            # Start time of the word in seconds.
+            start:,
+            # The transcribed word.
+            word:,
+            # Confidence score for the word (0.0 to 1.0).
+            confidence: nil,
+            # Speaker index. Only present when diarization is enabled via `model_config`.
+            speaker: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                end_: Float,
+                start: Float,
+                word: String,
+                confidence: Float,
+                speaker: Integer
+              }
+            )
+          end
+          def to_hash
+          end
+        end
       end
     end
   end

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

@@ -111,6 +111,21 @@ module Telnyx
         end
         attr_writer :messaging_settings
 
+        sig do
+          returns(
+            T.nilable(Telnyx::AI::InferenceEmbedding::ObservabilitySettings)
+          )
+        end
+        attr_reader :observability_settings
+
+        sig do
+          params(
+            observability_settings:
+              Telnyx::AI::InferenceEmbedding::ObservabilitySettings::OrHash
+          ).void
+        end
+        attr_writer :observability_settings
+
         sig { returns(T.nilable(Telnyx::AI::PrivacySettings)) }
         attr_reader :privacy_settings
 
@@ -192,6 +207,8 @@ module Telnyx
             insight_settings: Telnyx::AI::InsightSettings::OrHash,
             llm_api_key_ref: String,
             messaging_settings: Telnyx::AI::MessagingSettings::OrHash,
+            observability_settings:
+              Telnyx::AI::InferenceEmbedding::ObservabilitySettings::OrHash,
             privacy_settings: Telnyx::AI::PrivacySettings::OrHash,
             telephony_settings: Telnyx::AI::TelephonySettings::OrHash,
             tools:
@@ -250,6 +267,7 @@ module Telnyx
           # work with this integration.
           llm_api_key_ref: nil,
           messaging_settings: nil,
+          observability_settings: nil,
           privacy_settings: nil,
           telephony_settings: nil,
           # The tools that the assistant can use. These may be templated with
@@ -280,6 +298,8 @@ module Telnyx
               insight_settings: Telnyx::AI::InsightSettings,
               llm_api_key_ref: String,
               messaging_settings: Telnyx::AI::MessagingSettings,
+              observability_settings:
+                Telnyx::AI::InferenceEmbedding::ObservabilitySettings,
               privacy_settings: Telnyx::AI::PrivacySettings,
               telephony_settings: Telnyx::AI::TelephonySettings,
               tools: T::Array[Telnyx::AI::AssistantTool::Variants],
@@ -291,6 +311,116 @@ module Telnyx
         end
         def to_hash
         end
+
+        class ObservabilitySettings < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::AI::InferenceEmbedding::ObservabilitySettings,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :host
+
+          sig { params(host: String).void }
+          attr_writer :host
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :public_key_ref
+
+          sig { params(public_key_ref: String).void }
+          attr_writer :public_key_ref
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :secret_key_ref
+
+          sig { params(secret_key_ref: String).void }
+          attr_writer :secret_key_ref
+
+          sig do
+            returns(
+              T.nilable(
+                Telnyx::AI::InferenceEmbedding::ObservabilitySettings::Status::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :status
+
+          sig do
+            params(
+              status:
+                Telnyx::AI::InferenceEmbedding::ObservabilitySettings::Status::OrSymbol
+            ).void
+          end
+          attr_writer :status
+
+          sig do
+            params(
+              host: String,
+              public_key_ref: String,
+              secret_key_ref: String,
+              status:
+                Telnyx::AI::InferenceEmbedding::ObservabilitySettings::Status::OrSymbol
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            host: nil,
+            public_key_ref: nil,
+            secret_key_ref: nil,
+            status: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                host: String,
+                public_key_ref: String,
+                secret_key_ref: String,
+                status:
+                  Telnyx::AI::InferenceEmbedding::ObservabilitySettings::Status::TaggedSymbol
+              }
+            )
+          end
+          def to_hash
+          end
+
+          module Status
+            extend Telnyx::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  Telnyx::AI::InferenceEmbedding::ObservabilitySettings::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            ENABLED =
+              T.let(
+                :enabled,
+                Telnyx::AI::InferenceEmbedding::ObservabilitySettings::Status::TaggedSymbol
+              )
+            DISABLED =
+              T.let(
+                :disabled,
+                Telnyx::AI::InferenceEmbedding::ObservabilitySettings::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  Telnyx::AI::InferenceEmbedding::ObservabilitySettings::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
       end
     end
   end

data/rbi/telnyx/models/ai/telephony_settings.rbi

@@ -345,6 +345,14 @@ module Telnyx
           end
           attr_writer :channels
 
+          # Whether call recording is enabled. When set to false, calls will not be recorded
+          # regardless of other recording configuration.
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :enabled
+
+          sig { params(enabled: T::Boolean).void }
+          attr_writer :enabled
+
           # The format of the recording file.
           sig do
             returns(
@@ -368,6 +376,7 @@ module Telnyx
             params(
               channels:
                 Telnyx::AI::TelephonySettings::RecordingSettings::Channels::OrSymbol,
+              enabled: T::Boolean,
               file_format:
                 Telnyx::AI::TelephonySettings::RecordingSettings::Format::OrSymbol
             ).returns(T.attached_class)
@@ -375,6 +384,9 @@ module Telnyx
           def self.new(
             # The number of channels for the recording. 'single' for mono, 'dual' for stereo.
             channels: nil,
+            # Whether call recording is enabled. When set to false, calls will not be recorded
+            # regardless of other recording configuration.
+            enabled: nil,
             # The format of the recording file.
             file_format: nil
           )
@@ -385,6 +397,7 @@ module Telnyx
               {
                 channels:
                   Telnyx::AI::TelephonySettings::RecordingSettings::Channels::OrSymbol,
+                enabled: T::Boolean,
                 file_format:
                   Telnyx::AI::TelephonySettings::RecordingSettings::Format::OrSymbol
               }