retell-sdk 4.61.0 → 4.62.0

package/resources/conversation-flow.d.ts

@@ -9,7 +9,7 @@ export declare 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',
@@ -407,7 +407,7 @@ export declare namespace ConversationFlowResponse {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -762,7 +762,7 @@ export declare namespace ConversationFlowResponse {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -780,7 +780,7 @@ export declare namespace ConversationFlowResponse {
             id: string;
             edge: TransferCallNode.Edge;
             transfer_destination: TransferCallNode.TransferDestinationPredefined | TransferCallNode.TransferDestinationInferred;
-            transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer;
+            transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer | TransferCallNode.TransferOptionAgenticWarmTransfer;
             /**
              * Type of the node
              */
@@ -988,6 +988,88 @@ export declare namespace ConversationFlowResponse {
                     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';
+                }
+            }
             /**
              * Position for frontend display
              */
@@ -1061,7 +1143,7 @@ export declare namespace ConversationFlowResponse {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -1253,7 +1335,7 @@ export declare namespace ConversationFlowResponse {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -1921,7 +2003,7 @@ export declare namespace ConversationFlowResponse {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -2707,7 +2789,7 @@ export declare namespace ConversationFlowResponse {
         /**
          * The LLM model to use
          */
-        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';
+        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';
         /**
          * Type of model choice
          */
@@ -2938,7 +3020,7 @@ export declare namespace ConversationFlowResponse {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -3293,7 +3375,7 @@ export declare namespace ConversationFlowResponse {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -3311,7 +3393,7 @@ export declare namespace ConversationFlowResponse {
         id: string;
         edge: TransferCallNode.Edge;
         transfer_destination: TransferCallNode.TransferDestinationPredefined | TransferCallNode.TransferDestinationInferred;
-        transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer;
+        transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer | TransferCallNode.TransferOptionAgenticWarmTransfer;
         /**
          * Type of the node
          */
@@ -3519,6 +3601,88 @@ export declare namespace ConversationFlowResponse {
                 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';
+            }
+        }
         /**
          * Position for frontend display
          */
@@ -3592,7 +3756,7 @@ export declare namespace ConversationFlowResponse {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -3784,7 +3948,7 @@ export declare namespace ConversationFlowResponse {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -4452,7 +4616,7 @@ export declare namespace ConversationFlowResponse {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -5270,7 +5434,7 @@ export declare namespace ConversationFlowCreateParams {
         /**
          * The LLM model to use
          */
-        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';
+        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';
         /**
          * Type of model choice
          */
@@ -5501,7 +5665,7 @@ export declare namespace ConversationFlowCreateParams {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -5856,7 +6020,7 @@ export declare namespace ConversationFlowCreateParams {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -5874,7 +6038,7 @@ export declare namespace ConversationFlowCreateParams {
         id: string;
         edge: TransferCallNode.Edge;
         transfer_destination: TransferCallNode.TransferDestinationPredefined | TransferCallNode.TransferDestinationInferred;
-        transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer;
+        transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer | TransferCallNode.TransferOptionAgenticWarmTransfer;
         /**
          * Type of the node
          */
@@ -6082,6 +6246,88 @@ export declare namespace ConversationFlowCreateParams {
                 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';
+            }
+        }
         /**
          * Position for frontend display
          */
@@ -6155,7 +6401,7 @@ export declare namespace ConversationFlowCreateParams {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -6347,7 +6593,7 @@ export declare namespace ConversationFlowCreateParams {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -7015,7 +7261,7 @@ export declare namespace ConversationFlowCreateParams {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -7852,7 +8098,7 @@ export declare namespace ConversationFlowCreateParams {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -8207,7 +8453,7 @@ export declare namespace ConversationFlowCreateParams {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -8225,7 +8471,7 @@ export declare namespace ConversationFlowCreateParams {
             id: string;
             edge: TransferCallNode.Edge;
             transfer_destination: TransferCallNode.TransferDestinationPredefined | TransferCallNode.TransferDestinationInferred;
-            transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer;
+            transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer | TransferCallNode.TransferOptionAgenticWarmTransfer;
             /**
              * Type of the node
              */
@@ -8433,6 +8679,88 @@ export declare namespace ConversationFlowCreateParams {
                     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';
+                }
+            }
             /**
              * Position for frontend display
              */
@@ -8506,7 +8834,7 @@ export declare namespace ConversationFlowCreateParams {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -8698,7 +9026,7 @@ export declare namespace ConversationFlowCreateParams {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -9366,7 +9694,7 @@ export declare namespace ConversationFlowCreateParams {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -10628,7 +10956,7 @@ export declare namespace ConversationFlowUpdateParams {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -10983,7 +11311,7 @@ export declare namespace ConversationFlowUpdateParams {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -11001,7 +11329,7 @@ export declare namespace ConversationFlowUpdateParams {
             id: string;
             edge: TransferCallNode.Edge;
             transfer_destination: TransferCallNode.TransferDestinationPredefined | TransferCallNode.TransferDestinationInferred;
-            transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer;
+            transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer | TransferCallNode.TransferOptionAgenticWarmTransfer;
             /**
              * Type of the node
              */
@@ -11209,6 +11537,88 @@ export declare namespace ConversationFlowUpdateParams {
                     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';
+                }
+            }
             /**
              * Position for frontend display
              */
@@ -11282,7 +11692,7 @@ export declare namespace ConversationFlowUpdateParams {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -11474,7 +11884,7 @@ export declare namespace ConversationFlowUpdateParams {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -12142,7 +12552,7 @@ export declare namespace ConversationFlowUpdateParams {
                 /**
                  * The LLM model to use
                  */
-                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';
+                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';
                 /**
                  * Type of model choice
                  */
@@ -12928,7 +13338,7 @@ export declare namespace ConversationFlowUpdateParams {
         /**
          * The LLM model to use
          */
-        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';
+        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';
         /**
          * Type of model choice
          */
@@ -13159,7 +13569,7 @@ export declare namespace ConversationFlowUpdateParams {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -13514,7 +13924,7 @@ export declare namespace ConversationFlowUpdateParams {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -13532,7 +13942,7 @@ export declare namespace ConversationFlowUpdateParams {
         id: string;
         edge: TransferCallNode.Edge;
         transfer_destination: TransferCallNode.TransferDestinationPredefined | TransferCallNode.TransferDestinationInferred;
-        transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer;
+        transfer_option: TransferCallNode.TransferOptionColdTransfer | TransferCallNode.TransferOptionWarmTransfer | TransferCallNode.TransferOptionAgenticWarmTransfer;
         /**
          * Type of the node
          */
@@ -13740,6 +14150,88 @@ export declare namespace ConversationFlowUpdateParams {
                 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';
+            }
+        }
         /**
          * Position for frontend display
          */
@@ -13813,7 +14305,7 @@ export declare namespace ConversationFlowUpdateParams {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -14005,7 +14497,7 @@ export declare namespace ConversationFlowUpdateParams {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */
@@ -14673,7 +15165,7 @@ export declare namespace ConversationFlowUpdateParams {
             /**
              * The LLM model to use
              */
-            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';
+            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';
             /**
              * Type of model choice
              */