telnyx 5.76.0 → 5.77.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 59e245d43f929435e99b241c00ea1ed9f63a82ed8be05cfde272e9c1c8bcf9ea
-  data.tar.gz: e55cbe229e5f6fd49467da40f6358753dd05d062673141eef81b7a17c02943d1
+  metadata.gz: f7fb5e6708a25a947a58c8325f1169ed1e5eaa2a72f70b2910a02e80ed7ba715
+  data.tar.gz: b245bd720941ef0732a77fc2ada7b3b7cff57dcb811d640f77a55d0f8bac5f52
 SHA512:
-  metadata.gz: b5859cfa565098e2b10e8dc245df6002fb7e60ec5cca968b01154052e9035ac568951039708c19864fee5592aa0faeb7c0fc65c88468d9ae242c669a1b02b2ca
-  data.tar.gz: 4ece7fdc0338187af8677499069eb039489759d98947c5bce2c965a9a61b4e4fcc445a2540e29a9d5909c272deb6b4988dea55e7d88efe55e744d181943e4a41
+  metadata.gz: 92dffc9184ed50722bc216bb5ed3d77f860d253f13b9d710e77dede2303de6f7a2d8e191c1bfb61ccff4b9e0d728430e56fa52c3b41d9ae026c71771f9d62db1
+  data.tar.gz: 93797b87d12c38392de5f50ee5f980834871119efce30964784ff8e9736cb72088c2a80e11a5f2e4b5cb3a198e3a42ace139b1c2f62c5c278911436366c9806c

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 5.77.0 (2026-04-17)
+
+Full Changelog: [v5.76.0...v5.77.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.76.0...v5.77.0)
+
+### Features
+
+* TELAPPS Provide description what params can be used for premium amd ([86f672e](https://github.com/team-telnyx/telnyx-ruby/commit/86f672e62e347c27623d2e9ae9d588208e19d4b8))
+
+
+### Documentation
+
+* add pagination params to conversation messages endpoint ([6a87bac](https://github.com/team-telnyx/telnyx-ruby/commit/6a87bac178ee42635b530efef5e7aef6a48047f9))
+
 ## 5.76.0 (2026-04-15)
 
 Full Changelog: [v5.75.0...v5.76.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.75.0...v5.76.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.76.0"
+gem "telnyx", "~> 5.77.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -14,8 +14,25 @@ module Telnyx
           #   @return [String]
           required :conversation_id, String
 
-          # @!method initialize(conversation_id:, request_options: {})
+          # @!attribute page_number
+          #   The page number to retrieve.
+          #
+          #   @return [Integer, nil]
+          optional :page_number, Integer
+
+          # @!attribute page_size
+          #   The number of messages to return per page.
+          #
+          #   @return [Integer, nil]
+          optional :page_size, Integer
+
+          # @!method initialize(conversation_id:, page_number: nil, page_size: nil, request_options: {})
           #   @param conversation_id [String]
+          #
+          #   @param page_number [Integer] The page number to retrieve.
+          #
+          #   @param page_size [Integer] The number of messages to return per page.
+          #
           #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
         end
       end

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

@@ -6,140 +6,122 @@ module Telnyx
       module Conversations
         # @see Telnyx::Resources::AI::Conversations::Messages#list
         class MessageListResponse < Telnyx::Internal::Type::BaseModel
-          # @!attribute data
+          # @!attribute role
+          #   The role of the message sender.
           #
-          #   @return [Array<Telnyx::Models::AI::Conversations::MessageListResponse::Data>]
-          required :data,
-                   -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AI::Conversations::MessageListResponse::Data] }
+          #   @return [Symbol, Telnyx::Models::AI::Conversations::MessageListResponse::Role]
+          required :role, enum: -> { Telnyx::Models::AI::Conversations::MessageListResponse::Role }
 
-          # @!attribute meta
+          # @!attribute text
+          #   The message content. Can be null for tool calls.
           #
-          #   @return [Telnyx::Models::AI::Assistants::Tests::TestSuites::Meta]
-          required :meta, -> { Telnyx::AI::Assistants::Tests::TestSuites::Meta }
+          #   @return [String]
+          required :text, String
 
-          # @!method initialize(data:, meta:)
-          #   @param data [Array<Telnyx::Models::AI::Conversations::MessageListResponse::Data>]
-          #   @param meta [Telnyx::Models::AI::Assistants::Tests::TestSuites::Meta]
+          # @!attribute created_at
+          #   The datetime the message was created on the conversation. This does not
+          #   necesarily correspond to the time the message was sent. The best field to use to
+          #   determine the time the end user experienced the message is `sent_at`.
+          #
+          #   @return [Time, nil]
+          optional :created_at, Time
 
-          class Data < Telnyx::Internal::Type::BaseModel
-            # @!attribute role
-            #   The role of the message sender.
-            #
-            #   @return [Symbol, Telnyx::Models::AI::Conversations::MessageListResponse::Data::Role]
-            required :role, enum: -> { Telnyx::Models::AI::Conversations::MessageListResponse::Data::Role }
+          # @!attribute sent_at
+          #   The datetime the message was sent to the end user.
+          #
+          #   @return [Time, nil]
+          optional :sent_at, Time
 
-            # @!attribute text
-            #   The message content. Can be null for tool calls.
-            #
-            #   @return [String]
-            required :text, String
+          # @!attribute tool_calls
+          #   Optional tool calls made by the assistant.
+          #
+          #   @return [Array<Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall>, nil]
+          optional :tool_calls,
+                   -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall] }
 
-            # @!attribute created_at
-            #   The datetime the message was created on the conversation. This does not
-            #   necesarily correspond to the time the message was sent. The best field to use to
-            #   determine the time the end user experienced the message is `sent_at`.
-            #
-            #   @return [Time, nil]
-            optional :created_at, Time
+          # @!method initialize(role:, text:, created_at: nil, sent_at: nil, tool_calls: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::AI::Conversations::MessageListResponse} for more details.
+          #
+          #   @param role [Symbol, Telnyx::Models::AI::Conversations::MessageListResponse::Role] The role of the message sender.
+          #
+          #   @param text [String] The message content. Can be null for tool calls.
+          #
+          #   @param created_at [Time] The datetime the message was created on the conversation. This does not necesari
+          #
+          #   @param sent_at [Time] The datetime the message was sent to the end user.
+          #
+          #   @param tool_calls [Array<Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall>] Optional tool calls made by the assistant.
 
-            # @!attribute sent_at
-            #   The datetime the message was sent to the end user.
-            #
-            #   @return [Time, nil]
-            optional :sent_at, Time
+          # The role of the message sender.
+          #
+          # @see Telnyx::Models::AI::Conversations::MessageListResponse#role
+          module Role
+            extend Telnyx::Internal::Type::Enum
 
-            # @!attribute tool_calls
-            #   Optional tool calls made by the assistant.
-            #
-            #   @return [Array<Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall>, nil]
-            optional :tool_calls,
-                     -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall] }
+            USER = :user
+            ASSISTANT = :assistant
+            TOOL = :tool
 
-            # @!method initialize(role:, text:, created_at: nil, sent_at: nil, tool_calls: nil)
-            #   Some parameter documentations has been truncated, see
-            #   {Telnyx::Models::AI::Conversations::MessageListResponse::Data} for more details.
-            #
-            #   @param role [Symbol, Telnyx::Models::AI::Conversations::MessageListResponse::Data::Role] The role of the message sender.
-            #
-            #   @param text [String] The message content. Can be null for tool calls.
-            #
-            #   @param created_at [Time] The datetime the message was created on the conversation. This does not necesari
-            #
-            #   @param sent_at [Time] The datetime the message was sent to the end user.
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          class ToolCall < Telnyx::Internal::Type::BaseModel
+            # @!attribute id
+            #   Unique identifier for the tool call.
             #
-            #   @param tool_calls [Array<Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall>] Optional tool calls made by the assistant.
+            #   @return [String]
+            required :id, String
 
-            # The role of the message sender.
+            # @!attribute function
             #
-            # @see Telnyx::Models::AI::Conversations::MessageListResponse::Data#role
-            module Role
-              extend Telnyx::Internal::Type::Enum
+            #   @return [Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall::Function]
+            required :function, -> { Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall::Function }
 
-              USER = :user
-              ASSISTANT = :assistant
-              TOOL = :tool
+            # @!attribute type
+            #   Type of the tool call.
+            #
+            #   @return [Symbol, Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall::Type]
+            required :type, enum: -> { Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall::Type }
 
-              # @!method self.values
-              #   @return [Array<Symbol>]
-            end
+            # @!method initialize(id:, function:, type:)
+            #   @param id [String] Unique identifier for the tool call.
+            #
+            #   @param function [Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall::Function]
+            #
+            #   @param type [Symbol, Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall::Type] Type of the tool call.
 
-            class ToolCall < Telnyx::Internal::Type::BaseModel
-              # @!attribute id
-              #   Unique identifier for the tool call.
+            # @see Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall#function
+            class Function < Telnyx::Internal::Type::BaseModel
+              # @!attribute arguments
+              #   JSON-formatted arguments to pass to the function.
               #
               #   @return [String]
-              required :id, String
+              required :arguments, String
 
-              # @!attribute function
+              # @!attribute name
+              #   Name of the function to call.
               #
-              #   @return [Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall::Function]
-              required :function,
-                       -> { Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall::Function }
+              #   @return [String]
+              required :name, String
 
-              # @!attribute type
-              #   Type of the tool call.
+              # @!method initialize(arguments:, name:)
+              #   @param arguments [String] JSON-formatted arguments to pass to the function.
               #
-              #   @return [Symbol, Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall::Type]
-              required :type, enum: -> { Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall::Type }
+              #   @param name [String] Name of the function to call.
+            end
 
-              # @!method initialize(id:, function:, type:)
-              #   @param id [String] Unique identifier for the tool call.
-              #
-              #   @param function [Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall::Function]
-              #
-              #   @param type [Symbol, Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall::Type] Type of the tool call.
-
-              # @see Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall#function
-              class Function < Telnyx::Internal::Type::BaseModel
-                # @!attribute arguments
-                #   JSON-formatted arguments to pass to the function.
-                #
-                #   @return [String]
-                required :arguments, String
-
-                # @!attribute name
-                #   Name of the function to call.
-                #
-                #   @return [String]
-                required :name, String
-
-                # @!method initialize(arguments:, name:)
-                #   @param arguments [String] JSON-formatted arguments to pass to the function.
-                #
-                #   @param name [String] Name of the function to call.
-              end
-
-              # Type of the tool call.
-              #
-              # @see Telnyx::Models::AI::Conversations::MessageListResponse::Data::ToolCall#type
-              module Type
-                extend Telnyx::Internal::Type::Enum
+            # Type of the tool call.
+            #
+            # @see Telnyx::Models::AI::Conversations::MessageListResponse::ToolCall#type
+            module Type
+              extend Telnyx::Internal::Type::Enum
 
-                FUNCTION = :function
+              FUNCTION = :function
 
-                # @!method self.values
-                #   @return [Array<Symbol>]
-              end
+              # @!method self.values
+              #   @return [Array<Symbol>]
             end
           end
         end

data/lib/telnyx/models/call_dial_params.rb

@@ -52,7 +52,9 @@ module Telnyx
 
       # @!attribute answering_machine_detection_config
       #   Optional configuration parameters to modify 'answering_machine_detection'
-      #   performance.
+      #   performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
+      #   parameters are applicable when `premium` is selected as
+      #   answering_machine_detection.
       #
       #   @return [Telnyx::Models::CallDialParams::AnsweringMachineDetectionConfig, nil]
       optional :answering_machine_detection_config,
@@ -693,7 +695,9 @@ module Telnyx
         #   details.
         #
         #   Optional configuration parameters to modify 'answering_machine_detection'
-        #   performance.
+        #   performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
+        #   parameters are applicable when `premium` is selected as
+        #   answering_machine_detection.
         #
         #   @param after_greeting_silence_millis [Integer] Silence duration threshold after a greeting message or voice for it be considere
         #

data/lib/telnyx/models/calls/action_transfer_params.rb

@@ -34,7 +34,9 @@ module Telnyx
 
         # @!attribute answering_machine_detection_config
         #   Optional configuration parameters to modify 'answering_machine_detection'
-        #   performance.
+        #   performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
+        #   parameters are applicable when `premium` is selected as
+        #   answering_machine_detection.
         #
         #   @return [Telnyx::Models::Calls::ActionTransferParams::AnsweringMachineDetectionConfig, nil]
         optional :answering_machine_detection_config,
@@ -474,7 +476,9 @@ module Telnyx
           #   for more details.
           #
           #   Optional configuration parameters to modify 'answering_machine_detection'
-          #   performance.
+          #   performance. Only `total_analysis_time_millis` and `greeting_duration_millis`
+          #   parameters are applicable when `premium` is selected as
+          #   answering_machine_detection.
           #
           #   @param after_greeting_silence_millis [Integer] Silence duration threshold after a greeting message or voice for it be considere
           #

data/lib/telnyx/resources/ai/conversations/messages.rb

@@ -9,20 +9,29 @@ module Telnyx
           # Retrieve messages for a specific conversation, including tool calls made by the
           # assistant.
           #
-          # @overload list(conversation_id, request_options: {})
+          # @overload list(conversation_id, page_number: nil, page_size: nil, request_options: {})
           #
           # @param conversation_id [String]
+          #
+          # @param page_number [Integer] The page number to retrieve.
+          #
+          # @param page_size [Integer] The number of messages to return per page.
+          #
           # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
           #
-          # @return [Telnyx::Models::AI::Conversations::MessageListResponse]
+          # @return [Telnyx::Internal::DefaultFlatPagination<Telnyx::Models::AI::Conversations::MessageListResponse>]
           #
           # @see Telnyx::Models::AI::Conversations::MessageListParams
           def list(conversation_id, params = {})
+            parsed, options = Telnyx::AI::Conversations::MessageListParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
             @client.request(
               method: :get,
               path: ["ai/conversations/%1$s/messages", conversation_id],
+              query: query.transform_keys(page_number: "page[number]", page_size: "page[size]"),
+              page: Telnyx::Internal::DefaultFlatPagination,
               model: Telnyx::Models::AI::Conversations::MessageListResponse,
-              options: params[:request_options]
+              options: options
             )
           end
 

data/lib/telnyx/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Telnyx
-  VERSION = "5.76.0"
+  VERSION = "5.77.0"
 end

data/rbi/telnyx/models/ai/conversations/message_list_params.rbi

@@ -19,19 +19,44 @@ module Telnyx
           sig { returns(String) }
           attr_accessor :conversation_id
 
+          # The page number to retrieve.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :page_number
+
+          sig { params(page_number: Integer).void }
+          attr_writer :page_number
+
+          # The number of messages to return per page.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :page_size
+
+          sig { params(page_size: Integer).void }
+          attr_writer :page_size
+
           sig do
             params(
               conversation_id: String,
+              page_number: Integer,
+              page_size: Integer,
               request_options: Telnyx::RequestOptions::OrHash
             ).returns(T.attached_class)
           end
-          def self.new(conversation_id:, request_options: {})
+          def self.new(
+            conversation_id:,
+            # The page number to retrieve.
+            page_number: nil,
+            # The number of messages to return per page.
+            page_size: nil,
+            request_options: {}
+          )
           end
 
           sig do
             override.returns(
               {
                 conversation_id: String,
+                page_number: Integer,
+                page_size: Integer,
                 request_options: Telnyx::RequestOptions
               }
             )