@burdenoff/fe-libs 2026.1023.16 → 2026.1024.2

package/dist/shared/assistant/avatar/live/createLiveAvatarSeam.js

@@ -98,8 +98,18 @@ function j() {
 function M(e) {
 	if (!(typeof window > "u")) return (t) => (window.addEventListener(e, t), () => window.removeEventListener(e, t));
 }
-function N(e = {}) {
-	let t = e.preferences ?? O, n = e.controller ?? {}, r = n.subscribeWorkspaceChange ?? M("burdenoff:workspace-changed"), i = n.subscribePageHide ?? M("pagehide"), a = p({
+function N() {
+	if (!(typeof window > "u" || typeof document > "u")) return (e) => {
+		let t = window, n = document, r = () => {
+			n.visibilityState === "visible" && e();
+		};
+		return n.addEventListener("visibilitychange", r), t.addEventListener("pageshow", e), () => {
+			n.removeEventListener("visibilitychange", r), t.removeEventListener("pageshow", e);
+		};
+	};
+}
+function P(e = {}) {
+	let t = e.preferences ?? O, n = e.controller ?? {}, r = n.subscribeWorkspaceChange ?? M("burdenoff:workspace-changed"), i = n.subscribePageHide ?? M("pagehide"), a = n.subscribePageShow ?? N(), o = n.now ?? (() => Date.now()), u = p({
 		client: e.client ?? D(),
 		openRoom: e.openRoom ?? m,
 		scheduler: e.scheduler ?? s,
@@ -111,10 +121,11 @@ function N(e = {}) {
 		}),
 		startMeter: n.startMeter ?? ((e, t) => typeof MediaStream > "u" ? null : c(new MediaStream([e]), t)),
 		browserSupported: e.browserSupported ?? (() => w()),
-		now: n.now ?? (() => Date.now()),
+		now: o,
 		newIdempotencyKey: n.newIdempotencyKey ?? (() => d()),
 		...r ? { subscribeWorkspaceChange: r } : {},
 		...i ? { subscribePageHide: i } : {},
+		...a ? { subscribePageShow: a } : {},
 		...n.idleMs === void 0 ? {} : { idleMs: n.idleMs },
 		...n.endBeforeDeadlineMs === void 0 ? {} : { endBeforeDeadlineMs: n.endBeforeDeadlineMs },
 		...n.connectTimeoutMs === void 0 ? {} : { connectTimeoutMs: n.connectTimeoutMs },
@@ -123,53 +134,53 @@ function N(e = {}) {
 		...n.stallMs === void 0 ? {} : { stallMs: n.stallMs },
 		...n.readinessProbe === void 0 ? {} : { readinessProbe: n.readinessProbe },
 		...e.onLog ? { onLog: e.onLog } : {}
-	}), o = b(e.avatarVoices), u = e.avatarImages === void 0 ? null : _(e.avatarImages), f = e.avatarVoiceStore ?? k, T = () => f.getState(), E = (n, r) => {
-		let i = v(T(), {
-			avatarVoices: o,
+	}), f = b(e.avatarVoices), T = e.avatarImages === void 0 ? null : _(e.avatarImages), E = e.avatarVoiceStore ?? k, P = () => E.getState(), F = (n, r) => {
+		let i = v(P(), {
+			avatarVoices: f,
 			avatarId: t.getState().avatarId,
 			...e.defaultAvatarVoiceMode ? { hostDefault: e.defaultAvatarVoiceMode } : {}
 		});
 		return i === null ? null : y(i, n, r.listVoices());
-	}, N = (e, t) => {
+	}, I = (e, t) => {
 		let n = {
 			...e,
 			voice: t
 		};
-		return n.audioOutput = x(a.createOutput(), () => {
+		return n.audioOutput = x(u.createOutput(), () => {
 			n.voice = e.voice;
-		}, (e) => a.subscribe(() => {
-			a.getSnapshot().phase !== "ready" && e();
+		}, (e) => u.subscribe(() => {
+			u.getSnapshot().phase !== "ready" && e();
 		})), n;
 	};
 	return {
 		decorateSpeechEngine: (e) => {
 			let t = (t) => {
-				let n = E(t.lang, e), r = n === null ? t : {
+				let n = F(t.lang, e), r = n === null ? t : {
 					...t,
 					voice: n
 				};
 				return {
 					voice: n,
-					target: a.route(r, e)
+					target: u.route(r, e)
 				};
 			}, n = null, r = () => {
 				let e = n;
 				n = null, e?.();
 			}, i = (t, r, i) => {
-				let o = !0, s = !1, c = () => void 0, l = () => {
-					o && (o = !1, n === l && (n = null), c());
-				}, u = () => s ? !1 : (s = !0, l(), !0), d = () => {
-					!o || !u() || (e.cancel(), i?.onError?.("output-left"));
+				let a = !0, o = !1, s = () => void 0, c = () => {
+					a && (a = !1, n === c && (n = null), s());
+				}, l = () => o ? !1 : (o = !0, c(), !0), d = () => {
+					!a || !l() || (e.cancel(), i?.onError?.("output-left"));
 				};
-				c = a.subscribe(() => {
-					a.getSnapshot().phase !== "ready" && d();
-				}), n = l, r.audioOutput &&= A(r.audioOutput, d), r.fallback = !1, e.speak(t, r, {
+				s = u.subscribe(() => {
+					u.getSnapshot().phase !== "ready" && d();
+				}), n = c, r.audioOutput &&= A(r.audioOutput, d), r.fallback = !1, e.speak(t, r, {
 					...i,
 					onEnd: () => {
-						u() && i?.onEnd?.();
+						l() && i?.onEnd?.();
 					},
 					onError: (e) => {
-						u() && i?.onError?.(e);
+						l() && i?.onError?.(e);
 					}
 				});
 			};
@@ -179,26 +190,26 @@ function N(e = {}) {
 				listVoices: () => e.listVoices(),
 				subscribeVoices: (t) => e.subscribeVoices(t),
 				wouldSpeakOnAvatar: (e) => t(e).target === "avatar",
-				speak: (n, o, s) => {
+				speak: (n, a, o) => {
 					r();
-					let { voice: c, target: l } = t(o);
-					if (l !== "avatar") {
-						if (o.avatarOnly === !0) {
-							e.cancel(), s?.onError?.("output-left");
+					let { voice: s, target: c } = t(a);
+					if (c !== "avatar") {
+						if (a.avatarOnly === !0) {
+							e.cancel(), o?.onError?.("output-left");
 							return;
 						}
-						e.speak(n, o, s);
+						e.speak(n, a, o);
 						return;
 					}
-					let u = c === null ? {
-						...o,
-						audioOutput: a.createOutput()
-					} : N(o, c);
-					if (o.avatarOnly === !0) {
-						i(n, u, s);
+					let l = s === null ? {
+						...a,
+						audioOutput: u.createOutput()
+					} : I(a, s);
+					if (a.avatarOnly === !0) {
+						i(n, l, o);
 						return;
 					}
-					e.speak(n, u, s);
+					e.speak(n, l, o);
 				},
 				cancel: () => {
 					r(), e.cancel();
@@ -206,7 +217,7 @@ function N(e = {}) {
 			};
 		},
 		Stage: ({ expanded: t, fallback: n }) => /* @__PURE__ */ C(g, {
-			controller: a,
+			controller: u,
 			expanded: t,
 			fallback: n,
 			...e.avatarNames ? { avatarNames: e.avatarNames } : {}
@@ -214,33 +225,33 @@ function N(e = {}) {
 		enabled: {
 			subscribe: (e) => t.subscribe(e),
 			getSnapshot: () => t.getState().avatarEnabled,
-			switchOff: () => a.switchOff(),
-			voiceLive: (e) => a.setVoiceLive(e)
+			switchOff: () => u.switchOff(),
+			voiceLive: (e) => u.setVoiceLive(e)
 		},
 		tab: {
 			offered: {
-				subscribe: (e) => a.subscribe(e),
-				getSnapshot: () => a.getSnapshot().tabOffered
+				subscribe: (e) => u.subscribe(e),
+				getSnapshot: () => u.getSnapshot().tabOffered
 			},
 			ask: {
-				subscribe: (e) => a.subscribe(e),
-				getSnapshot: () => h(a.getSnapshot())
+				subscribe: (e) => u.subscribe(e),
+				getSnapshot: () => h(u.getSnapshot(), o())
 			},
-			setOpen: (e) => a.setTabOpen(e),
-			heldByVoice: () => a.getSnapshot().heldByVoice,
+			setOpen: (e) => u.setTabOpen(e),
+			heldByVoice: () => u.getSnapshot().heldByVoice,
 			View: (t) => /* @__PURE__ */ C(S, {
 				...t,
-				controller: a,
-				avatarVoices: o,
-				voiceStore: f,
+				controller: u,
+				avatarVoices: f,
+				voiceStore: E,
 				...e.avatarNames ? { avatarNames: e.avatarNames } : {},
-				...u ? { avatarImages: u } : {},
+				...T ? { avatarImages: T } : {},
 				...e.defaultAvatarVoiceMode ? { defaultAvatarVoiceMode: e.defaultAvatarVoiceMode } : {}
 			})
 		},
-		controller: a,
-		dispose: () => a.dispose()
+		controller: u,
+		dispose: () => u.dispose()
 	};
 }
 //#endregion
-export { N as createLiveAvatarSeam, w as isLiveAvatarBrowserSupported, T as liveAvatarAuthorization, E as liveAvatarWorkspaceAuthorization };
+export { P as createLiveAvatarSeam, w as isLiveAvatarBrowserSupported, T as liveAvatarAuthorization, E as liveAvatarWorkspaceAuthorization };

package/dist/shared/assistant/avatar/live/liveAvatarController.d.ts

@@ -4,7 +4,7 @@ import { AvatarMeterHandle } from './avatarAudioMeter';
 import { AvatarRoom, AvatarScheduler } from './avatarPorts';
 import { AvatarTrackerConfig } from './avatarPlaybackTracker';
 import { AvatarDecodedPiece, AvatarNotice, AvatarReplyOutputs } from './avatarReplyOutputs';
-import { AvatarClientEndReason, AvatarSessionClient } from './avatarSessionClient';
+import { AvatarBudgetScope, AvatarClientEndReason, AvatarSessionClient } from './avatarSessionClient';
 import { AvatarReadinessProbeOptions } from './avatarTransport';
 /** End after this long without a reply on the avatar while it is on (OD8, BACKEND-DESIGN §8.7). */
 export declare const LIVE_AVATAR_IDLE_MS = 120000;
@@ -46,9 +46,9 @@ export interface LiveAvatarSnapshot {
     readonly tabOffered: boolean;
     /**
      * After a "not now" refusal that said when (the server's Retry-After): the wall-clock ms a start may be tried again. Null otherwise.
-     * It goes with `problem`: cleared together, and both clear by themselves when the time comes. A newer refusal (including a question
-     * that failed or was answered "not offered"), a workspace switch and a voice conversation starting outside the Avatar tab clear them
-     * earlier.
+     * It goes with `problem`: cleared together, and both clear by themselves when the time comes (its timer, or `recheckRetry` when the
+     * page is shown again after a system sleep made that timer late). A newer refusal (including a question that failed or was answered
+     * "not offered"), a workspace switch and a voice conversation starting outside the Avatar tab clear them earlier.
      */
     readonly retryAt: number | null;
     /** The avatar was turned on outside the tab during the voice conversation that is still live: closing the tab hands it back to Voice. */
@@ -66,6 +66,11 @@ export interface LiveAvatarSnapshot {
     /** What the person must read before the avatar starts; null until the server said which version. */
     readonly consentVersion: string | null;
     readonly problem: AvatarProblem | null;
+    /**
+     * With the problem `budget-exhausted`, whose budget is used up when the server said (BOFF-9333): the person's own, their workspace's,
+     * or everyone's. Null otherwise: no scope sent (today's server), or another problem. It goes with `problem`, as `retryAt` does.
+     */
+    readonly budgetScope: AvatarBudgetScope | null;
     readonly notice: LiveAvatarNotice | null;
     /** The browser blocks the avatar's sound; a tap on the stage (`resumeAudio`) lifts it. */
     readonly audioBlocked: boolean;
@@ -112,11 +117,19 @@ export interface LiveAvatarControllerDeps {
     readonly startMeter: (track: MediaStreamTrack, onChange: (audible: boolean) => void) => AvatarMeterHandle | null;
     /** The browser can show the avatar at all (desktop Chromium first: GATE1B §10). */
     readonly browserSupported: () => boolean;
-    /** Wall-clock milliseconds: only the fallback for `endsAt` when the server announced no session length (the server's clock may differ). */
+    /**
+     * Wall-clock milliseconds: a refusal's retry time (`retryAt`), its lock and its re-check (`recheckRetry`); also the fallback for
+     * `endsAt` when the server announced no session length (the server's clock may differ).
+     */
     readonly now: () => number;
     readonly newIdempotencyKey: () => string;
     readonly subscribeWorkspaceChange?: (listener: () => void) => () => void;
     readonly subscribePageHide?: (listener: () => void) => () => void;
+    /**
+     * The page is shown again (its document visible again, or shown from the back/forward cache): the listener is `recheckRetry`. The
+     * scheduler's monotonic clock does not count a system sleep, so after one a refusal's timer fires late; the wall clock (`now`) does.
+     */
+    readonly subscribePageShow?: (listener: () => void) => () => void;
     readonly idleMs?: number;
     readonly endBeforeDeadlineMs?: number;
     readonly connectTimeoutMs?: number;
@@ -152,6 +165,13 @@ export interface LiveAvatarController {
      * time (`retryAt`) that has not come.
      */
     confirm(): void;
+    /**
+     * BOFF-9333 UI-11: once the wall clock has reached a refusal's retry time (`retryAt`), clear the refusal now, as its timer does: the
+     * problem, whose budget it was, the time, and the timer with them. That timer runs on the scheduler's monotonic clock, which a system
+     * sleep stops (macOS, Linux), so after one it fires late. Runs when the page is shown again (`subscribePageShow`); a host with its own
+     * wake signal may call it too. With no time, or before it, it does nothing: nothing is cleared early, and the timer stays as it is.
+     */
+    recheckRetry(): void;
     /**
      * The Avatar tab opened or closed (BOFF-9341). Open: the avatar may be asked for with no voice conversation, and an avatar already on
      * is adopted; a question already in flight is asked again, choose only. Close: any question, choice or session ends as the person's