@thoughtspot/visual-embed-sdk 1.46.5-beta.1 → 1.47.0

package/lib/src/visual-embed-sdk.d.ts

@@ -784,6 +784,42 @@ export interface CustomCssVariables {
 	 * Color for section title text (e.g., "Recent", "Older") in the saved chats sidebar.
 	 */
 	"--ts-var-saved-chats-section-title-color"?: string;
+	/**
+	 * Text color of the styling panel in the Liveboard.
+	 */
+	"--ts-var-liveboard-styling-panel-text-color"?: string;
+	/**
+	 * Border color of the styling panel in the Liveboard.
+	 */
+	"--ts-var-liveboard-styling-panel-border-color"?: string;
+	/**
+	 * Background color of the styling button in the Liveboard.
+	 */
+	"--ts-var-liveboard-styling-button-background"?: string;
+	/**
+	 * Text color of the styling button in the Liveboard.
+	 */
+	"--ts-var-liveboard-styling-button-text-color"?: string;
+	/**
+	 * Background color of the styling button in the Liveboard on hover.
+	 */
+	"--ts-var-liveboard-styling-button-hover-background"?: string;
+	/**
+	 * Background color of the styling button in the Liveboard when active.
+	 */
+	"--ts-var-liveboard-styling-button-active-background"?: string;
+	/**
+	 * Text color of the styling button in the Liveboard on hover.
+	 */
+	"--ts-var-liveboard-styling-button-hover-text-color"?: string;
+	/**
+	 * Box shadow of the styling button in the Liveboard.
+	 */
+	"--ts-var-liveboard-styling-button-shadow"?: string;
+	/**
+	 * Background color of the color palette in the Liveboard styling panel.
+	 */
+	"--ts-var-liveboard-styling-color-palette-background"?: string;
 }
 export interface SessionInterface {
 	sessionId: string;
@@ -1457,11 +1493,6 @@ export interface EmbedConfig {
 	 * @version SDK: 1.12.0 | ThoughtSpot: 8.4.0.cl, 8.4.1.sw
 	 */
 	suppressSearchEmbedBetaWarning?: boolean;
-	/**
-	 * Hide `beta` alert warning message for SageEmbed.
-	 *
-	 */
-	suppressSageEmbedBetaWarning?: boolean;
 	/**
 	 * Custom style params for embed Config.
 	 * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw
@@ -1543,6 +1574,7 @@ export interface EmbedConfig {
 	/**
 	 * Disables the Mixpanel tracking from the SDK.
 	 * @version SDK: 1.27.9
+	 * @hidden
 	 */
 	disableSDKTracking?: boolean;
 	/**
@@ -1845,7 +1877,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * 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`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
 	 * @example
 	 * ```js
@@ -1874,7 +1906,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * for the user.
 	 * Use this to disable actions.
 	 *
-	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
 	 * @example
 	 * ```js
@@ -1889,7 +1921,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	/**
 	 * The tooltip to display for disabled actions.
 	 *
-	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
 	 * @example
 	 * ```js
@@ -1907,7 +1939,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * These actions will be hidden from the user.
 	 * Use this to hide an action.
 	 *
-	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
 	 * @example
 	 * ```js
@@ -1928,7 +1960,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 *
 	 * Use either this or hiddenActions.
 	 *
-	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
 	 * @important
 	 * @example
@@ -1944,7 +1976,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	/**
 	 * The locale settings to apply to the embedded view.
 	 *
-	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.9.4 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
 	 * @example
 	 * ```js
@@ -1965,7 +1997,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * 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`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
 	 * @example
 	 * ```js
@@ -1993,7 +2025,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * 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`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.2.0 | ThoughtSpot: 9.0.0.cl, 9.0.0.sw
 	 * @example
 	 * ```js
@@ -2019,7 +2051,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * 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`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.25.0 | ThoughtSpot: 9.6.0.cl, 9.8.0.sw
 	 * @example
 	 * ```js
@@ -2056,7 +2088,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * Enable the V2 shell. This can provide performance benefits
 	 * due to a lighter-weight shell.
 	 *
-	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.31.2 | ThoughtSpot: 10.0.0.cl
 	 * @example
 	 * ```js
@@ -2083,7 +2115,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * 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`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.32.1 | ThoughtSpot: 10.3.0.cl
 	 * @example
 	 * ```js
@@ -2102,7 +2134,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * 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`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.35.0 | ThoughtSpot: 10.5.0.cl
 	 * @example
 	 * ```js
@@ -2122,7 +2154,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * {@link enableLinkOverridesV2} instead.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`,
-	 * `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`,
+	 * `SearchEmbed`, `SpotterAgentEmbed`,
 	 * `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
 	 * @example
@@ -2146,7 +2178,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * older ThoughtSpot versions.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`,
-	 * `SageEmbed`, `SearchEmbed`, `SpotterAgentEmbed`,
+	 * `SearchEmbed`, `SpotterAgentEmbed`,
 	 * `SpotterEmbed`, `SearchBarEmbed`
 	 * @version SDK: 1.46.0 | ThoughtSpot: 26.2.0.cl
 	 * @example
@@ -2205,7 +2237,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
 	 * external app, calling an API, or opening a modal — based on the data context of
 	 * what they clicked can be used to trigger custom logic when the action is clicked.
 	 *
-	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SageEmbed`, `SearchEmbed`, `SpotterEmbed`
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterEmbed`
 	 * @version SDK: 1.43.0 | ThoughtSpot: 10.14.0.cl
 	 * @example
 	 * ```ts
@@ -2559,11 +2591,11 @@ export interface SearchLiveboardCommonViewConfig {
 	/**
 	 * flag to set ContextMenu Trigger to either left or right click.
 	 *
-	 * Supported embed types: `AppEmbed`, `SageEmbed`, `SearchEmbed`
+	 * Supported embed types: `AppEmbed`, `SearchEmbed`
 	 * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
 	 * @example
 	 * ```js
-	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SageEmbed, or SearchEmbed
+	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, or SearchEmbed
 	 * const embed = new <EmbedComponent>('#tsEmbed', {
 	 *    ... // other embed view config
 	 *    contextMenuTrigger:ContextMenuTriggerOptions.LEFT_CLICK || RIGHT_CLICK,
@@ -2600,12 +2632,12 @@ export interface SearchLiveboardCommonViewConfig {
 	/**
 	 * To set the initial state of the search bar in case of saved Answers.
 	 *
-	 * Supported embed types: `SageEmbed`, `AppEmbed`, `SearchBarEmbed`
+	 * Supported embed types: `AppEmbed`, `SearchBarEmbed`
 	 * @default true
 	 * @version SDK: 1.34.0 | ThoughtSpot: 10.3.0.cl
 	 * @example
 	 * ```js
-	 * // Replace <EmbedComponent> with embed component name. For example, SageEmbed, AppEmbed, or SearchBarEmbed
+	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, or SearchBarEmbed
 	 * const embed = new <EmbedComponent>('#tsEmbed', {
 	 *    ... // other embed view config
 	 *   collapseSearchBar: true,
@@ -2616,12 +2648,12 @@ export interface SearchLiveboardCommonViewConfig {
 	/**
 	 * Flag to control Data panel experience
 	 *
-	 * Supported embed types: `SageEmbed`, `AppEmbed`, `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
+	 * Supported embed types: `AppEmbed`, `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
 	 * @deprecated from SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
 	 * @default true
 	 * @example
 	 * ```js
-	 * // Replace <EmbedComponent> with embed component name. For example, SageEmbed, AppEmbed, or SearchBarEmbed
+	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, or SearchBarEmbed
 	 * const embed = new <EmbedComponent>('#tsEmbed', {
 	 *    ... // other embed view config
 	 *    dataPanelV2: true,
@@ -2632,12 +2664,12 @@ export interface SearchLiveboardCommonViewConfig {
 	/**
 	 * To enable custom column groups in data panel v2
 	 *
-	 * Supported embed types: `SageEmbed`, `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
+	 * Supported embed types: `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
 	 * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl, 10.1.0.sw
 	 * @default false
 	 * @example
 	 * ```js
-	 * // Replace <EmbedComponent> with embed component name. For example, SageEmbed, SearchBarEmbed, or LiveboardEmbed
+	 * // Replace <EmbedComponent> with embed component name. For example, SearchBarEmbed, or LiveboardEmbed
 	 * const embed = new <EmbedComponent>('#tsEmbed', {
 	 *   ... // other embed view config
 	 *   enableCustomColumnGroups: true,
@@ -3630,6 +3662,17 @@ export enum EmbedEvent {
 	 * ```
 	 */
 	DownloadAsXlsx = "downloadAsXlsx",
+	/**
+	 * Emitted when the Download Liveboard as Continuous PDF action is triggered
+	 * on a Liveboard.
+	 * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+	 * @example
+	 * ```js
+	 * liveboardEmbed.on(EmbedEvent.DownloadLiveboardAsContinuousPDF, payload => {
+	 *   console.log('download liveboard as continuous PDF', payload)})
+	 * ```
+	 */
+	DownloadLiveboardAsContinuousPDF = "downloadLiveboardAsContinuousPDF",
 	/**
 	 * Emitted when an Answer is deleted in the app
 	 *  Use start:true to subscribe to when delete is initiated, or end:true to subscribe
@@ -4007,19 +4050,6 @@ export enum EmbedEvent {
 	 * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl, 9.5.0.sw
 	 */
 	FilterChanged = "filterChanged",
-	/**
-	 *  Emitted when a user clicks the **Go** button to initiate
-	 *  a Natural Language Search query
-	 * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
-	 */
-	SageEmbedQuery = "sageEmbedQuery",
-	/**
-	 * Emitted when a user selects a data source on the embedded
-	 * Natural Language Search interface.
-	 *
-	 * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
-	 */
-	SageWorksheetUpdated = "sageWorksheetUpdated",
 	/**
 	 * Emitted when a user updates a connection on the **Data** page
 	 * @version SDK: 1.27.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
@@ -5157,6 +5187,18 @@ export enum HostEvent {
 	 * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
 	 */
 	DownloadAsPdf = "downloadAsPdf",
+	/**
+	 * Trigger the **Download Liveboard as Continuous PDF** action on an
+	 * embedded Liveboard.
+	 *
+	 * @example
+	 * ```js
+	 * liveboardEmbed.trigger(HostEvent.DownloadLiveboardAsContinuousPDF)
+	 * ```
+	 *
+	 * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+	 */
+	DownloadLiveboardAsContinuousPDF = "downloadLiveboardAsContinuousPDF",
 	/**
 	 * Trigger the **AI Highlights** action on an embedded Liveboard
 	 *
@@ -5383,6 +5425,20 @@ export enum HostEvent {
 	 *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
 	 * }, ContextType.Liveboard);
 	 * ```
+	 * @example
+	 * ```js
+	 * // Copy link from liveboard context
+	 * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+	 * liveboardEmbed.trigger(HostEvent.CopyLink, {}, ContextType.Liveboard);
+	 * ```
+	 * @example
+	 * ```js
+	 * // Copy link from liveboard visualization context
+	 * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+	 * liveboardEmbed.trigger(HostEvent.CopyLink, {
+	 *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+	 * }, ContextType.Liveboard);
+	 * ```
 	 * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
 	 */
 	CopyLink = "embedDocument",
@@ -5414,6 +5470,20 @@ export enum HostEvent {
 	 * import { ContextType } from '@thoughtspot/visual-embed-sdk';
 	 * liveboardEmbed.trigger(HostEvent.Present, {}, ContextType.Liveboard);
 	 * ```
+	 * @example
+	 * ```js
+	 * // Present from liveboard visualization context
+	 * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+	 * liveboardEmbed.trigger(HostEvent.Present, {
+	 *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
+	 * }, ContextType.Liveboard);
+	 * ```
+	 * @example
+	 * ```js
+	 * // Present from liveboard context
+	 * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+	 * liveboardEmbed.trigger(HostEvent.Present, {}, ContextType.Liveboard);
+	 * ```
 	 * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
 	 */
 	Present = "present",
@@ -5442,7 +5512,7 @@ export enum HostEvent {
 	 *      tml.answer.search_query // TML representation of the search query
 	 *   );
 	 * })
-	* ```
+	 * ```
 	 * @example
 	 * ```js
 	 * // Get TML from search context
@@ -6065,21 +6135,6 @@ export enum HostEvent {
 	 * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
 	 */
 	SetHiddenTabs = "SetPinboardHiddenTabs",
-	/**
-	 * Updates the search query string for Natural Language Search operations.
-	 * @param - Includes the following keys:
-	 * - `queryString`: Text string in Natural Language format.
-	 * - `executeSearch`: Boolean to execute search and update search query.
-	 * @example
-	 * ```js
-	 * sageEmbed.trigger(HostEvent.UpdateSageQuery, {
-	 *  queryString: 'revenue per year',
-	 *  executeSearch: true,
-	 * })
-	 * ```
-	 * @version SDK: 1.26.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
-	 */
-	UpdateSageQuery = "updateSageQuery",
 	/**
 	 * Get the Answer session for a Search or
 	 * Liveboard visualization.
@@ -6899,6 +6954,16 @@ export enum Action {
 	 * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
 	 */
 	DownloadLiveboard = "downloadLiveboard",
+	/**
+	 * The **Download Liveboard as Continuous PDF** menu action on a Liveboard.
+	 * Allows downloading the entire Liveboard as a continuous PDF.
+	 * @example
+	 * ```js
+	 * disabledActions: [Action.DownloadLiveboardAsContinuousPDF]
+	 * ```
+	 * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+	 */
+	DownloadLiveboardAsContinuousPDF = "downloadLiveboardAsContinuousPDF",
 	/**
 	 * @hidden
 	 */
@@ -7855,11 +7920,11 @@ export enum Action {
 	 */
 	CoverAndFilterOptionInPDF = "coverAndFilterOptionInPDF",
 	/**
-	* Action ID to hide or disable the Coaching workflow in Spotter conversations.
-	* When disabled, users cannot access **Add to Coaching** workflow in conversation.
-	* The **Add to Coaching** feature allows adding reference questions and
-	* business terms to improve Spotter’s responses. This feature is generally available
-	* (GA) from version 26.2.0.cl and enabled by default on embed deployments.
+	 * Action ID to hide or disable the Coaching workflow in Spotter conversations.
+	 * When disabled, users cannot access **Add to Coaching** workflow in conversation.
+	 * The **Add to Coaching** feature allows adding reference questions and
+	 * business terms to improve Spotter’s responses. This feature is generally available
+	 * (GA) from version 26.2.0.cl and enabled by default on embed deployments.
 	 *  @example
 	 * ```js
 	 * hiddenAction: [Action.InConversationTraining]
@@ -7936,17 +8001,17 @@ export enum Action {
 	 */
 	LiveboardStylePanel = "liveboardStylePanel",
 	/**
-	* The **Publish** action for Liveboards, Answers and Models.
-	* Opens the publishing modal. It's a parent action for the
-	* **Manage Publishing** and **Unpublish** actions if the object
-	* is already published, otherwise appears standalone.
-	* @example
-	* ```js
-	* hiddenActions: [Action.Publish]
-	* disabledActions: [Action.Publish]
-	* ```
-	* @version SDK: 1.45.0 | ThoughtSpot Cloud: 26.2.0.cl
-	*/
+	 * The **Publish** action for Liveboards, Answers and Models.
+	 * Opens the publishing modal. It's a parent action for the
+	 * **Manage Publishing** and **Unpublish** actions if the object
+	 * is already published, otherwise appears standalone.
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.Publish]
+	 * disabledActions: [Action.Publish]
+	 * ```
+	 * @version SDK: 1.45.0 | ThoughtSpot Cloud: 26.2.0.cl
+	 */
 	Publish = "publish",
 	/**
 	 * The **Manage Publishing** action for Liveboards, Answers and Models.
@@ -8114,6 +8179,39 @@ export enum Action {
 	 * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
 	 */
 	SpotterDocs = "spotterDocs",
+	/**
+	 * Controls visibility and disable state of the connector resources
+	 * section in the Spotter chat interface.
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterChatConnectorResources]
+	 * disabledActions: [Action.SpotterChatConnectorResources]
+	 * ```
+	 * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
+	 */
+	SpotterChatConnectorResources = "spotterChatConnectorResources",
+	/**
+	 * Controls visibility and disable state of the connectors
+	 * in the Spotter chat interface.
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterChatConnectors]
+	 * disabledActions: [Action.SpotterChatConnectors]
+	 * ```
+	 * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
+	 */
+	SpotterChatConnectors = "spotterChatConnectors",
+	/**
+	 * Controls visibility and disable state of the mode switcher
+	 * in the Spotter chat interface.
+	 * @example
+	 * ```js
+	 * hiddenActions: [Action.SpotterChatModeSwitcher]
+	 * disabledActions: [Action.SpotterChatModeSwitcher]
+	 * ```
+	 * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
+	 */
+	SpotterChatModeSwitcher = "spotterChatModeSwitcher",
 	/**
 	 * The **Include current period** checkbox for date filters.
 	 * Controls the visibility and availability of the option to include
@@ -8457,7 +8555,13 @@ 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"
+	INVALID_URL = "INVALID_URL",
+	/** Host event payload validation failed */
+	HOST_EVENT_VALIDATION = "HOST_EVENT_VALIDATION",
+	/** UpdateFilters payload is invalid - missing or malformed filter/filters */
+	UPDATEFILTERS_INVALID_PAYLOAD = "UPDATEFILTERS_INVALID_PAYLOAD",
+	/** DrillDown payload is invalid - missing or malformed points */
+	DRILLDOWN_INVALID_PAYLOAD = "DRILLDOWN_INVALID_PAYLOAD"
 }
 /**
  * Error event object emitted when an error occurs in an embedded component.
@@ -8701,6 +8805,8 @@ export enum UIPassthroughEvent {
 	GetAnswerConfig = "getAnswerPageConfig",
 	GetLiveboardConfig = "getPinboardPageConfig",
 	GetUnsavedAnswerTML = "getUnsavedAnswerTML",
+	UpdateFilters = "updateFilters",
+	Drilldown = "drillDown",
 	GetAnswerSession = "getAnswerSession",
 	GetFilters = "getFilters",
 	GetIframeUrl = "getIframeUrl",
@@ -8822,6 +8928,35 @@ export type UIPassthroughContractBase = {
 			v2Content: string;
 		};
 	};
+	[UIPassthroughEvent.UpdateFilters]: {
+		request: {
+			filter?: {
+				column: string;
+				oper: string;
+				values: string[];
+				type?: string;
+			};
+			filters?: {
+				column: string;
+				oper: string;
+				values: string[];
+				type?: string;
+			}[];
+		};
+		response: unknown;
+	};
+	[UIPassthroughEvent.Drilldown]: {
+		request: {
+			points: {
+				selectedPoints?: string[];
+				clickedPoint?: string;
+			};
+			columnGuid?: string;
+			autoDrillDown?: boolean;
+			vizId?: string;
+		};
+		response: unknown;
+	};
 };
 export type UIPassthroughRequest<T extends keyof UIPassthroughContractBase> = UIPassthroughContractBase[T]["request"];
 export type UIPassthroughResponse<T extends keyof UIPassthroughContractBase> = UIPassthroughContractBase[T]["response"];
@@ -8847,6 +8982,8 @@ export type TriggerPayload<PayloadT, HostEventT extends HostEvent> = PayloadT |
 export type TriggerResponse<PayloadT, HostEventT extends HostEvent, ContextT extends ContextType> = PayloadT extends HostEventRequest<HostEventT> ? HostEventResponse<HostEventT, ContextT> : any;
 class HostEventClient {
 	iFrame: HTMLIFrameElement;
+	/** Cached list of available UI passthrough keys from the embedded app */
+	private availablePassthroughKeysCache;
 	/** Host events with custom handlers
 	 * (setters or special logic) -
 	 * bound to instance for protected method access */
@@ -8872,9 +9009,25 @@ class HostEventClient {
 	 * @param {HTMLIFrameElement} iFrame - the iframe element to set
 	 */
 	setIframeElement(iFrame: HTMLIFrameElement): void;
+	/**
+	 * Fetches the list of available UI passthrough keys from the embedded app.
+	 * Result is cached for the session. Returns empty array on failure.
+	 */
+	private getAvailableUIPassthroughKeys;
 	triggerUIPassthroughApi<UIPassthroughEventT extends UIPassthroughEvent>(apiName: UIPassthroughEventT, parameters: UIPassthroughRequest<UIPassthroughEventT>, context?: ContextType): Promise<UIPassthroughArrayResponse<UIPassthroughEventT>>;
 	protected handlePinEvent(payload: HostEventRequest<HostEvent.Pin>, context?: ContextType): Promise<HostEventResponse<HostEvent.Pin, ContextType>>;
 	protected handleSaveAnswerEvent(payload: HostEventRequest<HostEvent.SaveAnswer>, context?: ContextType): Promise<any>;
+	protected handleUpdateFiltersEvent(payload: HostEventRequest<HostEvent.UpdateFilters>, context?: ContextType): Promise<any>;
+	protected handleDrillDownEvent(payload: HostEventRequest<HostEvent.DrillDown>, context?: ContextType): Promise<any>;
+	/**
+	 * Dispatches a host event using the appropriate channel:
+	 * 1. If the embedded app supports UI passthrough for this event, use it (custom handler or getter).
+	 * 2. Otherwise fall back to the legacy host event channel.
+	 *
+	 * @param hostEvent - The host event to trigger
+	 * @param payload - Optional payload for the event
+	 * @param context - Optional context (e.g. vizId) for scoped operations
+	 */
 	triggerHostEvent<HostEventT extends HostEvent, PayloadT, ContextT extends ContextType>(hostEvent: HostEventT, payload?: TriggerPayload<PayloadT, HostEventT>, context?: ContextT): Promise<TriggerResponse<PayloadT, HostEventT, ContextType>>;
 }
 class TsEmbed {
@@ -9545,7 +9698,7 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, "primaryAct
 	 * @default true
 	 * @example
 	 * ```js
-	 * // Replace <EmbedComponent> with embed component name. For example, SageEmbed, AppEmbed, or SearchBarEmbed
+	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, or SearchBarEmbed
 	 * const embed = new <EmbedComponent>('#tsEmbed', {
 	 *    ... // other embed view config
 	 *    dataPanelV2: true,
@@ -9721,6 +9874,15 @@ export interface SpotterEmbedViewConfig extends Omit<BaseViewConfig, "primaryAct
  */
 export interface ConversationViewConfig extends SpotterEmbedViewConfig {
 }
+/**
+ * APP_INIT data shape for SpotterEmbed.
+ * @internal
+ */
+export interface SpotterAppInitData extends DefaultAppInitData {
+	embedParams?: {
+		spotterSidebarConfig?: SpotterSidebarViewConfig;
+	};
+}
 /**
  * Embed ThoughtSpot AI Conversation.
  * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
@@ -9739,6 +9901,19 @@ export interface ConversationViewConfig extends SpotterEmbedViewConfig {
 export class SpotterEmbed extends TsEmbed {
 	protected viewConfig: SpotterEmbedViewConfig;
 	constructor(container: HTMLElement, viewConfig: SpotterEmbedViewConfig);
+	/**
+	 * Extends the default APP_INIT payload with `embedParams.spotterSidebarConfig`
+	 * so the conv-assist app can read sidebar configuration on initialisation.
+	 *
+	 * Precedence for `enablePastConversationsSidebar`:
+	 * `spotterSidebarConfig.enablePastConversationsSidebar` wins over the
+	 * deprecated top-level `enablePastConversationsSidebar` flag; if the former
+	 * is absent the latter is used as a fallback.
+	 *
+	 * An invalid `spotterDocumentationUrl` triggers a validation error and is
+	 * excluded from the payload rather than forwarded to the app.
+	 */
+	protected getAppInitData(): Promise<SpotterAppInitData>;
 	protected getEmbedParamsObject(): Record<any, any>;
 	getIframeSrc(): string;
 	render(): Promise<SpotterEmbed>;
@@ -10267,21 +10442,6 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * @version SDK: 1.33.0 | ThoughtSpot: 10.3.0.cl
 	 */
 	homePageSearchBarMode?: HomePageSearchBarMode;
-	/**
-	 * This flag is used to enable unified search experience for full app embed.
-	 *
-	 * Supported embed types: `AppEmbed`
-	 * @version SDK: 1.34.0 | ThoughtSpot: 10.5.0.cl
-	 * @default true
-	 * @example
-	 * ```js
-	 * const embed = new AppEmbed('#tsEmbed', {
-	 *    ... // other embed view config
-	 *    isUnifiedSearchExperienceEnabled: true,
-	 * })
-	 * ```
-	 */
-	isUnifiedSearchExperienceEnabled?: boolean;
 	/**
 	 * This flag is used to enable/disable the styling and grouping in a Liveboard. Use {@link isLiveboardMasterpiecesEnabled} instead.
 	 * @deprecated This flag is deprecated.
@@ -10316,6 +10476,24 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	isPNGInScheduledEmailsEnabled?: boolean;
+	/**
+	 * Enables the 'what you see is what you get' PDF export for Liveboards. Each tab is rendered on a single page
+	 * following the exact UI layout, instead of splitting visualizations across multiple A4 pages.
+	 * This feature is GA from version 26.5.0.cl and is enabled by default on embed deployments.
+	 *
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
+	 * @type {boolean}
+	 * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+	 * @example
+	 * ```js
+	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
+	 * const embed = new <EmbedComponent>('#tsEmbed', {
+	 *    ... // other embed view config
+	 *    isContinuousLiveboardPDFEnabled: true,
+	 * })
+	 * ```
+	 */
+	isContinuousLiveboardPDFEnabled?: boolean;
 	/**
 	 * This flag is used to enable/disable the XLSX/CSV download option for Liveboards
 	 *
@@ -10484,6 +10662,15 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 */
 	enableHomepageAnnouncement?: boolean;
 }
+/**
+ * APP_INIT data shape for AppEmbed.
+ * @internal
+ */
+export interface AppEmbedAppInitData extends DefaultAppInitData {
+	embedParams?: {
+		spotterSidebarConfig?: SpotterSidebarViewConfig;
+	};
+}
 /**
  * Embeds full ThoughtSpot experience in a host application.
  * @group Embed components
@@ -10492,6 +10679,19 @@ export class AppEmbed extends V1Embed {
 	protected viewConfig: AppViewConfig;
 	private defaultHeight;
 	constructor(domSelector: DOMSelector, viewConfig: AppViewConfig);
+	/**
+	 * Extends the default APP_INIT payload with `embedParams.spotterSidebarConfig`
+	 * so the conv-assist app can read sidebar configuration on initialisation.
+	 *
+	 * Precedence for `enablePastConversationsSidebar`:
+	 * `spotterSidebarConfig.enablePastConversationsSidebar` wins over the
+	 * deprecated top-level `enablePastConversationsSidebar` flag; if the former
+	 * is absent the latter is used as a fallback.
+	 *
+	 * An invalid `spotterDocumentationUrl` triggers a validation error and is
+	 * excluded from the payload rather than forwarded to the app.
+	 */
+	protected getAppInitData(): Promise<AppEmbedAppInitData>;
 	/**
 	 * Constructs a map of parameters to be passed on to the
 	 * embedded Liveboard or visualization.
@@ -10510,7 +10710,6 @@ export class AppEmbed extends V1Embed {
 	 * @param pageId The ID of the page to be embedded.
 	 */
 	getIFrameSrc(): string;
-	private HEIGHT_CHANAGE_THRESHOLD;
 	/**
 	 * Set the iframe height as per the computed height received
 	 * from the ThoughtSpot app.
@@ -11193,6 +11392,24 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	 * ```
 	 */
 	isPNGInScheduledEmailsEnabled?: boolean;
+	/**
+	 * Enables the 'what you see is what you get' PDF export for Liveboards. Each tab is rendered on a single page
+	 * following the exact UI layout, instead of splitting visualizations across multiple A4 pages.
+	 * This feature is GA from version 26.5.0.cl and is enabled by default on embed deployments.
+	 *
+	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
+	 * @type {boolean}
+	 * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
+	 * @example
+	 * ```js
+	 * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
+	 * const embed = new <EmbedComponent>('#tsEmbed', {
+	 *    ... // other embed view config
+	 *    isContinuousLiveboardPDFEnabled: true,
+	 * })
+	 * ```
+	 */
+	isContinuousLiveboardPDFEnabled?: boolean;
 	/**
 	 * This flag is used to enable/disable the XLSX/CSV download option for Liveboards
 	 *
@@ -11353,7 +11570,6 @@ export class LiveboardEmbed extends V1Embed {
 	 * to be loaded within the iFrame.
 	 */
 	private getIFrameSrc;
-	private HEIGHT_CHANAGE_THRESHOLD;
 	/**
 	 * Set the iframe height as per the computed height received
 	 * from the ThoughtSpot app.
@@ -11982,157 +12198,6 @@ export type SessionInfo = {
  * @returns {Promise<SessionInfo>} The session info object.
  */
 export function getSessionInfo(): Promise<SessionInfo>;
-interface SearchOptions$2 {
-	/**
-	 * The query string to pass for Natural Language Search.
-	 */
-	searchQuery: string;
-	/**
-	 * Boolean to define if the search should be executed or not.
-	 * If it is executed, the focus is placed on the results.
-	 * If it’s not executed, the focus is placed at the end of
-	 * the token string in the search bar.
-	 */
-	executeSearch?: boolean;
-}
-/**
- * The configuration attributes for the embedded Natural language search view. Based on
- * GPT and LLM.
- * @version SDK: 1.23.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
- *
- * Note: This embed will be deprecated from SDK: 1.40.0 | ThoughtSpot: 10.13.0.cl
- * @group Embed components
- */
-export interface SageViewConfig extends SearchLiveboardCommonViewConfig, Omit<BaseViewConfig, "primaryAction" | "runtimeFilters" | "runtimeParameters" | "excludeRuntimeFiltersfromURL" | "excludeRuntimeParametersfromURL"> {
-	/**
-	 * If set to true, a list of Liveboard and Answers related
-	 * to the natural language search will be shown below the
-	 * AI generated answer.
-	 * @deprecated Currently Liveboard and Answers related
-	 * to the natural language search will not be shown for sage
-	 * embed
-	 */
-	showObjectResults?: boolean;
-	/**
-	 * flag used by the TS product tour page to show the blue search bar
-	 * even after the search is completed. This is different from ThoughtSpot Embedded
-	 * Sage Embed experience where it mimics closer to the non-embed case.
-	 * The Sample questions container is collapsed when this value is set after
-	 * does a search.
-	 * @version SDK: 1.26.0 | ThoughtSpot: 9.8.0.cl
-	 * @hidden
-	 */
-	isProductTour?: boolean;
-	/**
-	 * Show or hide the search bar title.
-	 * @version SDK: 1.29.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
-	 * @deprecated ThoughtSpot: 9.10.0.cl | search bar doesn't have the title from 9.10.0.cl
-	 */
-	hideSearchBarTitle?: boolean;
-	/**
-	 * Show or hide the Answer header, that is, the `AI Answer` title
-	 * at the top of the Answer page.
-	 * @version SDK: 1.26.0 | ThoughtSpot: 9.10.0.cl
-	 */
-	hideSageAnswerHeader?: boolean;
-	/**
-	 * Disable the data source selection option.
-	 * @version SDK: 1.26.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
-	 */
-	disableWorksheetChange?: boolean;
-	/**
-	 * Hide the data source selection panel.
-	 * @version SDK: 1.26.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
-	 */
-	hideWorksheetSelector?: boolean;
-	/**
-	 * Show or hide autocomplete suggestions for the search query string.
-	 * @version SDK: 1.26.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
-	 */
-	hideAutocompleteSuggestions?: boolean;
-	/**
-	 * Show or hide autocomplete suggestions for the search query string.
-	 * You can use {@link hideAutocompleteSuggestions} instead.
-	 * @deprecated
-	 * Currently, the object suggestions will not be shown for Natural Language Search.
-	 */
-	showObjectSuggestions?: boolean;
-	/**
-	 * Show or hide sample questions.
-	 * The sample questions are autogenerated based on the data model
-	 * selected for the search operation.
-	 *
-	 * Supported embed types: `SageEmbed`
-	 * @version SDK: 1.26.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
-	 * @example
-	 * ```js
-	 * const embed = new SageEmbed('#tsEmbed', {
-	 *    ... //other embed view config
-	 *    hideSampleQuestions : true,
-	 * })
-	 * ```
-	 */
-	hideSampleQuestions?: boolean;
-	/**
-	 * The data source GUID (Model GUID) to set on load.
-	 */
-	dataSource?: string;
-	/**
-	 * Includes the following properties:
-	 *
-	 * `searchQuery`: The search query string to pass in the search bar.
-	 * Supports Natural Language Search queries.
-	 *
-	 * `executeSearch`: Boolean to define if the search should be executed or not.
-	 * If it is executed, the focus is placed on the results.
-	 * If it’s not executed, the focus is placed at the end of
-	 * the token string in the search bar.
-	 *
-	 * Supported embed types: `SageEmbed`
-	 * @version SDK: 1.26.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
-	 * @example
-	 * ```js
-	 * searchOptions: {
-	 *    searchQuery: 'average sales by country and product type',
-	 *    executeSearch: true,
-	 * }
-	 * ```
-	 */
-	searchOptions?: SearchOptions$2;
-}
-/**
- * Embed ThoughtSpot LLM and GPT-based Natural Language Search component.
- * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl, 9.5.1-sw
- *
- * Note: This embed will be deprecated from SDK: 1.40.0 | ThoughtSpot: 10.13.0.cl
- * @group Embed components
- */
-export class SageEmbed extends V1Embed {
-	/**
-	 * The view configuration for the embedded ThoughtSpot sage.
-	 *
-	 */
-	protected viewConfig: SageViewConfig;
-	constructor(domSelector: DOMSelector, viewConfig: SageViewConfig);
-	protected getEmbedParamsObject(): Record<any, any>;
-	/**
-	 * Constructs a map of parameters to be passed on to the
-	 * embedded Eureka or Sage search page.
-	 * @returns {string} query string
-	 */
-	protected getEmbedParams(): string;
-	/**
-	 * Construct the URL of the embedded ThoughtSpot sage to be
-	 * loaded in the iframe
-	 * @returns {string} iframe url
-	 */
-	getIFrameSrc(): string;
-	/**
-	 * Render the embedded ThoughtSpot Sage
-	 * @returns {SageEmbed} Eureka/Sage embed
-	 */
-	render(): Promise<SageEmbed>;
-}
 /**
  * Gets the embed configuration settings that were used to
  * initialize the SDK.