@gooddata/sdk-pluggable-application-model 11.42.0-alpha.3 → 11.42.0-alpha.4

package/esm/__version.js

@@ -1,7 +1,7 @@
 // (C) 2026 GoodData Corporation
 // DO NOT CHANGE THIS FILE, IT IS RE-GENERATED ON EVERY BUILD
 /** @alpha */
-export const LIB_VERSION = "11.42.0-alpha.3";
+export const LIB_VERSION = "11.42.0-alpha.4";
 /** @alpha */
 export const LIB_DESCRIPTION = "GoodData SDK model contracts for pluggable applications";
 /** @alpha */

package/esm/hostUi.d.ts

@@ -1,4 +1,4 @@
-import { type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
+import { type IGenAIUserContext, type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
 import { type IAppHeaderOptions } from "./mount.js";
 import { type IPlatformContext } from "./platformContext.js";
 /**
@@ -44,6 +44,15 @@ export interface IHostUiMountOptions {
      * entry instead of pushing a new one.
      */
     replace: (url: string) => void;
+    /**
+     * Reports the host-owned AI assistant chat open-state whenever it changes.
+     *
+     * @remarks
+     * The host UI owns the single chat instance on hosted routes; the host runtime forwards this
+     * open-state to the active pluggable application (via its mount handle) so app-side assistant
+     * controls stay aligned with what the user sees.
+     */
+    onAiAssistantOpenChange?: (open: boolean) => void;
 }
 /**
  * Notification dispatched when the host runtime detects that a newer build of the host
@@ -68,6 +77,61 @@ export interface INewDeploymentAvailableHostUiNotification {
      */
     commitHash: string;
 }
+/**
+ * Notification requesting the host UI to open its AI assistant chat.
+ *
+ * @remarks
+ * Emitted when the active pluggable application requests the assistant (see
+ * `IOpenAiAssistantRequestedEvent`). The host UI owns the single chat instance on
+ * hosted-application routes and opens it, optionally seeded with a question and user context.
+ *
+ * @alpha
+ */
+export interface IOpenAiAssistantHostUiNotification {
+    type: "openAiAssistant";
+    /**
+     * Question to seed the chat with. When omitted, the chat just opens.
+     */
+    question?: string;
+    /**
+     * Context of the user's current location (e.g. the active dashboard), passed to the
+     * assistant alongside the seeded question.
+     */
+    userContext?: IGenAIUserContext;
+}
+/**
+ * Notification requesting the host UI to close its AI assistant chat.
+ *
+ * @remarks
+ * Emitted when the active pluggable application closes the assistant from one of its own controls
+ * (see `ICloseAiAssistantRequestedEvent`). The host UI closes its single chat instance.
+ *
+ * @alpha
+ */
+export interface ICloseAiAssistantHostUiNotification {
+    type: "closeAiAssistant";
+}
+/**
+ * Notification informing the host UI of the active application's current AI-assistant tag scope.
+ *
+ * @remarks
+ * Emitted when the active pluggable application's tag scope changes (see
+ * `IAiAssistantContextChangedEvent`). The host UI keeps the latest scope and applies it to its
+ * chat so the assistant's object search stays within the same scope the application enforces.
+ *
+ * @alpha
+ */
+export interface IAiAssistantContextHostUiNotification {
+    type: "aiAssistantContext";
+    /**
+     * Tag identifiers the assistant's object search should be restricted to.
+     */
+    includeTags?: string[];
+    /**
+     * Tag identifiers the assistant's object search should exclude.
+     */
+    excludeTags?: string[];
+}
 /**
  * Discriminated union of out-of-band notifications the host runtime can push into the
  * host UI module after mount. Lets the runtime signal events that should affect the UI
@@ -80,7 +144,7 @@ export interface INewDeploymentAvailableHostUiNotification {
  *
  * @alpha
  */
-export type IHostUiNotification = INewDeploymentAvailableHostUiNotification;
+export type IHostUiNotification = INewDeploymentAvailableHostUiNotification | IOpenAiAssistantHostUiNotification | ICloseAiAssistantHostUiNotification | IAiAssistantContextHostUiNotification;
 /**
  * Handle returned from a host UI mount for lifecycle management.
  *

package/esm/hostUi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostUi.d.ts","sourceRoot":"","sources":["../src/hostUi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,SAAS,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,GAAG,EAAE,gBAAgB,CAAC;IAEtB;;OAEG;IACH,oBAAoB,EAAE,gCAAgC,EAAE,CAAC;IAEzD;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;;OAOG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yCAAyC;IACtD;;;;OAIG;IACH,IAAI,EAAE,wBAAwB,CAAC;IAC/B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG,yCAAyC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;;;;OAKG;IACH,aAAa,CAAC,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE5C;;;;;OAKG;IACH,kBAAkB,CAAC,CAAC,IAAI,EAAE,gCAAgC,EAAE,GAAG,IAAI,CAAC;IAEpE;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC;;;;;;;;OAQG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;IAE3D;;;;;;;;OAQG;IACH,mBAAmB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAE1D;;;;;;;OAOG;IACH,eAAe,IAAI,WAAW,CAAC;IAE/B;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACpD;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,kBAAkB,CAAC;AAE/E;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,WAAW,CAAC;CACtB"}
+{"version":3,"file":"hostUi.d.ts","sourceRoot":"","sources":["../src/hostUi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAEpG,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,SAAS,EAAE,WAAW,CAAC;IAEvB;;OAEG;IACH,GAAG,EAAE,gBAAgB,CAAC;IAEtB;;OAEG;IACH,oBAAoB,EAAE,gCAAgC,EAAE,CAAC;IAEzD;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;;OAOG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/B;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yCAAyC;IACtD;;;;OAIG;IACH,IAAI,EAAE,wBAAwB,CAAC;IAC/B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kCAAkC;IAC/C,IAAI,EAAE,iBAAiB,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,mCAAmC;IAChD,IAAI,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qCAAqC;IAClD,IAAI,EAAE,oBAAoB,CAAC;IAC3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GACzB,yCAAyC,GACzC,kCAAkC,GAClC,mCAAmC,GACnC,qCAAqC,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB;;;;;OAKG;IACH,aAAa,CAAC,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE5C;;;;;OAKG;IACH,kBAAkB,CAAC,CAAC,IAAI,EAAE,gCAAgC,EAAE,GAAG,IAAI,CAAC;IAEpE;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC;;;;;;;;OAQG;IACH,YAAY,CAAC,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,IAAI,CAAC;IAE3D;;;;;;;;OAQG;IACH,mBAAmB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAE1D;;;;;;;OAOG;IACH,eAAe,IAAI,WAAW,CAAC;IAE/B;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACpD;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,kBAAkB,CAAC;AAE/E;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,WAAW,CAAC;CACtB"}

package/esm/index.d.ts

@@ -7,6 +7,6 @@ export { DefaultApplicationId } from "./defaultPlatformApplications.js";
 export { LIB_VERSION, LIB_DESCRIPTION, LIB_NAME } from "./__version.js";
 export { type EmbeddingMode, type IApiTokenAuthCredentials, type IAuthCredentials, type IContextDeferredAuthCredentials, type IEffectiveSettings, type IJwtAuthCredentials, type IOrganization, type IOrganizationPermissions, type IPlatformContext, type IPlatformContextV1, type IPluggableApplicationNavigation, PantherTier, isPlatformContextV1, isWorkspaceScopedSettings, } from "./platformContext.js";
 export { type ILocale } from "@gooddata/sdk-model";
-export { type IAppHeaderOptions, type IAppInstance, type KnownPluggableAppEventTypeName, type IDocumentTitleChangedEvent, type IPluggableApp, type IPluggableApplicationMountHandle, type IPluggableApplicationMountOptions, type IPluggableAppEvent, type IPluggableAppTelemetryCallbacks, type IReloadPlatformContextRequestedEvent, type ITelemetryEventOptions, documentTitleChanged, isDocumentTitleChangedEvent, isReloadPlatformContextRequestedEvent, type PluggableApplicationMount, PluggableAppEventType, type PluggableAppEventTypeName, reloadPlatformContextRequested, type TelemetryChannel, } from "./mount.js";
-export { type IHostUiModule, type IHostUiMountHandle, type IHostUiMountOptions, type IHostUiNotification, type INewDeploymentAvailableHostUiNotification, type HostUiMount, } from "./hostUi.js";
+export { type IAppHeaderOptions, type IAppInstance, type KnownPluggableAppEventTypeName, type IDocumentTitleChangedEvent, type IOpenAiAssistantRequestedEvent, type ICloseAiAssistantRequestedEvent, type IAiAssistantContextChangedEvent, type IPluggableApp, type IPluggableApplicationMountHandle, type IPluggableApplicationMountOptions, type IPluggableAppEvent, type IPluggableAppTelemetryCallbacks, type IReloadPlatformContextRequestedEvent, type ITelemetryEventOptions, documentTitleChanged, isDocumentTitleChangedEvent, isOpenAiAssistantRequestedEvent, isCloseAiAssistantRequestedEvent, isAiAssistantContextChangedEvent, isReloadPlatformContextRequestedEvent, openAiAssistantRequested, closeAiAssistantRequested, aiAssistantContextChanged, type PluggableApplicationMount, PluggableAppEventType, type PluggableAppEventTypeName, reloadPlatformContextRequested, type TelemetryChannel, } from "./mount.js";
+export { type IHostUiModule, type IHostUiMountHandle, type IHostUiMountOptions, type IHostUiNotification, type INewDeploymentAvailableHostUiNotification, type IOpenAiAssistantHostUiNotification, type ICloseAiAssistantHostUiNotification, type IAiAssistantContextHostUiNotification, type HostUiMount, } from "./hostUi.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,WAAW,EACX,mBAAmB,EACnB,yBAAyB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EAClB,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,EACtC,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,KAAK,oCAAoC,EACzC,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,qCAAqC,EACrC,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,8BAA8B,EAC9B,KAAK,gBAAgB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,yCAAyC,EAC9C,KAAK,WAAW,GACnB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,WAAW,EACX,mBAAmB,EACnB,yBAAyB,GAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,8BAA8B,EACnC,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACpC,KAAK,aAAa,EAClB,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,EACtC,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,KAAK,oCAAoC,EACzC,KAAK,sBAAsB,EAC3B,oBAAoB,EACpB,2BAA2B,EAC3B,+BAA+B,EAC/B,gCAAgC,EAChC,gCAAgC,EAChC,qCAAqC,EACrC,wBAAwB,EACxB,yBAAyB,EACzB,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,8BAA8B,EAC9B,KAAK,gBAAgB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,yCAAyC,EAC9C,KAAK,kCAAkC,EACvC,KAAK,mCAAmC,EACxC,KAAK,qCAAqC,EAC1C,KAAK,WAAW,GACnB,MAAM,aAAa,CAAC"}

package/esm/index.js

@@ -8,4 +8,4 @@
 export { DefaultApplicationId } from "./defaultPlatformApplications.js";
 export { LIB_VERSION, LIB_DESCRIPTION, LIB_NAME } from "./__version.js";
 export { PantherTier, isPlatformContextV1, isWorkspaceScopedSettings, } from "./platformContext.js";
-export { documentTitleChanged, isDocumentTitleChangedEvent, isReloadPlatformContextRequestedEvent, PluggableAppEventType, reloadPlatformContextRequested, } from "./mount.js";
+export { documentTitleChanged, isDocumentTitleChangedEvent, isOpenAiAssistantRequestedEvent, isCloseAiAssistantRequestedEvent, isAiAssistantContextChangedEvent, isReloadPlatformContextRequestedEvent, openAiAssistantRequested, closeAiAssistantRequested, aiAssistantContextChanged, PluggableAppEventType, reloadPlatformContextRequested, } from "./mount.js";

package/esm/mount.d.ts

@@ -1,3 +1,4 @@
+import { type IGenAIUserContext } from "@gooddata/sdk-model";
 import { type IPlatformContext } from "./platformContext.js";
 /**
  * Known generic pluggable application event types.
@@ -7,6 +8,9 @@ import { type IPlatformContext } from "./platformContext.js";
 export declare const PluggableAppEventType: {
     readonly RELOAD_PLATFORM_CONTEXT_REQUESTED: "GDC.PLUGGABLE_APP/EVT.RELOAD_PLATFORM_CONTEXT.REQUESTED";
     readonly DOCUMENT_TITLE_CHANGED: "GDC.PLUGGABLE_APP/EVT.DOCUMENT_TITLE.CHANGED";
+    readonly AI_ASSISTANT_OPEN_REQUESTED: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.OPEN_REQUESTED";
+    readonly AI_ASSISTANT_CLOSE_REQUESTED: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CLOSE_REQUESTED";
+    readonly AI_ASSISTANT_CONTEXT_CHANGED: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CONTEXT_CHANGED";
 };
 /**
  * Union of known pluggable application event type names.
@@ -91,6 +95,121 @@ export declare function documentTitleChanged(pageTitle: string | undefined): IDo
  * @alpha
  */
 export declare function isDocumentTitleChangedEvent(obj: unknown): obj is IDocumentTitleChangedEvent;
+/**
+ * Event requesting the host to open its AI assistant chat.
+ *
+ * @remarks
+ * The host shell owns the AI assistant on hosted-application routes — a pluggable application must
+ * not render its own chat dialog there (two assistants would overlay each other and a duplicate
+ * could auto-open from the shared open-state, see LX-2544). Instead, its in-content entry points
+ * (e.g. a "Summarize" action) emit this event and the host opens its chat, optionally seeded with a
+ * question and the user's location context. Tag scoping for the assistant's object search is carried
+ * separately via {@link IAiAssistantContextChangedEvent}, which reflects the app's current view.
+ *
+ * @alpha
+ */
+export interface IOpenAiAssistantRequestedEvent extends IPluggableAppEvent {
+    readonly type: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.OPEN_REQUESTED";
+    readonly payload: {
+        /**
+         * Question to seed the chat with. When omitted, the chat just opens.
+         */
+        readonly question?: string;
+        /**
+         * Context of the user's current location (e.g. the active dashboard and its widgets),
+         * passed to the assistant alongside the seeded question.
+         */
+        readonly userContext?: IGenAIUserContext;
+    };
+}
+/**
+ * Creates an {@link IOpenAiAssistantRequestedEvent}.
+ *
+ * @alpha
+ */
+export declare function openAiAssistantRequested(payload?: {
+    question?: string;
+    userContext?: IGenAIUserContext;
+}): IOpenAiAssistantRequestedEvent;
+/**
+ * Type guard for {@link IOpenAiAssistantRequestedEvent}.
+ *
+ * @remarks
+ * Validates the payload shape too (not just the type), so a malformed event — e.g. one emitted
+ * from JS or a mismatched remote module — is rejected rather than narrowed to a type whose later
+ * `payload.question` access would throw.
+ *
+ * @alpha
+ */
+export declare function isOpenAiAssistantRequestedEvent(obj: unknown): obj is IOpenAiAssistantRequestedEvent;
+/**
+ * Event requesting the host to close its AI assistant chat.
+ *
+ * @remarks
+ * Counterpart to {@link IOpenAiAssistantRequestedEvent}. A pluggable application emits this when one
+ * of its in-content controls toggles the assistant closed (e.g. an embedded AI button), so the
+ * host-owned chat closes in step with the application.
+ *
+ * @alpha
+ */
+export interface ICloseAiAssistantRequestedEvent extends IPluggableAppEvent {
+    readonly type: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CLOSE_REQUESTED";
+}
+/**
+ * Creates an {@link ICloseAiAssistantRequestedEvent}.
+ *
+ * @alpha
+ */
+export declare function closeAiAssistantRequested(): ICloseAiAssistantRequestedEvent;
+/**
+ * Type guard for {@link ICloseAiAssistantRequestedEvent}.
+ *
+ * @alpha
+ */
+export declare function isCloseAiAssistantRequestedEvent(obj: unknown): obj is ICloseAiAssistantRequestedEvent;
+/**
+ * Event informing the host of the active application's current AI-assistant tag scope.
+ *
+ * @remarks
+ * A hosted application can constrain its catalog to objects tagged in a certain way (e.g. AD's
+ * `includeObjectsWithTags` route filter). Because the host owns the single chat instance on hosted
+ * routes, the application forwards its current tag scope through this event so the host assistant's
+ * object search/autocomplete stays within the same scope the rest of the application enforces.
+ * The host keeps the latest reported scope and clears it (empty arrays / omitted) when the
+ * application no longer constrains its catalog.
+ *
+ * @alpha
+ */
+export interface IAiAssistantContextChangedEvent extends IPluggableAppEvent {
+    readonly type: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CONTEXT_CHANGED";
+    readonly payload: {
+        /**
+         * Tag identifiers the assistant's object search should be restricted to. Empty/omitted
+         * means no include filter.
+         */
+        readonly includeTags?: string[];
+        /**
+         * Tag identifiers the assistant's object search should exclude. Empty/omitted means no
+         * exclude filter.
+         */
+        readonly excludeTags?: string[];
+    };
+}
+/**
+ * Creates an {@link IAiAssistantContextChangedEvent}.
+ *
+ * @alpha
+ */
+export declare function aiAssistantContextChanged(payload?: {
+    includeTags?: string[];
+    excludeTags?: string[];
+}): IAiAssistantContextChangedEvent;
+/**
+ * Type guard for {@link IAiAssistantContextChangedEvent}.
+ *
+ * @alpha
+ */
+export declare function isAiAssistantContextChangedEvent(obj: unknown): obj is IAiAssistantContextChangedEvent;
 /**
  * Telemetry channel determines which analytics pipeline receives the event.
  *
@@ -244,6 +363,17 @@ export interface IPluggableApplicationMountHandle {
      * Host uses this to push down context changes after initial mount.
      */
     updateContext?: (ctx: IPlatformContext) => void;
+    /**
+     * Pushes the host-owned AI assistant chat open-state into the pluggable application.
+     *
+     * @remarks
+     * On hosted routes the host owns the single chat instance; an application that exposes its own
+     * assistant controls (e.g. an embedded AI button, or the `toggleAIAssistant` postMessage command
+     * whose result is echoed to an embedding client) needs to know the real open-state to keep those
+     * controls and their reported results aligned with what the user sees. The host calls this
+     * whenever its chat opens or closes. Applications without such controls may omit it.
+     */
+    setAiAssistantOpen?: (open: boolean) => void;
 }
 /**
  * Pluggable application mount function signature.

package/esm/mount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"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"}

package/esm/mount.js

@@ -7,6 +7,9 @@
 export const PluggableAppEventType = {
     RELOAD_PLATFORM_CONTEXT_REQUESTED: "GDC.PLUGGABLE_APP/EVT.RELOAD_PLATFORM_CONTEXT.REQUESTED",
     DOCUMENT_TITLE_CHANGED: "GDC.PLUGGABLE_APP/EVT.DOCUMENT_TITLE.CHANGED",
+    AI_ASSISTANT_OPEN_REQUESTED: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.OPEN_REQUESTED",
+    AI_ASSISTANT_CLOSE_REQUESTED: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CLOSE_REQUESTED",
+    AI_ASSISTANT_CONTEXT_CHANGED: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CONTEXT_CHANGED",
 };
 /**
  * Creates an {@link IReloadPlatformContextRequestedEvent}.
@@ -58,3 +61,83 @@ export function isDocumentTitleChangedEvent(obj) {
     const pageTitle = payload.pageTitle;
     return typeof pageTitle === "string" || pageTitle === undefined;
 }
+/**
+ * Creates an {@link IOpenAiAssistantRequestedEvent}.
+ *
+ * @alpha
+ */
+export function openAiAssistantRequested(payload) {
+    return { type: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.OPEN_REQUESTED", payload: payload ?? {} };
+}
+/**
+ * Type guard for {@link IOpenAiAssistantRequestedEvent}.
+ *
+ * @remarks
+ * Validates the payload shape too (not just the type), so a malformed event — e.g. one emitted
+ * from JS or a mismatched remote module — is rejected rather than narrowed to a type whose later
+ * `payload.question` access would throw.
+ *
+ * @alpha
+ */
+export function isOpenAiAssistantRequestedEvent(obj) {
+    if (typeof obj !== "object" ||
+        obj === null ||
+        obj.type !== "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.OPEN_REQUESTED") {
+        return false;
+    }
+    const payload = obj.payload;
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+        return false;
+    }
+    const { question, userContext } = payload;
+    const questionOk = typeof question === "string" || question === undefined;
+    // userContext is an opaque structured object; validate only that it is an object when present
+    // so a later property read on the host side cannot throw.
+    const userContextOk = userContext === undefined || (typeof userContext === "object" && userContext !== null);
+    return questionOk && userContextOk;
+}
+/**
+ * Creates an {@link ICloseAiAssistantRequestedEvent}.
+ *
+ * @alpha
+ */
+export function closeAiAssistantRequested() {
+    return { type: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CLOSE_REQUESTED" };
+}
+/**
+ * Type guard for {@link ICloseAiAssistantRequestedEvent}.
+ *
+ * @alpha
+ */
+export function isCloseAiAssistantRequestedEvent(obj) {
+    return (typeof obj === "object" &&
+        obj !== null &&
+        obj.type === "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CLOSE_REQUESTED");
+}
+/**
+ * Creates an {@link IAiAssistantContextChangedEvent}.
+ *
+ * @alpha
+ */
+export function aiAssistantContextChanged(payload) {
+    return { type: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CONTEXT_CHANGED", payload: payload ?? {} };
+}
+/**
+ * Type guard for {@link IAiAssistantContextChangedEvent}.
+ *
+ * @alpha
+ */
+export function isAiAssistantContextChangedEvent(obj) {
+    if (typeof obj !== "object" ||
+        obj === null ||
+        obj.type !== "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CONTEXT_CHANGED") {
+        return false;
+    }
+    const payload = obj.payload;
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+        return false;
+    }
+    const { includeTags, excludeTags } = payload;
+    const isStringArrayOrUndefined = (value) => value === undefined || (Array.isArray(value) && value.every((item) => typeof item === "string"));
+    return isStringArrayOrUndefined(includeTags) && isStringArrayOrUndefined(excludeTags);
+}

package/esm/sdk-pluggable-application-model.d.ts

@@ -7,6 +7,7 @@
 import { ApplicationScope } from '@gooddata/sdk-model';
 import { IColorPalette } from '@gooddata/sdk-model';
 import { IEntitlementDescriptor } from '@gooddata/sdk-model';
+import { IGenAIUserContext } from '@gooddata/sdk-model';
 import { ILocale } from '@gooddata/sdk-model';
 import { ITheme } from '@gooddata/sdk-model';
 import { IUser } from '@gooddata/sdk-model';
@@ -17,6 +18,23 @@ import { IWorkspacePermissions } from '@gooddata/sdk-model';
 import { ObjRef } from '@gooddata/sdk-model';
 import { PluggableApplicationRegistryItem } from '@gooddata/sdk-model';
 
+/**
+ * Creates an {@link IAiAssistantContextChangedEvent}.
+ *
+ * @alpha
+ */
+export declare function aiAssistantContextChanged(payload?: {
+    includeTags?: string[];
+    excludeTags?: string[];
+}): IAiAssistantContextChangedEvent;
+
+/**
+ * Creates an {@link ICloseAiAssistantRequestedEvent}.
+ *
+ * @alpha
+ */
+export declare function closeAiAssistantRequested(): ICloseAiAssistantRequestedEvent;
+
 /**
  * The object contains constants with IDs of default platform applications.
  * These IDs are used to identify application in the platform registry.
@@ -64,6 +82,57 @@ export declare type EmbeddingMode = "none" | "iframe" | "export";
  */
 export declare type HostUiMount = (options: IHostUiMountOptions) => IHostUiMountHandle;
 
+/**
+ * Event informing the host of the active application's current AI-assistant tag scope.
+ *
+ * @remarks
+ * A hosted application can constrain its catalog to objects tagged in a certain way (e.g. AD's
+ * `includeObjectsWithTags` route filter). Because the host owns the single chat instance on hosted
+ * routes, the application forwards its current tag scope through this event so the host assistant's
+ * object search/autocomplete stays within the same scope the rest of the application enforces.
+ * The host keeps the latest reported scope and clears it (empty arrays / omitted) when the
+ * application no longer constrains its catalog.
+ *
+ * @alpha
+ */
+export declare interface IAiAssistantContextChangedEvent extends IPluggableAppEvent {
+    readonly type: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CONTEXT_CHANGED";
+    readonly payload: {
+        /**
+         * Tag identifiers the assistant's object search should be restricted to. Empty/omitted
+         * means no include filter.
+         */
+        readonly includeTags?: string[];
+        /**
+         * Tag identifiers the assistant's object search should exclude. Empty/omitted means no
+         * exclude filter.
+         */
+        readonly excludeTags?: string[];
+    };
+}
+
+/**
+ * Notification informing the host UI of the active application's current AI-assistant tag scope.
+ *
+ * @remarks
+ * Emitted when the active pluggable application's tag scope changes (see
+ * `IAiAssistantContextChangedEvent`). The host UI keeps the latest scope and applies it to its
+ * chat so the assistant's object search stays within the same scope the application enforces.
+ *
+ * @alpha
+ */
+export declare interface IAiAssistantContextHostUiNotification {
+    type: "aiAssistantContext";
+    /**
+     * Tag identifiers the assistant's object search should be restricted to.
+     */
+    includeTags?: string[];
+    /**
+     * Tag identifiers the assistant's object search should exclude.
+     */
+    excludeTags?: string[];
+}
+
 /**
  * GoodData API-token authentication.
  *
@@ -128,6 +197,33 @@ export declare interface IAppInstance extends IPluggableApplicationMountHandle {
  */
 export declare type IAuthCredentials = IContextDeferredAuthCredentials | IApiTokenAuthCredentials | IJwtAuthCredentials;
 
+/**
+ * Notification requesting the host UI to close its AI assistant chat.
+ *
+ * @remarks
+ * Emitted when the active pluggable application closes the assistant from one of its own controls
+ * (see `ICloseAiAssistantRequestedEvent`). The host UI closes its single chat instance.
+ *
+ * @alpha
+ */
+export declare interface ICloseAiAssistantHostUiNotification {
+    type: "closeAiAssistant";
+}
+
+/**
+ * Event requesting the host to close its AI assistant chat.
+ *
+ * @remarks
+ * Counterpart to {@link IOpenAiAssistantRequestedEvent}. A pluggable application emits this when one
+ * of its in-content controls toggles the assistant closed (e.g. an embedded AI button), so the
+ * host-owned chat closes in step with the application.
+ *
+ * @alpha
+ */
+export declare interface ICloseAiAssistantRequestedEvent extends IPluggableAppEvent {
+    readonly type: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CLOSE_REQUESTED";
+}
+
 /**
  * Cookie / session-based authentication — no explicit credentials required.
  *
@@ -307,6 +403,15 @@ export declare interface IHostUiMountOptions {
      * entry instead of pushing a new one.
      */
     replace: (url: string) => void;
+    /**
+     * Reports the host-owned AI assistant chat open-state whenever it changes.
+     *
+     * @remarks
+     * The host UI owns the single chat instance on hosted routes; the host runtime forwards this
+     * open-state to the active pluggable application (via its mount handle) so app-side assistant
+     * controls stay aligned with what the user sees.
+     */
+    onAiAssistantOpenChange?: (open: boolean) => void;
 }
 
 /**
@@ -321,7 +426,7 @@ export declare interface IHostUiMountOptions {
  *
  * @alpha
  */
-export declare type IHostUiNotification = INewDeploymentAvailableHostUiNotification;
+export declare type IHostUiNotification = INewDeploymentAvailableHostUiNotification | IOpenAiAssistantHostUiNotification | ICloseAiAssistantHostUiNotification | IAiAssistantContextHostUiNotification;
 
 /**
  * JWT-based authentication.
@@ -360,6 +465,57 @@ export declare interface INewDeploymentAvailableHostUiNotification {
     commitHash: string;
 }
 
+/**
+ * Notification requesting the host UI to open its AI assistant chat.
+ *
+ * @remarks
+ * Emitted when the active pluggable application requests the assistant (see
+ * `IOpenAiAssistantRequestedEvent`). The host UI owns the single chat instance on
+ * hosted-application routes and opens it, optionally seeded with a question and user context.
+ *
+ * @alpha
+ */
+export declare interface IOpenAiAssistantHostUiNotification {
+    type: "openAiAssistant";
+    /**
+     * Question to seed the chat with. When omitted, the chat just opens.
+     */
+    question?: string;
+    /**
+     * Context of the user's current location (e.g. the active dashboard), passed to the
+     * assistant alongside the seeded question.
+     */
+    userContext?: IGenAIUserContext;
+}
+
+/**
+ * Event requesting the host to open its AI assistant chat.
+ *
+ * @remarks
+ * The host shell owns the AI assistant on hosted-application routes — a pluggable application must
+ * not render its own chat dialog there (two assistants would overlay each other and a duplicate
+ * could auto-open from the shared open-state, see LX-2544). Instead, its in-content entry points
+ * (e.g. a "Summarize" action) emit this event and the host opens its chat, optionally seeded with a
+ * question and the user's location context. Tag scoping for the assistant's object search is carried
+ * separately via {@link IAiAssistantContextChangedEvent}, which reflects the app's current view.
+ *
+ * @alpha
+ */
+export declare interface IOpenAiAssistantRequestedEvent extends IPluggableAppEvent {
+    readonly type: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.OPEN_REQUESTED";
+    readonly payload: {
+        /**
+         * Question to seed the chat with. When omitted, the chat just opens.
+         */
+        readonly question?: string;
+        /**
+         * Context of the user's current location (e.g. the active dashboard and its widgets),
+         * passed to the assistant alongside the seeded question.
+         */
+        readonly userContext?: IGenAIUserContext;
+    };
+}
+
 /**
  * Organization information available in the platform context.
  *
@@ -525,6 +681,17 @@ export declare interface IPluggableApplicationMountHandle {
      * Host uses this to push down context changes after initial mount.
      */
     updateContext?: (ctx: IPlatformContext) => void;
+    /**
+     * Pushes the host-owned AI assistant chat open-state into the pluggable application.
+     *
+     * @remarks
+     * On hosted routes the host owns the single chat instance; an application that exposes its own
+     * assistant controls (e.g. an embedded AI button, or the `toggleAIAssistant` postMessage command
+     * whose result is echoed to an embedding client) needs to know the real open-state to keep those
+     * controls and their reported results aligned with what the user sees. The host calls this
+     * whenever its chat opens or closes. Applications without such controls may omit it.
+     */
+    setAiAssistantOpen?: (open: boolean) => void;
 }
 
 /**
@@ -629,6 +796,20 @@ export declare interface IReloadPlatformContextRequestedEvent extends IPluggable
     readonly type: "GDC.PLUGGABLE_APP/EVT.RELOAD_PLATFORM_CONTEXT.REQUESTED";
 }
 
+/**
+ * Type guard for {@link IAiAssistantContextChangedEvent}.
+ *
+ * @alpha
+ */
+export declare function isAiAssistantContextChangedEvent(obj: unknown): obj is IAiAssistantContextChangedEvent;
+
+/**
+ * Type guard for {@link ICloseAiAssistantRequestedEvent}.
+ *
+ * @alpha
+ */
+export declare function isCloseAiAssistantRequestedEvent(obj: unknown): obj is ICloseAiAssistantRequestedEvent;
+
 /**
  * Type guard for {@link IDocumentTitleChangedEvent}.
  *
@@ -641,6 +822,18 @@ export declare interface IReloadPlatformContextRequestedEvent extends IPluggable
  */
 export declare function isDocumentTitleChangedEvent(obj: unknown): obj is IDocumentTitleChangedEvent;
 
+/**
+ * Type guard for {@link IOpenAiAssistantRequestedEvent}.
+ *
+ * @remarks
+ * Validates the payload shape too (not just the type), so a malformed event — e.g. one emitted
+ * from JS or a mismatched remote module — is rejected rather than narrowed to a type whose later
+ * `payload.question` access would throw.
+ *
+ * @alpha
+ */
+export declare function isOpenAiAssistantRequestedEvent(obj: unknown): obj is IOpenAiAssistantRequestedEvent;
+
 /**
  * Type guard for {@link IPlatformContextV1}.
  *
@@ -692,6 +885,16 @@ export declare const LIB_NAME: string;
 /** @alpha */
 export declare const LIB_VERSION: string;
 
+/**
+ * Creates an {@link IOpenAiAssistantRequestedEvent}.
+ *
+ * @alpha
+ */
+export declare function openAiAssistantRequested(payload?: {
+    question?: string;
+    userContext?: IGenAIUserContext;
+}): IOpenAiAssistantRequestedEvent;
+
 /**
  * Panther tier.
  *
@@ -713,6 +916,9 @@ export declare enum PantherTier {
 export declare const PluggableAppEventType: {
     readonly RELOAD_PLATFORM_CONTEXT_REQUESTED: "GDC.PLUGGABLE_APP/EVT.RELOAD_PLATFORM_CONTEXT.REQUESTED";
     readonly DOCUMENT_TITLE_CHANGED: "GDC.PLUGGABLE_APP/EVT.DOCUMENT_TITLE.CHANGED";
+    readonly AI_ASSISTANT_OPEN_REQUESTED: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.OPEN_REQUESTED";
+    readonly AI_ASSISTANT_CLOSE_REQUESTED: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CLOSE_REQUESTED";
+    readonly AI_ASSISTANT_CONTEXT_CHANGED: "GDC.PLUGGABLE_APP/EVT.AI_ASSISTANT.CONTEXT_CHANGED";
 };
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-pluggable-application-model",
-  "version": "11.42.0-alpha.3",
+  "version": "11.42.0-alpha.4",
   "description": "GoodData SDK model contracts for pluggable applications",
   "license": "MIT",
   "author": "GoodData Corporation",
@@ -23,7 +23,7 @@
   "dependencies": {
     "ts-invariant": "0.10.3",
     "tslib": "2.8.1",
-    "@gooddata/sdk-model": "11.42.0-alpha.3"
+    "@gooddata/sdk-model": "11.42.0-alpha.4"
   },
   "devDependencies": {
     "@microsoft/api-documenter": "^7.17.0",
@@ -47,8 +47,8 @@
     "oxlint-tsgolint": "0.15.0",
     "typescript": "5.9.3",
     "vitest": "4.1.8",
-    "@gooddata/oxlint-config": "11.42.0-alpha.3",
-    "@gooddata/eslint-config": "11.42.0-alpha.3"
+    "@gooddata/eslint-config": "11.42.0-alpha.4",
+    "@gooddata/oxlint-config": "11.42.0-alpha.4"
   },
   "scripts": {
     "_phase:build": "npm run build",