@burdenoff/fe-libs 2026.1028.3 → 2026.1028.5

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

@@ -101,3 +101,5 @@ export declare function queryAsSaid(original: string, canonicalQuery: string): s
  * transcribed — queries keep the person's own case and punctuation.
  */
 export declare function matchAppControl(utterance: string, original: string, snapshot: ControlSnapshot): AppControlMatch | null;
+/** Shared grammar patterns, gated by what the page actually registered. */
+export declare function appControlPrefixPatterns(snapshot: ControlSnapshot): readonly RegExp[];

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

@@ -16,37 +16,37 @@ function c(e, t) {
 	for (let e of i.matchAll(r)) a = e[0];
 	return a ?? t;
 }
-var l = 60, u = /^(?:log ?out|sign ?out|(?:log|sign) (?:me )?out(?: of (?:the |my |this )?(?:app|application|account|session))?)$/, d = "(?:workspace|workspaces|context|contexts|organi[sz]ation|organi[sz]ations|org|project)", f = "(?:switcher|selector|picker|menu|dropdown|list)", p = /^(?:another|other|a different|different|a new|new|a|the|another one|other one)$/, m = RegExp(`^${i} ${r}(?:notification|notifications) (?:panel|bell|centre|center|menu|tray|drawer|list)$`), h = RegExp(`^${i} ${r}(?:notification )?bell$`), ee = RegExp(`^${i} ${r}notifications?$`), g = RegExp(`^${i} ${r}(?:help (?:menu|panel|dialog|dialogue|centre|center)|keyboard shortcuts|keyboard help|shortcuts)$`), _ = RegExp(`^${i} ${r}help$`), v = RegExp(`^(?:open|show|start|use|pull up|bring up) ${r}(?:global |app )search(?: (?:bar|box|dialog|dialogue|panel))?$|^(?:open|show|start|use|pull up|bring up) ${r}search (?:bar|box|dialog|dialogue|panel)$`), y = /^(?:open|start|use|pull up|bring up) (?:(?:the|my) )?search$/, b = [
+var l = 60, u = /^(?:log ?out|sign ?out|(?:log|sign) (?:me )?out(?: of (?:the |my |this )?(?:app|application|account|session))?)$/, d = "(?:workspace|workspaces|context|contexts|organi[sz]ation|organi[sz]ations|org|project)", ee = "(?:switcher|selector|picker|menu|dropdown|list)", te = /^(?:another|other|a different|different|a new|new|a|the|another one|other one)$/, f = RegExp(`^(?:switch|change|move|go|jump|hop)(?: over)? to ${r}(.+?) ${d}$`), p = RegExp(`^(?:switch|change|move) ${r}${d} (?:to|over to) ${r}(.+)$`), m = RegExp(`^${i} ${r}${d} ${ee}$`), h = RegExp(`^(?:switch|change) ${r}${d}$`), g = RegExp(`^${i} ${r}(?:notification|notifications) (?:panel|bell|centre|center|menu|tray|drawer|list)$`), _ = RegExp(`^${i} ${r}(?:notification )?bell$`), v = RegExp(`^${i} ${r}notifications?$`), y = RegExp(`^${i} ${r}(?:help (?:menu|panel|dialog|dialogue|centre|center)|keyboard shortcuts|keyboard help|shortcuts)$`), b = RegExp(`^${i} ${r}help$`), x = RegExp(`^(?:open|show|start|use|pull up|bring up) ${r}(?:global |app )search(?: (?:bar|box|dialog|dialogue|panel))?$|^(?:open|show|start|use|pull up|bring up) ${r}search (?:bar|box|dialog|dialogue|panel)$`), S = /^(?:open|start|use|pull up|bring up) (?:(?:the|my) )?search$/, C = [
 	/^(?:open|start|use|pull up|bring up) (?:(?:the|my) )?(?:global |app )?search (?:for|with) (.+)$/,
 	/^(?:global search|search everything|search everywhere|search globally|search the app|search all|search across the app) (?:for )?(.+)$/,
 	/^search (?:the app|everything|everywhere|globally|all|across the app) for (.+)$/
-], x = "(?:side ?bar|side menu|side navigation|side nav|navigation (?:bar|menu|panel|drawer)|nav (?:bar|menu|panel|drawer)|left (?:menu|sidebar|panel))", S = RegExp(`^(?:collapse|close|hide|minimi[sz]e|shrink|fold) ${r}${x}$`), C = RegExp(`^(?:expand|open|show|reveal|unhide|bring up|widen|unfold) ${r}${x}$`), w = "(?: (?:group|section|menu|folder|submenu|sub menu|list|dropdown))?", T = RegExp(`^(expand|unfold|open up|open|show) ${r}(.+?)${w}$`), E = RegExp(`^(collapse|fold up|close|hide) ${r}(.+?)${w}$`), D = [
+], w = "(?:side ?bar|side menu|side navigation|side nav|navigation (?:bar|menu|panel|drawer)|nav (?:bar|menu|panel|drawer)|left (?:menu|sidebar|panel))", T = RegExp(`^(?:collapse|close|hide|minimi[sz]e|shrink|fold) ${r}${w}$`), E = RegExp(`^(?:expand|open|show|reveal|unhide|bring up|widen|unfold) ${r}${w}$`), D = "(?: (?:group|section|menu|folder|submenu|sub menu|list|dropdown))?", O = RegExp(`^(expand|unfold|open up|open|show) ${r}(.+?)${D}$`), k = RegExp(`^(collapse|fold up|close|hide) ${r}(.+?)${D}$`), A = [
 	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 (.+)$`)
-], O = RegExp(`^(?:switch|change)(?: over)? to ${r}(.+)$`), 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 = RegExp(`^(?:close|hide|dismiss) ${r}(?:ai|assistant) preview(?: panel| pane| surface)?$`), te = 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 = [
+], j = RegExp(`^(?:switch|change)(?: over)? to ${r}(.+)$`), M = RegExp(`^${i} ${r}(?:(?:assistant|ai|conversation|conversations|chat) history|history of (?:my )?(?:conversations|chats)|(?:past|previous|old|earlier) conversations)$`), N = RegExp(`^${i} ${r}history$`), P = RegExp(`^${i} ${r}(?:voice|spoken|speech) transcript$`), F = RegExp(`^${i} ${r}transcript$`), ne = RegExp(`^${i} ${r}(?:ai|assistant) preview(?: panel| pane| surface)?$`), I = RegExp(`^${i} ${r}preview(?: panel| pane)?$`), L = RegExp(`^(?:close|hide|dismiss) ${r}(?:ai|assistant) preview(?: panel| pane| surface)?$`), R = RegExp(`^(?:close|hide) ${r}preview(?: panel| pane)?$`), z = /^(?:(?:start|begin|open) (?:a |an |another )?(?:new |fresh |blank )?conversation|new conversation|(?:start|begin) (?:a )?(?:new|fresh) conversation with you)$/, B = [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 (.+)$/], V = "(?:filter|narrow|limit)(?: down)?", H = [RegExp(`^${V}(?: ${r}(?:page|list|table|results|items|rows|view))? (?:by|to|for|on) ${r}(.+)$`)], U = [/^(?:show|display|list|keep) only (.+)$/, /^only (?:show|display|list|keep) (.+)$/], W = [
 	RegExp(`^(?:set|change|switch|put|make) ${r}(.+?) filter (?:to|as|on) (.+)$`),
-	RegExp(`^${R} ${r}(.+?) (?:by|to|for|on) (.+)$`),
+	RegExp(`^${V} ${r}(.+?) (?:by|to|for|on) (.+)$`),
 	RegExp(`^(?:use|apply) ${r}(.+?) filter (?:of|with|for|set to) (.+)$`)
-], H = RegExp(`^(?:clear|remove|reset|drop|turn off) ${r}(?:(?:all|every) )?(?:(.+?) )?filters?$`), U = [
+], G = RegExp(`^(?:clear|remove|reset|drop|turn off) ${r}(?:(?:all|every) )?(?:(.+?) )?filters?$`), K = [
 	[/(?: 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"]
-], 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 = [
+], q = RegExp(`^(?:sort|order|arrange|rank)(?: ${r}(?:page|list|table|results|items|rows|view|it|them))? by (.+)$`), re = K.map(([e]) => new RegExp(q.source.slice(0, -1) + e.source)), J = /^(?:sort|order)(?: it| them)? (ascending|descending|asc|desc)$/, Y = [
 	/^(?: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 )?(.+)$/
-], 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) {
+], X = /^(?:clear|reset|empty|remove|stop) (?:the |my |this )?(?:page )?search(?:ing)?$/, Z = [RegExp(`^(?:open|show|start|bring up|pull up) ${r}(.+?) (?:form|dialog|dialogue|modal)$`)], Q = RegExp(`^(?:open|show|start|bring up|pull up) ${r}(.+)$`), ie = /\b(?:and then|then|and also|also|after that|afterwards|and open|and show|and go|and sort|and filter)\b/;
+function $(e, t) {
 	for (let n of e) {
 		let e = n.exec(t);
 		if (e) return e;
 	}
 	return null;
 }
-function Q(e) {
-	for (let [t, n] of U) {
+function ae(e) {
+	for (let [t, n] of K) {
 		let r = t.exec(e);
 		if (r) return {
 			field: e.slice(0, r.index).trim(),
@@ -58,110 +58,110 @@ function Q(e) {
 		direction: null
 	};
 }
-function $(e) {
+function oe(e) {
 	let t = e.replace(/\b(?:please|pls)$/, "").trim();
 	return !t || t.length > l ? null : t;
 }
-function ne(s, l, x) {
-	let w = x.registered;
-	if (X.test(s)) return null;
-	if (w["account.logout"] && u.test(s)) return a({ control: "account.logout" });
-	if (w["header.workspace"] || w["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);
-		if (e && w["header.workspace"]) {
+function se(r, i, s) {
+	let l = s.registered;
+	if (ie.test(r)) return null;
+	if (l["account.logout"] && u.test(r)) return a({ control: "account.logout" });
+	if (l["header.workspace"] || l["header.context"]) {
+		let e = f.exec(r) ?? p.exec(r);
+		if (e && l["header.workspace"]) {
 			let t = (e[1] ?? "").trim();
-			if (t && !p.test(t)) return a({
+			if (t && !te.test(t)) return a({
 				control: "header.workspace",
 				target: t
 			});
-			if (w["header.context"]) return a({ control: "header.context" });
+			if (l["header.context"]) return a({ control: "header.context" });
 		}
-		if (w["header.context"] && (RegExp(`^${i} ${r}${d} ${f}$`).test(s) || RegExp(`^(?:switch|change) ${r}${d}$`).test(s))) return a({ control: "header.context" });
+		if (l["header.context"] && (m.test(r) || h.test(r))) return a({ control: "header.context" });
 	}
-	if (w["header.notifications"]) {
-		if (m.test(s) || h.test(s)) return a({ control: "header.notifications" });
-		if (ee.test(s)) return o({ control: "header.notifications" });
+	if (l["header.notifications"]) {
+		if (g.test(r) || _.test(r)) return a({ control: "header.notifications" });
+		if (v.test(r)) return o({ control: "header.notifications" });
 	}
-	if (w["header.help"]) {
-		if (g.test(s)) return a({ control: "header.help" });
-		if (_.test(s)) return o({ control: "header.help" });
+	if (l["header.help"]) {
+		if (y.test(r)) return a({ control: "header.help" });
+		if (b.test(r)) return o({ control: "header.help" });
 	}
-	if (w["header.search"]) {
-		for (let e of b) {
-			let t = e.exec(s), n = t ? $(t[1] ?? "") : null;
+	if (l["header.search"]) {
+		for (let e of C) {
+			let t = e.exec(r), n = t ? oe(t[1] ?? "") : null;
 			if (n) return a({
 				control: "header.search",
-				query: c(l, n)
+				query: c(i, n)
 			});
 		}
-		if (v.test(s)) return a({
+		if (x.test(r)) return a({
 			control: "header.search",
 			query: null
 		});
-		if (y.test(s)) return o({
+		if (S.test(r)) return o({
 			control: "header.search",
 			query: null
 		});
 	}
-	if (w.sidebar) {
-		if (S.test(s)) return a({
+	if (l.sidebar) {
+		if (T.test(r)) return a({
 			control: "sidebar",
 			collapsed: !0
 		});
-		if (C.test(s)) return a({
+		if (E.test(r)) return a({
 			control: "sidebar",
 			collapsed: !1
 		});
-		let e = T.exec(s), t = e ? null : E.exec(s), r = e ?? t;
-		if (r && x.sidebarEntries.length > 0) {
-			let t = (r[2] ?? "").trim(), i = r[1] ?? "";
-			if (t && n(t, x.sidebarEntries).kind !== "none") return {
+		let e = O.exec(r), t = e ? null : k.exec(r), i = e ?? t;
+		if (i && s.sidebarEntries.length > 0) {
+			let t = (i[2] ?? "").trim(), r = i[1] ?? "";
+			if (t && n(t, s.sidebarEntries).kind !== "none") return {
 				request: {
 					control: "sidebar.entry",
 					name: t,
 					expanded: e !== null
 				},
-				weak: !/^(?:expand|unfold|open up|collapse|fold up)$/.test(i)
+				weak: !/^(?:expand|unfold|open up|collapse|fold up)$/.test(r)
 			};
 		}
 	}
-	if (w.language) {
-		for (let e of D) {
-			let n = e.exec(s);
+	if (l.language) {
+		for (let e of A) {
+			let n = e.exec(r);
 			if (!n) continue;
-			let r = t(n[1] ?? "");
-			if (r) return a({
+			let i = t(n[1] ?? "");
+			if (i) return a({
 				control: "language",
-				code: r
+				code: i
 			});
 		}
-		let e = O.exec(s), n = e ? t(e[1] ?? "") : null;
+		let e = j.exec(r), n = e ? t(e[1] ?? "") : null;
 		if (n) return o({
 			control: "language",
 			code: n
 		});
 	}
-	if (w["assistant.history"]) {
-		if (k.test(s)) return a({ control: "assistant.history" });
-		if (A.test(s)) return o({ control: "assistant.history" });
-	}
-	if (w["assistant.transcript"]) {
-		if (j.test(s)) return a({ control: "assistant.transcript" });
-		if (M.test(s)) return o({ control: "assistant.transcript" });
-	}
-	if (w["assistant.preview"]) {
-		if (N.test(s)) return a({ control: "assistant.preview" });
-		if (P.test(s)) return o({ control: "assistant.preview" });
-		if (F.test(s)) return a({ control: "assistant.preview.close" });
-		if (te.test(s)) return o({ control: "assistant.preview.close" });
-	}
-	if (w["assistant.conversation.new"] && I.test(s)) return a({ control: "assistant.conversation.new" });
-	let R = x.page;
-	if (!R) return null;
-	if (R.tabs.length > 0) {
-		let e = Z(L, s), t = e ? (e[1] ?? "").trim() : "";
+	if (l["assistant.history"]) {
+		if (M.test(r)) return a({ control: "assistant.history" });
+		if (N.test(r)) return o({ control: "assistant.history" });
+	}
+	if (l["assistant.transcript"]) {
+		if (P.test(r)) return a({ control: "assistant.transcript" });
+		if (F.test(r)) return o({ control: "assistant.transcript" });
+	}
+	if (l["assistant.preview"]) {
+		if (ne.test(r)) return a({ control: "assistant.preview" });
+		if (I.test(r)) return o({ control: "assistant.preview" });
+		if (L.test(r)) return a({ control: "assistant.preview.close" });
+		if (R.test(r)) return o({ control: "assistant.preview.close" });
+	}
+	if (l["assistant.conversation.new"] && z.test(r)) return a({ control: "assistant.conversation.new" });
+	let d = s.page;
+	if (!d) return null;
+	if (d.tabs.length > 0) {
+		let e = $(B, r), t = e ? (e[1] ?? "").trim() : "";
 		if (t) {
-			let e = n(t, R.tabs).kind !== "none";
+			let e = n(t, d.tabs).kind !== "none";
 			return {
 				request: {
 					control: "page.tab",
@@ -171,30 +171,30 @@ function ne(s, l, x) {
 			};
 		}
 	}
-	if (R.filters.length > 0) {
-		let e = H.exec(s);
+	if (d.filters.length > 0) {
+		let e = G.exec(r);
 		if (e) return a({
 			control: "page.filter.clear",
 			filter: (e[1] ?? "").trim() || null
 		});
-		let t = Z(V, s);
+		let t = $(W, r);
 		if (t) {
 			let e = (t[1] ?? "").trim(), r = (t[2] ?? "").trim();
-			if (e && r && n(e, R.filters).kind !== "none") return a({
+			if (e && r && n(e, d.filters).kind !== "none") return a({
 				control: "page.filter",
 				filter: e,
 				option: r
 			});
 		}
-		let r = Z(z, s);
-		if (r && (r[1] ?? "").trim()) return a({
+		let i = $(H, r);
+		if (i && (i[1] ?? "").trim()) return a({
 			control: "page.filter",
 			filter: null,
-			option: (r[1] ?? "").trim()
+			option: (i[1] ?? "").trim()
 		});
-		let i = Z(B, s);
-		if (i) {
-			let e = (i[1] ?? "").trim(), t = R.filters.some((t) => n(e, t.options).kind !== "none");
+		let o = $(U, r);
+		if (o) {
+			let e = (o[1] ?? "").trim(), t = d.filters.some((t) => n(e, t.options).kind !== "none");
 			if (e && t) return a({
 				control: "page.filter",
 				filter: null,
@@ -202,16 +202,16 @@ function ne(s, l, x) {
 			});
 		}
 	}
-	if (R.sorts.length > 0) {
-		let e = G.exec(s);
+	if (d.sorts.length > 0) {
+		let e = J.exec(r);
 		if (e) return a({
 			control: "page.sort",
 			field: null,
 			direction: /^asc/.test(e[1] ?? "") ? "asc" : "desc"
 		});
-		let t = W.exec(s);
+		let t = q.exec(r);
 		if (t) {
-			let { field: e, direction: n } = Q((t[1] ?? "").trim());
+			let { field: e, direction: n } = ae((t[1] ?? "").trim());
 			if (e) return a({
 				control: "page.sort",
 				field: e,
@@ -219,27 +219,35 @@ function ne(s, l, x) {
 			});
 		}
 	}
-	if (R.searchable) {
-		if (q.test(s)) return a({ control: "page.search.clear" });
-		let e = Z(K, s), t = e ? $(e[1] ?? "") : null;
+	if (d.searchable) {
+		if (X.test(r)) return a({ control: "page.search.clear" });
+		let e = $(Y, r), t = e ? oe(e[1] ?? "") : null;
 		if (t) return a({
 			control: "page.search",
-			query: c(l, t)
+			query: c(i, t)
 		});
 	}
-	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({
+	if (d.openers.length > 0) {
+		let t = $(Z, r), i = t ? (t[1] ?? "").trim() : "";
+		if (i && n(i, d.openers).kind !== "none") return a({
 			control: "page.open",
-			name: r
+			name: i
 		});
-		let i = Y.exec(s), c = i ? (i[1] ?? "").trim() : "";
-		if (c && R.openers.filter((t) => e(t.label) === c).length > 0) return o({
+		let s = Q.exec(r), c = s ? (s[1] ?? "").trim() : "";
+		if (c && d.openers.filter((t) => e(t.label) === c).length > 0) return o({
 			control: "page.open",
 			name: c
 		});
 	}
 	return null;
 }
+function ce(e) {
+	let t = e.registered, n = [], r = (e, ...t) => {
+		e && n.push(...t);
+	};
+	r(t["account.logout"], u), r(t["header.workspace"], f, p), r(t["header.context"], m, h), r(t["header.notifications"], g, _, v), r(t["header.help"], y, b), r(t["header.search"], x, S, ...C), r(t.sidebar, T, E, O, k), r(t.language, ...A, j), r(t["assistant.history"], M, N), r(t["assistant.transcript"], P, F), r(t["assistant.preview"], ne, I, L, R), r(t["assistant.conversation.new"], z);
+	let i = e.page;
+	return i && (r(i.tabs.length > 0, ...B), r(i.filters.length > 0, ...H, ...U, ...W, G), r(i.sorts.length > 0, q, ...re, J), r(i.searchable, X, ...Y), r(i.openers.length > 0, ...Z, Q)), n;
+}
 //#endregion
-export { ne as matchAppControl, c as queryAsSaid };
+export { ce as appControlPrefixPatterns, se as matchAppControl, c as queryAsSaid };

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

@@ -1,4 +1,6 @@
 import { ControlKey, ControlMap } from './types';
+/** Wake retained draft checks when registered controls mount, change or unmount. */
+export declare function subscribeAssistantControls(listener: () => void): () => void;
 /** Register `impl` for `key`. Returns the cleanup that removes exactly this entry. */
 export declare function registerAssistantControl<K extends ControlKey>(key: K, impl: ControlMap[K]): () => void;
 /** The handler in force for `key` (the newest registration), or null. */

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

@@ -13,26 +13,34 @@ var e = {
 	"assistant.preview": [],
 	"assistant.conversation.new": [],
 	page: []
+}, t = /* @__PURE__ */ new Set(), n = () => {
+	for (let e of t) e();
 };
-function t(t, n) {
-	let r = Symbol(t), i = e[t];
-	return i.push({
-		token: r,
-		impl: n
-	}), () => {
-		let e = i.findIndex((e) => e.token === r);
-		e >= 0 && i.splice(e, 1);
+function r(e) {
+	return t.add(e), () => {
+		t.delete(e);
 	};
 }
-function n(t) {
+function i(t, r) {
+	let i = Symbol(t), a = e[t];
+	return a.push({
+		token: i,
+		impl: r
+	}), n(), () => {
+		let e = a.findIndex((e) => e.token === i);
+		e >= 0 && (a.splice(e, 1), n());
+	};
+}
+function a(t) {
 	let n = e[t];
 	return n.length > 0 ? n[n.length - 1]?.impl ?? null : null;
 }
-function r(t) {
+function o(t) {
 	return e[t].length > 0;
 }
-function i() {
+function s() {
 	for (let t of Object.keys(e)) e[t].length = 0;
+	n();
 }
 //#endregion
-export { i as clearAssistantControls, n as getAssistantControl, r as hasAssistantControl, t as registerAssistantControl };
+export { s as clearAssistantControls, a as getAssistantControl, o as hasAssistantControl, i as registerAssistantControl, r as subscribeAssistantControls };

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

@@ -0,0 +1,9 @@
+export interface CompletionOptions {
+    maxLength: number;
+    /** Exact live names for an open capture; an absent capture is free text. */
+    slots?: Readonly<Record<string, readonly string[]>>;
+    /** Also try live labels for legacy, unnamed open captures. */
+    names?: readonly string[];
+}
+/** Is there a continuation of prefix that the real matcher accepts? */
+export declare function hasCommandCompletion(pattern: RegExp, prefix: string, options: CompletionOptions, accepts: (completion: string) => boolean): boolean;

package/dist/shared/assistant/commandCompletions.js

@@ -0,0 +1,161 @@
+//#region src/shared/assistant/commandCompletions.ts
+var e = /* @__PURE__ */ new WeakMap(), t = " abcdefghijklmnopqrstuvwxyz0123456789";
+function n(n) {
+	let r = e.get(n);
+	if (r) return r;
+	let i = n.source, a = 0, o = () => {
+		let e = [], n = [];
+		for (; a < i.length && i[a] !== ")";) {
+			let r = i[a++];
+			if (r === "|") {
+				e.push({
+					kind: "seq",
+					nodes: n
+				}), n = [];
+				continue;
+			}
+			let s;
+			if (r === "^" || r === "$") continue;
+			if (r === "(") {
+				let e;
+				if (i.startsWith("?:", a)) a += 2;
+				else if (i.startsWith("?<", a)) {
+					let t = i.indexOf(">", a);
+					if (t < 0) throw Error("Invalid command capture");
+					e = i.slice(a + 2, t), a = t + 1;
+				} else if (i[a] === "?") throw Error("Unsupported command assertion");
+				if (s = o(), i[a++] !== ")") throw Error("Unclosed command group");
+				e && (s = {
+					kind: "slot",
+					name: e,
+					node: s
+				});
+			} else if (r === ".") s = {
+				kind: "free",
+				min: 1,
+				max: 1
+			};
+			else if (r === "[") {
+				let e = a - 1;
+				for (; a < i.length && i[a] !== "]";) i[a] === "\\" && (a += 1), a += 1;
+				let n = RegExp(`^${i.slice(e, ++a)}$`, "u");
+				s = {
+					kind: "choice",
+					nodes: [...t].filter((e) => n.test(e)).map((e) => ({
+						kind: "text",
+						text: e
+					}))
+				};
+			} else if (r === "\\") {
+				let e = i[a++];
+				if (e === "b") continue;
+				if (e === "s") s = {
+					kind: "text",
+					text: " "
+				};
+				else if (e === "S") s = {
+					kind: "free",
+					min: 1,
+					max: 1
+				};
+				else if (e === "d") s = {
+					kind: "choice",
+					nodes: [..."0123456789"].map((e) => ({
+						kind: "text",
+						text: e
+					}))
+				};
+				else if (e && !/[a-zA-Z0-9]/.test(e)) s = {
+					kind: "text",
+					text: e
+				};
+				else throw Error("Unsupported command escape");
+			} else s = {
+				kind: "text",
+				text: r ?? ""
+			};
+			let c = 1, l = 1, u = i[a];
+			if (u === "?" || u === "*" || u === "+") a += 1, c = +(u === "+"), l = u === "?" ? 1 : Infinity;
+			else if (u === "{") {
+				let e = /^\{(\d+)(?:,(\d*))?\}/.exec(i.slice(a));
+				if (!e) throw Error("Unsupported command repetition");
+				a += e[0].length, c = Number(e[1]), l = e[2] === void 0 ? c : e[2] === "" ? Infinity : Number(e[2]);
+			}
+			i[a] === "?" && (c !== 1 || l !== 1) && (a += 1), (c !== 1 || l !== 1) && (s = s.kind === "free" ? {
+				kind: "free",
+				min: c,
+				max: l
+			} : {
+				kind: "repeat",
+				node: s,
+				min: c,
+				max: l
+			}), n.push(s);
+		}
+		return e.push({
+			kind: "seq",
+			nodes: n
+		}), e.length === 1 ? e[0] : {
+			kind: "choice",
+			nodes: e
+		};
+	}, s = o();
+	if (a !== i.length) throw Error("Unexpected command pattern suffix");
+	return e.set(n, s), s;
+}
+function r(e, t, r, i) {
+	if (t.length > r.maxLength) return !1;
+	let a = 0, o = (e) => e.length <= r.maxLength && (t.startsWith(e) || e.startsWith(t));
+	function* s(e, n) {
+		if (++a > 2e4) throw Error("Command completion budget");
+		if (e.kind === "text") {
+			let t = n + e.text;
+			o(t) && (yield t);
+		} else if (e.kind === "choice") for (let t of e.nodes) yield* s(t, n);
+		else if (e.kind === "seq") {
+			let { nodes: t } = e;
+			function* r(e, n) {
+				let i = t[e];
+				if (!i) {
+					yield n;
+					return;
+				}
+				for (let t of s(i, n)) yield* r(e + 1, t);
+			}
+			yield* r(0, n);
+		} else if (e.kind === "slot" && r.slots?.[e.name] !== void 0) for (let t of r.slots[e.name] ?? []) yield* s({
+			kind: "text",
+			text: t
+		}, n);
+		else if (e.kind === "slot") yield* s(e.node, n);
+		else if (e.kind === "repeat") {
+			let { min: t, max: i, node: a } = e;
+			function* o(e, n) {
+				if (e >= t && (yield n), !(e >= Math.min(i, r.maxLength + 1))) for (let t of s(a, n)) t !== n && (yield* o(e + 1, t));
+			}
+			yield* o(0, n);
+		} else {
+			let i = t.slice(Math.min(n.length, t.length)), a = new Set([
+				i,
+				i + "item",
+				"item",
+				"x",
+				...r.names ?? []
+			]), s = i.replace(/ /g, "");
+			for (let e of r.names ?? []) {
+				let t = e.replace(/ /g, "");
+				t.startsWith(s) && a.add(i + t.slice(s.length));
+			}
+			for (let e = i.length; e >= 0; --e) a.add(i.slice(0, e));
+			for (let t of a) t.length < e.min || t.length > e.max || o(n + t) && (yield n + t);
+		}
+	}
+	try {
+		for (let r of s(n(e), "")) if (r.startsWith(t) && e.test(r) && i(r)) return !0;
+		return !1;
+	} catch {
+		return !0;
+	}
+}
+//#endregion
+export { r as hasCommandCompletion };

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

@@ -253,6 +253,7 @@ export * from './turnTimingReport';
 export * from './turnTimingReporter';
 export * from './prewarm';
 export * from './localUiCommands';
+export * from './commandCompletions';
 export * from './localeCommands/types';
 export * from './localeCommands/fold';
 export * from './localeCommands/frames';
@@ -274,6 +275,7 @@ export * from './localeCommands/tables/en';
 export * from './localUiCommandCopy';
 export * from './uiActions/navigationOutcome';
 export * from './uiActions/backStack';
+export * from './uiActions/draftPathname';
 export * from './uiActions/navigateAction';
 export * from './uiActions/assistantHref';
 export * from './uiActions/inAppLinks';
@@ -320,6 +322,7 @@ export * from './useAssistantHeartbeat';
 export * from './useAssistantKeyboardShortcuts';
 export * from './ui/AssistantApiCallsConsentDialog';
 export * from './ui/AssistantChatArea';
+export * from './ui/draftCommandCheck';
 export * from './ui/AIAssistantPanel';
 export * from './ui/assistantOverlayState';
 export * from './ui/useAssistantLauncherLift';

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

@@ -212,6 +212,17 @@ export interface LocalUiCommandContext {
      * Absent: no app-control grammar runs, and the matcher is what it was.
      */
     controls?: ControlSnapshot;
+    /**
+     * Live host integrations for speculative drafts. Omitted by grammar-only
+     * callers; Send still checks the actual provider before running a command.
+     */
+    executors?: {
+        theme: boolean;
+        navigation: boolean;
+        conversationDelete?: boolean;
+        /** Build the current plan only; never run or confirm it during speculation. */
+        appControl?: (request: AppControlRequest) => boolean;
+    };
 }
 /**
  * The command this whole utterance is, or null to send it to the model.
@@ -222,6 +233,11 @@ export interface LocalUiCommandContext {
  * only for what the manifest has switched on.
  */
 export declare function matchLocalUiCommand(text: string, destinations: readonly LocalDestination[], options?: LocalUiCommandOptions, context?: LocalUiCommandContext): LocalUiCommand | null;
+/**
+ * Pure speculative check for typed drafts. A complete command, or a prefix
+ * with a completion accepted by the SAME matcher, must not acquire a sandbox.
+ */
+export declare function couldBeLocalUiCommand(text: string, destinations: readonly LocalDestination[], options?: LocalUiCommandOptions, context?: LocalUiCommandContext): boolean;
 /**
  * ★ BOFF-8060 / BOFF-8867: could this sentence be "take me there" or a pick —
  * in English or in an active language? The panel builds the offered-navigation