@burdenoff/fe-libs 2026.1014.4 → 2026.1015.1

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

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

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

@@ -1,9 +1,9 @@
 import { showsAssistantCaption as e, waveformIsActive as t, waveformIsSettled as n } from "../../voice/voiceStageState.js";
 import { showPreviousChunk as r } from "../../voice/miniCaptionBudget.js";
 import { isAwaitingFirstChunk as i } from "../../voice/speechPlayback.js";
-import { VoiceWaveform as a } from "./VoiceWaveform.js";
-import { VoiceStatusText as o } from "./VoiceStatusText.js";
-import { LiveAvatarMiniIndicator as s, useLiveAvatarMiniIndicatorShown as c } from "../assistantLiveAvatarSeam.js";
+import { LiveAvatarMiniIndicator as a, useLiveAvatarMiniIndicatorShown as o } from "../assistantLiveAvatarSeam.js";
+import { VoiceWaveform as s } from "./VoiceWaveform.js";
+import { VoiceStatusText as c } from "./VoiceStatusText.js";
 import { Fragment as l, jsx as u, jsxs as d } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/voice/VoiceMiniController.tsx
 var f = " self-stretch justify-end pb-8.5 [container-type:size] [@container_(min-height:4.0312rem)_and_(max-height:5.2343rem)]:[&>p[role=status]]:line-clamp-2 [@container_(max-height:4.0312rem)]:[&>p[role=status]]:line-clamp-1 [@container_(max-height:4.0312rem)]:[&>p[role=status]]:min-h-5 [@container_(max-height:5.2343rem)]:[&>p[role=status]>span:not(:last-child)]:sr-only", p = ({ state: p, caption: m, spokenChunks: h = null, statusText: g, statusSuffix: _, rotateStatus: v, control: y, errorText: b = null }) => {
@@ -14,14 +14,14 @@ var f = " self-stretch justify-end pb-8.5 [container-type:size] [@container_(min
 		"data-state": p,
 		children: [
 			/* @__PURE__ */ d("div", {
-				className: `flex min-w-0 flex-1 flex-col gap-1.5${c() ? f : ""}`,
+				className: `flex min-w-0 flex-1 flex-col gap-1.5${o() ? f : ""}`,
 				children: [/* @__PURE__ */ d("div", {
 					className: "flex items-center gap-2",
-					children: [/* @__PURE__ */ u(a, {
+					children: [/* @__PURE__ */ u(s, {
 						active: t(p),
 						settled: n(p),
 						tone: p === "speaking" ? "speaking" : "listening"
-					}), /* @__PURE__ */ u(o, {
+					}), /* @__PURE__ */ u(c, {
 						className: "truncate text-xs text-text-muted",
 						status: g,
 						suffix: _,
@@ -58,7 +58,7 @@ var f = " self-stretch justify-end pb-8.5 [container-type:size] [@container_(min
 				className: "shrink-0",
 				children: y
 			}),
-			/* @__PURE__ */ u(s, {})
+			/* @__PURE__ */ u(a, {})
 		]
 	});
 };

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

@@ -1,13 +1,13 @@
 import { showsAssistantCaption as e, showsUserCaption as t, waveformIsActive as n, waveformIsSettled as r } from "../../voice/voiceStageState.js";
 import { isAwaitingFirstChunk as i } from "../../voice/speechPlayback.js";
-import { VoiceCaption as a } from "./VoiceCaption.js";
-import { VoiceWaveform as o } from "./VoiceWaveform.js";
-import { VoiceStatusText as s } from "./VoiceStatusText.js";
-import { useLiveAvatarStage as c } from "../assistantLiveAvatarSeam.js";
+import { useLiveAvatarStage as a } from "../assistantLiveAvatarSeam.js";
+import { VoiceCaption as o } from "./VoiceCaption.js";
+import { VoiceWaveform as s } from "./VoiceWaveform.js";
+import { VoiceStatusText as c } from "./VoiceStatusText.js";
 import { Fragment as l, jsx as u, jsxs as d } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/voice/VoiceStage.tsx
 var f = ({ state: f, userCaption: p, assistantCaption: m, expanded: h, statusText: g, statusSuffix: _, rotateStatus: v, control: y, errorText: b = null, spokenChunks: x = null }) => {
-	let S = c(), C = e(f) && i(x), w = e(f) ? m : t(f) ? p : null, T = /* @__PURE__ */ u(o, {
+	let S = a(), C = e(f) && i(x), w = e(f) ? m : t(f) ? p : null, T = /* @__PURE__ */ u(s, {
 		active: n(f),
 		settled: r(f),
 		tone: f === "speaking" ? "speaking" : "listening",
@@ -22,7 +22,7 @@ var f = ({ state: f, userCaption: p, assistantCaption: m, expanded: h, statusTex
 		"data-testid": "assistant-voice-stage",
 		"data-state": f,
 		children: [
-			/* @__PURE__ */ u(s, {
+			/* @__PURE__ */ u(c, {
 				className: [
 					"text-center text-text-muted",
 					h ? "text-base" : "text-sm",
@@ -46,7 +46,7 @@ var f = ({ state: f, userCaption: p, assistantCaption: m, expanded: h, statusTex
 			}), w ? /* @__PURE__ */ u("div", {
 				className: [h ? "mb-12 max-h-[46vh] w-full overflow-y-auto" : "mb-6 max-h-[38vh] w-full overflow-y-auto", C ? h ? "min-h-[4.875rem]" : "min-h-12" : ""].join(" "),
 				"data-caption-scroll": "",
-				children: /* @__PURE__ */ u(a, {
+				children: /* @__PURE__ */ u(o, {
 					text: w,
 					role: e(f) ? "assistant" : "user",
 					spokenChunks: x,

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 };