retell-sdk 4.56.0 → 4.58.0

package/src/resources/conversation-flow.ts

@@ -172,6 +172,11 @@ export interface ConversationFlowResponse {
    */
   global_prompt?: string | null;
 
+  /**
+   * Whether this conversation flow is used for transfer LLM.
+   */
+  is_transfer_llm?: boolean | null;
+
   /**
    * Knowledge base configuration for RAG retrieval.
    */
@@ -7539,6 +7544,11 @@ export interface ConversationFlowCreateParams {
    */
   global_prompt?: string | null;
 
+  /**
+   * Whether this conversation flow is used for transfer LLM.
+   */
+  is_transfer_llm?: boolean | null;
+
   /**
    * Knowledge base configuration for RAG retrieval.
    */
@@ -14859,6 +14869,11 @@ export interface ConversationFlowUpdateParams {
    */
   global_prompt?: string | null;
 
+  /**
+   * Body param: Whether this conversation flow is used for transfer LLM.
+   */
+  is_transfer_llm?: boolean | null;
+
   /**
    * Body param: Knowledge base configuration for RAG retrieval.
    */

package/src/resources/index.ts

@@ -72,4 +72,5 @@ export {
   type PhoneNumberUpdateParams,
   type PhoneNumberImportParams,
 } from './phone-number';
+export { Tests, type BatchTestResponse, type TestCreateBatchTestParams } from './tests';
 export { Voice, type VoiceResponse, type VoiceListResponse } from './voice';

package/src/resources/llm.ts

@@ -11,9 +11,7 @@ export class Llm extends APIResource {
    *
    * @example
    * ```ts
-   * const llmResponse = await client.llm.create({
-   *   start_speaker: 'user',
-   * });
+   * const llmResponse = await client.llm.create();
    * ```
    */
   create(body: LlmCreateParams, options?: Core.RequestOptions): Core.APIPromise<LlmResponse> {
@@ -55,7 +53,6 @@ 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.',
    *   },
@@ -123,12 +120,6 @@ export interface LlmResponse {
    */
   llm_id: string;
 
-  /**
-   * The speaker who starts the conversation. Required. Must be either 'user' or
-   * 'agent'.
-   */
-  start_speaker: 'user' | 'agent';
-
   /**
    * If set, the AI will begin the conversation after waiting for the user for the
    * duration (in milliseconds) specified by this attribute. This only applies if the
@@ -192,11 +183,15 @@ export interface LlmResponse {
   kb_config?: LlmResponse.KBConfig | null;
 
   /**
-   * A list of knowledge base ids to use for this resource. Set to null to remove all
-   * knowledge bases.
+   * A list of knowledge base ids to use for this resource.
    */
   knowledge_base_ids?: Array<string> | null;
 
+  /**
+   * A list of MCPs to use for this LLM.
+   */
+  mcps?: Array<LlmResponse.Mcp> | null;
+
   /**
    * Select the underlying text LLM. If not set, would default to gpt-4.1.
    */
@@ -238,6 +233,12 @@ export interface LlmResponse {
    */
   s2s_model?: 'gpt-4o-realtime' | 'gpt-4o-mini-realtime' | 'gpt-realtime' | null;
 
+  /**
+   * The speaker who starts the conversation. Required. Must be either 'user' or
+   * 'agent'.
+   */
+  start_speaker?: 'user' | 'agent';
+
   /**
    * Name of the starting state. Required if states is not empty.
    */
@@ -261,9 +262,9 @@ export interface LlmResponse {
   tool_call_strict_mode?: boolean;
 
   /**
-   * Version of the Retell LLM.
+   * The version of the LLM.
    */
-  version?: unknown;
+  version?: number | null;
 }
 
 export namespace LlmResponse {
@@ -949,6 +950,31 @@ export namespace LlmResponse {
     top_k?: number;
   }
 
+  export interface Mcp {
+    name: string;
+
+    /**
+     * The URL of the MCP server.
+     */
+    url: string;
+
+    /**
+     * Headers to add to the MCP connection request.
+     */
+    headers?: { [key: string]: string };
+
+    /**
+     * Query parameters to append to the MCP connection request URL.
+     */
+    query_params?: { [key: string]: string };
+
+    /**
+     * Maximum time to wait for a connection to be established (in milliseconds).
+     * Default to 120,000 ms (2 minutes).
+     */
+    timeout_ms?: number;
+  }
+
   export interface State {
     /**
      * Name of the state, must be unique for each state. Must be consisted of a-z, A-Z,
@@ -1720,12 +1746,6 @@ 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';
-
   /**
    * If set, the AI will begin the conversation after waiting for the user for the
    * duration (in milliseconds) specified by this attribute. This only applies if the
@@ -1784,11 +1804,15 @@ export interface LlmCreateParams {
   kb_config?: LlmCreateParams.KBConfig | null;
 
   /**
-   * A list of knowledge base ids to use for this resource. Set to null to remove all
-   * knowledge bases.
+   * A list of knowledge base ids to use for this resource.
    */
   knowledge_base_ids?: Array<string> | null;
 
+  /**
+   * A list of MCPs to use for this LLM.
+   */
+  mcps?: Array<LlmCreateParams.Mcp> | null;
+
   /**
    * Select the underlying text LLM. If not set, would default to gpt-4.1.
    */
@@ -1830,6 +1854,12 @@ export interface LlmCreateParams {
    */
   s2s_model?: 'gpt-4o-realtime' | 'gpt-4o-mini-realtime' | 'gpt-realtime' | null;
 
+  /**
+   * The speaker who starts the conversation. Required. Must be either 'user' or
+   * 'agent'.
+   */
+  start_speaker?: 'user' | 'agent';
+
   /**
    * Name of the starting state. Required if states is not empty.
    */
@@ -1853,7 +1883,7 @@ export interface LlmCreateParams {
   tool_call_strict_mode?: boolean;
 
   /**
-   * Version of the Retell LLM.
+   * The version of the LLM.
    */
   version?: number | null;
 }
@@ -2541,6 +2571,31 @@ export namespace LlmCreateParams {
     top_k?: number;
   }
 
+  export interface Mcp {
+    name: string;
+
+    /**
+     * The URL of the MCP server.
+     */
+    url: string;
+
+    /**
+     * Headers to add to the MCP connection request.
+     */
+    headers?: { [key: string]: string };
+
+    /**
+     * Query parameters to append to the MCP connection request URL.
+     */
+    query_params?: { [key: string]: string };
+
+    /**
+     * Maximum time to wait for a connection to be established (in milliseconds).
+     * Default to 120,000 ms (2 minutes).
+     */
+    timeout_ms?: number;
+  }
+
   export interface State {
     /**
      * Name of the state, must be unique for each state. Must be consisted of a-z, A-Z,
@@ -3317,12 +3372,6 @@ 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.
@@ -3390,11 +3439,15 @@ export interface LlmUpdateParams {
   kb_config?: LlmUpdateParams.KBConfig | null;
 
   /**
-   * Body param: A list of knowledge base ids to use for this resource. Set to null
-   * to remove all knowledge bases.
+   * Body param: A list of knowledge base ids to use for this resource.
    */
   knowledge_base_ids?: Array<string> | null;
 
+  /**
+   * Body param: A list of MCPs to use for this LLM.
+   */
+  mcps?: Array<LlmUpdateParams.Mcp> | null;
+
   /**
    * Body param: Select the underlying text LLM. If not set, would default to
    * gpt-4.1.
@@ -3437,6 +3490,12 @@ export interface LlmUpdateParams {
    */
   s2s_model?: 'gpt-4o-realtime' | 'gpt-4o-mini-realtime' | 'gpt-realtime' | null;
 
+  /**
+   * Body param: The speaker who starts the conversation. Required. Must be either
+   * 'user' or 'agent'.
+   */
+  start_speaker?: 'user' | 'agent';
+
   /**
    * Body param: Name of the starting state. Required if states is not empty.
    */
@@ -3460,7 +3519,7 @@ export interface LlmUpdateParams {
   tool_call_strict_mode?: boolean;
 
   /**
-   * Body param: Version of the Retell LLM.
+   * Body param: The version of the LLM.
    */
   body_version?: number | null;
 }
@@ -4148,6 +4207,31 @@ export namespace LlmUpdateParams {
     top_k?: number;
   }
 
+  export interface Mcp {
+    name: string;
+
+    /**
+     * The URL of the MCP server.
+     */
+    url: string;
+
+    /**
+     * Headers to add to the MCP connection request.
+     */
+    headers?: { [key: string]: string };
+
+    /**
+     * Query parameters to append to the MCP connection request URL.
+     */
+    query_params?: { [key: string]: string };
+
+    /**
+     * Maximum time to wait for a connection to be established (in milliseconds).
+     * Default to 120,000 ms (2 minutes).
+     */
+    timeout_ms?: number;
+  }
+
   export interface State {
     /**
      * Name of the state, must be unique for each state. Must be consisted of a-z, A-Z,

package/src/resources/tests.ts

@@ -0,0 +1,168 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../resource';
+import * as Core from '../core';
+
+export class Tests extends APIResource {
+  /**
+   * Create a batch test to run multiple test cases
+   */
+  createBatchTest(
+    body: TestCreateBatchTestParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<BatchTestResponse> {
+    return this._client.post('/create-batch-test', { body, ...options });
+  }
+}
+
+export interface BatchTestResponse {
+  /**
+   * Timestamp when the batch job was created (milliseconds since epoch)
+   */
+  creation_timestamp: number;
+
+  /**
+   * Number of test cases that encountered errors
+   */
+  error_count: number;
+
+  /**
+   * Number of test cases that failed
+   */
+  fail_count: number;
+
+  /**
+   * Number of test cases that passed
+   */
+  pass_count: number;
+
+  response_engine:
+    | BatchTestResponse.ResponseEngineRetellLm
+    | BatchTestResponse.ResponseEngineCustomLm
+    | BatchTestResponse.ResponseEngineConversationFlow;
+
+  /**
+   * Status of the batch job
+   */
+  status: 'in_progress' | 'complete';
+
+  /**
+   * Unique identifier for the test case batch job
+   */
+  test_case_batch_job_id: string;
+
+  /**
+   * Total number of test cases in the batch
+   */
+  total_count: number;
+
+  /**
+   * Timestamp when the batch job was last modified (milliseconds since epoch)
+   */
+  user_modified_timestamp: number;
+}
+
+export namespace BatchTestResponse {
+  export 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;
+  }
+
+  export interface ResponseEngineCustomLm {
+    /**
+     * LLM websocket url of the custom LLM.
+     */
+    llm_websocket_url: string;
+
+    /**
+     * type of the Response Engine.
+     */
+    type: 'custom-llm';
+  }
+
+  export 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;
+  }
+}
+
+export interface TestCreateBatchTestParams {
+  /**
+   * Response engine to use for the test cases. Custom LLM is not supported.
+   */
+  response_engine:
+    | TestCreateBatchTestParams.ResponseEngineRetellLm
+    | TestCreateBatchTestParams.ResponseEngineConversationFlow;
+
+  /**
+   * Array of test case definition IDs to run
+   */
+  test_case_definition_ids: Array<string>;
+}
+
+export namespace TestCreateBatchTestParams {
+  export 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;
+  }
+
+  export 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;
+  }
+}
+
+export declare namespace Tests {
+  export {
+    type BatchTestResponse as BatchTestResponse,
+    type TestCreateBatchTestParams as TestCreateBatchTestParams,
+  };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '4.56.0'; // x-release-please-version
+export const VERSION = '4.58.0'; // x-release-please-version

package/version.d.ts

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

package/version.mjs

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