@burdenoff/fe-libs 2026.1009.1 → 2026.1009.2

package/dist/shared/assistant/appControls/copy.js

@@ -32,6 +32,7 @@ var i = (e) => e.map(t).join(", "), a = (e, t) => {
 function s(e, s) {
 	switch (s.code) {
 		case "opened": return r([a(e, s.what)], ([e]) => e ?? "");
+		case "closed": return r([[e("appControl.closed.preview", "Closed the AI preview."), "Closed the AI preview."]], ([e]) => e ?? "");
 		case "search-opened": return s.query === null ? r([[e("appControl.searchOpened", "Opened search."), "Opened search."]], ([e]) => e ?? "") : r([[e("appControl.searchOpenedFor", "Opened search for “{{query}}”."), "Opened search for “{{query}}”."]], ([e]) => n(e ?? "", { query: t(s.query ?? "") }));
 		case "sidebar": return r(s.already ? [s.collapsed ? [e("appControl.sidebarAlreadyCollapsed", "The sidebar is already collapsed."), "The sidebar is already collapsed."] : [e("appControl.sidebarAlreadyExpanded", "The sidebar is already expanded."), "The sidebar is already expanded."]] : [s.collapsed ? [e("appControl.sidebarCollapsed", "Collapsed the sidebar."), "Collapsed the sidebar."] : [e("appControl.sidebarExpanded", "Expanded the sidebar."), "Expanded the sidebar."]], ([e]) => e ?? "");
 		case "sidebar-entry": return r([s.already ? s.expanded ? [e("appControl.entryAlreadyExpanded", "{{name}} is already expanded."), "{{name}} is already expanded."] : [e("appControl.entryAlreadyCollapsed", "{{name}} is already collapsed."), "{{name}} is already collapsed."] : s.expanded ? [e("appControl.entryExpanded", "Expanded {{name}}."), "Expanded {{name}}."] : [e("appControl.entryCollapsed", "Collapsed {{name}}."), "Collapsed {{name}}."]], ([e]) => n(e ?? "", { name: t(s.name) }));

package/dist/shared/assistant/appControls/grammar.d.ts

@@ -55,6 +55,8 @@ export type AppControlRequest = {
     control: "assistant.transcript";
 } | {
     control: "assistant.preview";
+} | {
+    control: "assistant.preview.close";
 } | {
     control: "assistant.conversation.new";
 } | {

package/dist/shared/assistant/appControls/grammar.js

@@ -24,29 +24,29 @@ var l = 60, u = /^(?:log ?out|sign ?out|(?:log|sign) (?:me )?out(?: of (?:the |m
 	RegExp(`^(?:change|switch|set|update|turn|put|make)(?: over)? ${r}(?:(?:app|ui|user interface|interface|screen|display|site|system|menu|application) )?language (?:to|into|as|over to) (.+)$`),
 	RegExp(`^(?:switch|change|set|put|turn) ${r}(?:app|ui|user interface|interface|screen|display|site|application|menus?) (?:language )?(?:to|into) (.+)$`),
 	RegExp(`^(?:show|display|use|run) ${r}(?:app|ui|user interface|interface|screen|display|site|application)(?: menus?)? in (.+)$`)
-], k = RegExp(`^${i} ${r}(?:(?:assistant|ai|conversation|conversations|chat) history|history of (?:my )?(?:conversations|chats)|(?:past|previous|old|earlier) conversations)$`), A = RegExp(`^${i} ${r}history$`), j = RegExp(`^${i} ${r}(?:voice|spoken|speech) transcript$`), M = RegExp(`^${i} ${r}transcript$`), N = RegExp(`^${i} ${r}(?:ai|assistant) preview(?: panel| pane| surface)?$`), P = RegExp(`^${i} ${r}preview(?: panel| pane)?$`), F = /^(?:(?:start|begin|open) (?:a |an |another )?(?:new |fresh |blank )?conversation|new conversation|(?:start|begin) (?:a )?(?:new|fresh) conversation with you)$/, I = [RegExp(`^(?:go to|open|show|show me|switch to|select|view|change to|move to|take me to|bring up) ${r}(.+) tab$`), /^(?:switch|change|move) tabs? to (.+)$/], L = "(?:filter|narrow|limit)(?: down)?", R = [RegExp(`^${L}(?: ${r}(?:page|list|table|results|items|rows|view))? (?:by|to|for|on) ${r}(.+)$`)], z = [/^(?:show|display|list|keep) only (.+)$/, /^only (?:show|display|list|keep) (.+)$/], B = [
+], k = RegExp(`^${i} ${r}(?:(?:assistant|ai|conversation|conversations|chat) history|history of (?:my )?(?:conversations|chats)|(?:past|previous|old|earlier) conversations)$`), A = RegExp(`^${i} ${r}history$`), j = RegExp(`^${i} ${r}(?:voice|spoken|speech) transcript$`), M = RegExp(`^${i} ${r}transcript$`), ee = RegExp(`^${i} ${r}(?:ai|assistant) preview(?: panel| pane| surface)?$`), N = RegExp(`^${i} ${r}preview(?: panel| pane)?$`), P = RegExp(`^(?:close|hide|dismiss) ${r}(?:ai|assistant) preview(?: panel| pane| surface)?$`), F = RegExp(`^(?:close|hide) ${r}preview(?: panel| pane)?$`), I = /^(?:(?:start|begin|open) (?:a |an |another )?(?:new |fresh |blank )?conversation|new conversation|(?:start|begin) (?:a )?(?:new|fresh) conversation with you)$/, L = [RegExp(`^(?:go to|open|show|show me|switch to|select|view|change to|move to|take me to|bring up) ${r}(.+) tab$`), /^(?:switch|change|move) tabs? to (.+)$/], R = "(?:filter|narrow|limit)(?: down)?", z = [RegExp(`^${R}(?: ${r}(?:page|list|table|results|items|rows|view))? (?:by|to|for|on) ${r}(.+)$`)], B = [/^(?:show|display|list|keep) only (.+)$/, /^only (?:show|display|list|keep) (.+)$/], V = [
 	RegExp(`^(?:set|change|switch|put|make) ${r}(.+?) filter (?:to|as|on) (.+)$`),
-	RegExp(`^${L} ${r}(.+?) (?:by|to|for|on) (.+)$`),
+	RegExp(`^${R} ${r}(.+?) (?:by|to|for|on) (.+)$`),
 	RegExp(`^(?:use|apply) ${r}(.+?) filter (?:of|with|for|set to) (.+)$`)
-], V = RegExp(`^(?:clear|remove|reset|drop|turn off) ${r}(?:(?:all|every) )?(?:(.+?) )?filters?$`), H = [
+], H = RegExp(`^(?:clear|remove|reset|drop|turn off) ${r}(?:(?:all|every) )?(?:(.+?) )?filters?$`), U = [
 	[/(?: in)? (?:ascending|asc)(?: order)?$/, "asc"],
 	[/(?: in)? (?:descending|desc)(?: order)?$/, "desc"],
 	[/ (?:a to z|low to high|lowest first|smallest first|oldest first)$/, "asc"],
 	[/ (?:z to a|high to low|highest first|largest first|biggest first|newest first|latest first)$/, "desc"]
-], U = RegExp(`^(?:sort|order|arrange|rank)(?: ${r}(?:page|list|table|results|items|rows|view|it|them))? by (.+)$`), W = /^(?:sort|order)(?: it| them)? (ascending|descending|asc|desc)$/, G = [
+], W = RegExp(`^(?:sort|order|arrange|rank)(?: ${r}(?:page|list|table|results|items|rows|view|it|them))? by (.+)$`), G = /^(?:sort|order)(?: it| them)? (ascending|descending|asc|desc)$/, K = [
 	/^(?:search|find|look)(?: (?:this page|the page|the list|the table|this list|this table|here|these|them))? for (.+)$/,
 	/^(?:find|search for) (.+?) (?:on|in) (?:this|the) (?:page|list|table)$/,
 	/^search (?:this page|the page|the list|the table|here) (?:for )?(.+)$/
-], K = /^(?:clear|reset|empty|remove|stop) (?:the |my |this )?(?:page )?search(?:ing)?$/, q = [RegExp(`^(?:open|show|start|bring up|pull up) ${r}(.+?) (?:form|dialog|dialogue|modal)$`)], J = RegExp(`^(?:open|show|start|bring up|pull up) ${r}(.+)$`), Y = /\b(?:and then|then|and also|also|after that|afterwards|and open|and show|and go|and sort|and filter)\b/;
-function X(e, t) {
+], q = /^(?:clear|reset|empty|remove|stop) (?:the |my |this )?(?:page )?search(?:ing)?$/, J = [RegExp(`^(?:open|show|start|bring up|pull up) ${r}(.+?) (?:form|dialog|dialogue|modal)$`)], Y = RegExp(`^(?:open|show|start|bring up|pull up) ${r}(.+)$`), X = /\b(?:and then|then|and also|also|after that|afterwards|and open|and show|and go|and sort|and filter)\b/;
+function Z(e, t) {
 	for (let n of e) {
 		let e = n.exec(t);
 		if (e) return e;
 	}
 	return null;
 }
-function Z(e) {
-	for (let [t, n] of H) {
+function Q(e) {
+	for (let [t, n] of U) {
 		let r = t.exec(e);
 		if (r) return {
 			field: e.slice(0, r.index).trim(),
@@ -58,13 +58,13 @@ function Z(e) {
 		direction: null
 	};
 }
-function Q(e) {
+function $(e) {
 	let t = e.replace(/\b(?:please|pls)$/, "").trim();
 	return !t || t.length > l ? null : t;
 }
-function $(s, l, S) {
+function te(s, l, S) {
 	let T = S.registered;
-	if (Y.test(s)) return null;
+	if (X.test(s)) return null;
 	if (T["account.logout"] && u.test(s)) return a({ control: "account.logout" });
 	if (T["header.workspace"] || T["header.context"]) {
 		let e = RegExp(`^(?:switch|change|move|go|jump|hop)(?: over)? to ${r}(.+?) ${d}$`).exec(s) ?? RegExp(`^(?:switch|change|move) ${r}${d} (?:to|over to) ${r}(.+)$`).exec(s);
@@ -88,7 +88,7 @@ function $(s, l, S) {
 	}
 	if (T["header.search"]) {
 		for (let e of x) {
-			let t = e.exec(s), n = t ? Q(t[1] ?? "") : null;
+			let t = e.exec(s), n = t ? $(t[1] ?? "") : null;
 			if (n) return a({
 				control: "header.search",
 				query: c(l, n)
@@ -143,16 +143,18 @@ function $(s, l, S) {
 		if (M.test(s)) return o({ control: "assistant.transcript" });
 	}
 	if (T["assistant.preview"]) {
-		if (N.test(s)) return a({ control: "assistant.preview" });
-		if (P.test(s)) return o({ control: "assistant.preview" });
-	}
-	if (T["assistant.conversation.new"] && F.test(s)) return a({ control: "assistant.conversation.new" });
-	let L = S.page;
-	if (!L) return null;
-	if (L.tabs.length > 0) {
-		let e = X(I, s), t = e ? (e[1] ?? "").trim() : "";
+		if (ee.test(s)) return a({ control: "assistant.preview" });
+		if (N.test(s)) return o({ control: "assistant.preview" });
+		if (P.test(s)) return a({ control: "assistant.preview.close" });
+		if (F.test(s)) return o({ control: "assistant.preview.close" });
+	}
+	if (T["assistant.conversation.new"] && I.test(s)) return a({ control: "assistant.conversation.new" });
+	let R = S.page;
+	if (!R) return null;
+	if (R.tabs.length > 0) {
+		let e = Z(L, s), t = e ? (e[1] ?? "").trim() : "";
 		if (t) {
-			let e = n(t, L.tabs).kind !== "none";
+			let e = n(t, R.tabs).kind !== "none";
 			return {
 				request: {
 					control: "page.tab",
@@ -162,30 +164,30 @@ function $(s, l, S) {
 			};
 		}
 	}
-	if (L.filters.length > 0) {
-		let e = V.exec(s);
+	if (R.filters.length > 0) {
+		let e = H.exec(s);
 		if (e) return a({
 			control: "page.filter.clear",
 			filter: (e[1] ?? "").trim() || null
 		});
-		let t = X(B, s);
+		let t = Z(V, s);
 		if (t) {
 			let e = (t[1] ?? "").trim(), r = (t[2] ?? "").trim();
-			if (e && r && n(e, L.filters).kind !== "none") return a({
+			if (e && r && n(e, R.filters).kind !== "none") return a({
 				control: "page.filter",
 				filter: e,
 				option: r
 			});
 		}
-		let r = X(R, s);
+		let r = Z(z, s);
 		if (r && (r[1] ?? "").trim()) return a({
 			control: "page.filter",
 			filter: null,
 			option: (r[1] ?? "").trim()
 		});
-		let i = X(z, s);
+		let i = Z(B, s);
 		if (i) {
-			let e = (i[1] ?? "").trim(), t = L.filters.some((t) => n(e, t.options).kind !== "none");
+			let e = (i[1] ?? "").trim(), t = R.filters.some((t) => n(e, t.options).kind !== "none");
 			if (e && t) return a({
 				control: "page.filter",
 				filter: null,
@@ -193,16 +195,16 @@ function $(s, l, S) {
 			});
 		}
 	}
-	if (L.sorts.length > 0) {
-		let e = W.exec(s);
+	if (R.sorts.length > 0) {
+		let e = G.exec(s);
 		if (e) return a({
 			control: "page.sort",
 			field: null,
 			direction: /^asc/.test(e[1] ?? "") ? "asc" : "desc"
 		});
-		let t = U.exec(s);
+		let t = W.exec(s);
 		if (t) {
-			let { field: e, direction: n } = Z((t[1] ?? "").trim());
+			let { field: e, direction: n } = Q((t[1] ?? "").trim());
 			if (e) return a({
 				control: "page.sort",
 				field: e,
@@ -210,22 +212,22 @@ function $(s, l, S) {
 			});
 		}
 	}
-	if (L.searchable) {
-		if (K.test(s)) return a({ control: "page.search.clear" });
-		let e = X(G, s), t = e ? Q(e[1] ?? "") : null;
+	if (R.searchable) {
+		if (q.test(s)) return a({ control: "page.search.clear" });
+		let e = Z(K, s), t = e ? $(e[1] ?? "") : null;
 		if (t) return a({
 			control: "page.search",
 			query: c(l, t)
 		});
 	}
-	if (L.openers.length > 0) {
-		let t = X(q, s), r = t ? (t[1] ?? "").trim() : "";
-		if (r && n(r, L.openers).kind !== "none") return a({
+	if (R.openers.length > 0) {
+		let t = Z(J, s), r = t ? (t[1] ?? "").trim() : "";
+		if (r && n(r, R.openers).kind !== "none") return a({
 			control: "page.open",
 			name: r
 		});
-		let i = J.exec(s), c = i ? (i[1] ?? "").trim() : "";
-		if (c && L.openers.filter((t) => e(t.label) === c).length > 0) return o({
+		let i = Y.exec(s), c = i ? (i[1] ?? "").trim() : "";
+		if (c && R.openers.filter((t) => e(t.label) === c).length > 0) return o({
 			control: "page.open",
 			name: c
 		});
@@ -233,4 +235,4 @@ function $(s, l, S) {
 	return null;
 }
 //#endregion
-export { $ as matchAppControl, c as queryAsSaid };
+export { te as matchAppControl, c as queryAsSaid };

package/dist/shared/assistant/appControls/plan.d.ts

@@ -9,6 +9,9 @@ import { ControlBlock, ControlKey, SortDirection } from './types';
 export type ControlReply = {
     code: "opened";
     what: OpenedWhat;
+} | {
+    code: "closed";
+    what: ClosedWhat;
 } | {
     code: "search-opened";
     query: string | null;
@@ -95,6 +98,7 @@ export type ControlReply = {
     reason: ControlBlock;
 };
 export type OpenedWhat = "notifications" | "help" | "context" | "history" | "transcript" | "preview" | "conversation";
+export type ClosedWhat = "preview";
 export type NotFoundKind = "tab" | "filter" | "filter-option" | "sort" | "form" | "workspace";
 export type AmbiguousKind = "tab" | "filter" | "menu" | "workspace" | "column" | "form";
 /** What is recorded on the exchange (`AssistantLocalAction`). */

package/dist/shared/assistant/appControls/plan.js

@@ -18,15 +18,18 @@ function a(e) {
 	}
 }
 var o = (e, t) => e.status === "failed" ? i({ code: "failed" }, "failed") : i(t(e.status === "already"), e.status);
-function s(e, t, n) {
-	if (n.voiceLive && r.has(e)) return "voice-session";
+function s(e, t) {
+	return r.has(e) ? !(e === "assistant.preview" && "surface" in t && t.surface === "page") : !1;
+}
+function c(e, t, n, r = !0) {
+	if (r && n.voiceLive && s(e, t)) return "voice-session";
 	try {
 		return t.blockedBy?.() ?? null;
 	} catch {
 		return "permission";
 	}
 }
-var c = (e, t) => ({
+var l = (e, t) => ({
 	kind: "reply",
 	control: e,
 	run: i({
@@ -34,26 +37,39 @@ var c = (e, t) => ({
 		reason: t
 	}, "blocked")
 });
-function l(t, n) {
-	let { control: r, what: i } = t, l = e(r);
-	if (!l) return null;
-	let u = s(r, l, n);
-	return u ? c(r, u) : {
+function u(t, n) {
+	let { control: r, what: i } = t, s = e(r);
+	if (!s) return null;
+	let u = c(r, s, n);
+	return u ? l(r, u) : {
 		kind: "run",
 		control: r,
-		run: () => o(a(() => l.run()), () => ({
+		run: () => o(a(() => s.run()), () => ({
 			code: "opened",
 			what: i
 		}))
 	};
 }
-var u = (e) => e.map((e) => e.label);
-function d(t, r) {
-	let l = e("page");
-	if (!l) return null;
-	let d = s("page", l, r);
-	if (d) return c("page", d);
-	let m = l.page, h = (e) => ({
+function d(t) {
+	let n = e("assistant.preview");
+	if (!n?.close) return null;
+	let r = n.close, i = c("assistant.preview", n, t, !1);
+	return i ? l("assistant.preview", i) : {
+		kind: "run",
+		control: "assistant.preview",
+		run: () => o(a(r), () => ({
+			code: "closed",
+			what: "preview"
+		}))
+	};
+}
+var f = (e) => e.map((e) => e.label);
+function p(t, r) {
+	let s = e("page");
+	if (!s) return null;
+	let u = c("page", s, r);
+	if (u) return l("page", u);
+	let d = s.page, p = (e) => ({
 		kind: "reply",
 		control: "page",
 		run: e
@@ -64,36 +80,36 @@ function d(t, r) {
 	});
 	switch (t.control) {
 		case "page.tab": {
-			let e = l.tabs;
+			let e = s.tabs;
 			if (!e) return null;
-			let r = e.items(), s = n(t.name, r);
-			if (s.kind === "none") return h(i({
+			let r = e.items(), c = n(t.name, r);
+			if (c.kind === "none") return p(i({
 				code: "not-found",
 				what: "tab",
-				page: m,
+				page: d,
 				name: t.name,
-				options: u(r)
+				options: f(r)
 			}, "not-found"));
-			if (s.kind === "many") return h(i({
+			if (c.kind === "many") return p(i({
 				code: "ambiguous",
 				what: "tab",
 				name: t.name,
-				options: u(s.items)
+				options: f(c.items)
 			}, "ambiguous"));
-			let c = s.item;
-			return e.current?.() === c.id ? h(i({
+			let l = c.item;
+			return e.current?.() === l.id ? p(i({
 				code: "tab",
-				name: c.label,
+				name: l.label,
 				already: !0
-			}, "already")) : g(() => o(a(() => e.select(c.id)), (e) => ({
+			}, "already")) : g(() => o(a(() => e.select(l.id)), (e) => ({
 				code: "tab",
-				name: c.label,
+				name: l.label,
 				already: e
 			})));
 		}
-		case "page.filter": return p(l, t.filter, t.option, h, g);
+		case "page.filter": return h(s, t.filter, t.option, p, g);
 		case "page.filter.clear": {
-			let e = l.filters;
+			let e = s.filters;
 			if (!e) return null;
 			let r = e.items();
 			if (t.filter === null) return g(() => o(a(() => {
@@ -104,85 +120,85 @@ function d(t, r) {
 				code: "filter-cleared",
 				filter: null
 			})));
-			let s = n(t.filter, r);
-			if (s.kind === "none") return h(i({
+			let c = n(t.filter, r);
+			if (c.kind === "none") return p(i({
 				code: "not-found",
 				what: "filter",
-				page: m,
+				page: d,
 				name: t.filter,
-				options: u(r)
+				options: f(r)
 			}, "not-found"));
-			if (s.kind === "many") return h(i({
+			if (c.kind === "many") return p(i({
 				code: "ambiguous",
 				what: "filter",
 				name: t.filter,
-				options: u(s.items)
+				options: f(c.items)
 			}, "ambiguous"));
-			let c = s.item;
-			return g(() => o(a(() => e.set(c.id, null)), () => ({
+			let l = c.item;
+			return g(() => o(a(() => e.set(l.id, null)), () => ({
 				code: "filter-cleared",
-				filter: c.label
+				filter: l.label
 			})));
 		}
 		case "page.sort": {
-			let e = l.sort;
+			let e = s.sort;
 			if (!e) return null;
-			let n = e.fields(), r = f(m, t.field, n, e.current?.() ?? null);
-			if ("reply" in r) return h(r.reply);
-			let { id: s, label: c } = r, u = t.direction ?? "asc", d = e.current?.() ?? null;
-			return d && d.field === s && d.direction === u ? h(i({
+			let n = e.fields(), r = m(d, t.field, n, e.current?.() ?? null);
+			if ("reply" in r) return p(r.reply);
+			let { id: c, label: l } = r, u = t.direction ?? "asc", f = e.current?.() ?? null;
+			return f && f.field === c && f.direction === u ? p(i({
 				code: "sorted",
-				page: m,
-				field: c,
+				page: d,
+				field: l,
 				direction: u,
 				already: !0
-			}, "already")) : g(() => o(a(() => e.set(s, u)), () => ({
+			}, "already")) : g(() => o(a(() => e.set(c, u)), () => ({
 				code: "sorted",
-				page: m,
-				field: c,
+				page: d,
+				field: l,
 				direction: u,
 				already: !1
 			})));
 		}
 		case "page.search": {
-			let e = l.search;
+			let e = s.search;
 			return e ? g(() => o(a(() => e.set(t.query)), () => ({
 				code: "searched",
-				page: m,
+				page: d,
 				query: t.query
 			}))) : null;
 		}
 		case "page.search.clear": {
-			let e = l.search;
+			let e = s.search;
 			return e ? g(() => o(a(() => e.clear ? e.clear() : e.set("")), () => ({ code: "search-cleared" }))) : null;
 		}
 		case "page.open": {
-			let e = l.openers;
+			let e = s.openers;
 			if (!e) return null;
-			let r = e.items(), s = n(t.name, r);
-			if (s.kind === "none") return h(i({
+			let r = e.items(), c = n(t.name, r);
+			if (c.kind === "none") return p(i({
 				code: "not-found",
 				what: "form",
-				page: m,
+				page: d,
 				name: t.name,
-				options: u(r)
+				options: f(r)
 			}, "not-found"));
-			if (s.kind === "many") return h(i({
+			if (c.kind === "many") return p(i({
 				code: "ambiguous",
 				what: "form",
 				name: t.name,
-				options: u(s.items)
+				options: f(c.items)
 			}, "ambiguous"));
-			let c = s.item;
-			return g(() => o(a(() => e.open(c.id)), () => ({
+			let l = c.item;
+			return g(() => o(a(() => e.open(l.id)), () => ({
 				code: "form-opened",
-				name: c.label
+				name: l.label
 			})));
 		}
 		default: return null;
 	}
 }
-function f(e, t, r, a) {
+function m(e, t, r, a) {
 	if (t === null) return (a ? r.find((e) => e.id === a.field) : void 0) ?? { reply: i({ code: "sort-needs-field" }, "not-found") };
 	let o = n(t, r);
 	return o.kind === "one" ? o.item : { reply: o.kind === "none" ? i({
@@ -190,54 +206,54 @@ function f(e, t, r, a) {
 		what: "sort",
 		page: e,
 		name: t,
-		options: u(r)
+		options: f(r)
 	}, "not-found") : i({
 		code: "ambiguous",
 		what: "column",
 		name: t,
-		options: u(o.items)
+		options: f(o.items)
 	}, "ambiguous") };
 }
-function p(e, t, r, s, c) {
+function h(e, t, r, s, c) {
 	let l = e.filters;
 	if (!l) return null;
-	let d = e.page, f = l.items(), p = [];
+	let u = e.page, d = l.items(), p = [];
 	if (t !== null) {
-		let e = n(t, f);
+		let e = n(t, d);
 		if (e.kind === "none") return s(i({
 			code: "not-found",
 			what: "filter",
-			page: d,
+			page: u,
 			name: t,
-			options: u(f)
+			options: f(d)
 		}, "not-found"));
 		if (e.kind === "many") return s(i({
 			code: "ambiguous",
 			what: "filter",
 			name: t,
-			options: u(e.items)
+			options: f(e.items)
 		}, "ambiguous"));
 		let a = e.item, o = a.options(), c = n(r, o, { sayingMayContainLabel: !0 });
 		if (c.kind === "none") return s(i({
 			code: "not-found",
 			what: "filter-option",
-			page: d,
+			page: u,
 			name: r,
-			options: u(o),
+			options: f(o),
 			filter: a.label
 		}, "not-found"));
 		if (c.kind === "many") return s(i({
 			code: "ambiguous",
 			what: "filter",
 			name: r,
-			options: u(c.items)
+			options: f(c.items)
 		}, "ambiguous"));
 		p.push({
 			filter: a,
 			option: c.item
 		});
 	} else {
-		for (let e of f) {
+		for (let e of d) {
 			let t = n(r, e.options(), { sayingMayContainLabel: !0 });
 			if (t.kind === "one") p.push({
 				filter: e,
@@ -249,17 +265,17 @@ function p(e, t, r, s, c) {
 			});
 		}
 		if (p.length === 0) {
-			let e = n(r, f);
+			let e = n(r, d);
 			return e.kind === "one" ? s(i({
 				code: "filter-choose",
 				filter: e.item.label,
-				options: u(e.item.options())
+				options: f(e.item.options())
 			}, "not-found")) : s(i({
 				code: "not-found",
 				what: "filter",
-				page: d,
+				page: u,
 				name: r,
-				options: u(f)
+				options: f(d)
 			}, "not-found"));
 		}
 		if (p.length > 1) return s(i({
@@ -284,37 +300,38 @@ function p(e, t, r, s, c) {
 		already: e
 	})));
 }
-function m(r, f) {
+function g(r, s) {
 	switch (r.control) {
-		case "header.notifications": return l({
+		case "header.notifications": return u({
 			control: "header.notifications",
 			what: "notifications"
-		}, f);
-		case "header.help": return l({
+		}, s);
+		case "header.help": return u({
 			control: "header.help",
 			what: "help"
-		}, f);
-		case "header.context": return l({
+		}, s);
+		case "header.context": return u({
 			control: "header.context",
 			what: "context"
-		}, f);
-		case "assistant.history": return l({
+		}, s);
+		case "assistant.history": return u({
 			control: "assistant.history",
 			what: "history"
-		}, f);
-		case "assistant.transcript": return l({
+		}, s);
+		case "assistant.transcript": return u({
 			control: "assistant.transcript",
 			what: "transcript"
-		}, f);
-		case "assistant.preview": return l({
+		}, s);
+		case "assistant.preview": return u({
 			control: "assistant.preview",
 			what: "preview"
-		}, f);
+		}, s);
+		case "assistant.preview.close": return d(s);
 		case "assistant.conversation.new": {
 			let t = e("assistant.conversation.new");
 			if (!t) return null;
-			let n = s("assistant.conversation.new", t, f);
-			return n ? c("assistant.conversation.new", n) : {
+			let n = c("assistant.conversation.new", t, s);
+			return n ? l("assistant.conversation.new", n) : {
 				kind: "run",
 				control: "assistant.conversation.new",
 				silent: !0,
@@ -327,8 +344,8 @@ function m(r, f) {
 		case "header.search": {
 			let t = e("header.search");
 			if (!t) return null;
-			let n = s("header.search", t, f);
-			return n ? c("header.search", n) : {
+			let n = c("header.search", t, s);
+			return n ? l("header.search", n) : {
 				kind: "run",
 				control: "header.search",
 				run: () => o(a(() => t.run({ query: r.query })), () => ({
@@ -340,8 +357,8 @@ function m(r, f) {
 		case "sidebar": {
 			let t = e("sidebar");
 			if (!t) return null;
-			let n = s("sidebar", t, f);
-			return n ? c("sidebar", n) : t.collapsed() === r.collapsed ? {
+			let n = c("sidebar", t, s);
+			return n ? l("sidebar", n) : t.collapsed() === r.collapsed ? {
 				kind: "reply",
 				control: "sidebar",
 				run: i({
@@ -362,8 +379,8 @@ function m(r, f) {
 		case "sidebar.entry": {
 			let t = e("sidebar");
 			if (!t) return null;
-			let l = s("sidebar", t, f);
-			if (l) return c("sidebar", l);
+			let u = c("sidebar", t, s);
+			if (u) return l("sidebar", u);
 			let d = t.entries(), p = n(r.name, d);
 			if (p.kind === "none") return null;
 			if (p.kind === "many") return {
@@ -373,7 +390,7 @@ function m(r, f) {
 					code: "ambiguous",
 					what: "menu",
 					name: r.name,
-					options: u(p.items)
+					options: f(p.items)
 				}, "ambiguous")
 			};
 			let m = p.item;
@@ -400,23 +417,23 @@ function m(r, f) {
 		case "language": {
 			let n = e("language");
 			if (!n) return null;
-			let l = s("language", n, f);
-			if (l) return c("language", l);
-			let u = n.languages().find((e) => e.code.toLowerCase() === r.code);
-			return u ? n.current().toLowerCase() === u.code.toLowerCase() ? {
+			let u = c("language", n, s);
+			if (u) return l("language", u);
+			let d = n.languages().find((e) => e.code.toLowerCase() === r.code);
+			return d ? n.current().toLowerCase() === d.code.toLowerCase() ? {
 				kind: "reply",
 				control: "language",
 				run: i({
 					code: "language",
-					label: u.label,
+					label: d.label,
 					already: !0
 				}, "already")
 			} : {
 				kind: "run",
 				control: "language",
-				run: () => o(a(() => n.set(u.code)), (e) => ({
+				run: () => o(a(() => n.set(d.code)), (e) => ({
 					code: "language",
-					label: u.label,
+					label: d.label,
 					already: e
 				}))
 			} : {
@@ -431,8 +448,8 @@ function m(r, f) {
 		case "header.workspace": {
 			let t = e("header.workspace");
 			if (!t) return null;
-			let l = s("header.workspace", t, f);
-			if (l) return c("header.workspace", l);
+			let u = c("header.workspace", t, s);
+			if (u) return l("header.workspace", u);
 			let d = t.targets(), p = d.filter((e) => e.current !== !0);
 			if (p.length === 0) return {
 				kind: "reply",
@@ -448,7 +465,7 @@ function m(r, f) {
 					what: "workspace",
 					page: "",
 					name: r.target,
-					options: u(p)
+					options: f(p)
 				}, "not-found")
 			};
 			if (m.kind === "many") return {
@@ -458,7 +475,7 @@ function m(r, f) {
 					code: "ambiguous",
 					what: "workspace",
 					name: r.target,
-					options: u(m.items)
+					options: f(m.items)
 				}, "ambiguous")
 			};
 			let h = m.item;
@@ -482,7 +499,7 @@ function m(r, f) {
 				}, "confirm"),
 				confirmed: () => {
 					let t = e("header.workspace"), n = t?.targets().find((e) => e.id === h.id);
-					return !t || !n || n.current === !0 || s("header.workspace", t, f) ? i({ code: "failed" }, "failed") : o(a(() => t.switchTo(h.id)), () => ({
+					return !t || !n || n.current === !0 || c("header.workspace", t, s) ? i({ code: "failed" }, "failed") : o(a(() => t.switchTo(h.id)), () => ({
 						code: "workspace-switched",
 						name: h.label
 					}));
@@ -492,20 +509,20 @@ function m(r, f) {
 		case "account.logout": {
 			let t = e("account.logout");
 			if (!t) return null;
-			let n = s("account.logout", t, f);
-			return n ? c("account.logout", n) : {
+			let n = c("account.logout", t, s);
+			return n ? l("account.logout", n) : {
 				kind: "confirm",
 				control: "account.logout",
 				prompt: { kind: "logout" },
 				ask: i({ code: "logout-confirm" }, "confirm"),
 				confirmed: () => {
 					let t = e("account.logout");
-					return !t || s("account.logout", t, f) ? i({ code: "failed" }, "failed") : o(a(() => t.run()), () => ({ code: "logout-done" }));
+					return !t || c("account.logout", t, s) ? i({ code: "failed" }, "failed") : o(a(() => t.run()), () => ({ code: "logout-done" }));
 				}
 			};
 		}
-		default: return d(r, f);
+		default: return p(r, s);
 	}
 }
 //#endregion
-export { m as planAppControl };
+export { g as planAppControl };

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

@@ -160,6 +160,28 @@ export interface PageControlsAdapter extends ControlBase {
         open: (id: string) => ControlResult;
     };
 }
+/**
+ * The AI Preview, a product's own surface showing what the assistant just
+ * built or ran. Open and close are SET operations (`already` when it is in the
+ * state asked for), never toggles.
+ *
+ * Extensible per product: a product registers its own `assistant.preview` with
+ * the same shape, and a product without a preview registers nothing, so for it
+ * the sentence goes to the model as before ("not applicable").
+ */
+export interface PreviewControl extends OpenControl {
+    /**
+     * Hide it. SET: `already` when it is hidden. Absent: "close the AI preview"
+     * is not a command for this product and goes to the model.
+     */
+    close?: () => ControlResult;
+    /**
+     * Where the preview is drawn. "panel" (the default): an overlay inside the
+     * assistant panel, which the live voice screen covers. "page": drawn on the
+     * product's own page beside the assistant, so Voice may open it.
+     */
+    surface?: "panel" | "page";
+}
 /** Every control key, and the handler shape it takes. */
 export interface ControlMap {
     "header.notifications": OpenControl;
@@ -172,7 +194,7 @@ export interface ControlMap {
     language: LanguageControl;
     "assistant.history": OpenControl;
     "assistant.transcript": OpenControl;
-    "assistant.preview": OpenControl;
+    "assistant.preview": PreviewControl;
     "assistant.conversation.new": OpenControl;
     page: PageControlsAdapter;
 }

package/dist/shared/assistant/i18nManifest.d.ts

@@ -126,6 +126,7 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly "appControl.ambiguous": "More than one {{what}} matches “{{name}}”: {{options}}. Say which one.";
     readonly "appControl.blockedPermission": "That isn't available to you here.";
     readonly "appControl.blockedVoice": "I can't open that while the voice screen is up. End the voice session, or use the button in the assistant's header.";
+    readonly "appControl.closed.preview": "Closed the AI preview.";
     readonly "appControl.dialog.cancel": "Cancel";
     readonly "appControl.dialog.logoutBody": "You'll be signed out of this account on this device.";
     readonly "appControl.dialog.logoutConfirm": "Log out";

package/dist/shared/assistant/i18nManifest.js

@@ -20,6 +20,7 @@ var m = {
 	"appControl.ambiguous": "More than one {{what}} matches “{{name}}”: {{options}}. Say which one.",
 	"appControl.blockedPermission": "That isn't available to you here.",
 	"appControl.blockedVoice": "I can't open that while the voice screen is up. End the voice session, or use the button in the assistant's header.",
+	"appControl.closed.preview": "Closed the AI preview.",
 	"appControl.dialog.cancel": "Cancel",
 	"appControl.dialog.logoutBody": "You'll be signed out of this account on this device.",
 	"appControl.dialog.logoutConfirm": "Log out",

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

@@ -43,7 +43,11 @@ var k = ({ onClose: k, visible: A, docked: j, onToggleDock: M, writeAccess: N, o
 		}, e);
 		J(t.historyOpen), V(t.previewOpen);
 	};
-	t("assistant.history", w(() => ({ run: () => q ? { status: "already" } : (J(!0), V(!1), { status: "done" }) }), [q, J])), t("assistant.preview", w(() => H ? { run: () => U ? { status: "already" } : (J(!1), V(!0), { status: "done" }) } : null, [
+	t("assistant.history", w(() => ({ run: () => q ? { status: "already" } : (J(!0), V(!1), { status: "done" }) }), [q, J])), t("assistant.preview", w(() => H ? {
+		surface: "panel",
+		run: () => U ? { status: "already" } : (J(!1), V(!0), { status: "done" }),
+		close: () => U ? (V(!1), { status: "done" }) : { status: "already" }
+	} : null, [
 		H,
 		U,
 		J

package/package.json

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