@burdenoff/fe-libs 2026.1004.4 → 2026.1004.6

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

@@ -3,23 +3,24 @@ import { useAssistantTr as t } from "../i18n.js";
 import { useAssistantStore as n } from "../store.js";
 import { isVoiceTurn as r } from "../voice/turnVisibility.js";
 import { VOICE_LIST_TIMEOUT_MS as i, languageDisplayName as a, selectVoiceForLocale as o, speechGate as s, speechLangForLocale as c, voiceAvailability as l, voicesForLocale as u } from "../voice/speechVoices.js";
-import { getSpeechEngine as d, subscribeSpeechEngine as f } from "../speech/createSpeechEngine.js";
-import { speechFeed as p } from "../speech/speechFeed.js";
-import { chunkForSpeech as ee, toSpeakableText as m } from "../voice/speakableText.js";
-import { voicePreviewText as te } from "../voice/voicePreview.js";
-import { findAssistantLanguage as ne } from "../voice/languages.js";
-import { resolveLanguagePair as re } from "../voice/languagePair.js";
-import { speechLabelsFor as ie } from "../voice/speechLabels.js";
-import { resolveSpeechLocale as ae } from "../voice/replyLanguage.js";
-import { IDLE_PLAYBACK as oe, isSpeakingMessage as se, publishedChunks as ce, speechPlaybackReducer as le } from "../voice/speechPlayback.js";
-import { isTurnInFlight as ue } from "../turnState.js";
-import { parseToolActivity as de } from "./AssistantToolActivity.js";
+import { getSpeechEngine as d, subscribeSpeechEngine as ee } from "../speech/createSpeechEngine.js";
+import { speechFeed as f } from "../speech/speechFeed.js";
+import { isTurnSuperseded as p } from "../voice/supersededTurns.js";
+import { chunkForSpeech as te, toSpeakableText as m } from "../voice/speakableText.js";
+import { voicePreviewText as ne } from "../voice/voicePreview.js";
+import { findAssistantLanguage as re } from "../voice/languages.js";
+import { resolveLanguagePair as ie } from "../voice/languagePair.js";
+import { speechLabelsFor as ae } from "../voice/speechLabels.js";
+import { resolveSpeechLocale as oe } from "../voice/replyLanguage.js";
+import { IDLE_PLAYBACK as se, isSpeakingMessage as ce, publishedChunks as le, speechPlaybackReducer as ue } from "../voice/speechPlayback.js";
+import { isTurnInFlight as de } from "../turnState.js";
+import { parseToolActivity as fe } from "./AssistantToolActivity.js";
 import "../speech/index.js";
 import { markTurn as h } from "../turnTimeline.js";
-import { createContext as fe, useCallback as g, useContext as _, useEffect as v, useMemo as y, useReducer as pe, useRef as b, useState as x, useSyncExternalStore as me } from "react";
-import { jsx as he } from "react/jsx-runtime";
+import { createContext as pe, useCallback as g, useContext as _, useEffect as v, useMemo as y, useReducer as me, useRef as b, useState as x, useSyncExternalStore as he } from "react";
+import { jsx as ge } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/AssistantSpeechProvider.tsx
-var ge = {
+var _e = {
 	codeBlock: "",
 	image: "",
 	link: "",
@@ -28,7 +29,7 @@ var ge = {
 	emailAt: "at",
 	emailDot: "dot",
 	nestedItem: ""
-}, _e = 4e3, ve = fe({
+}, ve = 4e3, ye = pe({
 	isSupported: !1,
 	availability: "unsupported",
 	isBlocked: !0,
@@ -51,17 +52,17 @@ var ge = {
 	speakFinishedReply: () => {},
 	previewVoice: () => {}
 });
-function ye() {
-	return _(ve);
+function be() {
+	return _(ye);
 }
-var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
-	let be = me(f, d, d), S = ye ?? be, C = t(), { locale: w } = e(), [T, E] = pe(le, oe), [D, O] = x(() => S.listVoices()), [k, xe] = x(!1), [Se, A] = x(() => /* @__PURE__ */ new Map()), j = b(0), M = b(null), N = b(null), P = b(null);
+var xe = ({ children: pe, visible: _ = !0, engine: be }) => {
+	let xe = he(ee, d, d), S = be ?? xe, C = t(), { locale: w } = e(), [T, E] = me(ue, se), [D, O] = x(() => S.listVoices()), [k, Se] = x(!1), [Ce, A] = x(() => /* @__PURE__ */ new Map()), j = b(0), M = b(null), N = b(null), P = b(null);
 	v(() => () => {
 		P.current !== null && clearTimeout(P.current);
 	}, []);
-	let [Ce, F] = x(null), I = b(null), we = b(() => {}), L = g(() => {
+	let [we, F] = x(null), I = b(null), Te = b(() => {}), L = g(() => {
 		I.current?.(), I.current = null;
-	}, []), R = n((e) => e.autoSpeakEnabled), Te = n((e) => e.setAutoSpeak), [z, Ee] = x(!1), B = b(!1), De = g((e) => {
+	}, []), R = n((e) => e.autoSpeakEnabled), Ee = n((e) => e.setAutoSpeak), [z, De] = x(!1), B = b(!1), Oe = g((e) => {
 		B.current = e;
 	}, []), V = n((e) => e.activeConversationId), H = y(() => S.isSupported(), [S]);
 	v(() => {
@@ -71,16 +72,16 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 		};
 		return e(), S.subscribeVoices(e);
 	}, [S, H]);
-	let Oe = n((e) => e.assistantLanguage), ke = n((e) => e.replyLanguage), U = n((e) => e.preferredVoices), Ae = n((e) => e.setPreferredVoice), W = y(() => re(Oe, ke, w).reply, [
-		Oe,
+	let ke = n((e) => e.assistantLanguage), Ae = n((e) => e.replyLanguage), U = n((e) => e.preferredVoices), je = n((e) => e.setPreferredVoice), W = y(() => ie(ke, Ae, w).reply, [
 		ke,
+		Ae,
 		w
-	]), G = W.code, K = g((e) => ne(e)?.tag ?? c(e), []), je = g((e) => ne(e)?.rate ?? .9, []), q = y(() => l(H, D, W.tag, k), [
+	]), G = W.code, K = g((e) => re(e)?.tag ?? c(e), []), Me = g((e) => re(e)?.rate ?? .9, []), q = y(() => l(H, D, W.tag, k), [
 		H,
 		D,
 		W,
 		k
-	]), Me = y(() => ({
+	]), Ne = y(() => ({
 		codeBlock: C("speech.codeBlock", "Code block"),
 		image: C("speech.image", "image"),
 		link: C("speech.link", "link"),
@@ -91,12 +92,12 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 		emailDot: C("speech.emailDot", "dot")
 	}), [C]), J = g(() => {
 		L(), M.current = null, S.cancel(), E({ type: "stop" });
-	}, [L, S]), Ne = g((e) => {
+	}, [L, S]), Pe = g((e) => {
 		let t = S.listVoices().find((t) => t.name === e) ?? null;
 		if (t) {
 			J();
 			try {
-				S.speak([te(G)], {
+				S.speak([ne(G)], {
 					voice: t,
 					lang: K(G),
 					fallback: !1
@@ -108,15 +109,15 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 		G,
 		J,
 		K
-	]), Pe = g((e) => Se.get(e) ?? null, [Se]), Fe = g((e, t, n, r, a) => {
+	]), Fe = g((e) => Ce.get(e) ?? null, [Ce]), Ie = g((e, t, n, r, a) => {
 		L();
 		let o = !1, s = () => {}, c = (i) => {
 			if (!o) {
 				if (o = !0, I.current = null, clearTimeout(l), s(), i.length === 0) {
-					xe(!0);
+					Se(!0);
 					return;
 				}
-				O(i), we.current(e, t, i, n, r, a);
+				O(i), Te.current(e, t, i, n, r, a);
 			}
 		}, l = setTimeout(() => c(S.listVoices()), i);
 		s = S.subscribeVoices(() => c(S.listVoices())), I.current = () => {
@@ -128,14 +129,14 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 			let e = S.listVoices();
 			e.length > 0 && (u = e, O(e));
 		}
-		let d = K(r), f = s(l(!0, u, r, k));
-		if (f === "block") {
+		let d = K(r), ee = s(l(!0, u, r, k));
+		if (ee === "block") {
 			let t = C("speech.noVoiceForReply", "This reply is in {{language}}, and no {{language}} voice is installed on this device.", { language: a(d, w) });
 			A((n) => new Map(n).set(e, t));
 			return;
 		}
-		if (f === "wait-for-voices") {
-			Fe(e, t, r, i, c);
+		if (ee === "wait-for-voices") {
+			Ie(e, t, r, i, c);
 			return;
 		}
 		A((t) => {
@@ -143,85 +144,85 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 			let n = new Map(t);
 			return n.delete(e), n;
 		}), L();
-		let p = j.current + 1;
-		j.current = p, E({
+		let f = j.current + 1;
+		j.current = f, E({
 			type: "start",
 			messageId: e,
-			requestId: p
-		}), M.current = i ? p : null, i && h(e, "ttsStarted");
-		let m = c === void 0 ? ee(t) : ee(t, void 0, void 0, { firstChunkMaxChars: c });
+			requestId: f
+		}), M.current = i ? f : null, i && h(e, "ttsStarted");
+		let p = c === void 0 ? te(t) : te(t, void 0, void 0, { firstChunkMaxChars: c });
 		F({
-			requestId: p,
-			chunks: m,
+			requestId: f,
+			chunks: p,
 			index: -1
 		}), P.current !== null && clearTimeout(P.current), P.current = setTimeout(() => {
-			F((e) => e?.requestId === p && e.index < 0 ? null : e);
-		}, _e);
-		let te = () => {
-			j.current === p && P.current !== null && (clearTimeout(P.current), P.current = null), E({
+			F((e) => e?.requestId === f && e.index < 0 ? null : e);
+		}, ve);
+		let m = () => {
+			j.current === f && P.current !== null && (clearTimeout(P.current), P.current = null), E({
 				type: "failed",
-				requestId: p
+				requestId: f
 			});
 		};
 		try {
-			S.speak(m, {
+			S.speak(p, {
 				voice: o(u, d, U[r]),
 				lang: d,
-				rate: je(r)
+				rate: Me(r)
 			}, {
 				onStart: () => {
-					j.current === p && M.current === p && h(e, "firstAudio");
+					j.current === f && M.current === f && h(e, "firstAudio");
 				},
 				onChunkStart: (e) => {
-					j.current === p && P.current !== null && (clearTimeout(P.current), P.current = null), F((t) => t?.requestId === p ? {
+					j.current === f && P.current !== null && (clearTimeout(P.current), P.current = null), F((t) => t?.requestId === f ? {
 						...t,
 						index: e
-					} : j.current === p ? {
-						requestId: p,
-						chunks: m,
+					} : j.current === f ? {
+						requestId: f,
+						chunks: p,
 						index: e
 					} : t);
 				},
 				onEnd: () => {
-					j.current === p && M.current === p && h(e, "audioEnded"), E({
+					j.current === f && M.current === f && h(e, "audioEnded"), E({
 						type: "finished",
-						requestId: p
+						requestId: f
 					});
 				},
 				onError: () => E({
 					type: "failed",
-					requestId: p
+					requestId: f
 				})
 			});
 		} catch {
-			te();
+			m();
 		}
 	}, [
 		L,
 		S,
 		w,
 		U,
-		je,
+		Me,
 		K,
 		C,
 		k,
-		Fe
+		Ie
 	]);
 	v(() => {
-		we.current = Y;
+		Te.current = Y;
 	}, [Y]);
 	let X = g((e, t, n, r) => {
 		if (!H) return;
-		let i = ae(m(t, { labels: ge }), n ?? G), a = m(t, { labels: ie(i, Me) });
+		let i = oe(m(t, { labels: _e }), n ?? G), a = m(t, { labels: ae(i, Ne) });
 		a && Y(e, a, D, i, r?.auto === !0, r?.firstChunkMaxChars);
 	}, [
 		H,
-		Me,
+		Ne,
 		G,
 		Y,
 		D
-	]), Ie = g((e, t, n) => {
-		if (se(T, e)) {
+	]), Le = g((e, t, n) => {
+		if (ce(T, e)) {
 			J();
 			return;
 		}
@@ -234,14 +235,14 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 	v(() => {
 		_ || J();
 	}, [_, J]);
-	let Le = b({
+	let Z = b({
 		autoSpeakEnabled: R,
 		sessionSpeaking: z,
 		visible: _,
 		isSupported: H
 	});
 	v(() => {
-		Le.current = {
+		Z.current = {
 			autoSpeakEnabled: R,
 			sessionSpeaking: z,
 			visible: _,
@@ -271,7 +272,7 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 		let e = () => {
 			if (document.visibilityState !== "visible") return;
 			let e = S.listVoices();
-			e.length > 0 && L(), O(e), xe(!1), A((e) => e.size === 0 ? e : /* @__PURE__ */ new Map());
+			e.length > 0 && L(), O(e), Se(!1), A((e) => e.size === 0 ? e : /* @__PURE__ */ new Map());
 		};
 		return document.addEventListener("visibilitychange", e), window.addEventListener("focus", e), () => {
 			document.removeEventListener("visibilitychange", e), window.removeEventListener("focus", e);
@@ -281,15 +282,15 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 		S,
 		H
 	]);
-	let Z = b(X);
+	let Ve = b(X);
 	v(() => {
-		Z.current = X;
+		Ve.current = X;
 	}, [X]);
 	let Q = g((e, t) => {
-		if (r(e) !== t || N.current?.messageId === e.id || B.current) return;
-		let { text: n } = de(e.content);
+		if (r(e) !== t || p(e.id) || N.current?.messageId === e.id || B.current) return;
+		let { text: n } = fe(e.content);
 		if (n.trim()) try {
-			Z.current(e.id, n, e.metadata?.lang, { auto: !0 });
+			Ve.current(e.id, n, e.metadata?.lang, { auto: !0 });
 		} catch {}
 	}, []), $ = g((e, t) => {
 		if (e !== Re.current) {
@@ -299,7 +300,7 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 			});
 			return;
 		}
-		let r = Le.current;
+		let r = Z.current;
 		if (!r.autoSpeakEnabled && !r.sessionSpeaking || !r.visible || !r.isSupported) return;
 		let i = n.getState();
 		if (i.activeConversationId !== e) return;
@@ -313,7 +314,7 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 			let n = e.activeConversationId;
 			if (!n || n !== t.activeConversationId) return;
 			let r = e.processingByConversationId[n], i = t.processingByConversationId[n];
-			if (r?.status !== "complete" || !ue(i?.status)) return;
+			if (r?.status !== "complete" || !de(i?.status)) return;
 			let a = r.messageId ?? i?.messageId ?? null;
 			if (!a) return;
 			let o = e.conversations.find((e) => e.id === n)?.messages.find((e) => e.id === a);
@@ -326,20 +327,20 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 		_,
 		Q
 	]);
-	let Ve = g((e) => {
+	let He = g((e) => {
 		if (e.type === "abort") {
 			let t = N.current;
 			if (!t || t.messageId !== e.messageId) return;
 			N.current = null, (t.requestId === null ? t.waiting && I.current !== null : j.current === t.requestId) && J();
 			return;
 		}
-		let { messageId: t, item: r } = e, i = Le.current;
-		if (!i.autoSpeakEnabled && !i.sessionSpeaking || !i.visible || !i.isSupported || r.channel === "voice" !== i.sessionSpeaking || B.current || N.current?.messageId === t || n.getState().activeConversationId !== r.conversationId || Re.current !== r.conversationId) return;
-		let { text: a } = de(r.text);
+		let { messageId: t, item: r } = e, i = Z.current;
+		if (!i.autoSpeakEnabled && !i.sessionSpeaking || !i.visible || !i.isSupported || r.channel === "voice" !== i.sessionSpeaking || p(t) || B.current || N.current?.messageId === t || n.getState().activeConversationId !== r.conversationId || Re.current !== r.conversationId) return;
+		let { text: a } = fe(r.text);
 		if (!a.trim()) return;
 		let o = j.current;
 		try {
-			Z.current(t, a, r.lang, {
+			Ve.current(t, a, r.lang, {
 				auto: !0,
 				firstChunkMaxChars: 110
 			});
@@ -351,59 +352,59 @@ var be = ({ children: fe, visible: _ = !0, engine: ye }) => {
 			waiting: !s && I.current !== null
 		};
 	}, [J]);
-	v(() => p.subscribe(Ve), [Ve]);
-	let He = y(() => u(D, W.tag), [D, W]), Ue = y(() => o(D, W.tag, U[G]), [
+	v(() => f.subscribe(He), [He]);
+	let Ue = y(() => u(D, W.tag), [D, W]), We = y(() => o(D, W.tag, U[G]), [
 		D,
 		W,
 		U,
 		G
-	]), We = y(() => ({
+	]), Ge = y(() => ({
 		isSupported: H,
 		availability: q,
 		isBlocked: q === "no-voices",
 		disabledReason: q === "no-voices" ? C("speech.noVoicesOnDevice", "This device has no speech voices installed. Add one in your device speech or accessibility settings.") : null,
-		blockedFor: Pe,
-		voiceChoices: He,
-		spokenChunks: ce(T, Ce),
-		activeVoiceName: Ue?.name ?? null,
+		blockedFor: Fe,
+		voiceChoices: Ue,
+		spokenChunks: le(T, we),
+		activeVoiceName: We?.name ?? null,
 		preferredVoiceName: U[G] ?? null,
-		setVoice: (e) => Ae(G, e),
+		setVoice: (e) => je(G, e),
 		speakingMessageId: T.status === "speaking" ? T.messageId : null,
-		isSpeaking: (e) => se(T, e),
-		toggle: Ie,
+		isSpeaking: (e) => ce(T, e),
+		toggle: Le,
 		stop: J,
 		autoSpeakEnabled: R,
-		setAutoSpeak: Te,
+		setAutoSpeak: Ee,
 		sessionSpeaking: z,
-		setSessionSpeaking: Ee,
-		setSessionMicOpen: De,
+		setSessionSpeaking: De,
+		setSessionMicOpen: Oe,
 		speakFinishedReply: $,
-		previewVoice: Ne
+		previewVoice: Pe
 	}), [
 		H,
 		q,
-		Pe,
-		He,
+		Fe,
 		Ue,
+		We,
 		U,
-		Ae,
+		je,
 		G,
 		T,
-		Ie,
+		Le,
 		J,
 		R,
-		Te,
+		Ee,
 		z,
-		De,
+		Oe,
 		$,
-		Ne,
+		Pe,
 		C,
-		Ce
+		we
 	]);
-	return /* @__PURE__ */ he(ve.Provider, {
-		value: We,
-		children: fe
+	return /* @__PURE__ */ ge(ye.Provider, {
+		value: Ge,
+		children: pe
 	});
 };
 //#endregion
-export { be as AssistantSpeechProvider, ye as useAssistantSpeech };
+export { xe as AssistantSpeechProvider, be as useAssistantSpeech };

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

@@ -0,0 +1,20 @@
+import { FC } from 'react';
+/**
+ * How long a voice conversation waits, in silence, before it sends what you
+ * said (H1): 2 seconds by default, or 3 or 5 for people who pause to think.
+ *
+ * The preference is persisted per profile and is the ONE value the voice
+ * session's submit timer waits (`planSubmitTimer`). Resuming to speak inside
+ * the wait cancels the send and carries on with the same turn, and "Let me
+ * finish" in the session holds it entirely — this is only the default patience.
+ *
+ * Renders nothing where there is no speech recognition: a setting for a
+ * microphone that cannot exist is a control that cannot do anything.
+ *
+ * A native `<select>`, like the voice and language pickers: on a phone it opens
+ * the OS picker, which already scrolls, localises itself and is reachable by
+ * speech-control users. Wrapped in its `<label>`, so the visible words are the
+ * accessible name (WCAG 2.5.3).
+ */
+export declare const AssistantVoiceGraceSelector: FC;
+//# sourceMappingURL=AssistantVoiceGraceSelector.d.ts.map

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/controlConfirmDialog.d.ts

@@ -0,0 +1,30 @@
+import { FC, ReactNode } from 'react';
+import { ConfirmPrompt } from '../appControls/plan';
+/**
+ * The panel's one STRONGER confirmation (BOFF-8060): workspace switch and
+ * logout. `request` only OPENS it; `onConfirm` runs from a trusted press on the
+ * dialog's button and from nowhere else.
+ */
+export interface ControlConfirmRequest {
+    prompt: ConfirmPrompt;
+    /** Runs once, on the trusted press. Never called on Cancel, Esc or dismissal. */
+    onConfirm: () => void;
+}
+export interface ControlConfirmDialogController {
+    request: (request: ControlConfirmRequest) => void;
+    /**
+     * The confirmation is open. A live voice session holds its listening
+     * meanwhile, so nothing said is heard or sent.
+     */
+    asking: boolean;
+}
+/**
+ * The panel's confirmation, or null outside a panel that provides one
+ * (`AIAssistantPanel` does). With none, a control that needs it is not offered:
+ * the sentence goes to the model, as it did before the control existed.
+ */
+export declare function useControlConfirmDialog(): ControlConfirmDialogController | null;
+export declare const AssistantControlConfirmProvider: FC<{
+    children: ReactNode;
+}>;
+//# sourceMappingURL=controlConfirmDialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controlConfirmDialog.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/controlConfirmDialog.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,EAAE,EACP,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,iFAAiF;IACjF,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAClD;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAID;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,8BAA8B,GAAG,IAAI,CAE/E;AASD,eAAO,MAAM,+BAA+B,EAAE,EAAE,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,CAuCvE,CAAC"}

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

@@ -0,0 +1,46 @@
+import { useAssistantTr as e } from "../i18n.js";
+import { AssistantControlConfirmDialog as t } from "./AssistantControlConfirmDialog.js";
+import { confirmDialogCopy as n } from "../appControls/copy.js";
+import { createContext as r, useCallback as i, useContext as a, useMemo as o, useState as s } from "react";
+import { jsx as c, jsxs as l } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/controlConfirmDialog.tsx
+var u = r(null);
+function d() {
+	return a(u);
+}
+var f = ({ children: r }) => {
+	let a = e(), [d, f] = s({
+		request: null,
+		open: !1,
+		opening: 0
+	}), p = i((e) => {
+		f((t) => ({
+			request: e,
+			open: !0,
+			opening: t.opening + 1
+		}));
+	}, []), m = i(() => {
+		f((e) => e.open ? {
+			...e,
+			open: !1
+		} : e);
+	}, []), h = i(() => {
+		let { request: e, open: t } = d;
+		!t || !e || (m(), e.onConfirm());
+	}, [d, m]), g = o(() => ({
+		request: p,
+		asking: d.open
+	}), [p, d.open]);
+	return /* @__PURE__ */ l(u.Provider, {
+		value: g,
+		children: [r, d.request ? /* @__PURE__ */ c(t, {
+			open: d.open,
+			copy: n(a, d.request.prompt),
+			tr: a,
+			onConfirm: h,
+			onDismiss: m
+		}, d.opening) : null]
+	});
+};
+//#endregion
+export { f as AssistantControlConfirmProvider, d as useControlConfirmDialog };

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;
     /**