@gooddata/sdk-ui-pluggable-host 11.45.0-alpha.0 → 11.45.0-alpha.2

package/esm/ui/GenAIChat.js

@@ -1,108 +1,80 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 // (C) 2026 GoodData Corporation
-import { useCallback, useEffect, useMemo, useState } from "react";
+import { useCallback } from "react";
 import { defineMessage, useIntl } from "react-intl";
 import { useBackendStrict } from "@gooddata/sdk-ui";
-import { isChatAssistantMessageEvent, isChatClosedEvent, isChatCopyToClipboardEvent, isChatFeedbackEvent, isChatOpenedEvent, isChatResetEvent, isChatSaveVisualizationErrorEvent, isChatSaveVisualizationSuccessEvent, isChatUserMessageEvent, makeUserItem, } from "@gooddata/sdk-ui-gen-ai";
-import { GenAIChatDialog, clearThreadAction, makeTextContents, makeUserMessage, newMessageAction, setUserContextAction, } from "@gooddata/sdk-ui-gen-ai/internal";
+import { GenAIChatDialogConnected } from "@gooddata/sdk-ui-gen-ai/internal";
 import { HEADER_CHAT_BUTTON_ID, useToastMessage } from "@gooddata/sdk-ui-kit";
-export function GenAIChat({ workspaceId, open, onOpen, onClose, askedQuestion, askSeq, userContext, includeTags, excludeTags, canManageProject, canAnalyzeProject, canFullControl, settings, onEvent, }) {
+// DOM id of the embedded dashboard's AI trigger button (defined in gdc-dashboards-runtime as
+// EMBED_AI_TRIGGER_ID). Used as the chat's focus-return target when running embedded, where the host
+// header chat button does not exist. Kept as a literal to avoid a host→app package dependency.
+const EMBEDDED_AI_TRIGGER_ID = "embed-ai-trigger";
+const EMBEDDED_CHAT_CLASS = "gd-gen-ai-chat-embedded";
+/**
+ * Host chrome's chat adapter. The generic chat wiring (object types, the seeded-question dispatch flow,
+ * default link handling, event normalization) lives in `GenAIChatDialogConnected`
+ * (`@gooddata/sdk-ui-gen-ai/internal`); this adapter only supplies the host's data sources, renders the
+ * host's own save-visualization / copy toasts, and forwards telemetry events through `onEvent`.
+ */
+export function GenAIChat({ workspaceId, open, onOpen, onClose, askedQuestion, askSeq, userContext, includeTags, excludeTags, canManageProject, canAnalyzeProject, canFullControl, settings, dialogPosition, embedded, onAppLinkClick, onEvent, }) {
     const { addSuccess, addError } = useToastMessage();
     const intl = useIntl();
     const backend = useBackendStrict();
-    const onLinkClick = useCallback(({ itemUrl, newTab, preventDefault }) => {
-        if (itemUrl) {
-            preventDefault();
-            if (newTab) {
-                window.open(itemUrl, "_blank");
-            }
-            else {
-                window.location.assign(itemUrl);
-            }
+    // Embedded link handling (this handler is only wired when `embedded`). Delegate to the active app —
+    // it opens visualization links as an in-place overlay — and never let a link navigate the embedded
+    // iframe away, matching the previous embedded dashboard chat which prevented default for every link
+    // type (only visualizations did anything). Non-embedded mode uses the connected wrapper's default
+    // open/navigate handler instead.
+    const onLinkClick = useCallback((link) => {
+        onAppLinkClick?.({
+            type: link.type,
+            id: link.id,
+            itemUrl: link.itemUrl,
+            newTab: link.newTab,
+        });
+        link.preventDefault();
+        return undefined;
+    }, [onAppLinkClick]);
+    const handleEvent = useCallback((event) => {
+        switch (event.name) {
+            case "opened":
+                onEvent?.({ name: "chat.opened", payload: event.payload });
+                break;
+            case "closed":
+                onEvent?.({ name: "chat.closed", payload: event.payload });
+                break;
+            case "reset":
+                onEvent?.({ name: "chat.reset", payload: event.payload });
+                break;
+            case "feedback":
+                onEvent?.({ name: "chat.feedback", payload: event.payload });
+                break;
+            case "user-message":
+                onEvent?.({ name: "chat.user-message", payload: event.payload });
+                break;
+            case "assistant-message":
+                onEvent?.({ name: "chat.assistant-message", payload: event.payload });
+                break;
+            case "save-visualization-success":
+                addSuccess(defineMessage({ id: "messages.genAi.visualisation.saved.success" }));
+                break;
+            case "save-visualization-error":
+                addError(defineMessage({ id: "messages.genAi.visualisation.saved.error" }), {
+                    showMore: intl.formatMessage({ id: "messages.showMore" }),
+                    showLess: intl.formatMessage({ id: "messages.showLess" }),
+                    errorDetail: intl.formatMessage({ id: "messages.genAi.visualisation.saved.error.detail" }, {
+                        errorType: event.payload.errorType,
+                        errorMessage: event.payload.errorMessage,
+                    }),
+                    duration: 0,
+                });
+                break;
+            case "copy-to-clipboard":
+                addSuccess(defineMessage({ id: "messages.genAi.visualisation.link.copied" }));
+                break;
+            default:
+                break;
         }
-        return itemUrl;
-    }, []);
-    const events = useMemo(() => {
-        return [
-            {
-                eval: isChatOpenedEvent,
-                handler: (data) => onEvent?.({ name: "chat.opened", payload: data }),
-            },
-            {
-                eval: isChatClosedEvent,
-                handler: (data) => onEvent?.({ name: "chat.closed", payload: data }),
-            },
-            {
-                eval: isChatResetEvent,
-                handler: (data) => onEvent?.({ name: "chat.reset", payload: data }),
-            },
-            {
-                eval: isChatFeedbackEvent,
-                handler: (data) => onEvent?.({ name: "chat.feedback", payload: data }),
-            },
-            {
-                eval: isChatUserMessageEvent,
-                handler: (data) => onEvent?.({ name: "chat.user-message", payload: data }),
-            },
-            {
-                eval: isChatAssistantMessageEvent,
-                handler: (data) => onEvent?.({ name: "chat.assistant-message", payload: data }),
-            },
-            {
-                eval: isChatSaveVisualizationSuccessEvent,
-                handler: () => {
-                    addSuccess(defineMessage({ id: "messages.genAi.visualisation.saved.success" }));
-                },
-            },
-            {
-                eval: isChatSaveVisualizationErrorEvent,
-                handler: ({ errorType, errorMessage }) => {
-                    addError(defineMessage({ id: "messages.genAi.visualisation.saved.error" }), {
-                        showMore: intl.formatMessage({ id: "messages.showMore" }),
-                        showLess: intl.formatMessage({ id: "messages.showLess" }),
-                        errorDetail: intl.formatMessage({ id: "messages.genAi.visualisation.saved.error.detail" }, {
-                            errorType,
-                            errorMessage,
-                        }),
-                        duration: 0,
-                    });
-                },
-            },
-            {
-                eval: isChatCopyToClipboardEvent,
-                handler: () => {
-                    addSuccess(defineMessage({ id: "messages.genAi.visualisation.link.copied" }));
-                },
-            },
-        ];
     }, [addError, addSuccess, intl, onEvent]);
-    const objectTypes = useMemo(() => {
-        const types = ["dashboard", "visualization"];
-        if (canManageProject) {
-            types.push("metric");
-        }
-        return types;
-    }, [canManageProject]);
-    const [chatDispatcher, setDispatcher] = useState(null);
-    const onDispatcher = useCallback((dispatcher) => {
-        setDispatcher(() => dispatcher);
-    }, []);
-    useEffect(() => {
-        if (!chatDispatcher || !askedQuestion || !settings) {
-            return;
-        }
-        chatDispatcher(clearThreadAction());
-        // Always set (and thereby clear when undefined) so a follow-up ask without context does not
-        // inherit the previous ask's user context (LX-2544).
-        chatDispatcher(setUserContextAction({ userContext }));
-        if (settings.enableAiAgenticConversations) {
-            chatDispatcher(newMessageAction(makeUserItem({ type: "text", text: askedQuestion })));
-        }
-        else {
-            chatDispatcher(newMessageAction(makeUserMessage([makeTextContents(askedQuestion, [])])));
-        }
-        // `askSeq` is included so a repeated identical question (same `askedQuestion`) still re-seeds.
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [chatDispatcher, askedQuestion, askSeq, userContext, settings]);
-    return (_jsx(GenAIChatDialog, { isOpen: open, locale: intl.locale, canManage: canManageProject, canAnalyze: canAnalyzeProject, canFullControl: canFullControl, objectTypes: objectTypes, includeTags: includeTags, excludeTags: excludeTags, onLinkClick: onLinkClick, onClose: onClose, onOpen: onOpen, workspace: workspaceId, backend: backend, settings: settings, eventHandlers: events, onDispatcher: onDispatcher, returnFocusTo: HEADER_CHAT_BUTTON_ID }));
+    return (_jsx(GenAIChatDialogConnected, { backend: backend, workspace: workspaceId, locale: intl.locale, isOpen: open, onOpen: onOpen, onClose: onClose, askedQuestion: askedQuestion, askSeq: askSeq, userContext: userContext, includeTags: includeTags, excludeTags: excludeTags, canManage: canManageProject, canAnalyze: canAnalyzeProject, canFullControl: canFullControl, settings: settings, dialogPosition: dialogPosition, allowNativeLinks: embedded ? false : undefined, className: embedded ? EMBEDDED_CHAT_CLASS : undefined, onLinkClick: embedded ? onLinkClick : undefined, onEvent: handleEvent, returnFocusTo: embedded ? EMBEDDED_AI_TRIGGER_ID : HEADER_CHAT_BUTTON_ID }));
 }

package/esm/ui/HostChat.d.ts

@@ -0,0 +1,64 @@
+import { type IGenAIUserContext, type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
+import { type IPlatformContext } from "@gooddata/sdk-pluggable-application-model";
+import "@gooddata/sdk-ui-gen-ai/styles/css/main.css";
+/**
+ * AI-assistant open/close/toggle request. `seq` changes on every request so an identical repeat
+ * (e.g. "Summarize" clicked again, or the header button toggled) still re-triggers the effect.
+ */
+export interface IHostChatVisibility {
+    kind: "open" | "close" | "toggle";
+    question?: string;
+    userContext?: IGenAIUserContext;
+    seq: number;
+}
+/** A link clicked inside the chat, delegated to the active application for in-app handling. */
+export interface IHostChatLink {
+    type?: string;
+    id?: string;
+    itemUrl?: string;
+    newTab?: boolean;
+}
+/**
+ * AI-assistant presentation/context reported by the active pluggable application: its object-search
+ * tag scope plus, when embedded, how the host chat should be presented.
+ */
+export interface IHostChatContext {
+    includeTags?: string[];
+    excludeTags?: string[];
+    dialogPosition?: "left" | "right";
+    embedded?: boolean;
+}
+export interface IHostChatProps {
+    ctx: IPlatformContext;
+    resolvedApplications: PluggableApplicationRegistryItem[];
+    pathname: string;
+    /** Id of the active pluggable application; used to reset tag scope on app switch. */
+    activeAppId?: string;
+    /** Latest open/close/toggle request (from app events, the header button, or header search). */
+    visibility?: IHostChatVisibility | null;
+    /** Latest tag scope / presentation reported by the active pluggable application. */
+    context?: IHostChatContext | null;
+    /** Reports the chat open-state so the runtime can forward it to the active app. */
+    onOpenChange?: (open: boolean) => void;
+    /** Reports the header chat-button state (visibility + open) so the host UI can render it. */
+    onChatStateChange?: (state: {
+        showChatItem: boolean;
+        isOpen: boolean;
+    }) => void;
+    /**
+     * Delegates a chat link click to the active application (e.g. an embedded dashboard opening a
+     * visualization as an in-place overlay). Returns true if the app handled it.
+     */
+    onAppLinkClick?: (link: IHostChatLink) => boolean;
+}
+/**
+ * Owns and renders the host's single GenAI chat, decoupled from the host UI module.
+ *
+ * @remarks
+ * Rendered by {@link HostUiContainer} in its own React tree (with the providers the chat needs), so
+ * the chat survives a custom remote UI module and stays mounted when the chrome is hidden
+ * (embedded/export). The header chat button and app-side controls drive it through the `visibility`
+ * and `context` props; it reports its open-state and button state back via callbacks.
+ */
+export declare function HostChat({ ctx, resolvedApplications, pathname, activeAppId, visibility, context, onOpenChange, onChatStateChange, onAppLinkClick }: IHostChatProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=HostChat.d.ts.map

package/esm/ui/HostChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostChat.d.ts","sourceRoot":"","sources":["../../src/ui/HostChat.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAUlF,OAAO,6CAA6C,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;CACf;AAED,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,gBAAgB,CAAC;IACtB,oBAAoB,EAAE,gCAAgC,EAAE,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+FAA+F;IAC/F,UAAU,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,oFAAoF;IACpF,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,mFAAmF;IACnF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,YAAY,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAChF;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC;CACrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EACrB,GAAG,EACH,oBAAoB,EACpB,QAAQ,EACR,WAAW,EACX,UAAiB,EACjB,OAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACjB,EAAE,cAAc,2CA6EhB"}

package/esm/ui/HostChat.js

@@ -0,0 +1,75 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// (C) 2026 GoodData Corporation
+import { useEffect, useMemo } from "react";
+import { BackendProvider, resolveLocale } from "@gooddata/sdk-ui";
+import { ToastsCenterContextProvider } from "@gooddata/sdk-ui-kit";
+import { getAppLifecycleCallbacks } from "../loader/pluggableApplicationsLoader.js";
+import { getBackend } from "../platformContext/backend.js";
+import { HostIntlProvider } from "./HostIntlProvider.js";
+import { useHostChromeChat } from "./useHostChromeChat.js";
+import { useHostChromeWorkspaceFeatures } from "./useHostChromeWorkspaceFeatures.js";
+import "@gooddata/sdk-ui-gen-ai/styles/css/main.css";
+/**
+ * Owns and renders the host's single GenAI chat, decoupled from the host UI module.
+ *
+ * @remarks
+ * Rendered by {@link HostUiContainer} in its own React tree (with the providers the chat needs), so
+ * the chat survives a custom remote UI module and stays mounted when the chrome is hidden
+ * (embedded/export). The header chat button and app-side controls drive it through the `visibility`
+ * and `context` props; it reports its open-state and button state back via callbacks.
+ */
+export function HostChat({ ctx, resolvedApplications, pathname, activeAppId, visibility = null, context = null, onOpenChange, onChatStateChange, onAppLinkClick, }) {
+    const features = useHostChromeWorkspaceFeatures(resolvedApplications, ctx, pathname);
+    const shellTelemetry = useMemo(() => getAppLifecycleCallbacks()?.createTelemetryCallbacks?.("host-ui"), []);
+    const chat = useHostChromeChat({
+        features,
+        ctx,
+        telemetry: shellTelemetry,
+        dialogPosition: context?.dialogPosition,
+        embedded: context?.embedded,
+        onAppLinkClick,
+    });
+    const { askAiAssistant: chatAskAiAssistant, open: chatOpen, close: chatClose, toggle: chatToggle, setTags: chatSetTags, isOpen: chatIsOpen, showChatItem, } = chat;
+    // Report the chat open-state outward so the runtime can forward it to the active pluggable
+    // application, keeping app-side assistant controls (and their echoed results) aligned (LX-2544).
+    useEffect(() => {
+        onOpenChange?.(chatIsOpen);
+    }, [chatIsOpen, onOpenChange]);
+    // Report the header chat-button state so the host UI module can render the button to match.
+    useEffect(() => {
+        onChatStateChange?.({ showChatItem, isOpen: chatIsOpen });
+    }, [showChatItem, chatIsOpen, onChatStateChange]);
+    // Effect order matters: the tag-scope effects are declared before the open/ask effect so that,
+    // when a tag-scope change and an open/ask request land in the same commit, the host chat is
+    // already scoped before the seeded question is sent.
+    // Clear any stale tag scope when the active application changes. The newly active app re-reports
+    // its own scope (or none) right after it mounts; without this reset, switching from a tag-scoped
+    // app to one that reports no scope (e.g. the metric editor) would leak the old scope.
+    useEffect(() => {
+        chatSetTags(undefined, undefined);
+    }, [activeAppId, chatSetTags]);
+    useEffect(() => {
+        chatSetTags(context?.includeTags, context?.excludeTags);
+    }, [context, chatSetTags]);
+    const visibilitySeq = visibility?.seq;
+    useEffect(() => {
+        if (!visibility) {
+            return;
+        }
+        if (visibility.kind === "close") {
+            chatClose();
+        }
+        else if (visibility.kind === "toggle") {
+            chatToggle();
+        }
+        else if (visibility.question) {
+            chatAskAiAssistant(visibility.question, visibility.userContext);
+        }
+        else {
+            chatOpen();
+        }
+        // `seq` changes on every request, so a repeated identical open/ask/toggle still re-runs this.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [visibilitySeq, chatAskAiAssistant, chatOpen, chatClose, chatToggle]);
+    return (_jsx(HostIntlProvider, { locale: resolveLocale(ctx.preferredLocale), children: _jsx(BackendProvider, { backend: getBackend(), children: _jsx(ToastsCenterContextProvider, { children: chat.element }) }) }));
+}

package/esm/ui/HostChrome.d.ts

@@ -6,23 +6,6 @@ import "@gooddata/sdk-ui-ext/styles/css/main.css";
 import "@gooddata/sdk-ui-gen-ai/styles/css/main.css";
 import "@gooddata/sdk-ui-semantic-search/styles/css/main.css";
 import "@gooddata/sdk-ui-semantic-search/styles/css/internal.css";
-/**
- * AI-assistant open/close request pushed from the active pluggable application. `seq` changes on
- * every request so an identical repeat (e.g. "Summarize" clicked again) still re-triggers the host.
- */
-export interface IHostChromeAiVisibility {
-    kind: "open" | "close";
-    question?: string;
-    userContext?: IGenAIUserContext;
-    seq: number;
-}
-/**
- * AI-assistant object-search tag scope reported by the active pluggable application.
- */
-export interface IHostChromeAiContext {
-    includeTags?: string[];
-    excludeTags?: string[];
-}
 export interface IHostChromeProps {
     ctx: IPlatformContext;
     resolvedApplications: PluggableApplicationRegistryItem[];
@@ -31,12 +14,17 @@ export interface IHostChromeProps {
     onReplace: (url: string) => void;
     headerOptions?: IAppHeaderOptions;
     notification?: IHostUiNotification | null;
-    /** Latest AI-assistant open/close request from the active pluggable application. */
-    aiVisibility?: IHostChromeAiVisibility | null;
-    /** Latest AI-assistant tag scope reported by the active pluggable application. */
-    aiContext?: IHostChromeAiContext | null;
-    /** Reports the host chat open-state so the runtime can forward it to the active app. */
-    onAiAssistantOpenChange?: (open: boolean) => void;
+    /**
+     * Whether the header chat button should be shown. Reflects the host-owned chat's availability
+     * (feature flag, permissions and the runtime LLM-availability probe), pushed in by the runtime.
+     */
+    showChatItem?: boolean;
+    /** Whether the host-owned chat is currently open (for the header button's active state). */
+    chatIsOpen?: boolean;
+    /** Toggles the host-owned chat; wired to the header chat button. */
+    onChatToggle?: () => void;
+    /** Hands a question to the host-owned chat; wired to the header search "ask AI" action. */
+    onAskAiAssistant?: (question: string, userContext?: IGenAIUserContext) => void;
     /**
      * Page-title segment set by the active pluggable application via a document-title-changed
      * event. When omitted, the active application's manifest title is used instead.
@@ -44,5 +32,5 @@ export interface IHostChromeProps {
     appPageTitle?: string;
     children?: ReactNode;
 }
-export declare function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification, aiVisibility, aiContext, onAiAssistantOpenChange, appPageTitle, children }: IHostChromeProps): import("react/jsx-runtime").JSX.Element;
+export declare function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification, showChatItem, onChatToggle, onAskAiAssistant, appPageTitle, children }: IHostChromeProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=HostChrome.d.ts.map

package/esm/ui/HostChrome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HostChrome.d.ts","sourceRoot":"","sources":["../../src/ui/HostChrome.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,SAAS,EAAmC,MAAM,OAAO,CAAC;AAE7G,OAAO,EAEH,KAAK,iBAAiB,EAEtB,KAAK,gCAAgC,EACxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACxB,MAAM,2CAA2C,CAAC;AAgCnD,OAAO,mBAAmB,CAAC;AAK3B,OAAO,0CAA0C,CAAC;AAClD,OAAO,6CAA6C,CAAC;AACrD,OAAO,sDAAsD,CAAC;AAC9D,OAAO,0DAA0D,CAAC;AAYlE;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,gBAAgB,CAAC;IACtB,oBAAoB,EAAE,gCAAgC,EAAE,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,YAAY,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,oFAAoF;IACpF,YAAY,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC9C,kFAAkF;IAClF,SAAS,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACxC,wFAAwF;IACxF,uBAAuB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wBAAgB,UAAU,CAAC,EACvB,GAAG,EACH,oBAAoB,EACpB,QAAQ,EACR,UAAU,EACV,SAAS,EAAE,UAAU,EACrB,aAAa,EACb,YAAmB,EACnB,YAAmB,EACnB,SAAgB,EAChB,uBAAuB,EACvB,YAAY,EACZ,QAAQ,EACX,EAAE,gBAAgB,2CA+QlB"}
+{"version":3,"file":"HostChrome.d.ts","sourceRoot":"","sources":["../../src/ui/HostChrome.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,SAAS,EAAwB,MAAM,OAAO,CAAC;AAElG,OAAO,EAEH,KAAK,iBAAiB,EAEtB,KAAK,gCAAgC,EACxC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACxB,MAAM,2CAA2C,CAAC;AA+BnD,OAAO,mBAAmB,CAAC;AAK3B,OAAO,0CAA0C,CAAC;AAClD,OAAO,6CAA6C,CAAC;AACrD,OAAO,sDAAsD,CAAC;AAC9D,OAAO,0DAA0D,CAAC;AAYlE,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,gBAAgB,CAAC;IACtB,oBAAoB,EAAE,gCAAgC,EAAE,CAAC;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,YAAY,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,2FAA2F;IAC3F,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC/E;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wBAAgB,UAAU,CAAC,EACvB,GAAG,EACH,oBAAoB,EACpB,QAAQ,EACR,UAAU,EACV,SAAS,EAAE,UAAU,EACrB,aAAa,EACb,YAAmB,EACnB,YAAoB,EACpB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACX,EAAE,gBAAgB,2CA6NlB"}

package/esm/ui/HostChrome.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // (C) 2026 GoodData Corporation
-import { useCallback, useEffect, useMemo } from "react";
+import { useCallback, useMemo } from "react";
 import { isExternalPluggableApplicationRegistryItem, } from "@gooddata/sdk-model";
 import { BackendProvider, resolveLocale } from "@gooddata/sdk-ui";
 import { AppHeaderNotifications } from "@gooddata/sdk-ui-application-header";
@@ -15,7 +15,6 @@ import { getUserDisplayName, swapWorkspaceInPath } from "./chromeHelpers.js";
 import { b, e } from "./hostChromeBem.js";
 import { HostIntlProvider } from "./HostIntlProvider.js";
 import { HostNotificationDispatcher } from "./HostNotificationDispatcher.js";
-import { useHostChromeChat } from "./useHostChromeChat.js";
 import { useHostChromePricing } from "./useHostChromePricing.js";
 import { useHostChromeSearch } from "./useHostChromeSearch.js";
 import { useHostChromeWorkspaceFeatures } from "./useHostChromeWorkspaceFeatures.js";
@@ -36,60 +35,23 @@ const LOGOUT_MENU_ITEM_KEY = "gs.header.logout";
 // favicon is configured (see faviconUrl below).
 const initialFaviconUrl = (typeof document !== "undefined" && document.querySelector("link[rel~='icon']")?.getAttribute("href")) ||
     "/favicon.ico";
-export function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification = null, aiVisibility = null, aiContext = null, onAiAssistantOpenChange, appPageTitle, children, }) {
+export function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification = null, showChatItem = false, onChatToggle, onAskAiAssistant, appPageTitle, children, }) {
     const locale = resolveLocale(ctx.preferredLocale);
     const userName = getUserDisplayName(ctx.user);
     const features = useHostChromeWorkspaceFeatures(resolvedApplications, ctx, pathname);
     const shellTelemetry = useMemo(() => getAppLifecycleCallbacks()?.createTelemetryCallbacks?.("host-ui"), []);
     const pricing = useHostChromePricing(ctx, locale);
-    const chat = useHostChromeChat({ features, ctx, telemetry: shellTelemetry });
-    const { askAiAssistant: chatAskAiAssistant, open: chatOpen, close: chatClose, setTags: chatSetTags, isOpen: chatIsOpen, } = chat;
-    // Report the host-owned chat open-state outward so the runtime can forward it to the active
-    // pluggable application, keeping app-side assistant controls (and their echoed results) aligned
-    // with the real state — e.g. the embedded dashboard's toggleAIAssistant result (LX-2544).
-    useEffect(() => {
-        onAiAssistantOpenChange?.(chatIsOpen);
-    }, [chatIsOpen, onAiAssistantOpenChange]);
-    // The active pluggable application must not render its own chat dialog on hosted routes — the
-    // chrome owns the single chat instance there (LX-2544). It drives that instance through these
-    // signals instead: the object-search tag scope of its current view and open/close requests.
-    //
-    // Effect order matters: the tag-scope effects are declared before the open/ask effect so that,
-    // when a tag-scope change and an open/ask request land in the same commit, the host chat is
-    // already scoped before the seeded question is sent.
-    // Clear any stale tag scope when the active application changes. The newly active app re-reports
-    // its own scope (or none) right after it mounts; without this reset, switching from a
-    // tag-scoped app to one that reports no scope (e.g. the metric editor) would leak the old scope.
-    // Declared before the context effect so that, in the rare commit where both change, the fresh
-    // scope wins over the reset.
-    const activeAppId = getActiveInternalApplication(resolvedApplications, ctx, pathname)?.id;
-    useEffect(() => {
-        chatSetTags(undefined, undefined);
-    }, [activeAppId, chatSetTags]);
-    useEffect(() => {
-        chatSetTags(aiContext?.includeTags, aiContext?.excludeTags);
-    }, [aiContext, chatSetTags]);
-    const aiVisibilitySeq = aiVisibility?.seq;
-    useEffect(() => {
-        if (!aiVisibility) {
-            return;
-        }
-        if (aiVisibility.kind === "close") {
-            chatClose();
-        }
-        else if (aiVisibility.question) {
-            chatAskAiAssistant(aiVisibility.question, aiVisibility.userContext);
-        }
-        else {
-            chatOpen();
-        }
-        // `seq` changes on every request, so a repeated identical open/ask still re-runs this.
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [aiVisibilitySeq, chatAskAiAssistant, chatOpen, chatClose]);
+    // The host's single GenAI chat is owned by the runtime (HostChat), not the chrome — so it survives
+    // a custom UI module and stays mounted when the chrome is hidden (embedded/export). The chrome only
+    // renders the header chat button, which toggles that chat via `onChatToggle`, and hands the header
+    // search's questions to it via `onAskAiAssistant`.
+    const handleAskAiAssistant = useCallback((question, userContext) => {
+        onAskAiAssistant?.(question, userContext);
+    }, [onAskAiAssistant]);
     const search = useHostChromeSearch({
         features,
         isTrial: pricing.isTrial,
-        onAskAiAssistant: chat.askAiAssistant,
+        onAskAiAssistant: handleAskAiAssistant,
         telemetry: shellTelemetry,
     });
     const { menuItemsGroups, messages: appMessages } = useMemo(() => buildAppMenu(resolvedApplications, ctx, pathname, ctx.preferredLocale), [resolvedApplications, ctx, pathname]);
@@ -182,9 +144,6 @@ export function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, on
     const hideChrome = ctx.embeddingMode === "iframe" || ctx.isExportMode === true;
     return (_jsx(HostIntlProvider, { locale: locale, additionalMessages: appMessages, children: _jsx(BackendProvider, { backend: getBackend(), children: _jsx(ToastsCenterContextProvider, { children: _jsxs("div", { className: b(), children: [
                         _jsx(DocumentHeader, { pageTitle: documentPageTitle, brandTitle: documentBrandTitle, faviconUrl: faviconUrl, appleTouchIconUrl: ctx.whiteLabeling?.appleTouchIconUrl }), hideChrome ? null : (_jsx("div", { className: e("header"), onMouseOver: handleHeaderMouseOver, children: _jsx(AppHeader, { logoUrl: ctx.whiteLabeling?.logoUrl || defaultLogoUrl, logoHref: "/organization" // switch the host scope to organization, the first org app will be chosen
-                                , logoTitle: logoTitle, headerColor: headerColor, headerTextColor: headerTextColor, activeColor: activeColor, userName: userName, organizationName: ctx.organization?.title, isAccessibilityCompliant: true, workspacePicker: workspacePicker, menuItemsGroups: menuItemsGroups, helpMenuItems: helpMenuItems, accountMenuItems: accountMenuItems, onMenuItemClick: handleMenuItemClick, showUpsellButton: pricing.isTrial, onUpsellButtonClick: pricing.onUpsellButtonClick, expiredDate: pricing.isTrial ? pricing.expiredDate : undefined, search: search.element, showChatItem: chat.showChatItem, onChatItemClick: chat.toggle, notificationsPanel: ctx.userSettings.enableInPlatformNotifications
-                                    ? ({ isMobile, closeNotificationsOverlay }) => (_jsx(AppHeaderNotifications, { locale: locale, isMobile: isMobile, closeNotificationsOverlay: closeNotificationsOverlay, useAsOfDateParam: ctx.userSettings.enableExecutionTimestamp ?? false, enableExportToDocumentStorage: ctx.userSettings.enableExportToDocumentStorage ??
-                                            false }))
-                                    : undefined }) })), _jsx("main", { className: e("content"), children: children }), hideChrome ? null : chat.element, pricing.element, _jsx(HostNotificationDispatcher, { notification: notification })
+                                , logoTitle: logoTitle, headerColor: headerColor, headerTextColor: headerTextColor, activeColor: activeColor, userName: userName, organizationName: ctx.organization?.title, isAccessibilityCompliant: true, workspacePicker: workspacePicker, menuItemsGroups: menuItemsGroups, helpMenuItems: helpMenuItems, accountMenuItems: accountMenuItems, onMenuItemClick: handleMenuItemClick, showUpsellButton: pricing.isTrial, onUpsellButtonClick: pricing.onUpsellButtonClick, expiredDate: pricing.isTrial ? pricing.expiredDate : undefined, search: search.element, showChatItem: showChatItem, onChatItemClick: onChatToggle, notificationsPanel: ({ isMobile, closeNotificationsOverlay }) => (_jsx(AppHeaderNotifications, { locale: locale, isMobile: isMobile, closeNotificationsOverlay: closeNotificationsOverlay, useAsOfDateParam: true, enableExportToDocumentStorage: ctx.userSettings.enableExportToDocumentStorage ?? false })) }) })), _jsx("main", { className: e("content"), children: children }), pricing.element, _jsx(HostNotificationDispatcher, { notification: notification })
                     ] }) }) }) }));
 }

package/esm/ui/PluggableApplicationRenderer.d.ts

@@ -1,4 +1,5 @@
-import { type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
+import { type RefObject } from "react";
+import { type IGenAIUserContext, type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
 import { type IAppHeaderOptions, type IPlatformContext } from "@gooddata/sdk-pluggable-application-model";
 import "./PluggableApplicationRenderer.scss";
 export interface IPluggableApplicationRendererProps {
@@ -7,8 +8,29 @@ export interface IPluggableApplicationRendererProps {
     pathname: string;
     /** Host-owned AI assistant chat open-state, forwarded to the mounted app's handle. */
     aiAssistantOpen?: boolean;
+    /** Open/ask the host-owned chat, requested by the active app via an open-assistant event. */
+    onOpenAiAssistant?: (question?: string, userContext?: IGenAIUserContext) => void;
+    /** Close the host-owned chat, requested by the active app. */
+    onCloseAiAssistant?: () => void;
+    /** Report the active app's AI-assistant tag scope and presentation to the host-owned chat. */
+    onAiAssistantContext?: (context: {
+        includeTags?: string[];
+        excludeTags?: string[];
+        dialogPosition?: "left" | "right";
+        embedded?: boolean;
+    }) => void;
+    /**
+     * Ref the renderer populates with a handler that delegates a host-chat link click to the active
+     * app's mount handle (`onAiAssistantLinkClicked`), so an embedded app can handle it in-app.
+     */
+    aiLinkClickHandlerRef?: RefObject<((link: {
+        type?: string;
+        id?: string;
+        itemUrl?: string;
+        newTab?: boolean;
+    }) => boolean) | undefined>;
     onHeaderChange?: (appId: string, header: IAppHeaderOptions) => void;
     onDocumentTitleChange?: (appId: string, pageTitle: string | undefined) => void;
 }
-export declare function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOpen, onHeaderChange, onDocumentTitleChange }: IPluggableApplicationRendererProps): import("react/jsx-runtime").JSX.Element;
+export declare function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOpen, onOpenAiAssistant, onCloseAiAssistant, onAiAssistantContext, aiLinkClickHandlerRef, onHeaderChange, onDocumentTitleChange }: IPluggableApplicationRendererProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=PluggableApplicationRenderer.d.ts.map

package/esm/ui/PluggableApplicationRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluggableApplicationRenderer.d.ts","sourceRoot":"","sources":["../../src/ui/PluggableApplicationRenderer.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EASxB,MAAM,2CAA2C,CAAC;AAenD,OAAO,qCAAqC,CAAC;AAkB7C,MAAM,WAAW,kCAAkC;IAC/C,GAAG,EAAE,gCAAgC,CAAC;IACtC,GAAG,EAAE,gBAAgB,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpE,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAClF;AAED,wBAAgB,4BAA4B,CAAC,EACzC,GAAG,EACH,GAAG,EACH,QAAQ,EACR,eAAe,EACf,cAAc,EACd,qBAAqB,EACxB,EAAE,kCAAkC,2CAsOpC"}
+{"version":3,"file":"PluggableApplicationRenderer.d.ts","sourceRoot":"","sources":["../../src/ui/PluggableApplicationRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAqD,MAAM,OAAO,CAAC;AAI1F,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,gCAAgC,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EASxB,MAAM,2CAA2C,CAAC;AAcnD,OAAO,qCAAqC,CAAC;AAkB7C,MAAM,WAAW,kCAAkC;IAC/C,GAAG,EAAE,gCAAgC,CAAC;IACtC,GAAG,EAAE,gBAAgB,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACjF,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,8FAA8F;IAC9F,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE;QAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,KAAK,IAAI,CAAC;IACX;;;OAGG;IACH,qBAAqB,CAAC,EAAE,SAAS,CAC7B,CAAC,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,GAAG,SAAS,CACtG,CAAC;IACF,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpE,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAClF;AAED,wBAAgB,4BAA4B,CAAC,EACzC,GAAG,EACH,GAAG,EACH,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACxB,EAAE,kCAAkC,2CA0PpC"}

package/esm/ui/PluggableApplicationRenderer.js

@@ -6,7 +6,6 @@ import { isAiAssistantContextChangedEvent, isCloseAiAssistantRequestedEvent, isD
 import { LoadingComponent, useAutoupdateRef } from "@gooddata/sdk-ui";
 import { bemFactory } from "@gooddata/sdk-ui-kit";
 import { now } from "../debug.js";
-import { dispatchHostNotification } from "../lib/hostNotifications.js";
 import { getSecuredRemoteAppValidUntil, validateAppSecurity, } from "../loader/appSecurityValidation.js";
 import { getAppLifecycleCallbacks, loadPluggableApplication } from "../loader/pluggableApplicationsLoader.js";
 import { getApplicationHref } from "../loader/routing.js";
@@ -21,12 +20,15 @@ const SECURITY_FAILURE_MESSAGES = {
     "build-expired": defineMessage({ id: "gs.host.error.appBuildExpired" }),
     "metadata-missing": defineMessage({ id: "gs.host.error.appSecurityMetadataMissing" }),
 };
-export function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOpen, onHeaderChange, onDocumentTitleChange, }) {
+export function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOpen, onOpenAiAssistant, onCloseAiAssistant, onAiAssistantContext, aiLinkClickHandlerRef, onHeaderChange, onDocumentTitleChange, }) {
     const intl = useIntl();
     const intlRef = useAutoupdateRef(intl);
     const ctxRef = useAutoupdateRef(ctx);
     const onHeaderChangeRef = useAutoupdateRef(onHeaderChange);
     const onDocumentTitleChangeRef = useAutoupdateRef(onDocumentTitleChange);
+    const onOpenAiAssistantRef = useAutoupdateRef(onOpenAiAssistant);
+    const onCloseAiAssistantRef = useAutoupdateRef(onCloseAiAssistant);
+    const onAiAssistantContextRef = useAutoupdateRef(onAiAssistantContext);
     const containerRef = useRef(null);
     const mountHandleRef = useRef(undefined);
     // The app/module pair currently mounted. Held so the context-change effect can
@@ -47,32 +49,35 @@ export function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOp
             return;
         }
         // The active pluggable application owns no chat dialog on hosted routes; it requests
-        // the host's single assistant through these events (open/ask and tag-scope changes),
-        // which the host chrome consumes via the notification channel.
+        // the host's single (host-owned) assistant through these events (open/ask, close and
+        // tag-scope changes), which the host runtime drives directly via these callbacks.
         if (isOpenAiAssistantRequestedEvent(event)) {
-            dispatchHostNotification({
-                type: "openAiAssistant",
-                question: event.payload.question,
-                userContext: event.payload.userContext,
-            });
+            onOpenAiAssistantRef.current?.(event.payload.question, event.payload.userContext);
             return;
         }
         if (isCloseAiAssistantRequestedEvent(event)) {
-            dispatchHostNotification({ type: "closeAiAssistant" });
+            onCloseAiAssistantRef.current?.();
             return;
         }
         if (isAiAssistantContextChangedEvent(event)) {
-            dispatchHostNotification({
-                type: "aiAssistantContext",
+            onAiAssistantContextRef.current?.({
                 includeTags: event.payload.includeTags,
                 excludeTags: event.payload.excludeTags,
+                dialogPosition: event.payload.dialogPosition,
+                embedded: event.payload.embedded,
             });
             return;
         }
         if (isDocumentTitleChangedEvent(event)) {
             onDocumentTitleChangeRef.current?.(app.id, event.payload.pageTitle);
         }
-    }, [app.id, onDocumentTitleChangeRef]);
+    }, [
+        app.id,
+        onDocumentTitleChangeRef,
+        onOpenAiAssistantRef,
+        onCloseAiAssistantRef,
+        onAiAssistantContextRef,
+    ]);
     useEffect(() => {
         let cancelled = false;
         const mountId = `${app.id}:${Date.now()}`;
@@ -181,6 +186,19 @@ export function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOp
         }
         mountHandleRef.current?.setAiAssistantOpen?.(aiAssistantOpen);
     }, [aiAssistantOpen, viewState.state]);
+    // Expose a host-chat link-click delegate that defers to the active app's mount handle, so an
+    // embedded app can handle clicks in-app (e.g. open a visualization overlay) rather than navigating.
+    // Read through the ref at call time so it always targets the currently mounted app.
+    useEffect(() => {
+        const ref = aiLinkClickHandlerRef;
+        if (!ref) {
+            return;
+        }
+        ref.current = (link) => mountHandleRef.current?.onAiAssistantLinkClicked?.(link) ?? false;
+        return () => {
+            ref.current = undefined;
+        };
+    }, [aiLinkClickHandlerRef]);
     return (_jsxs("section", { className: b(), children: [viewState.state === "loading" ? (_jsx("div", { className: e("loading"), children: _jsx(LoadingComponent, { height: 40 }) })) : null, viewState.state === "error" ? (_jsxs("div", { className: e("error"), children: [
                     _jsx("h2", { children: _jsx(FormattedMessage, { id: "gs.host.error.applicationFailedToLoad" }) }), _jsx("p", { children: viewState.message })
                 ] })) : null, _jsx("div", { ref: containerRef, className: e("container", { visible: viewState.state === "ready" }) }), viewState.state === "ready" && viewState.validUntil !== undefined ? (_jsx("div", { className: e("demoBadge"), role: "status", children: _jsx(FormattedMessage, { id: "gs.host.demoApp.validUntil", values: {