retell-sdk 4.58.0 → 4.60.0

package/src/resources/call.ts

@@ -1974,7 +1974,8 @@ export interface CallUpdateParams {
    * Override dynamic varaibles represented as key-value pairs of strings. Setting
    * this will override or add the dynamic variables set in the agent during the
    * call. Only need to set the delta where you want to override, no need to set the
-   * entire dynamic variables object.
+   * entire dynamic variables object. Setting this to null will remove any existing
+   * override.
    */
   override_dynamic_variables?: { [key: string]: string } | null;
 }
@@ -2154,8 +2155,9 @@ export interface CallCreatePhoneCallParams {
   to_number: string;
 
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   agent_override?: CallCreatePhoneCallParams.AgentOverride;
 
@@ -2202,8 +2204,9 @@ export interface CallCreatePhoneCallParams {
 
 export namespace CallCreatePhoneCallParams {
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   export interface AgentOverride {
     /**
@@ -2215,16 +2218,17 @@ export namespace CallCreatePhoneCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     conversation_flow?: AgentOverride.ConversationFlow;
 
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     retell_llm?: AgentOverride.RetellLlm;
   }
@@ -2839,8 +2843,8 @@ export namespace CallCreatePhoneCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     export interface ConversationFlow {
       /**
@@ -2876,6 +2880,12 @@ export namespace CallCreatePhoneCallParams {
        * Who starts the conversation - user or agent.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace ConversationFlow {
@@ -2932,8 +2942,9 @@ export namespace CallCreatePhoneCallParams {
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     export interface RetellLlm {
       /**
@@ -2980,6 +2991,13 @@ export namespace CallCreatePhoneCallParams {
         | 'gemini-2.5-flash-lite'
         | null;
 
+      /**
+       * If set to true, will use high priority pool with more dedicated resource to
+       * ensure lower and more consistent latency, default to false. This feature usually
+       * comes with a higher cost.
+       */
+      model_high_priority?: boolean | null;
+
       /**
        * If set, will control the randomness of the response. Value ranging from [0,1].
        * Lower value means more deterministic, while higher value means more random. If
@@ -2999,6 +3017,12 @@ export namespace CallCreatePhoneCallParams {
        * 'agent'.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace RetellLlm {
@@ -3028,8 +3052,9 @@ export interface CallCreateWebCallParams {
   agent_id: string;
 
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   agent_override?: CallCreateWebCallParams.AgentOverride;
 
@@ -3055,8 +3080,9 @@ export interface CallCreateWebCallParams {
 
 export namespace CallCreateWebCallParams {
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   export interface AgentOverride {
     /**
@@ -3068,16 +3094,17 @@ export namespace CallCreateWebCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     conversation_flow?: AgentOverride.ConversationFlow;
 
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     retell_llm?: AgentOverride.RetellLlm;
   }
@@ -3692,8 +3719,8 @@ export namespace CallCreateWebCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     export interface ConversationFlow {
       /**
@@ -3729,6 +3756,12 @@ export namespace CallCreateWebCallParams {
        * Who starts the conversation - user or agent.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace ConversationFlow {
@@ -3785,8 +3818,9 @@ export namespace CallCreateWebCallParams {
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     export interface RetellLlm {
       /**
@@ -3833,6 +3867,13 @@ export namespace CallCreateWebCallParams {
         | 'gemini-2.5-flash-lite'
         | null;
 
+      /**
+       * If set to true, will use high priority pool with more dedicated resource to
+       * ensure lower and more consistent latency, default to false. This feature usually
+       * comes with a higher cost.
+       */
+      model_high_priority?: boolean | null;
+
       /**
        * If set, will control the randomness of the response. Value ranging from [0,1].
        * Lower value means more deterministic, while higher value means more random. If
@@ -3852,6 +3893,12 @@ export namespace CallCreateWebCallParams {
        * 'agent'.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace RetellLlm {
@@ -3880,8 +3927,9 @@ export interface CallRegisterPhoneCallParams {
   agent_id: string;
 
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   agent_override?: CallRegisterPhoneCallParams.AgentOverride;
 
@@ -3922,8 +3970,9 @@ export interface CallRegisterPhoneCallParams {
 
 export namespace CallRegisterPhoneCallParams {
   /**
-   * Override configuration for agent, retell LLM, or conversation flow settings for
-   * a specific call.
+   * For this particular call, override agent configuration with these settings. This
+   * allows you to customize agent behavior for individual calls without modifying
+   * the base agent.
    */
   export interface AgentOverride {
     /**
@@ -3935,16 +3984,17 @@ export namespace CallRegisterPhoneCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     conversation_flow?: AgentOverride.ConversationFlow;
 
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     retell_llm?: AgentOverride.RetellLlm;
   }
@@ -4559,8 +4609,8 @@ export namespace CallRegisterPhoneCallParams {
     /**
      * Override conversation flow configuration settings. Only applicable when using
      * conversation flow as the response engine. Supported attributes - model_choice,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms.
+     * model_temperature, tool_call_strict_mode, knowledge_base_ids, kb_config,
+     * start_speaker, begin_after_user_silence_ms.
      */
     export interface ConversationFlow {
       /**
@@ -4596,6 +4646,12 @@ export namespace CallRegisterPhoneCallParams {
        * Who starts the conversation - user or agent.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace ConversationFlow {
@@ -4652,8 +4708,9 @@ export namespace CallRegisterPhoneCallParams {
     /**
      * Override Retell LLM configuration settings. Only applicable when using Retell
      * LLM as the response engine. Supported attributes - model, s2s_model,
-     * model_temperature, knowledge_base_ids, kb_config, start_speaker,
-     * begin_after_user_silence_ms, begin_message.
+     * model_temperature, model_high_priority, tool_call_strict_mode,
+     * knowledge_base_ids, kb_config, start_speaker, begin_after_user_silence_ms,
+     * begin_message.
      */
     export interface RetellLlm {
       /**
@@ -4700,6 +4757,13 @@ export namespace CallRegisterPhoneCallParams {
         | 'gemini-2.5-flash-lite'
         | null;
 
+      /**
+       * If set to true, will use high priority pool with more dedicated resource to
+       * ensure lower and more consistent latency, default to false. This feature usually
+       * comes with a higher cost.
+       */
+      model_high_priority?: boolean | null;
+
       /**
        * If set, will control the randomness of the response. Value ranging from [0,1].
        * Lower value means more deterministic, while higher value means more random. If
@@ -4719,6 +4783,12 @@ export namespace CallRegisterPhoneCallParams {
        * 'agent'.
        */
       start_speaker?: 'user' | 'agent';
+
+      /**
+       * Whether to use strict mode for tool calls. Only applicable when using certain
+       * supported models.
+       */
+      tool_call_strict_mode?: boolean | null;
     }
 
     export namespace RetellLlm {