telnyx 6.46.0 → 6.48.0

package/src/resources/ai/assistants/versions.ts

@@ -146,9 +146,9 @@ export interface UpdateAssistant {
 
   enabled_features?: Array<AssistantsAPI.EnabledFeatures>;
 
-  external_llm?: UpdateAssistant.ExternalLlm;
+  external_llm?: AssistantsAPI.ExternalLlmReq;
 
-  fallback_config?: UpdateAssistant.FallbackConfig;
+  fallback_config?: AssistantsAPI.FallbackConfigReq;
 
   /**
    * Text that the assistant will use to start the conversation. This may be
@@ -225,7 +225,7 @@ export interface UpdateAssistant {
    * Telephony-control tools (e.g. hangup, transfer) are unavailable
    * post-conversation. Beta feature.
    */
-  post_conversation_settings?: UpdateAssistant.PostConversationSettings;
+  post_conversation_settings?: AssistantsAPI.PostConversationSettingsReq;
 
   privacy_settings?: AssistantsAPI.PrivacySettings;
 
@@ -266,111 +266,6 @@ export interface UpdateAssistant {
 }
 
 export namespace UpdateAssistant {
-  export interface ExternalLlm {
-    /**
-     * Base URL for the external LLM endpoint.
-     */
-    base_url: string;
-
-    /**
-     * Model identifier to use with the external LLM endpoint.
-     */
-    model: string;
-
-    /**
-     * Authentication method used when connecting to the external LLM endpoint.
-     */
-    authentication_method?: 'token' | 'certificate';
-
-    /**
-     * Integration secret identifier for the client certificate used with certificate
-     * authentication.
-     */
-    certificate_ref?: string;
-
-    /**
-     * When `true`, Telnyx forwards the assistant's dynamic variables to the external
-     * LLM endpoint as a top-level `extra_metadata` object on the chat completion
-     * request body. Defaults to `false`. Example payload sent to the external
-     * endpoint:
-     * `{"extra_metadata": {"customer_name": "Jane", "account_id": "acct_789", "telnyx_agent_target": "+13125550100", "telnyx_end_user_target": "+13125550123"}}`.
-     * Distinct from OpenAI's native `metadata` field, which has its own size and type
-     * limits.
-     */
-    forward_metadata?: boolean;
-
-    /**
-     * Integration secret identifier for the external LLM API key.
-     */
-    llm_api_key_ref?: string;
-
-    /**
-     * URL used to retrieve an access token when certificate authentication is enabled.
-     */
-    token_retrieval_url?: string;
-  }
-
-  export interface FallbackConfig {
-    external_llm?: FallbackConfig.ExternalLlm;
-
-    /**
-     * Integration secret identifier for the fallback model API key.
-     */
-    llm_api_key_ref?: string;
-
-    /**
-     * Fallback Telnyx-hosted model to use when the primary LLM provider is
-     * unavailable.
-     */
-    model?: string;
-  }
-
-  export namespace FallbackConfig {
-    export interface ExternalLlm {
-      /**
-       * Base URL for the external LLM endpoint.
-       */
-      base_url: string;
-
-      /**
-       * Model identifier to use with the external LLM endpoint.
-       */
-      model: string;
-
-      /**
-       * Authentication method used when connecting to the external LLM endpoint.
-       */
-      authentication_method?: 'token' | 'certificate';
-
-      /**
-       * Integration secret identifier for the client certificate used with certificate
-       * authentication.
-       */
-      certificate_ref?: string;
-
-      /**
-       * When `true`, Telnyx forwards the assistant's dynamic variables to the external
-       * LLM endpoint as a top-level `extra_metadata` object on the chat completion
-       * request body. Defaults to `false`. Example payload sent to the external
-       * endpoint:
-       * `{"extra_metadata": {"customer_name": "Jane", "account_id": "acct_789", "telnyx_agent_target": "+13125550100", "telnyx_end_user_target": "+13125550123"}}`.
-       * Distinct from OpenAI's native `metadata` field, which has its own size and type
-       * limits.
-       */
-      forward_metadata?: boolean;
-
-      /**
-       * Integration secret identifier for the external LLM API key.
-       */
-      llm_api_key_ref?: string;
-
-      /**
-       * URL used to retrieve an access token when certificate authentication is enabled.
-       */
-      token_retrieval_url?: string;
-    }
-  }
-
   /**
    * Reference to a connected integration attached to an assistant. Discover
    * available integrations with `/ai/integrations` and connected integrations with
@@ -482,23 +377,6 @@ export namespace UpdateAssistant {
      */
     allowed_tools?: Array<string>;
   }
-
-  /**
-   * Configuration for post-conversation processing. When enabled, the assistant
-   * receives one additional LLM turn after the conversation ends, allowing it to
-   * execute tool calls such as logging to a CRM or sending a summary. The assistant
-   * can execute multiple parallel or sequential tools during this phase.
-   * Telephony-control tools (e.g. hangup, transfer) are unavailable
-   * post-conversation. Beta feature.
-   */
-  export interface PostConversationSettings {
-    /**
-     * Whether post-conversation processing is enabled. When true, the assistant will
-     * be invoked after the conversation ends to perform any final tool calls. Defaults
-     * to false.
-     */
-    enabled?: boolean;
-  }
 }
 
 export interface VersionRetrieveParams {
@@ -557,12 +435,12 @@ export interface VersionUpdateParams {
   /**
    * Body param
    */
-  external_llm?: VersionUpdateParams.ExternalLlm;
+  external_llm?: AssistantsAPI.ExternalLlmReq;
 
   /**
    * Body param
    */
-  fallback_config?: VersionUpdateParams.FallbackConfig;
+  fallback_config?: AssistantsAPI.FallbackConfigReq;
 
   /**
    * Body param: Text that the assistant will use to start the conversation. This may
@@ -652,7 +530,7 @@ export interface VersionUpdateParams {
    * Telephony-control tools (e.g. hangup, transfer) are unavailable
    * post-conversation. Beta feature.
    */
-  post_conversation_settings?: VersionUpdateParams.PostConversationSettings;
+  post_conversation_settings?: AssistantsAPI.PostConversationSettingsReq;
 
   /**
    * Body param
@@ -705,111 +583,6 @@ export interface VersionUpdateParams {
 }
 
 export namespace VersionUpdateParams {
-  export interface ExternalLlm {
-    /**
-     * Base URL for the external LLM endpoint.
-     */
-    base_url: string;
-
-    /**
-     * Model identifier to use with the external LLM endpoint.
-     */
-    model: string;
-
-    /**
-     * Authentication method used when connecting to the external LLM endpoint.
-     */
-    authentication_method?: 'token' | 'certificate';
-
-    /**
-     * Integration secret identifier for the client certificate used with certificate
-     * authentication.
-     */
-    certificate_ref?: string;
-
-    /**
-     * When `true`, Telnyx forwards the assistant's dynamic variables to the external
-     * LLM endpoint as a top-level `extra_metadata` object on the chat completion
-     * request body. Defaults to `false`. Example payload sent to the external
-     * endpoint:
-     * `{"extra_metadata": {"customer_name": "Jane", "account_id": "acct_789", "telnyx_agent_target": "+13125550100", "telnyx_end_user_target": "+13125550123"}}`.
-     * Distinct from OpenAI's native `metadata` field, which has its own size and type
-     * limits.
-     */
-    forward_metadata?: boolean;
-
-    /**
-     * Integration secret identifier for the external LLM API key.
-     */
-    llm_api_key_ref?: string;
-
-    /**
-     * URL used to retrieve an access token when certificate authentication is enabled.
-     */
-    token_retrieval_url?: string;
-  }
-
-  export interface FallbackConfig {
-    external_llm?: FallbackConfig.ExternalLlm;
-
-    /**
-     * Integration secret identifier for the fallback model API key.
-     */
-    llm_api_key_ref?: string;
-
-    /**
-     * Fallback Telnyx-hosted model to use when the primary LLM provider is
-     * unavailable.
-     */
-    model?: string;
-  }
-
-  export namespace FallbackConfig {
-    export interface ExternalLlm {
-      /**
-       * Base URL for the external LLM endpoint.
-       */
-      base_url: string;
-
-      /**
-       * Model identifier to use with the external LLM endpoint.
-       */
-      model: string;
-
-      /**
-       * Authentication method used when connecting to the external LLM endpoint.
-       */
-      authentication_method?: 'token' | 'certificate';
-
-      /**
-       * Integration secret identifier for the client certificate used with certificate
-       * authentication.
-       */
-      certificate_ref?: string;
-
-      /**
-       * When `true`, Telnyx forwards the assistant's dynamic variables to the external
-       * LLM endpoint as a top-level `extra_metadata` object on the chat completion
-       * request body. Defaults to `false`. Example payload sent to the external
-       * endpoint:
-       * `{"extra_metadata": {"customer_name": "Jane", "account_id": "acct_789", "telnyx_agent_target": "+13125550100", "telnyx_end_user_target": "+13125550123"}}`.
-       * Distinct from OpenAI's native `metadata` field, which has its own size and type
-       * limits.
-       */
-      forward_metadata?: boolean;
-
-      /**
-       * Integration secret identifier for the external LLM API key.
-       */
-      llm_api_key_ref?: string;
-
-      /**
-       * URL used to retrieve an access token when certificate authentication is enabled.
-       */
-      token_retrieval_url?: string;
-    }
-  }
-
   /**
    * Reference to a connected integration attached to an assistant. Discover
    * available integrations with `/ai/integrations` and connected integrations with
@@ -921,23 +694,6 @@ export namespace VersionUpdateParams {
      */
     allowed_tools?: Array<string>;
   }
-
-  /**
-   * Configuration for post-conversation processing. When enabled, the assistant
-   * receives one additional LLM turn after the conversation ends, allowing it to
-   * execute tool calls such as logging to a CRM or sending a summary. The assistant
-   * can execute multiple parallel or sequential tools during this phase.
-   * Telephony-control tools (e.g. hangup, transfer) are unavailable
-   * post-conversation. Beta feature.
-   */
-  export interface PostConversationSettings {
-    /**
-     * Whether post-conversation processing is enabled. When true, the assistant will
-     * be invoked after the conversation ends to perform any final tool calls. Defaults
-     * to false.
-     */
-    enabled?: boolean;
-  }
 }
 
 export interface VersionDeleteParams {

package/src/resources/ai/index.ts

@@ -8,6 +8,10 @@ export {
   type AssistantsList,
   type AudioVisualizerConfig,
   type EnabledFeatures,
+  type ExternalLlm,
+  type ExternalLlmReq,
+  type FallbackConfig,
+  type FallbackConfigReq,
   type HangupTool,
   type HangupToolParams,
   type ImportMetadata,
@@ -17,6 +21,8 @@ export {
   type MessagingSettings,
   type Observability,
   type ObservabilityReq,
+  type PostConversationSettings,
+  type PostConversationSettingsReq,
   type PrivacySettings,
   type RetrievalTool,
   type TelephonySettings,

package/src/resources/calls/actions.ts

@@ -2673,6 +2673,8 @@ export interface ActionGatherUsingAIParams {
    * - **Telnyx:** Use `Telnyx.<model_id>.<voice_id>`
    * - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
    *   `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+   * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+   *   `ara`, `rex`, `sal`, `leo`.
    */
   voice?: string;
 
@@ -2685,7 +2687,8 @@ export interface ActionGatherUsingAIParams {
     | AwsVoiceSettings
     | Shared.AzureVoiceSettings
     | Shared.RimeVoiceSettings
-    | Shared.ResembleVoiceSettings;
+    | Shared.ResembleVoiceSettings
+    | ActionGatherUsingAIParams.XaiVoiceSettings;
 }
 
 export namespace ActionGatherUsingAIParams {
@@ -2700,6 +2703,18 @@ export namespace ActionGatherUsingAIParams {
      */
     role?: 'assistant' | 'user';
   }
+
+  export interface XaiVoiceSettings {
+    /**
+     * Voice settings provider type
+     */
+    type: 'xai';
+
+    /**
+     * Language code, or `auto` to detect automatically.
+     */
+    language?: string;
+  }
 }
 
 export interface ActionGatherUsingAudioParams {
@@ -2832,6 +2847,8 @@ export interface ActionGatherUsingSpeakParams {
    *   `voice_settings` to configure precision, sample_rate, and format.
    * - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
    *   `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+   * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+   *   `ara`, `rex`, `sal`, `leo`.
    *
    * For service_level basic, you may define the gender of the speaker (male or
    * female).
@@ -2954,7 +2971,8 @@ export interface ActionGatherUsingSpeakParams {
     | Shared.AzureVoiceSettings
     | Shared.RimeVoiceSettings
     | Shared.ResembleVoiceSettings
-    | ActionGatherUsingSpeakParams.InworldVoiceSettings;
+    | ActionGatherUsingSpeakParams.InworldVoiceSettings
+    | ActionGatherUsingSpeakParams.XaiVoiceSettings;
 }
 
 export namespace ActionGatherUsingSpeakParams {
@@ -2964,6 +2982,18 @@ export namespace ActionGatherUsingSpeakParams {
      */
     type: 'inworld';
   }
+
+  export interface XaiVoiceSettings {
+    /**
+     * Voice settings provider type
+     */
+    type: 'xai';
+
+    /**
+     * Language code, or `auto` to detect automatically.
+     */
+    language?: string;
+  }
 }
 
 export interface ActionHangupParams {
@@ -3239,6 +3269,8 @@ export interface ActionSpeakParams {
    *   `voice_settings` to configure precision, sample_rate, and format.
    * - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
    *   `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+   * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+   *   `ara`, `rex`, `sal`, `leo`.
    *
    * For service_level basic, you may define the gender of the speaker (male or
    * female).
@@ -3334,7 +3366,8 @@ export interface ActionSpeakParams {
     | Shared.AzureVoiceSettings
     | Shared.RimeVoiceSettings
     | Shared.ResembleVoiceSettings
-    | ActionSpeakParams.InworldVoiceSettings;
+    | ActionSpeakParams.InworldVoiceSettings
+    | ActionSpeakParams.XaiVoiceSettings;
 }
 
 export namespace ActionSpeakParams {
@@ -3344,6 +3377,18 @@ export namespace ActionSpeakParams {
      */
     type: 'inworld';
   }
+
+  export interface XaiVoiceSettings {
+    /**
+     * Voice settings provider type
+     */
+    type: 'xai';
+
+    /**
+     * Language code, or `auto` to detect automatically.
+     */
+    language?: string;
+  }
 }
 
 export interface ActionStartAIAssistantParams {
@@ -3434,6 +3479,8 @@ export interface ActionStartAIAssistantParams {
    * - **Telnyx:** Use `Telnyx.<model_id>.<voice_id>`
    * - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
    *   `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+   * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+   *   `ara`, `rex`, `sal`, `leo`.
    */
   voice?: string;
 
@@ -3446,7 +3493,8 @@ export interface ActionStartAIAssistantParams {
     | AwsVoiceSettings
     | Shared.AzureVoiceSettings
     | Shared.RimeVoiceSettings
-    | Shared.ResembleVoiceSettings;
+    | Shared.ResembleVoiceSettings
+    | ActionStartAIAssistantParams.XaiVoiceSettings;
 }
 
 export namespace ActionStartAIAssistantParams {
@@ -3614,6 +3662,18 @@ export namespace ActionStartAIAssistantParams {
      */
     on_hangup?: 'continue_conversation' | 'end_conversation';
   }
+
+  export interface XaiVoiceSettings {
+    /**
+     * Voice settings provider type
+     */
+    type: 'xai';
+
+    /**
+     * Language code, or `auto` to detect automatically.
+     */
+    language?: string;
+  }
 }
 
 export interface ActionStartForkingParams {

package/src/resources/conferences/actions.ts

@@ -940,6 +940,8 @@ export interface ActionSpeakParams {
    *   `voice_settings` to configure precision, sample_rate, and format.
    * - **Inworld:** Use `Inworld.<ModelId>.<VoiceId>` (e.g., `Inworld.Mini.Loretta`,
    *   `Inworld.Max.Oliver`). Supported models: `Mini`, `Max`.
+   * - **xAI:** Use `xAI.<VoiceId>` (e.g., `xAI.eve`). Available voices: `eve`,
+   *   `ara`, `rex`, `sal`, `leo`.
    *
    * For service_level basic, you may define the gender of the speaker (male or
    * female).
@@ -1017,7 +1019,8 @@ export interface ActionSpeakParams {
     | Shared.AzureVoiceSettings
     | Shared.RimeVoiceSettings
     | Shared.ResembleVoiceSettings
-    | ActionSpeakParams.InworldVoiceSettings;
+    | ActionSpeakParams.InworldVoiceSettings
+    | ActionSpeakParams.XaiVoiceSettings;
 }
 
 export namespace ActionSpeakParams {
@@ -1027,6 +1030,18 @@ export namespace ActionSpeakParams {
      */
     type: 'inworld';
   }
+
+  export interface XaiVoiceSettings {
+    /**
+     * Voice settings provider type
+     */
+    type: 'xai';
+
+    /**
+     * Language code, or `auto` to detect automatically.
+     */
+    language?: string;
+  }
 }
 
 export interface ActionStopParams {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '6.46.0'; // x-release-please-version
+export const VERSION = '6.48.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.46.0";
+export declare const VERSION = "6.48.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "6.46.0";
+export declare const VERSION = "6.48.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '6.46.0'; // x-release-please-version
+exports.VERSION = '6.48.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '6.46.0'; // x-release-please-version
+export const VERSION = '6.48.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map