@burdenoff/fe-libs 2026.1003.1 → 2026.1003.3

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;AAGpE,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;;IA+uBtE,qEAAqE;;IAErE;;;;;;;OAOG;;IAEH,+DAA+D;;IAE/D;;;;;;;OAOG;;IAIH,0EAA0E;;IAE1E,6DAA6D;;IAE7D,sDAAsD;;;;uCApEvC,MAAM;;;IA2ErB,0EAA0E;qBAhqB1C,iBAAiB;IAkqBjD;;;OAGG;+BAhrBuC,OAAO;IAkrBjD;;;OAGG;0BA/oBE,iBAAiB;EA2qB3B"}
+{"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"}

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

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

package/dist/shared/assistant/uiActions/backStack.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ★ BOFF-8060 (N1a, R2): what "go back" undoes — the assistant's OWN last
+ * navigation, never the browser history (`history.back()` can leave the app).
+ *
+ * Tab-scoped and memory-only: it survives closing and reopening the panel (a
+ * module singleton, not component state) and is never persisted. Pathnames
+ * only, so no filter or search query is kept anywhere.
+ */
+export interface BackEntry {
+    fromPath: string;
+    toPath: string;
+    /** The assistant reply that announced the move. */
+    replyMessageId: string;
+    at: number;
+}
+export declare const BACK_STACK_CAPACITY = 10;
+export interface BackStack {
+    push: (entry: BackEntry) => void;
+    top: () => BackEntry | null;
+    pop: () => BackEntry | null;
+    clear: () => void;
+    size: () => number;
+}
+export declare function createBackStack(capacity?: number): BackStack;
+/** The panel's stack: one per tab. */
+export declare const assistantBackStack: BackStack;
+/**
+ * Can "go back" be carried out right now? Only when the person is still on the
+ * page the assistant took them to AND that move's reply is the newest assistant
+ * message on the surface the command came from. Otherwise "go back" is an
+ * ordinary sentence ("want to go back and change step 2?") and reaches the
+ * model.
+ */
+export declare function isBackRunnable(stack: Pick<BackStack, "top">, currentPath: string, newestAssistantMessageId: string | null): boolean;
+//# sourceMappingURL=backStack.d.ts.map

package/dist/shared/assistant/uiActions/backStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backStack.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/uiActions/backStack.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACjC,GAAG,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IAC5B,GAAG,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,QAAQ,SAAsB,GAAG,SAAS,CAkBzE;AAED,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,EAAE,SAA6B,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAC7B,WAAW,EAAE,MAAM,EACnB,wBAAwB,EAAE,MAAM,GAAG,IAAI,GACtC,OAAO,CAIT"}

package/dist/shared/assistant/uiActions/backStack.js

@@ -0,0 +1,28 @@
+import { pathnameOf as e } from "./navigationOutcome.js";
+//#region src/shared/assistant/uiActions/backStack.ts
+var t = 10;
+function n(t = 10) {
+	let n = [];
+	return {
+		push: (r) => {
+			n.push({
+				...r,
+				fromPath: e(r.fromPath),
+				toPath: e(r.toPath)
+			}), n.length > t && (n = n.slice(n.length - t));
+		},
+		top: () => n[n.length - 1] ?? null,
+		pop: () => n.pop() ?? null,
+		clear: () => {
+			n = [];
+		},
+		size: () => n.length
+	};
+}
+var r = n();
+function i(t, n, r) {
+	let i = t.top();
+	return !i || r === null ? !1 : i.replyMessageId === r && i.toPath === e(n);
+}
+//#endregion
+export { t as BACK_STACK_CAPACITY, r as assistantBackStack, n as createBackStack, i as isBackRunnable };

package/dist/shared/assistant/uiActions/navigateAction.d.ts

@@ -0,0 +1,41 @@
+import { AssistantNavigateAction, AssistantNavigateOutcome, AssistantNavigateVia } from '../conversation';
+import { LocalDestination } from '../localUiCommands';
+import { NavigationOutcome } from './navigationOutcome';
+/** The server keeps a `localAction` of at most 1024 bytes; stay well inside it. */
+export declare const NAVIGATE_RECORD_BUDGET_BYTES = 900;
+export declare function outcomeStatus(outcome: NavigationOutcome): AssistantNavigateOutcome;
+/**
+ * ★ BOFF-8060 (N1a): the history record of a navigation.
+ *
+ * `path` is the registry path; `landedPath` is a PATHNAME ONLY. A record that
+ * would not fit the budget loses `landedPath` first (it is the evidence, not
+ * the identity), so the record is never rejected for size.
+ */
+export declare function buildNavigateAction(input: {
+    destinationId: string;
+    path: string;
+    alreadyHere: boolean;
+    via: AssistantNavigateVia;
+    outcome?: NavigationOutcome;
+}): AssistantNavigateAction;
+/** The registry label of the page at `path` (its target or its own path), or null. */
+export declare function labelForPath(destinations: readonly LocalDestination[], path: string): string | null;
+/** The registry entry at `path`, or null. */
+export declare function destinationForPath(destinations: readonly LocalDestination[], path: string): LocalDestination | null;
+interface SurfaceMessage {
+    id: string;
+    role: string;
+    metadata?: ({
+        voice?: boolean;
+        voiceSessionId?: string;
+    } & Record<string, unknown>) | undefined;
+}
+/**
+ * The newest assistant message on the surface a command came from: the chat
+ * thread for a typed one, that voice session's spoken turns for a spoken one.
+ * A typed command never acts on a voice-only reply the chat view does not
+ * show, and a spoken one never acts on a chat reply.
+ */
+export declare function newestAssistantOnSurface(messages: readonly SurfaceMessage[], voiceSessionId: string | undefined): string | null;
+export {};
+//# sourceMappingURL=navigateAction.d.ts.map

package/dist/shared/assistant/uiActions/navigateAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigateAction.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/uiActions/navigateAction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAc,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,mFAAmF;AACnF,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAQhD,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,wBAAwB,CAElF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,EAAE,oBAAoB,CAAC;IAC1B,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B,GAAG,uBAAuB,CAgB1B;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAC1B,YAAY,EAAE,SAAS,gBAAgB,EAAE,EACzC,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAOf;AAED,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,SAAS,gBAAgB,EAAE,EACzC,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,IAAI,CAQzB;AAED,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,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;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,MAAM,GAAG,IAAI,CAYf"}

package/dist/shared/assistant/uiActions/navigateAction.js

@@ -0,0 +1,40 @@
+import { isCurrentPath as e } from "../localUiCommands.js";
+import { pathnameOf as t } from "./navigationOutcome.js";
+//#region src/shared/assistant/uiActions/navigateAction.ts
+var n = 900, r = 256, i = 128, a = (e) => new TextEncoder().encode(JSON.stringify(e)).length, o = (e) => e.length <= r ? e : t(e).slice(0, r);
+function s(e) {
+	return e.status;
+}
+function c(e) {
+	let n = e.outcome && "landedPath" in e.outcome ? t(e.outcome.landedPath) : void 0, c = {
+		kind: "navigate",
+		destinationId: e.destinationId.length <= i ? e.destinationId : "",
+		path: o(e.path),
+		alreadyHere: e.alreadyHere,
+		via: e.via,
+		...e.outcome ? { outcome: s(e.outcome) } : {}
+	}, l = n !== void 0 && n.length <= r ? {
+		...c,
+		landedPath: n
+	} : c;
+	return a(l) <= 900 ? l : c;
+}
+function l(t, n) {
+	return t.find((t) => [t.path, ...t.aliases ?? []].some((t) => e(t, n)))?.label ?? null;
+}
+function u(t, n) {
+	return t.find((t) => [t.path, ...t.aliases ?? []].some((t) => e(t, n))) ?? null;
+}
+function d(e, t) {
+	for (let n = e.length - 1; n >= 0; --n) {
+		let r = e[n];
+		if (!r || r.role !== "assistant") continue;
+		let i = r.metadata?.voice === !0;
+		if (t === void 0) {
+			if (!i) return r.id;
+		} else if (i && r.metadata?.voiceSessionId === t) return r.id;
+	}
+	return null;
+}
+//#endregion
+export { n as NAVIGATE_RECORD_BUDGET_BYTES, c as buildNavigateAction, u as destinationForPath, l as labelForPath, d as newestAssistantOnSurface, s as outcomeStatus };

package/dist/shared/assistant/uiActions/navigationOutcome.d.ts

@@ -0,0 +1,52 @@
+import { AssistantNavigate } from '../ui/AssistantMarkdownRenderer';
+/**
+ * ★ BOFF-8060 (N1a, C7): never claim success before the landing is checked.
+ *
+ * `navigate(path)` only HANDS the path to the product's router; the router may
+ * redirect it, refuse it, or never get there. The panel used to answer "Opened
+ * X." in the same tick, so a parent entry that redirected to a shell-less login
+ * page was announced as opened while the person watched the panel disappear.
+ *
+ * Pure: the clock, the timer, the location and the shell-less predicate are
+ * injected, so it is tested with a fake clock and no DOM.
+ */
+export type NavigationRefusal = "unsaved-changes" | "not-routable" | "no-router";
+export type NavigationOutcome = {
+    status: "arrived";
+    landedPath: string;
+} | {
+    status: "redirected";
+    landedPath: string;
+} | {
+    status: "new-tab";
+} | {
+    status: "refused";
+    reason: NavigationRefusal;
+} | {
+    status: "unconfirmed";
+};
+export interface NavigationDeps {
+    /** The current pathname + search. */
+    readPath: () => string;
+    /** Milliseconds, monotonic enough to measure a window. */
+    now: () => number;
+    /** Run `fn` once, `ms` from now. A TIMER, never requestAnimationFrame (it stops in a hidden tab). */
+    schedule: (fn: () => void, ms: number) => void;
+    /** Is this path rendered WITHOUT the shell that hosts the panel? */
+    isShellLess: (path: string) => boolean;
+}
+/** Poll interval, quiet window and ceiling (ms). */
+export declare const NAVIGATION_POLL_MS = 50;
+export declare const NAVIGATION_QUIET_MS = 250;
+export declare const NAVIGATION_CEILING_MS = 1500;
+/** The path without query or hash, and without a trailing slash. */
+export declare function pathnameOf(value: string): string;
+/**
+ * Hand `path` to `navigate`, then watch where the location settles.
+ *
+ * Polls every 50 ms and stops when the location has been unchanged for 250 ms
+ * or 1.5 s have passed. A throttled background timer still fires (at about one
+ * second), so the worst case ends by about 2.5 s.
+ */
+export declare function runNavigation(navigate: AssistantNavigate | null, path: string, deps: NavigationDeps): Promise<NavigationOutcome>;
+//# sourceMappingURL=navigationOutcome.d.ts.map

package/dist/shared/assistant/uiActions/navigationOutcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationOutcome.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/uiActions/navigationOutcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAA2B,MAAM,iCAAiC,CAAC;AAGlG;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,cAAc,GAAG,WAAW,CAAC;AAEjF,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAChD;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC;AAE9B,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,0DAA0D;IAC1D,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,qGAAqG;IACrG,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,oEAAoE;IACpE,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC;AAED,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AA2BD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,EAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAwC5B"}