@burdenoff/fe-libs 2026.1024.4 → 2026.1026.1

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

@@ -34,14 +34,13 @@ var m = "inline-flex h-8 items-center gap-1.5 rounded-full border border-border-
 				children: [
 					/* @__PURE__ */ f("video", {
 						ref: _.attachVideo,
-						className: `size-full object-cover ${A.videoReady ? "" : "invisible"}`,
+						className: `size-full object-cover ${A.videoReady && !A.videoBlocked ? "" : "invisible"}`,
 						"aria-label": x.stageLabel,
-						autoPlay: !0,
 						muted: !0,
 						playsInline: !0,
 						"data-testid": "assistant-live-avatar-video"
 					}),
-					A.videoReady ? null : /* @__PURE__ */ f("p", {
+					A.videoReady && !A.videoBlocked || j === "ready" && A.videoBlocked ? null : /* @__PURE__ */ f("p", {
 						className: "absolute inset-0 flex items-center justify-center p-3 text-center text-xs text-text-muted",
 						children: j === "ending" ? x.stateEnding : j === "connecting" ? x.stageWaiting : x.stateStarting
 					}),

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

@@ -102,9 +102,8 @@ var h = "text-xs font-medium text-text-secondary", g = "text-xs text-text-muted"
 					children: [
 						P ? /* @__PURE__ */ l("video", {
 							ref: i.attachVideo,
-							className: `size-full object-cover ${j.videoReady ? "" : "invisible"}`,
+							className: `size-full object-cover ${j.videoReady && !j.videoBlocked ? "" : "invisible"}`,
 							"aria-label": C.stageLabel,
-							autoPlay: !0,
 							muted: !0,
 							playsInline: !0,
 							"data-testid": "assistant-avatar-tab-video"
@@ -115,7 +114,7 @@ var h = "text-xs font-medium text-text-secondary", g = "text-xs text-text-muted"
 							src: X,
 							onError: ze
 						}) : null,
-						P && j.videoReady ? null : /* @__PURE__ */ l("p", {
+						P && j.videoReady && !j.videoBlocked || N === "ready" && j.videoBlocked ? null : /* @__PURE__ */ l("p", {
 							className: X === null ? "absolute inset-0 flex items-center justify-center p-3 text-center text-sm text-text-secondary" : "absolute inset-x-0 bottom-0 bg-bg-elevated/90 px-3 py-1.5 text-center text-xs text-text-secondary",
 							"data-testid": "assistant-avatar-tab-frame-text",
 							children: Ie

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

@@ -63,4 +63,13 @@ export interface AvatarRoom {
     startAudio(): Promise<void>;
     /** Whether the browser currently lets remote audio play (false until a user gesture while autoplay is blocked). */
     canPlaybackAudio(): boolean;
+    /**
+     * ★ BOFF-9696: the browser refused (false) or allowed again (true) the avatar's VIDEO. iOS in Low Power Mode refuses even a muted
+     * inline video until a user gesture. Optional: a room without it never reports a refused video.
+     */
+    onVideoPlaybackChanged?(handler: (canPlay: boolean) => void): AvatarUnsubscribe;
+    /** Start the refused video after a user gesture: the video twin of startAudio. */
+    startVideo?(): Promise<void>;
+    /** Whether the browser currently lets the remote video play. */
+    canPlaybackVideo?(): boolean;
 }

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>;

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

@@ -65,6 +65,7 @@ var p = class {
 	videoPresent = !1;
 	degraded = !1;
 	audioElement = null;
+	elementPaused = !1;
 	disposed = !1;
 	rejectReady = null;
 	mediaReady = !1;
@@ -85,7 +86,10 @@ var p = class {
 		return this.readinessStatus;
 	}
 	get audioBlocked() {
-		return this.state === "ready" && !this.options.room.canPlaybackAudio();
+		return this.state === "ready" && (!this.options.room.canPlaybackAudio() || this.elementPaused);
+	}
+	get videoBlocked() {
+		return this.state === "ready" && this.options.room.canPlaybackVideo?.() === !1;
 	}
 	subscribe(e) {
 		return this.listeners.add(e), () => {
@@ -100,6 +104,26 @@ var p = class {
 	async resumeAudio() {
 		await this.options.room.startAudio();
 	}
+	async resumeVideo() {
+		await this.options.room.startVideo?.();
+	}
+	watchAudioElement(e) {
+		if (e === null || typeof e.addEventListener != "function") return;
+		let t = () => {
+			this.disposed || this.state !== "ready" || e.srcObject === null || this.elementPaused || (this.elementPaused = !0, this.emit({
+				type: "audioPlayback",
+				canPlay: !1
+			}));
+		}, n = () => {
+			this.elementPaused && (this.elementPaused = !1, this.emit({
+				type: "audioPlayback",
+				canPlay: this.options.room.canPlaybackAudio()
+			}));
+		};
+		e.addEventListener("pause", t), e.addEventListener("playing", n), this.unsubscribes.push(() => {
+			e.removeEventListener("pause", t), e.removeEventListener("playing", n);
+		});
+	}
 	setOutputMuted(e) {
 		this.audioElement && (this.audioElement.muted = e);
 	}
@@ -107,7 +131,7 @@ var p = class {
 		if (this.state !== "idle") throw Error("transport already used");
 		this.state = "connecting";
 		let { room: t, avatarIdentity: i } = this.options;
-		this.audioElement = e.audioElement ?? null, t.registerRpc(n, (e, t) => this.handleFinished(e, t)), t.registerRpc(r, (e) => this.handleStarted(e)), this.unsubscribes.push(t.onParticipantConnected((e) => {
+		this.audioElement = e.audioElement ?? null, this.watchAudioElement(this.audioElement), t.registerRpc(n, (e, t) => this.handleFinished(e, t)), t.registerRpc(r, (e) => this.handleStarted(e)), this.unsubscribes.push(t.onParticipantConnected((e) => {
 			e === i && (this.avatarPresent = !0, this.checkReady());
 		}), t.onParticipantDisconnected((e) => {
 			e === i && (this.avatarPresent = !1, this.videoPresent = !1, this.avatarDepartures += 1, this.owedFinishes = 0, this.endAllSegments(), this.emit({ type: "avatarLeft" }));
@@ -122,6 +146,9 @@ var p = class {
 		}), t.onAudioPlaybackChanged((e) => this.emit({
 			type: "audioPlayback",
 			canPlay: e
+		}))), t.onVideoPlaybackChanged && this.unsubscribes.push(t.onVideoPlaybackChanged((e) => this.emit({
+			type: "videoPlayback",
+			canPlay: e
 		})));
 		try {
 			await t.connect(e.url, e.token);

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

@@ -58,7 +58,7 @@ export interface LiveAvatarSeamOptions {
     readonly avatarVoiceStore?: LiveAvatarVoiceStore;
     readonly scheduler?: AvatarScheduler;
     readonly browserSupported?: () => boolean;
-    readonly controller?: Partial<Pick<LiveAvatarControllerDeps, 'createAudioElement' | 'releaseAudioElement' | 'startMeter' | 'decode' | 'now' | 'newIdempotencyKey' | 'subscribeWorkspaceChange' | 'subscribePageHide' | 'isPageVisible' | 'subscribePageVisible' | 'subscribePageShow' | 'idleMs' | 'endBeforeDeadlineMs' | 'connectTimeoutMs' | 'trackerConfig' | 'maxDrainMs' | 'stallMs' | 'readinessProbe'>>;
+    readonly controller?: Partial<Pick<LiveAvatarControllerDeps, 'createAudioElement' | 'releaseAudioElement' | 'startMeter' | 'decode' | 'now' | 'newIdempotencyKey' | 'subscribeWorkspaceChange' | 'subscribePageHide' | 'subscribePageHidden' | 'endOnHide' | 'subscribeUserGesture' | 'isPageVisible' | 'subscribePageVisible' | 'subscribePageShow' | 'idleMs' | 'endBeforeDeadlineMs' | 'connectTimeoutMs' | 'trackerConfig' | 'maxDrainMs' | 'stallMs' | 'readinessProbe'>>;
 }
 /** The seam, plus what a host or a test may need of it. */
 export interface LiveAvatarSeamHandle extends AssistantLiveAvatarSeam {
@@ -71,9 +71,12 @@ export interface LiveAvatarSeamHandle extends AssistantLiveAvatarSeam {
     dispose(): void;
 }
 /**
- * Whether this browser may show the avatar. Desktop Chrome first (GATE1B §10: no other browser or phone is offered until it is tested,
- * Chromium builds included, other Chromium-based browsers not), with the platform pieces the avatar needs: WebRTC, Web Audio (the level
- * meter and the MP3 decode) and MediaStream.
+ * Whether this browser can show the avatar: a check of what the avatar needs, on every browser and phone (BOFF-9696, the operator's
+ * decision of 2026-10-25; until then desktop Chrome only, GATE1B §10). The pieces: WebRTC (the room), an AudioContext (the level meter),
+ * MediaStream, and an OfflineAudioContext at the reply audio's rate (the MP3 decode makes one: avatarAudioDecode.ts). All four are
+ * unprefixed: Safari shipped the unprefixed audio contexts together (14.1), and the prefixed offline context's callback-only decode
+ * could not serve the avatar anyway. The user agent is never read: a browser that has these runs the avatar, one that lacks any cannot.
+ * Where autoplay needs a tap for sound (Safari and every iOS browser), the sound-blocked state asks for it.
  */
 export declare function isLiveAvatarBrowserSupported(scope?: typeof globalThis): boolean;
 /** The `Authorization` the hosted TTS requests carry (the host's `getHeaders`), else the stored access token. Nothing else is read. */
@@ -91,4 +94,19 @@ export declare function liveAvatarWorkspaceAuthorization(options: {
     readonly fresh: boolean;
     readonly refused?: string;
 }): Promise<string | null>;
+/**
+ * ★ BOFF-9696 (S5): a touch-first device (a phone or tablet without a hovering pointer), where a hidden page ends the session. A
+ * capability query, never the user agent. Exported for tests only.
+ */
+export declare function isTouchFirstDevice(scope?: {
+    readonly matchMedia?: (query: string) => {
+        readonly matches: boolean;
+    };
+}): boolean;
+/**
+ * ★ BOFF-9696: the person's taps, clicks and keys anywhere on the page, in the capture phase so no handler can stop them first. Each
+ * is a user gesture, inside which a browser lets a refused video start (iOS unlocks media on `touchend` and `click`). Only trusted
+ * events count: a script's synthetic click is no gesture. Exported for tests only.
+ */
+export declare function documentUserGesture(doc?: Pick<Document, 'addEventListener' | 'removeEventListener'> | null): ((listener: () => void) => () => void) | undefined;
 export declare function createLiveAvatarSeam(options?: LiveAvatarSeamOptions): LiveAvatarSeamHandle;

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

@@ -4,36 +4,41 @@ import { readSpeechEngineConfig as a } from "../../speech/createSpeechEngine.js"
 import { useAvatarPreferencesStore as o } from "../avatarPreferences.js";
 import { realAvatarScheduler as s } from "./avatarPorts.js";
 import { startAvatarAudioMeter as c } from "./avatarAudioMeter.js";
-import { decodeMp3ToPcm16k as l } from "./avatarAudioDecode.js";
-import { avatarApiBaseFromTtsEndpoint as u, avatarIdempotencyKey as d, createAvatarSessionClient as f } from "./avatarSessionClient.js";
-import { createLiveAvatarController as p } from "./liveAvatarController.js";
-import { openLiveKitAvatarRoom as m } from "./liveKitAvatarRoom.js";
-import { liveAvatarAskState as h } from "./liveAvatarStatus.js";
-import { LiveAvatarStageView as g } from "./LiveAvatarStage.js";
-import { sanitizeAvatarImages as _ } from "./avatarFaces.js";
-import { avatarSpeakerFor as v, hostedAvatarVoice as y, liveAvatarVoicesFrom as b, restoreVoiceWhenOutputLeaves as x } from "./avatarVoice.js";
-import { LiveAvatarTabView as S } from "./LiveAvatarTabView.js";
-import { jsx as C } from "react/jsx-runtime";
+import { AVATAR_SAMPLE_RATE as l } from "./avatarPcm16.js";
+import { decodeMp3ToPcm16k as u } from "./avatarAudioDecode.js";
+import { avatarApiBaseFromTtsEndpoint as d, avatarIdempotencyKey as f, createAvatarSessionClient as p } from "./avatarSessionClient.js";
+import { createLiveAvatarController as m } from "./liveAvatarController.js";
+import { openLiveKitAvatarRoom as h } from "./liveKitAvatarRoom.js";
+import { liveAvatarAskState as g } from "./liveAvatarStatus.js";
+import { LiveAvatarStageView as _ } from "./LiveAvatarStage.js";
+import { sanitizeAvatarImages as v } from "./avatarFaces.js";
+import { avatarSpeakerFor as y, hostedAvatarVoice as b, liveAvatarVoicesFrom as x, restoreVoiceWhenOutputLeaves as S } from "./avatarVoice.js";
+import { LiveAvatarTabView as C } from "./LiveAvatarTabView.js";
+import { jsx as w } from "react/jsx-runtime";
 //#region src/shared/assistant/avatar/live/createLiveAvatarSeam.tsx
-function w(e = globalThis) {
-	let t = e;
-	if (typeof t.RTCPeerConnection != "function" || typeof t.OfflineAudioContext != "function" || typeof t.AudioContext != "function" || typeof t.MediaStream != "function") return !1;
-	let n = t.navigator, r = n?.userAgentData;
-	if (r?.brands !== void 0) {
-		let e = r.brands.map((e) => e.brand);
-		return r.mobile === !1 && e.some((e) => e === "Google Chrome" || e === "Chromium") && !e.some((e) => /Edge|Opera|Brave|Vivaldi|Samsung/i.test(e));
+var T = /* @__PURE__ */ new WeakMap();
+function E(e = globalThis) {
+	let t = T.get(e);
+	if (t !== void 0) return t;
+	let n = D(e);
+	return T.set(e, n), n;
+}
+function D(e) {
+	if (typeof e.RTCPeerConnection != "function" || typeof e.AudioContext != "function" || typeof e.MediaStream != "function" || typeof e.OfflineAudioContext != "function") return !1;
+	try {
+		return new e.OfflineAudioContext(1, 1, l), !0;
+	} catch {
+		return !1;
 	}
-	let i = n?.userAgent ?? "";
-	return /\b(?:Chrome|Chromium)\//.test(i) && !/\b(?:Edg|OPR|SamsungBrowser)\/|Mobile|Android|iPhone|iPad/.test(i);
 }
-function T() {
+function O() {
 	let e = a().getHeaders?.() ?? {};
 	for (let [t, n] of Object.entries(e)) if (t.toLowerCase() === "authorization" && typeof n == "string" && n.trim() !== "") return n.trim();
 	let n = t();
 	return n ? `Bearer ${n}` : null;
 }
-async function E(t) {
-	let i = n(), a = T(), o = a?.replace(/^Bearer\s+/i, "") ?? null;
+async function k(t) {
+	let i = n(), a = O(), o = a?.replace(/^Bearer\s+/i, "") ?? null;
 	if (!i || !o) return null;
 	let s = t.refused?.replace(/^Bearer\s+/i, ""), c = await e({
 		url: r("workspace"),
@@ -42,38 +47,38 @@ async function E(t) {
 		currentQuery: "liveAvatarSession",
 		...t.fresh ? { issuanceGuard: {
 			identityKey: "liveAvatarSession",
-			isCurrent: () => n() === i && T() === a,
+			isCurrent: () => n() === i && O() === a,
 			accepts: (e, t) => e !== s && t === i
 		} } : {}
 	});
 	return c ? `Bearer ${c}` : null;
 }
-function D() {
+function A() {
 	let e = null;
 	return () => {
-		let t = typeof location > "u" ? void 0 : location.href, n = u(a().endpoint, t);
+		let t = typeof location > "u" ? void 0 : location.href, n = d(a().endpoint, t);
 		return n === null ? null : (e?.base !== n && (e = {
 			base: n,
-			client: f({
+			client: p({
 				baseUrl: n,
-				getAuthorization: T,
-				getWorkspaceAuthorization: E
+				getAuthorization: O,
+				getWorkspaceAuthorization: k
 			})
 		}), e.client);
 	};
 }
-var O = {
+var j = {
 	getState: () => o.getState(),
 	setAvatarEnabled: (e) => o.getState().setAvatarEnabled(e),
 	setAvatarId: (e) => o.getState().setAvatarId(e),
 	subscribe: (e) => o.subscribe(() => e())
-}, k = {
+}, M = {
 	getState: () => o.getState(),
 	subscribe: (e) => o.subscribe(() => e()),
 	setVoiceMode: (e) => o.getState().setVoiceMode(e),
 	setAvatarSpeaker: (e) => o.getState().setAvatarSpeaker(e)
 };
-function A(e, t) {
+function N(e, t) {
 	let n = (e) => {
 		i(e) || t();
 	};
@@ -90,24 +95,32 @@ function A(e, t) {
 		cancel: () => e.cancel()
 	};
 }
-function j(e) {
+function P(e) {
 	if (e === void 0) return;
 	let { access: t } = e;
 	return { access: () => t.call(e) };
 }
-function M() {
+function F() {
 	if (typeof document > "u") return null;
 	let e = document.createElement("audio");
 	return e.autoplay = !0, e.hidden = !0, e.setAttribute("data-testid", "assistant-live-avatar-audio"), document.body.appendChild(e), e;
 }
-function N(e) {
+function I(e) {
 	if (!(typeof window > "u")) return (t) => (window.addEventListener(e, t), () => window.removeEventListener(e, t));
 }
-function P() {
+function L() {
 	if (typeof document > "u" || typeof document.addEventListener != "function") return;
 	let e = () => document.visibilityState !== "hidden";
 	return {
 		isVisible: e,
+		onHidden: (t) => {
+			let n = () => {
+				e() || t();
+			};
+			return document.addEventListener("visibilitychange", n), () => {
+				document.removeEventListener("visibilitychange", n);
+			};
+		},
 		onShown: (t) => {
 			let n = () => {
 				e() && t();
@@ -120,7 +133,23 @@ function P() {
 		}
 	};
 }
-function F() {
+function R(e = globalThis) {
+	return typeof e.matchMedia == "function" && e.matchMedia("(hover: none) and (pointer: coarse)").matches;
+}
+function z(e = typeof document > "u" ? null : document) {
+	if (!(e === null || typeof e.addEventListener != "function")) return (t) => {
+		let n = (e) => {
+			e.isTrusted && t();
+		};
+		return e.addEventListener("touchend", n, {
+			capture: !0,
+			passive: !0
+		}), e.addEventListener("click", n, !0), e.addEventListener("keydown", n, !0), () => {
+			e.removeEventListener("touchend", n, { capture: !0 }), e.removeEventListener("click", n, !0), e.removeEventListener("keydown", n, !0);
+		};
+	};
+}
+function B() {
 	if (!(typeof window > "u" || typeof document > "u")) return (e) => {
 		let t = window, n = document, r = () => {
 			n.visibilityState === "visible" && e();
@@ -130,26 +159,29 @@ function F() {
 		};
 	};
 }
-function I(e = {}) {
-	let t = e.preferences ?? O, n = e.controller ?? {}, r = n.subscribeWorkspaceChange ?? N("burdenoff:workspace-changed"), i = n.subscribePageHide ?? N("pagehide"), a = P(), o = n.isPageVisible ?? a?.isVisible, u = n.subscribePageVisible ?? a?.onShown, f = n.subscribePageShow ?? F(), T = n.now ?? (() => Date.now()), E = p({
-		client: e.client ?? D(),
-		openRoom: e.openRoom ?? m,
+function V(e = {}) {
+	let t = e.preferences ?? j, n = e.controller ?? {}, r = n.subscribeWorkspaceChange ?? I("burdenoff:workspace-changed"), i = n.subscribePageHide ?? I("pagehide"), a = L(), o = n.isPageVisible ?? a?.isVisible, l = n.subscribePageVisible ?? a?.onShown, d = n.subscribePageHidden ?? a?.onHidden, p = n.endOnHide ?? R, T = n.subscribeUserGesture ?? z(), D = n.subscribePageShow ?? B(), O = n.now ?? (() => Date.now()), k = m({
+		client: e.client ?? A(),
+		openRoom: e.openRoom ?? h,
 		scheduler: e.scheduler ?? s,
 		preferences: t,
-		decode: n.decode ?? ((e, t) => l(e, { signal: t })),
-		createAudioElement: n.createAudioElement ?? M,
+		decode: n.decode ?? ((e, t) => u(e, { signal: t })),
+		createAudioElement: n.createAudioElement ?? F,
 		releaseAudioElement: n.releaseAudioElement ?? ((e) => {
 			e.srcObject = null, e.remove();
 		}),
 		startMeter: n.startMeter ?? ((e, t) => typeof MediaStream > "u" ? null : c(new MediaStream([e]), t)),
-		browserSupported: e.browserSupported ?? (() => w()),
-		now: T,
-		newIdempotencyKey: n.newIdempotencyKey ?? (() => d()),
+		browserSupported: e.browserSupported ?? (() => E()),
+		now: O,
+		newIdempotencyKey: n.newIdempotencyKey ?? (() => f()),
 		...r ? { subscribeWorkspaceChange: r } : {},
 		...i ? { subscribePageHide: i } : {},
 		...o ? { isPageVisible: o } : {},
-		...u ? { subscribePageVisible: u } : {},
-		...f ? { subscribePageShow: f } : {},
+		...l ? { subscribePageVisible: l } : {},
+		...d ? { subscribePageHidden: d } : {},
+		endOnHide: p,
+		...T ? { subscribeUserGesture: T } : {},
+		...D ? { subscribePageShow: D } : {},
 		...n.idleMs === void 0 ? {} : { idleMs: n.idleMs },
 		...n.endBeforeDeadlineMs === void 0 ? {} : { endBeforeDeadlineMs: n.endBeforeDeadlineMs },
 		...n.connectTimeoutMs === void 0 ? {} : { connectTimeoutMs: n.connectTimeoutMs },
@@ -158,34 +190,34 @@ function I(e = {}) {
 		...n.stallMs === void 0 ? {} : { stallMs: n.stallMs },
 		...n.readinessProbe === void 0 ? {} : { readinessProbe: n.readinessProbe },
 		...e.onLog ? { onLog: e.onLog } : {}
-	}), I = b(e.avatarVoices), L = e.avatarImages === void 0 ? null : _(e.avatarImages), R = e.avatarVoiceStore ?? k, z = () => R.getState(), B = j(e.minutesPurchase), V = (n, r) => {
-		let i = v(z(), {
-			avatarVoices: I,
+	}), V = x(e.avatarVoices), H = e.avatarImages === void 0 ? null : v(e.avatarImages), U = e.avatarVoiceStore ?? M, W = () => U.getState(), G = P(e.minutesPurchase), K = (n, r) => {
+		let i = y(W(), {
+			avatarVoices: V,
 			avatarId: t.getState().avatarId,
 			...e.defaultAvatarVoiceMode ? { hostDefault: e.defaultAvatarVoiceMode } : {}
 		});
-		return i === null ? null : y(i, n, r.listVoices());
-	}, H = (e, t) => {
+		return i === null ? null : b(i, n, r.listVoices());
+	}, q = (e, t) => {
 		let n = {
 			...e,
 			voice: t
 		};
-		return n.audioOutput = x(E.createOutput(), () => {
+		return n.audioOutput = S(k.createOutput(), () => {
 			n.voice = e.voice;
-		}, (e) => E.subscribe(() => {
-			E.getSnapshot().phase !== "ready" && e();
+		}, (e) => k.subscribe(() => {
+			k.getSnapshot().phase !== "ready" && e();
 		})), n;
 	};
 	return {
 		decorateSpeechEngine: (e) => {
 			let t = (t) => {
-				let n = V(t.lang, e), r = n === null ? t : {
+				let n = K(t.lang, e), r = n === null ? t : {
 					...t,
 					voice: n
 				};
 				return {
 					voice: n,
-					target: E.route(r, e)
+					target: k.route(r, e)
 				};
 			}, n = null, r = () => {
 				let e = n;
@@ -196,9 +228,9 @@ function I(e = {}) {
 				}, l = () => o ? !1 : (o = !0, c(), !0), u = () => {
 					!a || !l() || (e.cancel(), i?.onError?.("output-left"));
 				};
-				s = E.subscribe(() => {
-					E.getSnapshot().phase !== "ready" && u();
-				}), n = c, r.audioOutput &&= A(r.audioOutput, u), r.fallback = !1, e.speak(t, r, {
+				s = k.subscribe(() => {
+					k.getSnapshot().phase !== "ready" && u();
+				}), n = c, r.audioOutput &&= N(r.audioOutput, u), r.fallback = !1, e.speak(t, r, {
 					...i,
 					onEnd: () => {
 						l() && i?.onEnd?.();
@@ -227,8 +259,8 @@ function I(e = {}) {
 					}
 					let l = s === null ? {
 						...a,
-						audioOutput: E.createOutput()
-					} : H(a, s);
+						audioOutput: k.createOutput()
+					} : q(a, s);
 					if (a.avatarOnly === !0) {
 						i(n, l, o);
 						return;
@@ -240,8 +272,8 @@ function I(e = {}) {
 				}
 			};
 		},
-		Stage: ({ expanded: t, fallback: n }) => /* @__PURE__ */ C(g, {
-			controller: E,
+		Stage: ({ expanded: t, fallback: n }) => /* @__PURE__ */ w(_, {
+			controller: k,
 			expanded: t,
 			fallback: n,
 			...e.avatarNames ? { avatarNames: e.avatarNames } : {}
@@ -249,34 +281,34 @@ function I(e = {}) {
 		enabled: {
 			subscribe: (e) => t.subscribe(e),
 			getSnapshot: () => t.getState().avatarEnabled,
-			switchOff: () => E.switchOff(),
-			voiceLive: (e) => E.setVoiceLive(e)
+			switchOff: () => k.switchOff(),
+			voiceLive: (e) => k.setVoiceLive(e)
 		},
 		tab: {
 			offered: {
-				subscribe: (e) => E.subscribe(e),
-				getSnapshot: () => E.getSnapshot().tabOffered
+				subscribe: (e) => k.subscribe(e),
+				getSnapshot: () => k.getSnapshot().tabOffered
 			},
 			ask: {
-				subscribe: (e) => E.subscribe(e),
-				getSnapshot: () => h(E.getSnapshot(), T())
+				subscribe: (e) => k.subscribe(e),
+				getSnapshot: () => g(k.getSnapshot(), O())
 			},
-			setOpen: (e) => E.setTabOpen(e),
-			heldByVoice: () => E.getSnapshot().heldByVoice,
-			View: (t) => /* @__PURE__ */ C(S, {
+			setOpen: (e) => k.setTabOpen(e),
+			heldByVoice: () => k.getSnapshot().heldByVoice,
+			View: (t) => /* @__PURE__ */ w(C, {
 				...t,
-				controller: E,
-				avatarVoices: I,
-				voiceStore: R,
+				controller: k,
+				avatarVoices: V,
+				voiceStore: U,
 				...e.avatarNames ? { avatarNames: e.avatarNames } : {},
-				...L ? { avatarImages: L } : {},
+				...H ? { avatarImages: H } : {},
 				...e.defaultAvatarVoiceMode ? { defaultAvatarVoiceMode: e.defaultAvatarVoiceMode } : {},
-				...B ? { minutesPurchase: B } : {}
+				...G ? { minutesPurchase: G } : {}
 			})
 		},
-		controller: E,
-		dispose: () => E.dispose()
+		controller: k,
+		dispose: () => k.dispose()
 	};
 }
 //#endregion
-export { I as createLiveAvatarSeam, w as isLiveAvatarBrowserSupported, T as liveAvatarAuthorization, E as liveAvatarWorkspaceAuthorization };
+export { V as createLiveAvatarSeam, z as documentUserGesture, E as isLiveAvatarBrowserSupported, R as isTouchFirstDevice, O as liveAvatarAuthorization, k as liveAvatarWorkspaceAuthorization };

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

@@ -93,6 +93,11 @@ export interface LiveAvatarSnapshot {
     readonly audioBlocked: boolean;
     /** The avatar's video has arrived. */
     readonly videoReady: boolean;
+    /**
+     * ★ BOFF-9696: the browser refuses to play the avatar's video (iOS in Low Power Mode, until a user gesture): the views show the stage's
+     * placeholder instead of a frozen face. The sound tap (`resumeAudio`) plays it too, and so does the person's next tap or key on the page.
+     */
+    readonly videoBlocked: boolean;
     /**
      * ★ BOFF-9446: the minutes block of the latest availability answer (the server sends one in `enforce` only), or null: no answer with
      * one yet (today's answers never have one), an answer with none since, or cleared by a workspace switch or a "not offered" answer.
@@ -151,7 +156,7 @@ export interface LiveAvatarControllerDeps {
     readonly releaseAudioElement: (element: HTMLAudioElement) => void;
     /** A level meter on the avatar's received audio; null when none can be built (the output then cannot prove silence). */
     readonly startMeter: (track: MediaStreamTrack, onChange: (audible: boolean) => void) => AvatarMeterHandle | null;
-    /** The browser can show the avatar at all (desktop Chromium first: GATE1B §10). */
+    /** The browser can show the avatar at all: what it needs is there (any browser or phone since BOFF-9696). */
     readonly browserSupported: () => boolean;
     /**
      * Wall-clock milliseconds: a refusal's retry time (`retryAt`), its lock and its re-check (`recheckRetry`); also the fallback for
@@ -161,6 +166,15 @@ export interface LiveAvatarControllerDeps {
     readonly newIdempotencyKey: () => string;
     readonly subscribeWorkspaceChange?: (listener: () => void) => () => void;
     readonly subscribePageHide?: (listener: () => void) => () => void;
+    /**
+     * ★ BOFF-9696 (S5): the page was hidden (its document hidden). A phone hides a page without `pagehide` when the person switches apps or
+     * locks the screen, and freezes its timers then, so a session left on there would run on unseen until its idle rule or deadline.
+     */
+    readonly subscribePageHidden?: (listener: () => void) => () => void;
+    /** ★ BOFF-9696 (S5): whether a hidden page ends the session at once (touch devices); absent or false: only `pagehide` does. */
+    readonly endOnHide?: () => boolean;
+    /** ★ BOFF-9696: the person's next tap or key anywhere on the page (a user gesture), once: it plays a refused video. */
+    readonly subscribeUserGesture?: (listener: () => void) => () => void;
     /** ★ BOFF-9446: the page is shown now; no quiet minutes question is asked while it is hidden. Absent: always shown. */
     readonly isPageVisible?: () => boolean;
     /** ★ BOFF-9446: called when the page is shown again (after it was hidden): the minutes are asked again then, quietly. */