@burdenoff/fe-libs 2026.1029.6 → 2026.1029.7

package/dist/shared/assistant/voice/livePhraseSpeech.d.ts

@@ -0,0 +1,14 @@
+import { LiveDeltaState } from '../liveDeltas';
+export declare const NARRATION_HOLD_MS = 700;
+export interface LivePhraseSpeech {
+    update(visible: string, live: LiveDeltaState, floor: number): void;
+    invalidate(live: LiveDeltaState, floor: number): void;
+    close(): void;
+}
+/** One turn's narrator. Its caller runs only on an opted-in voice/SSE overlay. */
+export declare function createLivePhraseSpeech(options: {
+    append(phrases: readonly string[], visible: string): void;
+    retract(): void;
+    setTimer?: (run: () => void, ms: number) => unknown;
+    clearTimer?: (timer: unknown) => void;
+}): LivePhraseSpeech;

package/dist/shared/assistant/voice/livePhraseSpeech.js

@@ -0,0 +1,72 @@
+import { toSpeakableText as e } from "./speakableText.js";
+import { phraseCandidates as t } from "./phraseGate.js";
+//#region src/shared/assistant/voice/livePhraseSpeech.ts
+var n = 700;
+function r(n) {
+	let r = n.setTimer ?? ((e, t) => setTimeout(e, t)), i = n.clearTimer ?? ((e) => {
+		clearTimeout(e);
+	}), a = null, o = "", s = [], c = [], l = "", u = !1, d = !1, f = () => {
+		a !== null && i(a), a = null;
+	}, p = () => {
+		f(), n.retract(), u = !0;
+	}, m = (e) => {
+		if (d || u || e <= s.length) return;
+		let t = c.slice(s.length, e);
+		s = c.slice(0, e), n.append(t, l);
+	}, h = (e, t) => {
+		let n = [...e.messages].filter(([, e]) => (e.created ?? 0) > t);
+		n.sort((e, t) => (e[1].created ?? 0) - (t[1].created ?? 0));
+		let r = n.at(-1)?.[0];
+		return [...e.parts].filter(([, e]) => e.messageId === r).at(-1);
+	};
+	return {
+		invalidate(e, t) {
+			if (d || !o) return;
+			let n = h(e, t);
+			if (!n) {
+				p();
+				return;
+			}
+			let [r, i] = n;
+			(`${i.messageId}/${r}/${i.generation}` !== o || !i.live || i.gapped || i.frozen || i.toolAfter || i.generation !== e.generation) && p();
+		},
+		update(i, g, _) {
+			if (d) return;
+			let v = h(g, _);
+			if (!v) return;
+			let [y, b] = v, x = `${b.messageId}/${y}/${b.generation}`;
+			if (x !== o && (f(), o && n.retract(), o = x, s = [], u = !1), !b.live || b.gapped || b.frozen || b.toolAfter || b.generation !== g.generation) {
+				p();
+				return;
+			}
+			if (u) return;
+			let S = b.ended && g.messages.get(b.messageId)?.completed !== void 0;
+			if (c = t(b.text, S), s.some((e, t) => c[t] !== e)) {
+				p();
+				return;
+			}
+			l = i;
+			let C = e(i).replace(/\s+/g, " ");
+			if (c.some((e) => !C.includes(e.replace(/\s+/g, " ")))) {
+				p();
+				return;
+			}
+			if (S) {
+				f(), m(c.length);
+				return;
+			}
+			if (m(Math.max(0, c.length - 1)), s.length === c.length) {
+				f();
+				return;
+			}
+			a === null && (a = r(() => {
+				a = null, m(c.length);
+			}, 700));
+		},
+		close() {
+			d = !0, f();
+		}
+	};
+}
+//#endregion
+export { n as NARRATION_HOLD_MS, r as createLivePhraseSpeech };

package/dist/shared/assistant/voice/phraseGate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Re-scan a bounded, append-only source part. Callers keep their released prefix
+ * and freeze if it ever changes; they do not feed arbitrary poll snapshots.
+ * Unfinished paragraphs contribute only sentences with a confirmed ending.
+ */
+export declare function phraseCandidates(markdown: string, final?: boolean): string[];
+/** Reconcile F against accepted/unwithdrawn S without reading the final twice. */
+export declare function unspokenFinal(final: string, segments: readonly string[]): {
+    text: string;
+    diverged: boolean;
+};

package/dist/shared/assistant/voice/phraseGate.js

@@ -0,0 +1,74 @@
+import { MAX_SPEAKABLE_CHARS as e, toSpeakableText as t } from "./speakableText.js";
+//#region src/shared/assistant/voice/phraseGate.ts
+var n = /(?:\b(?:mr|mrs|ms|dr|prof|sr|jr|st|vs|etc|e\.g|i\.e)|\b[A-Z])\.$/i, r = /^(?:thinking|working|one moment|just a moment|sure|certainly|let me (?:check|think|look)|सोच रहा हूँ|சிந்திக்கிறேன்|أفكر|思考中)[\s.!…।॥。]*$/iu, i = /^\s*(?:\||[-*+]\s|\d+[.)]\s|[[{])/, a = {
+	codeBlock: "",
+	image: "",
+	link: "",
+	largeTable: "",
+	truncated: "",
+	emailAt: "",
+	emailDot: "",
+	nestedItem: ""
+};
+function o(e, i) {
+	let o = [], s = 0, c = (n) => {
+		let i = t(e.slice(s, n), { labels: a }).trim();
+		s = n, i && !r.test(i) && o.push(i);
+	};
+	for (let t = 0; t < e.length; t++) {
+		let r = e[t];
+		if (!".!?…。！？।॥؟".includes(r)) continue;
+		let i = e[t + 1] ?? "";
+		r === "." && (/\d/.test(e[t - 1] ?? "") && (i === "" || /\d/.test(i)) || n.test(e.slice(s, t + 1)) || i === ".") || ".!?…".includes(r) && i !== "" && !/\s/.test(i) || i !== r && c(t + 1);
+	}
+	return i && s < e.length && c(e.length), o;
+}
+function s(t, n = !1) {
+	let r = t.slice(0, e).split("\n"), a = [], s = [], c = null, l = !1, u = (e) => {
+		l || a.push(...o(s.join("\n"), e)), s = [], l = !1;
+	};
+	for (let e = 0; e < r.length; e++) {
+		let t = r[e], a = /^\s*(`{3,}|~{3,})/.exec(t)?.[1];
+		if (c) {
+			a && a[0] === c[0] && a.length >= c.length && (c = null);
+			continue;
+		}
+		if (a) {
+			u(!0), c = a;
+			continue;
+		}
+		if (!t.trim()) {
+			u(!0);
+			continue;
+		}
+		(i.test(t) || t.includes("|") || /[[{]\s*"(?:tool|arguments|name)"\s*:/.test(t)) && (l = !0), s.push(t), e === r.length - 1 && u(n);
+	}
+	return a;
+}
+function c(e, t) {
+	let n = (e) => e.replace(/\s+/g, " ").trim(), r = n(e), i = n(t.filter(Boolean).join(" "));
+	if (!i) return {
+		text: r,
+		diverged: !1
+	};
+	if (r.startsWith(i)) return {
+		text: r.slice(i.length).trim(),
+		diverged: !1
+	};
+	for (let e = t.length - 1; e >= 0; e--) {
+		let i = n(t[e] ?? "");
+		if (!i) continue;
+		let a = r.lastIndexOf(i);
+		if (a >= 0) return {
+			text: r.slice(a + i.length).trim(),
+			diverged: !0
+		};
+	}
+	let a = new Set(t.map(n)), o = s(r, !0);
+	return {
+		text: o.length ? o.filter((e) => !a.has(n(e))).join(" ") : r,
+		diverged: !0
+	};
+}
+//#endregion
+export { s as phraseCandidates, c as unspokenFinal };

package/dist/shared/assistant/voice/phrasePlayback.d.ts

@@ -0,0 +1,9 @@
+import { SpeechQueue, SpeechSpeakHandlers } from '../speech/types';
+export interface PhrasePlayback {
+    append(text: string): void;
+    finish(final: string): void;
+    retract(): void;
+    cancel(): void;
+}
+/** One reply, one engine request. Buffer text only; synthesis stays one ahead. */
+export declare function createPhrasePlayback(open: (handlers: SpeechSpeakHandlers) => SpeechQueue, handlers: SpeechSpeakHandlers, changed: (chunks: readonly string[]) => void, divergence: () => void): PhrasePlayback;

package/dist/shared/assistant/voice/phrasePlayback.js

@@ -0,0 +1,78 @@
+import { MAX_SPEAKABLE_CHARS as e, chunkForSpeech as t } from "./speakableText.js";
+import { unspokenFinal as n } from "./phraseGate.js";
+//#region src/shared/assistant/voice/phrasePlayback.ts
+function r(r, i, a, o) {
+	let s = [], c = [], l = 0, u = !1, d = !1, f = !1, p = !1, m = !1, h = r({
+		onStart: () => {
+			p || i.onStart?.();
+		},
+		onChunkStart: (e) => {
+			p || i.onChunkStart?.(e);
+		},
+		onPause: () => {
+			p || i.onPause?.();
+		},
+		onDeviceFallback: () => {
+			p || i.onDeviceFallback?.();
+		},
+		onChunkEnd(e) {
+			p || (g(), i.onChunkEnd?.(e));
+		},
+		onRetract(e) {
+			if (!p) {
+				for (let t of e) s[t] = "";
+				a([...s]), i.onRetract?.(e);
+			}
+		},
+		onEnd() {
+			p || (p = !0, i.onEnd?.());
+		},
+		onError(e) {
+			p || (p = !0, c = [], i.onError?.(e));
+		}
+	});
+	function g() {
+		if (!(m || p)) {
+			m = !0;
+			try {
+				for (; c.length && !p && (d || !s.some(Boolean) || c.length > 1);) {
+					let e = c[0];
+					if (s.push(e), a([...s]), !h.append([e])) {
+						s.pop(), a([...s]);
+						break;
+					}
+					c.shift();
+				}
+				d && !c.length && !p && !f && (f = !0, h.end());
+			} finally {
+				m = !1;
+			}
+		}
+	}
+	let _ = (e) => t(e, void 0, void 0, { ...s.some(Boolean) ? { packFirstChunk: !0 } : { firstChunkMaxChars: 110 } });
+	return {
+		append(e) {
+			if (!(d || p || u)) {
+				if (l + e.length > 8e3) {
+					u = !0;
+					return;
+				}
+				l += e.length, c = _([...c, e].filter(Boolean).join(" ")), g();
+			}
+		},
+		finish(t) {
+			if (d || p) return;
+			d = !0;
+			let r = n(t.slice(0, e), [...s, ...c]);
+			r.diverged && o(), c = _([...c, r.text].filter(Boolean).join(" ")), g();
+		},
+		retract() {
+			d || p || (c = [], h.retract());
+		},
+		cancel() {
+			p = !0, c = [], h.cancel();
+		}
+	};
+}
+//#endregion
+export { r as createPhrasePlayback };

package/dist/shared/assistant/voice/phraseSpeechConfig.d.ts

@@ -0,0 +1,5 @@
+export declare function configurePhraseSpeech(options: {
+    enabled: boolean;
+    environment: string;
+} | null): void;
+export declare function phraseSpeechEnabled(): boolean;

package/dist/shared/assistant/voice/phraseSpeechConfig.js

@@ -0,0 +1,10 @@
+//#region src/shared/assistant/voice/phraseSpeechConfig.ts
+var e = !1;
+function t(t) {
+	e = t?.enabled === !0 && t.environment === "alpha";
+}
+function n() {
+	return e;
+}
+//#endregion
+export { t as configurePhraseSpeech, n as phraseSpeechEnabled };

package/dist/shared/assistant/voice/speakableText.d.ts

@@ -132,4 +132,5 @@ export declare function containsCjk(text: string): boolean;
  */
 export declare function chunkForSpeech(text: string, maxChars?: number, cjkMaxChars?: number, options?: {
     firstChunkMaxChars?: number;
+    packFirstChunk?: boolean;
 }): string[];

package/dist/shared/assistant/voice/speakableText.js

@@ -302,7 +302,7 @@ function ee(e, t = 180, n = 40, r = {}) {
 		let n = X(s, t), r = Math.min(c, e);
 		n.length <= r ? (s = n, c = r) : (o.push(s), s = t, c = e);
 	}
-	if (s && o.push(s), o.length > 1) {
+	if (s && o.push(s), o.length > 1 && !r.packFirstChunk) {
 		let e = W(o[0]);
 		if (e.length > 1) {
 			let [t, ...n] = e;

package/dist/shared/assistant/voice/voiceSession.d.ts

@@ -125,6 +125,11 @@ export type VoiceSessionEvent =
  | {
     type: 'reply-audio-started';
     replyId: string;
+    partial?: boolean;
+} | {
+    type: 'reply-audio-paused';
+} | {
+    type: 'reply-audio-ended';
 }
 /**
  * ★ BOFF-9207: the turn ended WITHOUT an answer - the assistant refused it

package/dist/shared/assistant/voice/voiceSession.js

@@ -158,13 +158,29 @@ function v(t, r, i = null) {
 			pending: "",
 			interim: ""
 		} : t;
-		case "reply-audio-started": return t.phase === "thinking" ? {
+		case "reply-audio-started": return r.partial && t.phase === "thinking" ? {
+			...t,
+			phase: "speaking",
+			pending: "",
+			interim: ""
+		} : t.phase === "thinking" ? {
 			...t,
 			...g,
 			phase: "speaking",
 			pending: "",
 			interim: ""
 		} : t;
+		case "reply-audio-paused": return t.phase === "speaking" ? {
+			...t,
+			phase: "thinking"
+		} : t;
+		case "reply-audio-ended": return t.phase === "thinking" || t.phase === "speaking" ? {
+			...t,
+			...g,
+			phase: "listening",
+			pending: "",
+			interim: ""
+		} : t;
 		case "turn-refused": return t.phase === "thinking" ? {
 			...t,
 			...g,