@gooddata/sdk-ui-pluggable-host 11.42.0-alpha.3 → 11.42.0-alpha.5

package/esm/translations/zh-HK.json

@@ -24,19 +24,6 @@
     "gs.host.demoApp.validUntil": "示範應用程式有效期至 {date}",
     "gs.host.notification.newDeployment.message": "有新版本的 GoodData 可供使用。",
     "gs.host.notification.newDeployment.reloadLink": "重新載入",
-    "gs.header.helpMenu.gettingStarted": "開始使用",
-    "gs.header.helpMenu.connectData": "連接數據",
-    "gs.header.helpMenu.manage.ws": "管理工作區和工作區層次結構",
-    "gs.header.helpMenu.manage.user": "管理使用者和使用者群組",
-    "gs.header.helpMenu.connecting": "連接數據",
-    "gs.header.helpMenu.starting": "開始使用 LDM Modeler",
-    "gs.header.helpMenu.modeling": "深入了解資料建模",
-    "gs.header.helpMenu.understanding": "了解邏輯數據模型",
-    "gs.header.helpMenu.learning": "學習資料建模原則",
-    "gs.header.helpMenu.firstSteps": "分析設計器的第一步",
-    "gs.header.helpMenu.visualizing": "可視化數據",
-    "gs.header.helpMenu.sorting": "對結果進行排序和篩選",
-    "gs.header.helpMenu.embedding": "把Analytical Designer嵌入到應用中",
     "messages.genAi.visualisation.saved.success": "很好！我哋儲存咗您嘅可視化效果。",
     "messages.genAi.visualisation.saved.error": "糟糕，保存可視化時出現問題。",
     "messages.genAi.visualisation.saved.error.detail": "{errorType}: {errorMessage}",

package/esm/translations/zh-Hans.json

@@ -24,19 +24,6 @@
     "gs.host.demoApp.validUntil": "演示应用程序有效期至 {date}",
     "gs.host.notification.newDeployment.message": "GoodData 的新版本已可用。",
     "gs.host.notification.newDeployment.reloadLink": "重新加载",
-    "gs.header.helpMenu.gettingStarted": "开始使用",
-    "gs.header.helpMenu.connectData": "连接数据",
-    "gs.header.helpMenu.manage.ws": "管理工作区和工作区层次结构",
-    "gs.header.helpMenu.manage.user": "管理用户和用户组",
-    "gs.header.helpMenu.connecting": "连接数据",
-    "gs.header.helpMenu.starting": "开始使用 LDM Modeler",
-    "gs.header.helpMenu.modeling": "深入了解数据建模",
-    "gs.header.helpMenu.understanding": "了解逻辑数据模型",
-    "gs.header.helpMenu.learning": "学习数据建模原理",
-    "gs.header.helpMenu.firstSteps": "Analytical Designer 的使用入门",
-    "gs.header.helpMenu.visualizing": "可视化您的数据",
-    "gs.header.helpMenu.sorting": "对结果进行排序和筛选",
-    "gs.header.helpMenu.embedding": "将 Analytical Designer 嵌入您的应用",
     "messages.genAi.visualisation.saved.success": "太棒了！我们已保存您的可视化。",
     "messages.genAi.visualisation.saved.error": "哎呀，保存可视化时出现问题。",
     "messages.genAi.visualisation.saved.error.detail": "{errorType}: {errorMessage}",

package/esm/translations/zh-Hant.json

@@ -24,19 +24,6 @@
     "gs.host.demoApp.validUntil": "示範應用程式有效至 {date}",
     "gs.host.notification.newDeployment.message": "有新版本的 GoodData 可供使用。",
     "gs.host.notification.newDeployment.reloadLink": "重新載入",
-    "gs.header.helpMenu.gettingStarted": "開始使用",
-    "gs.header.helpMenu.connectData": "連接資料",
-    "gs.header.helpMenu.manage.ws": "管理工作區與工作區階層",
-    "gs.header.helpMenu.manage.user": "管理使用者與使用者群組",
-    "gs.header.helpMenu.connecting": "連接資料",
-    "gs.header.helpMenu.starting": "開始使用 LDM Modeler",
-    "gs.header.helpMenu.modeling": "深入了解資料建模",
-    "gs.header.helpMenu.understanding": "了解邏輯資料模型",
-    "gs.header.helpMenu.learning": "學習資料建模原則",
-    "gs.header.helpMenu.firstSteps": "分析設計器的第一步",
-    "gs.header.helpMenu.visualizing": "視覺化您的數據",
-    "gs.header.helpMenu.sorting": "對結果進行排序和過濾",
-    "gs.header.helpMenu.embedding": "將分析設計器嵌入到您的應用程式中",
     "messages.genAi.visualisation.saved.success": "偉大的！我們保存了您的視覺化。",
     "messages.genAi.visualisation.saved.error": "哎呀，保存可視化時出現問題。",
     "messages.genAi.visualisation.saved.error.detail": "{errorType}: {errorMessage}",

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

@@ -1 +1 @@
-{"version":3,"file":"DefaultHostUi.d.ts","sourceRoot":"","sources":["../../src/ui/DefaultHostUi.tsx"],"names":[],"mappings":"AAQA,OAAO,EAEH,KAAK,aAAa,EAKrB,MAAM,2CAA2C,CAAC;AAInD,OAAO,sBAAsB,CAAC;AAgK9B;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAEjC,CAAC"}
+{"version":3,"file":"DefaultHostUi.d.ts","sourceRoot":"","sources":["../../src/ui/DefaultHostUi.tsx"],"names":[],"mappings":"AAQA,OAAO,EAEH,KAAK,aAAa,EAKrB,MAAM,2CAA2C,CAAC;AAInD,OAAO,sBAAsB,CAAC;AA4M9B;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAEjC,CAAC"}

package/esm/ui/DefaultHostUi.js

@@ -1,35 +1,71 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 // (C) 2026 GoodData Corporation
-import { useLayoutEffect, useRef, useState } from "react";
+import { useCallback, useLayoutEffect, useRef, useState } from "react";
 import { flushSync } from "react-dom";
 import { createRoot } from "react-dom/client";
 import { HostChrome } from "./HostChrome.js";
 import { e } from "./hostChromeBem.js";
 import "./DefaultHostUi.scss";
-function HostUiBridge({ initialCtx, initialApps, initialPathname, navigate, replace, onAppContainerReady, onReady, }) {
+function HostUiBridge({ initialCtx, initialApps, initialPathname, navigate, replace, onAiAssistantOpenChange, onAppContainerReady, onReady, }) {
     const [ctx, setCtx] = useState(initialCtx);
     const [apps, setApps] = useState(initialApps);
     const [pathname, setPathname] = useState(initialPathname);
     const [headerOptions, setHeaderOptions] = useState(undefined);
     const [notification, setNotification] = useState(null);
     const [pageTitle, setPageTitle] = useState(undefined);
+    // AI-assistant signals are kept in their own state slots, separate from the single generic
+    // `notification` slot. Open/close and context-change notifications can arrive in the same
+    // synchronous tick; routing them to independent state ensures one does not overwrite the
+    // other (a single shared slot would drop the earlier one — LX-2544).
+    const [aiVisibility, setAiVisibility] = useState(null);
+    const [aiContext, setAiContext] = useState(null);
+    const aiVisibilitySeqRef = useRef(0);
     const appContainerRef = useRef(null);
+    const handleNotify = useCallback((notification) => {
+        if (notification === null) {
+            setNotification(null);
+            return;
+        }
+        switch (notification.type) {
+            case "openAiAssistant":
+                setAiVisibility({
+                    kind: "open",
+                    question: notification.question,
+                    userContext: notification.userContext,
+                    // A fresh seq on every request re-triggers the host effect even when the
+                    // question is identical to the previous one (e.g. "Summarize" clicked again).
+                    seq: ++aiVisibilitySeqRef.current,
+                });
+                break;
+            case "closeAiAssistant":
+                setAiVisibility({ kind: "close", seq: ++aiVisibilitySeqRef.current });
+                break;
+            case "aiAssistantContext":
+                setAiContext({
+                    includeTags: notification.includeTags,
+                    excludeTags: notification.excludeTags,
+                });
+                break;
+            default:
+                setNotification(notification);
+        }
+    }, []);
     // Layout effect runs in the same synchronous commit as flushSync.
     useLayoutEffect(() => {
-        onReady(setCtx, setApps, setPathname, setHeaderOptions, setNotification, setPageTitle);
+        onReady(setCtx, setApps, setPathname, setHeaderOptions, handleNotify, setPageTitle);
         if (appContainerRef.current) {
             onAppContainerReady(appContainerRef.current);
         }
         // Only call once on mount
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
-    return (_jsx(HostChrome, { ctx: ctx, resolvedApplications: apps, pathname: pathname, onNavigate: navigate, onReplace: replace, headerOptions: headerOptions, notification: notification, appPageTitle: pageTitle, children: _jsx("div", { ref: appContainerRef, className: e("app-container") }) }));
+    return (_jsx(HostChrome, { ctx: ctx, resolvedApplications: apps, pathname: pathname, onNavigate: navigate, onReplace: replace, headerOptions: headerOptions, notification: notification, aiVisibility: aiVisibility, aiContext: aiContext, onAiAssistantOpenChange: onAiAssistantOpenChange, appPageTitle: pageTitle, children: _jsx("div", { ref: appContainerRef, className: e("app-container") }) }));
 }
 // ---------------------------------------------------------------------------
 // Imperative mount function conforming to IHostUiModule
 // ---------------------------------------------------------------------------
 function mountDefaultHostUi(options) {
-    const { container, ctx, resolvedApplications, pathname, navigate, replace } = options;
+    const { container, ctx, resolvedApplications, pathname, navigate, replace, onAiAssistantOpenChange } = options;
     let reactRoot = createRoot(container);
     let appContainer = null;
     let updateCtxFn = null;
@@ -41,7 +77,7 @@ function mountDefaultHostUi(options) {
     // Use flushSync so that the DOM is ready synchronously after mount() returns,
     // making getAppContainer() safe to call immediately.
     flushSync(() => {
-        reactRoot?.render(_jsx(HostUiBridge, { initialCtx: ctx, initialApps: resolvedApplications, initialPathname: pathname, navigate: navigate, replace: replace, onAppContainerReady: (el) => {
+        reactRoot?.render(_jsx(HostUiBridge, { initialCtx: ctx, initialApps: resolvedApplications, initialPathname: pathname, navigate: navigate, replace: replace, onAiAssistantOpenChange: onAiAssistantOpenChange, onAppContainerReady: (el) => {
                 appContainer = el;
             }, onReady: (setCtx, setApps, setPathname, setHeaderOptions, setNotification, setPageTitle) => {
                 updateCtxFn = setCtx;

package/esm/ui/GenAIChat.d.ts

@@ -1,4 +1,5 @@
 import { type IUserWorkspaceSettings } from "@gooddata/sdk-backend-spi";
+import type { IGenAIUserContext } from "@gooddata/sdk-model";
 import { type ChatAssistantMessageEvent, type ChatClosedEvent, type ChatFeedbackEvent, type ChatOpenedEvent, type ChatResetEvent, type ChatUserMessageEvent } from "@gooddata/sdk-ui-gen-ai";
 /**
  * Discriminated union of GenAI chat events that are forwarded to the host
@@ -34,11 +35,30 @@ export interface IGenAIChatProps {
     onOpen: () => void;
     onClose: () => void;
     askedQuestion?: string | null;
+    /**
+     * Monotonic counter bumped on every ask. Keying the seeding effect on it re-seeds the chat
+     * (clear thread + send message) even when `askedQuestion` is identical to the previous ask.
+     */
+    askSeq?: number;
+    /**
+     * Context of the user's location when the question was asked (e.g. the active dashboard
+     * of a hosted application), passed to the assistant alongside the seeded question.
+     */
+    userContext?: IGenAIUserContext;
+    /**
+     * Tag identifiers the assistant's object search/autocomplete should be restricted to,
+     * reflecting the active hosted application's current view.
+     */
+    includeTags?: string[];
+    /**
+     * Tag identifiers the assistant's object search/autocomplete should exclude.
+     */
+    excludeTags?: string[];
     canManageProject?: boolean;
     canAnalyzeProject?: boolean;
     canFullControl?: boolean;
     settings?: IUserWorkspaceSettings;
     onEvent?: (event: GenAIChatEvent) => void;
 }
-export declare function GenAIChat({ workspaceId, open, onOpen, onClose, askedQuestion, canManageProject, canAnalyzeProject, canFullControl, settings, onEvent }: IGenAIChatProps): import("react/jsx-runtime").JSX.Element;
+export declare function GenAIChat({ workspaceId, open, onOpen, onClose, askedQuestion, askSeq, userContext, includeTags, excludeTags, canManageProject, canAnalyzeProject, canFullControl, settings, onEvent }: IGenAIChatProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=GenAIChat.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GenAIChat.d.ts","sourceRoot":"","sources":["../../src/ui/GenAIChat.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGxE,OAAO,EACH,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAY5B,MAAM,yBAAyB,CAAC;AAWjC;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACpB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,OAAO,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAI7E,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC7C;AAED,wBAAgB,SAAS,CAAC,EACtB,WAAW,EACX,IAAI,EACJ,MAAM,EACN,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,OAAO,EACV,EAAE,eAAe,2CAyHjB"}
+{"version":3,"file":"GenAIChat.d.ts","sourceRoot":"","sources":["../../src/ui/GenAIChat.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,KAAK,EAAmB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EACH,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EAY5B,MAAM,yBAAyB,CAAC;AAYjC;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACpB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,eAAe,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,OAAO,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAI7E,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC7C;AAED,wBAAgB,SAAS,CAAC,EACtB,WAAW,EACX,IAAI,EACJ,MAAM,EACN,OAAO,EACP,aAAa,EACb,MAAM,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,OAAO,EACV,EAAE,eAAe,2CAgIjB"}

package/esm/ui/GenAIChat.js

@@ -4,9 +4,9 @@ import { useCallback, useEffect, useMemo, useState } 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, } from "@gooddata/sdk-ui-gen-ai/internal";
+import { GenAIChatDialog, clearThreadAction, makeTextContents, makeUserMessage, newMessageAction, setUserContextAction, } 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, canManageProject, canAnalyzeProject, canFullControl, settings, onEvent, }) {
+export function GenAIChat({ workspaceId, open, onOpen, onClose, askedQuestion, askSeq, userContext, includeTags, excludeTags, canManageProject, canAnalyzeProject, canFullControl, settings, onEvent, }) {
     const { addSuccess, addError } = useToastMessage();
     const intl = useIntl();
     const backend = useBackendStrict();
@@ -91,12 +91,17 @@ export function GenAIChat({ workspaceId, open, onOpen, onClose, askedQuestion, c
             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, [])])));
         }
-    }, [chatDispatcher, askedQuestion, settings]);
-    return (_jsx(GenAIChatDialog, { isOpen: open, locale: intl.locale, canManage: canManageProject, canAnalyze: canAnalyzeProject, canFullControl: canFullControl, objectTypes: objectTypes, onLinkClick: onLinkClick, onClose: onClose, onOpen: onOpen, workspace: workspaceId, backend: backend, settings: settings, eventHandlers: events, onDispatcher: onDispatcher, returnFocusTo: HEADER_CHAT_BUTTON_ID }));
+        // `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 }));
 }

package/esm/ui/HostChrome.d.ts

@@ -1,11 +1,28 @@
 import { type ReactNode } from "react";
-import { type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
+import { type IGenAIUserContext, type PluggableApplicationRegistryItem } from "@gooddata/sdk-model";
 import { type IAppHeaderOptions, type IHostUiNotification, type IPlatformContext } from "@gooddata/sdk-pluggable-application-model";
 import "./HostChrome.scss";
 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[];
@@ -14,6 +31,12 @@ 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;
     /**
      * 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.
@@ -21,5 +44,5 @@ export interface IHostChromeProps {
     appPageTitle?: string;
     children?: ReactNode;
 }
-export declare function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification, appPageTitle, children }: IHostChromeProps): import("react/jsx-runtime").JSX.Element;
+export declare function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification, aiVisibility, aiContext, onAiAssistantOpenChange, 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,EAAwB,MAAM,OAAO,CAAC;AAElG,OAAO,EAGH,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;AAIlE,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,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,YAAY,EACZ,QAAQ,EACX,EAAE,gBAAgB,2CAwNlB"}
+{"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"}

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, useMemo } from "react";
+import { useCallback, useEffect, useMemo } from "react";
 import { isExternalPluggableApplicationRegistryItem, } from "@gooddata/sdk-model";
 import { BackendProvider, resolveLocale } from "@gooddata/sdk-ui";
 import { AppHeaderNotifications } from "@gooddata/sdk-ui-application-header";
@@ -30,13 +30,62 @@ 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";
 const LOGOUT_MENU_ITEM_KEY = "gs.header.logout";
-export function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, onReplace: _onReplace, headerOptions, notification = null, appPageTitle, children, }) {
+// The favicon that index.html shipped — resolved to "<cdnurl>/organization/favicon.ico" on the live
+// platform, "/favicon.ico" in dev. Captured once at module load, before DocumentHeader can overwrite
+// the <link rel="icon">, so the host can restore the organization favicon when no custom white-label
+// 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, }) {
     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]);
     const search = useHostChromeSearch({
         features,
         isTrial: pricing.isTrial,
@@ -105,11 +154,13 @@ export function HostChrome({ ctx, resolvedApplications, pathname, onNavigate, on
     const logoTitle = ctx.whiteLabeling?.enabled
         ? ctx.user.organizationName || defaultLogoTitle
         : defaultLogoTitle;
-    // White-label icons are applied whenever their URLs are set, independent of the `enabled`
-    // flag (matching the standalone apps and the Appearance behavior). The favicon falls back to
-    // the default served at /favicon.ico so a previously applied custom favicon is reset once its
-    // URL is cleared, instead of leaving the stale icon in place.
-    const faviconUrl = ctx.whiteLabeling?.faviconUrl || "/favicon.ico";
+    // White-label icons are applied whenever their URLs are set, independent of the `enabled` flag
+    // (matching the standalone apps and the Appearance behavior). When no custom favicon is set we
+    // fall back to the favicon index.html shipped (the organization favicon) instead of a hardcoded
+    // "/favicon.ico": on the live platform index.html resolves the icon to
+    // "<cdnurl>/organization/favicon.ico", and "/favicon.ico" is not served at the origin root — so
+    // hardcoding it removed the favicon once a module mounted (DocumentHeader overwrites the link).
+    const faviconUrl = ctx.whiteLabeling?.faviconUrl || initialFaviconUrl;
     // The host owns the browser tab title as "{page} - {brand}". The page segment defaults to the
     // active application's manifest title, but an embedded app can override it dynamically by emitting
     // a document-title-changed event (surfaced here as `appPageTitle`). When white-labeling
@@ -131,9 +182,9 @@ 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.open, notificationsPanel: ctx.userSettings.enableInPlatformNotifications
+                                , 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 }), chat.element, pricing.element, _jsx(HostNotificationDispatcher, { notification: notification })
+                                    : undefined }) })), _jsx("main", { className: e("content"), children: children }), hideChrome ? null : chat.element, pricing.element, _jsx(HostNotificationDispatcher, { notification: notification })
                     ] }) }) }) }));
 }

package/esm/ui/PluggableApplicationRenderer.d.ts

@@ -5,8 +5,10 @@ export interface IPluggableApplicationRendererProps {
     app: PluggableApplicationRegistryItem;
     ctx: IPlatformContext;
     pathname: string;
+    /** Host-owned AI assistant chat open-state, forwarded to the mounted app's handle. */
+    aiAssistantOpen?: boolean;
     onHeaderChange?: (appId: string, header: IAppHeaderOptions) => void;
     onDocumentTitleChange?: (appId: string, pageTitle: string | undefined) => void;
 }
-export declare function PluggableApplicationRenderer({ app, ctx, pathname, onHeaderChange, onDocumentTitleChange }: IPluggableApplicationRendererProps): import("react/jsx-runtime").JSX.Element;
+export declare function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOpen, 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,EAMxB,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,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,cAAc,EACd,qBAAqB,EACxB,EAAE,kCAAkC,2CAsMpC"}
+{"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"}

package/esm/ui/PluggableApplicationRenderer.js

@@ -2,10 +2,11 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // (C) 2026 GoodData Corporation
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { FormattedMessage, defineMessage, useIntl } from "react-intl";
-import { isDocumentTitleChangedEvent, isReloadPlatformContextRequestedEvent, } from "@gooddata/sdk-pluggable-application-model";
+import { isAiAssistantContextChangedEvent, isCloseAiAssistantRequestedEvent, isDocumentTitleChangedEvent, isOpenAiAssistantRequestedEvent, isReloadPlatformContextRequestedEvent, } from "@gooddata/sdk-pluggable-application-model";
 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";
@@ -20,7 +21,7 @@ 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, onHeaderChange, onDocumentTitleChange, }) {
+export function PluggableApplicationRenderer({ app, ctx, pathname, aiAssistantOpen, onHeaderChange, onDocumentTitleChange, }) {
     const intl = useIntl();
     const intlRef = useAutoupdateRef(intl);
     const ctxRef = useAutoupdateRef(ctx);
@@ -45,6 +46,29 @@ export function PluggableApplicationRenderer({ app, ctx, pathname, onHeaderChang
             void BackendPlatformContextProvider.load();
             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.
+        if (isOpenAiAssistantRequestedEvent(event)) {
+            dispatchHostNotification({
+                type: "openAiAssistant",
+                question: event.payload.question,
+                userContext: event.payload.userContext,
+            });
+            return;
+        }
+        if (isCloseAiAssistantRequestedEvent(event)) {
+            dispatchHostNotification({ type: "closeAiAssistant" });
+            return;
+        }
+        if (isAiAssistantContextChangedEvent(event)) {
+            dispatchHostNotification({
+                type: "aiAssistantContext",
+                includeTags: event.payload.includeTags,
+                excludeTags: event.payload.excludeTags,
+            });
+            return;
+        }
         if (isDocumentTitleChangedEvent(event)) {
             onDocumentTitleChangeRef.current?.(app.id, event.payload.pageTitle);
         }
@@ -149,6 +173,14 @@ export function PluggableApplicationRenderer({ app, ctx, pathname, onHeaderChang
         }
         handle.updateContext?.(ctx);
     }, [ctx, intlRef, lifecycle]);
+    // Forward the host-owned chat open-state to the mounted app once it is ready, and on every
+    // change, so app-side assistant controls stay aligned with the real (host) state (LX-2544).
+    useEffect(() => {
+        if (viewState.state !== "ready" || aiAssistantOpen === undefined) {
+            return;
+        }
+        mountHandleRef.current?.setAiAssistantOpen?.(aiAssistantOpen);
+    }, [aiAssistantOpen, viewState.state]);
     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: {

package/esm/ui/useHostChromeChat.d.ts

@@ -1,9 +1,12 @@
 import { type ReactNode } from "react";
+import { type IGenAIUserContext } from "@gooddata/sdk-model";
 import { type IPlatformContext, type IPluggableAppTelemetryCallbacks } from "@gooddata/sdk-pluggable-application-model";
 import { type IHostChromeWorkspaceFeatures } from "./useHostChromeWorkspaceFeatures.js";
 export interface IHostChromeChat {
     /** The `<GenAIChat>` element to mount, or `null` when chat is gated off. */
     element: ReactNode;
+    /** Whether the chat dialog is currently open. */
+    isOpen: boolean;
     /**
      * Whether the chat entry point should be visible in the header. Reflects both the
      * feature-flag/permission gate and the runtime LLM availability probe.
@@ -11,8 +14,20 @@ export interface IHostChromeChat {
     showChatItem: boolean;
     /** Open the chat dialog. */
     open: () => void;
-    /** Open the chat dialog with a pre-seeded user question. */
-    askAiAssistant: (question: string) => void;
+    /** Close the chat dialog. */
+    close: () => void;
+    /** Toggle the chat dialog open/closed — used by the header chat button. */
+    toggle: () => void;
+    /**
+     * Open the chat dialog with a pre-seeded user question and optional user-location context
+     * (e.g. the active dashboard a hosted application forwards alongside the question).
+     */
+    askAiAssistant: (question: string, userContext?: IGenAIUserContext) => void;
+    /**
+     * Set the assistant's object-search tag scope, reflecting the active hosted application's
+     * current view (e.g. AD's include/exclude tag route filters). Pass empty/undefined to clear.
+     */
+    setTags: (includeTags?: string[], excludeTags?: string[]) => void;
 }
 export interface IUseHostChromeChatArgs {
     features: IHostChromeWorkspaceFeatures;

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

@@ -1 +1 @@
-{"version":3,"file":"useHostChromeChat.d.ts","sourceRoot":"","sources":["../../src/ui/useHostChromeChat.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAyB,MAAM,OAAO,CAAC;AAE9D,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,EACvC,MAAM,2CAA2C,CAAC;AAMnD,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAExF,MAAM,WAAW,eAAe;IAC5B,4EAA4E;IAC5E,OAAO,EAAE,SAAS,CAAC;IACnB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,4DAA4D;IAC5D,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,4BAA4B,CAAC;IACvC,GAAG,EAAE,gBAAgB,CAAC;IACtB,SAAS,EAAE,+BAA+B,GAAG,SAAS,CAAC;CAC1D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,sBAAsB,GAAG,eAAe,CAqDvG"}
+{"version":3,"file":"useHostChromeChat.d.ts","sourceRoot":"","sources":["../../src/ui/useHostChromeChat.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAyB,MAAM,OAAO,CAAC;AAE9D,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,+BAA+B,EACvC,MAAM,2CAA2C,CAAC;AAMnD,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAExF,MAAM,WAAW,eAAe;IAC5B,4EAA4E;IAC5E,OAAO,EAAE,SAAS,CAAC;IACnB,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,6EAA2E;IAC3E,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB;;;OAGG;IACH,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC5E;;;OAGG;IACH,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,4BAA4B,CAAC;IACvC,GAAG,EAAE,gBAAgB,CAAC;IACtB,SAAS,EAAE,+BAA+B,GAAG,SAAS,CAAC;CAC1D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,sBAAsB,GAAG,eAAe,CAkFvG"}

package/esm/ui/useHostChromeChat.js

@@ -14,25 +14,48 @@ import { GenAIChat } from "./GenAIChat.js";
 export function useHostChromeChat({ features, ctx, telemetry }) {
     const [isChatOpen, setIsChatOpen] = useState(false);
     const [askedQuestion, setAskedQuestion] = useState(null);
+    // Bumped on every ask so the chat re-seeds (clears the thread + sends the message) even when the
+    // same prompt is asked again — e.g. "Summarize" clicked twice, or repeated after a close (the
+    // seeding effect is otherwise keyed on the question text, which does not change on a repeat).
+    const [askSeq, setAskSeq] = useState(0);
+    const [userContext, setUserContext] = useState(undefined);
+    const [includeTags, setIncludeTags] = useState(undefined);
+    const [excludeTags, setExcludeTags] = useState(undefined);
     const open = useCallback(() => {
         setIsChatOpen(true);
     }, []);
     const close = useCallback(() => {
         setIsChatOpen(false);
     }, []);
-    const askAiAssistant = useCallback((question) => {
+    // The header chat button toggles the dialog (click to open, click again to close),
+    // matching the standalone apps' behavior (LX-2544).
+    const toggle = useCallback(() => {
+        setIsChatOpen((isOpen) => !isOpen);
+    }, []);
+    const askAiAssistant = useCallback((question, questionUserContext) => {
         setAskedQuestion(question);
+        setUserContext(questionUserContext);
+        setAskSeq((seq) => seq + 1);
         setIsChatOpen(true);
     }, []);
+    const setTags = useCallback((nextIncludeTags, nextExcludeTags) => {
+        // Normalize empty arrays to undefined so the chat treats "no scope" uniformly.
+        setIncludeTags(nextIncludeTags?.length ? nextIncludeTags : undefined);
+        setExcludeTags(nextExcludeTags?.length ? nextExcludeTags : undefined);
+    }, []);
     const handleChatEvent = useCallback((event) => {
         telemetry?.trackEvent(event.name, event.payload);
     }, [telemetry]);
     const showChatItem = useGenAiChatAvailability(getBackend(), features.workspaceId, features.showChat, features.canManageProject);
-    const element = features.showChat && features.workspaceId ? (_jsx(GenAIChat, { workspaceId: features.workspaceId, open: isChatOpen, onOpen: open, onClose: close, askedQuestion: askedQuestion, canManageProject: features.canManageProject, canAnalyzeProject: features.canAccessWorkbench, canFullControl: features.canFullControl, settings: ctx.workspaceSettings, onEvent: handleChatEvent })) : null;
+    const element = features.showChat && features.workspaceId ? (_jsx(GenAIChat, { workspaceId: features.workspaceId, open: isChatOpen, onOpen: open, onClose: close, askedQuestion: askedQuestion, askSeq: askSeq, userContext: userContext, includeTags: includeTags, excludeTags: excludeTags, canManageProject: features.canManageProject, canAnalyzeProject: features.canAccessWorkbench, canFullControl: features.canFullControl, settings: ctx.workspaceSettings, onEvent: handleChatEvent })) : null;
     return {
         element,
+        isOpen: isChatOpen,
         showChatItem,
         open,
+        close,
+        toggle,
         askAiAssistant,
+        setTags,
     };
 }