@burdenoff/fe-libs 2026.713.2 → 2026.713.3

package/dist/shared/components/assistantWidget/AssistantWidget.d.ts

@@ -13,6 +13,22 @@ export interface AssistantWidgetProps {
     launcherClassName?: string;
     /** Speech-recognition language tag. */
     voiceLang?: string;
+    /**
+     * `floating` (default) — the small bottom-right popover every product uses.
+     * `sidebar` — a full-height panel docked to the right edge, for products whose
+     * assistant does long multi-step work worth watching (BigConsole).
+     *
+     * Defaulted, so a product that passes nothing keeps the exact UI it has today.
+     */
+    layout?: 'floating' | 'sidebar';
+    /**
+     * Show the conversations rail (New chat / Clear chat / History).
+     * Ignored unless the transport actually implements session management —
+     * a panel whose buttons do nothing is worse than no panel.
+     */
+    showSessionPanel?: boolean;
+    /** Route in-app links from assistant replies without a full page reload. */
+    onNavigate?: (href: string) => void;
 }
 /** External toggle hook so command palettes / plugins can open the widget. */
 export declare const ASSISTANT_WIDGET_TOGGLE_EVENT = "bf:toggle-assistant-widget";

package/dist/shared/components/assistantWidget/AssistantWidget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantWidget.d.ts","sourceRoot":"","sources":["../../../../src/shared/components/assistantWidget/AssistantWidget.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAML,KAAK,EAAE,EAER,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EAAE,kBAAkB,EAA0B,MAAM,SAAS,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,SAAS,EAAE,kBAAkB,CAAC;IAC9B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,+BAA+B,CAAC;AAyB1E,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,oBAAoB,CAkVpD,CAAC"}
+{"version":3,"file":"AssistantWidget.d.ts","sourceRoot":"","sources":["../../../../src/shared/components/assistantWidget/AssistantWidget.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAML,KAAK,EAAE,EAER,MAAM,OAAO,CAAC;AAef,OAAO,KAAK,EAA2B,kBAAkB,EAA0B,MAAM,SAAS,CAAC;AAEnG,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,SAAS,EAAE,kBAAkB,CAAC;IAC9B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAChC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,8EAA8E;AAC9E,eAAO,MAAM,6BAA6B,+BAA+B,CAAC;AAyB1E,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,oBAAoB,CA+epD,CAAC"}

package/dist/shared/components/assistantWidget/AssistantWidget.js

@@ -1,86 +1,120 @@
 import { cn as e } from "../../utils/cn.js";
 import { useVoiceInput as t } from "./useVoiceInput.js";
-import { useCallback as n, useEffect as r, useMemo as i, useRef as a, useState as o } from "react";
-import { Loader2 as s, MessageCircle as c, Mic as l, Send as u, Sparkles as d, X as f } from "lucide-react";
-import { Fragment as p, jsx as m, jsxs as h } from "react/jsx-runtime";
+import { MessageContent as n } from "./MessageContent.js";
+import { useCallback as r, useEffect as i, useMemo as ee, useRef as a, useState as o } from "react";
+import { History as te, Loader2 as s, MessageCircle as ne, Mic as c, Plus as re, Send as ie, Sparkles as l, Trash2 as u, X as d } from "lucide-react";
+import { Fragment as f, jsx as p, jsxs as m } from "react/jsx-runtime";
 //#region src/shared/components/assistantWidget/AssistantWidget.tsx
-var g = "bf:toggle-assistant-widget", _ = "bf:assistant-widget:isOpen";
-function v() {
+var h = "bf:toggle-assistant-widget", g = "bf:assistant-widget:isOpen";
+function _() {
 	if (typeof window > "u") return !1;
 	try {
-		return window.sessionStorage.getItem(_) === "1";
+		return window.sessionStorage.getItem(g) === "1";
 	} catch {
 		return !1;
 	}
 }
-function y(e) {
+function v(e) {
 	if (!(typeof window > "u")) try {
-		window.sessionStorage.setItem(_, e ? "1" : "0");
+		window.sessionStorage.setItem(g, e ? "1" : "0");
 	} catch {}
 }
-function b() {
+function y() {
 	return `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
 }
-var x = ({ transport: _, title: x = "AI Assistant", subtitle: S = "Ask me to do things on this screen — I can run them for you.", placeholder: C = "Ask anything, or describe what to create…", launcherClassName: w, voiceLang: T = "en-US" }) => {
-	let [E, D] = o(() => v()), [O, k] = o([]), [A, j] = o(""), [M, N] = o(!1), [P, F] = o(!1), I = a(null), L = a(null), R = a(null), z = a(!1), B = t(T), V = n(() => {
-		y(!0), D(!0);
-	}, []), H = n(() => {
-		y(!1), D(!1);
-	}, []), U = n(() => {
-		D((e) => {
+var b = ({ transport: g, title: b = "AI Assistant", subtitle: x = "Ask me to do things on this screen — I can run them for you.", placeholder: ae = "Ask anything, or describe what to create…", launcherClassName: S, voiceLang: C = "en-US", layout: w = "floating", showSessionPanel: T = !1, onNavigate: E }) => {
+	let [D, O] = o(() => _()), [k, A] = o([]), [j, M] = o(""), [N, P] = o(!1), [F, I] = o(!1), [L, R] = o([]), [z, B] = o(!1), V = a(null), H = a(null), U = a(null), W = a(!1), G = w === "sidebar", K = T && !!(g.newSession && g.clearSession), q = t(C), J = r(() => {
+		v(!0), O(!0);
+	}, []), Y = r(() => {
+		v(!1), O(!1);
+	}, []), X = r(() => {
+		O((e) => {
 			let t = !e;
-			return y(t), t;
+			return v(t), t;
 		});
 	}, []);
-	r(() => {
+	i(() => {
 		let e = (e) => {
 			let t = e.detail;
-			t?.open === !0 ? V() : t?.open === !1 ? H() : U();
+			t?.open === !0 ? J() : t?.open === !1 ? Y() : X();
 		};
-		return window.addEventListener(g, e), () => window.removeEventListener(g, e);
+		return window.addEventListener(h, e), () => window.removeEventListener(h, e);
 	}, [
-		V,
-		H,
-		U
-	]), r(() => {
-		B.isListening && B.transcript && j(B.transcript);
-	}, [B.transcript, B.isListening]), r(() => {
-		if (!E || z.current) return;
-		let e = _.loadHistory;
+		J,
+		Y,
+		X
+	]), i(() => {
+		q.isListening && q.transcript && M(q.transcript);
+	}, [q.transcript, q.isListening]), i(() => {
+		if (!D || W.current) return;
+		let e = g.loadHistory;
 		if (!e) {
-			z.current = !0;
+			W.current = !0;
 			return;
 		}
-		z.current = !0;
+		W.current = !0;
 		let t = !1;
-		return F(!0), (async () => {
+		return I(!0), (async () => {
 			try {
 				let n = await e();
-				!t && n.length > 0 && k((e) => e.length === 0 ? n : e);
+				!t && n.length > 0 && A((e) => e.length === 0 ? n : e);
 			} catch {} finally {
-				t || F(!1);
+				t || I(!1);
 			}
 		})(), () => {
 			t = !0;
 		};
-	}, [E, _]), r(() => {
-		E && L.current && (L.current.scrollTop = L.current.scrollHeight);
-	}, [O, E]);
-	let W = n((e, t) => {
-		k((n) => n.map((n) => n.id === e ? {
+	}, [D, g]), i(() => {
+		D && H.current && (H.current.scrollTop = H.current.scrollHeight);
+	}, [k, D]);
+	let Z = r((e, t) => {
+		A((n) => n.map((n) => n.id === e ? {
 			...n,
 			...t
 		} : n));
-	}, []), G = n(async () => {
-		let e = A.trim();
-		if (!e || M) return;
-		B.isListening && B.stop(), B.reset(), j(""), I.current && (I.current.style.height = "auto");
+	}, []), Q = r(async () => {
+		if (g.listSessions) try {
+			R(await g.listSessions());
+		} catch {
+			R([]);
+		}
+	}, [g]), oe = r(async () => {
+		!g.newSession || N || (await g.newSession(), A([]), M(""), Q());
+	}, [
+		g,
+		N,
+		Q
+	]), se = r(async () => {
+		!g.clearSession || N || (await g.clearSession(), A([]), M(""), Q());
+	}, [
+		g,
+		N,
+		Q
+	]), ce = r(() => {
+		B((e) => (e || Q(), !e));
+	}, [Q]), le = r(async (e) => {
+		if (!(!g.selectSession || N)) {
+			I(!0);
+			try {
+				A(await g.selectSession(e)), B(!1), Q();
+			} catch {} finally {
+				I(!1);
+			}
+		}
+	}, [
+		g,
+		N,
+		Q
+	]), $ = r(async () => {
+		let e = j.trim();
+		if (!e || N) return;
+		q.isListening && q.stop(), q.reset(), M(""), V.current && (V.current.style.height = "auto");
 		let t = {
-			id: b(),
+			id: y(),
 			role: "user",
 			content: e
-		}, n = b();
-		k((e) => [
+		}, n = y();
+		A((e) => [
 			...e,
 			t,
 			{
@@ -89,149 +123,203 @@ var x = ({ transport: _, title: x = "AI Assistant", subtitle: S = "Ask me to do
 				content: "",
 				pending: !0
 			}
-		]), N(!0);
+		]), P(!0);
 		let r = new AbortController();
-		R.current = r;
+		U.current = r;
 		try {
-			let { text: t } = await _.sendPrompt({
+			let { text: t } = await g.sendPrompt({
 				prompt: e,
 				signal: r.signal,
-				onProgress: (e) => W(n, { content: e })
+				onProgress: (e) => Z(n, { content: e })
 			});
-			W(n, {
+			Z(n, {
 				content: t,
 				pending: !1
 			});
 		} catch (e) {
-			W(n, {
+			Z(n, {
 				content: `Sorry, I couldn't complete that: ${e instanceof Error ? e.message : "Something went wrong. Please try again."}`,
 				pending: !1,
 				error: !0
 			});
 		} finally {
-			N(!1), R.current = null;
+			P(!1), U.current = null, z && Q();
 		}
 	}, [
-		A,
-		M,
-		W,
-		_,
-		B
-	]), K = n((e) => {
-		e.key === "Enter" && !e.shiftKey && (e.preventDefault(), G());
-	}, [G]), q = n(() => {
-		let e = I.current;
+		j,
+		N,
+		Z,
+		g,
+		q,
+		z,
+		Q
+	]), ue = r((e) => {
+		e.key === "Enter" && !e.shiftKey && (e.preventDefault(), $());
+	}, [$]), de = r(() => {
+		let e = V.current;
 		e && (e.style.height = "auto", e.style.height = `${Math.min(e.scrollHeight, 120)}px`);
-	}, []), J = n(() => {
-		B.isListening ? B.stop() : B.start();
-	}, [B]);
-	return /* @__PURE__ */ h(p, { children: [i(() => /* @__PURE__ */ m("button", {
+	}, []), fe = r(() => {
+		q.isListening ? q.stop() : q.start();
+	}, [q]);
+	return /* @__PURE__ */ m(f, { children: [ee(() => /* @__PURE__ */ p("button", {
 		type: "button",
-		onClick: U,
-		"aria-label": E ? "Close AI assistant" : "Open AI assistant",
-		"aria-expanded": E,
+		onClick: X,
+		"aria-label": D ? "Close AI assistant" : "Open AI assistant",
+		"aria-expanded": D,
 		"data-testid": "assistant-widget-launcher",
-		className: e("fixed bottom-6 right-6 z-[100] inline-flex size-14 items-center justify-center rounded-full", "bg-action-primary-bg text-action-primary-text shadow-xl transition-transform duration-200", "hover:scale-105 hover:bg-action-primary-bg-hover focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong cursor-pointer", w),
-		children: m(E ? f : d, { className: "size-6" })
+		className: e("fixed bottom-6 right-6 z-[100] inline-flex size-14 items-center justify-center rounded-full", "bg-action-primary-bg text-action-primary-text shadow-xl transition-transform duration-200", "hover:scale-105 hover:bg-action-primary-bg-hover focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong cursor-pointer", S),
+		children: p(D ? d : l, { className: "size-6" })
 	}), [
-		E,
-		U,
-		w
-	]), E ? /* @__PURE__ */ h("div", {
+		D,
+		X,
+		S
+	]), D ? /* @__PURE__ */ m("div", {
 		role: "dialog",
-		"aria-label": x,
+		"aria-label": b,
 		"data-testid": "assistant-widget-window",
-		className: e("fixed z-[100] flex flex-col overflow-hidden rounded-xl border border-border-default bg-bg-surface shadow-2xl", "bottom-24 right-6 h-[560px] max-h-[calc(100vh-7rem)] w-[calc(100vw-3rem)] sm:w-[400px]", "animate-in slide-in-from-bottom-2 fade-in duration-200"),
-		children: [
-			/* @__PURE__ */ h("div", {
-				className: "flex items-center justify-between gap-2 border-b border-border-subtle bg-bg-surface px-4 py-3",
-				children: [/* @__PURE__ */ h("div", {
-					className: "flex min-w-0 items-center gap-2",
-					children: [/* @__PURE__ */ m("span", {
-						className: "inline-flex size-7 shrink-0 items-center justify-center rounded-full bg-action-primary-bg/10 text-action-primary-bg",
-						children: /* @__PURE__ */ m(d, { className: "size-4" })
-					}), /* @__PURE__ */ m("h2", {
-						className: "truncate text-sm font-semibold text-text-primary",
-						children: x
-					})]
-				}), /* @__PURE__ */ m("button", {
+		"data-layout": w,
+		className: e("fixed z-[100] flex overflow-hidden border-border-default bg-bg-surface shadow-2xl", G ? "inset-y-0 right-0 h-screen w-full border-l sm:w-[480px] lg:w-[560px] animate-in slide-in-from-right duration-200" : "flex-col rounded-xl border bottom-24 right-6 h-[560px] max-h-[calc(100vh-7rem)] w-[calc(100vw-3rem)] sm:w-[400px] animate-in slide-in-from-bottom-2 fade-in duration-200"),
+		children: [G && K ? /* @__PURE__ */ m("aside", {
+			"data-testid": "assistant-session-panel",
+			className: "flex w-[168px] shrink-0 flex-col gap-1 border-r border-border-subtle bg-bg-sunken p-2",
+			children: [
+				/* @__PURE__ */ m("button", {
 					type: "button",
-					onClick: H,
-					"aria-label": "Close AI assistant",
-					"data-testid": "assistant-widget-close",
-					className: "inline-flex size-8 shrink-0 items-center justify-center rounded-md 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 cursor-pointer",
-					children: /* @__PURE__ */ m(f, { className: "size-4" })
-				})]
-			}),
-			/* @__PURE__ */ m("div", {
-				ref: L,
-				className: "flex-1 space-y-3 overflow-y-auto px-4 py-4",
-				"data-testid": "assistant-widget-messages",
-				children: O.length === 0 && P ? /* @__PURE__ */ h("div", {
-					"data-testid": "assistant-widget-restoring",
-					className: "flex h-full flex-col items-center justify-center gap-3 text-center",
-					children: [/* @__PURE__ */ m(s, { className: "size-5 animate-spin text-text-secondary" }), /* @__PURE__ */ m("p", {
-						className: "text-xs leading-relaxed text-text-secondary",
-						children: "Restoring your conversation…"
-					})]
-				}) : O.length === 0 ? /* @__PURE__ */ h("div", {
-					className: "flex h-full flex-col items-center justify-center gap-3 text-center",
-					children: [/* @__PURE__ */ m("span", {
-						className: "inline-flex size-12 items-center justify-center rounded-full bg-bg-sunken text-action-primary-bg",
-						children: /* @__PURE__ */ m(c, { className: "size-6" })
-					}), /* @__PURE__ */ m("p", {
-						className: "max-w-[16rem] text-xs leading-relaxed text-text-secondary",
-						children: S
-					})]
-				}) : O.map((t) => /* @__PURE__ */ m("div", {
-					className: e("flex", t.role === "user" ? "justify-end" : "justify-start"),
-					children: /* @__PURE__ */ h("div", {
-						"data-testid": `assistant-widget-message-${t.role}`,
-						className: e("max-w-[85%] whitespace-pre-wrap break-words rounded-lg px-3 py-2 text-xs leading-relaxed", t.role === "user" ? "bg-action-primary-bg text-action-primary-text" : t.error ? "bg-status-error-bg/10 text-status-error-bg" : "bg-bg-sunken text-text-primary"),
-						children: [t.content || (t.pending, ""), t.pending ? /* @__PURE__ */ h("span", {
-							className: "mt-1 inline-flex items-center gap-1 text-text-secondary",
-							children: [/* @__PURE__ */ m(s, { className: "size-3 animate-spin" }), /* @__PURE__ */ m("span", { children: "Thinking…" })]
-						}) : null]
-					})
-				}, t.id))
-			}),
-			/* @__PURE__ */ h("div", {
-				className: "flex items-end gap-2 border-t border-border-default bg-bg-surface px-3 py-2.5",
-				children: [
-					B.isSupported ? /* @__PURE__ */ m("button", {
+					onClick: () => void oe(),
+					disabled: N,
+					"data-testid": "assistant-new-chat",
+					className: "flex items-center gap-2 rounded-md px-2 py-2 text-xs font-medium text-text-primary transition-colors hover:bg-bg-surface disabled:opacity-50 cursor-pointer",
+					children: [/* @__PURE__ */ p(re, { className: "size-4 shrink-0" }), "New chat"]
+				}),
+				/* @__PURE__ */ m("button", {
+					type: "button",
+					onClick: () => void se(),
+					disabled: N || k.length === 0,
+					"data-testid": "assistant-clear-chat",
+					className: "flex items-center gap-2 rounded-md px-2 py-2 text-xs font-medium text-text-primary transition-colors hover:bg-bg-surface disabled:opacity-50 cursor-pointer",
+					children: [/* @__PURE__ */ p(u, { className: "size-4 shrink-0" }), "Clear chat"]
+				}),
+				/* @__PURE__ */ m("button", {
+					type: "button",
+					onClick: ce,
+					"aria-expanded": z,
+					"data-testid": "assistant-history-toggle",
+					className: "flex items-center gap-2 rounded-md px-2 py-2 text-xs font-medium text-text-primary transition-colors hover:bg-bg-surface cursor-pointer",
+					children: [/* @__PURE__ */ p(te, { className: "size-4 shrink-0" }), "History"]
+				}),
+				z ? /* @__PURE__ */ p("div", {
+					"data-testid": "assistant-history-list",
+					className: "mt-1 flex-1 space-y-0.5 overflow-y-auto border-t border-border-subtle pt-2",
+					children: L.length === 0 ? /* @__PURE__ */ p("p", {
+						className: "px-2 py-1 text-[11px] leading-relaxed text-text-muted",
+						children: "No past chats yet."
+					}) : L.map((t) => /* @__PURE__ */ p("button", {
 						type: "button",
-						onClick: J,
-						"aria-label": B.isListening ? "Stop voice input" : "Start voice input",
-						"aria-pressed": B.isListening,
-						"data-testid": "assistant-widget-mic",
-						className: e("flex size-9 shrink-0 items-center justify-center rounded-lg transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong cursor-pointer", B.isListening ? "animate-pulse bg-status-error-bg text-action-primary-text" : "bg-bg-sunken text-text-secondary hover:text-text-primary"),
-						children: /* @__PURE__ */ m(l, { className: "size-4" })
-					}) : null,
-					/* @__PURE__ */ m("textarea", {
-						ref: I,
-						value: A,
-						onChange: (e) => j(e.target.value),
-						onKeyDown: K,
-						onInput: q,
-						rows: 1,
-						placeholder: C,
-						"aria-label": "Message the assistant",
-						"data-testid": "assistant-widget-input",
-						className: "flex-1 resize-none rounded-lg border border-border-default bg-bg-sunken px-3 py-2 text-xs leading-relaxed text-text-primary placeholder:text-text-muted focus:border-action-primary-bg focus:outline-none"
-					}),
-					/* @__PURE__ */ m("button", {
+						onClick: () => void le(t.id),
+						title: t.title,
+						"data-testid": "assistant-history-item",
+						className: e("w-full truncate rounded px-2 py-1.5 text-left text-[11px] leading-relaxed transition-colors cursor-pointer", t.active ? "bg-bg-surface font-medium text-text-primary" : "text-text-secondary hover:bg-bg-surface hover:text-text-primary"),
+						children: t.title
+					}, t.id))
+				}) : null
+			]
+		}) : null, /* @__PURE__ */ m("div", {
+			className: "flex min-w-0 flex-1 flex-col",
+			children: [
+				/* @__PURE__ */ m("div", {
+					className: "flex items-center justify-between gap-2 border-b border-border-subtle bg-bg-surface px-4 py-3",
+					children: [/* @__PURE__ */ m("div", {
+						className: "flex min-w-0 items-center gap-2",
+						children: [/* @__PURE__ */ p("span", {
+							className: "inline-flex size-7 shrink-0 items-center justify-center rounded-full bg-action-primary-bg/10 text-action-primary-bg",
+							children: /* @__PURE__ */ p(l, { className: "size-4" })
+						}), /* @__PURE__ */ p("h2", {
+							className: "truncate text-sm font-semibold text-text-primary",
+							children: b
+						})]
+					}), /* @__PURE__ */ p("button", {
 						type: "button",
-						onClick: () => void G(),
-						disabled: M || A.trim().length === 0,
-						"aria-label": "Send message",
-						"data-testid": "assistant-widget-send",
-						className: "flex size-9 shrink-0 items-center justify-center rounded-lg bg-action-primary-bg text-action-primary-text transition-colors hover:bg-action-primary-bg-hover focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong disabled:opacity-50 cursor-pointer",
-						children: M ? /* @__PURE__ */ m(s, { className: "size-4 animate-spin" }) : /* @__PURE__ */ m(u, { className: "size-4" })
-					})
-				]
-			})
-		]
+						onClick: Y,
+						"aria-label": "Close AI assistant",
+						"data-testid": "assistant-widget-close",
+						className: "inline-flex size-8 shrink-0 items-center justify-center rounded-md 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 cursor-pointer",
+						children: /* @__PURE__ */ p(d, { className: "size-4" })
+					})]
+				}),
+				/* @__PURE__ */ p("div", {
+					ref: H,
+					className: "flex-1 space-y-3 overflow-y-auto px-4 py-4",
+					"data-testid": "assistant-widget-messages",
+					children: k.length === 0 && F ? /* @__PURE__ */ m("div", {
+						"data-testid": "assistant-widget-restoring",
+						className: "flex h-full flex-col items-center justify-center gap-3 text-center",
+						children: [/* @__PURE__ */ p(s, { className: "size-5 animate-spin text-text-secondary" }), /* @__PURE__ */ p("p", {
+							className: "text-xs leading-relaxed text-text-secondary",
+							children: "Restoring your conversation…"
+						})]
+					}) : k.length === 0 ? /* @__PURE__ */ m("div", {
+						className: "flex h-full flex-col items-center justify-center gap-3 text-center",
+						children: [/* @__PURE__ */ p("span", {
+							className: "inline-flex size-12 items-center justify-center rounded-full bg-bg-sunken text-action-primary-bg",
+							children: /* @__PURE__ */ p(ne, { className: "size-6" })
+						}), /* @__PURE__ */ p("p", {
+							className: "max-w-[16rem] text-xs leading-relaxed text-text-secondary",
+							children: x
+						})]
+					}) : k.map((t) => /* @__PURE__ */ p("div", {
+						className: e("flex", t.role === "user" ? "justify-end" : "justify-start"),
+						children: /* @__PURE__ */ m("div", {
+							"data-testid": `assistant-widget-message-${t.role}`,
+							className: e("whitespace-pre-wrap break-words rounded-lg px-3 py-2 text-xs leading-relaxed", G ? "max-w-[92%]" : "max-w-[85%]", t.role === "user" ? "bg-action-primary-bg text-action-primary-text" : t.error ? "bg-status-error-bg/10 text-status-error-bg" : "bg-bg-sunken text-text-primary"),
+							children: [t.content ? /* @__PURE__ */ p(n, {
+								content: t.content,
+								onNavigate: E
+							}) : null, t.pending ? /* @__PURE__ */ m("span", {
+								"data-testid": "assistant-widget-working",
+								className: e("inline-flex items-center gap-1 text-text-secondary", t.content ? "mt-1" : ""),
+								children: [/* @__PURE__ */ p(s, { className: "size-3 animate-spin" }), t.content ? null : /* @__PURE__ */ p("span", { children: "Working on it…" })]
+							}) : null]
+						})
+					}, t.id))
+				}),
+				/* @__PURE__ */ m("div", {
+					className: "flex items-end gap-2 border-t border-border-default bg-bg-surface px-3 py-2.5",
+					children: [
+						q.isSupported ? /* @__PURE__ */ p("button", {
+							type: "button",
+							onClick: fe,
+							"aria-label": q.isListening ? "Stop voice input" : "Start voice input",
+							"aria-pressed": q.isListening,
+							"data-testid": "assistant-widget-mic",
+							className: e("flex size-9 shrink-0 items-center justify-center rounded-lg transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong cursor-pointer", q.isListening ? "animate-pulse bg-status-error-bg text-action-primary-text" : "bg-bg-sunken text-text-secondary hover:text-text-primary"),
+							children: /* @__PURE__ */ p(c, { className: "size-4" })
+						}) : null,
+						/* @__PURE__ */ p("textarea", {
+							ref: V,
+							value: j,
+							onChange: (e) => M(e.target.value),
+							onKeyDown: ue,
+							onInput: de,
+							rows: 1,
+							placeholder: ae,
+							"aria-label": "Message the assistant",
+							"data-testid": "assistant-widget-input",
+							className: "flex-1 resize-none rounded-lg border border-border-default bg-bg-sunken px-3 py-2 text-xs leading-relaxed text-text-primary placeholder:text-text-muted focus:border-action-primary-bg focus:outline-none"
+						}),
+						/* @__PURE__ */ p("button", {
+							type: "button",
+							onClick: () => void $(),
+							disabled: N || j.trim().length === 0,
+							"aria-label": "Send message",
+							"data-testid": "assistant-widget-send",
+							className: "flex size-9 shrink-0 items-center justify-center rounded-lg bg-action-primary-bg text-action-primary-text transition-colors hover:bg-action-primary-bg-hover focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong disabled:opacity-50 cursor-pointer",
+							children: N ? /* @__PURE__ */ p(s, { className: "size-4 animate-spin" }) : /* @__PURE__ */ p(ie, { className: "size-4" })
+						})
+					]
+				})
+			]
+		})]
 	}) : null] });
 };
 //#endregion
-export { g as ASSISTANT_WIDGET_TOGGLE_EVENT, x as AssistantWidget };
+export { h as ASSISTANT_WIDGET_TOGGLE_EVENT, b as AssistantWidget };

package/dist/shared/components/assistantWidget/MessageContent.d.ts

@@ -0,0 +1,11 @@
+import { FC } from 'react';
+export interface MessageContentProps {
+    content: string;
+    /**
+     * Called for in-app (`/…`) links so the host can route without a full page
+     * reload. When omitted, in-app links fall back to a normal anchor.
+     */
+    onNavigate?: (href: string) => void;
+}
+export declare const MessageContent: FC<MessageContentProps>;
+//# sourceMappingURL=MessageContent.d.ts.map

package/dist/shared/components/assistantWidget/MessageContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessageContent.d.ts","sourceRoot":"","sources":["../../../../src/shared/components/assistantWidget/MessageContent.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAY,KAAK,EAAE,EAAkB,MAAM,OAAO,CAAC;AAW1D,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CAqDlD,CAAC"}

package/dist/shared/components/assistantWidget/MessageContent.js

@@ -0,0 +1,32 @@
+import { Fragment as e } from "react";
+import { Fragment as t, jsx as n } from "react/jsx-runtime";
+//#region src/shared/components/assistantWidget/MessageContent.tsx
+var r = /\[([^\]]+)\]\(([^)\s]+)\)/g;
+function i(e) {
+	return e.startsWith("/") && !e.startsWith("//") ? !0 : e.startsWith("https://");
+}
+var a = ({ content: a, onNavigate: o }) => {
+	let s = [], c = 0, l = new RegExp(r.source, "g");
+	for (let t of a.matchAll(l)) {
+		let [r, l, u] = t, d = t.index ?? 0;
+		if (d > c && s.push(/* @__PURE__ */ n(e, { children: a.slice(c, d) }, `t${String(c)}`)), l && u && i(u)) {
+			let e = u.startsWith("/");
+			s.push(/* @__PURE__ */ n("a", {
+				href: u,
+				"data-testid": "assistant-message-link",
+				...e ? { onClick: o ? (e) => {
+					e.preventDefault(), o(u);
+				} : void 0 } : {
+					target: "_blank",
+					rel: "noopener noreferrer"
+				},
+				className: "font-medium text-action-primary-bg underline underline-offset-2 hover:opacity-80",
+				children: l
+			}, `l${String(d)}`));
+		} else s.push(/* @__PURE__ */ n(e, { children: l ?? r }, `u${String(d)}`));
+		c = d + r.length;
+	}
+	return c < a.length && s.push(/* @__PURE__ */ n(e, { children: a.slice(c) }, `t${String(c)}`)), /* @__PURE__ */ n(t, { children: s });
+};
+//#endregion
+export { a as MessageContent };

package/dist/shared/components/assistantWidget/types.d.ts

@@ -33,10 +33,27 @@ export interface AssistantSendArgs {
  * Backend adapter the host product supplies. A single transport instance is
  * reused across turns so it can keep a warm session/sandbox between sends.
  */
+/** One past conversation, for the history list. */
+export interface AssistantSessionSummary {
+    id: string;
+    title: string;
+    /** epoch ms — used only for ordering/labelling. */
+    updatedAt?: number;
+    /** True for the conversation currently on screen. */
+    active?: boolean;
+}
 export interface AssistantTransport {
     sendPrompt: (args: AssistantSendArgs) => Promise<{
         text: string;
     }>;
+    /** All conversations for this user/sandbox, newest first. */
+    listSessions?: () => Promise<AssistantSessionSummary[]>;
+    /** Start an empty conversation and make it active. */
+    newSession?: () => Promise<void>;
+    /** Delete the active conversation and start a fresh one in its place. */
+    clearSession?: () => Promise<void>;
+    /** Switch to a past conversation; returns its messages. */
+    selectSession?: (sessionId: string) => Promise<AssistantWidgetMessage[]>;
     /**
      * Optional: restore the conversation from the backend when the widget opens.
      *

package/dist/shared/components/assistantWidget/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/shared/components/assistantWidget/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,WAAW,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,mBAAmB,CAAC;IAC1B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,8DAA8D;IAC9D,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;CACvD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/shared/components/assistantWidget/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,WAAW,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,mBAAmB,CAAC;IAC1B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,8DAA8D;IAC9D,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;GAGG;AACH,mDAAmD;AACnD,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAOnE,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACxD,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACzE;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;CACvD"}

package/dist/shared/components/index.d.ts

@@ -30,5 +30,5 @@ export { AssistantWidget, ASSISTANT_WIDGET_TOGGLE_EVENT } from './assistantWidge
 export type { AssistantWidgetProps } from './assistantWidget/AssistantWidget';
 export { useVoiceInput } from './assistantWidget/useVoiceInput';
 export type { UseVoiceInputReturn } from './assistantWidget/useVoiceInput';
-export type { AssistantTransport, AssistantSendArgs, AssistantWidgetMessage, AssistantWidgetRole, } from './assistantWidget/types';
+export type { AssistantTransport, AssistantSendArgs, AssistantSessionSummary, AssistantWidgetMessage, AssistantWidgetRole, } from './assistantWidget/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/components/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGzE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpF,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAI/E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,YAAY,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAEpF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAGlF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AACnG,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/components/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGzE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpF,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAI/E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,YAAY,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAEpF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,YAAY,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAGlF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAGxE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,cAAc,EACd,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AACnG,YAAY,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fe-libs",
-  "version": "2026.713.2",
+  "version": "2026.713.3",
   "description": "Burdenoff frontend primitives and domain libraries",
   "type": "module",
   "imports": {