@burdenoff/fe-libs 2026.1001.2 → 2026.1001.4

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

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

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

@@ -20,6 +20,15 @@
  * we left off" work. Genuinely separate backend sessions are a larger change
  * and would cost that.
  *
+ * ★★ BOFF-8159 S5 (operator, 2026-09-30: VOICE IS ALWAYS SEPARATE): a live
+ * voice session now speaks into a conversation of its OWN, created at its first
+ * spoken entry (`planVoiceSessionStart`), and never into an unrelated chat. The
+ * split still matters wherever both channels meet in one conversation: a
+ * session that took over an empty placeholder and was later typed into, an
+ * entry attached to the open conversation for a waiting proposal or a running
+ * turn, and every mixed conversation saved before S5 (shown filtered, never
+ * split).
+ *
  * ★ Product-agnostic by construction: it knows about turns and surfaces, never
  * about crops, workflows or nodes. Nothing here needs to change for a product
  * whose modes are `fluidgrids-node` rather than `api-calls`.

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

@@ -1 +1 @@
-{"version":3,"file":"turnVisibility.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/turnVisibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,UAAU,QAAQ;IAChB,QAAQ,CAAC,EAAE,CAAC;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACjG;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,KAAK,CAAC,EAAE,IAAI,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAEpG;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAE9E;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAE9F;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,GAC3C,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAWxB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;OASG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B"}
+{"version":3,"file":"turnVisibility.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/turnVisibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,UAAU,QAAQ;IAChB,QAAQ,CAAC,EAAE,CAAC;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACjG;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,KAAK,CAAC,EAAE,IAAI,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,CAEpG;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAE9E;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAE9F;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,GAC3C,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAWxB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;OASG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B"}

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

@@ -8,13 +8,131 @@
  * read-only transcript", "end the session" and "drop a spoken turn". None can
  * start one.
  */
+/**
+ * ★★ BOFF-8159 S5 — VOICE IS ALWAYS SEPARATE (operator, 2026-09-30). A live
+ * session that has not yet spoken into a conversation of its OWN.
+ *
+ * The session used to adopt whatever conversation was open when the mic was
+ * tapped — including one restored from storage days ago, since
+ * `activeConversationId` is persisted — so a reload left the next spoken
+ * exchange (and its spoken local commands) inside an unrelated typed thread.
+ * Now nothing is adopted: the session's conversation is created LAZILY, at
+ * its first spoken entry, exactly as a send with no conversation open creates
+ * one. A session that says nothing leaves no conversation, no save and no
+ * tombstone behind.
+ *
+ * Conversation identity is separate from sandbox, runtime and model-session
+ * identity: the sandbox for the new conversation's mode is warmed at the mic
+ * tap (and reused when warm), but no conversation id is ever shared to save
+ * the session's start-up.
+ */
+export interface VoiceSessionAwaitingOwn {
+    readonly pending: "own";
+    /**
+     * The conversation on screen when the session started (null: none). It is
+     * not the session's: opening another one before the session has its own
+     * ends the session, as a switch always has.
+     */
+    readonly openAtStart: string | null;
+}
 /**
  * The conversation a live voice session belongs to.
  *
- * `undefined`: no session is live. `null`: a session is live but has not
- * spoken into any conversation yet — its first turn creates one.
+ * `undefined`: no session is live. A string: the session's conversation — its
+ * own, or the empty placeholder it took over. `VoiceSessionAwaitingOwn`: live,
+ * with no conversation of its own yet (`planVoiceSpokenEntry` decides where
+ * each entry goes until it has one). `null`: the pre-S5 "adopt the next active
+ * conversation" value, kept for compatibility; no start path writes it now.
+ */
+export type VoiceSessionBinding = string | null | undefined | VoiceSessionAwaitingOwn;
+/** The session is live and still awaits a conversation of its own. */
+export declare function isAwaitingOwnConversation(binding: VoiceSessionBinding): binding is VoiceSessionAwaitingOwn;
+/**
+ * The conversation a binding names: the session's own, or — while it awaits
+ * one — the conversation that was on screen when it started.
+ */
+export declare function voiceBindingConversationId(binding: VoiceSessionBinding): string | null;
+/** The open conversation, as the voice start and entry rules read it. */
+export interface VoiceOpenConversation {
+    id: string;
+    /**
+     * An empty, unsent placeholder this device would save as a new
+     * conversation (`isReusableHistoryDraft`): nothing in it to keep apart.
+     */
+    reusableDraft: boolean;
+    /** Its 5a proposals still waiting for a person's button. */
+    liveProposals: number;
+    /** One of its turns is in flight. */
+    turnInFlight: boolean;
+}
+/**
+ * Where a new voice session goes: a conversation of its own, or — the two
+ * operator exceptions — the open one.
+ *
+ * - `draft`: an empty unsent placeholder BECOMES the voice conversation.
+ * - `proposal` / `turn`: a waiting 5a proposal or a turn in flight keeps the
+ *   session attached to the open conversation, for that transaction only: a
+ *   spoken correction, decline or "yes" still binds to the card there
+ *   (`planWriteReply`), and nothing is withdrawn by leaving. Once it resolves,
+ *   the session's next entry goes to a conversation of its own.
+ */
+export type VoiceStartPlan = {
+    kind: "own";
+} | {
+    kind: "join";
+    conversationId: string;
+    why: "draft" | "proposal" | "turn";
+};
+/**
+ * ★★ BOFF-8159 S5: the rules, in order. Pure; the panel applies them at the
+ * mic tap (`voiceBindingAtStart`) and again at every spoken entry while the
+ * session has no conversation of its own (`planVoiceSpokenEntry`).
+ *
+ * 1. Nothing open: its own (created at the first spoken entry).
+ * 2. An empty reusable placeholder: it becomes the session's.
+ * 3. A waiting proposal or a turn in flight: attached, for the transaction.
+ * 4. Anything else — a typed chat, a voice conversation of an earlier
+ *    session, one restored from storage: its own. There is no "recently
+ *    used" window (the operator overrode it).
+ */
+export declare function planVoiceSessionStart(open: VoiceOpenConversation | null): VoiceStartPlan;
+/**
+ * The binding a session starts with. Only the placeholder is taken over at
+ * the tap; every other plan — its own, or attached for a transaction — starts
+ * AWAITING its own, so nothing is created or made active at the tap (and
+ * nothing is withdrawn from the conversation on screen), and an attachment
+ * lasts no longer than the transaction that caused it.
  */
-export type VoiceSessionBinding = string | null | undefined;
+export declare function voiceBindingAtStart(plan: VoiceStartPlan, openAtStart: string | null): VoiceSessionBinding;
+/**
+ * Where ONE spoken entry (a turn, or a local command) of a session still
+ * awaiting its own conversation goes — decided with what the open
+ * conversation holds NOW, not at the tap: a proposal restored after a reload
+ * may have arrived since (BOFF-8128), and a transaction that was open at the
+ * tap may have resolved.
+ *
+ * - `own`: start the session's conversation now, the way a send with no
+ *   conversation open starts one (Auto routing and its consent hold apply
+ *   unchanged), and bind the session to it.
+ * - `adopt`: the open conversation is an empty placeholder; it becomes the
+ *   session's.
+ * - `attach`: into the open conversation, for its waiting proposal or running
+ *   turn; the session still awaits its own.
+ * - `gone`: another conversation was opened since the session started — the
+ *   session is ending, and the entry goes nowhere.
+ */
+export type VoiceSpokenEntry = {
+    kind: "own";
+} | {
+    kind: "adopt";
+    conversationId: string;
+} | {
+    kind: "attach";
+    conversationId: string;
+} | {
+    kind: "gone";
+};
+export declare function planVoiceSpokenEntry(binding: VoiceSessionAwaitingOwn, activeConversationId: string | null, open: VoiceOpenConversation | null): VoiceSpokenEntry;
 /**
  * Keep a live voice session in the conversation it started in.
  *
@@ -25,18 +143,20 @@ export type VoiceSessionBinding = string | null | undefined;
  * answers aloud — into a conversation the person was no longer talking to. The
  * session now ends instead; nothing is moved.
  *
- * A session that started with no conversation adopts the first one that
- * becomes active — the one its own first turn creates. A conversation the
- * session's own turn starts (the send path records it as the new binding
- * first) is not a switch — provided the caller passes where the store is NOW:
- * the send moves the store and the binding together, after the render the
- * caller's effect belongs to.
+ * A session awaiting its own conversation (BOFF-8159 S5) is bound to the one
+ * its own first entry creates. A conversation the session's own turn starts
+ * (the send path records it as the new binding first) is not a switch —
+ * provided the caller passes where the store is NOW: the send moves the store
+ * and the binding together, after the render the caller's effect belongs to.
  */
 export declare function planVoiceSessionBinding(args: {
     sessionLive: boolean;
     bound: VoiceSessionBinding;
     activeConversationId: string | null;
-    /** The bound conversation is still in the store. */
+    /**
+     * The conversation the binding names (`voiceBindingConversationId`) is
+     * still in the store.
+     */
     boundConversationExists: boolean;
 }): {
     bound: VoiceSessionBinding;
@@ -64,7 +184,10 @@ export declare function maySendSpokenTurn(args: {
     /** The session's conversation when the turn was asked. */
     boundAtSubmit: VoiceSessionBinding;
     activeConversationId: string | null;
-    /** `boundAtSubmit` is still in the store. */
+    /**
+     * The conversation `boundAtSubmit` names (`voiceBindingConversationId`) is
+     * still in the store.
+     */
     boundConversationExists: boolean;
 }): boolean;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"voiceReopen.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/voiceReopen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAE5D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,oDAAoD;IACpD,uBAAuB,EAAE,OAAO,CAAC;CAClC,GAAG;IAAE,KAAK,EAAE,mBAAmB,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,CAY/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,gEAAgE;IAChE,WAAW,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,aAAa,EAAE,mBAAmB,CAAC;IACnC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,6CAA6C;IAC7C,uBAAuB,EAAE,OAAO,CAAC;CAClC,GAAG,OAAO,CAOV;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,4BAA4B,EAAE,uBAG1C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,uBAAuB,EACjC,GAAG,EAAE;IACH,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,cAAc,EAAE,mBAAmB,CAAC;IACpC,YAAY,EAAE,OAAO,CAAC;CACvB,GACA;IAAE,KAAK,EAAE,uBAAuB,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAqBnD"}
+{"version":3,"file":"voiceReopen.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/voiceReopen.ts"],"names":[],"mappings":"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"}