telnyx 5.156.0 → 5.157.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90d7decc9cec24949a0d9beb4809b4c21521a283afc48f53ce0bc401d7db77d0
-  data.tar.gz: b0dd0d0bb56c06a18079fcc8e9aa77bc65dc2c0e2ec8da2c674686c3f197f90a
+  metadata.gz: d5b9ffed476341dbc8eb0fbd2245dc0554a2d0d2bcb10e483b8565b380f126b8
+  data.tar.gz: 928fb90fc99dc45aaa32115149cb68ccc0fd8389eea0b514b077d321f088cce3
 SHA512:
-  metadata.gz: 6cbcb63aa2277c0750355a893354d1025f689192b7e2be70267d5e7d96249cb3a16dafd3fa54adecbcfe4940987725b671d37e4ac80d1e014e8e7d7406886727
-  data.tar.gz: d6432420d78f51ef8dd197756c310071bca69ae741d449645f5701819f6ac92b0ff3dd2a29747d19b5d3f40228577d8c3097096e4cb1546e5b949442f7b69e51
+  metadata.gz: c36fe657f30fac2ede9294e51b892997ca7d4842034c340ed7988825fe75d4787b98ba36dd047b9b17595f6aea405daf7cf3eed0f8ec2d0055bf8d775d29409b
+  data.tar.gz: 30771b79640ba029739c62938a934ae1095eeea5af831c5db68969a5fb2b844c8171fce515b48001b7fba4bb8ee4d8ab0e92154af543b3f2b5c75250d60a238c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [5.157.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.156.0...v5.157.0) (2026-07-17)
+
+
+### Bug Fixes
+
+* **release:** assert a release PR exists for unreleased commits ([#326](https://github.com/team-telnyx/telnyx-ruby/issues/326)) ([d8a97f0](https://github.com/team-telnyx/telnyx-ruby/commit/d8a97f00ce88d2d91f7529644eb36b7bf75ab996))
+* **release:** make the --local scan clone see the repointed release branch ([#324](https://github.com/team-telnyx/telnyx-ruby/issues/324)) ([82dfdae](https://github.com/team-telnyx/telnyx-ruby/commit/82dfdae237576a2a71c3ca8ebc470ae590b81fb9))
+
 ## [5.156.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.155.0...v5.156.0) (2026-07-09)
 
 

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.156.0"
+gem "telnyx", "~> 5.157.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -0,0 +1,209 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Anthropic
+        # @see Telnyx::Resources::AI::Anthropic::V1#messages
+        class V1MessagesParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute max_tokens
+          #   The maximum number of tokens to generate in the response.
+          #
+          #   @return [Integer]
+          required :max_tokens, Integer
+
+          # @!attribute messages
+          #   The messages to send to the model, following the
+          #   [Anthropic Messages API](https://docs.anthropic.com/en/api/messages) format.
+          #
+          #   @return [Array<Hash{Symbol=>Object}>]
+          required :messages,
+                   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.
+          #
+          #   @return [String]
+          required :model, String
+
+          # @!attribute api_key_ref
+          #   If you are using an external inference provider, this field allows you to pass
+          #   along a reference to your API key. After creating an
+          #   [integration secret](https://developers.telnyx.com/api-reference/integration-secrets/create-a-secret)
+          #   for your API key, pass the secret's `identifier` in this field.
+          #
+          #   @return [String, nil]
+          optional :api_key_ref, String
+
+          # @!attribute billing_group_id
+          #   The billing group ID to associate with this request.
+          #
+          #   @return [String, nil]
+          optional :billing_group_id, String
+
+          # @!attribute fallback_config
+          #   Configuration for model fallback behavior when the primary model is unavailable.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :fallback_config, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute max_retries
+          #   Maximum number of retries for the request.
+          #
+          #   @return [Integer, nil]
+          optional :max_retries, Integer
+
+          # @!attribute mcp_servers
+          #   List of MCP (Model Context Protocol) servers to make available to the model.
+          #
+          #   @return [Array<Hash{Symbol=>Object}>, nil]
+          optional :mcp_servers,
+                   Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]]
+
+          # @!attribute metadata
+          #   An object describing metadata about the request.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute service_tier
+          #   Service tier for the request.
+          #
+          #   @return [String, nil]
+          optional :service_tier, String
+
+          # @!attribute stop_sequences
+          #   Custom sequences that will cause the model to stop generating.
+          #
+          #   @return [Array<String>, nil]
+          optional :stop_sequences, Telnyx::Internal::Type::ArrayOf[String]
+
+          # @!attribute stream
+          #   Whether to stream the response as Anthropic-format Server-Sent Events.
+          #
+          #   @return [Boolean, nil]
+          optional :stream, Telnyx::Internal::Type::Boolean
+
+          # @!attribute system_
+          #   System prompt. Can be a string or an array of content blocks following the
+          #   Anthropic API format.
+          #
+          #   @return [String, Array<Hash{Symbol=>Object}>, nil]
+          optional :system_, union: -> { Telnyx::AI::Anthropic::V1MessagesParams::System }, api_name: :system
+
+          # @!attribute temperature
+          #   Amount of randomness injected into the response. Ranges from 0 to 1.
+          #
+          #   @return [Float, nil]
+          optional :temperature, Float
+
+          # @!attribute thinking
+          #   Extended thinking configuration for models that support it. Set `type` to
+          #   `enabled` to turn on extended thinking.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :thinking, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute timeout
+          #   Request timeout in seconds.
+          #
+          #   @return [Float, nil]
+          optional :timeout, Float
+
+          # @!attribute tool_choice
+          #   Controls how the model uses tools, following the Anthropic API format.
+          #
+          #   @return [Hash{Symbol=>Object}, nil]
+          optional :tool_choice, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+          # @!attribute tools
+          #   Definitions of tools that the model may use, following the Anthropic API format.
+          #
+          #   @return [Array<Hash{Symbol=>Object}>, nil]
+          optional :tools,
+                   Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]]
+
+          # @!attribute top_k
+          #   Top-k sampling parameter. Only sample from the top K options for each subsequent
+          #   token.
+          #
+          #   @return [Integer, nil]
+          optional :top_k, Integer
+
+          # @!attribute top_p
+          #   Nucleus sampling parameter. Use temperature or top_p, but not both.
+          #
+          #   @return [Float, nil]
+          optional :top_p, Float
+
+          # @!method initialize(max_tokens:, messages:, model:, api_key_ref: nil, billing_group_id: nil, fallback_config: nil, max_retries: nil, mcp_servers: nil, metadata: nil, service_tier: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, timeout: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, request_options: {})
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::Anthropic::V1MessagesParams} for more details.
+          #
+          #   @param max_tokens [Integer] The maximum number of tokens to generate in the response.
+          #
+          #   @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 api_key_ref [String] If you are using an external inference provider, this field allows you to pass a
+          #
+          #   @param billing_group_id [String] The billing group ID to associate with this request.
+          #
+          #   @param fallback_config [Hash{Symbol=>Object}] Configuration for model fallback behavior when the primary model is unavailable.
+          #
+          #   @param max_retries [Integer] Maximum number of retries for the request.
+          #
+          #   @param mcp_servers [Array<Hash{Symbol=>Object}>] List of MCP (Model Context Protocol) servers to make available to the model.
+          #
+          #   @param metadata [Hash{Symbol=>Object}] An object describing metadata about the request.
+          #
+          #   @param service_tier [String] Service tier for the request.
+          #
+          #   @param stop_sequences [Array<String>] Custom sequences that will cause the model to stop generating.
+          #
+          #   @param stream [Boolean] Whether to stream the response as Anthropic-format Server-Sent Events.
+          #
+          #   @param system_ [String, Array<Hash{Symbol=>Object}>] System prompt. Can be a string or an array of content blocks following the Anthr
+          #
+          #   @param temperature [Float] Amount of randomness injected into the response. Ranges from 0 to 1.
+          #
+          #   @param thinking [Hash{Symbol=>Object}] Extended thinking configuration for models that support it. Set `type` to `enabl
+          #
+          #   @param timeout [Float] Request timeout in seconds.
+          #
+          #   @param tool_choice [Hash{Symbol=>Object}] Controls how the model uses tools, following the Anthropic API format.
+          #
+          #   @param tools [Array<Hash{Symbol=>Object}>] Definitions of tools that the model may use, following the Anthropic API format.
+          #
+          #   @param top_k [Integer] Top-k sampling parameter. Only sample from the top K options for each subsequent
+          #
+          #   @param top_p [Float] Nucleus sampling parameter. Use temperature or top_p, but not both.
+          #
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+          # System prompt. Can be a string or an array of content blocks following the
+          # Anthropic API format.
+          module System
+            extend Telnyx::Internal::Type::Union
+
+            variant String
+
+            variant -> { Telnyx::Models::AI::Anthropic::V1MessagesParams::System::UnionMember1Array }
+
+            # @!method self.variants
+            #   @return [Array(String, Array<Hash{Symbol=>Object}>)]
+
+            # @type [Telnyx::Internal::Type::Converter]
+            UnionMember1Array =
+              Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]]
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Anthropic
+        # @type [Telnyx::Internal::Type::Converter]
+        V1MessagesResponse = Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+      end
+    end
+  end
+end

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

@@ -192,7 +192,7 @@ module Telnyx
         #   assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
         #   endpoints.
         #
-        #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>, nil]
+        #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>, nil]
         optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
         # @!attribute transcription
@@ -263,7 +263,7 @@ module Telnyx
         #
         #   @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
         #
-        #   @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>] Deprecated for new integrations. Inline tool definitions available to the assist
+        #   @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #

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

@@ -35,6 +35,9 @@ module Telnyx
 
         variant :skip_turn, -> { Telnyx::AI::AssistantTool::SkipTurn }
 
+        # (BETA) The pay tool allows the assistant to collect card payments from the caller via DTMF during the conversation. Recording is automatically paused while the pay tool is active and resumes when the payment flow completes. The connector_name must reference a pay connector configured in the Telnyx API.
+        variant :pay, -> { Telnyx::AI::AssistantTool::Pay }
+
         class ClientSideTool < Telnyx::Internal::Type::BaseModel
           # @!attribute client_side_tool
           #
@@ -1045,8 +1048,29 @@ module Telnyx
           end
         end
 
+        class Pay < Telnyx::Internal::Type::BaseModel
+          # @!attribute pay
+          #
+          #   @return [Telnyx::Models::AI::PayToolParams]
+          required :pay, -> { Telnyx::AI::PayToolParams }
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :pay]
+          required :type, const: :pay
+
+          # @!method initialize(pay:, type: :pay)
+          #   (BETA) The pay tool allows the assistant to collect card payments from the
+          #   caller via DTMF during the conversation. Recording is automatically paused while
+          #   the pay tool is active and resumes when the payment flow completes. The
+          #   connector_name must reference a pay connector configured in the Telnyx API.
+          #
+          #   @param pay [Telnyx::Models::AI::PayToolParams]
+          #   @param type [Symbol, :pay]
+        end
+
         # @!method self.variants
-        #   @return [Array(Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn)]
+        #   @return [Array(Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay)]
       end
     end
   end

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

@@ -204,7 +204,7 @@ module Telnyx
         #   assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
         #   endpoints.
         #
-        #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>, nil]
+        #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>, nil]
         optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
         # @!attribute transcription
@@ -285,7 +285,7 @@ module Telnyx
         #
         #   @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
         #
-        #   @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>] Deprecated for new integrations. Inline tool definitions available to the assist
+        #   @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #

data/lib/telnyx/models/ai/assistants/update_assistant.rb

@@ -189,7 +189,7 @@ module Telnyx
           #   assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
           #   endpoints.
           #
-          #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>, nil]
+          #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>, nil]
           optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
           # @!attribute transcription
@@ -266,7 +266,7 @@ module Telnyx
           #
           #   @param tool_ids [Array<String>] IDs of shared tools to attach to the assistant. New integrations should prefer `
           #
-          #   @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>] Deprecated for new integrations. Inline tool definitions available to the assist
+          #   @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>] Deprecated for new integrations. Inline tool definitions available to the assist
           #
           #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
           #

data/lib/telnyx/models/ai/conversations/conversation_insight_retrieve_aggregates_params.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Conversations
+        # @see Telnyx::Resources::AI::Conversations::ConversationInsights#retrieve_aggregates
+        class ConversationInsightRetrieveAggregatesParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute created_at
+          #   Filter by creation datetime to scope the aggregation window. Supports range
+          #   operators (e.g., `created_at=gte.2025-01-01T00:00:00Z` for the start of the
+          #   range, `created_at=lt.2025-01-02T00:00:00Z` for the end). To build per-day time
+          #   series (as the portal does for the 'Insights Over Time' chart), issue one
+          #   request per day bounded by `created_at=gte.<day_start>` and
+          #   `created_at=lt.<next_day_start>`.
+          #
+          #   @return [String, nil]
+          optional :created_at, String
+
+          # @!attribute group_by
+          #   Fields to group by (can be comma-separated or multiple parameters). Prefix a
+          #   field with 'metadata.' (e.g. 'metadata.assistant_id') to group by the
+          #   conversation's metadata instead of the insight result.
+          #
+          #   Common fields used for over-time charts:
+          #
+          #   - `score` — Group by the insight's score value (e.g. for Agent Instruction
+          #     Following, User Satisfaction).
+          #   - `metadata.assistant_id` — Group by the assistant that handled the
+          #     conversation.
+          #   - `metadata.assistant_version_id` — Group by the assistant version, useful for
+          #     comparing performance across versions in the portal's 'Insights Over Time'
+          #     chart.
+          #   - `metadata.telnyx_conversation_channel` — Group by conversation channel
+          #     (phone_call, web_chat, etc.).
+          #
+          #   @return [Array<String>, nil]
+          optional :group_by, Telnyx::Internal::Type::ArrayOf[String]
+
+          # @!attribute insight_id
+          #   Optional insight ID to filter conversation insights. Only insights matching this
+          #   ID will be included in the aggregation.
+          #
+          #   @return [String, nil]
+          optional :insight_id, String
+
+          # @!attribute metadata
+          #
+          #   @return [Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata, nil]
+          optional :metadata,
+                   -> { Telnyx::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata }
+
+          # @!attribute show
+          #   Fields to include in the result (can be comma-separated or multiple parameters).
+          #   Supports the same 'metadata.<key>' prefix as group_by. Each returned row will
+          #   contain the grouped field values plus a `record_count` indicating how many
+          #   conversation insights match that combination.
+          #
+          #   @return [Array<String>, nil]
+          optional :show, Telnyx::Internal::Type::ArrayOf[String]
+
+          # @!method initialize(created_at: nil, group_by: nil, insight_id: nil, metadata: nil, show: nil, request_options: {})
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams}
+          #   for more details.
+          #
+          #   @param created_at [String] Filter by creation datetime to scope the aggregation window. Supports range oper
+          #
+          #   @param group_by [Array<String>] Fields to group by (can be comma-separated or multiple parameters). Prefix a fie
+          #
+          #   @param insight_id [String] Optional insight ID to filter conversation insights. Only insights matching this
+          #
+          #   @param metadata [Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata]
+          #
+          #   @param show [Array<String>] Fields to include in the result (can be comma-separated or multiple parameters).
+          #
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+          class Metadata < Telnyx::Internal::Type::BaseModel
+            # @!attribute assistant_id
+            #   Filter by assistant ID (e.g., `metadata.assistant_id=eq.<assistant_id>`). When
+            #   provided, only conversation insights for the specified assistant are aggregated.
+            #   Used by the portal to scope the 'Insights Over Time' chart to a single
+            #   assistant.
+            #
+            #   @return [String, nil]
+            optional :assistant_id, String
+
+            # @!method initialize(assistant_id: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata}
+            #   for more details.
+            #
+            #   @param assistant_id [String] Filter by assistant ID (e.g., `metadata.assistant_id=eq.<assistant_id>`). When p
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/ai/conversations/conversation_insight_retrieve_aggregates_response.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Conversations
+        # @see Telnyx::Resources::AI::Conversations::ConversationInsights#retrieve_aggregates
+        class ConversationInsightRetrieveAggregatesResponse < Telnyx::Internal::Type::BaseModel
+          # @!attribute data
+          #   Aggregation result rows. Each row contains the grouped field values and a
+          #   `record_count`.
+          #
+          #   @return [Array<Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse::Data>]
+          required :data,
+                   -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse::Data] }
+
+          # @!method initialize(data:)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse}
+          #   for more details.
+          #
+          #   Aggregated conversation insight counts grouped by the specified fields. Each
+          #   item in `data` contains the grouped field values and a `record_count` indicating
+          #   how many conversation insights match that combination.
+          #
+          #   @param data [Array<Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse::Data>] Aggregation result rows. Each row contains the grouped field values and a `recor
+
+          class Data < Telnyx::Internal::Type::BaseModel
+            # @!attribute record_count
+            #   Number of conversation insights that match this combination of grouped field
+            #   values.
+            #
+            #   @return [Integer]
+            required :record_count, Integer
+
+            # @!method initialize(record_count:)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse::Data}
+            #   for more details.
+            #
+            #   An aggregation row. Contains the grouped field values (keyed by the group_by
+            #   field names) and a `record_count` integer. For example, when grouping by
+            #   `score`, each row has a `score` value and a `record_count` of conversations with
+            #   that score. When also splitting by `metadata.assistant_version_id`, each row
+            #   includes both `score` and `metadata.assistant_version_id` plus their combined
+            #   `record_count`.
+            #
+            #   @param record_count [Integer] Number of conversation insights that match this combination of grouped field val
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -199,7 +199,7 @@ module Telnyx
         #   assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
         #   endpoints.
         #
-        #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>, nil]
+        #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>, nil]
         optional :tools, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
         # @!attribute transcription
@@ -295,7 +295,7 @@ module Telnyx
         #
         #   @param telephony_settings [Telnyx::Models::AI::TelephonySettings]
         #
-        #   @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>] Deprecated for new integrations. Inline tool definitions available to the assist
+        #   @param tools [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>] Deprecated for new integrations. Inline tool definitions available to the assist
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
         #
@@ -430,7 +430,7 @@ module Telnyx
               #   follow-up fetch per shared tool. Ignored on input — set `shared_tool_ids` to
               #   configure a node's tools.
               #
-              #   @return [Array<Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>>, nil]
+              #   @return [Array<Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>>, nil]
               optional :tools,
                        -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool]] }
 
@@ -486,7 +486,7 @@ module Telnyx
               #
               #   @param shared_tool_ids [Array<String>] IDs of shared (org-level) tools available at this node. Knowledge bases are atta
               #
-              #   @param tools [Array<Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>>] Full tool definitions for this node, resolved from `shared_tool_ids` server-side
+              #   @param tools [Array<Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>>] Full tool definitions for this node, resolved from `shared_tool_ids` server-side
               #
               #   @param tools_mode [Symbol, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Prompt::ToolsMode] How `shared_tool_ids` combine with the assistant-level tool set. `replace` (defa
               #
@@ -576,7 +576,7 @@ module Telnyx
               #   responses so clients can render the node without a follow-up fetch. Ignored on
               #   input — set `shared_tool_id`.
               #
-              #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>, nil]
+              #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>, nil]
               optional :tool, -> { Telnyx::Internal::Type::ArrayOf[union: Telnyx::AI::AssistantTool] }
 
               # @!attribute type
@@ -600,7 +600,7 @@ module Telnyx
               #
               #   @param position [Telnyx::Models::AI::NodePosition] Optional canvas coordinates used by authoring UIs to lay out the graph. Ignored
               #
-              #   @param tool [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn>] Full tool definition resolved from `shared_tool_id` server-side. Populated on re
+              #   @param tool [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams, Telnyx::Models::AI::AssistantTool::ClientSideTool, Telnyx::Models::AI::RetrievalTool, Telnyx::Models::AI::AssistantTool::Handoff, Telnyx::Models::AI::HangupTool, Telnyx::Models::AI::AssistantTool::Transfer, Telnyx::Models::AI::AssistantTool::Invite, Telnyx::Models::AI::AssistantTool::Refer, Telnyx::Models::AI::AssistantTool::SendDtmf, Telnyx::Models::AI::AssistantTool::SendMessage, Telnyx::Models::AI::AssistantTool::SkipTurn, Telnyx::Models::AI::AssistantTool::Pay>] Full tool definition resolved from `shared_tool_id` server-side. Populated on re
               #
               #   @param type [Symbol, Telnyx::Models::AI::InferenceEmbedding::ConversationFlow::Node::Tool::Type] Node kind discriminator. Always `tool` for a tool node.
 

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

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      class PayToolParams < Telnyx::Internal::Type::BaseModel
+        # @!attribute connector_name
+        #   The name of the pay connector configured in the Telnyx API. Must reference an
+        #   existing pay connector for this organization.
+        #
+        #   @return [String]
+        required :connector_name, String
+
+        # @!attribute currency
+        #   Default currency for payments processed by this tool.
+        #
+        #   @return [String, nil]
+        optional :currency, String
+
+        # @!attribute description
+        #   Optional description of the pay tool that will be passed to the assistant.
+        #
+        #   @return [String, nil]
+        optional :description, String, nil?: true
+
+        # @!attribute payment_method
+        #   Default payment method for payments processed by this tool.
+        #
+        #   @return [String, nil]
+        optional :payment_method, String
+
+        # @!method initialize(connector_name:, currency: nil, description: nil, payment_method: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::PayToolParams} for more details.
+        #
+        #   @param connector_name [String] The name of the pay connector configured in the Telnyx API. Must reference an ex
+        #
+        #   @param currency [String] Default currency for payments processed by this tool.
+        #
+        #   @param description [String, nil] Optional description of the pay tool that will be passed to the assistant.
+        #
+        #   @param payment_method [String] Default payment method for payments processed by this tool.
+      end
+    end
+  end
+end