@burdenoff/fe-libs 2026.930.2 → 2026.930.3

package/dist/shared/assistant/preview/AssistantPreviewOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantPreviewOverlay.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/AssistantPreviewOverlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAA6B,KAAK,EAAE,EAAkB,MAAM,OAAO,CAAC;AA2E3E,eAAO,MAAM,uBAAuB,EAAE,EAAE,CAAC;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CA4F/D,CAAC"}
+{"version":3,"file":"AssistantPreviewOverlay.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/AssistantPreviewOverlay.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAA6B,KAAK,EAAE,EAAkB,MAAM,OAAO,CAAC;AA8E3E,eAAO,MAAM,uBAAuB,EAAE,EAAE,CAAC;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CA+F/D,CAAC"}

package/dist/shared/assistant/preview/AssistantPreviewOverlay.js

@@ -1,11 +1,12 @@
 import { useAssistantTr as e } from "../i18n.js";
 import { useAssistantStore as t } from "../store.js";
-import { useAssistantPreview as n } from "./context.js";
-import { useOverlayFocus as r } from "../ui/useOverlayFocus.js";
-import { Component as i } from "react";
-import { Fragment as a, jsx as o, jsxs as s } from "react/jsx-runtime";
+import { hasAssistantPreviewSurface as n } from "./types.js";
+import { useAssistantPreview as r } from "./context.js";
+import { useOverlayFocus as i } from "../ui/useOverlayFocus.js";
+import { Component as a } from "react";
+import { Fragment as o, jsx as s, jsxs as c } from "react/jsx-runtime";
 //#region src/shared/assistant/preview/AssistantPreviewOverlay.tsx
-var c = class extends i {
+var l = class extends a {
 	state = {
 		failed: !1,
 		shownFor: this.props.resetKey
@@ -25,44 +26,44 @@ var c = class extends i {
 	render() {
 		return this.state.failed ? this.props.fallback : this.props.children;
 	}
-}, l = ({ controller: e }) => /* @__PURE__ */ o(a, { children: e.render() }), u = ({ onClose: i }) => {
-	let a = n(), u = e(), d = t((e) => {
+}, u = ({ controller: e }) => /* @__PURE__ */ s(o, { children: e.render() }), d = ({ onClose: a }) => {
+	let o = r(), d = e(), f = t((e) => {
 		let t = e.activeConversationId, n = t ? e.processingByConversationId[t]?.messageId : null;
 		return !t || !n ? "idle" : `${t}:${n}#${e.conversations.find((e) => e.id === t)?.updatedAt ?? ""}`;
-	}), f = r("assistant-toggle-preview");
-	return a ? /* @__PURE__ */ s("div", {
-		ref: f,
+	}), p = i("assistant-toggle-preview");
+	return n(o) ? /* @__PURE__ */ c("div", {
+		ref: p,
 		tabIndex: -1,
 		className: "absolute inset-0 z-10 flex flex-col bg-bg-surface outline-none animate-in slide-in-from-right-2 fade-in duration-200",
 		role: "region",
-		"aria-label": a.label ?? u("preview.title", "Preview"),
+		"aria-label": o.label ?? d("preview.title", "Preview"),
 		"data-testid": "assistant-preview",
-		children: [/* @__PURE__ */ s("div", {
+		children: [/* @__PURE__ */ c("div", {
 			className: "flex items-center justify-between border-b border-border-default px-3 py-2",
-			children: [/* @__PURE__ */ o("span", {
+			children: [/* @__PURE__ */ s("span", {
 				className: "text-sm font-medium text-text-primary",
-				children: a.label ?? u("preview.title", "Preview")
-			}), /* @__PURE__ */ o("button", {
+				children: o.label ?? d("preview.title", "Preview")
+			}), /* @__PURE__ */ s("button", {
 				type: "button",
-				onClick: i,
+				onClick: a,
 				className: "rounded-md px-2 py-1 text-xs text-text-secondary transition-colors hover:bg-bg-sunken hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong",
-				"aria-label": u("preview.close", "Close preview"),
+				"aria-label": d("preview.close", "Close preview"),
 				"data-testid": "assistant-preview-close",
-				children: u("preview.close", "Close preview")
+				children: d("preview.close", "Close preview")
 			})]
-		}), /* @__PURE__ */ o("div", {
+		}), /* @__PURE__ */ s("div", {
 			className: "min-h-0 flex-1 overflow-y-auto",
-			children: /* @__PURE__ */ o(c, {
-				resetKey: d,
-				fallback: /* @__PURE__ */ o("p", {
+			children: /* @__PURE__ */ s(l, {
+				resetKey: f,
+				fallback: /* @__PURE__ */ s("p", {
 					className: "p-4 text-sm text-text-muted",
 					"data-testid": "assistant-preview-failed",
-					children: u("preview.failed", "The preview could not be displayed.")
+					children: d("preview.failed", "The preview could not be displayed.")
 				}),
-				children: /* @__PURE__ */ o(l, { controller: a })
+				children: /* @__PURE__ */ s(u, { controller: o })
 			})
 		})]
 	}) : null;
 };
 //#endregion
-export { u as AssistantPreviewOverlay };
+export { d as AssistantPreviewOverlay };

package/dist/shared/assistant/preview/types.d.ts

@@ -124,22 +124,32 @@ export type AssistantPreviewEvent = {
  *    DIFFERENT hook layout while the overlay is open is the classic
  *    "rendered more hooks than during the previous render" error. Keep one
  *    renderer per mounted preview, and branch inside it rather than swapping it.
+ *    The same goes for adding or dropping `render` itself: decide once whether
+ *    the controller is headless.
  *
  * Neither is enforced by the type system: a named function passed as a callback
  * satisfies the hooks lint, so nothing warns.
  */
 export interface AssistantPreviewController {
     /**
-     * The product's own preview surface. Returns JSX and is called during render,
-     * so it may use hooks like any component body.
+     * The product's own preview surface, drawn INSIDE the panel. Returns JSX and
+     * is called during render, so it may use hooks like any component body.
      *
      * ★ It is rendered as an OVERLAY over a still-mounted chat area — never as an
      * alternate view. Swapping the panel's body would unmount `AssistantChatArea`
      * and take the voice session, the in-flight turn, draft attachments and the
      * composer draft with it, while turn status lives on in the zustand store:
      * split-brain rather than a clean stop.
+     *
+     * ★★ OPTIONAL (BOFF-7799). Omit it when the product draws its preview on the
+     * page and wants only the events. BigConsole did exactly that, but `render`
+     * was required, so it also supplied an in-panel copy. The panel then offered a
+     * "Build preview" toggle for that copy, even with no run in the tab; it showed
+     * an empty rail captioned "Done", and opening it made the page copy stand
+     * down. Without `render` the panel shows no toggle, never opens the overlay
+     * and never publishes `data-assistant-overlay="preview"`.
      */
-    render: () => ReactNode;
+    render?: () => ReactNode;
     /**
      * Run-scoped progress. Optional: a product may want the surface without the
      * stream.
@@ -148,7 +158,27 @@ export interface AssistantPreviewController {
      * never disturb the assistant, and must never cause a retry.
      */
     onEvent?: (event: AssistantPreviewEvent) => void;
-    /** Toggle label. Product-neutral English fallback if omitted. */
+    /**
+     * Toggle label. Product-neutral English fallback if omitted. Unused by a
+     * headless controller, which has no toggle.
+     */
     label?: string;
 }
+/** A controller that draws a surface inside the panel: one with `render`. */
+export type AssistantPreviewSurfaceController = AssistantPreviewController & {
+    render: () => ReactNode;
+};
+/**
+ * Does this controller put a surface in the panel?
+ *
+ * ★★ ONE PREDICATE for the header's toggle, the panel's open flag and the
+ * overlay. If they each tested `render` themselves, one of them would drift and
+ * the panel could offer a toggle that opens nothing, or publish an overlay
+ * nobody can see (which Escape and every host would then believe is open).
+ *
+ * `null` and `undefined` answer false, like a controller with no `render`: in
+ * both cases there is nothing to draw. Only the bridge still cares about the
+ * difference, since a headless controller still gets events.
+ */
+export declare function hasAssistantPreviewSurface(controller: AssistantPreviewController | null | undefined): controller is AssistantPreviewSurfaceController;
 //# sourceMappingURL=types.d.ts.map

package/dist/shared/assistant/preview/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,mBAAmB,CAAA;CAAE,GAC3C;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,mBAAmB,CAAC;IACzB;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACrC,GACD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,mBAAmB,CAAC;IACzB;;;;;;;;OAQG;IACH,OAAO,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;IAC5C;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,SAAS,CAAC;IAExB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAEjD,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/preview/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,mBAAmB,CAAA;CAAE,GAC3C;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,mBAAmB,CAAC;IACzB;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACrC,GACD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,mBAAmB,CAAC;IACzB;;;;;;;;OAQG;IACH,OAAO,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;IAC5C;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,EAAE,MAAM,SAAS,CAAC;IAEzB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAEjD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,MAAM,iCAAiC,GAAG,0BAA0B,GAAG;IAC3E,MAAM,EAAE,MAAM,SAAS,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,0BAA0B,GAAG,IAAI,GAAG,SAAS,GACxD,UAAU,IAAI,iCAAiC,CAEjD"}

package/dist/shared/assistant/preview/types.js

@@ -0,0 +1,6 @@
+//#region src/shared/assistant/preview/types.ts
+function e(e) {
+	return typeof e?.render == "function";
+}
+//#endregion
+export { e as hasAssistantPreviewSurface };

package/dist/shared/assistant/ui/AIAssistantPanel.d.ts

@@ -57,6 +57,11 @@ export type AIAssistantPanelProps = PanelProps & {
      * ★ Absence is the off-switch — no controller, no toggle, no overlay and no
      * events. There is deliberately no second flag that could disagree with it.
      *
+     * ★★ A controller with no `render` is HEADLESS (BOFF-7799): its events flow
+     * as usual, but there is no toggle and no overlay, and the panel never
+     * publishes `data-assistant-overlay="preview"`. That is a product that draws
+     * its preview on the page and needs no second copy in here.
+     *
      * ★★ Passed through `AssistantOverlay`'s `panelProps`, its events keep flowing
      * after the panel closes: the overlay runs the bridge, and this panel then
      * runs none for the same controller (BOFF-7367, see `bridgeHost.tsx`).

package/dist/shared/assistant/ui/AIAssistantPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AIAssistantPanel.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/AIAssistantPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAU,KAAK,EAAE,EAAY,MAAM,OAAO,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIvE,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAkBrC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAKnE,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG;IAC/C,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CAkPtD,CAAC"}
+{"version":3,"file":"AIAssistantPanel.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/AIAssistantPanel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAU,KAAK,EAAE,EAAY,MAAM,OAAO,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIvE,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,6BAA6B,CAAC;AAkBrC,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,kBAAkB,CAAC;AAK1B,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG;IAC/C,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CA0PtD,CAAC"}

package/dist/shared/assistant/ui/AIAssistantPanel.js

@@ -6,95 +6,96 @@ import { useAssistantStore as i } from "../store.js";
 import { AssistantSpeechProvider as a } from "./AssistantSpeechProvider.js";
 import { AssistantConnectSourceProvider as o } from "./composer/connectSource.js";
 import { ASSISTANT_OVERLAY_ATTR as s, ASSISTANT_PANEL_ATTR as c, activePanelOverlay as l, escapeDismisses as u, nextPanelOverlays as d } from "./panelOverlays.js";
-import { AssistantPreviewProvider as f } from "../preview/context.js";
-import { useAssistantPreviewBridge as p } from "../preview/useAssistantPreviewBridge.js";
-import { panelOwnedPreviewBridge as m, useHostedAssistantPreviewBridge as h } from "../preview/bridgeHostContext.js";
-import { AssistantPreviewOverlay as g } from "../preview/AssistantPreviewOverlay.js";
-import { AssistantHeader as _ } from "./AssistantHeader.js";
-import { AssistantConversationList as v } from "./AssistantConversationList.js";
-import { useAssistantServerHistory as y } from "../history/useAssistantServerHistory.js";
-import { useFilesServiceWarmup as b } from "../../../storage/warmFilesService.js";
-import { useAssistantHeartbeat as x } from "../useAssistantHeartbeat.js";
-import { useAssistantKeyboardShortcuts as S } from "../useAssistantKeyboardShortcuts.js";
-import { AssistantChatArea as C } from "./AssistantChatArea.js";
-import { useRef as w, useState as T } from "react";
-import { jsx as E, jsxs as D } from "react/jsx-runtime";
+import { hasAssistantPreviewSurface as f } from "../preview/types.js";
+import { AssistantPreviewProvider as p } from "../preview/context.js";
+import { useAssistantPreviewBridge as m } from "../preview/useAssistantPreviewBridge.js";
+import { panelOwnedPreviewBridge as h, useHostedAssistantPreviewBridge as g } from "../preview/bridgeHostContext.js";
+import { AssistantPreviewOverlay as _ } from "../preview/AssistantPreviewOverlay.js";
+import { AssistantHeader as v } from "./AssistantHeader.js";
+import { AssistantConversationList as y } from "./AssistantConversationList.js";
+import { useAssistantServerHistory as b } from "../history/useAssistantServerHistory.js";
+import { useFilesServiceWarmup as x } from "../../../storage/warmFilesService.js";
+import { useAssistantHeartbeat as S } from "../useAssistantHeartbeat.js";
+import { useAssistantKeyboardShortcuts as C } from "../useAssistantKeyboardShortcuts.js";
+import { AssistantChatArea as w } from "./AssistantChatArea.js";
+import { useRef as T, useState as E } from "react";
+import { jsx as D, jsxs as O } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/AIAssistantPanel.tsx
-var O = ({ onClose: O, visible: k, docked: A, onToggleDock: j, writeAccess: M, onNavigate: N, connectSourceHref: P, onConnectSource: F, preview: I, serverHistory: L = !1 }) => {
+var k = ({ onClose: k, visible: A, docked: j, onToggleDock: M, writeAccess: N, onNavigate: ee, connectSourceHref: P, onConnectSource: F, preview: I, serverHistory: L = !1 }) => {
 	let R = n();
-	y(L);
-	let [z, B] = T(!1);
-	z && !I && B(!1);
-	let V = z && !!I;
-	p(m(I, h()));
-	let H = w(null);
-	e(H);
-	let { conversations: U, activeConversationId: W, conversationListOpen: G, setConversationListOpen: K, createConversation: q } = i(), J = G || V, Y = l({
-		historyOpen: G,
-		previewOpen: V
-	}), X = (e) => {
+	b(L);
+	let [z, B] = E(!1), V = f(I);
+	z && !V && B(!1);
+	let H = z && V;
+	m(h(I, g()));
+	let U = T(null);
+	e(U);
+	let { conversations: W, activeConversationId: G, conversationListOpen: K, setConversationListOpen: q, createConversation: J } = i(), Y = K || H, X = l({
+		historyOpen: K,
+		previewOpen: H
+	}), Z = (e) => {
 		let t = d({
-			historyOpen: G,
-			previewOpen: V
+			historyOpen: K,
+			previewOpen: H
 		}, e);
-		K(t.historyOpen), B(t.previewOpen);
-	}, Z = U.find((e) => e.id === W);
-	x(Z?.backendSessionId ?? null, Z?.mode ?? null, k ?? !0), b(k ?? !0);
-	let Q = t(k !== !1);
-	return S({
-		panelRef: H,
+		q(t.historyOpen), B(t.previewOpen);
+	}, Q = W.find((e) => e.id === G);
+	S(Q?.backendSessionId ?? null, Q?.mode ?? null, A ?? !0), x(A ?? !0);
+	let $ = t(A !== !1);
+	return C({
+		panelRef: U,
 		onClose: () => {
 			if (u({
-				historyOpen: G,
-				previewOpen: V
+				historyOpen: K,
+				previewOpen: H
 			}) === "overlay") {
-				K(!1), B(!1);
+				q(!1), B(!1);
 				return;
 			}
-			O();
+			k();
 		}
-	}), /* @__PURE__ */ E(a, {
-		visible: k ?? !0,
-		children: /* @__PURE__ */ E(f, {
+	}), /* @__PURE__ */ D(a, {
+		visible: A ?? !0,
+		children: /* @__PURE__ */ D(p, {
 			value: I,
-			children: /* @__PURE__ */ E(r, {
-				value: N,
-				children: /* @__PURE__ */ E(o, {
+			children: /* @__PURE__ */ D(r, {
+				value: ee,
+				children: /* @__PURE__ */ D(o, {
 					value: P,
 					onOpen: F,
-					children: /* @__PURE__ */ D("div", {
-						ref: H,
+					children: /* @__PURE__ */ O("div", {
+						ref: U,
 						className: "relative flex h-full w-full flex-col bg-bg-surface",
 						role: "complementary",
 						"aria-label": R("panel.ariaLabel", "AI Assistant"),
 						"data-testid": "ai-assistant-panel",
 						[c]: "",
-						...Y ? { [s]: Y } : {},
+						...X ? { [s]: X } : {},
 						tabIndex: -1,
 						children: [
-							/* @__PURE__ */ E("div", {
+							/* @__PURE__ */ D("div", {
 								className: "contents",
-								inert: J || void 0,
-								children: /* @__PURE__ */ E(_, {
-									contextLabel: Q,
-									onNewConversation: () => q(),
-									onOpenHistory: () => X("history"),
-									historyOpen: G,
-									onTogglePreview: () => X("preview"),
-									previewOpen: V,
-									onClose: O,
-									docked: A,
-									onToggleDock: j
+								inert: Y || void 0,
+								children: /* @__PURE__ */ D(v, {
+									contextLabel: $,
+									onNewConversation: () => J(),
+									onOpenHistory: () => Z("history"),
+									historyOpen: K,
+									onTogglePreview: () => Z("preview"),
+									previewOpen: H,
+									onClose: k,
+									docked: j,
+									onToggleDock: M
 								})
 							}),
-							G && /* @__PURE__ */ E(v, {}),
-							V && /* @__PURE__ */ E(g, { onClose: () => B(!1) }),
-							/* @__PURE__ */ E("div", {
+							K && /* @__PURE__ */ D(y, {}),
+							H && /* @__PURE__ */ D(_, { onClose: () => B(!1) }),
+							/* @__PURE__ */ D("div", {
 								className: "contents",
-								inert: J || void 0,
-								children: /* @__PURE__ */ E(C, {
-									visible: k ?? !0,
-									writeAccess: M
+								inert: Y || void 0,
+								children: /* @__PURE__ */ D(w, {
+									visible: A ?? !0,
+									writeAccess: N
 								})
 							})
 						]
@@ -105,4 +106,4 @@ var O = ({ onClose: O, visible: k, docked: A, onToggleDock: j, writeAccess: M, o
 	});
 };
 //#endregion
-export { O as AIAssistantPanel };
+export { k as AIAssistantPanel };

package/dist/shared/assistant/ui/AssistantEmptyState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantEmptyState.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/AssistantEmptyState.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAItE,UAAU,KAAK;IACb,IAAI,EAAE,aAAa,CAAC;IACpB;;;OAGG;IACH,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1E;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,EAAE,CAAC,KAAK,CA2EzC,CAAC"}
+{"version":3,"file":"AssistantEmptyState.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/AssistantEmptyState.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMtE,UAAU,KAAK;IACb,IAAI,EAAE,aAAa,CAAC;IACpB;;;OAGG;IACH,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IAC1E;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACxC;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,EAAE,CAAC,KAAK,CA8FzC,CAAC"}

package/dist/shared/assistant/ui/AssistantEmptyState.js

@@ -1,42 +1,48 @@
 import { resolveModeConfig as e, useAssistantPageLabel as t, useAssistantProduct as n } from "../product.js";
 import { useAssistantTr as r } from "../i18n.js";
-import { Sparkles as i } from "lucide-react";
-import { jsx as a, jsxs as o } from "react/jsx-runtime";
+import { hasConnectSource as i, useAssistantConnectSource as a } from "./composer/connectSource.js";
+import { AssistantConnectSourceItem as o } from "./composer/AssistantConnectSourceItem.js";
+import { Sparkles as s } from "lucide-react";
+import { jsx as c, jsxs as l } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/AssistantEmptyState.tsx
-var s = ({ mode: s, onSuggestionClick: c, suggestions: l, explainsAuto: u = !1 }) => {
-	let d = r(), { modes: f } = n(), p = e(f, s), m = t(), h = l ?? (p?.suggestions.slice(0, 4) ?? []).map((e) => ({ text: e }));
-	return /* @__PURE__ */ o("div", {
+var u = ({ mode: u, onSuggestionClick: d, suggestions: f, explainsAuto: p = !1 }) => {
+	let m = r(), { modes: h } = n(), g = e(h, u), _ = t(), v = f ?? (g?.suggestions.slice(0, 4) ?? []).map((e) => ({ text: e })), y = i(a());
+	return /* @__PURE__ */ l("div", {
 		className: "flex flex-1 flex-col items-center justify-center overflow-y-auto px-6 py-8 text-center",
 		children: [
-			/* @__PURE__ */ a("div", {
+			/* @__PURE__ */ c("div", {
 				className: "flex size-12 items-center justify-center rounded-2xl bg-gradient-to-br from-action-primary-bg/25 to-action-primary-bg/5 text-action-primary-bg shadow-sm",
-				children: /* @__PURE__ */ a(i, { className: "size-6" })
+				children: /* @__PURE__ */ c(s, { className: "size-6" })
 			}),
-			/* @__PURE__ */ a("h2", {
+			/* @__PURE__ */ c("h2", {
 				className: "mt-5 text-2xl font-semibold leading-tight tracking-tight text-text-primary",
-				children: d("empty.title", "How can I help?")
+				children: m("empty.title", "How can I help?")
 			}),
-			/* @__PURE__ */ a("p", {
+			/* @__PURE__ */ c("p", {
 				className: "mt-2 max-w-[16rem] text-[13px] leading-relaxed text-text-muted",
-				children: m ? d("empty.subtitle", "You're viewing {{page}}. Ask about it, or pick a suggestion below.", { page: m }) : d("empty.subtitleNoPage", "Ask me anything, or pick a suggestion below.")
+				children: _ ? m("empty.subtitle", "You're viewing {{page}}. Ask about it, or pick a suggestion below.", { page: _ }) : m("empty.subtitleNoPage", "Ask me anything, or pick a suggestion below.")
 			}),
-			u ? /* @__PURE__ */ a("p", {
+			p ? /* @__PURE__ */ c("p", {
 				className: "mt-2 max-w-[18rem] text-[12px] leading-relaxed text-text-muted",
 				"data-testid": "assistant-auto-explainer",
-				children: d("modeSelector.autoHint", "Answers your questions, and proposes changes for you to approve")
+				children: m("modeSelector.autoHint", "Answers your questions, and proposes changes for you to approve")
 			}) : null,
-			/* @__PURE__ */ a("div", {
+			/* @__PURE__ */ c("div", {
 				className: "mt-6 flex flex-wrap items-center justify-center gap-2",
-				children: h.map((e) => /* @__PURE__ */ a("button", {
+				children: v.map((e) => /* @__PURE__ */ c("button", {
 					type: "button",
-					onClick: () => c(e.text, e.intent),
+					onClick: () => d(e.text, e.intent),
 					className: "rounded-full border border-border-subtle bg-bg-surface px-3.5 py-2 text-[13px] leading-tight text-text-primary shadow-sm transition-[color,background-color,border-color,box-shadow] hover:border-action-primary-bg/40 hover:bg-bg-elevated hover:shadow-md",
 					"data-testid": "assistant-suggestion",
 					children: e.text
 				}, e.text))
-			})
+			}),
+			y ? /* @__PURE__ */ c("div", {
+				className: "mt-5",
+				children: /* @__PURE__ */ c(o, { presentation: "action" })
+			}) : null
 		]
 	});
 };
 //#endregion
-export { s as AssistantEmptyState };
+export { u as AssistantEmptyState };

package/dist/shared/assistant/ui/AssistantHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantHeader.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/AssistantHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAchC,UAAU,KAAK;IACb,qEAAqE;IACrE;;;;;;;OAOG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,KAAK,CA4IrC,CAAC"}
+{"version":3,"file":"AssistantHeader.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/AssistantHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAehC,UAAU,KAAK;IACb,qEAAqE;IACrE;;;;;;;OAOG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,KAAK,CA+IrC,CAAC"}

package/dist/shared/assistant/ui/AssistantHeader.js

@@ -1,81 +1,82 @@
 import { useAssistantTr as e } from "../i18n.js";
-import { useAssistantPreview as t } from "../preview/context.js";
-import { AssistantMoreMenu as n } from "./AssistantMoreMenu.js";
-import { Eye as r, History as i, PanelBottom as a, PanelRight as o, Plus as s, Sparkles as c, X as l } from "lucide-react";
-import { Fragment as u, jsx as d, jsxs as f } from "react/jsx-runtime";
+import { hasAssistantPreviewSurface as t } from "../preview/types.js";
+import { useAssistantPreview as n } from "../preview/context.js";
+import { AssistantMoreMenu as r } from "./AssistantMoreMenu.js";
+import { Eye as i, History as a, PanelBottom as o, PanelRight as s, Plus as c, Sparkles as l, X as u } from "lucide-react";
+import { Fragment as d, jsx as f, jsxs as p } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/AssistantHeader.tsx
-var p = ({ contextLabel: p, onNewConversation: m, onOpenHistory: h, historyOpen: g, onTogglePreview: _, previewOpen: v, onClose: y, docked: b, onToggleDock: x }) => {
-	let S = e(), C = t();
-	return /* @__PURE__ */ f("div", {
+var m = ({ contextLabel: m, onNewConversation: h, onOpenHistory: g, historyOpen: _, onTogglePreview: v, previewOpen: y, onClose: b, docked: x, onToggleDock: S }) => {
+	let C = e(), w = n();
+	return /* @__PURE__ */ p("div", {
 		className: "flex items-center gap-2 border-b border-border-default bg-bg-elevated px-3 py-2.5",
-		children: [/* @__PURE__ */ f("div", {
+		children: [/* @__PURE__ */ p("div", {
 			className: "flex min-w-0 flex-1 items-center gap-2",
-			children: [/* @__PURE__ */ d("span", {
+			children: [/* @__PURE__ */ f("span", {
 				className: "flex size-7 flex-shrink-0 items-center justify-center rounded-lg bg-gradient-to-br from-action-primary-bg/25 to-action-primary-bg/5 text-action-primary-bg",
-				children: /* @__PURE__ */ d(c, { className: "size-4" })
-			}), /* @__PURE__ */ f("span", {
+				children: /* @__PURE__ */ f(l, { className: "size-4" })
+			}), /* @__PURE__ */ p("span", {
 				className: "min-w-0 flex-1",
-				children: [/* @__PURE__ */ d("span", {
+				children: [/* @__PURE__ */ f("span", {
 					className: "block truncate text-[14px] font-semibold leading-tight text-text-primary",
-					children: S("header.title", "AI Assistant")
-				}), /* @__PURE__ */ f("span", {
+					children: C("header.title", "AI Assistant")
+				}), /* @__PURE__ */ p("span", {
 					className: "block truncate text-[11px] leading-tight text-text-muted",
-					children: [S("header.ready", "Ready"), p && /* @__PURE__ */ f(u, { children: [/* @__PURE__ */ d("span", {
+					children: [C("header.ready", "Ready"), m && /* @__PURE__ */ p(d, { children: [/* @__PURE__ */ f("span", {
 						"aria-hidden": "true",
 						children: " · "
-					}), S("header.context", "Context: {{page}}", { page: p })] })]
+					}), C("header.context", "Context: {{page}}", { page: m })] })]
 				})]
 			})]
-		}), /* @__PURE__ */ f("div", {
+		}), /* @__PURE__ */ p("div", {
 			className: "flex flex-shrink-0 items-center gap-0.5",
 			children: [
-				/* @__PURE__ */ d("button", {
+				/* @__PURE__ */ f("button", {
 					type: "button",
-					onClick: m,
+					onClick: h,
 					className: "rounded-lg p-1.5 text-text-secondary transition-colors hover:bg-bg-sunken hover:text-text-primary",
-					"aria-label": S("header.newConversation", "New conversation"),
+					"aria-label": C("header.newConversation", "New conversation"),
 					"data-testid": "assistant-new-conversation",
-					children: /* @__PURE__ */ d(s, { className: "size-4" })
+					children: /* @__PURE__ */ f(c, { className: "size-4" })
 				}),
-				/* @__PURE__ */ d("button", {
+				/* @__PURE__ */ f("button", {
 					type: "button",
-					onClick: h,
-					className: `rounded-lg p-1.5 transition-colors ${g ? "bg-action-primary-bg/15 text-action-primary-bg" : "text-text-secondary hover:bg-bg-sunken hover:text-text-primary"}`,
-					"aria-label": S("header.history", "Conversation history"),
-					"aria-pressed": g,
+					onClick: g,
+					className: `rounded-lg p-1.5 transition-colors ${_ ? "bg-action-primary-bg/15 text-action-primary-bg" : "text-text-secondary hover:bg-bg-sunken hover:text-text-primary"}`,
+					"aria-label": C("header.history", "Conversation history"),
+					"aria-pressed": _,
 					"data-testid": "assistant-open-history",
-					children: /* @__PURE__ */ d(i, { className: "size-4" })
+					children: /* @__PURE__ */ f(a, { className: "size-4" })
 				}),
-				C && _ && /* @__PURE__ */ d("button", {
+				t(w) && v && /* @__PURE__ */ f("button", {
 					type: "button",
-					onClick: _,
-					className: `rounded-lg p-1.5 transition-colors ${v ? "bg-action-primary-bg/15 text-action-primary-bg" : "text-text-secondary hover:bg-bg-sunken hover:text-text-primary"}`,
-					"aria-label": C.label ?? S("header.preview", "Preview"),
-					"aria-pressed": !!v,
+					onClick: v,
+					className: `rounded-lg p-1.5 transition-colors ${y ? "bg-action-primary-bg/15 text-action-primary-bg" : "text-text-secondary hover:bg-bg-sunken hover:text-text-primary"}`,
+					"aria-label": w.label ?? C("header.preview", "Preview"),
+					"aria-pressed": !!y,
 					"data-testid": "assistant-toggle-preview",
-					children: /* @__PURE__ */ d(r, { className: "size-4" })
+					children: /* @__PURE__ */ f(i, { className: "size-4" })
 				}),
-				/* @__PURE__ */ d(n, {}),
-				x && /* @__PURE__ */ d("button", {
+				/* @__PURE__ */ f(r, {}),
+				S && /* @__PURE__ */ f("button", {
 					type: "button",
-					onClick: x,
+					onClick: S,
 					className: "hidden rounded-lg p-1.5 text-text-secondary transition-colors hover:bg-bg-sunken hover:text-text-primary sm:inline-flex",
-					"aria-label": b ? S("header.float", "Float chat window") : S("header.dock", "Dock to side panel"),
-					"aria-pressed": b,
+					"aria-label": x ? C("header.float", "Float chat window") : C("header.dock", "Dock to side panel"),
+					"aria-pressed": x,
 					"data-testid": "assistant-toggle-dock",
-					children: d(b ? a : o, { className: "size-4" })
+					children: f(x ? o : s, { className: "size-4" })
 				}),
-				/* @__PURE__ */ d("button", {
+				/* @__PURE__ */ f("button", {
 					type: "button",
-					onClick: y,
+					onClick: b,
 					className: "rounded-lg p-1.5 text-text-secondary transition-colors hover:bg-bg-sunken hover:text-text-primary",
-					"aria-label": S("header.close", "Close assistant"),
+					"aria-label": C("header.close", "Close assistant"),
 					"data-testid": "assistant-close",
-					children: /* @__PURE__ */ d(l, { className: "size-4" })
+					children: /* @__PURE__ */ f(u, { className: "size-4" })
 				})
 			]
 		})]
 	});
 };
 //#endregion
-export { p as AssistantHeader };
+export { m as AssistantHeader };

package/dist/shared/assistant/ui/AssistantOverlay.d.ts

@@ -12,6 +12,11 @@ export interface AssistantOverlayContextValue {
     toggleDock: () => void;
     /** Width the docked panel takes from the page right now, in px (0 if none). */
     dockWidthPx: number;
+    /**
+     * How far the open assistant reaches in from the page's right edge, in px:
+     * docked or floating, 0 when closed or on a phone (BOFF-7799).
+     */
+    panelInsetPx: number;
     keys: AssistantOverlayKeys;
 }
 /** The overlay state in force, or null when no provider is mounted. */
@@ -22,6 +27,13 @@ export declare function useAssistantOverlayOrNull(): AssistantOverlayContextValu
  * published as `var(--assistant-dock-width)` on `<html>` for CSS consumers.
  */
 export declare function useAssistantDockWidth(): number;
+/**
+ * How far, in px, the open assistant reaches in from the right of the page,
+ * docked OR floating: 0 when it is closed, on a phone, or not mounted at all.
+ * The same value is published as `var(--assistant-panel-inset)` on `<html>`.
+ * See `ASSISTANT_PANEL_INSET_VAR` for why it differs from the dock width.
+ */
+export declare function useAssistantPanelInset(): number;
 /**
  * Listen for `<product>:quota-exhausted` and hand each wall to the product.
  *
@@ -62,7 +74,8 @@ export interface AssistantOverlayProviderProps {
  * the panel's own close and dock buttons) without each path remembering to
  * persist.
  *
- * Mount ONE per page: the published dock width is a single `<html>` variable.
+ * Mount ONE per page: the published dock width and panel inset are single
+ * `<html>` variables.
  */
 export declare function AssistantOverlayProvider({ keyPrefix, quota, children, }: AssistantOverlayProviderProps): import("react/jsx-runtime").JSX.Element;
 /** What the overlay hands the panel it renders. */