retell-sdk 6.0.1 → 6.1.0

package/resources/agent.d.ts

@@ -239,6 +239,14 @@ export interface AgentResponse {
      * disable call screen prompt instructions.
      */
     call_screening_option?: AgentResponse.CallScreeningOption | null;
+    /**
+     * Contact memory settings for phone calls and SMS chats. Creating an agent
+     * defaults enable_update to false and enable_read to true. Updates only change the
+     * supplied flags; omitted flags stay unchanged and an empty object has no effect.
+     * Set a flag to false to disable it. The configuration cannot be cleared. Existing
+     * agents without this configuration have both disabled.
+     */
+    contact_memory_config?: AgentResponse.ContactMemoryConfig;
     /**
      * Custom STT configuration. Only used when stt_mode is set to custom.
      */
@@ -273,6 +281,13 @@ export interface AgentResponse {
      * will not backchannel.
      */
     enable_backchannel?: boolean;
+    /**
+     * If set to true, the agent recognizes requests to stop calling or contacting the
+     * user, confirms once, and on a clear yes ends the call with disconnection reason
+     * user_requested_dnc and sets do_not_call to true on the contact for the user's
+     * phone number. If unset, default value false will apply.
+     */
+    enable_dnc_detection?: boolean;
     /**
      * If set to true, the agent will dynamically adjust how quickly it responds based
      * on the user's speech rate and past turn-taking behavior in the call. If unset,
@@ -377,7 +392,23 @@ export interface AgentResponse {
     /**
      * The model to use for post call analysis. Default to gpt-5.6-terra.
      */
-    post_call_analysis_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;
+    post_call_analysis_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;
+    /**
+     * Integration (Agent Functions) tools run as a dependency graph during teardown,
+     * after post-call analysis. Each tool can be gated by a condition. On calls the
+     * graph is stopped after five minutes so teardown can finish. Set to null to
+     * clear.
+     */
+    post_session_tools?: Array<AgentResponse.AppTool | AgentResponse.CustomTool | AgentResponse.CodeTool | AgentResponse.SendSMSTool> | null;
+    /**
+     * Integration (Agent Functions) tools run as a dependency graph during session
+     * setup, before the agent's first message. Outputs are injected as dynamic
+     * variables. On calls the graph gets one minute unless an outbound caller will be
+     * dialed after setup, in which case it gets five minutes. Past that session
+     * initialization continues and any remaining tools finish in the background, so
+     * their outputs no longer reach the agent's prompt. Set to null to clear.
+     */
+    pre_session_tools?: Array<AgentResponse.AppTool | AgentResponse.CustomTool | AgentResponse.CodeTool> | null;
     /**
      * A list of words / phrases and their pronunciation to be used to guide the audio
      * synthesize for consistent pronunciation. Check the dashboard to see what
@@ -442,17 +473,12 @@ export interface AgentResponse {
      * Default to general.
      */
     vocab_specialization?: 'general' | 'medical';
-    /**
-     * Controls the emotional tone of the agent's voice. Currently supported for
-     * Cartesia and Minimax TTS providers. If unset, no emotion will be used.
-     */
-    voice_emotion?: 'calm' | 'sympathetic' | 'happy' | 'sad' | 'angry' | 'fearful' | 'surprised' | null;
     /**
      * Select the voice model used for the selected voice. Each provider has a set of
      * available voice models. Set to null to remove voice model selection, and default
      * ones will apply. Check out dashboard for more details of each voice model.
      */
-    voice_model?: 'eleven_flash_v2' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'sonic-3' | 'sonic-3-latest' | 'sonic-3.5' | 'sonic-3.6' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | 's2.1-pro' | 'inworld-tts-2' | 'inworld-tts-2-flash' | null;
+    voice_model?: 'eleven_flash_v2' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'eleven_v4_turbo' | 'sonic-3' | 'sonic-3-latest' | 'sonic-3.5' | 'sonic-3.6' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | 's2.1-pro' | 'inworld-tts-2' | 'inworld-tts-2-flash' | null;
     /**
      * Controls speed of voice. Value ranging from [0.5,2]. Lower value means slower
      * speech, while higher value means faster speech rate. If unset, default value 1
@@ -553,21 +579,43 @@ export declare namespace AgentResponse {
          */
         call_purpose: string;
     }
+    /**
+     * Contact memory settings for phone calls and SMS chats. Creating an agent
+     * defaults enable_update to false and enable_read to true. Updates only change the
+     * supplied flags; omitted flags stay unchanged and an empty object has no effect.
+     * Set a flag to false to disable it. The configuration cannot be cleared. Existing
+     * agents without this configuration have both disabled.
+     */
+    interface ContactMemoryConfig {
+        /**
+         * Automatically add saved contact memory to the agent prompt. Skippable nodes can
+         * use answers from the current conversation even when this setting is disabled.
+         * Contact dynamic variables, including contact_memory, remain available regardless
+         * of this setting.
+         */
+        enable_read?: boolean;
+        /**
+         * Rewrite the contact memory after each conversation. Requires storing
+         * conversation data. Chat agents must also have end_chat_after_silence_ms set.
+         */
+        enable_update?: boolean;
+    }
     /**
      * Custom STT configuration. Only used when stt_mode is set to custom.
      */
     interface CustomSttConfig {
         /**
          * Endpointing timeout in milliseconds. Minimum is 100 for Azure, 10 for Deepgram,
-         * 500 for Soniox, 100 for AssemblyAI. For AssemblyAI, this sets min_turn_silence
-         * (100-3000 ms). max_turn_silence adds half of this value, rounded to the nearest
-         * millisecond and bounded to 500-1000 ms, with a total cap of 3000 ms.
+         * 500 for Soniox, 100 for AssemblyAI, 100 for Muse. For AssemblyAI, this sets
+         * min_turn_silence (100-3000 ms). max_turn_silence adds half of this value,
+         * rounded to the nearest millisecond and bounded to 500-1000 ms, with a total cap
+         * of 3000 ms. Muse detects turn ends itself and ignores this value.
          */
         endpointing_ms: number;
         /**
          * ASR provider name.
          */
-        provider: 'azure' | 'deepgram' | 'soniox' | 'assemblyai';
+        provider: 'azure' | 'deepgram' | 'soniox' | 'assemblyai' | 'muse';
     }
     /**
      * Configuration for guardrail checks to detect and prevent prohibited topics in
@@ -804,179 +852,1030 @@ export declare namespace AgentResponse {
          */
         required?: boolean;
     }
-    interface PronunciationDictionary {
+    interface AppTool {
         /**
-         * The phonetic alphabet to use. MiniMax speech-02-turbo supports IPA and Pinyin.
-         * MiniMax speech-2.8-turbo also supports Jyutping. Support for other alphabets
-         * depends on the selected voice provider and model.
+         * The connection (App) this tool runs against. Must be a connection in the
+         * organization whose provider matches this tool's provider.
          */
-        alphabet: 'ipa' | 'cmu' | 'pinyin' | 'jyutping';
+        app_id: string;
         /**
-         * Pronunciation of the word in the format of the selected phonetic alphabet.
+         * Name of the catalog template within the provider, as listed by
+         * list-app-templates.
          */
-        phoneme: string;
+        app_tool_template_name: string;
         /**
-         * The string of word / phrase to be annotated with pronunciation.
+         * Name of the tool. Must be unique within the phase's tools; referenced by
+         * depends_on.
          */
-        word: string;
-    }
-    interface UserDtmfOptions {
+        name: string;
         /**
-         * The maximum number of digits allowed in the user's DTMF (Dual-Tone
-         * Multi-Frequency) input per turn. Once this limit is reached, the input is
-         * considered complete and a response will be generated immediately.
+         * Provider of the connection. Must match the connection's provider; supported
+         * providers are listed by list-app-templates.
          */
-        digit_limit?: number | null;
+        provider: string;
+        type: 'integration_app';
         /**
-         * A single key that signals the end of DTMF input. Acceptable values include any
-         * digit (0-9), the pound/hash symbol (#), or the asterisk (\*).
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
          */
-        termination_key?: string | null;
+        condition?: AppTool.Condition;
         /**
-         * The time (in milliseconds) to wait for user DTMF input before timing out. The
-         * timer resets with each digit received.
+         * Names of tools that must run before this one.
          */
-        timeout_ms?: number;
-    }
-    /**
-     * If this option is set, the call will try to detect voicemail in the first 3
-     * minutes of the call. Actions defined (hangup, or leave a message) will be
-     * applied when the voicemail is detected. Set this to null to disable voicemail
-     * detection.
-     */
-    interface VoicemailOption {
-        action: VoicemailOption.VoicemailActionPrompt | VoicemailOption.VoicemailActionStaticText | VoicemailOption.VoicemailActionHangup | VoicemailOption.VoicemailActionBridgeTransfer;
+        depends_on?: Array<string>;
         /**
-         * Optionally describe what should be treated as voicemail. Leave as null to use
-         * the default definition.
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. Overrides the catalog template's LLM-facing description.
          */
-        detection_prompt?: string | null;
+        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 VoicemailOption {
-        interface VoicemailActionPrompt {
+    namespace AppTool {
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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 UnionMember0 {
+            mode: 'all';
             /**
-             * The prompt used to generate the text to be spoken when the call is detected to
-             * be in voicemail.
+             * Not used at runtime; stored and returned as-is for the UI.
              */
-            text: string;
-            type: 'prompt';
+            fields?: Array<string>;
         }
-        interface VoicemailActionStaticText {
+        interface UnionMember1 {
             /**
-             * The text to be spoken when the call is detected to be in voicemail.
+             * 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.
              */
-            text: string;
-            type: 'static_text';
+            fields: Array<string>;
+            mode: 'subset';
         }
-        interface VoicemailActionHangup {
-            type: 'hangup';
+        /**
+         * 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>;
         }
-        interface VoicemailActionBridgeTransfer {
-            type: 'bridge_transfer';
+    }
+    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;
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        condition?: CustomTool.Condition;
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * Describes what this tool does and when to call this tool.
+         */
+        description?: string;
+        /**
+         * 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;
+        /**
+         * 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;
+        };
+        /**
+         * Maximum number of times to retry the request after a failed attempt, from 0 (no
+         * retry) to 5. Retries happen on any failure, with exponential backoff between
+         * attempts; the backoff delay is not configurable. `timeout_ms` applies per
+         * attempt rather than as a budget across all attempts, so an attempt that times
+         * out is still retried and the worst-case total duration is `timeout_ms`
+         * multiplied by (`max_retry` + 1) as well as any latency incurred by the
+         * exponential backoff + jitter between each retry. Only the final attempt's result
+         * is reported to the agent. Because retries repeat the request, only set this
+         * above 0 if your endpoint is idempotent — a retried request may be processed more
+         * than once. Defaults to 0 (no retry).
+         */
+        max_retry?: number;
+        /**
+         * Method to use for the request, default to POST.
+         */
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        /**
+         * How the tool's `parameters` are authored and shown in the dashboard editor —
+         * "form" for the visual parameter builder, "json" for a raw JSON Schema. Both
+         * produce the same `parameters` schema; this does not change how the request body
+         * is encoded (see `args_at_root`).
+         */
+        parameter_type?: 'json' | 'form';
+        /**
+         * 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;
+    }
+    namespace CustomTool {
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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;
+            }
+        }
+        /**
+         * 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: 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 AgentListResponse {
-    /**
-     * Whether more results are available.
-     */
-    has_more: boolean;
-    items: Array<AgentListResponse.Item>;
-    /**
-     * Pagination key for the next page.
-     */
-    pagination_key?: string;
-}
-export declare namespace AgentListResponse {
-    interface Item {
+    interface CodeTool {
         /**
-         * Unique id of agent.
+         * JavaScript code to execute in the sandbox.
          */
-        agent_id: string;
+        code: string;
         /**
-         * The name of the agent. Only used for your own reference.
+         * 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).
          */
-        agent_name: string;
-        channel: 'voice' | 'chat';
+        name: string;
+        type: 'code';
         /**
-         * Authoritative root tags for this agent, keyed by tag name.
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
          */
-        tags: {
-            [key: string]: Item.Tags;
+        condition?: CodeTool.Condition;
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * Describes what this tool does and when to call this tool.
+         */
+        description?: string;
+        /**
+         * If true, play a typing sound on the agent audio track while this tool is
+         * executing.
+         */
+        enable_typing_sound?: boolean;
+        /**
+         * The description for the sentence agent say during execution. 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';
+        /**
+         * A mapping of variable names to JSON paths in the code execution result. These
+         * mapped values will be extracted and added as dynamic variables.
+         */
+        response_variables?: {
+            [key: string]: string;
         };
         /**
-         * User modification timestamp (milliseconds since epoch). Either the time of last
-         * update or creation if no updates available.
+         * Determines whether the agent would call LLM another time and speak when the
+         * result of function is obtained.
          */
-        user_modified_timestamp: number;
+        speak_after_execution?: boolean;
+        /**
+         * Determines whether the agent would say sentence like "One moment, let me check
+         * that." when executing the tool.
+         */
+        speak_during_execution?: boolean;
+        /**
+         * The maximum time in milliseconds the code can run before it's considered
+         * timeout. Defaults to 30,000 ms (30 s).
+         */
+        timeout_ms?: number;
     }
-    namespace Item {
-        interface Tags {
-            dynamic_variables?: {
-                [key: string]: string;
-            };
-            version?: number;
+    namespace CodeTool {
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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;
+            }
         }
     }
-}
-export type AgentCreateVersionResponse = AgentResponse | ChatAgentAPI.ChatAgentResponse;
-export interface AgentListVersionsResponse {
-    /**
-     * Whether more results are available.
-     */
-    has_more: boolean;
-    items: Array<AgentListVersionsResponse.Item>;
-    /**
-     * Pagination key for the next page.
-     */
-    pagination_key?: string;
-}
-export declare namespace AgentListVersionsResponse {
-    interface Item {
+    interface SendSMSTool {
         /**
-         * Whether the agent version is published.
+         * Name of the tool. Must be unique within all tools available to LLM at any given
+         * time (general tools + state tools + state edges).
          */
-        is_published: boolean;
+        name: string;
+        sms_content: SendSMSTool.SMSContentPredefined | SendSMSTool.SMSContentInferred | SendSMSTool.SMSContentTemplate;
+        type: 'send_sms';
         /**
-         * Last modification timestamp in milliseconds since epoch.
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
          */
-        last_modification_timestamp: number;
+        condition?: SendSMSTool.Condition;
         /**
-         * Version number of the agent.
+         * Names of tools that must run before this one.
          */
-        version: number;
+        depends_on?: Array<string>;
         /**
-         * Version that this agent version was based on.
+         * Describes what the tool does, sometimes can also include information about when
+         * to call the tool.
          */
-        base_version?: number;
+        description?: string;
         /**
-         * Optional description of the agent version.
+         * Describes what to say before sending the SMS. Only applicable when
+         * speak_during_execution is true.
          */
-        version_description?: string;
+        execution_message_description?: string;
         /**
-         * Optional title of the agent version.
+         * 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".
          */
-        version_title?: string;
+        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;
     }
-}
-export type AgentRepairResponse = AgentResponse | ChatAgentAPI.ChatAgentResponse;
-export interface AgentCreateParams {
-    /**
-     * The Response Engine to attach to the agent. It is used to generate responses for
-     * the agent. You need to create a Response Engine first before attaching it to an
-     * agent.
-     */
-    response_engine: AgentCreateParams.ResponseEngineRetellLm | AgentCreateParams.ResponseEngineCustomLm | AgentCreateParams.ResponseEngineConversationFlow;
-    /**
-     * Unique voice id used for the agent. Find list of available voices and their
-     * preview in Dashboard.
-     */
-    voice_id: string;
-    /**
-     * The name of the agent. Only used for your own reference.
-     */
-    agent_name?: string | null;
-    /**
+    namespace SendSMSTool {
+        interface SMSContentPredefined {
+            /**
+             * The static message to be sent in the SMS. Can contain dynamic variables.
+             */
+            text?: string;
+            type?: 'predefined';
+        }
+        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';
+        }
+        interface SMSContentTemplate {
+            /**
+             * The template to use for the SMS content. "info_collection" sends a predefined
+             * message requesting information from the user.
+             */
+            template: 'info_collection';
+            type: 'template';
+        }
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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 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';
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * 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>;
+        }
+    }
+    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;
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * Describes what this tool does and when to call this tool.
+         */
+        description?: string;
+        /**
+         * 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;
+        /**
+         * 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;
+        };
+        /**
+         * Maximum number of times to retry the request after a failed attempt, from 0 (no
+         * retry) to 5. Retries happen on any failure, with exponential backoff between
+         * attempts; the backoff delay is not configurable. `timeout_ms` applies per
+         * attempt rather than as a budget across all attempts, so an attempt that times
+         * out is still retried and the worst-case total duration is `timeout_ms`
+         * multiplied by (`max_retry` + 1) as well as any latency incurred by the
+         * exponential backoff + jitter between each retry. Only the final attempt's result
+         * is reported to the agent. Because retries repeat the request, only set this
+         * above 0 if your endpoint is idempotent — a retried request may be processed more
+         * than once. Defaults to 0 (no retry).
+         */
+        max_retry?: number;
+        /**
+         * Method to use for the request, default to POST.
+         */
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        /**
+         * How the tool's `parameters` are authored and shown in the dashboard editor —
+         * "form" for the visual parameter builder, "json" for a raw JSON Schema. Both
+         * produce the same `parameters` schema; this does not change how the request body
+         * is encoded (see `args_at_root`).
+         */
+        parameter_type?: 'json' | 'form';
+        /**
+         * 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;
+    }
+    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: 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 CodeTool {
+        /**
+         * JavaScript code to execute in the sandbox.
+         */
+        code: string;
+        /**
+         * 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: 'code';
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * Describes what this tool does and when to call this tool.
+         */
+        description?: string;
+        /**
+         * If true, play a typing sound on the agent audio track while this tool is
+         * executing.
+         */
+        enable_typing_sound?: boolean;
+        /**
+         * The description for the sentence agent say during execution. 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';
+        /**
+         * A mapping of variable names to JSON paths in the code execution result. These
+         * mapped values will be extracted and added as dynamic variables.
+         */
+        response_variables?: {
+            [key: string]: string;
+        };
+        /**
+         * Determines whether the agent would call LLM another time and speak when the
+         * result of function is obtained.
+         */
+        speak_after_execution?: boolean;
+        /**
+         * Determines whether the agent would say sentence like "One moment, let me check
+         * that." when executing the tool.
+         */
+        speak_during_execution?: boolean;
+        /**
+         * The maximum time in milliseconds the code can run before it's considered
+         * timeout. Defaults to 30,000 ms (30 s).
+         */
+        timeout_ms?: number;
+    }
+    interface PronunciationDictionary {
+        /**
+         * The phonetic alphabet to use. MiniMax speech-02-turbo supports IPA and Pinyin.
+         * MiniMax speech-2.8-turbo also supports Jyutping. Support for other alphabets
+         * depends on the selected voice provider and model.
+         */
+        alphabet: 'ipa' | 'cmu' | 'pinyin' | 'jyutping';
+        /**
+         * Pronunciation of the word in the format of the selected phonetic alphabet.
+         */
+        phoneme: string;
+        /**
+         * The string of word / phrase to be annotated with pronunciation.
+         */
+        word: string;
+    }
+    interface UserDtmfOptions {
+        /**
+         * The maximum number of digits allowed in the user's DTMF (Dual-Tone
+         * Multi-Frequency) input per turn. Once this limit is reached, the input is
+         * considered complete and a response will be generated immediately.
+         */
+        digit_limit?: number | null;
+        /**
+         * A single key that signals the end of DTMF input. Acceptable values include any
+         * digit (0-9), the pound/hash symbol (#), or the asterisk (\*).
+         */
+        termination_key?: string | null;
+        /**
+         * The time (in milliseconds) to wait for user DTMF input before timing out. The
+         * timer resets with each digit received.
+         */
+        timeout_ms?: number;
+    }
+    /**
+     * If this option is set, the call will try to detect voicemail in the first 3
+     * minutes of the call. Actions defined (hangup, or leave a message) will be
+     * applied when the voicemail is detected. Set this to null to disable voicemail
+     * detection.
+     */
+    interface VoicemailOption {
+        action: VoicemailOption.VoicemailActionPrompt | VoicemailOption.VoicemailActionStaticText | VoicemailOption.VoicemailActionHangup | VoicemailOption.VoicemailActionBridgeTransfer;
+        /**
+         * Optionally describe what should be treated as voicemail. Leave as null to use
+         * the default definition.
+         */
+        detection_prompt?: string | null;
+    }
+    namespace VoicemailOption {
+        interface VoicemailActionPrompt {
+            /**
+             * The prompt used to generate the text to be spoken when the call is detected to
+             * be in voicemail.
+             */
+            text: string;
+            type: 'prompt';
+        }
+        interface VoicemailActionStaticText {
+            /**
+             * The text to be spoken when the call is detected to be in voicemail.
+             */
+            text: string;
+            type: 'static_text';
+        }
+        interface VoicemailActionHangup {
+            type: 'hangup';
+        }
+        interface VoicemailActionBridgeTransfer {
+            type: 'bridge_transfer';
+        }
+    }
+}
+export interface AgentListResponse {
+    /**
+     * Whether more results are available.
+     */
+    has_more: boolean;
+    items: Array<AgentListResponse.Item>;
+    /**
+     * Pagination key for the next page.
+     */
+    pagination_key?: string;
+}
+export declare namespace AgentListResponse {
+    interface Item {
+        /**
+         * Unique id of agent.
+         */
+        agent_id: string;
+        /**
+         * The name of the agent. Only used for your own reference.
+         */
+        agent_name: string;
+        channel: 'voice' | 'chat';
+        /**
+         * Authoritative root tags for this agent, keyed by tag name.
+         */
+        tags: {
+            [key: string]: Item.Tags;
+        };
+        /**
+         * User modification timestamp (milliseconds since epoch). Either the time of last
+         * update or creation if no updates available.
+         */
+        user_modified_timestamp: number;
+    }
+    namespace Item {
+        interface Tags {
+            dynamic_variables?: {
+                [key: string]: string;
+            };
+            version?: number;
+        }
+    }
+}
+export type AgentCreateVersionResponse = AgentResponse | ChatAgentAPI.ChatAgentResponse;
+export interface AgentListVersionsResponse {
+    /**
+     * Whether more results are available.
+     */
+    has_more: boolean;
+    items: Array<AgentListVersionsResponse.Item>;
+    /**
+     * Pagination key for the next page.
+     */
+    pagination_key?: string;
+}
+export declare namespace AgentListVersionsResponse {
+    interface Item {
+        /**
+         * Whether the agent version is published.
+         */
+        is_published: boolean;
+        /**
+         * Last modification timestamp in milliseconds since epoch.
+         */
+        last_modification_timestamp: number;
+        /**
+         * Version number of the agent.
+         */
+        version: number;
+        /**
+         * Version that this agent version was based on.
+         */
+        base_version?: number;
+        /**
+         * Optional description of the agent version.
+         */
+        version_description?: string;
+        /**
+         * Optional title of the agent version.
+         */
+        version_title?: string;
+    }
+}
+export type AgentRepairResponse = AgentResponse | ChatAgentAPI.ChatAgentResponse;
+export interface AgentCreateParams {
+    /**
+     * The Response Engine to attach to the agent. It is used to generate responses for
+     * the agent. You need to create a Response Engine first before attaching it to an
+     * agent.
+     */
+    response_engine: AgentCreateParams.ResponseEngineRetellLm | AgentCreateParams.ResponseEngineCustomLm | AgentCreateParams.ResponseEngineConversationFlow;
+    /**
+     * Unique voice id used for the agent. Find list of available voices and their
+     * preview in Dashboard.
+     */
+    voice_id: string;
+    /**
+     * The name of the agent. Only used for your own reference.
+     */
+    agent_name?: string | null;
+    /**
      * If set to true, DTMF input will interrupt the agent even when
      * interruption_sensitivity is 0. Can be overridden per conversation or subagent
      * node. Default to false.
@@ -1048,6 +1947,14 @@ export interface AgentCreateParams {
      * disable call screen prompt instructions.
      */
     call_screening_option?: AgentCreateParams.CallScreeningOption | null;
+    /**
+     * Contact memory settings for phone calls and SMS chats. Creating an agent
+     * defaults enable_update to false and enable_read to true. Updates only change the
+     * supplied flags; omitted flags stay unchanged and an empty object has no effect.
+     * Set a flag to false to disable it. The configuration cannot be cleared. Existing
+     * agents without this configuration have both disabled.
+     */
+    contact_memory_config?: AgentCreateParams.ContactMemoryConfig;
     /**
      * Custom STT configuration. Only used when stt_mode is set to custom.
      */
@@ -1082,6 +1989,13 @@ export interface AgentCreateParams {
      * will not backchannel.
      */
     enable_backchannel?: boolean;
+    /**
+     * If set to true, the agent recognizes requests to stop calling or contacting the
+     * user, confirms once, and on a clear yes ends the call with disconnection reason
+     * user_requested_dnc and sets do_not_call to true on the contact for the user's
+     * phone number. If unset, default value false will apply.
+     */
+    enable_dnc_detection?: boolean;
     /**
      * If set to true, the agent will dynamically adjust how quickly it responds based
      * on the user's speech rate and past turn-taking behavior in the call. If unset,
@@ -1182,7 +2096,23 @@ export interface AgentCreateParams {
     /**
      * The model to use for post call analysis. Default to gpt-5.6-terra.
      */
-    post_call_analysis_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;
+    post_call_analysis_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;
+    /**
+     * Integration (Agent Functions) tools run as a dependency graph during teardown,
+     * after post-call analysis. Each tool can be gated by a condition. On calls the
+     * graph is stopped after five minutes so teardown can finish. Set to null to
+     * clear.
+     */
+    post_session_tools?: Array<AgentCreateParams.AppTool | AgentCreateParams.CustomTool | AgentCreateParams.CodeTool | AgentCreateParams.SendSMSTool> | null;
+    /**
+     * Integration (Agent Functions) tools run as a dependency graph during session
+     * setup, before the agent's first message. Outputs are injected as dynamic
+     * variables. On calls the graph gets one minute unless an outbound caller will be
+     * dialed after setup, in which case it gets five minutes. Past that session
+     * initialization continues and any remaining tools finish in the background, so
+     * their outputs no longer reach the agent's prompt. Set to null to clear.
+     */
+    pre_session_tools?: Array<AgentCreateParams.AppTool | AgentCreateParams.CustomTool | AgentCreateParams.CodeTool> | null;
     /**
      * A list of words / phrases and their pronunciation to be used to guide the audio
      * synthesize for consistent pronunciation. Check the dashboard to see what
@@ -1247,367 +2177,1235 @@ export interface AgentCreateParams {
      * Default to general.
      */
     vocab_specialization?: 'general' | 'medical';
-    /**
-     * Controls the emotional tone of the agent's voice. Currently supported for
-     * Cartesia and Minimax TTS providers. If unset, no emotion will be used.
-     */
-    voice_emotion?: 'calm' | 'sympathetic' | 'happy' | 'sad' | 'angry' | 'fearful' | 'surprised' | null;
     /**
      * Select the voice model used for the selected voice. Each provider has a set of
      * available voice models. Set to null to remove voice model selection, and default
      * ones will apply. Check out dashboard for more details of each voice model.
      */
-    voice_model?: 'eleven_flash_v2' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'sonic-3' | 'sonic-3-latest' | 'sonic-3.5' | 'sonic-3.6' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | 's2.1-pro' | 'inworld-tts-2' | 'inworld-tts-2-flash' | null;
+    voice_model?: 'eleven_flash_v2' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'eleven_v4_turbo' | 'sonic-3' | 'sonic-3-latest' | 'sonic-3.5' | 'sonic-3.6' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | 's2.1-pro' | 'inworld-tts-2' | 'inworld-tts-2-flash' | null;
+    /**
+     * Controls speed of voice. Value ranging from [0.5,2]. Lower value means slower
+     * speech, while higher value means faster speech rate. If unset, default value 1
+     * will apply.
+     */
+    voice_speed?: number;
+    /**
+     * Controls how stable the voice is. Value ranging from [0,2]. Lower value means
+     * more stable, and higher value means more variant speech generation. Check the
+     * dashboard to see what provider supports this feature. If unset, default value 1
+     * will apply.
+     */
+    voice_temperature?: number;
+    /**
+     * If this option is set, the call will try to detect voicemail in the first 3
+     * minutes of the call. Actions defined (hangup, or leave a message) will be
+     * applied when the voicemail is detected. Set this to null to disable voicemail
+     * detection.
+     */
+    voicemail_option?: AgentCreateParams.VoicemailOption | null;
+    /**
+     * If set, will control the volume of the agent. Value ranging from [0,2]. Lower
+     * value means quieter agent speech, while higher value means louder agent speech.
+     * If unset, default value 1 will apply.
+     */
+    volume?: number;
+    /**
+     * Which webhook events this agent should receive. If not set, defaults to
+     * call_started, call_ended, call_analyzed.
+     */
+    webhook_events?: Array<'call_started' | 'call_ended' | 'call_analyzed' | 'transcript_updated' | 'transfer_started' | 'transfer_bridged' | 'transfer_cancelled' | 'transfer_ended'> | null;
+    /**
+     * The timeout for the webhook in milliseconds. If not set, default value of 10000
+     * will apply.
+     */
+    webhook_timeout_ms?: number;
+    /**
+     * The webhook for agent to listen to call events. See what events it would get at
+     * [webhook doc](/features/webhook). If set, will binds webhook events for this
+     * agent to the specified url, and will ignore the account level webhook for this
+     * agent. Set to `null` to remove webhook url from this agent.
+     */
+    webhook_url?: string | null;
+}
+export declare namespace AgentCreateParams {
+    interface ResponseEngineRetellLm {
+        /**
+         * id of the Retell LLM Response Engine.
+         */
+        llm_id: string;
+        /**
+         * type of the Response Engine.
+         */
+        type: 'retell-llm';
+        /**
+         * Version of the Retell LLM Response Engine.
+         */
+        version?: number | null;
+    }
+    interface ResponseEngineCustomLm {
+        /**
+         * LLM websocket url of the custom LLM.
+         */
+        llm_websocket_url: string;
+        /**
+         * type of the Response Engine.
+         */
+        type: 'custom-llm';
+    }
+    interface ResponseEngineConversationFlow {
+        /**
+         * ID of the Conversation Flow Response Engine.
+         */
+        conversation_flow_id: string;
+        /**
+         * type of the Response Engine.
+         */
+        type: 'conversation-flow';
+        /**
+         * Version of the Conversation Flow Response Engine.
+         */
+        version?: number | null;
+    }
+    /**
+     * If this option is set, the agent prompt will include call screen handling
+     * instructions for identity and call purpose questions. Set this to null to
+     * disable call screen prompt instructions.
+     */
+    interface CallScreeningOption {
+        /**
+         * Identity the agent should provide when a call screen asks who is calling.
+         * Dynamic variables are supported.
+         */
+        agent_identity: string;
+        /**
+         * Purpose the agent should provide when a call screen asks why it is calling.
+         * Dynamic variables are supported.
+         */
+        call_purpose: string;
+    }
     /**
-     * Controls speed of voice. Value ranging from [0.5,2]. Lower value means slower
-     * speech, while higher value means faster speech rate. If unset, default value 1
-     * will apply.
+     * Contact memory settings for phone calls and SMS chats. Creating an agent
+     * defaults enable_update to false and enable_read to true. Updates only change the
+     * supplied flags; omitted flags stay unchanged and an empty object has no effect.
+     * Set a flag to false to disable it. The configuration cannot be cleared. Existing
+     * agents without this configuration have both disabled.
      */
-    voice_speed?: number;
+    interface ContactMemoryConfig {
+        /**
+         * Automatically add saved contact memory to the agent prompt. Skippable nodes can
+         * use answers from the current conversation even when this setting is disabled.
+         * Contact dynamic variables, including contact_memory, remain available regardless
+         * of this setting.
+         */
+        enable_read?: boolean;
+        /**
+         * Rewrite the contact memory after each conversation. Requires storing
+         * conversation data. Chat agents must also have end_chat_after_silence_ms set.
+         */
+        enable_update?: boolean;
+    }
     /**
-     * Controls how stable the voice is. Value ranging from [0,2]. Lower value means
-     * more stable, and higher value means more variant speech generation. Check the
-     * dashboard to see what provider supports this feature. If unset, default value 1
-     * will apply.
+     * Custom STT configuration. Only used when stt_mode is set to custom.
      */
-    voice_temperature?: number;
+    interface CustomSttConfig {
+        /**
+         * Endpointing timeout in milliseconds. Minimum is 100 for Azure, 10 for Deepgram,
+         * 500 for Soniox, 100 for AssemblyAI, 100 for Muse. For AssemblyAI, this sets
+         * min_turn_silence (100-3000 ms). max_turn_silence adds half of this value,
+         * rounded to the nearest millisecond and bounded to 500-1000 ms, with a total cap
+         * of 3000 ms. Muse detects turn ends itself and ignores this value.
+         */
+        endpointing_ms: number;
+        /**
+         * ASR provider name.
+         */
+        provider: 'azure' | 'deepgram' | 'soniox' | 'assemblyai' | 'muse';
+    }
     /**
-     * If this option is set, the call will try to detect voicemail in the first 3
-     * minutes of the call. Actions defined (hangup, or leave a message) will be
-     * applied when the voicemail is detected. Set this to null to disable voicemail
-     * detection.
+     * Configuration for guardrail checks to detect and prevent prohibited topics in
+     * agent output and user input.
      */
-    voicemail_option?: AgentCreateParams.VoicemailOption | null;
+    interface GuardrailConfig {
+        /**
+         * Selected prohibited user topic categories to check. When user messages contain
+         * these topics, the agent will respond with a placeholder message instead of
+         * processing the request.
+         */
+        input_topics?: Array<'platform_integrity_jailbreaking'> | null;
+        /**
+         * Selected prohibited agent topic categories to check. When agent messages contain
+         * these topics, they will be replaced with a placeholder message.
+         */
+        output_topics?: Array<'harassment' | 'self_harm' | 'sexual_exploitation' | 'violence' | 'defense_and_national_security' | 'illicit_and_harmful_activity' | 'gambling' | 'regulated_professional_advice' | 'child_safety_and_exploitation'> | null;
+    }
     /**
-     * If set, will control the volume of the agent. Value ranging from [0,2]. Lower
-     * value means quieter agent speech, while higher value means louder agent speech.
-     * If unset, default value 1 will apply.
+     * Toggle behavior presets on/off to influence agent response style and behaviors.
      */
-    volume?: number;
+    interface HandbookConfig {
+        /**
+         * When asked, acknowledge being a virtual assistant.
+         */
+        ai_disclosure?: boolean;
+        /**
+         * Enables Conversational Personality. When true, the agent uses the Conversational
+         * Personality handbook preset, skips Professional Rep Personality during prompt
+         * assembly, and enables internal colloquial rewrite behavior.
+         */
+        conversational_personality?: boolean;
+        /**
+         * Professional call center rep baseline.
+         */
+        default_personality?: boolean;
+        /**
+         * Repeat back and confirm important details (voice only).
+         */
+        echo_verification?: boolean;
+        /**
+         * Warm acknowledgment of caller concerns.
+         */
+        high_empathy?: boolean;
+        /**
+         * Spell using NATO phonetic alphabet style (voice only).
+         */
+        nato_phonetic_alphabet?: boolean;
+        /**
+         * Sprinkle natural speech fillers like "um", "you know" for a more human,
+         * conversational tone.
+         */
+        natural_filler_words?: boolean;
+        /**
+         * Stay within prompt/context scope, don't invent details.
+         */
+        scope_boundaries?: boolean;
+        /**
+         * Treat near-match similar words as same entity to reduce impact of transcription
+         * error (voice only).
+         */
+        smart_matching?: boolean;
+        /**
+         * Convert numbers/dates/currency to spoken forms (voice only).
+         */
+        speech_normalization?: boolean;
+    }
     /**
-     * Which webhook events this agent should receive. If not set, defaults to
-     * call_started, call_ended, call_analyzed.
+     * If this option is set, the call will try to detect IVR in the first 3 minutes of
+     * the call. Actions defined will be applied when the IVR is detected. Set this to
+     * null to disable IVR detection.
      */
-    webhook_events?: Array<'call_started' | 'call_ended' | 'call_analyzed' | 'transcript_updated' | 'transfer_started' | 'transfer_bridged' | 'transfer_cancelled' | 'transfer_ended'> | null;
+    interface IvrOption {
+        action: IvrOption.Action;
+        /**
+         * Optionally describe what should be treated as an IVR. Leave as null to use the
+         * default definition.
+         */
+        detection_prompt?: string | null;
+    }
+    namespace IvrOption {
+        interface Action {
+            type: 'hangup';
+        }
+    }
     /**
-     * The timeout for the webhook in milliseconds. If not set, default value of 10000
-     * will apply.
+     * Configuration for PII scrubbing from transcripts and recordings.
      */
-    webhook_timeout_ms?: number;
+    interface PiiConfig {
+        /**
+         * List of PII categories to scrub from transcripts and recordings. PII redaction
+         * is only active when this list is non-empty; an empty array means no PII
+         * scrubbing is performed.
+         */
+        categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth' | 'customer_account_number'>;
+        /**
+         * The processing mode for PII scrubbing. Currently only post-call is supported.
+         */
+        mode: 'post_call';
+    }
+    interface StringAnalysisData {
+        /**
+         * Description of the variable.
+         */
+        description: string;
+        /**
+         * Name of the variable.
+         */
+        name: string;
+        /**
+         * 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.
+         */
+        examples?: Array<string>;
+        /**
+         * Whether this data is required. If true and the data is not extracted, the call
+         * will be marked as unsuccessful.
+         */
+        required?: boolean;
+    }
+    interface EnumAnalysisData {
+        /**
+         * The possible values of the variable, must be non empty array.
+         */
+        choices: Array<string>;
+        /**
+         * Description of the variable.
+         */
+        description: string;
+        /**
+         * Name of the variable.
+         */
+        name: string;
+        /**
+         * 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.
+         */
+        required?: boolean;
+    }
+    interface BooleanAnalysisData {
+        /**
+         * Description of the variable.
+         */
+        description: string;
+        /**
+         * Name of the variable.
+         */
+        name: string;
+        /**
+         * 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.
+         */
+        required?: boolean;
+    }
+    interface NumberAnalysisData {
+        /**
+         * Description of the variable.
+         */
+        description: string;
+        /**
+         * Name of the variable.
+         */
+        name: string;
+        /**
+         * 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.
+         */
+        required?: boolean;
+    }
     /**
-     * The webhook for agent to listen to call events. See what events it would get at
-     * [webhook doc](/features/webhook). If set, will binds webhook events for this
-     * agent to the specified url, and will ignore the account level webhook for this
-     * agent. Set to `null` to remove webhook url from this agent.
+     * System preset for post-call analysis (voice agents). Use in
+     * post_call_analysis_data to override prompts or mark fields optional.
      */
-    webhook_url?: string | null;
-}
-export declare namespace AgentCreateParams {
-    interface ResponseEngineRetellLm {
+    interface CallPresetAnalysisData {
         /**
-         * id of the Retell LLM Response Engine.
+         * Preset identifier for voice agent analysis.
          */
-        llm_id: string;
+        name: 'call_summary' | 'call_successful' | 'user_sentiment';
         /**
-         * type of the Response Engine.
+         * Identifies this item as a system preset.
          */
-        type: 'retell-llm';
+        type: 'system-presets';
         /**
-         * Version of the Retell LLM Response Engine.
+         * Optional instruction to help decide whether this field needs to be populated. If
+         * not set, the field is always included.
          */
-        version?: number | null;
-    }
-    interface ResponseEngineCustomLm {
+        conditional_prompt?: string;
         /**
-         * LLM websocket url of the custom LLM.
+         * Prompt or description for this preset.
          */
-        llm_websocket_url: string;
+        description?: string;
         /**
-         * type of the Response Engine.
+         * If false, this field is optional in the analysis. If true or unset, the field is
+         * required.
          */
-        type: 'custom-llm';
+        required?: boolean;
     }
-    interface ResponseEngineConversationFlow {
+    interface AppTool {
         /**
-         * ID of the Conversation Flow Response Engine.
+         * The connection (App) this tool runs against. Must be a connection in the
+         * organization whose provider matches this tool's provider.
          */
-        conversation_flow_id: string;
+        app_id: string;
         /**
-         * type of the Response Engine.
+         * Name of the catalog template within the provider, as listed by
+         * list-app-templates.
          */
-        type: 'conversation-flow';
+        app_tool_template_name: string;
         /**
-         * Version of the Conversation Flow Response Engine.
+         * Name of the tool. Must be unique within the phase's tools; referenced by
+         * depends_on.
          */
-        version?: number | null;
+        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';
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        condition?: AppTool.Condition;
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * 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;
     }
-    /**
-     * If this option is set, the agent prompt will include call screen handling
-     * instructions for identity and call purpose questions. Set this to null to
-     * disable call screen prompt instructions.
-     */
-    interface CallScreeningOption {
+    namespace AppTool {
         /**
-         * Identity the agent should provide when a call screen asks who is calling.
-         * Dynamic variables are supported.
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
          */
-        agent_identity: string;
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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 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';
+        }
         /**
-         * Purpose the agent should provide when a call screen asks why it is calling.
-         * Dynamic variables are supported.
+         * 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.
          */
-        call_purpose: string;
+        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>;
+        }
     }
-    /**
-     * Custom STT configuration. Only used when stt_mode is set to custom.
-     */
-    interface CustomSttConfig {
+    interface CustomTool {
         /**
-         * Endpointing timeout in milliseconds. Minimum is 100 for Azure, 10 for Deepgram,
-         * 500 for Soniox, 100 for AssemblyAI. For AssemblyAI, this sets min_turn_silence
-         * (100-3000 ms). max_turn_silence adds half of this value, rounded to the nearest
-         * millisecond and bounded to 500-1000 ms, with a total cap of 3000 ms.
+         * 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).
          */
-        endpointing_ms: number;
+        name: string;
+        type: 'custom';
         /**
-         * ASR provider name.
+         * 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;
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        condition?: CustomTool.Condition;
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * Describes what this tool does and when to call this tool.
+         */
+        description?: string;
+        /**
+         * 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;
+        /**
+         * 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;
+        };
+        /**
+         * Maximum number of times to retry the request after a failed attempt, from 0 (no
+         * retry) to 5. Retries happen on any failure, with exponential backoff between
+         * attempts; the backoff delay is not configurable. `timeout_ms` applies per
+         * attempt rather than as a budget across all attempts, so an attempt that times
+         * out is still retried and the worst-case total duration is `timeout_ms`
+         * multiplied by (`max_retry` + 1) as well as any latency incurred by the
+         * exponential backoff + jitter between each retry. Only the final attempt's result
+         * is reported to the agent. Because retries repeat the request, only set this
+         * above 0 if your endpoint is idempotent — a retried request may be processed more
+         * than once. Defaults to 0 (no retry).
+         */
+        max_retry?: number;
+        /**
+         * Method to use for the request, default to POST.
+         */
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        /**
+         * How the tool's `parameters` are authored and shown in the dashboard editor —
+         * "form" for the visual parameter builder, "json" for a raw JSON Schema. Both
+         * produce the same `parameters` schema; this does not change how the request body
+         * is encoded (see `args_at_root`).
+         */
+        parameter_type?: 'json' | 'form';
+        /**
+         * 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.
          */
-        provider: 'azure' | 'deepgram' | 'soniox' | 'assemblyai';
+        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;
     }
-    /**
-     * Configuration for guardrail checks to detect and prevent prohibited topics in
-     * agent output and user input.
-     */
-    interface GuardrailConfig {
+    namespace CustomTool {
         /**
-         * Selected prohibited user topic categories to check. When user messages contain
-         * these topics, the agent will respond with a placeholder message instead of
-         * processing the request.
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
          */
-        input_topics?: Array<'platform_integrity_jailbreaking'> | null;
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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;
+            }
+        }
         /**
-         * Selected prohibited agent topic categories to check. When agent messages contain
-         * these topics, they will be replaced with a placeholder message.
+         * 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.
          */
-        output_topics?: Array<'harassment' | 'self_harm' | 'sexual_exploitation' | 'violence' | 'defense_and_national_security' | 'illicit_and_harmful_activity' | 'gambling' | 'regulated_professional_advice' | 'child_safety_and_exploitation'> | null;
+        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: 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>;
+        }
     }
-    /**
-     * Toggle behavior presets on/off to influence agent response style and behaviors.
-     */
-    interface HandbookConfig {
+    interface CodeTool {
         /**
-         * When asked, acknowledge being a virtual assistant.
+         * JavaScript code to execute in the sandbox.
          */
-        ai_disclosure?: boolean;
+        code: string;
         /**
-         * Enables Conversational Personality. When true, the agent uses the Conversational
-         * Personality handbook preset, skips Professional Rep Personality during prompt
-         * assembly, and enables internal colloquial rewrite behavior.
+         * 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).
          */
-        conversational_personality?: boolean;
+        name: string;
+        type: 'code';
         /**
-         * Professional call center rep baseline.
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
          */
-        default_personality?: boolean;
+        condition?: CodeTool.Condition;
         /**
-         * Repeat back and confirm important details (voice only).
+         * Names of tools that must run before this one.
          */
-        echo_verification?: boolean;
+        depends_on?: Array<string>;
         /**
-         * Warm acknowledgment of caller concerns.
+         * Describes what this tool does and when to call this tool.
          */
-        high_empathy?: boolean;
+        description?: string;
         /**
-         * Spell using NATO phonetic alphabet style (voice only).
+         * If true, play a typing sound on the agent audio track while this tool is
+         * executing.
          */
-        nato_phonetic_alphabet?: boolean;
+        enable_typing_sound?: boolean;
         /**
-         * Sprinkle natural speech fillers like "um", "you know" for a more human,
-         * conversational tone.
+         * The description for the sentence agent say during execution. Only applicable
+         * when speak_during_execution is true.
          */
-        natural_filler_words?: boolean;
+        execution_message_description?: string;
         /**
-         * Stay within prompt/context scope, don't invent details.
+         * 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".
          */
-        scope_boundaries?: boolean;
+        execution_message_type?: 'prompt' | 'static_text';
         /**
-         * Treat near-match similar words as same entity to reduce impact of transcription
-         * error (voice only).
+         * A mapping of variable names to JSON paths in the code execution result. These
+         * mapped values will be extracted and added as dynamic variables.
          */
-        smart_matching?: boolean;
+        response_variables?: {
+            [key: string]: string;
+        };
         /**
-         * Convert numbers/dates/currency to spoken forms (voice only).
+         * Determines whether the agent would call LLM another time and speak when the
+         * result of function is obtained.
          */
-        speech_normalization?: boolean;
+        speak_after_execution?: boolean;
+        /**
+         * Determines whether the agent would say sentence like "One moment, let me check
+         * that." when executing the tool.
+         */
+        speak_during_execution?: boolean;
+        /**
+         * The maximum time in milliseconds the code can run before it's considered
+         * timeout. Defaults to 30,000 ms (30 s).
+         */
+        timeout_ms?: number;
     }
-    /**
-     * If this option is set, the call will try to detect IVR in the first 3 minutes of
-     * the call. Actions defined will be applied when the IVR is detected. Set this to
-     * null to disable IVR detection.
-     */
-    interface IvrOption {
-        action: IvrOption.Action;
+    namespace CodeTool {
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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 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 | SendSMSTool.SMSContentTemplate;
+        type: 'send_sms';
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        condition?: SendSMSTool.Condition;
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * Describes what the tool does, sometimes can also include information about when
+         * 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 {
+            /**
+             * The static message to be sent in the SMS. Can contain dynamic variables.
+             */
+            text?: string;
+            type?: 'predefined';
+        }
+        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';
+        }
+        interface SMSContentTemplate {
+            /**
+             * The template to use for the SMS content. "info_collection" sends a predefined
+             * message requesting information from the user.
+             */
+            template: 'info_collection';
+            type: 'template';
+        }
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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 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';
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * 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>;
         /**
-         * Optionally describe what should be treated as an IVR. Leave as null to use the
-         * default definition.
+         * Mapping of a dynamic-variable name to the response field (dot-path) it is
+         * populated from. Missing paths are ignored.
          */
-        detection_prompt?: string | null;
+        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 IvrOption {
-        interface Action {
-            type: 'hangup';
+    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>;
         }
     }
-    /**
-     * Configuration for PII scrubbing from transcripts and recordings.
-     */
-    interface PiiConfig {
+    interface CustomTool {
         /**
-         * List of PII categories to scrub from transcripts and recordings. PII redaction
-         * is only active when this list is non-empty; an empty array means no PII
-         * scrubbing is performed.
+         * 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).
          */
-        categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth' | 'customer_account_number'>;
+        name: string;
+        type: 'custom';
         /**
-         * The processing mode for PII scrubbing. Currently only post-call is supported.
+         * Describes what the tool does, sometimes can also include information about when
+         * to call the tool.
          */
-        mode: 'post_call';
-    }
-    interface StringAnalysisData {
+        url: string;
         /**
-         * Description of the variable.
+         * If set to true, the parameters will be passed as root level JSON object instead
+         * of nested under "args".
          */
-        description: string;
+        args_at_root?: boolean;
         /**
-         * Name of the variable.
+         * Names of tools that must run before this one.
          */
-        name: string;
+        depends_on?: Array<string>;
         /**
-         * Type of the variable to extract.
+         * Describes what this tool does and when to call this tool.
          */
-        type: 'string';
+        description?: 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.
+         * 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.
          */
-        conditional_prompt?: string;
+        enable_typing_sound?: boolean;
         /**
-         * Examples of the variable value to teach model the style and syntax.
+         * 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.".
          */
-        examples?: Array<string>;
+        execution_message_description?: string;
         /**
-         * Whether this data is required. If true and the data is not extracted, the call
-         * will be marked as unsuccessful.
+         * 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".
          */
-        required?: boolean;
-    }
-    interface EnumAnalysisData {
+        execution_message_type?: 'prompt' | 'static_text';
         /**
-         * The possible values of the variable, must be non empty array.
+         * Headers to add to the request.
          */
-        choices: Array<string>;
+        headers?: {
+            [key: string]: string;
+        };
         /**
-         * Description of the variable.
+         * Maximum number of times to retry the request after a failed attempt, from 0 (no
+         * retry) to 5. Retries happen on any failure, with exponential backoff between
+         * attempts; the backoff delay is not configurable. `timeout_ms` applies per
+         * attempt rather than as a budget across all attempts, so an attempt that times
+         * out is still retried and the worst-case total duration is `timeout_ms`
+         * multiplied by (`max_retry` + 1) as well as any latency incurred by the
+         * exponential backoff + jitter between each retry. Only the final attempt's result
+         * is reported to the agent. Because retries repeat the request, only set this
+         * above 0 if your endpoint is idempotent — a retried request may be processed more
+         * than once. Defaults to 0 (no retry).
          */
-        description: string;
+        max_retry?: number;
         /**
-         * Name of the variable.
+         * Method to use for the request, default to POST.
          */
-        name: string;
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
         /**
-         * Type of the variable to extract.
+         * How the tool's `parameters` are authored and shown in the dashboard editor —
+         * "form" for the visual parameter builder, "json" for a raw JSON Schema. Both
+         * produce the same `parameters` schema; this does not change how the request body
+         * is encoded (see `args_at_root`).
          */
-        type: 'enum';
+        parameter_type?: 'json' | 'form';
         /**
-         * 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.
+         * 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.
          */
-        conditional_prompt?: string;
+        parameters?: CustomTool.Parameters;
         /**
-         * Whether this data is required. If true and the data is not extracted, the call
-         * will be marked as unsuccessful.
+         * Query parameters to append to the request URL.
          */
-        required?: boolean;
-    }
-    interface BooleanAnalysisData {
+        query_params?: {
+            [key: string]: string;
+        };
         /**
-         * Description of the variable.
+         * 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.
          */
-        description: string;
+        response_variables?: {
+            [key: string]: string;
+        };
         /**
-         * Name of the variable.
+         * 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.
          */
-        name: string;
+        speak_after_execution?: boolean;
         /**
-         * Type of the variable to extract.
+         * 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.
          */
-        type: 'boolean';
+        speak_during_execution?: 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.
+         * 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).
          */
-        conditional_prompt?: string;
+        timeout_ms?: number;
+    }
+    namespace CustomTool {
         /**
-         * Whether this data is required. If true and the data is not extracted, the call
-         * will be marked as unsuccessful.
+         * 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.
          */
-        required?: boolean;
+        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: 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 NumberAnalysisData {
+    interface CodeTool {
         /**
-         * Description of the variable.
+         * JavaScript code to execute in the sandbox.
          */
-        description: string;
+        code: string;
         /**
-         * Name of the variable.
+         * 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: 'code';
         /**
-         * Type of the variable to extract.
+         * Names of tools that must run before this one.
          */
-        type: 'number';
+        depends_on?: Array<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.
+         * Describes what this tool does and when to call this tool.
          */
-        conditional_prompt?: string;
+        description?: string;
         /**
-         * Whether this data is required. If true and the data is not extracted, the call
-         * will be marked as unsuccessful.
+         * If true, play a typing sound on the agent audio track while this tool is
+         * executing.
          */
-        required?: boolean;
-    }
-    /**
-     * System preset for post-call analysis (voice agents). Use in
-     * post_call_analysis_data to override prompts or mark fields optional.
-     */
-    interface CallPresetAnalysisData {
+        enable_typing_sound?: boolean;
         /**
-         * Preset identifier for voice agent analysis.
+         * The description for the sentence agent say during execution. Only applicable
+         * when speak_during_execution is true.
          */
-        name: 'call_summary' | 'call_successful' | 'user_sentiment';
+        execution_message_description?: string;
         /**
-         * Identifies this item as a system preset.
+         * 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".
          */
-        type: 'system-presets';
+        execution_message_type?: 'prompt' | 'static_text';
         /**
-         * Optional instruction to help decide whether this field needs to be populated. If
-         * not set, the field is always included.
+         * A mapping of variable names to JSON paths in the code execution result. These
+         * mapped values will be extracted and added as dynamic variables.
          */
-        conditional_prompt?: string;
+        response_variables?: {
+            [key: string]: string;
+        };
         /**
-         * Prompt or description for this preset.
+         * Determines whether the agent would call LLM another time and speak when the
+         * result of function is obtained.
          */
-        description?: string;
+        speak_after_execution?: boolean;
         /**
-         * If false, this field is optional in the analysis. If true or unset, the field is
-         * required.
+         * Determines whether the agent would say sentence like "One moment, let me check
+         * that." when executing the tool.
          */
-        required?: boolean;
+        speak_during_execution?: boolean;
+        /**
+         * The maximum time in milliseconds the code can run before it's considered
+         * timeout. Defaults to 30,000 ms (30 s).
+         */
+        timeout_ms?: number;
     }
     interface PronunciationDictionary {
         /**
@@ -1771,6 +3569,14 @@ export interface AgentUpdateParams {
      * to disable call screen prompt instructions.
      */
     call_screening_option?: AgentUpdateParams.CallScreeningOption | null;
+    /**
+     * Body param: Contact memory settings for phone calls and SMS chats. Creating an
+     * agent defaults enable_update to false and enable_read to true. Updates only
+     * change the supplied flags; omitted flags stay unchanged and an empty object has
+     * no effect. Set a flag to false to disable it. The configuration cannot be
+     * cleared. Existing agents without this configuration have both disabled.
+     */
+    contact_memory_config?: AgentUpdateParams.ContactMemoryConfig;
     /**
      * Body param: Custom STT configuration. Only used when stt_mode is set to custom.
      */
@@ -1805,6 +3611,13 @@ export interface AgentUpdateParams {
      * set, agent will not backchannel.
      */
     enable_backchannel?: boolean;
+    /**
+     * Body param: If set to true, the agent recognizes requests to stop calling or
+     * contacting the user, confirms once, and on a clear yes ends the call with
+     * disconnection reason user_requested_dnc and sets do_not_call to true on the
+     * contact for the user's phone number. If unset, default value false will apply.
+     */
+    enable_dnc_detection?: boolean;
     /**
      * Body param: If set to true, the agent will dynamically adjust how quickly it
      * responds based on the user's speech rate and past turn-taking behavior in the
@@ -1908,7 +3721,23 @@ export interface AgentUpdateParams {
     /**
      * Body param: The model to use for post call analysis. Default to gpt-5.6-terra.
      */
-    post_call_analysis_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;
+    post_call_analysis_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: Integration (Agent Functions) tools run as a dependency graph during
+     * teardown, after post-call analysis. Each tool can be gated by a condition. On
+     * calls the graph is stopped after five minutes so teardown can finish. Set to
+     * null to clear.
+     */
+    post_session_tools?: Array<AgentUpdateParams.AppTool | AgentUpdateParams.CustomTool | AgentUpdateParams.CodeTool | AgentUpdateParams.SendSMSTool> | null;
+    /**
+     * Body param: Integration (Agent Functions) tools run as a dependency graph during
+     * session setup, before the agent's first message. Outputs are injected as dynamic
+     * variables. On calls the graph gets one minute unless an outbound caller will be
+     * dialed after setup, in which case it gets five minutes. Past that session
+     * initialization continues and any remaining tools finish in the background, so
+     * their outputs no longer reach the agent's prompt. Set to null to clear.
+     */
+    pre_session_tools?: Array<AgentUpdateParams.AppTool | AgentUpdateParams.CustomTool | AgentUpdateParams.CodeTool> | null;
     /**
      * Body param: A list of words / phrases and their pronunciation to be used to
      * guide the audio synthesize for consistent pronunciation. Check the dashboard to
@@ -1984,12 +3813,6 @@ export interface AgentUpdateParams {
      * a no-op. Default to general.
      */
     vocab_specialization?: 'general' | 'medical';
-    /**
-     * Body param: Controls the emotional tone of the agent's voice. Currently
-     * supported for Cartesia and Minimax TTS providers. If unset, no emotion will be
-     * used.
-     */
-    voice_emotion?: 'calm' | 'sympathetic' | 'happy' | 'sad' | 'angry' | 'fearful' | 'surprised' | null;
     /**
      * Body param: Unique voice id used for the agent. Find list of available voices
      * and their preview in Dashboard.
@@ -2001,7 +3824,7 @@ export interface AgentUpdateParams {
      * selection, and default ones will apply. Check out dashboard for more details of
      * each voice model.
      */
-    voice_model?: 'eleven_flash_v2' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'sonic-3' | 'sonic-3-latest' | 'sonic-3.5' | 'sonic-3.6' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | 's2.1-pro' | 'inworld-tts-2' | 'inworld-tts-2-flash' | null;
+    voice_model?: 'eleven_flash_v2' | 'eleven_flash_v2_5' | 'eleven_multilingual_v2' | 'eleven_v3' | 'eleven_v4_turbo' | 'sonic-3' | 'sonic-3-latest' | 'sonic-3.5' | 'sonic-3.6' | 'tts-1' | 'gpt-4o-mini-tts' | 'speech-02-turbo' | 'speech-2.8-turbo' | 's1' | 's2-pro' | 's2.1-pro' | 'inworld-tts-2' | 'inworld-tts-2-flash' | null;
     /**
      * Body param: Controls speed of voice. Value ranging from [0.5,2]. Lower value
      * means slower speech, while higher value means faster speech rate. If unset,
@@ -2048,272 +3871,1145 @@ export interface AgentUpdateParams {
 }
 export declare namespace AgentUpdateParams {
     /**
-     * If this option is set, the agent prompt will include call screen handling
-     * instructions for identity and call purpose questions. Set this to null to
-     * disable call screen prompt instructions.
+     * If this option is set, the agent prompt will include call screen handling
+     * instructions for identity and call purpose questions. Set this to null to
+     * disable call screen prompt instructions.
+     */
+    interface CallScreeningOption {
+        /**
+         * Identity the agent should provide when a call screen asks who is calling.
+         * Dynamic variables are supported.
+         */
+        agent_identity: string;
+        /**
+         * Purpose the agent should provide when a call screen asks why it is calling.
+         * Dynamic variables are supported.
+         */
+        call_purpose: string;
+    }
+    /**
+     * Contact memory settings for phone calls and SMS chats. Creating an agent
+     * defaults enable_update to false and enable_read to true. Updates only change the
+     * supplied flags; omitted flags stay unchanged and an empty object has no effect.
+     * Set a flag to false to disable it. The configuration cannot be cleared. Existing
+     * agents without this configuration have both disabled.
+     */
+    interface ContactMemoryConfig {
+        /**
+         * Automatically add saved contact memory to the agent prompt. Skippable nodes can
+         * use answers from the current conversation even when this setting is disabled.
+         * Contact dynamic variables, including contact_memory, remain available regardless
+         * of this setting.
+         */
+        enable_read?: boolean;
+        /**
+         * Rewrite the contact memory after each conversation. Requires storing
+         * conversation data. Chat agents must also have end_chat_after_silence_ms set.
+         */
+        enable_update?: boolean;
+    }
+    /**
+     * Custom STT configuration. Only used when stt_mode is set to custom.
+     */
+    interface CustomSttConfig {
+        /**
+         * Endpointing timeout in milliseconds. Minimum is 100 for Azure, 10 for Deepgram,
+         * 500 for Soniox, 100 for AssemblyAI, 100 for Muse. For AssemblyAI, this sets
+         * min_turn_silence (100-3000 ms). max_turn_silence adds half of this value,
+         * rounded to the nearest millisecond and bounded to 500-1000 ms, with a total cap
+         * of 3000 ms. Muse detects turn ends itself and ignores this value.
+         */
+        endpointing_ms: number;
+        /**
+         * ASR provider name.
+         */
+        provider: 'azure' | 'deepgram' | 'soniox' | 'assemblyai' | 'muse';
+    }
+    /**
+     * Configuration for guardrail checks to detect and prevent prohibited topics in
+     * agent output and user input.
+     */
+    interface GuardrailConfig {
+        /**
+         * Selected prohibited user topic categories to check. When user messages contain
+         * these topics, the agent will respond with a placeholder message instead of
+         * processing the request.
+         */
+        input_topics?: Array<'platform_integrity_jailbreaking'> | null;
+        /**
+         * Selected prohibited agent topic categories to check. When agent messages contain
+         * these topics, they will be replaced with a placeholder message.
+         */
+        output_topics?: Array<'harassment' | 'self_harm' | 'sexual_exploitation' | 'violence' | 'defense_and_national_security' | 'illicit_and_harmful_activity' | 'gambling' | 'regulated_professional_advice' | 'child_safety_and_exploitation'> | null;
+    }
+    /**
+     * Toggle behavior presets on/off to influence agent response style and behaviors.
+     */
+    interface HandbookConfig {
+        /**
+         * When asked, acknowledge being a virtual assistant.
+         */
+        ai_disclosure?: boolean;
+        /**
+         * Enables Conversational Personality. When true, the agent uses the Conversational
+         * Personality handbook preset, skips Professional Rep Personality during prompt
+         * assembly, and enables internal colloquial rewrite behavior.
+         */
+        conversational_personality?: boolean;
+        /**
+         * Professional call center rep baseline.
+         */
+        default_personality?: boolean;
+        /**
+         * Repeat back and confirm important details (voice only).
+         */
+        echo_verification?: boolean;
+        /**
+         * Warm acknowledgment of caller concerns.
+         */
+        high_empathy?: boolean;
+        /**
+         * Spell using NATO phonetic alphabet style (voice only).
+         */
+        nato_phonetic_alphabet?: boolean;
+        /**
+         * Sprinkle natural speech fillers like "um", "you know" for a more human,
+         * conversational tone.
+         */
+        natural_filler_words?: boolean;
+        /**
+         * Stay within prompt/context scope, don't invent details.
+         */
+        scope_boundaries?: boolean;
+        /**
+         * Treat near-match similar words as same entity to reduce impact of transcription
+         * error (voice only).
+         */
+        smart_matching?: boolean;
+        /**
+         * Convert numbers/dates/currency to spoken forms (voice only).
+         */
+        speech_normalization?: boolean;
+    }
+    /**
+     * If this option is set, the call will try to detect IVR in the first 3 minutes of
+     * the call. Actions defined will be applied when the IVR is detected. Set this to
+     * null to disable IVR detection.
+     */
+    interface IvrOption {
+        action: IvrOption.Action;
+        /**
+         * Optionally describe what should be treated as an IVR. Leave as null to use the
+         * default definition.
+         */
+        detection_prompt?: string | null;
+    }
+    namespace IvrOption {
+        interface Action {
+            type: 'hangup';
+        }
+    }
+    /**
+     * Configuration for PII scrubbing from transcripts and recordings.
      */
-    interface CallScreeningOption {
+    interface PiiConfig {
         /**
-         * Identity the agent should provide when a call screen asks who is calling.
-         * Dynamic variables are supported.
+         * List of PII categories to scrub from transcripts and recordings. PII redaction
+         * is only active when this list is non-empty; an empty array means no PII
+         * scrubbing is performed.
          */
-        agent_identity: string;
+        categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth' | 'customer_account_number'>;
         /**
-         * Purpose the agent should provide when a call screen asks why it is calling.
-         * Dynamic variables are supported.
+         * The processing mode for PII scrubbing. Currently only post-call is supported.
          */
-        call_purpose: string;
+        mode: 'post_call';
+    }
+    interface StringAnalysisData {
+        /**
+         * Description of the variable.
+         */
+        description: string;
+        /**
+         * Name of the variable.
+         */
+        name: string;
+        /**
+         * 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.
+         */
+        examples?: Array<string>;
+        /**
+         * Whether this data is required. If true and the data is not extracted, the call
+         * will be marked as unsuccessful.
+         */
+        required?: boolean;
+    }
+    interface EnumAnalysisData {
+        /**
+         * The possible values of the variable, must be non empty array.
+         */
+        choices: Array<string>;
+        /**
+         * Description of the variable.
+         */
+        description: string;
+        /**
+         * Name of the variable.
+         */
+        name: string;
+        /**
+         * 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.
+         */
+        required?: boolean;
+    }
+    interface BooleanAnalysisData {
+        /**
+         * Description of the variable.
+         */
+        description: string;
+        /**
+         * Name of the variable.
+         */
+        name: string;
+        /**
+         * 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.
+         */
+        required?: boolean;
+    }
+    interface NumberAnalysisData {
+        /**
+         * Description of the variable.
+         */
+        description: string;
+        /**
+         * Name of the variable.
+         */
+        name: string;
+        /**
+         * 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.
+         */
+        required?: boolean;
     }
     /**
-     * Custom STT configuration. Only used when stt_mode is set to custom.
+     * System preset for post-call analysis (voice agents). Use in
+     * post_call_analysis_data to override prompts or mark fields optional.
      */
-    interface CustomSttConfig {
+    interface CallPresetAnalysisData {
+        /**
+         * Preset identifier for voice agent analysis.
+         */
+        name: 'call_summary' | 'call_successful' | 'user_sentiment';
+        /**
+         * Identifies this item as a system preset.
+         */
+        type: 'system-presets';
+        /**
+         * Optional instruction to help decide whether this field needs to be populated. If
+         * not set, the field is always included.
+         */
+        conditional_prompt?: string;
+        /**
+         * Prompt or description for this preset.
+         */
+        description?: string;
+        /**
+         * If false, this field is optional in the analysis. If true or unset, the field is
+         * required.
+         */
+        required?: 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';
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        condition?: AppTool.Condition;
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * 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 {
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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 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>;
+        }
+    }
+    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;
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        condition?: CustomTool.Condition;
+        /**
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * Describes what this tool does and when to call this tool.
+         */
+        description?: string;
+        /**
+         * 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;
+        /**
+         * 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;
+        };
+        /**
+         * Maximum number of times to retry the request after a failed attempt, from 0 (no
+         * retry) to 5. Retries happen on any failure, with exponential backoff between
+         * attempts; the backoff delay is not configurable. `timeout_ms` applies per
+         * attempt rather than as a budget across all attempts, so an attempt that times
+         * out is still retried and the worst-case total duration is `timeout_ms`
+         * multiplied by (`max_retry` + 1) as well as any latency incurred by the
+         * exponential backoff + jitter between each retry. Only the final attempt's result
+         * is reported to the agent. Because retries repeat the request, only set this
+         * above 0 if your endpoint is idempotent — a retried request may be processed more
+         * than once. Defaults to 0 (no retry).
+         */
+        max_retry?: number;
+        /**
+         * Method to use for the request, default to POST.
+         */
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        /**
+         * How the tool's `parameters` are authored and shown in the dashboard editor —
+         * "form" for the visual parameter builder, "json" for a raw JSON Schema. Both
+         * produce the same `parameters` schema; this does not change how the request body
+         * is encoded (see `args_at_root`).
+         */
+        parameter_type?: 'json' | 'form';
+        /**
+         * 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;
         /**
-         * Endpointing timeout in milliseconds. Minimum is 100 for Azure, 10 for Deepgram,
-         * 500 for Soniox, 100 for AssemblyAI. For AssemblyAI, this sets min_turn_silence
-         * (100-3000 ms). max_turn_silence adds half of this value, rounded to the nearest
-         * millisecond and bounded to 500-1000 ms, with a total cap of 3000 ms.
+         * 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.
          */
-        endpointing_ms: number;
+        speak_during_execution?: boolean;
         /**
-         * ASR provider name.
+         * 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).
          */
-        provider: 'azure' | 'deepgram' | 'soniox' | 'assemblyai';
+        timeout_ms?: number;
     }
-    /**
-     * Configuration for guardrail checks to detect and prevent prohibited topics in
-     * agent output and user input.
-     */
-    interface GuardrailConfig {
+    namespace CustomTool {
         /**
-         * Selected prohibited user topic categories to check. When user messages contain
-         * these topics, the agent will respond with a placeholder message instead of
-         * processing the request.
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
          */
-        input_topics?: Array<'platform_integrity_jailbreaking'> | null;
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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;
+            }
+        }
         /**
-         * Selected prohibited agent topic categories to check. When agent messages contain
-         * these topics, they will be replaced with a placeholder message.
+         * 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.
          */
-        output_topics?: Array<'harassment' | 'self_harm' | 'sexual_exploitation' | 'violence' | 'defense_and_national_security' | 'illicit_and_harmful_activity' | 'gambling' | 'regulated_professional_advice' | 'child_safety_and_exploitation'> | null;
+        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: 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>;
+        }
     }
-    /**
-     * Toggle behavior presets on/off to influence agent response style and behaviors.
-     */
-    interface HandbookConfig {
+    interface CodeTool {
         /**
-         * When asked, acknowledge being a virtual assistant.
+         * JavaScript code to execute in the sandbox.
          */
-        ai_disclosure?: boolean;
+        code: string;
         /**
-         * Enables Conversational Personality. When true, the agent uses the Conversational
-         * Personality handbook preset, skips Professional Rep Personality during prompt
-         * assembly, and enables internal colloquial rewrite behavior.
+         * 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).
          */
-        conversational_personality?: boolean;
+        name: string;
+        type: 'code';
         /**
-         * Professional call center rep baseline.
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
          */
-        default_personality?: boolean;
+        condition?: CodeTool.Condition;
         /**
-         * Repeat back and confirm important details (voice only).
+         * Names of tools that must run before this one.
          */
-        echo_verification?: boolean;
+        depends_on?: Array<string>;
         /**
-         * Warm acknowledgment of caller concerns.
+         * Describes what this tool does and when to call this tool.
          */
-        high_empathy?: boolean;
+        description?: string;
         /**
-         * Spell using NATO phonetic alphabet style (voice only).
+         * If true, play a typing sound on the agent audio track while this tool is
+         * executing.
          */
-        nato_phonetic_alphabet?: boolean;
+        enable_typing_sound?: boolean;
         /**
-         * Sprinkle natural speech fillers like "um", "you know" for a more human,
-         * conversational tone.
+         * The description for the sentence agent say during execution. Only applicable
+         * when speak_during_execution is true.
          */
-        natural_filler_words?: boolean;
+        execution_message_description?: string;
         /**
-         * Stay within prompt/context scope, don't invent details.
+         * 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".
          */
-        scope_boundaries?: boolean;
+        execution_message_type?: 'prompt' | 'static_text';
         /**
-         * Treat near-match similar words as same entity to reduce impact of transcription
-         * error (voice only).
+         * A mapping of variable names to JSON paths in the code execution result. These
+         * mapped values will be extracted and added as dynamic variables.
          */
-        smart_matching?: boolean;
+        response_variables?: {
+            [key: string]: string;
+        };
         /**
-         * Convert numbers/dates/currency to spoken forms (voice only).
+         * Determines whether the agent would call LLM another time and speak when the
+         * result of function is obtained.
          */
-        speech_normalization?: boolean;
-    }
-    /**
-     * If this option is set, the call will try to detect IVR in the first 3 minutes of
-     * the call. Actions defined will be applied when the IVR is detected. Set this to
-     * null to disable IVR detection.
-     */
-    interface IvrOption {
-        action: IvrOption.Action;
+        speak_after_execution?: boolean;
         /**
-         * Optionally describe what should be treated as an IVR. Leave as null to use the
-         * default definition.
+         * Determines whether the agent would say sentence like "One moment, let me check
+         * that." when executing the tool.
          */
-        detection_prompt?: string | null;
+        speak_during_execution?: boolean;
+        /**
+         * The maximum time in milliseconds the code can run before it's considered
+         * timeout. Defaults to 30,000 ms (30 s).
+         */
+        timeout_ms?: number;
     }
-    namespace IvrOption {
-        interface Action {
-            type: 'hangup';
+    namespace CodeTool {
+        /**
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
+         */
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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;
+            }
         }
     }
-    /**
-     * Configuration for PII scrubbing from transcripts and recordings.
-     */
-    interface PiiConfig {
+    interface SendSMSTool {
         /**
-         * List of PII categories to scrub from transcripts and recordings. PII redaction
-         * is only active when this list is non-empty; an empty array means no PII
-         * scrubbing is performed.
+         * Name of the tool. Must be unique within all tools available to LLM at any given
+         * time (general tools + state tools + state edges).
          */
-        categories: Array<'person_name' | 'address' | 'email' | 'phone_number' | 'ssn' | 'passport' | 'driver_license' | 'credit_card' | 'bank_account' | 'password' | 'pin' | 'medical_id' | 'date_of_birth' | 'customer_account_number'>;
+        name: string;
+        sms_content: SendSMSTool.SMSContentPredefined | SendSMSTool.SMSContentInferred | SendSMSTool.SMSContentTemplate;
+        type: 'send_sms';
         /**
-         * The processing mode for PII scrubbing. Currently only post-call is supported.
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
          */
-        mode: 'post_call';
-    }
-    interface StringAnalysisData {
+        condition?: SendSMSTool.Condition;
         /**
-         * Description of the variable.
+         * Names of tools that must run before this one.
          */
-        description: string;
+        depends_on?: Array<string>;
         /**
-         * Name of the variable.
+         * Describes what the tool does, sometimes can also include information about when
+         * to call the tool.
          */
-        name: string;
+        description?: string;
         /**
-         * Type of the variable to extract.
+         * Describes what to say before sending the SMS. Only applicable when
+         * speak_during_execution is true.
          */
-        type: 'string';
+        execution_message_description?: 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.
+         * 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".
          */
-        conditional_prompt?: string;
+        execution_message_type?: 'prompt' | 'static_text';
         /**
-         * Examples of the variable value to teach model the style and syntax.
+         * 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).
          */
-        examples?: Array<string>;
+        speak_during_execution?: boolean;
+    }
+    namespace SendSMSTool {
+        interface SMSContentPredefined {
+            /**
+             * The static message to be sent in the SMS. Can contain dynamic variables.
+             */
+            text?: string;
+            type?: 'predefined';
+        }
+        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';
+        }
+        interface SMSContentTemplate {
+            /**
+             * The template to use for the SMS content. "info_collection" sends a predefined
+             * message requesting information from the user.
+             */
+            template: 'info_collection';
+            type: 'template';
+        }
         /**
-         * Whether this data is required. If true and the data is not extracted, the call
-         * will be marked as unsuccessful.
+         * Optional gate; the step only runs when the condition holds. Defaults to always
+         * running.
          */
-        required?: boolean;
+        interface Condition {
+            equations: Array<Condition.Equation>;
+            operator: '||' | '&&';
+            type: 'equation';
+        }
+        namespace Condition {
+            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 EnumAnalysisData {
+    interface AppTool {
         /**
-         * The possible values of the variable, must be non empty array.
+         * The connection (App) this tool runs against. Must be a connection in the
+         * organization whose provider matches this tool's provider.
          */
-        choices: Array<string>;
+        app_id: string;
         /**
-         * Description of the variable.
+         * Name of the catalog template within the provider, as listed by
+         * list-app-templates.
          */
-        description: string;
+        app_tool_template_name: string;
         /**
-         * Name of the variable.
+         * Name of the tool. Must be unique within the phase's tools; referenced by
+         * depends_on.
          */
         name: string;
         /**
-         * Type of the variable to extract.
+         * Provider of the connection. Must match the connection's provider; supported
+         * providers are listed by list-app-templates.
          */
-        type: 'enum';
+        provider: string;
+        type: 'integration_app';
         /**
-         * 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.
+         * Names of tools that must run before this one.
          */
-        conditional_prompt?: string;
+        depends_on?: Array<string>;
         /**
-         * Whether this data is required. If true and the data is not extracted, the call
-         * will be marked as unsuccessful.
+         * Only applies to during conversation functions; ignored by the pre/post
+         * conversation. Overrides the catalog template's LLM-facing description.
          */
-        required?: boolean;
-    }
-    interface BooleanAnalysisData {
+        description?: string;
         /**
-         * Description of the variable.
+         * 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.
          */
-        description: string;
+        enable_typing_sound?: boolean;
         /**
-         * Name of the variable.
+         * 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.
          */
-        name: string;
+        execution_message_description?: string;
         /**
-         * Type of the variable to extract.
+         * 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".
          */
-        type: 'boolean';
+        execution_message_type?: 'prompt' | 'static_text';
         /**
-         * 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.
+         * 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.
          */
-        conditional_prompt?: string;
+        output_selection?: AppTool.UnionMember0 | AppTool.UnionMember1;
         /**
-         * Whether this data is required. If true and the data is not extracted, the call
-         * will be marked as unsuccessful.
+         * 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.
          */
-        required?: boolean;
+        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;
     }
-    interface NumberAnalysisData {
+    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';
+        }
         /**
-         * Description of the variable.
+         * 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.
          */
-        description: string;
+        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>;
+        }
+    }
+    interface CustomTool {
         /**
-         * Name of the variable.
+         * 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';
         /**
-         * Type of the variable to extract.
+         * Describes what the tool does, sometimes can also include information about when
+         * to call the tool.
          */
-        type: 'number';
+        url: 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.
+         * If set to true, the parameters will be passed as root level JSON object instead
+         * of nested under "args".
          */
-        conditional_prompt?: string;
+        args_at_root?: boolean;
         /**
-         * Whether this data is required. If true and the data is not extracted, the call
-         * will be marked as unsuccessful.
+         * Names of tools that must run before this one.
          */
-        required?: boolean;
+        depends_on?: Array<string>;
+        /**
+         * Describes what this tool does and when to call this tool.
+         */
+        description?: string;
+        /**
+         * 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;
+        /**
+         * 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;
+        };
+        /**
+         * Maximum number of times to retry the request after a failed attempt, from 0 (no
+         * retry) to 5. Retries happen on any failure, with exponential backoff between
+         * attempts; the backoff delay is not configurable. `timeout_ms` applies per
+         * attempt rather than as a budget across all attempts, so an attempt that times
+         * out is still retried and the worst-case total duration is `timeout_ms`
+         * multiplied by (`max_retry` + 1) as well as any latency incurred by the
+         * exponential backoff + jitter between each retry. Only the final attempt's result
+         * is reported to the agent. Because retries repeat the request, only set this
+         * above 0 if your endpoint is idempotent — a retried request may be processed more
+         * than once. Defaults to 0 (no retry).
+         */
+        max_retry?: number;
+        /**
+         * Method to use for the request, default to POST.
+         */
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+        /**
+         * How the tool's `parameters` are authored and shown in the dashboard editor —
+         * "form" for the visual parameter builder, "json" for a raw JSON Schema. Both
+         * produce the same `parameters` schema; this does not change how the request body
+         * is encoded (see `args_at_root`).
+         */
+        parameter_type?: 'json' | 'form';
+        /**
+         * 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;
     }
-    /**
-     * System preset for post-call analysis (voice agents). Use in
-     * post_call_analysis_data to override prompts or mark fields optional.
-     */
-    interface CallPresetAnalysisData {
+    namespace CustomTool {
         /**
-         * Preset identifier for voice agent analysis.
+         * 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.
          */
-        name: 'call_summary' | 'call_successful' | 'user_sentiment';
+        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: 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 CodeTool {
         /**
-         * Identifies this item as a system preset.
+         * JavaScript code to execute in the sandbox.
          */
-        type: 'system-presets';
+        code: string;
         /**
-         * Optional instruction to help decide whether this field needs to be populated. If
-         * not set, the field is always included.
+         * 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).
          */
-        conditional_prompt?: string;
+        name: string;
+        type: 'code';
         /**
-         * Prompt or description for this preset.
+         * Names of tools that must run before this one.
+         */
+        depends_on?: Array<string>;
+        /**
+         * Describes what this tool does and when to call this tool.
          */
         description?: string;
         /**
-         * If false, this field is optional in the analysis. If true or unset, the field is
-         * required.
+         * If true, play a typing sound on the agent audio track while this tool is
+         * executing.
          */
-        required?: boolean;
+        enable_typing_sound?: boolean;
+        /**
+         * The description for the sentence agent say during execution. 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';
+        /**
+         * A mapping of variable names to JSON paths in the code execution result. These
+         * mapped values will be extracted and added as dynamic variables.
+         */
+        response_variables?: {
+            [key: string]: string;
+        };
+        /**
+         * Determines whether the agent would call LLM another time and speak when the
+         * result of function is obtained.
+         */
+        speak_after_execution?: boolean;
+        /**
+         * Determines whether the agent would say sentence like "One moment, let me check
+         * that." when executing the tool.
+         */
+        speak_during_execution?: boolean;
+        /**
+         * The maximum time in milliseconds the code can run before it's considered
+         * timeout. Defaults to 30,000 ms (30 s).
+         */
+        timeout_ms?: number;
     }
     interface PronunciationDictionary {
         /**