@burdenoff/fe-libs 2026.1004.4 → 2026.1004.5

package/dist/shared/assistant/ui/composer/AssistantVoiceGraceSelector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantVoiceGraceSelector.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/ui/composer/AssistantVoiceGraceSelector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAWhC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,2BAA2B,EAAE,EA8CzC,CAAC"}

package/dist/shared/assistant/ui/composer/AssistantVoiceGraceSelector.js

@@ -0,0 +1,39 @@
+import { isSpeechRecognitionSupported as e } from "../../voice/useVoiceInput.js";
+import { useAssistantTr as t } from "../../i18n.js";
+import { VOICE_GRACE_CHOICES_MS as n, resolveVoiceGraceMs as r } from "../../voice/handsFree.js";
+import { useAssistantStore as i } from "../../store.js";
+import { Timer as a } from "lucide-react";
+import { jsx as o, jsxs as s } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/composer/AssistantVoiceGraceSelector.tsx
+var c = () => {
+	let c = t(), l = i((e) => e.voiceGraceMs), u = i((e) => e.setVoiceGraceMs);
+	if (!e()) return null;
+	let d = r(l), f = (e) => e / 1e3;
+	return /* @__PURE__ */ s("label", {
+		className: "flex items-center gap-2.5 px-3 py-2 text-xs text-text-primary focus-within:ring-2 focus-within:ring-inset focus-within:ring-border-strong",
+		title: c("voice.graceHint", "How long the assistant waits in silence before it sends what you said. Start talking again and it carries on with the same message."),
+		"data-testid": "assistant-voice-grace",
+		children: [
+			/* @__PURE__ */ o(a, {
+				className: "size-3.5 flex-shrink-0 text-text-secondary",
+				"aria-hidden": "true"
+			}),
+			/* @__PURE__ */ o("span", {
+				className: "flex-1",
+				children: c("voice.graceLabel", "Wait after I stop talking")
+			}),
+			/* @__PURE__ */ o("select", {
+				value: d,
+				onChange: (e) => u(Number(e.target.value)),
+				className: "rounded-md border border-border-default bg-bg-surface px-1.5 py-1 text-xs text-text-primary focus:outline-none scheme-normal dark:scheme-dark [&_option]:bg-bg-surface [&_option]:text-text-primary",
+				"data-testid": "assistant-voice-grace-select",
+				children: n.map((e) => /* @__PURE__ */ o("option", {
+					value: e,
+					children: e === 2e3 ? c("voice.graceOptionDefault", "{{seconds}} seconds (default)", { seconds: f(e) }) : c("voice.graceOption", "{{seconds}} seconds", { seconds: f(e) })
+				}, e))
+			})
+		]
+	});
+};
+//#endregion
+export { c as AssistantVoiceGraceSelector };

package/dist/shared/assistant/ui/useVoiceSession.d.ts

@@ -1,4 +1,5 @@
 import { VoiceTurnTiming } from '../turnTimeline';
+import { VoiceGraceMs } from '../voice/handsFree';
 import { VoiceSessionSnapshot } from '../voice/voiceSession';
 /**
  * A problem worth TELLING the user about that does not warrant killing the
@@ -46,7 +47,14 @@ interface Options {
      * When the speech that was submitted ended and when its correction grace
      * ran out (BOFF-7801) — taken here because the turn has no id yet.
      */
-    timing: VoiceTurnTiming) => void;
+    timing: VoiceTurnTiming, 
+    /**
+     * H2: facts about THIS turn the sender needs. `correction` is true when it
+     * is what the person said to correct a turn still being prepared: the
+     * sender must send it as the next message of the same conversation even
+     * though the superseded turn may not have let go yet.
+     */
+    meta: VoiceSubmitMeta) => void;
     /**
      * Id + text of the newest assistant reply. A CHANGE of id is what advances
      * the session out of `thinking` — the text alone is not enough, because two
@@ -58,6 +66,23 @@ interface Options {
     } | null;
     /** Language the user is speaking, so the recogniser is pointed correctly. */
     language: string;
+    /**
+     * H1: the end-of-speech grace — 2 s (the default), 3 s or 5 s. The ONE value
+     * the submit timer waits (`planSubmitTimer`); anything else is the default.
+     */
+    graceMs?: VoiceGraceMs | number;
+    /**
+     * H2: a correction was heard while a turn was still being prepared. Cancel
+     * that turn — abort it on the sandbox, record it as superseded
+     * (`markTurnSuperseded`), withdraw the proposals it made outdated. Called
+     * once per supersession, from an effect (never during a reduction).
+     */
+    onSupersede?: () => void;
+}
+/** What `onSubmit` is told about the turn beyond its words (H2). */
+export interface VoiceSubmitMeta {
+    /** The words are a correction of a turn that was superseded. */
+    correction: boolean;
 }
 /**
  * Drives a live voice conversation (BOFF-7120).
@@ -73,7 +98,7 @@ interface Options {
  * microphone's lifetime, and turning "auto-speak is currently on" back off again
  * when the session ends.
  */
-export declare function useVoiceSession({ onSubmit, latestReply, language }: Options): {
+export declare function useVoiceSession({ onSubmit, latestReply, language, graceMs: graceChoice, onSupersede, }: Options): {
     session: Readonly<VoiceSessionSnapshot>;
     /** A recoverable problem worth showing, or null when all is well. */
     notice: VoiceSessionNotice | null;
@@ -101,6 +126,10 @@ export declare function useVoiceSession({ onSubmit, latestReply, language }: Opt
     interrupting: boolean;
     /** Quiet has fallen and the correction window is running. */
     awaitingEndpoint: boolean;
+    /** H1: "Let me finish" is on — nothing is sent until `imDone`. */
+    holding: boolean;
+    /** H2: what is being collected corrects a turn that was superseded. */
+    correcting: boolean;
     /** Can a session be offered at all on this device? */
     available: boolean;
     start: () => void;
@@ -108,6 +137,10 @@ export declare function useVoiceSession({ onSubmit, latestReply, language }: Opt
     isCurrentSession: (voiceSessionId: string) => boolean;
     toggleMute: () => void;
     interrupt: () => void;
+    /** H1: hold auto-submit until the person is done. */
+    letMeFinish: () => void;
+    /** H1: the person is done — send what was said now. */
+    imDone: () => void;
     /** Say a line of the panel's own (BOFF-7803 FE9, `VoiceAnnouncement`). */
     announce: (item: VoiceAnnouncement) => void;
     /**

package/dist/shared/assistant/ui/useVoiceSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVoiceSession.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/useVoiceSession.ts"],"names":[],"mappings":"AAUA,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIpE,OAAO,EAgBL,KAAK,oBAAoB,EAE1B,MAAM,uBAAuB,CAAC;AAsC/B;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAC5B,SAAS,GAAG,eAAe,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAEvE;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B;AAMD,UAAU,OAAO;IACf,+EAA+E;IAC/E;;;;;;;OAOG;IACH,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM;IACtB;;;OAGG;IACH,MAAM,EAAE,eAAe,KACpB,IAAI,CAAC;IACV;;;;OAIG;IACH,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,OAAO;;IA4xBtE,qEAAqE;;IAErE;;;;;;;OAOG;;IAEH,+DAA+D;;IAE/D;;;;;;;OAOG;;IAIH,0EAA0E;;IAE1E,6DAA6D;;IAE7D,sDAAsD;;;;uCApEvC,MAAM;;;IA2ErB,0EAA0E;qBAtsB1C,iBAAiB;IAwsBjD;;;OAGG;+BAttBuC,OAAO;IAwtBjD;;;OAGG;0BArrBE,iBAAiB;EAitB3B"}
+{"version":3,"file":"useVoiceSession.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/useVoiceSession.ts"],"names":[],"mappings":"AAUA,OAAO,EAAe,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIpE,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAgBL,KAAK,oBAAoB,EAE1B,MAAM,uBAAuB,CAAC;AAsC/B;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAC5B,SAAS,GAAG,eAAe,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAEvE;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B;AAMD,UAAU,OAAO;IACf,+EAA+E;IAC/E;;;;;;;OAOG;IACH,QAAQ,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM;IACtB;;;OAGG;IACH,MAAM,EAAE,eAAe;IACvB;;;;;OAKG;IACH,IAAI,EAAE,eAAe,KAClB,IAAI,CAAC;IACV;;;;OAIG;IACH,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAChC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,OAAO,EAAE,WAAW,EACpB,WAAW,GACZ,EAAE,OAAO;;IAq4BJ,qEAAqE;;IAErE;;;;;;;OAOG;;IAEH,+DAA+D;;IAE/D;;;;;;;OAOG;;IAIH,0EAA0E;;IAE1E,6DAA6D;;IAE7D,kEAAkE;;IAElE,uEAAuE;;IAEvE,sDAAsD;;;;uCA1GvC,MAAM;;;IAiHrB,qDAAqD;;IAErD,uDAAuD;;IAEvD,0EAA0E;qBA7yB1C,iBAAiB;IA+yBjD;;;OAGG;+BA7zBuC,OAAO;IA+zBjD;;;OAGG;0BA5xBE,iBAAiB;EA2zB3B"}

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

@@ -1,176 +1,214 @@
 import { useVoiceInput as e } from "../voice/useVoiceInput.js";
-import { speechFeed as t } from "../speech/speechFeed.js";
-import { INITIAL_SESSION as n, INTERRUPT_MAX_MS as ee, NOTHING_HEARD as r, SILENCE_SUBMIT_MS as te, advanceHeardClock as ne, isCapturing as i, isSubmittable as re, planListeningHold as ie, planReplyConsumption as ae, planVoiceAnnouncement as oe, spokenSoFar as a, voiceSessionReducer as se } from "../voice/voiceSession.js";
-import { captionChunks as ce } from "../voice/speechPlayback.js";
-import { turnClockMs as o } from "../turnTimeline.js";
-import { useAssistantSpeech as le } from "./AssistantSpeechProvider.js";
-import { useCallback as s, useEffect as c, useLayoutEffect as ue, useMemo as de, useReducer as fe, useRef as l, useState as u } from "react";
+import { planSubmitTimer as t, resolveVoiceGraceMs as n } from "../voice/handsFree.js";
+import { speechFeed as r } from "../speech/speechFeed.js";
+import { INITIAL_SESSION as ee, INTERRUPT_MAX_MS as te, NOTHING_HEARD as i, advanceHeardClock as ne, isCapturing as a, isSubmittable as re, planListeningHold as ie, planReplyConsumption as ae, planVoiceAnnouncement as oe, shouldRecognise as se, spokenSoFar as o, voiceSessionReducer as ce } from "../voice/voiceSession.js";
+import { isTurnSuperseded as s } from "../voice/supersededTurns.js";
+import { captionChunks as le } from "../voice/speechPlayback.js";
+import { turnClockMs as c } from "../turnTimeline.js";
+import { useAssistantSpeech as ue } from "./AssistantSpeechProvider.js";
+import { useCallback as l, useEffect as u, useLayoutEffect as de, useMemo as fe, useReducer as pe, useRef as d, useState as f } from "react";
 //#region src/shared/assistant/ui/useVoiceSession.ts
-var pe = 4e3, me = 2500, he = 5e3, ge = 12e3, _e = "data:audio/wav;base64,UklGRiQAAABXQVZFZm10IBAAAAABAAEARKwAAIhYAQACABAAZGF0YQAAAAA=";
-function d({ onSubmit: d, latestReply: f, language: ve }) {
-	let p = l(null), [m, h] = fe(s((e, t) => se(e, t, p.current), []), n), g = le(), { setSessionSpeaking: _, setSessionMicOpen: v, speakingMessageId: y, stop: b } = g, x = l(g.toggle), S = g.toggle;
-	ue(() => {
-		x.current = S;
-	}, [S]);
-	let C = l(null), w = l({}), T = l(r), E = l(null), D = l(!1), O = l(null), [k, A] = u(null), [j, M] = u(!1), [N, P] = u(!1), F = l(m);
-	F.current = m;
-	let I = l([]), L = l(null), R = l(!1), z = s(() => {
-		I.current = [], L.current = null, R.current = !1;
-	}, []), B = s(() => {
+var me = 4e3, he = 2500, ge = 5e3, _e = 12e3, ve = "data:audio/wav;base64,UklGRiQAAABXQVZFZm10IBAAAAABAAEARKwAAIhYAQACABAAZGF0YQAAAAA=";
+function ye({ onSubmit: ye, latestReply: p, language: be, graceMs: xe, onSupersede: m }) {
+	let h = n(xe), g = d(null), [_, v] = pe(l((e, t) => ce(e, t, g.current), []), ee), y = ue(), { setSessionSpeaking: b, setSessionMicOpen: x, speakingMessageId: S, stop: C } = y, w = d(y.toggle), T = y.toggle;
+	de(() => {
+		w.current = T;
+	}, [T]);
+	let E = d(null), D = d({}), O = d(i), k = d(null), A = d(!1), j = d(null), [M, N] = f(null), [P, F] = f(!1), [I, L] = f(!1), [R, z] = f(!1), B = d(_);
+	B.current = _;
+	let V = d([]), H = d(null), U = d(!1), W = l(() => {
+		V.current = [], H.current = null, U.current = !1;
+	}, []), G = l(() => {
 		for (;;) {
-			let e = I.current.shift();
+			let e = V.current.shift();
 			if (!e) return !1;
 			if (!(e.stillWanted && !e.stillWanted())) {
-				L.current = e, p.current = p.current ? `${p.current} ${e.text}` : e.text;
+				H.current = e, g.current = g.current ? `${g.current} ${e.text}` : e.text;
 				try {
-					x.current(e.id, e.text, e.lang);
+					w.current(e.id, e.text, e.lang);
 				} catch {
-					L.current = null;
+					H.current = null;
 					continue;
 				}
 				return !0;
 			}
 		}
-	}, []), V = l(!1), H = s((e) => {
+	}, []), K = d(!1), q = l((e) => {
 		let t = ie({
 			requested: e,
-			held: V.current,
-			muted: F.current.muted
+			held: K.current,
+			muted: B.current.muted
 		});
-		V.current = t.held, t.mute !== null && h({
+		K.current = t.held, t.mute !== null && v({
 			type: "mute",
 			muted: t.mute
 		});
-	}, []), U = s((e) => {
-		let t = oe(F.current);
-		t !== "drop" && (L.current?.id === e.id || I.current.some((t) => t.id === e.id) || (I.current.push(e), t === "start" && !R.current && (R.current = !0, h({ type: "announce" }))));
-	}, []), W = s((e) => {
-		if (F.current.phase !== "thinking") {
-			U(e);
+	}, []), J = l((e) => {
+		let t = oe(B.current);
+		t !== "drop" && (H.current?.id === e.id || V.current.some((t) => t.id === e.id) || (V.current.push(e), t === "start" && !U.current && (U.current = !0, v({ type: "announce" }))));
+	}, []), Se = l((e) => {
+		if (B.current.phase !== "thinking") {
+			J(e);
 			return;
 		}
-		I.current.push(e), R.current = !0, h({ type: "answered-locally" });
-	}, [U]), G = l(f);
-	G.current = f, c(() => {
-		if (m.phase === "speaking") {
-			let e = O.current;
-			p.current = e && E.current === e.id && f?.id !== e.id ? e.text : f?.text ?? null;
+		V.current.push(e), U.current = !0, v({ type: "answered-locally" });
+	}, [J]), Ce = d(p);
+	Ce.current = p, u(() => {
+		if (_.phase === "speaking") {
+			let e = j.current;
+			g.current = e && k.current === e.id && p?.id !== e.id ? e.text : p?.text ?? null;
 			return;
 		}
-		if (p.current === null) return;
+		if (g.current === null) return;
 		let e = setTimeout(() => {
-			p.current = null;
-		}, me);
+			g.current = null;
+		}, he);
 		return () => clearTimeout(e);
-	}, [m.phase, f]);
-	let K = s((e, t) => {
-		h({
+	}, [_.phase, p]);
+	let Y = l((e, t) => {
+		v({
 			type: "speech",
 			transcript: e,
-			final: t
+			final: t,
+			at: Date.now()
 		});
-	}, []), q = l(0), J = s(() => {
-		z(), b(), q.current = Date.now(), M(!0), h({ type: "interrupt" });
-	}, [b, z]), Y = e({
-		onFinalize: s((e) => K(e, !0), [K]),
-		language: ve
+	}, []), we = d(0), Te = l(() => {
+		W(), C(), we.current = Date.now(), F(!0), v({ type: "interrupt" });
+	}, [C, W]), X = e({
+		onFinalize: l((e) => Y(e, !0), [Y]),
+		language: be
 	});
-	c(() => {
-		Y.interim && K(Y.interim, !1);
-	}, [Y.interim, K]), c(() => {
-		if (C.current && clearTimeout(C.current), P(!1), T.current = ne(T.current, m, o()), m.phase !== "listening" || m.muted || !re(a(m))) return;
-		let e = setTimeout(() => P(!0), 800), t = o();
-		return C.current = setTimeout(() => {
-			w.current = {
-				speechEnded: T.current.at ?? t,
-				graceStarted: t,
-				graceEnded: o()
-			}, h({ type: "silence" });
-		}, te), () => {
-			clearTimeout(e), C.current && clearTimeout(C.current);
+	u(() => {
+		X.interim && Y(X.interim, !1);
+	}, [X.interim, Y]), u(() => {
+		E.current && clearTimeout(E.current), L(!1), O.current = ne(O.current, _, c());
+		let e = t({
+			phase: _.phase,
+			muted: _.muted,
+			spoken: o(_),
+			holding: R,
+			graceMs: h
+		});
+		if (!e.arm) return;
+		let n = setTimeout(() => L(!0), Math.min(800, e.delayMs)), r = c();
+		return E.current = setTimeout(() => {
+			D.current = {
+				speechEnded: O.current.at ?? r,
+				graceStarted: r,
+				graceEnded: c()
+			}, v({
+				type: "silence",
+				at: Date.now()
+			});
+		}, e.delayMs), () => {
+			clearTimeout(n), E.current && clearTimeout(E.current);
 		};
-	}, [m]), c(() => {
-		if (!j) return;
-		let e = Date.now() - q.current, t = Y.isListening ? Math.max(0, 500 - e) : Math.max(0, ee - e), n = setTimeout(() => M(!1), t);
+	}, [
+		_,
+		R,
+		h
+	]), u(() => {
+		(_.phase !== "listening" || _.muted) && z(!1);
+	}, [_.phase, _.muted]), u(() => {
+		if (!P) return;
+		let e = Date.now() - we.current, t = X.isListening ? Math.max(0, 500 - e) : Math.max(0, te - e), n = setTimeout(() => F(!1), t);
 		return () => clearTimeout(n);
-	}, [j, Y.isListening]);
-	let X = l("");
-	m.phase === "listening" && (X.current = a(m)), c(() => {
-		if (m.phase !== "thinking") return;
-		v(!1), z();
-		let e = X.current.trim();
-		e && d(e, Z.current ?? `vs-orphan-${Date.now().toString(36)}`, w.current), w.current = {}, T.current = r;
-	}, [m.phase]), c(() => {
-		let e = ae(f?.id, m.phase, E.current);
-		e.claim && (E.current = f?.id ?? null, e.advance && f && h({
+	}, [P, X.isListening]);
+	let Ee = d("");
+	_.phase === "listening" && (Ee.current = o(_)), u(() => {
+		if (_.phase !== "thinking") return;
+		x(!1), W();
+		let e = Ee.current.trim();
+		e && ye(e, Z.current ?? `vs-orphan-${Date.now().toString(36)}`, D.current, { correction: B.current.correcting }), D.current = {}, O.current = i;
+	}, [_.phase]), u(() => {
+		let e = ae(p?.id, _.phase, k.current, s(p?.id));
+		e.claim && (k.current = p?.id ?? null, e.advance && p && v({
 			type: "reply",
-			text: f.text
+			text: p.text
 		}));
-	}, [f, m.phase]), c(() => {
-		if (y === null || m.phase !== "thinking" || E.current === y) return;
-		let e = t.peek(y);
-		!e || e.channel !== "voice" || e.voiceSessionId === void 0 || e.voiceSessionId !== Z.current || (E.current = y, O.current = {
-			id: y,
+	}, [p, _.phase]), u(() => {
+		if (S === null || _.phase !== "thinking" || k.current === S) return;
+		if (s(S)) {
+			C();
+			return;
+		}
+		let e = r.peek(S);
+		!e || e.channel !== "voice" || e.voiceSessionId === void 0 || e.voiceSessionId !== Z.current || (k.current = S, j.current = {
+			id: S,
 			text: e.text
-		}, h({
+		}, v({
 			type: "reply-audio-started",
-			replyId: y
+			replyId: S
 		}));
-	}, [y, m.phase]), c(() => {
-		let e = y !== null;
-		D.current && !e && (L.current = null, (F.current.phase !== "speaking" || !B()) && h({ type: "speech-ended" })), D.current = e;
-	}, [y, B]), c(() => {
-		m.phase !== "listening" && A((e) => e === "nothing-heard" ? null : e);
-	}, [m.phase]), c(() => {
-		if (m.phase !== "speaking" || y !== null) return;
+	}, [
+		S,
+		_.phase,
+		C
+	]), u(() => {
+		let e = S !== null;
+		A.current && !e && (H.current = null, (B.current.phase !== "speaking" || !G()) && v({ type: "speech-ended" })), A.current = e;
+	}, [S, G]), u(() => {
+		_.phase !== "listening" && N((e) => e === "nothing-heard" ? null : e);
+	}, [_.phase]), u(() => {
+		if (_.phase !== "speaking" || S !== null) return;
 		let e = setTimeout(() => {
-			D.current || (z(), h({ type: "speech-ended" }));
-		}, pe);
+			A.current || (W(), v({ type: "speech-ended" }));
+		}, me);
 		return () => clearTimeout(e);
 	}, [
-		m.phase,
-		y,
-		z
-	]), c(() => {
-		let e = i(m);
-		v(e), e ? Y.isActive || Y.start("auto") : Y.isActive && Y.stop();
+		_.phase,
+		S,
+		W
+	]);
+	let De = d(m);
+	De.current = m;
+	let Oe = d(0);
+	u(() => {
+		let e = _.superseded;
+		e !== Oe.current && (Oe.current = e, e !== 0 && (W(), C(), De.current?.()));
+	}, [
+		_.superseded,
+		W,
+		C
+	]), u(() => {
+		x(a(_)), se(_) ? X.isActive || X.start("auto") : X.isActive && X.stop();
 	}, [
-		m,
-		Y,
-		v
-	]), c(() => {
-		m.phase !== "speaking" || !R.current || (R.current = !1, B() || h({ type: "speech-ended" }));
-	}, [m.phase, B]), c(() => {
-		Y.error === "not-allowed" || Y.error === "audio-capture" ? h({
+		_,
+		X,
+		x
+	]), u(() => {
+		_.phase !== "speaking" || !U.current || (U.current = !1, G() || v({ type: "speech-ended" }));
+	}, [_.phase, G]), u(() => {
+		X.error === "not-allowed" || X.error === "audio-capture" ? v({
 			type: "fail",
 			error: "mic-denied"
-		}) : Y.error === "language-not-supported" ? h({
+		}) : X.error === "language-not-supported" ? v({
 			type: "fail",
 			error: "no-speech-support"
-		}) : Y.error === "network" ? A("network") : Y.error === "unknown" && A("recognition-failed");
-	}, [Y.error]), c(() => {
-		Y.error !== null || !Y.isListening || A((e) => e === "network" || e === "recognition-failed" ? null : e);
-	}, [Y.error, Y.isListening]), c(() => {
-		if (Y.isListening && A((e) => e === "not-capturing" ? null : e), !i(m) || Y.isListening) return;
-		let e = setTimeout(() => A("not-capturing"), he);
+		}) : X.error === "network" ? N("network") : X.error === "unknown" && N("recognition-failed");
+	}, [X.error]), u(() => {
+		X.error !== null || !X.isListening || N((e) => e === "network" || e === "recognition-failed" ? null : e);
+	}, [X.error, X.isListening]), u(() => {
+		if (X.isListening && N((e) => e === "not-capturing" ? null : e), !a(_) || X.isListening) return;
+		let e = setTimeout(() => N("not-capturing"), ge);
 		return () => clearTimeout(e);
-	}, [m, Y.isListening]), c(() => {
-		if (m.phase !== "listening" || m.muted || !Y.isListening || a(m) !== "") return;
-		let e = setTimeout(() => A("nothing-heard"), ge);
+	}, [_, X.isListening]), u(() => {
+		if (_.phase !== "listening" || _.muted || !X.isListening || o(_) !== "") return;
+		let e = setTimeout(() => N("nothing-heard"), _e);
 		return () => clearTimeout(e);
-	}, [m, Y.isListening]), c(() => {
-		a(m) !== "" && A(null);
-	}, [m]);
-	let Z = l(null), Q = s(() => {
-		if (M(!1), P(!1), z(), V.current = !1, !Y.isSupported) {
-			h({
+	}, [_, X.isListening]), u(() => {
+		o(_) !== "" && N(null);
+	}, [_]);
+	let Z = d(null), Q = l(() => {
+		if (F(!1), L(!1), z(!1), W(), K.current = !1, !X.isSupported) {
+			v({
 				type: "fail",
 				error: "no-speech-support"
 			});
 			return;
 		}
-		if (g.isBlocked) {
-			h({
+		if (y.isBlocked) {
+			v({
 				type: "fail",
 				error: "no-voice-support"
 			});
@@ -185,67 +223,90 @@ function d({ onSubmit: d, latestReply: f, language: ve }) {
 		} catch {}
 		try {
 			if (typeof window < "u" && typeof window.Audio == "function") {
-				let e = new window.Audio(_e);
+				let e = new window.Audio(ve);
 				e.volume = 0, e.play().catch(() => {});
 			}
 		} catch {}
-		_(!0), A(null), E.current = G.current?.id ?? null, O.current = null, Z.current = `vs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`, h({ type: "start" });
+		b(!0), N(null), k.current = Ce.current?.id ?? null, j.current = null, Z.current = `vs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`, v({ type: "start" });
 	}, [
-		Y.isSupported,
-		g.isBlocked,
-		_,
-		z
-	]), $ = s(() => {
-		M(!1), P(!1), z(), V.current = !1, Z.current = null, h({ type: "end" }), b(), _(!1);
+		X.isSupported,
+		y.isBlocked,
+		b,
+		W
+	]), ke = l(() => {
+		F(!1), L(!1), z(!1), W(), K.current = !1, Z.current = null, v({ type: "end" }), C(), b(!1);
 	}, [
+		C,
 		b,
-		_,
-		z
-	]), ye = s((e) => Z.current === e, []), be = s(() => {
-		h({
+		W
+	]), Ae = l((e) => Z.current === e, []), je = l(() => {
+		let e = B.current;
+		e.phase !== "listening" || e.muted || z(!0);
+	}, []), Me = l(() => {
+		z(!1);
+		let e = B.current;
+		if (e.phase !== "listening" || e.muted || !re(o(e))) return;
+		let t = c();
+		D.current = {
+			speechEnded: O.current.at ?? t,
+			graceStarted: t,
+			graceEnded: t
+		}, v({
+			type: "silence",
+			at: Date.now()
+		});
+	}, []), Ne = l(() => {
+		v({
 			type: "mute",
-			muted: !F.current.muted
+			muted: !B.current.muted
 		});
 	}, []);
-	c(() => () => {
-		_(!1), v(!1);
-	}, [_, v]);
-	let xe = ce(g.spokenChunks, m.phase, y);
-	return de(() => ({
-		session: m,
-		notice: k,
-		spokenChunks: xe,
-		capturing: Y.isListening,
-		active: m.phase !== "idle" && (m.phase !== "ended" || m.error !== null),
-		interrupting: j,
-		awaitingEndpoint: N,
-		available: Y.isSupported && !g.isBlocked,
+	u(() => () => {
+		b(!1), x(!1);
+	}, [b, x]);
+	let $ = le(y.spokenChunks, _.phase, S);
+	return fe(() => ({
+		session: _,
+		notice: M,
+		spokenChunks: $,
+		capturing: X.isListening,
+		active: _.phase !== "idle" && (_.phase !== "ended" || _.error !== null),
+		interrupting: P,
+		awaitingEndpoint: I,
+		holding: R,
+		correcting: _.correcting,
+		available: X.isSupported && !y.isBlocked,
 		start: Q,
-		end: $,
-		isCurrentSession: ye,
-		toggleMute: be,
-		interrupt: J,
-		announce: U,
-		holdListening: H,
-		answerLocally: W
+		end: ke,
+		isCurrentSession: Ae,
+		toggleMute: Ne,
+		interrupt: Te,
+		letMeFinish: je,
+		imDone: Me,
+		announce: J,
+		holdListening: q,
+		answerLocally: Se
 	}), [
-		m,
-		k,
-		j,
-		N,
-		Y.isListening,
-		Y.isSupported,
-		g.isBlocked,
-		xe,
-		Q,
+		_,
+		M,
+		P,
+		I,
+		R,
+		X.isListening,
+		X.isSupported,
+		y.isBlocked,
 		$,
-		ye,
-		be,
+		Q,
+		ke,
+		Ae,
+		Ne,
+		Te,
+		je,
+		Me,
 		J,
-		U,
-		H,
-		W
+		q,
+		Se
 	]);
 }
 //#endregion
-export { d as useVoiceSession };
+export { ye as useVoiceSession };

package/dist/shared/assistant/ui/voice/AssistantVoiceSession.d.ts

@@ -44,8 +44,22 @@ interface Props {
     capturing?: boolean;
     /** The user has cut the assistant off and capture has not resumed yet. */
     interrupting?: boolean;
-    /** Quiet has fallen and the two-second correction window is running. */
+    /** Quiet has fallen and the correction window is running. */
     awaitingEndpoint?: boolean;
+    /**
+     * ★ H1: "Let me finish" is on — nothing is sent until the person says they
+     * are done. The control swaps to "I'm done" while it is.
+     */
+    holding?: boolean;
+    /**
+     * ★ H2: what is being heard corrects an answer that was still being
+     * prepared (it was cancelled when the person began to speak).
+     */
+    correcting?: boolean;
+    /** Hold auto-send (H1). With `onImDone`, shows the control. */
+    onLetMeFinish?: () => void;
+    /** End the hold and send what was said now (H1). */
+    onImDone?: () => void;
     /**
      * ★ BOFF-7803 FE9: a change of this conversation waiting for its on-screen
      * button. The thread's card is covered (and inert) while the session runs,

package/dist/shared/assistant/ui/voice/AssistantVoiceSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantVoiceSession.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/ui/voice/AssistantVoiceSession.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,EAAE,EACP,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAyB7D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,gFAAgF;AAChF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAElD,UAAU,KAAK;IACb,OAAO,EAAE,oBAAoB,CAAC;IAC9B,iEAAiE;IACjE,KAAK,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACpC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;IACjD,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,iBAAiB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,6EAA6E;IAC7E,YAAY,CAAC,EAAE;QACb,OAAO,EAAE,SAAS,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB,GAAG,IAAI,CAAC;CACV;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,qBAAqB,EAAE,EAAE,CAAC,KAAK,CAuuB3C,CAAC"}
+{"version":3,"file":"AssistantVoiceSession.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/ui/voice/AssistantVoiceSession.tsx"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,EAAE,EACP,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAyB7D,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,gFAAgF;AAChF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAElD,UAAU,KAAK;IACb,OAAO,EAAE,oBAAoB,CAAC;IAC9B,iEAAiE;IACjE,KAAK,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAC3C,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACpC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CAAC;IACjD,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,iBAAiB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,6EAA6E;IAC7E,YAAY,CAAC,EAAE;QACb,OAAO,EAAE,SAAS,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB,GAAG,IAAI,CAAC;CACV;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,qBAAqB,EAAE,EAAE,CAAC,KAAK,CA+zB3C,CAAC"}