telnyx 5.155.0 → 5.157.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa8fe26513764360f954a821465c8b4efb6ad2d03fa5b78458d45eec3fbb449d
-  data.tar.gz: 41d6930278a436cfd8927725247391d444ab01372849f133706386848b1a6dac
+  metadata.gz: d5b9ffed476341dbc8eb0fbd2245dc0554a2d0d2bcb10e483b8565b380f126b8
+  data.tar.gz: 928fb90fc99dc45aaa32115149cb68ccc0fd8389eea0b514b077d321f088cce3
 SHA512:
-  metadata.gz: d89bbd103e10e9b1bb63bb94724143dc3b56f146d0045f9ef1843910f05d84866d6336c8416279e74bfd828e31b637c40c558e3d015bb9e421ec662ee1dfceef
-  data.tar.gz: 953014783b8f97894c94f320b45d329751aaa44d0c97e7b5be61f5a745198219a60ae58088f52182744e908b8feb3e4ce3def088e458247e86e8af89e2ad5720
+  metadata.gz: c36fe657f30fac2ede9294e51b892997ca7d4842034c340ed7988825fe75d4787b98ba36dd047b9b17595f6aea405daf7cf3eed0f8ec2d0055bf8d775d29409b
+  data.tar.gz: 30771b79640ba029739c62938a934ae1095eeea5af831c5db68969a5fb2b844c8171fce515b48001b7fba4bb8ee4d8ab0e92154af543b3f2b5c75250d60a238c

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 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)
+
+
+### Bug Fixes
+
+* **release:** ghost guard also verifies the GitHub Release exists ([#317](https://github.com/team-telnyx/telnyx-ruby/issues/317)) ([1a26287](https://github.com/team-telnyx/telnyx-ruby/commit/1a26287d09ca746144898eb875f64f72447b54b6))
+* **release:** scan next's commits in release-pr (stop depending on master hotfixes) ([#315](https://github.com/team-telnyx/telnyx-ruby/issues/315)) ([67446aa](https://github.com/team-telnyx/telnyx-ruby/commit/67446aa023de85bdbd6143ec50b9f12d447fb0e7))
+
 ## 5.155.0 (2026-07-03)
 
 Full Changelog: [v5.154.0...v5.155.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.154.0...v5.155.0)

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

data/lib/telnyx/client.rb

@@ -275,6 +275,7 @@ module Telnyx
     # @return [Telnyx::Resources::Media]
     attr_reader :media
 
+    # Messages
     # @return [Telnyx::Resources::Messages]
     attr_reader :messages
 

data/lib/telnyx/internal/type/union.rb

@@ -10,10 +10,10 @@ module Telnyx
       #   case assistant_tool
       #   when Telnyx::AI::InferenceEmbeddingWebhookToolParams
       #     puts(assistant_tool.type)
+      #   when Telnyx::AI::AssistantTool::ClientSideTool
+      #     puts(assistant_tool.client_side_tool)
       #   when Telnyx::AI::RetrievalTool
       #     puts(assistant_tool.retrieval)
-      #   when Telnyx::AI::AssistantTool::Handoff
-      #     puts(assistant_tool.handoff)
       #   else
       #     puts(assistant_tool)
       #   end
@@ -22,10 +22,10 @@ module Telnyx
       #   case assistant_tool
       #   in {type: :webhook, webhook: webhook}
       #     puts(webhook)
+      #   in {type: :client_side_tool, client_side_tool: client_side_tool}
+      #     puts(client_side_tool)
       #   in {type: :retrieval, retrieval: retrieval}
       #     puts(retrieval)
-      #   in {type: :handoff, handoff: handoff}
-      #     puts(handoff)
       #   else
       #     puts(assistant_tool)
       #   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::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::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

@@ -13,6 +13,8 @@ module Telnyx
 
         variant :webhook, -> { Telnyx::AI::InferenceEmbeddingWebhookToolParams }
 
+        variant :client_side_tool, -> { Telnyx::AI::AssistantTool::ClientSideTool }
+
         variant :retrieval, -> { Telnyx::AI::RetrievalTool }
 
         # The handoff tool allows the assistant to hand off control of the conversation to another AI assistant. By default, this will happen transparently to the end user.
@@ -33,6 +35,100 @@ 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
+          #
+          #   @return [Telnyx::Models::AI::AssistantTool::ClientSideTool::ClientSideTool]
+          required :client_side_tool, -> { Telnyx::AI::AssistantTool::ClientSideTool::ClientSideTool }
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :client_side_tool]
+          required :type, const: :client_side_tool
+
+          # @!method initialize(client_side_tool:, type: :client_side_tool)
+          #   @param client_side_tool [Telnyx::Models::AI::AssistantTool::ClientSideTool::ClientSideTool]
+          #   @param type [Symbol, :client_side_tool]
+
+          # @see Telnyx::Models::AI::AssistantTool::ClientSideTool#client_side_tool
+          class ClientSideTool < Telnyx::Internal::Type::BaseModel
+            # @!attribute description
+            #   The description of the tool.
+            #
+            #   @return [String]
+            required :description, String
+
+            # @!attribute name
+            #   The name of the tool.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute parameters
+            #   The parameters the tool accepts, described as a JSON Schema object. See the
+            #   [JSON Schema reference](https://json-schema.org/understanding-json-schema) for
+            #   documentation about the format
+            #
+            #   @return [Telnyx::Models::AI::AssistantTool::ClientSideTool::ClientSideTool::Parameters]
+            required :parameters, -> { Telnyx::AI::AssistantTool::ClientSideTool::ClientSideTool::Parameters }
+
+            # @!method initialize(description:, name:, parameters:)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::AssistantTool::ClientSideTool::ClientSideTool} for more
+            #   details.
+            #
+            #   @param description [String] The description of the tool.
+            #
+            #   @param name [String] The name of the tool.
+            #
+            #   @param parameters [Telnyx::Models::AI::AssistantTool::ClientSideTool::ClientSideTool::Parameters] The parameters the tool accepts, described as a JSON Schema object. See the [JSO
+
+            # @see Telnyx::Models::AI::AssistantTool::ClientSideTool::ClientSideTool#parameters
+            class Parameters < Telnyx::Internal::Type::BaseModel
+              # @!attribute properties
+              #   The properties of the parameters.
+              #
+              #   @return [Hash{Symbol=>Object}, nil]
+              optional :properties, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+              # @!attribute required
+              #   The required properties of the parameters.
+              #
+              #   @return [Array<String>, nil]
+              optional :required, Telnyx::Internal::Type::ArrayOf[String]
+
+              # @!attribute type
+              #
+              #   @return [Symbol, Telnyx::Models::AI::AssistantTool::ClientSideTool::ClientSideTool::Parameters::Type, nil]
+              optional :type, enum: -> { Telnyx::AI::AssistantTool::ClientSideTool::ClientSideTool::Parameters::Type }
+
+              # @!method initialize(properties: nil, required: nil, type: nil)
+              #   The parameters the tool accepts, described as a JSON Schema object. See the
+              #   [JSON Schema reference](https://json-schema.org/understanding-json-schema) for
+              #   documentation about the format
+              #
+              #   @param properties [Hash{Symbol=>Object}] The properties of the parameters.
+              #
+              #   @param required [Array<String>] The required properties of the parameters.
+              #
+              #   @param type [Symbol, Telnyx::Models::AI::AssistantTool::ClientSideTool::ClientSideTool::Parameters::Type]
+
+              # @see Telnyx::Models::AI::AssistantTool::ClientSideTool::ClientSideTool::Parameters#type
+              module Type
+                extend Telnyx::Internal::Type::Enum
+
+                OBJECT = :object
+
+                # @!method self.values
+                #   @return [Array<Symbol>]
+              end
+            end
+          end
+        end
+
         class Handoff < Telnyx::Internal::Type::BaseModel
           # @!attribute handoff
           #
@@ -952,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::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::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::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::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::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