telnyx 5.63.0 → 5.65.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a25e60fb729312e93e742112b5ce176dd554572fb54f464a8d0c602fbcfd078
-  data.tar.gz: 5aa7d25774c30d13801a2c05f1d2826baeac6a70df9054304f815512fa89bb60
+  metadata.gz: 4482cc328c3e6d2041574cddfda44fc2ec08a9a1b1134b90c1ad7075100934c8
+  data.tar.gz: 01b1df067f588988896ded2b7d9f25bcdf88969ff2adbf2bd4351e0eb6fe0d4b
 SHA512:
-  metadata.gz: b90d19304721075def555a581ee058fc8487a7390d830e816ff72727dbc2cc11ecc58d78bebb98ac3b83efa481cc52238ec8d9788e1a1bed16847a1e54a7139f
-  data.tar.gz: 12bf8d3cc7a0bc3500e82746fd8b17d2b4c53112d4861bca42a01a9fd3630a26c6f660d068759f1ed2da4a2738b33f8b81021b786b57e5facc05212cd12bf088
+  metadata.gz: 2d8c0b98d86b972aa768cc77e9389fddde7b25f9ffe9c505f269287964ffed4a7c224ab20c45bf37a2dc931f6cd779effcda4882a00860bba5b133a6435be564
+  data.tar.gz: 3b7d417c854a13940fef44962375c1e8e3609046ed1cad17007c97ea803e02055c25820af21683543011e7195dc572e393ca0cf76fa2ada5a8a295a742afffa3

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 5.65.0 (2026-03-24)
+
+Full Changelog: [v5.64.0...v5.65.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.64.0...v5.65.0)
+
+### Features
+
+* New tools api ([0d4a318](https://github.com/team-telnyx/telnyx-ruby/commit/0d4a318b82132d25a28f85620da0bb05599c3ea2))
+
+## 5.64.0 (2026-03-24)
+
+Full Changelog: [v5.63.0...v5.64.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.63.0...v5.64.0)
+
+### Features
+
+* TELAPPS-5685: Add store_fields_as_variables to WebhookToolParams ([603352b](https://github.com/team-telnyx/telnyx-ruby/commit/603352b0959551b578a0092f2b060ff008a17c47))
+
 ## 5.63.0 (2026-03-24)
 
 Full Changelog: [v5.62.0...v5.63.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.62.0...v5.63.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.63.0"
+gem "telnyx", "~> 5.65.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -94,6 +94,11 @@ module Telnyx
         #   @return [Telnyx::Models::AI::TelephonySettings, nil]
         optional :telephony_settings, -> { Telnyx::AI::TelephonySettings }
 
+        # @!attribute tool_ids
+        #
+        #   @return [Array<String>, nil]
+        optional :tool_ids, Telnyx::Internal::Type::ArrayOf[String]
+
         # @!attribute tools
         #   The tools that the assistant can use. These may be templated with
         #   [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
@@ -117,7 +122,7 @@ module Telnyx
         #   @return [Telnyx::Models::AI::WidgetSettings, nil]
         optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-        # @!method initialize(instructions:, model:, name:, description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, llm_api_key_ref: nil, messaging_settings: nil, privacy_settings: nil, telephony_settings: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, request_options: {})
+        # @!method initialize(instructions:, model:, name:, description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, llm_api_key_ref: nil, messaging_settings: nil, privacy_settings: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::AssistantCreateParams} for more details.
         #
@@ -147,6 +152,8 @@ module Telnyx
         #
         #   @param telephony_settings [Telnyx::Models::AI::TelephonySettings]
         #
+        #   @param tool_ids [Array<String>]
+        #
         #   @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>] The tools that the assistant can use. These may be templated with [dynamic varia
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]

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

@@ -106,6 +106,11 @@ module Telnyx
         #   @return [Telnyx::Models::AI::TelephonySettings, nil]
         optional :telephony_settings, -> { Telnyx::AI::TelephonySettings }
 
+        # @!attribute tool_ids
+        #
+        #   @return [Array<String>, nil]
+        optional :tool_ids, Telnyx::Internal::Type::ArrayOf[String]
+
         # @!attribute tools
         #   The tools that the assistant can use. These may be templated with
         #   [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
@@ -129,7 +134,7 @@ module Telnyx
         #   @return [Telnyx::Models::AI::WidgetSettings, nil]
         optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-        # @!method initialize(assistant_id:, description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, instructions: nil, llm_api_key_ref: nil, messaging_settings: nil, model: nil, name: nil, privacy_settings: nil, promote_to_main: nil, telephony_settings: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, request_options: {})
+        # @!method initialize(assistant_id:, description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, instructions: nil, llm_api_key_ref: nil, messaging_settings: nil, model: nil, name: nil, privacy_settings: nil, promote_to_main: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Telnyx::Models::AI::AssistantUpdateParams} for more details.
         #
@@ -163,6 +168,8 @@ module Telnyx
         #
         #   @param telephony_settings [Telnyx::Models::AI::TelephonySettings]
         #
+        #   @param tool_ids [Array<String>]
+        #
         #   @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>] The tools that the assistant can use. These may be templated with [dynamic varia
         #
         #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Assistants
+        # @see Telnyx::Resources::AI::Assistants::Tools#add
+        class ToolAddParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute assistant_id
+          #
+          #   @return [String]
+          required :assistant_id, String
+
+          # @!attribute tool_id
+          #
+          #   @return [String]
+          required :tool_id, String
+
+          # @!method initialize(assistant_id:, tool_id:, request_options: {})
+          #   @param assistant_id [String]
+          #   @param tool_id [String]
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      module Assistants
+        # @see Telnyx::Resources::AI::Assistants::Tools#remove
+        class ToolRemoveParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          # @!attribute assistant_id
+          #
+          #   @return [String]
+          required :assistant_id, String
+
+          # @!attribute tool_id
+          #
+          #   @return [String]
+          required :tool_id, String
+
+          # @!method initialize(assistant_id:, tool_id:, request_options: {})
+          #   @param assistant_id [String]
+          #   @param tool_id [String]
+          #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+        end
+      end
+    end
+  end
+end

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

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

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

@@ -91,6 +91,11 @@ module Telnyx
           #   @return [Telnyx::Models::AI::TelephonySettings, nil]
           optional :telephony_settings, -> { Telnyx::AI::TelephonySettings }
 
+          # @!attribute tool_ids
+          #
+          #   @return [Array<String>, nil]
+          optional :tool_ids, Telnyx::Internal::Type::ArrayOf[String]
+
           # @!attribute tools
           #   The tools that the assistant can use. These may be templated with
           #   [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
@@ -114,7 +119,7 @@ module Telnyx
           #   @return [Telnyx::Models::AI::WidgetSettings, nil]
           optional :widget_settings, -> { Telnyx::AI::WidgetSettings }
 
-          # @!method initialize(description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, instructions: nil, llm_api_key_ref: nil, messaging_settings: nil, model: nil, name: nil, privacy_settings: nil, telephony_settings: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil)
+          # @!method initialize(description: nil, dynamic_variables: nil, dynamic_variables_webhook_url: nil, enabled_features: nil, greeting: nil, insight_settings: nil, instructions: nil, llm_api_key_ref: nil, messaging_settings: nil, model: nil, name: nil, privacy_settings: nil, telephony_settings: nil, tool_ids: nil, tools: nil, transcription: nil, voice_settings: nil, widget_settings: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::AI::Assistants::UpdateAssistant} for more details.
           #
@@ -144,6 +149,8 @@ module Telnyx
           #
           #   @param telephony_settings [Telnyx::Models::AI::TelephonySettings]
           #
+          #   @param tool_ids [Array<String>]
+          #
           #   @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>] The tools that the assistant can use. These may be templated with [dynamic varia
           #
           #   @param transcription [Telnyx::Models::AI::TranscriptionSettings]

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

@@ -103,6 +103,15 @@ module Telnyx
           optional :query_parameters,
                    -> { Telnyx::AI::InferenceEmbeddingWebhookToolParams::Webhook::QueryParameters }
 
+          # @!attribute store_fields_as_variables
+          #   A list of mappings that extract values from the webhook response and store them
+          #   as dynamic variables. Each mapping specifies a dynamic variable name and a
+          #   dot-notation path to the value in the response body.
+          #
+          #   @return [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook::StoreFieldsAsVariable>, nil]
+          optional :store_fields_as_variables,
+                   -> { Telnyx::Internal::Type::ArrayOf[Telnyx::AI::InferenceEmbeddingWebhookToolParams::Webhook::StoreFieldsAsVariable] }
+
           # @!attribute timeout_ms
           #   The maximum number of milliseconds to wait for the webhook to respond. Only
           #   applicable when async is false.
@@ -110,7 +119,7 @@ module Telnyx
           #   @return [Integer, nil]
           optional :timeout_ms, Integer
 
-          # @!method initialize(description:, name:, url:, async: nil, body_parameters: nil, headers: nil, http_method: nil, path_parameters: nil, query_parameters: nil, timeout_ms: nil)
+          # @!method initialize(description:, name:, url:, async: nil, body_parameters: nil, headers: nil, http_method: nil, path_parameters: nil, query_parameters: nil, store_fields_as_variables: nil, timeout_ms: nil)
           #   Some parameter documentations has been truncated, see
           #   {Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook} for more
           #   details.
@@ -133,6 +142,8 @@ module Telnyx
           #
           #   @param query_parameters [Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook::QueryParameters] The query parameters the webhook tool accepts, described as a JSON Schema object
           #
+          #   @param store_fields_as_variables [Array<Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook::StoreFieldsAsVariable>] A list of mappings that extract values from the webhook response and store them
+          #
           #   @param timeout_ms [Integer] The maximum number of milliseconds to wait for the webhook to respond. Only appl
 
           # @see Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook#body_parameters
@@ -308,6 +319,30 @@ module Telnyx
               #   @return [Array<Symbol>]
             end
           end
+
+          class StoreFieldsAsVariable < Telnyx::Internal::Type::BaseModel
+            # @!attribute name
+            #   The name of the dynamic variable to store the extracted value in.
+            #
+            #   @return [String]
+            required :name, String
+
+            # @!attribute value_path
+            #   A dot-notation path to the value in the webhook response body (e.g.
+            #   'customer.name' or 'id').
+            #
+            #   @return [String]
+            required :value_path, String
+
+            # @!method initialize(name:, value_path:)
+            #   Some parameter documentations has been truncated, see
+            #   {Telnyx::Models::AI::InferenceEmbeddingWebhookToolParams::Webhook::StoreFieldsAsVariable}
+            #   for more details.
+            #
+            #   @param name [String] The name of the dynamic variable to store the extracted value in.
+            #
+            #   @param value_path [String] A dot-notation path to the value in the webhook response body (e.g. 'customer.na
+          end
         end
       end
     end

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

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Tools#create
+      class ToolCreateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute display_name
+        #
+        #   @return [String]
+        required :display_name, String
+
+        # @!attribute type
+        #
+        #   @return [String]
+        required :type, String
+
+        # @!attribute function
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :function, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute handoff
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :handoff, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute invite
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :invite, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute retrieval
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :retrieval, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute timeout_ms
+        #
+        #   @return [Integer, nil]
+        optional :timeout_ms, Integer
+
+        # @!attribute webhook
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :webhook, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!method initialize(display_name:, type:, function: nil, handoff: nil, invite: nil, retrieval: nil, timeout_ms: nil, webhook: nil, request_options: {})
+        #   @param display_name [String]
+        #   @param type [String]
+        #   @param function [Hash{Symbol=>Object}]
+        #   @param handoff [Hash{Symbol=>Object}]
+        #   @param invite [Hash{Symbol=>Object}]
+        #   @param retrieval [Hash{Symbol=>Object}]
+        #   @param timeout_ms [Integer]
+        #   @param webhook [Hash{Symbol=>Object}]
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Tools#create
+      class ToolCreateResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute tool_definition
+        #
+        #   @return [Hash{Symbol=>Object}]
+        required :tool_definition, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute type
+        #
+        #   @return [String]
+        required :type, String
+
+        # @!attribute created_at
+        #
+        #   @return [String, nil]
+        optional :created_at, String
+
+        # @!attribute display_name
+        #
+        #   @return [String, nil]
+        optional :display_name, String
+
+        # @!attribute timeout_ms
+        #
+        #   @return [Integer, nil]
+        optional :timeout_ms, Integer
+
+        # @!method initialize(id:, tool_definition:, type:, created_at: nil, display_name: nil, timeout_ms: nil)
+        #   @param id [String]
+        #   @param tool_definition [Hash{Symbol=>Object}]
+        #   @param type [String]
+        #   @param created_at [String]
+        #   @param display_name [String]
+        #   @param timeout_ms [Integer]
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @type [Telnyx::Internal::Type::Converter]
+      ToolDeleteResponse = Telnyx::Internal::Type::Unknown
+    end
+  end
+end

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

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Tools#list
+      class ToolListParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute filter_name
+        #
+        #   @return [String, nil]
+        optional :filter_name, String
+
+        # @!attribute filter_type
+        #
+        #   @return [String, nil]
+        optional :filter_type, String
+
+        # @!attribute page_number
+        #
+        #   @return [Integer, nil]
+        optional :page_number, Integer
+
+        # @!attribute page_size
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!method initialize(filter_name: nil, filter_type: nil, page_number: nil, page_size: nil, request_options: {})
+        #   @param filter_name [String]
+        #   @param filter_type [String]
+        #   @param page_number [Integer]
+        #   @param page_size [Integer]
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Tools#list
+      class ToolListResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute tool_definition
+        #
+        #   @return [Hash{Symbol=>Object}]
+        required :tool_definition, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute type
+        #
+        #   @return [String]
+        required :type, String
+
+        # @!attribute created_at
+        #
+        #   @return [String, nil]
+        optional :created_at, String
+
+        # @!attribute display_name
+        #
+        #   @return [String, nil]
+        optional :display_name, String
+
+        # @!attribute timeout_ms
+        #
+        #   @return [Integer, nil]
+        optional :timeout_ms, Integer
+
+        # @!method initialize(id:, tool_definition:, type:, created_at: nil, display_name: nil, timeout_ms: nil)
+        #   @param id [String]
+        #   @param tool_definition [Hash{Symbol=>Object}]
+        #   @param type [String]
+        #   @param created_at [String]
+        #   @param display_name [String]
+        #   @param timeout_ms [Integer]
+      end
+    end
+  end
+end

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

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

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Tools#retrieve
+      class ToolRetrieveResponse < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute tool_definition
+        #
+        #   @return [Hash{Symbol=>Object}]
+        required :tool_definition, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute type
+        #
+        #   @return [String]
+        required :type, String
+
+        # @!attribute created_at
+        #
+        #   @return [String, nil]
+        optional :created_at, String
+
+        # @!attribute display_name
+        #
+        #   @return [String, nil]
+        optional :display_name, String
+
+        # @!attribute timeout_ms
+        #
+        #   @return [Integer, nil]
+        optional :timeout_ms, Integer
+
+        # @!method initialize(id:, tool_definition:, type:, created_at: nil, display_name: nil, timeout_ms: nil)
+        #   @param id [String]
+        #   @param tool_definition [Hash{Symbol=>Object}]
+        #   @param type [String]
+        #   @param created_at [String]
+        #   @param display_name [String]
+        #   @param timeout_ms [Integer]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module AI
+      # @see Telnyx::Resources::AI::Tools#update
+      class ToolUpdateParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        # @!attribute tool_id
+        #
+        #   @return [String]
+        required :tool_id, String
+
+        # @!attribute display_name
+        #
+        #   @return [String, nil]
+        optional :display_name, String
+
+        # @!attribute function
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :function, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute handoff
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :handoff, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute invite
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :invite, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute retrieval
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :retrieval, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!attribute timeout_ms
+        #
+        #   @return [Integer, nil]
+        optional :timeout_ms, Integer
+
+        # @!attribute type
+        #
+        #   @return [String, nil]
+        optional :type, String
+
+        # @!attribute webhook
+        #
+        #   @return [Hash{Symbol=>Object}, nil]
+        optional :webhook, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
+
+        # @!method initialize(tool_id:, display_name: nil, function: nil, handoff: nil, invite: nil, retrieval: nil, timeout_ms: nil, type: nil, webhook: nil, request_options: {})
+        #   @param tool_id [String]
+        #   @param display_name [String]
+        #   @param function [Hash{Symbol=>Object}]
+        #   @param handoff [Hash{Symbol=>Object}]
+        #   @param invite [Hash{Symbol=>Object}]
+        #   @param retrieval [Hash{Symbol=>Object}]
+        #   @param timeout_ms [Integer]
+        #   @param type [String]
+        #   @param webhook [Hash{Symbol=>Object}]
+        #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end