retell-sdk 5.10.3 → 5.12.0

package/resources/conversation-flow-component.d.ts

@@ -83,7 +83,7 @@ export interface ConversationFlowComponentResponse {
     /**
      * Nodes that make up the component
      */
-    nodes: Array<ConversationFlowComponentResponse.ConversationNode | ConversationFlowComponentResponse.EndNode | ConversationFlowComponentResponse.FunctionNode | ConversationFlowComponentResponse.CodeNode | ConversationFlowComponentResponse.TransferCallNode | ConversationFlowComponentResponse.PressDigitNode | ConversationFlowComponentResponse.BranchNode | ConversationFlowComponentResponse.SMSNode | ConversationFlowComponentResponse.ExtractDynamicVariablesNode | ConversationFlowComponentResponse.AgentSwapNode | ConversationFlowComponentResponse.McpNode | ConversationFlowComponentResponse.ComponentNode | ConversationFlowComponentResponse.BridgeTransferNode | ConversationFlowComponentResponse.CancelTransferNode>;
+    nodes: Array<ConversationFlowComponentResponse.ConversationNode | ConversationFlowComponentResponse.SubagentNode | ConversationFlowComponentResponse.EndNode | ConversationFlowComponentResponse.FunctionNode | ConversationFlowComponentResponse.CodeNode | ConversationFlowComponentResponse.TransferCallNode | ConversationFlowComponentResponse.PressDigitNode | ConversationFlowComponentResponse.BranchNode | ConversationFlowComponentResponse.SMSNode | ConversationFlowComponentResponse.ExtractDynamicVariablesNode | ConversationFlowComponentResponse.AgentSwapNode | ConversationFlowComponentResponse.McpNode | ConversationFlowComponentResponse.ComponentNode | ConversationFlowComponentResponse.BridgeTransferNode | ConversationFlowComponentResponse.CancelTransferNode>;
     /**
      * Timestamp of last user modification
      */
@@ -100,6 +100,10 @@ export interface ConversationFlowComponentResponse {
      * A list of MCP server configurations to use for this component
      */
     mcps?: Array<ConversationFlowComponentResponse.Mcp> | null;
+    /**
+     * Visual annotations displayed on the flow canvas.
+     */
+    notes?: Array<ConversationFlowComponentResponse.Note> | null;
     /**
      * ID of the starting node
      */
@@ -141,16 +145,6 @@ export declare namespace ConversationFlowComponentResponse {
         name?: string;
         responsiveness?: number | null;
         skip_response_edge?: ConversationNode.SkipResponseEdge;
-        /**
-         * The tool ids of the tools defined in main conversation flow or component that
-         * can be used in this conversation node.
-         */
-        tool_ids?: Array<string> | null;
-        /**
-         * The tools owned by this conversation node. This includes other tool types like
-         * transfer_call, agent_swap, etc.
-         */
-        tools?: Array<ConversationNode.EndCallTool | ConversationNode.TransferCallTool | ConversationNode.CheckAvailabilityCalTool | ConversationNode.BookAppointmentCalTool | ConversationNode.AgentSwapTool | ConversationNode.PressDigitTool | ConversationNode.SendSMSTool | ConversationNode.CustomTool | ConversationNode.CodeTool | ConversationNode.ExtractDynamicVariableTool | ConversationNode.BridgeTransferTool | ConversationNode.CancelTransferTool | ConversationNode.McpTool> | null;
         voice_speed?: number | null;
     }
     namespace ConversationNode {
@@ -503,86 +497,470 @@ export declare namespace ConversationFlowComponentResponse {
                 type: 'prompt';
             }
         }
-        interface EndCallTool {
+    }
+    interface SubagentNode {
+        /**
+         * Unique identifier for the node
+         */
+        id: string;
+        instruction: SubagentNode.Instruction;
+        /**
+         * Type of the node
+         */
+        type: 'subagent';
+        always_edge?: SubagentNode.AlwaysEdge;
+        /**
+         * Position for frontend display
+         */
+        display_position?: SubagentNode.DisplayPosition;
+        edges?: Array<SubagentNode.Edge>;
+        finetune_conversation_examples?: Array<SubagentNode.FinetuneConversationExample>;
+        finetune_transition_examples?: Array<SubagentNode.FinetuneTransitionExample>;
+        global_node_setting?: SubagentNode.GlobalNodeSetting;
+        interruption_sensitivity?: number | null;
+        /**
+         * Knowledge base IDs for RAG (Retrieval-Augmented Generation).
+         */
+        knowledge_base_ids?: Array<string> | null;
+        model_choice?: SubagentNode.ModelChoice;
+        /**
+         * Optional name for display purposes
+         */
+        name?: string;
+        responsiveness?: number | null;
+        skip_response_edge?: SubagentNode.SkipResponseEdge;
+        /**
+         * The tool ids of the tools defined in main conversation flow or component that
+         * can be used in this subagent node.
+         */
+        tool_ids?: Array<string> | null;
+        /**
+         * The tools owned by this subagent node. This includes other tool types like
+         * transfer_call, agent_swap, etc.
+         */
+        tools?: Array<SubagentNode.EndCallTool | SubagentNode.TransferCallTool | SubagentNode.CheckAvailabilityCalTool | SubagentNode.BookAppointmentCalTool | SubagentNode.AgentSwapTool | SubagentNode.PressDigitTool | SubagentNode.SendSMSTool | SubagentNode.CustomTool | SubagentNode.CodeTool | SubagentNode.ExtractDynamicVariableTool | SubagentNode.BridgeTransferTool | SubagentNode.CancelTransferTool | SubagentNode.McpTool> | null;
+        voice_speed?: number | null;
+    }
+    namespace SubagentNode {
+        interface Instruction {
             /**
-             * Name of the tool. Must be unique within all tools available to LLM at any given
-             * time (general tools + state tools + state transitions). Must be consisted of
-             * a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64
-             * (no space allowed).
+             * The prompt text for the instruction
              */
-            name: string;
-            type: 'end_call';
+            text: string;
             /**
-             * Describes what the tool does, sometimes can also include information about when
-             * to call the tool.
+             * Type of instruction
              */
-            description?: string;
+            type: 'prompt';
+        }
+        interface AlwaysEdge {
             /**
-             * Describes what to say to user when ending the call. Only applicable when
-             * speak_during_execution is true.
+             * Unique identifier for the edge
              */
-            execution_message_description?: string;
+            id: string;
+            transition_condition: AlwaysEdge.PromptCondition | AlwaysEdge.EquationCondition | AlwaysEdge.UnionMember2;
             /**
-             * Type of execution message. "prompt" means the agent will use
-             * execution_message_description as a prompt to generate the message. "static_text"
-             * means the agent will speak the execution_message_description directly. Defaults
-             * to "prompt".
+             * ID of the destination node
              */
-            execution_message_type?: 'prompt' | 'static_text';
+            destination_node_id?: string;
+        }
+        namespace AlwaysEdge {
+            interface PromptCondition {
+                /**
+                 * Prompt condition text
+                 */
+                prompt: string;
+                type: 'prompt';
+            }
+            interface EquationCondition {
+                equations: Array<EquationCondition.Equation>;
+                operator: '||' | '&&';
+                type: 'equation';
+                /**
+                 * Must be "Always" for always edge
+                 */
+                prompt?: 'Always';
+            }
+            namespace EquationCondition {
+                interface Equation {
+                    /**
+                     * Left side of the equation
+                     */
+                    left: string;
+                    operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                    /**
+                     * Right side of the equation. The right side of the equation not required when
+                     * "exists" or "not_exist" are selected.
+                     */
+                    right?: string;
+                }
+            }
+            interface UnionMember2 {
+                /**
+                 * Must be "Always" for always edge
+                 */
+                prompt: 'Always';
+                type: 'prompt';
+            }
+        }
+        /**
+         * Position for frontend display
+         */
+        interface DisplayPosition {
+            x?: number;
+            y?: number;
+        }
+        interface Edge {
             /**
-             * If true, will speak during execution.
+             * Unique identifier for the edge
              */
-            speak_during_execution?: boolean;
+            id: string;
+            transition_condition: Edge.PromptCondition | Edge.EquationCondition;
+            /**
+             * ID of the destination node
+             */
+            destination_node_id?: string;
         }
-        interface TransferCallTool {
+        namespace Edge {
+            interface PromptCondition {
+                /**
+                 * Prompt condition text
+                 */
+                prompt: string;
+                type: 'prompt';
+            }
+            interface EquationCondition {
+                equations: Array<EquationCondition.Equation>;
+                operator: '||' | '&&';
+                type: 'equation';
+            }
+            namespace EquationCondition {
+                interface Equation {
+                    /**
+                     * Left side of the equation
+                     */
+                    left: string;
+                    operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                    /**
+                     * Right side of the equation. The right side of the equation not required when
+                     * "exists" or "not_exist" are selected.
+                     */
+                    right?: string;
+                }
+            }
+        }
+        interface FinetuneConversationExample {
             /**
-             * Name of the tool. Must be unique within all tools available to LLM at any given
-             * time (general tools + state tools + state edges).
+             * Unique identifier for the example
              */
-            name: string;
-            transfer_destination: TransferCallTool.TransferDestinationPredefined | TransferCallTool.TransferDestinationInferred;
-            transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer | TransferCallTool.TransferOptionAgenticWarmTransfer;
-            type: 'transfer_call';
+            id: string;
             /**
-             * Custom SIP headers to be added to the call.
+             * The example transcript to finetune how the conversation should be.
              */
-            custom_sip_headers?: {
-                [key: string]: string;
-            };
+            transcript: Array<FinetuneConversationExample.UnionMember0 | FinetuneConversationExample.UnionMember1 | FinetuneConversationExample.UnionMember2>;
+        }
+        namespace FinetuneConversationExample {
+            interface UnionMember0 {
+                content: string;
+                role: 'agent' | 'user';
+            }
+            interface UnionMember1 {
+                arguments: string;
+                name: string;
+                role: 'tool_call_invocation';
+                tool_call_id: string;
+            }
+            interface UnionMember2 {
+                content: string;
+                role: 'tool_call_result';
+                tool_call_id: string;
+            }
+        }
+        interface FinetuneTransitionExample {
             /**
-             * Describes what the tool does, sometimes can also include information about when
-             * to call the tool.
+             * Unique identifier for the example
              */
-            description?: string;
+            id: string;
             /**
-             * Describes what to say to user when transferring the call. Only applicable when
-             * speak_during_execution is true.
+             * The example transcript to finetune how the node should transition.
              */
-            execution_message_description?: string;
+            transcript: Array<FinetuneTransitionExample.UnionMember0 | FinetuneTransitionExample.UnionMember1 | FinetuneTransitionExample.UnionMember2>;
             /**
-             * Type of execution message. "prompt" means the agent will use
-             * execution_message_description as a prompt to generate the message. "static_text"
-             * means the agent will speak the execution_message_description directly. Defaults
-             * to "prompt".
+             * Optional destination node ID
              */
-            execution_message_type?: 'prompt' | 'static_text';
+            destination_node_id?: string;
+        }
+        namespace FinetuneTransitionExample {
+            interface UnionMember0 {
+                content: string;
+                role: 'agent' | 'user';
+            }
+            interface UnionMember1 {
+                arguments: string;
+                name: string;
+                role: 'tool_call_invocation';
+                tool_call_id: string;
+            }
+            interface UnionMember2 {
+                content: string;
+                role: 'tool_call_result';
+                tool_call_id: string;
+            }
+        }
+        interface GlobalNodeSetting {
             /**
-             * If true, the e.164 validation will be ignored for the from_number. This can be
-             * useful when you want to dial to internal pseudo numbers. This only applies when
-             * you are using custom telephony and does not apply when you are using Retell
-             * Telephony. If omitted, the default value is false.
+             * Condition for global node activation, cannot be empty
              */
-            ignore_e164_validation?: boolean;
+            condition: string;
             /**
-             * If true, will speak during execution.
+             * The same global node won't be triggered again within the next N node
+             * transitions.
              */
-            speak_during_execution?: boolean;
+            cool_down?: number;
+            /**
+             * The conditions for global node go back. There would be no destination_node_id
+             * for these edges.
+             */
+            go_back_conditions?: Array<GlobalNodeSetting.GoBackCondition>;
+            /**
+             * Don't transition to this node
+             */
+            negative_finetune_examples?: Array<GlobalNodeSetting.NegativeFinetuneExample>;
+            /**
+             * Transition to this node
+             */
+            positive_finetune_examples?: Array<GlobalNodeSetting.PositiveFinetuneExample>;
         }
-        namespace TransferCallTool {
-            interface TransferDestinationPredefined {
+        namespace GlobalNodeSetting {
+            interface GoBackCondition {
                 /**
-                 * The number to transfer to in E.164 format or a dynamic variable like
-                 * {{transfer_number}}.
+                 * Unique identifier for the edge
+                 */
+                id: string;
+                transition_condition: GoBackCondition.PromptCondition | GoBackCondition.EquationCondition;
+                /**
+                 * ID of the destination node
+                 */
+                destination_node_id?: string;
+            }
+            namespace GoBackCondition {
+                interface PromptCondition {
+                    /**
+                     * Prompt condition text
+                     */
+                    prompt: string;
+                    type: 'prompt';
+                }
+                interface EquationCondition {
+                    equations: Array<EquationCondition.Equation>;
+                    operator: '||' | '&&';
+                    type: 'equation';
+                }
+                namespace EquationCondition {
+                    interface Equation {
+                        /**
+                         * Left side of the equation
+                         */
+                        left: string;
+                        operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                        /**
+                         * Right side of the equation. The right side of the equation not required when
+                         * "exists" or "not_exist" are selected.
+                         */
+                        right?: string;
+                    }
+                }
+            }
+            interface NegativeFinetuneExample {
+                /**
+                 * Find tune the transition condition to this global node
+                 */
+                transcript: Array<NegativeFinetuneExample.UnionMember0 | NegativeFinetuneExample.UnionMember1 | NegativeFinetuneExample.UnionMember2>;
+            }
+            namespace NegativeFinetuneExample {
+                interface UnionMember0 {
+                    content: string;
+                    role: 'agent' | 'user';
+                }
+                interface UnionMember1 {
+                    arguments: string;
+                    name: string;
+                    role: 'tool_call_invocation';
+                    tool_call_id: string;
+                }
+                interface UnionMember2 {
+                    content: string;
+                    role: 'tool_call_result';
+                    tool_call_id: string;
+                }
+            }
+            interface PositiveFinetuneExample {
+                /**
+                 * Find tune the transition condition to this global node
+                 */
+                transcript: Array<PositiveFinetuneExample.UnionMember0 | PositiveFinetuneExample.UnionMember1 | PositiveFinetuneExample.UnionMember2>;
+            }
+            namespace PositiveFinetuneExample {
+                interface UnionMember0 {
+                    content: string;
+                    role: 'agent' | 'user';
+                }
+                interface UnionMember1 {
+                    arguments: string;
+                    name: string;
+                    role: 'tool_call_invocation';
+                    tool_call_id: string;
+                }
+                interface UnionMember2 {
+                    content: string;
+                    role: 'tool_call_result';
+                    tool_call_id: string;
+                }
+            }
+        }
+        interface ModelChoice {
+            /**
+             * The LLM model to use
+             */
+            model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash';
+            /**
+             * Type of model choice
+             */
+            type: 'cascading';
+            /**
+             * Whether to use high priority pool with more dedicated resource, default false
+             */
+            high_priority?: boolean;
+        }
+        interface SkipResponseEdge {
+            /**
+             * Unique identifier for the edge
+             */
+            id: string;
+            transition_condition: SkipResponseEdge.PromptCondition | SkipResponseEdge.EquationCondition | SkipResponseEdge.UnionMember2;
+            /**
+             * ID of the destination node
+             */
+            destination_node_id?: string;
+        }
+        namespace SkipResponseEdge {
+            interface PromptCondition {
+                /**
+                 * Prompt condition text
+                 */
+                prompt: string;
+                type: 'prompt';
+            }
+            interface EquationCondition {
+                equations: Array<EquationCondition.Equation>;
+                operator: '||' | '&&';
+                type: 'equation';
+                /**
+                 * Must be "Skip response" for skip response edge
+                 */
+                prompt?: 'Skip response';
+            }
+            namespace EquationCondition {
+                interface Equation {
+                    /**
+                     * Left side of the equation
+                     */
+                    left: string;
+                    operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                    /**
+                     * Right side of the equation. The right side of the equation not required when
+                     * "exists" or "not_exist" are selected.
+                     */
+                    right?: string;
+                }
+            }
+            interface UnionMember2 {
+                /**
+                 * Must be "Skip response" for skip response edge
+                 */
+                prompt: 'Skip response';
+                type: 'prompt';
+            }
+        }
+        interface EndCallTool {
+            /**
+             * Name of the tool. Must be unique within all tools available to LLM at any given
+             * time (general tools + state tools + state transitions). Must be consisted of
+             * a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64
+             * (no space allowed).
+             */
+            name: string;
+            type: 'end_call';
+            /**
+             * Describes what the tool does, sometimes can also include information about when
+             * to call the tool.
+             */
+            description?: string;
+            /**
+             * Describes what to say to user when ending the call. Only applicable when
+             * speak_during_execution is true.
+             */
+            execution_message_description?: string;
+            /**
+             * Type of execution message. "prompt" means the agent will use
+             * execution_message_description as a prompt to generate the message. "static_text"
+             * means the agent will speak the execution_message_description directly. Defaults
+             * to "prompt".
+             */
+            execution_message_type?: 'prompt' | 'static_text';
+            /**
+             * If true, will speak during execution.
+             */
+            speak_during_execution?: boolean;
+        }
+        interface TransferCallTool {
+            /**
+             * Name of the tool. Must be unique within all tools available to LLM at any given
+             * time (general tools + state tools + state edges).
+             */
+            name: string;
+            transfer_destination: TransferCallTool.TransferDestinationPredefined | TransferCallTool.TransferDestinationInferred;
+            transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer | TransferCallTool.TransferOptionAgenticWarmTransfer;
+            type: 'transfer_call';
+            /**
+             * Custom SIP headers to be added to the call.
+             */
+            custom_sip_headers?: {
+                [key: string]: string;
+            };
+            /**
+             * Describes what the tool does, sometimes can also include information about when
+             * to call the tool.
+             */
+            description?: string;
+            /**
+             * Describes what to say to user when transferring the call. Only applicable when
+             * speak_during_execution is true.
+             */
+            execution_message_description?: string;
+            /**
+             * Type of execution message. "prompt" means the agent will use
+             * execution_message_description as a prompt to generate the message. "static_text"
+             * means the agent will speak the execution_message_description directly. Defaults
+             * to "prompt".
+             */
+            execution_message_type?: 'prompt' | 'static_text';
+            /**
+             * If true, the e.164 validation will be ignored for the from_number. This can be
+             * useful when you want to dial to internal pseudo numbers. This only applies when
+             * you are using custom telephony and does not apply when you are using Retell
+             * Telephony. If omitted, the default value is false.
+             */
+            ignore_e164_validation?: boolean;
+            /**
+             * If true, will speak during execution.
+             */
+            speak_during_execution?: boolean;
+        }
+        namespace TransferCallTool {
+            interface TransferDestinationPredefined {
+                /**
+                 * The number to transfer to in E.164 format or a dynamic variable like
+                 * {{transfer_number}}.
                  */
                 number: string;
                 /**
@@ -965,6 +1343,23 @@ export declare namespace ConversationFlowComponentResponse {
              * to call the tool.
              */
             description?: string;
+            /**
+             * Describes what to say before sending the SMS. Only applicable when
+             * speak_during_execution is true.
+             */
+            execution_message_description?: string;
+            /**
+             * Type of execution message. "prompt" means the agent will use
+             * execution_message_description as a prompt to generate the message. "static_text"
+             * means the agent will speak the execution_message_description directly. Defaults
+             * to "prompt".
+             */
+            execution_message_type?: 'prompt' | 'static_text';
+            /**
+             * If true, the agent will speak a short line before sending the SMS. If omitted,
+             * defaults to true (same as end_call / transfer_call tools).
+             */
+            speak_during_execution?: boolean;
         }
         namespace SendSMSTool {
             interface SMSContentPredefined {
@@ -1185,6 +1580,12 @@ export declare namespace ConversationFlowComponentResponse {
                  * Type of the variable to extract.
                  */
                 type: 'string';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Examples of the variable value to teach model the style and syntax.
                  */
@@ -1212,6 +1613,12 @@ export declare namespace ConversationFlowComponentResponse {
                  * Type of the variable to extract.
                  */
                 type: 'enum';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Whether this data is required. If true and the data is not extracted, the call
                  * will be marked as unsuccessful.
@@ -1231,6 +1638,12 @@ export declare namespace ConversationFlowComponentResponse {
                  * Type of the variable to extract.
                  */
                 type: 'boolean';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Whether this data is required. If true and the data is not extracted, the call
                  * will be marked as unsuccessful.
@@ -1250,6 +1663,12 @@ export declare namespace ConversationFlowComponentResponse {
                  * Type of the variable to extract.
                  */
                 type: 'number';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Whether this data is required. If true and the data is not extracted, the call
                  * will be marked as unsuccessful.
@@ -3511,6 +3930,12 @@ export declare namespace ConversationFlowComponentResponse {
              * Type of the variable to extract.
              */
             type: 'string';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Examples of the variable value to teach model the style and syntax.
              */
@@ -3538,6 +3963,12 @@ export declare namespace ConversationFlowComponentResponse {
              * Type of the variable to extract.
              */
             type: 'enum';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Whether this data is required. If true and the data is not extracted, the call
              * will be marked as unsuccessful.
@@ -3557,6 +3988,12 @@ export declare namespace ConversationFlowComponentResponse {
              * Type of the variable to extract.
              */
             type: 'boolean';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Whether this data is required. If true and the data is not extracted, the call
              * will be marked as unsuccessful.
@@ -3576,6 +4013,12 @@ export declare namespace ConversationFlowComponentResponse {
              * Type of the variable to extract.
              */
             type: 'number';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Whether this data is required. If true and the data is not extracted, the call
              * will be marked as unsuccessful.
@@ -5102,6 +5545,41 @@ export declare namespace ConversationFlowComponentResponse {
          */
         timeout_ms?: number;
     }
+    interface Note {
+        /**
+         * Unique identifier for the note.
+         */
+        id: string;
+        /**
+         * Text content of the note, can contain refs to images in the format
+         * "<image:asset_id>"
+         */
+        content: string;
+        /**
+         * Position of the note on the canvas.
+         */
+        display_position: Note.DisplayPosition;
+        /**
+         * Dimensions of the note on the canvas.
+         */
+        size: Note.Size;
+    }
+    namespace Note {
+        /**
+         * Position of the note on the canvas.
+         */
+        interface DisplayPosition {
+            x?: number;
+            y?: number;
+        }
+        /**
+         * Dimensions of the note on the canvas.
+         */
+        interface Size {
+            height?: number;
+            width?: number;
+        }
+    }
     interface CustomTool {
         /**
          * Name of the tool. Must be unique within all tools available to LLM at any given
@@ -5308,7 +5786,7 @@ export interface ConversationFlowComponentCreateParams {
     /**
      * Nodes that make up the component
      */
-    nodes: Array<ConversationFlowComponentCreateParams.ConversationNode | ConversationFlowComponentCreateParams.EndNode | ConversationFlowComponentCreateParams.FunctionNode | ConversationFlowComponentCreateParams.CodeNode | ConversationFlowComponentCreateParams.TransferCallNode | ConversationFlowComponentCreateParams.PressDigitNode | ConversationFlowComponentCreateParams.BranchNode | ConversationFlowComponentCreateParams.SMSNode | ConversationFlowComponentCreateParams.ExtractDynamicVariablesNode | ConversationFlowComponentCreateParams.AgentSwapNode | ConversationFlowComponentCreateParams.McpNode | ConversationFlowComponentCreateParams.ComponentNode | ConversationFlowComponentCreateParams.BridgeTransferNode | ConversationFlowComponentCreateParams.CancelTransferNode>;
+    nodes: Array<ConversationFlowComponentCreateParams.ConversationNode | ConversationFlowComponentCreateParams.SubagentNode | ConversationFlowComponentCreateParams.EndNode | ConversationFlowComponentCreateParams.FunctionNode | ConversationFlowComponentCreateParams.CodeNode | ConversationFlowComponentCreateParams.TransferCallNode | ConversationFlowComponentCreateParams.PressDigitNode | ConversationFlowComponentCreateParams.BranchNode | ConversationFlowComponentCreateParams.SMSNode | ConversationFlowComponentCreateParams.ExtractDynamicVariablesNode | ConversationFlowComponentCreateParams.AgentSwapNode | ConversationFlowComponentCreateParams.McpNode | ConversationFlowComponentCreateParams.ComponentNode | ConversationFlowComponentCreateParams.BridgeTransferNode | ConversationFlowComponentCreateParams.CancelTransferNode>;
     /**
      * Display position for the begin tag in the frontend
      */
@@ -5317,6 +5795,10 @@ export interface ConversationFlowComponentCreateParams {
      * A list of MCP server configurations to use for this component
      */
     mcps?: Array<ConversationFlowComponentCreateParams.Mcp> | null;
+    /**
+     * Visual annotations displayed on the flow canvas.
+     */
+    notes?: Array<ConversationFlowComponentCreateParams.Note> | null;
     /**
      * ID of the starting node
      */
@@ -5358,16 +5840,6 @@ export declare namespace ConversationFlowComponentCreateParams {
         name?: string;
         responsiveness?: number | null;
         skip_response_edge?: ConversationNode.SkipResponseEdge;
-        /**
-         * The tool ids of the tools defined in main conversation flow or component that
-         * can be used in this conversation node.
-         */
-        tool_ids?: Array<string> | null;
-        /**
-         * The tools owned by this conversation node. This includes other tool types like
-         * transfer_call, agent_swap, etc.
-         */
-        tools?: Array<ConversationNode.EndCallTool | ConversationNode.TransferCallTool | ConversationNode.CheckAvailabilityCalTool | ConversationNode.BookAppointmentCalTool | ConversationNode.AgentSwapTool | ConversationNode.PressDigitTool | ConversationNode.SendSMSTool | ConversationNode.CustomTool | ConversationNode.CodeTool | ConversationNode.ExtractDynamicVariableTool | ConversationNode.BridgeTransferTool | ConversationNode.CancelTransferTool | ConversationNode.McpTool> | null;
         voice_speed?: number | null;
     }
     namespace ConversationNode {
@@ -5720,217 +6192,601 @@ export declare namespace ConversationFlowComponentCreateParams {
                 type: 'prompt';
             }
         }
-        interface EndCallTool {
-            /**
-             * Name of the tool. Must be unique within all tools available to LLM at any given
-             * time (general tools + state tools + state transitions). Must be consisted of
-             * a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64
-             * (no space allowed).
-             */
-            name: string;
-            type: 'end_call';
+    }
+    interface SubagentNode {
+        /**
+         * Unique identifier for the node
+         */
+        id: string;
+        instruction: SubagentNode.Instruction;
+        /**
+         * Type of the node
+         */
+        type: 'subagent';
+        always_edge?: SubagentNode.AlwaysEdge;
+        /**
+         * Position for frontend display
+         */
+        display_position?: SubagentNode.DisplayPosition;
+        edges?: Array<SubagentNode.Edge>;
+        finetune_conversation_examples?: Array<SubagentNode.FinetuneConversationExample>;
+        finetune_transition_examples?: Array<SubagentNode.FinetuneTransitionExample>;
+        global_node_setting?: SubagentNode.GlobalNodeSetting;
+        interruption_sensitivity?: number | null;
+        /**
+         * Knowledge base IDs for RAG (Retrieval-Augmented Generation).
+         */
+        knowledge_base_ids?: Array<string> | null;
+        model_choice?: SubagentNode.ModelChoice;
+        /**
+         * Optional name for display purposes
+         */
+        name?: string;
+        responsiveness?: number | null;
+        skip_response_edge?: SubagentNode.SkipResponseEdge;
+        /**
+         * The tool ids of the tools defined in main conversation flow or component that
+         * can be used in this subagent node.
+         */
+        tool_ids?: Array<string> | null;
+        /**
+         * The tools owned by this subagent node. This includes other tool types like
+         * transfer_call, agent_swap, etc.
+         */
+        tools?: Array<SubagentNode.EndCallTool | SubagentNode.TransferCallTool | SubagentNode.CheckAvailabilityCalTool | SubagentNode.BookAppointmentCalTool | SubagentNode.AgentSwapTool | SubagentNode.PressDigitTool | SubagentNode.SendSMSTool | SubagentNode.CustomTool | SubagentNode.CodeTool | SubagentNode.ExtractDynamicVariableTool | SubagentNode.BridgeTransferTool | SubagentNode.CancelTransferTool | SubagentNode.McpTool> | null;
+        voice_speed?: number | null;
+    }
+    namespace SubagentNode {
+        interface Instruction {
             /**
-             * Describes what the tool does, sometimes can also include information about when
-             * to call the tool.
+             * The prompt text for the instruction
              */
-            description?: string;
+            text: string;
             /**
-             * Describes what to say to user when ending the call. Only applicable when
-             * speak_during_execution is true.
+             * Type of instruction
              */
-            execution_message_description?: string;
+            type: 'prompt';
+        }
+        interface AlwaysEdge {
             /**
-             * Type of execution message. "prompt" means the agent will use
-             * execution_message_description as a prompt to generate the message. "static_text"
-             * means the agent will speak the execution_message_description directly. Defaults
-             * to "prompt".
+             * Unique identifier for the edge
              */
-            execution_message_type?: 'prompt' | 'static_text';
+            id: string;
+            transition_condition: AlwaysEdge.PromptCondition | AlwaysEdge.EquationCondition | AlwaysEdge.UnionMember2;
             /**
-             * If true, will speak during execution.
+             * ID of the destination node
              */
-            speak_during_execution?: boolean;
+            destination_node_id?: string;
         }
-        interface TransferCallTool {
+        namespace AlwaysEdge {
+            interface PromptCondition {
+                /**
+                 * Prompt condition text
+                 */
+                prompt: string;
+                type: 'prompt';
+            }
+            interface EquationCondition {
+                equations: Array<EquationCondition.Equation>;
+                operator: '||' | '&&';
+                type: 'equation';
+                /**
+                 * Must be "Always" for always edge
+                 */
+                prompt?: 'Always';
+            }
+            namespace EquationCondition {
+                interface Equation {
+                    /**
+                     * Left side of the equation
+                     */
+                    left: string;
+                    operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                    /**
+                     * Right side of the equation. The right side of the equation not required when
+                     * "exists" or "not_exist" are selected.
+                     */
+                    right?: string;
+                }
+            }
+            interface UnionMember2 {
+                /**
+                 * Must be "Always" for always edge
+                 */
+                prompt: 'Always';
+                type: 'prompt';
+            }
+        }
+        /**
+         * Position for frontend display
+         */
+        interface DisplayPosition {
+            x?: number;
+            y?: number;
+        }
+        interface Edge {
             /**
-             * Name of the tool. Must be unique within all tools available to LLM at any given
-             * time (general tools + state tools + state edges).
+             * Unique identifier for the edge
              */
-            name: string;
-            transfer_destination: TransferCallTool.TransferDestinationPredefined | TransferCallTool.TransferDestinationInferred;
-            transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer | TransferCallTool.TransferOptionAgenticWarmTransfer;
-            type: 'transfer_call';
+            id: string;
+            transition_condition: Edge.PromptCondition | Edge.EquationCondition;
             /**
-             * Custom SIP headers to be added to the call.
+             * ID of the destination node
              */
-            custom_sip_headers?: {
-                [key: string]: string;
-            };
+            destination_node_id?: string;
+        }
+        namespace Edge {
+            interface PromptCondition {
+                /**
+                 * Prompt condition text
+                 */
+                prompt: string;
+                type: 'prompt';
+            }
+            interface EquationCondition {
+                equations: Array<EquationCondition.Equation>;
+                operator: '||' | '&&';
+                type: 'equation';
+            }
+            namespace EquationCondition {
+                interface Equation {
+                    /**
+                     * Left side of the equation
+                     */
+                    left: string;
+                    operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                    /**
+                     * Right side of the equation. The right side of the equation not required when
+                     * "exists" or "not_exist" are selected.
+                     */
+                    right?: string;
+                }
+            }
+        }
+        interface FinetuneConversationExample {
             /**
-             * Describes what the tool does, sometimes can also include information about when
-             * to call the tool.
+             * Unique identifier for the example
              */
-            description?: string;
+            id: string;
             /**
-             * Describes what to say to user when transferring the call. Only applicable when
-             * speak_during_execution is true.
+             * The example transcript to finetune how the conversation should be.
              */
-            execution_message_description?: string;
+            transcript: Array<FinetuneConversationExample.UnionMember0 | FinetuneConversationExample.UnionMember1 | FinetuneConversationExample.UnionMember2>;
+        }
+        namespace FinetuneConversationExample {
+            interface UnionMember0 {
+                content: string;
+                role: 'agent' | 'user';
+            }
+            interface UnionMember1 {
+                arguments: string;
+                name: string;
+                role: 'tool_call_invocation';
+                tool_call_id: string;
+            }
+            interface UnionMember2 {
+                content: string;
+                role: 'tool_call_result';
+                tool_call_id: string;
+            }
+        }
+        interface FinetuneTransitionExample {
             /**
-             * Type of execution message. "prompt" means the agent will use
-             * execution_message_description as a prompt to generate the message. "static_text"
-             * means the agent will speak the execution_message_description directly. Defaults
-             * to "prompt".
+             * Unique identifier for the example
              */
-            execution_message_type?: 'prompt' | 'static_text';
+            id: string;
             /**
-             * If true, the e.164 validation will be ignored for the from_number. This can be
-             * useful when you want to dial to internal pseudo numbers. This only applies when
-             * you are using custom telephony and does not apply when you are using Retell
-             * Telephony. If omitted, the default value is false.
+             * The example transcript to finetune how the node should transition.
              */
-            ignore_e164_validation?: boolean;
+            transcript: Array<FinetuneTransitionExample.UnionMember0 | FinetuneTransitionExample.UnionMember1 | FinetuneTransitionExample.UnionMember2>;
             /**
-             * If true, will speak during execution.
+             * Optional destination node ID
              */
-            speak_during_execution?: boolean;
+            destination_node_id?: string;
         }
-        namespace TransferCallTool {
-            interface TransferDestinationPredefined {
-                /**
-                 * The number to transfer to in E.164 format or a dynamic variable like
-                 * {{transfer_number}}.
-                 */
-                number: string;
-                /**
-                 * The type of transfer destination.
-                 */
-                type: 'predefined';
-                /**
-                 * Extension digits to dial after the main number connects. Sent via DTMF. Allow
-                 * digits, '\*', '#', or a dynamic variable like {{extension}}.
-                 */
-                extension?: string;
+        namespace FinetuneTransitionExample {
+            interface UnionMember0 {
+                content: string;
+                role: 'agent' | 'user';
             }
-            interface TransferDestinationInferred {
-                /**
-                 * The prompt to be used to help infer the transfer destination. The model will
-                 * take the global prompt, the call transcript, and this prompt together to deduce
-                 * the right number to transfer to. Can contain dynamic variables.
-                 */
-                prompt: string;
-                /**
-                 * The type of transfer destination.
-                 */
-                type: 'inferred';
+            interface UnionMember1 {
+                arguments: string;
+                name: string;
+                role: 'tool_call_invocation';
+                tool_call_id: string;
             }
-            interface TransferOptionColdTransfer {
-                /**
-                 * The type of the transfer.
-                 */
-                type: 'cold_transfer';
-                /**
-                 * The mode of the cold transfer. If set to `sip_refer`, will use SIP REFER to
-                 * transfer the call. If set to `sip_invite`, will use SIP INVITE to transfer the
-                 * call.
-                 */
-                cold_transfer_mode?: 'sip_refer' | 'sip_invite';
-                /**
-                 * 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. This parameter takes effect only when
-                 * `cold_transfer_mode` is set to `sip_invite`. When using `sip_refer`, this option
-                 * is not available. Retell Twilio numbers always use user's number as the caller
-                 * id when using `sip refer` cold transfer mode.
-                 */
-                show_transferee_as_caller?: boolean;
-                /**
-                 * Override the ring duration for this specific transfer, in milliseconds. If not
-                 * set, falls back to the agent-level `ring_duration_ms`.
-                 */
-                transfer_ring_duration_ms?: number;
+            interface UnionMember2 {
+                content: string;
+                role: 'tool_call_result';
+                tool_call_id: string;
             }
-            interface TransferOptionWarmTransfer {
-                /**
-                 * The type of the transfer.
-                 */
-                type: 'warm_transfer';
-                /**
-                 * The time to wait before considering transfer fails.
-                 */
-                agent_detection_timeout_ms?: number;
-                /**
-                 * Whether to play an audio cue when bridging the call. Defaults to true.
-                 */
-                enable_bridge_audio_cue?: boolean;
-                /**
-                 * IVR navigation option to run when doing human detection. This prompt will guide
-                 * the AI on how to navigate the IVR system.
-                 */
-                ivr_option?: TransferOptionWarmTransfer.IvrOption;
-                /**
-                 * The music to play while the caller is being transferred.
-                 */
-                on_hold_music?: 'none' | 'relaxing_sound' | 'uplifting_beats' | 'ringtone';
+        }
+        interface GlobalNodeSetting {
+            /**
+             * Condition for global node activation, cannot be empty
+             */
+            condition: string;
+            /**
+             * The same global node won't be triggered again within the next N node
+             * transitions.
+             */
+            cool_down?: number;
+            /**
+             * The conditions for global node go back. There would be no destination_node_id
+             * for these edges.
+             */
+            go_back_conditions?: Array<GlobalNodeSetting.GoBackCondition>;
+            /**
+             * Don't transition to this node
+             */
+            negative_finetune_examples?: Array<GlobalNodeSetting.NegativeFinetuneExample>;
+            /**
+             * Transition to this node
+             */
+            positive_finetune_examples?: Array<GlobalNodeSetting.PositiveFinetuneExample>;
+        }
+        namespace GlobalNodeSetting {
+            interface GoBackCondition {
                 /**
-                 * If set to true, will not perform human detection for the transfer. Default to
-                 * false.
+                 * Unique identifier for the edge
                  */
-                opt_out_human_detection?: boolean;
+                id: string;
+                transition_condition: GoBackCondition.PromptCondition | GoBackCondition.EquationCondition;
                 /**
-                 * If set, when transfer is connected, will say the handoff message only to 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.
+                 * ID of the destination node
                  */
-                private_handoff_option?: TransferOptionWarmTransfer.WarmTransferPrompt | TransferOptionWarmTransfer.WarmTransferStaticMessage;
+                destination_node_id?: string;
+            }
+            namespace GoBackCondition {
+                interface PromptCondition {
+                    /**
+                     * Prompt condition text
+                     */
+                    prompt: string;
+                    type: 'prompt';
+                }
+                interface EquationCondition {
+                    equations: Array<EquationCondition.Equation>;
+                    operator: '||' | '&&';
+                    type: 'equation';
+                }
+                namespace EquationCondition {
+                    interface Equation {
+                        /**
+                         * Left side of the equation
+                         */
+                        left: string;
+                        operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                        /**
+                         * Right side of the equation. The right side of the equation not required when
+                         * "exists" or "not_exist" are selected.
+                         */
+                        right?: string;
+                    }
+                }
+            }
+            interface NegativeFinetuneExample {
                 /**
-                 * 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.
+                 * Find tune the transition condition to this global node
                  */
-                public_handoff_option?: TransferOptionWarmTransfer.WarmTransferPrompt | TransferOptionWarmTransfer.WarmTransferStaticMessage;
+                transcript: Array<NegativeFinetuneExample.UnionMember0 | NegativeFinetuneExample.UnionMember1 | NegativeFinetuneExample.UnionMember2>;
+            }
+            namespace NegativeFinetuneExample {
+                interface UnionMember0 {
+                    content: string;
+                    role: 'agent' | 'user';
+                }
+                interface UnionMember1 {
+                    arguments: string;
+                    name: string;
+                    role: 'tool_call_invocation';
+                    tool_call_id: string;
+                }
+                interface UnionMember2 {
+                    content: string;
+                    role: 'tool_call_result';
+                    tool_call_id: string;
+                }
+            }
+            interface PositiveFinetuneExample {
                 /**
-                 * 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.
+                 * Find tune the transition condition to this global node
                  */
-                show_transferee_as_caller?: boolean;
+                transcript: Array<PositiveFinetuneExample.UnionMember0 | PositiveFinetuneExample.UnionMember1 | PositiveFinetuneExample.UnionMember2>;
+            }
+            namespace PositiveFinetuneExample {
+                interface UnionMember0 {
+                    content: string;
+                    role: 'agent' | 'user';
+                }
+                interface UnionMember1 {
+                    arguments: string;
+                    name: string;
+                    role: 'tool_call_invocation';
+                    tool_call_id: string;
+                }
+                interface UnionMember2 {
+                    content: string;
+                    role: 'tool_call_result';
+                    tool_call_id: string;
+                }
+            }
+        }
+        interface ModelChoice {
+            /**
+             * The LLM model to use
+             */
+            model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash';
+            /**
+             * Type of model choice
+             */
+            type: 'cascading';
+            /**
+             * Whether to use high priority pool with more dedicated resource, default false
+             */
+            high_priority?: boolean;
+        }
+        interface SkipResponseEdge {
+            /**
+             * Unique identifier for the edge
+             */
+            id: string;
+            transition_condition: SkipResponseEdge.PromptCondition | SkipResponseEdge.EquationCondition | SkipResponseEdge.UnionMember2;
+            /**
+             * ID of the destination node
+             */
+            destination_node_id?: string;
+        }
+        namespace SkipResponseEdge {
+            interface PromptCondition {
                 /**
-                 * Override the ring duration for this specific transfer, in milliseconds. If not
-                 * set, falls back to the agent-level `ring_duration_ms`.
+                 * Prompt condition text
                  */
-                transfer_ring_duration_ms?: number;
+                prompt: string;
+                type: 'prompt';
             }
-            namespace TransferOptionWarmTransfer {
+            interface EquationCondition {
+                equations: Array<EquationCondition.Equation>;
+                operator: '||' | '&&';
+                type: 'equation';
                 /**
-                 * IVR navigation option to run when doing human detection. This prompt will guide
-                 * the AI on how to navigate the IVR system.
+                 * Must be "Skip response" for skip response edge
                  */
-                interface IvrOption {
-                    /**
-                     * The prompt to be used for warm handoff. Can contain dynamic variables.
-                     */
-                    prompt?: string;
-                    type?: 'prompt';
-                }
-                interface WarmTransferPrompt {
+                prompt?: 'Skip response';
+            }
+            namespace EquationCondition {
+                interface Equation {
                     /**
-                     * The prompt to be used for warm handoff. Can contain dynamic variables.
+                     * Left side of the equation
                      */
-                    prompt?: string;
-                    type?: 'prompt';
-                }
-                interface WarmTransferStaticMessage {
+                    left: string;
+                    operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
                     /**
-                     * The static message to be used for warm handoff. Can contain dynamic variables.
+                     * Right side of the equation. The right side of the equation not required when
+                     * "exists" or "not_exist" are selected.
                      */
-                    message?: string;
-                    type?: 'static_message';
+                    right?: string;
                 }
-                interface WarmTransferPrompt {
-                    /**
-                     * The prompt to be used for warm handoff. Can contain dynamic variables.
-                     */
+            }
+            interface UnionMember2 {
+                /**
+                 * Must be "Skip response" for skip response edge
+                 */
+                prompt: 'Skip response';
+                type: 'prompt';
+            }
+        }
+        interface EndCallTool {
+            /**
+             * Name of the tool. Must be unique within all tools available to LLM at any given
+             * time (general tools + state tools + state transitions). Must be consisted of
+             * a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64
+             * (no space allowed).
+             */
+            name: string;
+            type: 'end_call';
+            /**
+             * Describes what the tool does, sometimes can also include information about when
+             * to call the tool.
+             */
+            description?: string;
+            /**
+             * Describes what to say to user when ending the call. Only applicable when
+             * speak_during_execution is true.
+             */
+            execution_message_description?: string;
+            /**
+             * Type of execution message. "prompt" means the agent will use
+             * execution_message_description as a prompt to generate the message. "static_text"
+             * means the agent will speak the execution_message_description directly. Defaults
+             * to "prompt".
+             */
+            execution_message_type?: 'prompt' | 'static_text';
+            /**
+             * If true, will speak during execution.
+             */
+            speak_during_execution?: boolean;
+        }
+        interface TransferCallTool {
+            /**
+             * Name of the tool. Must be unique within all tools available to LLM at any given
+             * time (general tools + state tools + state edges).
+             */
+            name: string;
+            transfer_destination: TransferCallTool.TransferDestinationPredefined | TransferCallTool.TransferDestinationInferred;
+            transfer_option: TransferCallTool.TransferOptionColdTransfer | TransferCallTool.TransferOptionWarmTransfer | TransferCallTool.TransferOptionAgenticWarmTransfer;
+            type: 'transfer_call';
+            /**
+             * Custom SIP headers to be added to the call.
+             */
+            custom_sip_headers?: {
+                [key: string]: string;
+            };
+            /**
+             * Describes what the tool does, sometimes can also include information about when
+             * to call the tool.
+             */
+            description?: string;
+            /**
+             * Describes what to say to user when transferring the call. Only applicable when
+             * speak_during_execution is true.
+             */
+            execution_message_description?: string;
+            /**
+             * Type of execution message. "prompt" means the agent will use
+             * execution_message_description as a prompt to generate the message. "static_text"
+             * means the agent will speak the execution_message_description directly. Defaults
+             * to "prompt".
+             */
+            execution_message_type?: 'prompt' | 'static_text';
+            /**
+             * If true, the e.164 validation will be ignored for the from_number. This can be
+             * useful when you want to dial to internal pseudo numbers. This only applies when
+             * you are using custom telephony and does not apply when you are using Retell
+             * Telephony. If omitted, the default value is false.
+             */
+            ignore_e164_validation?: boolean;
+            /**
+             * If true, will speak during execution.
+             */
+            speak_during_execution?: boolean;
+        }
+        namespace TransferCallTool {
+            interface TransferDestinationPredefined {
+                /**
+                 * The number to transfer to in E.164 format or a dynamic variable like
+                 * {{transfer_number}}.
+                 */
+                number: string;
+                /**
+                 * The type of transfer destination.
+                 */
+                type: 'predefined';
+                /**
+                 * Extension digits to dial after the main number connects. Sent via DTMF. Allow
+                 * digits, '\*', '#', or a dynamic variable like {{extension}}.
+                 */
+                extension?: string;
+            }
+            interface TransferDestinationInferred {
+                /**
+                 * The prompt to be used to help infer the transfer destination. The model will
+                 * take the global prompt, the call transcript, and this prompt together to deduce
+                 * the right number to transfer to. Can contain dynamic variables.
+                 */
+                prompt: string;
+                /**
+                 * The type of transfer destination.
+                 */
+                type: 'inferred';
+            }
+            interface TransferOptionColdTransfer {
+                /**
+                 * The type of the transfer.
+                 */
+                type: 'cold_transfer';
+                /**
+                 * The mode of the cold transfer. If set to `sip_refer`, will use SIP REFER to
+                 * transfer the call. If set to `sip_invite`, will use SIP INVITE to transfer the
+                 * call.
+                 */
+                cold_transfer_mode?: 'sip_refer' | 'sip_invite';
+                /**
+                 * 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. This parameter takes effect only when
+                 * `cold_transfer_mode` is set to `sip_invite`. When using `sip_refer`, this option
+                 * is not available. Retell Twilio numbers always use user's number as the caller
+                 * id when using `sip refer` cold transfer mode.
+                 */
+                show_transferee_as_caller?: boolean;
+                /**
+                 * Override the ring duration for this specific transfer, in milliseconds. If not
+                 * set, falls back to the agent-level `ring_duration_ms`.
+                 */
+                transfer_ring_duration_ms?: number;
+            }
+            interface TransferOptionWarmTransfer {
+                /**
+                 * The type of the transfer.
+                 */
+                type: 'warm_transfer';
+                /**
+                 * The time to wait before considering transfer fails.
+                 */
+                agent_detection_timeout_ms?: number;
+                /**
+                 * Whether to play an audio cue when bridging the call. Defaults to true.
+                 */
+                enable_bridge_audio_cue?: boolean;
+                /**
+                 * IVR navigation option to run when doing human detection. This prompt will guide
+                 * the AI on how to navigate the IVR system.
+                 */
+                ivr_option?: TransferOptionWarmTransfer.IvrOption;
+                /**
+                 * The music to play while the caller is being transferred.
+                 */
+                on_hold_music?: 'none' | 'relaxing_sound' | 'uplifting_beats' | 'ringtone';
+                /**
+                 * If set to true, will not perform human detection for the transfer. Default to
+                 * false.
+                 */
+                opt_out_human_detection?: boolean;
+                /**
+                 * If set, when transfer is connected, will say the handoff message only to 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.
+                 */
+                private_handoff_option?: TransferOptionWarmTransfer.WarmTransferPrompt | TransferOptionWarmTransfer.WarmTransferStaticMessage;
+                /**
+                 * 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?: TransferOptionWarmTransfer.WarmTransferPrompt | TransferOptionWarmTransfer.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;
+                /**
+                 * Override the ring duration for this specific transfer, in milliseconds. If not
+                 * set, falls back to the agent-level `ring_duration_ms`.
+                 */
+                transfer_ring_duration_ms?: number;
+            }
+            namespace TransferOptionWarmTransfer {
+                /**
+                 * IVR navigation option to run when doing human detection. This prompt will guide
+                 * the AI on how to navigate the IVR system.
+                 */
+                interface IvrOption {
+                    /**
+                     * The prompt to be used for warm handoff. Can contain dynamic variables.
+                     */
+                    prompt?: string;
+                    type?: 'prompt';
+                }
+                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 WarmTransferPrompt {
+                    /**
+                     * The prompt to be used for warm handoff. Can contain dynamic variables.
+                     */
                     prompt?: string;
                     type?: 'prompt';
                 }
@@ -6182,6 +7038,23 @@ export declare namespace ConversationFlowComponentCreateParams {
              * to call the tool.
              */
             description?: string;
+            /**
+             * Describes what to say before sending the SMS. Only applicable when
+             * speak_during_execution is true.
+             */
+            execution_message_description?: string;
+            /**
+             * Type of execution message. "prompt" means the agent will use
+             * execution_message_description as a prompt to generate the message. "static_text"
+             * means the agent will speak the execution_message_description directly. Defaults
+             * to "prompt".
+             */
+            execution_message_type?: 'prompt' | 'static_text';
+            /**
+             * If true, the agent will speak a short line before sending the SMS. If omitted,
+             * defaults to true (same as end_call / transfer_call tools).
+             */
+            speak_during_execution?: boolean;
         }
         namespace SendSMSTool {
             interface SMSContentPredefined {
@@ -6402,6 +7275,12 @@ export declare namespace ConversationFlowComponentCreateParams {
                  * Type of the variable to extract.
                  */
                 type: 'string';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Examples of the variable value to teach model the style and syntax.
                  */
@@ -6429,6 +7308,12 @@ export declare namespace ConversationFlowComponentCreateParams {
                  * Type of the variable to extract.
                  */
                 type: 'enum';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Whether this data is required. If true and the data is not extracted, the call
                  * will be marked as unsuccessful.
@@ -6448,6 +7333,12 @@ export declare namespace ConversationFlowComponentCreateParams {
                  * Type of the variable to extract.
                  */
                 type: 'boolean';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Whether this data is required. If true and the data is not extracted, the call
                  * will be marked as unsuccessful.
@@ -6467,6 +7358,12 @@ export declare namespace ConversationFlowComponentCreateParams {
                  * Type of the variable to extract.
                  */
                 type: 'number';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Whether this data is required. If true and the data is not extracted, the call
                  * will be marked as unsuccessful.
@@ -8728,6 +9625,12 @@ export declare namespace ConversationFlowComponentCreateParams {
              * Type of the variable to extract.
              */
             type: 'string';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Examples of the variable value to teach model the style and syntax.
              */
@@ -8755,6 +9658,12 @@ export declare namespace ConversationFlowComponentCreateParams {
              * Type of the variable to extract.
              */
             type: 'enum';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Whether this data is required. If true and the data is not extracted, the call
              * will be marked as unsuccessful.
@@ -8774,6 +9683,12 @@ export declare namespace ConversationFlowComponentCreateParams {
              * Type of the variable to extract.
              */
             type: 'boolean';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Whether this data is required. If true and the data is not extracted, the call
              * will be marked as unsuccessful.
@@ -8793,6 +9708,12 @@ export declare namespace ConversationFlowComponentCreateParams {
              * Type of the variable to extract.
              */
             type: 'number';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Whether this data is required. If true and the data is not extracted, the call
              * will be marked as unsuccessful.
@@ -9922,225 +10843,904 @@ export declare namespace ConversationFlowComponentCreateParams {
             }
         }
     }
-    interface BridgeTransferNode {
+    interface BridgeTransferNode {
+        /**
+         * Unique identifier for the node
+         */
+        id: string;
+        /**
+         * Type of the node - initiates a warm transfer by bridging the call
+         */
+        type: 'bridge_transfer';
+        /**
+         * Position for frontend display
+         */
+        display_position?: BridgeTransferNode.DisplayPosition;
+        global_node_setting?: BridgeTransferNode.GlobalNodeSetting;
+        /**
+         * Describes what to say to user when bridging the transfer. Only applicable when
+         * speak_during_execution is true.
+         */
+        instruction?: BridgeTransferNode.NodeInstructionPrompt | BridgeTransferNode.NodeInstructionStaticText;
+        model_choice?: BridgeTransferNode.ModelChoice;
+        /**
+         * Optional name for display purposes
+         */
+        name?: string;
+        /**
+         * If true, will speak during execution
+         */
+        speak_during_execution?: boolean;
+    }
+    namespace BridgeTransferNode {
+        /**
+         * Position for frontend display
+         */
+        interface DisplayPosition {
+            x?: number;
+            y?: number;
+        }
+        interface GlobalNodeSetting {
+            /**
+             * Condition for global node activation, cannot be empty
+             */
+            condition: string;
+            /**
+             * The same global node won't be triggered again within the next N node
+             * transitions.
+             */
+            cool_down?: number;
+            /**
+             * The conditions for global node go back. There would be no destination_node_id
+             * for these edges.
+             */
+            go_back_conditions?: Array<GlobalNodeSetting.GoBackCondition>;
+            /**
+             * Don't transition to this node
+             */
+            negative_finetune_examples?: Array<GlobalNodeSetting.NegativeFinetuneExample>;
+            /**
+             * Transition to this node
+             */
+            positive_finetune_examples?: Array<GlobalNodeSetting.PositiveFinetuneExample>;
+        }
+        namespace GlobalNodeSetting {
+            interface GoBackCondition {
+                /**
+                 * Unique identifier for the edge
+                 */
+                id: string;
+                transition_condition: GoBackCondition.PromptCondition | GoBackCondition.EquationCondition;
+                /**
+                 * ID of the destination node
+                 */
+                destination_node_id?: string;
+            }
+            namespace GoBackCondition {
+                interface PromptCondition {
+                    /**
+                     * Prompt condition text
+                     */
+                    prompt: string;
+                    type: 'prompt';
+                }
+                interface EquationCondition {
+                    equations: Array<EquationCondition.Equation>;
+                    operator: '||' | '&&';
+                    type: 'equation';
+                }
+                namespace EquationCondition {
+                    interface Equation {
+                        /**
+                         * Left side of the equation
+                         */
+                        left: string;
+                        operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                        /**
+                         * Right side of the equation. The right side of the equation not required when
+                         * "exists" or "not_exist" are selected.
+                         */
+                        right?: string;
+                    }
+                }
+            }
+            interface NegativeFinetuneExample {
+                /**
+                 * Find tune the transition condition to this global node
+                 */
+                transcript: Array<NegativeFinetuneExample.UnionMember0 | NegativeFinetuneExample.UnionMember1 | NegativeFinetuneExample.UnionMember2>;
+            }
+            namespace NegativeFinetuneExample {
+                interface UnionMember0 {
+                    content: string;
+                    role: 'agent' | 'user';
+                }
+                interface UnionMember1 {
+                    arguments: string;
+                    name: string;
+                    role: 'tool_call_invocation';
+                    tool_call_id: string;
+                }
+                interface UnionMember2 {
+                    content: string;
+                    role: 'tool_call_result';
+                    tool_call_id: string;
+                }
+            }
+            interface PositiveFinetuneExample {
+                /**
+                 * Find tune the transition condition to this global node
+                 */
+                transcript: Array<PositiveFinetuneExample.UnionMember0 | PositiveFinetuneExample.UnionMember1 | PositiveFinetuneExample.UnionMember2>;
+            }
+            namespace PositiveFinetuneExample {
+                interface UnionMember0 {
+                    content: string;
+                    role: 'agent' | 'user';
+                }
+                interface UnionMember1 {
+                    arguments: string;
+                    name: string;
+                    role: 'tool_call_invocation';
+                    tool_call_id: string;
+                }
+                interface UnionMember2 {
+                    content: string;
+                    role: 'tool_call_result';
+                    tool_call_id: string;
+                }
+            }
+        }
+        interface NodeInstructionPrompt {
+            /**
+             * The prompt text for the instruction
+             */
+            text: string;
+            /**
+             * Type of instruction
+             */
+            type: 'prompt';
+        }
+        interface NodeInstructionStaticText {
+            /**
+             * The static text for the instruction
+             */
+            text: string;
+            /**
+             * Type of instruction
+             */
+            type: 'static_text';
+        }
+        interface ModelChoice {
+            /**
+             * The LLM model to use
+             */
+            model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash';
+            /**
+             * Type of model choice
+             */
+            type: 'cascading';
+            /**
+             * Whether to use high priority pool with more dedicated resource, default false
+             */
+            high_priority?: boolean;
+        }
+    }
+    interface CancelTransferNode {
+        /**
+         * Unique identifier for the node
+         */
+        id: string;
+        /**
+         * Type of the node - cancels the warm transfer and ends the transfer agent call
+         */
+        type: 'cancel_transfer';
+        /**
+         * Position for frontend display
+         */
+        display_position?: CancelTransferNode.DisplayPosition;
+        global_node_setting?: CancelTransferNode.GlobalNodeSetting;
+        /**
+         * Describes what to say to user when cancelling the transfer. Only applicable when
+         * speak_during_execution is true.
+         */
+        instruction?: CancelTransferNode.NodeInstructionPrompt | CancelTransferNode.NodeInstructionStaticText;
+        model_choice?: CancelTransferNode.ModelChoice;
+        /**
+         * Optional name for display purposes
+         */
+        name?: string;
+        /**
+         * If true, will speak during execution
+         */
+        speak_during_execution?: boolean;
+    }
+    namespace CancelTransferNode {
+        /**
+         * Position for frontend display
+         */
+        interface DisplayPosition {
+            x?: number;
+            y?: number;
+        }
+        interface GlobalNodeSetting {
+            /**
+             * Condition for global node activation, cannot be empty
+             */
+            condition: string;
+            /**
+             * The same global node won't be triggered again within the next N node
+             * transitions.
+             */
+            cool_down?: number;
+            /**
+             * The conditions for global node go back. There would be no destination_node_id
+             * for these edges.
+             */
+            go_back_conditions?: Array<GlobalNodeSetting.GoBackCondition>;
+            /**
+             * Don't transition to this node
+             */
+            negative_finetune_examples?: Array<GlobalNodeSetting.NegativeFinetuneExample>;
+            /**
+             * Transition to this node
+             */
+            positive_finetune_examples?: Array<GlobalNodeSetting.PositiveFinetuneExample>;
+        }
+        namespace GlobalNodeSetting {
+            interface GoBackCondition {
+                /**
+                 * Unique identifier for the edge
+                 */
+                id: string;
+                transition_condition: GoBackCondition.PromptCondition | GoBackCondition.EquationCondition;
+                /**
+                 * ID of the destination node
+                 */
+                destination_node_id?: string;
+            }
+            namespace GoBackCondition {
+                interface PromptCondition {
+                    /**
+                     * Prompt condition text
+                     */
+                    prompt: string;
+                    type: 'prompt';
+                }
+                interface EquationCondition {
+                    equations: Array<EquationCondition.Equation>;
+                    operator: '||' | '&&';
+                    type: 'equation';
+                }
+                namespace EquationCondition {
+                    interface Equation {
+                        /**
+                         * Left side of the equation
+                         */
+                        left: string;
+                        operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                        /**
+                         * Right side of the equation. The right side of the equation not required when
+                         * "exists" or "not_exist" are selected.
+                         */
+                        right?: string;
+                    }
+                }
+            }
+            interface NegativeFinetuneExample {
+                /**
+                 * Find tune the transition condition to this global node
+                 */
+                transcript: Array<NegativeFinetuneExample.UnionMember0 | NegativeFinetuneExample.UnionMember1 | NegativeFinetuneExample.UnionMember2>;
+            }
+            namespace NegativeFinetuneExample {
+                interface UnionMember0 {
+                    content: string;
+                    role: 'agent' | 'user';
+                }
+                interface UnionMember1 {
+                    arguments: string;
+                    name: string;
+                    role: 'tool_call_invocation';
+                    tool_call_id: string;
+                }
+                interface UnionMember2 {
+                    content: string;
+                    role: 'tool_call_result';
+                    tool_call_id: string;
+                }
+            }
+            interface PositiveFinetuneExample {
+                /**
+                 * Find tune the transition condition to this global node
+                 */
+                transcript: Array<PositiveFinetuneExample.UnionMember0 | PositiveFinetuneExample.UnionMember1 | PositiveFinetuneExample.UnionMember2>;
+            }
+            namespace PositiveFinetuneExample {
+                interface UnionMember0 {
+                    content: string;
+                    role: 'agent' | 'user';
+                }
+                interface UnionMember1 {
+                    arguments: string;
+                    name: string;
+                    role: 'tool_call_invocation';
+                    tool_call_id: string;
+                }
+                interface UnionMember2 {
+                    content: string;
+                    role: 'tool_call_result';
+                    tool_call_id: string;
+                }
+            }
+        }
+        interface NodeInstructionPrompt {
+            /**
+             * The prompt text for the instruction
+             */
+            text: string;
+            /**
+             * Type of instruction
+             */
+            type: 'prompt';
+        }
+        interface NodeInstructionStaticText {
+            /**
+             * The static text for the instruction
+             */
+            text: string;
+            /**
+             * Type of instruction
+             */
+            type: 'static_text';
+        }
+        interface ModelChoice {
+            /**
+             * The LLM model to use
+             */
+            model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash';
+            /**
+             * Type of model choice
+             */
+            type: 'cascading';
+            /**
+             * Whether to use high priority pool with more dedicated resource, default false
+             */
+            high_priority?: boolean;
+        }
+    }
+    /**
+     * Display position for the begin tag in the frontend
+     */
+    interface BeginTagDisplayPosition {
+        x?: number;
+        y?: number;
+    }
+    interface Mcp {
+        name: string;
+        /**
+         * The URL of the MCP server.
+         */
+        url: string;
+        /**
+         * Headers to add to the MCP connection request.
+         */
+        headers?: {
+            [key: string]: string;
+        };
+        /**
+         * Query parameters to append to the MCP connection request URL.
+         */
+        query_params?: {
+            [key: string]: string;
+        };
+        /**
+         * Maximum time to wait for a connection to be established (in milliseconds).
+         * Default to 120,000 ms (2 minutes).
+         */
+        timeout_ms?: number;
+    }
+    interface Note {
+        /**
+         * Unique identifier for the note.
+         */
+        id: string;
+        /**
+         * Text content of the note, can contain refs to images in the format
+         * "<image:asset_id>"
+         */
+        content: string;
+        /**
+         * Position of the note on the canvas.
+         */
+        display_position: Note.DisplayPosition;
+        /**
+         * Dimensions of the note on the canvas.
+         */
+        size: Note.Size;
+    }
+    namespace Note {
+        /**
+         * Position of the note on the canvas.
+         */
+        interface DisplayPosition {
+            x?: number;
+            y?: number;
+        }
+        /**
+         * Dimensions of the note on the canvas.
+         */
+        interface Size {
+            height?: number;
+            width?: number;
+        }
+    }
+    interface CustomTool {
+        /**
+         * Name of the tool. Must be unique within all tools available to LLM at any given
+         * time (general tools + state tools + state edges). Must be consisted of a-z, A-Z,
+         * 0-9, or contain underscores and dashes, with a maximum length of 64 (no space
+         * allowed).
+         */
+        name: string;
+        type: 'custom';
+        /**
+         * Describes what the tool does, sometimes can also include information about when
+         * to call the tool.
+         */
+        url: string;
+        /**
+         * If set to true, the parameters will be passed as root level JSON object instead
+         * of nested under "args".
+         */
+        args_at_root?: boolean;
+        /**
+         * Describes what this tool does and when to call this tool.
+         */
+        description?: string;
+        /**
+         * The description for the sentence agent say during execution. Only applicable
+         * when speak_during_execution is true. Can write what to say or even provide
+         * examples. The default is "The message you will say to callee when calling this
+         * tool. Make sure it fits into the conversation smoothly.".
+         */
+        execution_message_description?: string;
+        /**
+         * Type of execution message. "prompt" means the agent will use
+         * execution_message_description as a prompt to generate the message. "static_text"
+         * means the agent will speak the execution_message_description directly. Defaults
+         * to "prompt".
+         */
+        execution_message_type?: 'prompt' | 'static_text';
+        /**
+         * Headers to add to the request.
+         */
+        headers?: {
+            [key: string]: string;
+        };
+        /**
+         * Method to use for the request, default to POST.
+         */
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        /**
+         * The parameters the functions accepts, described as a JSON Schema object. See
+         * [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for
+         * documentation about the format. Omitting parameters defines a function with an
+         * empty parameter list.
+         */
+        parameters?: CustomTool.Parameters;
+        /**
+         * Query parameters to append to the request URL.
+         */
+        query_params?: {
+            [key: string]: string;
+        };
+        /**
+         * A mapping of variable names to JSON paths in the response body. These values
+         * will be extracted from the response and made available as dynamic variables for
+         * use.
+         */
+        response_variables?: {
+            [key: string]: string;
+        };
+        /**
+         * Determines whether the agent would call LLM another time and speak when the
+         * result of function is obtained. Usually this needs to get turned on so user can
+         * get update for the function call.
+         */
+        speak_after_execution?: boolean;
+        /**
+         * Determines whether the agent would say sentence like "One moment, let me check
+         * that." when executing the function. Recommend to turn on if your function call
+         * takes over 1s (including network) to complete, so that your agent remains
+         * responsive.
+         */
+        speak_during_execution?: boolean;
+        /**
+         * The maximum time in milliseconds the tool can run before it's considered
+         * timeout. If the tool times out, the agent would have that info. The minimum
+         * value allowed is 1000 ms (1 s), and maximum value allowed is 600,000 ms (10
+         * min). By default, this is set to 120,000 ms (2 min).
+         */
+        timeout_ms?: number;
+        /**
+         * Unique identifier for the tool
+         */
+        tool_id?: string;
+    }
+    namespace CustomTool {
+        /**
+         * The parameters the functions accepts, described as a JSON Schema object. See
+         * [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for
+         * documentation about the format. Omitting parameters defines a function with an
+         * empty parameter list.
+         */
+        interface Parameters {
+            /**
+             * The value of properties is an object, where each key is the name of a property
+             * and each value is a schema used to validate that property.
+             */
+            properties: {
+                [key: string]: unknown;
+            };
+            /**
+             * Type must be "object" for a JSON Schema object.
+             */
+            type: 'object';
+            /**
+             * List of names of required property when generating this parameter. LLM will do
+             * its best to generate the required properties in its function arguments. Property
+             * must exist in properties.
+             */
+            required?: Array<string>;
+        }
+    }
+    interface CheckAvailabilityCalTool {
+        /**
+         * Cal.com Api key that have access to the cal.com event you want to check
+         * availability for.
+         */
+        cal_api_key: string;
+        /**
+         * Cal.com event type id number for the cal.com event you want to check
+         * availability for. Can be a number or a dynamic variable in the format
+         * `{{variable_name}}` that will be resolved at runtime.
+         */
+        event_type_id: number | string;
+        /**
+         * Name of the tool. Must be unique within all tools available to LLM at any given
+         * time (general tools + state tools + state transitions). Must be consisted of
+         * a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64
+         * (no space allowed).
+         */
+        name: string;
+        type: 'check_availability_cal';
+        /**
+         * Describes what the tool does, sometimes can also include information about when
+         * to call the tool.
+         */
+        description?: string;
+        /**
+         * Timezone to be used when checking availability, must be in
+         * [IANA timezone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
+         * Can also be a dynamic variable in the format `{{variable_name}}` that will be
+         * resolved at runtime. If not specified, will check if user specified timezone in
+         * call, and if not, will use the timezone of the Retell servers.
+         */
+        timezone?: string;
+        /**
+         * Unique identifier for the tool
+         */
+        tool_id?: string;
+    }
+    interface BookAppointmentCalTool {
+        /**
+         * Cal.com Api key that have access to the cal.com event you want to book
+         * appointment.
+         */
+        cal_api_key: string;
+        /**
+         * Cal.com event type id number for the cal.com event you want to book appointment.
+         * Can be a number or a dynamic variable in the format `{{variable_name}}` that
+         * will be resolved at runtime.
+         */
+        event_type_id: number | string;
+        /**
+         * Name of the tool. Must be unique within all tools available to LLM at any given
+         * time (general tools + state tools + state transitions). Must be consisted of
+         * a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64
+         * (no space allowed).
+         */
+        name: string;
+        type: 'book_appointment_cal';
+        /**
+         * Describes what the tool does, sometimes can also include information about when
+         * to call the tool.
+         */
+        description?: string;
+        /**
+         * Timezone to be used when booking appointment, must be in
+         * [IANA timezone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
+         * Can also be a dynamic variable in the format `{{variable_name}}` that will be
+         * resolved at runtime. If not specified, will check if user specified timezone in
+         * call, and if not, will use the timezone of the Retell servers.
+         */
+        timezone?: string;
+        /**
+         * Unique identifier for the tool
+         */
+        tool_id?: string;
+    }
+}
+export interface ConversationFlowComponentUpdateParams {
+    /**
+     * Display position for the begin tag in the frontend
+     */
+    begin_tag_display_position?: ConversationFlowComponentUpdateParams.BeginTagDisplayPosition | null;
+    /**
+     * A list of MCP server configurations to use for this component
+     */
+    mcps?: Array<ConversationFlowComponentUpdateParams.Mcp> | null;
+    /**
+     * Name of the component
+     */
+    name?: string;
+    /**
+     * Nodes that make up the component
+     */
+    nodes?: Array<ConversationFlowComponentUpdateParams.ConversationNode | ConversationFlowComponentUpdateParams.SubagentNode | ConversationFlowComponentUpdateParams.EndNode | ConversationFlowComponentUpdateParams.FunctionNode | ConversationFlowComponentUpdateParams.CodeNode | ConversationFlowComponentUpdateParams.TransferCallNode | ConversationFlowComponentUpdateParams.PressDigitNode | ConversationFlowComponentUpdateParams.BranchNode | ConversationFlowComponentUpdateParams.SMSNode | ConversationFlowComponentUpdateParams.ExtractDynamicVariablesNode | ConversationFlowComponentUpdateParams.AgentSwapNode | ConversationFlowComponentUpdateParams.McpNode | ConversationFlowComponentUpdateParams.ComponentNode | ConversationFlowComponentUpdateParams.BridgeTransferNode | ConversationFlowComponentUpdateParams.CancelTransferNode>;
+    /**
+     * Visual annotations displayed on the flow canvas.
+     */
+    notes?: Array<ConversationFlowComponentUpdateParams.Note> | null;
+    /**
+     * ID of the starting node
+     */
+    start_node_id?: string | null;
+    /**
+     * Tools available within the component
+     */
+    tools?: Array<ConversationFlowComponentUpdateParams.CustomTool | ConversationFlowComponentUpdateParams.CheckAvailabilityCalTool | ConversationFlowComponentUpdateParams.BookAppointmentCalTool> | null;
+}
+export declare namespace ConversationFlowComponentUpdateParams {
+    /**
+     * Display position for the begin tag in the frontend
+     */
+    interface BeginTagDisplayPosition {
+        x?: number;
+        y?: number;
+    }
+    interface Mcp {
+        name: string;
+        /**
+         * The URL of the MCP server.
+         */
+        url: string;
+        /**
+         * Headers to add to the MCP connection request.
+         */
+        headers?: {
+            [key: string]: string;
+        };
+        /**
+         * Query parameters to append to the MCP connection request URL.
+         */
+        query_params?: {
+            [key: string]: string;
+        };
+        /**
+         * Maximum time to wait for a connection to be established (in milliseconds).
+         * Default to 120,000 ms (2 minutes).
+         */
+        timeout_ms?: number;
+    }
+    interface ConversationNode {
         /**
          * Unique identifier for the node
          */
         id: string;
+        instruction: ConversationNode.NodeInstructionPrompt | ConversationNode.NodeInstructionStaticText;
         /**
-         * Type of the node - initiates a warm transfer by bridging the call
+         * Type of the node
          */
-        type: 'bridge_transfer';
+        type: 'conversation';
+        always_edge?: ConversationNode.AlwaysEdge;
         /**
          * Position for frontend display
          */
-        display_position?: BridgeTransferNode.DisplayPosition;
-        global_node_setting?: BridgeTransferNode.GlobalNodeSetting;
+        display_position?: ConversationNode.DisplayPosition;
+        edges?: Array<ConversationNode.Edge>;
+        finetune_conversation_examples?: Array<ConversationNode.FinetuneConversationExample>;
+        finetune_transition_examples?: Array<ConversationNode.FinetuneTransitionExample>;
+        global_node_setting?: ConversationNode.GlobalNodeSetting;
+        interruption_sensitivity?: number | null;
         /**
-         * Describes what to say to user when bridging the transfer. Only applicable when
-         * speak_during_execution is true.
+         * Knowledge base IDs for RAG (Retrieval-Augmented Generation).
          */
-        instruction?: BridgeTransferNode.NodeInstructionPrompt | BridgeTransferNode.NodeInstructionStaticText;
-        model_choice?: BridgeTransferNode.ModelChoice;
+        knowledge_base_ids?: Array<string> | null;
+        model_choice?: ConversationNode.ModelChoice;
         /**
          * Optional name for display purposes
          */
         name?: string;
-        /**
-         * If true, will speak during execution
-         */
-        speak_during_execution?: boolean;
+        responsiveness?: number | null;
+        skip_response_edge?: ConversationNode.SkipResponseEdge;
+        voice_speed?: number | null;
     }
-    namespace BridgeTransferNode {
-        /**
-         * Position for frontend display
-         */
-        interface DisplayPosition {
-            x?: number;
-            y?: number;
-        }
-        interface GlobalNodeSetting {
+    namespace ConversationNode {
+        interface NodeInstructionPrompt {
             /**
-             * Condition for global node activation, cannot be empty
+             * The prompt text for the instruction
              */
-            condition: string;
+            text: string;
             /**
-             * The same global node won't be triggered again within the next N node
-             * transitions.
+             * Type of instruction
              */
-            cool_down?: number;
+            type: 'prompt';
+        }
+        interface NodeInstructionStaticText {
             /**
-             * The conditions for global node go back. There would be no destination_node_id
-             * for these edges.
+             * The static text for the instruction
              */
-            go_back_conditions?: Array<GlobalNodeSetting.GoBackCondition>;
+            text: string;
             /**
-             * Don't transition to this node
+             * Type of instruction
              */
-            negative_finetune_examples?: Array<GlobalNodeSetting.NegativeFinetuneExample>;
+            type: 'static_text';
+        }
+        interface AlwaysEdge {
             /**
-             * Transition to this node
+             * Unique identifier for the edge
              */
-            positive_finetune_examples?: Array<GlobalNodeSetting.PositiveFinetuneExample>;
+            id: string;
+            transition_condition: AlwaysEdge.PromptCondition | AlwaysEdge.EquationCondition | AlwaysEdge.UnionMember2;
+            /**
+             * ID of the destination node
+             */
+            destination_node_id?: string;
         }
-        namespace GlobalNodeSetting {
-            interface GoBackCondition {
+        namespace AlwaysEdge {
+            interface PromptCondition {
                 /**
-                 * Unique identifier for the edge
+                 * Prompt condition text
                  */
-                id: string;
-                transition_condition: GoBackCondition.PromptCondition | GoBackCondition.EquationCondition;
+                prompt: string;
+                type: 'prompt';
+            }
+            interface EquationCondition {
+                equations: Array<EquationCondition.Equation>;
+                operator: '||' | '&&';
+                type: 'equation';
                 /**
-                 * ID of the destination node
+                 * Must be "Always" for always edge
                  */
-                destination_node_id?: string;
+                prompt?: 'Always';
             }
-            namespace GoBackCondition {
-                interface PromptCondition {
+            namespace EquationCondition {
+                interface Equation {
                     /**
-                     * Prompt condition text
+                     * Left side of the equation
                      */
-                    prompt: string;
-                    type: 'prompt';
-                }
-                interface EquationCondition {
-                    equations: Array<EquationCondition.Equation>;
-                    operator: '||' | '&&';
-                    type: 'equation';
-                }
-                namespace EquationCondition {
-                    interface Equation {
-                        /**
-                         * Left side of the equation
-                         */
-                        left: string;
-                        operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
-                        /**
-                         * Right side of the equation. The right side of the equation not required when
-                         * "exists" or "not_exist" are selected.
-                         */
-                        right?: string;
-                    }
-                }
-            }
-            interface NegativeFinetuneExample {
-                /**
-                 * Find tune the transition condition to this global node
-                 */
-                transcript: Array<NegativeFinetuneExample.UnionMember0 | NegativeFinetuneExample.UnionMember1 | NegativeFinetuneExample.UnionMember2>;
-            }
-            namespace NegativeFinetuneExample {
-                interface UnionMember0 {
-                    content: string;
-                    role: 'agent' | 'user';
-                }
-                interface UnionMember1 {
-                    arguments: string;
-                    name: string;
-                    role: 'tool_call_invocation';
-                    tool_call_id: string;
-                }
-                interface UnionMember2 {
-                    content: string;
-                    role: 'tool_call_result';
-                    tool_call_id: string;
+                    left: string;
+                    operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                    /**
+                     * Right side of the equation. The right side of the equation not required when
+                     * "exists" or "not_exist" are selected.
+                     */
+                    right?: string;
                 }
             }
-            interface PositiveFinetuneExample {
+            interface UnionMember2 {
                 /**
-                 * Find tune the transition condition to this global node
+                 * Must be "Always" for always edge
                  */
-                transcript: Array<PositiveFinetuneExample.UnionMember0 | PositiveFinetuneExample.UnionMember1 | PositiveFinetuneExample.UnionMember2>;
-            }
-            namespace PositiveFinetuneExample {
-                interface UnionMember0 {
-                    content: string;
-                    role: 'agent' | 'user';
-                }
-                interface UnionMember1 {
-                    arguments: string;
-                    name: string;
-                    role: 'tool_call_invocation';
-                    tool_call_id: string;
-                }
-                interface UnionMember2 {
-                    content: string;
-                    role: 'tool_call_result';
-                    tool_call_id: string;
-                }
+                prompt: 'Always';
+                type: 'prompt';
             }
         }
-        interface NodeInstructionPrompt {
+        /**
+         * Position for frontend display
+         */
+        interface DisplayPosition {
+            x?: number;
+            y?: number;
+        }
+        interface Edge {
             /**
-             * The prompt text for the instruction
+             * Unique identifier for the edge
              */
-            text: string;
+            id: string;
+            transition_condition: Edge.PromptCondition | Edge.EquationCondition;
             /**
-             * Type of instruction
+             * ID of the destination node
              */
-            type: 'prompt';
+            destination_node_id?: string;
         }
-        interface NodeInstructionStaticText {
+        namespace Edge {
+            interface PromptCondition {
+                /**
+                 * Prompt condition text
+                 */
+                prompt: string;
+                type: 'prompt';
+            }
+            interface EquationCondition {
+                equations: Array<EquationCondition.Equation>;
+                operator: '||' | '&&';
+                type: 'equation';
+            }
+            namespace EquationCondition {
+                interface Equation {
+                    /**
+                     * Left side of the equation
+                     */
+                    left: string;
+                    operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                    /**
+                     * Right side of the equation. The right side of the equation not required when
+                     * "exists" or "not_exist" are selected.
+                     */
+                    right?: string;
+                }
+            }
+        }
+        interface FinetuneConversationExample {
             /**
-             * The static text for the instruction
+             * Unique identifier for the example
              */
-            text: string;
+            id: string;
             /**
-             * Type of instruction
+             * The example transcript to finetune how the conversation should be.
              */
-            type: 'static_text';
+            transcript: Array<FinetuneConversationExample.UnionMember0 | FinetuneConversationExample.UnionMember1 | FinetuneConversationExample.UnionMember2>;
         }
-        interface ModelChoice {
+        namespace FinetuneConversationExample {
+            interface UnionMember0 {
+                content: string;
+                role: 'agent' | 'user';
+            }
+            interface UnionMember1 {
+                arguments: string;
+                name: string;
+                role: 'tool_call_invocation';
+                tool_call_id: string;
+            }
+            interface UnionMember2 {
+                content: string;
+                role: 'tool_call_result';
+                tool_call_id: string;
+            }
+        }
+        interface FinetuneTransitionExample {
             /**
-             * The LLM model to use
+             * Unique identifier for the example
              */
-            model: 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5.1' | 'gpt-5.2' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-4.5-haiku' | 'gemini-2.5-flash' | 'gemini-2.5-flash-lite' | 'gemini-3.0-flash';
+            id: string;
             /**
-             * Type of model choice
+             * The example transcript to finetune how the node should transition.
              */
-            type: 'cascading';
+            transcript: Array<FinetuneTransitionExample.UnionMember0 | FinetuneTransitionExample.UnionMember1 | FinetuneTransitionExample.UnionMember2>;
             /**
-             * Whether to use high priority pool with more dedicated resource, default false
+             * Optional destination node ID
              */
-            high_priority?: boolean;
+            destination_node_id?: string;
         }
-    }
-    interface CancelTransferNode {
-        /**
-         * Unique identifier for the node
-         */
-        id: string;
-        /**
-         * Type of the node - cancels the warm transfer and ends the transfer agent call
-         */
-        type: 'cancel_transfer';
-        /**
-         * Position for frontend display
-         */
-        display_position?: CancelTransferNode.DisplayPosition;
-        global_node_setting?: CancelTransferNode.GlobalNodeSetting;
-        /**
-         * Describes what to say to user when cancelling the transfer. Only applicable when
-         * speak_during_execution is true.
-         */
-        instruction?: CancelTransferNode.NodeInstructionPrompt | CancelTransferNode.NodeInstructionStaticText;
-        model_choice?: CancelTransferNode.ModelChoice;
-        /**
-         * Optional name for display purposes
-         */
-        name?: string;
-        /**
-         * If true, will speak during execution
-         */
-        speak_during_execution?: boolean;
-    }
-    namespace CancelTransferNode {
-        /**
-         * Position for frontend display
-         */
-        interface DisplayPosition {
-            x?: number;
-            y?: number;
+        namespace FinetuneTransitionExample {
+            interface UnionMember0 {
+                content: string;
+                role: 'agent' | 'user';
+            }
+            interface UnionMember1 {
+                arguments: string;
+                name: string;
+                role: 'tool_call_invocation';
+                tool_call_id: string;
+            }
+            interface UnionMember2 {
+                content: string;
+                role: 'tool_call_result';
+                tool_call_id: string;
+            }
         }
         interface GlobalNodeSetting {
             /**
@@ -10253,26 +11853,6 @@ export declare namespace ConversationFlowComponentCreateParams {
                 }
             }
         }
-        interface NodeInstructionPrompt {
-            /**
-             * The prompt text for the instruction
-             */
-            text: string;
-            /**
-             * Type of instruction
-             */
-            type: 'prompt';
-        }
-        interface NodeInstructionStaticText {
-            /**
-             * The static text for the instruction
-             */
-            text: string;
-            /**
-             * Type of instruction
-             */
-            type: 'static_text';
-        }
         interface ModelChoice {
             /**
              * The LLM model to use
@@ -10287,338 +11867,102 @@ export declare namespace ConversationFlowComponentCreateParams {
              */
             high_priority?: boolean;
         }
-    }
-    /**
-     * Display position for the begin tag in the frontend
-     */
-    interface BeginTagDisplayPosition {
-        x?: number;
-        y?: number;
-    }
-    interface Mcp {
-        name: string;
-        /**
-         * The URL of the MCP server.
-         */
-        url: string;
-        /**
-         * Headers to add to the MCP connection request.
-         */
-        headers?: {
-            [key: string]: string;
-        };
-        /**
-         * Query parameters to append to the MCP connection request URL.
-         */
-        query_params?: {
-            [key: string]: string;
-        };
-        /**
-         * Maximum time to wait for a connection to be established (in milliseconds).
-         * Default to 120,000 ms (2 minutes).
-         */
-        timeout_ms?: number;
-    }
-    interface CustomTool {
-        /**
-         * Name of the tool. Must be unique within all tools available to LLM at any given
-         * time (general tools + state tools + state edges). Must be consisted of a-z, A-Z,
-         * 0-9, or contain underscores and dashes, with a maximum length of 64 (no space
-         * allowed).
-         */
-        name: string;
-        type: 'custom';
-        /**
-         * Describes what the tool does, sometimes can also include information about when
-         * to call the tool.
-         */
-        url: string;
-        /**
-         * If set to true, the parameters will be passed as root level JSON object instead
-         * of nested under "args".
-         */
-        args_at_root?: boolean;
-        /**
-         * Describes what this tool does and when to call this tool.
-         */
-        description?: string;
-        /**
-         * The description for the sentence agent say during execution. Only applicable
-         * when speak_during_execution is true. Can write what to say or even provide
-         * examples. The default is "The message you will say to callee when calling this
-         * tool. Make sure it fits into the conversation smoothly.".
-         */
-        execution_message_description?: string;
-        /**
-         * Type of execution message. "prompt" means the agent will use
-         * execution_message_description as a prompt to generate the message. "static_text"
-         * means the agent will speak the execution_message_description directly. Defaults
-         * to "prompt".
-         */
-        execution_message_type?: 'prompt' | 'static_text';
-        /**
-         * Headers to add to the request.
-         */
-        headers?: {
-            [key: string]: string;
-        };
-        /**
-         * Method to use for the request, default to POST.
-         */
-        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-        /**
-         * The parameters the functions accepts, described as a JSON Schema object. See
-         * [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for
-         * documentation about the format. Omitting parameters defines a function with an
-         * empty parameter list.
-         */
-        parameters?: CustomTool.Parameters;
-        /**
-         * Query parameters to append to the request URL.
-         */
-        query_params?: {
-            [key: string]: string;
-        };
-        /**
-         * A mapping of variable names to JSON paths in the response body. These values
-         * will be extracted from the response and made available as dynamic variables for
-         * use.
-         */
-        response_variables?: {
-            [key: string]: string;
-        };
-        /**
-         * Determines whether the agent would call LLM another time and speak when the
-         * result of function is obtained. Usually this needs to get turned on so user can
-         * get update for the function call.
-         */
-        speak_after_execution?: boolean;
-        /**
-         * Determines whether the agent would say sentence like "One moment, let me check
-         * that." when executing the function. Recommend to turn on if your function call
-         * takes over 1s (including network) to complete, so that your agent remains
-         * responsive.
-         */
-        speak_during_execution?: boolean;
-        /**
-         * The maximum time in milliseconds the tool can run before it's considered
-         * timeout. If the tool times out, the agent would have that info. The minimum
-         * value allowed is 1000 ms (1 s), and maximum value allowed is 600,000 ms (10
-         * min). By default, this is set to 120,000 ms (2 min).
-         */
-        timeout_ms?: number;
-        /**
-         * Unique identifier for the tool
-         */
-        tool_id?: string;
-    }
-    namespace CustomTool {
-        /**
-         * The parameters the functions accepts, described as a JSON Schema object. See
-         * [JSON Schema reference](https://json-schema.org/understanding-json-schema/) for
-         * documentation about the format. Omitting parameters defines a function with an
-         * empty parameter list.
-         */
-        interface Parameters {
-            /**
-             * The value of properties is an object, where each key is the name of a property
-             * and each value is a schema used to validate that property.
-             */
-            properties: {
-                [key: string]: unknown;
-            };
+        interface SkipResponseEdge {
             /**
-             * Type must be "object" for a JSON Schema object.
+             * Unique identifier for the edge
              */
-            type: 'object';
+            id: string;
+            transition_condition: SkipResponseEdge.PromptCondition | SkipResponseEdge.EquationCondition | SkipResponseEdge.UnionMember2;
             /**
-             * List of names of required property when generating this parameter. LLM will do
-             * its best to generate the required properties in its function arguments. Property
-             * must exist in properties.
+             * ID of the destination node
              */
-            required?: Array<string>;
+            destination_node_id?: string;
+        }
+        namespace SkipResponseEdge {
+            interface PromptCondition {
+                /**
+                 * Prompt condition text
+                 */
+                prompt: string;
+                type: 'prompt';
+            }
+            interface EquationCondition {
+                equations: Array<EquationCondition.Equation>;
+                operator: '||' | '&&';
+                type: 'equation';
+                /**
+                 * Must be "Skip response" for skip response edge
+                 */
+                prompt?: 'Skip response';
+            }
+            namespace EquationCondition {
+                interface Equation {
+                    /**
+                     * Left side of the equation
+                     */
+                    left: string;
+                    operator: '==' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'not_contains' | 'exists' | 'not_exist';
+                    /**
+                     * Right side of the equation. The right side of the equation not required when
+                     * "exists" or "not_exist" are selected.
+                     */
+                    right?: string;
+                }
+            }
+            interface UnionMember2 {
+                /**
+                 * Must be "Skip response" for skip response edge
+                 */
+                prompt: 'Skip response';
+                type: 'prompt';
+            }
         }
     }
-    interface CheckAvailabilityCalTool {
-        /**
-         * Cal.com Api key that have access to the cal.com event you want to check
-         * availability for.
-         */
-        cal_api_key: string;
-        /**
-         * Cal.com event type id number for the cal.com event you want to check
-         * availability for. Can be a number or a dynamic variable in the format
-         * `{{variable_name}}` that will be resolved at runtime.
-         */
-        event_type_id: number | string;
-        /**
-         * Name of the tool. Must be unique within all tools available to LLM at any given
-         * time (general tools + state tools + state transitions). Must be consisted of
-         * a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64
-         * (no space allowed).
-         */
-        name: string;
-        type: 'check_availability_cal';
-        /**
-         * Describes what the tool does, sometimes can also include information about when
-         * to call the tool.
-         */
-        description?: string;
-        /**
-         * Timezone to be used when checking availability, must be in
-         * [IANA timezone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
-         * Can also be a dynamic variable in the format `{{variable_name}}` that will be
-         * resolved at runtime. If not specified, will check if user specified timezone in
-         * call, and if not, will use the timezone of the Retell servers.
-         */
-        timezone?: string;
-        /**
-         * Unique identifier for the tool
-         */
-        tool_id?: string;
-    }
-    interface BookAppointmentCalTool {
-        /**
-         * Cal.com Api key that have access to the cal.com event you want to book
-         * appointment.
-         */
-        cal_api_key: string;
-        /**
-         * Cal.com event type id number for the cal.com event you want to book appointment.
-         * Can be a number or a dynamic variable in the format `{{variable_name}}` that
-         * will be resolved at runtime.
-         */
-        event_type_id: number | string;
-        /**
-         * Name of the tool. Must be unique within all tools available to LLM at any given
-         * time (general tools + state tools + state transitions). Must be consisted of
-         * a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64
-         * (no space allowed).
-         */
-        name: string;
-        type: 'book_appointment_cal';
-        /**
-         * Describes what the tool does, sometimes can also include information about when
-         * to call the tool.
-         */
-        description?: string;
-        /**
-         * Timezone to be used when booking appointment, must be in
-         * [IANA timezone database](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
-         * Can also be a dynamic variable in the format `{{variable_name}}` that will be
-         * resolved at runtime. If not specified, will check if user specified timezone in
-         * call, and if not, will use the timezone of the Retell servers.
-         */
-        timezone?: string;
-        /**
-         * Unique identifier for the tool
-         */
-        tool_id?: string;
-    }
-}
-export interface ConversationFlowComponentUpdateParams {
-    /**
-     * Display position for the begin tag in the frontend
-     */
-    begin_tag_display_position?: ConversationFlowComponentUpdateParams.BeginTagDisplayPosition | null;
-    /**
-     * A list of MCP server configurations to use for this component
-     */
-    mcps?: Array<ConversationFlowComponentUpdateParams.Mcp> | null;
-    /**
-     * Name of the component
-     */
-    name?: string;
-    /**
-     * Nodes that make up the component
-     */
-    nodes?: Array<ConversationFlowComponentUpdateParams.ConversationNode | ConversationFlowComponentUpdateParams.EndNode | ConversationFlowComponentUpdateParams.FunctionNode | ConversationFlowComponentUpdateParams.CodeNode | ConversationFlowComponentUpdateParams.TransferCallNode | ConversationFlowComponentUpdateParams.PressDigitNode | ConversationFlowComponentUpdateParams.BranchNode | ConversationFlowComponentUpdateParams.SMSNode | ConversationFlowComponentUpdateParams.ExtractDynamicVariablesNode | ConversationFlowComponentUpdateParams.AgentSwapNode | ConversationFlowComponentUpdateParams.McpNode | ConversationFlowComponentUpdateParams.ComponentNode | ConversationFlowComponentUpdateParams.BridgeTransferNode | ConversationFlowComponentUpdateParams.CancelTransferNode>;
-    /**
-     * ID of the starting node
-     */
-    start_node_id?: string | null;
-    /**
-     * Tools available within the component
-     */
-    tools?: Array<ConversationFlowComponentUpdateParams.CustomTool | ConversationFlowComponentUpdateParams.CheckAvailabilityCalTool | ConversationFlowComponentUpdateParams.BookAppointmentCalTool> | null;
-}
-export declare namespace ConversationFlowComponentUpdateParams {
-    /**
-     * Display position for the begin tag in the frontend
-     */
-    interface BeginTagDisplayPosition {
-        x?: number;
-        y?: number;
-    }
-    interface Mcp {
-        name: string;
-        /**
-         * The URL of the MCP server.
-         */
-        url: string;
-        /**
-         * Headers to add to the MCP connection request.
-         */
-        headers?: {
-            [key: string]: string;
-        };
-        /**
-         * Query parameters to append to the MCP connection request URL.
-         */
-        query_params?: {
-            [key: string]: string;
-        };
-        /**
-         * Maximum time to wait for a connection to be established (in milliseconds).
-         * Default to 120,000 ms (2 minutes).
-         */
-        timeout_ms?: number;
-    }
-    interface ConversationNode {
+    interface SubagentNode {
         /**
          * Unique identifier for the node
          */
         id: string;
-        instruction: ConversationNode.NodeInstructionPrompt | ConversationNode.NodeInstructionStaticText;
+        instruction: SubagentNode.Instruction;
         /**
          * Type of the node
          */
-        type: 'conversation';
-        always_edge?: ConversationNode.AlwaysEdge;
+        type: 'subagent';
+        always_edge?: SubagentNode.AlwaysEdge;
         /**
          * Position for frontend display
          */
-        display_position?: ConversationNode.DisplayPosition;
-        edges?: Array<ConversationNode.Edge>;
-        finetune_conversation_examples?: Array<ConversationNode.FinetuneConversationExample>;
-        finetune_transition_examples?: Array<ConversationNode.FinetuneTransitionExample>;
-        global_node_setting?: ConversationNode.GlobalNodeSetting;
+        display_position?: SubagentNode.DisplayPosition;
+        edges?: Array<SubagentNode.Edge>;
+        finetune_conversation_examples?: Array<SubagentNode.FinetuneConversationExample>;
+        finetune_transition_examples?: Array<SubagentNode.FinetuneTransitionExample>;
+        global_node_setting?: SubagentNode.GlobalNodeSetting;
         interruption_sensitivity?: number | null;
         /**
          * Knowledge base IDs for RAG (Retrieval-Augmented Generation).
          */
         knowledge_base_ids?: Array<string> | null;
-        model_choice?: ConversationNode.ModelChoice;
+        model_choice?: SubagentNode.ModelChoice;
         /**
          * Optional name for display purposes
          */
         name?: string;
         responsiveness?: number | null;
-        skip_response_edge?: ConversationNode.SkipResponseEdge;
+        skip_response_edge?: SubagentNode.SkipResponseEdge;
         /**
          * The tool ids of the tools defined in main conversation flow or component that
-         * can be used in this conversation node.
+         * can be used in this subagent node.
          */
         tool_ids?: Array<string> | null;
         /**
-         * The tools owned by this conversation node. This includes other tool types like
+         * The tools owned by this subagent node. This includes other tool types like
          * transfer_call, agent_swap, etc.
          */
-        tools?: Array<ConversationNode.EndCallTool | ConversationNode.TransferCallTool | ConversationNode.CheckAvailabilityCalTool | ConversationNode.BookAppointmentCalTool | ConversationNode.AgentSwapTool | ConversationNode.PressDigitTool | ConversationNode.SendSMSTool | ConversationNode.CustomTool | ConversationNode.CodeTool | ConversationNode.ExtractDynamicVariableTool | ConversationNode.BridgeTransferTool | ConversationNode.CancelTransferTool | ConversationNode.McpTool> | null;
+        tools?: Array<SubagentNode.EndCallTool | SubagentNode.TransferCallTool | SubagentNode.CheckAvailabilityCalTool | SubagentNode.BookAppointmentCalTool | SubagentNode.AgentSwapTool | SubagentNode.PressDigitTool | SubagentNode.SendSMSTool | SubagentNode.CustomTool | SubagentNode.CodeTool | SubagentNode.ExtractDynamicVariableTool | SubagentNode.BridgeTransferTool | SubagentNode.CancelTransferTool | SubagentNode.McpTool> | null;
         voice_speed?: number | null;
     }
-    namespace ConversationNode {
-        interface NodeInstructionPrompt {
+    namespace SubagentNode {
+        interface Instruction {
             /**
              * The prompt text for the instruction
              */
@@ -10628,16 +11972,6 @@ export declare namespace ConversationFlowComponentUpdateParams {
              */
             type: 'prompt';
         }
-        interface NodeInstructionStaticText {
-            /**
-             * The static text for the instruction
-             */
-            text: string;
-            /**
-             * Type of instruction
-             */
-            type: 'static_text';
-        }
         interface AlwaysEdge {
             /**
              * Unique identifier for the edge
@@ -11429,6 +12763,23 @@ export declare namespace ConversationFlowComponentUpdateParams {
              * to call the tool.
              */
             description?: string;
+            /**
+             * Describes what to say before sending the SMS. Only applicable when
+             * speak_during_execution is true.
+             */
+            execution_message_description?: string;
+            /**
+             * Type of execution message. "prompt" means the agent will use
+             * execution_message_description as a prompt to generate the message. "static_text"
+             * means the agent will speak the execution_message_description directly. Defaults
+             * to "prompt".
+             */
+            execution_message_type?: 'prompt' | 'static_text';
+            /**
+             * If true, the agent will speak a short line before sending the SMS. If omitted,
+             * defaults to true (same as end_call / transfer_call tools).
+             */
+            speak_during_execution?: boolean;
         }
         namespace SendSMSTool {
             interface SMSContentPredefined {
@@ -11649,6 +13000,12 @@ export declare namespace ConversationFlowComponentUpdateParams {
                  * Type of the variable to extract.
                  */
                 type: 'string';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Examples of the variable value to teach model the style and syntax.
                  */
@@ -11676,6 +13033,12 @@ export declare namespace ConversationFlowComponentUpdateParams {
                  * Type of the variable to extract.
                  */
                 type: 'enum';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Whether this data is required. If true and the data is not extracted, the call
                  * will be marked as unsuccessful.
@@ -11695,6 +13058,12 @@ export declare namespace ConversationFlowComponentUpdateParams {
                  * Type of the variable to extract.
                  */
                 type: 'boolean';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Whether this data is required. If true and the data is not extracted, the call
                  * will be marked as unsuccessful.
@@ -11714,6 +13083,12 @@ export declare namespace ConversationFlowComponentUpdateParams {
                  * Type of the variable to extract.
                  */
                 type: 'number';
+                /**
+                 * Optional instruction to help decide whether this field needs to be populated in
+                 * the analysis. If not set, the field is always included. If required is true,
+                 * this is ignored.
+                 */
+                conditional_prompt?: string;
                 /**
                  * Whether this data is required. If true and the data is not extracted, the call
                  * will be marked as unsuccessful.
@@ -13975,6 +15350,12 @@ export declare namespace ConversationFlowComponentUpdateParams {
              * Type of the variable to extract.
              */
             type: 'string';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Examples of the variable value to teach model the style and syntax.
              */
@@ -14002,6 +15383,12 @@ export declare namespace ConversationFlowComponentUpdateParams {
              * Type of the variable to extract.
              */
             type: 'enum';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Whether this data is required. If true and the data is not extracted, the call
              * will be marked as unsuccessful.
@@ -14021,6 +15408,12 @@ export declare namespace ConversationFlowComponentUpdateParams {
              * Type of the variable to extract.
              */
             type: 'boolean';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Whether this data is required. If true and the data is not extracted, the call
              * will be marked as unsuccessful.
@@ -14040,6 +15433,12 @@ export declare namespace ConversationFlowComponentUpdateParams {
              * Type of the variable to extract.
              */
             type: 'number';
+            /**
+             * Optional instruction to help decide whether this field needs to be populated in
+             * the analysis. If not set, the field is always included. If required is true,
+             * this is ignored.
+             */
+            conditional_prompt?: string;
             /**
              * Whether this data is required. If true and the data is not extracted, the call
              * will be marked as unsuccessful.
@@ -15535,6 +16934,41 @@ export declare namespace ConversationFlowComponentUpdateParams {
             high_priority?: boolean;
         }
     }
+    interface Note {
+        /**
+         * Unique identifier for the note.
+         */
+        id: string;
+        /**
+         * Text content of the note, can contain refs to images in the format
+         * "<image:asset_id>"
+         */
+        content: string;
+        /**
+         * Position of the note on the canvas.
+         */
+        display_position: Note.DisplayPosition;
+        /**
+         * Dimensions of the note on the canvas.
+         */
+        size: Note.Size;
+    }
+    namespace Note {
+        /**
+         * Position of the note on the canvas.
+         */
+        interface DisplayPosition {
+            x?: number;
+            y?: number;
+        }
+        /**
+         * Dimensions of the note on the canvas.
+         */
+        interface Size {
+            height?: number;
+            width?: number;
+        }
+    }
     interface CustomTool {
         /**
          * Name of the tool. Must be unique within all tools available to LLM at any given