@thoughtspot/visual-embed-sdk 1.50.0 → 1.51.0

package/src/types.ts

@@ -176,7 +176,9 @@ export 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.
  *
  */
 
@@ -244,6 +246,13 @@ export enum HomeLeftNavItem {
      * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
      */
     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;
 
@@ -1220,6 +1229,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.
@@ -1590,7 +1619,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
@@ -1599,7 +1630,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
      * })
@@ -1610,8 +1641,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
@@ -1620,7 +1654,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
      * })
@@ -1632,7 +1666,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
@@ -2010,6 +2046,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.
      *
@@ -2226,7 +2280,9 @@ export 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
  */
 
@@ -3223,11 +3279,19 @@ export 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
@@ -3419,9 +3483,17 @@ export 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
@@ -3723,6 +3795,158 @@ export 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
@@ -3736,6 +3960,31 @@ export enum EmbedEvent {
      */
     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.
@@ -4227,6 +4476,17 @@ export 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,
@@ -4239,6 +4499,14 @@ export 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, {
@@ -4248,6 +4516,38 @@ export 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[] }
@@ -5312,6 +5612,14 @@ export 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);
@@ -5351,6 +5659,16 @@ export 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
      *
@@ -5427,6 +5745,21 @@ export 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',
@@ -5451,6 +5784,28 @@ export 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
@@ -5578,6 +5933,15 @@ export 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
@@ -5589,6 +5953,18 @@ export 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, [{
@@ -5602,6 +5978,14 @@ export 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) => {
@@ -5868,6 +6252,36 @@ export 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
@@ -5965,6 +6379,43 @@ export enum HostEvent {
      */
     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.
@@ -6193,6 +6644,7 @@ export enum Param {
     SpotterEnabled = 'isSpotterExperienceEnabled',
     IsUnifiedSearchExperienceEnabled = 'isUnifiedSearchExperienceEnabled',
     OverrideOrgId = 'orgId',
+    OverrideHistoryState = 'overrideHistoryState',
     OauthPollingInterval = 'oAuthPollingInterval',
     IsForceRedirect = 'isForceRedirect',
     DataSourceId = 'dataSourceId',
@@ -6210,9 +6662,12 @@ export 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',
@@ -6232,6 +6687,8 @@ export enum Param {
     SpotterFileUploadEnabled = 'spotterFileUploadEnabled',
     SpotterFileUploadFileTypes = 'spotterFileUploadFileTypes',
     IsStarterPromptsEnabled = 'enableStarterPrompts',
+    UpdatedSpotterExperience = 'updatedSpotterExperience',
+    SpotterDataSources = 'spotterDataSources',
 }
 
 /**
@@ -7522,6 +7979,20 @@ export enum Action {
      */
     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.
@@ -7859,6 +8330,89 @@ export 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.
@@ -7869,6 +8423,16 @@ export 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.
@@ -8436,6 +9000,9 @@ export enum EmbedErrorCodes {
 
     /** DrillDown payload is invalid - missing or malformed points */
     DRILLDOWN_INVALID_PAYLOAD = 'DRILLDOWN_INVALID_PAYLOAD',
+
+    /** UpdateParameters payload is invalid - malformed applicability */
+    UPDATEPARAMETERS_INVALID_PAYLOAD = 'UPDATEPARAMETERS_INVALID_PAYLOAD',
 }
 
 /**