telnyx 5.174.0 → 5.175.0

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

@@ -29,6 +29,23 @@ module Telnyx
         #   @return [String, nil]
         optional :certificate_ref, String
 
+        # @!attribute extra_headers
+        #   Custom HTTP headers Telnyx sets on every request to the external LLM endpoint,
+        #   in addition to the authentication header. Keys are header names, values are
+        #   static strings. At most 32 headers. Reserved names are rejected:
+        #   accept-encoding, authorization, connection, content-encoding, content-length,
+        #   content-type, cookie, expect, host, keep-alive, proxy-authenticate,
+        #   proxy-authorization, proxy-connection, set-cookie, te, trailer,
+        #   transfer-encoding, upgrade, x-host-rewrite, x-request-id, x-trace-id, and any
+        #   x-telnyx-_ or x-stainless-_ header; '\_' counts as '-' when names are compared.
+        #   Names must be valid HTTP header names (RFC 7230 token, at most 128 characters)
+        #   and must not repeat (case-insensitive). Values must be printable ASCII, at most
+        #   4096 characters, with no leading or trailing whitespace. Values are stored as
+        #   plain text and returned when the assistant is retrieved.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :extra_headers, Telnyx::Internal::Type::HashOf[String], nil?: true
+
         # @!attribute forward_metadata
         #   When `true`, Telnyx forwards the assistant's dynamic variables to the external
         #   LLM endpoint as a top-level `extra_metadata` object on the chat completion
@@ -53,7 +70,7 @@ module Telnyx
         #   @return [String, nil]
         optional :token_retrieval_url, String
 
-        # @!method initialize(base_url:, model:, authentication_method: nil, certificate_ref: nil, forward_metadata: nil, llm_api_key_ref: nil, token_retrieval_url: nil)
+        # @!method initialize(base_url:, model:, authentication_method: nil, certificate_ref: nil, extra_headers: nil, forward_metadata: nil, llm_api_key_ref: nil, token_retrieval_url: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ExternalLlm} for more details.
         #
@@ -65,6 +82,8 @@ module Telnyx
         #
         #   @param certificate_ref [String] Integration secret identifier for the client certificate used with certificate a
         #
+        #   @param extra_headers [Hash{Symbol=>String}, nil] Custom HTTP headers Telnyx sets on every request to the external LLM endpoint, i
+        #
         #   @param forward_metadata [Boolean] When `true`, Telnyx forwards the assistant's dynamic variables to the external L
         #
         #   @param llm_api_key_ref [String] Integration secret identifier for the external LLM API key.

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

@@ -29,6 +29,23 @@ module Telnyx
         #   @return [String, nil]
         optional :certificate_ref, String
 
+        # @!attribute extra_headers
+        #   Custom HTTP headers Telnyx sets on every request to the external LLM endpoint,
+        #   in addition to the authentication header. Keys are header names, values are
+        #   static strings. At most 32 headers. Reserved names are rejected:
+        #   accept-encoding, authorization, connection, content-encoding, content-length,
+        #   content-type, cookie, expect, host, keep-alive, proxy-authenticate,
+        #   proxy-authorization, proxy-connection, set-cookie, te, trailer,
+        #   transfer-encoding, upgrade, x-host-rewrite, x-request-id, x-trace-id, and any
+        #   x-telnyx-_ or x-stainless-_ header; '\_' counts as '-' when names are compared.
+        #   Names must be valid HTTP header names (RFC 7230 token, at most 128 characters)
+        #   and must not repeat (case-insensitive). Values must be printable ASCII, at most
+        #   4096 characters, with no leading or trailing whitespace. Values are stored as
+        #   plain text and returned when the assistant is retrieved.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :extra_headers, Telnyx::Internal::Type::HashOf[String], nil?: true
+
         # @!attribute forward_metadata
         #   When `true`, Telnyx forwards the assistant's dynamic variables to the external
         #   LLM endpoint as a top-level `extra_metadata` object on the chat completion
@@ -53,7 +70,7 @@ module Telnyx
         #   @return [String, nil]
         optional :token_retrieval_url, String
 
-        # @!method initialize(base_url:, model:, authentication_method: nil, certificate_ref: nil, forward_metadata: nil, llm_api_key_ref: nil, token_retrieval_url: nil)
+        # @!method initialize(base_url:, model:, authentication_method: nil, certificate_ref: nil, extra_headers: nil, forward_metadata: nil, llm_api_key_ref: nil, token_retrieval_url: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ExternalLlmReq} for more details.
         #
@@ -65,6 +82,8 @@ module Telnyx
         #
         #   @param certificate_ref [String] Integration secret identifier for the client certificate used with certificate a
         #
+        #   @param extra_headers [Hash{Symbol=>String}, nil] Custom HTTP headers Telnyx sets on every request to the external LLM endpoint, i
+        #
         #   @param forward_metadata [Boolean] When `true`, Telnyx forwards the assistant's dynamic variables to the external L
         #
         #   @param llm_api_key_ref [String] Integration secret identifier for the external LLM API key.

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

@@ -29,8 +29,20 @@ module Telnyx
         #   turn-taking models like `deepgram/flux`, end-of-turn detection is driven by the
         #   transcription end-of-turn settings under `transcription.settings` instead.
         #
+        #   Sending any `start_speaking_plan` object — an empty `{}` included (the stored
+        #   config fills in field defaults) — engages per-turn transcript matching: on each
+        #   turn the transcript tail is evaluated against the configured
+        #   `transcription_endpointing_plan` tiers, and the wait is set to the matching
+        #   tier's seconds. When the transcript ends without terminal punctuation or a
+        #   number and `transcription_endpointing_plan` is set, its
+        #   `on_no_punctuation_seconds` tier applies. Only when no tier matches
+        #   (`transcription_endpointing_plan` unset or null) does the wait stay on
+        #   `wait_seconds`. Setting `start_speaking_plan` to `null` (or omitting it) turns
+        #   per-turn matching off entirely, and the assistant starts speaking as soon as
+        #   silence is detected.
+        #
         #   @return [Telnyx::Models::AI::StartSpeakingPlan, nil]
-        optional :start_speaking_plan, -> { Telnyx::AI::StartSpeakingPlan }
+        optional :start_speaking_plan, -> { Telnyx::AI::StartSpeakingPlan }, nil?: true
 
         # @!method initialize(disable_greeting_interruption: nil, enable: nil, interrupt_prediction_threshold: nil, start_speaking_plan: nil)
         #   Some parameter documentations has been truncated, see
@@ -49,7 +61,7 @@ module Telnyx
         #
         #   @param interrupt_prediction_threshold [Float, nil] Interrupt-prediction sensitivity, from 0.0 to 1.0. Set to null or 0.0 to disable
         #
-        #   @param start_speaking_plan [Telnyx::Models::AI::StartSpeakingPlan] Controls when the assistant starts speaking after the user stops. These threshol
+        #   @param start_speaking_plan [Telnyx::Models::AI::StartSpeakingPlan, nil] Controls when the assistant starts speaking after the user stops. These threshol
       end
     end
   end

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

@@ -47,6 +47,16 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :expressive_mode, Telnyx::Internal::Type::Boolean
 
+        # @!attribute language
+        #   Two-letter ISO 639-1 code of the language the voice speaks, for example `es`.
+        #   Only applicable to Soniox and AssemblyAI voices, which speak every language of
+        #   their model. AssemblyAI accepts `en`, `es`, `de`, `fr`, `it`, and `pt`, as a
+        #   literal code: a dynamic variable is rejected. When unset, the voice speaks
+        #   English.
+        #
+        #   @return [String, nil]
+        optional :language, String, nil?: true
+
         # @!attribute language_boost
         #   Enhances recognition for specific languages and dialects during MiniMax TTS
         #   synthesis. Default is null (no boost). Set to 'auto' for automatic language
@@ -114,7 +124,7 @@ module Telnyx
         #   @return [Float, nil]
         optional :voice_speed, Float
 
-        # @!method initialize(voice:, api_key_ref: nil, background_audio: nil, expressive_mode: nil, language_boost: nil, similarity_boost: nil, speed: nil, style: nil, temperature: nil, tool_call_audio: nil, use_speaker_boost: nil, voice_speed: nil)
+        # @!method initialize(voice:, api_key_ref: nil, background_audio: nil, expressive_mode: nil, language: nil, language_boost: nil, similarity_boost: nil, speed: nil, style: nil, temperature: nil, tool_call_audio: nil, use_speaker_boost: nil, voice_speed: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::InferenceEmbeddingVoiceSettings} for more details.
         #
@@ -126,6 +136,8 @@ module Telnyx
         #
         #   @param expressive_mode [Boolean] Enables emotionally expressive speech using SSML emotion tags. When enabled, the
         #
+        #   @param language [String, nil] Two-letter ISO 639-1 code of the language the voice speaks, for example `es`. On
+        #
         #   @param language_boost [Symbol, Telnyx::Models::AI::InferenceEmbeddingVoiceSettings::LanguageBoost, nil] Enhances recognition for specific languages and dialects during MiniMax TTS synt
         #
         #   @param similarity_boost [Float] Determines how closely the AI should adhere to the original voice when attemptin

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

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Memory
+        module Namespaces
+          class AgentMemoryPageMeta < Telnyx::Internal::Type::BaseModel
+            # @!attribute page_number
+            #   The page returned, counting from 1.
+            #
+            #   @return [Integer]
+            required :page_number, Integer
+
+            # @!attribute page_size
+            #   How many results a page holds.
+            #
+            #   @return [Integer]
+            required :page_size, Integer
+
+            # @!attribute total_pages
+            #   Pages that can be requested; 0 when nothing matched. Page until `page_number`
+            #   reaches it rather than until a page comes back short: a page can hold fewer than
+            #   `page_size` results without being the last. Capped at the deepest page served,
+            #   so on a very large listing it covers fewer results than `total_results`.
+            #
+            #   @return [Integer]
+            required :total_pages, Integer
+
+            # @!attribute total_results
+            #   Results the request matched, including any past the deepest page.
+            #
+            #   @return [Integer]
+            required :total_results, Integer
+
+            # @!method initialize(page_number:, page_size:, total_pages:, total_results:)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::Memory::Namespaces::AgentMemoryPageMeta} for more details.
+            #
+            #   Where a listing's page sits in the whole.
+            #
+            #   A page is a snapshot: the counts it reports and the order it is drawn in both
+            #   move as writes land, so paging through a busy namespace can repeat or miss an
+            #   entry at a page boundary.
+            #
+            #   @param page_number [Integer] The page returned, counting from 1.
+            #
+            #   @param page_size [Integer] How many results a page holds.
+            #
+            #   @param total_pages [Integer] Pages that can be requested; 0 when nothing matched. Page until `page_number` re
+            #
+            #   @param total_results [Integer] Results the request matched, including any past the deepest page.
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -13,43 +13,31 @@ module Telnyx
             required :page_number, Integer
 
             # @!attribute page_size
-            #   How many results a page holds.
+            #   Results per page.
             #
             #   @return [Integer]
             required :page_size, Integer
 
             # @!attribute total_pages
-            #   Pages that can be requested; 0 when nothing matched. Page until `page_number`
-            #   reaches it rather than until a page comes back short: a page can hold fewer than
-            #   `page_size` results without being the last. Capped at the deepest page served,
-            #   so on a very large listing it covers fewer results than `total_results`.
+            #   Pages that can be requested; 0 when nothing matched.
             #
             #   @return [Integer]
             required :total_pages, Integer
 
             # @!attribute total_results
-            #   Results the request matched, including any past the deepest page.
+            #   Results across every page.
             #
             #   @return [Integer]
             required :total_results, Integer
 
             # @!method initialize(page_number:, page_size:, total_pages:, total_results:)
-            #   Some parameter documentations has been truncated, see
-            #   {Telnyx::Models::AI::Memory::Namespaces::PageMeta} for more details.
-            #
-            #   Where a listing's page sits in the whole.
-            #
-            #   A page is a snapshot: the counts it reports and the order it is drawn in both
-            #   move as writes land, so paging through a busy namespace can repeat or miss an
-            #   entry at a page boundary.
-            #
             #   @param page_number [Integer] The page returned, counting from 1.
             #
-            #   @param page_size [Integer] How many results a page holds.
+            #   @param page_size [Integer] Results per page.
             #
-            #   @param total_pages [Integer] Pages that can be requested; 0 when nothing matched. Page until `page_number` re
+            #   @param total_pages [Integer] Pages that can be requested; 0 when nothing matched.
             #
-            #   @param total_results [Integer] Results the request matched, including any past the deepest page.
+            #   @param total_results [Integer] Results across every page.
           end
         end
       end

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

@@ -58,14 +58,14 @@ module Telnyx
             module Body
               extend Telnyx::Internal::Type::Union
 
-              variant -> { Telnyx::Models::AI::Memory::Namespaces::ProfileIngestParams::Body::UnionMember0Map }
+              variant -> { Telnyx::Models::AI::Memory::Namespaces::ProfileIngestParams::Body::IngestPayloadObjectMap }
 
               variant union: -> { Telnyx::AI::Memory::Namespaces::ProfileIngestParams::Body::UnionMember1 }
 
               module UnionMember1
                 extend Telnyx::Internal::Type::Union
 
-                variant -> { Telnyx::Models::AI::Memory::Namespaces::ProfileIngestParams::Body::UnionMember1::UnionMember0Array }
+                variant -> { Telnyx::Models::AI::Memory::Namespaces::ProfileIngestParams::Body::UnionMember1::IngestPayloadValueArray }
 
                 variant String
 
@@ -77,14 +77,14 @@ module Telnyx
                 #   @return [Array(Array<Object>, String, Float, Boolean)]
 
                 # @type [Telnyx::Internal::Type::Converter]
-                UnionMember0Array = Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
+                IngestPayloadValueArray = Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
               end
 
               # @!method self.variants
               #   @return [Array(Hash{Symbol=>Object}, Array<Object>, String, Float, Boolean)]
 
               # @type [Telnyx::Internal::Type::Converter]
-              UnionMember0Map = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+              IngestPayloadObjectMap = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
             end
           end
         end

data/lib/telnyx/models/ai/memory/namespaces/profiles/source_retrieve_response.rb

@@ -85,14 +85,14 @@ module Telnyx
                 module Content
                   extend Telnyx::Internal::Type::Union
 
-                  variant -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::UnionMember0Map }
+                  variant -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::SourceContentObjectMap }
 
                   variant union: -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::UnionMember1 }
 
                   module UnionMember1
                     extend Telnyx::Internal::Type::Union
 
-                    variant -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::UnionMember1::UnionMember0Array }
+                    variant -> { Telnyx::Models::AI::Memory::Namespaces::Profiles::SourceRetrieveResponse::Data::Content::UnionMember1::SourceContentValueArray }
 
                     variant String
 
@@ -104,14 +104,14 @@ module Telnyx
                     #   @return [Array(Array<Object>, String, Float, Boolean)]
 
                     # @type [Telnyx::Internal::Type::Converter]
-                    UnionMember0Array = Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
+                    SourceContentValueArray = Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::Unknown]
                   end
 
                   # @!method self.variants
                   #   @return [Array(Hash{Symbol=>Object}, Array<Object>, String, Float, Boolean)]
 
                   # @type [Telnyx::Internal::Type::Converter]
-                  UnionMember0Map = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+                  SourceContentObjectMap = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
                 end
               end
             end