retell-sdk 4.48.0 → 4.50.0

package/src/resources/index.ts

@@ -58,6 +58,12 @@ export {
   type LlmUpdateParams,
   type LlmListParams,
 } from './llm';
+export {
+  McpTool,
+  type McpToolDefinition,
+  type McpToolGetMcpToolsResponse,
+  type McpToolGetMcpToolsParams,
+} from './mcp-tool';
 export {
   PhoneNumber,
   type PhoneNumberResponse,

package/src/resources/llm.ts

@@ -11,7 +11,9 @@ export class Llm extends APIResource {
    *
    * @example
    * ```ts
-   * const llmResponse = await client.llm.create();
+   * const llmResponse = await client.llm.create({
+   *   start_speaker: 'user',
+   * });
    * ```
    */
   create(body: LlmCreateParams, options?: Core.RequestOptions): Core.APIPromise<LlmResponse> {
@@ -53,6 +55,7 @@ export class Llm extends APIResource {
    * const llmResponse = await client.llm.update(
    *   '16b980523634a6dc504898cda492e939',
    *   {
+   *     start_speaker: 'user',
    *     begin_message:
    *       'Hey I am a virtual assistant calling from Retell Hospital.',
    *   },
@@ -120,6 +123,12 @@ export interface LlmResponse {
    */
   llm_id: string;
 
+  /**
+   * The speaker who starts the conversation. Required. Must be either 'user' or
+   * 'agent'.
+   */
+  start_speaker: 'user' | 'agent';
+
   /**
    * 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.
@@ -312,7 +321,7 @@ export namespace LlmResponse {
 
       /**
        * Extension digits to dial after the main number connects. Sent via DTMF. Allow
-       * digits, '\*', '#'.
+       * digits, '\*', '#', or a dynamic variable like {{extension}}.
        */
       extension?: string;
     }
@@ -357,6 +366,12 @@ export namespace LlmResponse {
        */
       agent_detection_timeout_ms?: number;
 
+      /**
+       * IVR navigation option to run when doing human detection. This prompt will guide
+       * the AI on how to navigate the IVR system.
+       */
+      ivr_option?: TransferOptionWarmTransfer.IvrOption;
+
       /**
        * The music to play while the caller is being transferred.
        */
@@ -394,6 +409,19 @@ export namespace LlmResponse {
     }
 
     export namespace TransferOptionWarmTransfer {
+      /**
+       * IVR navigation option to run when doing human detection. This prompt will guide
+       * the AI on how to navigate the IVR system.
+       */
+      export interface IvrOption {
+        /**
+         * The prompt to be used for warm handoff. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'prompt';
+      }
+
       export interface WarmTransferPrompt {
         /**
          * The prompt to be used for warm handoff. Can contain dynamic variables.
@@ -1060,7 +1088,7 @@ export namespace LlmResponse {
 
         /**
          * Extension digits to dial after the main number connects. Sent via DTMF. Allow
-         * digits, '\*', '#'.
+         * digits, '\*', '#', or a dynamic variable like {{extension}}.
          */
         extension?: string;
       }
@@ -1105,6 +1133,12 @@ export namespace LlmResponse {
          */
         agent_detection_timeout_ms?: number;
 
+        /**
+         * IVR navigation option to run when doing human detection. This prompt will guide
+         * the AI on how to navigate the IVR system.
+         */
+        ivr_option?: TransferOptionWarmTransfer.IvrOption;
+
         /**
          * The music to play while the caller is being transferred.
          */
@@ -1142,6 +1176,19 @@ export namespace LlmResponse {
       }
 
       export namespace TransferOptionWarmTransfer {
+        /**
+         * IVR navigation option to run when doing human detection. This prompt will guide
+         * the AI on how to navigate the IVR system.
+         */
+        export interface IvrOption {
+          /**
+           * The prompt to be used for warm handoff. Can contain dynamic variables.
+           */
+          prompt?: string;
+
+          type?: 'prompt';
+        }
+
         export interface WarmTransferPrompt {
           /**
            * The prompt to be used for warm handoff. Can contain dynamic variables.
@@ -1637,6 +1684,12 @@ export namespace LlmResponse {
 export type LlmListResponse = Array<LlmResponse>;
 
 export interface LlmCreateParams {
+  /**
+   * The speaker who starts the conversation. Required. Must be either 'user' or
+   * 'agent'.
+   */
+  start_speaker: 'user' | 'agent';
+
   /**
    * 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.
@@ -1824,7 +1877,7 @@ export namespace LlmCreateParams {
 
       /**
        * Extension digits to dial after the main number connects. Sent via DTMF. Allow
-       * digits, '\*', '#'.
+       * digits, '\*', '#', or a dynamic variable like {{extension}}.
        */
       extension?: string;
     }
@@ -1869,6 +1922,12 @@ export namespace LlmCreateParams {
        */
       agent_detection_timeout_ms?: number;
 
+      /**
+       * IVR navigation option to run when doing human detection. This prompt will guide
+       * the AI on how to navigate the IVR system.
+       */
+      ivr_option?: TransferOptionWarmTransfer.IvrOption;
+
       /**
        * The music to play while the caller is being transferred.
        */
@@ -1906,6 +1965,19 @@ export namespace LlmCreateParams {
     }
 
     export namespace TransferOptionWarmTransfer {
+      /**
+       * IVR navigation option to run when doing human detection. This prompt will guide
+       * the AI on how to navigate the IVR system.
+       */
+      export interface IvrOption {
+        /**
+         * The prompt to be used for warm handoff. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'prompt';
+      }
+
       export interface WarmTransferPrompt {
         /**
          * The prompt to be used for warm handoff. Can contain dynamic variables.
@@ -2572,7 +2644,7 @@ export namespace LlmCreateParams {
 
         /**
          * Extension digits to dial after the main number connects. Sent via DTMF. Allow
-         * digits, '\*', '#'.
+         * digits, '\*', '#', or a dynamic variable like {{extension}}.
          */
         extension?: string;
       }
@@ -2617,6 +2689,12 @@ export namespace LlmCreateParams {
          */
         agent_detection_timeout_ms?: number;
 
+        /**
+         * IVR navigation option to run when doing human detection. This prompt will guide
+         * the AI on how to navigate the IVR system.
+         */
+        ivr_option?: TransferOptionWarmTransfer.IvrOption;
+
         /**
          * The music to play while the caller is being transferred.
          */
@@ -2654,6 +2732,19 @@ export namespace LlmCreateParams {
       }
 
       export namespace TransferOptionWarmTransfer {
+        /**
+         * IVR navigation option to run when doing human detection. This prompt will guide
+         * the AI on how to navigate the IVR system.
+         */
+        export interface IvrOption {
+          /**
+           * The prompt to be used for warm handoff. Can contain dynamic variables.
+           */
+          prompt?: string;
+
+          type?: 'prompt';
+        }
+
         export interface WarmTransferPrompt {
           /**
            * The prompt to be used for warm handoff. Can contain dynamic variables.
@@ -3154,6 +3245,12 @@ export interface LlmRetrieveParams {
 }
 
 export interface LlmUpdateParams {
+  /**
+   * Body param: The speaker who starts the conversation. Required. Must be either
+   * 'user' or 'agent'.
+   */
+  start_speaker: 'user' | 'agent';
+
   /**
    * Query param: Optional version of the API to use for this request. Default to
    * latest version.
@@ -3351,7 +3448,7 @@ export namespace LlmUpdateParams {
 
       /**
        * Extension digits to dial after the main number connects. Sent via DTMF. Allow
-       * digits, '\*', '#'.
+       * digits, '\*', '#', or a dynamic variable like {{extension}}.
        */
       extension?: string;
     }
@@ -3396,6 +3493,12 @@ export namespace LlmUpdateParams {
        */
       agent_detection_timeout_ms?: number;
 
+      /**
+       * IVR navigation option to run when doing human detection. This prompt will guide
+       * the AI on how to navigate the IVR system.
+       */
+      ivr_option?: TransferOptionWarmTransfer.IvrOption;
+
       /**
        * The music to play while the caller is being transferred.
        */
@@ -3433,6 +3536,19 @@ export namespace LlmUpdateParams {
     }
 
     export namespace TransferOptionWarmTransfer {
+      /**
+       * IVR navigation option to run when doing human detection. This prompt will guide
+       * the AI on how to navigate the IVR system.
+       */
+      export interface IvrOption {
+        /**
+         * The prompt to be used for warm handoff. Can contain dynamic variables.
+         */
+        prompt?: string;
+
+        type?: 'prompt';
+      }
+
       export interface WarmTransferPrompt {
         /**
          * The prompt to be used for warm handoff. Can contain dynamic variables.
@@ -4099,7 +4215,7 @@ export namespace LlmUpdateParams {
 
         /**
          * Extension digits to dial after the main number connects. Sent via DTMF. Allow
-         * digits, '\*', '#'.
+         * digits, '\*', '#', or a dynamic variable like {{extension}}.
          */
         extension?: string;
       }
@@ -4144,6 +4260,12 @@ export namespace LlmUpdateParams {
          */
         agent_detection_timeout_ms?: number;
 
+        /**
+         * IVR navigation option to run when doing human detection. This prompt will guide
+         * the AI on how to navigate the IVR system.
+         */
+        ivr_option?: TransferOptionWarmTransfer.IvrOption;
+
         /**
          * The music to play while the caller is being transferred.
          */
@@ -4181,6 +4303,19 @@ export namespace LlmUpdateParams {
       }
 
       export namespace TransferOptionWarmTransfer {
+        /**
+         * IVR navigation option to run when doing human detection. This prompt will guide
+         * the AI on how to navigate the IVR system.
+         */
+        export interface IvrOption {
+          /**
+           * The prompt to be used for warm handoff. Can contain dynamic variables.
+           */
+          prompt?: string;
+
+          type?: 'prompt';
+        }
+
         export interface WarmTransferPrompt {
           /**
            * The prompt to be used for warm handoff. Can contain dynamic variables.

package/src/resources/mcp-tool.ts

@@ -0,0 +1,56 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../resource';
+import * as Core from '../core';
+
+export class McpTool extends APIResource {
+  /**
+   * Get MCP tools for a specific agent
+   */
+  getMcpTools(
+    agentId: string,
+    query: McpToolGetMcpToolsParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<McpToolGetMcpToolsResponse> {
+    return this._client.get(`/get-mcp-tools/${agentId}`, { query, ...options });
+  }
+}
+
+export interface McpToolDefinition {
+  /**
+   * Description of what the MCP tool does.
+   */
+  description: string;
+
+  /**
+   * JSON schema defining the input parameters for the tool.
+   */
+  inputSchema: { [key: string]: unknown };
+
+  /**
+   * Name of the MCP tool.
+   */
+  name: string;
+}
+
+export type McpToolGetMcpToolsResponse = Array<McpToolDefinition>;
+
+export interface McpToolGetMcpToolsParams {
+  /**
+   * The ID of the MCP server to get tools from.
+   */
+  mcp_id: string;
+
+  /**
+   * Optional version of the API to use for this request.
+   */
+  version?: number;
+}
+
+export declare namespace McpTool {
+  export {
+    type McpToolDefinition as McpToolDefinition,
+    type McpToolGetMcpToolsResponse as McpToolGetMcpToolsResponse,
+    type McpToolGetMcpToolsParams as McpToolGetMcpToolsParams,
+  };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '4.48.0'; // x-release-please-version
+export const VERSION = '4.50.0'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.48.0";
+export declare const VERSION = "4.50.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.48.0'; // x-release-please-version
+exports.VERSION = '4.50.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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