@thoughtspot/visual-embed-sdk 1.45.2 → 1.45.3-mcp.2

package/src/embed/liveboard.ts

@@ -24,12 +24,13 @@ import {
     EmbedErrorCodes,
     ContextType,
 } from '../types';
-import { calculateVisibleElementData, getQueryParamString, isUndefined, isValidCssMargin } from '../utils';
+import { calculateVisibleElementData, getQueryParamString, isUndefined, isValidCssMargin, setParamIfDefined } from '../utils';
 import { getAuthPromise } from './base';
 import { TsEmbed, V1Embed } from './ts-embed';
 import { addPreviewStylesIfNotPresent } from '../utils/global-styles';
 import { TriggerPayload, TriggerResponse } from './hostEventClient/contracts';
 import { logger } from '../utils/logger';
+import { SpotterChatViewConfig } from './conversation';
 
 
 /**
@@ -209,6 +210,23 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
      */
     activeTabId?: string;
+    /**
+     * The GUID of a saved personalized view to load.
+     * A personalized view is a saved configuration of a Liveboard
+     * that includes specific filter selections.
+     *
+     * Supported embed types: `LiveboardEmbed`
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#tsEmbed', {
+     *    liveboardId: 'liveboard-guid',
+     *    personalizedViewId: 'view-guid',
+     *    activeTabId: 'tab-guid',
+     * })
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
+     */
+    personalizedViewId?: string;
     /**
      * Show or hide the tab panel of the embedded Liveboard.
      *
@@ -464,6 +482,24 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
      * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
      */
     updatedSpotterChatPrompt?: boolean;
+    /**
+     * Configuration for customizing Spotter chat UI
+     * branding in tool response cards.
+     *
+     * Supported embed types: `LiveboardEmbed`
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#tsEmbed', {
+     *    ... //other embed view config
+     *    spotterChatConfig: {
+     *        hideToolResponseCardBranding: true,
+     *        toolResponseCardBrandingLabel: 'MyBrand',
+     *    },
+     * })
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
+     */
+    spotterChatConfig?: SpotterChatViewConfig;
 }
 
 /**
@@ -553,6 +589,7 @@ export class LiveboardEmbed extends V1Embed {
             isCentralizedLiveboardFilterUXEnabled = false,
             isLinkParametersEnabled,
             updatedSpotterChatPrompt,
+            spotterChatConfig,
             isThisPeriodInDateFiltersEnabled,
         } = this.viewConfig;
 
@@ -619,7 +656,6 @@ export class LiveboardEmbed extends V1Embed {
             params[Param.DataSourceId] = dataSourceId;
         }
 
-
         if (isLiveboardStylingAndGroupingEnabled !== undefined) {
             params[Param.IsLiveboardStylingAndGroupingEnabled] = isLiveboardStylingAndGroupingEnabled;
         }
@@ -640,6 +676,17 @@ export class LiveboardEmbed extends V1Embed {
             params[Param.ShowSpotterLimitations] = showSpotterLimitations;
         }
 
+        // Handle spotterChatConfig params
+        if (spotterChatConfig) {
+            const {
+                hideToolResponseCardBranding,
+                toolResponseCardBrandingLabel,
+            } = spotterChatConfig;
+
+            setParamIfDefined(params, Param.HideToolResponseCardBranding, hideToolResponseCardBranding, true);
+            setParamIfDefined(params, Param.ToolResponseCardBrandingLabel, toolResponseCardBrandingLabel);
+        }
+
         if (isLinkParametersEnabled !== undefined) {
             params[Param.isLinkParametersEnabled] = isLinkParametersEnabled;
         }
@@ -671,15 +718,39 @@ export class LiveboardEmbed extends V1Embed {
         return params;
     }
 
-    private getIframeSuffixSrc(liveboardId: string, vizId: string, activeTabId: string) {
-        let suffix = `/embed/viz/${liveboardId}`;
+    private getIframeSuffixSrc(
+        liveboardId: string,
+        vizId: string,
+        activeTabId: string,
+        personalizedViewId?: string,
+    ) {
+        // Extract view from liveboardId if passed along with it (legacy approach)
+        // View must be appended as query param at the end, not embedded in path
+        let liveboardGuid = liveboardId;
+        let legacyViewId: string | undefined;
+
+        if (liveboardId?.includes('?')) {
+            const [id, query] = liveboardId.split('?');
+            liveboardGuid = id;
+            const params = new URLSearchParams(query);
+            legacyViewId = params.get('view') || undefined;
+        }
+
+        // personalizedViewId takes precedence over legacyViewId (when passed as part of liveboardId)
+        const effectiveViewId = personalizedViewId || legacyViewId;
+
+        let suffix = `/embed/viz/${liveboardGuid}`;
         if (activeTabId) {
-            suffix = `${suffix}/tab/${activeTabId} `;
+            suffix = `${suffix}/tab/${activeTabId}`;
         }
         if (vizId) {
             suffix = `${suffix}/${vizId}`;
         }
-        const tsPostHashParams = this.getThoughtSpotPostUrlParams();
+        const additionalParams: { [key: string]: string } = {};
+        if (effectiveViewId) {
+            additionalParams.view = effectiveViewId;
+        }
+        const tsPostHashParams = this.getThoughtSpotPostUrlParams(additionalParams);
         suffix = `${suffix}${tsPostHashParams}`;
         return suffix;
     }
@@ -687,7 +758,7 @@ export class LiveboardEmbed extends V1Embed {
     private sendFullHeightLazyLoadData = () => {
         const data = calculateVisibleElementData(this.iFrame);
         this.trigger(HostEvent.VisibleEmbedCoordinates, data);
-    }
+    };
 
     /**
      * This is a handler for the RequestVisibleEmbedCoordinates event.
@@ -706,7 +777,7 @@ export class LiveboardEmbed extends V1Embed {
      * to be loaded within the iFrame.
      */
     private getIFrameSrc(): string {
-        const { vizId, activeTabId } = this.viewConfig;
+        const { vizId, activeTabId, personalizedViewId } = this.viewConfig;
         const liveboardId = this.viewConfig.liveboardId ?? this.viewConfig.pinboardId;
 
         if (!liveboardId) {
@@ -721,6 +792,7 @@ export class LiveboardEmbed extends V1Embed {
             liveboardId,
             vizId,
             activeTabId,
+            personalizedViewId,
         )}`;
     }
 
@@ -813,18 +885,25 @@ export class LiveboardEmbed extends V1Embed {
         liveboardId: this.viewConfig.liveboardId,
         vizId: this.viewConfig.vizId,
         activeTabId: this.viewConfig.activeTabId,
+        personalizedViewId: this.viewConfig.personalizedViewId,
     };
 
     protected beforePrerenderVisible(): void {
         const embedObj = this.getPreRenderObj<LiveboardEmbed>();
 
         this.executeAfterEmbedContainerLoaded(() => {
-            this.navigateToLiveboard(this.viewConfig.liveboardId, this.viewConfig.vizId, this.viewConfig.activeTabId);
+            this.navigateToLiveboard(
+                this.viewConfig.liveboardId,
+                this.viewConfig.vizId,
+                this.viewConfig.activeTabId,
+                this.viewConfig.personalizedViewId,
+            );
             if (embedObj) {
                 embedObj.currentLiveboardState = {
                     liveboardId: this.viewConfig.liveboardId,
                     vizId: this.viewConfig.vizId,
                     activeTabId: this.viewConfig.activeTabId,
+                    personalizedViewId: this.viewConfig.personalizedViewId,
                 };
             }
         });
@@ -902,11 +981,17 @@ export class LiveboardEmbed extends V1Embed {
         return this;
     }
 
-    public navigateToLiveboard(liveboardId: string, vizId?: string, activeTabId?: string) {
-        const path = this.getIframeSuffixSrc(liveboardId, vizId, activeTabId);
+    public navigateToLiveboard(
+        liveboardId: string,
+        vizId?: string,
+        activeTabId?: string,
+        personalizedViewId?: string,
+    ) {
+        const path = this.getIframeSuffixSrc(liveboardId, vizId, activeTabId, personalizedViewId);
         this.viewConfig.liveboardId = liveboardId;
         this.viewConfig.activeTabId = activeTabId;
         this.viewConfig.vizId = vizId;
+        this.viewConfig.personalizedViewId = personalizedViewId;
         if (this.isRendered) {
             this.trigger(HostEvent.Navigate, path.substring(1));
         } else if (this.viewConfig.preRenderId) {
@@ -931,6 +1016,10 @@ export class LiveboardEmbed extends V1Embed {
             url = `${url}/${this.viewConfig.vizId}`;
         }
 
+        if (this.viewConfig.personalizedViewId) {
+            url = `${url}?view=${this.viewConfig.personalizedViewId}`;
+        }
+
         return url;
     }
 }

package/src/errors.ts

@@ -29,6 +29,7 @@ export const ERROR_MESSAGE = {
     ERROR_PARSING_API_INTERCEPT_BODY: 'Error parsing api intercept body',
     SSR_ENVIRONMENT_ERROR: 'SSR environment detected. This function cannot be called in SSR environment.',
     UPDATE_PARAMS_FAILED: 'Failed to update embed parameters',
+    INVALID_SPOTTER_DOCUMENTATION_URL: 'Invalid spotterDocumentationUrl. Please provide a valid http or https URL.',
 };
 
 export const CUSTOM_ACTIONS_ERROR_MESSAGE = {

package/src/index.ts

@@ -32,7 +32,7 @@ import { PinboardEmbed, LiveboardViewConfig, LiveboardEmbed } from './embed/live
 import { SearchEmbed, SearchViewConfig } from './embed/search';
 import { SearchBarEmbed, SearchBarViewConfig } from './embed/search-bar';
 import { SpotterAgentEmbed, SpotterAgentEmbedViewConfig, BodylessConversation, BodylessConversationViewConfig} from './embed/bodyless-conversation';
-import { SpotterEmbed, SpotterEmbedViewConfig, ConversationEmbed, ConversationViewConfig } from './embed/conversation';
+import { SpotterEmbed, SpotterEmbedViewConfig, SpotterChatViewConfig, SpotterSidebarViewConfig, ConversationEmbed, ConversationViewConfig } from './embed/conversation';
 import {
     AuthFailureType, AuthStatus, AuthEvent, AuthEventEmitter,
 } from './auth';
@@ -67,8 +67,10 @@ import {
     CustomActionTarget,
     InterceptedApiType,
     EmbedErrorCodes,
+    EmbedErrorDetailsEvent, 
     ErrorDetailsTypes,
     ContextType,
+    AutoMCPFrameRendererViewConfig,
 } from './types';
 import { CustomCssVariables } from './css-variables';
 import { SageEmbed, SageViewConfig } from './embed/sage';
@@ -106,6 +108,8 @@ export {
     BodylessConversation,
     SpotterEmbed,
     SpotterEmbedViewConfig,
+    SpotterChatViewConfig,
+    SpotterSidebarViewConfig,
     ConversationViewConfig,
     ConversationEmbed,
     AuthFailureType,
@@ -161,7 +165,10 @@ export {
     CustomActionTarget,
     InterceptedApiType,
     EmbedErrorCodes,
+    EmbedErrorDetailsEvent,
     ErrorDetailsTypes,
+    AutoMCPFrameRendererViewConfig,
 };
 
 export { resetCachedAuthToken } from './authToken';
+export { startAutoMCPFrameRenderer } from './embed/auto-frame-renderer';

package/src/types.ts

@@ -1163,6 +1163,8 @@ export interface BaseViewConfig extends ApiInterceptFlags {
     useHostEventsV2?: boolean;
 }
 
+export interface AutoMCPFrameRendererViewConfig extends BaseViewConfig {}
+
 /**
  * The configuration object for Home page embeds configs.
  */
@@ -1361,7 +1363,7 @@ export interface SearchLiveboardCommonViewConfig {
      *
      * Supported embed types: `SageEmbed`, `AppEmbed`, `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
      * @default true
-     * @version SDK: 1.41.1 | ThoughtSpot Cloud: 10.14.0.cl
+     * @deprecated from SDK 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
      * @example
      * ```js
      * // Replace <EmbedComponent> with embed component name. For example, SageEmbed, AppEmbed, or SearchBarEmbed
@@ -1599,7 +1601,7 @@ export interface LiveboardAppEmbedViewConfig {
      * To enable this feature on your instance, contact ThoughtSpot Support.
      *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
-     * @version SDK: 1.42.0 | ThoughtSpot: 10.15.0.cl
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
      * @example
      * ```js
      * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
@@ -3203,6 +3205,42 @@ export enum EmbedEvent {
      * @version SDK: 1.43.0 | ThoughtSpot: 10.15.0.cl
      */
     ApiIntercept = 'ApiIntercept',
+    /**
+     * Emitted when a Spotter conversation is renamed.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterConversationRenamed, (payload) => {
+     *     console.log('Conversation renamed', payload);
+     *     // payload: { convId: string, oldTitle: string, newTitle: string }
+     * })
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     */
+    SpotterConversationRenamed = 'spotterConversationRenamed',
+    /**
+     * Emitted when a Spotter conversation is deleted.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterConversationDeleted, (payload) => {
+     *     console.log('Conversation deleted', payload);
+     *     // payload: { convId: string, title: string }
+     * })
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     */
+    SpotterConversationDeleted = 'spotterConversationDeleted',
+    /**
+     * Emitted when a Spotter conversation is selected/clicked.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterConversationSelected, (payload) => {
+     *     console.log('Conversation selected', payload);
+     *     // payload: { convId: string, title: string, worksheetId: string }
+     * })
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
+     */
+    SpotterConversationSelected = 'spotterConversationSelected',
     
     /**
      * @hidden
@@ -4641,6 +4679,7 @@ export enum DataSourceVisualMode {
  */
 
 export enum Param {
+    Tsmcp = 'tsmcp',
     EmbedApp = 'embedApp',
     DataSources = 'dataSources',
     DataSourceMode = 'dataSourceMode',
@@ -4771,7 +4810,19 @@ export enum Param {
     isLinkParametersEnabled = 'isLinkParametersEnabled',
     EnablePastConversationsSidebar = 'enablePastConversationsSidebar',
     UpdatedSpotterChatPrompt = 'updatedSpotterChatPrompt',
+    SpotterSidebarTitle = 'spotterSidebarTitle',
+    SpotterSidebarDefaultExpanded = 'spotterSidebarDefaultExpanded',
+    SpotterChatRenameLabel = 'spotterChatRenameLabel',
+    SpotterChatDeleteLabel = 'spotterChatDeleteLabel',
+    SpotterDeleteConversationModalTitle = 'spotterDeleteConversationModalTitle',
+    SpotterPastConversationAlertMessage = 'spotterPastConversationAlertMessage',
+    SpotterDocumentationUrl = 'spotterDocumentationUrl',
+    SpotterBestPracticesLabel = 'spotterBestPracticesLabel',
+    SpotterConversationsBatchSize = 'spotterConversationsBatchSize',
+    SpotterNewChatButtonTitle = 'spotterNewChatButtonTitle',
     IsThisPeriodInDateFiltersEnabled = 'isThisPeriodInDateFiltersEnabled',
+    HideToolResponseCardBranding = 'hideToolResponseCardBranding',
+    ToolResponseCardBrandingLabel = 'toolResponseCardBrandingLabel',
 }
 
 /**
@@ -6216,6 +6267,96 @@ export enum Action {
      * @version SDK: 1.44.0 | ThoughtSpot Cloud: 26.2.0.cl
      */
     UngroupLiveboardGroup = 'ungroupLiveboardGroup',
+    /**
+     * Controls visibility of the sidebar header (title and toggle button)
+     * in the Spotter past conversations sidebar.
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterSidebarHeader]
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
+     */
+    SpotterSidebarHeader = 'spotterSidebarHeader',
+    /**
+     * Controls visibility of the sidebar footer (documentation link)
+     * in the Spotter past conversations sidebar.
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterSidebarFooter]
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
+     */
+    SpotterSidebarFooter = 'spotterSidebarFooter',
+    /**
+     * Controls visibility and disable state of the sidebar toggle/expand button
+     * in the Spotter past conversations sidebar.
+     * @example
+     * ```js
+     * disabledActions: [Action.SpotterSidebarToggle]
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
+     */
+    SpotterSidebarToggle = 'spotterSidebarToggle',
+    /**
+     * Controls visibility and disable state of the "New Chat" button
+     * in the Spotter past conversations sidebar.
+     * @example
+     * ```js
+     * disabledActions: [Action.SpotterNewChat]
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
+     */
+    SpotterNewChat = 'spotterNewChat',
+    /**
+     * Controls visibility of the past conversation banner alert
+     * in the Spotter interface.
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterPastChatBanner]
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
+     */
+    SpotterPastChatBanner = 'spotterPastChatBanner',
+    /**
+     * Controls visibility and disable state of the conversation edit menu
+     * (three-dot menu) in the Spotter past conversations sidebar.
+     * @example
+     * ```js
+     * disabledActions: [Action.SpotterChatMenu]
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
+     */
+    SpotterChatMenu = 'spotterChatMenu',
+    /**
+     * Controls visibility and disable state of the rename action
+     * in the Spotter conversation edit menu.
+     * @example
+     * ```js
+     * disabledActions: [Action.SpotterChatRename]
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
+     */
+    SpotterChatRename = 'spotterChatRename',
+    /**
+     * Controls visibility and disable state of the delete action
+     * in the Spotter conversation edit menu.
+     * @example
+     * ```js
+     * disabledActions: [Action.SpotterChatDelete]
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
+     */
+    SpotterChatDelete = 'spotterChatDelete',
+    /**
+     * Controls visibility and disable state of the documentation/best practices
+     * link in the Spotter sidebar footer.
+     * @example
+     * ```js
+     * disabledActions: [Action.SpotterDocs]
+     * ```
+     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
+     */
+    SpotterDocs = 'spotterDocs',
     /**
      * The **Include current period** checkbox for date filters.
      * Controls the visibility and availability of the option to include
@@ -6426,13 +6567,30 @@ export enum LogLevel {
  * Error types emitted by embedded components.
  *
  * These enum values categorize different types of errors that can occur during
- * the lifecycle of an embedded ThoughtSpot component. Use these values to implement
- * specific error handling logic based on the error category.
- *
- * @see {@link EmbedErrorDetailsEvent} - The error event object structure
- * @see {@link EmbedEvent.Error} - The event that emits these errors
+ * the lifecycle of an embedded ThoughtSpot component. 
+ * Use {@link EmbedErrorDetailsEvent} and {@link EmbedErrorCodes} to handle specific errors.
  * @version SDK: 1.44.2 | ThoughtSpot: 26.2.0.cl
  * @group Error Handling
+ * 
+ * @example
+ * Handle specific error types
+ * ```js
+ * embed.on(EmbedEvent.Error, (error) => {
+ *   switch (error.errorType) {
+ *     case ErrorDetailsTypes.API:
+ *       console.error('API error:', error.message);
+ *       break;
+ *     case ErrorDetailsTypes.VALIDATION_ERROR:
+ *       console.error('Validation error:', error.message);
+ *       break;
+ *     case ErrorDetailsTypes.NETWORK:
+ *       console.error('Network error:', error.message);
+ *       break;
+ *     default:
+ *       console.error('Unknown error:', error);
+ *   }
+ * });
+ * ```
  */
 export enum ErrorDetailsTypes {
     /** API call failure */
@@ -6444,26 +6602,34 @@ export enum ErrorDetailsTypes {
 }
 
 /**
- * Error codes for identifying specific issues in embedded ThoughtSpot components.
- *
- * Use these codes for precise error handling and debugging. Each code maps to a
- * distinct failure scenario, enabling targeted recovery strategies.
+ * Error codes for identifying specific issues in embedded ThoughtSpot components. Use {@link EmbedErrorDetailsEvent}  and  {@link ErrorDetailsTypes} codes for precise error handling and debugging.
  *
  * @version SDK: 1.44.2 | ThoughtSpot: 26.2.0.cl
  * @group Error Handling
- *
- * @see {@link EmbedErrorDetailsEvent} - The error event object that includes these codes
- * @see {@link ErrorDetailsTypes} - General error type categories
- *
+
  * @example
  * Handle specific error codes in the error event handler
- *
+ * ```js
  * embed.on(EmbedEvent.Error, (error) => {
- *   if (error.code === EmbedErrorCodes.WORKSHEET_ID_NOT_FOUND) {
- *     console.error('Worksheet ID not found:', error.message);
+ *   switch (error.code) {
+ *     case EmbedErrorCodes.WORKSHEET_ID_NOT_FOUND:
+ *       console.error('Worksheet ID not found:', error.message);
+ *       break;
+ *     case EmbedErrorCodes.LIVEBOARD_ID_MISSING:
+ *       console.error('Liveboard ID is missing:', error.message);
+ *       break;
+ *     case EmbedErrorCodes.CONFLICTING_ACTIONS_CONFIG:
+ *       console.error('Conflicting actions configuration:', error.message);
+ *       break;
+ *     case EmbedErrorCodes.CONFLICTING_TABS_CONFIG:
+ *       console.error('Conflicting tabs configuration:', error.message);
+ *       break;
+ *     default:
+ *       console.error('Unknown error:', error);
  *   }
  * });
- *  */
+ * ```
+ * */
 export enum EmbedErrorCodes {
     /** Worksheet ID not found or does not exist */
     WORKSHEET_ID_NOT_FOUND = 'WORKSHEET_ID_NOT_FOUND',
@@ -6471,10 +6637,10 @@ export enum EmbedErrorCodes {
     /** Required Liveboard ID is missing from configuration */
     LIVEBOARD_ID_MISSING = 'LIVEBOARD_ID_MISSING',
 
-    /** Conflicting action configuration detected (e.g., both hiddenActions and visibleActions specified) */
+    /** Conflicting action configuration detected */
     CONFLICTING_ACTIONS_CONFIG = 'CONFLICTING_ACTIONS_CONFIG',
 
-    /** Conflicting tab configuration detected (e.g., both hiddenTabs and visibleTabs specified) */
+    /** Conflicting tab configuration detected  */
     CONFLICTING_TABS_CONFIG = 'CONFLICTING_TABS_CONFIG',
 
     /** Error during component initialization */
@@ -6500,6 +6666,9 @@ export enum EmbedErrorCodes {
 
     /** Failed to update embed parameters during pre-render */
     UPDATE_PARAMS_FAILED = 'UPDATE_PARAMS_FAILED',
+
+    /** Invalid URL provided in configuration */
+    INVALID_URL = 'INVALID_URL',
 }
 
 /**
@@ -6513,7 +6682,7 @@ export enum EmbedErrorCodes {
  *
  * - **errorType**: One of the predefined {@link ErrorDetailsTypes} values
  * - **message**: Human-readable error description (string or array of strings for multiple errors)
- * - **code**: Machine-readable error identifier for programmatic handling
+ * - **code**: Machine-readable error identifier {@link EmbedErrorCodes} values
  * - **[key: string]**: Additional context-specific for backward compatibility
  *
  * ## Usage
@@ -6523,12 +6692,11 @@ export enum EmbedErrorCodes {
  *
  * @version SDK: 1.44.2 | ThoughtSpot: 26.2.0.cl
  * @group Error Handling
- * @see {@link ErrorDetailsTypes} - Available error type values
- * @see {@link EmbedEvent.Error} - The event that emits this object
  *
  * @example
  * Handle specific error types
- *
+ * 
+ * ```js
  * embed.on(EmbedEvent.Error, (error) => {
  *   switch (error.code) {
  *     case EmbedErrorCodes.WORKSHEET_ID_NOT_FOUND:
@@ -6538,30 +6706,18 @@ export enum EmbedErrorCodes {
  *       console.error('Unknown error:', error);
  *   }
  * });
- *  *
+ * ```
  * @example
  * Handle multiple error messages
- *
+ * 
+ * ```js
  * embed.on(EmbedEvent.Error, (error) => {
  *   const messages = Array.isArray(error.message)
  *     ? error.message
  *     : [error.message];
- *
  *   messages.forEach(msg => console.error(msg));
  * });
- *  *
- * @example
- * Access additional error context
- *
- * embed.on(EmbedEvent.Error, (error) => {
- *   console.error('Error Details:', {
- *     type: error.errorType,
- *     message: error.message,
- *     code: error.code,
- *     // Additional context fields vary by error type
- *     ...error
- *   });
- * });
+ * ```
  *  */
 export interface EmbedErrorDetailsEvent {
     /** The type of error that occurred */
@@ -6754,4 +6910,4 @@ export interface ContextObject {
     type: ContextType;
     objectIds: ObjectIds;
    }
-}
+}

package/src/utils/graphql/answerService/answer-queries.ts

@@ -176,6 +176,29 @@ export const getSQLQuery = `
     }
 `;
 
+export const updateDisplayMode = `
+   mutation UpdateDisplayMode(
+    $session: BachSessionIdInput!
+    $displayMode: DisplayMode
+) {
+    Answer__updateProperties(session: $session, displayMode: $displayMode) {
+        id {
+            sessionId
+            genNo
+            acSession {
+                sessionId
+                genNo
+            }
+        }
+        answer {
+            id
+            displayMode
+            suggestedDisplayMode
+        }
+    }
+}
+`;
+
 export const getAnswerTML = `
 mutation GetUnsavedAnswerTML($session: BachSessionIdInput!, $exportDependencies: Boolean, $formatType:  EDocFormatType, $exportPermissions: Boolean, $exportFqn: Boolean) {
   UnsavedAnswer_getTML(