@burdenoff/fe-libs 2026.1016.1 → 2026.1016.3

package/dist/shared/assistant/avatar/live/createLiveAvatarSeam.js

@@ -1,18 +1,21 @@
 import { ensureWorkspaceToken as e, getStoredAuthToken as t, getStoredWorkspaceId as n, resolveGatewayUrl as r } from "../../../graphql/fetch.js";
-import { readSpeechEngineConfig as i } from "../../speech/createSpeechEngine.js";
-import { useAvatarPreferencesStore as a } from "../avatarPreferences.js";
-import { realAvatarScheduler as o } from "./avatarPorts.js";
-import { startAvatarAudioMeter as s } from "./avatarAudioMeter.js";
-import { decodeMp3ToPcm16k as c } from "./avatarAudioDecode.js";
-import { avatarApiBaseFromTtsEndpoint as l, avatarIdempotencyKey as u, createAvatarSessionClient as d } from "./avatarSessionClient.js";
-import { createLiveAvatarController as f } from "./liveAvatarController.js";
-import { openLiveKitAvatarRoom as p } from "./liveKitAvatarRoom.js";
-import { LiveAvatarStageView as m } from "./LiveAvatarStage.js";
-import { avatarSpeakerFor as h, hostedAvatarVoice as g, liveAvatarVoicesFrom as _, restoreVoiceWhenOutputLeaves as v } from "./avatarVoice.js";
-import { LiveAvatarTabView as y } from "./LiveAvatarTabView.js";
-import { jsx as b } from "react/jsx-runtime";
+import { isOutputRefusal as i } from "../../speech/pieceSink.js";
+import { readSpeechEngineConfig as a } from "../../speech/createSpeechEngine.js";
+import { useAvatarPreferencesStore as o } from "../avatarPreferences.js";
+import { realAvatarScheduler as s } from "./avatarPorts.js";
+import { startAvatarAudioMeter as c } from "./avatarAudioMeter.js";
+import { decodeMp3ToPcm16k as l } from "./avatarAudioDecode.js";
+import { avatarApiBaseFromTtsEndpoint as u, avatarIdempotencyKey as d, createAvatarSessionClient as f } from "./avatarSessionClient.js";
+import { createLiveAvatarController as p } from "./liveAvatarController.js";
+import { openLiveKitAvatarRoom as m } from "./liveKitAvatarRoom.js";
+import { liveAvatarAskState as h } from "./liveAvatarStatus.js";
+import { LiveAvatarStageView as g } from "./LiveAvatarStage.js";
+import { sanitizeAvatarImages as _ } from "./avatarFaces.js";
+import { avatarSpeakerFor as v, hostedAvatarVoice as y, liveAvatarVoicesFrom as b, restoreVoiceWhenOutputLeaves as x } from "./avatarVoice.js";
+import { LiveAvatarTabView as S } from "./LiveAvatarTabView.js";
+import { jsx as C } from "react/jsx-runtime";
 //#region src/shared/assistant/avatar/live/createLiveAvatarSeam.tsx
-function x(e = globalThis) {
+function w(e = globalThis) {
 	let t = e;
 	if (typeof t.RTCPeerConnection != "function" || typeof t.OfflineAudioContext != "function" || typeof t.AudioContext != "function" || typeof t.MediaStream != "function") return !1;
 	let n = t.navigator, r = n?.userAgentData;
@@ -23,14 +26,14 @@ function x(e = globalThis) {
 	let i = n?.userAgent ?? "";
 	return /\b(?:Chrome|Chromium)\//.test(i) && !/\b(?:Edg|OPR|SamsungBrowser)\/|Mobile|Android|iPhone|iPad/.test(i);
 }
-function S() {
-	let e = i().getHeaders?.() ?? {};
+function T() {
+	let e = a().getHeaders?.() ?? {};
 	for (let [t, n] of Object.entries(e)) if (t.toLowerCase() === "authorization" && typeof n == "string" && n.trim() !== "") return n.trim();
 	let n = t();
 	return n ? `Bearer ${n}` : null;
 }
-async function C(t) {
-	let i = n(), a = S(), o = a?.replace(/^Bearer\s+/i, "") ?? null;
+async function E(t) {
+	let i = n(), a = T(), o = a?.replace(/^Bearer\s+/i, "") ?? null;
 	if (!i || !o) return null;
 	let s = t.refused?.replace(/^Bearer\s+/i, ""), c = await e({
 		url: r("workspace"),
@@ -39,60 +42,77 @@ async function C(t) {
 		currentQuery: "liveAvatarSession",
 		...t.fresh ? { issuanceGuard: {
 			identityKey: "liveAvatarSession",
-			isCurrent: () => n() === i && S() === a,
+			isCurrent: () => n() === i && T() === a,
 			accepts: (e, t) => e !== s && t === i
 		} } : {}
 	});
 	return c ? `Bearer ${c}` : null;
 }
-function w() {
+function D() {
 	let e = null;
 	return () => {
-		let t = typeof location > "u" ? void 0 : location.href, n = l(i().endpoint, t);
+		let t = typeof location > "u" ? void 0 : location.href, n = u(a().endpoint, t);
 		return n === null ? null : (e?.base !== n && (e = {
 			base: n,
-			client: d({
+			client: f({
 				baseUrl: n,
-				getAuthorization: S,
-				getWorkspaceAuthorization: C
+				getAuthorization: T,
+				getWorkspaceAuthorization: E
 			})
 		}), e.client);
 	};
 }
-var T = {
-	getState: () => a.getState(),
-	setAvatarEnabled: (e) => a.getState().setAvatarEnabled(e),
-	setAvatarId: (e) => a.getState().setAvatarId(e),
-	subscribe: (e) => a.subscribe(() => e())
-}, E = {
-	getState: () => a.getState(),
-	subscribe: (e) => a.subscribe(() => e()),
-	setVoiceMode: (e) => a.getState().setVoiceMode(e),
-	setAvatarSpeaker: (e) => a.getState().setAvatarSpeaker(e)
+var O = {
+	getState: () => o.getState(),
+	setAvatarEnabled: (e) => o.getState().setAvatarEnabled(e),
+	setAvatarId: (e) => o.getState().setAvatarId(e),
+	subscribe: (e) => o.subscribe(() => e())
+}, k = {
+	getState: () => o.getState(),
+	subscribe: (e) => o.subscribe(() => e()),
+	setVoiceMode: (e) => o.getState().setVoiceMode(e),
+	setAvatarSpeaker: (e) => o.getState().setAvatarSpeaker(e)
 };
-function D() {
+function A(e, t) {
+	let n = (e) => {
+		i(e) || t();
+	};
+	return {
+		write: (t, r, i) => {
+			let a = e.write(t, r, i);
+			return a.then(void 0, n), a;
+		},
+		drain: () => {
+			let t = e.drain();
+			return t.then(void 0, n), t;
+		},
+		retract: (t) => e.retract(t),
+		cancel: () => e.cancel()
+	};
+}
+function j() {
 	if (typeof document > "u") return null;
 	let e = document.createElement("audio");
 	return e.autoplay = !0, e.hidden = !0, e.setAttribute("data-testid", "assistant-live-avatar-audio"), document.body.appendChild(e), e;
 }
-function O(e) {
+function M(e) {
 	if (!(typeof window > "u")) return (t) => (window.addEventListener(e, t), () => window.removeEventListener(e, t));
 }
-function k(e = {}) {
-	let t = e.preferences ?? T, n = e.controller ?? {}, r = n.subscribeWorkspaceChange ?? O("burdenoff:workspace-changed"), i = n.subscribePageHide ?? O("pagehide"), a = f({
-		client: e.client ?? w(),
-		openRoom: e.openRoom ?? p,
-		scheduler: e.scheduler ?? o,
+function N(e = {}) {
+	let t = e.preferences ?? O, n = e.controller ?? {}, r = n.subscribeWorkspaceChange ?? M("burdenoff:workspace-changed"), i = n.subscribePageHide ?? M("pagehide"), a = p({
+		client: e.client ?? D(),
+		openRoom: e.openRoom ?? m,
+		scheduler: e.scheduler ?? s,
 		preferences: t,
-		decode: n.decode ?? ((e, t) => c(e, { signal: t })),
-		createAudioElement: n.createAudioElement ?? D,
+		decode: n.decode ?? ((e, t) => l(e, { signal: t })),
+		createAudioElement: n.createAudioElement ?? j,
 		releaseAudioElement: n.releaseAudioElement ?? ((e) => {
 			e.srcObject = null, e.remove();
 		}),
-		startMeter: n.startMeter ?? ((e, t) => typeof MediaStream > "u" ? null : s(new MediaStream([e]), t)),
-		browserSupported: e.browserSupported ?? (() => x()),
+		startMeter: n.startMeter ?? ((e, t) => typeof MediaStream > "u" ? null : c(new MediaStream([e]), t)),
+		browserSupported: e.browserSupported ?? (() => w()),
 		now: n.now ?? (() => Date.now()),
-		newIdempotencyKey: n.newIdempotencyKey ?? (() => u()),
+		newIdempotencyKey: n.newIdempotencyKey ?? (() => d()),
 		...r ? { subscribeWorkspaceChange: r } : {},
 		...i ? { subscribePageHide: i } : {},
 		...n.idleMs === void 0 ? {} : { idleMs: n.idleMs },
@@ -103,47 +123,89 @@ function k(e = {}) {
 		...n.stallMs === void 0 ? {} : { stallMs: n.stallMs },
 		...n.readinessProbe === void 0 ? {} : { readinessProbe: n.readinessProbe },
 		...e.onLog ? { onLog: e.onLog } : {}
-	}), l = _(e.avatarVoices), d = e.avatarVoiceStore ?? E, S = () => d.getState(), C = (n, r) => {
-		let i = h(S(), {
-			avatarVoices: l,
+	}), o = b(e.avatarVoices), u = e.avatarImages === void 0 ? null : _(e.avatarImages), f = e.avatarVoiceStore ?? k, T = () => f.getState(), E = (n, r) => {
+		let i = v(T(), {
+			avatarVoices: o,
 			avatarId: t.getState().avatarId,
 			...e.defaultAvatarVoiceMode ? { hostDefault: e.defaultAvatarVoiceMode } : {}
 		});
-		return i === null ? null : g(i, n, r.listVoices());
-	}, k = (e, t) => {
+		return i === null ? null : y(i, n, r.listVoices());
+	}, N = (e, t) => {
 		let n = {
 			...e,
 			voice: t
 		};
-		return n.audioOutput = v(a.createOutput(), () => {
+		return n.audioOutput = x(a.createOutput(), () => {
 			n.voice = e.voice;
 		}, (e) => a.subscribe(() => {
 			a.getSnapshot().phase !== "ready" && e();
 		})), n;
 	};
 	return {
-		decorateSpeechEngine: (e) => ({
-			id: e.id,
-			isSupported: () => e.isSupported(),
-			listVoices: () => e.listVoices(),
-			subscribeVoices: (t) => e.subscribeVoices(t),
-			speak: (t, n, r) => {
-				let i = C(n.lang, e), o = i === null ? n : {
-					...n,
-					voice: i
+		decorateSpeechEngine: (e) => {
+			let t = (t) => {
+				let n = E(t.lang, e), r = n === null ? t : {
+					...t,
+					voice: n
 				};
-				if (a.route(o, e) !== "avatar") {
-					e.speak(t, n, r);
-					return;
+				return {
+					voice: n,
+					target: a.route(r, e)
+				};
+			}, n = null, r = () => {
+				let e = n;
+				n = null, e?.();
+			}, i = (t, r, i) => {
+				let o = !0, s = !1, c = () => void 0, l = () => {
+					o && (o = !1, n === l && (n = null), c());
+				}, u = () => s ? !1 : (s = !0, l(), !0), d = () => {
+					!o || !u() || (e.cancel(), i?.onError?.("output-left"));
+				};
+				c = a.subscribe(() => {
+					a.getSnapshot().phase !== "ready" && d();
+				}), n = l, r.audioOutput &&= A(r.audioOutput, d), r.fallback = !1, e.speak(t, r, {
+					...i,
+					onEnd: () => {
+						u() && i?.onEnd?.();
+					},
+					onError: (e) => {
+						u() && i?.onError?.(e);
+					}
+				});
+			};
+			return {
+				id: e.id,
+				isSupported: () => e.isSupported(),
+				listVoices: () => e.listVoices(),
+				subscribeVoices: (t) => e.subscribeVoices(t),
+				wouldSpeakOnAvatar: (e) => t(e).target === "avatar",
+				speak: (n, o, s) => {
+					r();
+					let { voice: c, target: l } = t(o);
+					if (l !== "avatar") {
+						if (o.avatarOnly === !0) {
+							e.cancel(), s?.onError?.("output-left");
+							return;
+						}
+						e.speak(n, o, s);
+						return;
+					}
+					let u = c === null ? {
+						...o,
+						audioOutput: a.createOutput()
+					} : N(o, c);
+					if (o.avatarOnly === !0) {
+						i(n, u, s);
+						return;
+					}
+					e.speak(n, u, s);
+				},
+				cancel: () => {
+					r(), e.cancel();
 				}
-				e.speak(t, i === null ? {
-					...n,
-					audioOutput: a.createOutput()
-				} : k(n, i), r);
-			},
-			cancel: () => e.cancel()
-		}),
-		Stage: ({ expanded: t, fallback: n }) => /* @__PURE__ */ b(m, {
+			};
+		},
+		Stage: ({ expanded: t, fallback: n }) => /* @__PURE__ */ C(g, {
 			controller: a,
 			expanded: t,
 			fallback: n,
@@ -160,14 +222,19 @@ function k(e = {}) {
 				subscribe: (e) => a.subscribe(e),
 				getSnapshot: () => a.getSnapshot().tabOffered
 			},
+			ask: {
+				subscribe: (e) => a.subscribe(e),
+				getSnapshot: () => h(a.getSnapshot())
+			},
 			setOpen: (e) => a.setTabOpen(e),
 			heldByVoice: () => a.getSnapshot().heldByVoice,
-			View: (t) => /* @__PURE__ */ b(y, {
+			View: (t) => /* @__PURE__ */ C(S, {
 				...t,
 				controller: a,
-				avatarVoices: l,
-				voiceStore: d,
+				avatarVoices: o,
+				voiceStore: f,
 				...e.avatarNames ? { avatarNames: e.avatarNames } : {},
+				...u ? { avatarImages: u } : {},
 				...e.defaultAvatarVoiceMode ? { defaultAvatarVoiceMode: e.defaultAvatarVoiceMode } : {}
 			})
 		},
@@ -176,4 +243,4 @@ function k(e = {}) {
 	};
 }
 //#endregion
-export { k as createLiveAvatarSeam, x as isLiveAvatarBrowserSupported, S as liveAvatarAuthorization, C as liveAvatarWorkspaceAuthorization };
+export { N as createLiveAvatarSeam, w as isLiveAvatarBrowserSupported, T as liveAvatarAuthorization, E as liveAvatarWorkspaceAuthorization };

package/dist/shared/assistant/avatar/live/liveAvatarController.d.ts

@@ -52,6 +52,11 @@ export interface LiveAvatarSnapshot {
     /** The avatar was turned on outside the tab during the voice conversation that is still live: closing the tab hands it back to Voice. */
     readonly heldByVoice: boolean;
     readonly phase: LiveAvatarPhase;
+    /**
+     * ★ BOFF-9360 (critic m1): the session's time limit is near (10 s before the server's end). The phase is still `ready` and a reply
+     * in flight finishes on the avatar, but no new reply goes to it, and the session ends between replies. False in every other phase.
+     */
+    readonly closing: boolean;
     /** The avatars the server offers, from the last availability answer. */
     readonly avatars: readonly string[];
     /** The avatar the next session starts with. */

package/dist/shared/assistant/avatar/live/liveAvatarController.js

@@ -11,6 +11,7 @@ var s = 12e4, c = 1e4, l = 8e3, ee = 5e3, u = 2e4, d = 1e3, f = {
 	retryAt: null,
 	heldByVoice: !1,
 	phase: "off",
+	closing: !1,
 	avatars: [],
 	selectedAvatarId: null,
 	consentVersion: null,
@@ -189,6 +190,7 @@ function g(s) {
 			keepalive: t.keepalive === !0
 		}).catch(() => void 0)), V({
 			phase: "off",
+			closing: !1,
 			audioBlocked: !1,
 			videoReady: !1,
 			...t.problem === void 0 ? v.problem !== null && m.has(v.problem) ? { problem: null } : {} : { problem: t.problem },
@@ -364,7 +366,7 @@ function g(s) {
 		}), G();
 		let _ = S > 0 ? u + S - ee - c.now() : f.endsAt - s.now(), v = Math.max(0, _ - d);
 		F = c.setTimeout(() => {
-			F = null, T === a && (w = !0, W.isBusy() || K("user", { notice: "time-limit" }));
+			F = null, T === a && (w = !0, V({ closing: !0 }), W.isBusy() || K("user", { notice: "time-limit" }));
 		}, v);
 	}
 	function Y(t) {

package/dist/shared/assistant/avatar/live/liveAvatarStatus.d.ts

@@ -1,4 +1,18 @@
+import { LiveAvatarAskState } from '../../ui/assistantLiveAvatarSeam';
 import { AvatarCopy } from '../useAvatarCopy';
 import { LiveAvatarSnapshot } from './liveAvatarController';
+/**
+ * ★ BOFF-9360: whether the avatar can take a typed question's answer now, as the Avatar tab's ask box reads it
+ * (`LiveAvatarTabSeam.ask`). Pure, from the snapshot alone: it never asks `route()`, which has side effects.
+ *  - `ready`: on, and nothing in the way;
+ *  - `sound-blocked`: on, but the browser blocks its sound until a tap on the frame lifts it (critic m1);
+ *  - `ending`: stopping, or near its time limit (`closing`), so no new reply goes to it (critic m1);
+ *  - `starting`: being started or joined;
+ *  - `locked`: off after a "not now" refusal that said when (`retryAt`): Turn on waits for that time (critic m11);
+ *  - `off`: off, or being set up (checking, choosing).
+ * A device voice (no hosted voice to animate) is not predicted here: the route says so per reply, and the tab's
+ * status line already explains it (`needs-hosted-voice`).
+ */
+export declare function liveAvatarAskState(snapshot: LiveAvatarSnapshot): LiveAvatarAskState;
 /** The words for the avatar's state line: what went wrong, what it is doing, or null. `now`: wall-clock ms, for the retry time. */
 export declare function liveAvatarStatusText(snapshot: LiveAvatarSnapshot, copy: AvatarCopy, now?: number): string | null;

package/dist/shared/assistant/avatar/live/liveAvatarStatus.js

@@ -1,5 +1,14 @@
 //#region src/shared/assistant/avatar/live/liveAvatarStatus.ts
-function e(e, t, n = Date.now()) {
+function e(e) {
+	switch (e.phase) {
+		case "ready": return e.closing ? "ending" : e.audioBlocked ? "sound-blocked" : "ready";
+		case "starting":
+		case "connecting": return "starting";
+		case "ending": return "ending";
+		default: return e.retryAt === null ? "off" : "locked";
+	}
+}
+function t(e, t, n = Date.now()) {
 	if (e.problem === "playback-blocked" && e.audioBlocked) return null;
 	let r = e.voiceLive;
 	if (e.problem !== null) {
@@ -18,4 +27,4 @@ function e(e, t, n = Date.now()) {
 	}
 }
 //#endregion
-export { e as liveAvatarStatusText };
+export { e as liveAvatarAskState, t as liveAvatarStatusText };

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

@@ -1,3 +1,4 @@
+import { AvatarAskBlocker } from '../ui/avatar/avatarAskGate';
 import { VoiceStartBlocker } from '../ui/voice/voiceStartGate';
 /** What the person can be told went wrong; the adapter maps server codes onto these. */
 export type AvatarProblem = 'unavailable' | 'not-ready' | 'already-running' | 'capacity' | 'rate-limited' | 'paused'
@@ -62,6 +63,47 @@ export interface AvatarCopy {
     voiceStartBlocked: (blocker: VoiceStartBlocker) => string;
     /** Said with a lasting reason: the avatar can be turned on, but it is asked by voice only. */
     askNeedsVoice: string;
+    /**
+     * ★ BOFF-9360: the Avatar tab's typed questions. Said while the avatar is off with voice blocked for a reason that
+     * lasts, and typing open: the line `askNeedsVoice` was before typing existed (critic M3).
+     */
+    askByTyping: string;
+    /** Said while the avatar is off, when neither typing nor voice can ask here (critic M3): turning it on is of no use. */
+    askNothing: string;
+    /** The ask box's textarea: its label, placeholder and keyboard hint. */
+    askLabel: string;
+    askPlaceholder: string;
+    askHint: string;
+    /** Send, as the composer names it (`chatInput.send`). */
+    askSend: string;
+    /** Why Send is off, in the gate's order (`avatarAskBlocker`); null for a live voice conversation (the box is hidden). */
+    askBlocked: (blocker: AvatarAskBlocker) => string | null;
+    /** A file dropped or pasted on the box is not taken. */
+    askNoFiles: string;
+    /** Before the first question of this opening. */
+    askEmpty: string;
+    /** The last exchange: its section's name and its two visible labels. */
+    askExchangeLabel: string;
+    askYouAsked: string;
+    askAnswer: string;
+    /** Which conversation the question went into (critic m9). */
+    askAskedIn: (title: string) => string;
+    askShowAll: string;
+    askShowLess: string;
+    /** While the answer is on its way: the voice session's own "Thinking…". */
+    askThinking: string;
+    /** What became of the answer's audio: never a claim that it was heard. */
+    askNotSpoken: string;
+    /** The avatar stopped part way (Turn off, the time limit, the avatar leaving): part of it was read, not all. */
+    askCut: string;
+    askNotHeard: string;
+    askFailed: string;
+    /** A failed turn whose question could not go back into the box (newer words were typed there): it is in Chat. */
+    askFailedInChat: string;
+    askAlsoInChat: string;
+    /** Stop reading the answer: the transcript's own words (`message.stopSpeaking*`). */
+    askStop: string;
+    askStopShort: 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;
     /**