telnyx 5.100.0 → 5.102.0

data/rbi/telnyx/models/ai/openai/chat_create_completion_response.rbi

@@ -0,0 +1,15 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      module OpenAI
+        ChatCreateCompletionResponse =
+          T.let(
+            Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown],
+            Telnyx::Internal::Type::Converter
+          )
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/openai_list_models_params.rbi

@@ -0,0 +1,29 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      class OpenAIListModelsParams < Telnyx::Internal::Type::BaseModel
+        extend Telnyx::Internal::Type::RequestParameters::Converter
+        include Telnyx::Internal::Type::RequestParameters
+
+        OrHash =
+          T.type_alias do
+            T.any(Telnyx::AI::OpenAIListModelsParams, Telnyx::Internal::AnyHash)
+          end
+
+        sig do
+          params(request_options: Telnyx::RequestOptions::OrHash).returns(
+            T.attached_class
+          )
+        end
+        def self.new(request_options: {})
+        end
+
+        sig { override.returns({ request_options: Telnyx::RequestOptions }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/ai/openai_list_models_response.rbi

@@ -0,0 +1,96 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    module AI
+      class OpenAIListModelsResponse < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::Models::AI::OpenAIListModelsResponse,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        sig do
+          returns(T::Array[Telnyx::Models::AI::OpenAIListModelsResponse::Data])
+        end
+        attr_accessor :data
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :object
+
+        sig { params(object: String).void }
+        attr_writer :object
+
+        sig do
+          params(
+            data:
+              T::Array[
+                Telnyx::Models::AI::OpenAIListModelsResponse::Data::OrHash
+              ],
+            object: String
+          ).returns(T.attached_class)
+        end
+        def self.new(data:, object: nil)
+        end
+
+        sig do
+          override.returns(
+            {
+              data:
+                T::Array[Telnyx::Models::AI::OpenAIListModelsResponse::Data],
+              object: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Data < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::Models::AI::OpenAIListModelsResponse::Data,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :id
+
+          sig { returns(Integer) }
+          attr_accessor :created
+
+          sig { returns(String) }
+          attr_accessor :owned_by
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :object
+
+          sig { params(object: String).void }
+          attr_writer :object
+
+          sig do
+            params(
+              id: String,
+              created: Integer,
+              owned_by: String,
+              object: String
+            ).returns(T.attached_class)
+          end
+          def self.new(id:, created:, owned_by:, object: nil)
+          end
+
+          sig do
+            override.returns(
+              { id: String, created: Integer, owned_by: String, object: String }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/ai/chat.rbi

@@ -5,7 +5,8 @@ module Telnyx
     class AI
       # Generate text with LLMs
       class Chat
-        # Chat with a language model. This endpoint is consistent with the
+        # **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.
         sig do
@@ -29,6 +30,8 @@ module Telnyx
             presence_penalty: Float,
             response_format:
               Telnyx::AI::ChatCreateCompletionParams::ResponseFormat::OrHash,
+            seed: Integer,
+            stop: Telnyx::AI::ChatCreateCompletionParams::Stop::Variants,
             stream: T::Boolean,
             temperature: Float,
             tool_choice:
@@ -95,6 +98,13 @@ module Telnyx
           # Use this is you want to guarantee a JSON output without defining a schema. For
           # control over the schema, use `guided_json`.
           response_format: nil,
+          # If specified, the system will make a best effort to sample deterministically,
+          # such that repeated requests with the same `seed` and parameters should return
+          # the same result.
+          seed: nil,
+          # Up to 4 sequences where the API will stop generating further tokens. The
+          # returned text will not contain the stop sequence.
+          stop: nil,
           # Whether or not to stream data-only server-sent events as they become available.
           stream: nil,
           # Adjusts the "creativity" of the model. Lower values make the model more

data/rbi/telnyx/resources/ai/openai/chat.rbi

@@ -0,0 +1,147 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class AI
+      class OpenAI
+        class Chat
+          # 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 by setting the base URL to
+          # `https://api.telnyx.com/v2/ai/openai`.
+          sig do
+            params(
+              messages:
+                T::Array[
+                  Telnyx::AI::OpenAI::ChatCreateCompletionParams::Message::OrHash
+                ],
+              api_key_ref: String,
+              best_of: Integer,
+              early_stopping: T::Boolean,
+              enable_thinking: T::Boolean,
+              frequency_penalty: Float,
+              guided_choice: T::Array[String],
+              guided_json: T::Hash[Symbol, T.anything],
+              guided_regex: String,
+              length_penalty: Float,
+              logprobs: T::Boolean,
+              max_tokens: Integer,
+              min_p: Float,
+              model: String,
+              n: Float,
+              presence_penalty: Float,
+              response_format:
+                Telnyx::AI::OpenAI::ChatCreateCompletionParams::ResponseFormat::OrHash,
+              seed: Integer,
+              stop:
+                Telnyx::AI::OpenAI::ChatCreateCompletionParams::Stop::Variants,
+              stream: T::Boolean,
+              temperature: Float,
+              tool_choice:
+                Telnyx::AI::OpenAI::ChatCreateCompletionParams::ToolChoice::OrSymbol,
+              tools:
+                T::Array[
+                  T.any(
+                    Telnyx::AI::OpenAI::ChatCreateCompletionParams::Tool::Function::OrHash,
+                    Telnyx::AI::OpenAI::ChatCreateCompletionParams::Tool::Retrieval::OrHash
+                  )
+                ],
+              top_logprobs: Integer,
+              top_p: Float,
+              use_beam_search: T::Boolean,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(T::Hash[Symbol, T.anything])
+          end
+          def create_completion(
+            # A list of the previous chat messages for context.
+            messages:,
+            # If you are using an external inference provider like xAI or OpenAI, this field
+            # allows you to pass along a reference to your API key. After creating an
+            # [integration secret](https://developers.telnyx.com/api-reference/integration-secrets/create-a-secret)
+            # for you API key, pass the secret's `identifier` in this field.
+            api_key_ref: nil,
+            # This is used with `use_beam_search` to determine how many candidate beams to
+            # explore.
+            best_of: nil,
+            # This is used with `use_beam_search`. If `true`, generation stops as soon as
+            # there are `best_of` complete candidates; if `false`, a heuristic is applied and
+            # the generation stops when is it very unlikely to find better candidates.
+            early_stopping: nil,
+            # Whether to enable the thinking/reasoning phase for models that support it (e.g.,
+            # QwQ, Qwen3). When set to false, the model will skip the internal reasoning step
+            # and respond directly, which can reduce latency. Defaults to true.
+            enable_thinking: nil,
+            # Higher values will penalize the model from repeating the same output tokens.
+            frequency_penalty: nil,
+            # If specified, the output will be exactly one of the choices.
+            guided_choice: nil,
+            # Must be a valid JSON schema. If specified, the output will follow the JSON
+            # schema.
+            guided_json: nil,
+            # If specified, the output will follow the regex pattern.
+            guided_regex: nil,
+            # This is used with `use_beam_search` to prefer shorter or longer completions.
+            length_penalty: nil,
+            # Whether to return log probabilities of the output tokens or not. If true,
+            # returns the log probabilities of each output token returned in the `content` of
+            # `message`.
+            logprobs: nil,
+            # Maximum number of completion tokens the model should generate.
+            max_tokens: nil,
+            # This is an alternative to `top_p` that
+            # [many prefer](https://github.com/huggingface/transformers/issues/27670). Must be
+            # in [0, 1].
+            min_p: nil,
+            # The language model to chat with.
+            model: nil,
+            # This will return multiple choices for you instead of a single chat completion.
+            n: nil,
+            # Higher values will penalize the model from repeating the same output tokens.
+            presence_penalty: nil,
+            # Use this is you want to guarantee a JSON output without defining a schema. For
+            # control over the schema, use `guided_json`.
+            response_format: nil,
+            # If specified, the system will make a best effort to sample deterministically,
+            # such that repeated requests with the same `seed` and parameters should return
+            # the same result.
+            seed: nil,
+            # Up to 4 sequences where the API will stop generating further tokens. The
+            # returned text will not contain the stop sequence.
+            stop: nil,
+            # Whether or not to stream data-only server-sent events as they become available.
+            stream: nil,
+            # Adjusts the "creativity" of the model. Lower values make the model more
+            # deterministic and repetitive, while higher values make the model more random and
+            # creative.
+            temperature: nil,
+            tool_choice: nil,
+            # The `function` tool type follows the same schema as the
+            # [OpenAI Chat Completions API](https://platform.openai.com/docs/api-reference/chat).
+            # The `retrieval` tool type is unique to Telnyx. You may pass a list of
+            # [embedded storage buckets](https://developers.telnyx.com/api-reference/embeddings/embed-documents)
+            # for retrieval-augmented generation.
+            tools: nil,
+            # This is used with `logprobs`. An integer between 0 and 20 specifying the number
+            # of most likely tokens to return at each token position, each with an associated
+            # log probability.
+            top_logprobs: nil,
+            # An alternative or complement to `temperature`. This adjusts how many of the top
+            # possibilities to consider.
+            top_p: nil,
+            # Setting this to `true` will allow the model to
+            # [explore more completion options](https://huggingface.co/blog/how-to-generate#beam-search).
+            # This is not supported by OpenAI.
+            use_beam_search: nil,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: Telnyx::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/ai/openai.rbi

@@ -9,6 +9,22 @@ module Telnyx
         sig { returns(Telnyx::Resources::AI::OpenAI::Embeddings) }
         attr_reader :embeddings
 
+        sig { returns(Telnyx::Resources::AI::OpenAI::Chat) }
+        attr_reader :chat
+
+        # This endpoint returns a list of Open Source and OpenAI models that are available
+        # for use. <br /><br /> **Note**: Model `id`'s will be in the form
+        # `{source}/{model_name}`. For example `openai/gpt-4` or
+        # `mistralai/Mistral-7B-Instruct-v0.1` consistent with HuggingFace naming
+        # conventions.
+        sig do
+          params(request_options: Telnyx::RequestOptions::OrHash).returns(
+            Telnyx::Models::AI::OpenAIListModelsResponse
+          )
+        end
+        def list_models(request_options: {})
+        end
+
         # @api private
         sig { params(client: Telnyx::Client).returns(T.attached_class) }
         def self.new(client:)

data/rbi/telnyx/resources/ai.rbi

@@ -46,11 +46,11 @@ module Telnyx
       sig { returns(Telnyx::Resources::AI::Tools) }
       attr_reader :tools
 
-      # This endpoint returns a list of Open Source and OpenAI models that are available
-      # for use. <br /><br /> **Note**: Model `id`'s will be in the form
-      # `{source}/{model_name}`. For example `openai/gpt-4` or
-      # `mistralai/Mistral-7B-Instruct-v0.1` consistent with HuggingFace naming
-      # conventions.
+      # **Deprecated**: Use `GET /v2/ai/openai/models` instead. This endpoint returns a
+      # list of Open Source and OpenAI models that are available for use. <br /><br />
+      # **Note**: Model `id`'s will be in the form `{source}/{model_name}`. For example
+      # `openai/gpt-4` or `mistralai/Mistral-7B-Instruct-v0.1` consistent with
+      # HuggingFace naming conventions.
       sig do
         params(request_options: Telnyx::RequestOptions::OrHash).returns(
           Telnyx::Models::AIRetrieveModelsResponse

data/rbi/telnyx/resources/messaging_10dlc/brand/external_vetting.rbi

@@ -48,7 +48,11 @@ module Telnyx
           )
           end
 
-          # Order new external vetting for a brand
+          # Order new external vetting for a brand.
+          #
+          # Duplicate orders for the same `evpId` and `vettingClass` return `400` with code
+          # `10012` if a successful vetting exists within the last 180 days, or one is
+          # currently being processed. Failed vettings can be retried immediately.
           sig do
             params(
               brand_id: String,

data/sig/telnyx/models/ai/chat_create_completion_params.rbs

@@ -20,6 +20,8 @@ module Telnyx
           n: Float,
           presence_penalty: Float,
           response_format: Telnyx::AI::ChatCreateCompletionParams::ResponseFormat,
+          seed: Integer,
+          stop: Telnyx::Models::AI::ChatCreateCompletionParams::stop,
           stream: bool,
           temperature: Float,
           tool_choice: Telnyx::Models::AI::ChatCreateCompletionParams::tool_choice,
@@ -102,6 +104,16 @@ module Telnyx
           Telnyx::AI::ChatCreateCompletionParams::ResponseFormat
         ) -> Telnyx::AI::ChatCreateCompletionParams::ResponseFormat
 
+        attr_reader seed: Integer?
+
+        def seed=: (Integer) -> Integer
+
+        attr_reader stop: Telnyx::Models::AI::ChatCreateCompletionParams::stop?
+
+        def stop=: (
+          Telnyx::Models::AI::ChatCreateCompletionParams::stop
+        ) -> Telnyx::Models::AI::ChatCreateCompletionParams::stop
+
         attr_reader stream: bool?
 
         def stream=: (bool) -> bool
@@ -152,6 +164,8 @@ module Telnyx
           ?n: Float,
           ?presence_penalty: Float,
           ?response_format: Telnyx::AI::ChatCreateCompletionParams::ResponseFormat,
+          ?seed: Integer,
+          ?stop: Telnyx::Models::AI::ChatCreateCompletionParams::stop,
           ?stream: bool,
           ?temperature: Float,
           ?tool_choice: Telnyx::Models::AI::ChatCreateCompletionParams::tool_choice,
@@ -180,6 +194,8 @@ module Telnyx
           n: Float,
           presence_penalty: Float,
           response_format: Telnyx::AI::ChatCreateCompletionParams::ResponseFormat,
+          seed: Integer,
+          stop: Telnyx::Models::AI::ChatCreateCompletionParams::stop,
           stream: bool,
           temperature: Float,
           tool_choice: Telnyx::Models::AI::ChatCreateCompletionParams::tool_choice,
@@ -307,6 +323,16 @@ module Telnyx
           end
         end
 
+        type stop = String | ::Array[String]
+
+        module Stop
+          extend Telnyx::Internal::Type::Union
+
+          def self?.variants: -> ::Array[Telnyx::Models::AI::ChatCreateCompletionParams::stop]
+
+          StringArray: Telnyx::Internal::Type::Converter
+        end
+
         type tool_choice = :none | :auto | :required
 
         module ToolChoice