retell-sdk 4.61.0 → 4.62.0

package/resources/conversation-flow.js

@@ -13,7 +13,7 @@ class ConversationFlow extends resource_1.APIResource {
      * ```ts
      * const conversationFlowResponse =
      *   await client.conversationFlow.create({
-     *     model_choice: { model: 'gpt-5', type: 'cascading' },
+     *     model_choice: { model: 'gpt-4.1', type: 'cascading' },
      *     nodes: [
      *       {
      *         id: 'start',

package/resources/conversation-flow.mjs

@@ -10,7 +10,7 @@ export class ConversationFlow extends APIResource {
      * ```ts
      * const conversationFlowResponse =
      *   await client.conversationFlow.create({
-     *     model_choice: { model: 'gpt-5', type: 'cascading' },
+     *     model_choice: { model: 'gpt-4.1', type: 'cascading' },
      *     nodes: [
      *       {
      *         id: 'start',

package/resources/llm.d.ts

@@ -125,7 +125,7 @@ export interface LlmResponse {
     /**
      * Select the underlying text LLM. If not set, would default to gpt-4.1.
      */
-    model?: 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'claude-3.7-sonnet' | 'claude-3.5-haiku' | 'gemini-2.0-flash' | 'gemini-2.0-flash-lite' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
+    model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
     /**
      * If set to true, will use high priority pool with more dedicated resource to
      * ensure lower and more consistent latency, default to false. This feature usually
@@ -194,7 +194,7 @@ export declare namespace LlmResponse {
          */
         name: string;
         transfer_destination: TransferCallTool.TransferDestinationPredefined | TransferCallTool.TransferDestinationInferred;
-        transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer;
+        transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer | TransferCallTool.TransferOptionAgenticWarmTransfer;
         type: 'transfer_call';
         /**
          * Custom SIP headers to be added to the call.
@@ -344,6 +344,88 @@ export declare namespace LlmResponse {
                 type?: 'static_message';
             }
         }
+        interface TransferOptionAgenticWarmTransfer {
+            /**
+             * Configuration for agentic warm transfer. Required for agentic warm transfer.
+             */
+            agentic_transfer_config: TransferOptionAgenticWarmTransfer.AgenticTransferConfig;
+            /**
+             * The type of the transfer.
+             */
+            type: 'agentic_warm_transfer';
+            /**
+             * Whether to play an audio cue when bridging the call. Defaults to true.
+             */
+            enable_bridge_audio_cue?: boolean;
+            /**
+             * The music to play while the caller is being transferred.
+             */
+            on_hold_music?: 'none' | 'relaxing_sound' | 'uplifting_beats' | 'ringtone';
+            /**
+             * If set, when transfer is successful, will say the handoff message to both the
+             * transferee and the agent receiving the transfer. Can leave either a static
+             * message or a dynamic one based on prompt. Set to null to disable warm handoff.
+             */
+            public_handoff_option?: TransferOptionAgenticWarmTransfer.WarmTransferPrompt | TransferOptionAgenticWarmTransfer.WarmTransferStaticMessage;
+            /**
+             * If set to true, will show transferee (the user, not the AI agent) as caller when
+             * transferring, requires the telephony side to support caller id override. Retell
+             * Twilio numbers support this option.
+             */
+            show_transferee_as_caller?: boolean;
+        }
+        namespace TransferOptionAgenticWarmTransfer {
+            /**
+             * Configuration for agentic warm transfer. Required for agentic warm transfer.
+             */
+            interface AgenticTransferConfig {
+                /**
+                 * The action to take when the transfer agent times out without making a decision.
+                 * Defaults to cancel_transfer.
+                 */
+                action_on_timeout?: 'bridge_transfer' | 'cancel_transfer';
+                /**
+                 * The agent that will mediate the transfer decision.
+                 */
+                transfer_agent?: AgenticTransferConfig.TransferAgent;
+                /**
+                 * The maximum time to wait for the transfer agent to make a decision, in
+                 * milliseconds. Defaults to 30000 (30 seconds).
+                 */
+                transfer_timeout_ms?: number;
+            }
+            namespace AgenticTransferConfig {
+                /**
+                 * The agent that will mediate the transfer decision.
+                 */
+                interface TransferAgent {
+                    /**
+                     * The agent ID of the transfer agent. This agent must have isTransferAgent set to
+                     * true and should use bridge_transfer and cancel_transfer tools (for Retell LLM)
+                     * or BridgeTransferNode and CancelTransferNode (for Conversation Flow).
+                     */
+                    agent_id: string;
+                    /**
+                     * The version of the transfer agent to use.
+                     */
+                    agent_version: number;
+                }
+            }
+            interface WarmTransferPrompt {
+                /**
+                 * The prompt to be used for warm handoff. Can contain dynamic variables.
+                 */
+                prompt?: string;
+                type?: 'prompt';
+            }
+            interface WarmTransferStaticMessage {
+                /**
+                 * The static message to be used for warm handoff. Can contain dynamic variables.
+                 */
+                message?: string;
+                type?: 'static_message';
+            }
+        }
     }
     interface CheckAvailabilityCalTool {
         /**
@@ -866,7 +948,7 @@ export declare namespace LlmResponse {
              */
             name: string;
             transfer_destination: TransferCallTool.TransferDestinationPredefined | TransferCallTool.TransferDestinationInferred;
-            transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer;
+            transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer | TransferCallTool.TransferOptionAgenticWarmTransfer;
             type: 'transfer_call';
             /**
              * Custom SIP headers to be added to the call.
@@ -1016,6 +1098,88 @@ export declare namespace LlmResponse {
                     type?: 'static_message';
                 }
             }
+            interface TransferOptionAgenticWarmTransfer {
+                /**
+                 * Configuration for agentic warm transfer. Required for agentic warm transfer.
+                 */
+                agentic_transfer_config: TransferOptionAgenticWarmTransfer.AgenticTransferConfig;
+                /**
+                 * The type of the transfer.
+                 */
+                type: 'agentic_warm_transfer';
+                /**
+                 * Whether to play an audio cue when bridging the call. Defaults to true.
+                 */
+                enable_bridge_audio_cue?: boolean;
+                /**
+                 * The music to play while the caller is being transferred.
+                 */
+                on_hold_music?: 'none' | 'relaxing_sound' | 'uplifting_beats' | 'ringtone';
+                /**
+                 * If set, when transfer is successful, will say the handoff message to both the
+                 * transferee and the agent receiving the transfer. Can leave either a static
+                 * message or a dynamic one based on prompt. Set to null to disable warm handoff.
+                 */
+                public_handoff_option?: TransferOptionAgenticWarmTransfer.WarmTransferPrompt | TransferOptionAgenticWarmTransfer.WarmTransferStaticMessage;
+                /**
+                 * If set to true, will show transferee (the user, not the AI agent) as caller when
+                 * transferring, requires the telephony side to support caller id override. Retell
+                 * Twilio numbers support this option.
+                 */
+                show_transferee_as_caller?: boolean;
+            }
+            namespace TransferOptionAgenticWarmTransfer {
+                /**
+                 * Configuration for agentic warm transfer. Required for agentic warm transfer.
+                 */
+                interface AgenticTransferConfig {
+                    /**
+                     * The action to take when the transfer agent times out without making a decision.
+                     * Defaults to cancel_transfer.
+                     */
+                    action_on_timeout?: 'bridge_transfer' | 'cancel_transfer';
+                    /**
+                     * The agent that will mediate the transfer decision.
+                     */
+                    transfer_agent?: AgenticTransferConfig.TransferAgent;
+                    /**
+                     * The maximum time to wait for the transfer agent to make a decision, in
+                     * milliseconds. Defaults to 30000 (30 seconds).
+                     */
+                    transfer_timeout_ms?: number;
+                }
+                namespace AgenticTransferConfig {
+                    /**
+                     * The agent that will mediate the transfer decision.
+                     */
+                    interface TransferAgent {
+                        /**
+                         * The agent ID of the transfer agent. This agent must have isTransferAgent set to
+                         * true and should use bridge_transfer and cancel_transfer tools (for Retell LLM)
+                         * or BridgeTransferNode and CancelTransferNode (for Conversation Flow).
+                         */
+                        agent_id: string;
+                        /**
+                         * The version of the transfer agent to use.
+                         */
+                        agent_version: number;
+                    }
+                }
+                interface WarmTransferPrompt {
+                    /**
+                     * The prompt to be used for warm handoff. Can contain dynamic variables.
+                     */
+                    prompt?: string;
+                    type?: 'prompt';
+                }
+                interface WarmTransferStaticMessage {
+                    /**
+                     * The static message to be used for warm handoff. Can contain dynamic variables.
+                     */
+                    message?: string;
+                    type?: 'static_message';
+                }
+            }
         }
         interface CheckAvailabilityCalTool {
             /**
@@ -1456,7 +1620,7 @@ export interface LlmCreateParams {
     /**
      * Select the underlying text LLM. If not set, would default to gpt-4.1.
      */
-    model?: 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'claude-3.7-sonnet' | 'claude-3.5-haiku' | 'gemini-2.0-flash' | 'gemini-2.0-flash-lite' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
+    model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
     /**
      * If set to true, will use high priority pool with more dedicated resource to
      * ensure lower and more consistent latency, default to false. This feature usually
@@ -1525,7 +1689,7 @@ export declare namespace LlmCreateParams {
          */
         name: string;
         transfer_destination: TransferCallTool.TransferDestinationPredefined | TransferCallTool.TransferDestinationInferred;
-        transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer;
+        transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer | TransferCallTool.TransferOptionAgenticWarmTransfer;
         type: 'transfer_call';
         /**
          * Custom SIP headers to be added to the call.
@@ -1675,6 +1839,88 @@ export declare namespace LlmCreateParams {
                 type?: 'static_message';
             }
         }
+        interface TransferOptionAgenticWarmTransfer {
+            /**
+             * Configuration for agentic warm transfer. Required for agentic warm transfer.
+             */
+            agentic_transfer_config: TransferOptionAgenticWarmTransfer.AgenticTransferConfig;
+            /**
+             * The type of the transfer.
+             */
+            type: 'agentic_warm_transfer';
+            /**
+             * Whether to play an audio cue when bridging the call. Defaults to true.
+             */
+            enable_bridge_audio_cue?: boolean;
+            /**
+             * The music to play while the caller is being transferred.
+             */
+            on_hold_music?: 'none' | 'relaxing_sound' | 'uplifting_beats' | 'ringtone';
+            /**
+             * If set, when transfer is successful, will say the handoff message to both the
+             * transferee and the agent receiving the transfer. Can leave either a static
+             * message or a dynamic one based on prompt. Set to null to disable warm handoff.
+             */
+            public_handoff_option?: TransferOptionAgenticWarmTransfer.WarmTransferPrompt | TransferOptionAgenticWarmTransfer.WarmTransferStaticMessage;
+            /**
+             * If set to true, will show transferee (the user, not the AI agent) as caller when
+             * transferring, requires the telephony side to support caller id override. Retell
+             * Twilio numbers support this option.
+             */
+            show_transferee_as_caller?: boolean;
+        }
+        namespace TransferOptionAgenticWarmTransfer {
+            /**
+             * Configuration for agentic warm transfer. Required for agentic warm transfer.
+             */
+            interface AgenticTransferConfig {
+                /**
+                 * The action to take when the transfer agent times out without making a decision.
+                 * Defaults to cancel_transfer.
+                 */
+                action_on_timeout?: 'bridge_transfer' | 'cancel_transfer';
+                /**
+                 * The agent that will mediate the transfer decision.
+                 */
+                transfer_agent?: AgenticTransferConfig.TransferAgent;
+                /**
+                 * The maximum time to wait for the transfer agent to make a decision, in
+                 * milliseconds. Defaults to 30000 (30 seconds).
+                 */
+                transfer_timeout_ms?: number;
+            }
+            namespace AgenticTransferConfig {
+                /**
+                 * The agent that will mediate the transfer decision.
+                 */
+                interface TransferAgent {
+                    /**
+                     * The agent ID of the transfer agent. This agent must have isTransferAgent set to
+                     * true and should use bridge_transfer and cancel_transfer tools (for Retell LLM)
+                     * or BridgeTransferNode and CancelTransferNode (for Conversation Flow).
+                     */
+                    agent_id: string;
+                    /**
+                     * The version of the transfer agent to use.
+                     */
+                    agent_version: number;
+                }
+            }
+            interface WarmTransferPrompt {
+                /**
+                 * The prompt to be used for warm handoff. Can contain dynamic variables.
+                 */
+                prompt?: string;
+                type?: 'prompt';
+            }
+            interface WarmTransferStaticMessage {
+                /**
+                 * The static message to be used for warm handoff. Can contain dynamic variables.
+                 */
+                message?: string;
+                type?: 'static_message';
+            }
+        }
     }
     interface CheckAvailabilityCalTool {
         /**
@@ -2197,7 +2443,7 @@ export declare namespace LlmCreateParams {
              */
             name: string;
             transfer_destination: TransferCallTool.TransferDestinationPredefined | TransferCallTool.TransferDestinationInferred;
-            transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer;
+            transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer | TransferCallTool.TransferOptionAgenticWarmTransfer;
             type: 'transfer_call';
             /**
              * Custom SIP headers to be added to the call.
@@ -2347,6 +2593,88 @@ export declare namespace LlmCreateParams {
                     type?: 'static_message';
                 }
             }
+            interface TransferOptionAgenticWarmTransfer {
+                /**
+                 * Configuration for agentic warm transfer. Required for agentic warm transfer.
+                 */
+                agentic_transfer_config: TransferOptionAgenticWarmTransfer.AgenticTransferConfig;
+                /**
+                 * The type of the transfer.
+                 */
+                type: 'agentic_warm_transfer';
+                /**
+                 * Whether to play an audio cue when bridging the call. Defaults to true.
+                 */
+                enable_bridge_audio_cue?: boolean;
+                /**
+                 * The music to play while the caller is being transferred.
+                 */
+                on_hold_music?: 'none' | 'relaxing_sound' | 'uplifting_beats' | 'ringtone';
+                /**
+                 * If set, when transfer is successful, will say the handoff message to both the
+                 * transferee and the agent receiving the transfer. Can leave either a static
+                 * message or a dynamic one based on prompt. Set to null to disable warm handoff.
+                 */
+                public_handoff_option?: TransferOptionAgenticWarmTransfer.WarmTransferPrompt | TransferOptionAgenticWarmTransfer.WarmTransferStaticMessage;
+                /**
+                 * If set to true, will show transferee (the user, not the AI agent) as caller when
+                 * transferring, requires the telephony side to support caller id override. Retell
+                 * Twilio numbers support this option.
+                 */
+                show_transferee_as_caller?: boolean;
+            }
+            namespace TransferOptionAgenticWarmTransfer {
+                /**
+                 * Configuration for agentic warm transfer. Required for agentic warm transfer.
+                 */
+                interface AgenticTransferConfig {
+                    /**
+                     * The action to take when the transfer agent times out without making a decision.
+                     * Defaults to cancel_transfer.
+                     */
+                    action_on_timeout?: 'bridge_transfer' | 'cancel_transfer';
+                    /**
+                     * The agent that will mediate the transfer decision.
+                     */
+                    transfer_agent?: AgenticTransferConfig.TransferAgent;
+                    /**
+                     * The maximum time to wait for the transfer agent to make a decision, in
+                     * milliseconds. Defaults to 30000 (30 seconds).
+                     */
+                    transfer_timeout_ms?: number;
+                }
+                namespace AgenticTransferConfig {
+                    /**
+                     * The agent that will mediate the transfer decision.
+                     */
+                    interface TransferAgent {
+                        /**
+                         * The agent ID of the transfer agent. This agent must have isTransferAgent set to
+                         * true and should use bridge_transfer and cancel_transfer tools (for Retell LLM)
+                         * or BridgeTransferNode and CancelTransferNode (for Conversation Flow).
+                         */
+                        agent_id: string;
+                        /**
+                         * The version of the transfer agent to use.
+                         */
+                        agent_version: number;
+                    }
+                }
+                interface WarmTransferPrompt {
+                    /**
+                     * The prompt to be used for warm handoff. Can contain dynamic variables.
+                     */
+                    prompt?: string;
+                    type?: 'prompt';
+                }
+                interface WarmTransferStaticMessage {
+                    /**
+                     * The static message to be used for warm handoff. Can contain dynamic variables.
+                     */
+                    message?: string;
+                    type?: 'static_message';
+                }
+            }
         }
         interface CheckAvailabilityCalTool {
             /**
@@ -2801,7 +3129,7 @@ export interface LlmUpdateParams {
      * Body param: Select the underlying text LLM. If not set, would default to
      * gpt-4.1.
      */
-    model?: 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'claude-3.7-sonnet' | 'claude-3.5-haiku' | 'gemini-2.0-flash' | 'gemini-2.0-flash-lite' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
+    model?: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'claude-4.5-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | null;
     /**
      * Body param: If set to true, will use high priority pool with more dedicated
      * resource to ensure lower and more consistent latency, default to false. This
@@ -2870,7 +3198,7 @@ export declare namespace LlmUpdateParams {
          */
         name: string;
         transfer_destination: TransferCallTool.TransferDestinationPredefined | TransferCallTool.TransferDestinationInferred;
-        transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer;
+        transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer | TransferCallTool.TransferOptionAgenticWarmTransfer;
         type: 'transfer_call';
         /**
          * Custom SIP headers to be added to the call.
@@ -3020,6 +3348,88 @@ export declare namespace LlmUpdateParams {
                 type?: 'static_message';
             }
         }
+        interface TransferOptionAgenticWarmTransfer {
+            /**
+             * Configuration for agentic warm transfer. Required for agentic warm transfer.
+             */
+            agentic_transfer_config: TransferOptionAgenticWarmTransfer.AgenticTransferConfig;
+            /**
+             * The type of the transfer.
+             */
+            type: 'agentic_warm_transfer';
+            /**
+             * Whether to play an audio cue when bridging the call. Defaults to true.
+             */
+            enable_bridge_audio_cue?: boolean;
+            /**
+             * The music to play while the caller is being transferred.
+             */
+            on_hold_music?: 'none' | 'relaxing_sound' | 'uplifting_beats' | 'ringtone';
+            /**
+             * If set, when transfer is successful, will say the handoff message to both the
+             * transferee and the agent receiving the transfer. Can leave either a static
+             * message or a dynamic one based on prompt. Set to null to disable warm handoff.
+             */
+            public_handoff_option?: TransferOptionAgenticWarmTransfer.WarmTransferPrompt | TransferOptionAgenticWarmTransfer.WarmTransferStaticMessage;
+            /**
+             * If set to true, will show transferee (the user, not the AI agent) as caller when
+             * transferring, requires the telephony side to support caller id override. Retell
+             * Twilio numbers support this option.
+             */
+            show_transferee_as_caller?: boolean;
+        }
+        namespace TransferOptionAgenticWarmTransfer {
+            /**
+             * Configuration for agentic warm transfer. Required for agentic warm transfer.
+             */
+            interface AgenticTransferConfig {
+                /**
+                 * The action to take when the transfer agent times out without making a decision.
+                 * Defaults to cancel_transfer.
+                 */
+                action_on_timeout?: 'bridge_transfer' | 'cancel_transfer';
+                /**
+                 * The agent that will mediate the transfer decision.
+                 */
+                transfer_agent?: AgenticTransferConfig.TransferAgent;
+                /**
+                 * The maximum time to wait for the transfer agent to make a decision, in
+                 * milliseconds. Defaults to 30000 (30 seconds).
+                 */
+                transfer_timeout_ms?: number;
+            }
+            namespace AgenticTransferConfig {
+                /**
+                 * The agent that will mediate the transfer decision.
+                 */
+                interface TransferAgent {
+                    /**
+                     * The agent ID of the transfer agent. This agent must have isTransferAgent set to
+                     * true and should use bridge_transfer and cancel_transfer tools (for Retell LLM)
+                     * or BridgeTransferNode and CancelTransferNode (for Conversation Flow).
+                     */
+                    agent_id: string;
+                    /**
+                     * The version of the transfer agent to use.
+                     */
+                    agent_version: number;
+                }
+            }
+            interface WarmTransferPrompt {
+                /**
+                 * The prompt to be used for warm handoff. Can contain dynamic variables.
+                 */
+                prompt?: string;
+                type?: 'prompt';
+            }
+            interface WarmTransferStaticMessage {
+                /**
+                 * The static message to be used for warm handoff. Can contain dynamic variables.
+                 */
+                message?: string;
+                type?: 'static_message';
+            }
+        }
     }
     interface CheckAvailabilityCalTool {
         /**
@@ -3542,7 +3952,7 @@ export declare namespace LlmUpdateParams {
              */
             name: string;
             transfer_destination: TransferCallTool.TransferDestinationPredefined | TransferCallTool.TransferDestinationInferred;
-            transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer;
+            transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer | TransferCallTool.TransferOptionAgenticWarmTransfer;
             type: 'transfer_call';
             /**
              * Custom SIP headers to be added to the call.
@@ -3692,6 +4102,88 @@ export declare namespace LlmUpdateParams {
                     type?: 'static_message';
                 }
             }
+            interface TransferOptionAgenticWarmTransfer {
+                /**
+                 * Configuration for agentic warm transfer. Required for agentic warm transfer.
+                 */
+                agentic_transfer_config: TransferOptionAgenticWarmTransfer.AgenticTransferConfig;
+                /**
+                 * The type of the transfer.
+                 */
+                type: 'agentic_warm_transfer';
+                /**
+                 * Whether to play an audio cue when bridging the call. Defaults to true.
+                 */
+                enable_bridge_audio_cue?: boolean;
+                /**
+                 * The music to play while the caller is being transferred.
+                 */
+                on_hold_music?: 'none' | 'relaxing_sound' | 'uplifting_beats' | 'ringtone';
+                /**
+                 * If set, when transfer is successful, will say the handoff message to both the
+                 * transferee and the agent receiving the transfer. Can leave either a static
+                 * message or a dynamic one based on prompt. Set to null to disable warm handoff.
+                 */
+                public_handoff_option?: TransferOptionAgenticWarmTransfer.WarmTransferPrompt | TransferOptionAgenticWarmTransfer.WarmTransferStaticMessage;
+                /**
+                 * If set to true, will show transferee (the user, not the AI agent) as caller when
+                 * transferring, requires the telephony side to support caller id override. Retell
+                 * Twilio numbers support this option.
+                 */
+                show_transferee_as_caller?: boolean;
+            }
+            namespace TransferOptionAgenticWarmTransfer {
+                /**
+                 * Configuration for agentic warm transfer. Required for agentic warm transfer.
+                 */
+                interface AgenticTransferConfig {
+                    /**
+                     * The action to take when the transfer agent times out without making a decision.
+                     * Defaults to cancel_transfer.
+                     */
+                    action_on_timeout?: 'bridge_transfer' | 'cancel_transfer';
+                    /**
+                     * The agent that will mediate the transfer decision.
+                     */
+                    transfer_agent?: AgenticTransferConfig.TransferAgent;
+                    /**
+                     * The maximum time to wait for the transfer agent to make a decision, in
+                     * milliseconds. Defaults to 30000 (30 seconds).
+                     */
+                    transfer_timeout_ms?: number;
+                }
+                namespace AgenticTransferConfig {
+                    /**
+                     * The agent that will mediate the transfer decision.
+                     */
+                    interface TransferAgent {
+                        /**
+                         * The agent ID of the transfer agent. This agent must have isTransferAgent set to
+                         * true and should use bridge_transfer and cancel_transfer tools (for Retell LLM)
+                         * or BridgeTransferNode and CancelTransferNode (for Conversation Flow).
+                         */
+                        agent_id: string;
+                        /**
+                         * The version of the transfer agent to use.
+                         */
+                        agent_version: number;
+                    }
+                }
+                interface WarmTransferPrompt {
+                    /**
+                     * The prompt to be used for warm handoff. Can contain dynamic variables.
+                     */
+                    prompt?: string;
+                    type?: 'prompt';
+                }
+                interface WarmTransferStaticMessage {
+                    /**
+                     * The static message to be used for warm handoff. Can contain dynamic variables.
+                     */
+                    message?: string;
+                    type?: 'static_message';
+                }
+            }
         }
         interface CheckAvailabilityCalTool {
             /**