@thoughtspot/visual-embed-sdk 1.39.1 → 1.39.2-alpha.2

package/src/react/index.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import React, { useRef } from 'react';
+import React, { useRef, useCallback } from 'react';
 import useDeepCompareEffect from 'use-deep-compare-effect';
 import { AuthEventEmitter } from '../auth';
 import { deepMerge } from '../utils';
@@ -10,12 +10,13 @@ import { SearchEmbed as _SearchEmbed, SearchViewConfig } from '../embed/search';
 import { AppEmbed as _AppEmbed, AppViewConfig } from '../embed/app';
 import { LiveboardEmbed as _LiveboardEmbed, LiveboardViewConfig } from '../embed/liveboard';
 import { TsEmbed } from '../embed/ts-embed';
-import { SpotterAgentEmbed as _SpotterAgentEmbed, SpotterAgentEmbedViewConfig } from '../embed/bodyless-conversation';
+import { SpotterAgentEmbed as _SpotterAgentEmbed, SpotterAgentEmbedViewConfig, ConversationMessage as _ConversationMessage, SpotterAgentMessageViewConfig } from '../embed/bodyless-conversation';
 
 import { EmbedConfig, EmbedEvent, AllEmbedViewConfig } from '../types';
 import { EmbedProps, getViewPropsAndListeners } from './util';
 import { SpotterEmbed as _SpotterEmbed, SpotterEmbedViewConfig, ConversationEmbed as _ConversationEmbed, ConversationViewConfig } from '../embed/conversation';
 import { init } from '../embed/base';
+import { ERROR_MESSAGE } from '../errors';
 
 const componentFactory = <T extends typeof TsEmbed, U extends EmbedProps, V extends AllEmbedViewConfig>(
     EmbedConstructor: T,
@@ -383,62 +384,61 @@ export const ConversationEmbed = componentFactory<
     ConversationViewConfig
 >(_ConversationEmbed);
 
-interface SpotterAgentEmbedProps extends EmbedProps, SpotterAgentEmbedViewConfig {}
+/**
+ * React component for individual conversation messages from SpotterAgent.
+ * This component is used internally by the useSpotterAgent hook.
+ * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
+ */
+interface ConversationMessageProps extends EmbedProps, SpotterAgentMessageViewConfig {}
+
+export const ConversationMessage = componentFactory<
+    typeof _ConversationMessage,
+    ConversationMessageProps,
+    SpotterAgentMessageViewConfig
+>(_ConversationMessage);
+
+type SpotterMessageProps = {
+    message: SpotterAgentMessageViewConfig;
+    query?: string;
+  } & Omit<EmbedProps, keyof SpotterAgentMessageViewConfig>;
 
 /**
- * React component for SpotterAgent embed, which can be integrated inside
- * chatbots or other conversational interfaces.
+ * React component for displaying individual conversation messages from SpotterAgent.
+ * 
+ * This component renders a single message response from your ThoughtSpot conversation,
+ * showing charts, visualizations, or text responses based on the user's query.
+ * 
  * @example
  * ```tsx
- * function SpotterAgent() {
- *  const ref = useRef();
- *  
- *  const handleSendMessage = async () => {
- *    const { container, error } = await ref.current.sendMessage('show me sales by region');
- *    if (container) {
- *      document.body.appendChild(container);
- *    }
- *  };
- *  
- *  return (
- *    <div>
- *      <SpotterAgentEmbed ref={ref} worksheetId="worksheetId" />
- *      <button onClick={handleSendMessage}>Send Message</button>
- *    </div>
- *  );
+ * const { sendMessage } = useSpotterAgent({ worksheetId: 'worksheetId' });
+ * const result = await sendMessage('show me sales by region');
+ * 
+ * if (!result.error) {
+ *   // Simple usage - just pass the message data
+ *   <SpotterMessage message={result.message} />
+ *   
+ *   // With optional query for context
+ *   <SpotterMessage 
+ *     message={result.message} 
+ *     query={result.query} 
+ *   />
  * }
  * ```
+ * @version SDK: 1.39.0 | ThoughtSpot: 10.11.0.cl
  */
-export const SpotterAgentEmbed = React.forwardRef<_SpotterAgentEmbed, SpotterAgentEmbedProps>((props, ref) => {
-  const { className, ...restProps } = props;
-  const serviceRef = useRef<_SpotterAgentEmbed | null>(null);
-  
-  useDeepCompareEffect(() => {
-    if (serviceRef.current) {
-      serviceRef.current = null;
-    }
-    
-    const configProps = {
-      ...restProps,
-      ...(className ? { containerClassName: className } : {})
-    };
-    
-    serviceRef.current = new _SpotterAgentEmbed(configProps);
+export const SpotterMessage = React.forwardRef<
+    React.ComponentRef<typeof ConversationMessage>,
+    SpotterMessageProps
+>((props, ref) => {
+    const { message, query: _, ...otherProps } = props;
     
-    if (ref) {
-      if (typeof ref === 'function') {
-        ref(serviceRef.current);
-      } else {
-        ref.current = serviceRef.current;
-      }
-    }
-    
-    return () => {
-      serviceRef.current = null;
-    };
-  }, [props]);
-  
-  return null;
+    return (
+        <ConversationMessage
+            ref={ref}
+            {...message}
+            {...otherProps}
+        />
+    );
 });
 
 /**
@@ -470,7 +470,8 @@ type EmbedComponent = typeof SearchEmbed
     | typeof LiveboardEmbed
     | typeof SearchBarEmbed
     | typeof SageEmbed
-    | typeof SpotterAgentEmbed
+    | typeof ConversationMessage
+    | typeof SpotterMessage
     | typeof SpotterEmbed
     | typeof ConversationEmbed;
 
@@ -518,6 +519,71 @@ export function useInit(config: EmbedConfig) {
     return ref;
 }
 
+/**
+ * React hook for interacting with SpotterAgent AI conversations.
+ * 
+ * This hook provides a sendMessage function that allows you to send natural language
+ * queries to your data and get back AI-generated responses with visualizations.
+ * 
+ * @param config - Configuration object containing worksheetId and other options
+ * @returns Object with sendMessage function that returns conversation results
+ * @example
+ * ```tsx
+ * const { sendMessage } = useSpotterAgent({ worksheetId: 'worksheetId' });
+ * 
+ * const handleQuery = async () => {
+ *   const result = await sendMessage('show me sales by region');
+ *   
+ *   if (!result.error) {
+ *     // Display the message response
+ *     <SpotterMessage message={result.message} />
+ *   } else {
+ *     console.error('Error:', result.error);
+ *   }
+ * };
+ * ```
+ * @version SDK: 1.39.0 | ThoughtSpot: 10.11.0.cl
+ */
+export function useSpotterAgent(config: SpotterAgentEmbedViewConfig) {
+    const serviceRef = useRef<_SpotterAgentEmbed | null>(null);
+    
+    useDeepCompareEffect(() => {
+        if (serviceRef.current) {
+            serviceRef.current = null;
+        }
+        
+        serviceRef.current = new _SpotterAgentEmbed(config);
+        
+        return () => {
+            serviceRef.current = null;
+        };
+    }, [config]);
+
+    const sendMessage = useCallback(async (query: string) => {
+        if (!serviceRef.current) {
+            return { error: new Error(ERROR_MESSAGE.SPOTTER_AGENT_NOT_INITIALIZED) };
+        }
+
+        const result = await serviceRef.current.sendMessageData(query);
+
+        if (result.error) {
+            return { error: result.error };
+        }
+
+        return {
+            query: query,
+            message: {
+                ...result.data,
+                worksheetId: config.worksheetId,
+            },
+        };
+    }, [config.worksheetId]);
+
+    return {
+        sendMessage,
+    };
+}
+
 export {
     LiveboardViewConfig,
     SearchViewConfig,

package/src/types.ts

@@ -217,6 +217,12 @@ export enum HomeLeftNavItem {
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
      */
     Spotter = 'spotter',
+    /**
+     * Favorites option in the insights left navigation,
+     * available when new navigation V3 is enabled.
+     * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+     */
+    Favorites = 'favorites',
 }
 export type DOMSelector = string | HTMLElement;
 
@@ -645,9 +651,9 @@ export interface EmbedConfig {
     customVariablesForThirdPartyTools?: Record< string, any >;
 
     disablePreauthCache?: boolean;
-    
+
     /**
-     * Disable fullscreen presentation mode functionality. When enabled, prevents entering 
+     * Disable fullscreen presentation mode functionality. When enabled, prevents entering
      * and exiting fullscreen mode for embedded visualizations during presentations.
      * @default true (feature is disabled by default)
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
@@ -702,7 +708,7 @@ export interface BaseViewConfig {
     /**
      * The width and height dimensions to render an embedded
      * object inside your app.  Specify the values in pixels or percentage.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
      * @example
@@ -732,7 +738,7 @@ export interface BaseViewConfig {
      * (...), and the contextual menu. These actions will be disabled
      * for the user.
      * Use this to disable actions.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
      * @example
@@ -747,7 +753,7 @@ export interface BaseViewConfig {
     disabledActions?: Action[];
     /**
      * The tooltip to display for disabled actions.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
      * @example
@@ -765,7 +771,7 @@ export interface BaseViewConfig {
      * The list of actions to hide from the embedded.
      * This actions will be hidden from the user.
      * Use this to hide an action.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
      * @example
@@ -786,7 +792,7 @@ export interface BaseViewConfig {
      * Use this to hide all actions except the ones you want to show.
      *
      * Use either this or hiddenActions.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
      * @important
@@ -802,7 +808,7 @@ export interface BaseViewConfig {
     visibleActions?: Action[];
     /**
      * The locale settings to apply to the embedded view.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @version SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
      * @example
@@ -823,7 +829,7 @@ export interface BaseViewConfig {
      * Warning: This option is for advanced use only and is used internally
      * to control embed behavior in non-regular ways. We do not publish the
      * list of supported keys and values associated with each.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @example
      * ```js
@@ -849,7 +855,7 @@ export interface BaseViewConfig {
     /**
      * Insert as a sibling of the target container, instead of appending to a
      * child inside it.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @version SDK: 1.2.0 | ThoughtSpot: 9.0.0.cl, 9.0.0.sw
      * @example
@@ -875,7 +881,7 @@ export interface BaseViewConfig {
      * PreRender id to be used for PreRendering the embed.
      * Use PreRender to render the embed in the background and then
      * show or hide the rendered embed using showPreRender or hidePreRender respectively.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @example
      * ```js
@@ -913,7 +919,7 @@ export interface BaseViewConfig {
     /**
      * Enable the V2 shell. This can provide performance benefits
      * due to a lighterweight shell.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @example
      * ```js
@@ -941,7 +947,7 @@ export interface BaseViewConfig {
     /**
      * This flag can be used to disable links inside the embedded app,
      * and disable redirection of links in a new tab.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @example
      * ```js
@@ -960,7 +966,7 @@ export interface BaseViewConfig {
      * objects from another Org.
      * The `overrideOrgId` setting is honoured only if the
      * Per Org URL feature is enabled on your ThoughtSpot instance.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @example
      * ```js
@@ -975,7 +981,7 @@ export interface BaseViewConfig {
     overrideOrgId?: number;
     /**
      * Flag to override the *Open Link in New Tab* context menu option.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      * @example
@@ -991,7 +997,7 @@ export interface BaseViewConfig {
     /**
      * The primary action to display on top of the viz for Liveboard and App Embed.
      * Use this to set the primary action.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @version SDK: 1.39.0 | ThoughtSpot: 10.11.0.cl
      * @example
@@ -1010,6 +1016,20 @@ export interface BaseViewConfig {
      * @private
      */
     insertInToSlide?: boolean;
+    /**
+     * Show alert messages and toast messages in the embed.
+     * Supported embed in all embed types.
+     * 
+     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
+     * @example
+     * ```js
+     * const embed = new AppEmbed('#tsEmbed', {
+     *    ... // other embed view config
+     *    showAlerts:true,
+     * })
+     * ```
+     */
+    showAlerts?: boolean;
 }
 
 /**
@@ -1021,7 +1041,7 @@ export interface HomePageConfig {
      * For example: hiddenListColumns = [ListPageColumns.Author]
      *
      * **Note**: This option is available only in full app embedding.
-     * 
+     *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.38.0 | ThoughtSpot: 10.9.0.cl
      * @example
@@ -1040,7 +1060,7 @@ export interface HomePageConfig {
      * **Note**: This option does not apply to the classic homepage.
      * To access the updated modular homepage, set
      * `modularHomeExperience` to `true` (available as Early Access feature in 9.12.5.cl).
-     * 
+     *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
      * @example
@@ -1059,7 +1079,7 @@ export interface HomePageConfig {
      * **Note**: This option does not apply to the classic homepage.
      * To access the updated modular homepage, set
      * `modularHomeExperience` to `true` (available as Early Access feature in 9.12.5.cl).
-     * 
+     *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.28.0| ThoughtSpot: 9.12.5.cl, 10.1.0.sw
      * @example
@@ -1075,7 +1095,7 @@ export interface HomePageConfig {
      * homepageLeftNavItems : Show or hide the left navigation bar items.
      * There are 8 eight home navigation list items.
      * To hide these items, specify the string in the array.
-     * 
+     *
      * Supported embed types: `AppEmbed`
      * @example
      * ```js
@@ -1100,7 +1120,7 @@ export interface SearchLiveboardCommonViewConfig {
     /**
      * The list of runtime filters to apply to a search Answer,
      * visualization, or Liveboard.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`
      * @version SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1.sw
      * @example
@@ -1122,7 +1142,7 @@ export interface SearchLiveboardCommonViewConfig {
     /**
      * The list of parameter override to apply to a search Answer,
      * visualization, or Liveboard.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`
      * @version SDK : 1.25.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
      * @example
@@ -1142,7 +1162,7 @@ export interface SearchLiveboardCommonViewConfig {
     runtimeParameters?: RuntimeParameter[];
     /**
      * flag to set ContextMenu Trigger to either left or right click.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `SageEmbed`, `SearchEmbed`
      * @example
      * ```js
@@ -1178,7 +1198,7 @@ export interface SearchLiveboardCommonViewConfig {
     excludeRuntimeParametersfromURL?: boolean;
     /**
      * To set the initial state of the search bar in case of saved Answers.
-     * 
+     *
      * Supported embed types: `SageEmbed`, `AppEmbed`, `SearchBarEmbed`
      * @default true
      * @version SDK: 1.34.0 | ThoughtSpot: 10.3.0.cl
@@ -1193,7 +1213,7 @@ export interface SearchLiveboardCommonViewConfig {
     collapseSearchBar?: boolean;
     /**
      * Flag to control Data panel experience
-     * 
+     *
      * Supported embed types: `SageEmbed`, `AppEmbed`, `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
      * @default false
      * @version SDK: 1.34.0 | ThoughtSpot Cloud: 10.3.0.cl
@@ -1209,7 +1229,7 @@ export interface SearchLiveboardCommonViewConfig {
     dataPanelV2?: boolean;
     /**
      * To enable custom column groups in data panel v2
-     * 
+     *
      * Supported embed types: `SageEmbed`, `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
      * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl, 10.1.0.sw
      * @default false
@@ -1231,7 +1251,7 @@ export interface SearchLiveboardCommonViewConfig {
 export interface LiveboardAppEmbedViewConfig {
     /**
      * Show or hide Liveboard header
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
      * @default false
@@ -1247,7 +1267,7 @@ export interface LiveboardAppEmbedViewConfig {
     hideLiveboardHeader?: boolean;
     /**
      * Show or hide Liveboard title
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
      * @default false
@@ -1263,7 +1283,7 @@ export interface LiveboardAppEmbedViewConfig {
     showLiveboardTitle?: boolean;
     /**
      * Show or hide Liveboard description
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @version SDK: 1.26.0 | Thoughtspot: 9.7.0.cl
      * @default false
@@ -1279,7 +1299,7 @@ export interface LiveboardAppEmbedViewConfig {
     showLiveboardDescription?: boolean;
     /**
      * Boolean to control if Liveboard header is sticky or not.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @example
      * ```js
@@ -1294,7 +1314,7 @@ export interface LiveboardAppEmbedViewConfig {
     isLiveboardHeaderSticky?: boolean;
     /**
      * This attribute can be used to enable the two-column layout on an embedded Liveboard
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @type {boolean}
      * @default false
@@ -1311,7 +1331,7 @@ export interface LiveboardAppEmbedViewConfig {
     enable2ColumnLayout?: boolean;
     /**
      * This flag can be used to enable the compact header in Liveboard
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @type {boolean}
      * @default false
@@ -1328,7 +1348,7 @@ export interface LiveboardAppEmbedViewConfig {
     isLiveboardCompactHeaderEnabled?: boolean;
     /**
      * This flag can be used to show or hide the Liveboard verified icon in the compact header.
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @version SDK: 1.35.0 | ThoughtSpot:10.4.0.cl
      * @default true
@@ -1344,7 +1364,7 @@ export interface LiveboardAppEmbedViewConfig {
     showLiveboardVerifiedBadge?: boolean;
     /**
      * This flag is used to enable/disable hide irrelevant filters in Liveboard tab
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @version SDK: 1.36.0 | ThoughtSpot:10.6.0.cl
      * @default false
@@ -1360,7 +1380,7 @@ export interface LiveboardAppEmbedViewConfig {
     hideIrrelevantChipsInLiveboardTabs?: boolean;
     /**
      * This flag can be used to show or hide the re-verify banner on the Liveboard compact header
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @version SDK: 1.35.0 | ThoughtSpot:10.4.0.cl
      * @default true
@@ -1376,7 +1396,7 @@ export interface LiveboardAppEmbedViewConfig {
     showLiveboardReverifyBanner?: boolean;
     /**
      * enable or disable ask sage
-     * 
+     *
      * Supported embed types: `AppEmbed`, `LiveboardEmbed`
      * @version SDK: 1.29.0 | Thoughtspot: 9.12.0.cl
      * @default false
@@ -1390,6 +1410,22 @@ export interface LiveboardAppEmbedViewConfig {
      * ```
      */
     enableAskSage?: boolean;
+     /**
+     * This flag is used to show or hide checkboxes for including or excluding
+     * the cover and filters pages in the Liveboard PDF.
+     *
+     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
+     * @version SDK: 1.40.0 | ThoughtSpot:10.8.0.cl
+     * @example
+     * ```js
+     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
+     * const embed = new <EmbedComponent>('#tsEmbed', {
+     *    ... // other embed view config
+     *    coverAndFilterOptionInPDF: false,
+     * })
+     * ```
+     */
+    coverAndFilterOptionInPDF?: boolean;
 }
 
 export interface AllEmbedViewConfig extends BaseViewConfig, SearchLiveboardCommonViewConfig, HomePageConfig, LiveboardAppEmbedViewConfig {}
@@ -2671,6 +2707,12 @@ export enum EmbedEvent {
      * @version SDK : 1.40.0 | ThoughtSpot: 10.11.0.cl
      */
     ExitPresentMode = 'exitPresentMode',
+    /**
+     * Emitted when a user requests the full height lazy load data.
+     * @version SDK : 1.39.0 | ThoughtSpot : 10.10.0.cl
+     * @hidden
+     */
+    RequestVisibleEmbedCoordinates = 'requestVisibleEmbedCoordinates',
 }
 
 /**
@@ -3595,16 +3637,16 @@ export enum HostEvent {
     /**
      * Get the Answer session for a Search or
      * Liveboard visualization.
-     * 
-     * Note: This event is not typically used directly. Instead, use the 
-     * `getAnswerService()` method on the embed instance to get an AnswerService 
+     *
+     * Note: This event is not typically used directly. Instead, use the
+     * `getAnswerService()` method on the embed instance to get an AnswerService
      * object that provides a more convenient interface for working with answers.
-     * 
+     *
      * @example
      * ```js
      * // Preferred way to get an AnswerService
      * const service = await embed.getAnswerService();
-     * 
+     *
      * // Alternative direct usage (not recommended)
      * const {session} = await embed.trigger(
      *  HostEvent.GetAnswerSession, {
@@ -3615,7 +3657,7 @@ export enum HostEvent {
      * ```js
      * // Preferred way to get an AnswerService
      * const service = await embed.getAnswerService();
-     * 
+     *
      * // Alternative direct usage (not recommended)
      * const {session} = await embed.trigger( HostEvent.GetAnswerSession )
      * ```
@@ -3755,6 +3797,19 @@ export enum HostEvent {
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
      */
     ExitPresentMode = 'exitPresentMode',
+    /**
+     * Triggers the full height lazy load data.
+     * @example
+     * ```js
+     * liveboardEmbed.on(EmbedEvent.RequestVisibleEmbedCoordinates, (payload) => {
+     *      console.log(payload);
+     * });
+     * ```
+     * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
+     *
+     * @hidden
+     */
+    VisibleEmbedCoordinates = 'visibleEmbedCoordinates',
 }
 
 /**
@@ -3860,6 +3915,7 @@ export enum Param {
     Query = 'query',
     HideHomepageLeftNav = 'hideHomepageLeftNav',
     ModularHomeExperienceEnabled = 'modularHomeExperience',
+    ListPageVersion = 'listpageVersion',
     PendoTrackingKey = 'additionalPendoKey',
     LiveboardHeaderSticky = 'isLiveboardHeaderSticky',
     IsProductTour = 'isProductTour',
@@ -3894,10 +3950,12 @@ export enum Param {
     DataSourceId = 'dataSourceId',
     preAuthCache = 'preAuthCache',
     ShowSpotterLimitations = 'showSpotterLimitations',
-    CoverAndFilterOptionInPDF = 'coverAndFilterOptionInPDF',
+    CoverAndFilterOptionInPDF = 'arePdfCoverFilterPageCheckboxesEnabled',
     PrimaryAction = 'primaryAction',
     isSpotterAgentEmbed = 'isSpotterAgentEmbed',
     IsLiveboardStylingAndGroupingEnabled = 'isLiveboardStylingAndGroupingEnabled',
+    IsLazyLoadingForEmbedEnabled = 'isLazyLoadingForEmbedEnabled',
+    RootMarginForLazyLoad = 'rootMarginForLazyLoad'
 }
 
 /**
@@ -5137,6 +5195,22 @@ export enum Action {
      *  @version SDK: 1.37.0 | ThoughtSpot Cloud: 10.8.0.cl
      */
     CoverAndFilterOptionInPDF = 'coverAndFilterOptionInPDF',
+    /**
+     * Action ID for hide or disable the
+     * Spotter in conversation training widget.
+     * The Add to Coaching feature is currently in beta
+     * and is disabled by default on embed deployments.
+     * To enable this feature on your instance,
+     * contact ThoughtSpot Support.
+     *  @example
+     * ```js
+     * hiddenAction: [Action.InConversationTraining]
+     * disabledActions: [Action.InConversationTraining]
+     *
+     * ```
+     *  @version SDK: 1.39.0 | ThoughtSpot Cloud: 10.10.0.cl
+     */
+    InConversationTraining = 'InConversationTraining',
 }
 
 export interface AnswerServiceType {

package/src/utils/graphql/nlsService/conversation-service.ts

@@ -64,6 +64,8 @@ export class Conversation {
             );
             const data = responses[0].data;
             return {
+                convId: this.conversationId,
+                messageId: responses[0].msgId,
                 data: data.asstRespData.nlsAnsData.sageQuerySuggestions[0],
                 error: null,
             };