@burdenoff/fe-libs 2026.1023.16 → 2026.1024.2

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

@@ -3,16 +3,18 @@ import { AvatarCopy } from '../useAvatarCopy';
 import { LiveAvatarSnapshot } from './liveAvatarController';
 /**
  * ★ BOFF-9360: whether the avatar can take a typed question's answer now, as the Avatar tab's ask box reads it
- * (`LiveAvatarTabSeam.ask`). Pure, from the snapshot alone: it never asks `route()`, which has side effects.
+ * (`LiveAvatarTabSeam.ask`). From the snapshot and the time (`now`) alone: it never asks `route()`, which has side effects.
  *  - `ready`: on, and nothing in the way;
  *  - `sound-blocked`: on, but the browser blocks its sound until a tap on the frame lifts it (critic m1);
  *  - `ending`: stopping, or near its time limit (`closing`), so no new reply goes to it (critic m1);
  *  - `starting`: being started or joined;
- *  - `locked`: off after a "not now" refusal that said when (`retryAt`): Turn on waits for that time (critic m11);
+ *  - `locked`: off after a "not now" refusal that said when (`retryAt`), until that time (`now`, wall-clock ms): Turn on waits for it
+ *    (critic m11). From that time on it is `off`, even while the snapshot still carries the time: the timer that clears it runs late
+ *    after a system sleep (BOFF-9333 UI-11);
  *  - `off`: off, or being set up (checking, choosing).
  * A device voice (no hosted voice to animate) is not predicted here: the route says so per reply, and the tab's
  * status line already explains it (`needs-hosted-voice`).
  */
-export declare function liveAvatarAskState(snapshot: LiveAvatarSnapshot): LiveAvatarAskState;
+export declare function liveAvatarAskState(snapshot: LiveAvatarSnapshot, now?: number): LiveAvatarAskState;
 /** The words for the avatar's state line: what went wrong, what it is doing, or null. `now`: wall-clock ms, for the retry time. */
 export declare function liveAvatarStatusText(snapshot: LiveAvatarSnapshot, copy: AvatarCopy, now?: number): string | null;

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

@@ -1,11 +1,11 @@
 //#region src/shared/assistant/avatar/live/liveAvatarStatus.ts
-function e(e) {
+function e(e, t = Date.now()) {
 	switch (e.phase) {
 		case "ready": return e.closing ? "ending" : e.audioBlocked ? "sound-blocked" : "ready";
 		case "starting":
 		case "connecting": return "starting";
 		case "ending": return "ending";
-		default: return e.retryAt === null ? "off" : "locked";
+		default: return e.retryAt !== null && e.retryAt > t ? "locked" : "off";
 	}
 }
 function t(e, t, n = Date.now()) {
@@ -14,7 +14,8 @@ function t(e, t, n = Date.now()) {
 	if (e.problem !== null) {
 		let i = e.retryAt, a = i !== null && i > n, o = t.problem(e.problem, {
 			voiceLive: r,
-			timed: a
+			timed: a,
+			budgetScope: e.budgetScope
 		});
 		return a ? `${o} ${t.availableAgain(t.retryTime(i, n))}` : o;
 	}

package/dist/shared/assistant/avatar/useAvatarCopy.d.ts

@@ -1,9 +1,12 @@
 import { AvatarAskBlocker } from '../ui/avatar/avatarAskGate';
 import { VoiceStartBlocker } from '../ui/voice/voiceStartGate';
+import { AvatarBudgetScope } from './live/avatarSessionClient';
 /** What the person can be told went wrong; the adapter maps server codes onto these. */
 export type AvatarProblem = 'unavailable' | 'not-ready' | 'already-running' | 'capacity' | 'rate-limited' | 'paused'
-/** The avatar time allowed for now (the daily credits) is used up; the server says when it comes back. */
- | 'budget-exhausted' | 'start-timeout' | 'provider' | 'connection' | 'needs-hosted-voice' | 'unsupported-browser' | 'playback-blocked';
+/** The avatar time allowed for now (a credit cap) is used up; the server says when it comes back, and whose it is (`budgetScope`). */
+ | 'budget-exhausted' | 'start-timeout' | 'provider'
+/** The avatar vendor's balance is at its floor: nobody's fault, it affects everyone, and no time is said for it. */
+ | 'provider-out-of-credits' | 'connection' | 'needs-hosted-voice' | 'unsupported-browser' | 'playback-blocked';
 export interface AvatarCopy {
     toggle: string;
     toggleHint: string;
@@ -108,7 +111,8 @@ export interface AvatarCopy {
     handsFreeOff: string;
     /**
      * What went wrong. `voiceLive` false: no voice conversation is live, so nothing is said to "continue" (BOFF-9341). `timed`: the next
-     * sentence says when it can start again, so the wording does not also say "in a moment".
+     * sentence says when it can start again, so the wording does not also say "in a moment". `budgetScope`: whose time is used up
+     * (`budget-exhausted` only; BOFF-9333).
      */
     problem: (problem: AvatarProblem, options?: AvatarProblemOptions) => string;
 }
@@ -117,6 +121,8 @@ export interface AvatarProblemOptions {
     readonly voiceLive?: boolean;
     /** A "You can start it again at …" sentence follows. */
     readonly timed?: boolean;
+    /** With `budget-exhausted`, whose budget is used up. Absent or null: the server named none, and the general line is said. */
+    readonly budgetScope?: AvatarBudgetScope | null;
 }
 /**
  * `at` as the reader's locale writes a time, with the date when `at` is not on `now`'s day (a daily limit comes back tomorrow).

package/dist/shared/assistant/avatar/useAvatarCopy.js

@@ -122,9 +122,15 @@ function s() {
 				case "capacity": return r ? i("avatar.problemCapacityTimed", "Avatars are busy right now.") : i("avatar.problemCapacity", "Avatars are busy right now. Try again in a moment.");
 				case "rate-limited": return r ? i("avatar.problemRateLimitedTimed", "You started avatars too quickly.") : i("avatar.problemRateLimited", "You started avatars too quickly. Wait a minute and try again.");
 				case "paused": return i("avatar.problemPaused", "Avatars are paused for now.");
-				case "budget-exhausted": return i("avatar.problemBudgetExhausted", "Avatar time is used up for now.");
+				case "budget-exhausted": switch (t.budgetScope) {
+					case "person": return i("avatar.problemBudgetExhaustedPerson", "Your avatar time is used up for now.");
+					case "workspace": return i("avatar.problemBudgetExhaustedWorkspace", "This workspace’s avatar time is used up for now.");
+					case "everyone": return i("avatar.problemBudgetExhaustedEveryone", "Avatar time is used up for everyone for now.");
+					default: return i("avatar.problemBudgetExhausted", "Avatar time is used up for now.");
+				}
 				case "start-timeout": return i("avatar.problemStartTimeout", "The avatar took too long to start. Try again in a moment.");
 				case "provider": return n ? i("avatar.problemProvider", "The avatar had a problem. Voice continues without it.") : i("avatar.problemProviderNoVoice", "The avatar had a problem.");
+				case "provider-out-of-credits": return i("avatar.problemProviderOutOfCredits", "Avatars aren’t available right now. Try again later.");
 				case "connection": return i("avatar.problemConnection", "The connection to the avatar was lost.");
 				case "needs-hosted-voice": return i("avatar.problemNeedsHostedVoice", "The avatar needs one of the assistant’s own voices. Choose one in the voice settings.");
 				case "unsupported-browser": return i("avatar.problemUnsupportedBrowser", "This browser can’t show the avatar.");

package/dist/shared/assistant/i18nManifest.d.ts

@@ -261,6 +261,9 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly "avatar.handsFreeOff": "Hands-free interrupt is off, so the avatar's voice can't interrupt itself. It stays off after you turn the avatar off; turn it back on in More options. You can still tap to interrupt.";
     readonly "avatar.problemAlreadyRunning": "An avatar is already running for you.";
     readonly "avatar.problemBudgetExhausted": "Avatar time is used up for now.";
+    readonly "avatar.problemBudgetExhaustedEveryone": "Avatar time is used up for everyone for now.";
+    readonly "avatar.problemBudgetExhaustedPerson": "Your avatar time is used up for now.";
+    readonly "avatar.problemBudgetExhaustedWorkspace": "This workspace’s avatar time is used up for now.";
     readonly "avatar.problemCapacity": "Avatars are busy right now. Try again in a moment.";
     readonly "avatar.problemCapacityTimed": "Avatars are busy right now.";
     readonly "avatar.problemConnection": "The connection to the avatar was lost.";
@@ -270,6 +273,7 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly "avatar.problemPlaybackBlocked": "The browser blocked the avatar’s sound. Tap the avatar to turn it on.";
     readonly "avatar.problemProvider": "The avatar had a problem. Voice continues without it.";
     readonly "avatar.problemProviderNoVoice": "The avatar had a problem.";
+    readonly "avatar.problemProviderOutOfCredits": "Avatars aren’t available right now. Try again later.";
     readonly "avatar.problemRateLimited": "You started avatars too quickly. Wait a minute and try again.";
     readonly "avatar.problemRateLimitedTimed": "You started avatars too quickly.";
     readonly "avatar.problemStartTimeout": "The avatar took too long to start. Try again in a moment.";

package/dist/shared/assistant/i18nManifest.js

@@ -155,6 +155,9 @@ var m = {
 	"avatar.handsFreeOff": "Hands-free interrupt is off, so the avatar's voice can't interrupt itself. It stays off after you turn the avatar off; turn it back on in More options. You can still tap to interrupt.",
 	"avatar.problemAlreadyRunning": "An avatar is already running for you.",
 	"avatar.problemBudgetExhausted": "Avatar time is used up for now.",
+	"avatar.problemBudgetExhaustedEveryone": "Avatar time is used up for everyone for now.",
+	"avatar.problemBudgetExhaustedPerson": "Your avatar time is used up for now.",
+	"avatar.problemBudgetExhaustedWorkspace": "This workspace’s avatar time is used up for now.",
 	"avatar.problemCapacity": "Avatars are busy right now. Try again in a moment.",
 	"avatar.problemCapacityTimed": "Avatars are busy right now.",
 	"avatar.problemConnection": "The connection to the avatar was lost.",
@@ -164,6 +167,7 @@ var m = {
 	"avatar.problemPlaybackBlocked": "The browser blocked the avatar’s sound. Tap the avatar to turn it on.",
 	"avatar.problemProvider": "The avatar had a problem. Voice continues without it.",
 	"avatar.problemProviderNoVoice": "The avatar had a problem.",
+	"avatar.problemProviderOutOfCredits": "Avatars aren’t available right now. Try again later.",
 	"avatar.problemRateLimited": "You started avatars too quickly. Wait a minute and try again.",
 	"avatar.problemRateLimitedTimed": "You started avatars too quickly.",
 	"avatar.problemStartTimeout": "The avatar took too long to start. Try again in a moment.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/fe-libs",
-  "version": "2026.1023.16",
+  "version": "2026.1024.2",
   "description": "Burdenoff frontend primitives and domain libraries",
   "type": "module",
   "bin": {