@burdenoff/fe-libs 2026.1029.2 → 2026.1029.3

package/dist/shared/assistant/ui/useVoiceSession.js

@@ -15,57 +15,67 @@ import { useCallback as o, useEffect as s, useLayoutEffect as be, useMemo as xe,
 //#region src/shared/assistant/ui/useVoiceSession.ts
 var Ce = 4e3, we = 2500, Te = 5e3, Ee = 12e3;
 function De({ onSubmit: De, latestReply: u, language: d, graceMs: Oe, onSupersede: ke, handsFreeInterrupt: Ae, handsFreeStreamNoticeAccepted: je, onAcceptHandsFreeStreamNotice: Me, onBargeIn: Ne }) {
-	let f = n(Oe), p = c(null), [m, h] = Se(o((e, t) => me(e, t, p.current), []), ie), g = ve(), { setSessionSpeaking: _, setSessionMicOpen: v, speakingMessageId: y, stop: b } = g, x = c(g.toggle), Pe = g.toggle;
+	let f = n(Oe), p = c(null), [m, h] = Se(o((e, t) => me(e, t, p.current), []), ie), g = ve(), { setSessionSpeaking: _, setSessionMicOpen: v, speakingMessageId: y, stop: b } = g, Pe = c(g.toggle), Fe = g.toggle;
 	be(() => {
-		x.current = Pe;
-	}, [Pe]);
-	let S = c(null), C = c({}), w = c(oe), T = c(void 0), E = c(void 0);
+		Pe.current = Fe;
+	}, [Fe]);
+	let x = c(null), S = c({}), C = c(oe), w = c(void 0), T = c(void 0), E = c(0), D = c(void 0), O = c(/* @__PURE__ */ new Map()), Ie = c(void 0);
 	s(() => {
-		(m.phase === "idle" || m.phase === "ended") && (T.current = void 0, E.current = void 0);
-	}, [m.phase]);
-	let D = c(null), O = c(!1), k = c(null), [Fe, A] = l(null), [j, M] = l(!1), [Ie, N] = l(!1), [P, F] = l(!1), I = c(m);
-	I.current = m;
-	let L = c([]), R = c(null), z = c(!1), B = o(() => {
-		L.current = [], R.current = null, z.current = !1;
-	}, []), V = o(() => {
+		let e = m.correctionTimingDecision;
+		if (e && e !== Ie.current) {
+			Ie.current = e;
+			for (let [t, n] of O.current) e.accepted && t >= e.candidateId && (w.current = n.lastSpeechFrame ?? w.current, T.current = n.recognizerSpeechEnded ?? T.current), (e.accepted || t <= e.candidateId) && O.current.delete(t);
+			D.current !== void 0 && D.current <= e.candidateId && (D.current = void 0);
+		}
+		(m.phase !== "thinking" || m.muted) && (O.current.clear(), D.current = void 0), (m.phase === "idle" || m.phase === "ended") && (w.current = void 0, T.current = void 0);
+	}, [
+		m.phase,
+		m.muted,
+		m.correctionTimingDecision
+	]);
+	let k = c(null), A = c(!1), Le = c(null), [Re, j] = l(null), [M, N] = l(!1), [ze, P] = l(!1), [F, I] = l(!1), L = c(m);
+	L.current = m;
+	let R = c([]), z = c(null), B = c(!1), V = o(() => {
+		R.current = [], z.current = null, B.current = !1;
+	}, []), H = o(() => {
 		for (;;) {
-			let e = L.current.shift();
+			let e = R.current.shift();
 			if (!e) return !1;
 			if (!(e.stillWanted && !e.stillWanted())) {
-				R.current = e, p.current = p.current ? `${p.current} ${e.text}` : e.text;
+				z.current = e, p.current = p.current ? `${p.current} ${e.text}` : e.text;
 				try {
-					x.current(e.id, e.text, e.lang);
+					Pe.current(e.id, e.text, e.lang);
 				} catch {
-					R.current = null;
+					z.current = null;
 					continue;
 				}
 				return !0;
 			}
 		}
-	}, []), H = c(!1), Le = o((e) => {
+	}, []), U = c(!1), Be = o((e) => {
 		let t = ue({
 			requested: e,
-			held: H.current,
-			muted: I.current.muted
+			held: U.current,
+			muted: L.current.muted
 		});
-		H.current = t.held, t.mute !== null && h({
+		U.current = t.held, t.mute !== null && h({
 			type: "mute",
 			muted: t.mute
 		});
-	}, []), U = o((e) => {
-		let t = fe(I.current);
-		t !== "drop" && (R.current?.id === e.id || L.current.some((t) => t.id === e.id) || (L.current.push(e), t === "start" && !z.current && (z.current = !0, h({ type: "announce" }))));
-	}, []), Re = o((e) => {
-		if (I.current.phase !== "thinking") {
-			U(e);
+	}, []), W = o((e) => {
+		let t = fe(L.current);
+		t !== "drop" && (z.current?.id === e.id || R.current.some((t) => t.id === e.id) || (R.current.push(e), t === "start" && !B.current && (B.current = !0, h({ type: "announce" }))));
+	}, []), Ve = o((e) => {
+		if (L.current.phase !== "thinking") {
+			W(e);
 			return;
 		}
-		L.current.push(e), z.current = !0, h({ type: "answered-locally" });
-	}, [U]), ze = c(u);
-	ze.current = u, s(() => {
+		R.current.push(e), B.current = !0, h({ type: "answered-locally" });
+	}, [W]), He = c(u);
+	He.current = u, s(() => {
 		if (m.phase === "speaking") {
-			let e = k.current;
-			p.current = e && D.current === e.id && u?.id !== e.id ? e.text : u?.text ?? null;
+			let e = Le.current;
+			p.current = e && k.current === e.id && u?.id !== e.id ? e.text : u?.text ?? null;
 			return;
 		}
 		if (p.current === null) return;
@@ -74,68 +84,82 @@ function De({ onSubmit: De, latestReply: u, language: d, graceMs: Oe, onSupersed
 		}, we);
 		return () => clearTimeout(e);
 	}, [m.phase, u]);
-	let W = c(d);
-	W.current = d;
-	let G = o((e, t) => {
+	let G = c(d);
+	G.current = d;
+	let Ue = o((e, t) => {
+		let n = L.current;
+		if (!n.muted) if (n.phase === "thinking") {
+			e === "lastSpeechFrame" && (D.current = void 0);
+			let n = D.current ?? E.current, r = O.current.get(n) ?? {};
+			r[e] = t, O.current.set(n, r);
+		} else n.phase === "listening" && (e === "lastSpeechFrame" ? w.current = t : T.current = t);
+	}, []), K = o((e) => {
+		let t = L.current;
+		if (t.phase !== "thinking" || t.muted) return;
+		let n = E.current;
+		return e && (D.current = n, E.current += 1), n;
+	}, []), q = o((e, t) => {
 		h({
 			type: "speech",
 			transcript: e,
 			final: t,
 			at: Date.now(),
-			language: W.current
+			language: G.current,
+			timingCandidateId: K(t)
 		});
-	}, []), Be = o((e, t, n) => {
+	}, [K]), We = o((e, t, n) => {
 		h({
 			type: "speech",
 			transcript: e,
 			final: t,
 			at: Date.now(),
-			language: n ?? W.current,
-			gated: !0
+			language: n ?? G.current,
+			gated: !0,
+			timingCandidateId: K(t)
 		});
-	}, []), K = c(0), Ve = o(() => {
-		B(), b(), K.current = Date.now(), M(!0), h({ type: "interrupt" });
-	}, [b, B]), q = e({
-		onFinalize: o((e) => G(e, !0), [G]),
+	}, [K]), J = c(0), Ge = o(() => {
+		V(), b(), J.current = Date.now(), N(!0), h({ type: "interrupt" });
+	}, [b, V]), Y = e({
+		onFinalize: o((e) => q(e, !0), [q]),
 		language: d,
 		onSpeechEnd: (e) => {
-			I.current.phase === "listening" && (E.current = e);
+			Ue("recognizerSpeechEnded", e);
 		}
-	}), He = c(Ne);
-	He.current = Ne;
-	let Ue = o(() => {
-		B(), te(), b(), K.current = Date.now(), M(!0), h({ type: "interrupt" }), He.current?.();
-	}, [b, B]), We = ye(), J = he({
-		enabled: ee(Ae, r(), We),
+	}), Ke = c(Ne);
+	Ke.current = Ne;
+	let qe = o(() => {
+		V(), te(), b(), J.current = Date.now(), N(!0), h({ type: "interrupt" }), Ke.current?.();
+	}, [b, V]), Je = ye(), X = he({
+		enabled: ee(Ae, r(), Je),
 		phase: m.phase,
 		muted: m.muted,
 		language: d,
 		streamNoticeAccepted: je ?? null,
 		onAcceptStreamNotice: Me,
-		onBargeIn: Ue,
-		onTranscript: Be,
+		onBargeIn: qe,
+		onTranscript: We,
 		onSpeechFrame: (e) => {
-			I.current.phase === "listening" && !I.current.muted && (T.current = e);
+			Ue("lastSpeechFrame", e);
 		}
-	}), Ge = J.mode === "notice", Y = q.isListening || J.suppressWebSpeech && J.mode === "active";
+	}), Ye = X.mode === "notice", Z = Y.isListening || X.suppressWebSpeech && X.mode === "active";
 	s(() => {
-		q.interim && G(q.interim, !1);
-	}, [q.interim, G]), s(() => {
-		S.current && clearTimeout(S.current), N(!1), w.current = se(w.current, m, a());
+		Y.interim && q(Y.interim, !1);
+	}, [Y.interim, q]), s(() => {
+		x.current && clearTimeout(x.current), P(!1), C.current = se(C.current, m, a());
 		let e = t({
 			phase: m.phase,
 			muted: m.muted,
 			spoken: i(m),
-			holding: P,
+			holding: F,
 			graceMs: f
 		});
 		if (!e.arm) return;
-		let n = setTimeout(() => N(!0), Math.min(800, e.delayMs)), r = a();
-		return S.current = setTimeout(() => {
-			C.current = {
-				speechEnded: w.current.at ?? r,
-				lastSpeechFrame: T.current,
-				recognizerSpeechEnded: E.current,
+		let n = setTimeout(() => P(!0), Math.min(800, e.delayMs)), r = a();
+		return x.current = setTimeout(() => {
+			S.current = {
+				speechEnded: C.current.at ?? r,
+				lastSpeechFrame: w.current,
+				recognizerSpeechEnded: T.current,
 				selectedGraceMs: f,
 				graceStarted: r,
 				graceEnded: a()
@@ -144,28 +168,28 @@ function De({ onSubmit: De, latestReply: u, language: d, graceMs: Oe, onSupersed
 				at: Date.now()
 			});
 		}, e.delayMs), () => {
-			clearTimeout(n), S.current && clearTimeout(S.current);
+			clearTimeout(n), x.current && clearTimeout(x.current);
 		};
 	}, [
 		m,
-		P,
+		F,
 		f
 	]), s(() => {
-		(m.phase !== "listening" || m.muted) && F(!1);
+		(m.phase !== "listening" || m.muted) && I(!1);
 	}, [m.phase, m.muted]), s(() => {
-		if (!j) return;
-		let e = Date.now() - K.current, t = Y ? Math.max(0, 500 - e) : Math.max(0, ae - e), n = setTimeout(() => M(!1), t);
+		if (!M) return;
+		let e = Date.now() - J.current, t = Z ? Math.max(0, 500 - e) : Math.max(0, ae - e), n = setTimeout(() => N(!1), t);
 		return () => clearTimeout(n);
-	}, [j, Y]);
-	let Ke = c("");
-	m.phase === "listening" && (Ke.current = i(m)), s(() => {
+	}, [M, Z]);
+	let Xe = c("");
+	m.phase === "listening" && (Xe.current = i(m)), s(() => {
 		if (m.phase !== "thinking") return;
-		v(!1), B(), A((e) => typeof e == "object" && e ? null : e);
-		let e = Ke.current.trim();
-		e && De(e, Q.current ?? `vs-orphan-${Date.now().toString(36)}`, C.current, { correction: I.current.correcting }), C.current = {}, w.current = oe, T.current = void 0, E.current = void 0;
+		v(!1), V(), j((e) => typeof e == "object" && e ? null : e);
+		let e = Xe.current.trim();
+		e && De(e, $.current ?? `vs-orphan-${Date.now().toString(36)}`, S.current, { correction: L.current.correcting }), S.current = {}, C.current = oe, w.current = void 0, T.current = void 0;
 	}, [m.phase]), s(() => {
-		let e = de(u?.id, m.phase, D.current, ge(u?.id));
-		e.claim && (D.current = u?.id ?? null, e.advance && u && (u.refused ? (B(), A({
+		let e = de(u?.id, m.phase, k.current, ge(u?.id));
+		e.claim && (k.current = u?.id ?? null, e.advance && u && (u.refused ? (V(), j({
 			kind: "turn-refused",
 			text: u.text
 		}), h({ type: "turn-refused" })) : h({
@@ -175,15 +199,15 @@ function De({ onSubmit: De, latestReply: u, language: d, graceMs: Oe, onSupersed
 	}, [
 		u,
 		m.phase,
-		B
+		V
 	]), s(() => {
-		if (y === null || m.phase !== "thinking" || D.current === y) return;
+		if (y === null || m.phase !== "thinking" || k.current === y) return;
 		if (ge(y)) {
 			b();
 			return;
 		}
 		let e = re.peek(y);
-		!e || e.channel !== "voice" || e.voiceSessionId === void 0 || e.voiceSessionId !== Q.current || (D.current = y, k.current = {
+		!e || e.channel !== "voice" || e.voiceSessionId === void 0 || e.voiceSessionId !== $.current || (k.current = y, Le.current = {
 			id: y,
 			text: e.text
 		}, h({
@@ -196,74 +220,74 @@ function De({ onSubmit: De, latestReply: u, language: d, graceMs: Oe, onSupersed
 		b
 	]), s(() => {
 		let e = y !== null;
-		O.current && !e && (R.current = null, (I.current.phase !== "speaking" || !V()) && h({ type: "speech-ended" })), O.current = e;
-	}, [y, V]), s(() => {
-		m.phase !== "listening" && A((e) => e === "nothing-heard" ? null : e);
+		A.current && !e && (z.current = null, (L.current.phase !== "speaking" || !H()) && h({ type: "speech-ended" })), A.current = e;
+	}, [y, H]), s(() => {
+		m.phase !== "listening" && j((e) => e === "nothing-heard" ? null : e);
 	}, [m.phase]), s(() => {
 		if (m.phase !== "speaking" || y !== null) return;
 		let e = setTimeout(() => {
-			O.current || (B(), h({ type: "speech-ended" }));
+			A.current || (V(), h({ type: "speech-ended" }));
 		}, Ce);
 		return () => clearTimeout(e);
 	}, [
 		m.phase,
 		y,
-		B
+		V
 	]);
-	let X = g.outputNotCleared;
+	let Q = g.outputNotCleared;
 	s(() => {
-		if (X === null || D.current !== X.messageId) return;
-		let { phase: e } = I.current;
-		e === "idle" || e === "ended" || e === "thinking" || A("reply-not-heard");
-	}, [X]), s(() => {
-		m.phase === "listening" || m.phase === "thinking" || A((e) => e === "reply-not-heard" ? null : e);
+		if (Q === null || k.current !== Q.messageId) return;
+		let { phase: e } = L.current;
+		e === "idle" || e === "ended" || e === "thinking" || j("reply-not-heard");
+	}, [Q]), s(() => {
+		m.phase === "listening" || m.phase === "thinking" || j((e) => e === "reply-not-heard" ? null : e);
 	}, [m.phase]);
-	let Z = c(ke);
-	Z.current = ke;
-	let qe = c(0);
+	let Ze = c(ke);
+	Ze.current = ke;
+	let Qe = c(0);
 	s(() => {
 		let e = m.superseded;
-		e !== qe.current && (qe.current = e, e !== 0 && (B(), b(), Z.current?.()));
+		e !== Qe.current && (Qe.current = e, e !== 0 && (V(), b(), Ze.current?.()));
 	}, [
 		m.superseded,
-		B,
+		V,
 		b
 	]), s(() => {
-		v(ce(m)), pe(m) && !J.suppressWebSpeech ? q.isActive || q.start("auto") : q.isActive && q.stop();
+		v(ce(m)), pe(m) && !X.suppressWebSpeech ? Y.isActive || Y.start("auto") : Y.isActive && Y.stop();
 	}, [
 		m,
-		q,
+		Y,
 		v,
-		J.suppressWebSpeech
+		X.suppressWebSpeech
 	]), s(() => {
-		m.phase !== "speaking" || !z.current || (z.current = !1, V() || h({ type: "speech-ended" }));
-	}, [m.phase, V]), s(() => {
-		q.error === "not-allowed" || q.error === "audio-capture" ? h({
+		m.phase !== "speaking" || !B.current || (B.current = !1, H() || h({ type: "speech-ended" }));
+	}, [m.phase, H]), s(() => {
+		Y.error === "not-allowed" || Y.error === "audio-capture" ? h({
 			type: "fail",
 			error: "mic-denied"
-		}) : q.error === "language-not-supported" ? h({
+		}) : Y.error === "language-not-supported" ? h({
 			type: "fail",
 			error: "no-speech-support"
-		}) : q.error === "network" ? A("network") : q.error === "unknown" && A("recognition-failed");
-	}, [q.error]), s(() => {
-		q.error !== null || !Y || A((e) => e === "network" || e === "recognition-failed" ? null : e);
-	}, [q.error, Y]), s(() => {
-		if (Y && A((e) => e === "not-capturing" ? null : e), !ce(m) || Y || Ge) return;
-		let e = setTimeout(() => A("not-capturing"), Te);
+		}) : Y.error === "network" ? j("network") : Y.error === "unknown" && j("recognition-failed");
+	}, [Y.error]), s(() => {
+		Y.error !== null || !Z || j((e) => e === "network" || e === "recognition-failed" ? null : e);
+	}, [Y.error, Z]), s(() => {
+		if (Z && j((e) => e === "not-capturing" ? null : e), !ce(m) || Z || Ye) return;
+		let e = setTimeout(() => j("not-capturing"), Te);
 		return () => clearTimeout(e);
 	}, [
 		m,
-		Y,
-		Ge
+		Z,
+		Ye
 	]), s(() => {
-		if (m.phase !== "listening" || m.muted || !Y || i(m) !== "") return;
-		let e = setTimeout(() => A("nothing-heard"), Ee);
+		if (m.phase !== "listening" || m.muted || !Z || i(m) !== "") return;
+		let e = setTimeout(() => j("nothing-heard"), Ee);
 		return () => clearTimeout(e);
-	}, [m, Y]), s(() => {
-		i(m) !== "" && A(null);
+	}, [m, Z]), s(() => {
+		i(m) !== "" && j(null);
 	}, [m]);
-	let Q = c(null), Je = o(() => {
-		if (M(!1), N(!1), F(!1), B(), H.current = !1, !q.isSupported) {
+	let $ = c(null), $e = o(() => {
+		if (N(!1), P(!1), I(!1), V(), U.current = !1, !Y.isSupported) {
 			h({
 				type: "fail",
 				error: "no-speech-support"
@@ -284,30 +308,30 @@ function De({ onSubmit: De, latestReply: u, language: d, graceMs: Oe, onSupersed
 				t.volume = 0, e.speak(t);
 			}
 		} catch {}
-		ne(), _(!0), A(null), D.current = ze.current?.id ?? null, k.current = null, Q.current = `vs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`, h({ type: "start" });
+		ne(), _(!0), j(null), k.current = He.current?.id ?? null, Le.current = null, $.current = `vs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`, h({ type: "start" });
 	}, [
-		q.isSupported,
+		Y.isSupported,
 		g.isBlocked,
 		_,
-		B
-	]), Ye = o(() => {
-		M(!1), N(!1), F(!1), B(), H.current = !1, Q.current = null, h({ type: "end" }), b(), _(!1);
+		V
+	]), et = o(() => {
+		N(!1), P(!1), I(!1), V(), U.current = !1, $.current = null, h({ type: "end" }), b(), _(!1);
 	}, [
 		b,
 		_,
-		B
-	]), Xe = o((e) => Q.current === e, []), Ze = o(() => {
-		let e = I.current;
-		e.phase !== "listening" || e.muted || F(!0);
-	}, []), Qe = o(() => {
-		F(!1);
-		let e = I.current;
+		V
+	]), tt = o((e) => $.current === e, []), nt = o(() => {
+		let e = L.current;
+		e.phase !== "listening" || e.muted || I(!0);
+	}, []), rt = o(() => {
+		I(!1);
+		let e = L.current;
 		if (e.phase !== "listening" || e.muted || !le(i(e))) return;
 		let t = a();
-		C.current = {
-			speechEnded: w.current.at ?? t,
-			lastSpeechFrame: T.current,
-			recognizerSpeechEnded: E.current,
+		S.current = {
+			speechEnded: C.current.at ?? t,
+			lastSpeechFrame: w.current,
+			recognizerSpeechEnded: T.current,
 			selectedGraceMs: f,
 			graceStarted: t,
 			graceEnded: t
@@ -315,69 +339,69 @@ function De({ onSubmit: De, latestReply: u, language: d, graceMs: Oe, onSupersed
 			type: "silence",
 			at: Date.now()
 		});
-	}, [f]), $e = o(() => {
+	}, [f]), it = o(() => {
 		h({
 			type: "mute",
-			muted: !I.current.muted
+			muted: !L.current.muted
 		});
 	}, []);
 	s(() => () => {
 		_(!1), v(!1);
 	}, [_, v]);
-	let $ = _e(g.spokenChunks, m.phase, y);
+	let at = _e(g.spokenChunks, m.phase, y);
 	return xe(() => ({
 		session: m,
-		notice: Fe ?? (J.fallbackReason !== null && J.fallbackReason !== "notice-declined" ? "hands-free-fallback" : J.nothingHeard ? "hands-free-nothing-heard" : null),
-		spokenChunks: $,
-		capturing: Y,
+		notice: Re ?? (X.fallbackReason !== null && X.fallbackReason !== "notice-declined" ? "hands-free-fallback" : X.nothingHeard ? "hands-free-nothing-heard" : null),
+		spokenChunks: at,
+		capturing: Z,
 		active: m.phase !== "idle" && (m.phase !== "ended" || m.error !== null),
-		interrupting: j,
-		awaitingEndpoint: Ie,
-		holding: P,
+		interrupting: M,
+		awaitingEndpoint: ze,
+		holding: F,
 		correcting: m.correcting,
 		handsFree: {
-			mode: J.mode,
-			nothingHeard: J.nothingHeard,
-			transportKind: J.transportKind,
-			fallbackReason: J.fallbackReason,
-			privacyNotice: J.privacyNotice
+			mode: X.mode,
+			nothingHeard: X.nothingHeard,
+			transportKind: X.transportKind,
+			fallbackReason: X.fallbackReason,
+			privacyNotice: X.privacyNotice
 		},
-		available: q.isSupported && !g.isBlocked,
-		start: Je,
-		end: Ye,
-		isCurrentSession: Xe,
-		toggleMute: $e,
-		interrupt: Ve,
-		letMeFinish: Ze,
-		imDone: Qe,
-		announce: U,
-		holdListening: Le,
-		answerLocally: Re
+		available: Y.isSupported && !g.isBlocked,
+		start: $e,
+		end: et,
+		isCurrentSession: tt,
+		toggleMute: it,
+		interrupt: Ge,
+		letMeFinish: nt,
+		imDone: rt,
+		announce: W,
+		holdListening: Be,
+		answerLocally: Ve
 	}), [
 		m,
-		Fe,
-		j,
-		Ie,
-		P,
-		Y,
-		J.mode,
-		J.nothingHeard,
-		J.transportKind,
-		J.fallbackReason,
-		J.privacyNotice,
-		q.isSupported,
+		Re,
+		M,
+		ze,
+		F,
+		Z,
+		X.mode,
+		X.nothingHeard,
+		X.transportKind,
+		X.fallbackReason,
+		X.privacyNotice,
+		Y.isSupported,
 		g.isBlocked,
-		$,
-		Je,
-		Ye,
-		Xe,
+		at,
 		$e,
-		Ve,
-		Ze,
-		Qe,
-		U,
-		Le,
-		Re
+		et,
+		tt,
+		it,
+		Ge,
+		nt,
+		rt,
+		W,
+		Be,
+		Ve
 	]);
 }
 //#endregion

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

@@ -68,6 +68,11 @@ export interface VoiceSessionSnapshot {
      * doing anything impure. Reset by `start`.
      */
     superseded: number;
+    /** Timing-only receipt; the hook keeps acoustic samples until classification finishes. */
+    correctionTimingDecision?: {
+        candidateId: number;
+        accepted: boolean;
+    };
 }
 /**
  * Deliberately does NOT include a "playback blocked" variant. Nothing can
@@ -98,6 +103,8 @@ export type VoiceSessionEvent =
      * leakage. Absent for the Web Speech path, whose audio is not vetted.
      */
     gated?: boolean;
+    /** Identifies pending acoustic timing, without putting per-frame updates in React state. */
+    timingCandidateId?: number;
 }
 /** Nothing heard for the person's grace (`resolveVoiceGraceMs`). */
  | {

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

@@ -119,7 +119,16 @@ function v(t, r, i = null) {
 		} : t;
 		case "speech": {
 			if (t.muted) return t;
-			if (t.phase === "thinking") return _(t, r, i);
+			if (t.phase === "thinking") {
+				let e = _(t, r, i);
+				return r.timingCandidateId !== void 0 && (e !== t || r.final) ? {
+					...e,
+					correctionTimingDecision: {
+						candidateId: r.timingCandidateId,
+						accepted: e !== t
+					}
+				} : e;
+			}
 			if (t.phase !== "listening" || !r.gated && p(r.transcript, i)) return t;
 			let a = t.correcting ? n(r.transcript, t.submitted) : r.transcript;
 			if (t.correcting && a === "") return t;