@burdenoff/fe-libs 2026.928.2 → 2026.929.1

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

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

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

@@ -0,0 +1,61 @@
+import { WriteProposalView } from '../writeProposals';
+import { AssistantWriteConfirmDialogProps } from './AssistantWriteConfirmDialog';
+/**
+ * The HIGH-risk confirmation flow (BOFF-7803 5a, unit FE5; OD-12): the
+ * product's own dialog through `confirmWrite` when it has one, fe-libs'
+ * `AssistantWriteConfirmDialog` otherwise.
+ *
+ * ★★ 5a is a safety floor, not the final security boundary. This hook makes
+ * the approve and decline calls itself, through the caller's `actions`, and
+ * only on a person's decision: an exact `'confirmed'` from the product's
+ * dialog (surface `host_modal`) or a press of the default dialog's armed
+ * confirm (surface `assistant_modal`). The product seam never gets `actions`.
+ * The issuing sandbox and wspace-sandbox-svc decide whether anything runs.
+ *
+ * ★ Only the dialog kinds reach it: `review` ignores any proposal whose
+ * confirmation is the card's single button, and any proposal that is not
+ * pending, bound, executable and button-approvable.
+ *
+ * Usage (the panel):
+ *
+ *   const confirm = useWriteProposalConfirm(actions);
+ *   <AssistantWriteProposalCard … onReview={() => confirm.review(view)} />
+ *   <AssistantWriteConfirmDialog {...confirm.dialog} serverNow=… capabilities=…
+ *     turnInFlight=… tr=… />
+ *
+ * Call `dismiss()` when the proposal can no longer be confirmed here (it was
+ * replaced, the conversation or mode changed): that closes the default dialog
+ * and aborts the product's.
+ */
+/** Where a HIGH-risk confirmation was made. */
+export type WriteConfirmDecisionSurface = "assistant_modal" | "host_modal";
+/**
+ * The calls the flow makes. Each is the caller's, bound to the ISSUING sandbox
+ * (`WriteProposalClient`), and handles its own errors: a rejection here only
+ * ends the flow.
+ */
+export interface WriteProposalConfirmActions {
+    /** Approve by button (`method: "button"`), from `surface`. */
+    approve: (view: WriteProposalView, surface: WriteConfirmDecisionSurface) => void | Promise<unknown>;
+    /** Decline by button, from `surface`. */
+    decline: (view: WriteProposalView, reason: "user_declined", surface: WriteConfirmDecisionSurface) => void | Promise<unknown>;
+    /** The proposal was shown in a dialog. */
+    presented: (view: WriteProposalView, surface: "modal") => void | Promise<unknown>;
+}
+export type WriteProposalConfirmDialogBinding = Pick<AssistantWriteConfirmDialogProps, "open" | "view" | "onApprove" | "onDecline" | "onPresented" | "onDismiss">;
+export interface WriteProposalConfirmController {
+    /** The person asked to confirm `view` (the card's "Review & confirm…"). */
+    review: (view: WriteProposalView) => void;
+    /** Close the default dialog and abort the product's, deciding nothing. */
+    dismiss: () => void;
+    /** Spread into `AssistantWriteConfirmDialog`. */
+    dialog: WriteProposalConfirmDialogBinding;
+    /**
+     * ★ BOFF-7803 FE9: a confirmation is being asked right now — the default
+     * dialog is open, or the product's own is. A live voice conversation pauses
+     * listening meanwhile.
+     */
+    asking: boolean;
+}
+export declare function useWriteProposalConfirm(actions: WriteProposalConfirmActions): WriteProposalConfirmController;
+//# sourceMappingURL=useWriteProposalConfirm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useWriteProposalConfirm.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/useWriteProposalConfirm.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AAGtF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,2BAA2B,GAAG,iBAAiB,GAAG,YAAY,CAAC;AAE3E;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8DAA8D;IAC9D,OAAO,EAAE,CACP,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,2BAA2B,KACjC,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,yCAAyC;IACzC,OAAO,EAAE,CACP,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,2BAA2B,KACjC,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7B,0CAA0C;IAC1C,SAAS,EAAE,CACT,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,OAAO,KACb,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAClD,gCAAgC,EAChC,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAC1E,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,2EAA2E;IAC3E,MAAM,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC1C,0EAA0E;IAC1E,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,iDAAiD;IACjD,MAAM,EAAE,iCAAiC,CAAC;IAC1C;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAkCD,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,2BAA2B,GACnC,8BAA8B,CA0IhC"}

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

@@ -0,0 +1,109 @@
+import { useAssistantProduct as e } from "../product.js";
+import { writeProposalUsesDialog as t } from "./AssistantWriteProposalCard.js";
+import { askProductToConfirmWrite as n } from "../writeConfirmSeam.js";
+import { useCallback as r, useEffect as i, useMemo as a, useRef as o, useState as s } from "react";
+//#region src/shared/assistant/ui/useWriteProposalConfirm.ts
+function c(e) {
+	return t(e) && e.status === "pending" && e.approvable && e.execution.enabled === !0 && e.allowedMethods.includes("button");
+}
+async function l(e) {
+	try {
+		await e();
+	} catch {}
+}
+var u = {
+	view: null,
+	open: !1
+};
+function d(t) {
+	let { confirmWrite: d } = e(), f = o(d), p = o(t);
+	i(() => {
+		f.current = d, p.current = t;
+	});
+	let [m, h] = s(u), g = o(u), _ = r((e) => {
+		g.current = e, h(e);
+	}, []), v = o(null), [y, b] = s(!1), x = r((e) => {
+		v.current = e, b(e !== null);
+	}, []), S = r(() => {
+		let e = v.current;
+		x(null), e?.controller.abort();
+	}, [x]);
+	i(() => S, [S]);
+	let C = r((e) => {
+		let t = g.current;
+		t.open && (e !== void 0 && t.view?.proposalId !== e || _({
+			view: t.view,
+			open: !1
+		}));
+	}, [_]), w = r((e) => _({
+		view: e,
+		open: !0
+	}), [_]), T = r((e) => {
+		if (!c(e)) return;
+		let t = e.proposalId;
+		if (v.current?.proposalId === t) return;
+		let r = g.current;
+		if (r.open && r.view?.proposalId === t) return;
+		S(), C();
+		let i = f.current;
+		if (!i) {
+			w(e);
+			return;
+		}
+		let a = {
+			proposalId: t,
+			controller: new AbortController()
+		};
+		x(a);
+		let { signal: o } = a.controller;
+		(async () => {
+			let t = await n(i, e, o);
+			if (!(v.current !== a || o.aborted)) {
+				if (t === "aborted") {
+					x(null);
+					return;
+				}
+				if (t === "default") {
+					x(null), w(e);
+					return;
+				}
+				await l(() => p.current.presented(e, "modal")), !(v.current !== a || o.aborted) && (x(null), t === "approve" ? await l(() => p.current.approve(e, "host_modal")) : await l(() => p.current.decline(e, "user_declined", "host_modal")));
+			}
+		})();
+	}, [
+		S,
+		C,
+		w,
+		x
+	]), E = r(() => {
+		S(), C();
+	}, [S, C]), D = m.view;
+	return {
+		review: T,
+		dismiss: E,
+		dialog: a(() => {
+			let e = D?.proposalId;
+			return {
+				open: m.open,
+				view: D,
+				onApprove: (t) => {
+					if (D) return l(() => p.current.approve(D, t)).then(() => C(e));
+				},
+				onDecline: (t, n) => {
+					if (D) return l(() => p.current.decline(D, t, n)).then(() => C(e));
+				},
+				onPresented: (e) => {
+					D && l(() => p.current.presented(D, e));
+				},
+				onDismiss: () => C(e)
+			};
+		}, [
+			m.open,
+			D,
+			C
+		]),
+		asking: m.open || y
+	};
+}
+//#endregion
+export { d as useWriteProposalConfirm };

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

@@ -0,0 +1,102 @@
+import { AssistantTr } from '../i18n';
+import { WriteProposalMessageRef, WriteProposalSession } from '../writeProposalDiscovery';
+import { WriteProposalApproveSurface, WriteProposalDeclineReason, WriteProposalDecisionSurface, WriteProposalPresentationSurface, WriteProposalView } from '../writeProposals';
+import { WriteReplyDeclineReason } from '../writeReplyBinder';
+import { WriteReplyLiveState, WriteReplyPersonOrigin } from '../writeReplySend';
+/**
+ * The panel's write proposals (BOFF-7803 5a, unit FE7): the records the
+ * ISSUING sandboxes hold, the references the thread keeps to them, and the
+ * calls a person's press makes.
+ *
+ * ★★ 5a is a safety floor, not the final security boundary. Nothing here
+ * authorises a change: the sandbox's store and wspace-sandbox-svc (route
+ * policy, live admin re-check, session relay) decide. The panel draws what
+ * they answer and carries a press to them.
+ *
+ * ★★ Discovery (design §3.1 / FE7): `list` on the session of the sandbox that
+ * ISSUED the proposals, only when that sandbox's own `/health` said
+ * `proposal-v1` —
+ *  - after every settled turn (`afterTurn`),
+ *  - when a conversation opens (`openConversation`),
+ *  - when a card mounts whose record this panel does not hold (`ensureKnown`),
+ *  - every 2 s while one of the session's proposals is executing, stopping at
+ *    the terminal state and when the panel unmounts.
+ *
+ * ★ References, not records, go into the thread: a new live proposal's
+ * `{proposalId, sandboxId, sessionId}` is attached to the reply of the turn
+ * that raised it (or, found later, the newest reply of its session). The view
+ * lives here, in memory, and is replaced by every answer.
+ *
+ * ★ Every refusal or failure a person should know about becomes a system
+ * message through `tr("writeProposal.error.<code>")` (`writeProposalErrorLine`).
+ *
+ * ★★ BOFF-7803 FE8 — declines the panel makes on the person's behalf, all to
+ * the ISSUING sandbox and only ever for PENDING proposals (a change already
+ * running is never withdrawn):
+ *  - a reply that corrects, declines or redirects (`declineForReply`), awaited
+ *    by the send path BEFORE anything is sent; a failure is told;
+ *  - the conversation is left or deleted (`conversation_closed`), the mode is
+ *    switched (`mode_switched`), or its sandbox is replaced by a failover
+ *    (`sandbox_replaced`, after which its cards are inert). These are
+ *    best-effort and silent, and each fires ONCE: a proposal the panel has
+ *    already withdrawn is not withdrawn again by the next event.
+ */
+/** Why the panel withdraws a conversation's waiting changes on its own. */
+export type WriteProposalLifecycleReason = Extract<WriteProposalDeclineReason, "conversation_closed" | "mode_switched">;
+/** One proposal as its issuing sandbox last reported it. */
+export interface WriteProposalEntry {
+    view: WriteProposalView;
+    /** That sandbox's clock at the read the view came from (`list().serverNow`). */
+    serverNow: number;
+    /** Where the proposal lives: its issuing sandbox, session and conversation. */
+    session: WriteProposalSession;
+}
+export type WriteProposalEntries = Readonly<Record<string, WriteProposalEntry>>;
+/** The panel's handle. Stable for the panel's life. */
+export interface WriteProposalPanel {
+    /** A turn in `session` settled; new live proposals attach to its reply. */
+    afterTurn: (session: WriteProposalSession, turnMessageId: string) => void;
+    /** A conversation opened: read every session its cards belong to. */
+    openConversation: (conversationId: string) => void;
+    /** A card mounted: read its session unless this panel already holds it. */
+    ensureKnown: (ref: WriteProposalMessageRef, conversationId: string) => void;
+    /** Confirm pressed (the card's single button, or a dialog's). */
+    approve: (view: WriteProposalView, surface: WriteProposalApproveSurface) => Promise<void>;
+    /** Cancel pressed. */
+    decline: (view: WriteProposalView, reason: "user_declined", surface: WriteProposalDecisionSurface) => Promise<void>;
+    /** The proposal was shown. */
+    presented: (view: WriteProposalView, surface: WriteProposalPresentationSurface) => Promise<void>;
+    /** The latest entry for a proposal, read live. */
+    entry: (proposalId: string) => WriteProposalEntry | undefined;
+    /**
+     * The conversation's waiting changes, for the write-reply binder: how many
+     * are pending (in sandboxes still in use), and whether any card offers its
+     * confirm button.
+     */
+    liveFor: (conversationId: string | null | undefined) => WriteReplyLiveState;
+    /**
+     * A person's reply corrected, declined or redirected: decline every pending
+     * proposal of the conversation, in each session holding one. Resolves once
+     * every sandbox answered (or failed — a failure is told, and the sandbox's
+     * sweep on the next prompt is the backstop), or after
+     * `WRITE_REPLY_DECLINE_WAIT_MS`, so a sandbox that never answers cannot
+     * freeze the panel. Never rejects.
+     */
+    declineForReply: (conversationId: string, reason: WriteReplyDeclineReason, origin: WriteReplyPersonOrigin) => Promise<void>;
+    /** The conversation was left or its mode switched: withdraw, once, best-effort. */
+    withdraw: (conversationId: string, reason: WriteProposalLifecycleReason) => void;
+    /**
+     * A failover replaced this sandbox: withdraw its waiting changes
+     * (`sandbox_replaced`, best-effort) and make its cards inert.
+     */
+    retireSandbox: (sandboxId: string) => void;
+}
+export declare function useWriteProposals(options: {
+    tr: AssistantTr;
+}): {
+    panel: WriteProposalPanel;
+    entries: WriteProposalEntries;
+    /** Sandboxes a failover replaced: their cards are inert. */
+    retiredSandboxes: ReadonlySet<string>;
+};
+//# sourceMappingURL=useWriteProposals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useWriteProposals.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/ui/useWriteProposals.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAKL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAEL,KAAK,2BAA2B,EAEhC,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,gCAAgC,EACrC,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,4BAA4B,GAAG,OAAO,CAChD,0BAA0B,EAC1B,qBAAqB,GAAG,eAAe,CACxC,CAAC;AAEF,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,iBAAiB,CAAC;IACxB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAEhF,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,SAAS,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E,qEAAqE;IACrE,gBAAgB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,2EAA2E;IAC3E,WAAW,EAAE,CAAC,GAAG,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,iEAAiE;IACjE,OAAO,EAAE,CACP,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,2BAA2B,KACjC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,CACP,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,4BAA4B,KAClC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,8BAA8B;IAC9B,SAAS,EAAE,CACT,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,gCAAgC,KACtC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,kDAAkD;IAClD,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,kBAAkB,GAAG,SAAS,CAAC;IAC9D;;;;OAIG;IACH,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,mBAAmB,CAAC;IAC5E;;;;;;;OAOG;IACH,eAAe,EAAE,CACf,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,sBAAsB,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,mFAAmF;IACnF,QAAQ,EAAE,CACR,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,4BAA4B,KACjC,IAAI,CAAC;IACV;;;OAGG;IACH,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AA+ED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IAAE,EAAE,EAAE,WAAW,CAAA;CAAE,GAAG;IAC/D,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4DAA4D;IAC5D,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC,CA0VA"}