@deepdesk/deepdesk-sdk 19.3.0 → 19.3.1-beta.0

package/dist/index.d.mts

@@ -407,6 +407,11 @@ declare enum FetchState {
     ERROR = "error"
 }
 
+interface State$a {
+    current: Conversation | null;
+    isSupported: boolean | null;
+}
+
 type CallToAction = Server.CallToAction;
 type LegacyCue = CamelCaseKeys<Server.LegacyCue> & {
     isLoading?: boolean;
@@ -421,6 +426,13 @@ type ArrayItemType<T> = T extends Array<infer I> ? I : never;
 type Cue = ArrayItemType<EvaluationOutput> & {
     isLoading?: boolean;
     evaluationId: string;
+    externalConversationId?: string;
+};
+type ConversationAssistantResult = {
+    assistantCode: string;
+    evaluationId: string;
+    output: EvaluationOutput;
+    externalConversationId: string;
 };
 type AssistantAnswerSource = {
     url?: string;
@@ -434,7 +446,7 @@ type AssistantInteraction = {
     };
     evaluationId: string;
 };
-type State$a = {
+type State$9 = {
     cues: Cue[];
     threads: Record<number, AssistantInteraction[]>;
     pending: string[];
@@ -450,6 +462,7 @@ interface EvaluateInput {
     input?: any;
     transcript?: TranscriptOption;
     includeMetadata?: boolean;
+    externalConversationId?: string;
     skipState?: boolean;
 }
 
@@ -1009,6 +1022,10 @@ type SendEventArgumentMap = {
     'Assistant response displayed': Event$1<AssistantEventMeta & {
         input?: string;
     }>;
+    'Assistant evaluation completed': Event$1<AssistantEventMeta & {
+        externalConversationId?: string;
+        evaluationStatus: 'success' | 'failed';
+    }>;
     'Assistant response closed': Event$1<AssistantEventMeta>;
     'Assistant response feedback': Event$1<AssistantEventMeta & {
         rating: 'up' | 'down';
@@ -1178,12 +1195,12 @@ declare class DeepdeskAPI {
 }
 
 type StyleSuggestion = CamelCaseKeys<Server.StyleSuggestion>;
-interface State$9 {
+interface State$8 {
     list: StyleSuggestion;
     fetchState: FetchState;
 }
 
-type State$8 = {
+type State$7 = {
     data: Profile | null;
     fetchState: FetchState;
 };
@@ -1304,7 +1321,7 @@ type MetricState = {
     textSuggestions: SuggestionMetrics[];
     cuts: any[];
 };
-type State$7 = {
+type State$6 = {
     text: string;
     html: string | null;
     suggestionTextStart: number;
@@ -1321,27 +1338,22 @@ type State$7 = {
     selectedSuggestionIndex: number;
 };
 
-type State$6 = {
+type State$5 = {
     startTime: Date | null;
     stopTime: Date | null;
 };
 
-type State$5 = {
+type State$4 = {
     token: string | null;
     interval: NodeJS.Timer | null;
 };
 
 type ContentType = CamelCaseKeys<Server.ContentType>;
-type State$4 = {
+type State$3 = {
     data: ContentType[] | null;
     fetchState: FetchState;
 };
 
-interface State$3 {
-    current: Conversation | null;
-    isSupported: boolean | null;
-}
-
 interface State$2 {
     isLoggedIn: boolean | null;
     loginFetchState: FetchState;
@@ -1362,13 +1374,13 @@ interface StoreConfig {
     preloadedState?: any;
 }
 declare const reducers: redux.Reducer<{
-    assistants: State$a;
+    assistants: State$9;
     auth: State$2;
-    conversation: State$3;
-    contentTypes: State$4;
-    passwordlessToken: State$5;
+    conversation: State$a;
+    contentTypes: State$3;
+    passwordlessToken: State$4;
     entities: State$1;
-    handlingTime: State$6;
+    handlingTime: State$5;
     info: {
         agentInfo?: AgentInfo;
         agentSettings: unknown;
@@ -1378,7 +1390,7 @@ declare const reducers: redux.Reducer<{
         fetchState: FetchState;
         showNicknameDialog: boolean;
     };
-    input: State$7;
+    input: State$6;
     settings: {
         locale: Locale;
         deanonymize: boolean;
@@ -1415,9 +1427,9 @@ declare const reducers: redux.Reducer<{
         enableFeedbackForm: boolean;
         hasKeyboardInput: boolean;
     };
-    profile: State$8;
+    profile: State$7;
     search: State$b;
-    styleSuggestions: State$9;
+    styleSuggestions: State$8;
     ui: {
         showTabHint: boolean;
         inputHasFocus: boolean;
@@ -1427,13 +1439,13 @@ declare const reducers: redux.Reducer<{
     };
     textSuggestions: TextSuggestionState;
 }, redux.UnknownAction, Partial<{
-    assistants: State$a | undefined;
+    assistants: State$9 | undefined;
     auth: State$2 | undefined;
-    conversation: State$3 | undefined;
-    contentTypes: State$4 | undefined;
-    passwordlessToken: State$5 | undefined;
+    conversation: State$a | undefined;
+    contentTypes: State$3 | undefined;
+    passwordlessToken: State$4 | undefined;
     entities: State$1 | undefined;
-    handlingTime: State$6 | undefined;
+    handlingTime: State$5 | undefined;
     info: {
         agentInfo?: AgentInfo;
         agentSettings: unknown;
@@ -1443,7 +1455,7 @@ declare const reducers: redux.Reducer<{
         fetchState: FetchState;
         showNicknameDialog: boolean;
     } | undefined;
-    input: State$7 | undefined;
+    input: State$6 | undefined;
     settings: {
         locale: Locale;
         deanonymize: boolean;
@@ -1480,9 +1492,9 @@ declare const reducers: redux.Reducer<{
         enableFeedbackForm: boolean;
         hasKeyboardInput: boolean;
     } | undefined;
-    profile: State$8 | undefined;
+    profile: State$7 | undefined;
     search: State$b | undefined;
-    styleSuggestions: State$9 | undefined;
+    styleSuggestions: State$8 | undefined;
     ui: {
         showTabHint: boolean;
         inputHasFocus: boolean;
@@ -1493,13 +1505,13 @@ declare const reducers: redux.Reducer<{
     textSuggestions: TextSuggestionState | undefined;
 }>>;
 declare function createStore(config: StoreConfig): _reduxjs_toolkit.EnhancedStore<{
-    assistants: State$a;
+    assistants: State$9;
     auth: State$2;
-    conversation: State$3;
-    contentTypes: State$4;
-    passwordlessToken: State$5;
+    conversation: State$a;
+    contentTypes: State$3;
+    passwordlessToken: State$4;
     entities: State$1;
-    handlingTime: State$6;
+    handlingTime: State$5;
     info: {
         agentInfo?: AgentInfo;
         agentSettings: unknown;
@@ -1509,7 +1521,7 @@ declare function createStore(config: StoreConfig): _reduxjs_toolkit.EnhancedStor
         fetchState: FetchState;
         showNicknameDialog: boolean;
     };
-    input: State$7;
+    input: State$6;
     settings: {
         locale: Locale;
         deanonymize: boolean;
@@ -1546,9 +1558,9 @@ declare function createStore(config: StoreConfig): _reduxjs_toolkit.EnhancedStor
         enableFeedbackForm: boolean;
         hasKeyboardInput: boolean;
     };
-    profile: State$8;
+    profile: State$7;
     search: State$b;
-    styleSuggestions: State$9;
+    styleSuggestions: State$8;
     ui: {
         showTabHint: boolean;
         inputHasFocus: boolean;
@@ -2034,6 +2046,7 @@ interface RenderOptions {
     appendOverlayTo?: HTMLElement;
     inputMediator?: InputMediator<HTMLElement>;
 }
+
 interface MountOptions extends Partial<Settings>, RenderOptions {
 }
 interface KnowledgeAssistOptions {
@@ -2112,13 +2125,13 @@ declare class DeepdeskSDK {
      */
     constructor({ deepdeskUrl, version, locale, token, fetch, productName, createCustomChannel, websocketClient, }: SDKOptions);
     get state(): {
-        assistants: State$a;
+        assistants: State$9;
         auth: State$2;
-        conversation: State$3;
-        contentTypes: State$4;
-        passwordlessToken: State$5;
+        conversation: State$a;
+        contentTypes: State$3;
+        passwordlessToken: State$4;
         entities: State$1;
-        handlingTime: State$6;
+        handlingTime: State$5;
         info: {
             agentInfo?: AgentInfo;
             agentSettings: unknown;
@@ -2128,7 +2141,7 @@ declare class DeepdeskSDK {
             fetchState: FetchState;
             showNicknameDialog: boolean;
         };
-        input: State$7;
+        input: State$6;
         settings: {
             locale: Locale;
             deanonymize: boolean;
@@ -2165,9 +2178,9 @@ declare class DeepdeskSDK {
             enableFeedbackForm: boolean;
             hasKeyboardInput: boolean;
         };
-        profile: State$8;
+        profile: State$7;
         search: State$b;
-        styleSuggestions: State$9;
+        styleSuggestions: State$8;
         ui: {
             showTabHint: boolean;
             inputHasFocus: boolean;
@@ -2786,10 +2799,11 @@ declare class DeepdeskSDK {
      */
     notifyExternalSuggestion(suggestion: StageSuggestion): void;
     /**
-     * Evaluates an assistant with the given code.
+     * Evaluates a single assistant by code.
      *
-     * This is a low-level method that allows you to evaluate an assistant.
-     * You are probably better off using `evaluateConversationAssistant()` for conversation lifecycle events.
+     * Use for on-demand or fixed-code flows. For lifecycle hooks (accepted,
+     * new-message, ended), prefer `evaluateConversationAssistant()` so the
+     * profile decides which assistants run.
      *
      * @param assistantCode - The assistant code to evaluate
      * @param options - Evaluation options
@@ -2797,6 +2811,7 @@ declare class DeepdeskSDK {
      * @param options.transcript - Transcript option ('in-memory-transcript' or custom transcript)
      * @param options.includeMetadata - Whether to include metadata in the response
      * @param options.showCuesInWidget - Whether to show cues in the widget (default: true)
+     * @param options.externalConversationId - Optional conversation id to evaluate without switching the loaded conversation
      * @returns Promise that resolves to evaluation output or string
      *
      * @example
@@ -2829,14 +2844,15 @@ declare class DeepdeskSDK {
         transcript?: TranscriptOption;
         includeMetadata?: boolean;
         showCuesInWidget?: boolean;
+        externalConversationId?: string;
     }): Promise<EvaluationOutput | string>;
     /**
-     * Evaluates conversation lifecycle assistants.
+     * Evaluates conversation lifecycle assistants configured in the profile.
      *
-     * This is a convenient wrapper around `evaluateAssistant()` that evaluates
-     * assistants based on conversation lifecycle events. It automatically loads
-     * the profile configuration and evaluates the appropriate assistants for
-     * the given event.
+     * Resolves assistant codes from the profile for the given event and runs
+     * each one. Prefer this over `evaluateAssistant()` when the trigger is a
+     * lifecycle moment (close chat, new message) and Studio config should
+     * control which assistants run.
      *
      * @param event - The conversation event type 'accepted' | 'new-message' | 'ended'
      * @param options - Evaluation options
@@ -2844,7 +2860,8 @@ declare class DeepdeskSDK {
      * @param options.transcript - Transcript option ('in-memory-transcript' or custom transcript)
      * @param options.includeMetadata - Whether to include metadata in the response
      * @param options.showCuesInWidget - Whether to show cues in the widget (default: true)
-     * @returns Promise that resolves when evaluation is complete
+     * @param options.externalConversationId - Optional conversation id to evaluate without switching the loaded conversation
+     * @returns Promise that resolves when evaluation is complete, or with assistant results when `showCuesInWidget` is false
      *
      * @example
      * ```typescript
@@ -2875,7 +2892,8 @@ declare class DeepdeskSDK {
         transcript?: TranscriptOption;
         includeMetadata?: boolean;
         showCuesInWidget?: boolean;
-    }): Promise<void>;
+        externalConversationId?: string;
+    }): Promise<ConversationAssistantResult[] | void>;
     private handleKeyDown;
     private handleAfterSendMessage;
     /**
@@ -3551,4 +3569,4 @@ declare function logEvent<T extends keyof SendEventArgumentMap>(event: LogEvent<
 type CSSModule = Record<string, string>;
 declare function useStyles<TStyles extends CSSModule>(componentName: string, defaultStyles: TStyles): TStyles;
 
-export { type AgentInfo, Card, ContentEditableInput, type Conversation, type ConversationMessage, DeepdeskAPI, DeepdeskSDK, HTTPClient, InputMediator, type InputOverlayCustomStyles, InputType, KeyboardHint, Label, Locale, type Logger, type MountOptions, type PinnedMessage, type PlatformConfig, type RootState, Section, SectionList, type SelectionRange, Sources, Suggestion, type SuggestionEventMetrics, SuggestionList, type SuggestionMetrics, TextAreaInput, type TextSuggestion, ToggleButton, type UrlSuggestion, type VisitorInfo, type WidgetCustomStyles, type WidgetOptions, attachFile, authenticateWithKey, createFullRange, createOverlayContainer, createRangeFromOffsets, escapeHTML, formatTextMarkup, getRangeOffsets, getRangeText, insertCKEditor, isHTML, isSupportedInputElement, logEvent, updateContentEditable, updateTextArea, useClickOutsideRoot, useStyles, waitForElementVisibilityChange };
+export { type AgentInfo, Card, ContentEditableInput, type Conversation, type ConversationAssistantResult, type ConversationMessage, DeepdeskAPI, DeepdeskSDK, HTTPClient, InputMediator, type InputOverlayCustomStyles, InputType, KeyboardHint, Label, Locale, type Logger, type MountOptions, type PinnedMessage, type PlatformConfig, type RootState, Section, SectionList, type SelectionRange, Sources, Suggestion, type SuggestionEventMetrics, SuggestionList, type SuggestionMetrics, TextAreaInput, type TextSuggestion, ToggleButton, type UrlSuggestion, type VisitorInfo, type WidgetCustomStyles, type WidgetOptions, attachFile, authenticateWithKey, createFullRange, createOverlayContainer, createRangeFromOffsets, escapeHTML, formatTextMarkup, getRangeOffsets, getRangeText, insertCKEditor, isHTML, isSupportedInputElement, logEvent, updateContentEditable, updateTextArea, useClickOutsideRoot, useStyles, waitForElementVisibilityChange };

package/dist/index.d.ts

@@ -407,6 +407,11 @@ declare enum FetchState {
     ERROR = "error"
 }
 
+interface State$a {
+    current: Conversation | null;
+    isSupported: boolean | null;
+}
+
 type CallToAction = Server.CallToAction;
 type LegacyCue = CamelCaseKeys<Server.LegacyCue> & {
     isLoading?: boolean;
@@ -421,6 +426,13 @@ type ArrayItemType<T> = T extends Array<infer I> ? I : never;
 type Cue = ArrayItemType<EvaluationOutput> & {
     isLoading?: boolean;
     evaluationId: string;
+    externalConversationId?: string;
+};
+type ConversationAssistantResult = {
+    assistantCode: string;
+    evaluationId: string;
+    output: EvaluationOutput;
+    externalConversationId: string;
 };
 type AssistantAnswerSource = {
     url?: string;
@@ -434,7 +446,7 @@ type AssistantInteraction = {
     };
     evaluationId: string;
 };
-type State$a = {
+type State$9 = {
     cues: Cue[];
     threads: Record<number, AssistantInteraction[]>;
     pending: string[];
@@ -450,6 +462,7 @@ interface EvaluateInput {
     input?: any;
     transcript?: TranscriptOption;
     includeMetadata?: boolean;
+    externalConversationId?: string;
     skipState?: boolean;
 }
 
@@ -1009,6 +1022,10 @@ type SendEventArgumentMap = {
     'Assistant response displayed': Event$1<AssistantEventMeta & {
         input?: string;
     }>;
+    'Assistant evaluation completed': Event$1<AssistantEventMeta & {
+        externalConversationId?: string;
+        evaluationStatus: 'success' | 'failed';
+    }>;
     'Assistant response closed': Event$1<AssistantEventMeta>;
     'Assistant response feedback': Event$1<AssistantEventMeta & {
         rating: 'up' | 'down';
@@ -1178,12 +1195,12 @@ declare class DeepdeskAPI {
 }
 
 type StyleSuggestion = CamelCaseKeys<Server.StyleSuggestion>;
-interface State$9 {
+interface State$8 {
     list: StyleSuggestion;
     fetchState: FetchState;
 }
 
-type State$8 = {
+type State$7 = {
     data: Profile | null;
     fetchState: FetchState;
 };
@@ -1304,7 +1321,7 @@ type MetricState = {
     textSuggestions: SuggestionMetrics[];
     cuts: any[];
 };
-type State$7 = {
+type State$6 = {
     text: string;
     html: string | null;
     suggestionTextStart: number;
@@ -1321,27 +1338,22 @@ type State$7 = {
     selectedSuggestionIndex: number;
 };
 
-type State$6 = {
+type State$5 = {
     startTime: Date | null;
     stopTime: Date | null;
 };
 
-type State$5 = {
+type State$4 = {
     token: string | null;
     interval: NodeJS.Timer | null;
 };
 
 type ContentType = CamelCaseKeys<Server.ContentType>;
-type State$4 = {
+type State$3 = {
     data: ContentType[] | null;
     fetchState: FetchState;
 };
 
-interface State$3 {
-    current: Conversation | null;
-    isSupported: boolean | null;
-}
-
 interface State$2 {
     isLoggedIn: boolean | null;
     loginFetchState: FetchState;
@@ -1362,13 +1374,13 @@ interface StoreConfig {
     preloadedState?: any;
 }
 declare const reducers: redux.Reducer<{
-    assistants: State$a;
+    assistants: State$9;
     auth: State$2;
-    conversation: State$3;
-    contentTypes: State$4;
-    passwordlessToken: State$5;
+    conversation: State$a;
+    contentTypes: State$3;
+    passwordlessToken: State$4;
     entities: State$1;
-    handlingTime: State$6;
+    handlingTime: State$5;
     info: {
         agentInfo?: AgentInfo;
         agentSettings: unknown;
@@ -1378,7 +1390,7 @@ declare const reducers: redux.Reducer<{
         fetchState: FetchState;
         showNicknameDialog: boolean;
     };
-    input: State$7;
+    input: State$6;
     settings: {
         locale: Locale;
         deanonymize: boolean;
@@ -1415,9 +1427,9 @@ declare const reducers: redux.Reducer<{
         enableFeedbackForm: boolean;
         hasKeyboardInput: boolean;
     };
-    profile: State$8;
+    profile: State$7;
     search: State$b;
-    styleSuggestions: State$9;
+    styleSuggestions: State$8;
     ui: {
         showTabHint: boolean;
         inputHasFocus: boolean;
@@ -1427,13 +1439,13 @@ declare const reducers: redux.Reducer<{
     };
     textSuggestions: TextSuggestionState;
 }, redux.UnknownAction, Partial<{
-    assistants: State$a | undefined;
+    assistants: State$9 | undefined;
     auth: State$2 | undefined;
-    conversation: State$3 | undefined;
-    contentTypes: State$4 | undefined;
-    passwordlessToken: State$5 | undefined;
+    conversation: State$a | undefined;
+    contentTypes: State$3 | undefined;
+    passwordlessToken: State$4 | undefined;
     entities: State$1 | undefined;
-    handlingTime: State$6 | undefined;
+    handlingTime: State$5 | undefined;
     info: {
         agentInfo?: AgentInfo;
         agentSettings: unknown;
@@ -1443,7 +1455,7 @@ declare const reducers: redux.Reducer<{
         fetchState: FetchState;
         showNicknameDialog: boolean;
     } | undefined;
-    input: State$7 | undefined;
+    input: State$6 | undefined;
     settings: {
         locale: Locale;
         deanonymize: boolean;
@@ -1480,9 +1492,9 @@ declare const reducers: redux.Reducer<{
         enableFeedbackForm: boolean;
         hasKeyboardInput: boolean;
     } | undefined;
-    profile: State$8 | undefined;
+    profile: State$7 | undefined;
     search: State$b | undefined;
-    styleSuggestions: State$9 | undefined;
+    styleSuggestions: State$8 | undefined;
     ui: {
         showTabHint: boolean;
         inputHasFocus: boolean;
@@ -1493,13 +1505,13 @@ declare const reducers: redux.Reducer<{
     textSuggestions: TextSuggestionState | undefined;
 }>>;
 declare function createStore(config: StoreConfig): _reduxjs_toolkit.EnhancedStore<{
-    assistants: State$a;
+    assistants: State$9;
     auth: State$2;
-    conversation: State$3;
-    contentTypes: State$4;
-    passwordlessToken: State$5;
+    conversation: State$a;
+    contentTypes: State$3;
+    passwordlessToken: State$4;
     entities: State$1;
-    handlingTime: State$6;
+    handlingTime: State$5;
     info: {
         agentInfo?: AgentInfo;
         agentSettings: unknown;
@@ -1509,7 +1521,7 @@ declare function createStore(config: StoreConfig): _reduxjs_toolkit.EnhancedStor
         fetchState: FetchState;
         showNicknameDialog: boolean;
     };
-    input: State$7;
+    input: State$6;
     settings: {
         locale: Locale;
         deanonymize: boolean;
@@ -1546,9 +1558,9 @@ declare function createStore(config: StoreConfig): _reduxjs_toolkit.EnhancedStor
         enableFeedbackForm: boolean;
         hasKeyboardInput: boolean;
     };
-    profile: State$8;
+    profile: State$7;
     search: State$b;
-    styleSuggestions: State$9;
+    styleSuggestions: State$8;
     ui: {
         showTabHint: boolean;
         inputHasFocus: boolean;
@@ -2034,6 +2046,7 @@ interface RenderOptions {
     appendOverlayTo?: HTMLElement;
     inputMediator?: InputMediator<HTMLElement>;
 }
+
 interface MountOptions extends Partial<Settings>, RenderOptions {
 }
 interface KnowledgeAssistOptions {
@@ -2112,13 +2125,13 @@ declare class DeepdeskSDK {
      */
     constructor({ deepdeskUrl, version, locale, token, fetch, productName, createCustomChannel, websocketClient, }: SDKOptions);
     get state(): {
-        assistants: State$a;
+        assistants: State$9;
         auth: State$2;
-        conversation: State$3;
-        contentTypes: State$4;
-        passwordlessToken: State$5;
+        conversation: State$a;
+        contentTypes: State$3;
+        passwordlessToken: State$4;
         entities: State$1;
-        handlingTime: State$6;
+        handlingTime: State$5;
         info: {
             agentInfo?: AgentInfo;
             agentSettings: unknown;
@@ -2128,7 +2141,7 @@ declare class DeepdeskSDK {
             fetchState: FetchState;
             showNicknameDialog: boolean;
         };
-        input: State$7;
+        input: State$6;
         settings: {
             locale: Locale;
             deanonymize: boolean;
@@ -2165,9 +2178,9 @@ declare class DeepdeskSDK {
             enableFeedbackForm: boolean;
             hasKeyboardInput: boolean;
         };
-        profile: State$8;
+        profile: State$7;
         search: State$b;
-        styleSuggestions: State$9;
+        styleSuggestions: State$8;
         ui: {
             showTabHint: boolean;
             inputHasFocus: boolean;
@@ -2786,10 +2799,11 @@ declare class DeepdeskSDK {
      */
     notifyExternalSuggestion(suggestion: StageSuggestion): void;
     /**
-     * Evaluates an assistant with the given code.
+     * Evaluates a single assistant by code.
      *
-     * This is a low-level method that allows you to evaluate an assistant.
-     * You are probably better off using `evaluateConversationAssistant()` for conversation lifecycle events.
+     * Use for on-demand or fixed-code flows. For lifecycle hooks (accepted,
+     * new-message, ended), prefer `evaluateConversationAssistant()` so the
+     * profile decides which assistants run.
      *
      * @param assistantCode - The assistant code to evaluate
      * @param options - Evaluation options
@@ -2797,6 +2811,7 @@ declare class DeepdeskSDK {
      * @param options.transcript - Transcript option ('in-memory-transcript' or custom transcript)
      * @param options.includeMetadata - Whether to include metadata in the response
      * @param options.showCuesInWidget - Whether to show cues in the widget (default: true)
+     * @param options.externalConversationId - Optional conversation id to evaluate without switching the loaded conversation
      * @returns Promise that resolves to evaluation output or string
      *
      * @example
@@ -2829,14 +2844,15 @@ declare class DeepdeskSDK {
         transcript?: TranscriptOption;
         includeMetadata?: boolean;
         showCuesInWidget?: boolean;
+        externalConversationId?: string;
     }): Promise<EvaluationOutput | string>;
     /**
-     * Evaluates conversation lifecycle assistants.
+     * Evaluates conversation lifecycle assistants configured in the profile.
      *
-     * This is a convenient wrapper around `evaluateAssistant()` that evaluates
-     * assistants based on conversation lifecycle events. It automatically loads
-     * the profile configuration and evaluates the appropriate assistants for
-     * the given event.
+     * Resolves assistant codes from the profile for the given event and runs
+     * each one. Prefer this over `evaluateAssistant()` when the trigger is a
+     * lifecycle moment (close chat, new message) and Studio config should
+     * control which assistants run.
      *
      * @param event - The conversation event type 'accepted' | 'new-message' | 'ended'
      * @param options - Evaluation options
@@ -2844,7 +2860,8 @@ declare class DeepdeskSDK {
      * @param options.transcript - Transcript option ('in-memory-transcript' or custom transcript)
      * @param options.includeMetadata - Whether to include metadata in the response
      * @param options.showCuesInWidget - Whether to show cues in the widget (default: true)
-     * @returns Promise that resolves when evaluation is complete
+     * @param options.externalConversationId - Optional conversation id to evaluate without switching the loaded conversation
+     * @returns Promise that resolves when evaluation is complete, or with assistant results when `showCuesInWidget` is false
      *
      * @example
      * ```typescript
@@ -2875,7 +2892,8 @@ declare class DeepdeskSDK {
         transcript?: TranscriptOption;
         includeMetadata?: boolean;
         showCuesInWidget?: boolean;
-    }): Promise<void>;
+        externalConversationId?: string;
+    }): Promise<ConversationAssistantResult[] | void>;
     private handleKeyDown;
     private handleAfterSendMessage;
     /**
@@ -3551,4 +3569,4 @@ declare function logEvent<T extends keyof SendEventArgumentMap>(event: LogEvent<
 type CSSModule = Record<string, string>;
 declare function useStyles<TStyles extends CSSModule>(componentName: string, defaultStyles: TStyles): TStyles;
 
-export { type AgentInfo, Card, ContentEditableInput, type Conversation, type ConversationMessage, DeepdeskAPI, DeepdeskSDK, HTTPClient, InputMediator, type InputOverlayCustomStyles, InputType, KeyboardHint, Label, Locale, type Logger, type MountOptions, type PinnedMessage, type PlatformConfig, type RootState, Section, SectionList, type SelectionRange, Sources, Suggestion, type SuggestionEventMetrics, SuggestionList, type SuggestionMetrics, TextAreaInput, type TextSuggestion, ToggleButton, type UrlSuggestion, type VisitorInfo, type WidgetCustomStyles, type WidgetOptions, attachFile, authenticateWithKey, createFullRange, createOverlayContainer, createRangeFromOffsets, escapeHTML, formatTextMarkup, getRangeOffsets, getRangeText, insertCKEditor, isHTML, isSupportedInputElement, logEvent, updateContentEditable, updateTextArea, useClickOutsideRoot, useStyles, waitForElementVisibilityChange };
+export { type AgentInfo, Card, ContentEditableInput, type Conversation, type ConversationAssistantResult, type ConversationMessage, DeepdeskAPI, DeepdeskSDK, HTTPClient, InputMediator, type InputOverlayCustomStyles, InputType, KeyboardHint, Label, Locale, type Logger, type MountOptions, type PinnedMessage, type PlatformConfig, type RootState, Section, SectionList, type SelectionRange, Sources, Suggestion, type SuggestionEventMetrics, SuggestionList, type SuggestionMetrics, TextAreaInput, type TextSuggestion, ToggleButton, type UrlSuggestion, type VisitorInfo, type WidgetCustomStyles, type WidgetOptions, attachFile, authenticateWithKey, createFullRange, createOverlayContainer, createRangeFromOffsets, escapeHTML, formatTextMarkup, getRangeOffsets, getRangeText, insertCKEditor, isHTML, isSupportedInputElement, logEvent, updateContentEditable, updateTextArea, useClickOutsideRoot, useStyles, waitForElementVisibilityChange };