retell-sdk 6.0.1 → 6.1.1

package/resources/llm.d.ts

@@ -102,7 +102,7 @@ export interface LlmResponse {
      * - Tools of LLM (with state) = general tools + state tools + state transitions
      * - Tools of LLM (no state) = general tools
      */
-    general_tools?: Array<LlmResponse.EndCallTool | LlmResponse.TransferCallTool | LlmResponse.AgentSwapTool | LlmResponse.PressDigitTool | LlmResponse.SendSMSTool | LlmResponse.CustomTool | LlmResponse.CodeTool | LlmResponse.ExtractDynamicVariableTool | LlmResponse.BridgeTransferTool | LlmResponse.CancelTransferTool | LlmResponse.McpTool> | null;
+    general_tools?: Array<LlmResponse.EndCallTool | LlmResponse.TransferCallTool | LlmResponse.AgentSwapTool | LlmResponse.PressDigitTool | LlmResponse.SendSMSTool | LlmResponse.CustomTool | LlmResponse.CodeTool | LlmResponse.ExtractDynamicVariableTool | LlmResponse.BridgeTransferTool | LlmResponse.CancelTransferTool | LlmResponse.McpTool | LlmResponse.AppTool> | null;
     /**
      * Whether the Retell LLM Response Engine is published.
      */
@@ -127,7 +127,7 @@ export interface LlmResponse {
     /**
      * Select the underlying text LLM. If not set, would default to gpt-5.6-terra.
      */
-    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' | 'gpt-5.5' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-5-sonnet' | 'claude-4.5-haiku' | 'gemini-3.0-flash' | 'gemini-3.1-flash-lite' | 'gemini-3.5-flash' | 'gemini-3.5-flash-lite' | 'gemini-3.6-flash' | 'gemini-3.7-flash' | 'gemini-3.8-flash' | null;
+    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' | 'gpt-5.5' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-6-astra' | 'gpt-6-sol' | 'gpt-6.1-sol' | 'gpt-6-luna' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-5-opus' | 'claude-5.5-opus' | 'claude-5-sonnet' | 'claude-5.5-sonnet' | 'claude-4.5-haiku' | 'gemini-3.0-flash' | 'gemini-3.1-flash-lite' | 'gemini-3.5-flash' | 'gemini-3.5-flash-lite' | 'gemini-3.6-flash' | 'gemini-3.7-flash' | 'gemini-3.8-flash' | 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
@@ -183,6 +183,13 @@ export declare namespace LlmResponse {
          */
         name: string;
         type: 'end_call';
+        /**
+         * Custom SIP headers sent on the outgoing BYE when ending the call. Header names
+         * must start with X- or x-. Supports dynamic variables.
+         */
+        custom_sip_headers?: {
+            [key: string]: string;
+        };
         /**
          * Describes what the tool does, sometimes can also include information about when
          * to call the tool.
@@ -545,6 +552,13 @@ export declare namespace LlmResponse {
          */
         keep_current_voice?: boolean;
         speak_during_execution?: boolean;
+        /**
+         * If true, restart the max call duration timer at the swap using the destination
+         * agent's max_call_duration_ms, capped so the whole call never exceeds 2 hours.
+         * Otherwise, the timer already running is left unchanged. Voice calls only.
+         * Defaults to false.
+         */
+        use_swap_agent_max_duration?: boolean;
         /**
          * Webhook setting for the agent swap, defaults to only source.
          */
@@ -1085,6 +1099,135 @@ export declare namespace LlmResponse {
          */
         speak_during_execution?: boolean;
     }
+    interface AppTool {
+        /**
+         * The connection (App) this tool runs against. Must be a connection in the
+         * organization whose provider matches this tool's provider.
+         */
+        app_id: string;
+        /**
+         * Name of the catalog template within the provider, as listed by
+         * list-app-templates.
+         */
+        app_tool_template_name: string;
+        /**
+         * Name of the tool. Must be unique within the phase's tools; referenced by
+         * depends_on.
+         */
+        name: string;
+        /**
+         * Provider of the connection. Must match the connection's provider; supported
+         * providers are listed by list-app-templates.
+         */
+        provider: string;
+        type: 'integration_app';
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. Overrides the catalog template's LLM-facing description.
+         */
+        description?: string;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. If true, play a typing sound on the agent audio track while this
+         * tool is executing. Useful when the tool takes a noticeable amount of time to
+         * prevent silence on the call.
+         */
+        enable_typing_sound?: boolean;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. The message for the agent to speak when executing the tool. Only
+         * applicable when speak_during_execution is true.
+         */
+        execution_message_description?: string;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. 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';
+        /**
+         * What the agent and the transcript see of the tool's response. Omit to send the
+         * full response. Does not affect response_variables, which are always extracted
+         * from the raw response.
+         */
+        output_selection?: AppTool.UnionMember0 | AppTool.UnionMember1;
+        /**
+         * The resolved input parameters, in order. Properties may pin a value with const
+         * (including {{variable}} references) or provide a description for LLM inference.
+         * Each property may also record selected*input_mode, the editor mode the user
+         * selected ("const_enum", "const_boolean", "const_value", "description_custom", or
+         * "description_preset"); it is stored and returned as-is, used only by the tool
+         * config UI. Omit the key when no mode is recorded; when set, const*_ modes
+         * require a non-empty const, and description\__ modes must omit const entirely.
+         * Each parameter's required list must match the schema returned by the
+         * corresponding step of the get-app-tool-schema loop.
+         */
+        parameters?: Array<AppTool.Parameter>;
+        /**
+         * Mapping of a dynamic-variable name to the response field (dot-path) it is
+         * populated from. Missing paths are ignored.
+         */
+        response_variables?: {
+            [key: string]: string;
+        };
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. Determines whether the agent would call LLM another time and speak
+         * when the result of the tool is obtained.
+         */
+        speak_after_execution?: boolean;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. If true, will speak during execution.
+         */
+        speak_during_execution?: boolean;
+    }
+    namespace AppTool {
+        interface UnionMember0 {
+            mode: 'all';
+            /**
+             * Not used at runtime; stored and returned as-is for the UI.
+             */
+            fields?: Array<string>;
+        }
+        interface UnionMember1 {
+            /**
+             * The only response fields the agent and the transcript see, as dot-paths into the
+             * response schema returned by get-app-tool-schema. Everything else is dropped.
+             * Selecting a parent keeps its whole subtree. A plain segment traverses arrays
+             * element-wise (deals.properties.amount keeps that field on every deal), while
+             * key[n] selects one element (deals[0].id keeps only the first deal's id); paths
+             * that match nothing contribute nothing.
+             */
+            fields: Array<string>;
+            mode: 'subset';
+        }
+        /**
+         * 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 Parameter {
+            /**
+             * 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: 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>;
+        }
+    }
     /**
      * Knowledge base configuration for RAG retrieval.
      */
@@ -1147,7 +1290,7 @@ export declare namespace LlmResponse {
          *
          * - Tools of LLM = general tools + state tools + state transitions
          */
-        tools?: Array<State.EndCallTool | State.TransferCallTool | State.AgentSwapTool | State.PressDigitTool | State.SendSMSTool | State.CustomTool | State.CodeTool | State.ExtractDynamicVariableTool | State.BridgeTransferTool | State.CancelTransferTool | State.McpTool>;
+        tools?: Array<State.EndCallTool | State.TransferCallTool | State.AgentSwapTool | State.PressDigitTool | State.SendSMSTool | State.CustomTool | State.CodeTool | State.ExtractDynamicVariableTool | State.BridgeTransferTool | State.CancelTransferTool | State.McpTool | State.AppTool>;
     }
     namespace State {
         interface Edge {
@@ -1209,6 +1352,13 @@ export declare namespace LlmResponse {
              */
             name: string;
             type: 'end_call';
+            /**
+             * Custom SIP headers sent on the outgoing BYE when ending the call. Header names
+             * must start with X- or x-. Supports dynamic variables.
+             */
+            custom_sip_headers?: {
+                [key: string]: string;
+            };
             /**
              * Describes what the tool does, sometimes can also include information about when
              * to call the tool.
@@ -1571,6 +1721,13 @@ export declare namespace LlmResponse {
              */
             keep_current_voice?: boolean;
             speak_during_execution?: boolean;
+            /**
+             * If true, restart the max call duration timer at the swap using the destination
+             * agent's max_call_duration_ms, capped so the whole call never exceeds 2 hours.
+             * Otherwise, the timer already running is left unchanged. Voice calls only.
+             * Defaults to false.
+             */
+            use_swap_agent_max_duration?: boolean;
             /**
              * Webhook setting for the agent swap, defaults to only source.
              */
@@ -2111,6 +2268,135 @@ export declare namespace LlmResponse {
              */
             speak_during_execution?: boolean;
         }
+        interface AppTool {
+            /**
+             * The connection (App) this tool runs against. Must be a connection in the
+             * organization whose provider matches this tool's provider.
+             */
+            app_id: string;
+            /**
+             * Name of the catalog template within the provider, as listed by
+             * list-app-templates.
+             */
+            app_tool_template_name: string;
+            /**
+             * Name of the tool. Must be unique within the phase's tools; referenced by
+             * depends_on.
+             */
+            name: string;
+            /**
+             * Provider of the connection. Must match the connection's provider; supported
+             * providers are listed by list-app-templates.
+             */
+            provider: string;
+            type: 'integration_app';
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. Overrides the catalog template's LLM-facing description.
+             */
+            description?: string;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. If true, play a typing sound on the agent audio track while this
+             * tool is executing. Useful when the tool takes a noticeable amount of time to
+             * prevent silence on the call.
+             */
+            enable_typing_sound?: boolean;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. The message for the agent to speak when executing the tool. Only
+             * applicable when speak_during_execution is true.
+             */
+            execution_message_description?: string;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. 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';
+            /**
+             * What the agent and the transcript see of the tool's response. Omit to send the
+             * full response. Does not affect response_variables, which are always extracted
+             * from the raw response.
+             */
+            output_selection?: AppTool.UnionMember0 | AppTool.UnionMember1;
+            /**
+             * The resolved input parameters, in order. Properties may pin a value with const
+             * (including {{variable}} references) or provide a description for LLM inference.
+             * Each property may also record selected*input_mode, the editor mode the user
+             * selected ("const_enum", "const_boolean", "const_value", "description_custom", or
+             * "description_preset"); it is stored and returned as-is, used only by the tool
+             * config UI. Omit the key when no mode is recorded; when set, const*_ modes
+             * require a non-empty const, and description\__ modes must omit const entirely.
+             * Each parameter's required list must match the schema returned by the
+             * corresponding step of the get-app-tool-schema loop.
+             */
+            parameters?: Array<AppTool.Parameter>;
+            /**
+             * Mapping of a dynamic-variable name to the response field (dot-path) it is
+             * populated from. Missing paths are ignored.
+             */
+            response_variables?: {
+                [key: string]: string;
+            };
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. Determines whether the agent would call LLM another time and speak
+             * when the result of the tool is obtained.
+             */
+            speak_after_execution?: boolean;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. If true, will speak during execution.
+             */
+            speak_during_execution?: boolean;
+        }
+        namespace AppTool {
+            interface UnionMember0 {
+                mode: 'all';
+                /**
+                 * Not used at runtime; stored and returned as-is for the UI.
+                 */
+                fields?: Array<string>;
+            }
+            interface UnionMember1 {
+                /**
+                 * The only response fields the agent and the transcript see, as dot-paths into the
+                 * response schema returned by get-app-tool-schema. Everything else is dropped.
+                 * Selecting a parent keeps its whole subtree. A plain segment traverses arrays
+                 * element-wise (deals.properties.amount keeps that field on every deal), while
+                 * key[n] selects one element (deals[0].id keeps only the first deal's id); paths
+                 * that match nothing contribute nothing.
+                 */
+                fields: Array<string>;
+                mode: 'subset';
+            }
+            /**
+             * 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 Parameter {
+                /**
+                 * 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: 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>;
+            }
+        }
     }
 }
 export interface LlmListResponse {
@@ -2160,7 +2446,7 @@ export interface LlmCreateParams {
      * - Tools of LLM (with state) = general tools + state tools + state transitions
      * - Tools of LLM (no state) = general tools
      */
-    general_tools?: Array<LlmCreateParams.EndCallTool | LlmCreateParams.TransferCallTool | LlmCreateParams.AgentSwapTool | LlmCreateParams.PressDigitTool | LlmCreateParams.SendSMSTool | LlmCreateParams.CustomTool | LlmCreateParams.CodeTool | LlmCreateParams.ExtractDynamicVariableTool | LlmCreateParams.BridgeTransferTool | LlmCreateParams.CancelTransferTool | LlmCreateParams.McpTool> | null;
+    general_tools?: Array<LlmCreateParams.EndCallTool | LlmCreateParams.TransferCallTool | LlmCreateParams.AgentSwapTool | LlmCreateParams.PressDigitTool | LlmCreateParams.SendSMSTool | LlmCreateParams.CustomTool | LlmCreateParams.CodeTool | LlmCreateParams.ExtractDynamicVariableTool | LlmCreateParams.BridgeTransferTool | LlmCreateParams.CancelTransferTool | LlmCreateParams.McpTool | LlmCreateParams.AppTool> | null;
     /**
      * Whether this Retell LLM is used for warm transfer. Can only be set at creation,
      * and is ignored on update.
@@ -2181,7 +2467,7 @@ export interface LlmCreateParams {
     /**
      * Select the underlying text LLM. If not set, would default to gpt-5.6-terra.
      */
-    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' | 'gpt-5.5' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-5-sonnet' | 'claude-4.5-haiku' | 'gemini-3.0-flash' | 'gemini-3.1-flash-lite' | 'gemini-3.5-flash' | 'gemini-3.5-flash-lite' | 'gemini-3.6-flash' | 'gemini-3.7-flash' | 'gemini-3.8-flash' | null;
+    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' | 'gpt-5.5' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-6-astra' | 'gpt-6-sol' | 'gpt-6.1-sol' | 'gpt-6-luna' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-5-opus' | 'claude-5.5-opus' | 'claude-5-sonnet' | 'claude-5.5-sonnet' | 'claude-4.5-haiku' | 'gemini-3.0-flash' | 'gemini-3.1-flash-lite' | 'gemini-3.5-flash' | 'gemini-3.5-flash-lite' | 'gemini-3.6-flash' | 'gemini-3.7-flash' | 'gemini-3.8-flash' | 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
@@ -2233,6 +2519,13 @@ export declare namespace LlmCreateParams {
          */
         name: string;
         type: 'end_call';
+        /**
+         * Custom SIP headers sent on the outgoing BYE when ending the call. Header names
+         * must start with X- or x-. Supports dynamic variables.
+         */
+        custom_sip_headers?: {
+            [key: string]: string;
+        };
         /**
          * Describes what the tool does, sometimes can also include information about when
          * to call the tool.
@@ -2595,6 +2888,13 @@ export declare namespace LlmCreateParams {
          */
         keep_current_voice?: boolean;
         speak_during_execution?: boolean;
+        /**
+         * If true, restart the max call duration timer at the swap using the destination
+         * agent's max_call_duration_ms, capped so the whole call never exceeds 2 hours.
+         * Otherwise, the timer already running is left unchanged. Voice calls only.
+         * Defaults to false.
+         */
+        use_swap_agent_max_duration?: boolean;
         /**
          * Webhook setting for the agent swap, defaults to only source.
          */
@@ -3135,6 +3435,135 @@ export declare namespace LlmCreateParams {
          */
         speak_during_execution?: boolean;
     }
+    interface AppTool {
+        /**
+         * The connection (App) this tool runs against. Must be a connection in the
+         * organization whose provider matches this tool's provider.
+         */
+        app_id: string;
+        /**
+         * Name of the catalog template within the provider, as listed by
+         * list-app-templates.
+         */
+        app_tool_template_name: string;
+        /**
+         * Name of the tool. Must be unique within the phase's tools; referenced by
+         * depends_on.
+         */
+        name: string;
+        /**
+         * Provider of the connection. Must match the connection's provider; supported
+         * providers are listed by list-app-templates.
+         */
+        provider: string;
+        type: 'integration_app';
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. Overrides the catalog template's LLM-facing description.
+         */
+        description?: string;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. If true, play a typing sound on the agent audio track while this
+         * tool is executing. Useful when the tool takes a noticeable amount of time to
+         * prevent silence on the call.
+         */
+        enable_typing_sound?: boolean;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. The message for the agent to speak when executing the tool. Only
+         * applicable when speak_during_execution is true.
+         */
+        execution_message_description?: string;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. 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';
+        /**
+         * What the agent and the transcript see of the tool's response. Omit to send the
+         * full response. Does not affect response_variables, which are always extracted
+         * from the raw response.
+         */
+        output_selection?: AppTool.UnionMember0 | AppTool.UnionMember1;
+        /**
+         * The resolved input parameters, in order. Properties may pin a value with const
+         * (including {{variable}} references) or provide a description for LLM inference.
+         * Each property may also record selected*input_mode, the editor mode the user
+         * selected ("const_enum", "const_boolean", "const_value", "description_custom", or
+         * "description_preset"); it is stored and returned as-is, used only by the tool
+         * config UI. Omit the key when no mode is recorded; when set, const*_ modes
+         * require a non-empty const, and description\__ modes must omit const entirely.
+         * Each parameter's required list must match the schema returned by the
+         * corresponding step of the get-app-tool-schema loop.
+         */
+        parameters?: Array<AppTool.Parameter>;
+        /**
+         * Mapping of a dynamic-variable name to the response field (dot-path) it is
+         * populated from. Missing paths are ignored.
+         */
+        response_variables?: {
+            [key: string]: string;
+        };
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. Determines whether the agent would call LLM another time and speak
+         * when the result of the tool is obtained.
+         */
+        speak_after_execution?: boolean;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. If true, will speak during execution.
+         */
+        speak_during_execution?: boolean;
+    }
+    namespace AppTool {
+        interface UnionMember0 {
+            mode: 'all';
+            /**
+             * Not used at runtime; stored and returned as-is for the UI.
+             */
+            fields?: Array<string>;
+        }
+        interface UnionMember1 {
+            /**
+             * The only response fields the agent and the transcript see, as dot-paths into the
+             * response schema returned by get-app-tool-schema. Everything else is dropped.
+             * Selecting a parent keeps its whole subtree. A plain segment traverses arrays
+             * element-wise (deals.properties.amount keeps that field on every deal), while
+             * key[n] selects one element (deals[0].id keeps only the first deal's id); paths
+             * that match nothing contribute nothing.
+             */
+            fields: Array<string>;
+            mode: 'subset';
+        }
+        /**
+         * 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 Parameter {
+            /**
+             * 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: 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>;
+        }
+    }
     /**
      * Knowledge base configuration for RAG retrieval.
      */
@@ -3197,7 +3626,7 @@ export declare namespace LlmCreateParams {
          *
          * - Tools of LLM = general tools + state tools + state transitions
          */
-        tools?: Array<State.EndCallTool | State.TransferCallTool | State.AgentSwapTool | State.PressDigitTool | State.SendSMSTool | State.CustomTool | State.CodeTool | State.ExtractDynamicVariableTool | State.BridgeTransferTool | State.CancelTransferTool | State.McpTool>;
+        tools?: Array<State.EndCallTool | State.TransferCallTool | State.AgentSwapTool | State.PressDigitTool | State.SendSMSTool | State.CustomTool | State.CodeTool | State.ExtractDynamicVariableTool | State.BridgeTransferTool | State.CancelTransferTool | State.McpTool | State.AppTool>;
     }
     namespace State {
         interface Edge {
@@ -3259,6 +3688,13 @@ export declare namespace LlmCreateParams {
              */
             name: string;
             type: 'end_call';
+            /**
+             * Custom SIP headers sent on the outgoing BYE when ending the call. Header names
+             * must start with X- or x-. Supports dynamic variables.
+             */
+            custom_sip_headers?: {
+                [key: string]: string;
+            };
             /**
              * Describes what the tool does, sometimes can also include information about when
              * to call the tool.
@@ -3621,6 +4057,13 @@ export declare namespace LlmCreateParams {
              */
             keep_current_voice?: boolean;
             speak_during_execution?: boolean;
+            /**
+             * If true, restart the max call duration timer at the swap using the destination
+             * agent's max_call_duration_ms, capped so the whole call never exceeds 2 hours.
+             * Otherwise, the timer already running is left unchanged. Voice calls only.
+             * Defaults to false.
+             */
+            use_swap_agent_max_duration?: boolean;
             /**
              * Webhook setting for the agent swap, defaults to only source.
              */
@@ -4161,6 +4604,135 @@ export declare namespace LlmCreateParams {
              */
             speak_during_execution?: boolean;
         }
+        interface AppTool {
+            /**
+             * The connection (App) this tool runs against. Must be a connection in the
+             * organization whose provider matches this tool's provider.
+             */
+            app_id: string;
+            /**
+             * Name of the catalog template within the provider, as listed by
+             * list-app-templates.
+             */
+            app_tool_template_name: string;
+            /**
+             * Name of the tool. Must be unique within the phase's tools; referenced by
+             * depends_on.
+             */
+            name: string;
+            /**
+             * Provider of the connection. Must match the connection's provider; supported
+             * providers are listed by list-app-templates.
+             */
+            provider: string;
+            type: 'integration_app';
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. Overrides the catalog template's LLM-facing description.
+             */
+            description?: string;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. If true, play a typing sound on the agent audio track while this
+             * tool is executing. Useful when the tool takes a noticeable amount of time to
+             * prevent silence on the call.
+             */
+            enable_typing_sound?: boolean;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. The message for the agent to speak when executing the tool. Only
+             * applicable when speak_during_execution is true.
+             */
+            execution_message_description?: string;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. 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';
+            /**
+             * What the agent and the transcript see of the tool's response. Omit to send the
+             * full response. Does not affect response_variables, which are always extracted
+             * from the raw response.
+             */
+            output_selection?: AppTool.UnionMember0 | AppTool.UnionMember1;
+            /**
+             * The resolved input parameters, in order. Properties may pin a value with const
+             * (including {{variable}} references) or provide a description for LLM inference.
+             * Each property may also record selected*input_mode, the editor mode the user
+             * selected ("const_enum", "const_boolean", "const_value", "description_custom", or
+             * "description_preset"); it is stored and returned as-is, used only by the tool
+             * config UI. Omit the key when no mode is recorded; when set, const*_ modes
+             * require a non-empty const, and description\__ modes must omit const entirely.
+             * Each parameter's required list must match the schema returned by the
+             * corresponding step of the get-app-tool-schema loop.
+             */
+            parameters?: Array<AppTool.Parameter>;
+            /**
+             * Mapping of a dynamic-variable name to the response field (dot-path) it is
+             * populated from. Missing paths are ignored.
+             */
+            response_variables?: {
+                [key: string]: string;
+            };
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. Determines whether the agent would call LLM another time and speak
+             * when the result of the tool is obtained.
+             */
+            speak_after_execution?: boolean;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. If true, will speak during execution.
+             */
+            speak_during_execution?: boolean;
+        }
+        namespace AppTool {
+            interface UnionMember0 {
+                mode: 'all';
+                /**
+                 * Not used at runtime; stored and returned as-is for the UI.
+                 */
+                fields?: Array<string>;
+            }
+            interface UnionMember1 {
+                /**
+                 * The only response fields the agent and the transcript see, as dot-paths into the
+                 * response schema returned by get-app-tool-schema. Everything else is dropped.
+                 * Selecting a parent keeps its whole subtree. A plain segment traverses arrays
+                 * element-wise (deals.properties.amount keeps that field on every deal), while
+                 * key[n] selects one element (deals[0].id keeps only the first deal's id); paths
+                 * that match nothing contribute nothing.
+                 */
+                fields: Array<string>;
+                mode: 'subset';
+            }
+            /**
+             * 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 Parameter {
+                /**
+                 * 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: 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>;
+            }
+        }
     }
 }
 export interface LlmRetrieveParams {
@@ -4212,7 +4784,7 @@ export interface LlmUpdateParams {
      * - Tools of LLM (with state) = general tools + state tools + state transitions
      * - Tools of LLM (no state) = general tools
      */
-    general_tools?: Array<LlmUpdateParams.EndCallTool | LlmUpdateParams.TransferCallTool | LlmUpdateParams.AgentSwapTool | LlmUpdateParams.PressDigitTool | LlmUpdateParams.SendSMSTool | LlmUpdateParams.CustomTool | LlmUpdateParams.CodeTool | LlmUpdateParams.ExtractDynamicVariableTool | LlmUpdateParams.BridgeTransferTool | LlmUpdateParams.CancelTransferTool | LlmUpdateParams.McpTool> | null;
+    general_tools?: Array<LlmUpdateParams.EndCallTool | LlmUpdateParams.TransferCallTool | LlmUpdateParams.AgentSwapTool | LlmUpdateParams.PressDigitTool | LlmUpdateParams.SendSMSTool | LlmUpdateParams.CustomTool | LlmUpdateParams.CodeTool | LlmUpdateParams.ExtractDynamicVariableTool | LlmUpdateParams.BridgeTransferTool | LlmUpdateParams.CancelTransferTool | LlmUpdateParams.McpTool | LlmUpdateParams.AppTool> | null;
     /**
      * Body param: Whether this Retell LLM is used for warm transfer. Can only be set
      * at creation, and is ignored on update.
@@ -4234,7 +4806,7 @@ export interface LlmUpdateParams {
      * Body param: Select the underlying text LLM. If not set, would default to
      * gpt-5.6-terra.
      */
-    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' | 'gpt-5.5' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-5-sonnet' | 'claude-4.5-haiku' | 'gemini-3.0-flash' | 'gemini-3.1-flash-lite' | 'gemini-3.5-flash' | 'gemini-3.5-flash-lite' | 'gemini-3.6-flash' | 'gemini-3.7-flash' | 'gemini-3.8-flash' | null;
+    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' | 'gpt-5.5' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-6-astra' | 'gpt-6-sol' | 'gpt-6.1-sol' | 'gpt-6-luna' | 'claude-4.5-sonnet' | 'claude-4.6-sonnet' | 'claude-5-opus' | 'claude-5.5-opus' | 'claude-5-sonnet' | 'claude-5.5-sonnet' | 'claude-4.5-haiku' | 'gemini-3.0-flash' | 'gemini-3.1-flash-lite' | 'gemini-3.5-flash' | 'gemini-3.5-flash-lite' | 'gemini-3.6-flash' | 'gemini-3.7-flash' | 'gemini-3.8-flash' | 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
@@ -4286,6 +4858,13 @@ export declare namespace LlmUpdateParams {
          */
         name: string;
         type: 'end_call';
+        /**
+         * Custom SIP headers sent on the outgoing BYE when ending the call. Header names
+         * must start with X- or x-. Supports dynamic variables.
+         */
+        custom_sip_headers?: {
+            [key: string]: string;
+        };
         /**
          * Describes what the tool does, sometimes can also include information about when
          * to call the tool.
@@ -4648,6 +5227,13 @@ export declare namespace LlmUpdateParams {
          */
         keep_current_voice?: boolean;
         speak_during_execution?: boolean;
+        /**
+         * If true, restart the max call duration timer at the swap using the destination
+         * agent's max_call_duration_ms, capped so the whole call never exceeds 2 hours.
+         * Otherwise, the timer already running is left unchanged. Voice calls only.
+         * Defaults to false.
+         */
+        use_swap_agent_max_duration?: boolean;
         /**
          * Webhook setting for the agent swap, defaults to only source.
          */
@@ -5188,6 +5774,135 @@ export declare namespace LlmUpdateParams {
          */
         speak_during_execution?: boolean;
     }
+    interface AppTool {
+        /**
+         * The connection (App) this tool runs against. Must be a connection in the
+         * organization whose provider matches this tool's provider.
+         */
+        app_id: string;
+        /**
+         * Name of the catalog template within the provider, as listed by
+         * list-app-templates.
+         */
+        app_tool_template_name: string;
+        /**
+         * Name of the tool. Must be unique within the phase's tools; referenced by
+         * depends_on.
+         */
+        name: string;
+        /**
+         * Provider of the connection. Must match the connection's provider; supported
+         * providers are listed by list-app-templates.
+         */
+        provider: string;
+        type: 'integration_app';
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. Overrides the catalog template's LLM-facing description.
+         */
+        description?: string;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. If true, play a typing sound on the agent audio track while this
+         * tool is executing. Useful when the tool takes a noticeable amount of time to
+         * prevent silence on the call.
+         */
+        enable_typing_sound?: boolean;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. The message for the agent to speak when executing the tool. Only
+         * applicable when speak_during_execution is true.
+         */
+        execution_message_description?: string;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. 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';
+        /**
+         * What the agent and the transcript see of the tool's response. Omit to send the
+         * full response. Does not affect response_variables, which are always extracted
+         * from the raw response.
+         */
+        output_selection?: AppTool.UnionMember0 | AppTool.UnionMember1;
+        /**
+         * The resolved input parameters, in order. Properties may pin a value with const
+         * (including {{variable}} references) or provide a description for LLM inference.
+         * Each property may also record selected*input_mode, the editor mode the user
+         * selected ("const_enum", "const_boolean", "const_value", "description_custom", or
+         * "description_preset"); it is stored and returned as-is, used only by the tool
+         * config UI. Omit the key when no mode is recorded; when set, const*_ modes
+         * require a non-empty const, and description\__ modes must omit const entirely.
+         * Each parameter's required list must match the schema returned by the
+         * corresponding step of the get-app-tool-schema loop.
+         */
+        parameters?: Array<AppTool.Parameter>;
+        /**
+         * Mapping of a dynamic-variable name to the response field (dot-path) it is
+         * populated from. Missing paths are ignored.
+         */
+        response_variables?: {
+            [key: string]: string;
+        };
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. Determines whether the agent would call LLM another time and speak
+         * when the result of the tool is obtained.
+         */
+        speak_after_execution?: boolean;
+        /**
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. If true, will speak during execution.
+         */
+        speak_during_execution?: boolean;
+    }
+    namespace AppTool {
+        interface UnionMember0 {
+            mode: 'all';
+            /**
+             * Not used at runtime; stored and returned as-is for the UI.
+             */
+            fields?: Array<string>;
+        }
+        interface UnionMember1 {
+            /**
+             * The only response fields the agent and the transcript see, as dot-paths into the
+             * response schema returned by get-app-tool-schema. Everything else is dropped.
+             * Selecting a parent keeps its whole subtree. A plain segment traverses arrays
+             * element-wise (deals.properties.amount keeps that field on every deal), while
+             * key[n] selects one element (deals[0].id keeps only the first deal's id); paths
+             * that match nothing contribute nothing.
+             */
+            fields: Array<string>;
+            mode: 'subset';
+        }
+        /**
+         * 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 Parameter {
+            /**
+             * 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: 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>;
+        }
+    }
     /**
      * Knowledge base configuration for RAG retrieval.
      */
@@ -5250,7 +5965,7 @@ export declare namespace LlmUpdateParams {
          *
          * - Tools of LLM = general tools + state tools + state transitions
          */
-        tools?: Array<State.EndCallTool | State.TransferCallTool | State.AgentSwapTool | State.PressDigitTool | State.SendSMSTool | State.CustomTool | State.CodeTool | State.ExtractDynamicVariableTool | State.BridgeTransferTool | State.CancelTransferTool | State.McpTool>;
+        tools?: Array<State.EndCallTool | State.TransferCallTool | State.AgentSwapTool | State.PressDigitTool | State.SendSMSTool | State.CustomTool | State.CodeTool | State.ExtractDynamicVariableTool | State.BridgeTransferTool | State.CancelTransferTool | State.McpTool | State.AppTool>;
     }
     namespace State {
         interface Edge {
@@ -5312,6 +6027,13 @@ export declare namespace LlmUpdateParams {
              */
             name: string;
             type: 'end_call';
+            /**
+             * Custom SIP headers sent on the outgoing BYE when ending the call. Header names
+             * must start with X- or x-. Supports dynamic variables.
+             */
+            custom_sip_headers?: {
+                [key: string]: string;
+            };
             /**
              * Describes what the tool does, sometimes can also include information about when
              * to call the tool.
@@ -5674,6 +6396,13 @@ export declare namespace LlmUpdateParams {
              */
             keep_current_voice?: boolean;
             speak_during_execution?: boolean;
+            /**
+             * If true, restart the max call duration timer at the swap using the destination
+             * agent's max_call_duration_ms, capped so the whole call never exceeds 2 hours.
+             * Otherwise, the timer already running is left unchanged. Voice calls only.
+             * Defaults to false.
+             */
+            use_swap_agent_max_duration?: boolean;
             /**
              * Webhook setting for the agent swap, defaults to only source.
              */
@@ -6214,6 +6943,135 @@ export declare namespace LlmUpdateParams {
              */
             speak_during_execution?: boolean;
         }
+        interface AppTool {
+            /**
+             * The connection (App) this tool runs against. Must be a connection in the
+             * organization whose provider matches this tool's provider.
+             */
+            app_id: string;
+            /**
+             * Name of the catalog template within the provider, as listed by
+             * list-app-templates.
+             */
+            app_tool_template_name: string;
+            /**
+             * Name of the tool. Must be unique within the phase's tools; referenced by
+             * depends_on.
+             */
+            name: string;
+            /**
+             * Provider of the connection. Must match the connection's provider; supported
+             * providers are listed by list-app-templates.
+             */
+            provider: string;
+            type: 'integration_app';
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. Overrides the catalog template's LLM-facing description.
+             */
+            description?: string;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. If true, play a typing sound on the agent audio track while this
+             * tool is executing. Useful when the tool takes a noticeable amount of time to
+             * prevent silence on the call.
+             */
+            enable_typing_sound?: boolean;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. The message for the agent to speak when executing the tool. Only
+             * applicable when speak_during_execution is true.
+             */
+            execution_message_description?: string;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. 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';
+            /**
+             * What the agent and the transcript see of the tool's response. Omit to send the
+             * full response. Does not affect response_variables, which are always extracted
+             * from the raw response.
+             */
+            output_selection?: AppTool.UnionMember0 | AppTool.UnionMember1;
+            /**
+             * The resolved input parameters, in order. Properties may pin a value with const
+             * (including {{variable}} references) or provide a description for LLM inference.
+             * Each property may also record selected*input_mode, the editor mode the user
+             * selected ("const_enum", "const_boolean", "const_value", "description_custom", or
+             * "description_preset"); it is stored and returned as-is, used only by the tool
+             * config UI. Omit the key when no mode is recorded; when set, const*_ modes
+             * require a non-empty const, and description\__ modes must omit const entirely.
+             * Each parameter's required list must match the schema returned by the
+             * corresponding step of the get-app-tool-schema loop.
+             */
+            parameters?: Array<AppTool.Parameter>;
+            /**
+             * Mapping of a dynamic-variable name to the response field (dot-path) it is
+             * populated from. Missing paths are ignored.
+             */
+            response_variables?: {
+                [key: string]: string;
+            };
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. Determines whether the agent would call LLM another time and speak
+             * when the result of the tool is obtained.
+             */
+            speak_after_execution?: boolean;
+            /**
+             * Only applies to during conversation functions; ignored by the pre/post
+             * conversation. If true, will speak during execution.
+             */
+            speak_during_execution?: boolean;
+        }
+        namespace AppTool {
+            interface UnionMember0 {
+                mode: 'all';
+                /**
+                 * Not used at runtime; stored and returned as-is for the UI.
+                 */
+                fields?: Array<string>;
+            }
+            interface UnionMember1 {
+                /**
+                 * The only response fields the agent and the transcript see, as dot-paths into the
+                 * response schema returned by get-app-tool-schema. Everything else is dropped.
+                 * Selecting a parent keeps its whole subtree. A plain segment traverses arrays
+                 * element-wise (deals.properties.amount keeps that field on every deal), while
+                 * key[n] selects one element (deals[0].id keeps only the first deal's id); paths
+                 * that match nothing contribute nothing.
+                 */
+                fields: Array<string>;
+                mode: 'subset';
+            }
+            /**
+             * 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 Parameter {
+                /**
+                 * 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: 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>;
+            }
+        }
     }
 }
 export interface LlmListParams {