telnyx 7.22.0 → 7.24.0

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

@@ -57,6 +57,7 @@ import {
   VersionUpdateParams,
   Versions,
 } from './versions';
+import * as OpenAIChatAPI from '../openai/chat';
 import * as TestsAPI from './tests/tests';
 import {
   AssistantTest,
@@ -543,11 +544,12 @@ export interface AssistantMcpServer {
  * user.
  */
 export type AssistantTool =
+  | AssistantTool.Function
   | InferenceEmbeddingWebhookToolParams
   | AssistantTool.ClientSideTool
   | RetrievalTool
   | AssistantTool.Handoff
-  | HangupTool
+  | AssistantTool.Hangup
   | AssistantTool.Transfer
   | AssistantTool.Invite
   | AssistantTool.Refer
@@ -558,10 +560,38 @@ export type AssistantTool =
   | AssistantTool.UpdateDynamicVariables;
 
 export namespace AssistantTool {
+  export 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;
+  }
+
   export 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;
   }
 
   export namespace ClientSideTool {
@@ -615,6 +645,17 @@ export namespace AssistantTool {
     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;
   }
 
   export namespace Handoff {
@@ -648,10 +689,38 @@ export namespace AssistantTool {
     }
   }
 
+  export 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;
+  }
+
   export 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;
   }
 
   export namespace Transfer {
@@ -737,6 +806,15 @@ export namespace AssistantTool {
          */
         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
@@ -748,6 +826,18 @@ export 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;
       }
 
       export interface CustomHeader {
@@ -922,6 +1012,17 @@ export namespace AssistantTool {
     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;
   }
 
   export namespace Invite {
@@ -1013,6 +1114,17 @@ export namespace AssistantTool {
     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;
   }
 
   export namespace Refer {
@@ -1088,6 +1200,17 @@ export namespace AssistantTool {
     send_dtmf: { [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;
   }
 
   /**
@@ -1100,6 +1223,17 @@ export namespace AssistantTool {
     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;
   }
 
   export namespace SendMessage {
@@ -1121,6 +1255,17 @@ export namespace AssistantTool {
     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;
   }
 
   export namespace SkipTurn {
@@ -1142,6 +1287,17 @@ export namespace AssistantTool {
     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;
   }
 
   /**
@@ -1158,6 +1314,17 @@ export 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;
   }
 }
 
@@ -1697,7 +1864,7 @@ export interface FlowNode {
   /**
    * Per-node voice override (response form).
    */
-  voice_settings?: VoiceSettings;
+  voice_settings?: InferenceEmbeddingVoiceSettings;
 }
 
 /**
@@ -1789,7 +1956,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 {
@@ -1944,10 +2111,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;
 
@@ -1967,9 +2134,12 @@ export interface InferenceEmbedding {
   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>;
 
@@ -1991,7 +2161,7 @@ export interface InferenceEmbedding {
    */
   version_name?: string;
 
-  voice_settings?: VoiceSettings;
+  voice_settings?: InferenceEmbeddingVoiceSettings;
 
   /**
    * Configuration settings for the assistant's web widget.
@@ -2018,6 +2188,12 @@ export interface InferenceEmbeddingInterruptionSettings {
    */
   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
@@ -2027,10 +2203,207 @@ 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 namespace InferenceEmbeddingVoiceSettings {
+  export 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;
+  }
+
+  export 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;
+  }
+
+  export 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 namespace InferenceEmbeddingWebhookToolParams {
@@ -2142,12 +2515,6 @@ export 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;
   }
 
   export namespace Webhook {
@@ -2379,10 +2746,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 {
   /**
@@ -2396,10 +2763,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 {
   /**
@@ -2420,6 +2787,22 @@ 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;
 }
 
 /**
@@ -2435,6 +2818,17 @@ 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;
 }
 
 /**
@@ -2563,14 +2957,17 @@ 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;
 
@@ -2634,19 +3031,42 @@ export interface TelephonySettings {
 
 export 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'.
    */
   export 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';
   }
 
   /**
@@ -2882,14 +3302,17 @@ 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
@@ -2901,11 +3324,13 @@ export interface TranscriptionSettings {
     | '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'
@@ -2948,9 +3373,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;
 
@@ -2998,15 +3423,16 @@ 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;
 
@@ -3229,6 +3655,14 @@ 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 namespace WebhookTool {
@@ -3597,10 +4031,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;
 
@@ -3641,7 +4075,7 @@ export interface AssistantCreateParams {
   /**
    * Body param
    */
-  voice_settings?: VoiceSettings;
+  voice_settings?: InferenceEmbeddingVoiceSettings;
 
   /**
    * Body param: Configuration settings for the assistant's web widget.
@@ -3841,10 +4275,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;
 
@@ -3866,14 +4300,25 @@ export interface AssistantUpdateParams {
 
   /**
    * 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>;
 
@@ -3884,7 +4329,7 @@ export interface AssistantUpdateParams {
    */
   version_name?: string;
 
-  voice_settings?: VoiceSettings;
+  voice_settings?: InferenceEmbeddingVoiceSettings;
 
   /**
    * Configuration settings for the assistant's web widget.
@@ -4008,6 +4453,7 @@ export declare namespace Assistants {
     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,