@burdenoff/fe-libs 2026.1013.9 → 2026.1013.11

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

@@ -515,6 +515,7 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly "voiceSession.noticeNotCapturing": "The microphone did not start. Check that this site is allowed to use it, then try again.";
     readonly "voiceSession.noticeNothingHeard": "Nothing heard yet. Check your microphone is not muted or in use by another app.";
     readonly "voiceSession.noticeRecognitionFailed": "Speech recognition stopped unexpectedly. It will retry — if it keeps happening, reload the page.";
+    readonly "voiceSession.noticeReplyNotHeard": "That reply was not read aloud: earlier audio may still be playing. Read it in the transcript.";
     readonly "voiceSession.save": "Save transcript";
     readonly "voiceSession.savedAt": "Saved";
     readonly "voiceSession.sessionLabel": "Session";

package/dist/shared/assistant/i18nManifest.js

@@ -409,6 +409,7 @@ var m = {
 	"voiceSession.noticeNotCapturing": "The microphone did not start. Check that this site is allowed to use it, then try again.",
 	"voiceSession.noticeNothingHeard": "Nothing heard yet. Check your microphone is not muted or in use by another app.",
 	"voiceSession.noticeRecognitionFailed": "Speech recognition stopped unexpectedly. It will retry — if it keeps happening, reload the page.",
+	"voiceSession.noticeReplyNotHeard": "That reply was not read aloud: earlier audio may still be playing. Read it in the transcript.",
 	"voiceSession.save": "Save transcript",
 	"voiceSession.savedAt": "Saved",
 	"voiceSession.sessionLabel": "Session",

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

@@ -44,6 +44,7 @@ export * from './speech/browserSpeechEngine';
 export * from './speech/hostedTtsSpeechEngine';
 export * from './speech/routingSpeechEngine';
 export * from './speech/hostedVoiceCatalogue';
+export * from './speech/pieceSink';
 export * from './speech/speechFeed';
 export * from './voice/useVoiceInput';
 export * from './voice/voiceStageState';

package/dist/shared/assistant/speech/hostedTtsSpeechEngine.js

@@ -1,23 +1,24 @@
 import { tapPlaybackElement as e } from "../voice/handsfree/playbackReference.js";
 import { HOSTED_TTS_TIER as t, HOSTED_VOICES as n, hostedLocaleFor as r } from "./hostedVoiceCatalogue.js";
 import { buildRequest as i, classifyHttpFailure as a, decodeAudioResponse as o, disableDurationMs as s, shouldDisableEngine as c, speakableChunks as l } from "./hostedTtsProtocol.js";
+import { createPieceSink as u, isOutputRefusal as d } from "./pieceSink.js";
 //#region src/shared/assistant/speech/hostedTtsSpeechEngine.ts
-function u(e) {
+function f(e) {
 	let t = Object.entries(e).map(([e, t]) => `${e.toLowerCase()}:${t}`).sort().join("\n"), n = 5381;
 	for (let e = 0; e < t.length; e += 1) n = (n << 5) + n + t.charCodeAt(e) | 0;
 	return `${t.length}:${n >>> 0}`;
 }
-var d = new Set([
+var p = new Set([
 	429,
 	502,
 	503,
 	504
-]), f = 3, p = 400, m = 2e3;
-function h(e, t) {
+]), m = 3, h = 400, g = 2e3;
+function _(e, t) {
 	let n = e === null ? NaN : Number(e);
-	return Math.min(Number.isFinite(n) && n >= 0 ? n * 1e3 : p * 2 ** (t - 1), m);
+	return Math.min(Number.isFinite(n) && n >= 0 ? n * 1e3 : h * 2 ** (t - 1), g);
 }
-function g(e, t) {
+function v(e, t) {
 	return new Promise((n) => {
 		if (t.aborted) {
 			n();
@@ -32,44 +33,44 @@ function g(e, t) {
 		t.addEventListener("abort", i, { once: !0 });
 	});
 }
-function _(p) {
-	let m = p.fetchImpl ?? ((...e) => fetch(...e)), _ = p.now ?? (() => Date.now()), v = null, y = null, b = 0, x = null, S = 0, C = null, w = null, T = () => {
+function y(h) {
+	let g = h.fetchImpl ?? ((...e) => fetch(...e)), y = h.now ?? (() => Date.now()), b = null, x = null, S = 0, C = null, w = null, T = 0, E = null, D = null, O = () => {
 		try {
-			return p.getHeaders?.() ?? {};
+			return h.getHeaders?.() ?? {};
 		} catch {
 			return {};
 		}
-	}, E = () => _() >= S ? !1 : w === null ? !0 : u(T()) === w, D = /* @__PURE__ */ new Set(), O = () => {
-		for (let e of [...D]) e();
-	}, k = () => {
-		C !== null && clearTimeout(C), C = null;
-	}, A = (e) => {
-		k(), C = setTimeout(() => {
-			C = null;
-			let e = S - _();
+	}, k = () => y() >= T ? !1 : D === null ? !0 : f(O()) === D, A = /* @__PURE__ */ new Set(), j = () => {
+		for (let e of [...A]) e();
+	}, M = () => {
+		E !== null && clearTimeout(E), E = null;
+	}, N = (e) => {
+		M(), E = setTimeout(() => {
+			E = null;
+			let e = T - y();
 			if (e > 0) {
-				A(e);
+				N(e);
 				return;
 			}
-			O();
+			j();
 		}, e);
-	}, j = (e, t) => {
-		S = _() + e, w = t, A(e), O();
-	}, M = () => {
-		y &&= (URL.revokeObjectURL(y), null);
-	}, N = () => {
-		if (v) {
-			v.onended = null, v.onerror = null;
+	}, P = (e, t) => {
+		T = y() + e, D = t, N(e), j();
+	}, F = () => {
+		x &&= (URL.revokeObjectURL(x), null);
+	}, I = () => {
+		if (b) {
+			b.onended = null, b.onerror = null;
 			try {
-				v.pause();
+				b.pause();
 			} catch {}
-			v = null;
+			b = null;
 		}
-		M();
+		F();
 	};
-	async function P(e, n, s) {
-		let c = i(e, r(n.lang) ?? n.lang, t, n.voice?.name ?? null, n.rate), l = p.getHeaders?.() ?? {}, _;
-		for (let e = 1; _ = await m(p.endpoint, {
+	async function L(e, n, s) {
+		let c = i(e, r(n.lang) ?? n.lang, t, n.voice?.name ?? null, n.rate), l = h.getHeaders?.() ?? {}, u;
+		for (let e = 1; u = await g(h.endpoint, {
 			method: "POST",
 			signal: s,
 			headers: {
@@ -77,42 +78,42 @@ function _(p) {
 				...l
 			},
 			body: JSON.stringify(c)
-		}), !_.ok; e += 1) {
-			if (!(d.has(_.status) && e < f && !s.aborted)) {
-				let e = /* @__PURE__ */ Error(`hosted tts ${_.status}`);
-				throw e.reason = a(_.status), e.headers = u(l), e;
+		}), !u.ok; e += 1) {
+			if (!(p.has(u.status) && e < m && !s.aborted)) {
+				let e = /* @__PURE__ */ Error(`hosted tts ${u.status}`);
+				throw e.reason = a(u.status), e.headers = f(l), e;
 			}
-			await g(h(_.headers.get("retry-after"), e), s);
+			await v(_(u.headers.get("retry-after"), e), s);
 		}
-		let v = _.headers.get("content-type"), y = o(v, v?.includes("json") ? await _.json() : await _.arrayBuffer());
+		let d = u.headers.get("content-type"), y = o(d, d?.includes("json") ? await u.json() : await u.arrayBuffer());
 		if (!y) {
 			let e = /* @__PURE__ */ Error("hosted tts returned no audio");
 			throw e.reason = "unknown", e;
 		}
 		return y;
 	}
-	function F(t, n, r) {
+	function R(t, n, r) {
 		return new Promise((i, a) => {
-			if (n !== b) {
+			if (n !== S) {
 				i();
 				return;
 			}
 			let o = new Blob([t.slice().buffer], { type: "audio/mpeg" });
-			M(), y = URL.createObjectURL(o);
-			let s = new Audio(y);
-			e(s), v = s, s.onended = () => {
-				n === b && i();
+			F(), x = URL.createObjectURL(o);
+			let s = new Audio(x);
+			e(s), b = s, s.onended = () => {
+				n === S && i();
 			}, s.onerror = () => {
-				if (n !== b) {
+				if (n !== S) {
 					i();
 					return;
 				}
 				let e = /* @__PURE__ */ Error("audio playback failed");
 				e.reason = "unknown", a(e);
 			}, s.play().then(() => {
-				n === b && r?.();
+				n === S && r?.();
 			}, (e) => {
-				if (n !== b) {
+				if (n !== S) {
 					i();
 					return;
 				}
@@ -124,14 +125,14 @@ function _(p) {
 	return {
 		id: "hosted-tts",
 		isSupported() {
-			return E() ? !1 : typeof window < "u" && typeof window.Audio == "function" && typeof fetch == "function";
+			return k() ? !1 : typeof window < "u" && typeof window.Audio == "function" && typeof fetch == "function";
 		},
 		listVoices() {
-			return E() ? [] : [...n];
+			return k() ? [] : [...n];
 		},
 		subscribeVoices(e) {
-			return D.add(e), () => {
-				D.delete(e);
+			return A.add(e), () => {
+				A.delete(e);
 			};
 		},
 		speak(e, t, n = {}) {
@@ -140,43 +141,66 @@ function _(p) {
 				n.onEnd?.();
 				return;
 			}
-			b += 1;
-			let i = b;
-			N();
+			S += 1;
+			let i = S;
+			I(), w?.cancel();
 			let a = new AbortController();
-			x = a;
-			let o = !1, u = () => {
+			C = a;
+			let o = !1, f = () => {
 				o || (o = !0, n.onStart?.());
-			}, d = (e) => {
-				let n = P(e, t, a.signal);
+			}, p = (e) => {
+				let n = L(e, t, a.signal);
 				return n.catch(() => {}), n;
-			};
-			(async () => {
+			}, m = t.audioOutput ? u(t.audioOutput, {
+				play: (e) => R(e, i, f),
+				isCurrent: () => i === S,
+				onChunkStart: (e) => n.onChunkStart?.(e),
+				onStart: f
+			}) : null;
+			w = m, (async () => {
 				try {
-					let e = d(r[0]);
+					let e = p(r[0]);
 					for (let t = 0; t < r.length; t += 1) {
-						if (i !== b) return;
+						if (i !== S) return;
 						let a = await e;
-						if (i !== b) return;
+						if (i !== S) return;
 						let o = r[t + 1];
-						o !== void 0 && (e = d(o)), n.onChunkStart?.(t), await F(a, i, u);
+						if (o !== void 0 && (e = p(o)), m) {
+							await m.write(a);
+							continue;
+						}
+						n.onChunkStart?.(t), await R(a, i, f);
 					}
-					i === b && n.onEnd?.();
+					if (m) {
+						let e = await m.drain();
+						if (i !== S) return;
+						if (!e) throw Object.assign(/* @__PURE__ */ Error("audio output did not finish"), { reason: "unknown" });
+					}
+					i === S && n.onEnd?.();
 				} catch (e) {
-					if (a.abort(), i !== b) return;
-					b += 1, N();
-					let t = e?.reason;
-					c(t, e?.transient === !0) && j(s(t), t === "not-allowed" ? e.headers ?? null : null), n.onError?.(t === "not-allowed" || t === "unsupported" || t === "cancelled" ? t : "unknown");
+					if (a.abort(), i !== S) return;
+					let t = null;
+					if (m) {
+						let n = await m.drain().then(() => null, (e) => e);
+						if (i !== S) return;
+						m.cancel(), d(e) ? t = e : d(n) && (t = n);
+					}
+					if (S += 1, I(), t) {
+						n.onError?.("output-not-cleared");
+						return;
+					}
+					let r = e?.reason;
+					c(r, e?.transient === !0) && P(s(r), r === "not-allowed" ? e.headers ?? null : null), n.onError?.(r === "not-allowed" || r === "unsupported" || r === "cancelled" ? r : "unknown");
 				}
 			})();
 		},
 		headersChanged() {
-			_() >= S || w === null || E() || (S = 0, w = null, k(), O());
+			y() >= T || D === null || k() || (T = 0, D = null, M(), j());
 		},
 		cancel() {
-			b += 1, x?.abort(), x = null, N();
+			S += 1, C?.abort(), C = null, I(), w?.cancel(), w = null;
 		}
 	};
 }
 //#endregion
-export { _ as createHostedTtsEngine, h as retryDelayMs };
+export { y as createHostedTtsEngine, _ as retryDelayMs };

package/dist/shared/assistant/speech/pieceSink.d.ts

@@ -0,0 +1,51 @@
+import { SpeechAudioOutput, SpeechOutputRefusal } from './types';
+/** @internal What the sink needs from the reply it belongs to. */
+export interface PieceSinkReply {
+    /** Plays one piece on the speakers and resolves when it has finished: the engine's own `play`. */
+    play(bytes: Uint8Array): Promise<void>;
+    /** False once the reply was cancelled or replaced: nothing more is played. */
+    isCurrent(): boolean;
+    /** Piece `index` begins: the live caption's sync signal. */
+    onChunkStart(index: number): void;
+    /** The reply's first sound (the engine announces it once per reply). */
+    onStart(): void;
+}
+/** @internal The engine's side of one reply's audio output. */
+export interface PieceSink {
+    /**
+     * Hand over the reply's next piece. Pieces are numbered 0, 1, 2… by ONE
+     * counter for the whole reply: a queue's count continues across appends and
+     * across drains, and a retracted number is never given again. Resolves when
+     * the next piece may follow; rejects as `drain` does once the speakers fail
+     * or the output refused the reply.
+     */
+    write(bytes: Uint8Array): Promise<void>;
+    /**
+     * Resolves once everything written so far has finished playing: `true`, or
+     * `false` when the output FAILED after every piece had begun, so the end was
+     * never confirmed (a leave is not a failure: `true`). Callable any number of
+     * times; writing may go on after it, even while it is pending (a piece written
+     * meanwhile is not part of it). Never rejects with the output's reason, only
+     * with the speakers' own failure, which the engine reports as it always has,
+     * or with the output's REFUSAL (`SpeechOutputRefusal`, operator decision
+     * D7 b), which the engine reports as `output-not-cleared`. Either one is kept:
+     * every later or queued `write` and `drain` rejects with it until `cancel()`,
+     * nothing more plays, and nothing is confirmed.
+     */
+    drain(): Promise<boolean>;
+    /**
+     * Withdraw every piece from `fromIndex` on that has not begun, on the output
+     * and in the record a failure replays from; the one playing finishes.
+     */
+    retract(fromIndex: number): void;
+    /** The hard stop: silence the output and drop everything. Nothing is replayed. */
+    cancel(): void;
+}
+/**
+ * @internal The output REFUSED the reply (`SpeechOutputRefusal`, operator
+ * decision D7 b): nothing of it may be heard anywhere. The engine reads it to
+ * report `output-not-cleared`.
+ */
+export declare const isOutputRefusal: (cause: unknown) => cause is SpeechOutputRefusal;
+/** @internal One reply's piece sink, playing on `output` until it fails, leaves or refuses. */
+export declare function createPieceSink(output: SpeechAudioOutput, reply: PieceSinkReply): PieceSink;

package/dist/shared/assistant/speech/pieceSink.js

@@ -0,0 +1,90 @@
+import { SPEECH_OUTPUT_LEFT as e, SPEECH_OUTPUT_REFUSE_AUDIBLE as t } from "./types.js";
+//#region src/shared/assistant/speech/pieceSink.ts
+var n = (t) => t?.reason === e, r = (e) => e?.reason === t;
+function i(e, t) {
+	let i = e, a = !1, o = 0, s = /* @__PURE__ */ new Map(), c = null, l = () => !a && t.isCurrent(), u = () => {
+		let e = i;
+		i = null;
+		try {
+			e?.cancel();
+		} catch {}
+	}, d = (e) => (c === null && (c = e), s.clear(), u(), c), f = () => {
+		if (c !== null && l()) throw c;
+	}, p = (e, n) => () => {
+		if (!(i !== e || !l() || !s.has(n))) {
+			for (let e of s.keys()) {
+				if (e > n) break;
+				s.delete(e);
+			}
+			t.onChunkStart(n), t.onStart();
+		}
+	}, m = !1, h = async () => {
+		for (let [e, n] of s) {
+			if (!l()) return;
+			s.delete(e), m = !0, t.onChunkStart(e);
+			try {
+				await t.play(n);
+			} catch (e) {
+				throw s.clear(), c ?? e;
+			}
+		}
+	}, g = Promise.resolve(), _ = () => {
+		if (!l()) return Promise.resolve();
+		if (c !== null) return Promise.reject(c);
+		let e = g.then(h);
+		return g = e, e;
+	};
+	return {
+		async write(e) {
+			let t = o;
+			if (o += 1, !l()) return;
+			if (c !== null) throw c;
+			s.set(t, e);
+			let n = i;
+			if (n) try {
+				await n.write(e, t, p(n, t));
+			} catch (e) {
+				if (!l()) return;
+				if (r(e)) throw d(e);
+				i === n && u();
+			}
+			i === null && await _(), f();
+		},
+		async drain() {
+			let e = i;
+			if (e && l()) {
+				let t = o;
+				try {
+					if (await e.drain(), i === e) {
+						for (let e of s.keys()) {
+							if (e >= t) break;
+							s.delete(e);
+						}
+						return !0;
+					}
+				} catch (t) {
+					if (!l()) return !0;
+					if (r(t)) throw d(t);
+					let a = n(t) || s.size > 0;
+					return i === e && u(), await _(), f(), a || m;
+				}
+			}
+			return await _(), f(), !0;
+		},
+		retract(e) {
+			if (!l()) return;
+			let t = i;
+			if (t) try {
+				t.retract(e);
+			} catch {
+				i === t && u();
+			}
+			for (let t of s.keys()) t >= e && s.delete(t);
+		},
+		cancel() {
+			a = !0, s.clear(), u();
+		}
+	};
+}
+//#endregion
+export { i as createPieceSink, r as isOutputRefusal };

package/dist/shared/assistant/speech/routingSpeechEngine.js

@@ -2,82 +2,92 @@ import { hostedSupportsLanguage as e } from "./hostedVoiceCatalogue.js";
 import { speakableChunks as t } from "./hostedTtsProtocol.js";
 import { selectVoiceForLocale as n } from "../voice/speechVoices.js";
 //#region src/shared/assistant/speech/routingSpeechEngine.ts
-function r({ device: r, hosted: i }) {
-	if (!i) return r;
-	let a = new Set(i.listVoices().map((e) => e.name)), o = (e) => e.source === "hosted" || a.has(e.name), s = (e, t, i) => {
-		if (!t.voice || !o(t.voice)) {
-			r.speak(e, t, i);
+function r(e) {
+	switch (e) {
+		case "cancelled":
+		case "output-not-cleared": return !1;
+		case "not-allowed":
+		case "unsupported":
+		case "unknown": return !0;
+		default: return e;
+	}
+}
+function i({ device: i, hosted: a }) {
+	if (!a) return i;
+	let o = new Set(a.listVoices().map((e) => e.name)), s = (e) => e.source === "hosted" || o.has(e.name), c = (e, t, r) => {
+		if (!t.voice || !s(t.voice)) {
+			i.speak(e, t, r);
 			return;
 		}
 		if (t.fallback === !1) {
-			i?.onError?.("unsupported");
+			r?.onError?.("unsupported");
 			return;
 		}
-		let a = n(r.listVoices(), t.lang);
+		let a = n(i.listVoices(), t.lang);
 		if (!a) {
-			i?.onError?.("unsupported");
+			r?.onError?.("unsupported");
 			return;
 		}
-		r.speak(e, {
+		i.speak(e, {
 			...t,
 			voice: a
-		}, i);
-	}, c = (t) => i.isSupported() ? t.voice ? a.has(t.voice.name) ? i : r : e(t.lang) ? i : r : r;
+		}, r);
+	}, l = (t) => a.isSupported() ? t.voice ? o.has(t.voice.name) ? a : i : e(t.lang) ? a : i : i;
 	return {
-		id: `routing(${i.id}+${r.id})`,
+		id: `routing(${a.id}+${i.id})`,
 		isSupported() {
-			return i.isSupported() || r.isSupported();
+			return a.isSupported() || i.isSupported();
 		},
 		listVoices() {
-			return i.isSupported() ? [...i.listVoices(), ...r.listVoices()] : r.listVoices();
+			return a.isSupported() ? [...a.listVoices(), ...i.listVoices()] : i.listVoices();
 		},
 		subscribeVoices(e) {
-			let t = r.subscribeVoices(e), n = i.subscribeVoices(e);
+			let t = i.subscribeVoices(e), n = a.subscribeVoices(e);
 			return () => {
 				t(), n();
 			};
 		},
-		speak(e, n, a) {
-			if (r.cancel(), i.cancel(), c(n) !== i) {
-				s(e, n, a);
+		speak(e, n, o) {
+			if (i.cancel(), a.cancel(), l(n) !== a) {
+				c(e, n, o);
 				return;
 			}
-			let o = !1, l = -1;
-			i.speak(e, n, {
-				...a,
+			let s = !1, u = -1;
+			a.speak(e, n, {
+				...o,
 				onStart: () => {
-					o = !0, a?.onStart?.();
+					s = !0, o?.onStart?.();
 				},
 				onChunkStart: (e) => {
-					l = e, a?.onChunkStart?.(e);
+					u = e, o?.onChunkStart?.(e);
 				},
-				onError: (r) => {
-					if (r === "cancelled" || n.fallback === !1) {
-						a?.onError?.(r);
+				onError: (i) => {
+					if (!r(i) || n.fallback === !1) {
+						o?.onError?.(i);
 						return;
 					}
-					if (!o) {
-						s(e, n, a);
+					if (!s) {
+						c(e, n, o);
 						return;
 					}
-					let i = l >= 0 ? t(e).slice(l + 1) : [];
-					if (i.length === 0) {
-						a?.onError?.(r);
+					let a = u >= 0 ? t(e).slice(u + 1) : [];
+					if (a.length === 0) {
+						o?.onError?.(i);
 						return;
 					}
-					let c = l + 1;
-					s(i, n, {
-						...a,
+					let l = u + 1;
+					c(a, n, {
+						...o,
 						onStart: void 0,
-						onChunkStart: (e) => a?.onChunkStart?.(c + e)
+						onChunkStart: (e) => o?.onChunkStart?.(l + e)
 					});
 				}
 			});
 		},
 		cancel() {
-			r.cancel(), i.cancel();
+			i.cancel(), a.cancel();
 		}
 	};
 }
 //#endregion
-export { r as createRoutingSpeechEngine };
+export { i as createRoutingSpeechEngine };