retell-sdk 5.25.1 → 5.26.0

package/src/resources/call.ts

@@ -359,6 +359,7 @@ export interface PhoneCallResponse {
     | PhoneCallResponse.ToolCallResultUtterance
     | PhoneCallResponse.NodeTransitionUtterance
     | PhoneCallResponse.DtmfUtterance
+    | PhoneCallResponse.SMSUtterance
   >;
 
   /**
@@ -395,6 +396,7 @@ export interface PhoneCallResponse {
     | PhoneCallResponse.ToolCallResultUtterance
     | PhoneCallResponse.NodeTransitionUtterance
     | PhoneCallResponse.DtmfUtterance
+    | PhoneCallResponse.SMSUtterance
   >;
 
   /**
@@ -1038,6 +1040,44 @@ export namespace PhoneCallResponse {
     role: 'dtmf';
   }
 
+  export interface SMSUtterance {
+    /**
+     * Text content of the SMS message.
+     */
+    content: string;
+
+    /**
+     * SMS message received from the user during the call (for example while the agent
+     * is leaving a voicemail). Not part of the spoken conversation.
+     */
+    role: 'sms';
+
+    /**
+     * Time the SMS was received, in seconds relative to the start of the call.
+     */
+    time_sec: number;
+
+    /**
+     * Multimedia attachments (MMS). Display only; not relayed into the spoken
+     * conversation.
+     */
+    multimedia?: Array<SMSUtterance.Multimedia>;
+  }
+
+  export namespace SMSUtterance {
+    export interface Multimedia {
+      /**
+       * URL of the multimedia attachment.
+       */
+      url: string;
+
+      /**
+       * Optional textual summary of the attachment.
+       */
+      summary?: string;
+    }
+  }
+
   /**
    * Telephony identifier of the call, populated when available. Tracking purposes
    * only.
@@ -1226,6 +1266,44 @@ export namespace PhoneCallResponse {
      */
     role: 'dtmf';
   }
+
+  export interface SMSUtterance {
+    /**
+     * Text content of the SMS message.
+     */
+    content: string;
+
+    /**
+     * SMS message received from the user during the call (for example while the agent
+     * is leaving a voicemail). Not part of the spoken conversation.
+     */
+    role: 'sms';
+
+    /**
+     * Time the SMS was received, in seconds relative to the start of the call.
+     */
+    time_sec: number;
+
+    /**
+     * Multimedia attachments (MMS). Display only; not relayed into the spoken
+     * conversation.
+     */
+    multimedia?: Array<SMSUtterance.Multimedia>;
+  }
+
+  export namespace SMSUtterance {
+    export interface Multimedia {
+      /**
+       * URL of the multimedia attachment.
+       */
+      url: string;
+
+      /**
+       * Optional textual summary of the attachment.
+       */
+      summary?: string;
+    }
+  }
 }
 
 export interface WebCallResponse {
@@ -1432,6 +1510,7 @@ export interface WebCallResponse {
     | WebCallResponse.ToolCallResultUtterance
     | WebCallResponse.NodeTransitionUtterance
     | WebCallResponse.DtmfUtterance
+    | WebCallResponse.SMSUtterance
   >;
 
   /**
@@ -1462,6 +1541,7 @@ export interface WebCallResponse {
     | WebCallResponse.ToolCallResultUtterance
     | WebCallResponse.NodeTransitionUtterance
     | WebCallResponse.DtmfUtterance
+    | WebCallResponse.SMSUtterance
   >;
 
   /**
@@ -2105,6 +2185,44 @@ export namespace WebCallResponse {
     role: 'dtmf';
   }
 
+  export interface SMSUtterance {
+    /**
+     * Text content of the SMS message.
+     */
+    content: string;
+
+    /**
+     * SMS message received from the user during the call (for example while the agent
+     * is leaving a voicemail). Not part of the spoken conversation.
+     */
+    role: 'sms';
+
+    /**
+     * Time the SMS was received, in seconds relative to the start of the call.
+     */
+    time_sec: number;
+
+    /**
+     * Multimedia attachments (MMS). Display only; not relayed into the spoken
+     * conversation.
+     */
+    multimedia?: Array<SMSUtterance.Multimedia>;
+  }
+
+  export namespace SMSUtterance {
+    export interface Multimedia {
+      /**
+       * URL of the multimedia attachment.
+       */
+      url: string;
+
+      /**
+       * Optional textual summary of the attachment.
+       */
+      summary?: string;
+    }
+  }
+
   export interface TranscriptObject {
     /**
      * Transcript of the utterances.
@@ -2282,6 +2400,44 @@ export namespace WebCallResponse {
      */
     role: 'dtmf';
   }
+
+  export interface SMSUtterance {
+    /**
+     * Text content of the SMS message.
+     */
+    content: string;
+
+    /**
+     * SMS message received from the user during the call (for example while the agent
+     * is leaving a voicemail). Not part of the spoken conversation.
+     */
+    role: 'sms';
+
+    /**
+     * Time the SMS was received, in seconds relative to the start of the call.
+     */
+    time_sec: number;
+
+    /**
+     * Multimedia attachments (MMS). Display only; not relayed into the spoken
+     * conversation.
+     */
+    multimedia?: Array<SMSUtterance.Multimedia>;
+  }
+
+  export namespace SMSUtterance {
+    export interface Multimedia {
+      /**
+       * URL of the multimedia attachment.
+       */
+      url: string;
+
+      /**
+       * Optional textual summary of the attachment.
+       */
+      summary?: string;
+    }
+  }
 }
 
 export interface CallListResponse {
@@ -2296,6 +2452,12 @@ export interface CallListResponse {
    * Pagination key for the next page.
    */
   pagination_key?: string;
+
+  /**
+   * Total number of calls matching `filter_criteria`. Only present when
+   * `include_total` is true.
+   */
+  total?: number;
 }
 
 export namespace CallListResponse {
@@ -3769,6 +3931,14 @@ export interface CallListParams {
    */
   filter_criteria?: CallListParams.FilterCriteria;
 
+  /**
+   * Whether to include `total` (count of all calls matching `filter_criteria`,
+   * ignoring `limit`/`skip`/`pagination_key`) in the response. Defaults to false.
+   * Each enabled request triggers an additional aggregate query, so opt in only when
+   * the total is needed.
+   */
+  include_total?: boolean;
+
   /**
    * Maximum number of calls to return.
    */
@@ -4891,12 +5061,6 @@ export namespace CallCreatePhoneCallParams {
        */
       interruption_sensitivity?: number;
 
-      /**
-       * Whether the agent is public. When set to true, the agent is available for public
-       * agent preview link.
-       */
-      is_public?: boolean | null;
-
       /**
        * If this option is set, the call will try to detect IVR in the first 3 minutes of
        * the call. Actions defined will be applied when the IVR is detected. Set this to
@@ -5435,7 +5599,9 @@ export namespace CallCreatePhoneCallParams {
        */
       export interface PiiConfig {
         /**
-         * List of PII categories to scrub from transcripts and recordings.
+         * List of PII categories to scrub from transcripts and recordings. PII redaction
+         * is only active when this list is non-empty; an empty array means no PII
+         * scrubbing is performed.
          */
         categories: Array<
           | 'person_name'
@@ -6254,12 +6420,6 @@ export namespace CallCreateWebCallParams {
        */
       interruption_sensitivity?: number;
 
-      /**
-       * Whether the agent is public. When set to true, the agent is available for public
-       * agent preview link.
-       */
-      is_public?: boolean | null;
-
       /**
        * If this option is set, the call will try to detect IVR in the first 3 minutes of
        * the call. Actions defined will be applied when the IVR is detected. Set this to
@@ -6798,7 +6958,9 @@ export namespace CallCreateWebCallParams {
        */
       export interface PiiConfig {
         /**
-         * List of PII categories to scrub from transcripts and recordings.
+         * List of PII categories to scrub from transcripts and recordings. PII redaction
+         * is only active when this list is non-empty; an empty array means no PII
+         * scrubbing is performed.
          */
         categories: Array<
           | 'person_name'
@@ -7617,12 +7779,6 @@ export namespace CallRegisterPhoneCallParams {
        */
       interruption_sensitivity?: number;
 
-      /**
-       * Whether the agent is public. When set to true, the agent is available for public
-       * agent preview link.
-       */
-      is_public?: boolean | null;
-
       /**
        * If this option is set, the call will try to detect IVR in the first 3 minutes of
        * the call. Actions defined will be applied when the IVR is detected. Set this to
@@ -8161,7 +8317,9 @@ export namespace CallRegisterPhoneCallParams {
        */
       export interface PiiConfig {
         /**
-         * List of PII categories to scrub from transcripts and recordings.
+         * List of PII categories to scrub from transcripts and recordings. PII redaction
+         * is only active when this list is non-empty; an empty array means no PII
+         * scrubbing is performed.
          */
         categories: Array<
           | 'person_name'

package/src/resources/chat-agent.ts

@@ -221,12 +221,6 @@ export interface ChatAgentResponse {
    */
   handbook_config?: ChatAgentResponse.HandbookConfig;
 
-  /**
-   * Whether the agent is public. When set to true, the agent is available for public
-   * agent preview link.
-   */
-  is_public?: boolean | null;
-
   /**
    * Whether the chat agent is published.
    */
@@ -566,7 +560,9 @@ export namespace ChatAgentResponse {
    */
   export interface PiiConfig {
     /**
-     * List of PII categories to scrub from transcripts and recordings.
+     * List of PII categories to scrub from transcripts and recordings. PII redaction
+     * is only active when this list is non-empty; an empty array means no PII
+     * scrubbing is performed.
      */
     categories: Array<
       | 'person_name'
@@ -832,12 +828,6 @@ export interface ChatAgentCreateParams {
    */
   handbook_config?: ChatAgentCreateParams.HandbookConfig;
 
-  /**
-   * Whether the agent is public. When set to true, the agent is available for public
-   * agent preview link.
-   */
-  is_public?: boolean | null;
-
   /**
    * Specifies what language(s) the agent will operate in. Accepts either a single
    * scalar locale (e.g. `en-US`), the legacy scalar value `multi` for multilingual
@@ -1167,7 +1157,9 @@ export namespace ChatAgentCreateParams {
    */
   export interface PiiConfig {
     /**
-     * List of PII categories to scrub from transcripts and recordings.
+     * List of PII categories to scrub from transcripts and recordings. PII redaction
+     * is only active when this list is non-empty; an empty array means no PII
+     * scrubbing is performed.
      */
     categories: Array<
       | 'person_name'
@@ -1435,12 +1427,6 @@ export interface ChatAgentUpdateParams {
    */
   handbook_config?: ChatAgentUpdateParams.HandbookConfig;
 
-  /**
-   * Body param: Whether the agent is public. When set to true, the agent is
-   * available for public agent preview link.
-   */
-  is_public?: boolean | null;
-
   /**
    * Body param: Specifies what language(s) the agent will operate in. Accepts either
    * a single scalar locale (e.g. `en-US`), the legacy scalar value `multi` for
@@ -1734,7 +1720,9 @@ export namespace ChatAgentUpdateParams {
    */
   export interface PiiConfig {
     /**
-     * List of PII categories to scrub from transcripts and recordings.
+     * List of PII categories to scrub from transcripts and recordings. PII redaction
+     * is only active when this list is non-empty; an empty array means no PII
+     * scrubbing is performed.
      */
     categories: Array<
       | 'person_name'

package/src/resources/chat.ts

@@ -483,6 +483,12 @@ export interface ChatListResponse {
    * Pagination key for the next page.
    */
   pagination_key?: string;
+
+  /**
+   * Total number of chats matching `filter_criteria`. Only present when
+   * `include_total` is true.
+   */
+  total?: number;
 }
 
 export namespace ChatListResponse {
@@ -675,7 +681,7 @@ export namespace ChatCreateChatCompletionResponse {
 
 export interface ChatCreateParams {
   /**
-   * The chat agent to use for the call.
+   * The chat agent to use for the chat.
    */
   agent_id: string;
 
@@ -736,6 +742,14 @@ export interface ChatListParams {
    */
   filter_criteria?: unknown;
 
+  /**
+   * Whether to include `total` (count of all chats matching `filter_criteria`,
+   * ignoring `limit`/`skip`/`pagination_key`) in the response. Defaults to false.
+   * Each enabled request triggers an additional aggregate query, so opt in only when
+   * the total is needed.
+   */
+  include_total?: boolean;
+
   /**
    * Maximum number of chats to return.
    */

package/src/resources/conversation-flow-component.ts

@@ -152,6 +152,11 @@ export interface ConversationFlowComponentResponse {
    */
   begin_tag_display_position?: ConversationFlowComponentResponse.BeginTagDisplayPosition | null;
 
+  /**
+   * If enabled, the whole component will be converted as a Single Prompt agent.
+   */
+  flex_mode?: boolean | null;
+
   /**
    * IDs of conversation flows linked to this shared component
    */
@@ -8392,6 +8397,11 @@ export interface ConversationFlowComponentCreateParams {
    */
   begin_tag_display_position?: ConversationFlowComponentCreateParams.BeginTagDisplayPosition | null;
 
+  /**
+   * If enabled, the whole component will be converted as a Single Prompt agent.
+   */
+  flex_mode?: boolean | null;
+
   /**
    * A list of MCP server configurations to use for this component
    */
@@ -16587,6 +16597,11 @@ export interface ConversationFlowComponentUpdateParams {
    */
   begin_tag_display_position?: ConversationFlowComponentUpdateParams.BeginTagDisplayPosition | null;
 
+  /**
+   * If enabled, the whole component will be converted as a Single Prompt agent.
+   */
+  flex_mode?: boolean | null;
+
   /**
    * A list of MCP server configurations to use for this component
    */

package/src/resources/conversation-flow.ts

@@ -146,6 +146,12 @@ export interface ConversationFlowResponse {
    */
   default_dynamic_variables?: { [key: string]: string } | null;
 
+  /**
+   * If enabled, the whole conversation flow will be converted as a Single Prompt
+   * agent.
+   */
+  flex_mode?: boolean | null;
+
   /**
    * Global prompt used in every node of the conversation flow.
    */
@@ -276,6 +282,11 @@ export namespace ConversationFlowResponse {
      */
     begin_tag_display_position?: Component.BeginTagDisplayPosition | null;
 
+    /**
+     * If enabled, the whole component will be converted as a Single Prompt agent.
+     */
+    flex_mode?: boolean | null;
+
     /**
      * A list of MCP server configurations to use for this component
      */
@@ -16740,6 +16751,12 @@ export interface ConversationFlowCreateParams {
    */
   default_dynamic_variables?: { [key: string]: string } | null;
 
+  /**
+   * If enabled, the whole conversation flow will be converted as a Single Prompt
+   * agent.
+   */
+  flex_mode?: boolean | null;
+
   /**
    * Global prompt used in every node of the conversation flow.
    */
@@ -24734,6 +24751,11 @@ export namespace ConversationFlowCreateParams {
      */
     begin_tag_display_position?: Component.BeginTagDisplayPosition | null;
 
+    /**
+     * If enabled, the whole component will be converted as a Single Prompt agent.
+     */
+    flex_mode?: boolean | null;
+
     /**
      * A list of MCP server configurations to use for this component
      */
@@ -33272,6 +33294,12 @@ export interface ConversationFlowUpdateParams {
    */
   default_dynamic_variables?: { [key: string]: string } | null;
 
+  /**
+   * Body param: If enabled, the whole conversation flow will be converted as a
+   * Single Prompt agent.
+   */
+  flex_mode?: boolean | null;
+
   /**
    * Body param: Global prompt used in every node of the conversation flow.
    */
@@ -33403,6 +33431,11 @@ export namespace ConversationFlowUpdateParams {
      */
     begin_tag_display_position?: Component.BeginTagDisplayPosition | null;
 
+    /**
+     * If enabled, the whole component will be converted as a Single Prompt agent.
+     */
+    flex_mode?: boolean | null;
+
     /**
      * A list of MCP server configurations to use for this component
      */

package/src/resources/knowledge-base.ts

@@ -168,6 +168,11 @@ export interface KnowledgeBaseResponse {
 
 export namespace KnowledgeBaseResponse {
   export interface KnowledgeBaseSourceDocument {
+    /**
+     * File size in bytes.
+     */
+    file_size: number;
+
     /**
      * URL of the document stored.
      */

package/src/resources/llm.ts

@@ -53,12 +53,8 @@ export class Llm extends APIResource {
    * ```
    */
   update(llmID: string, params: LlmUpdateParams, options?: RequestOptions): APIPromise<LlmResponse> {
-    const { query_version, ...body } = params;
-    return this._client.patch(path`/update-retell-llm/${llmID}`, {
-      query: { version: query_version },
-      body,
-      ...options,
-    });
+    const { version, ...body } = params;
+    return this._client.patch(path`/update-retell-llm/${llmID}`, { query: { version }, body, ...options });
   }
 
   /**
@@ -246,9 +242,9 @@ export interface LlmResponse {
   tool_call_strict_mode?: boolean | null;
 
   /**
-   * The version of the LLM.
+   * Version of the Retell LLM Response Engine.
    */
-  version?: number | null;
+  version?: number;
 }
 
 export namespace LlmResponse {
@@ -2797,11 +2793,6 @@ export interface LlmCreateParams {
    * supported models.
    */
   tool_call_strict_mode?: boolean | null;
-
-  /**
-   * The version of the LLM.
-   */
-  version?: number | null;
 }
 
 export namespace LlmCreateParams {
@@ -5209,7 +5200,7 @@ export interface LlmUpdateParams {
    * Query param: Optional version of the API to use for this request. Default to
    * latest version.
    */
-  query_version?: number;
+  version?: number;
 
   /**
    * Body param: If set, the AI will begin the conversation after waiting for the
@@ -5352,11 +5343,6 @@ export interface LlmUpdateParams {
    * using certain supported models.
    */
   tool_call_strict_mode?: boolean | null;
-
-  /**
-   * Body param: The version of the LLM.
-   */
-  body_version?: number | null;
 }
 
 export namespace LlmUpdateParams {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '5.25.1'; // x-release-please-version
+export const VERSION = '5.26.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "5.25.1";
+export declare const VERSION = "5.26.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

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

package/version.mjs

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