telnyx 5.159.0 → 5.161.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ef3d02bb657bb6d91e6d90a8cad3873c5db29d4ba4ecb61e21fbf2efae59dcb
-  data.tar.gz: 71c473b3a79715cbbd52939409016def3959295c91a60d1523d44b74764b7e5e
+  metadata.gz: 2926183df9eba863cb9f3883645e4fda40856c5a009b3da68617ab423cf47132
+  data.tar.gz: 8986f6f68a2955e6d4bbb32c2d7544dcce8a2ac32fcfe8d5a2b6b0edd284c65c
 SHA512:
-  metadata.gz: 581c58a35b40cc249ef319daf7fe65f751236995fac4d017eba7815439154b540ad91f49c35e8869c0295a26e2d0d063a52e07929deed5b03f987236e6879676
-  data.tar.gz: 51743faea90266f4617c362a577f705156c2ab90f3f136940dab596622367e1b716adec87c111db38a77da6df647d8dcc9055fa84b89e7c11b2bc05f6e0d6b41
+  metadata.gz: dc3c5571dd5484d1ffaf401f0c9c0ff5bdfb1f1e68f434d269960e71b46eb0b1e4d3ff651051fb58ed5bf442743de9aaaa054d18d27bdbafe599fdc4ca7ee928
+  data.tar.gz: f40de206f27feb3dcd13a5e1314b691f5f76839522da610ea92d45a2dadf2980704a74ed2a47a615df76ed0c5e1788e96dfbe90273ab824aeb75d6f6f81109d8

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [5.161.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.160.0...v5.161.0) (2026-08-16)
+
+
+### Features
+
+* promote from staging 2ba3fff ([0ed0d6c](https://github.com/team-telnyx/telnyx-ruby/commit/0ed0d6c9d8dccdac163a918465ffdd03bace1211))
+
+
+### Bug Fixes
+
+* **ci:** attest private release provenance ([#342](https://github.com/team-telnyx/telnyx-ruby/issues/342)) ([b12f392](https://github.com/team-telnyx/telnyx-ruby/commit/b12f392866c7dc097b53d885762b11b222cd2e86))
+
+## [5.160.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.159.0...v5.160.0) (2026-08-11)
+
+
+### Features
+
+* promote from staging 6d802d8 ([6997207](https://github.com/team-telnyx/telnyx-ruby/commit/6997207468e5c2bd5224f2d0fbdcf469518819c6))
+
 ## [5.159.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.158.0...v5.159.0) (2026-08-03)
 
 

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

data/lib/telnyx/client.rb

@@ -275,7 +275,6 @@ module Telnyx
     # @return [Telnyx::Resources::Media]
     attr_reader :media
 
-    # Messages
     # @return [Telnyx::Resources::Messages]
     attr_reader :messages
 
@@ -421,8 +420,8 @@ module Telnyx
     # @return [Telnyx::Resources::Queues]
     attr_reader :queues
 
-    # @return [Telnyx::Resources::RcsAgents]
-    attr_reader :rcs_agents
+    # @return [Telnyx::Resources::Rcs]
+    attr_reader :rcs
 
     # Call Recordings operations.
     # @return [Telnyx::Resources::RecordingTranscriptions]
@@ -731,6 +730,12 @@ module Telnyx
     # @return [Telnyx::Resources::Pricing]
     attr_reader :pricing
 
+    # @return [Telnyx::Resources::WebSearch]
+    attr_reader :web_search
+
+    # @return [Telnyx::Resources::MeetingSessions]
+    attr_reader :meeting_sessions
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -942,7 +947,7 @@ module Telnyx
       @private_wireless_gateways = Telnyx::Resources::PrivateWirelessGateways.new(client: self)
       @public_internet_gateways = Telnyx::Resources::PublicInternetGateways.new(client: self)
       @queues = Telnyx::Resources::Queues.new(client: self)
-      @rcs_agents = Telnyx::Resources::RcsAgents.new(client: self)
+      @rcs = Telnyx::Resources::Rcs.new(client: self)
       @recording_transcriptions = Telnyx::Resources::RecordingTranscriptions.new(client: self)
       @recordings = Telnyx::Resources::Recordings.new(client: self)
       @regions = Telnyx::Resources::Regions.new(client: self)
@@ -1020,6 +1025,8 @@ module Telnyx
       @email_unsubscribe_groups = Telnyx::Resources::EmailUnsubscribeGroups.new(client: self)
       @email_validations = Telnyx::Resources::EmailValidations.new(client: self)
       @pricing = Telnyx::Resources::Pricing.new(client: self)
+      @web_search = Telnyx::Resources::WebSearch.new(client: self)
+      @meeting_sessions = Telnyx::Resources::MeetingSessions.new(client: self)
     end
   end
 end

data/lib/telnyx/models/actions/purchase_create_response.rb

@@ -13,13 +13,13 @@ module Telnyx
 
         # @!attribute errors
         #
-        #   @return [Array<Telnyx::Models::WirelessError>, nil]
-        optional :errors, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::WirelessError] }
+        #   @return [Array<Telnyx::Models::Actions::WirelessErrorC5290d5308>, nil]
+        optional :errors, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Actions::WirelessErrorC5290d5308] }
 
         # @!method initialize(data: nil, errors: nil)
         #   @param data [Array<Telnyx::Models::SimpleSimCard>] Successfully registered SIM cards.
         #
-        #   @param errors [Array<Telnyx::Models::WirelessError>]
+        #   @param errors [Array<Telnyx::Models::Actions::WirelessErrorC5290d5308>]
       end
     end
   end

data/lib/telnyx/models/actions/register_create_response.rb

@@ -13,13 +13,13 @@ module Telnyx
 
         # @!attribute errors
         #
-        #   @return [Array<Telnyx::Models::WirelessError>, nil]
-        optional :errors, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::WirelessError] }
+        #   @return [Array<Telnyx::Models::Actions::WirelessErrorC5290d5308>, nil]
+        optional :errors, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Actions::WirelessErrorC5290d5308] }
 
         # @!method initialize(data: nil, errors: nil)
         #   @param data [Array<Telnyx::Models::SimpleSimCard>] Successfully registered SIM cards.
         #
-        #   @param errors [Array<Telnyx::Models::WirelessError>]
+        #   @param errors [Array<Telnyx::Models::Actions::WirelessErrorC5290d5308>]
       end
     end
   end

data/lib/telnyx/models/actions/wireless_error_c5290d5308.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Actions
+      class WirelessErrorC5290d5308 < Telnyx::Internal::Type::BaseModel
+        # @!attribute code
+        #
+        #   @return [String]
+        required :code, String
+
+        # @!attribute title
+        #
+        #   @return [String]
+        required :title, String
+
+        # @!attribute detail
+        #
+        #   @return [String, nil]
+        optional :detail, String
+
+        # @!attribute meta
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :meta, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute source
+        #
+        #   @return [Telnyx::Models::Actions::WirelessErrorC5290d5308::Source, nil]
+        optional :source, -> { Telnyx::Actions::WirelessErrorC5290d5308::Source }
+
+        # @!method initialize(code:, title:, detail: nil, meta: nil, source: nil)
+        #   @param code [String]
+        #   @param title [String]
+        #   @param detail [String]
+        #   @param meta [Hash{Symbol=>Object}]
+        #   @param source [Telnyx::Models::Actions::WirelessErrorC5290d5308::Source]
+
+        # @see Telnyx::Models::Actions::WirelessErrorC5290d5308#source
+        class Source < Telnyx::Internal::Type::BaseModel
+          # @!attribute parameter
+          #   Indicates which query parameter caused the error.
+          #
+          #   @return [String, nil]
+          optional :parameter, String
+
+          # @!attribute pointer
+          #   JSON pointer (RFC6901) to the offending entity.
+          #
+          #   @return [String, nil]
+          optional :pointer, String
+
+          # @!method initialize(parameter: nil, pointer: nil)
+          #   @param parameter [String] Indicates which query parameter caused the error.
+          #
+          #   @param pointer [String] JSON pointer (RFC6901) to the offending entity.
+        end
+      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, Telnyx::Models::AI::AssistantTool::Pay>, 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, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, 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, Telnyx::Models::AI::AssistantTool::Pay>] 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, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] 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

@@ -38,6 +38,9 @@ module Telnyx
         # (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 }
 
+        # The update_dynamic_variables tool lets the assistant write values into the conversation's dynamic-variables context during the call. Updated variables are available to later `{{variable}}` interpolation (prompts, speak nodes, message templates) and to flow edge conditions. Declare each variable the assistant is allowed to set under `updatable_variables`.
+        variant :update_dynamic_variables, -> { Telnyx::AI::AssistantTool::UpdateDynamicVariables }
+
         class ClientSideTool < Telnyx::Internal::Type::BaseModel
           # @!attribute client_side_tool
           #
@@ -1069,8 +1072,32 @@ module Telnyx
           #   @param type [Symbol, :pay]
         end
 
+        class UpdateDynamicVariables < Telnyx::Internal::Type::BaseModel
+          # @!attribute type
+          #
+          #   @return [Symbol, :update_dynamic_variables]
+          required :type, const: :update_dynamic_variables
+
+          # @!attribute update_dynamic_variables
+          #   Configuration for an update_dynamic_variables tool.
+          #
+          #   @return [Telnyx::Models::AI::UpdateDynamicVariablesToolParams]
+          required :update_dynamic_variables, -> { Telnyx::AI::UpdateDynamicVariablesToolParams }
+
+          # @!method initialize(update_dynamic_variables:, type: :update_dynamic_variables)
+          #   The update_dynamic_variables tool lets the assistant write values into the
+          #   conversation's dynamic-variables context during the call. Updated variables are
+          #   available to later `{{variable}}` interpolation (prompts, speak nodes, message
+          #   templates) and to flow edge conditions. Declare each variable the assistant is
+          #   allowed to set under `updatable_variables`.
+          #
+          #   @param update_dynamic_variables [Telnyx::Models::AI::UpdateDynamicVariablesToolParams] Configuration for an update_dynamic_variables tool.
+          #
+          #   @param type [Symbol, :update_dynamic_variables]
+        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, Telnyx::Models::AI::AssistantTool::Pay)]
+        #   @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, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables)]
       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, Telnyx::Models::AI::AssistantTool::Pay>, 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, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, 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, Telnyx::Models::AI::AssistantTool::Pay>] 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, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] 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, Telnyx::Models::AI::AssistantTool::Pay>, 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, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>, 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, Telnyx::Models::AI::AssistantTool::Pay>] 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, Telnyx::Models::AI::AssistantTool::UpdateDynamicVariables>] Deprecated for new integrations. Inline tool definitions available to the assist
           #
           #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]
           #

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

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Collections#list
+      class Collection < Telnyx::Internal::Type::BaseModel
+        # @!attribute created_at
+        #
+        #   @return [Time, nil]
+        optional :created_at, Time
+
+        # @!attribute description
+        #
+        #   @return [String, nil]
+        optional :description, String
+
+        # @!attribute name
+        #
+        #   @return [String, nil]
+        optional :name, String
+
+        # @!attribute record_type
+        #   Identifies the record type. Always `ai_collection`.
+        #
+        #   @return [String, nil]
+        optional :record_type, String
+
+        # @!attribute settings
+        #
+        #   @return [Telnyx::Models::AI::Collections::RetrievalSettingsWrapper, nil]
+        optional :settings, -> { Telnyx::AI::Collections::RetrievalSettingsWrapper }
+
+        # @!attribute slug
+        #
+        #   @return [String, nil]
+        optional :slug, String
+
+        # @!attribute sources
+        #
+        #   @return [Array<Telnyx::Models::AI::Collections::Source>, nil]
+        optional :sources, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::Collections::Source] }
+
+        # @!attribute status
+        #
+        #   @return [String, nil]
+        optional :status, String
+
+        # @!attribute updated_at
+        #
+        #   @return [Time, nil]
+        optional :updated_at, Time
+
+        # @!attribute uuid
+        #
+        #   @return [String, nil]
+        optional :uuid, String
+
+        # @!method initialize(created_at: nil, description: nil, name: nil, record_type: nil, settings: nil, slug: nil, sources: nil, status: nil, updated_at: nil, uuid: nil)
+        #   @param created_at [Time]
+        #
+        #   @param description [String]
+        #
+        #   @param name [String]
+        #
+        #   @param record_type [String] Identifies the record type. Always `ai_collection`.
+        #
+        #   @param settings [Telnyx::Models::AI::Collections::RetrievalSettingsWrapper]
+        #
+        #   @param slug [String]
+        #
+        #   @param sources [Array<Telnyx::Models::AI::Collections::Source>]
+        #
+        #   @param status [String]
+        #
+        #   @param updated_at [Time]
+        #
+        #   @param uuid [String]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Collections#create
+      class CollectionCreateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute name
+        #   Human-readable collection name.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute description
+        #   Optional description.
+        #
+        #   @return [String, nil]
+        optional :description, String
+
+        # @!attribute settings
+        #   Optional retrieval settings.
+        #
+        #   @return [Telnyx::Models::AI::Collections::RetrievalSettingsWrapper, nil]
+        optional :settings, -> { Telnyx::AI::Collections::RetrievalSettingsWrapper }
+
+        # @!attribute slug
+        #   Optional slug (unique per organization). Derived from `name` when omitted.
+        #
+        #   @return [String, nil]
+        optional :slug, String
+
+        # @!attribute sources
+        #   Optional sources to attach at creation time.
+        #
+        #   @return [Array<Telnyx::Models::AI::Collections::SourceRequest>, nil]
+        optional :sources, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::Collections::SourceRequest] }
+
+        # @!method initialize(name:, description: nil, settings: nil, slug: nil, sources: nil, request_options: {})
+        #   @param name [String] Human-readable collection name.
+        #
+        #   @param description [String] Optional description.
+        #
+        #   @param settings [Telnyx::Models::AI::Collections::RetrievalSettingsWrapper] Optional retrieval settings.
+        #
+        #   @param slug [String] Optional slug (unique per organization). Derived from `name` when omitted.
+        #
+        #   @param sources [Array<Telnyx::Models::AI::Collections::SourceRequest>] Optional sources to attach at creation time.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Collections#delete
+      class CollectionDeleteParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute uuid
+        #
+        #   @return [String]
+        required :uuid, String
+
+        # @!method initialize(uuid:, request_options: {})
+        #   @param uuid [String]
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Collections#create
+      class CollectionEnvelope < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #
+        #   @return [Telnyx::Models::AI::Collection, nil]
+        optional :data, -> { Telnyx::AI::Collection }
+
+        # @!method initialize(data: nil)
+        #   @param data [Telnyx::Models::AI::Collection]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Collections#list
+      class CollectionListParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute page_number
+        #   Page number to return (1-based). Defaults to 1.
+        #
+        #   @return [Integer, nil]
+        optional :page_number, Integer
+
+        # @!attribute page_size
+        #   Number of results per page. Defaults to 20.
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!method initialize(page_number: nil, page_size: nil, request_options: {})
+        #   @param page_number [Integer] Page number to return (1-based). Defaults to 1.
+        #
+        #   @param page_size [Integer] Number of results per page. Defaults to 20.
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Collections#retrieve_by_id
+      class CollectionRetrieveByIDParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute uuid
+        #
+        #   @return [String]
+        required :uuid, String
+
+        # @!method initialize(uuid:, request_options: {})
+        #   @param uuid [String]
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Collections#retrieve_documents
+      class CollectionRetrieveDocumentsParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute slug
+        #
+        #   @return [String]
+        required :slug, String
+
+        # @!attribute filter
+        #   Field filters applied before ranking, using `filter[field][operator]=value`.
+        #   Supported operators: `eq` (default), `in`, `gte`, `gt`, `lte`, `lt`, `contains`.
+        #   Known fields: `record_type`, `record_id`, `user_id`, `record_created_at`,
+        #   `ingested_at`; any other name resolves to a `metadata.<field>` filter. Example:
+        #   `filter[record_id][eq]=rec_123`.
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :filter, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute page_number
+        #   Page number to return (1-based). Defaults to 1.
+        #
+        #   @return [Integer, nil]
+        optional :page_number, Integer
+
+        # @!attribute page_size
+        #   Number of results per page. Defaults to 20.
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!attribute query
+        #   Natural-language search query. When provided, the text is matched against the
+        #   collection's document chunks using the collection's `retrieval_type` (vector or
+        #   hybrid). When omitted, documents are returned as a plain catalog listing.
+        #
+        #   @return [String, nil]
+        optional :query, String
+
+        # @!attribute retrieval_type
+        #   Override the collection's configured retrieval strategy for this request. Echoed
+        #   back in `meta.retrieval_type`.
+        #
+        #   @return [Symbol, Telnyx::Models::AI::CollectionRetrieveDocumentsParams::RetrievalType, nil]
+        optional :retrieval_type, enum: -> { Telnyx::AI::CollectionRetrieveDocumentsParams::RetrievalType }
+
+        # @!attribute sources
+        #   Comma-separated list of source types to restrict the search to. When omitted,
+        #   all of the collection's sources are searched.
+        #
+        #   @return [String, nil]
+        optional :sources, String
+
+        # @!attribute top_k
+        #   Maximum number of ranked results to consider. When omitted, the collection's
+        #   configured `top_k` setting is used.
+        #
+        #   @return [Integer, nil]
+        optional :top_k, Integer
+
+        # @!method initialize(slug:, filter: nil, page_number: nil, page_size: nil, query: nil, retrieval_type: nil, sources: nil, top_k: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::AI::CollectionRetrieveDocumentsParams} for more details.
+        #
+        #   @param slug [String]
+        #
+        #   @param filter [Hash{Symbol=>Object}] Field filters applied before ranking, using `filter[field][operator]=value`. Sup
+        #
+        #   @param page_number [Integer] Page number to return (1-based). Defaults to 1.
+        #
+        #   @param page_size [Integer] Number of results per page. Defaults to 20.
+        #
+        #   @param query [String] Natural-language search query. When provided, the text is matched against the co
+        #
+        #   @param retrieval_type [Symbol, Telnyx::Models::AI::CollectionRetrieveDocumentsParams::RetrievalType] Override the collection's configured retrieval strategy for this request. Echoed
+        #
+        #   @param sources [String] Comma-separated list of source types to restrict the search to. When omitted, al
+        #
+        #   @param top_k [Integer] Maximum number of ranked results to consider. When omitted, the collection's con
+        #
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+        # Override the collection's configured retrieval strategy for this request. Echoed
+        # back in `meta.retrieval_type`.
+        module RetrievalType
+          extend Telnyx::Internal::Type::Enum
+
+          VECTOR = :vector
+          HYBRID = :hybrid
+          KEYWORD = :keyword
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end