retell-sdk 4.7.0 → 4.9.0

package/src/resources/llm.ts

@@ -2,7 +2,6 @@
 
 import { APIResource } from '../resource';
 import * as Core from '../core';
-import * as LlmAPI from './llm';
 
 export class Llm extends APIResource {
   /**
@@ -56,12 +55,6 @@ export interface LlmResponse {
    */
   llm_id: string;
 
-  /**
-   * The LLM Websocket URL constructed from unique id of Retell LLM. Used in agent
-   * API to create / update agent.
-   */
-  llm_websocket_url: string;
-
   /**
    * First utterance said by the agent in the call. If not set, LLM will dynamically
    * generate a message. If set to "", agent will wait for user to speak first.
@@ -103,9 +96,15 @@ export interface LlmResponse {
   inbound_dynamic_variables_webhook_url?: string | null;
 
   /**
-   * Select the underlying LLM. If not set, would default to gpt-4o.
+   * A list of knowledge base ids to use for this resource. Set to null to remove all
+   * knowledge bases.
    */
-  model?: 'gpt-4o' | 'gpt-4o-mini' | 'claude-3.5-sonnet' | 'claude-3-haiku';
+  knowledge_base_ids?: Array<string> | null;
+
+  /**
+   * Select the underlying text LLM. If not set, would default to gpt-4o.
+   */
+  model?: 'gpt-4o' | 'gpt-4o-mini' | 'claude-3.5-sonnet' | 'claude-3-haiku' | null;
 
   /**
    * If set, will control the randomness of the response. Value ranging from [0,1].
@@ -115,6 +114,12 @@ export interface LlmResponse {
    */
   model_temperature?: number;
 
+  /**
+   * Select the underlying speech to speech model. Can only set this or model, not
+   * both.
+   */
+  s2s_model?: 'gpt-4o-realtime' | null;
+
   /**
    * Name of the starting state. Required if states is not empty.
    */
@@ -128,6 +133,14 @@ export interface LlmResponse {
    * tools (essentially one state).
    */
   states?: Array<LlmResponse.State> | null;
+
+  /**
+   * Only applicable when model is gpt-4o or gpt-4o mini. If set to true, will use
+   * structured output to make sure tool call arguments follow the json schema. The
+   * time to save a new tool or change to a tool will be longer as additional
+   * processing is needed. Default to false.
+   */
+  tool_call_strict_mode?: boolean;
 }
 
 export namespace LlmResponse {
@@ -157,8 +170,8 @@ export namespace LlmResponse {
     name: string;
 
     /**
-     * The number to transfer to in E.164 format (a + and country code, then the phone
-     * number with no space or other special characters). For example, +16175551212.
+     * The number to transfer to in E.164 format or a dynamic variable like
+     * {{transfer_number}}.
      */
     number: string;
 
@@ -169,6 +182,44 @@ export namespace LlmResponse {
      * to call the tool.
      */
     description?: string;
+
+    /**
+     * If set to true, will show transferee (the user, not the AI agent) as caller when
+     * transferring, requires the telephony side to support SIP REFER to PSTN. This is
+     * only applicable for cold transfer, so if warm transfer option is specified, this
+     * field will be ignored. Default to false (default to show AI agent as caller).
+     */
+    show_transferee_as_caller?: boolean | null;
+
+    /**
+     * If set, when transfer is successful, will perform a warm handoff. Can leave
+     * either a static message or a dynamic one based on prompt. Set to null to disable
+     * warm handoff.
+     */
+    warm_transfer_option?:
+      | TransferCallTool.WarmTransferPrompt
+      | TransferCallTool.WarmTransferStaticMessage
+      | null;
+  }
+
+  export namespace TransferCallTool {
+    export interface WarmTransferPrompt {
+      /**
+       * The prompt to be used for warm handoff. Can contain dynamic variables.
+       */
+      prompt?: string;
+
+      type?: 'prompt';
+    }
+
+    export interface WarmTransferStaticMessage {
+      /**
+       * The static message to be used for warm handoff. Can contain dynamic variables.
+       */
+      message?: string;
+
+      type?: 'static_message';
+    }
   }
 
   export interface CheckAvailabilityCalTool {
@@ -475,8 +526,8 @@ export namespace LlmResponse {
       name: string;
 
       /**
-       * The number to transfer to in E.164 format (a + and country code, then the phone
-       * number with no space or other special characters). For example, +16175551212.
+       * The number to transfer to in E.164 format or a dynamic variable like
+       * {{transfer_number}}.
        */
       number: string;
 
@@ -487,6 +538,44 @@ export namespace LlmResponse {
        * to call the tool.
        */
       description?: string;
+
+      /**
+       * If set to true, will show transferee (the user, not the AI agent) as caller when
+       * transferring, requires the telephony side to support SIP REFER to PSTN. This is
+       * only applicable for cold transfer, so if warm transfer option is specified, this
+       * field will be ignored. Default to false (default to show AI agent as caller).
+       */
+      show_transferee_as_caller?: boolean | null;
+
+      /**
+       * If set, when transfer is successful, will perform a warm handoff. Can leave
+       * either a static message or a dynamic one based on prompt. Set to null to disable
+       * warm handoff.
+       */
+      warm_transfer_option?:
+        | TransferCallTool.WarmTransferPrompt
+        | TransferCallTool.WarmTransferStaticMessage
+        | null;
+    }
+
+    export namespace TransferCallTool {
+      export interface WarmTransferPrompt {
+        /**
+         * The prompt to be used for warm handoff. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'prompt';
+      }
+
+      export interface WarmTransferStaticMessage {
+        /**
+         * The static message to be used for warm handoff. Can contain dynamic variables.
+         */
+        message?: string;
+
+        type?: 'static_message';
+      }
     }
 
     export interface CheckAvailabilityCalTool {
@@ -718,9 +807,15 @@ export interface LlmCreateParams {
   inbound_dynamic_variables_webhook_url?: string | null;
 
   /**
-   * Select the underlying LLM. If not set, would default to gpt-4o.
+   * A list of knowledge base ids to use for this resource. Set to null to remove all
+   * knowledge bases.
    */
-  model?: 'gpt-4o' | 'gpt-4o-mini' | 'claude-3.5-sonnet' | 'claude-3-haiku';
+  knowledge_base_ids?: Array<string> | null;
+
+  /**
+   * Select the underlying text LLM. If not set, would default to gpt-4o.
+   */
+  model?: 'gpt-4o' | 'gpt-4o-mini' | 'claude-3.5-sonnet' | 'claude-3-haiku' | null;
 
   /**
    * If set, will control the randomness of the response. Value ranging from [0,1].
@@ -730,6 +825,12 @@ export interface LlmCreateParams {
    */
   model_temperature?: number;
 
+  /**
+   * Select the underlying speech to speech model. Can only set this or model, not
+   * both.
+   */
+  s2s_model?: 'gpt-4o-realtime' | null;
+
   /**
    * Name of the starting state. Required if states is not empty.
    */
@@ -743,6 +844,14 @@ export interface LlmCreateParams {
    * tools (essentially one state).
    */
   states?: Array<LlmCreateParams.State> | null;
+
+  /**
+   * Only applicable when model is gpt-4o or gpt-4o mini. If set to true, will use
+   * structured output to make sure tool call arguments follow the json schema. The
+   * time to save a new tool or change to a tool will be longer as additional
+   * processing is needed. Default to false.
+   */
+  tool_call_strict_mode?: boolean;
 }
 
 export namespace LlmCreateParams {
@@ -772,8 +881,8 @@ export namespace LlmCreateParams {
     name: string;
 
     /**
-     * The number to transfer to in E.164 format (a + and country code, then the phone
-     * number with no space or other special characters). For example, +16175551212.
+     * The number to transfer to in E.164 format or a dynamic variable like
+     * {{transfer_number}}.
      */
     number: string;
 
@@ -784,6 +893,44 @@ export namespace LlmCreateParams {
      * to call the tool.
      */
     description?: string;
+
+    /**
+     * If set to true, will show transferee (the user, not the AI agent) as caller when
+     * transferring, requires the telephony side to support SIP REFER to PSTN. This is
+     * only applicable for cold transfer, so if warm transfer option is specified, this
+     * field will be ignored. Default to false (default to show AI agent as caller).
+     */
+    show_transferee_as_caller?: boolean | null;
+
+    /**
+     * If set, when transfer is successful, will perform a warm handoff. Can leave
+     * either a static message or a dynamic one based on prompt. Set to null to disable
+     * warm handoff.
+     */
+    warm_transfer_option?:
+      | TransferCallTool.WarmTransferPrompt
+      | TransferCallTool.WarmTransferStaticMessage
+      | null;
+  }
+
+  export namespace TransferCallTool {
+    export interface WarmTransferPrompt {
+      /**
+       * The prompt to be used for warm handoff. Can contain dynamic variables.
+       */
+      prompt?: string;
+
+      type?: 'prompt';
+    }
+
+    export interface WarmTransferStaticMessage {
+      /**
+       * The static message to be used for warm handoff. Can contain dynamic variables.
+       */
+      message?: string;
+
+      type?: 'static_message';
+    }
   }
 
   export interface CheckAvailabilityCalTool {
@@ -1090,8 +1237,8 @@ export namespace LlmCreateParams {
       name: string;
 
       /**
-       * The number to transfer to in E.164 format (a + and country code, then the phone
-       * number with no space or other special characters). For example, +16175551212.
+       * The number to transfer to in E.164 format or a dynamic variable like
+       * {{transfer_number}}.
        */
       number: string;
 
@@ -1102,6 +1249,44 @@ export namespace LlmCreateParams {
        * to call the tool.
        */
       description?: string;
+
+      /**
+       * If set to true, will show transferee (the user, not the AI agent) as caller when
+       * transferring, requires the telephony side to support SIP REFER to PSTN. This is
+       * only applicable for cold transfer, so if warm transfer option is specified, this
+       * field will be ignored. Default to false (default to show AI agent as caller).
+       */
+      show_transferee_as_caller?: boolean | null;
+
+      /**
+       * If set, when transfer is successful, will perform a warm handoff. Can leave
+       * either a static message or a dynamic one based on prompt. Set to null to disable
+       * warm handoff.
+       */
+      warm_transfer_option?:
+        | TransferCallTool.WarmTransferPrompt
+        | TransferCallTool.WarmTransferStaticMessage
+        | null;
+    }
+
+    export namespace TransferCallTool {
+      export interface WarmTransferPrompt {
+        /**
+         * The prompt to be used for warm handoff. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'prompt';
+      }
+
+      export interface WarmTransferStaticMessage {
+        /**
+         * The static message to be used for warm handoff. Can contain dynamic variables.
+         */
+        message?: string;
+
+        type?: 'static_message';
+      }
     }
 
     export interface CheckAvailabilityCalTool {
@@ -1331,9 +1516,15 @@ export interface LlmUpdateParams {
   inbound_dynamic_variables_webhook_url?: string | null;
 
   /**
-   * Select the underlying LLM. If not set, would default to gpt-4o.
+   * A list of knowledge base ids to use for this resource. Set to null to remove all
+   * knowledge bases.
+   */
+  knowledge_base_ids?: Array<string> | null;
+
+  /**
+   * Select the underlying text LLM. If not set, would default to gpt-4o.
    */
-  model?: 'gpt-4o' | 'gpt-4o-mini' | 'claude-3.5-sonnet' | 'claude-3-haiku';
+  model?: 'gpt-4o' | 'gpt-4o-mini' | 'claude-3.5-sonnet' | 'claude-3-haiku' | null;
 
   /**
    * If set, will control the randomness of the response. Value ranging from [0,1].
@@ -1343,6 +1534,12 @@ export interface LlmUpdateParams {
    */
   model_temperature?: number;
 
+  /**
+   * Select the underlying speech to speech model. Can only set this or model, not
+   * both.
+   */
+  s2s_model?: 'gpt-4o-realtime' | null;
+
   /**
    * Name of the starting state. Required if states is not empty.
    */
@@ -1356,6 +1553,14 @@ export interface LlmUpdateParams {
    * tools (essentially one state).
    */
   states?: Array<LlmUpdateParams.State> | null;
+
+  /**
+   * Only applicable when model is gpt-4o or gpt-4o mini. If set to true, will use
+   * structured output to make sure tool call arguments follow the json schema. The
+   * time to save a new tool or change to a tool will be longer as additional
+   * processing is needed. Default to false.
+   */
+  tool_call_strict_mode?: boolean;
 }
 
 export namespace LlmUpdateParams {
@@ -1385,8 +1590,8 @@ export namespace LlmUpdateParams {
     name: string;
 
     /**
-     * The number to transfer to in E.164 format (a + and country code, then the phone
-     * number with no space or other special characters). For example, +16175551212.
+     * The number to transfer to in E.164 format or a dynamic variable like
+     * {{transfer_number}}.
      */
     number: string;
 
@@ -1397,6 +1602,44 @@ export namespace LlmUpdateParams {
      * to call the tool.
      */
     description?: string;
+
+    /**
+     * If set to true, will show transferee (the user, not the AI agent) as caller when
+     * transferring, requires the telephony side to support SIP REFER to PSTN. This is
+     * only applicable for cold transfer, so if warm transfer option is specified, this
+     * field will be ignored. Default to false (default to show AI agent as caller).
+     */
+    show_transferee_as_caller?: boolean | null;
+
+    /**
+     * If set, when transfer is successful, will perform a warm handoff. Can leave
+     * either a static message or a dynamic one based on prompt. Set to null to disable
+     * warm handoff.
+     */
+    warm_transfer_option?:
+      | TransferCallTool.WarmTransferPrompt
+      | TransferCallTool.WarmTransferStaticMessage
+      | null;
+  }
+
+  export namespace TransferCallTool {
+    export interface WarmTransferPrompt {
+      /**
+       * The prompt to be used for warm handoff. Can contain dynamic variables.
+       */
+      prompt?: string;
+
+      type?: 'prompt';
+    }
+
+    export interface WarmTransferStaticMessage {
+      /**
+       * The static message to be used for warm handoff. Can contain dynamic variables.
+       */
+      message?: string;
+
+      type?: 'static_message';
+    }
   }
 
   export interface CheckAvailabilityCalTool {
@@ -1703,8 +1946,8 @@ export namespace LlmUpdateParams {
       name: string;
 
       /**
-       * The number to transfer to in E.164 format (a + and country code, then the phone
-       * number with no space or other special characters). For example, +16175551212.
+       * The number to transfer to in E.164 format or a dynamic variable like
+       * {{transfer_number}}.
        */
       number: string;
 
@@ -1715,6 +1958,44 @@ export namespace LlmUpdateParams {
        * to call the tool.
        */
       description?: string;
+
+      /**
+       * If set to true, will show transferee (the user, not the AI agent) as caller when
+       * transferring, requires the telephony side to support SIP REFER to PSTN. This is
+       * only applicable for cold transfer, so if warm transfer option is specified, this
+       * field will be ignored. Default to false (default to show AI agent as caller).
+       */
+      show_transferee_as_caller?: boolean | null;
+
+      /**
+       * If set, when transfer is successful, will perform a warm handoff. Can leave
+       * either a static message or a dynamic one based on prompt. Set to null to disable
+       * warm handoff.
+       */
+      warm_transfer_option?:
+        | TransferCallTool.WarmTransferPrompt
+        | TransferCallTool.WarmTransferStaticMessage
+        | null;
+    }
+
+    export namespace TransferCallTool {
+      export interface WarmTransferPrompt {
+        /**
+         * The prompt to be used for warm handoff. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'prompt';
+      }
+
+      export interface WarmTransferStaticMessage {
+        /**
+         * The static message to be used for warm handoff. Can contain dynamic variables.
+         */
+        message?: string;
+
+        type?: 'static_message';
+      }
     }
 
     export interface CheckAvailabilityCalTool {
@@ -1902,9 +2183,11 @@ export namespace LlmUpdateParams {
   }
 }
 
-export namespace Llm {
-  export import LlmResponse = LlmAPI.LlmResponse;
-  export import LlmListResponse = LlmAPI.LlmListResponse;
-  export import LlmCreateParams = LlmAPI.LlmCreateParams;
-  export import LlmUpdateParams = LlmAPI.LlmUpdateParams;
+export declare namespace Llm {
+  export {
+    type LlmResponse as LlmResponse,
+    type LlmListResponse as LlmListResponse,
+    type LlmCreateParams as LlmCreateParams,
+    type LlmUpdateParams as LlmUpdateParams,
+  };
 }

package/src/resources/phone-number.ts

@@ -2,7 +2,6 @@
 
 import { APIResource } from '../resource';
 import * as Core from '../core';
-import * as PhoneNumberAPI from './phone-number';
 
 export class PhoneNumber extends APIResource {
   /**
@@ -194,10 +193,12 @@ export interface PhoneNumberImportParams {
   sip_trunk_auth_username?: string;
 }
 
-export namespace PhoneNumber {
-  export import PhoneNumberResponse = PhoneNumberAPI.PhoneNumberResponse;
-  export import PhoneNumberListResponse = PhoneNumberAPI.PhoneNumberListResponse;
-  export import PhoneNumberCreateParams = PhoneNumberAPI.PhoneNumberCreateParams;
-  export import PhoneNumberUpdateParams = PhoneNumberAPI.PhoneNumberUpdateParams;
-  export import PhoneNumberImportParams = PhoneNumberAPI.PhoneNumberImportParams;
+export declare namespace PhoneNumber {
+  export {
+    type PhoneNumberResponse as PhoneNumberResponse,
+    type PhoneNumberListResponse as PhoneNumberListResponse,
+    type PhoneNumberCreateParams as PhoneNumberCreateParams,
+    type PhoneNumberUpdateParams as PhoneNumberUpdateParams,
+    type PhoneNumberImportParams as PhoneNumberImportParams,
+  };
 }

package/src/resources/voice.ts

@@ -2,7 +2,6 @@
 
 import { APIResource } from '../resource';
 import * as Core from '../core';
-import * as VoiceAPI from './voice';
 
 export class Voice extends APIResource {
   /**
@@ -59,7 +58,6 @@ export interface VoiceResponse {
 
 export type VoiceListResponse = Array<VoiceResponse>;
 
-export namespace Voice {
-  export import VoiceResponse = VoiceAPI.VoiceResponse;
-  export import VoiceListResponse = VoiceAPI.VoiceListResponse;
+export declare namespace Voice {
+  export { type VoiceResponse as VoiceResponse, type VoiceListResponse as VoiceListResponse };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '4.7.0'; // x-release-please-version
+export const VERSION = '4.9.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.7.0";
+export declare const VERSION = "4.9.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '4.7.0'; // x-release-please-version
+exports.VERSION = '4.9.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '4.7.0'; // x-release-please-version
+export const VERSION = '4.9.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map