telnyx 6.65.0 → 6.66.0

package/src/resources/ai/ai.ts

@@ -52,6 +52,8 @@ import {
   AssistantDeleteResponse,
   AssistantGetTexmlResponse,
   AssistantImportsParams,
+  AssistantIntegration,
+  AssistantMcpServer,
   AssistantRetrieveParams,
   AssistantSendSMSParams,
   AssistantSendSMSResponse,
@@ -69,6 +71,7 @@ import {
   HangupToolParams,
   ImportMetadata,
   InferenceEmbedding,
+  InferenceEmbeddingInterruptionSettings,
   InferenceEmbeddingWebhookToolParams,
   InsightSettings,
   MessagingSettings,
@@ -78,7 +81,9 @@ import {
   PostConversationSettingsReq,
   PrivacySettings,
   RetrievalTool,
+  StartSpeakingPlan,
   TelephonySettings,
+  TranscriptionEndpointingPlan,
   TranscriptionSettings,
   TranscriptionSettingsConfig,
   TransferTool,
@@ -222,142 +227,140 @@ export class AI extends APIResource {
   }
 }
 
-export type AICreateResponseResponse = { [key: string]: unknown };
+/**
+ * Metadata for a model available on Telnyx Inference. Returned by
+ * `GET /v2/ai/openai/models` (and the deprecated `GET /v2/ai/models`). Open-source
+ * models live under their Hugging Face organization (e.g. `moonshotai/Kimi-K2.6`,
+ * `zai-org/GLM-5.1-FP8`, `MiniMaxAI/MiniMax-M2.7`); fine-tuned models are owned by
+ * the Telnyx organization that trained them.
+ */
+export interface ModelMetadata {
+  /**
+   * Model identifier. For open-source models, follows the
+   * `{organization}/{model_name}` convention from Hugging Face (e.g.
+   * `moonshotai/Kimi-K2.6`).
+   */
+  id: string;
 
-export interface AIRetrieveModelsResponse {
-  data: Array<AIRetrieveModelsResponse.Data>;
+  /**
+   * Maximum total tokens (prompt + completion) supported by the model in a single
+   * request.
+   */
+  context_length: number;
+
+  /**
+   * Timestamp at which the model was registered on Telnyx Inference (ISO 8601).
+   */
+  created: string;
+
+  /**
+   * ISO language codes the model supports (e.g. `en`, `es`).
+   */
+  languages: Array<string>;
+
+  /**
+   * License the model is distributed under, e.g. `Apache 2.0`, `MIT`,
+   * `Llama 3 Community License`.
+   */
+  license: string;
+
+  /**
+   * Organization that originally published the model, matching the prefix of `id`
+   * for open-source models.
+   */
+  organization: string;
+
+  /**
+   * Owner of the model. `Telnyx` for Telnyx-hosted open-source models, the upstream
+   * provider name for proxied models, or the Telnyx organization id for fine-tuned
+   * models.
+   */
+  owned_by: string;
+
+  /**
+   * Total parameter count of the model.
+   */
+  parameters: number;
+
+  /**
+   * Billing tier the model belongs to. Used together with `pricing` to determine
+   * cost per 1M tokens.
+   */
+  tier: 'small' | 'medium' | 'large' | 'unlisted';
+
+  /**
+   * Base model the fine-tuned model was trained from. Only set for fine-tuned
+   * models.
+   */
+  base_model?: string | null;
+
+  /**
+   * Short, human-readable summary of what the model is best suited for.
+   */
+  description?: string | null;
 
+  /**
+   * Whether the model can be used as a base for a fine-tuning job via
+   * `POST /v2/ai/fine_tuning/jobs`.
+   */
+  is_fine_tunable?: boolean;
+
+  /**
+   * Whether the model accepts image inputs in chat completions (multimodal vision
+   * support).
+   */
+  is_vision_supported?: boolean;
+
+  /**
+   * Maximum number of completion (output) tokens the model will generate per
+   * request. `null` if unconstrained beyond `context_length`.
+   */
+  max_completion_tokens?: number | null;
+
+  /**
+   * Object type. Always `model`.
+   */
   object?: string;
-}
 
-export namespace AIRetrieveModelsResponse {
   /**
-   * Metadata for a model available on Telnyx Inference. Returned by
-   * `GET /v2/ai/openai/models` (and the deprecated `GET /v2/ai/models`). Open-source
-   * models live under their Hugging Face organization (e.g. `moonshotai/Kimi-K2.6`,
-   * `zai-org/GLM-5.1-FP8`, `MiniMaxAI/MiniMax-M2.7`); fine-tuned models are owned by
-   * the Telnyx organization that trained them.
+   * Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
    */
-  export interface Data {
-    /**
-     * Model identifier. For open-source models, follows the
-     * `{organization}/{model_name}` convention from Hugging Face (e.g.
-     * `moonshotai/Kimi-K2.6`).
-     */
-    id: string;
-
-    /**
-     * Maximum total tokens (prompt + completion) supported by the model in a single
-     * request.
-     */
-    context_length: number;
-
-    /**
-     * Timestamp at which the model was registered on Telnyx Inference (ISO 8601).
-     */
-    created: string;
-
-    /**
-     * ISO language codes the model supports (e.g. `en`, `es`).
-     */
-    languages: Array<string>;
-
-    /**
-     * License the model is distributed under, e.g. `Apache 2.0`, `MIT`,
-     * `Llama 3 Community License`.
-     */
-    license: string;
-
-    /**
-     * Organization that originally published the model, matching the prefix of `id`
-     * for open-source models.
-     */
-    organization: string;
-
-    /**
-     * Owner of the model. `Telnyx` for Telnyx-hosted open-source models, the upstream
-     * provider name for proxied models, or the Telnyx organization id for fine-tuned
-     * models.
-     */
-    owned_by: string;
-
-    /**
-     * Total parameter count of the model.
-     */
-    parameters: number;
-
-    /**
-     * Billing tier the model belongs to. Used together with `pricing` to determine
-     * cost per 1M tokens.
-     */
-    tier: 'small' | 'medium' | 'large' | 'unlisted';
-
-    /**
-     * Base model the fine-tuned model was trained from. Only set for fine-tuned
-     * models.
-     */
-    base_model?: string | null;
-
-    /**
-     * Short, human-readable summary of what the model is best suited for.
-     */
-    description?: string | null;
-
-    /**
-     * Whether the model can be used as a base for a fine-tuning job via
-     * `POST /v2/ai/fine_tuning/jobs`.
-     */
-    is_fine_tunable?: boolean;
-
-    /**
-     * Whether the model accepts image inputs in chat completions (multimodal vision
-     * support).
-     */
-    is_vision_supported?: boolean;
-
-    /**
-     * Maximum number of completion (output) tokens the model will generate per
-     * request. `null` if unconstrained beyond `context_length`.
-     */
-    max_completion_tokens?: number | null;
-
-    /**
-     * Object type. Always `model`.
-     */
-    object?: string;
-
-    /**
-     * Human-readable parameter count, e.g. `1.0T`, `753.9B`, `8B`.
-     */
-    parameters_str?: string | null;
-
-    /**
-     * Mapping of token kind to price, as strings to preserve precision. Typical keys
-     * are `prompt`, `cached_prompt`, and `completion`. When pricing is available the
-     * block also includes `currency` (ISO 4217 code matching the account's configured
-     * billing currency) and `unit` (the denomination the prices are quoted in,
-     * currently always `1M_tokens` for token-priced models).
-     */
-    pricing?: { [key: string]: string };
-
-    /**
-     * Whether Telnyx currently recommends this model as the LLM powering a Telnyx AI
-     * Assistant.
-     */
-    recommended_for_assistants?: boolean;
-
-    /**
-     * Public region names where the model is currently deployed (e.g. `us-central-1`,
-     * `eu-central-1`).
-     */
-    regions?: Array<string>;
-
-    /**
-     * Primary task the model is intended for, e.g. `text-generation`,
-     * `audio-text-to-text`, `feature-extraction` (embeddings).
-     */
-    task?: string;
-  }
+  parameters_str?: string | null;
+
+  /**
+   * Mapping of token kind to price, as strings to preserve precision. Typical keys
+   * are `prompt`, `cached_prompt`, and `completion`. When pricing is available the
+   * block also includes `currency` (ISO 4217 code matching the account's configured
+   * billing currency) and `unit` (the denomination the prices are quoted in,
+   * currently always `1M_tokens` for token-priced models).
+   */
+  pricing?: { [key: string]: string };
+
+  /**
+   * Whether Telnyx currently recommends this model as the LLM powering a Telnyx AI
+   * Assistant.
+   */
+  recommended_for_assistants?: boolean;
+
+  /**
+   * Public region names where the model is currently deployed (e.g. `us-central-1`,
+   * `eu-central-1`).
+   */
+  regions?: Array<string>;
+
+  /**
+   * Primary task the model is intended for, e.g. `text-generation`,
+   * `audio-text-to-text`, `feature-extraction` (embeddings).
+   */
+  task?: string;
+}
+
+export type AICreateResponseResponse = { [key: string]: unknown };
+
+export interface AIRetrieveModelsResponse {
+  data: Array<ModelMetadata>;
+
+  object?: string;
 }
 
 export interface AISummarizeResponse {
@@ -406,6 +409,7 @@ AI.Tools = Tools;
 
 export declare namespace AI {
   export {
+    type ModelMetadata as ModelMetadata,
     type AICreateResponseResponse as AICreateResponseResponse,
     type AIRetrieveModelsResponse as AIRetrieveModelsResponse,
     type AISummarizeResponse as AISummarizeResponse,
@@ -416,6 +420,8 @@ export declare namespace AI {
   export {
     Assistants as Assistants,
     type Assistant as Assistant,
+    type AssistantIntegration as AssistantIntegration,
+    type AssistantMcpServer as AssistantMcpServer,
     type AssistantTool as AssistantTool,
     type AssistantsList as AssistantsList,
     type AudioVisualizerConfig as AudioVisualizerConfig,
@@ -428,6 +434,7 @@ export declare namespace AI {
     type HangupToolParams as HangupToolParams,
     type ImportMetadata as ImportMetadata,
     type InferenceEmbedding as InferenceEmbedding,
+    type InferenceEmbeddingInterruptionSettings as InferenceEmbeddingInterruptionSettings,
     type InferenceEmbeddingWebhookToolParams as InferenceEmbeddingWebhookToolParams,
     type InsightSettings as InsightSettings,
     type MessagingSettings as MessagingSettings,
@@ -437,7 +444,9 @@ export declare namespace AI {
     type PostConversationSettingsReq as PostConversationSettingsReq,
     type PrivacySettings as PrivacySettings,
     type RetrievalTool as RetrievalTool,
+    type StartSpeakingPlan as StartSpeakingPlan,
     type TelephonySettings as TelephonySettings,
+    type TranscriptionEndpointingPlan as TranscriptionEndpointingPlan,
     type TranscriptionSettings as TranscriptionSettings,
     type TranscriptionSettingsConfig as TranscriptionSettingsConfig,
     type TransferTool as TransferTool,