telnyx 5.155.0 → 5.157.0

data/lib/telnyx/models/storage/cloudfs_filesystem_response_wrapper.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # @see Telnyx::Resources::Storage::Cloudfs#create
+      class CloudfsFilesystemResponseWrapper < Telnyx::Internal::Type::BaseModel
+        # @!attribute data
+        #   A CloudFS filesystem, including its metadata credential. This shape is returned
+        #   only by create and rotate-meta-token.
+        #
+        #   @return [Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper::Data, nil]
+        optional :data, -> { Telnyx::Storage::CloudfsFilesystemResponseWrapper::Data }
+
+        # @!method initialize(data: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper} for more details.
+        #
+        #   @param data [Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper::Data] A CloudFS filesystem, including its metadata credential. This shape is returned
+
+        # @see Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper#data
+        class Data < Telnyx::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String, nil]
+          optional :id, String
+
+          # @!attribute created_at
+          #
+          #   @return [Time, nil]
+          optional :created_at, Time
+
+          # @!attribute meta_token
+          #   Metadata access token, in cleartext. Returned only by create and
+          #   rotate-meta-token and not retrievable afterwards — store it securely.
+          #
+          #   @return [String, nil]
+          optional :meta_token, String
+
+          # @!attribute meta_url
+          #   PostgreSQL connection URL for the filesystem's metadata database. In create and
+          #   rotate-meta-token responses it embeds the metadata token as the password:
+          #   `postgres://<database>:<meta_token>@us-east-1.telnyxcloudfs.com:5432/<database>?sslmode=require`
+          #   (the example below is shown without the credential; the actual response includes
+          #   it). Pass it to `juicefs mount`: the storage configuration is baked in at
+          #   provisioning, so the metadata URL is all a client needs to mount the filesystem.
+          #
+          #   @return [String, nil]
+          optional :meta_url, String
+
+          # @!attribute name
+          #
+          #   @return [String, nil]
+          optional :name, String
+
+          # @!attribute record_type
+          #
+          #   @return [String, nil]
+          optional :record_type, String
+
+          # @!attribute region
+          #
+          #   @return [String, nil]
+          optional :region, String
+
+          # @!attribute s3_bucket
+          #   Name of the bucket that stores this filesystem's data. Created during
+          #   provisioning.
+          #
+          #   @return [String, nil]
+          optional :s3_bucket, String
+
+          # @!attribute s3_endpoint
+          #   URL of the Telnyx Cloud Storage endpoint backing this filesystem.
+          #
+          #   @return [String, nil]
+          optional :s3_endpoint, String
+
+          # @!attribute status
+          #   Lifecycle status of the filesystem. `ready` means it is fully provisioned and
+          #   usable. `needs_format` means the storage bucket and metadata database were
+          #   provisioned but the filesystem has not yet been formatted — run `juicefs format`
+          #   with the filesystem's `meta_url` before mounting. `failed` means the last
+          #   lifecycle action failed — see the filesystem's `error` message. `deleted`
+          #   appears only in the delete response: deleted filesystems are excluded from list
+          #   results and return a `404` on retrieval.
+          #
+          #   @return [Symbol, Telnyx::Models::Storage::CloudfsFilesystemStatus, nil]
+          optional :status, enum: -> { Telnyx::Storage::CloudfsFilesystemStatus }
+
+          # @!attribute updated_at
+          #
+          #   @return [Time, nil]
+          optional :updated_at, Time
+
+          # @!method initialize(id: nil, created_at: nil, meta_token: nil, meta_url: nil, name: nil, record_type: nil, region: nil, s3_bucket: nil, s3_endpoint: nil, status: nil, updated_at: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Telnyx::Models::Storage::CloudfsFilesystemResponseWrapper::Data} for more
+          #   details.
+          #
+          #   A CloudFS filesystem, including its metadata credential. This shape is returned
+          #   only by create and rotate-meta-token.
+          #
+          #   @param id [String]
+          #
+          #   @param created_at [Time]
+          #
+          #   @param meta_token [String] Metadata access token, in cleartext. Returned only by create and rotate-meta-tok
+          #
+          #   @param meta_url [String] PostgreSQL connection URL for the filesystem's metadata database. In create and
+          #
+          #   @param name [String]
+          #
+          #   @param record_type [String]
+          #
+          #   @param region [String]
+          #
+          #   @param s3_bucket [String] Name of the bucket that stores this filesystem's data. Created during provisioni
+          #
+          #   @param s3_endpoint [String] URL of the Telnyx Cloud Storage endpoint backing this filesystem.
+          #
+          #   @param status [Symbol, Telnyx::Models::Storage::CloudfsFilesystemStatus] Lifecycle status of the filesystem. `ready` means it is fully provisioned and us
+          #
+          #   @param updated_at [Time]
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/storage/cloudfs_filesystem_status.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    module Storage
+      # Lifecycle status of the filesystem. `ready` means it is fully provisioned and
+      # usable. `needs_format` means the storage bucket and metadata database were
+      # provisioned but the filesystem has not yet been formatted — run `juicefs format`
+      # with the filesystem's `meta_url` before mounting. `failed` means the last
+      # lifecycle action failed — see the filesystem's `error` message. `deleted`
+      # appears only in the delete response: deleted filesystems are excluded from list
+      # results and return a `404` on retrieval.
+      module CloudfsFilesystemStatus
+        extend Telnyx::Internal::Type::Enum
+
+        PROVISIONING = :provisioning
+        READY = :ready
+        NEEDS_FORMAT = :needs_format
+        DELETING = :deleting
+        FAILED = :failed
+        DELETED = :deleted
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/text_to_speech_generate_speech_params.rb

@@ -71,7 +71,9 @@ module Telnyx
       # @!attribute telnyx
       #   Telnyx provider-specific parameters. Use `voice_speed` and `temperature` for
       #   `Natural` and `NaturalHD` models. For the `Ultra` model, use `voice_speed`,
-      #   `volume`, and `emotion`.
+      #   `volume`, and `emotion`. `Bayan` and `Sukhan` don't use `temperature`, `volume`,
+      #   or `emotion`, and don't support `voice_speed`. `Sukhan`'s `response_format` is
+      #   restricted to `mp3` or `pcm` (no `wav`).
       #
       #   @return [::Telnyx::Models::TextToSpeechGenerateSpeechParams::Telnyx, nil]
       optional :telnyx, -> { ::Telnyx::TextToSpeechGenerateSpeechParams::Telnyx }
@@ -91,10 +93,10 @@ module Telnyx
       # @!attribute voice
       #   Voice identifier in the format `provider.model_id.voice_id` or
       #   `provider.voice_id`. Examples: `telnyx.NaturalHD.Alloy`,
-      #   `Telnyx.Ultra.<voice_id>`, `azure.en-US-AvaMultilingualNeural`,
-      #   `aws.Polly.Generative.Lucia`. When provided, `provider`, `model_id`, and
-      #   `voice_id` are extracted automatically and take precedence over individual
-      #   parameters.
+      #   `Telnyx.Ultra.<voice_id>`, `Telnyx.Bayan.Ahmed`, `Telnyx.Sukhan.urdu-professor`,
+      #   `azure.en-US-AvaMultilingualNeural`, `aws.Polly.Generative.Lucia`. When
+      #   provided, `provider`, `model_id`, and `voice_id` are extracted automatically and
+      #   take precedence over individual parameters.
       #
       #   @return [String, nil]
       optional :voice, String
@@ -486,7 +488,8 @@ module Telnyx
         optional :temperature, Float
 
         # @!attribute voice_speed
-        #   Voice speed multiplier. Applies to all models. Range: 0.5 to 2.0.
+        #   Voice speed multiplier. Applies to all models except `Bayan` and `Sukhan`, which
+        #   don't support it. Range: 0.5 to 2.0.
         #
         #   @return [Float, nil]
         optional :voice_speed, Float
@@ -503,7 +506,9 @@ module Telnyx
         #
         #   Telnyx provider-specific parameters. Use `voice_speed` and `temperature` for
         #   `Natural` and `NaturalHD` models. For the `Ultra` model, use `voice_speed`,
-        #   `volume`, and `emotion`.
+        #   `volume`, and `emotion`. `Bayan` and `Sukhan` don't use `temperature`, `volume`,
+        #   or `emotion`, and don't support `voice_speed`. `Sukhan`'s `response_format` is
+        #   restricted to `mp3` or `pcm` (no `wav`).
         #
         #   @param emotion [Symbol, ::Telnyx::Models::TextToSpeechGenerateSpeechParams::Telnyx::Emotion] Emotion control for the Ultra model. Adjusts the emotional tone of the synthesiz
         #
@@ -513,7 +518,7 @@ module Telnyx
         #
         #   @param temperature [Float] Sampling temperature. Applies to `Natural` and `NaturalHD` models only.
         #
-        #   @param voice_speed [Float] Voice speed multiplier. Applies to all models. Range: 0.5 to 2.0.
+        #   @param voice_speed [Float] Voice speed multiplier. Applies to all models except `Bayan` and `Sukhan`, which
         #
         #   @param volume [Float] Volume level for the Ultra model. Range: 0.0 to 2.0.
 

data/lib/telnyx/models/text_to_speech_retrieve_speech_params.rb

@@ -45,10 +45,10 @@ module Telnyx
       # @!attribute voice
       #   Voice identifier in the format `provider.model_id.voice_id` or
       #   `provider.voice_id` (e.g. `telnyx.NaturalHD.Telnyx_Alloy`,
-      #   `Telnyx.Ultra.<voice_id>`, or `azure.en-US-AvaMultilingualNeural`). When
-      #   provided, the `provider`, `model_id`, and `voice_id` are extracted
-      #   automatically. Takes precedence over individual `provider`/`model_id`/`voice_id`
-      #   parameters.
+      #   `Telnyx.Ultra.<voice_id>`, `Telnyx.Bayan.Ahmed`, `Telnyx.Sukhan.urdu-professor`,
+      #   or `azure.en-US-AvaMultilingualNeural`). When provided, the `provider`,
+      #   `model_id`, and `voice_id` are extracted automatically. Takes precedence over
+      #   individual `provider`/`model_id`/`voice_id` parameters.
       #
       #   @return [String, nil]
       optional :voice, String

data/lib/telnyx/models/verify_profile.rb

@@ -301,7 +301,7 @@ module Telnyx
         optional :sender_phone_number, String, nil?: true
 
         # @!attribute template_id
-        #   Customer pre-approved authentication template name registered on Meta
+        #   Customer pre-approved authentication template ID registered on Meta
         #
         #   @return [String, nil]
         optional :template_id, String, nil?: true
@@ -336,7 +336,7 @@ module Telnyx
         #
         #   @param sender_phone_number [String, nil] Phone number registered on the customer WABA to send OTPs from
         #
-        #   @param template_id [String, nil] Customer pre-approved authentication template name registered on Meta
+        #   @param template_id [String, nil] Customer pre-approved authentication template ID registered on Meta
         #
         #   @param waba_id [String, nil] Customer Meta WABA ID for Bring-Your-Own-WABA sending
         #

data/lib/telnyx/models/verify_profile_create_params.rb

@@ -254,7 +254,7 @@ module Telnyx
         optional :sender_phone_number, String, nil?: true
 
         # @!attribute template_id
-        #   Customer pre-approved authentication template name registered on Meta
+        #   Customer pre-approved authentication template ID registered on Meta
         #
         #   @return [String, nil]
         optional :template_id, String, nil?: true
@@ -283,7 +283,7 @@ module Telnyx
         #
         #   @param sender_phone_number [String, nil] Phone number registered on the customer WABA to send OTPs from
         #
-        #   @param template_id [String, nil] Customer pre-approved authentication template name registered on Meta
+        #   @param template_id [String, nil] Customer pre-approved authentication template ID registered on Meta
         #
         #   @param waba_id [String, nil] Customer Meta WABA ID for Bring-Your-Own-WABA sending
         #

data/lib/telnyx/models/verify_profile_update_params.rb

@@ -216,7 +216,7 @@ module Telnyx
         optional :sender_phone_number, String, nil?: true
 
         # @!attribute template_id
-        #   Customer pre-approved authentication template name registered on Meta
+        #   Customer pre-approved authentication template ID registered on Meta
         #
         #   @return [String, nil]
         optional :template_id, String, nil?: true
@@ -245,7 +245,7 @@ module Telnyx
         #
         #   @param sender_phone_number [String, nil] Phone number registered on the customer WABA to send OTPs from
         #
-        #   @param template_id [String, nil] Customer pre-approved authentication template name registered on Meta
+        #   @param template_id [String, nil] Customer pre-approved authentication template ID registered on Meta
         #
         #   @param waba_id [String, nil] Customer Meta WABA ID for Bring-Your-Own-WABA sending
         #

data/lib/telnyx/models.rb

@@ -85,12 +85,8 @@ module Telnyx
 
   AI = Telnyx::Models::AI
 
-  AICreateResponseDeprecatedParams = Telnyx::Models::AICreateResponseDeprecatedParams
-
   AIRetrieveConversationHistoriesParams = Telnyx::Models::AIRetrieveConversationHistoriesParams
 
-  AIRetrieveModelsParams = Telnyx::Models::AIRetrieveModelsParams
-
   AISummarizeParams = Telnyx::Models::AISummarizeParams
 
   AlphanumericSenderID = Telnyx::Models::AlphanumericSenderID
@@ -930,8 +926,6 @@ module Telnyx
 
   MessageSendShortCodeParams = Telnyx::Models::MessageSendShortCodeParams
 
-  MessageSendWhatsappParams = Telnyx::Models::MessageSendWhatsappParams
-
   MessageSendWithAlphanumericSenderParams = Telnyx::Models::MessageSendWithAlphanumericSenderParams
 
   MessageTemplate = Telnyx::Models::MessageTemplate

data/lib/telnyx/resources/ai/anthropic/v1.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Anthropic
+        class V1
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AI::Anthropic::V1MessagesParams} for more details.
+          #
+          # Send a message to a language model using the Anthropic Messages API format. This
+          # endpoint is compatible with the
+          # [Anthropic Messages API](https://docs.anthropic.com/en/api/messages) and may be
+          # used with the Anthropic JS or Python SDK by setting the base URL to
+          # `https://api.telnyx.com/v2/ai/anthropic`.
+          #
+          # The endpoint translates Anthropic-format requests into Telnyx's inference
+          # internals, then translates the response back to the Anthropic message shape.
+          # Streaming responses use Anthropic SSE event types (`message_start`,
+          # `content_block_start`, `content_block_delta`, `content_block_stop`,
+          # `message_delta`, `message_stop`).
+          #
+          # @overload messages(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: {})
+          #
+          # @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}, nil]
+          #
+          # @return [Hash{Symbol=>Object}]
+          #
+          # @see Telnyx::Models::AI::Anthropic::V1MessagesParams
+          def messages(params)
+            parsed, options = Telnyx::AI::Anthropic::V1MessagesParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: "ai/anthropic/v1/messages",
+              body: parsed,
+              model: Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/ai/anthropic.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Anthropic
+        # @return [Telnyx::Resources::AI::Anthropic::V1]
+        attr_reader :v1
+
+        # @api private
+        #
+        # @param client [Telnyx::Client]
+        def initialize(client:)
+          @client = client
+          @v1 = Telnyx::Resources::AI::Anthropic::V1.new(client: client)
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/resources/ai/assistants/versions.rb

@@ -97,7 +97,7 @@ module Telnyx
           #
           # @param tool_ids [Array<String>] Body param: IDs of shared tools to attach to the assistant. New integrations sho
           #
-          # @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>] Body param: Deprecated for new integrations. Inline tool definitions available t
+          # @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>] Body param: Deprecated for new integrations. Inline tool definitions available t
           #
           # @param transcription [Telnyx::Models::AI::TranscriptionSettings] Body param
           #

data/lib/telnyx/resources/ai/assistants.rb

@@ -88,7 +88,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]
         #
@@ -202,7 +202,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/resources/ai/chat.rb

@@ -3,88 +3,7 @@
 module Telnyx
   module Resources
     class AI
-      # Generate text with LLMs
       class Chat
-        # @deprecated
-        #
-        # Some parameter documentations has been truncated, see
-        # {Telnyx::Models::AI::ChatCreateCompletionParams} for more details.
-        #
-        # **Deprecated**: Use `POST /v2/ai/openai/chat/completions` instead. Chat with a
-        # language model. This endpoint is consistent with the
-        # [OpenAI Chat Completions API](https://platform.openai.com/docs/api-reference/chat)
-        # and may be used with the OpenAI JS or Python SDK.
-        #
-        # @overload create_completion(messages:, api_key_ref: nil, best_of: nil, early_stopping: nil, enable_thinking: nil, frequency_penalty: nil, guided_choice: nil, guided_json: nil, guided_regex: nil, length_penalty: nil, logprobs: nil, max_tokens: nil, min_p: nil, model: nil, n: nil, presence_penalty: nil, response_format: nil, seed: nil, stop: nil, stream: nil, temperature: nil, tool_choice: nil, tools: nil, top_logprobs: nil, top_p: nil, use_beam_search: nil, request_options: {})
-        #
-        # @param messages [Array<Telnyx::Models::AI::ChatCompletionRequest::Message>] A list of the previous chat messages for context.
-        #
-        # @param api_key_ref [String] If you are using an external inference provider like xAI or OpenAI, this field a
-        #
-        # @param best_of [Integer] This is used with `use_beam_search` to determine how many candidate beams to exp
-        #
-        # @param early_stopping [Boolean] This is used with `use_beam_search`. If `true`, generation stops as soon as ther
-        #
-        # @param enable_thinking [Boolean] Whether to enable the thinking/reasoning phase for models that support it (e.g.,
-        #
-        # @param frequency_penalty [Float] Higher values will penalize the model from repeating the same output tokens.
-        #
-        # @param guided_choice [Array<String>] If specified, the output will be exactly one of the choices.
-        #
-        # @param guided_json [Hash{Symbol=>Object}] Must be a valid JSON schema. If specified, the output will follow the JSON schem
-        #
-        # @param guided_regex [String] If specified, the output will follow the regex pattern.
-        #
-        # @param length_penalty [Float] This is used with `use_beam_search` to prefer shorter or longer completions.
-        #
-        # @param logprobs [Boolean] Whether to return log probabilities of the output tokens or not. If true, return
-        #
-        # @param max_tokens [Integer] Maximum number of completion tokens the model should generate.
-        #
-        # @param min_p [Float] This is an alternative to `top_p` that [many prefer](https://github.com/huggingf
-        #
-        # @param model [String] The language model to chat with.
-        #
-        # @param n [Float] This will return multiple choices for you instead of a single chat completion.
-        #
-        # @param presence_penalty [Float] Higher values will penalize the model from repeating the same output tokens.
-        #
-        # @param response_format [Telnyx::Models::AI::ChatCompletionRequest::ResponseFormat] Use this is you want to guarantee a JSON output without defining a schema. For c
-        #
-        # @param seed [Integer] If specified, the system will make a best effort to sample deterministically, su
-        #
-        # @param stop [String, Array<String>] Up to 4 sequences where the API will stop generating further tokens. The returne
-        #
-        # @param stream [Boolean] Whether or not to stream data-only server-sent events as they become available.
-        #
-        # @param temperature [Float] Adjusts the "creativity" of the model. Lower values make the model more determin
-        #
-        # @param tool_choice [Symbol, Telnyx::Models::AI::ChatCompletionRequest::ToolChoice]
-        #
-        # @param tools [Array<Telnyx::Models::AI::ChatCompletionRequest::Tool::Function, Telnyx::Models::AI::ChatCompletionRequest::Tool::Retrieval>] The `function` tool type follows the same schema as the [OpenAI Chat Completions
-        #
-        # @param top_logprobs [Integer] This is used with `logprobs`. An integer between 0 and 20 specifying the number
-        #
-        # @param top_p [Float] An alternative or complement to `temperature`. This adjusts how many of the top
-        #
-        # @param use_beam_search [Boolean] Setting this to `true` will allow the model to [explore more completion options]
-        #
-        # @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}, nil]
-        #
-        # @return [Hash{Symbol=>Object}]
-        #
-        # @see Telnyx::Models::AI::ChatCreateCompletionParams
-        def create_completion(params)
-          parsed, options = Telnyx::AI::ChatCreateCompletionParams.dump_request(params)
-          @client.request(
-            method: :post,
-            path: "ai/chat/completions",
-            body: parsed,
-            model: Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
-            options: options
-          )
-        end
-
         # @api private
         #
         # @param client [Telnyx::Client]

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

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Resources
+    class AI
+      class Conversations
+        # Manage historical AI assistant conversations
+        class ConversationInsights
+          # Some parameter documentations has been truncated, see
+          # {Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams}
+          # for more details.
+          #
+          # Aggregate conversation insights by specified fields
+          #
+          # @overload retrieve_aggregates(created_at: nil, group_by: nil, insight_id: nil, metadata: nil, show: nil, request_options: {})
+          #
+          # @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}, nil]
+          #
+          # @return [Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse]
+          #
+          # @see Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesParams
+          def retrieve_aggregates(params = {})
+            parsed, options =
+              Telnyx::AI::Conversations::ConversationInsightRetrieveAggregatesParams.dump_request(params)
+            query = Telnyx::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: "ai/conversations/conversation-insights/aggregates",
+              query: query,
+              model: Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Telnyx::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -17,6 +17,10 @@ module Telnyx
         # @return [Telnyx::Resources::AI::Conversations::Messages]
         attr_reader :messages
 
+        # Manage historical AI assistant conversations
+        # @return [Telnyx::Resources::AI::Conversations::ConversationInsights]
+        attr_reader :conversation_insights
+
         # Some parameter documentations has been truncated, see
         # {Telnyx::Models::AI::ConversationCreateParams} for more details.
         #
@@ -237,6 +241,7 @@ module Telnyx
           @insight_groups = Telnyx::Resources::AI::Conversations::InsightGroups.new(client: client)
           @insights = Telnyx::Resources::AI::Conversations::Insights.new(client: client)
           @messages = Telnyx::Resources::AI::Conversations::Messages.new(client: client)
+          @conversation_insights = Telnyx::Resources::AI::Conversations::ConversationInsights.new(client: client)
         end
       end
     end

data/lib/telnyx/resources/ai/tools.rb

@@ -7,13 +7,15 @@ module Telnyx
       class Tools
         # Create Tool
         #
-        # @overload create(display_name:, type:, function: nil, handoff: nil, invite: nil, retrieval: nil, timeout_ms: nil, webhook: nil, request_options: {})
+        # @overload create(display_name:, type:, client_side_tool: nil, function: nil, handoff: nil, invite: nil, pay: nil, retrieval: nil, timeout_ms: nil, webhook: nil, request_options: {})
         #
         # @param display_name [String]
         # @param type [String]
+        # @param client_side_tool [Hash{Symbol=>Object}]
         # @param function [Hash{Symbol=>Object}]
         # @param handoff [Hash{Symbol=>Object}]
         # @param invite [Hash{Symbol=>Object}]
+        # @param pay [Telnyx::Models::AI::PayToolParams]
         # @param retrieval [Hash{Symbol=>Object}]
         # @param timeout_ms [Integer]
         # @param webhook [Hash{Symbol=>Object}]
@@ -55,10 +57,12 @@ module Telnyx
 
         # Update Tool
         #
-        # @overload update(tool_id, display_name: nil, function: nil, handoff: nil, invite: nil, retrieval: nil, timeout_ms: nil, type: nil, webhook: nil, request_options: {})
+        # @overload update(tool_id, client_side_tool: nil, display_name: nil, function: nil, handoff: nil, invite: nil, pay: nil, retrieval: nil, timeout_ms: nil, type: nil, webhook: nil, request_options: {})
         #
         # @param tool_id [String] Unique identifier of the tool.
         #
+        # @param client_side_tool [Hash{Symbol=>Object}]
+        #
         # @param display_name [String]
         #
         # @param function [Hash{Symbol=>Object}]
@@ -67,6 +71,8 @@ module Telnyx
         #
         # @param invite [Hash{Symbol=>Object}]
         #
+        # @param pay [Telnyx::Models::AI::PayToolParams]
+        #
         # @param retrieval [Hash{Symbol=>Object}]
         #
         # @param timeout_ms [Integer]