@burdenoff/fe-libs 2026.1004.4 → 2026.1004.5

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

@@ -0,0 +1,29 @@
+/**
+ * The turns a person has superseded — the stale-turn guard of hands-free
+ * corrections (H2).
+ *
+ * When someone speaks a correction while the assistant is still PREPARING an
+ * answer, the in-flight turn is aborted (`POST /sessions/:id/abort`) and then
+ * recorded here. Aborting is best-effort and asynchronous, so the old turn can
+ * still deliver something afterwards: its reply landing, its speech starting
+ * from the speech feed, its text becoming the "latest reply" the caption and
+ * the echo reference are built from. Every one of those paths asks THIS module
+ * whether the message belongs to a turn that was superseded, and refuses if so:
+ * the late answer never restarts audio, never replaces a caption and never
+ * advances the next turn.
+ *
+ * ★ Module scope on purpose, like `speechFeed`: the publisher (the chat area),
+ * the speaker (the speech provider) and the voice session are three components
+ * that do not know each other, and the guard has to hold across a remount.
+ *
+ * ★ Bounded. A session is a handful of turns; the oldest ids are dropped first
+ * so a long-lived page cannot grow this without limit, and an id this old can
+ * no longer be in flight.
+ */
+/** Record that the turn that produced assistant message `messageId` was superseded. */
+export declare function markTurnSuperseded(messageId: string): void;
+/** Was the turn behind `messageId` superseded? Null and undefined never were. */
+export declare function isTurnSuperseded(messageId: string | null | undefined): boolean;
+/** Tests only. */
+export declare function resetSupersededTurnsForTest(): void;
+//# sourceMappingURL=supersededTurns.d.ts.map

package/dist/shared/assistant/voice/supersededTurns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersededTurns.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/supersededTurns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAQ1D;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE9E;AAED,kBAAkB;AAClB,wBAAgB,2BAA2B,IAAI,IAAI,CAElD"}

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

@@ -0,0 +1,17 @@
+//#region src/shared/assistant/voice/supersededTurns.ts
+var e = 64, t = /* @__PURE__ */ new Set();
+function n(n) {
+	for (t.delete(n), t.add(n); t.size > e;) {
+		let e = t.values().next();
+		if (e.done) break;
+		t.delete(e.value);
+	}
+}
+function r(e) {
+	return typeof e == "string" && t.has(e);
+}
+function i() {
+	t.clear();
+}
+//#endregion
+export { r as isTurnSuperseded, n as markTurnSuperseded, i as resetSupersededTurnsForTest };

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

@@ -31,6 +31,13 @@
  *  - **`stop()` resolves the final transcript** through `onFinalize`, so the
  *    composer can commit exactly once when the user stops.
  */
+/**
+ * Can this browser recognise speech at all? The same test `useVoiceInput`
+ * reports as `isSupported`, for surfaces that must decide whether to OFFER a
+ * voice setting without mounting the hook (a settings row for a recogniser
+ * that does not exist is a control that cannot do anything).
+ */
+export declare function isSpeechRecognitionSupported(): boolean;
 /**
  * How long to refuse a restart after `recognition.start()` THREW.
  *

package/dist/shared/assistant/voice/useVoiceInput.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVoiceInput.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/useVoiceInput.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AA+DH;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAW5C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED,MAAM,MAAM,eAAe,GACzB,aAAa,GAAG,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,wBAAwB,GAAG,SAAS,CAAC;AA+BnG,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,uEAAuE;IACvE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,oBAAoB,GAAG,mBAAmB,CAmO5G"}
+{"version":3,"file":"useVoiceInput.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/useVoiceInput.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AA+DH;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAW5C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED,MAAM,MAAM,eAAe,GACzB,aAAa,GAAG,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,wBAAwB,GAAG,SAAS,CAAC;AA+BnG,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,uEAAuE;IACvE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,oBAAoB,GAAG,mBAAmB,CAmO5G"}

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

@@ -17,11 +17,14 @@ function o() {
 	let e = window;
 	return e.SpeechRecognition ?? e.webkitSpeechRecognition ?? null;
 }
-var s = 2e3, c = 2;
-function l(e, t) {
-	return t - e < s;
+function s() {
+	return o() !== null;
 }
-function u(e) {
+var c = 2e3, l = 2;
+function u(e, t) {
+	return t - e < c;
+}
+function d(e) {
 	switch (e) {
 		case "not-allowed":
 		case "service-not-allowed": return "not-allowed";
@@ -32,18 +35,18 @@ function u(e) {
 		default: return "unknown";
 	}
 }
-function d({ onFinalize: s, language: d }) {
+function f({ onFinalize: s, language: c }) {
 	let { locale: f } = e(), [p, m] = i(!1), [h, g] = i(!1), [_, v] = i(""), [y, b] = i(null), x = r(null), S = r(0), C = r(-Infinity), w = r(0), T = r(s);
 	n(() => {
 		T.current = s;
 	}, [s]);
-	let E = o() !== null, D = d ?? a[f] ?? "en-US";
+	let E = o() !== null, D = c ?? a[f] ?? "en-US";
 	n(() => () => {
 		x.current?.abort(), x.current = null;
 	}, []);
 	let O = t((e = "manual") => {
 		let t = o();
-		if (!t || x.current || e === "auto" && l(C.current, performance.now())) return;
+		if (!t || x.current || e === "auto" && u(C.current, performance.now())) return;
 		let n = new t();
 		n.continuous = !0, n.interimResults = !0, n.lang = D;
 		let r = S.current;
@@ -57,7 +60,7 @@ function d({ onFinalize: s, language: d }) {
 			t.trim() && T.current(t.trim()), v(n.trim());
 		}, n.onerror = (e) => {
 			if (r !== S.current) return;
-			let t = u(e.error);
+			let t = d(e.error);
 			t !== "no-speech" && b(t);
 		}, n.onend = () => {
 			r === S.current && (x.current = null, g(!1), m(!1), v(""));
@@ -67,7 +70,7 @@ function d({ onFinalize: s, language: d }) {
 		try {
 			n.start();
 		} catch {
-			C.current = performance.now(), w.current += 1, w.current >= c && b("unknown"), x.current = null, g(!1), m(!1);
+			C.current = performance.now(), w.current += 1, w.current >= l && b("unknown"), x.current = null, g(!1), m(!1);
 			return;
 		}
 		x.current = n, w.current = 0, b(null), v("");
@@ -101,4 +104,4 @@ function d({ onFinalize: s, language: d }) {
 	};
 }
 //#endregion
-export { s as START_RETRY_COOLDOWN_MS, l as startIsCoolingDown, d as useVoiceInput };
+export { c as START_RETRY_COOLDOWN_MS, s as isSpeechRecognitionSupported, u as startIsCoolingDown, f as useVoiceInput };

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

@@ -46,6 +46,28 @@ export interface VoiceSessionSnapshot {
     interim: string;
     /** Why the session stopped, when it stopped abnormally. */
     error: VoiceSessionError | null;
+    /**
+     * H2: what the turn in flight was sent as, while there is one ('' otherwise).
+     * Kept so a result that is only the recogniser finishing, repeating or
+     * revising it is not mistaken for a correction, and so a cumulative result
+     * ("<sent words> <new words>") contributes only the new words.
+     */
+    submitted: string;
+    /** H2: when `submitted` was sent (the `at` of the `silence` that sent it). */
+    submittedAt: number | null;
+    /**
+     * H2: the words being collected, or the turn in flight, are a CORRECTION of
+     * a turn that was superseded. Cleared when the corrected turn is answered,
+     * interrupted or the session ends.
+     */
+    correcting: boolean;
+    /**
+     * H2: how many times an in-flight turn has been superseded this session.
+     * A counter, not a flag, so the hook can act exactly once per supersession
+     * (abort the model turn, withdraw outdated proposals) without the reducer
+     * doing anything impure. Reset by `start`.
+     */
+    superseded: number;
 }
 /**
  * Deliberately does NOT include a "playback blocked" variant. Nothing can
@@ -63,10 +85,13 @@ export type VoiceSessionEvent =
     type: 'speech';
     transcript: string;
     final: boolean;
+    /** Wall-clock ms when it was heard — what the H2 trailing-result window is measured with. */
+    at?: number;
 }
-/** Nothing heard for `SILENCE_SUBMIT_MS`. */
+/** Nothing heard for the person's grace (`resolveVoiceGraceMs`). */
  | {
     type: 'silence';
+    at?: number;
 } | {
     type: 'reply';
     text: string;
@@ -116,24 +141,19 @@ export type VoiceSessionEvent =
     type: 'end';
 };
 /**
- * How long the user must stop talking before the turn is submitted.
+ * How long the user must stop talking before the turn is submitted is a USER
+ * PREFERENCE (H1): `DEFAULT_VOICE_GRACE_MS` (2 s), 3 s or 5 s, resolved by
+ * `resolveVoiceGraceMs` and applied by `planSubmitTimer` in `./handsFree` —
+ * the only place that waits. (`SILENCE_SUBMIT_MS`, which used to live here, is
+ * gone: a second constant was a second owner.)
  *
- * Long enough to survive a mid-sentence breath — a farmer describing a problem
- * pauses — and short enough that the session does not feel unresponsive. A
- * premature send truncates the question, which costs a whole 2-5s round trip to
- * recover from.
- *
- * ★ Raised from 1200ms because 1.2s does not survive an ordinary pause: the
- * operator reported being cut off mid-sentence, and the cost is worse than a
- * truncated prompt — once the turn is submitted the reducer discards every
- * `speech` event outside `listening`, so the rest of the sentence is not
- * queued, it is thrown away, and the assistant answers half a question.
- *
- * The asymmetry is what settles the number: waiting 800ms longer costs a moment
- * of silence, while cutting someone off costs the whole round trip AND makes
- * them repeat themselves.
+ * Why the default is 2 s and not the 1.2 s it started at: 1.2 s does not
+ * survive an ordinary pause — once the turn is submitted the reducer discards
+ * every `speech` event outside `listening`, so the rest of the sentence is not
+ * queued, it is thrown away, and the assistant answers half a question. Waiting
+ * 800ms longer costs a moment of silence; cutting someone off costs the whole
+ * round trip AND makes them repeat themselves.
  */
-export declare const SILENCE_SUBMIT_MS = 2000;
 /**
  * Quiet needed before the pause is SHOWN as a pause.
  *
@@ -145,7 +165,7 @@ export declare const SILENCE_SUBMIT_MS = 2000;
  *
  * Short enough to be seen, long enough that an ordinary breath between words
  * does not flicker the stage. ★800, not 400: this file already records that
- * SILENCE_SUBMIT_MS had to go 1200 -> 2000 because ordinary pauses ran longer
+ * the grace had to go 1200 -> 2000 because ordinary pauses ran longer
  * than expected, so a 400ms threshold sits inside normal inter-clause silence
  * and would oscillate the stage mid-sentence. Still leaves ~1.2s visible.
  */
@@ -213,7 +233,14 @@ export declare function isEcho(transcript: string, spokenText: string | null): b
  * while the phase is `listening`. Leaving it unclaimed meant the NEXT question
  * found it waiting and spoke the answer to the question the user had cut off.
  */
-export declare function planReplyConsumption(replyId: string | null | undefined, phase: VoiceSessionPhase, consumedReplyId: string | null): {
+export declare function planReplyConsumption(replyId: string | null | undefined, phase: VoiceSessionPhase, consumedReplyId: string | null, 
+/**
+ * H2: the reply belongs to a turn the person superseded (`isTurnSuperseded`).
+ * It is claimed and never advances the session, whatever the phase — a late
+ * answer to a question the person has since corrected must not move the
+ * turn that REPLACED it out of `thinking`.
+ */
+supersededReply?: boolean): {
     claim: boolean;
     advance: boolean;
 };
@@ -265,13 +292,30 @@ export declare function planListeningHold(input: {
     held: boolean;
 };
 /**
- * Is the microphone capturing right now?
+ * Is the microphone capturing right now — in the sense the AUDIO guards mean?
  *
  * False while the assistant speaks, which is the whole point: an open
  * microphone during playback is what created the feedback loop. False whenever
  * muted, whatever the phase.
+ *
+ * ★ Deliberately still `listening` only, though the recogniser now also runs in
+ * `thinking` (see `shouldRecognise`). This is what the speech provider is told
+ * ("the microphone is open: refuse to auto-speak a reply into it"), and the
+ * not-capturing notice is judged by. A correction heard in `thinking` supersedes
+ * the turn and returns the phase to `listening`, so a late reply is then refused
+ * by exactly this guard — it is not weakened by listening for corrections.
  */
 export declare function isCapturing(snapshot: VoiceSessionSnapshot): boolean;
+/**
+ * Should the recogniser be RUNNING right now (H2)?
+ *
+ * While `listening`, and also while the assistant is `thinking`: nothing plays
+ * then, so there is no echo to fear, and keeping the microphone open is what
+ * lets a person correct themselves without tapping. Closed for the whole of
+ * `speaking`, and whenever muted. Barge-in while SPEAKING is a separate step
+ * (H3) and is NOT enabled here.
+ */
+export declare function shouldRecognise(snapshot: VoiceSessionSnapshot): boolean;
 /** The orb's visual mode. Kept here so the UI has no state logic of its own. */
 export declare function orbMode(snapshot: VoiceSessionSnapshot): 'idle' | 'listening' | 'thinking' | 'speaking';
 //# sourceMappingURL=voiceSession.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"voiceSession.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/voiceSession.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"voiceSession.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/voiceSession.ts"],"names":[],"mappings":"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"}

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

@@ -1,20 +1,21 @@
+import { mergeFinalPhrase as e, planThinkingSpeech as t, stripSubmittedPrefix as n } from "./handsFree.js";
 //#region src/shared/assistant/voice/voiceSession.ts
-var e = 2e3, t = 800, n = 1500, r = 500;
-function i(e) {
+var r = 800, i = 1500, a = 500;
+function o(e) {
 	return e.trim().length > 0;
 }
-function a(e) {
+function s(e) {
 	return `${e.pending} ${e.interim}`.replace(/\s+/g, " ").trim();
 }
-var o = {
+var c = {
 	text: "",
 	at: null
-}, s = (e) => e ? e.split(" ").length : 0;
-function c(e, t, n) {
-	let r = a(t);
-	if (!r) return o;
+}, l = (e) => e ? e.split(" ").length : 0;
+function u(e, t, n) {
+	let r = s(t);
+	if (!r) return c;
 	let i = r.toLowerCase().replace(/[^\p{L}\p{M}\p{N}]+/gu, " ").trim();
-	return i === e.text || e.text.startsWith(i) ? e : t.interim.trim() === "" && s(i) <= s(e.text) ? {
+	return i === e.text || e.text.startsWith(i) ? e : t.interim.trim() === "" && l(i) <= l(e.text) ? {
 		text: i,
 		at: e.at
 	} : {
@@ -22,120 +23,169 @@ function c(e, t, n) {
 		at: n
 	};
 }
-function l(e) {
+function d(e) {
 	return e.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
 }
-var u = 3;
-function d(e, t) {
+var f = 3;
+function p(e, t) {
 	if (!t) return !1;
-	let n = l(e);
-	return n.length === 0 ? !0 : n.split(" ").length < u ? !1 : ` ${l(t)} `.includes(` ${n} `);
+	let n = d(e);
+	return n.length === 0 ? !0 : n.split(" ").length < f ? !1 : ` ${d(t)} `.includes(` ${n} `);
 }
-function f(e, t, n) {
+function m(e, t, n, r = !1) {
 	return !e || e === n ? {
 		claim: !1,
 		advance: !1
+	} : r ? {
+		claim: !0,
+		advance: !1
 	} : {
 		claim: !0,
 		advance: t === "thinking"
 	};
 }
-var p = Object.freeze({
+var h = Object.freeze({
 	phase: "idle",
 	muted: !1,
 	pending: "",
 	interim: "",
-	error: null
-});
-function m(e, t, n = null) {
-	if (t.type === "start") return {
-		...p,
+	error: null,
+	submitted: "",
+	submittedAt: null,
+	correcting: !1,
+	superseded: 0
+}), g = {
+	submitted: "",
+	submittedAt: null,
+	correcting: !1
+};
+function _(e, n, r) {
+	if (p(n.transcript, r)) return e;
+	let i = t({
+		transcript: n.transcript,
+		submitted: e.submitted,
+		sinceSubmitMs: n.at !== void 0 && e.submittedAt !== null ? n.at - e.submittedAt : null
+	});
+	if (i.kind === "ignore") return e;
+	let a = i.text.replace(/\s+/g, " ").trim();
+	return {
+		...e,
+		phase: "listening",
+		correcting: !0,
+		superseded: e.superseded + 1,
+		pending: n.final ? a : "",
+		interim: n.final ? "" : a
+	};
+}
+function v(t, r, i = null) {
+	if (r.type === "start") return {
+		...h,
 		phase: "listening"
 	};
-	if (t.type === "end") return {
-		...e,
+	if (r.type === "end") return {
+		...t,
+		...g,
 		phase: "ended",
 		pending: "",
 		interim: "",
 		error: null
 	};
-	if (e.phase === "ended") return e;
-	if (t.type === "fail") return {
-		...e,
+	if (t.phase === "ended") return t;
+	if (r.type === "fail") return {
+		...t,
+		...g,
 		phase: "ended",
 		pending: "",
 		interim: "",
-		error: t.error
+		error: r.error
 	};
-	switch (t.type) {
+	switch (r.type) {
 		case "mute": return {
-			...e,
-			muted: t.muted,
-			...t.muted ? {
+			...t,
+			muted: r.muted,
+			...r.muted ? {
 				pending: "",
 				interim: ""
 			} : {}
 		};
-		case "interrupt": return e.phase === "speaking" || e.phase === "thinking" ? {
-			...e,
+		case "interrupt": return t.phase === "speaking" || t.phase === "thinking" ? {
+			...t,
+			...g,
 			phase: "listening",
 			pending: "",
 			interim: ""
-		} : e;
-		case "speech": return e.muted || e.phase !== "listening" || d(t.transcript, n) ? e : t.final ? {
-			...e,
-			pending: `${e.pending} ${t.transcript}`.replace(/\s+/g, " ").trim(),
-			interim: ""
-		} : {
-			...e,
-			interim: t.transcript
+		} : t;
+		case "speech": {
+			if (t.muted) return t;
+			if (t.phase === "thinking") return _(t, r, i);
+			if (t.phase !== "listening" || p(r.transcript, i)) return t;
+			let a = t.correcting ? n(r.transcript, t.submitted) : r.transcript;
+			if (t.correcting && a === "") return t;
+			if (r.final) {
+				let n = e(t.pending, a);
+				return n === t.pending && t.interim === "" ? t : {
+					...t,
+					pending: n,
+					interim: ""
+				};
+			}
+			return a === t.interim ? t : {
+				...t,
+				interim: a
+			};
+		}
+		case "silence": return t.phase !== "listening" || t.muted || !o(s(t)) ? t : {
+			...t,
+			phase: "thinking",
+			submitted: s(t),
+			submittedAt: r.at ?? null
 		};
-		case "silence": return e.phase !== "listening" || e.muted || !i(a(e)) ? e : {
-			...e,
-			phase: "thinking"
-		};
-		case "reply": return e.phase === "thinking" ? {
-			...e,
+		case "reply": return t.phase === "thinking" ? {
+			...t,
+			...g,
 			phase: "speaking",
 			pending: "",
 			interim: ""
-		} : e;
-		case "reply-audio-started": return e.phase === "thinking" ? {
-			...e,
+		} : t;
+		case "reply-audio-started": return t.phase === "thinking" ? {
+			...t,
+			...g,
 			phase: "speaking",
 			pending: "",
 			interim: ""
-		} : e;
-		case "speech-ended": return e.phase === "speaking" ? {
-			...e,
+		} : t;
+		case "speech-ended": return t.phase === "speaking" ? {
+			...t,
+			...g,
 			phase: "listening",
 			pending: "",
 			interim: ""
-		} : e;
-		case "answered-locally": return e.phase === "thinking" ? {
-			...e,
+		} : t;
+		case "answered-locally": return t.phase === "thinking" ? {
+			...t,
+			...g,
 			phase: "speaking",
 			pending: "",
 			interim: ""
-		} : e;
-		case "announce": return e.phase === "listening" && a(e) === "" ? {
-			...e,
+		} : t;
+		case "announce": return t.phase === "listening" && s(t) === "" ? {
+			...t,
 			phase: "speaking",
 			pending: "",
 			interim: ""
-		} : e;
-		default: return e;
+		} : t;
+		default: return t;
 	}
 }
-function h(e) {
+function y(e) {
 	switch (e.phase) {
-		case "listening": return a(e) === "" ? "start" : "drop";
+		case "listening": return s(e) === "" ? "start" : "drop";
 		case "thinking":
 		case "speaking": return "queue";
 		default: return "drop";
 	}
 }
-function g(e) {
+function b(e) {
 	let { requested: t, held: n, muted: r } = e;
 	return t ? n ? {
 		mute: null,
@@ -154,10 +204,13 @@ function g(e) {
 		held: !1
 	};
 }
-function _(e) {
+function x(e) {
 	return e.muted ? !1 : e.phase === "listening";
 }
-function v(e) {
+function S(e) {
+	return e.muted ? !1 : e.phase === "listening" || e.phase === "thinking";
+}
+function C(e) {
 	switch (e.phase) {
 		case "thinking": return "thinking";
 		case "speaking": return "speaking";
@@ -166,4 +219,4 @@ function v(e) {
 	}
 }
 //#endregion
-export { t as ENDPOINT_GRACE_MS, p as INITIAL_SESSION, n as INTERRUPT_MAX_MS, r as INTERRUPT_MIN_MS, o as NOTHING_HEARD, e as SILENCE_SUBMIT_MS, c as advanceHeardClock, _ as isCapturing, d as isEcho, i as isSubmittable, v as orbMode, g as planListeningHold, f as planReplyConsumption, h as planVoiceAnnouncement, a as spokenSoFar, m as voiceSessionReducer };
+export { r as ENDPOINT_GRACE_MS, h as INITIAL_SESSION, i as INTERRUPT_MAX_MS, a as INTERRUPT_MIN_MS, c as NOTHING_HEARD, u as advanceHeardClock, x as isCapturing, p as isEcho, o as isSubmittable, C as orbMode, b as planListeningHold, m as planReplyConsumption, y as planVoiceAnnouncement, S as shouldRecognise, s as spokenSoFar, v as voiceSessionReducer };