@burdenoff/fe-libs 2026.1013.10 → 2026.1013.12

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/speech/hostedTtsSpeechEngine.js

@@ -1,24 +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 } from "./pieceSink.js";
+import { createPieceSink as u, isOutputRefusal as d } from "./pieceSink.js";
 //#region src/shared/assistant/speech/hostedTtsSpeechEngine.ts
-function d(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 f = new Set([
+var p = new Set([
 	429,
 	502,
 	503,
 	504
-]), p = 3, m = 400, h = 2e3;
-function g(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 : m * 2 ** (t - 1), h);
+	return Math.min(Number.isFinite(n) && n >= 0 ? n * 1e3 : h * 2 ** (t - 1), g);
 }
-function _(e, t) {
+function v(e, t) {
 	return new Promise((n) => {
 		if (t.aborted) {
 			n();
@@ -33,44 +33,44 @@ function _(e, t) {
 		t.addEventListener("abort", i, { once: !0 });
 	});
 }
-function v(m) {
-	let h = m.fetchImpl ?? ((...e) => fetch(...e)), v = m.now ?? (() => Date.now()), y = null, b = null, x = 0, S = null, C = null, w = 0, T = null, E = null, D = () => {
+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 m.getHeaders?.() ?? {};
+			return h.getHeaders?.() ?? {};
 		} catch {
 			return {};
 		}
-	}, O = () => v() >= w ? !1 : E === null ? !0 : d(D()) === E, k = /* @__PURE__ */ new Set(), A = () => {
-		for (let e of [...k]) e();
-	}, j = () => {
-		T !== null && clearTimeout(T), T = null;
-	}, M = (e) => {
-		j(), T = setTimeout(() => {
-			T = null;
-			let e = w - v();
+	}, 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) {
-				M(e);
+				N(e);
 				return;
 			}
-			A();
+			j();
 		}, e);
-	}, N = (e, t) => {
-		w = v() + e, E = t, M(e), A();
-	}, P = () => {
-		b &&= (URL.revokeObjectURL(b), null);
+	}, P = (e, t) => {
+		T = y() + e, D = t, N(e), j();
 	}, F = () => {
-		if (y) {
-			y.onended = null, y.onerror = null;
+		x &&= (URL.revokeObjectURL(x), null);
+	}, I = () => {
+		if (b) {
+			b.onended = null, b.onerror = null;
 			try {
-				y.pause();
+				b.pause();
 			} catch {}
-			y = null;
+			b = null;
 		}
-		P();
+		F();
 	};
-	async function I(e, n, s) {
-		let c = i(e, r(n.lang) ?? n.lang, t, n.voice?.name ?? null, n.rate), l = m.getHeaders?.() ?? {}, u;
-		for (let e = 1; u = await h(m.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: {
@@ -79,41 +79,41 @@ function v(m) {
 			},
 			body: JSON.stringify(c)
 		}), !u.ok; e += 1) {
-			if (!(f.has(u.status) && e < p && !s.aborted)) {
+			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 = d(l), e;
+				throw e.reason = a(u.status), e.headers = f(l), e;
 			}
-			await _(g(u.headers.get("retry-after"), e), s);
+			await v(_(u.headers.get("retry-after"), e), s);
 		}
-		let v = u.headers.get("content-type"), y = o(v, v?.includes("json") ? await u.json() : await u.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 L(t, n, r) {
+	function R(t, n, r) {
 		return new Promise((i, a) => {
-			if (n !== x) {
+			if (n !== S) {
 				i();
 				return;
 			}
 			let o = new Blob([t.slice().buffer], { type: "audio/mpeg" });
-			P(), b = URL.createObjectURL(o);
-			let s = new Audio(b);
-			e(s), y = s, s.onended = () => {
-				n === x && i();
+			F(), x = URL.createObjectURL(o);
+			let s = new Audio(x);
+			e(s), b = s, s.onended = () => {
+				n === S && i();
 			}, s.onerror = () => {
-				if (n !== x) {
+				if (n !== S) {
 					i();
 					return;
 				}
 				let e = /* @__PURE__ */ Error("audio playback failed");
 				e.reason = "unknown", a(e);
 			}, s.play().then(() => {
-				n === x && r?.();
+				n === S && r?.();
 			}, (e) => {
-				if (n !== x) {
+				if (n !== S) {
 					i();
 					return;
 				}
@@ -125,14 +125,14 @@ function v(m) {
 	return {
 		id: "hosted-tts",
 		isSupported() {
-			return O() ? !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 O() ? [] : [...n];
+			return k() ? [] : [...n];
 		},
 		subscribeVoices(e) {
-			return k.add(e), () => {
-				k.delete(e);
+			return A.add(e), () => {
+				A.delete(e);
 			};
 		},
 		speak(e, t, n = {}) {
@@ -141,61 +141,66 @@ function v(m) {
 				n.onEnd?.();
 				return;
 			}
-			x += 1;
-			let i = x;
-			F(), C?.cancel();
+			S += 1;
+			let i = S;
+			I(), w?.cancel();
 			let a = new AbortController();
-			S = a;
-			let o = !1, d = () => {
+			C = a;
+			let o = !1, f = () => {
 				o || (o = !0, n.onStart?.());
-			}, f = (e) => {
-				let n = I(e, t, a.signal);
+			}, p = (e) => {
+				let n = L(e, t, a.signal);
 				return n.catch(() => {}), n;
-			}, p = t.audioOutput ? u(t.audioOutput, {
-				play: (e) => L(e, i, d),
-				isCurrent: () => i === x,
+			}, m = t.audioOutput ? u(t.audioOutput, {
+				play: (e) => R(e, i, f),
+				isCurrent: () => i === S,
 				onChunkStart: (e) => n.onChunkStart?.(e),
-				onStart: d
+				onStart: f
 			}) : null;
-			C = p, (async () => {
+			w = m, (async () => {
 				try {
-					let e = f(r[0]);
+					let e = p(r[0]);
 					for (let t = 0; t < r.length; t += 1) {
-						if (i !== x) return;
+						if (i !== S) return;
 						let a = await e;
-						if (i !== x) return;
+						if (i !== S) return;
 						let o = r[t + 1];
-						if (o !== void 0 && (e = f(o)), p) {
-							await p.write(a);
+						if (o !== void 0 && (e = p(o)), m) {
+							await m.write(a);
 							continue;
 						}
-						n.onChunkStart?.(t), await L(a, i, d);
+						n.onChunkStart?.(t), await R(a, i, f);
 					}
-					if (p) {
-						let e = await p.drain();
-						if (i !== x) return;
+					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 === x && n.onEnd?.();
+					i === S && n.onEnd?.();
 				} catch (e) {
-					if (a.abort(), i !== x) return;
-					if (p) {
-						if (await p.drain().catch(() => !1), i !== x) return;
-						p.cancel();
+					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;
 					}
-					x += 1, F();
-					let t = e?.reason;
-					c(t, e?.transient === !0) && N(s(t), t === "not-allowed" ? e.headers ?? null : null), n.onError?.(t === "not-allowed" || t === "unsupported" || t === "cancelled" ? t : "unknown");
+					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() {
-			v() >= w || E === null || O() || (w = 0, E = null, j(), A());
+			y() >= T || D === null || k() || (T = 0, D = null, M(), j());
 		},
 		cancel() {
-			x += 1, S?.abort(), S = null, F(), C?.cancel(), C = null;
+			S += 1, C?.abort(), C = null, I(), w?.cancel(), w = null;
 		}
 	};
 }
 //#endregion
-export { v as createHostedTtsEngine, g as retryDelayMs };
+export { y as createHostedTtsEngine, _ as retryDelayMs };

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

@@ -1,4 +1,4 @@
-import { SpeechAudioOutput } from './types';
+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`. */
@@ -16,7 +16,8 @@ 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.
+     * the next piece may follow; rejects as `drain` does once the speakers fail
+     * or the output refused the reply.
      */
     write(bytes: Uint8Array): Promise<void>;
     /**
@@ -25,10 +26,11 @@ export interface PieceSink {
      * 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.
-     * Once the speakers have failed, every later or queued `write` and `drain`
-     * rejects with that same failure until `cancel()`: nothing more plays, and
-     * nothing is confirmed.
+     * 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>;
     /**
@@ -39,5 +41,11 @@ export interface PieceSink {
     /** The hard stop: silence the output and drop everything. Nothing is replayed. */
     cancel(): void;
 }
-/** @internal One reply's piece sink, playing on `output` until it fails or leaves. */
+/**
+ * @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

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