@burdenoff/fe-libs 2026.1004.4 → 2026.1004.6

package/dist/shared/assistant/ui/voice/AssistantVoiceSession.js

@@ -1,233 +1,256 @@
 import { useReturnFocus as e } from "../../../hooks/useReturnFocus.js";
-import { useAssistantTr as t } from "../../i18n.js";
-import { micIsInterrupt as n, showsAssistantCaption as r, voiceStageState as i } from "../../voice/voiceStageState.js";
-import { VOICE_THINKING_LABEL as a, composeVoiceStatus as o, voiceStatusSuffix as ee } from "../../voice/voiceStatus.js";
-import { spokenSoFar as s } from "../../voice/voiceSession.js";
-import { ASSISTANT_PANEL_ATTR as c, ASSISTANT_VOICE_SESSION_ATTR as l } from "../panelOverlays.js";
-import { AssistantAttachmentButton as u } from "../composer/AssistantAttachmentButton.js";
-import { AssistantAttachmentChips as te } from "../composer/AssistantAttachmentChips.js";
-import { AssistantVoiceOrb as ne } from "./AssistantVoiceOrb.js";
-import { VoiceMiniController as re } from "./VoiceMiniController.js";
-import { VoiceStage as ie } from "./VoiceStage.js";
-import { VoiceTranscriptDrawer as ae } from "./VoiceTranscriptDrawer.js";
-import { escapeBelongsToLayerAbove as oe, voiceSessionEscapeAction as se } from "./voiceSessionEscape.js";
-import { useCallback as d, useEffect as f, useRef as p, useState as m } from "react";
-import { Maximize2 as ce, Minimize2 as le, ScrollText as ue, X as h } from "lucide-react";
-import { jsx as g, jsxs as _ } from "react/jsx-runtime";
+import { useAssistantControl as t } from "../../appControls/useAssistantControl.js";
+import { useAssistantTr as n } from "../../i18n.js";
+import { micIsInterrupt as r, showsAssistantCaption as ee, voiceStageState as i } from "../../voice/voiceStageState.js";
+import { VOICE_THINKING_LABEL as a, composeVoiceStatus as te, voiceStatusSuffix as ne } from "../../voice/voiceStatus.js";
+import { spokenSoFar as o } from "../../voice/voiceSession.js";
+import { ASSISTANT_PANEL_ATTR as re, ASSISTANT_VOICE_SESSION_ATTR as ie } from "../panelOverlays.js";
+import { AssistantAttachmentButton as ae } from "../composer/AssistantAttachmentButton.js";
+import { AssistantAttachmentChips as oe } from "../composer/AssistantAttachmentChips.js";
+import { AssistantVoiceOrb as se } from "./AssistantVoiceOrb.js";
+import { VoiceMiniController as ce } from "./VoiceMiniController.js";
+import { VoiceStage as le } from "./VoiceStage.js";
+import { VoiceTranscriptDrawer as ue } from "./VoiceTranscriptDrawer.js";
+import { escapeBelongsToLayerAbove as de, voiceSessionEscapeAction as fe } from "./voiceSessionEscape.js";
+import { useCallback as s, useEffect as c, useMemo as pe, useRef as l, useState as u } from "react";
+import { Maximize2 as me, Minimize2 as he, ScrollText as ge, X as d } from "lucide-react";
+import { jsx as f, jsxs as p } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/voice/AssistantVoiceSession.tsx
-var v = ({ session: v, turns: pe = [], onSaveTranscript: me, onContinueInChat: he, notice: y = null, spoken: b, onInterrupt: ge, onToggleMute: x, attachments: S = [], onAttachFiles: C, onRemoveAttachment: _e, onRetryAttachment: ve, canAttachMore: ye = !0, preparingAttachments: w = 0, spokenChunks: T = null, onEnd: E, capturing: be = !0, interrupting: xe = !1, awaitingEndpoint: Se = !1, proposalChip: D = null, proposalTray: O = null }) => {
-	let k = t(), { muted: A, error: j } = v, M = p(null), N = p(null), [P, F] = m("mini"), I = P === "full", L = P === "mini", R = P === "mini" ? "panel" : P === "panel" ? "full" : "mini", [z, B] = m(!1), V = O !== null && !L, H = p(!1), U = p(x);
-	U.current = x;
-	let W = d(() => {
-		v.phase === "listening" && (A || H.current || s(v) || (H.current = !0, U.current()));
-	}, [A, v]), G = d(() => {
-		H.current && (H.current = !1, U.current());
-	}, []), K = W;
-	f(() => {
+var m = ({ session: m, turns: ye = [], onSaveTranscript: be, onContinueInChat: xe, notice: h = null, spoken: g, onInterrupt: Se, onToggleMute: _, attachments: v = [], onAttachFiles: y, onRemoveAttachment: Ce, onRetryAttachment: we, canAttachMore: Te = !0, preparingAttachments: b = 0, spokenChunks: x = null, onEnd: S, capturing: Ee = !0, interrupting: De = !1, awaitingEndpoint: Oe = !1, holding: C = !1, correcting: ke = !1, onLetMeFinish: w, onImDone: T, proposalChip: E = null, proposalTray: D = null }) => {
+	let O = n(), { muted: k, error: A } = m, j = l(null), M = l(null), [N, P] = u("mini"), F = N === "full", I = N === "mini", L = N === "mini" ? "panel" : N === "panel" ? "full" : "mini", [R, z] = u(!1);
+	t("assistant.transcript", pe(() => ({ run: () => R ? { status: "already" } : (z(!0), { status: "done" }) }), [R]));
+	let B = D !== null && !I, V = l(!1), H = l(_);
+	H.current = _;
+	let U = s(() => {
+		m.phase !== "listening" && m.phase !== "thinking" || k || V.current || o(m) || (V.current = !0, H.current());
+	}, [k, m]), W = s(() => {
+		V.current && (V.current = !1, H.current());
+	}, []), Ae = U;
+	c(() => {
 		let e = () => {
-			document.visibilityState === "hidden" ? W() : G();
+			document.visibilityState === "hidden" ? U() : W();
 		};
 		return document.addEventListener("visibilitychange", e), () => document.removeEventListener("visibilitychange", e);
-	}, [W, G]), f(() => {
-		let e = G;
+	}, [U, W]), c(() => {
+		let e = W;
 		return window.addEventListener("focus", e), () => {
-			window.removeEventListener("focus", e), H.current = !1;
+			window.removeEventListener("focus", e), V.current = !1;
 		};
-	}, []), f(() => {
-		M.current?.focus();
-	}, []), e(N, { fallbackSelector: `[${c}]` }), f(() => {
+	}, []), c(() => {
+		j.current?.focus();
+	}, []), e(M, { fallbackSelector: `[${re}]` }), c(() => {
 		let e = (e) => {
 			if (e.key === "Escape") {
-				let t = se({
+				let t = fe({
 					defaultPrevented: e.defaultPrevented,
-					layerAbove: oe({
+					layerAbove: de({
 						target: e.target,
-						session: N.current,
+						session: M.current,
 						doc: document
 					}),
-					transcriptOpen: z
+					transcriptOpen: R
 				});
 				if (t === "ignore") return;
-				e.preventDefault(), t === "close-transcript" ? B(!1) : V ? O?.onClose() : E();
+				e.preventDefault(), t === "close-transcript" ? z(!1) : B ? D?.onClose() : S();
 				return;
 			}
-			if (e.key !== "Tab" || !I) return;
-			let t = (z ? N.current?.querySelector("[data-testid=\"assistant-voice-transcript\"]") : N.current)?.querySelectorAll("button:not([disabled])");
+			if (e.key !== "Tab" || !F) return;
+			let t = (R ? M.current?.querySelector("[data-testid=\"assistant-voice-transcript\"]") : M.current)?.querySelectorAll("button:not([disabled])");
 			if (!t || t.length === 0) return;
 			let n = t[0], r = t[t.length - 1];
 			!n || !r || (e.shiftKey && document.activeElement === n ? (e.preventDefault(), r.focus()) : !e.shiftKey && document.activeElement === r && (e.preventDefault(), n.focus()));
 		};
 		return window.addEventListener("keydown", e), () => window.removeEventListener("keydown", e);
 	}, [
-		E,
-		I,
-		z,
-		V,
-		O
+		S,
+		F,
+		R,
+		B,
+		D
 	]);
-	let q = y !== null && j === null, J = s(v), Y = i({
-		snapshot: v,
-		capturing: be,
-		interrupting: xe,
-		awaitingEndpoint: Se
-	}), X = (() => {
+	let G = h !== null && A === null, K = o(m), q = w && T && m.phase === "listening" && !k && A === null ? {
+		letMeFinish: w,
+		imDone: T
+	} : null, J = q !== null;
+	c(() => {
+		if (J) return;
+		let e = document.activeElement;
+		(!e || e === document.body) && j.current?.focus();
+	}, [J]);
+	let Y = i({
+		snapshot: m,
+		capturing: Ee,
+		interrupting: De,
+		awaitingEndpoint: Oe
+	}), je = (() => {
 		switch (Y) {
-			case "connecting": return k("voiceSession.connecting", "Starting the microphone…");
-			case "endpoint-grace": return k("voiceSession.endpointGrace", "Still listening — take your time");
-			case "interrupting": return k("voiceSession.interrupting", "Stopped — go ahead");
-			case "thinking": return k(a.key, a.fallback);
-			case "speaking": return k("voiceSession.speaking", "Speaking — tap to stop");
+			case "connecting": return O("voiceSession.connecting", "Starting the microphone…");
+			case "endpoint-grace": return O("voiceSession.endpointGrace", "Still listening — take your time");
+			case "interrupting": return O("voiceSession.interrupting", "Stopped — go ahead");
+			case "thinking": return O(a.key, a.fallback);
+			case "speaking": return O("voiceSession.speaking", "Speaking — tap to stop");
 			case "mic-error":
 			case "ended": return "";
-			case "listening": return A ? k("voiceSession.muted", "Microphone off") : k("voiceSession.listening", "Listening…");
+			case "listening": return k ? O("voiceSession.muted", "Microphone off") : O("voiceSession.listening", "Listening…");
 			default: return Y;
 		}
-	})(), Z = ee({
-		tr: k,
+	})(), X = !k && (Y === "listening" || Y === "endpoint-grace"), Z = X && C ? O("voiceSession.holding", "Take your time — tap “I’m done” when you finish") : X && ke ? O("voiceSession.correcting", "Stopped that answer — listening to your correction") : je, Q = ne({
+		tr: O,
 		stage: Y,
-		muted: A,
-		label: X
-	}), Q = o(X, Z), $ = Y === "thinking";
-	return /* @__PURE__ */ _("div", {
-		ref: N,
-		className: `flex flex-col items-center justify-between bg-bg-sunken ${P === "full" ? "fixed inset-x-0 bottom-0 top-14 z-[60] px-6 py-8" : P === "panel" ? "absolute inset-0 z-20 px-4 py-6" : "absolute inset-x-0 bottom-0 z-20 h-[11.25rem] border-t border-border-subtle px-3 py-3 shadow-lg"}`,
+		muted: k,
+		label: Z
+	}), $ = te(Z, Q), Me = Y === "thinking";
+	return /* @__PURE__ */ p("div", {
+		ref: M,
+		className: `flex flex-col items-center justify-between bg-bg-sunken ${N === "full" ? "fixed inset-x-0 bottom-0 top-14 z-[60] px-6 py-8" : N === "panel" ? "absolute inset-0 z-20 px-4 py-6" : "absolute inset-x-0 bottom-0 z-20 h-[11.25rem] border-t border-border-subtle px-3 py-3 shadow-lg"}`,
 		role: "dialog",
-		"aria-modal": I || void 0,
-		"aria-label": k("voiceSession.title", "Voice conversation"),
+		"aria-modal": F || void 0,
+		"aria-label": O("voiceSession.title", "Voice conversation"),
 		"data-testid": "assistant-voice-session",
-		[l]: "",
+		[ie]: "",
 		children: [
-			/* @__PURE__ */ _("button", {
-				ref: M,
+			/* @__PURE__ */ p("button", {
+				ref: j,
 				type: "button",
-				onClick: E,
-				className: `absolute ${I ? "right-6 top-6 h-14 gap-2 px-5 text-base" : L ? "right-12 top-2 h-8 gap-1.5 px-2.5 text-xs" : "right-3 top-3 h-11 gap-2 px-4 text-sm"} flex items-center justify-center rounded-full border border-border-default bg-bg-elevated text-text-secondary hover:bg-bg-sunken transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong`,
-				title: k("voiceSession.end", "End the voice conversation"),
+				onClick: S,
+				className: `absolute ${F ? "right-6 top-6 h-14 gap-2 px-5 text-base" : I ? "right-12 top-2 h-8 gap-1.5 px-2.5 text-xs" : "right-3 top-3 h-11 gap-2 px-4 text-sm"} flex items-center justify-center rounded-full border border-border-default bg-bg-elevated text-text-secondary hover:bg-bg-sunken transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong`,
+				title: O("voiceSession.end", "End the voice conversation"),
 				"data-testid": "assistant-voice-end",
-				children: [/* @__PURE__ */ g(h, {
-					className: I ? "size-6" : L ? "size-4" : "size-5",
+				children: [/* @__PURE__ */ f(d, {
+					className: F ? "size-6" : I ? "size-4" : "size-5",
 					"aria-hidden": "true"
-				}), /* @__PURE__ */ g("span", {
-					className: `truncate whitespace-nowrap font-medium ${L ? "max-w-[3.5rem] text-xs" : "max-w-[7rem]"}`,
-					children: k("voiceSession.endShort", "End")
+				}), /* @__PURE__ */ f("span", {
+					className: `truncate whitespace-nowrap font-medium ${I ? "max-w-[3.5rem] text-xs" : "max-w-[7rem]"}`,
+					children: O("voiceSession.endShort", "End")
 				})]
 			}),
-			/* @__PURE__ */ g("div", {
-				className: `flex flex-col items-center ${L ? "px-3" : `min-h-[1.5rem] ${q ? I ? "pt-14" : "pt-10" : ""}`}`,
-				children: q ? /* @__PURE__ */ g("p", {
+			/* @__PURE__ */ f("div", {
+				className: `flex flex-col items-center ${I ? "px-3" : `min-h-[1.5rem] ${G ? F ? "pt-14" : "pt-10" : ""}`}`,
+				children: G ? /* @__PURE__ */ f("p", {
 					className: "max-w-xs text-center text-xs text-status-warning",
 					"data-testid": "assistant-voice-notice",
-					children: de(y, k)
+					children: _e(h, O)
 				}) : null
 			}),
 			(() => {
-				let e = /* @__PURE__ */ g(ne, {
-					session: v,
-					compact: L,
+				let e = /* @__PURE__ */ f(se, {
+					session: m,
+					compact: I,
 					connecting: Y === "connecting",
-					onPress: n(Y) ? ge : x,
-					label: n(Y) ? k("voiceSession.interrupt", "Stop the assistant and speak") : A ? k("voiceSession.unmute", "Turn the microphone on") : k("voiceSession.mute", "Turn the microphone off")
-				}), t = r(Y) ? b : J || null, i = j === null ? null : fe(j, k);
-				return L ? /* @__PURE__ */ g(re, {
-					spokenChunks: T,
+					onPress: r(Y) ? Se : _,
+					label: r(Y) ? O("voiceSession.interrupt", "Stop the assistant and speak") : k ? O("voiceSession.unmute", "Turn the microphone on") : O("voiceSession.mute", "Turn the microphone off")
+				}), t = q ? /* @__PURE__ */ f("button", {
+					type: "button",
+					onClick: C ? q.imDone : q.letMeFinish,
+					className: `flex items-center justify-center rounded-full border font-medium transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong ${I ? "h-7 px-3 text-xs" : F ? "h-11 px-6 text-base" : "h-9 px-4 text-sm"} ${C ? "border-transparent bg-action-primary-bg text-action-primary-text hover:opacity-90" : "border-border-default bg-bg-elevated text-text-secondary hover:bg-bg-sunken"}`,
+					title: C ? O("voiceSession.imDoneHint", "Send what you said now") : O("voiceSession.letMeFinishHint", "Pause sending until you tap “I’m done”"),
+					"data-testid": "assistant-voice-hold",
+					"data-holding": C ? "true" : "false",
+					children: C ? O("voiceSession.imDone", "I’m done") : O("voiceSession.letMeFinish", "Let me finish")
+				}) : null, n = t ? /* @__PURE__ */ p("div", {
+					className: "flex flex-col items-center gap-2",
+					children: [e, t]
+				}) : e, i = ee(Y) ? g : K || null, a = A === null ? null : ve(A, O);
+				return I ? /* @__PURE__ */ f(ce, {
+					spokenChunks: x,
 					state: Y,
-					caption: t,
-					statusText: Q,
-					statusSuffix: Z,
-					rotateStatus: $,
-					errorText: i,
-					control: e
-				}) : /* @__PURE__ */ g(ie, {
+					caption: i,
+					statusText: $,
+					statusSuffix: Q,
+					rotateStatus: Me,
+					errorText: a,
+					control: n
+				}) : /* @__PURE__ */ f(le, {
 					state: Y,
-					userCaption: J || null,
-					spokenChunks: T,
-					assistantCaption: b,
-					expanded: I,
-					statusText: Q,
-					statusSuffix: Z,
-					rotateStatus: $,
-					errorText: i,
-					control: e
+					userCaption: K || null,
+					spokenChunks: x,
+					assistantCaption: g,
+					expanded: F,
+					statusText: $,
+					statusSuffix: Q,
+					rotateStatus: Me,
+					errorText: a,
+					control: n
 				});
 			})(),
-			D && !V ? /* @__PURE__ */ g("div", {
-				className: L ? "absolute left-20 right-36 top-2 flex justify-center" : `flex w-full justify-center ${I ? "max-w-[calc(100%-12rem)]" : "max-w-[calc(100%-8rem)]"}`,
-				children: /* @__PURE__ */ g("button", {
+			E && !B ? /* @__PURE__ */ f("div", {
+				className: I ? "absolute left-20 right-36 top-2 flex justify-center" : `flex w-full justify-center ${F ? "max-w-[calc(100%-12rem)]" : "max-w-[calc(100%-8rem)]"}`,
+				children: /* @__PURE__ */ f("button", {
 					type: "button",
 					onClick: () => {
-						F("panel"), D.onOpen();
+						P("panel"), E.onOpen();
 					},
-					className: `max-w-full truncate rounded-full border border-border-default bg-bg-elevated font-medium text-text-primary transition-colors hover:bg-bg-raised focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong ${L ? "h-8 px-3 text-xs" : "h-10 px-4 text-sm"}`,
+					className: `max-w-full truncate rounded-full border border-border-default bg-bg-elevated font-medium text-text-primary transition-colors hover:bg-bg-raised focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong ${I ? "h-8 px-3 text-xs" : "h-10 px-4 text-sm"}`,
 					"data-testid": "assistant-voice-proposal-chip",
-					children: D.label
+					children: E.label
 				})
 			}) : null,
-			O && V ? /* @__PURE__ */ _("div", {
-				className: `absolute z-10 flex flex-col gap-2 overflow-y-auto rounded-lg border border-border-subtle bg-bg-elevated shadow-lg ${I ? "inset-x-6 bottom-24 top-24 mx-auto max-w-xl p-4" : "inset-x-3 bottom-16 top-16 p-3"}`,
+			D && B ? /* @__PURE__ */ p("div", {
+				className: `absolute z-10 flex flex-col gap-2 overflow-y-auto rounded-lg border border-border-subtle bg-bg-elevated shadow-lg ${F ? "inset-x-6 bottom-24 top-24 mx-auto max-w-xl p-4" : "inset-x-3 bottom-16 top-16 p-3"}`,
 				"data-testid": "assistant-voice-proposal-tray",
-				children: [/* @__PURE__ */ g("div", {
+				children: [/* @__PURE__ */ f("div", {
 					className: "flex justify-end",
-					children: /* @__PURE__ */ g("button", {
+					children: /* @__PURE__ */ f("button", {
 						type: "button",
-						onClick: O.onClose,
+						onClick: D.onClose,
 						className: "flex size-8 items-center justify-center rounded-full text-text-secondary transition-colors hover:bg-bg-raised hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong",
-						"aria-label": O.closeLabel,
+						"aria-label": D.closeLabel,
 						"data-testid": "assistant-voice-proposal-tray-close",
-						children: /* @__PURE__ */ g(h, {
+						children: /* @__PURE__ */ f(d, {
 							className: "size-4",
 							"aria-hidden": "true"
 						})
 					})
-				}), O.content]
+				}), D.content]
 			}) : null,
-			z ? /* @__PURE__ */ g(ae, {
-				turns: pe,
-				onClose: () => B(!1),
-				onSave: me,
-				onContinueInChat: he
+			R ? /* @__PURE__ */ f(ue, {
+				turns: ye,
+				onClose: () => z(!1),
+				onSave: be,
+				onContinueInChat: xe
 			}) : null,
-			C ? /* @__PURE__ */ g("div", {
-				className: `absolute ${I ? "left-6 top-6" : L ? "left-11 top-2" : "left-3 top-3"}`,
-				children: /* @__PURE__ */ g(u, {
+			y ? /* @__PURE__ */ f("div", {
+				className: `absolute ${F ? "left-6 top-6" : I ? "left-11 top-2" : "left-3 top-3"}`,
+				children: /* @__PURE__ */ f(ae, {
 					onFiles: (e) => {
-						C(e), F((e) => e === "mini" ? "panel" : e);
+						y(e), P((e) => e === "mini" ? "panel" : e);
 					},
-					onPickerOpen: K,
+					onPickerOpen: Ae,
 					direction: "down",
-					canAddMore: ye
+					canAddMore: Te
 				})
 			}) : null,
-			(S.length > 0 || w > 0) && !L ? /* @__PURE__ */ g("div", {
-				className: `absolute ${I ? "bottom-24 left-24 right-24" : "bottom-16 left-16 right-16"}`,
+			(v.length > 0 || b > 0) && !I ? /* @__PURE__ */ f("div", {
+				className: `absolute ${F ? "bottom-24 left-24 right-24" : "bottom-16 left-16 right-16"}`,
 				"data-testid": "assistant-voice-attachments",
-				children: /* @__PURE__ */ g(te, {
-					attachments: S,
-					onRemove: _e ?? (() => void 0),
-					onRetry: ve ?? (() => void 0),
-					preparingCount: w
+				children: /* @__PURE__ */ f(oe, {
+					attachments: v,
+					onRemove: Ce ?? (() => void 0),
+					onRetry: we ?? (() => void 0),
+					preparingCount: b
 				})
 			}) : null,
-			/* @__PURE__ */ g("button", {
+			/* @__PURE__ */ f("button", {
 				type: "button",
-				onClick: () => B((e) => !e),
-				className: `absolute ${I ? "bottom-6 right-6 size-14" : L ? "right-2 top-2 size-8" : "bottom-3 right-3 size-11"} flex items-center justify-center rounded-full bg-bg-elevated text-text-secondary transition-colors hover:bg-bg-raised hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong`,
-				"aria-pressed": z,
-				"aria-label": k("voiceSession.transcriptTitle", "Voice transcript"),
+				onClick: () => z((e) => !e),
+				className: `absolute ${F ? "bottom-6 right-6 size-14" : I ? "right-2 top-2 size-8" : "bottom-3 right-3 size-11"} flex items-center justify-center rounded-full bg-bg-elevated text-text-secondary transition-colors hover:bg-bg-raised hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong`,
+				"aria-pressed": R,
+				"aria-label": O("voiceSession.transcriptTitle", "Voice transcript"),
 				"data-testid": "assistant-voice-transcript-toggle",
-				children: /* @__PURE__ */ g(ue, { className: I ? "size-6" : L ? "size-4" : "size-5" })
+				children: /* @__PURE__ */ f(ge, { className: F ? "size-6" : I ? "size-4" : "size-5" })
 			}),
-			/* @__PURE__ */ g("button", {
+			/* @__PURE__ */ f("button", {
 				type: "button",
-				onClick: () => F(R),
-				className: `absolute ${I ? "bottom-6 left-6 size-14" : L ? "left-2 top-2 size-8" : "bottom-3 left-3 size-11"} flex items-center justify-center rounded-full bg-bg-elevated text-text-secondary transition-colors hover:bg-bg-raised hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong`,
-				"aria-label": R === "panel" ? k("voiceSession.expandPanel", "Show the conversation in the panel") : R === "full" ? k("voiceSession.expand", "Expand the conversation to full screen") : k("voiceSession.collapse", "Shrink to the compact controller"),
+				onClick: () => P(L),
+				className: `absolute ${F ? "bottom-6 left-6 size-14" : I ? "left-2 top-2 size-8" : "bottom-3 left-3 size-11"} flex items-center justify-center rounded-full bg-bg-elevated text-text-secondary transition-colors hover:bg-bg-raised hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong`,
+				"aria-label": L === "panel" ? O("voiceSession.expandPanel", "Show the conversation in the panel") : L === "full" ? O("voiceSession.expand", "Expand the conversation to full screen") : O("voiceSession.collapse", "Shrink to the compact controller"),
 				"data-testid": "assistant-voice-expand",
-				children: I ? /* @__PURE__ */ g(le, { className: "size-5" }) : /* @__PURE__ */ g(ce, { className: L ? "size-4" : "size-5" })
+				children: F ? /* @__PURE__ */ f(he, { className: "size-5" }) : /* @__PURE__ */ f(me, { className: I ? "size-4" : "size-5" })
 			})
 		]
 	});
 };
-function de(e, t) {
+function _e(e, t) {
 	switch (e) {
 		case "network": return t("voiceSession.noticeNetwork", "Speech recognition lost its connection. Check your network — it will retry.");
 		case "not-capturing": return t("voiceSession.noticeNotCapturing", "The microphone did not start. Check that this site is allowed to use it, then try again.");
@@ -236,7 +259,7 @@ function de(e, t) {
 		default: return e;
 	}
 }
-function fe(e, t) {
+function ve(e, t) {
 	switch (e) {
 		case "mic-denied": return t("voiceSession.micDenied", "Microphone access is blocked. Allow it in your browser settings to talk.");
 		case "no-speech-support": return t("voiceSession.noSpeechSupport", "This browser cannot listen. Try a different browser, or type instead.");
@@ -245,4 +268,4 @@ function fe(e, t) {
 	}
 }
 //#endregion
-export { v as AssistantVoiceSession };
+export { m as AssistantVoiceSession };

package/dist/shared/assistant/voice/handsFree.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Hands-free voice, steps H1 and H2 — the pure rules (BOFF hands-free slice).
+ *
+ * Everything here is data in, decision out: no DOM, no timers, no React, for
+ * the reason `voiceSession.ts` gives (this repo's unit runner has no browser).
+ * The hook (`useVoiceSession`) owns the clock and the recogniser; this file
+ * owns what the words and the preference MEAN.
+ *
+ * ★ H1 — the end-of-speech grace is a USER PREFERENCE (2 s default, 3 s, 5 s),
+ * and there is exactly ONE timing owner: `planSubmitTimer`. The old
+ * `SILENCE_SUBMIT_MS` constant is gone; the value the timer waits is the
+ * preference, resolved by `resolveVoiceGraceMs`. Nothing else in the package
+ * waits before submitting a spoken turn (`ENDPOINT_GRACE_MS` only decides when
+ * the stage SHOWS the pause, and is clamped inside the grace).
+ *
+ * ★ H2 — corrections while the assistant is still PREPARING an answer. The
+ * microphone stays open in `thinking`, so a recogniser can deliver three kinds
+ * of result there, and telling them apart is the whole difficulty:
+ *   1. a trailing result of the turn JUST submitted (Chrome finalises late;
+ *      Chrome Android re-sends the whole utterance, sometimes revised) — must
+ *      be ignored, or every spoken question is aborted and sent twice;
+ *   2. noise and fillers ("uh", "hmm") — must not abort a model turn;
+ *   3. a person speaking — a correction: the turn is superseded.
+ * `planThinkingSpeech` is that classification.
+ *
+ * A spoken "yes" never commits a business write. In `thinking` a bare
+ * affirmation is therefore NOT a correction at all: it neither aborts the turn
+ * nor withdraws anything (`classifyWriteReply` is the same classifier the 5a
+ * binder uses). The binder, and the card's button, stay the only way a change
+ * is confirmed.
+ */
+/** The choices offered in the voice settings, shortest first. */
+export declare const VOICE_GRACE_CHOICES_MS: readonly [2000, 3000, 5000];
+export type VoiceGraceMs = (typeof VOICE_GRACE_CHOICES_MS)[number];
+/**
+ * How long the user must stop talking before the turn is submitted, until they
+ * choose otherwise.
+ *
+ * ★ 2000, not 1200: 1.2 s does not survive an ordinary pause. Once a turn is
+ * submitted the reducer discards the rest of the sentence, so cutting someone
+ * off costs the whole round trip AND makes them repeat themselves — waiting
+ * 800 ms longer costs only a moment of silence. The asymmetry is what settled
+ * the number, and it is why the longer choices exist for people who pause more.
+ */
+export declare const DEFAULT_VOICE_GRACE_MS: VoiceGraceMs;
+/**
+ * Read a stored or passed value as one of the offered choices.
+ *
+ * Anything else — a stale number from an older build, a string, `null`, a value
+ * hand-edited into storage — is the default, never a nearby choice: a grace of
+ * 0 or 600000 ms read back from storage would either submit mid-word or never
+ * submit at all.
+ */
+export declare function resolveVoiceGraceMs(value: unknown): VoiceGraceMs;
+/**
+ * The ONE decision about the submit timer.
+ *
+ * `arm` is true only for a listening, unmuted session with something worth
+ * sending, and NOT while the person asked to finish in their own time
+ * ("Let me finish", `holding`). `delayMs` is the preference. The hook re-asks
+ * on every change of the session, so new speech cancels a pending submit and
+ * the turn continues — there is no second timer to forget.
+ */
+export declare function planSubmitTimer(input: {
+    phase: string;
+    muted: boolean;
+    /** Everything heard this turn (`spokenSoFar`). */
+    spoken: string;
+    /** "Let me finish" is on: nothing is submitted until the person says done. */
+    holding: boolean;
+    /** The preference, in ms. */
+    graceMs: number;
+}): {
+    arm: boolean;
+    delayMs: number;
+};
+/**
+ * The comparable words of a transcript: letters, marks and digits only (marks
+ * kept — Tamil and Hindi vowel signs are marks), lower-cased. Punctuation and
+ * capitals a final adds are not speech.
+ */
+export declare function speechWords(text: string): string[];
+/**
+ * Add a newly finalised phrase to the turn heard so far.
+ *
+ * ★ Chrome Android duplicates finals. With `continuous` on, a restarted
+ * recogniser can re-send the phrase it just finalised, and it often re-sends
+ * the WHOLE utterance so far with a few words added. Plain concatenation turned
+ * "when should I sow" into "when should I sow when should I sow ragi" and sent
+ * that. So:
+ *  - a phrase that STARTS WITH everything heard is the same utterance, longer
+ *    or equal: it replaces what was heard;
+ *  - a phrase of two or more words that the turn already ENDS with is a
+ *    repeat: dropped;
+ *  - anything else is new speech: appended.
+ * A single repeated word is kept unless it is the whole turn — "no no" is
+ * emphasis, but a lone "hello" arriving twice is the recogniser.
+ */
+export declare function mergeFinalPhrase(pending: string, phrase: string): string;
+/**
+ * A transcript without the words of the turn it follows, when it starts with
+ * them (a cumulative result: "when should I sow ragi" after "when should I
+ * sow"). Anything else is returned unchanged.
+ */
+export declare function stripSubmittedPrefix(transcript: string, submitted: string): string;
+/**
+ * How long after a turn is submitted its OWN trailing results may still arrive.
+ *
+ * The person was silent for the whole grace (2 s at least), so anything
+ * arriving this soon after the submit and resembling what was sent is the
+ * recogniser finishing the sentence, not a correction. Past it, only an exact
+ * repeat is ignored — a person correcting "plant ragi in June" with "no plant
+ * ragi in July" is speaking, however alike the words are.
+ */
+export declare const TRAILING_RESULT_WINDOW_MS = 1500;
+/**
+ * Is this transcript the recogniser finishing, repeating or revising the turn
+ * that was just submitted?
+ *
+ * `sinceSubmitMs` is null when unknown (no clock): then only an exact repeat
+ * counts, which can only ever err towards treating speech as speech.
+ */
+export declare function isTrailingResultOfSubmitted(transcript: string, submitted: string, sinceSubmitMs: number | null): boolean;
+/**
+ * Is this a person speaking, rather than noise?
+ *
+ * Aborting a model turn costs the turn, so the bar is two letters or digits
+ * that are not all filler. "no" and "ok" pass; "a", "uh" and "hmm" do not. A
+ * single Han, kana or Hangul character passes — "不" is a whole word.
+ */
+export declare function isGenuineUserSpeech(text: string): boolean;
+/** What a result heard while the answer is being prepared amounts to. */
+export type ThinkingSpeechPlan = {
+    kind: "ignore";
+    reason: "empty" | "trailing" | "noise" | "affirmation";
+} | {
+    kind: "supersede";
+    /** What the person said, without the words of the turn it corrects. */
+    text: string;
+};
+/**
+ * Classify a result that arrives while the assistant is PREPARING an answer.
+ *
+ * Ignored: nothing; the recogniser finishing, repeating or revising the turn
+ * just submitted; noise; and a bare affirmation (a spoken "yes" is never a
+ * correction, and never commits a write — see the header). Everything else is
+ * a correction.
+ *
+ * Echo is not checked here: nothing plays during `thinking`. The caller still
+ * passes the previous reply through `isEcho` first, because its tail can sound
+ * for a moment after playback ends.
+ */
+export declare function planThinkingSpeech(input: {
+    transcript: string;
+    /** The turn in flight, as it was sent. */
+    submitted: string;
+    /** Milliseconds since it was sent, or null when no clock was given. */
+    sinceSubmitMs: number | null;
+}): ThinkingSpeechPlan;
+//# sourceMappingURL=handsFree.d.ts.map

package/dist/shared/assistant/voice/handsFree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handsFree.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/handsFree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAQH,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,6BAA8B,CAAC;AAElE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAAmB,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAEhE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAIpC;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMlD;AA6BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQxE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAelF;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAK9C;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAYT;AAyBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,aAAa,CAAA;CAAE,GAC1E;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,kBAAkB,CASrB"}