@thoughtspot/visual-embed-sdk 1.39.2 → 1.40.0

package/dist/visual-embed-sdk-react.d.ts

@@ -233,33 +233,42 @@ export const SpotterEmbed: React.ForwardRefExoticComponent<SpotterEmbedProps & R
     * ```
     */
 export const ConversationEmbed: React.ForwardRefExoticComponent<ConversationEmbedProps & React.RefAttributes<_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: React.ForwardRefExoticComponent<ConversationMessageProps & React.RefAttributes<_ConversationMessage>>;
 /**
-    * 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 { sendMessage } = useSpotterAgent({ worksheetId: 'worksheetId' });
+    * const result = await sendMessage('show me sales by region');
     *
-    *  const handleSendMessage = async () => {
-    *    const { container, error } = await ref.current.sendMessage('show me sales by region');
-    *    if (container) {
-    *      document.body.appendChild(container);
-    *    }
-    *  };
+    * if (!result.error) {
+    *   // Simple usage - just pass the message data
+    *   <SpotterMessage message={result.message} />
     *
-    *  return (
-    *    <div>
-    *      <SpotterAgentEmbed ref={ref} worksheetId="worksheetId" />
-    *      <button onClick={handleSendMessage}>Send Message</button>
-    *    </div>
-    *  );
+    *   // 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.ForwardRefExoticComponent<SpotterAgentEmbedProps & React.RefAttributes<_SpotterAgentEmbed>>;
+export const SpotterMessage: React.ForwardRefExoticComponent<{
+        message: SpotterAgentMessageViewConfig;
+        query?: string;
+} & Omit<EmbedProps, keyof SpotterAgentMessageViewConfig> & React.RefAttributes<_ConversationMessage>>;
 /**
     * React component for PreRendered Conversation embed.
     *
@@ -279,7 +288,7 @@ export const SpotterAgentEmbed: React.ForwardRefExoticComponent<SpotterAgentEmbe
     * ```
     */
 export const PreRenderedConversationEmbed: React.ForwardRefExoticComponent<SpotterEmbedProps & PreRenderProps & React.RefAttributes<_SpotterEmbed>>;
-type EmbedComponent = typeof SearchEmbed | typeof AppEmbed | typeof LiveboardEmbed | typeof SearchBarEmbed | typeof SageEmbed | typeof SpotterAgentEmbed | typeof SpotterEmbed | typeof ConversationEmbed;
+type EmbedComponent = typeof SearchEmbed | typeof AppEmbed | typeof LiveboardEmbed | typeof SearchBarEmbed | typeof SageEmbed | typeof ConversationMessage | typeof SpotterMessage | typeof SpotterEmbed | typeof ConversationEmbed;
 /**
     * Get a reference to the embed component to trigger events on the component.
     * @example
@@ -311,6 +320,50 @@ export function useEmbedRef<T extends EmbedComponent>(): React.MutableRefObject<
     * @version SDK: 1.36.2 | ThoughtSpot: *
     */
 export function useInit(config: EmbedConfig): React.MutableRefObject<AuthEventEmitter>;
+/**
+    * 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): {
+        sendMessage: (query: string) => Promise<{
+                error: any;
+                query?: undefined;
+                message?: undefined;
+        } | {
+                query: string;
+                message: {
+                        worksheetId: string;
+                        convId: any;
+                        messageId: any;
+                        sessionId: any;
+                        genNo: any;
+                        acSessionId: any;
+                        acGenNo: any;
+                };
+                error?: undefined;
+        }>;
+};
 
 export declare let loggedInStatus: boolean;
 export declare let samlAuthWindow: Window;
@@ -1194,6 +1247,21 @@ export declare enum HomePage {
             */
         Modular = "v2"
 }
+/**
+    * Define the version of the list page
+    * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
+    */
+export declare enum ListPage {
+        /**
+            * List (v2) is the traditional List Experience.
+            * It serves as the foundational version of the list page.
+            */
+        List = "v2",
+        /**
+            * ListWithUXChanges (v3) introduces the new updated list page with UX changes.
+            */
+        ListWithUXChanges = "v3"
+}
 /**
     * Define the discovery experience
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
@@ -1207,6 +1275,10 @@ export interface DiscoveryExperience {
             * homePage determines the version of the home page.
             */
         homePage?: HomePage;
+        /**
+            * listPageVersion determines the version of the list page.
+            */
+        listPageVersion?: ListPage;
 }
 /**
     * The view configuration for full app embedding.
@@ -1578,21 +1650,6 @@ export interface AppViewConfig extends AllEmbedViewConfig {
             * ```
             */
         isUnifiedSearchExperienceEnabled?: boolean;
-        /**
-         * Show alert messages and toast messages in the embedded
-         * view in full app embed.
-         *
-         * Supported embed types: `AppEmbed`
-         * @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;
         /**
             * This flag is used to enable/disable the styling and grouping in a Liveboard
             *
@@ -1609,6 +1666,46 @@ export interface AppViewConfig extends AllEmbedViewConfig {
             * ```
             */
         isLiveboardStylingAndGroupingEnabled?: boolean;
+        /**
+            * This flag is used to enable the full height lazy load data.
+            *
+            * @example
+            * ```js
+            * const embed = new AppEmbed('#embed-container', {
+            *    // ...other options
+            *    fullHeight: true,
+            *    lazyLoadingForFullHeight: true,
+            * })
+            * ```
+            *
+            * @type {boolean}
+            * @default false
+            * @version SDK: 1.40.0 | ThoughtSpot:10.12.0.cl
+            */
+        lazyLoadingForFullHeight?: boolean;
+        /**
+            * The margin to be used for lazy loading.
+            *
+            * For example, if the margin is set to '10px',
+            * the visualization will be loaded 10px before the its top edge is visible in the
+            * viewport.
+            *
+            * The format is similar to CSS margin.
+            *
+            * @example
+            * ```js
+            * const embed = new AppEmbed('#embed-container', {
+            *    // ...other options
+            *    fullHeight: true,
+            *    lazyLoadingForFullHeight: true,
+            *   // Using 0px, the visualization will be only loaded when its visible in the viewport.
+            *    lazyLoadingMargin: '0px',
+            * })
+            * ```
+            * @type {string}
+            * @version SDK: 1.40.0 | ThoughtSpot:10.12.0.cl
+            */
+        lazyLoadingMargin?: string;
 }
 /**
     * Embeds full ThoughtSpot experience in a host application.
@@ -1645,6 +1742,11 @@ export declare class AppEmbed extends V1Embed {
             * @version SDK: 1.12.0 | ThoughtSpot: 8.4.0.cl, 8.4.1-sw
             */
         navigateToPage(path: string | number, noReload?: boolean): void;
+        /**
+            * Destroys the ThoughtSpot embed, and remove any nodes from the DOM.
+            * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
+            */
+        destroy(): void;
         /**
             * Renders the embedded application pages in the ThoughtSpot app.
             * @param renderOptions An object containing the page ID
@@ -1900,23 +2002,6 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
             * })
             */
         dataSourceId?: string;
-        /**
-            * This flag is for show/hide checkboxes for include or exclude
-            * cover page and filters in the Liveboard PDF.
-            *
-            * Supported embed types: `LiveboardEmbed`
-            * @version SDK: 1.37.0 | ThoughtSpot:10.8.0.cl
-            * @default true
-            * Supported embed types: `LiveboardEmbed`
-            * @example
-            * ```js
-            * const embed = new LiveboardEmbed('#tsEmbed', {
-            *    ... //other embed view config
-            *    coverAndFilterOptionInPDF: false,
-            * })
-            * ```
-            */
-        coverAndFilterOptionInPDF?: boolean;
         /**
             * The list of tab IDs to hide from the embedded.
             * This Tabs will be hidden from their respective LBs.
@@ -1972,6 +2057,46 @@ export interface LiveboardViewConfig extends BaseViewConfig, LiveboardOtherViewC
             * ```
             */
         isLiveboardStylingAndGroupingEnabled?: boolean;
+        /**
+            * This flag is used to enable the full height lazy load data.
+            *
+            * @example
+            * ```js
+            * const embed = new LiveboardEmbed('#embed-container', {
+            *    // ...other options
+            *    fullHeight: true,
+            *    lazyLoadingForFullHeight: true,
+            * })
+            * ```
+            *
+            * @type {boolean}
+            * @default false
+            * @version SDK: 1.40.0 | ThoughtSpot:10.12.0.cl
+            */
+        lazyLoadingForFullHeight?: boolean;
+        /**
+            * The margin to be used for lazy loading.
+            *
+            * For example, if the margin is set to '10px',
+            * the visualization will be loaded 10px before the its top edge is visible in the
+            * viewport.
+            *
+            * The format is similar to CSS margin.
+            *
+            * @example
+            * ```js
+            * const embed = new LiveboardEmbed('#embed-container', {
+            *    // ...other options
+            *    fullHeight: true,
+            *    lazyLoadingForFullHeight: true,
+            *   // Using 0px, the visualization will be only loaded when its visible in the viewport.
+            *    lazyLoadingMargin: '0px',
+            * })
+            * ```
+            * @type {string}
+            * @version SDK: 1.40.0 | ThoughtSpot:10.12.0.cl
+            */
+        lazyLoadingMargin?: string;
 }
 /**
     * Embed a ThoughtSpot Liveboard or visualization. When rendered it already
@@ -2005,6 +2130,11 @@ export declare class LiveboardEmbed extends V1Embed {
             * @returns A promise that resolves with the response from the embedded app
             */
         trigger<HostEventT extends HostEvent, PayloadT>(messageType: HostEventT, data?: TriggerPayload<PayloadT, HostEventT>): Promise<TriggerResponse<PayloadT, HostEventT>>;
+        /**
+            * Destroys the ThoughtSpot embed, and remove any nodes from the DOM.
+            * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
+            */
+        destroy(): void;
         /**
             * Render an embedded ThoughtSpot Liveboard or visualization
             * @param renderOptions An object specifying the Liveboard ID,
@@ -2034,10 +2164,6 @@ export interface SpotterAgentEmbedViewConfig extends Omit<BaseViewConfig, 'prima
             * The ID of the worksheet to use for the conversation.
             */
         worksheetId: string;
-        /**
-            * Optional CSS class name to add to the container div.
-            */
-        containerClassName?: string;
 }
 /**
     * Configuration for conversation options.
@@ -2047,13 +2173,15 @@ export interface SpotterAgentEmbedViewConfig extends Omit<BaseViewConfig, 'prima
     */
 export interface BodylessConversationViewConfig extends SpotterAgentEmbedViewConfig {
 }
-interface SpotterAgentMessageViewConfig extends SpotterAgentEmbedViewConfig {
+export interface SpotterAgentMessageViewConfig extends SpotterAgentEmbedViewConfig {
         sessionId: string;
         genNo: number;
         acSessionId: string;
         acGenNo: number;
+        convId: string;
+        messageId: string;
 }
-declare class ConversationMessage extends TsEmbed {
+export declare class ConversationMessage extends TsEmbed {
         protected viewConfig: SpotterAgentMessageViewConfig;
         constructor(container: HTMLElement, viewConfig: SpotterAgentMessageViewConfig);
         getIframeSrc(): string;
@@ -2089,6 +2217,25 @@ export declare class SpotterAgentEmbed {
                 viz: ConversationMessage;
                 error?: undefined;
         }>;
+        /**
+            * Send a message to the conversation service and return only the data.
+            * @param userMessage - The message to send to the conversation service.
+            * @returns The data from the conversation service.
+            */
+        sendMessageData(userMessage: string): Promise<{
+                error: any;
+                data?: undefined;
+        } | {
+                data: {
+                        convId: any;
+                        messageId: any;
+                        sessionId: any;
+                        genNo: any;
+                        acSessionId: any;
+                        acGenNo: any;
+                };
+                error?: undefined;
+        }>;
 }
 /**
     * Create a conversation embed, which can be integrated inside
@@ -2113,7 +2260,6 @@ export declare class SpotterAgentEmbed {
 export declare class BodylessConversation extends SpotterAgentEmbed {
         constructor(viewConfig: BodylessConversationViewConfig);
 }
-export {};
 
 /**
     * Copyright (c) 2023
@@ -2327,7 +2473,13 @@ export declare enum HomeLeftNavItem {
             * available when new navigation V3 is enabled.
             * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
             */
-        Spotter = "spotter"
+        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;
 /**
@@ -3093,6 +3245,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;
 }
 /**
     * The configuration object for Home page embeds configs.
@@ -3470,6 +3636,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 {
 }
@@ -4362,7 +4544,7 @@ export declare enum EmbedEvent {
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             * @example
             *```js
-            * liveboardEmbed.on(EmbedEvent.AnswerChartSwitcher, payload => {
+            * liveboardEmbed.on(EmbedEvent.LiveboardInfo, payload => {
             *    console.log('Liveboard details', payload);
             * })
             *```
@@ -4729,7 +4911,90 @@ export declare enum EmbedEvent {
             * Emitted when a user exits present mode.
             * @version SDK : 1.40.0 | ThoughtSpot: 10.11.0.cl
             */
-        ExitPresentMode = "exitPresentMode"
+        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",
+        /**
+            * Emitted when Spotter response is text data
+            * @example
+            * ```js
+            * spotterEmbed.on(EmbedEvent.SpotterData, (payload) => {
+            *     console.log('payload', payload);
+            * })
+            *```
+            * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
+            */
+        SpotterData = "SpotterData",
+        /**
+            * Emitted when user opens up the worksheet preview modal in Spotter embed.
+            * @example
+            * ```js
+            * spotterEmbed.on(EmbedEvent.PreviewSpotterData, (payload) => {
+            *     console.log('payload', payload);
+            * })
+            *```
+            * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
+            */
+        PreviewSpotterData = "PreviewSpotterData",
+        /**
+            * Emitted when the Spotter query is triggered in Spotter embed.
+            * @example
+            * ```js
+            * spotterEmbed.on(EmbedEvent.SpotterQueryTriggered, (payload) => {
+            *     console.log('payload', payload);
+            * })
+            *```
+            * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
+            */
+        SpotterQueryTriggered = "SpotterQueryTriggered",
+        /**
+            * Emitted when the last Spotter query is edited in Spotter embed.
+            * @example
+            * ```js
+            * spotterEmbed.on(EmbedEvent.LastPromptEdited, (payload) => {
+            *     console.log('payload', payload);
+            * })
+            *```
+            * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
+            */
+        LastPromptEdited = "LastPromptEdited",
+        /**
+            * Emitted when the last Spotter query is deleted in Spotter embed.
+            * @example
+            * ```js
+            * spotterEmbed.on(EmbedEvent.LastPromptDeleted, (payload) => {
+            *     console.log('payload', payload);
+            * })
+            *```
+            * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
+            */
+        LastPromptDeleted = "LastPromptDeleted",
+        /**
+            * Emitted when the coversation is reset in spotter embed.
+            * @example
+            * ```js
+            * spotterEmbed.on(EmbedEvent.ResetSpotterConversation, (payload) => {
+            *     console.log('payload', payload);
+            * })
+            *```
+            * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
+            */
+        ResetSpotterConversation = "ResetSpotterConversation",
+        /**
+            * Emitted when the *Spotter* is initialized.
+            * @example
+            * ```js
+            * spotterEmbed.on(EmbedEvent.SpotterInit, (payload) => {
+            *     console.log('payload', payload);
+            * })
+            *```
+            * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+            */
+        SpotterInit = "spotterInit"
 }
 /**
     * Event types that can be triggered by the host application
@@ -4747,7 +5012,7 @@ export declare enum EmbedEvent {
     * // create the liveboard embed.
     *
     * liveboardEmbed.trigger(HostEvent.UpdateRuntimeFilters, [
-    *   { columnName: 'state, operator: RuntimeFilterOp.EQ, values: ['california']}
+    *   { columnName: 'state', operator: RuntimeFilterOp.EQ, values: ["california"]}
     * ]);
     * ```
     * @example
@@ -4817,6 +5082,7 @@ export declare enum HostEvent {
             * done automatically on the most popular column.
             * @param - vizId [TS >= 9.8.0] - Optional. The GUID of the visualization to drill
             * in case of a Liveboard.
+            * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
             * @example
             * ```js
             * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
@@ -4955,12 +5221,12 @@ export declare enum HostEvent {
             * Works with Search and Liveboard embed.
             * @param - { columnId: string,
             *  name: string,
-            *  type: INT64/CHAR/DATE,
-            *  dataType: ATTRIBUTE/MEASURE }
+            *  type: ATTRIBUTE/MEASURE,
+            *  dataType: INT64/CHAR/DATE }
             * @example
             * ```js
             * searchEmbed.trigger(HostEvent.OpenFilter,
-            *  {column: { columnId: '<column-GUID>', name: 'column name', type: 'INT64', dataType: 'ATTRIBUTE'}})
+            *  {column: { columnId: '<column-GUID>', name: 'column name', type: 'ATTRIBUTE', dataType: 'INT64'}})
             * ```
             * @example
             * ```js
@@ -5018,6 +5284,7 @@ export declare enum HostEvent {
             * @param
             * `vizId`-  GUID of the saved Answer or visualization to pin to a Liveboard.
             *  Optional when pinning a new chart or table generated from a Search query.
+            *  **Required** in Spotter Embed.
             * @param
             * `liveboardID` - GUID of the Liveboard to pin an Answer. If there is no Liveboard,
             *  specify the `newLiveboardName` parameter to create a new Liveboard.
@@ -5065,6 +5332,12 @@ export declare enum HostEvent {
             * ```js
             * appEmbed.trigger(HostEvent.Pin)
             * ```
+            * @example
+            * ```js
+            * const pinResponse = await spotterEmbed.trigger(HostEvent.Pin, {
+            *     vizId:'730496d6-6903-4601-937e-2c691821af3c'
+            *  });
+            * ```
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             */
         Pin = "pin",
@@ -5129,12 +5402,21 @@ export declare enum HostEvent {
             * Trigger the **Download PDF** action on an embedded Liveboard,
             * visualization or Answer.
             *
+            * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
+            *
             * **NOTE**: The **Download** > **PDF** action is available on
             * visualizations and Answers if the data is in tabular format.
             * @example
             * ```js
             * liveboardEmbed.trigger(HostEvent.DownloadAsPdf)
             * ```
+            * @example
+            * ```js
+            * spotterEmbed.trigger(HostEvent.DownloadAsPdf, {
+            *     vizId:'730496d6-6903-4601-937e-2c691821af3c'
+            *  });
+            * ```
+            *
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             */
         DownloadAsPdf = "downloadAsPdf",
@@ -5158,6 +5440,12 @@ export declare enum HostEvent {
             * ```js
             * searchEmbed.trigger(HostEvent.MakeACopy)
             * ```
+            * @example
+            * ```js
+            * const pinResponse = await spotterEmbed.trigger(HostEvent.MakeACopy, {
+            *     vizId:'730496d6-6903-4601-937e-2c691821af3c'
+            *  });
+            * ```
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             */
         MakeACopy = "makeACopy",
@@ -5230,6 +5518,8 @@ export declare enum HostEvent {
             * This event is not supported in visualization embed and search embed.
             * @param - object - To trigger the action for a specific visualization
             * in Liveboard embed, pass in `vizId` as a key.
+            * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
+            *
             * @example
             * ```js
             * liveboardEmbed.trigger(HostEvent.Edit)
@@ -5238,6 +5528,18 @@ export declare enum HostEvent {
             * liveboardEmbed.trigger(HostEvent.Edit, {vizId:
             * '730496d6-6903-4601-937e-2c691821af3c'})
             * ```
+            * @example
+            * ```js
+            * const pinResponse = await spotterEmbed.trigger(HostEvent.Edit, {
+            *     vizId:'730496d6-6903-4601-937e-2c691821af3c'
+            *  });
+            * ```
+            * @example
+            * ```js
+            * const editResponse = await spotterEmbed.trigger(HostEvent.Edit, {
+            *     vizId:'730496d6-6903-4601-937e-2c691821af3c'
+            *  });
+            * ```
             * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
             */
         Edit = "edit",
@@ -5285,6 +5587,16 @@ export declare enum HostEvent {
             *   );
             * })
             * ```
+            * @example
+            * ```js
+            * spotterEmbed.trigger(HostEvent.GetTML, {
+            *   vizId: '730496d6-6903-4601-937e-2c691821af3c'
+            * }).then((tml) => {
+            *   console.log(
+            *      tml.answer.search_query // TML representation of the search query
+            *   );
+            * })
+            * ```
             * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl, 9.0.1.sw
             * @important
             */
@@ -5348,6 +5660,7 @@ export declare enum HostEvent {
         /**
             * Trigger the **Download** action on charts in
             * the embedded view.
+            * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
             * @example
             * ```js
             * liveboardEmbed.trigger(HostEvent.Download, {vizId:
@@ -5356,6 +5669,11 @@ export declare enum HostEvent {
             * ```js
             * embed.trigger(HostEvent.Download)
             * ```
+            * ```js
+            * spotterEmbed.trigger(HostEvent.Download, {
+            *     vizId:'730496d6-6903-4601-937e-2c691821af3c'
+            *  });
+            * ```
             * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw
             * Use {@link DownloadAsPng}
             * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
@@ -5372,13 +5690,19 @@ export declare enum HostEvent {
             * vizEmbed.trigger(HostEvent.DownloadAsPng)
             *
             * searchEmbed.trigger(HostEvent.DownloadAsPng)
+            *
+            * spotterEmbed.trigger(HostEvent.DownloadAsPng, {
+            *       vizId:"730496d6-6903-4601-937e-2c691821af3c"
+            * })
             * ```
+            *
             * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.1.sw
             */
         DownloadAsPng = "downloadAsPng",
         /**
             * Trigger the **Download** > **CSV**  action on tables in
             * the embedded view.
+            * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
             * @example
             * ```js
             * liveboardEmbed.trigger(HostEvent.DownloadAsCsv, {vizId:
@@ -5390,12 +5714,18 @@ export declare enum HostEvent {
             * ```js
             * searchEmbed.trigger(HostEvent.DownloadAsCsv)
             * ```
+            * ```js
+            * spotterEmbed.trigger(HostEvent.DownloadAsCsv, {
+            *       vizId:"730496d6-6903-4601-937e-2c691821af3c"
+            * })
+            * ```
             * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
             */
         DownloadAsCsv = "downloadAsCSV",
         /**
             * Trigger the **Download** > **XLSX**  action on tables
             * in the embedded view.
+            * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
             * @example
             * ```js
             * liveboardEmbed.trigger(HostEvent.DownloadAsXlsx, {vizId:
@@ -5407,6 +5737,11 @@ export declare enum HostEvent {
             * ```js
             * searchEmbed.trigger(HostEvent.DownloadAsXlsx)
             * ```
+            * ```js
+            * spotterEmbed.trigger(HostEvent.downloadAsXLSX, {
+            *       vizId:"730496d6-6903-4601-937e-2c691821af3c"
+            * })
+            * ```
             * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
             */
         DownloadAsXlsx = "downloadAsXLSX",
@@ -5426,6 +5761,7 @@ export declare enum HostEvent {
         /**
             * Trigger the **Save**  action on a Liveboard or Answer.
             * Saves the changes.
+            * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
             * @example
             * ```js
             * liveboardEmbed.trigger(HostEvent.Save)
@@ -5433,6 +5769,11 @@ export declare enum HostEvent {
             * ```js
             * searchEmbed.trigger(HostEvent.Save)
             * ```
+            * ```js
+            * spotterEmbed.trigger(HostEvent.Save, {
+            *       vizId:"730496d6-6903-4601-937e-2c691821af3c"
+            * })
+            * ```
             * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
             */
         Save = "save",
@@ -5716,7 +6057,7 @@ export declare enum HostEvent {
         ResetLiveboardPersonalisedView = "ResetLiveboardPersonalisedView",
         /**
             * Triggers an action to update Parameter values on embedded
-            * Answers and Liveboard.
+            * Answers, Liveboard and Spotter answer in Edit mode.
             *
             * @example
             * ```js
@@ -5730,11 +6071,19 @@ export declare enum HostEvent {
         UpdateParameters = "UpdateParameters",
         /**
             * Triggers GetParameters to fetch the runtime Parameters.
+            * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
             * ```js
             * liveboardEmbed.trigger(HostEvent.GetParameters).then((parameter) => {
             *  console.log('parameters', parameter);
             * });
             *```
+            *```js
+            * spotterEmbed.trigger(HostEvent.GetParameters, {
+            *  vizId: '730496d6-6903-4601-937e-2c691821af3c'
+            * }).then((parameter) => {
+            *  console.log('parameters', parameter);
+            * });
+            *```
             * @version SDK: 1.29.0 | ThoughtSpot: 10.1.0.cl, 10.1.0.sw
             */
         GetParameters = "GetParameters",
@@ -5766,7 +6115,7 @@ export declare enum HostEvent {
             * @param - optional attributes to set Answer properties.
             *  `name` - Name string for the Answer.
             *  `description` - Description text for the Answer.
-            *
+            * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
             * @example
             * ```js
             * const saveAnswerResponse = await searchEmbed.trigger(HostEvent.SaveAnswer, {
@@ -5774,6 +6123,14 @@ export declare enum HostEvent {
             *      description: "Total sales by states in MidWest"
             *   });
             * ```
+            * @example
+            * ```js
+            * const saveAnswerResponse = await spotterEmbed.trigger(HostEvent.SaveAnswer, {
+            *      vizId: '730496d6-6903-4601-937e-2c691821af3c',
+            *      name: "Sales by states",
+            *      description: "Total sales by states in MidWest"
+            * });
+            * ```
             * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
             */
         SaveAnswer = "saveAnswer",
@@ -5802,6 +6159,70 @@ export declare enum HostEvent {
             * @version SDK: 1.37.0 | ThoughtSpot: 10.8.0.cl
             */
         TransformTableVizData = "TransformTableVizData",
+        /**
+            * Triggers a search operation with the search tokens specified in
+            * the search query string in spotter embed.
+            * @param - `query`: Text string in Natural Language format
+            * @param - `executeSearch`: Boolean to execute search and update search query
+            * @example
+            * ```js
+            * spotterEmbed.trigger(HostEvent.SpotterSearch, {
+            *  query: 'revenue per year',
+            *  executeSearch: true,
+            * })
+            * ```
+            * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
+            */
+        SpotterSearch = "SpotterSearch",
+        /**
+            * Edits the last prompt in spotter embed.
+            * @param - `query`: Text string
+            * @example
+            * ```js
+            * spotterEmbed.trigger(HostEvent.EditLastPrompt, "revenue per year");
+            * ```
+            * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
+            */
+        EditLastPrompt = "EditLastPrompt",
+        /**
+            * Opens the Worksheet preview modal in Spotter Embed.
+            * @example
+            * ```js
+            * spotterEmbed.trigger(HostEvent.PreviewSpotterData);
+            * ```
+            * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
+            */
+        PreviewSpotterData = "PreviewSpotterData",
+        /**
+            * Resets the Spotter Embed Conversation.
+            * @example
+            * ```js
+            * spotterEmbed.trigger(HostEvent.ResetSpotterConversation);
+            * ```
+            * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
+            */
+        ResetSpotterConversation = "ResetSpotterConversation",
+        /**
+            * Deletes the last prompt in spotter embed.
+            * @example
+            * ```js
+            * spotterEmbed.trigger(HostEvent.DeleteLastPrompt);
+            * ```
+            * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
+            */
+        DeleteLastPrompt = "DeleteLastPrompt",
+        /**
+            * Toggle the visualization to chart or table view.
+            * @param - `vizId ` refers to the answer id in spotter Embed, it is required in spotter Embed.
+            * @example
+            * ```js
+            * spotterEmbed.trigger(HostEvent.AnswerChartSwitcher, {
+            *          vizId:'b535c760-8bbe-4e6f-bb26-af56b4129a1e'
+            * });
+            *```
+            * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
+            */
+        AnswerChartSwitcher = "answerChartSwitcher",
         /**
             * @hidden
             * Trigger exit from presentation mode when user exits fullscreen.
@@ -5811,7 +6232,31 @@ export declare enum HostEvent {
             *```
             * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
             */
-        ExitPresentMode = "exitPresentMode"
+        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",
+        /**
+            * Trigger the *Ask Spotter* action for visualizations
+            * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
+            * @example
+            * ```js
+            * spotterEmbed.trigger(HostEvent.AskSpotter,
+            * {vizId:'730496d6-6903-4601-937e-2c691821af3c'})
+            * ```
+            * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
+            */
+        AskSpotter = "AskSpotter"
 }
 /**
     * The different visual modes that the data sources panel within
@@ -5907,6 +6352,7 @@ export declare enum Param {
         Query = "query",
         HideHomepageLeftNav = "hideHomepageLeftNav",
         ModularHomeExperienceEnabled = "modularHomeExperience",
+        ListPageVersion = "listpageVersion",
         PendoTrackingKey = "additionalPendoKey",
         LiveboardHeaderSticky = "isLiveboardHeaderSticky",
         IsProductTour = "isProductTour",
@@ -5941,10 +6387,12 @@ export declare enum Param {
         DataSourceId = "dataSourceId",
         preAuthCache = "preAuthCache",
         ShowSpotterLimitations = "showSpotterLimitations",
-        CoverAndFilterOptionInPDF = "coverAndFilterOptionInPDF",
+        CoverAndFilterOptionInPDF = "arePdfCoverFilterPageCheckboxesEnabled",
         PrimaryAction = "primaryAction",
         isSpotterAgentEmbed = "isSpotterAgentEmbed",
-        IsLiveboardStylingAndGroupingEnabled = "isLiveboardStylingAndGroupingEnabled"
+        IsLiveboardStylingAndGroupingEnabled = "isLiveboardStylingAndGroupingEnabled",
+        IsLazyLoadingForEmbedEnabled = "isLazyLoadingForEmbedEnabled",
+        RootMarginForLazyLoad = "rootMarginForLazyLoad"
 }
 /**
     * ThoughtSpot application pages include actions and menu commands
@@ -7164,7 +7612,23 @@ export declare enum Action {
             * ```
             *  @version SDK: 1.37.0 | ThoughtSpot Cloud: 10.8.0.cl
             */
-        CoverAndFilterOptionInPDF = "coverAndFilterOptionInPDF"
+        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 {
         getAnswer?: (offset: number, batchSize: number) => any;
@@ -7501,7 +7965,7 @@ export declare class ConversationEmbed extends SpotterEmbed {
   * @summary ThoughtSpot Visual Embed SDK
   * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
   */
-export { init, logout, prefetch, executeTML, exportTML, executeTMLInput, exportTMLInput, getEmbedConfig as getInitConfig, getSessionInfo, tokenizedFetch, getAnswerFromQuery, createLiveboardWithAnswers, SearchEmbed, SearchBarEmbed, PinboardEmbed, LiveboardEmbed, SageEmbed, AppEmbed, SpotterAgentEmbed, SpotterAgentEmbedViewConfig, BodylessConversationViewConfig, BodylessConversation, SpotterEmbed, SpotterEmbedViewConfig, ConversationViewConfig, ConversationEmbed, AuthFailureType, AuthStatus, AuthEvent, AuthEventEmitter, AnswerService, SessionInterface, UnderlyingDataPoint, Page, AuthType, RuntimeFilter, RuntimeFilterOp, EmbedEvent, HostEvent, DataSourceVisualMode, Action, ContextMenuTriggerOptions, EmbedConfig, SearchViewConfig, SearchBarViewConfig, LiveboardViewConfig, SageViewConfig, AppViewConfig, PrefetchFeatures, FrameParams, HomeLeftNavItem, HomepageModule, DOMSelector, MessageOptions, MessageCallback, MessagePayload, CustomisationsInterface, CustomStyles, customCssInterface, CustomCssVariables, RuntimeParameter, LogLevel, uploadMixpanelEvent, MIXPANEL_EVENT, HomePageSearchBarMode, PrimaryNavbarVersion, HomePage, VizPoint, CustomActionPayload, UIPassthroughEvent, ListPageColumns, DataPanelCustomColumnGroupsAccordionState, };
+export { init, logout, prefetch, executeTML, exportTML, executeTMLInput, exportTMLInput, getEmbedConfig as getInitConfig, getSessionInfo, tokenizedFetch, getAnswerFromQuery, createLiveboardWithAnswers, SearchEmbed, SearchBarEmbed, PinboardEmbed, LiveboardEmbed, SageEmbed, AppEmbed, SpotterAgentEmbed, SpotterAgentEmbedViewConfig, BodylessConversationViewConfig, BodylessConversation, SpotterEmbed, SpotterEmbedViewConfig, ConversationViewConfig, ConversationEmbed, AuthFailureType, AuthStatus, AuthEvent, AuthEventEmitter, AnswerService, SessionInterface, UnderlyingDataPoint, Page, AuthType, RuntimeFilter, RuntimeFilterOp, EmbedEvent, HostEvent, DataSourceVisualMode, Action, ContextMenuTriggerOptions, EmbedConfig, SearchViewConfig, SearchBarViewConfig, LiveboardViewConfig, SageViewConfig, AppViewConfig, PrefetchFeatures, FrameParams, HomeLeftNavItem, HomepageModule, DOMSelector, MessageOptions, MessageCallback, MessagePayload, CustomisationsInterface, CustomStyles, customCssInterface, CustomCssVariables, RuntimeParameter, LogLevel, uploadMixpanelEvent, MIXPANEL_EVENT, HomePageSearchBarMode, PrimaryNavbarVersion, HomePage, ListPage, VizPoint, CustomActionPayload, UIPassthroughEvent, ListPageColumns, DataPanelCustomColumnGroupsAccordionState, };
 
 /**
     * Copyright (c) 2022
@@ -8733,13 +9197,14 @@ export declare function resetCachedPreauthInfo(): void;
     *
     * @example
     * ```js
+    * import { getInitConfig } from '@thoughtspot/visual-embed-sdk';
+    * // Call the getInitConfig method to retrieve the embed configuration
     * const config = getInitConfig();
+    * // Log the configuration settings
     * console.log(config);
     * ```
-    * @example
-    *
-    * Returns the `EmbedConfig` object, which
-    * contains the configuration settings used to
+    * Returns the link:https://developers.thoughtspot.com/docs/Interface_EmbedConfig[EmbedConfig]
+    * object, which contains the configuration settings used to
     * initialize the SDK, including the following:
     *
     *  - `thoughtSpotHost` - ThoughtSpot host URL
@@ -8748,9 +9213,10 @@ export declare function resetCachedPreauthInfo(): void;
     *  - `customizations` - Style, text, and icon customization settings
     *  that were applied during the SDK initialization.
     *
-    * For a comprehensive list of embed configuration settings,
-    * see link:https://developers.thoughtspot.com/docs/Interface_EmbedConfig[Developer Documentation].
+    * The following JSON output shows the embed configuration
+    * settings returned from the code in the previous example:
     *
+    * @example
     * ```json
     * {
     *   "thoughtSpotHost": "https://{ThoughtSpot-Host}",
@@ -8772,7 +9238,7 @@ export declare function resetCachedPreauthInfo(): void;
     *   "authTriggerContainer": "#your-own-div"
     *  }
     * ```
-    * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.cl, and later
+    * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw, and later
     * @group Global methods
     */
 export declare const getEmbedConfig: () => EmbedConfig;