@thoughtspot/visual-embed-sdk 1.50.0 → 1.51.0

package/lib/src/types.d.ts

@@ -169,7 +169,9 @@ export declare enum AuthType {
 }
 /**
  *
- * **Note**:  This attribute is not supported in the classic (V1) homepage experience.
+ * **Note**: The classic (V1) and Modular (V2) home page experiences are
+ * deprecated. This attribute applies to V3 (ModularWithStylingChanges) and
+ * V4 (Focused) home page experiences.
  *
  */
 export declare enum HomeLeftNavItem {
@@ -235,7 +237,14 @@ export declare enum HomeLeftNavItem {
      * Available in the V3 navigation experience.
      * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
      */
-    Favorites = "favorites"
+    Favorites = "favorites",
+    /**
+     * The *Collections* menu option in
+     * the *Insights* left navigation panel.
+     * Shown when collections are enabled on the cluster.
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    Collections = "collections"
 }
 export type DOMSelector = string | HTMLElement;
 /**
@@ -1182,6 +1191,26 @@ export interface BaseViewConfig extends ApiInterceptFlags {
      * ```
      */
     overrideOrgId?: number;
+    /**
+     * Overrides the browser history behavior for embedding application users.
+     * This parameter changes standard history navigation (pushState) into a
+     * state replacement (replaceState), preventing users from getting trapped in
+     * back-button loops inside the embedded iframe environment.
+     * The overrideHistoryState setting is honored only if the
+     * application is running within an embedded context.
+     *
+     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     * @example
+     * ```js
+     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
+     * const embed = new <EmbedComponent>('#tsEmbed', {
+     *     // ... other embed view config
+     *     overrideHistoryState: true,
+     * });
+     * ```
+     */
+    overrideHistoryState?: boolean;
     /**
      * Flag to override the *Open Link in New Tab* context
      * menu option.
@@ -1540,7 +1569,9 @@ export interface HomePageConfig {
      * To specify the modules, import the `HomepageModule` enum.
      * For example: `hiddenHomepageModules = [HomepageModule.MyLibrary]`
      *
-     * **Note**: This attribute is not supported in the classic (v1) experience.
+     * **Note**: The classic (V1) and Modular (V2) home page experiences are
+     * deprecated. This attribute applies to V3 (ModularWithStylingChanges)
+     * and V4 (Focused) home page experiences.
      *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
@@ -1549,7 +1580,7 @@ export interface HomePageConfig {
      * import { HomepageModule } from '@thoughtspot/visual-embed-sdk';
      *
      * const embed = new AppEmbed('#tsEmbed', {
-     *    ... // V2/V3 navigation and home page experience attributes
+     *    ... // V3 navigation and home page experience attributes
      *    hiddenHomepageModules : [HomepageModule.Favorite,HomepageModule.Learning],
      *    //...other embed view configuration attributes
      * })
@@ -1560,8 +1591,11 @@ export interface HomePageConfig {
      * Reorder home page modules.
      * To specify the modules, import the `HomepageModule` enum.
      * For example: `reorderedHomepageModules = [HomepageModule.MyLibrary,
-     * HomepageModule.Watchlist]` **Note**: This attribute is not supported in the
-     * classic (v1) homepage.
+     * HomepageModule.Watchlist]`
+     *
+     * **Note**: The classic (V1) and Modular (V2) home page experiences are
+     * deprecated. This attribute applies to V3 (ModularWithStylingChanges)
+     * and V4 (Focused) home page experiences.
      *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
@@ -1570,7 +1604,7 @@ export interface HomePageConfig {
      * import { HomepageModule } from '@thoughtspot/visual-embed-sdk';
      *
      * const embed = new AppEmbed('#tsEmbed', {
-     *    ...//V2/V3 navigation and home page experience attributes
+     *    ...//V3 navigation and home page experience attributes
      *    reorderedHomepageModules:[HomepageModule.Favorite,HomepageModule.MyLibrary],
      *    //... other embed view configuration attributes
      * })
@@ -1582,7 +1616,9 @@ export interface HomePageConfig {
      * on the home page left navigation panel.
      * To specify the menu items, import the `HomeLeftNavItem` enum.
      *
-     * **Note**: This attribute is not supported in the classic (v1) homepage.
+     * **Note**: The classic (V1) and Modular (V2) home page experiences are
+     * deprecated. This attribute applies to V3 (ModularWithStylingChanges)
+     * and V4 (Focused) home page experiences.
      *
      * Supported embed types: `AppEmbed`
      * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
@@ -1958,6 +1994,24 @@ export interface LiveboardAppEmbedViewConfig {
      * ```
      */
     isCentralizedLiveboardFilterUXEnabled?: boolean;
+    /**
+     * This flag is used to enable or disable scoped Liveboard filtering.
+     * When enabled, filters and parameters can be scoped to a group of
+     * visualizations on a Liveboard, in addition to the Liveboard and
+     * tab levels.
+     *
+     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
+     * @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
+     * @example
+     * ```js
+     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
+     * const embed = new <EmbedComponent>('#tsEmbed', {
+     *    ... // other embed view config
+     *    isScopedLiveboardFilteringEnabled: true,
+     * })
+     * ```
+     */
+    isScopedLiveboardFilteringEnabled?: boolean;
     /**
      * This flag is used to enable or disable the link parameters in liveboard.
      *
@@ -2156,7 +2210,9 @@ export declare enum RuntimeFilterOp {
  * via `hiddenHomepageModules` and reordered via
  * `reorderedHomepageModules`.
  *
- * **Note**: This option is not supported in the classic (v1) experience.
+ * **Note**: The classic (V1) and Modular (V2) home page experiences are
+ * deprecated. These modules apply to V3 (ModularWithStylingChanges) and
+ * V4 (Focused) home page experiences.
  * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
  */
 export declare enum HomepageModule {
@@ -3145,11 +3201,19 @@ export declare enum EmbedEvent {
      * Emitted when a user changes any filter on a Liveboard.
      * Returns filter type and name, column name and ID, and runtime
      * filter details.
+     * The payload includes an optional `applicability` attribute indicating the
+     * scope of the changed filter. It contains a `level` (`LIVEBOARD`,
+     * `TAB`, or `GROUP`) and, when `level` is `TAB` or `GROUP`, a
+     * `targetId` with the GUID of the target. At `LIVEBOARD` level there
+     * is no `targetId`, since the filter applies to the whole Liveboard.
+     * The `applicability` attribute is available from SDK: 1.53.0 |
+     * ThoughtSpot: 26.10.0.cl.
      * @example
      *
      * ```js
      * LiveboardEmbed.on(EmbedEvent.FilterChanged, (payload) => {
      *    console.log('payload', payload);
+     *    // payload.data optionally includes applicability: { level, targetId }
      * })
      * ```
      * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl, 9.5.0.sw
@@ -3341,9 +3405,17 @@ export declare enum EmbedEvent {
     /**
      * Emitted when parameter changes in an Answer
      * or Liveboard.
+     * The payload includes an optional `applicability` attribute indicating the
+     * scope of the changed parameter. It contains a `level` (`LIVEBOARD`,
+     * `TAB`, or `GROUP`) and, when `level` is `TAB` or `GROUP`, a
+     * `targetId` with the GUID of the target. At `LIVEBOARD` level there
+     * is no `targetId`, since the parameter applies to the whole Liveboard.
+     * The `applicability` attribute is available from SDK: 1.53.0 |
+     * ThoughtSpot: 26.10.0.cl.
      * ```js
      * liveboardEmbed.on(EmbedEvent.ParameterChanged, (payload) => {
      *     console.log('payload', payload);
+     *     // payload.data optionally includes applicability: { level, targetId }
      * })
      * ```
      * @version SDK: 1.29.0 | ThoughtSpot: 10.3.0.cl
@@ -3645,6 +3717,158 @@ export declare enum EmbedEvent {
      * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
      */
     SpotterConversationDeleted = "spotterConversationDeleted",
+    /**
+     * Emitted when the header Share button is clicked. Fires `Start` then `End`
+     * to bracket the interaction. App→host counterpart of the
+     * `ShareSpotterConversation` host event (user-driven vs programmatic open).
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterShareConversationButtonHeaderClicked, (payload) => {
+     *     // payload: { convId: string }
+     * })
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareConversationButtonHeaderClicked = "spotterShareConversationButtonHeaderClicked",
+    /**
+     * Emitted when the sidebar Share item is clicked. Fires `Start` then `End`
+     * to bracket the interaction.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterShareConversationMenuItemSidebarClicked, (payload) => {
+     *     // payload: { convId: string }
+     * })
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareConversationMenuItemSidebarClicked = "spotterShareConversationMenuItemSidebarClicked",
+    /**
+     * Emitted when a Spotter conversation is shared (recipients added, or a new
+     * share created). The host builds its own link from shareId/convId + its
+     * configured CONVERSATION_URL — no link string is sent. Distinct from
+     * `SpotterShareModalConfirmButtonClicked`, which fires at click time before
+     * the save resolves.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterConversationShared, (payload) => {
+     *     // payload: { convId: string, shareId: string,
+     *     //            recipientsAdded: string[], recipientsRemoved: string[] }
+     * })
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterConversationShared = "spotterConversationShared",
+    /**
+     * Emitted when access to a shared Spotter conversation is revoked
+     * (recipients removed). `fullyRevoked` is true when the last sharee is removed
+     * and the share is deleted entirely.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterConversationShareRevoked, (payload) => {
+     *     // payload: { convId: string, shareId: string,
+     *     //            recipientsRemoved: string[], fullyRevoked: boolean }
+     * })
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterConversationShareRevoked = "spotterConversationShareRevoked",
+    /**
+     * Emitted when a recipient opens a shared Spotter conversation (read-only
+     * view). No shareId available viewer-side.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterSharedConversationViewed, (payload) => {
+     *     // payload: { convId: string, sourceConvId: string }
+     *     // convId = resolved snapshot conv id; sourceConvId = the shared URL id
+     * })
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterSharedConversationViewed = "spotterSharedConversationViewed",
+    /**
+     * Emitted when the user toggles the share-modal "include new messages since
+     * last shared version" checkbox.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterShareIncludeNewMessagesCheckboxToggled, (payload) => {
+     *     // payload: { convId: string, includeNewMessages: boolean }
+     * })
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareIncludeNewMessagesCheckboxToggled = "spotterShareIncludeNewMessagesCheckboxToggled",
+    /**
+     * Emitted when the user dismisses the stale-snapshot info banner via its
+     * cross (distinct from the include-new-messages checkbox toggle).
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterShareStaleInfoBannerDismissed, (payload) => {
+     *     // payload: { convId: string }
+     * })
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareStaleInfoBannerDismissed = "spotterShareStaleInfoBannerDismissed",
+    /**
+     * Emitted when the modal Share (confirm) button is clicked — fires at click
+     * time, before the save resolves. Distinct from the `SpotterConversationShared`
+     * / `SpotterConversationShareRevoked` result events.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterShareModalConfirmButtonClicked, (payload) => {
+     *     // payload: { convId: string }
+     * })
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareModalConfirmButtonClicked = "spotterShareModalConfirmButtonClicked",
+    /**
+     * Emitted when the share modal is dismissed via the Cancel button.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterShareModalCancelButtonClicked, (payload) => {
+     *     // payload: { convId: string }
+     * })
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareModalCancelButtonClicked = "spotterShareModalCancelButtonClicked",
+    /**
+     * Emitted when a recipient leaves the read-only shared view via the Exit
+     * button.
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterSharedConversationExitButtonClicked, (payload) => {
+     *     // payload: { convId: string }
+     * })
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterSharedConversationExitButtonClicked = "spotterSharedConversationExitButtonClicked",
+    /**
+     * Emitted when a Spotter conversation is pinned.
+     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterConversationPinned, (payload) => {
+     *     console.log('Conversation pinned', payload);
+     *     // payload: { conversationId: string, pinnedAt: string (ISO 8601) }
+     * })
+     * ```
+     */
+    SpotterConversationPinned = "spotterConversationPinned",
+    /**
+     * Emitted when a Spotter conversation is unpinned.
+     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterConversationUnpinned, (payload) => {
+     *     console.log('Conversation unpinned', payload);
+     *     // payload: { conversationId: string, unpinnedAt: string (ISO 8601) }
+     * })
+     * ```
+     */
+    SpotterConversationUnpinned = "spotterConversationUnpinned",
     /**
      * Emitted when a Spotter conversation is selected/clicked.
      * @example
@@ -3657,6 +3881,30 @@ export declare enum EmbedEvent {
      * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
      */
     SpotterConversationSelected = "spotterConversationSelected",
+    /**
+     * Emitted when the Spotter agent finishes streaming/rendering a response.
+     * Includes the conversation and message identifiers so the host app can
+     * fetch the full conversation history via the REST API if needed.
+     *
+     * The payload data has the shape `{ convId: string, messageId: string }`.
+     *
+     * Works with SpotterEmbed as well as AppEmbed (when Spotter is reached
+     * inside the full application).
+     * @example
+     * ```js
+     * spotterEmbed.on(EmbedEvent.SpotterResponseComplete, (payload) => {
+     *     console.log('Spotter response complete', payload);
+     * })
+     * ```
+     * @example
+     * ```js
+     * appEmbed.on(EmbedEvent.SpotterResponseComplete, (payload) => {
+     *     console.log('Spotter response complete', payload);
+     * })
+     * ```
+     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterResponseComplete = "spotterResponseComplete",
     /**
      * @hidden
      * Emitted when the auth token is about to get expired and needs to be refreshed.
@@ -4136,6 +4384,17 @@ export declare enum HostEvent {
      *  name: string,
      *  type: ATTRIBUTE/MEASURE,
      *  dataType: INT64/CHAR/DATE }
+     *
+     * `applicability` - Optional. Scopes the filter to a specific target,
+     * for example, a single Liveboard tab, so the panel for the correct
+     * scoped filter is opened. Available from SDK: 1.53.0 |
+     * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
+     *
+     *  - `level`: The scope of the filter: `LIVEBOARD`, `TAB`, or `GROUP`.
+     *  - `targetId`: The GUID of the target, for example, the tab GUID.
+     *    Required when `level` is `TAB` or `GROUP`. Do not pass it when
+     *    `level` is `LIVEBOARD`, since the filter applies to the whole
+     *    Liveboard. Omitting `applicability` targets the `LIVEBOARD` level.
      * @example
      * ```js
      * searchEmbed.trigger(HostEvent.OpenFilter,
@@ -4148,6 +4407,14 @@ export declare enum HostEvent {
      * ```
      * @example
      * ```js
+     * // Open a filter scoped to a specific Liveboard tab
+     * liveboardEmbed.trigger(HostEvent.OpenFilter, {
+     *     column: { columnId: '<column-GUID>' },
+     *     applicability: { level: 'TAB', targetId: '<tab-GUID>' }
+     * });
+     * ```
+     * @example
+     * ```js
      * // Open filter from search context
      * import { ContextType } from '@thoughtspot/visual-embed-sdk';
      * searchEmbed.trigger(HostEvent.OpenFilter, {
@@ -4157,6 +4424,38 @@ export declare enum HostEvent {
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
     OpenFilter = "openFilter",
+    /**
+     * Open the parameter panel for a particular parameter on a Liveboard.
+     * Mirrors {@link HostEvent.OpenFilter} for parameters.
+     * @param - Includes the following keys:
+     * - `parameter`: An object identifying the parameter to open, for
+     *   example, `{ parameterId: '<parameter-GUID>' }`.
+     * - `applicability`: Optional. Scopes the parameter to a specific target,
+     *   for example, a single Liveboard tab, so the panel for the correct
+     *   scoped parameter is opened. Includes the following attributes:
+     *
+     *    - `level`: The scope of the parameter: `LIVEBOARD`, `TAB`, or `GROUP`.
+     *    - `targetId`: The GUID of the target, for example, the tab GUID.
+     *      Required when `level` is `TAB` or `GROUP`. Do not pass it when
+     *      `level` is `LIVEBOARD`, since the parameter applies to the whole
+     *      Liveboard. Omitting `applicability` targets the `LIVEBOARD` level.
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.OpenParameter, {
+     *     parameter: { parameterId: '<parameter-GUID>' }
+     * });
+     * ```
+     * @example
+     * ```js
+     * // Open a parameter scoped to a specific group
+     * liveboardEmbed.trigger(HostEvent.OpenParameter, {
+     *     parameter: { parameterId: '<parameter-GUID>' },
+     *     applicability: { level: 'GROUP', targetId: '<group-GUID>' }
+     * });
+     * ```
+     * @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
+     */
+    OpenParameter = "openParameter",
     /**
      * Add columns to the current search query.
      * @param - { columnIds: string[] }
@@ -5220,6 +5519,14 @@ export declare enum HostEvent {
     /**
      * Get details of filters applied on the Liveboard.
      * Returns arrays containing Liveboard filter and runtime filter elements.
+     * Each Liveboard filter includes an optional `applicability` attribute
+     * indicating the scope of the filter. It contains a `level`
+     * (`LIVEBOARD`, `TAB`, or `GROUP`) and, when `level` is `TAB` or
+     * `GROUP`, a `targetId` with the GUID of the target. At `LIVEBOARD`
+     * level there is no `targetId`, since the filter applies to the
+     * whole Liveboard.
+     * The `applicability` attribute is available from SDK: 1.53.0 |
+     * ThoughtSpot: 26.10.0.cl.
      * @example
      * ```js
      * const data = await liveboardEmbed.trigger(HostEvent.GetFilters);
@@ -5259,6 +5566,16 @@ export declare enum HostEvent {
      *
      * `type`  - To update filters for date time, specify the date format type.
      * For more information and examples, see link:https://developers.thoughtspot.com/docs/embed-liveboard#_date_filters[Date filters].
+     *
+     * `applicability` - Optional. Scopes the filter to a specific target,
+     * for example, a single Liveboard tab. Available from SDK: 1.53.0 |
+     * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
+     *
+     *  - `level`: The scope of the filter: `LIVEBOARD`, `TAB`, or `GROUP`.
+     *  - `targetId`: The GUID of the target, for example, the tab GUID.
+     *    Required when `level` is `TAB` or `GROUP`. Do not pass it when
+     *    `level` is `LIVEBOARD`, since the filter applies to the whole
+     *    Liveboard.
      * @example
      * ```js
      *
@@ -5335,6 +5652,21 @@ export declare enum HostEvent {
      *     }
      * }, ContextType.Liveboard);
      * ```
+     * @example
+     * ```js
+     * // Scope the filter to a specific Liveboard tab
+     * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
+     *     filter: {
+     *         column: "item type",
+     *         oper: "IN",
+     *         values: ["bags", "shirts"],
+     *         applicability: {
+     *             level: "TAB",
+     *             targetId: "e0836cad-4fdf-42d4-bd97-567a6b2a6058"
+     *         }
+     *     }
+     * });
+     * ```
      * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
      */
     UpdateFilters = "updateFilters",
@@ -5359,6 +5691,28 @@ export declare enum HostEvent {
      * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl
      */
     GetTabs = "getTabs",
+    /**
+     * Get group details for the current Liveboard.
+     * Mirrors {@link HostEvent.GetTabs} for filter/parameter groups.
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.GetGroups).then((groupDetails) => {
+     *   console.log(
+     *      groupDetails // GroupDetails of current Liveboard
+     *   );
+     * })
+     * ```
+     * @example
+     * ```js
+     * // Get groups from liveboard context
+     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
+     * liveboardEmbed.trigger(HostEvent.GetGroups, {}, ContextType.Liveboard).then((groupDetails) => {
+     *     console.log('groups', groupDetails);
+     * });
+     * ```
+     * @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
+     */
+    GetGroups = "getGroups",
     /**
      * Set the visible tabs on a Liveboard.
      * @param - an array of ids of tabs to show, the IDs not passed
@@ -5486,6 +5840,15 @@ export declare enum HostEvent {
      * - `name`: Name of the parameter.
      * - `value`: The value to set for the parameter.
      * - `isVisibleToUser`: Optional. To control the visibility of the parameter chip.
+     * - `applicability`: Optional. Scopes the parameter to a specific target,
+     * for example, a single Liveboard tab. Available from SDK: 1.53.0 |
+     * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
+     *
+     *    - `level`: The scope of the parameter: `LIVEBOARD`, `TAB`, or `GROUP`.
+     *    - `targetId`: The GUID of the target, for example, the tab GUID.
+     *      Required when `level` is `TAB` or `GROUP`. Do not pass it when
+     *      `level` is `LIVEBOARD`, since the parameter applies to the whole
+     *      Liveboard.
      *
      * @example
      * ```js
@@ -5497,6 +5860,18 @@ export declare enum HostEvent {
      * ```
      * @example
      * ```js
+     * // Scope the parameter to a specific Liveboard tab
+     * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
+     *   name: "Integer Range Param",
+     *   value: 10,
+     *   applicability: {
+     *     level: "TAB",
+     *     targetId: "e0836cad-4fdf-42d4-bd97-567a6b2a6058"
+     *   }
+     * }])
+     * ```
+     * @example
+     * ```js
      * // Update parameters from liveboard context
      * import { ContextType } from '@thoughtspot/visual-embed-sdk';
      * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
@@ -5510,6 +5885,14 @@ export declare enum HostEvent {
     UpdateParameters = "UpdateParameters",
     /**
      * Triggers GetParameters to fetch the runtime Parameters.
+     * Each parameter includes an optional `applicability` attribute
+     * indicating the scope of the parameter. It contains a `level`
+     * (`LIVEBOARD`, `TAB`, or `GROUP`) and, when `level` is `TAB` or
+     * `GROUP`, a `targetId` with the GUID of the target. At `LIVEBOARD`
+     * level there is no `targetId`, since the parameter applies to the
+     * whole Liveboard.
+     * The `applicability` attribute is available from SDK: 1.53.0 |
+     * ThoughtSpot: 26.10.0.cl.
      * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
      * ```js
      * liveboardEmbed.trigger(HostEvent.GetParameters).then((parameter) => {
@@ -5776,6 +6159,36 @@ export declare enum HostEvent {
      * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
      */
     ResetSpotterConversation = "ResetSpotterConversation",
+    /**
+     * Opens the Spotter share-conversation modal for the given conversation.
+     * `conversationId` is **mandatory** — you must pass the id of the
+     * conversation to share. Also no-op when sharing is disabled
+     * (enableShareConversation off) or when already in the read-only shared view.
+     * @example
+     * ```js
+     * spotterEmbed.trigger(HostEvent.ShareSpotterConversation, { conversationId: 'abc' });
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    ShareSpotterConversation = "ShareSpotterConversation",
+    /**
+     * Closes the Spotter share-conversation modal. No-op if none is open.
+     * @example
+     * ```js
+     * spotterEmbed.trigger(HostEvent.CloseSpotterShareConversation);
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    CloseSpotterShareConversation = "CloseSpotterShareConversation",
+    /**
+     * Exits the read-only shared-conversation view.
+     * @example
+     * ```js
+     * spotterEmbed.trigger(HostEvent.ExitSpotterSharedConversation);
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    ExitSpotterSharedConversation = "ExitSpotterSharedConversation",
     /**
      * Deletes the last prompt in spotter embed.
      * @example
@@ -5871,6 +6284,41 @@ export declare enum HostEvent {
      * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
      */
     StartNewSpotterConversation = "StartNewSpotterConversation",
+    /**
+     * Pins a saved Spotter conversation so it floats to the top of the past
+     * conversations sidebar. The `conversationId` of the conversation to pin is
+     * required.
+     *
+     * This feature is available only when chat history is enabled on your ThoughtSpot
+     * instance. Contact your admin or ThoughtSpot Support to enable chat history on your
+     * instance.
+     *
+     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+     * @example
+     * ```js
+     * spotterEmbed.trigger(HostEvent.PinSpotterConversation, {
+     *     conversationId: '<conversation-id>',
+     * });
+     * ```
+     */
+    PinSpotterConversation = "PinSpotterConversation",
+    /**
+     * Unpins a previously pinned Spotter conversation. The `conversationId` of the
+     * conversation to unpin is required.
+     *
+     * This feature is available only when chat history is enabled on your ThoughtSpot
+     * instance. Contact your admin or ThoughtSpot Support to enable chat history on your
+     * instance.
+     *
+     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+     * @example
+     * ```js
+     * spotterEmbed.trigger(HostEvent.UnpinSpotterConversation, {
+     *     conversationId: '<conversation-id>',
+     * });
+     * ```
+     */
+    UnpinSpotterConversation = "UnpinSpotterConversation",
     /**
      * @hidden
      * Get the current context of the embedded page.
@@ -6084,6 +6532,7 @@ export declare enum Param {
     SpotterEnabled = "isSpotterExperienceEnabled",
     IsUnifiedSearchExperienceEnabled = "isUnifiedSearchExperienceEnabled",
     OverrideOrgId = "orgId",
+    OverrideHistoryState = "overrideHistoryState",
     OauthPollingInterval = "oAuthPollingInterval",
     IsForceRedirect = "isForceRedirect",
     DataSourceId = "dataSourceId",
@@ -6101,9 +6550,12 @@ export declare enum Param {
     isGranularXLSXCSVSchedulesEnabled = "isGranularXLSXCSVSchedulesEnabled",
     isSendNowLiveboardSchedulingEnabled = "isSendNowLiveboardSchedulingEnabled",
     isCentralizedLiveboardFilterUXEnabled = "isCentralizedLiveboardFilterUXEnabled",
+    isScopedLiveboardFilteringEnabled = "isScopedLiveboardFilteringEnabled",
     isLinkParametersEnabled = "isLinkParametersEnabled",
     EnablePastConversationsSidebar = "enablePastConversationsSidebar",
     UpdatedSpotterChatPrompt = "updatedSpotterChatPrompt",
+    ShowSpotterRadiance = "showSpotterRadiance",
+    DefaultQueryMode = "defaultQueryMode",
     EnableStopAnswerGenerationEmbed = "enableStopAnswerGenerationEmbed",
     SpotterSidebarTitle = "spotterSidebarTitle",
     SpotterSidebarDefaultExpanded = "spotterSidebarDefaultExpanded",
@@ -6122,7 +6574,9 @@ export declare enum Param {
     EnableLiveboardDataCache = "enableLiveboardDataCache",
     SpotterFileUploadEnabled = "spotterFileUploadEnabled",
     SpotterFileUploadFileTypes = "spotterFileUploadFileTypes",
-    IsStarterPromptsEnabled = "enableStarterPrompts"
+    IsStarterPromptsEnabled = "enableStarterPrompts",
+    UpdatedSpotterExperience = "updatedSpotterExperience",
+    SpotterDataSources = "spotterDataSources"
 }
 /**
  * Configuration for allowed file types in Spotter file upload.
@@ -7391,6 +7845,19 @@ export declare enum Action {
      *  @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
      */
     ChangeFilterVisibilityInTab = "changeFilterVisibilityInTab",
+    /**
+     * Action ID to show, hide, or disable all filter surfaces on a Liveboard,
+     * including filter, parameter, and cross-filter chips at the liveboard,
+     * tab, and group levels. Parameter and cross-filter chips are hide-only.
+     *
+     *  @example
+     * ```js
+     * hiddenActions: [Action.AllLiveboardFilters]
+     * disabledActions: [Action.AllLiveboardFilters]
+     * ```
+     *  @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
+     */
+    AllLiveboardFilters = "allLiveboardFilters",
     /**
      * The **Data model instructions** button on the Spotter interface.
      * Allows opening the data model instructions modal.
@@ -7726,6 +8193,89 @@ export declare enum Action {
      * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
      */
     SpotterChatRename = "spotterChatRename",
+    /**
+     * Controls visibility and disable state of the Spotter conversation Share
+     * button in the chat header. Only takes effect once sharing is enabled
+     * (enableShareConversation on).
+     * @example
+     * ```js
+     * disabledActions: [Action.SpotterShareConversationButtonHeader]
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareConversationButtonHeader = "spotterShareConversationButtonHeader",
+    /**
+     * Controls visibility and disable state of the Share item in the Spotter
+     * conversation history (sidebar) edit menu. Independent of the header button
+     * above, so a host can show Share in one entry point and hide it in the other.
+     * @example
+     * ```js
+     * disabledActions: [Action.SpotterShareConversationMenuItemSidebar]
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareConversationMenuItemSidebar = "spotterShareConversationMenuItemSidebar",
+    /**
+     * Controls visibility of the entire read-only shared-conversation data-access
+     * banner shown when a recipient opens a shared view. Hide-only.
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterSharedConversationBanner]
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterSharedConversationBanner = "spotterSharedConversationBanner",
+    /**
+     * Controls visibility and disable state of the cross/close button on the
+     * read-only shared-conversation data-access banner (keeps the banner itself).
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterSharedConversationBannerDismissButton]
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterSharedConversationBannerDismissButton = "spotterSharedConversationBannerDismissButton",
+    /**
+     * Controls visibility and disable state of the Exit button in the read-only
+     * shared-view header. Hiding it does not disable the ExitSpotterSharedConversation
+     * host event.
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterSharedConversationExitButton]
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterSharedConversationExitButton = "spotterSharedConversationExitButton",
+    /**
+     * Controls visibility of the share-modal footer note ("Chat will be shared up
+     * to the current moment…"). Hide-only.
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterShareUpToCurrentInfo]
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareUpToCurrentInfo = "spotterShareUpToCurrentInfo",
+    /**
+     * Controls visibility and disable state of the share-modal "include new
+     * messages since last shared version" checkbox.
+     * @example
+     * ```js
+     * disabledActions: [Action.SpotterShareIncludeNewMessagesCheckbox]
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareIncludeNewMessagesCheckbox = "spotterShareIncludeNewMessagesCheckbox",
+    /**
+     * Controls visibility and disable state of the cross on the share-modal
+     * stale-snapshot info banner.
+     * @example
+     * ```js
+     * hiddenActions: [Action.SpotterShareStaleInfoBannerDismissButton]
+     * ```
+     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
+     */
+    SpotterShareStaleInfoBannerDismissButton = "spotterShareStaleInfoBannerDismissButton",
     /**
      * Controls visibility and disable state of the delete action
      * in the Spotter conversation edit menu.
@@ -7736,6 +8286,16 @@ export declare enum Action {
      * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
      */
     SpotterChatDelete = "spotterChatDelete",
+    /**
+     * Controls visibility and disable state of the pin/unpin action
+     * in the Spotter conversation edit menu.
+     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
+     * @example
+     * ```js
+     * disabledActions: [Action.SpotterChatPin]
+     * ```
+     */
+    SpotterChatPin = "spotterChatPin",
     /**
      * Controls visibility and disable state of the documentation/best practices
      * link in the Spotter sidebar footer.
@@ -8267,7 +8827,9 @@ export declare enum EmbedErrorCodes {
     /** 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"
+    DRILLDOWN_INVALID_PAYLOAD = "DRILLDOWN_INVALID_PAYLOAD",
+    /** UpdateParameters payload is invalid - malformed applicability */
+    UPDATEPARAMETERS_INVALID_PAYLOAD = "UPDATEPARAMETERS_INVALID_PAYLOAD"
 }
 /**
  * Error event object emitted when an error occurs in an embedded component.