@burdenoff/fe-libs 2026.1024.3 → 2026.1026.1

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

@@ -19,6 +19,63 @@ export type AvatarAvailabilityReason = (typeof AVAILABILITY_REASONS)[number];
  */
 declare const BUDGET_SCOPES: readonly ["person", "workspace", "everyone"];
 export type AvatarBudgetScope = (typeof BUDGET_SCOPES)[number];
+/** BOFF-9446: the only `minutes.version` this client reads (contract v2). A block of any other version reads as no block. */
+export declare const AVATAR_MINUTES_CONTRACT_VERSION = 2;
+/** BOFF-9446: the states of an availability `minutes` block. Any other value reads as no block. */
+export declare const AVATAR_MINUTES_STATES: readonly ["AVAILABLE", "IN_USE", "EXHAUSTED", "UNAVAILABLE"];
+export type AvatarMinutesState = (typeof AVATAR_MINUTES_STATES)[number];
+/**
+ * BOFF-9446: why no credits are left for this person. `FREE_CEILING`: their free credits for the month are used (plan credits would
+ * still work); `ZERO_SESSION_LIMIT`: too many sessions today that charged nothing (a 402 only, until the next UTC midnight; a plan does
+ * not lift it); `NOT_INCLUDED`: this workspace has no avatar credits at all; `OWN_SESSION`: the credits left are held by this person's
+ * own session on another device (a block's IN_USE only). Any other value reads as none.
+ */
+export declare const AVATAR_MINUTES_REASONS: readonly ["FREE_CEILING", "ZERO_SESSION_LIMIT", "NOT_INCLUDED", "OWN_SESSION"];
+export type AvatarMinutesReason = (typeof AVATAR_MINUTES_REASONS)[number];
+/**
+ * BOFF-9446: the balance of an AVAILABLE, IN_USE or EXHAUSTED block, the workspace's. Counts are whole credits (1 credit = 1 minute of
+ * avatar time), 0 or more.
+ */
+export interface AvatarMinutesBalance {
+    /** Credits left for this person now: carried, then free within their ceiling, then plan. */
+    readonly availableMinutes: number;
+    /** Reserved by open sessions in the workspace. */
+    readonly heldMinutes: number;
+    /** The workspace's free credits each month; 0 without a free allowance. */
+    readonly freeMinutesPerMonth: number;
+    /** The workspace's free credits left this month, before the person's ceiling. */
+    readonly freeRemaining: number;
+    /** The credits the workspace's counted plans give each month, summed. */
+    readonly planMinutesPerMonth: number;
+    readonly planRemaining: number;
+    /** Credits given back by a full-session credit, still unused. */
+    readonly carriedRemaining: number;
+    /** The free credits one person may use each month, across workspaces; null while billing has the ceiling off. */
+    readonly personFreeCeiling: number | null;
+    /** This person's free credits left this month; null while billing has the ceiling off. */
+    readonly personFreeRemaining: number | null;
+    /** When the free and plan credits reset (the next 1st, 00:00 UTC), as UTC epoch milliseconds: shown as a UTC date, never local. */
+    readonly resetsAt: number;
+    /** A plan with more avatar credits exists for this app: display only (it offers "See plans"), never an entitlement. */
+    readonly morePlanCreditsAvailable: boolean;
+}
+/** BOFF-9446: the availability `minutes` block, as the client keeps it. */
+export interface AvatarMinutes {
+    readonly state: AvatarMinutesState;
+    /** When the server gave one the client knows, where it may stand: OWN_SESSION with IN_USE, FREE_CEILING or NOT_INCLUDED with EXHAUSTED. */
+    readonly reason: AvatarMinutesReason | null;
+    /** With AVAILABLE, IN_USE and EXHAUSTED; null with UNAVAILABLE, which carries no numbers. */
+    readonly balance: AvatarMinutesBalance | null;
+    /** W, the seconds of the stale-presence margin the counting rules name (20 to 120); null when the answer had none in that range. */
+    readonly staleSeconds: number | null;
+}
+/** BOFF-9446: what a start answer says about the session's minutes (enforce only). */
+export interface AvatarSessionMinutes {
+    /** The minutes reserved for this session, 1 or more. */
+    readonly reserved: number;
+    /** The session's length D' is shorter than the server's D: a session that reaches D' ends because its minutes ran out. */
+    readonly limitedByBalance: boolean;
+}
 export interface AvatarAvailability {
     readonly available: boolean;
     readonly reason: AvatarAvailabilityReason | null;
@@ -28,6 +85,8 @@ export interface AvatarAvailability {
     readonly consentVersion: string;
     /** The server's session cap, D. */
     readonly maxSessionSeconds: number;
+    /** ★ BOFF-9446: the avatar-minutes block (enforce only). Absent when the answer had none, or none the client can read. */
+    readonly minutes?: AvatarMinutes;
 }
 export interface AvatarSessionStart {
     readonly sessionId: string;
@@ -40,6 +99,10 @@ export interface AvatarSessionStart {
     readonly connectBy: number;
     /** Wall-clock milliseconds: the server's hard end (create + D - 5 s). */
     readonly endsAt: number;
+    /** ★ BOFF-9446: D', this session's own length in seconds (enforce only): its hard end is create + D' - 5 s. */
+    readonly maxSessionSeconds?: number;
+    /** ★ BOFF-9446: the session's minutes (enforce only). */
+    readonly minutes?: AvatarSessionMinutes;
 }
 export type AvatarSessionState = 'starting' | 'ready' | 'ending' | 'ended' | 'failed' | 'canceled';
 export interface AvatarSessionStatus {
@@ -58,11 +121,15 @@ export declare class AvatarApiError extends Error {
     readonly retryAfterSeconds: number | null;
     /** On `budget_exhausted` only, whose budget the body names when it is one of the three we know; null in every other answer. */
     readonly scope: AvatarBudgetScope | null;
+    /** ★ BOFF-9446: on `minutes_exhausted` only, the body's reason when the client knows it; null otherwise. */
+    readonly minutesReason: AvatarMinutesReason | null;
     constructor(status: number, 
     /** The server's or the gateway's code, `invalid_response` for a body we refused, `network` for no answer. */
     code: string, retryAfterSeconds: number | null, 
     /** On `budget_exhausted` only, whose budget the body names when it is one of the three we know; null in every other answer. */
-    scope?: AvatarBudgetScope | null);
+    scope?: AvatarBudgetScope | null, 
+    /** ★ BOFF-9446: on `minutes_exhausted` only, the body's reason when the client knows it; null otherwise. */
+    minutesReason?: AvatarMinutesReason | null);
 }
 export interface AvatarSessionClientOptions {
     /** `https://<gateway>/api/avatar/v1` (avatarApiBaseFromTtsEndpoint). */
@@ -120,6 +187,8 @@ export interface AvatarRefusal {
      * Absent when it named none (today's server) and with every other refusal: the person is then told the general line.
      */
     readonly scope?: AvatarBudgetScope;
+    /** ★ BOFF-9446: with `minutes-exhausted`, the reason the server gave, when the client knows it. Absent otherwise. */
+    readonly minutesReason?: AvatarMinutesReason;
 }
 /**
  * The person's side of every failure (§3.4): the normal voice always continues; this says what to show. 404 means "not here" (the module
@@ -132,4 +201,11 @@ export declare function avatarRefusalFor(error: unknown): AvatarRefusal;
  * enabled, not permitted), or only not now when the gateway could not check the permission (`unavailable`): the toggle stays.
  */
 export declare function avatarAvailabilityRefusal(reason: AvatarAvailabilityReason | null): AvatarRefusal;
+/**
+ * ★ BOFF-9446: what a minutes block means for a start, as the server's create would answer it: EXHAUSTED and IN_USE cannot start a
+ * session, so the person is told why instead of sending a create that would be refused (and, for IN_USE with OWN_SESSION, that would
+ * meet the person's own session on another device). AVAILABLE can, and UNAVAILABLE stays startable as the retry (the server decides).
+ * No block, today's answers: nothing in the way. Never a reason to hide, and no time (an availability answer carries no Retry-After).
+ */
+export declare function avatarMinutesRefusal(minutes: AvatarMinutes | null | undefined): AvatarRefusal | null;
 export {};

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

@@ -23,16 +23,34 @@ var o = [
 	"person",
 	"workspace",
 	"everyone"
-], c = class extends Error {
+], c = 2, l = [
+	"AVAILABLE",
+	"IN_USE",
+	"EXHAUSTED",
+	"UNAVAILABLE"
+], u = [
+	"FREE_CEILING",
+	"ZERO_SESSION_LIMIT",
+	"NOT_INCLUDED",
+	"OWN_SESSION"
+], d = {
+	IN_USE: ["OWN_SESSION"],
+	EXHAUSTED: ["FREE_CEILING", "NOT_INCLUDED"]
+}, f = [
+	"FREE_CEILING",
+	"ZERO_SESSION_LIMIT",
+	"NOT_INCLUDED"
+], p = class extends Error {
 	status;
 	code;
 	retryAfterSeconds;
 	scope;
-	constructor(e, t, n, r = null) {
-		super(`avatar api ${e} ${t}`), this.status = e, this.code = t, this.retryAfterSeconds = n, this.scope = r, this.name = "AvatarApiError";
+	minutesReason;
+	constructor(e, t, n, r = null, i = null) {
+		super(`avatar api ${e} ${t}`), this.status = e, this.code = t, this.retryAfterSeconds = n, this.scope = r, this.minutesReason = i, this.name = "AvatarApiError";
 	}
 };
-function l(e = globalThis.crypto) {
+function m(e = globalThis.crypto) {
 	if (e && typeof e.randomUUID == "function") return e.randomUUID();
 	let t = new Uint8Array(16);
 	if (e && typeof e.getRandomValues == "function") e.getRandomValues(t);
@@ -41,43 +59,96 @@ function l(e = globalThis.crypto) {
 	let n = [...t].map((e) => e.toString(16).padStart(2, "0")).join("");
 	return `${n.slice(0, 8)}-${n.slice(8, 12)}-${n.slice(12, 16)}-${n.slice(16, 20)}-${n.slice(20)}`;
 }
-function u(e) {
+function h(e) {
 	return typeof e == "object" && !!e && !Array.isArray(e);
 }
-function d(e, t) {
+function g(e, t) {
 	let n = e.headers.get("retry-after"), r = n === null || n.trim() === "" ? NaN : Number(n);
 	if (Number.isFinite(r) && r >= 0) return r;
-	let i = u(t) && u(t.error) ? Number(t.error.retryAfterSeconds) : NaN;
+	let i = h(t) && h(t.error) ? Number(t.error.retryAfterSeconds) : NaN;
 	return Number.isFinite(i) && i >= 0 ? i : null;
 }
-async function f(e) {
+async function _(e) {
 	try {
 		return await e.json();
 	} catch {
 		return null;
 	}
 }
-function p(e, t) {
-	if (e !== "budget_exhausted" || !u(t) || !u(t.error)) return null;
+function v(e, t) {
+	if (e !== "budget_exhausted" || !h(t) || !h(t.error)) return null;
 	let { scope: n } = t.error;
 	return s.find((e) => e === n) ?? null;
 }
-async function m(e) {
-	let t = await f(e), n = u(t) && u(t.error) && typeof t.error.code == "string" ? t.error.code : "http_error";
-	return new c(e.status, n, d(e, t), p(n, t));
+async function y(e) {
+	let t = await _(e), n = h(t) && h(t.error) && typeof t.error.code == "string" ? t.error.code : "http_error", r = n === "minutes_exhausted" && h(t) && h(t.error) ? b(t.error.reason, f) : null;
+	return new p(e.status, n, g(e, t), v(n, t), r);
 }
-function h(e) {
-	if (!u(e) || typeof e.available != "boolean") throw new c(200, "invalid_response", null);
-	let t = Array.isArray(e.avatars) ? e.avatars.flatMap((e) => u(e) && typeof e.id == "string" && r.test(e.id) ? [e.id] : []) : [], n = o.find((t) => t === e.reason) ?? null, i = typeof e.consentVersion == "string" ? e.consentVersion : "", a = typeof e.maxSessionSeconds == "number" && Number.isFinite(e.maxSessionSeconds) ? e.maxSessionSeconds : 0, s = e.available && t.length > 0 && i !== "" && a > 0;
+function b(e, t) {
+	return t.find((t) => t === e) ?? null;
+}
+function x(e) {
+	return typeof e == "number" && Number.isSafeInteger(e) && e >= 0 ? e : null;
+}
+function S(e) {
+	return e === null ? null : x(e) ?? void 0;
+}
+function C(e) {
+	if (typeof e != "string" || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(e)) return null;
+	let t = Date.parse(e);
+	return Number.isFinite(t) && new Date(t).toISOString() === e ? t : null;
+}
+function w(e) {
+	let t = x(e.availableMinutes), n = x(e.heldMinutes), r = x(e.freeMinutesPerMonth), i = x(e.freeRemaining), a = x(e.planMinutesPerMonth), o = x(e.planRemaining), s = x(e.carriedRemaining), c = S(e.personFreeCeiling), l = S(e.personFreeRemaining), u = C(e.resetsAt), { morePlanCreditsAvailable: d } = e;
+	return t === null || n === null || r === null || i === null || a === null || o === null || s === null || c === void 0 || l === void 0 || u === null || typeof d != "boolean" ? null : {
+		availableMinutes: t,
+		heldMinutes: n,
+		freeMinutesPerMonth: r,
+		freeRemaining: i,
+		planMinutesPerMonth: a,
+		planRemaining: o,
+		carriedRemaining: s,
+		personFreeCeiling: c,
+		personFreeRemaining: l,
+		resetsAt: u,
+		morePlanCreditsAvailable: d
+	};
+}
+function T(e) {
+	if (!h(e) || e.version !== 2) return null;
+	let t = l.find((t) => t === e.state);
+	if (t === void 0) return null;
+	let n = null;
+	if (t !== "UNAVAILABLE" && (n = w(e), n === null || (t === "AVAILABLE" ? n.availableMinutes < 1 : n.availableMinutes !== 0))) return null;
+	let r = e.staleSeconds;
+	return {
+		state: t,
+		reason: b(e.reason, d[t] ?? []),
+		balance: n,
+		staleSeconds: typeof r == "number" && Number.isSafeInteger(r) && r >= 20 && r <= 120 ? r : null
+	};
+}
+function E(e) {
+	if (!h(e)) return null;
+	let t = x(e.reserved);
+	return t === null || t < 1 || typeof e.limitedByBalance != "boolean" ? null : {
+		reserved: t,
+		limitedByBalance: e.limitedByBalance
+	};
+}
+function D(e) {
+	if (!h(e) || typeof e.available != "boolean") throw new p(200, "invalid_response", null);
+	let t = Array.isArray(e.avatars) ? e.avatars.flatMap((e) => h(e) && typeof e.id == "string" && r.test(e.id) ? [e.id] : []) : [], n = o.find((t) => t === e.reason) ?? null, i = typeof e.consentVersion == "string" ? e.consentVersion : "", a = typeof e.maxSessionSeconds == "number" && Number.isFinite(e.maxSessionSeconds) ? e.maxSessionSeconds : 0, s = e.available && t.length > 0 && i !== "" && a > 0, c = T(e.minutes);
 	return {
 		available: s,
 		reason: s ? null : n ?? "not_enabled",
 		avatars: t,
 		consentVersion: i,
-		maxSessionSeconds: a
+		maxSessionSeconds: a,
+		...c === null ? {} : { minutes: c }
 	};
 }
-function g(e) {
+function O(e) {
 	try {
 		let n = new URL(e);
 		return n.protocol === "wss:" ? !0 : n.protocol === "ws:" && t.has(n.hostname.toLowerCase());
@@ -85,20 +156,23 @@ function g(e) {
 		return !1;
 	}
 }
-function _(e) {
-	if (!u(e)) throw new c(201, "invalid_response", null);
-	let { sessionId: t, livekitUrl: r, participantToken: i, avatarIdentity: a, connectBy: o, endsAt: s } = e, l = typeof o == "string" ? Date.parse(o) : NaN, d = typeof s == "string" ? Date.parse(s) : NaN;
-	if (typeof t != "string" || !n.test(t) || typeof r != "string" || !g(r) || typeof i != "string" || i === "" || typeof a != "string" || a === "" || !Number.isFinite(l) || !Number.isFinite(d)) throw new c(201, "invalid_response", null);
+function k(e) {
+	if (!h(e)) throw new p(201, "invalid_response", null);
+	let { sessionId: t, livekitUrl: r, participantToken: i, avatarIdentity: a, connectBy: o, endsAt: s } = e, c = typeof o == "string" ? Date.parse(o) : NaN, l = typeof s == "string" ? Date.parse(s) : NaN;
+	if (typeof t != "string" || !n.test(t) || typeof r != "string" || !O(r) || typeof i != "string" || i === "" || typeof a != "string" || a === "" || !Number.isFinite(c) || !Number.isFinite(l)) throw new p(201, "invalid_response", null);
+	let { maxSessionSeconds: u } = e, d = typeof u == "number" && Number.isSafeInteger(u) && u > 0 ? u : null, f = E(e.minutes);
 	return {
 		sessionId: t,
 		livekitUrl: r,
 		participantToken: i,
 		avatarIdentity: a,
-		connectBy: l,
-		endsAt: d
+		connectBy: c,
+		endsAt: l,
+		...d === null ? {} : { maxSessionSeconds: d },
+		...f === null ? {} : { minutes: f }
 	};
 }
-var v = [
+var A = [
 	"starting",
 	"ready",
 	"ending",
@@ -106,22 +180,22 @@ var v = [
 	"failed",
 	"canceled"
 ];
-function y(e, t) {
-	if (!u(e) || !v.includes(e.state)) throw new c(200, "invalid_response", null);
+function j(e, t) {
+	if (!h(e) || !A.includes(e.state)) throw new p(200, "invalid_response", null);
 	return {
 		sessionId: t,
 		state: e.state,
 		endedReason: typeof e.endedReason == "string" ? e.endedReason : null
 	};
 }
-var b = (e) => new Promise((t) => {
+var M = (e) => new Promise((t) => {
 	setTimeout(t, e);
 });
-function x(e) {
-	let t = e.fetchImpl ?? ((e, t) => fetch(e, t)), a = e.sleep ?? b, o = e.now ?? (() => Date.now()), s = e.startInProgressBudgetMs ?? 15e3, l = e.baseUrl.replace(/\/+$/, "");
-	async function u(t, n = null) {
+function N(e) {
+	let t = e.fetchImpl ?? ((e, t) => fetch(e, t)), a = e.sleep ?? M, o = e.now ?? (() => Date.now()), s = e.startInProgressBudgetMs ?? 15e3, c = e.baseUrl.replace(/\/+$/, "");
+	async function l(t, n = null) {
 		let r = e.getAuthorization();
-		if (!r) throw new c(401, "unauthenticated", null);
+		if (!r) throw new p(401, "unauthenticated", null);
 		let i = { authorization: r };
 		if (t) {
 			let t = await e.getWorkspaceAuthorization(n === null ? { fresh: !1 } : {
@@ -133,7 +207,7 @@ function x(e) {
 		}
 		return i;
 	}
-	async function d(e, n) {
+	async function u(e, n) {
 		try {
 			return await t(e, {
 				...n,
@@ -142,20 +216,20 @@ function x(e) {
 				redirect: "error"
 			});
 		} catch (e) {
-			throw n.signal?.aborted ? e : new c(0, "network", null);
+			throw n.signal?.aborted ? e : new p(0, "network", null);
 		}
 	}
 	return {
 		async availability(e) {
 			let t = null;
 			for (;;) {
-				let n = await u(!0, t), r = await d(`${l}/availability`, {
+				let n = await l(!0, t), r = await u(`${c}/availability`, {
 					method: "GET",
 					headers: n,
 					signal: e
 				});
-				if (r.ok) return h(await f(r));
-				let i = await m(r);
+				if (r.ok) return D(await _(r));
+				let i = await y(r);
 				if (r.status === 401 && t === null) {
 					t = {
 						error: i,
@@ -167,16 +241,16 @@ function x(e) {
 			}
 		},
 		async create(e, t) {
-			if (!r.test(e.avatarId) || !i.test(e.idempotencyKey)) throw new c(400, "invalid_request", null);
+			if (!r.test(e.avatarId) || !i.test(e.idempotencyKey)) throw new p(400, "invalid_request", null);
 			let n = JSON.stringify({
 				avatarId: e.avatarId,
 				consentVersion: e.consentVersion
-			}), p = o(), h = null, g = !1, v = !1, y = null;
+			}), d = o(), f = null, m = !1, h = !1, g = null;
 			for (;;) {
-				let r = await u(!0, h);
-				if (h = null, y !== null && o() - p > s) throw y;
-				if (r["x-workspace-authorization"] === void 0) throw new c(403, "workspace_context_required", null);
-				let i = await d(`${l}/sessions`, {
+				let r = await l(!0, f);
+				if (f = null, g !== null && o() - d > s) throw g;
+				if (r["x-workspace-authorization"] === void 0) throw new p(403, "workspace_context_required", null);
+				let i = await u(`${c}/sessions`, {
 					method: "POST",
 					headers: {
 						...r,
@@ -186,41 +260,41 @@ function x(e) {
 					body: n,
 					signal: t
 				});
-				if (i.status === 201) return _(await f(i));
-				let b = await m(i);
-				if (i.status === 401 && !g) {
-					g = !0, h = {
-						error: b,
+				if (i.status === 201) return k(await _(i));
+				let v = await y(i);
+				if (i.status === 401 && !m) {
+					m = !0, f = {
+						error: v,
 						workspace: r["x-workspace-authorization"]
 					};
 					continue;
 				}
-				if (i.status === 409 && b.code === "start_in_progress") {
-					let e = Math.max(250, (b.retryAfterSeconds ?? 1) * 1e3);
-					if (o() - p + e > s || (await a(e), t?.aborted)) throw b;
-					y = b;
+				if (i.status === 409 && v.code === "start_in_progress") {
+					let e = Math.max(250, (v.retryAfterSeconds ?? 1) * 1e3);
+					if (o() - d + e > s || (await a(e), t?.aborted)) throw v;
+					g = v;
 					continue;
 				}
-				if (i.status === 502 && !v) {
-					v = !0;
+				if (i.status === 502 && !h) {
+					h = !0;
 					continue;
 				}
-				throw b;
+				throw v;
 			}
 		},
 		async status(e, t) {
-			if (!n.test(e)) throw new c(400, "invalid_request", null);
-			let r = await u(!1), i = await d(`${l}/sessions/${e}`, {
+			if (!n.test(e)) throw new p(400, "invalid_request", null);
+			let r = await l(!1), i = await u(`${c}/sessions/${e}`, {
 				method: "GET",
 				headers: r,
 				signal: t
 			});
-			if (!i.ok) throw await m(i);
-			return y(await f(i), e);
+			if (!i.ok) throw await y(i);
+			return j(await _(i), e);
 		},
 		async end(e, { reason: t, keepalive: r = !1 }) {
-			if (!n.test(e)) throw new c(400, "invalid_request", null);
-			let i = await u(!1), a = await d(`${l}/sessions/${e}/end`, {
+			if (!n.test(e)) throw new p(400, "invalid_request", null);
+			let i = await l(!1), a = await u(`${c}/sessions/${e}/end`, {
 				method: "POST",
 				headers: {
 					...i,
@@ -229,28 +303,34 @@ function x(e) {
 				body: JSON.stringify({ reason: t }),
 				keepalive: r
 			});
-			if (!a.ok) throw await m(a);
-			return y(await f(a), e);
+			if (!a.ok) throw await y(a);
+			return j(await _(a), e);
 		}
 	};
 }
-var S = new Set([
+var P = new Set([
 	"capacity",
 	"rate-limited",
-	"budget-exhausted"
+	"budget-exhausted",
+	"minutes-in-use",
+	"minutes-in-use-self",
+	"minutes-unavailable"
 ]);
-function C(e) {
-	if (!(e instanceof c)) return {
+function F(e) {
+	return e.problem === null ? !1 : P.has(e.problem) ? !0 : e.problem === "minutes-exhausted" && e.minutesReason === "ZERO_SESSION_LIMIT";
+}
+function I(e) {
+	if (!(e instanceof p)) return {
 		problem: "connection",
 		hide: !1
 	};
-	let t = w(e);
-	return t.problem !== null && S.has(t.problem) && e.retryAfterSeconds !== null ? {
+	let t = L(e);
+	return F(t) && e.retryAfterSeconds !== null ? {
 		...t,
 		retryAfterSeconds: e.retryAfterSeconds
 	} : t;
 }
-function w(e) {
+function L(e) {
 	if (e.status === 0) return {
 		problem: "connection",
 		hide: !1
@@ -312,6 +392,26 @@ function w(e) {
 			hide: !1,
 			scope: e.scope
 		};
+		case "minutes_exhausted": return e.minutesReason === null ? {
+			problem: "minutes-exhausted",
+			hide: !1
+		} : {
+			problem: "minutes-exhausted",
+			hide: !1,
+			minutesReason: e.minutesReason
+		};
+		case "minutes_in_use": return {
+			problem: "minutes-in-use",
+			hide: !1
+		};
+		case "minutes_in_use_self": return {
+			problem: "minutes-in-use-self",
+			hide: !1
+		};
+		case "minutes_unavailable": return {
+			problem: "minutes-unavailable",
+			hide: !1
+		};
 		case "avatar_unavailable": return {
 			problem: "unavailable",
 			hide: !1
@@ -345,7 +445,7 @@ function w(e) {
 		};
 	}
 }
-function T(e) {
+function R(e) {
 	return e === "unavailable" ? {
 		problem: "capacity",
 		hide: !1
@@ -354,5 +454,26 @@ function T(e) {
 		hide: !0
 	};
 }
+function z(e) {
+	if (e == null) return null;
+	switch (e.state) {
+		case "EXHAUSTED": return e.reason === null ? {
+			problem: "minutes-exhausted",
+			hide: !1
+		} : {
+			problem: "minutes-exhausted",
+			hide: !1,
+			minutesReason: e.reason
+		};
+		case "IN_USE": return e.reason === "OWN_SESSION" ? {
+			problem: "minutes-in-use-self",
+			hide: !1
+		} : {
+			problem: "minutes-in-use",
+			hide: !1
+		};
+		default: return null;
+	}
+}
 //#endregion
-export { e as AVATAR_API_PATH, c as AvatarApiError, a as avatarApiBaseFromTtsEndpoint, T as avatarAvailabilityRefusal, l as avatarIdempotencyKey, C as avatarRefusalFor, x as createAvatarSessionClient };
+export { e as AVATAR_API_PATH, c as AVATAR_MINUTES_CONTRACT_VERSION, u as AVATAR_MINUTES_REASONS, l as AVATAR_MINUTES_STATES, p as AvatarApiError, a as avatarApiBaseFromTtsEndpoint, R as avatarAvailabilityRefusal, m as avatarIdempotencyKey, z as avatarMinutesRefusal, I as avatarRefusalFor, N as createAvatarSessionClient };

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

@@ -51,6 +51,11 @@ export type AvatarTransportEvent = {
     readonly type: 'audioPlayback';
     readonly canPlay: boolean;
 }
+/** ★ BOFF-9696: the browser refused (or allowed again) the avatar's video, e.g. iOS in Low Power Mode until a user gesture. */
+ | {
+    readonly type: 'videoPlayback';
+    readonly canPlay: boolean;
+}
 /** Result of the readiness probe at connect (see AvatarReadinessProbeOptions). */
  | {
     readonly type: 'readiness';
@@ -168,6 +173,8 @@ export declare class LiveKitAvatarTransport {
     private videoPresent;
     private degraded;
     private audioElement;
+    /** ★ BOFF-9696 (S1): the browser paused the avatar's audio element on its own (see watchAudioElement). */
+    private elementPaused;
     private disposed;
     private rejectReady;
     private mediaReady;
@@ -218,15 +225,30 @@ export declare class LiveKitAvatarTransport {
     get transportState(): AvatarTransportState;
     /** The readiness probe's result once connect() has resolved; null before. */
     get readiness(): AvatarReadinessStatus | null;
-    /** True while the browser blocks the avatar's audio (autoplay policy): resumeAudio() from a user gesture is needed. */
+    /**
+     * True while the browser blocks the avatar's audio: by autoplay policy, or by pausing its element on its own (an interruption, the lock
+     * screen). resumeAudio() from a user gesture is needed.
+     */
     get audioBlocked(): boolean;
+    /** ★ BOFF-9696: true while the browser refuses the avatar's video (resumeVideo() from a user gesture plays it). */
+    get videoBlocked(): boolean;
     subscribe(handler: (event: AvatarTransportEvent) => void): AvatarUnsubscribe;
     private emit;
     /**
-     * Resume audio playback. Call it synchronously from the user's click on the Avatar toggle (a user gesture is required by
-     * the browser's autoplay policy), and again from a "tap to enable sound" control when audioPlayback reports canPlay=false.
+     * Resume audio playback. Call it synchronously from a user gesture (the browser's autoplay policy requires one): today the
+     * "tap to enable sound" control (`controller.resumeAudio()`), shown when audioPlayback reports canPlay=false.
      */
     resumeAudio(): Promise<void>;
+    /** ★ BOFF-9696: play a refused video. Call it synchronously from a user gesture, like resumeAudio(). */
+    resumeVideo(): Promise<void>;
+    /**
+     * ★ BOFF-9696 (S1): an element the browser PAUSED on its own while the avatar is on (an interruption such as a call or Siri, the lock
+     * screen, or WebKit pausing it when it is unmuted). The SDK only learns of a blocked playback from a failed play(), so without this the
+     * avatar would lip-sync with no voice and no way back. The pause reports the sound blocked; the existing tap (resumeAudio: the SDK's
+     * startAudio plays every attached element) plays it again, and its 'playing' reports it back. Only while ready and fed: a release
+     * (srcObject null) or a teardown is not a block.
+     */
+    private watchAudioElement;
     /** Mute or unmute the avatar's audio element instantly (used to silence output on cancel before the provider confirms). */
     setOutputMuted(muted: boolean): void;
     connect(params: AvatarConnectParams): Promise<void>;