telnyx 5.163.0 → 5.165.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dd14ec881b84e3ce8b0d2ba88bc49cc87dd03da84dcaa0fd551a48a7a954d715
-  data.tar.gz: 75fef0397f90e5f5fb35702edad17b1956ee62024056661b670047bb68df30b8
+  metadata.gz: '0599a5281ad206a21c41f29f139876ab91b6596c4403c2c1fd265a98b0b26c10'
+  data.tar.gz: 1d2a0cf55be8f93d2f638e8a1140316b3c052cdaf805740669efbf459e45da9e
 SHA512:
-  metadata.gz: 9f6682ab4347e4de132f6b73aa3bf0ab3927ab3b5da54a9d9a5cf10591777fe914cbf62e9599a3a06f034fb6cdf982f4cbb9868616ecb320433803feed6e6995
-  data.tar.gz: fc259dfb669208234bf0bc21ac8c92779781545ba8645f4c26c6b7312c36dee69936ea4ea544eb8c83ba24cd8f8f04ac43cf030d72f2aafcee943c8541d2d700
+  metadata.gz: 881615fb8ac4ba023d747d946aea0de2ad2f8aabe41bce223c6908fa2f389b961800bfdab0b4f8c3cb219cdbb1f90a99d65c10ef47b68cb8fd87a68fef870ee0
+  data.tar.gz: 6c943fc02c098ebfde7ac90194979745ba78c62ed6e901a2a1e57df06983dda31a51891aea5c87679b17fd21e89d9a27931ef86a00bd7612cfdd89b5b70e9733

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [5.165.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.164.0...v5.165.0) (2026-09-01)
+
+
+### Features
+
+* promote from staging 9d1efe7 ([d16fd9d](https://github.com/team-telnyx/telnyx-ruby/commit/d16fd9d7cff7b0205653440a32023153b7710b1f))
+
+
+### Bug Fixes
+
+* **ci:** retry transient Steep API errors ([#355](https://github.com/team-telnyx/telnyx-ruby/issues/355)) ([25ec469](https://github.com/team-telnyx/telnyx-ruby/commit/25ec4693e5110cdc0bf7849c8cdcfab7ac1d46ce))
+* **ci:** skip post-merge release readiness ([#352](https://github.com/team-telnyx/telnyx-ruby/issues/352)) ([bed03fd](https://github.com/team-telnyx/telnyx-ruby/commit/bed03fd1c162112e4a1f254687d0c5ca9d42cef8))
+
+## [5.164.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.163.0...v5.164.0) (2026-08-31)
+
+
+### Features
+
+* promote from staging 88d5491 ([d62cbe6](https://github.com/team-telnyx/telnyx-ruby/commit/d62cbe641c502f1f69a2fcca8089f3f6ff72ae91))
+
 ## [5.163.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.162.0...v5.163.0) (2026-08-21)
 
 

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.163.0"
+gem "telnyx", "~> 5.165.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/client.rb

@@ -672,10 +672,6 @@ module Telnyx
     # @return [Telnyx::Resources::VoiceSDKCallReports]
     attr_reader :voice_sdk_call_reports
 
-    # UAC connection operations
-    # @return [Telnyx::Resources::SipRegistrationStatus]
-    attr_reader :sip_registration_status
-
     # Static reference values the API accepts: call reasons, document types, rejection
     # types.
     # @return [Telnyx::Resources::CallReasons]
@@ -736,6 +732,9 @@ module Telnyx
     # @return [Telnyx::Resources::MeetingSessions]
     attr_reader :meeting_sessions
 
+    # @return [Telnyx::Resources::ExternalRequirements]
+    attr_reader :external_requirements
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -1011,7 +1010,6 @@ module Telnyx
       @pronunciation_dicts = Telnyx::Resources::PronunciationDicts.new(client: self)
       @uac_connections = Telnyx::Resources::UacConnections.new(client: self)
       @voice_sdk_call_reports = Telnyx::Resources::VoiceSDKCallReports.new(client: self)
-      @sip_registration_status = Telnyx::Resources::SipRegistrationStatus.new(client: self)
       @call_reasons = Telnyx::Resources::CallReasons.new(client: self)
       @dir = Telnyx::Resources::Dir.new(client: self)
       @infringement_claims = Telnyx::Resources::InfringementClaims.new(client: self)
@@ -1027,6 +1025,7 @@ module Telnyx
       @pricing = Telnyx::Resources::Pricing.new(client: self)
       @web_search = Telnyx::Resources::WebSearch.new(client: self)
       @meeting_sessions = Telnyx::Resources::MeetingSessions.new(client: self)
+      @external_requirements = Telnyx::Resources::ExternalRequirements.new(client: self)
     end
   end
 end

data/lib/telnyx/lib/webhook_verification.rb

@@ -2,183 +2,82 @@
 
 require "base64"
 require "openssl"
-require_relative "webhook_verification_error"
 
 module Telnyx
   module Lib
-    # Telnyx webhook verification using ED25519 signatures.
-    #
-    # This module provides ED25519 signature verification for Telnyx webhooks,
-    # matching the implementation pattern used in the Python and Node SDKs.
-    #
-    # The module is kept separate from generated code to avoid merge conflicts
-    # when Stainless updates webhook event types.
-    #
-    # Example usage:
-    #
-    #   client = Telnyx::Client.new(
-    #     api_key: ENV["TELNYX_API_KEY"],
-    #     public_key: ENV["TELNYX_PUBLIC_KEY"]  # Base64 from Mission Control
-    #   )
-    #
-    #   # Verify signature only
-    #   client.webhooks.verify!(payload, headers)
-    #
-    #   # Verify and parse
-    #   event = client.webhooks.unwrap(payload, headers)
-    #
+    # Telnyx Ed25519 webhook verification over the exact raw payload bytes.
     module WebhookVerification
-      # Telnyx webhook signature headers (case-insensitive per HTTP spec)
       SIGNATURE_HEADER = "telnyx-signature-ed25519"
       TIMESTAMP_HEADER = "telnyx-timestamp"
+      DEFAULT_TOLERANCE = 300
+      ED25519_SPKI_PREFIX = ["302a300506032b6570032100"].pack("H*").freeze
+
+      class << self
+        # Verify a Telnyx webhook signature before the caller parses the payload.
+        #
+        # @param payload [String] exact raw request body
+        # @param headers [Hash] request headers (looked up case-insensitively)
+        # @param public_key [String] Base64-encoded raw 32-byte Ed25519 public key
+        # @return [true]
+        # @raise [Telnyx::Errors::WebhookVerificationError] if verification fails
+        def verify_signature!(payload, headers, public_key)
+          signature_header = get_header(headers, SIGNATURE_HEADER)
+          timestamp = get_header(headers, TIMESTAMP_HEADER)
+
+          fail_verification("Missing required header: telnyx-signature-ed25519") if signature_header.nil? || signature_header.empty?
+          fail_verification("Missing required header: telnyx-timestamp") if timestamp.nil? || timestamp.empty?
+          fail_verification("Public key is required for webhook verification") if public_key.nil? || public_key.empty?
+
+          timestamp_int = parse_timestamp(timestamp)
+          if (Time.now.to_i - timestamp_int).abs > DEFAULT_TOLERANCE
+            fail_verification("Webhook timestamp is too old or too far in the future")
+          end
 
-      # Tolerance for timestamp validation (5 minutes)
-      TIMESTAMP_TOLERANCE_SECONDS = 300
-
-      # Verify webhook signature without parsing the payload.
-      #
-      # @param payload [String] The raw webhook payload
-      # @param headers [Hash] The webhook headers
-      # @param key [String, nil] Optional public key override (base64-encoded)
-      #
-      # @return [void]
-      #
-      # @raise [Telnyx::Errors::WebhookVerificationError] If verification fails
-      def verify!(payload, headers, key: nil)
-        public_key = key || @client.public_key
-
-        unless public_key && !public_key.empty?
-          raise Telnyx::Errors::WebhookVerificationError.new(
-            message: "No public key configured. Provide key parameter or configure client with public_key."
-          )
-        end
-
-        do_verify_signature(payload, headers, public_key)
-      end
+          key = parse_public_key(public_key)
+          signature = Base64.strict_decode64(signature_header)
+          signed_payload = "#{timestamp}|#{payload}"
 
-      private
+          fail_verification("Invalid webhook signature") unless key.verify(nil, signature, signed_payload)
 
-      # Get header value case-insensitively
-      #
-      # @param headers [Hash] The headers hash
-      # @param key [String] The header key to find
-      #
-      # @return [String, nil]
-      def get_header(headers, key)
-        key_lower = key.downcase
-        headers.each do |header_key, header_value|
-          return header_value if header_key.to_s.downcase == key_lower
+          true
+        rescue Telnyx::Errors::WebhookVerificationError
+          raise
+        rescue ArgumentError => e
+          fail_verification("Invalid webhook signature or public key encoding: #{e.message}")
+        rescue OpenSSL::PKey::PKeyError => e
+          fail_verification("Invalid Ed25519 public key: #{e.message}")
+        rescue OpenSSL::OpenSSLError => e
+          fail_verification("Webhook verification failed: #{e.message}")
         end
-        nil
-      end
-
-      # Verify the webhook signature using ED25519 cryptography
-      #
-      # @param payload [String] The raw webhook payload
-      # @param headers [Hash] The webhook headers
-      # @param public_key [String] The ED25519 public key (base64-encoded)
-      #
-      # @raise [Telnyx::Errors::WebhookVerificationError] If verification fails
-      def do_verify_signature(payload, headers, public_key)
-        # Extract required headers (case-insensitive)
-        signature_header = get_header(headers, SIGNATURE_HEADER)
-        timestamp_header = get_header(headers, TIMESTAMP_HEADER)
 
-        unless signature_header
-          raise Telnyx::Errors::WebhookVerificationError.new(
-            message: "Missing required header: #{SIGNATURE_HEADER}"
-          )
-        end
+        private
 
-        unless timestamp_header
-          raise Telnyx::Errors::WebhookVerificationError.new(
-            message: "Missing required header: #{TIMESTAMP_HEADER}"
-          )
+        def fail_verification(message)
+          raise Telnyx::Errors::WebhookVerificationError.new(message: message)
         end
 
-        # Validate timestamp to prevent replay attacks (5 minute tolerance)
-        begin
-          webhook_time = Integer(timestamp_header)
-          current_time = Time.now.to_i
-          time_diff = (current_time - webhook_time).abs
-
-          if time_diff > TIMESTAMP_TOLERANCE_SECONDS
-            raise Telnyx::Errors::WebhookVerificationError.new(
-              message: "Webhook timestamp is too old or too new (#{time_diff}s difference)"
-            )
+        def get_header(headers, name)
+          headers.each do |key, value|
+            return value if key.to_s.downcase == name
           end
-        rescue ArgumentError
-          raise Telnyx::Errors::WebhookVerificationError.new(
-            message: "Invalid timestamp format: #{timestamp_header}"
-          )
+          nil
         end
 
-        # Decode public key from base64
-        begin
-          public_key_bytes = Base64.strict_decode64(public_key)
-
-          if public_key_bytes.bytesize != 32
-            raise Telnyx::Errors::WebhookVerificationError.new(
-              message: "Invalid public key: expected 32 bytes, got #{public_key_bytes.bytesize} bytes"
-            )
-          end
-        rescue ArgumentError => e
-          raise Telnyx::Errors::WebhookVerificationError.new(
-            message: "Invalid public key format: #{e.message}"
-          )
+        def parse_timestamp(timestamp)
+          Integer(timestamp, 10)
+        rescue ArgumentError, TypeError
+          fail_verification("Invalid webhook timestamp: #{timestamp.inspect}")
         end
 
-        # Decode signature from base64
-        begin
-          signature_bytes = Base64.strict_decode64(signature_header)
-
-          if signature_bytes.bytesize != 64
-            raise Telnyx::Errors::WebhookVerificationError.new(
-              message: "Invalid signature length: expected 64 bytes, got #{signature_bytes.bytesize} bytes"
+        def parse_public_key(public_key)
+          decoded_key = Base64.strict_decode64(public_key)
+          unless decoded_key.bytesize == 32
+            fail_verification(
+              "Invalid Ed25519 public key length: expected 32 bytes, got #{decoded_key.bytesize}"
             )
           end
-        rescue ArgumentError => e
-          raise Telnyx::Errors::WebhookVerificationError.new(
-            message: "Invalid signature format: #{e.message}"
-          )
-        end
 
-        # Create the signed payload: timestamp|payload
-        signed_payload = "#{timestamp_header}|#{payload}"
-
-        # Build ED25519 public key for verification
-        # The raw 32-byte key needs to be wrapped in X.509 SubjectPublicKeyInfo format
-        # ED25519 OID: 1.3.101.112 = 06 03 2b 65 70
-        # X.509 SPKI header for ED25519: 30 2a 30 05 06 03 2b 65 70 03 21 00
-        ed25519_spki_header = [
-          0x30,
-          0x2a,
-          0x30,
-          0x05,
-          0x06,
-          0x03,
-          0x2b,
-          0x65,
-          0x70,
-          0x03,
-          0x21,
-          0x00
-        ].pack("C*")
-        der_key = ed25519_spki_header + public_key_bytes
-
-        begin
-          pkey = OpenSSL::PKey.read(der_key)
-          valid = pkey.verify(nil, signature_bytes, signed_payload)
-
-          unless valid
-            raise Telnyx::Errors::WebhookVerificationError.new(
-              message: "Signature verification failed: signature does not match payload"
-            )
-          end
-        rescue OpenSSL::PKey::PKeyError => e
-          raise Telnyx::Errors::WebhookVerificationError.new(
-            message: "Signature verification failed: #{e.message}"
-          )
+          OpenSSL::PKey.read(ED25519_SPKI_PREFIX + decoded_key)
         end
       end
     end

data/lib/telnyx/lib.rb

@@ -11,4 +11,6 @@
 #
 # Add new custom modules below:
 
-require_relative "lib/webhooks_ed25519"
+require_relative "lib/webhook_verification_error"
+require_relative "lib/webhook_verification"
+require_relative "lib/websocket"

data/lib/telnyx/models/ai/anthropic/v1_messages_params.rb

@@ -24,8 +24,9 @@ module Telnyx
                    Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]]
 
           # @!attribute model
-          #   The model to use for generating the response, for example `zai-org/GLM-5.2` or
-          #   another model available from the Telnyx models endpoint.
+          #   The model to use for generating the response, for example
+          #   `zai-org/GLM-5.3-Flash` or another model available from the Telnyx models
+          #   endpoint.
           #
           #   @return [String]
           required :model, String
@@ -150,7 +151,7 @@ module Telnyx
           #
           #   @param messages [Array<Hash{Symbol=>Object}>] The messages to send to the model, following the [Anthropic Messages API](https:
           #
-          #   @param model [String] The model to use for generating the response, for example `zai-org/GLM-5.2` or a
+          #   @param model [String] The model to use for generating the response, for example `zai-org/GLM-5.3-Flash
           #
           #   @param api_key_ref [String] If you are using an external inference provider, this field allows you to pass a
           #

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

@@ -263,6 +263,17 @@ module Telnyx
             #   @return [String, nil]
             optional :description, String
 
+            # @!attribute diversion
+            #   The number the inbound call was received on, forwarded so an unverified
+            #   non-Telnyx `from` can be used as the caller id -- typically to transfer out as
+            #   the original caller by pairing `from: "{{telnyx_end_user_target}}"` with
+            #   `diversion: "{{telnyx_agent_target}}"`. The caller id is only accepted while
+            #   that number is still on an active inbound call to this `diversion` number, and
+            #   the `diversion` number must be one you own or have verified.
+            #
+            #   @return [String, nil]
+            optional :diversion, String
+
             # @!attribute voicemail_detection
             #   Configuration for voicemail detection (AMD - Answering Machine Detection) on the
             #   transferred call. Allows the assistant to detect when a voicemail system answers
@@ -280,6 +291,23 @@ module Telnyx
             #   @return [Integer, nil]
             optional :warm_message_delay_ms, Integer, nil?: true
 
+            # @!attribute warm_transfer_acceptance
+            #   Requires the transfer destination to accept the call before the caller is
+            #   bridged. When enabled, the assistant speaks privately with the destination after
+            #   they answer — delivering the warm transfer message and asking whether they take
+            #   the call — while the caller keeps hearing ringback. The assistant then finalizes
+            #   the transfer with the built-in `complete_transfer` tool: an accept bridges the
+            #   calls, a decline hangs up the destination and returns the assistant to the
+            #   caller with the reason the destination gave. Requires either
+            #   `warm_transfer_instructions` or a `message` on every target, otherwise the
+            #   assistant fails to save. Only available for calls started with
+            #   `ai_assistant_start`; single-caller conversations only (a conference or
+            #   additional invited participants fall back to a regular warm transfer).
+            #
+            #   @return [Telnyx::Models::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance, nil]
+            optional :warm_transfer_acceptance,
+                     -> { Telnyx::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance }
+
             # @!attribute warm_transfer_instructions
             #   Natural language instructions for your agent for how to provide context for the
             #   transfer recipient.
@@ -287,7 +315,7 @@ module Telnyx
             #   @return [String, nil]
             optional :warm_transfer_instructions, String
 
-            # @!method initialize(from:, targets:, custom_headers: nil, description: nil, voicemail_detection: nil, warm_message_delay_ms: nil, warm_transfer_instructions: nil)
+            # @!method initialize(from:, targets:, custom_headers: nil, description: nil, diversion: nil, voicemail_detection: nil, warm_message_delay_ms: nil, warm_transfer_acceptance: nil, warm_transfer_instructions: nil)
             #   Some parameter documentations has been truncated, see
             #   {Telnyx::Models::AI::AssistantTool::Transfer::Transfer} for more details.
             #
@@ -299,10 +327,14 @@ module Telnyx
             #
             #   @param description [String] A description of the transfer tool. By default, Telnyx generates this automatica
             #
+            #   @param diversion [String] The number the inbound call was received on, forwarded so an unverified non-Teln
+            #
             #   @param voicemail_detection [Telnyx::Models::AI::AssistantTool::Transfer::Transfer::VoicemailDetection] Configuration for voicemail detection (AMD - Answering Machine Detection) on the
             #
             #   @param warm_message_delay_ms [Integer, nil] Optional delay in milliseconds before playing the warm message audio when the tr
             #
+            #   @param warm_transfer_acceptance [Telnyx::Models::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance] Requires the transfer destination to accept the call before the caller is bridge
+            #
             #   @param warm_transfer_instructions [String] Natural language instructions for your agent for how to provide context for the
 
             # The different possible targets of the transfer. The assistant will be able to
@@ -326,15 +358,29 @@ module Telnyx
                 #   @return [String]
                 required :to, String
 
+                # @!attribute message
+                #   The warm transfer message to deliver to this specific target. When set, it takes
+                #   precedence over the message the assistant composes from
+                #   `warm_transfer_instructions`.
+                #
+                #   @return [String, nil]
+                optional :message, String
+
                 # @!attribute name
                 #   The name of the target.
                 #
                 #   @return [String, nil]
                 optional :name, String
 
-                # @!method initialize(to:, name: nil)
+                # @!method initialize(to:, message: nil, name: nil)
+                #   Some parameter documentations has been truncated, see
+                #   {Telnyx::Models::AI::AssistantTool::Transfer::Transfer::Targets::TargetsList}
+                #   for more details.
+                #
                 #   @param to [String] The destination number or SIP URI of the call.
                 #
+                #   @param message [String] The warm transfer message to deliver to this specific target. When set, it takes
+                #
                 #   @param name [String] The name of the target.
               end
 
@@ -615,6 +661,64 @@ module Telnyx
                 end
               end
             end
+
+            # @see Telnyx::Models::AI::AssistantTool::Transfer::Transfer#warm_transfer_acceptance
+            class WarmTransferAcceptance < Telnyx::Internal::Type::BaseModel
+              # @!attribute enabled
+              #   Whether the destination must accept the transfer before the calls are bridged.
+              #
+              #   @return [Boolean, nil]
+              optional :enabled, Telnyx::Internal::Type::Boolean
+
+              # @!attribute end_user_target_context_mode
+              #   Controls whether the private exchange between the assistant and the transfer
+              #   destination is kept out of the conversation. With `private` (default) the
+              #   exchange never reaches the conversation history, AI conversations, webhooks or
+              #   insights, and the transfer tool result is rewritten with the outcome only. With
+              #   `shared` the exchange stays in the conversation like any other messages.
+              #
+              #   @return [Symbol, Telnyx::Models::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode, nil]
+              optional :end_user_target_context_mode,
+                       enum: -> { Telnyx::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode }
+
+              # @!method initialize(enabled: nil, end_user_target_context_mode: nil)
+              #   Some parameter documentations has been truncated, see
+              #   {Telnyx::Models::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance}
+              #   for more details.
+              #
+              #   Requires the transfer destination to accept the call before the caller is
+              #   bridged. When enabled, the assistant speaks privately with the destination after
+              #   they answer — delivering the warm transfer message and asking whether they take
+              #   the call — while the caller keeps hearing ringback. The assistant then finalizes
+              #   the transfer with the built-in `complete_transfer` tool: an accept bridges the
+              #   calls, a decline hangs up the destination and returns the assistant to the
+              #   caller with the reason the destination gave. Requires either
+              #   `warm_transfer_instructions` or a `message` on every target, otherwise the
+              #   assistant fails to save. Only available for calls started with
+              #   `ai_assistant_start`; single-caller conversations only (a conference or
+              #   additional invited participants fall back to a regular warm transfer).
+              #
+              #   @param enabled [Boolean] Whether the destination must accept the transfer before the calls are bridged.
+              #
+              #   @param end_user_target_context_mode [Symbol, Telnyx::Models::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance::EndUserTargetContextMode] Controls whether the private exchange between the assistant and the transfer des
+
+              # Controls whether the private exchange between the assistant and the transfer
+              # destination is kept out of the conversation. With `private` (default) the
+              # exchange never reaches the conversation history, AI conversations, webhooks or
+              # insights, and the transfer tool result is rewritten with the outcome only. With
+              # `shared` the exchange stays in the conversation like any other messages.
+              #
+              # @see Telnyx::Models::AI::AssistantTool::Transfer::Transfer::WarmTransferAcceptance#end_user_target_context_mode
+              module EndUserTargetContextMode
+                extend Telnyx::Internal::Type::Enum
+
+                PRIVATE = :private
+                SHARED = :shared
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
           end
         end
 

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

@@ -113,6 +113,16 @@ module Telnyx
         #   @return [Float, nil]
         optional :presence_penalty, Float
 
+        # @!attribute reasoning_effort
+        #   Controls the reasoning effort for models that support it. When set, the model
+        #   spends more or less compute on internal reasoning before generating its
+        #   response. Supported values: none, minimal, low, medium, high, xhigh, max. Not
+        #   all models support all values; unsupported values are rejected with a 400 error.
+        #   When omitted, reasoning models use their default effort level.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ReasoningEffort, nil]
+        optional :reasoning_effort, enum: -> { Telnyx::AI::ChatCompletionRequest::ReasoningEffort }
+
         # @!attribute response_format
         #   Use this is you want to guarantee a JSON output without defining a schema. For
         #   control over the schema, use `guided_json`.
@@ -195,7 +205,7 @@ module Telnyx
         #   @return [Boolean, nil]
         optional :use_beam_search, Telnyx::Internal::Type::Boolean
 
-        # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, response_format: nil, seed: nil, service_tier: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil)
+        # @!method initialize(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, reasoning_effort: nil, response_format: nil, seed: nil, service_tier: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil)
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::ChatCompletionRequest} for more details.
         #
@@ -231,6 +241,8 @@ module Telnyx
         #
         #   @param presence_penalty [Float] Higher values will penalize the model from repeating the same output tokens.
         #
+        #   @param reasoning_effort [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ReasoningEffort] Controls the reasoning effort for models that support it. When set, the model sp
+        #
         #   @param response_format [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat] Use this is you want to guarantee a JSON output without defining a schema. For c
         #
         #   @param seed [Integer] If specified, the system will make a best effort to sample deterministically, su
@@ -333,6 +345,28 @@ module Telnyx
           end
         end
 
+        # Controls the reasoning effort for models that support it. When set, the model
+        # spends more or less compute on internal reasoning before generating its
+        # response. Supported values: none, minimal, low, medium, high, xhigh, max. Not
+        # all models support all values; unsupported values are rejected with a 400 error.
+        # When omitted, reasoning models use their default effort level.
+        #
+        # @see Telnyx::Models::AI::ChatCompletionRequest#reasoning_effort
+        module ReasoningEffort
+          extend Telnyx::Internal::Type::Enum
+
+          NONE = :none
+          MINIMAL = :minimal
+          LOW = :low
+          MEDIUM = :medium
+          HIGH = :high
+          XHIGH = :xhigh
+          MAX = :max
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # @see Telnyx::Models::AI::ChatCompletionRequest#response_format
         class ResponseFormat < Telnyx::Internal::Type::BaseModel
           # @!attribute type

data/lib/telnyx/models/ai/collections/retrieval_settings.rb

@@ -8,6 +8,9 @@ module Telnyx
           # @!attribute retrieval_type
           #   Retrieval strategy. `vector` runs semantic similarity search; `hybrid` combines
           #   vector similarity with keyword matching; `keyword` runs lexical (BM25) matching.
+          #   `keyword` is not accepted yet: setting it returns 422
+          #   `unsupported_retrieval_type`. A collection set to `hybrid` is accepted here but
+          #   cannot be searched until hybrid execution ships.
           #
           #   @return [Symbol, Telnyx::Models::AI::Collections::RetrievalSettings::RetrievalType, nil]
           optional :retrieval_type, enum: -> { Telnyx::AI::Collections::RetrievalSettings::RetrievalType }
@@ -30,6 +33,9 @@ module Telnyx
 
           # Retrieval strategy. `vector` runs semantic similarity search; `hybrid` combines
           # vector similarity with keyword matching; `keyword` runs lexical (BM25) matching.
+          # `keyword` is not accepted yet: setting it returns 422
+          # `unsupported_retrieval_type`. A collection set to `hybrid` is accepted here but
+          # cannot be searched until hybrid execution ships.
           #
           # @see Telnyx::Models::AI::Collections::RetrievalSettings#retrieval_type
           module RetrievalType
@@ -37,7 +43,6 @@ module Telnyx
 
             VECTOR = :vector
             HYBRID = :hybrid
-            KEYWORD = :keyword
 
             # @!method self.values
             #   @return [Array<Symbol>]

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

@@ -111,6 +111,31 @@ module Telnyx
           #   @return [Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook::PathParameters, nil]
           optional :path_parameters, -> { Telnyx::AI::InferenceEmbeddingWebhookToolParams::Webhook::PathParameters }
 
+          # @!attribute preset_body_fields
+          #   Body fields supplied by the assistant configuration rather than by the model.
+          #   They are never advertised in the tool definition, so the LLM can neither see nor
+          #   set them, and they take precedence over a `body_parameters` value of the same
+          #   name. Values support mustache templating, so they can hold dynamic variables
+          #   (`{{customer_id}}`) and integration secrets
+          #   (`{{#integration_secret}}my-secret{{/integration_secret}}`). Not sent on `GET`
+          #   requests, which carry no body.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :preset_body_fields, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute preset_query_params
+          #   Query string parameters supplied by the assistant configuration rather than by
+          #   the model. They are never advertised in the tool definition, so the LLM can
+          #   neither see nor set them, and they take precedence over a `query_parameters`
+          #   value of the same name. Values support mustache templating, so they can hold
+          #   dynamic variables (`{{telnyx_end_user_target}}`) and integration secrets
+          #   (`{{#integration_secret}}my-secret{{/integration_secret}}`). Unlike values
+          #   templated directly into the `url`, these are percent-encoded, so a value such as
+          #   `+15551234567` survives the round trip.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :preset_query_params, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
           # @!attribute query_parameters
           #   The query parameters the webhook tool accepts, described as a JSON Schema
           #   object. These parameters will be passed to the webhook as the query of the
@@ -138,7 +163,7 @@ module Telnyx
           #   @return [Integer, nil]
           optional :timeout_ms, Integer
 
-          # @!method initialize(description:, name:, url:, async: nil, async_timeout_ms: nil, body_parameters: nil, headers: nil, messages: nil, http_method: nil, path_parameters: nil, query_parameters: nil, store_fields_as_variables: nil, timeout_ms: nil)
+          # @!method initialize(description:, name:, url:, async: nil, async_timeout_ms: nil, body_parameters: nil, headers: nil, messages: nil, http_method: nil, path_parameters: nil, preset_body_fields: nil, preset_query_params: nil, query_parameters: nil, store_fields_as_variables: nil, timeout_ms: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook} for more
           #   details.
@@ -163,6 +188,10 @@ module Telnyx
           #
           #   @param path_parameters [Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook::PathParameters] The path parameters the webhook tool accepts, described as a JSON Schema object.
           #
+          #   @param preset_body_fields [Hash{Symbol=>Object}] Body fields supplied by the assistant configuration rather than by the model. Th
+          #
+          #   @param preset_query_params [Hash{Symbol=>Object}] Query string parameters supplied by the assistant configuration rather than by t
+          #
           #   @param query_parameters [Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook::QueryParameters] The query parameters the webhook tool accepts, described as a JSON Schema object
           #
           #   @param store_fields_as_variables [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook::StoreFieldsAsVariable>] A list of mappings that extract values from the webhook response and store them