@burdenoff/fe-libs 2026.1029.6 → 2026.1029.7

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);