@burdenoff/fe-libs 2026.1028.4 → 2026.1028.6

package/dist/shared/assistant/ui/composer/AssistantComposer.d.ts

@@ -55,6 +55,8 @@ interface Props {
      * sandbox while the person is still typing (BOFF-7801).
      */
     onDraftStart?: () => void;
+    /** Additive observer: every text/attachment change, including an empty draft. */
+    onDraftChange?: (draft: AssistantComposerDraft) => void;
     /**
      * ★ BOFF-9341: something covers the composer (the Avatar tab). Dictation
      * stops, keeping every word it heard in the draft, and stays stopped: a
@@ -69,6 +71,12 @@ interface Props {
      */
     onVoiceStateChange?: (state: AssistantComposerVoiceState) => void;
 }
+/** A local draft snapshot; no files are uploaded by observing it. */
+export interface AssistantComposerDraft {
+    readonly text: string;
+    readonly hasAttachments: boolean;
+    readonly dictated: boolean;
+}
 /** What in the composer holds a voice conversation back (`onVoiceStateChange`). */
 export interface AssistantComposerVoiceState {
     readonly committing: boolean;

package/dist/shared/assistant/ui/composer/AssistantComposer.js

@@ -17,69 +17,80 @@ import { useCallback as s, useEffect as c, useLayoutEffect as le, useMemo as ue,
 import { ArrowUp as de, Loader2 as fe } from "lucide-react";
 import { jsx as d, jsxs as f } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/composer/AssistantComposer.tsx
-var pe = 200, p = ({ writeAccessDenied: p = !1, onSend: m, disabled: h = !1, readOnly: me = !1, placeholder: he, mode: ge, availableModes: g, attachmentCharsPerFile: _e, onModeChange: ve, auto: ye, onStartVoiceSession: be, onDraftStart: _, suspendDictation: v = !1, onVoiceStateChange: y }) => {
-	let b = r(), { locale: x } = e(), S = h || me, C = l(null), [w, T] = u(""), [E, D] = u(!1), [O, xe] = u(!1), k = l(!1), [A, j] = u(null), M = l(0), { attachments: N, isBusy: Se, preparingCount: Ce, sendBlocker: P, rejection: F, addFiles: I, remove: we, retry: Te, clear: L, clearRejection: Ee, canAddMore: De, commit: R, cancelCommit: z } = ce({ perFileChars: _e }), B = w.trim() !== "" || N.length > 0, V = l(!1);
+var pe = 200, p = ({ writeAccessDenied: p = !1, onSend: m, disabled: h = !1, readOnly: me = !1, placeholder: he, mode: ge, availableModes: g, attachmentCharsPerFile: _e, onModeChange: ve, auto: ye, onStartVoiceSession: be, onDraftStart: _, onDraftChange: v, suspendDictation: y = !1, onVoiceStateChange: b }) => {
+	let x = r(), { locale: S } = e(), C = h || me, w = l(null), [T, E] = u(""), [xe, D] = u(!1), [O, k] = u(!1), A = l(!1), [j, M] = u(null), N = l(0), { attachments: P, isBusy: Se, preparingCount: Ce, sendBlocker: F, rejection: I, addFiles: L, remove: we, retry: Te, clear: R, clearRejection: Ee, canAddMore: De, commit: z, cancelCommit: B } = ce({ perFileChars: _e }), V = T.trim() !== "" || P.length > 0, H = l(!1), U = l(!1);
 	c(() => {
-		B && !V.current ? (V.current = !0, _?.()) : B || (V.current = !1);
-	}, [B, _]);
-	let H = s((e) => {
-		T((t) => t ? `${t.replace(/\s+$/, "")} ${e}` : e);
-	}, []), U = i((e) => e.assistantLanguage), W = n({
-		onFinalize: H,
-		language: ue(() => te(U, x), [U, x]).tag
-	}), G = W.isActive, K = W.interim, q = W.stop;
+		V && !H.current ? (H.current = !0, _?.()) : V || (H.current = !1);
+	}, [V, _]), c(() => {
+		V || (U.current = !1), v?.({
+			text: T,
+			hasAttachments: P.length > 0,
+			dictated: U.current
+		});
+	}, [
+		T,
+		P.length,
+		V,
+		v
+	]);
+	let W = s((e) => {
+		U.current = !0, E((t) => t ? `${t.replace(/\s+$/, "")} ${e}` : e);
+	}, []), G = i((e) => e.assistantLanguage), K = n({
+		onFinalize: W,
+		language: ue(() => te(G, S), [G, S]).tag
+	}), q = K.isActive, J = K.interim, Oe = K.stop;
 	c(() => {
-		!v || !G || (K.trim() !== "" && H(K.trim()), q());
+		!y || !q || (J.trim() !== "" && W(J.trim()), Oe());
 	}, [
-		v,
-		G,
-		K,
+		y,
 		q,
-		H
+		J,
+		Oe,
+		W
 	]), c(() => {
-		y?.({
+		b?.({
 			committing: O,
-			dictating: G
+			dictating: q
 		});
 	}, [
-		y,
+		b,
 		O,
-		G
+		q
 	]);
-	let Oe = he ?? b("composer.placeholder", "Ask me anything…"), ke = w.trim(), J = a(N), Y = N.filter((e) => e.status === "error"), X = (ke.length > 0 || J.length > 0) && !S && !O && P === null, Ae = J.some((e) => !e.fileId && !e.inlineOnly), je = l(S);
-	je.current = S;
-	let Z = l(!0);
-	c(() => (Z.current = !0, () => {
-		Z.current = !1;
+	let ke = he ?? x("composer.placeholder", "Ask me anything…"), Ae = T.trim(), Y = a(P), X = P.filter((e) => e.status === "error"), Z = (Ae.length > 0 || Y.length > 0) && !C && !O && F === null, je = Y.some((e) => !e.fileId && !e.inlineOnly), Me = l(C);
+	Me.current = C;
+	let Q = l(!0);
+	c(() => (Q.current = !0, () => {
+		Q.current = !1;
 	}), []), le(() => {
-		let e = C.current;
+		let e = w.current;
 		e && (e.style.height = "auto", e.style.height = `${Math.min(e.scrollHeight, pe)}px`);
-	}, [w]);
-	let Q = s(async () => {
-		if (!X || k.current) return;
-		W.isActive && W.stop();
-		let e = w.trim();
-		if (j(null), !Ae) {
-			m(e, J), T(""), L();
+	}, [T]);
+	let $ = s(async () => {
+		if (!Z || A.current) return;
+		K.isActive && K.stop();
+		let e = T.trim();
+		if (M(null), !je) {
+			m(e, Y), E(""), R();
 			return;
 		}
 		let t = i.getState().activeConversationId;
-		k.current = !0, xe(!0);
+		A.current = !0, k(!0);
 		try {
-			let n = await R();
-			if (!Z.current) {
+			let n = await z();
+			if (!Q.current) {
 				n.ok && await n.rollback();
 				return;
 			}
 			if (!n.ok) {
-				n.cancelled || j({
+				n.cancelled || M({
 					kind: "failed",
 					failures: n.failures
 				});
 				return;
 			}
-			if (je.current) {
-				await n.rollback(), Z.current && j({
+			if (Me.current) {
+				await n.rollback(), Q.current && M({
 					kind: "busy",
 					failures: []
 				});
@@ -87,67 +98,67 @@ var pe = 200, p = ({ writeAccessDenied: p = !1, onSend: m, disabled: h = !1, rea
 			}
 			let r = i.getState();
 			if (!(r.activeConversationId === t && (t === null || r.conversations.some((e) => e.id === t)))) {
-				await n.rollback(), Z.current && j({
+				await n.rollback(), Q.current && M({
 					kind: "moved",
 					failures: []
 				});
 				return;
 			}
-			m(e, a(n.attachments)), n.handedOver(), T(""), L();
+			m(e, a(n.attachments)), n.handedOver(), E(""), R();
 		} finally {
-			k.current = !1, Z.current && xe(!1);
+			A.current = !1, Q.current && k(!1);
 		}
 	}, [
-		X,
-		Ae,
-		R,
+		Z,
+		je,
+		z,
 		m,
-		w,
-		J,
-		L,
-		W
-	]), Me = s(() => {
-		z(), C.current?.focus();
-	}, [z]);
+		T,
+		Y,
+		R,
+		K
+	]), Ne = s(() => {
+		B(), w.current?.focus();
+	}, [B]);
 	c(() => {
-		j(null);
-	}, [N.length]);
-	let Ne = (e) => {
-		if (e.kind === "busy") return b("attachments.saveBusy", "The assistant started another reply, so nothing was sent. Your message and files are still here.");
-		if (e.kind === "moved") return b("attachments.saveMoved", "You switched conversations while the files were being saved, so nothing was sent. Your message and files are still here.");
+		M(null);
+	}, [P.length]);
+	let Pe = (e) => {
+		if (e.kind === "busy") return x("attachments.saveBusy", "The assistant started another reply, so nothing was sent. Your message and files are still here.");
+		if (e.kind === "moved") return x("attachments.saveMoved", "You switched conversations while the files were being saved, so nothing was sent. Your message and files are still here.");
 		let { failures: t } = e;
-		if (t.some((e) => e.code === o.quotaExceeded || e.code === o.quotaNotProvisioned)) return `${b("attachments.quotaFull", "File storage is full or not set up for this workspace, so the attachments couldn't be saved. Nothing was sent.")} ${b("attachments.retrySend", "Press Send to try again, or remove the file.")}`;
-		let n = t[0], r = N.find((e) => e.id === n?.id)?.filename ?? "";
-		return `${t.length <= 1 ? b("attachments.saveFailedOne", "{{name}} couldn't be saved, so nothing was sent.", { name: r }) : b("attachments.saveFailedMany", "{{count}} attachments couldn't be saved, so nothing was sent.", { count: t.length })} ${b("attachments.retrySend", "Press Send to try again, or remove the file.")}`;
-	}, Pe = s((e) => {
-		e.key === "Enter" && !e.shiftKey && (e.preventDefault(), Q());
-	}, [Q]), Fe = s((e) => {
+		if (t.some((e) => e.code === o.quotaExceeded || e.code === o.quotaNotProvisioned)) return `${x("attachments.quotaFull", "File storage is full or not set up for this workspace, so the attachments couldn't be saved. Nothing was sent.")} ${x("attachments.retrySend", "Press Send to try again, or remove the file.")}`;
+		let n = t[0], r = P.find((e) => e.id === n?.id)?.filename ?? "";
+		return `${t.length <= 1 ? x("attachments.saveFailedOne", "{{name}} couldn't be saved, so nothing was sent.", { name: r }) : x("attachments.saveFailedMany", "{{count}} attachments couldn't be saved, so nothing was sent.", { count: t.length })} ${x("attachments.retrySend", "Press Send to try again, or remove the file.")}`;
+	}, Fe = s((e) => {
+		e.key === "Enter" && !e.shiftKey && (e.preventDefault(), $());
+	}, [$]), Ie = s((e) => {
 		let t = Array.from(e.clipboardData?.files ?? []);
-		t.length !== 0 && (e.preventDefault(), I(t));
-	}, [I]), Ie = s((e) => {
-		Array.from(e.dataTransfer?.types ?? []).includes("Files") && (M.current += 1, D(!0));
-	}, []), Le = s(() => {
-		M.current = Math.max(0, M.current - 1), M.current === 0 && D(!1);
-	}, []), Re = s((e) => {
-		Array.from(e.dataTransfer?.types ?? []).includes("Files") && e.preventDefault();
+		t.length !== 0 && (e.preventDefault(), L(t));
+	}, [L]), Le = s((e) => {
+		Array.from(e.dataTransfer?.types ?? []).includes("Files") && (N.current += 1, D(!0));
+	}, []), Re = s(() => {
+		N.current = Math.max(0, N.current - 1), N.current === 0 && D(!1);
 	}, []), ze = s((e) => {
-		e.preventDefault(), M.current = 0, D(!1), I(e.dataTransfer?.files ?? null);
-	}, [I]), Be = (e) => {
+		Array.from(e.dataTransfer?.types ?? []).includes("Files") && e.preventDefault();
+	}, []), Be = s((e) => {
+		e.preventDefault(), N.current = 0, D(!1), L(e.dataTransfer?.files ?? null);
+	}, [L]), Ve = (e) => {
 		switch (e) {
-			case "too-many": return b("attachments.tooMany", "You can attach up to {{max}} files per message.", { max: 5 });
-			case "too-large": return b("attachments.tooLarge", "That file is larger than 10 MB.");
-			case "empty": return b("attachments.empty", "That file is empty.");
-			case "unreadable": return b("attachments.unreadable", "That file could not be read.");
-			case "unsupported-image": return b("attachments.unsupportedImage", "This device can't read that image format, so it can't be resized to send. Save it as JPEG and try again.");
-			case "too-large-to-save": return b("attachments.tooLargeToSave", "That file is over 5 MB, so it can't be saved to Files, and no text could be read from it.");
+			case "too-many": return x("attachments.tooMany", "You can attach up to {{max}} files per message.", { max: 5 });
+			case "too-large": return x("attachments.tooLarge", "That file is larger than 10 MB.");
+			case "empty": return x("attachments.empty", "That file is empty.");
+			case "unreadable": return x("attachments.unreadable", "That file could not be read.");
+			case "unsupported-image": return x("attachments.unsupportedImage", "This device can't read that image format, so it can't be resized to send. Save it as JPEG and try again.");
+			case "too-large-to-save": return x("attachments.tooLargeToSave", "That file is over 5 MB, so it can't be saved to Files, and no text could be read from it.");
 		}
-	}, $ = (() => {
-		switch (W.error) {
-			case "not-allowed": return b("voice.denied", "Microphone access is blocked. Allow it in your browser settings to dictate.");
-			case "audio-capture": return b("voice.noMic", "No microphone was found.");
-			case "network": return b("voice.network", "Speech recognition is offline right now.");
-			case "language-not-supported": return b("voice.languageNotSupported", "This browser cannot recognise spoken {{language}}. Try a different browser, or type instead.", { language: ee(W.language, x) });
-			case "unknown": return b("voice.failed", "Dictation stopped unexpectedly.");
+	}, He = (() => {
+		switch (K.error) {
+			case "not-allowed": return x("voice.denied", "Microphone access is blocked. Allow it in your browser settings to dictate.");
+			case "audio-capture": return x("voice.noMic", "No microphone was found.");
+			case "network": return x("voice.network", "Speech recognition is offline right now.");
+			case "language-not-supported": return x("voice.languageNotSupported", "This browser cannot recognise spoken {{language}}. Try a different browser, or type instead.", { language: ee(K.language, S) });
+			case "unknown": return x("voice.failed", "Dictation stopped unexpectedly.");
 			default: return null;
 		}
 	})();
@@ -155,59 +166,59 @@ var pe = 200, p = ({ writeAccessDenied: p = !1, onSend: m, disabled: h = !1, rea
 		className: "flex-shrink-0 px-3 pb-3 pt-1.5",
 		children: [
 			/* @__PURE__ */ f("div", {
-				onDragEnter: Ie,
-				onDragLeave: Le,
-				onDragOver: Re,
-				onDrop: ze,
-				className: `rounded-2xl border p-2 shadow-sm transition-colors focus-within:border-action-primary-bg focus-within:ring-2 focus-within:ring-action-primary-bg/15 ${E ? "border-action-primary-bg border-dashed bg-action-primary-bg/5" : "border-border-default bg-bg-sunken"}`,
+				onDragEnter: Le,
+				onDragLeave: Re,
+				onDragOver: ze,
+				onDrop: Be,
+				className: `rounded-2xl border p-2 shadow-sm transition-colors focus-within:border-action-primary-bg focus-within:ring-2 focus-within:ring-action-primary-bg/15 ${xe ? "border-action-primary-bg border-dashed bg-action-primary-bg/5" : "border-border-default bg-bg-sunken"}`,
 				"data-testid": "assistant-composer",
 				children: [
 					/* @__PURE__ */ d(re, {
-						attachments: N,
+						attachments: P,
 						onRemove: we,
 						onRetry: Te,
-						disabled: S || O,
+						disabled: C || O,
 						preparingCount: Ce
 					}),
 					/* @__PURE__ */ f("div", {
 						className: "flex items-end gap-2",
 						children: [
 							/* @__PURE__ */ d(ne, {
-								onFiles: I,
+								onFiles: L,
 								canAddMore: De,
-								disabled: S || O,
+								disabled: C || O,
 								showLabel: !0
 							}),
 							/* @__PURE__ */ d("textarea", {
-								ref: C,
-								value: w,
-								onChange: (e) => T(e.target.value),
-								onKeyDown: Pe,
-								onPaste: Fe,
-								disabled: S,
+								ref: w,
+								value: T,
+								onChange: (e) => E(e.target.value),
+								onKeyDown: Fe,
+								onPaste: Ie,
+								disabled: C,
 								readOnly: O,
 								"aria-busy": O || void 0,
-								placeholder: E ? b("composer.dropHere", "Drop files to attach") : Oe,
+								placeholder: xe ? x("composer.dropHere", "Drop files to attach") : ke,
 								rows: 1,
 								className: "min-h-[36px] flex-1 resize-none self-center bg-transparent px-1 py-2 text-[15px] leading-relaxed text-text-primary placeholder:text-text-muted focus:outline-none disabled:opacity-50",
-								"aria-label": b("chatInput.ariaLabel", "Message input"),
+								"aria-label": x("chatInput.ariaLabel", "Message input"),
 								"data-testid": "assistant-input"
 							}),
-							W.isSupported && /* @__PURE__ */ d(ae, {
-								isListening: W.isListening,
-								isStarting: W.isStarting,
-								onToggle: W.toggle,
-								disabled: S || O
+							K.isSupported && /* @__PURE__ */ d(ae, {
+								isListening: K.isListening,
+								isStarting: K.isStarting,
+								onToggle: K.toggle,
+								disabled: C || O
 							}),
-							be && ke.length === 0 && N.length === 0 && !W.isActive ? /* @__PURE__ */ d(se, {
+							be && Ae.length === 0 && P.length === 0 && !K.isActive ? /* @__PURE__ */ d(se, {
 								onStart: be,
-								disabled: S || O
+								disabled: C || O
 							}) : /* @__PURE__ */ d("button", {
 								type: "button",
-								onClick: () => void Q(),
-								disabled: !X,
-								className: `flex size-9 flex-shrink-0 items-center justify-center rounded-full shadow-sm transition-all focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong ${X ? "bg-action-primary-bg text-action-primary-text hover:scale-105 hover:bg-action-primary-bg-hover" : "bg-bg-elevated text-text-muted"}`,
-								"aria-label": b("chatInput.send", "Send message"),
+								onClick: () => void $(),
+								disabled: !Z,
+								className: `flex size-9 flex-shrink-0 items-center justify-center rounded-full shadow-sm transition-all focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong ${Z ? "bg-action-primary-bg text-action-primary-text hover:scale-105 hover:bg-action-primary-bg-hover" : "bg-bg-elevated text-text-muted"}`,
+								"aria-label": x("chatInput.send", "Send message"),
 								"data-testid": "assistant-send",
 								children: h || Se || O ? /* @__PURE__ */ d(fe, { className: "size-4 motion-safe:animate-spin" }) : /* @__PURE__ */ d(de, { className: "size-4" })
 							})
@@ -219,7 +230,7 @@ var pe = 200, p = ({ writeAccessDenied: p = !1, onSend: m, disabled: h = !1, rea
 							mode: ge,
 							availableModes: g,
 							onModeChange: ve,
-							disabled: S || O,
+							disabled: C || O,
 							auto: ye
 						})
 					})
@@ -228,13 +239,13 @@ var pe = 200, p = ({ writeAccessDenied: p = !1, onSend: m, disabled: h = !1, rea
 			p ? /* @__PURE__ */ d("p", {
 				className: "mt-1.5 px-1 text-center text-[11px] text-status-warning",
 				"data-testid": "assistant-write-access-warning",
-				children: b("composer.writeAccessDenied", "Changes may not save — your role in this workspace does not currently allow edits. You can still plan and review an action.")
+				children: x("composer.writeAccessDenied", "Changes may not save — your role in this workspace does not currently allow edits. You can still plan and review an action.")
 			}) : null,
 			/* @__PURE__ */ d("div", {
 				className: "mt-1.5 px-1 text-center text-[11px]",
 				"aria-live": "polite",
 				children: O ? /* @__PURE__ */ d(t, {
-					onDismiss: Me,
+					onDismiss: Ne,
 					children: /* @__PURE__ */ f("p", {
 						className: "flex items-center justify-center gap-2 text-text-muted",
 						"data-testid": "assistant-commit-status",
@@ -243,46 +254,46 @@ var pe = 200, p = ({ writeAccessDenied: p = !1, onSend: m, disabled: h = !1, rea
 								className: "size-3 motion-safe:animate-spin",
 								"aria-hidden": "true"
 							}),
-							/* @__PURE__ */ d("span", { children: b("attachments.saving", "Saving your attachments…") }),
+							/* @__PURE__ */ d("span", { children: x("attachments.saving", "Saving your attachments…") }),
 							/* @__PURE__ */ d("button", {
 								type: "button",
-								onClick: Me,
+								onClick: Ne,
 								className: "rounded text-text-primary underline underline-offset-2 hover:text-action-primary-bg focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong",
 								"data-testid": "assistant-commit-cancel",
-								children: b("attachments.cancelSaving", "Cancel")
+								children: x("attachments.cancelSaving", "Cancel")
 							})
 						]
 					})
-				}) : A ? /* @__PURE__ */ d("p", {
+				}) : j ? /* @__PURE__ */ d("p", {
 					className: "text-status-error-text",
 					role: "alert",
 					"data-testid": "assistant-commit-failed",
-					children: Ne(A)
-				}) : W.isStarting && !W.isListening ? /* @__PURE__ */ d("p", {
+					children: Pe(j)
+				}) : K.isStarting && !K.isListening ? /* @__PURE__ */ d("p", {
 					className: "text-text-muted",
 					"data-testid": "assistant-voice-starting",
-					children: b("voice.starting", "Starting the microphone…")
-				}) : W.isListening ? /* @__PURE__ */ f("p", {
+					children: x("voice.starting", "Starting the microphone…")
+				}) : K.isListening ? /* @__PURE__ */ f("p", {
 					className: "text-status-error-text",
 					"data-testid": "assistant-voice-status",
-					children: [/* @__PURE__ */ d(oe, {}), W.interim || b("voice.listening", "Listening… speak now, tap the square to stop")]
-				}) : $ ? /* @__PURE__ */ d("p", {
+					children: [/* @__PURE__ */ d(oe, {}), K.interim || x("voice.listening", "Listening… speak now, tap the square to stop")]
+				}) : He ? /* @__PURE__ */ d("p", {
 					className: "text-status-error-text",
 					"data-testid": "assistant-voice-error",
-					children: $
-				}) : F ? /* @__PURE__ */ d("button", {
+					children: He
+				}) : I ? /* @__PURE__ */ d("button", {
 					type: "button",
 					onClick: Ee,
 					className: "text-status-error-text underline-offset-2 hover:underline",
 					"data-testid": "assistant-attachment-rejection",
-					children: Be(F)
-				}) : P === "failed" ? /* @__PURE__ */ d("p", {
+					children: Ve(I)
+				}) : F === "failed" ? /* @__PURE__ */ d("p", {
 					className: "text-status-error-text",
 					"data-testid": "assistant-attachment-blocked",
-					children: Y.length === 1 ? b("attachments.blockedOne", "{{name}} didn't upload. Retry or remove it before sending.", { name: Y[0].filename }) : b("attachments.blockedMany", "{{count}} attachments didn't upload. Retry or remove them before sending.", { count: Y.length })
+					children: X.length === 1 ? x("attachments.blockedOne", "{{name}} didn't upload. Retry or remove it before sending.", { name: X[0].filename }) : x("attachments.blockedMany", "{{count}} attachments didn't upload. Retry or remove them before sending.", { count: X.length })
 				}) : /* @__PURE__ */ d("p", {
 					className: "text-text-muted",
-					children: b("composer.hint", "Enter to send · Shift+Enter for newline · drag or paste files to attach")
+					children: x("composer.hint", "Enter to send · Shift+Enter for newline · drag or paste files to attach")
 				})
 			})
 		]

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

@@ -0,0 +1,7 @@
+/** Keep speculative grammar work out of the keystroke's React effect. */
+export declare const DRAFT_COMMAND_CHECK_DELAY_MS = 120;
+/** A trailing check; new edits, cleared drafts and unmounts cancel stale work. */
+export declare function createDraftCommandCheck(): {
+    cancel: () => void;
+    schedule(check: () => void): void;
+};

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

@@ -0,0 +1,17 @@
+//#region src/shared/assistant/ui/draftCommandCheck.ts
+var e = 120;
+function t() {
+	let e, t = () => {
+		e !== void 0 && clearTimeout(e), e = void 0;
+	};
+	return {
+		cancel: t,
+		schedule(n) {
+			t(), e = setTimeout(() => {
+				e = void 0, n();
+			}, 120);
+		}
+	};
+}
+//#endregion
+export { e as DRAFT_COMMAND_CHECK_DELAY_MS, t as createDraftCommandCheck };

package/dist/shared/assistant/uiActions/backStack.d.ts

@@ -20,6 +20,7 @@ export interface BackStack {
     pop: () => BackEntry | null;
     clear: () => void;
     size: () => number;
+    subscribe: (listener: () => void) => () => void;
 }
 export declare function createBackStack(capacity?: number): BackStack;
 /** The panel's stack: one per tab. */

package/dist/shared/assistant/uiActions/backStack.js

@@ -2,21 +2,29 @@ import { pathnameOf as e } from "./navigationOutcome.js";
 //#region src/shared/assistant/uiActions/backStack.ts
 var t = 10;
 function n(t = 10) {
-	let n = [];
+	let n = [], r = /* @__PURE__ */ new Set(), i = () => {
+		for (let e of [...r]) e();
+	};
 	return {
 		push: (r) => {
 			n.push({
 				...r,
 				fromPath: e(r.fromPath),
 				toPath: e(r.toPath)
-			}), n.length > t && (n = n.slice(n.length - t));
+			}), n.length > t && (n = n.slice(n.length - t)), i();
 		},
 		top: () => n[n.length - 1] ?? null,
-		pop: () => n.pop() ?? null,
+		pop: () => {
+			let e = n.pop() ?? null;
+			return e && i(), e;
+		},
 		clear: () => {
-			n = [];
+			n.length !== 0 && (n = [], i());
 		},
-		size: () => n.length
+		size: () => n.length,
+		subscribe: (e) => (r.add(e), () => {
+			r.delete(e);
+		})
 	};
 }
 var r = n();

package/dist/shared/assistant/uiActions/deixis.d.ts

@@ -26,3 +26,5 @@ export type ChoiceRequest =
     context: string;
 };
 export declare function parseChoice(utterance: string): ChoiceRequest | null;
+/** Reuse the send grammar when deciding whether a typed prefix may be a follow-up. */
+export declare function navigationPrefixPatterns(back: boolean, navigation: boolean, choice: boolean): readonly RegExp[];

package/dist/shared/assistant/uiActions/deixis.js

@@ -50,5 +50,16 @@ function u(e) {
 		context: (r[1] ?? "").trim()
 	} : null;
 }
+function d(n, r, i) {
+	return [
+		...n ? e : [],
+		...r ? t : [],
+		...i ? [
+			s,
+			c,
+			l
+		] : []
+	];
+}
 //#endregion
-export { e as BACK_GRAMMAR, n as isBackRequest, r as isThereRequest, u as parseChoice };
+export { e as BACK_GRAMMAR, n as isBackRequest, r as isThereRequest, d as navigationPrefixPatterns, u as parseChoice };

package/dist/shared/assistant/uiActions/draftPathname.d.ts

@@ -0,0 +1,13 @@
+/** The panel may live outside a Router; observe paths without polling. */
+type PathSource = Pick<EventTarget, 'addEventListener' | 'removeEventListener'> & {
+    location: Pick<Location, 'pathname'>;
+    history?: Pick<History, 'pushState' | 'replaceState'>;
+};
+/**
+ * Only pathnames are compared. History arguments/state, query strings and
+ * hashes are passed through untouched and are never retained or emitted.
+ * Multiple panels share one observer; the last cleanup restores our wrappers
+ * only if another integration has not replaced them in the meantime.
+ */
+export declare function subscribeDraftPathname(source: PathSource, listener: () => void): () => void;
+export {};

package/dist/shared/assistant/uiActions/draftPathname.js

@@ -0,0 +1,31 @@
+//#region src/shared/assistant/uiActions/draftPathname.ts
+var e = /* @__PURE__ */ new WeakMap();
+function t(t, n) {
+	let r = e.get(t);
+	if (!r) {
+		let n = /* @__PURE__ */ new Set(), i = t.location.pathname, a = () => {
+			let e = t.location.pathname;
+			if (e !== i) {
+				i = e;
+				for (let e of [...n]) e();
+			}
+		}, o = t.history, s = o?.pushState, c = o?.replaceState, l = (e) => function(...t) {
+			let n = e.apply(this, t);
+			return queueMicrotask(a), n;
+		}, u = typeof s == "function" ? l(s) : void 0, d = typeof c == "function" ? l(c) : void 0;
+		o && u && (o.pushState = u), o && d && (o.replaceState = d), t.addEventListener("popstate", a), r = {
+			listeners: n,
+			dispose: () => {
+				t.removeEventListener("popstate", a), o && u && o.pushState === u && s && (o.pushState = s), o && d && o.replaceState === d && c && (o.replaceState = c);
+			}
+		}, e.set(t, r);
+	}
+	let i = r, a = () => n();
+	i.listeners.add(a);
+	let o = !0;
+	return () => {
+		o && (o = !1, i.listeners.delete(a), i.listeners.size === 0 && (i.dispose(), e.delete(t)));
+	};
+}
+//#endregion
+export { t as subscribeDraftPathname };