@burdenoff/fe-libs 2026.1014.5 → 2026.1015.1

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

@@ -1,290 +1,296 @@
 import { useReturnFocus as e } from "../../../hooks/useReturnFocus.js";
 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 re } from "../../voice/voiceSession.js";
-import { useAvatarCopy as ie } from "../../avatar/useAvatarCopy.js";
-import { ASSISTANT_PANEL_ATTR as ae, ASSISTANT_VOICE_SESSION_ATTR as oe } from "../panelOverlays.js";
-import { useLiveAvatarHandsFreeGuard as se, useLiveAvatarVoiceView as ce } from "../assistantLiveAvatarSeam.js";
-import { AssistantAttachmentButton as le } from "../composer/AssistantAttachmentButton.js";
-import { AssistantAttachmentChips as ue } from "../composer/AssistantAttachmentChips.js";
-import { AssistantVoiceOrb as de } from "./AssistantVoiceOrb.js";
-import { VoiceMiniController as fe } from "./VoiceMiniController.js";
-import { VoiceStage as pe } from "./VoiceStage.js";
-import { VoiceTranscriptDrawer as me } from "./VoiceTranscriptDrawer.js";
-import { escapeBelongsToLayerAbove as he, voiceSessionEscapeAction as ge } from "./voiceSessionEscape.js";
-import { HandsFreePrivacyNotice as _e } from "./HandsFreePrivacyNotice.js";
-import { useCallback as o, useEffect as s, useMemo as ve, useRef as c, useState as l } from "react";
-import { Maximize2 as ye, Minimize2 as be, ScrollText as xe, X as u } from "lucide-react";
-import { jsx as d, jsxs as f } from "react/jsx-runtime";
+import { micIsInterrupt as r, showsAssistantCaption as ee, voiceStageState as te } from "../../voice/voiceStageState.js";
+import { VOICE_THINKING_LABEL as i, composeVoiceStatus as ne, voiceStatusSuffix as re } from "../../voice/voiceStatus.js";
+import { spokenSoFar as ie } from "../../voice/voiceSession.js";
+import { useAvatarCopy as ae } from "../../avatar/useAvatarCopy.js";
+import { ASSISTANT_PANEL_ATTR as oe, ASSISTANT_VOICE_SESSION_ATTR as se } from "../panelOverlays.js";
+import { useLiveAvatarHandsFreeGuard as ce, useLiveAvatarTab as le, useLiveAvatarVoiceView as ue } from "../assistantLiveAvatarSeam.js";
+import { AssistantAttachmentButton as de } from "../composer/AssistantAttachmentButton.js";
+import { AssistantAttachmentChips as fe } from "../composer/AssistantAttachmentChips.js";
+import { AssistantVoiceOrb as pe } from "./AssistantVoiceOrb.js";
+import { VoiceMiniController as me } from "./VoiceMiniController.js";
+import { VoiceStage as he } from "./VoiceStage.js";
+import { VoiceTranscriptDrawer as ge } from "./VoiceTranscriptDrawer.js";
+import { escapeBelongsToLayerAbove as _e, voiceSessionEscapeAction as ve } from "./voiceSessionEscape.js";
+import { HandsFreePrivacyNotice as ye } from "./HandsFreePrivacyNotice.js";
+import { useCallback as a, useEffect as o, useMemo as be, useRef as s, useState as c } from "react";
+import { Maximize2 as xe, Minimize2 as Se, ScrollText as Ce, X as l } from "lucide-react";
+import { jsx as u, jsxs as d } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/voice/AssistantVoiceSession.tsx
-var p = ({ session: p, turns: we = [], onSaveTranscript: Te, onContinueInChat: Ee, notice: m = null, privacyNotice: h = null, spoken: g, onInterrupt: De, onToggleMute: _, attachments: v = [], onAttachFiles: y, onRemoveAttachment: Oe, onRetryAttachment: ke, canAttachMore: Ae = !0, preparingAttachments: b = 0, attachmentsLocked: x = !1, attachmentNotice: S = null, spokenChunks: C = null, onEnd: w, capturing: je = !0, interrupting: Me = !1, awaitingEndpoint: Ne = !1, holding: T = !1, correcting: Pe = !1, onLetMeFinish: E, onImDone: D, proposalChip: O = null, proposalTray: k = null, renderAfterTurn: Fe }) => {
-	let A = n(), { muted: j, error: M } = p, N = c(null), P = c(null), [Ie, F] = l("mini"), I = ce(Ie, p.phase === "ended"), Le = se(), L = ie(), R = I === "full", z = I === "mini", B = I === "mini" ? "panel" : I === "panel" ? "full" : "mini", [V, H] = l(!1);
-	t("assistant.transcript", ve(() => ({ run: () => V ? { status: "already" } : (H(!0), { status: "done" }) }), [V]));
-	let U = k !== null && !z, W = c(!1), G = c(_);
-	G.current = _;
-	let K = o(() => {
-		p.phase !== "listening" && p.phase !== "thinking" || j || W.current || re(p) || (W.current = !0, G.current());
-	}, [j, p]), q = o(() => {
-		W.current && (W.current = !1, G.current());
-	}, []), Re = K;
-	s(() => {
+var f = ({ session: f, turns: Te = [], onSaveTranscript: Ee, onContinueInChat: De, notice: m = null, privacyNotice: h = null, spoken: g, onInterrupt: Oe, onToggleMute: _, attachments: v = [], onAttachFiles: y, onRemoveAttachment: ke, onRetryAttachment: Ae, canAttachMore: je = !0, preparingAttachments: Me = 0, attachmentsLocked: b = !1, attachmentNotice: x = null, spokenChunks: S = null, onEnd: C, capturing: Ne = !0, interrupting: Pe = !1, awaitingEndpoint: Fe = !1, holding: w = !1, correcting: Ie = !1, onLetMeFinish: T, onImDone: E, proposalChip: D = null, proposalTray: O = null, renderAfterTurn: Le, onViewChange: k }) => {
+	let A = n(), { muted: j, error: M } = f, N = s(null), P = s(null), [F, I] = c("mini"), L = le().open, [Re, ze] = c(L);
+	Re !== L && (ze(L), L && F !== "mini" && I("mini"));
+	let R = ue(F, f.phase === "ended"), Be = ce();
+	o(() => {
+		k?.(R);
+	}, [k, R]);
+	let Ve = ae(), z = R === "full", B = R === "mini", V = R === "mini" ? "panel" : R === "panel" ? "full" : "mini", [H, U] = c(!1);
+	t("assistant.transcript", be(() => ({ run: () => H ? { status: "already" } : (U(!0), { status: "done" }) }), [H]));
+	let W = O !== null && !B, G = s(!1), K = s(_);
+	K.current = _;
+	let q = a(() => {
+		f.phase !== "listening" && f.phase !== "thinking" || j || G.current || ie(f) || (G.current = !0, K.current());
+	}, [j, f]), J = a(() => {
+		G.current && (G.current = !1, K.current());
+	}, []), He = q;
+	o(() => {
 		let e = () => {
-			document.visibilityState === "hidden" ? K() : q();
+			document.visibilityState === "hidden" ? q() : J();
 		};
 		return document.addEventListener("visibilitychange", e), () => document.removeEventListener("visibilitychange", e);
-	}, [K, q]), s(() => {
-		let e = q;
+	}, [q, J]), o(() => {
+		let e = J;
 		return window.addEventListener("focus", e), () => {
-			window.removeEventListener("focus", e), W.current = !1;
+			window.removeEventListener("focus", e), G.current = !1;
 		};
-	}, []), s(() => {
+	}, []), o(() => {
 		document.activeElement?.closest("[data-hands-free-notice]") || N.current?.focus();
-	}, []), e(P, { fallbackSelector: `[${ae}]` }), s(() => {
+	}, []), e(P, { fallbackSelector: `[${oe}]` }), o(() => {
 		let e = (e) => {
 			if (e.key === "Escape") {
-				let t = ge({
+				let t = ve({
 					defaultPrevented: e.defaultPrevented,
-					layerAbove: he({
+					layerAbove: _e({
 						target: e.target,
 						session: P.current,
 						doc: document
 					}),
-					transcriptOpen: V
+					transcriptOpen: H
 				});
 				if (t === "ignore") return;
-				e.preventDefault(), t === "close-transcript" ? H(!1) : h ? h.decline() : U ? k?.onClose() : w();
+				e.preventDefault(), t === "close-transcript" ? U(!1) : h ? h.decline() : W ? O?.onClose() : C();
 				return;
 			}
-			if (e.key !== "Tab" || !R) return;
-			let t = (V ? P.current?.querySelector("[data-testid=\"assistant-voice-transcript\"]") : P.current)?.querySelectorAll("button:not([disabled])");
+			if (e.key !== "Tab" || !z) return;
+			let t = (H ? P.current?.querySelector("[data-testid=\"assistant-voice-transcript\"]") : P.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);
 	}, [
-		w,
-		R,
-		V,
-		U,
-		k,
+		C,
+		z,
+		H,
+		W,
+		O,
 		h
 	]);
-	let J = m !== null && M === null, Y = Le && m === null && M === null, ze = re(p), X = E && D && p.phase === "listening" && !j && M === null ? {
-		letMeFinish: E,
-		imDone: D
-	} : null, Be = X !== null;
-	s(() => {
-		if (Be) return;
+	let Y = m !== null && M === null, X = Be && m === null && M === null, Ue = ie(f), Z = T && E && f.phase === "listening" && !j && M === null ? {
+		letMeFinish: T,
+		imDone: E
+	} : null, We = Z !== null;
+	o(() => {
+		if (We) return;
 		let e = document.activeElement;
 		(!e || e === document.body) && N.current?.focus();
-	}, [Be]);
-	let Z = i({
-		snapshot: p,
-		capturing: je,
-		interrupting: Me,
-		awaitingEndpoint: Ne
-	}), Ve = (() => {
-		switch (Z) {
+	}, [We]);
+	let Q = te({
+		snapshot: f,
+		capturing: Ne,
+		interrupting: Pe,
+		awaitingEndpoint: Fe
+	}), Ge = (() => {
+		switch (Q) {
 			case "connecting": return A("voiceSession.connecting", "Starting the microphone…");
 			case "endpoint-grace": return A("voiceSession.endpointGrace", "Still listening — take your time");
 			case "interrupting": return A("voiceSession.interrupting", "Stopped — go ahead");
-			case "thinking": return A(a.key, a.fallback);
+			case "thinking": return A(i.key, i.fallback);
 			case "speaking": return A("voiceSession.speaking", "Speaking — tap to stop");
 			case "mic-error":
 			case "ended": return "";
 			case "listening": return j ? A("voiceSession.muted", "Microphone off") : A("voiceSession.listening", "Listening…");
-			default: return Z;
+			default: return Q;
 		}
-	})(), He = !j && (Z === "listening" || Z === "endpoint-grace"), Ue = He && T ? A("voiceSession.holding", "Take your time — tap “I’m done” when you finish") : He && Pe ? A("voiceSession.correcting", "Stopped that answer — listening to your correction") : Ve, Q = ne({
+	})(), Ke = !j && (Q === "listening" || Q === "endpoint-grace"), qe = Ke && w ? A("voiceSession.holding", "Take your time — tap “I’m done” when you finish") : Ke && Ie ? A("voiceSession.correcting", "Stopped that answer — listening to your correction") : Ge, $ = re({
 		tr: A,
-		stage: Z,
+		stage: Q,
 		muted: j,
-		label: Ue
-	}), We = te(Ue, Q), $ = Z === "thinking";
-	return /* @__PURE__ */ f("div", {
+		label: qe
+	}), Je = ne(qe, $), Ye = Q === "thinking";
+	return /* @__PURE__ */ d("div", {
 		ref: P,
-		className: `flex flex-col items-center justify-between bg-bg-sunken ${I === "full" ? "fixed inset-x-0 bottom-0 top-14 z-[60] px-6 py-8" : I === "panel" ? "absolute inset-0 z-20 px-4 py-6" : "absolute inset-x-0 bottom-0 z-20 min-h-[11.25rem] border-t border-border-subtle px-3 py-3 shadow-lg"}`,
+		className: `flex flex-col items-center justify-between bg-bg-sunken ${R === "full" ? "fixed inset-x-0 bottom-0 top-14 z-[60] px-6 py-8" : R === "panel" ? "absolute inset-0 z-20 px-4 py-6" : "absolute inset-x-0 bottom-0 z-20 min-h-[11.25rem] border-t border-border-subtle px-3 py-3 shadow-lg"}`,
 		role: "dialog",
-		"aria-modal": R || void 0,
+		"aria-modal": z || void 0,
 		"aria-label": A("voiceSession.title", "Voice conversation"),
 		"data-testid": "assistant-voice-session",
-		[oe]: "",
+		[se]: "",
 		children: [
-			/* @__PURE__ */ f("button", {
+			/* @__PURE__ */ d("button", {
 				ref: N,
 				type: "button",
-				onClick: w,
-				className: `absolute ${R ? "right-6 top-6 h-14 gap-2 px-5 text-base" : z ? "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`,
+				onClick: C,
+				className: `absolute ${z ? "right-6 top-6 h-14 gap-2 px-5 text-base" : B ? "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: A("voiceSession.end", "End the voice conversation"),
 				"data-testid": "assistant-voice-end",
-				children: [/* @__PURE__ */ d(u, {
-					className: R ? "size-6" : z ? "size-4" : "size-5",
+				children: [/* @__PURE__ */ u(l, {
+					className: z ? "size-6" : B ? "size-4" : "size-5",
 					"aria-hidden": "true"
-				}), /* @__PURE__ */ d("span", {
-					className: `truncate whitespace-nowrap font-medium ${z ? "max-w-[3.5rem] text-xs" : "max-w-[7rem]"}`,
+				}), /* @__PURE__ */ u("span", {
+					className: `truncate whitespace-nowrap font-medium ${B ? "max-w-[3.5rem] text-xs" : "max-w-[7rem]"}`,
 					children: A("voiceSession.endShort", "End")
 				})]
 			}),
-			/* @__PURE__ */ f("div", {
-				className: `flex flex-col items-center ${z ? `px-3 ${J || Y || S ? "pt-9 pb-2" : ""}` : `min-h-[1.5rem] ${J || Y || S ? R ? "pt-14" : "pt-10" : ""}`}`,
+			/* @__PURE__ */ d("div", {
+				className: `flex flex-col items-center ${B ? `px-3 ${Y || X || x ? "pt-9 pb-2" : ""}` : `min-h-[1.5rem] ${Y || X || x ? z ? "pt-14" : "pt-10" : ""}`}`,
 				children: [
-					J ? /* @__PURE__ */ d("p", {
+					Y ? /* @__PURE__ */ u("p", {
 						className: "max-w-xs text-center text-xs text-status-warning",
 						"data-testid": "assistant-voice-notice",
-						children: Se(m, A)
+						children: p(m, A)
 					}) : null,
-					Y ? /* @__PURE__ */ d("p", {
+					X ? /* @__PURE__ */ u("p", {
 						className: "max-w-xs text-center text-xs text-text-secondary",
 						"data-testid": "assistant-voice-avatar-hands-free",
-						children: L.handsFreeOff
+						children: Ve.handsFreeOff
 					}) : null,
-					/* @__PURE__ */ d("span", {
+					/* @__PURE__ */ u("span", {
 						className: "sr-only start-0 top-0",
 						role: "status",
 						"aria-live": "polite",
 						"aria-atomic": "true",
 						"data-testid": "assistant-voice-notice-announced",
-						children: J && m === "reply-not-heard" ? Se(m, A) : Y ? L.handsFreeOff : null
+						children: Y && m === "reply-not-heard" ? p(m, A) : X ? Ve.handsFreeOff : null
 					}),
-					S ? /* @__PURE__ */ d("p", {
+					x ? /* @__PURE__ */ u("p", {
 						className: "max-w-xs text-center text-xs text-status-warning",
 						role: "status",
 						"aria-live": "polite",
 						"data-testid": "assistant-voice-attachment-notice",
-						children: S
+						children: x
 					}) : null
 				]
 			}),
 			(() => {
-				let e = /* @__PURE__ */ d(de, {
-					session: p,
-					compact: z,
-					connecting: Z === "connecting",
-					onPress: r(Z) ? De : _,
-					label: r(Z) ? A("voiceSession.interrupt", "Stop the assistant and speak") : j ? A("voiceSession.unmute", "Turn the microphone on") : A("voiceSession.mute", "Turn the microphone off")
-				}), t = X ? /* @__PURE__ */ d("button", {
+				let e = /* @__PURE__ */ u(pe, {
+					session: f,
+					compact: B,
+					connecting: Q === "connecting",
+					onPress: r(Q) ? Oe : _,
+					label: r(Q) ? A("voiceSession.interrupt", "Stop the assistant and speak") : j ? A("voiceSession.unmute", "Turn the microphone on") : A("voiceSession.mute", "Turn the microphone off")
+				}), t = Z ? /* @__PURE__ */ u("button", {
 					type: "button",
-					onClick: T ? X.imDone : X.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 ${z ? "h-7 px-3 text-xs" : R ? "h-11 px-6 text-base" : "h-9 px-4 text-sm"} ${T ? "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: T ? A("voiceSession.imDoneHint", "Send what you said now") : A("voiceSession.letMeFinishHint", "Pause sending until you tap “I’m done”"),
+					onClick: w ? Z.imDone : Z.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 ${B ? "h-7 px-3 text-xs" : z ? "h-11 px-6 text-base" : "h-9 px-4 text-sm"} ${w ? "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: w ? A("voiceSession.imDoneHint", "Send what you said now") : A("voiceSession.letMeFinishHint", "Pause sending until you tap “I’m done”"),
 					"data-testid": "assistant-voice-hold",
-					"data-holding": T ? "true" : "false",
-					children: T ? A("voiceSession.imDone", "I’m done") : A("voiceSession.letMeFinish", "Let me finish")
-				}) : null, n = t ? /* @__PURE__ */ f("div", {
+					"data-holding": w ? "true" : "false",
+					children: w ? A("voiceSession.imDone", "I’m done") : A("voiceSession.letMeFinish", "Let me finish")
+				}) : null, n = t ? /* @__PURE__ */ d("div", {
 					className: "flex flex-col items-center gap-2",
 					children: [e, t]
-				}) : e, i = ee(Z) ? g : ze || null, a = M === null ? null : Ce(M, A);
-				return z ? /* @__PURE__ */ d(fe, {
-					spokenChunks: C,
-					state: Z,
-					caption: i,
-					statusText: We,
-					statusSuffix: Q,
-					rotateStatus: $,
-					errorText: a,
+				}) : e, te = ee(Q) ? g : Ue || null, i = M === null ? null : we(M, A);
+				return B ? /* @__PURE__ */ u(me, {
+					spokenChunks: S,
+					state: Q,
+					caption: te,
+					statusText: Je,
+					statusSuffix: $,
+					rotateStatus: Ye,
+					errorText: i,
 					control: n
-				}) : /* @__PURE__ */ d(pe, {
-					state: Z,
-					userCaption: ze || null,
-					spokenChunks: C,
+				}) : /* @__PURE__ */ u(he, {
+					state: Q,
+					userCaption: Ue || null,
+					spokenChunks: S,
 					assistantCaption: g,
-					expanded: R,
-					statusText: We,
-					statusSuffix: Q,
-					rotateStatus: $,
-					errorText: a,
+					expanded: z,
+					statusText: Je,
+					statusSuffix: $,
+					rotateStatus: Ye,
+					errorText: i,
 					control: n
 				});
 			})(),
-			O && !U ? /* @__PURE__ */ d("div", {
-				className: z ? "absolute left-20 right-36 top-2 flex justify-center" : `flex w-full justify-center ${R ? "max-w-[calc(100%-12rem)]" : "max-w-[calc(100%-8rem)]"}`,
-				children: /* @__PURE__ */ d("button", {
+			D && !W ? /* @__PURE__ */ u("div", {
+				className: B ? "absolute left-20 right-36 top-2 flex justify-center" : `flex w-full justify-center ${z ? "max-w-[calc(100%-12rem)]" : "max-w-[calc(100%-8rem)]"}`,
+				children: /* @__PURE__ */ u("button", {
 					type: "button",
 					onClick: () => {
-						F("panel"), O.onOpen();
+						I("panel"), D.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 ${z ? "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 ${B ? "h-8 px-3 text-xs" : "h-10 px-4 text-sm"}`,
 					"data-testid": "assistant-voice-proposal-chip",
-					children: O.label
+					children: D.label
 				})
 			}) : null,
-			k && U ? /* @__PURE__ */ f("div", {
-				className: `absolute z-10 flex flex-col gap-2 overflow-y-auto rounded-lg border border-border-subtle bg-bg-elevated shadow-lg ${R ? "inset-x-6 bottom-24 top-24 mx-auto max-w-xl p-4" : "inset-x-3 bottom-16 top-16 p-3"}`,
+			O && W ? /* @__PURE__ */ d("div", {
+				className: `absolute z-10 flex flex-col gap-2 overflow-y-auto rounded-lg border border-border-subtle bg-bg-elevated shadow-lg ${z ? "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__ */ d("div", {
+				children: [/* @__PURE__ */ u("div", {
 					className: "flex justify-end",
-					children: /* @__PURE__ */ d("button", {
+					children: /* @__PURE__ */ u("button", {
 						type: "button",
-						onClick: k.onClose,
+						onClick: O.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": k.closeLabel,
+						"aria-label": O.closeLabel,
 						"data-testid": "assistant-voice-proposal-tray-close",
-						children: /* @__PURE__ */ d(u, {
+						children: /* @__PURE__ */ u(l, {
 							className: "size-4",
 							"aria-hidden": "true"
 						})
 					})
-				}), k.content]
+				}), O.content]
 			}) : null,
-			h ? /* @__PURE__ */ d(_e, {
-				view: I,
+			h ? /* @__PURE__ */ u(ye, {
+				view: R,
 				onContinue: h.accept,
 				onNotNow: h.decline
 			}) : null,
-			V ? /* @__PURE__ */ d(me, {
-				turns: we,
-				onClose: () => H(!1),
-				onSave: Te,
-				onContinueInChat: Ee,
-				renderAfterTurn: Fe
+			H ? /* @__PURE__ */ u(ge, {
+				turns: Te,
+				onClose: () => U(!1),
+				onSave: Ee,
+				onContinueInChat: De,
+				renderAfterTurn: Le
 			}) : null,
-			y ? /* @__PURE__ */ d("div", {
-				className: `absolute ${R ? "left-6 top-6" : z ? "left-11 top-2" : "left-3 top-3"}`,
-				children: /* @__PURE__ */ d(le, {
+			y ? /* @__PURE__ */ u("div", {
+				className: `absolute ${z ? "left-6 top-6" : B ? "left-11 top-2" : "left-3 top-3"}`,
+				children: /* @__PURE__ */ u(de, {
 					onFiles: (e) => {
-						y(e), F((e) => e === "mini" ? "panel" : e);
+						y(e), I((e) => e === "mini" ? "panel" : e);
 					},
-					onPickerOpen: Re,
+					onPickerOpen: He,
 					direction: "down",
-					canAddMore: Ae,
-					disabled: x
+					canAddMore: je,
+					disabled: b
 				})
 			}) : null,
-			(v.length > 0 || b > 0) && !z ? /* @__PURE__ */ d("div", {
-				className: `absolute ${R ? "bottom-24 left-24 right-24" : "bottom-16 left-16 right-16"}`,
+			(v.length > 0 || Me > 0) && !B ? /* @__PURE__ */ u("div", {
+				className: `absolute ${z ? "bottom-24 left-24 right-24" : "bottom-16 left-16 right-16"}`,
 				"data-testid": "assistant-voice-attachments",
-				children: /* @__PURE__ */ d(ue, {
+				children: /* @__PURE__ */ u(fe, {
 					attachments: v,
-					onRemove: Oe ?? (() => void 0),
-					onRetry: ke ?? (() => void 0),
-					preparingCount: b,
-					disabled: x
+					onRemove: ke ?? (() => void 0),
+					onRetry: Ae ?? (() => void 0),
+					preparingCount: Me,
+					disabled: b
 				})
 			}) : null,
-			/* @__PURE__ */ d("button", {
+			/* @__PURE__ */ u("button", {
 				type: "button",
-				onClick: () => H((e) => !e),
-				className: `absolute ${R ? "bottom-6 right-6 size-14" : z ? "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": V,
+				onClick: () => U((e) => !e),
+				className: `absolute ${z ? "bottom-6 right-6 size-14" : B ? "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": H,
 				"aria-label": A("voiceSession.transcriptTitle", "Voice transcript"),
 				"data-testid": "assistant-voice-transcript-toggle",
-				children: /* @__PURE__ */ d(xe, { className: R ? "size-6" : z ? "size-4" : "size-5" })
+				children: /* @__PURE__ */ u(Ce, { className: z ? "size-6" : B ? "size-4" : "size-5" })
 			}),
-			/* @__PURE__ */ d("button", {
+			/* @__PURE__ */ u("button", {
 				type: "button",
-				onClick: () => F(B),
-				className: `absolute ${R ? "bottom-6 left-6 size-14" : z ? "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": B === "panel" ? A("voiceSession.expandPanel", "Show the conversation in the panel") : B === "full" ? A("voiceSession.expand", "Expand the conversation to full screen") : A("voiceSession.collapse", "Shrink to the compact controller"),
+				onClick: () => I(V),
+				className: `absolute ${z ? "bottom-6 left-6 size-14" : B ? "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": V === "panel" ? A("voiceSession.expandPanel", "Show the conversation in the panel") : V === "full" ? A("voiceSession.expand", "Expand the conversation to full screen") : A("voiceSession.collapse", "Shrink to the compact controller"),
 				"data-testid": "assistant-voice-expand",
-				children: R ? /* @__PURE__ */ d(be, { className: "size-5" }) : /* @__PURE__ */ d(ye, { className: z ? "size-4" : "size-5" })
+				children: z ? /* @__PURE__ */ u(Se, { className: "size-5" }) : /* @__PURE__ */ u(xe, { className: B ? "size-4" : "size-5" })
 			})
 		]
 	});
 };
-function Se(e, t) {
+function p(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.");
@@ -296,7 +302,7 @@ function Se(e, t) {
 		default: return e;
 	}
 }
-function Ce(e, t) {
+function we(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.");
@@ -305,4 +311,4 @@ function Ce(e, t) {
 	}
 }
 //#endregion
-export { p as AssistantVoiceSession };
+export { f as AssistantVoiceSession };

package/dist/shared/assistant/ui/voice/voiceStartGate.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Whether a voice conversation can start now, and if not, why (BOFF-9341,
+ * critic #6).
+ *
+ * ★★ ONE check, the composer's FULL one. The composer offers its Voice button
+ * only where voice can work at all and the active mode takes it
+ * (`onStartVoiceSession`: `voiceSession.available && voiceAllowedInActiveMode`),
+ * disables it while the conversation cannot take a turn (its `disabled` and
+ * `readOnly`: a turn in flight, an approval being recorded, history loading,
+ * navigation busy, a read-only conversation) or while a Send saves its
+ * attachments (`committing`), and hides it while dictation holds the
+ * microphone. The Avatar tab's "Start a voice conversation" is the same
+ * conversation, so it asks exactly this: a button that skipped part of it
+ * could open a voice conversation the composer would have refused, or turn on
+ * a paid avatar in a mode (the write-capable `api-calls` one with no voice
+ * proposal bound to it) where nothing could ever be asked of it.
+ *
+ * Pure, so the rule is testable without a DOM; the chat area hands it the
+ * same expressions it hands the composer (`avatarTab.client.test.tsx` pins
+ * that).
+ */
+/** Why a voice conversation cannot start now, most lasting first. */
+export type VoiceStartBlocker = 
+/** Nothing here can hold a voice conversation (no speech input, or nothing to speak the reply). */
+"unavailable"
+/** The active mode takes no voice (it writes, and no voice proposal is bound to it). */
+ | "mode"
+/** This conversation takes no new turn at all. */
+ | "read-only"
+/** Not now: a turn in flight, an approval being recorded, history loading, navigation busy. */
+ | "busy"
+/** Not now: a Send is saving its attachments. */
+ | "committing"
+/** Not now: dictation holds the microphone. */
+ | "dictating";
+export interface VoiceStartGateInput {
+    /** `voiceSession.available`: speech in and out work here. */
+    readonly available: boolean;
+    /** `voiceAllowedInActiveMode`. */
+    readonly allowedInMode: boolean;
+    /** The conversation is read-only (the composer's `readOnly`). */
+    readonly readOnly: boolean;
+    /** The composer's `disabled`. */
+    readonly busy: boolean;
+    /** The composer is saving a Send's attachments. */
+    readonly committing: boolean;
+    /** Composer dictation is listening, or starting to. */
+    readonly dictating: boolean;
+}
+/** Null when a voice conversation can start now; else the first reason it cannot. */
+export declare function voiceStartBlocker(input: VoiceStartGateInput): VoiceStartBlocker | null;
+/**
+ * A reason nothing the person waits out will lift, here and now: voice cannot
+ * work, the mode refuses it, or the conversation takes nothing. The Avatar tab
+ * then still offers Turn on, and says that asking needs a voice conversation.
+ */
+export declare function voiceStartBlockerLasts(blocker: VoiceStartBlocker | null): boolean;

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

@@ -0,0 +1,9 @@
+//#region src/shared/assistant/ui/voice/voiceStartGate.ts
+function e(e) {
+	return e.available ? e.allowedInMode ? e.readOnly ? "read-only" : e.busy ? "busy" : e.committing ? "committing" : e.dictating ? "dictating" : null : "mode" : "unavailable";
+}
+function t(e) {
+	return e === "unavailable" || e === "mode" || e === "read-only";
+}
+//#endregion
+export { e as voiceStartBlocker, t as voiceStartBlockerLasts };