@burdenoff/fe-libs 2026.1029.6 → 2026.1029.7

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

@@ -365,5 +365,10 @@ export * from './avatar/live/LiveAvatarMinutes';
 export * from './avatar/live/createLiveAvatarSeam';
 export * from './avatar/live/avatarVoice';
 export * from './promptDelivery';
+export * from './speech/appendSpeechQueue';
+export * from './voice/phraseSpeechConfig';
+export * from './voice/phraseGate';
+export * from './voice/livePhraseSpeech';
+export * from './voice/phrasePlayback';
 export * from './attachmentAccess';
 export * from './attachmentAccessCopy';

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

@@ -19,6 +19,8 @@ export interface LivePartState {
     readonly gapped: boolean;
     /** A new generation began while the part was being written. */
     readonly frozen: boolean;
+    /** S7: a tool began after this text part; it is no longer live narration. */
+    readonly toolAfter?: boolean;
 }
 export interface LiveMessageState {
     readonly created?: number;
@@ -27,6 +29,7 @@ export interface LiveMessageState {
 export interface LiveDeltaState {
     /** +1 for every re-mint. */
     readonly generation: number;
+    readonly toolIds?: ReadonlySet<string>;
     readonly parts: ReadonlyMap<string, LivePartState>;
     readonly messages: ReadonlyMap<string, LiveMessageState>;
 }

package/dist/shared/assistant/liveDeltas.js

@@ -109,7 +109,23 @@ function p(e, t) {
 	if (!n) return e;
 	switch (t.event) {
 		case "message.updated": return u(e, n);
-		case "message.part.updated": return n.type === "text" ? d(e, n) : e;
+		case "message.part.updated": {
+			if (n.type === "text") return d(e, n);
+			if (n.type !== "tool") return e;
+			let t = a(n.id), r = a(n.messageID);
+			if (!t || !r || e.toolIds?.has(t)) return e;
+			if ((e.toolIds?.size ?? 0) >= 256) return c(e);
+			let i = new Map(e.parts);
+			for (let [e, t] of i) t.messageId === r && i.set(e, {
+				...t,
+				toolAfter: !0
+			});
+			return {
+				...e,
+				parts: i,
+				toolIds: new Set([...e.toolIds ?? [], t])
+			};
+		}
 		case "message.part.delta": return n.partType === "text" || n.partType === void 0 ? f(e, n) : e;
 		default: return e;
 	}

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

@@ -34,6 +34,10 @@ export interface LiveRenderOptions {
     onFirstDelta?: () => void;
     /** Called once, when the overlay first shows text. */
     onFirstVisible?: () => void;
+    /** S7 reads validated live parts only AFTER this overlay write, never the poll text. */
+    /** Safety notifications precede throttling: a tool must cancel a hold timer now. */
+    onLiveState?: (live: LiveDeltaState, floor: number) => void;
+    onRendered?: (content: string, live: LiveDeltaState, floor: number) => void;
     /** Minimum gap between live renders. Leading edge, with a trailing call. */
     throttleMs?: number;
     now?: () => number;

package/dist/shared/assistant/liveOverlay.js

@@ -31,9 +31,18 @@ function o(n) {
 	}, y = () => {
 		if (f = null, d || l === null) return;
 		let e = _();
-		e === "" || e === m || (p = i(), m = e, s.setLive(n.messageId, n.conversationId, e), g || (g = !0, n.onFirstVisible?.()));
+		if (e !== "") {
+			e !== m && (p = i(), m = e, s.setLive(n.messageId, n.conversationId, e));
+			try {
+				n.onRendered?.(e, n.stream.live, l);
+			} catch {}
+			g || (g = !0, n.onFirstVisible?.());
+		}
 	}, b = n.stream.onLive(() => {
 		if (d || l === null) return;
+		try {
+			n.onLiveState?.(n.stream.live, l);
+		} catch {}
 		v();
 		let e = p + c - i();
 		if (e <= 0) {

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

@@ -0,0 +1,13 @@
+import { SpeechErrorReason, SpeechQueue, SpeechSpeakHandlers } from './types';
+export declare const SPEECH_QUEUE_CAPACITY = 32;
+export declare const SPEECH_QUEUE_TEXT_LIMIT = 16384;
+export interface AppendSpeechPort<T> {
+    prepare(text: string, signal: AbortSignal): Promise<T>;
+    play(value: T, index: number, began: () => void): Promise<void>;
+    drain(): Promise<void>;
+    retract(fromIndex: number): void;
+    cancel(): void;
+    failed(cause: unknown): SpeechErrorReason;
+}
+/** Bounded reply queue: one playing/preparing piece and at most one prefetched. */
+export declare function createAppendSpeechQueue<T>(port: AppendSpeechPort<T>, handlers?: SpeechSpeakHandlers): SpeechQueue;

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

@@ -0,0 +1,75 @@
+//#region src/shared/assistant/speech/appendSpeechQueue.ts
+var e = 32, t = 16384;
+function n(e, t = {}) {
+	let n = [], r = null, i = 0, a = !1, o = !1, s = !1, c = !1, l = !1, u = (t) => (t.ready || (t.ready = Promise.resolve().then(() => {
+		if (o || t.controller.signal.aborted) throw Error("speech cancelled");
+		return e.prepare(t.text, t.controller.signal);
+	}), t.ready.catch(() => {})), t.ready), d = () => {
+		r?.started && n[0] && u(n[0]);
+	}, f = (e) => {
+		e.withdrawn = !0, e.controller.abort();
+	}, p = () => {
+		o || (o = !0, r && f(r), n.forEach(f), n = [], e.cancel());
+	}, m = async () => {
+		if (!(s || o)) {
+			s = !0;
+			try {
+				for (; !o;) {
+					if (r = n.shift() ?? null, !r) {
+						if (await e.drain(), o) return;
+						if (n.length) continue;
+						a ? (o = !0, t.onEnd?.()) : l || (l = !0, t.onPause?.());
+						return;
+					}
+					l = !1;
+					let i = r, s;
+					try {
+						s = await u(i);
+					} catch (e) {
+						if (i.withdrawn) continue;
+						throw e;
+					}
+					if (o) return;
+					if (!i.withdrawn) {
+						if (n[0] && u(n[0]), await e.play(s, i.index, () => {
+							o || i.withdrawn || i.started || (i.started = !0, c || (c = !0, t.onStart?.()), t.onChunkStart?.(i.index), d());
+						}), o || (await e.drain(), o)) return;
+						r = null, i.withdrawn || t.onChunkEnd?.(i.index);
+					}
+				}
+			} catch (n) {
+				o || (p(), t.onError?.(e.failed(n)));
+			} finally {
+				s = !1;
+			}
+		}
+	};
+	return {
+		append(e) {
+			if (o || a) return !1;
+			let t = e.filter((e) => e.trim().length > 0), s = [...n, ...r ? [r] : []];
+			if (s.length + t.length > 32 || s.reduce((e, t) => e + t.text.length, 0) + t.join("").length > 16384) return !1;
+			for (let e of t) n.push({
+				index: i++,
+				text: e,
+				controller: new AbortController(),
+				started: !1,
+				withdrawn: !1
+			});
+			return d(), m(), !0;
+		},
+		end() {
+			o || (a = !0, m());
+		},
+		retract() {
+			if (o) return;
+			let i = n;
+			n = [];
+			let a = r && !r.started ? r.index : i[0]?.index;
+			a !== void 0 && e.retract(a), r && !r.started && i.push(r), i.forEach(f), i.length && t.onRetract?.(i.map((e) => e.index));
+		},
+		cancel: p
+	};
+}
+//#endregion
+export { e as SPEECH_QUEUE_CAPACITY, t as SPEECH_QUEUE_TEXT_LIMIT, n as createAppendSpeechQueue };

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

@@ -1,6 +1,7 @@
-import { setDeviceVoice as e } from "../voice/handsfree/playbackReference.js";
+import { createAppendSpeechQueue as e } from "./appendSpeechQueue.js";
+import { setDeviceVoice as t } from "../voice/handsfree/playbackReference.js";
 //#region src/shared/assistant/speech/browserSpeechEngine.ts
-function t() {
+function n() {
 	if (typeof window > "u") return null;
 	try {
 		return window.speechSynthesis ?? null;
@@ -8,10 +9,10 @@ function t() {
 		return null;
 	}
 }
-function n() {
+function r() {
 	return typeof window < "u" && typeof window.SpeechSynthesisUtterance == "function";
 }
-function r(e) {
+function i(e) {
 	switch (e) {
 		case "canceled":
 		case "cancelled":
@@ -23,7 +24,7 @@ function r(e) {
 		default: return "unknown";
 	}
 }
-function i(e, t) {
+function a(e, t) {
 	if (!t) return null;
 	let n;
 	try {
@@ -33,85 +34,131 @@ function i(e, t) {
 	}
 	return n.find((e) => e === t) ?? n.find((e) => e.name === t.name && e.lang === t.lang) ?? null;
 }
-var a = 0, o = {
+var o = 0, s = null, c = {
 	id: "browser-speech-synthesis",
 	isSupported() {
-		return t() !== null && n();
+		return n() !== null && r();
 	},
 	listVoices() {
 		try {
-			return t()?.getVoices() ?? [];
+			return n()?.getVoices() ?? [];
 		} catch {
 			return [];
 		}
 	},
 	subscribeVoices(e) {
-		let n = t();
-		if (!n?.addEventListener) return () => {};
+		let t = n();
+		if (!t?.addEventListener) return () => {};
 		let r = () => e();
-		return n.addEventListener("voiceschanged", r), () => n.removeEventListener("voiceschanged", r);
+		return t.addEventListener("voiceschanged", r), () => t.removeEventListener("voiceschanged", r);
 	},
-	speak(o, s, c = {}) {
-		let l = t();
-		if (!l || !n()) {
-			c.onError?.("unsupported");
+	speak(e, c, l = {}) {
+		s?.cancel(), s = null;
+		let u = n();
+		if (!u || !r()) {
+			l.onError?.("unsupported");
 			return;
 		}
-		let u = o.filter((e) => e.trim().length > 0);
-		if (u.length === 0) {
-			c.onEnd?.();
+		let d = e.filter((e) => e.trim().length > 0);
+		if (d.length === 0) {
+			l.onEnd?.();
 			return;
 		}
-		a += 1;
-		let d = a;
+		o += 1;
+		let f = o;
 		try {
-			l.cancel();
+			u.cancel();
 		} catch {}
-		let f = i(l, s.voice);
-		e(!0), u.forEach((t, n) => {
-			if (d !== a) return;
-			let i;
+		let p = a(u, c.voice);
+		t(!0), d.forEach((e, n) => {
+			if (f !== o) return;
+			let r;
 			try {
-				i = new window.SpeechSynthesisUtterance(t), i.lang = s.lang, f && (i.voice = f), s.rate !== void 0 && (i.rate = s.rate);
+				r = new window.SpeechSynthesisUtterance(e), r.lang = c.lang, p && (r.voice = p), c.rate !== void 0 && (r.rate = c.rate);
 			} catch {
-				a += 1;
+				o += 1;
 				try {
-					l.cancel();
+					u.cancel();
 				} catch {}
-				c.onError?.("unknown");
+				l.onError?.("unknown");
 				return;
 			}
-			i.onstart = () => {
-				d === a && (n === 0 && c.onStart?.(), c.onChunkStart?.(n));
-			}, i.onerror = (t) => {
-				if (d === a) {
-					e(!1), a += 1;
+			r.onstart = () => {
+				f === o && (n === 0 && l.onStart?.(), l.onChunkStart?.(n));
+			}, r.onerror = (e) => {
+				if (f === o) {
+					t(!1), o += 1;
 					try {
-						l.cancel();
+						u.cancel();
 					} catch {}
-					c.onError?.(r(t.error));
+					l.onError?.(i(e.error));
 				}
-			}, n === u.length - 1 && (i.onend = () => {
-				d === a && (e(!1), c.onEnd?.());
+			}, n === d.length - 1 && (r.onend = () => {
+				f === o && (t(!1), l.onEnd?.());
 			});
 			try {
-				l.speak(i);
+				u.speak(r);
 			} catch {
-				if (d !== a) return;
-				a += 1, e(!1);
+				if (f !== o) return;
+				o += 1, t(!1);
 				try {
-					l.cancel();
+					u.cancel();
 				} catch {}
-				c.onError?.("unknown");
+				l.onError?.("unknown");
+			}
+		});
+	},
+	open(o, l = {}) {
+		c.cancel();
+		let u = n(), d = -1, f = null, p = () => {
+			f?.(), f = null, t(!1);
+			try {
+				u?.cancel();
+			} catch {}
+		}, m = e({
+			prepare: async (e) => e,
+			play: (e, n, s) => new Promise((c, l) => {
+				if (!u || !r()) {
+					l({ reason: "unsupported" });
+					return;
+				}
+				d = n;
+				let p = !1, m = (e) => {
+					p || (p = !0, t(!1), e ? l({ reason: e }) : c());
+				};
+				f = () => m();
+				try {
+					let n = new window.SpeechSynthesisUtterance(e);
+					n.lang = o.lang;
+					let r = a(u, o.voice);
+					r && (n.voice = r), o.rate !== void 0 && (n.rate = o.rate), n.onstart = () => {
+						p || s();
+					}, n.onend = () => m(), n.onerror = (e) => m(i(e.error)), t(!0), u.speak(n);
+				} catch {
+					m("unknown");
+				}
+			}),
+			drain: async () => {},
+			retract: (e) => {
+				d >= e && p();
+			},
+			cancel: p,
+			failed: (e) => e?.reason ?? "unknown"
+		}, {
+			...l,
+			onEnd: () => {
+				s === m && (s = null), l.onEnd?.();
 			}
 		});
+		return s = m, m;
 	},
 	cancel() {
-		a += 1, e(!1);
+		let e = s;
+		s = null, e?.cancel(), o += 1, t(!1);
 		try {
-			t()?.cancel();
+			n()?.cancel();
 		} catch {}
 	}
 };
 //#endregion
-export { o as browserSpeechEngine };
+export { c as browserSpeechEngine };