@burdenoff/fe-libs 2026.1029.6 → 2026.1029.8

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

@@ -10,6 +10,59 @@ function e(e) {
 		listVoices: () => e.listVoices(),
 		subscribeVoices: (t) => e.subscribeVoices(t),
 		cancel: n,
+		...e.open ? { open(r, i = {}) {
+			n();
+			let a = { handlers: i };
+			t = a;
+			let o = {
+				onStart: () => {
+					t === a && i.onStart?.();
+				},
+				onChunkStart: (e) => {
+					t === a && i.onChunkStart?.(e);
+				},
+				onChunkEnd: (e) => {
+					t === a && i.onChunkEnd?.(e);
+				},
+				onRetract: (e) => {
+					t === a && i.onRetract?.(e);
+				},
+				onPause: () => {
+					t === a && i.onPause?.();
+				},
+				onDeviceFallback: () => {
+					t === a && i.onDeviceFallback?.();
+				},
+				onEnd: () => {
+					t === a && (t = null, i.onEnd?.());
+				},
+				onError: (e) => {
+					t === a && (t = null, i.onError?.(e));
+				}
+			}, s;
+			try {
+				s = e.open(r, o);
+			} catch {
+				return o.onError?.("unknown"), {
+					append: () => !1,
+					end() {},
+					retract() {},
+					cancel() {}
+				};
+			}
+			return {
+				append: (e) => t === a && s.append(e),
+				end: () => {
+					t === a && s.end();
+				},
+				retract: () => {
+					t === a && s.retract();
+				},
+				cancel: () => {
+					t === a && n();
+				}
+			};
+		} } : {},
 		speak(r, i, a = {}) {
 			n();
 			let o = { handlers: a };

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

@@ -4,6 +4,7 @@ import { selectVoiceForLocale as n } from "../voice/speechVoices.js";
 //#region src/shared/assistant/speech/routingSpeechEngine.ts
 function r(e) {
 	switch (e) {
+		case "rate-limited":
 		case "cancelled":
 		case "output-not-cleared":
 		case "output-left": return !1;
@@ -15,11 +16,11 @@ function r(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, a = !1) => {
+	let o = null, s = new Set(a.listVoices().map((e) => e.name)), c = (e) => e.source === "hosted" || s.has(e.name), l = (e, t, r, a = !1) => {
 		let o = () => {
 			a && r?.onDeviceFallback?.();
 		};
-		if (!t.voice || !s(t.voice)) {
+		if (!t.voice || !c(t.voice)) {
 			o(), i.speak(e, t, r);
 			return;
 		}
@@ -27,16 +28,16 @@ function i({ device: i, hosted: a }) {
 			r?.onError?.("unsupported");
 			return;
 		}
-		let c = n(i.listVoices(), t.lang);
-		if (!c) {
+		let s = n(i.listVoices(), t.lang);
+		if (!s) {
 			r?.onError?.("unsupported");
 			return;
 		}
 		o(), i.speak(e, {
 			...t,
-			voice: c
+			voice: s
 		}, r);
-	}, l = (t) => a.isSupported() ? t.voice ? o.has(t.voice.name) ? a : i : e(t.lang) ? a : i : i;
+	}, u = (t) => a.isSupported() ? t.voice ? s.has(t.voice.name) ? a : i : e(t.lang) ? a : i : i;
 	return {
 		id: `routing(${a.id}+${i.id})`,
 		isSupported() {
@@ -51,45 +52,128 @@ function i({ device: i, hosted: a }) {
 				t(), n();
 			};
 		},
-		speak(e, n, o) {
-			if (i.cancel(), a.cancel(), l(n) !== a) {
-				c(e, n, o);
+		speak(e, n, s) {
+			if (o?.cancel(), o = null, i.cancel(), a.cancel(), u(n) !== a) {
+				l(e, n, s);
 				return;
 			}
-			let s = !1, u = -1;
+			let c = !1, d = -1;
 			a.speak(e, n, {
-				...o,
+				...s,
 				onStart: () => {
-					s = !0, o?.onStart?.();
+					c = !0, s?.onStart?.();
 				},
 				onChunkStart: (e) => {
-					u = e, o?.onChunkStart?.(e);
+					d = e, s?.onChunkStart?.(e);
 				},
 				onError: (i) => {
 					if (!r(i) || n.fallback === !1) {
-						o?.onError?.(i);
+						s?.onError?.(i);
 						return;
 					}
-					if (!s) {
-						c(e, n, o, !0);
+					if (!c) {
+						l(e, n, s, !0);
 						return;
 					}
-					let a = u >= 0 ? t(e).slice(u + 1) : [];
+					let a = d >= 0 ? t(e).slice(d + 1) : [];
 					if (a.length === 0) {
-						o?.onError?.(i);
+						s?.onError?.(i);
 						return;
 					}
-					let l = u + 1;
-					c(a, n, {
-						...o,
+					let o = d + 1;
+					l(a, n, {
+						...s,
 						onStart: void 0,
-						onChunkStart: (e) => o?.onChunkStart?.(l + e)
+						onChunkStart: (e) => s?.onChunkStart?.(o + e)
 					}, !0);
 				}
 			});
 		},
+		...i.open && a.open ? { open(e, t = {}) {
+			o?.cancel(), i.cancel(), a.cancel();
+			let s = u(e), l = !1, d = !1, f = !1, p = 0, m = [], h = [], g, _ = () => {
+				if (!e.voice || !c(e.voice)) return e;
+				if (e.fallback === !1) return null;
+				let t = n(i.listVoices(), e.lang);
+				return t ? {
+					...e,
+					voice: t
+				} : null;
+			}, v = (e) => {
+				d || (d = !0, h = [], t.onError?.(e));
+			}, y = {
+				...t,
+				onStart: () => {
+					d || (l = !0, h = [], t.onStart?.());
+				},
+				onChunkStart: (e) => {
+					if (d) return;
+					l = !0, h = [];
+					let n = m[e];
+					n !== void 0 && t.onChunkStart?.(n);
+				},
+				onChunkEnd: (e) => {
+					let n = m[e];
+					!d && n !== void 0 && t.onChunkEnd?.(n);
+				},
+				onRetract: (e) => {
+					let n = e.flatMap((e) => m[e] === void 0 ? [] : [m[e]]), r = new Set(n);
+					h = h.filter((e) => !r.has(e.index)), t.onRetract?.(n);
+				},
+				onPause: () => {
+					d || t.onPause?.();
+				},
+				onEnd: () => {
+					d || (d = !0, h = [], t.onEnd?.());
+				},
+				onError: (n) => {
+					if (d) return;
+					if (s === i || l || !r(n) || e.fallback === !1) {
+						v(n);
+						return;
+					}
+					let a = _();
+					if (!a || !i.open) {
+						v("unsupported");
+						return;
+					}
+					if (g.cancel(), s = i, m = h.map((e) => e.index), g = i.open(a, y), t.onDeviceFallback?.(), !g.append(h.map((e) => e.text))) {
+						v("unknown");
+						return;
+					}
+					f && g.end();
+				}
+			}, b = s === i ? _() : e;
+			if (!b || !s.open) return v("unsupported"), {
+				append: () => !1,
+				end: () => {},
+				retract: () => {},
+				cancel: () => {}
+			};
+			g = s.open(b, y);
+			let x = {
+				append(e) {
+					if (d || f) return !1;
+					let t = e.filter((e) => e.trim()), n = t.map((e, t) => ({
+						index: p + t,
+						text: e
+					})), r = m.length;
+					return m.push(...n.map((e) => e.index)), l || h.push(...n), g.append(t) ? (p += n.length, !0) : (m.splice(r), h = h.filter((e) => e.index < p), !1);
+				},
+				end() {
+					d || (f = !0, g.end());
+				},
+				retract() {
+					d || g.retract();
+				},
+				cancel() {
+					d || (d = !0, h = [], g.cancel());
+				}
+			};
+			return o = x, x;
+		} } : {},
 		cancel() {
-			i.cancel(), a.cancel();
+			o?.cancel(), o = null, i.cancel(), a.cancel();
 		}
 	};
 }

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

@@ -34,13 +34,25 @@ export interface SpeechFeedItem {
     text: string;
     /** The turn's reply language, stamped on the message as `metadata.lang`. */
     lang?: string | undefined;
-    /** Always true in C1: only a finished answer is published. */
-    final: true;
+    /** False only for opted-in S7 text already written to the live overlay. */
+    final: boolean;
 }
 export type SpeechFeedEvent = {
     type: 'publish';
     messageId: string;
     item: SpeechFeedItem;
+} | {
+    type: 'append';
+    messageId: string;
+    item: SpeechFeedItem;
+    phrases: readonly string[];
+} | {
+    type: 'retract';
+    messageId: string;
+} | {
+    type: 'audio';
+    messageId: string;
+    state: 'queued' | 'started' | 'paused' | 'ended';
 } | {
     type: 'abort';
     messageId: string;
@@ -48,6 +60,9 @@ export type SpeechFeedEvent = {
 type Listener = (event: SpeechFeedEvent) => void;
 export declare const speechFeed: {
     publish(messageId: string, item: SpeechFeedItem): void;
+    append(messageId: string, item: SpeechFeedItem, phrases: readonly string[]): void;
+    retract(messageId: string): void;
+    audio(messageId: string, state: "queued" | "started" | "paused" | "ended"): void;
     /** Forget a published message and tell the subscriber to stop speaking it. */
     abort(messageId: string): void;
     subscribe(listener: Listener): () => void;

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

@@ -5,17 +5,40 @@ function r(e) {
 		n(e);
 	} catch {}
 }
-var i = {
-	publish(t, i) {
-		for (n.delete(t), n.set(t, i); n.size > e;) {
-			let e = n.keys().next();
-			if (e.done) break;
-			n.delete(e.value);
-		}
-		r({
+function i(t, r) {
+	for (n.delete(t), n.set(t, r); n.size > e;) {
+		let e = n.keys().next();
+		if (e.done) break;
+		n.delete(e.value);
+	}
+}
+var a = {
+	publish(e, t) {
+		i(e, t), r({
 			type: "publish",
-			messageId: t,
-			item: i
+			messageId: e,
+			item: t
+		});
+	},
+	append(e, t, n) {
+		i(e, t), r({
+			type: "append",
+			messageId: e,
+			item: t,
+			phrases: n
+		});
+	},
+	retract(e) {
+		r({
+			type: "retract",
+			messageId: e
+		});
+	},
+	audio(e, t) {
+		r({
+			type: "audio",
+			messageId: e,
+			state: t
 		});
 	},
 	abort(e) {
@@ -33,8 +56,8 @@ var i = {
 		return n.get(e);
 	}
 };
-function a() {
+function o() {
 	t.clear(), n.clear();
 }
 //#endregion
-export { a as resetSpeechFeedForTest, i as speechFeed };
+export { o as resetSpeechFeedForTest, a as speechFeed };

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

@@ -157,8 +157,14 @@ export interface SpeechOutputRefusal {
  * played on the speakers. Only the live avatar's engine decorator reports it,
  * and nothing re-speaks it.
  */
-export type SpeechErrorReason = 'cancelled' | 'not-allowed' | 'unsupported' | 'unknown' | 'output-not-cleared' | 'output-left';
+export type SpeechErrorReason = 'rate-limited' | 'cancelled' | 'not-allowed' | 'unsupported' | 'unknown' | 'output-not-cleared' | 'output-left';
 export interface SpeechSpeakHandlers {
+    /** An open queue drained for now, but its producer has not ended it. */
+    onPause?: () => void;
+    /** Unplayed indices withdrawn by a tool start or a changed source message. */
+    onRetract?: (indices: readonly number[]) => void;
+    /** A piece finished; a bounded producer may append more. */
+    onChunkEnd?: (index: number) => void;
     /**
      * Audio has actually begun playing — not merely been requested.
      *
@@ -204,6 +210,8 @@ export interface SpeechSpeakHandlers {
     onDeviceFallback?: () => void;
 }
 export interface SpeechEngine {
+    /** Optional: engines/decorators without it retain completed-answer speech. */
+    open?(options: SpeechSpeakOptions, handlers?: SpeechSpeakHandlers): SpeechQueue;
     /** Stable id, for logging and for telling engines apart in a future swap. */
     readonly id: string;
     /** False when the platform has no usable speech output at all. */
@@ -226,3 +234,14 @@ export interface SpeechEngine {
      */
     wouldSpeakOnAvatar?(options: SpeechSpeakOptions): boolean;
 }
+/** One reply. Appends never pre-empt the piece currently playing. */
+export interface SpeechQueue {
+    /** False means full or terminal; a producer must retain its unaccepted text. */
+    append(chunks: readonly string[]): boolean;
+    /** No more appends; onEnd follows the last piece and confirmed drain. */
+    end(): void;
+    /** Drop queued/unplayed work while the sounding piece finishes. */
+    retract(): void;
+    /** Hard stop, including pending synthesis. No end event. */
+    cancel(): void;
+}

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

@@ -131,6 +131,9 @@ export interface TurnDimensions {
 }
 /** What one attempt found out. */
 export interface TurnAttemptFacts {
+    /** S7 local diagnostics only: no text and no new metric labels. */
+    spokeNarration?: boolean;
+    speechDivergence?: boolean;
     runtime?: TurnRuntime;
     /** The model called at least one tool on the way to its answer. */
     usedTools?: boolean;

package/dist/shared/assistant/turnTimeline.js

@@ -84,6 +84,7 @@ function m(e, t) {
 	let n = i.get(e);
 	if (!n) return;
 	let r = !1;
+	for (let e of ["spokeNarration", "speechDivergence"]) t[e] === !0 && n[e] !== !0 && (n[e] = !0, r = !0);
 	t.runtime !== void 0 && n.runtime === void 0 && (n.runtime = t.runtime, r = !0), t.usedTools !== void 0 && n.usedTools === void 0 && (n.usedTools = t.usedTools, r = !0), t.deadSandboxProbe !== void 0 && n.deadSandboxProbe === void 0 && (n.deadSandboxProbe = t.deadSandboxProbe, r = !0), t.cacheProofFailed !== void 0 && n.cacheProofFailed === void 0 && (n.cacheProofFailed = t.cacheProofFailed, r = !0), t.prewarm !== void 0 && n.prewarm === void 0 && (n.prewarm = t.prewarm, r = !0), t.transport !== void 0 && n.transport === void 0 && (n.transport = t.transport, r = !0), t.live !== void 0 && n.live === void 0 && (n.live = t.live, r = !0), t.session !== void 0 && n.session === void 0 && (n.session = t.session, r = !0), t.outcome !== void 0 && n.outcome === void 0 && (n.outcome = t.outcome, r = !0), r && d(n);
 }
 function h(e, n = c()) {
@@ -97,7 +98,9 @@ function h(e, n = c()) {
 		let t = r.at[e];
 		t !== void 0 && (a.at[e] = t, delete r.at[e]);
 	}
-	r.runtime !== void 0 && (a.runtime = r.runtime), r.usedTools !== void 0 && (a.usedTools = r.usedTools), r.deadSandboxProbe !== void 0 && (a.deadSandboxProbe = r.deadSandboxProbe), r.cacheProofFailed !== void 0 && (a.cacheProofFailed = r.cacheProofFailed), r.prewarm !== void 0 && (a.prewarm = r.prewarm), r.transport !== void 0 && (a.transport = r.transport), r.live !== void 0 && (a.live = r.live), r.session !== void 0 && (a.session = r.session), delete r.transport, delete r.live, delete r.session, delete r.runtime, delete r.usedTools, delete r.deadSandboxProbe, delete r.cacheProofFailed, delete r.prewarm, r.attempts = [...r.attempts ?? [], a], r.retried = !0, d(r);
+	r.runtime !== void 0 && (a.runtime = r.runtime), r.usedTools !== void 0 && (a.usedTools = r.usedTools), r.deadSandboxProbe !== void 0 && (a.deadSandboxProbe = r.deadSandboxProbe), r.cacheProofFailed !== void 0 && (a.cacheProofFailed = r.cacheProofFailed), r.prewarm !== void 0 && (a.prewarm = r.prewarm), r.transport !== void 0 && (a.transport = r.transport), r.live !== void 0 && (a.live = r.live), r.session !== void 0 && (a.session = r.session);
+	for (let e of ["spokeNarration", "speechDivergence"]) r[e] !== void 0 && (a[e] = r[e]), delete r[e];
+	delete r.transport, delete r.live, delete r.session, delete r.runtime, delete r.usedTools, delete r.deadSandboxProbe, delete r.cacheProofFailed, delete r.prewarm, r.attempts = [...r.attempts ?? [], a], r.retried = !0, d(r);
 }
 function g(e) {
 	let t = i.get(e);