retell-sdk 6.2.6 → 6.2.8

package/src/resources/chat-agent.ts

@@ -261,10 +261,7 @@ export interface ChatAgentResponse {
   /**
    * Specifies what language(s) the agent will operate in. Accepts either a single
    * locale (e.g. `en-US`) or an array of locales for multilingual agents (e.g.
-   * `["en-US","es-ES"]`). The scalar value `multi` is deprecated but still accepted
-   * as a scalar, and is stored and returned as the ten locales it used to mean. It
-   * must not appear inside the array form. Send an explicit locale array instead. If
-   * unset, defaults to `en-US`.
+   * `["en-US","es-ES"]`). If unset, defaults to `en-US`.
    */
   language?:
     | 'en-US'
@@ -330,7 +327,6 @@ export interface ChatAgentResponse {
     | 'ur-IN'
     | 'yue-CN'
     | 'uk-UA'
-    | 'multi'
     | Array<
         | 'en-US'
         | 'en-IN'
@@ -456,6 +452,7 @@ export interface ChatAgentResponse {
     | 'gemini-3.6-flash'
     | 'gemini-3.7-flash'
     | 'gemini-3.8-flash'
+    | 'gemini-4-argon'
     | null;
 
   /**
@@ -1410,6 +1407,23 @@ export namespace ChatAgentResponse {
      */
     execution_message_type?: 'prompt' | 'static_text';
 
+    /**
+     * SMS destination number configuration. If omitted, the message is sent to the
+     * customer number on the call.
+     */
+    sms_destination?: SendSMSTool.DestinationCustomerNumber | SendSMSTool.DestinationPhoneNumber | unknown;
+
+    /**
+     * SMS sender number configuration. If omitted, the message is sent from the
+     * agent's phone number.
+     */
+    sms_sender?: SendSMSTool.SenderCurrentNumber | SendSMSTool.SenderRetellLongCode | unknown;
+
+    /**
+     * Whether the agent should speak after the SMS tool finishes execution.
+     */
+    speak_after_execution?: boolean;
+
     /**
      * 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).
@@ -1486,6 +1500,33 @@ export namespace ChatAgentResponse {
         right?: string;
       }
     }
+
+    export interface DestinationCustomerNumber {
+      type: 'customer_number';
+    }
+
+    export interface DestinationPhoneNumber {
+      /**
+       * Destination phone number in E.164 format.
+       */
+      phone_number: string;
+
+      type: 'phone_number';
+
+      /**
+       * If true, skip E.164 validation for this phone number (same semantics as
+       * transfer_call ignore_e164_validation).
+       */
+      ignore_e164_validation?: boolean;
+    }
+
+    export interface SenderCurrentNumber {
+      type: 'current_number';
+    }
+
+    export interface SenderRetellLongCode {
+      type: 'retell_long_code';
+    }
   }
 
   export interface AppTool {
@@ -1912,6 +1953,11 @@ export namespace ChatAgentListResponse {
      * update or creation if no updates available.
      */
     user_modified_timestamp: number;
+
+    /**
+     * Whether the agent is a transfer agent used for agentic warm transfer.
+     */
+    is_transfer_agent?: boolean;
   }
 
   export namespace Item {
@@ -1992,10 +2038,7 @@ export interface ChatAgentCreateParams {
   /**
    * Specifies what language(s) the agent will operate in. Accepts either a single
    * locale (e.g. `en-US`) or an array of locales for multilingual agents (e.g.
-   * `["en-US","es-ES"]`). The scalar value `multi` is deprecated but still accepted
-   * as a scalar, and is stored and returned as the ten locales it used to mean. It
-   * must not appear inside the array form. Send an explicit locale array instead. If
-   * unset, defaults to `en-US`.
+   * `["en-US","es-ES"]`). If unset, defaults to `en-US`.
    */
   language?:
     | 'en-US'
@@ -2061,7 +2104,6 @@ export interface ChatAgentCreateParams {
     | 'ur-IN'
     | 'yue-CN'
     | 'uk-UA'
-    | 'multi'
     | Array<
         | 'en-US'
         | 'en-IN'
@@ -2187,6 +2229,7 @@ export interface ChatAgentCreateParams {
     | 'gemini-3.6-flash'
     | 'gemini-3.7-flash'
     | 'gemini-3.8-flash'
+    | 'gemini-4-argon'
     | null;
 
   /**
@@ -3136,6 +3179,23 @@ export namespace ChatAgentCreateParams {
      */
     execution_message_type?: 'prompt' | 'static_text';
 
+    /**
+     * SMS destination number configuration. If omitted, the message is sent to the
+     * customer number on the call.
+     */
+    sms_destination?: SendSMSTool.DestinationCustomerNumber | SendSMSTool.DestinationPhoneNumber | unknown;
+
+    /**
+     * SMS sender number configuration. If omitted, the message is sent from the
+     * agent's phone number.
+     */
+    sms_sender?: SendSMSTool.SenderCurrentNumber | SendSMSTool.SenderRetellLongCode | unknown;
+
+    /**
+     * Whether the agent should speak after the SMS tool finishes execution.
+     */
+    speak_after_execution?: boolean;
+
     /**
      * 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).
@@ -3212,6 +3272,33 @@ export namespace ChatAgentCreateParams {
         right?: string;
       }
     }
+
+    export interface DestinationCustomerNumber {
+      type: 'customer_number';
+    }
+
+    export interface DestinationPhoneNumber {
+      /**
+       * Destination phone number in E.164 format.
+       */
+      phone_number: string;
+
+      type: 'phone_number';
+
+      /**
+       * If true, skip E.164 validation for this phone number (same semantics as
+       * transfer_call ignore_e164_validation).
+       */
+      ignore_e164_validation?: boolean;
+    }
+
+    export interface SenderCurrentNumber {
+      type: 'current_number';
+    }
+
+    export interface SenderRetellLongCode {
+      type: 'retell_long_code';
+    }
   }
 
   export interface AppTool {
@@ -3672,10 +3759,7 @@ export interface ChatAgentUpdateParams {
   /**
    * Body param: Specifies what language(s) the agent will operate in. Accepts either
    * a single locale (e.g. `en-US`) or an array of locales for multilingual agents
-   * (e.g. `["en-US","es-ES"]`). The scalar value `multi` is deprecated but still
-   * accepted as a scalar, and is stored and returned as the ten locales it used to
-   * mean. It must not appear inside the array form. Send an explicit locale array
-   * instead. If unset, defaults to `en-US`.
+   * (e.g. `["en-US","es-ES"]`). If unset, defaults to `en-US`.
    */
   language?:
     | 'en-US'
@@ -3741,7 +3825,6 @@ export interface ChatAgentUpdateParams {
     | 'ur-IN'
     | 'yue-CN'
     | 'uk-UA'
-    | 'multi'
     | Array<
         | 'en-US'
         | 'en-IN'
@@ -3867,6 +3950,7 @@ export interface ChatAgentUpdateParams {
     | 'gemini-3.6-flash'
     | 'gemini-3.7-flash'
     | 'gemini-3.8-flash'
+    | 'gemini-4-argon'
     | null;
 
   /**
@@ -4783,6 +4867,23 @@ export namespace ChatAgentUpdateParams {
      */
     execution_message_type?: 'prompt' | 'static_text';
 
+    /**
+     * SMS destination number configuration. If omitted, the message is sent to the
+     * customer number on the call.
+     */
+    sms_destination?: SendSMSTool.DestinationCustomerNumber | SendSMSTool.DestinationPhoneNumber | unknown;
+
+    /**
+     * SMS sender number configuration. If omitted, the message is sent from the
+     * agent's phone number.
+     */
+    sms_sender?: SendSMSTool.SenderCurrentNumber | SendSMSTool.SenderRetellLongCode | unknown;
+
+    /**
+     * Whether the agent should speak after the SMS tool finishes execution.
+     */
+    speak_after_execution?: boolean;
+
     /**
      * 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).
@@ -4859,6 +4960,33 @@ export namespace ChatAgentUpdateParams {
         right?: string;
       }
     }
+
+    export interface DestinationCustomerNumber {
+      type: 'customer_number';
+    }
+
+    export interface DestinationPhoneNumber {
+      /**
+       * Destination phone number in E.164 format.
+       */
+      phone_number: string;
+
+      type: 'phone_number';
+
+      /**
+       * If true, skip E.164 validation for this phone number (same semantics as
+       * transfer_call ignore_e164_validation).
+       */
+      ignore_e164_validation?: boolean;
+    }
+
+    export interface SenderCurrentNumber {
+      type: 'current_number';
+    }
+
+    export interface SenderRetellLongCode {
+      type: 'retell_long_code';
+    }
   }
 
   export interface AppTool {
@@ -5323,6 +5451,11 @@ export namespace ChatAgentListParams {
   export interface FilterCriteria {
     channel?: FilterCriteria.Channel;
 
+    /**
+     * Filter by whether the agent is a transfer agent.
+     */
+    is_transfer_agent?: FilterCriteria.IsTransferAgent;
+
     /**
      * Case-insensitive substring search over agent name, plus substring search over
      * agent id.
@@ -5341,6 +5474,17 @@ export namespace ChatAgentListParams {
 
       value: 'voice' | 'chat';
     }
+
+    /**
+     * Filter by whether the agent is a transfer agent.
+     */
+    export interface IsTransferAgent {
+      op: 'eq';
+
+      type: 'boolean';
+
+      value: boolean;
+    }
   }
 }