retell-sdk 4.38.0 → 4.40.0

package/src/resources/llm.ts

@@ -151,6 +151,9 @@ export interface LlmResponse {
     | LlmResponse.PressDigitTool
     | LlmResponse.CustomTool
     | LlmResponse.ExtractDynamicVariableTool
+    | LlmResponse.AgentSwapTool
+    | LlmResponse.McpTool
+    | LlmResponse.SendSMSTool
   > | null;
 
   /**
@@ -180,9 +183,9 @@ export interface LlmResponse {
     | null;
 
   /**
-   * If set to true, will use high priority pool with more dedicated resource to
-   * ensure lower and more consistent latency, default to false. This feature usually
-   * comes with a higher cost.
+   * If set to true, will enable fast tier, which uses high priority pool with more
+   * dedicated resource to ensure lower and more consistent latency, default to
+   * false. This feature usually comes with a higher cost.
    */
   model_high_priority?: boolean;
 
@@ -325,6 +328,37 @@ export namespace LlmResponse {
        */
       type: 'warm_transfer';
 
+      /**
+       * The time to wait before considering transfer fails.
+       */
+      agent_detection_timeout_ms?: number;
+
+      /**
+       * 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 to true, AI will not say "Hello" after connecting the call. Default to
+       * false.
+       */
+      opt_out_initial_message?: 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
@@ -353,6 +387,24 @@ export namespace LlmResponse {
 
         type?: 'static_message';
       }
+
+      export interface WarmTransferPrompt {
+        /**
+         * The prompt to be used for warm handoff. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'prompt';
+      }
+
+      export interface WarmTransferStaticMessage {
+        /**
+         * The static message to be used for warm handoff. Can contain dynamic variables.
+         */
+        message?: string;
+
+        type?: 'static_message';
+      }
     }
   }
 
@@ -676,6 +728,106 @@ export namespace LlmResponse {
     }
   }
 
+  export interface AgentSwapTool {
+    /**
+     * The id of the agent to swap to.
+     */
+    agent_id: string;
+
+    /**
+     * 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;
+
+    type: 'agent_swap';
+
+    /**
+     * The version of the agent to swap to. If not specified, will use the latest
+     * version.
+     */
+    agent_version?: number;
+
+    /**
+     * Describes what the tool does, sometimes can also include information about when
+     * to call the tool.
+     */
+    description?: string;
+
+    /**
+     * The message for the agent to speak when executing agent swap.
+     */
+    execution_message_description?: string;
+
+    post_call_analysis_setting?: 'both_agents' | 'only_destination_agent';
+
+    speak_during_execution?: boolean;
+  }
+
+  export interface McpTool {
+    /**
+     * Description of the MCP tool.
+     */
+    description: string;
+
+    /**
+     * Name of the MCP tool.
+     */
+    name: string;
+
+    type: 'mcp';
+
+    /**
+     * The input schema of the MCP tool.
+     */
+    input_schema?: { [key: string]: string };
+
+    /**
+     * Unique id of the MCP.
+     */
+    mcp_id?: string;
+  }
+
+  export interface SendSMSTool {
+    /**
+     * 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;
+
+    sms_content: SendSMSTool.SMSContentPredefined | SendSMSTool.SMSContentInferred;
+
+    type: 'send_sms';
+
+    /**
+     * Describes what the tool does, sometimes can also include information about when
+     * to call the tool.
+     */
+    description?: string;
+  }
+
+  export namespace SendSMSTool {
+    export interface SMSContentPredefined {
+      /**
+       * The static message to be sent in the SMS. Can contain dynamic variables.
+       */
+      content?: string;
+
+      type?: 'predefined';
+    }
+
+    export interface SMSContentInferred {
+      /**
+       * The prompt to be used to help infer the SMS content. The model will take the
+       * global prompt, the call transcript, and this prompt together to deduce the right
+       * message to send. Can contain dynamic variables.
+       */
+      prompt?: string;
+
+      type?: 'inferred';
+    }
+  }
+
   export interface State {
     /**
      * Name of the state, must be unique for each state. Must be consisted of a-z, A-Z,
@@ -712,6 +864,9 @@ export namespace LlmResponse {
       | State.PressDigitTool
       | State.CustomTool
       | State.ExtractDynamicVariableTool
+      | State.AgentSwapTool
+      | State.McpTool
+      | State.SendSMSTool
     >;
   }
 
@@ -868,6 +1023,37 @@ export namespace LlmResponse {
          */
         type: 'warm_transfer';
 
+        /**
+         * The time to wait before considering transfer fails.
+         */
+        agent_detection_timeout_ms?: number;
+
+        /**
+         * 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 to true, AI will not say "Hello" after connecting the call. Default to
+         * false.
+         */
+        opt_out_initial_message?: 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
@@ -896,6 +1082,24 @@ export namespace LlmResponse {
 
           type?: 'static_message';
         }
+
+        export interface WarmTransferPrompt {
+          /**
+           * The prompt to be used for warm handoff. Can contain dynamic variables.
+           */
+          prompt?: string;
+
+          type?: 'prompt';
+        }
+
+        export interface WarmTransferStaticMessage {
+          /**
+           * The static message to be used for warm handoff. Can contain dynamic variables.
+           */
+          message?: string;
+
+          type?: 'static_message';
+        }
       }
     }
 
@@ -1218,6 +1422,106 @@ export namespace LlmResponse {
         type: 'number';
       }
     }
+
+    export interface AgentSwapTool {
+      /**
+       * The id of the agent to swap to.
+       */
+      agent_id: string;
+
+      /**
+       * 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;
+
+      type: 'agent_swap';
+
+      /**
+       * The version of the agent to swap to. If not specified, will use the latest
+       * version.
+       */
+      agent_version?: number;
+
+      /**
+       * Describes what the tool does, sometimes can also include information about when
+       * to call the tool.
+       */
+      description?: string;
+
+      /**
+       * The message for the agent to speak when executing agent swap.
+       */
+      execution_message_description?: string;
+
+      post_call_analysis_setting?: 'both_agents' | 'only_destination_agent';
+
+      speak_during_execution?: boolean;
+    }
+
+    export interface McpTool {
+      /**
+       * Description of the MCP tool.
+       */
+      description: string;
+
+      /**
+       * Name of the MCP tool.
+       */
+      name: string;
+
+      type: 'mcp';
+
+      /**
+       * The input schema of the MCP tool.
+       */
+      input_schema?: { [key: string]: string };
+
+      /**
+       * Unique id of the MCP.
+       */
+      mcp_id?: string;
+    }
+
+    export interface SendSMSTool {
+      /**
+       * 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;
+
+      sms_content: SendSMSTool.SMSContentPredefined | SendSMSTool.SMSContentInferred;
+
+      type: 'send_sms';
+
+      /**
+       * Describes what the tool does, sometimes can also include information about when
+       * to call the tool.
+       */
+      description?: string;
+    }
+
+    export namespace SendSMSTool {
+      export interface SMSContentPredefined {
+        /**
+         * The static message to be sent in the SMS. Can contain dynamic variables.
+         */
+        content?: string;
+
+        type?: 'predefined';
+      }
+
+      export interface SMSContentInferred {
+        /**
+         * The prompt to be used to help infer the SMS content. The model will take the
+         * global prompt, the call transcript, and this prompt together to deduce the right
+         * message to send. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'inferred';
+      }
+    }
   }
 }
 
@@ -1263,6 +1567,9 @@ export interface LlmCreateParams {
     | LlmCreateParams.PressDigitTool
     | LlmCreateParams.CustomTool
     | LlmCreateParams.ExtractDynamicVariableTool
+    | LlmCreateParams.AgentSwapTool
+    | LlmCreateParams.McpTool
+    | LlmCreateParams.SendSMSTool
   > | null;
 
   /**
@@ -1287,9 +1594,9 @@ export interface LlmCreateParams {
     | null;
 
   /**
-   * If set to true, will use high priority pool with more dedicated resource to
-   * ensure lower and more consistent latency, default to false. This feature usually
-   * comes with a higher cost.
+   * If set to true, will enable fast tier, which uses high priority pool with more
+   * dedicated resource to ensure lower and more consistent latency, default to
+   * false. This feature usually comes with a higher cost.
    */
   model_high_priority?: boolean;
 
@@ -1432,6 +1739,37 @@ export namespace LlmCreateParams {
        */
       type: 'warm_transfer';
 
+      /**
+       * The time to wait before considering transfer fails.
+       */
+      agent_detection_timeout_ms?: number;
+
+      /**
+       * 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 to true, AI will not say "Hello" after connecting the call. Default to
+       * false.
+       */
+      opt_out_initial_message?: 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
@@ -1460,6 +1798,24 @@ export namespace LlmCreateParams {
 
         type?: 'static_message';
       }
+
+      export interface WarmTransferPrompt {
+        /**
+         * The prompt to be used for warm handoff. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'prompt';
+      }
+
+      export interface WarmTransferStaticMessage {
+        /**
+         * The static message to be used for warm handoff. Can contain dynamic variables.
+         */
+        message?: string;
+
+        type?: 'static_message';
+      }
     }
   }
 
@@ -1783,23 +2139,123 @@ export namespace LlmCreateParams {
     }
   }
 
-  export interface State {
+  export interface AgentSwapTool {
     /**
-     * Name of the state, must be unique for each state. 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 id of the agent to swap to.
      */
-    name: string;
+    agent_id: string;
 
     /**
-     * Edges of the state define how and what state can be reached from this state.
+     * Name of the tool. Must be unique within all tools available to LLM at any given
+     * time (general tools + state tools + state edges).
      */
-    edges?: Array<State.Edge>;
+    name: string;
+
+    type: 'agent_swap';
 
     /**
-     * Prompt of the state, will be appended to the system prompt of LLM.
-     *
-     * - System prompt = general prompt + state prompt.
+     * The version of the agent to swap to. If not specified, will use the latest
+     * version.
+     */
+    agent_version?: number;
+
+    /**
+     * Describes what the tool does, sometimes can also include information about when
+     * to call the tool.
+     */
+    description?: string;
+
+    /**
+     * The message for the agent to speak when executing agent swap.
+     */
+    execution_message_description?: string;
+
+    post_call_analysis_setting?: 'both_agents' | 'only_destination_agent';
+
+    speak_during_execution?: boolean;
+  }
+
+  export interface McpTool {
+    /**
+     * Description of the MCP tool.
+     */
+    description: string;
+
+    /**
+     * Name of the MCP tool.
+     */
+    name: string;
+
+    type: 'mcp';
+
+    /**
+     * The input schema of the MCP tool.
+     */
+    input_schema?: { [key: string]: string };
+
+    /**
+     * Unique id of the MCP.
+     */
+    mcp_id?: string;
+  }
+
+  export interface SendSMSTool {
+    /**
+     * 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;
+
+    sms_content: SendSMSTool.SMSContentPredefined | SendSMSTool.SMSContentInferred;
+
+    type: 'send_sms';
+
+    /**
+     * Describes what the tool does, sometimes can also include information about when
+     * to call the tool.
+     */
+    description?: string;
+  }
+
+  export namespace SendSMSTool {
+    export interface SMSContentPredefined {
+      /**
+       * The static message to be sent in the SMS. Can contain dynamic variables.
+       */
+      content?: string;
+
+      type?: 'predefined';
+    }
+
+    export interface SMSContentInferred {
+      /**
+       * The prompt to be used to help infer the SMS content. The model will take the
+       * global prompt, the call transcript, and this prompt together to deduce the right
+       * message to send. Can contain dynamic variables.
+       */
+      prompt?: string;
+
+      type?: 'inferred';
+    }
+  }
+
+  export interface State {
+    /**
+     * Name of the state, must be unique for each state. 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;
+
+    /**
+     * Edges of the state define how and what state can be reached from this state.
+     */
+    edges?: Array<State.Edge>;
+
+    /**
+     * Prompt of the state, will be appended to the system prompt of LLM.
+     *
+     * - System prompt = general prompt + state prompt.
      */
     state_prompt?: string;
 
@@ -1819,6 +2275,9 @@ export namespace LlmCreateParams {
       | State.PressDigitTool
       | State.CustomTool
       | State.ExtractDynamicVariableTool
+      | State.AgentSwapTool
+      | State.McpTool
+      | State.SendSMSTool
     >;
   }
 
@@ -1975,6 +2434,37 @@ export namespace LlmCreateParams {
          */
         type: 'warm_transfer';
 
+        /**
+         * The time to wait before considering transfer fails.
+         */
+        agent_detection_timeout_ms?: number;
+
+        /**
+         * 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 to true, AI will not say "Hello" after connecting the call. Default to
+         * false.
+         */
+        opt_out_initial_message?: 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
@@ -2003,6 +2493,24 @@ export namespace LlmCreateParams {
 
           type?: 'static_message';
         }
+
+        export interface WarmTransferPrompt {
+          /**
+           * The prompt to be used for warm handoff. Can contain dynamic variables.
+           */
+          prompt?: string;
+
+          type?: 'prompt';
+        }
+
+        export interface WarmTransferStaticMessage {
+          /**
+           * The static message to be used for warm handoff. Can contain dynamic variables.
+           */
+          message?: string;
+
+          type?: 'static_message';
+        }
       }
     }
 
@@ -2325,6 +2833,106 @@ export namespace LlmCreateParams {
         type: 'number';
       }
     }
+
+    export interface AgentSwapTool {
+      /**
+       * The id of the agent to swap to.
+       */
+      agent_id: string;
+
+      /**
+       * 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;
+
+      type: 'agent_swap';
+
+      /**
+       * The version of the agent to swap to. If not specified, will use the latest
+       * version.
+       */
+      agent_version?: number;
+
+      /**
+       * Describes what the tool does, sometimes can also include information about when
+       * to call the tool.
+       */
+      description?: string;
+
+      /**
+       * The message for the agent to speak when executing agent swap.
+       */
+      execution_message_description?: string;
+
+      post_call_analysis_setting?: 'both_agents' | 'only_destination_agent';
+
+      speak_during_execution?: boolean;
+    }
+
+    export interface McpTool {
+      /**
+       * Description of the MCP tool.
+       */
+      description: string;
+
+      /**
+       * Name of the MCP tool.
+       */
+      name: string;
+
+      type: 'mcp';
+
+      /**
+       * The input schema of the MCP tool.
+       */
+      input_schema?: { [key: string]: string };
+
+      /**
+       * Unique id of the MCP.
+       */
+      mcp_id?: string;
+    }
+
+    export interface SendSMSTool {
+      /**
+       * 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;
+
+      sms_content: SendSMSTool.SMSContentPredefined | SendSMSTool.SMSContentInferred;
+
+      type: 'send_sms';
+
+      /**
+       * Describes what the tool does, sometimes can also include information about when
+       * to call the tool.
+       */
+      description?: string;
+    }
+
+    export namespace SendSMSTool {
+      export interface SMSContentPredefined {
+        /**
+         * The static message to be sent in the SMS. Can contain dynamic variables.
+         */
+        content?: string;
+
+        type?: 'predefined';
+      }
+
+      export interface SMSContentInferred {
+        /**
+         * The prompt to be used to help infer the SMS content. The model will take the
+         * global prompt, the call transcript, and this prompt together to deduce the right
+         * message to send. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'inferred';
+      }
+    }
   }
 }
 
@@ -2384,6 +2992,9 @@ export interface LlmUpdateParams {
     | LlmUpdateParams.PressDigitTool
     | LlmUpdateParams.CustomTool
     | LlmUpdateParams.ExtractDynamicVariableTool
+    | LlmUpdateParams.AgentSwapTool
+    | LlmUpdateParams.McpTool
+    | LlmUpdateParams.SendSMSTool
   > | null;
 
   /**
@@ -2408,9 +3019,9 @@ export interface LlmUpdateParams {
     | null;
 
   /**
-   * Body param: If set to true, will use high priority pool with more dedicated
-   * resource to ensure lower and more consistent latency, default to false. This
-   * feature usually comes with a higher cost.
+   * Body param: If set to true, will enable fast tier, which uses high priority pool
+   * with more dedicated resource to ensure lower and more consistent latency,
+   * default to false. This feature usually comes with a higher cost.
    */
   model_high_priority?: boolean;
 
@@ -2553,6 +3164,37 @@ export namespace LlmUpdateParams {
        */
       type: 'warm_transfer';
 
+      /**
+       * The time to wait before considering transfer fails.
+       */
+      agent_detection_timeout_ms?: number;
+
+      /**
+       * 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 to true, AI will not say "Hello" after connecting the call. Default to
+       * false.
+       */
+      opt_out_initial_message?: 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
@@ -2581,6 +3223,24 @@ export namespace LlmUpdateParams {
 
         type?: 'static_message';
       }
+
+      export interface WarmTransferPrompt {
+        /**
+         * The prompt to be used for warm handoff. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'prompt';
+      }
+
+      export interface WarmTransferStaticMessage {
+        /**
+         * The static message to be used for warm handoff. Can contain dynamic variables.
+         */
+        message?: string;
+
+        type?: 'static_message';
+      }
     }
   }
 
@@ -2904,6 +3564,106 @@ export namespace LlmUpdateParams {
     }
   }
 
+  export interface AgentSwapTool {
+    /**
+     * The id of the agent to swap to.
+     */
+    agent_id: string;
+
+    /**
+     * 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;
+
+    type: 'agent_swap';
+
+    /**
+     * The version of the agent to swap to. If not specified, will use the latest
+     * version.
+     */
+    agent_version?: number;
+
+    /**
+     * Describes what the tool does, sometimes can also include information about when
+     * to call the tool.
+     */
+    description?: string;
+
+    /**
+     * The message for the agent to speak when executing agent swap.
+     */
+    execution_message_description?: string;
+
+    post_call_analysis_setting?: 'both_agents' | 'only_destination_agent';
+
+    speak_during_execution?: boolean;
+  }
+
+  export interface McpTool {
+    /**
+     * Description of the MCP tool.
+     */
+    description: string;
+
+    /**
+     * Name of the MCP tool.
+     */
+    name: string;
+
+    type: 'mcp';
+
+    /**
+     * The input schema of the MCP tool.
+     */
+    input_schema?: { [key: string]: string };
+
+    /**
+     * Unique id of the MCP.
+     */
+    mcp_id?: string;
+  }
+
+  export interface SendSMSTool {
+    /**
+     * 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;
+
+    sms_content: SendSMSTool.SMSContentPredefined | SendSMSTool.SMSContentInferred;
+
+    type: 'send_sms';
+
+    /**
+     * Describes what the tool does, sometimes can also include information about when
+     * to call the tool.
+     */
+    description?: string;
+  }
+
+  export namespace SendSMSTool {
+    export interface SMSContentPredefined {
+      /**
+       * The static message to be sent in the SMS. Can contain dynamic variables.
+       */
+      content?: string;
+
+      type?: 'predefined';
+    }
+
+    export interface SMSContentInferred {
+      /**
+       * The prompt to be used to help infer the SMS content. The model will take the
+       * global prompt, the call transcript, and this prompt together to deduce the right
+       * message to send. Can contain dynamic variables.
+       */
+      prompt?: string;
+
+      type?: 'inferred';
+    }
+  }
+
   export interface State {
     /**
      * Name of the state, must be unique for each state. Must be consisted of a-z, A-Z,
@@ -2940,6 +3700,9 @@ export namespace LlmUpdateParams {
       | State.PressDigitTool
       | State.CustomTool
       | State.ExtractDynamicVariableTool
+      | State.AgentSwapTool
+      | State.McpTool
+      | State.SendSMSTool
     >;
   }
 
@@ -3096,6 +3859,37 @@ export namespace LlmUpdateParams {
          */
         type: 'warm_transfer';
 
+        /**
+         * The time to wait before considering transfer fails.
+         */
+        agent_detection_timeout_ms?: number;
+
+        /**
+         * 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 to true, AI will not say "Hello" after connecting the call. Default to
+         * false.
+         */
+        opt_out_initial_message?: 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
@@ -3124,6 +3918,24 @@ export namespace LlmUpdateParams {
 
           type?: 'static_message';
         }
+
+        export interface WarmTransferPrompt {
+          /**
+           * The prompt to be used for warm handoff. Can contain dynamic variables.
+           */
+          prompt?: string;
+
+          type?: 'prompt';
+        }
+
+        export interface WarmTransferStaticMessage {
+          /**
+           * The static message to be used for warm handoff. Can contain dynamic variables.
+           */
+          message?: string;
+
+          type?: 'static_message';
+        }
       }
     }
 
@@ -3446,6 +4258,106 @@ export namespace LlmUpdateParams {
         type: 'number';
       }
     }
+
+    export interface AgentSwapTool {
+      /**
+       * The id of the agent to swap to.
+       */
+      agent_id: string;
+
+      /**
+       * 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;
+
+      type: 'agent_swap';
+
+      /**
+       * The version of the agent to swap to. If not specified, will use the latest
+       * version.
+       */
+      agent_version?: number;
+
+      /**
+       * Describes what the tool does, sometimes can also include information about when
+       * to call the tool.
+       */
+      description?: string;
+
+      /**
+       * The message for the agent to speak when executing agent swap.
+       */
+      execution_message_description?: string;
+
+      post_call_analysis_setting?: 'both_agents' | 'only_destination_agent';
+
+      speak_during_execution?: boolean;
+    }
+
+    export interface McpTool {
+      /**
+       * Description of the MCP tool.
+       */
+      description: string;
+
+      /**
+       * Name of the MCP tool.
+       */
+      name: string;
+
+      type: 'mcp';
+
+      /**
+       * The input schema of the MCP tool.
+       */
+      input_schema?: { [key: string]: string };
+
+      /**
+       * Unique id of the MCP.
+       */
+      mcp_id?: string;
+    }
+
+    export interface SendSMSTool {
+      /**
+       * 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;
+
+      sms_content: SendSMSTool.SMSContentPredefined | SendSMSTool.SMSContentInferred;
+
+      type: 'send_sms';
+
+      /**
+       * Describes what the tool does, sometimes can also include information about when
+       * to call the tool.
+       */
+      description?: string;
+    }
+
+    export namespace SendSMSTool {
+      export interface SMSContentPredefined {
+        /**
+         * The static message to be sent in the SMS. Can contain dynamic variables.
+         */
+        content?: string;
+
+        type?: 'predefined';
+      }
+
+      export interface SMSContentInferred {
+        /**
+         * The prompt to be used to help infer the SMS content. The model will take the
+         * global prompt, the call transcript, and this prompt together to deduce the right
+         * message to send. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'inferred';
+      }
+    }
   }
 }