@burdenoff/fe-libs 2026.1014.4 → 2026.1014.5

package/dist/shared/assistant/avatar/useAvatarCopy.d.ts

@@ -48,6 +48,8 @@ export interface AvatarCopy {
     voiceModePaired: string;
     voiceModeMine: string;
     voiceModeHint: string;
+    /** Why hands-free interrupt is off while the avatar is on (the pilot rule), and that it stays off after: the session's notice, and its control's reason. */
+    handsFreeOff: string;
     problem: (problem: AvatarProblem) => string;
 }
 export declare function useAvatarCopy(): AvatarCopy;

package/dist/shared/assistant/avatar/useAvatarCopy.js

@@ -32,6 +32,7 @@ function n() {
 		voiceModePaired: n("avatar.voiceModePaired", "Use this avatar's recommended voice"),
 		voiceModeMine: n("avatar.voiceModeMine", "Keep my current voice"),
 		voiceModeHint: n("avatar.voiceModeHint", "The recommended voice is chosen for this avatar and the language of each reply."),
+		handsFreeOff: n("avatar.handsFreeOff", "Hands-free interrupt is off, so the avatar's voice can't interrupt itself. It stays off after you turn the avatar off; turn it back on in More options. You can still tap to interrupt."),
 		problem: (e) => {
 			switch (e) {
 				case "unavailable": return n("avatar.problemUnavailable", "The avatar isn’t available here.");

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

@@ -227,6 +227,7 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly "avatar.consent": "Turning on Avatar shares the assistant's reply audio with LiveKit and Protoface to animate the avatar. This feature does not send your microphone audio to Protoface.";
     readonly "avatar.consentCancel": "Not now";
     readonly "avatar.consentConfirm": "Turn on the avatar";
+    readonly "avatar.handsFreeOff": "Hands-free interrupt is off, so the avatar's voice can't interrupt itself. It stays off after you turn the avatar off; turn it back on in More options. You can still tap to interrupt.";
     readonly "avatar.problemAlreadyRunning": "An avatar is already running for you.";
     readonly "avatar.problemCapacity": "Avatars are busy right now. Try again in a moment.";
     readonly "avatar.problemConnection": "The connection to the avatar was lost.";

package/dist/shared/assistant/i18nManifest.js

@@ -121,6 +121,7 @@ var m = {
 	"avatar.consent": "Turning on Avatar shares the assistant's reply audio with LiveKit and Protoface to animate the avatar. This feature does not send your microphone audio to Protoface.",
 	"avatar.consentCancel": "Not now",
 	"avatar.consentConfirm": "Turn on the avatar",
+	"avatar.handsFreeOff": "Hands-free interrupt is off, so the avatar's voice can't interrupt itself. It stays off after you turn the avatar off; turn it back on in More options. You can still tap to interrupt.",
 	"avatar.problemAlreadyRunning": "An avatar is already running for you.",
 	"avatar.problemCapacity": "Avatars are busy right now. Try again in a moment.",
 	"avatar.problemConnection": "The connection to the avatar was lost.",

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

@@ -4,14 +4,14 @@ import { useAssistantPageLabel as n } from "../product.js";
 import { useAssistantTr as r } from "../i18n.js";
 import { useAssistantStore as i } from "../store.js";
 import { AssistantSpeechProvider as a } from "./AssistantSpeechProvider.js";
-import { AssistantPreviewProvider as o } from "../preview/context.js";
-import { useAssistantPreviewBridge as s } from "../preview/useAssistantPreviewBridge.js";
-import { AssistantConnectSourceProvider as c } from "./composer/connectSource.js";
-import { hasAssistantPreviewSurface as l } from "../preview/types.js";
-import { ASSISTANT_OVERLAY_ATTR as u, ASSISTANT_PANEL_ATTR as d, activePanelOverlay as f, escapeDismisses as p, nextPanelOverlays as ee } from "./panelOverlays.js";
-import { panelOwnedPreviewBridge as te, useHostedAssistantPreviewBridge as ne } from "../preview/bridgeHostContext.js";
-import { AssistantPreviewOverlay as re } from "../preview/AssistantPreviewOverlay.js";
-import { LiveAvatarSeamProvider as ie, useLiveAvatarSpeechEngine as ae } from "./assistantLiveAvatarSeam.js";
+import { ASSISTANT_OVERLAY_ATTR as o, ASSISTANT_PANEL_ATTR as s, activePanelOverlay as c, escapeDismisses as l, nextPanelOverlays as u } from "./panelOverlays.js";
+import { LiveAvatarSeamProvider as d, useLiveAvatarSpeechEngine as f } from "./assistantLiveAvatarSeam.js";
+import { AssistantPreviewProvider as p } from "../preview/context.js";
+import { useAssistantPreviewBridge as ee } from "../preview/useAssistantPreviewBridge.js";
+import { AssistantConnectSourceProvider as te } from "./composer/connectSource.js";
+import { hasAssistantPreviewSurface as ne } from "../preview/types.js";
+import { panelOwnedPreviewBridge as re, useHostedAssistantPreviewBridge as ie } from "../preview/bridgeHostContext.js";
+import { AssistantPreviewOverlay as ae } from "../preview/AssistantPreviewOverlay.js";
 import { AssistantHeader as m } from "./AssistantHeader.js";
 import { AssistantConversationList as h } from "./AssistantConversationList.js";
 import { AssistantConversationDeleteDialogProvider as g } from "./conversationDeleteDialog.js";
@@ -26,19 +26,19 @@ import { useMemo as w, useRef as T, useState as E } from "react";
 import { jsx as D, jsxs as O } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/AIAssistantPanel.tsx
 var k = ({ onClose: k, visible: A, docked: j, onToggleDock: M, writeAccess: N, onNavigate: oe, isShellLessTarget: P, connectSourceHref: F, onConnectSource: I, preview: L, liveAvatar: R, serverHistory: z = !1 }) => {
-	let B = r(), V = ae(R);
+	let B = r(), V = f(R);
 	y(z);
-	let [H, U] = E(!1), W = l(L);
+	let [H, U] = E(!1), W = ne(L);
 	H && !W && U(!1);
 	let G = H && W;
-	s(te(L, ne()));
+	ee(re(L, ie()));
 	let K = T(null);
 	e(K);
-	let { conversations: q, activeConversationId: se, conversationListOpen: J, setConversationListOpen: Y, createConversation: ce } = i(), X = J || G, Z = f({
+	let { conversations: q, activeConversationId: se, conversationListOpen: J, setConversationListOpen: Y, createConversation: ce } = i(), X = J || G, Z = c({
 		historyOpen: J,
 		previewOpen: G
 	}), Q = (e) => {
-		let t = ee({
+		let t = u({
 			historyOpen: J,
 			previewOpen: G
 		}, e);
@@ -59,7 +59,7 @@ var k = ({ onClose: k, visible: A, docked: j, onToggleDock: M, writeAccess: N, o
 	return S({
 		panelRef: K,
 		onClose: () => {
-			if (p({
+			if (l({
 				historyOpen: J,
 				previewOpen: G
 			}) === "overlay") {
@@ -71,14 +71,14 @@ var k = ({ onClose: k, visible: A, docked: j, onToggleDock: M, writeAccess: N, o
 	}), /* @__PURE__ */ D(a, {
 		visible: A ?? !0,
 		engine: V,
-		children: /* @__PURE__ */ D(ie, {
+		children: /* @__PURE__ */ D(d, {
 			value: R,
-			children: /* @__PURE__ */ D(o, {
+			children: /* @__PURE__ */ D(p, {
 				value: L,
 				children: /* @__PURE__ */ D(v, {
 					navigate: oe,
 					isShellLessTarget: P,
-					children: /* @__PURE__ */ D(c, {
+					children: /* @__PURE__ */ D(te, {
 						value: F,
 						onOpen: I,
 						children: /* @__PURE__ */ D(g, { children: /* @__PURE__ */ D(_, { children: /* @__PURE__ */ O("div", {
@@ -87,8 +87,8 @@ var k = ({ onClose: k, visible: A, docked: j, onToggleDock: M, writeAccess: N, o
 							role: "complementary",
 							"aria-label": B("panel.ariaLabel", "AI Assistant"),
 							"data-testid": "ai-assistant-panel",
-							[d]: "",
-							...Z ? { [u]: Z } : {},
+							[s]: "",
+							...Z ? { [o]: Z } : {},
 							tabIndex: -1,
 							children: [
 								/* @__PURE__ */ D("div", {
@@ -107,7 +107,7 @@ var k = ({ onClose: k, visible: A, docked: j, onToggleDock: M, writeAccess: N, o
 									})
 								}),
 								J && /* @__PURE__ */ D(h, {}),
-								G && /* @__PURE__ */ D(re, { onClose: () => U(!1) }),
+								G && /* @__PURE__ */ D(ae, { onClose: () => U(!1) }),
 								/* @__PURE__ */ D("div", {
 									className: "contents",
 									inert: X || void 0,

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

@@ -63,6 +63,34 @@ export declare function useLiveAvatarStage(): ComponentType<LiveAvatarStageProps
  * is to the store `AssistantSpeechProvider` already subscribes to.
  */
 export declare function useLiveAvatarSpeechEngine(seam: AssistantLiveAvatarSeam | undefined): SpeechEngine | undefined;
+/**
+ * @internal Exported for the assistant's own hands-free wiring (`useVoiceSession`,
+ * `AssistantHandsFreeInterruptToggle`); not part of the module's public surface.
+ *
+ * Whether the live avatar is ON: never without a seam, so false in every app that passes no
+ * `liveAvatar`. Read from the ON switch with or without a stage: what it guards is the avatar's
+ * voice, not its picture.
+ */
+export declare function useLiveAvatarOn(): boolean;
+/**
+ * @internal Exported for `AssistantVoiceSession` alone; not part of the module's public surface.
+ *
+ * ★★ THE PILOT RULE (BOFF-8822), while the avatar's echo reference (P5) is not in: hands-free
+ * interrupt is OFF whenever the avatar is ON. The avatar's voice plays on the speakers, where the
+ * microphone hears it, and hands-free would take it for the person speaking over the reply: a
+ * barge-in that cuts the avatar off.
+ *  - Switched ON with hands-free on: hands-free is switched OFF in the setting the person sees (and
+ *    stored, so it stays off), and this returns true until the avatar is OFF again, for the voice
+ *    session to say why.
+ *  - While it is ON: a write that turns hands-free back on is turned back at once, its menu control
+ *    is `aria-disabled` (it keeps its focus) and says why (`AssistantHandsFreeInterruptToggle`), and the voice session's own
+ *    reading of the setting is OFF whatever it says (`resolveHandsFreeEnabled`).
+ *  - Switched OFF: hands-free stays OFF. Nothing turns it back on behind the person's back, and the
+ *    copy (`avatar.handsFreeOff`) says so and where to turn it back on (More options).
+ *
+ * Without a seam nothing here subscribes to, reads or writes anything.
+ */
+export declare function useLiveAvatarHandsFreeGuard(): boolean;
 /**
  * The voice view to SHOW, given the one the user CHOSE; and the avatar kept to
  * the live conversation (`ended`: over, but still on screen to say why it

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

@@ -1,53 +1,76 @@
-import { getSpeechEngine as e, subscribeSpeechEngine as t } from "../speech/createSpeechEngine.js";
-import { useAvatarCopy as n } from "../avatar/useAvatarCopy.js";
-import { ASSISTANT_VOICE_SESSION_ATTR as r } from "./panelOverlays.js";
-import { createContext as i, useContext as a, useEffect as o, useLayoutEffect as s, useMemo as c, useRef as l, useState as u, useSyncExternalStore as d } from "react";
-import { VideoOff as f } from "lucide-react";
-import { jsx as p, jsxs as m } from "react/jsx-runtime";
+import { useAssistantStore as e } from "../store.js";
+import { getSpeechEngine as t, subscribeSpeechEngine as n } from "../speech/createSpeechEngine.js";
+import { useAvatarCopy as r } from "../avatar/useAvatarCopy.js";
+import { ASSISTANT_VOICE_SESSION_ATTR as i } from "./panelOverlays.js";
+import { createContext as a, useContext as o, useEffect as s, useLayoutEffect as c, useMemo as l, useRef as u, useState as d, useSyncExternalStore as f } from "react";
+import { VideoOff as p } from "lucide-react";
+import { jsx as m, jsxs as h } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/assistantLiveAvatarSeam.tsx
-var h = i(null), g = ({ value: e, children: t }) => /* @__PURE__ */ p(h.Provider, {
+var g = a(null), _ = ({ value: e, children: t }) => /* @__PURE__ */ m(g.Provider, {
 	value: e ?? null,
 	children: t
 });
-function _() {
-	return a(h)?.Stage ?? null;
+function v() {
+	return o(g)?.Stage ?? null;
 }
-function v(n) {
-	let r = d(t, e, e), i = n?.decorateSpeechEngine;
-	return c(() => i ? i(r) : void 0, [i, r]);
+function y(e) {
+	let r = f(n, t, t), i = e?.decorateSpeechEngine;
+	return l(() => i ? i(r) : void 0, [i, r]);
 }
-var y = {
+var b = {
 	subscribe: () => () => {},
 	getSnapshot: () => !1,
 	switchOff: () => {},
 	voiceLive: () => {}
 };
-function b(e) {
+function x(e) {
 	return e?.Stage ? e.enabled : void 0;
 }
-function x(e) {
-	let t = e ?? y;
-	return d(t.subscribe, t.getSnapshot, t.getSnapshot);
+function S(e) {
+	let t = e ?? b;
+	return f(t.subscribe, t.getSnapshot, t.getSnapshot);
+}
+function C() {
+	return S(o(g)?.enabled);
 }
-function S(e, t) {
-	let n = a(h);
-	C(n?.enabled, t);
-	let r = b(n), i = x(r), [o, s] = u(() => ({
+function w() {
+	let t = o(g)?.enabled, [n, r] = d(null);
+	return s(() => {
+		if (!t) return;
+		let n = () => {
+			if (!t.getSnapshot()) {
+				r(null);
+				return;
+			}
+			let n = e.getState();
+			n.handsFreeInterrupt && (n.setHandsFreeInterrupt(!1), r(() => t));
+		};
+		n();
+		let i = t.subscribe(n), a = e.subscribe(n);
+		return () => {
+			i(), a();
+		};
+	}, [t]), n !== null && n === t;
+}
+function T(e, t) {
+	let n = o(g);
+	E(n?.enabled, t);
+	let r = x(n), i = S(r), [a, s] = d(() => ({
 		on: i,
 		chosen: e,
 		open: i && e === "mini"
 	}));
 	if (!r) return e;
-	let c = o.open;
-	return (o.on !== i || o.chosen !== e) && (c = o.on !== i && i && e === "mini", s({
+	let c = a.open;
+	return (a.on !== i || a.chosen !== e) && (c = a.on !== i && i && e === "mini", s({
 		on: i,
 		chosen: e,
 		open: c
 	})), c && !t ? "panel" : e;
 }
-function C(e, t) {
-	let n = l(0);
-	o(() => {
+function E(e, t) {
+	let n = u(0);
+	s(() => {
 		if (!e) return;
 		let r = ++n.current, i = (e) => queueMicrotask(() => {
 			n.current === r && e();
@@ -63,38 +86,38 @@ function C(e, t) {
 		});
 	}, [e, t]);
 }
-function w() {
-	return x(b(a(h)));
+function D() {
+	return S(x(o(g)));
 }
-var T = () => {
-	let e = b(a(h)), t = x(e);
-	return e && t ? /* @__PURE__ */ p(O, {
+var O = () => {
+	let e = x(o(g)), t = S(e);
+	return e && t ? /* @__PURE__ */ m(j, {
 		onStop: e.switchOff,
 		isOn: e.getSnapshot
 	}) : null;
-}, E = "[data-testid=\"assistant-voice-orb\"]", D = "[data-testid=\"assistant-voice-end\"]", O = ({ onStop: e, isOn: t }) => {
-	let i = n(), a = l(null), o = l(t);
-	return s(() => {
+}, k = "[data-testid=\"assistant-voice-orb\"]", A = "[data-testid=\"assistant-voice-end\"]", j = ({ onStop: e, isOn: t }) => {
+	let n = r(), a = u(null), o = u(t);
+	return c(() => {
 		let e = a.current, t = o.current;
 		return () => {
 			if (!e?.contains(e.ownerDocument.activeElement)) return;
-			let n = e.closest(`[${r}]`), i = t() ? null : n?.querySelector(E);
-			(i && !i.hasAttribute("disabled") ? i : n?.querySelector(D))?.focus();
+			let n = e.closest(`[${i}]`), r = t() ? null : n?.querySelector(k);
+			(r && !r.hasAttribute("disabled") ? r : n?.querySelector(A))?.focus();
 		};
-	}, []), /* @__PURE__ */ m("div", {
+	}, []), /* @__PURE__ */ h("div", {
 		ref: a,
 		className: "absolute bottom-1.5 left-7 flex h-8 max-w-[calc(100%-13.875rem)] items-center gap-1 rounded-full border border-border-default bg-bg-elevated ps-2.5 pe-0.5 text-xs font-medium text-text-secondary rtl:left-auto rtl:right-7",
 		"data-testid": "assistant-voice-avatar",
-		children: [/* @__PURE__ */ p("span", {
+		children: [/* @__PURE__ */ m("span", {
 			className: "truncate",
-			children: i.stateOn
-		}), /* @__PURE__ */ p("button", {
+			children: n.stateOn
+		}), /* @__PURE__ */ m("button", {
 			type: "button",
 			onClick: () => e(),
 			className: "relative flex size-7 shrink-0 items-center justify-center rounded-full transition-colors after:absolute after:-inset-2 after:-ms-1.5 after:me-1.5 hover:bg-bg-raised hover:text-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong",
-			"aria-label": i.stop,
+			"aria-label": n.stop,
 			"data-testid": "assistant-voice-avatar-stop",
-			children: /* @__PURE__ */ p(f, {
+			children: /* @__PURE__ */ m(p, {
 				className: "size-4",
 				"aria-hidden": "true"
 			})
@@ -102,4 +125,4 @@ var T = () => {
 	});
 };
 //#endregion
-export { T as LiveAvatarMiniIndicator, g as LiveAvatarSeamProvider, w as useLiveAvatarMiniIndicatorShown, v as useLiveAvatarSpeechEngine, _ as useLiveAvatarStage, S as useLiveAvatarVoiceView };
+export { O as LiveAvatarMiniIndicator, _ as LiveAvatarSeamProvider, w as useLiveAvatarHandsFreeGuard, D as useLiveAvatarMiniIndicatorShown, C as useLiveAvatarOn, y as useLiveAvatarSpeechEngine, v as useLiveAvatarStage, T as useLiveAvatarVoiceView };

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

@@ -12,5 +12,14 @@ import { FC } from 'react';
  * name (WCAG 2.5.3) and it is reachable by keyboard and speech control. Renders
  * nothing where this browser can neither capture nor recognise speech: a
  * setting that cannot do anything is not offered.
+ *
+ * ★ BOFF-8822, the avatar pilot: while a live avatar is ON this is OFF and
+ * cannot be switched on (`useLiveAvatarHandsFreeGuard`), and it stays OFF after
+ * the avatar is turned off until the person turns it back on here. The checkbox
+ * is `aria-disabled` and described by the reason, which is shown under it.
+ * Never `disabled`: the More menu has no roving focus, so a disabled checkbox
+ * drops out of the Tab order and keyboard and screen-reader users would skip
+ * the control and the reason with it (the avatar toggle keeps its focus the
+ * same way). Without an avatar it is exactly what it was.
  */
 export declare const AssistantHandsFreeInterruptToggle: FC;

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

@@ -2,33 +2,47 @@ import { isSpeechRecognitionSupported as e } from "../../voice/useVoiceInput.js"
 import { useAssistantTr as t } from "../../i18n.js";
 import { useAssistantStore as n } from "../../store.js";
 import { isMicCaptureSupported as r } from "../../voice/handsfree/micCapture.js";
-import { Mic as i } from "lucide-react";
-import { jsx as a, jsxs as o } from "react/jsx-runtime";
+import { useAvatarCopy as i } from "../../avatar/useAvatarCopy.js";
+import { useLiveAvatarOn as a } from "../assistantLiveAvatarSeam.js";
+import { useId as o } from "react";
+import { Mic as s } from "lucide-react";
+import { Fragment as c, jsx as l, jsxs as u } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/composer/AssistantHandsFreeInterruptToggle.tsx
-var s = () => {
-	let s = t(), c = n((e) => e.handsFreeInterrupt), l = n((e) => e.setHandsFreeInterrupt);
-	return !e() && !r() ? null : /* @__PURE__ */ o("label", {
+var d = () => {
+	let d = t(), f = i(), p = a(), m = o(), h = n((e) => e.handsFreeInterrupt), g = n((e) => e.setHandsFreeInterrupt);
+	if (!e() && !r()) return null;
+	let _ = /* @__PURE__ */ u("label", {
 		className: "flex items-center gap-2.5 px-3 py-2 text-xs text-text-primary focus-within:ring-2 focus-within:ring-inset focus-within:ring-border-strong",
-		title: s("voice.handsFreeHint", "Let the assistant listen while it answers, so you can speak over it to correct it. Works best with headphones. You can always tap to interrupt."),
+		title: d("voice.handsFreeHint", "Let the assistant listen while it answers, so you can speak over it to correct it. Works best with headphones. You can always tap to interrupt."),
 		"data-testid": "assistant-hands-free-interrupt",
 		children: [
-			/* @__PURE__ */ a(i, {
+			/* @__PURE__ */ l(s, {
 				className: "size-3.5 flex-shrink-0 text-text-secondary",
 				"aria-hidden": "true"
 			}),
-			/* @__PURE__ */ a("span", {
+			/* @__PURE__ */ l("span", {
 				className: "flex-1",
-				children: s("voice.handsFreeLabel", "Hands-free interrupt (beta)")
+				children: d("voice.handsFreeLabel", "Hands-free interrupt (beta)")
 			}),
-			/* @__PURE__ */ a("input", {
+			/* @__PURE__ */ l("input", {
 				type: "checkbox",
-				checked: c,
-				onChange: (e) => l(e.target.checked),
-				className: "size-4 accent-current",
+				checked: h,
+				onChange: (e) => {
+					p || g(e.target.checked);
+				},
+				"aria-disabled": p ? "true" : void 0,
+				"aria-describedby": p ? m : void 0,
+				className: p ? "size-4 accent-current aria-disabled:cursor-default aria-disabled:opacity-60" : "size-4 accent-current",
 				"data-testid": "assistant-hands-free-interrupt-checkbox"
 			})
 		]
 	});
+	return p ? /* @__PURE__ */ u(c, { children: [_, /* @__PURE__ */ l("p", {
+		id: m,
+		className: "px-3 pb-2 text-[11px] text-text-muted",
+		"data-testid": "assistant-hands-free-interrupt-avatar",
+		children: f.handsFreeOff
+	})] }) : _;
 };
 //#endregion
-export { s as AssistantHandsFreeInterruptToggle };
+export { d as AssistantHandsFreeInterruptToggle };