telnyx 7.22.0 → 7.24.0

package/resources/ai/assistants/assistants.d.ts

@@ -15,6 +15,7 @@ import * as AssistantsToolsAPI from "./tools.js";
 import { ToolAddParams, ToolAddResponse, ToolRemoveParams, ToolRemoveResponse, ToolTestParams, ToolTestResponse, Tools } from "./tools.js";
 import * as VersionsAPI from "./versions.js";
 import { UpdateAssistant, VersionDeleteParams, VersionPromoteParams, VersionRetrieveParams, VersionUpdateParams, Versions } from "./versions.js";
+import * as OpenAIChatAPI from "../openai/chat.js";
 import * as TestsAPI from "./tests/tests.js";
 import { AssistantTest, AssistantTestsDefaultFlatPagination, TelnyxConversationChannel, TestCreateParams, TestListParams, TestUpdateParams, Tests } from "./tests/tests.js";
 import { APIPromise } from "../../../core/api-promise.js";
@@ -371,11 +372,35 @@ export interface AssistantMcpServer {
  * another AI assistant. By default, this will happen transparently to the end
  * user.
  */
-export type AssistantTool = InferenceEmbeddingWebhookToolParams | AssistantTool.ClientSideTool | RetrievalTool | AssistantTool.Handoff | HangupTool | AssistantTool.Transfer | AssistantTool.Invite | AssistantTool.Refer | AssistantTool.SendDtmf | AssistantTool.SendMessage | AssistantTool.SkipTurn | AssistantTool.Pay | AssistantTool.UpdateDynamicVariables;
+export type AssistantTool = AssistantTool.Function | InferenceEmbeddingWebhookToolParams | AssistantTool.ClientSideTool | RetrievalTool | AssistantTool.Handoff | AssistantTool.Hangup | AssistantTool.Transfer | AssistantTool.Invite | AssistantTool.Refer | AssistantTool.SendDtmf | AssistantTool.SendMessage | AssistantTool.SkipTurn | AssistantTool.Pay | AssistantTool.UpdateDynamicVariables;
 export declare namespace AssistantTool {
+    interface Function {
+        function: OpenAIChatAPI.FunctionDefinition;
+        type: 'function';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
+    }
     interface ClientSideTool {
         client_side_tool: ClientSideTool.ClientSideTool;
         type: 'client_side_tool';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
     }
     namespace ClientSideTool {
         interface ClientSideTool {
@@ -423,6 +448,16 @@ export declare namespace AssistantTool {
     interface Handoff {
         handoff: Handoff.Handoff;
         type: 'handoff';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
     }
     namespace Handoff {
         interface Handoff {
@@ -451,9 +486,33 @@ export declare namespace AssistantTool {
             }
         }
     }
+    interface Hangup {
+        hangup: AssistantsAPI.HangupToolParams;
+        type: 'hangup';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
+    }
     interface Transfer {
         transfer: Transfer.Transfer;
         type: 'transfer';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
     }
     namespace Transfer {
         interface Transfer {
@@ -528,6 +587,14 @@ export declare namespace AssistantTool {
                  * The destination number or SIP URI of the call.
                  */
                 to: string;
+                /**
+                 * DTMF digits to send automatically after the transfer destination answers. Useful
+                 * for reaching an extension behind an IVR (e.g. `"200"` to dial extension 200 once
+                 * the called party picks up). Allowed characters: `0-9`, `A-D`, `w` (0.5s pause),
+                 * `W` (1s pause), `*`, `#`. Maximum 64 characters. When omitted, no automatic DTMF
+                 * is sent.
+                 */
+                extension?: string;
                 /**
                  * The warm transfer message to deliver to this specific target. When set, it takes
                  * precedence over the message the assistant composes from
@@ -538,6 +605,16 @@ export declare namespace AssistantTool {
                  * The name of the target.
                  */
                 name?: string;
+                /**
+                 * SIP Authentication password used for SIP challenges. Applies when `to` is a SIP
+                 * URI.
+                 */
+                sip_auth_password?: string;
+                /**
+                 * SIP Authentication username used for SIP challenges. Applies when `to` is a SIP
+                 * URI.
+                 */
+                sip_auth_username?: string;
             }
             interface CustomHeader {
                 name?: string;
@@ -688,6 +765,16 @@ export declare namespace AssistantTool {
     interface Invite {
         invite: Invite.Invite;
         type: 'invite';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
     }
     namespace Invite {
         interface Invite {
@@ -766,6 +853,16 @@ export declare namespace AssistantTool {
     interface Refer {
         refer: Refer.Refer;
         type: 'refer';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
     }
     namespace Refer {
         interface Refer {
@@ -830,6 +927,16 @@ export declare namespace AssistantTool {
             [key: string]: unknown;
         };
         type: 'send_dtmf';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
     }
     /**
      * The send_message tool allows the assistant to send SMS or MMS messages to the
@@ -840,6 +947,16 @@ export declare namespace AssistantTool {
     interface SendMessage {
         send_message: SendMessage.SendMessage;
         type: 'send_message';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
     }
     namespace SendMessage {
         interface SendMessage {
@@ -857,6 +974,16 @@ export declare namespace AssistantTool {
     interface SkipTurn {
         skip_turn: SkipTurn.SkipTurn;
         type: 'skip_turn';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
     }
     namespace SkipTurn {
         interface SkipTurn {
@@ -875,6 +1002,16 @@ export declare namespace AssistantTool {
     interface Pay {
         pay: ToolsAPI.PayToolParams;
         type: 'pay';
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
     }
     /**
      * The update_dynamic_variables tool lets the assistant write values into the
@@ -889,6 +1026,16 @@ export declare namespace AssistantTool {
          * Configuration for an update_dynamic_variables tool.
          */
         update_dynamic_variables: ToolsAPI.UpdateDynamicVariablesToolParams;
+        /**
+         * Whether this tool comes from the shared Tools Library. Responses merge shared
+         * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+         * Read-only: set by the server, not accepted in requests. When updating an
+         * assistant, omit `shared: true` tools from the request `tools` array and manage
+         * them through `tool_ids` instead — re-sending their definitions creates an inline
+         * duplicate (rejected with error code 10015 when the type allows only one instance
+         * per assistant).
+         */
+        shared?: boolean;
     }
 }
 export interface AssistantsList {
@@ -1345,7 +1492,7 @@ export interface FlowNode {
     /**
      * Per-node voice override (response form).
      */
-    voice_settings?: VoiceSettings;
+    voice_settings?: InferenceEmbeddingVoiceSettings;
 }
 /**
  * One step in a conversation flow, as supplied by API clients.
@@ -1424,7 +1571,7 @@ export interface FlowNodeReq {
      * Per-node voice override. Only fields set here override the assistant-level voice
      * settings; unset fields cascade.
      */
-    voice_settings?: VoiceSettings;
+    voice_settings?: InferenceEmbeddingVoiceSettings;
 }
 export interface HangupTool {
     hangup: HangupToolParams;
@@ -1552,10 +1699,10 @@ export interface InferenceEmbedding {
     /**
      * 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.
+     * execute final tool calls such as sending a summary or updating a record via
+     * webhook or function tools. Integration and MCP server tools are not available
+     * post-conversation; call-control tools (e.g. hangup, transfer) are also
+     * unavailable. Beta feature.
      */
     post_conversation_settings?: PostConversationSettings;
     privacy_settings?: PrivacySettings;
@@ -1570,9 +1717,12 @@ export interface InferenceEmbedding {
     tags?: Array<string>;
     telephony_settings?: TelephonySettings;
     /**
-     * Deprecated for new integrations. Inline tool definitions available to the
-     * assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
-     * endpoints.
+     * The assistant's tools. Responses merge the assistant's shared Tools Library
+     * tools into this array alongside inline tools, each flagged `shared: true`;
+     * inline tools carry `shared: false`. On update, a sent `tools` array fully
+     * replaces the inline tools only — shared tools stay attached unless `tool_ids`
+     * changes. Each tool type except `function`, `webhook`, and `client_side_tool`
+     * allows at most one instance per assistant across both sources.
      */
     tools?: Array<AssistantTool>;
     transcription?: TranscriptionSettings;
@@ -1589,7 +1739,7 @@ export interface InferenceEmbedding {
      * Human-readable name for the assistant version.
      */
     version_name?: string;
-    voice_settings?: VoiceSettings;
+    voice_settings?: InferenceEmbeddingVoiceSettings;
     /**
      * Configuration settings for the assistant's web widget.
      */
@@ -1612,6 +1762,11 @@ export interface InferenceEmbeddingInterruptionSettings {
      * Whether users can interrupt the assistant while it is speaking.
      */
     enable?: boolean;
+    /**
+     * Interrupt-prediction sensitivity, from 0.0 to 1.0. Set to null or 0.0 to disable
+     * interrupt prediction.
+     */
+    interrupt_prediction_threshold?: number | null;
     /**
      * Controls when the assistant starts speaking after the user stops. These
      * thresholds primarily apply to non turn-taking transcription models. For
@@ -1620,9 +1775,141 @@ export interface InferenceEmbeddingInterruptionSettings {
      */
     start_speaking_plan?: StartSpeakingPlan;
 }
+export interface InferenceEmbeddingVoiceSettings {
+    /**
+     * The voice to be used by the voice assistant. Check the full list of
+     * [available voices](https://developers.telnyx.com/docs/tts-stt/tts-available-voices)
+     * via our voices API. To use ElevenLabs, you must reference your ElevenLabs API
+     * key as an integration secret under the `api_key_ref` field. See
+     * [integration secrets documentation](https://developers.telnyx.com/api-reference/integration-secrets/create-a-secret)
+     * for details. For Telnyx voices, use `Telnyx.<model_id>.<voice_id>` (e.g.
+     * Telnyx.KokoroTTS.af_heart). For Soniox voices, use `Soniox.tts-rt-v2.<voice_id>`
+     * (e.g. Soniox.tts-rt-v2.Emma); every Soniox voice speaks all supported languages.
+     * The voice portion of the identifier supports
+     * [dynamic variables](https://developers.telnyx.com/docs/inference/ai-assistants/dynamic-variables)
+     * using mustache syntax (e.g. `Telnyx.Ultra.{{voice_id}}`). The variable is
+     * resolved at call time from your dynamic variables webhook, allowing you to
+     * select the voice dynamically per call.
+     */
+    voice: string;
+    /**
+     * The `identifier` for an integration secret
+     * [/v2/integration_secrets](https://developers.telnyx.com/api-reference/integration-secrets/create-a-secret)
+     * that refers to your ElevenLabs API key. Warning: Free plans are unlikely to work
+     * with this integration.
+     */
+    api_key_ref?: string;
+    /**
+     * Optional background audio to play on the call. Use a predefined media bed, or
+     * supply a looped MP3 URL. If a media URL is chosen in the portal, customers can
+     * preview it before saving.
+     */
+    background_audio?: InferenceEmbeddingVoiceSettings.UnionMember0 | InferenceEmbeddingVoiceSettings.UnionMember1 | InferenceEmbeddingVoiceSettings.UnionMember2;
+    /**
+     * Enables emotionally expressive speech using SSML emotion tags. When enabled, the
+     * assistant uses audio tags like angry, excited, content, and sad to add emotional
+     * nuance. Only supported for Telnyx Ultra voices.
+     */
+    expressive_mode?: boolean;
+    /**
+     * Enhances recognition for specific languages and dialects during MiniMax TTS
+     * synthesis. Default is null (no boost). Set to 'auto' for automatic language
+     * detection. Only applicable when using MiniMax voices.
+     */
+    language_boost?: 'auto' | 'Chinese' | 'Chinese,Yue' | 'English' | 'Arabic' | 'Russian' | 'Spanish' | 'French' | 'Portuguese' | 'German' | 'Turkish' | 'Dutch' | 'Ukrainian' | 'Vietnamese' | 'Indonesian' | 'Japanese' | 'Italian' | 'Korean' | 'Thai' | 'Polish' | 'Romanian' | 'Greek' | 'Czech' | 'Finnish' | 'Hindi' | 'Bulgarian' | 'Danish' | 'Hebrew' | 'Malay' | 'Persian' | 'Slovak' | 'Swedish' | 'Croatian' | 'Filipino' | 'Hungarian' | 'Norwegian' | 'Slovenian' | 'Catalan' | 'Nynorsk' | 'Tamil' | 'Afrikaans' | null;
+    /**
+     * Determines how closely the AI should adhere to the original voice when
+     * attempting to replicate it. Only applicable when using ElevenLabs.
+     */
+    similarity_boost?: number;
+    /**
+     * Adjusts speech velocity. 1.0 is default speed; values less than 1.0 slow speech;
+     * values greater than 1.0 accelerate it. Only applicable when using ElevenLabs.
+     */
+    speed?: number;
+    /**
+     * Determines the style exaggeration of the voice. Amplifies speaker style but
+     * consumes additional resources when set above 0. Only applicable when using
+     * ElevenLabs.
+     */
+    style?: number;
+    /**
+     * Determines how stable the voice is and the randomness between each generation.
+     * Lower values create a broader emotional range; higher values produce more
+     * consistent, monotonous output. Only applicable when using ElevenLabs.
+     */
+    temperature?: number;
+    /**
+     * Amplifies similarity to the original speaker voice. Increases computational load
+     * and latency slightly. Only applicable when using ElevenLabs.
+     */
+    use_speaker_boost?: boolean;
+    /**
+     * The speed of the voice in the range [0.25, 2.0]. 1.0 is deafult speed. Larger
+     * numbers make the voice faster, smaller numbers make it slower. This is only
+     * applicable for Telnyx Natural voices and Soniox voices (0.7 to 1.3 for Soniox).
+     */
+    voice_speed?: number;
+}
+export declare namespace InferenceEmbeddingVoiceSettings {
+    interface UnionMember0 {
+        /**
+         * Select from predefined media options.
+         */
+        type: 'predefined_media';
+        /**
+         * The predefined media to use. `silence` disables background audio.
+         */
+        value: 'silence' | 'office';
+        /**
+         * Volume level for the predefined background audio. Supports values from 0.1 to
+         * 1.0 in 0.1 increments.
+         */
+        volume?: number;
+    }
+    interface UnionMember1 {
+        /**
+         * Provide a direct URL to an MP3 file. The audio will loop during the call.
+         */
+        type: 'media_url';
+        /**
+         * HTTPS URL to an MP3 file.
+         */
+        value: string;
+    }
+    interface UnionMember2 {
+        /**
+         * Reference a previously uploaded media by its name from Telnyx Media Storage.
+         */
+        type: 'media_name';
+        /**
+         * The `name` of a media asset created via
+         * [Media Storage API](https://developers.telnyx.com/api/media-storage/create-media-storage).
+         * The audio will loop during the call.
+         */
+        value: string;
+    }
+}
 export interface InferenceEmbeddingWebhookToolParams {
     type: 'webhook';
     webhook: InferenceEmbeddingWebhookToolParams.Webhook;
+    /**
+     * Whether this tool comes from the shared Tools Library. Responses merge shared
+     * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+     * Read-only: set by the server, not accepted in requests. When updating an
+     * assistant, omit `shared: true` tools from the request `tools` array and manage
+     * them through `tool_ids` instead — re-sending their definitions creates an inline
+     * duplicate (rejected with error code 10015 when the type allows only one instance
+     * per assistant).
+     */
+    shared?: boolean;
+    /**
+     * The maximum number of milliseconds to wait for the webhook to respond before the
+     * tool call is aborted. Set this at the tool level, as a sibling of `type` — a
+     * `timeout_ms` nested inside the `webhook` object is stored but not applied, and
+     * the tool runs at this default instead. Applies when `webhook.async` is false.
+     */
+    timeout_ms?: number;
 }
 export declare namespace InferenceEmbeddingWebhookToolParams {
     interface Webhook {
@@ -1722,11 +2009,6 @@ export declare namespace InferenceEmbeddingWebhookToolParams {
          * dot-notation path to the value in the response body.
          */
         store_fields_as_variables?: Array<Webhook.StoreFieldsAsVariable>;
-        /**
-         * The maximum number of milliseconds to wait for the webhook to respond. Only
-         * applicable when async is false.
-         */
-        timeout_ms?: number;
     }
     namespace Webhook {
         /**
@@ -1921,10 +2203,10 @@ export type ObservabilityStatus = 'enabled' | 'disabled';
 /**
  * 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.
+ * execute final tool calls such as sending a summary or updating a record via
+ * webhook or function tools. Integration and MCP server tools are not available
+ * post-conversation; call-control tools (e.g. hangup, transfer) are also
+ * unavailable. Beta feature.
  */
 export interface PostConversationSettings {
     /**
@@ -1937,10 +2219,10 @@ export interface PostConversationSettings {
 /**
  * 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.
+ * execute final tool calls such as sending a summary or updating a record via
+ * webhook or function tools. Integration and MCP server tools are not available
+ * post-conversation; call-control tools (e.g. hangup, transfer) are also
+ * unavailable. Beta feature.
  */
 export interface PostConversationSettingsReq {
     /**
@@ -1960,6 +2242,21 @@ export interface PrivacySettings {
      * force regardless of your selection here.
      */
     data_retention?: boolean;
+    /**
+     * Requires every model call made for a web chat turn to be received and served
+     * inside your organization's data-locality region, rather than only stored there.
+     * Applies to web chat only — voice and messaging assistants are unaffected.
+     * Enabling it requires a data-locality region with in-region inference (USA, EU,
+     * AUS, UAE; see
+     * [Inference regions](https://developers.telnyx.com/docs/inference/models/regions))
+     * and Telnyx-hosted models for the assistant, its fallback, and any
+     * conversation-flow node that overrides the model; the request is rejected
+     * otherwise. Once enabled, send chat requests to your region's API hostname: a
+     * request entering the platform in another region is rejected rather than
+     * forwarded, because forwarding it would already have moved the content across the
+     * border. Defaults to false.
+     */
+    in_transit_data_locality?: boolean;
 }
 /**
  * Whether to auto-publish the assistant's instructions as a Langfuse prompt.
@@ -1972,6 +2269,16 @@ export type PromptSyncStatus = 'enabled' | 'disabled';
 export interface RetrievalTool {
     retrieval: ChatAPI.BucketIDs;
     type: 'retrieval';
+    /**
+     * Whether this tool comes from the shared Tools Library. Responses merge shared
+     * tools into `tools` with `shared: true`; inline tools carry `shared: false`.
+     * Read-only: set by the server, not accepted in requests. When updating an
+     * assistant, omit `shared: true` tools from the request `tools` array and manage
+     * them through `tool_ids` instead — re-sending their definitions creates an inline
+     * duplicate (rejected with error code 10015 when the type allows only one instance
+     * per assistant).
+     */
+    shared?: boolean;
 }
 /**
  * A standalone scripted-message step in a flow, as returned by the API.
@@ -2084,13 +2391,16 @@ export interface TelephonySettings {
      */
     fallback_destination?: string;
     /**
-     * The noise suppression engine to use. Use 'disabled' to turn off noise
-     * suppression.
+     * The noise suppression engine to use. 'aicoustics' is STT-optimized and
+     * recommended for AI assistants (configure through noise_suppression_config). Use
+     * 'disabled' to turn off noise suppression.
      */
-    noise_suppression?: 'krisp' | 'deepfilternet' | 'disabled';
+    noise_suppression?: 'aicoustics' | 'krisp' | 'deepfilternet' | 'disabled';
     /**
-     * Configuration for noise suppression. Only applicable when noise_suppression is
-     * 'deepfilternet'.
+     * Configuration for noise suppression. Applicable fields depend on the engine:
+     * 'attenuation_limit' and 'mode' only when noise_suppression is 'deepfilternet';
+     * 'family', 'size' and 'enhancement_level' only when noise_suppression is
+     * 'aicoustics'.
      */
     noise_suppression_config?: TelephonySettings.NoiseSuppressionConfig;
     /**
@@ -2146,18 +2456,38 @@ export interface TelephonySettings {
 }
 export declare namespace TelephonySettings {
     /**
-     * Configuration for noise suppression. Only applicable when noise_suppression is
-     * 'deepfilternet'.
+     * Configuration for noise suppression. Applicable fields depend on the engine:
+     * 'attenuation_limit' and 'mode' only when noise_suppression is 'deepfilternet';
+     * 'family', 'size' and 'enhancement_level' only when noise_suppression is
+     * 'aicoustics'.
      */
     interface NoiseSuppressionConfig {
         /**
-         * Attenuation limit for noise suppression. Range: 0-100.
+         * Attenuation limit for noise suppression. Range: 0-100. Only applicable when
+         * noise_suppression is 'deepfilternet'.
          */
         attenuation_limit?: number;
         /**
-         * Mode for noise suppression configuration.
+         * AiCoustics enhancement intensity. Range: 0-1. Only applicable when
+         * noise_suppression is 'aicoustics'.
+         */
+        enhancement_level?: number;
+        /**
+         * AiCoustics model family optimized for Voice AI and STT. Only applicable when
+         * noise_suppression is 'aicoustics'.
+         */
+        family?: 'quail';
+        /**
+         * Mode for noise suppression configuration. Only applicable when noise_suppression
+         * is 'deepfilternet'.
          */
         mode?: 'advanced';
+        /**
+         * AiCoustics model size. 'vf' tracks the latest model release; 'vf_2_0_l' is
+         * pinned to version 2.0 for consistent, predictable behavior. Only applicable when
+         * noise_suppression is 'aicoustics'.
+         */
+        size?: 'vf' | 'vf_2_0_l';
     }
     /**
      * Configuration for call recording format and channel settings.
@@ -2366,21 +2696,24 @@ export interface TranscriptionSettings {
      * - `deepgram/nova-3` is multilingual with automatic language detection.
      * - `deepgram/nova-2` is Deepgram's previous-generation multilingual model.
      * - `azure/fast` is a multilingual Azure transcription model.
-     * - `assemblyai/universal-streaming` is a multilingual streaming model with
-     *   configurable turn detection.
+     * - `assemblyai/universal-3-5-pro` is a multilingual streaming model with
+     *   configurable turn detection. The legacy alias `assemblyai/universal-streaming`
+     *   is still accepted and resolves to the same model.
      * - `xai/grok-stt` is a multilingual Grok STT model.
      * - `soniox/stt-rt-v4` and `soniox/stt-rt-v5` are multilingual streaming models
      *   with automatic language detection, configurable endpointing, term biasing
      *   (`context`), and `language_hints`.
      * - `nvidia/parakeet-v3` is a multilingual transcription model with automatic
      *   language detection.
+     * - `omi-health/omi-med-stt-v1` is an English-only medical transcription model
+     *   (Parakeet-based).
      * - `humain/realtime` is a streaming model with native Arabic and Arabic/English
      *   code-switching support.
      * - `reson8/turns` is a turn-based streaming model covering 10 European languages
      *   with automatic language detection.
      * - `cohere/ar-stt` is a non-streaming Arabic and English transcription model.
      */
-    model?: 'deepgram/flux' | 'deepgram/nova-3' | 'deepgram/nova-2' | 'azure/fast' | 'assemblyai/universal-streaming' | 'xai/grok-stt' | 'soniox/stt-rt-v4' | 'soniox/stt-rt-v5' | 'nvidia/parakeet-v3' | 'humain/realtime' | 'reson8/turns' | 'cohere/ar-stt' | 'distil-whisper/distil-large-v2' | 'openai/whisper-large-v3-turbo';
+    model?: 'deepgram/flux' | 'deepgram/nova-3' | 'deepgram/nova-2' | 'azure/fast' | 'assemblyai/universal-3-5-pro' | 'assemblyai/universal-streaming' | 'xai/grok-stt' | 'soniox/stt-rt-v4' | 'soniox/stt-rt-v5' | 'nvidia/parakeet-v3' | 'omi-health/omi-med-stt-v1' | 'humain/realtime' | 'reson8/turns' | 'cohere/ar-stt' | 'distil-whisper/distil-large-v2' | 'openai/whisper-large-v3-turbo';
     /**
      * Region on third party cloud providers (currently Azure) if using one of their
      * models. Some regions require `api_key_ref`.
@@ -2412,9 +2745,9 @@ export interface TranscriptionSettingsConfig {
      */
     enable_endpoint_detection?: boolean;
     /**
-     * Available only for assemblyai/universal-streaming. Confidence level required to
-     * trigger an end of turn. Higher values require more certainty before ending a
-     * turn.
+     * Available only for assemblyai/universal-3-5-pro (and its legacy alias
+     * assemblyai/universal-streaming). Confidence level required to trigger an end of
+     * turn. Higher values require more certainty before ending a turn.
      */
     end_of_turn_confidence_threshold?: number;
     /**
@@ -2455,14 +2788,15 @@ export interface TranscriptionSettingsConfig {
      */
     max_endpoint_delay_ms?: number;
     /**
-     * Available only for assemblyai/universal-streaming. Maximum duration of silence
-     * in milliseconds before forcing an end of turn.
+     * Available only for assemblyai/universal-3-5-pro (and its legacy alias
+     * assemblyai/universal-streaming). Maximum duration of silence in milliseconds
+     * before forcing an end of turn.
      */
     max_turn_silence?: number;
     /**
-     * Available only for assemblyai/universal-streaming. Minimum duration of silence
-     * in milliseconds before a turn can end. Must be less than or equal to
-     * max_turn_silence.
+     * Available only for assemblyai/universal-3-5-pro (and its legacy alias
+     * assemblyai/universal-streaming). Minimum duration of silence in milliseconds
+     * before a turn can end. Must be less than or equal to max_turn_silence.
      */
     min_turn_silence?: number;
     numerals?: boolean;
@@ -2615,6 +2949,13 @@ export declare namespace VoiceSettings {
 export interface WebhookTool {
     type: 'webhook';
     webhook: WebhookTool.Webhook;
+    /**
+     * The maximum number of milliseconds to wait for the webhook to respond before the
+     * tool call is aborted. Set this at the tool level, as a sibling of `type` — a
+     * `timeout_ms` nested inside the `webhook` object is not applied, and the tool
+     * runs at this default instead.
+     */
+    timeout_ms?: number;
 }
 export declare namespace WebhookTool {
     interface Webhook {
@@ -2934,10 +3275,10 @@ export interface AssistantCreateParams {
     /**
      * Body param: 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.
+     * it to execute final tool calls such as sending a summary or updating a record
+     * via webhook or function tools. Integration and MCP server tools are not
+     * available post-conversation; call-control tools (e.g. hangup, transfer) are also
+     * unavailable. Beta feature.
      */
     post_conversation_settings?: PostConversationSettingsReq;
     /**
@@ -2971,7 +3312,7 @@ export interface AssistantCreateParams {
     /**
      * Body param
      */
-    voice_settings?: VoiceSettings;
+    voice_settings?: InferenceEmbeddingVoiceSettings;
     /**
      * Body param: Configuration settings for the assistant's web widget.
      */
@@ -3142,10 +3483,10 @@ export interface AssistantUpdateParams {
     /**
      * 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.
+     * execute final tool calls such as sending a summary or updating a record via
+     * webhook or function tools. Integration and MCP server tools are not available
+     * post-conversation; call-control tools (e.g. hangup, transfer) are also
+     * unavailable. Beta feature.
      */
     post_conversation_settings?: PostConversationSettingsReq;
     privacy_settings?: PrivacySettings;
@@ -3162,13 +3503,24 @@ export interface AssistantUpdateParams {
     telephony_settings?: TelephonySettings;
     /**
      * IDs of shared tools to attach to the assistant. New integrations should prefer
-     * `tool_ids` over inline `tools`.
+     * `tool_ids` over inline `tools`. On update, a sent `tool_ids` array fully
+     * replaces the assistant's attached shared tools; omit the field to leave them
+     * unchanged. Single-instance tool types are counted across inline `tools` and
+     * `tool_ids` combined, so attaching a shared tool of such a type when an instance
+     * already exists returns HTTP 400 with error code 10015.
      */
     tool_ids?: Array<string>;
     /**
      * Deprecated for new integrations. Inline tool definitions available to the
      * assistant. Prefer `tool_ids` to attach shared tools created with the AI Tools
-     * endpoints.
+     * endpoints. On update, a sent `tools` array fully replaces the assistant's inline
+     * tools; omit the field to leave the inline tools unchanged. Each tool type except
+     * `function`, `webhook`, and `client_side_tool` allows at most one instance per
+     * assistant, counted across inline `tools` and shared `tool_ids` combined —
+     * sending a duplicate of such a type returns HTTP 400 with error code 10015.
+     * Responses merge shared tools into `tools` with `shared: true`; when updating,
+     * omit those tools from the `tools` array and manage them through `tool_ids`
+     * instead.
      */
     tools?: Array<AssistantTool>;
     transcription?: TranscriptionSettings;
@@ -3176,7 +3528,7 @@ export interface AssistantUpdateParams {
      * Human-readable name for the assistant version.
      */
     version_name?: string;
-    voice_settings?: VoiceSettings;
+    voice_settings?: InferenceEmbeddingVoiceSettings;
     /**
      * Configuration settings for the assistant's web widget.
      */
@@ -3253,7 +3605,7 @@ export interface AssistantSendSMSParams {
     'Idempotency-Key'?: string;
 }
 export declare namespace Assistants {
-    export { type ArithmeticExpression as ArithmeticExpression, type Assistant as Assistant, type AssistantA2AAgent as AssistantA2AAgent, type AssistantIntegration as AssistantIntegration, type AssistantMcpServer as AssistantMcpServer, type AssistantTool as AssistantTool, type AssistantsList as AssistantsList, type AudioVisualizerConfig as AudioVisualizerConfig, type AuthenticationMethod as AuthenticationMethod, type BooleanOpExpression as BooleanOpExpression, type ComparisonExpression as ComparisonExpression, type ConversationFlow as ConversationFlow, type ConversationFlowReq as ConversationFlowReq, type EnabledFeatures as EnabledFeatures, type Expression as Expression, type ExternalLlm as ExternalLlm, type ExternalLlmReq as ExternalLlmReq, type FallbackConfig as FallbackConfig, type FallbackConfigReq as FallbackConfigReq, type FlowEdge as FlowEdge, type FlowNode as FlowNode, type FlowNodeReq as FlowNodeReq, type HangupTool as HangupTool, 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, type NodePosition as NodePosition, type Observability as Observability, type ObservabilityReq as ObservabilityReq, type ObservabilityStatus as ObservabilityStatus, type PostConversationSettings as PostConversationSettings, type PostConversationSettingsReq as PostConversationSettingsReq, type PrivacySettings as PrivacySettings, type PromptSyncStatus as PromptSyncStatus, type RetrievalTool as RetrievalTool, type SpeakNode as SpeakNode, type SpeakNodeReq as SpeakNodeReq, type StartSpeakingPlan as StartSpeakingPlan, type TelephonySettings as TelephonySettings, type ToolNode as ToolNode, type ToolNodeReq as ToolNodeReq, type TranscriptionEndpointingPlan as TranscriptionEndpointingPlan, type TranscriptionSettings as TranscriptionSettings, type TranscriptionSettingsConfig as TranscriptionSettingsConfig, type TransferTool as TransferTool, type VoiceSettings as VoiceSettings, type WebhookTool as WebhookTool, type WidgetSettings as WidgetSettings, type AssistantDeleteResponse as AssistantDeleteResponse, type AssistantChatResponse as AssistantChatResponse, type AssistantGetTexmlResponse as AssistantGetTexmlResponse, type AssistantSendSMSResponse as AssistantSendSMSResponse, type AssistantCreateParams as AssistantCreateParams, type AssistantImportsParams as AssistantImportsParams, type AssistantRetrieveParams as AssistantRetrieveParams, type AssistantUpdateParams as AssistantUpdateParams, type AssistantChatParams as AssistantChatParams, type AssistantCloneParams as AssistantCloneParams, type AssistantSendSMSParams as AssistantSendSMSParams, };
+    export { type ArithmeticExpression as ArithmeticExpression, type Assistant as Assistant, type AssistantA2AAgent as AssistantA2AAgent, type AssistantIntegration as AssistantIntegration, type AssistantMcpServer as AssistantMcpServer, type AssistantTool as AssistantTool, type AssistantsList as AssistantsList, type AudioVisualizerConfig as AudioVisualizerConfig, type AuthenticationMethod as AuthenticationMethod, type BooleanOpExpression as BooleanOpExpression, type ComparisonExpression as ComparisonExpression, type ConversationFlow as ConversationFlow, type ConversationFlowReq as ConversationFlowReq, type EnabledFeatures as EnabledFeatures, type Expression as Expression, type ExternalLlm as ExternalLlm, type ExternalLlmReq as ExternalLlmReq, type FallbackConfig as FallbackConfig, type FallbackConfigReq as FallbackConfigReq, type FlowEdge as FlowEdge, type FlowNode as FlowNode, type FlowNodeReq as FlowNodeReq, type HangupTool as HangupTool, type HangupToolParams as HangupToolParams, type ImportMetadata as ImportMetadata, type InferenceEmbedding as InferenceEmbedding, type InferenceEmbeddingInterruptionSettings as InferenceEmbeddingInterruptionSettings, type InferenceEmbeddingVoiceSettings as InferenceEmbeddingVoiceSettings, type InferenceEmbeddingWebhookToolParams as InferenceEmbeddingWebhookToolParams, type InsightSettings as InsightSettings, type MessagingSettings as MessagingSettings, type NodePosition as NodePosition, type Observability as Observability, type ObservabilityReq as ObservabilityReq, type ObservabilityStatus as ObservabilityStatus, type PostConversationSettings as PostConversationSettings, type PostConversationSettingsReq as PostConversationSettingsReq, type PrivacySettings as PrivacySettings, type PromptSyncStatus as PromptSyncStatus, type RetrievalTool as RetrievalTool, type SpeakNode as SpeakNode, type SpeakNodeReq as SpeakNodeReq, type StartSpeakingPlan as StartSpeakingPlan, type TelephonySettings as TelephonySettings, type ToolNode as ToolNode, type ToolNodeReq as ToolNodeReq, type TranscriptionEndpointingPlan as TranscriptionEndpointingPlan, type TranscriptionSettings as TranscriptionSettings, type TranscriptionSettingsConfig as TranscriptionSettingsConfig, type TransferTool as TransferTool, type VoiceSettings as VoiceSettings, type WebhookTool as WebhookTool, type WidgetSettings as WidgetSettings, type AssistantDeleteResponse as AssistantDeleteResponse, type AssistantChatResponse as AssistantChatResponse, type AssistantGetTexmlResponse as AssistantGetTexmlResponse, type AssistantSendSMSResponse as AssistantSendSMSResponse, type AssistantCreateParams as AssistantCreateParams, type AssistantImportsParams as AssistantImportsParams, type AssistantRetrieveParams as AssistantRetrieveParams, type AssistantUpdateParams as AssistantUpdateParams, type AssistantChatParams as AssistantChatParams, type AssistantCloneParams as AssistantCloneParams, type AssistantSendSMSParams as AssistantSendSMSParams, };
     export { Tests as Tests, type AssistantTest as AssistantTest, type TelnyxConversationChannel as TelnyxConversationChannel, type AssistantTestsDefaultFlatPagination as AssistantTestsDefaultFlatPagination, type TestListParams as TestListParams, type TestCreateParams as TestCreateParams, type TestUpdateParams as TestUpdateParams, };
     export { CanaryDeploys as CanaryDeploys, type CanaryDeploy as CanaryDeploy, type CanaryDeployResponse as CanaryDeployResponse, type Clause as Clause, type RolloutSlot as RolloutSlot, type RuleInput as RuleInput, type RuleOutput as RuleOutput, type Serve as Serve, type CanaryDeployCreateParams as CanaryDeployCreateParams, type CanaryDeployUpdateParams as CanaryDeployUpdateParams, };
     export { ScheduledEvents as ScheduledEvents, type ConversationChannelType as ConversationChannelType, type EventStatus as EventStatus, type ScheduledCallSettings as ScheduledCallSettings, type ScheduledEventResponse as ScheduledEventResponse, type ScheduledPhoneCallEventResponse as ScheduledPhoneCallEventResponse, type ScheduledSMSEventResponse as ScheduledSMSEventResponse, type ScheduledEventListResponse as ScheduledEventListResponse, type ScheduledEventListResponsesDefaultFlatPagination as ScheduledEventListResponsesDefaultFlatPagination, type ScheduledEventListParams as ScheduledEventListParams, type ScheduledEventCreateParams as ScheduledEventCreateParams, type ScheduledEventDeleteParams as ScheduledEventDeleteParams, type ScheduledEventRetrieveParams as ScheduledEventRetrieveParams, };