@burdenoff/fe-libs 2026.1014.4 → 2026.1015.1

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

@@ -0,0 +1,45 @@
+import { hostedLocaleFor as e, hostedVoiceName as t, isHostedSpeaker as n } from "../../speech/hostedVoiceCatalogue.js";
+import { resolveAvatarVoiceMode as r, resolveStoredAvatarId as i } from "../avatarPreferences.js";
+//#region src/shared/assistant/avatar/live/avatarVoice.ts
+function a(e) {
+	let t = /* @__PURE__ */ new Map();
+	if (typeof e != "object" || !e) return t;
+	for (let [r, a] of Object.entries(e)) i(r) === r && n(a) && t.set(r, a);
+	return t;
+}
+function o(e, t) {
+	switch (r(e, t.hostDefault)) {
+		case "mine": return null;
+		case "speaker": return e.avatarSpeaker;
+		case "paired": return t.avatarId === null ? null : t.avatarVoices.get(t.avatarId) ?? null;
+	}
+}
+function s(n, r, i) {
+	let a = e(r);
+	if (a === null) return null;
+	let o = t(a, n);
+	return i.find((e) => e.name === o && e.source === "hosted") ?? null;
+}
+function c(e, t, n) {
+	let r = !1, i = null, a = (e) => {
+		r || (r = !0, i?.(), i = null, e && t());
+	};
+	i = n?.(() => a(!0)) ?? null;
+	let o = () => a(!0);
+	return {
+		write: (t, n, r) => {
+			let i = e.write(t, n, r);
+			return i.then(void 0, o), i;
+		},
+		drain: () => {
+			let t = e.drain();
+			return t.then(() => a(!1), o), t;
+		},
+		retract: (t) => e.retract(t),
+		cancel: () => {
+			a(!1), e.cancel();
+		}
+	};
+}
+//#endregion
+export { o as avatarSpeakerFor, s as hostedAvatarVoice, a as liveAvatarVoicesFrom, c as restoreVoiceWhenOutputLeaves };

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

@@ -1,17 +1,36 @@
 import { ComponentType } from 'react';
+import { HostedSpeaker } from '../../speech/hostedVoiceCatalogue';
 import { SpeechEngine } from '../../speech/types';
-import { AssistantLiveAvatarSeam, LiveAvatarEnabledStore, LiveAvatarStageProps } from '../../ui/assistantLiveAvatarSeam';
+import { AssistantLiveAvatarSeam, LiveAvatarEnabledStore, LiveAvatarStageProps, LiveAvatarTabSeam } from '../../ui/assistantLiveAvatarSeam';
+import { AvatarVoiceDefault } from '../avatarPreferences';
 import { AvatarRoom, AvatarScheduler } from './avatarPorts';
 import { AvatarSessionClient } from './avatarSessionClient';
+import { LiveAvatarVoiceStore } from './LiveAvatarTabView';
 import { LiveAvatarController, LiveAvatarControllerDeps, LiveAvatarLogEvent, LiveAvatarPreferences } from './liveAvatarController';
 export interface LiveAvatarSeamOptions {
     /** Display names for the avatar ids the server offers (it sends ids only); without one the chooser numbers them. */
     readonly avatarNames?: Readonly<Record<string, string>>;
+    /**
+     * The speaker each avatar id speaks with as "Default for this avatar" (BOFF-9341): host config, never inferred. An id without one has
+     * no Default, and a value that is not a hosted speaker is ignored.
+     */
+    readonly avatarVoices?: Readonly<Record<string, HostedSpeaker>>;
+    /**
+     * The avatar's voice for a person who has not chosen one: `mine` (the default: their current voice is kept) or `paired` (each avatar
+     * speaks with its `avatarVoices` speaker, and follows the avatar when it is switched; one with none keeps the assistant's voice). A
+     * person's stored choice always wins.
+     */
+    readonly defaultAvatarVoiceMode?: AvatarVoiceDefault;
     readonly onLog?: (event: LiveAvatarLogEvent) => void;
     /** Overrides, for tests and for hosts with their own plumbing. Each defaults to the assistant's own. */
     readonly client?: () => AvatarSessionClient | null;
     readonly openRoom?: () => Promise<AvatarRoom>;
     readonly preferences?: LiveAvatarPreferences;
+    /**
+     * The person's avatar voice choice: read per reply, and written by the Avatar tab's voice select (never the assistant's own voice).
+     * Defaults to the assistant's avatar preferences.
+     */
+    readonly avatarVoiceStore?: LiveAvatarVoiceStore;
     readonly scheduler?: AvatarScheduler;
     readonly browserSupported?: () => boolean;
     readonly controller?: Partial<Pick<LiveAvatarControllerDeps, 'createAudioElement' | 'releaseAudioElement' | 'startMeter' | 'decode' | 'now' | 'newIdempotencyKey' | 'subscribeWorkspaceChange' | 'subscribePageHide' | 'idleMs' | 'endBeforeDeadlineMs' | 'connectTimeoutMs' | 'trackerConfig' | 'maxDrainMs' | 'stallMs' | 'readinessProbe'>>;
@@ -21,6 +40,7 @@ export interface LiveAvatarSeamHandle extends AssistantLiveAvatarSeam {
     readonly decorateSpeechEngine: (base: SpeechEngine) => SpeechEngine;
     readonly Stage: ComponentType<LiveAvatarStageProps>;
     readonly enabled: LiveAvatarEnabledStore;
+    readonly tab: LiveAvatarTabSeam;
     readonly controller: LiveAvatarController;
     /** Ends any session and stops listening. The handle is unusable afterwards. */
     dispose(): void;

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

@@ -8,9 +8,11 @@ import { avatarApiBaseFromTtsEndpoint as l, avatarIdempotencyKey as u, createAva
 import { createLiveAvatarController as f } from "./liveAvatarController.js";
 import { openLiveKitAvatarRoom as p } from "./liveKitAvatarRoom.js";
 import { LiveAvatarStageView as m } from "./LiveAvatarStage.js";
-import { jsx as h } from "react/jsx-runtime";
+import { avatarSpeakerFor as h, hostedAvatarVoice as g, liveAvatarVoicesFrom as _, restoreVoiceWhenOutputLeaves as v } from "./avatarVoice.js";
+import { LiveAvatarTabView as y } from "./LiveAvatarTabView.js";
+import { jsx as b } from "react/jsx-runtime";
 //#region src/shared/assistant/avatar/live/createLiveAvatarSeam.tsx
-function g(e = globalThis) {
+function x(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;
@@ -21,14 +23,14 @@ function g(e = globalThis) {
 	let i = n?.userAgent ?? "";
 	return /\b(?:Chrome|Chromium)\//.test(i) && !/\b(?:Edg|OPR|SamsungBrowser)\/|Mobile|Android|iPhone|iPad/.test(i);
 }
-function _() {
+function S() {
 	let e = i().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 v(t) {
-	let i = n(), a = _(), o = a?.replace(/^Bearer\s+/i, "") ?? null;
+async function C(t) {
+	let i = n(), a = S(), 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"),
@@ -37,13 +39,13 @@ async function v(t) {
 		currentQuery: "liveAvatarSession",
 		...t.fresh ? { issuanceGuard: {
 			identityKey: "liveAvatarSession",
-			isCurrent: () => n() === i && _() === a,
+			isCurrent: () => n() === i && S() === a,
 			accepts: (e, t) => e !== s && t === i
 		} } : {}
 	});
 	return c ? `Bearer ${c}` : null;
 }
-function y() {
+function w() {
 	let e = null;
 	return () => {
 		let t = typeof location > "u" ? void 0 : location.href, n = l(i().endpoint, t);
@@ -51,39 +53,44 @@ function y() {
 			base: n,
 			client: d({
 				baseUrl: n,
-				getAuthorization: _,
-				getWorkspaceAuthorization: v
+				getAuthorization: S,
+				getWorkspaceAuthorization: C
 			})
 		}), e.client);
 	};
 }
-var b = {
+var T = {
 	getState: () => a.getState(),
 	setAvatarEnabled: (e) => a.getState().setAvatarEnabled(e),
 	setAvatarId: (e) => a.getState().setAvatarId(e),
 	subscribe: (e) => a.subscribe(() => e())
+}, E = {
+	getState: () => a.getState(),
+	subscribe: (e) => a.subscribe(() => e()),
+	setVoiceMode: (e) => a.getState().setVoiceMode(e),
+	setAvatarSpeaker: (e) => a.getState().setAvatarSpeaker(e)
 };
-function x() {
+function D() {
 	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 S(e) {
+function O(e) {
 	if (!(typeof window > "u")) return (t) => (window.addEventListener(e, t), () => window.removeEventListener(e, t));
 }
-function C(e = {}) {
-	let t = e.preferences ?? b, n = e.controller ?? {}, r = n.subscribeWorkspaceChange ?? S("burdenoff:workspace-changed"), i = n.subscribePageHide ?? S("pagehide"), a = f({
-		client: e.client ?? y(),
+function k(e = {}) {
+	let t = e.preferences ?? T, n = e.controller ?? {}, r = n.subscribeWorkspaceChange ?? O("burdenoff:workspace-changed"), i = n.subscribePageHide ?? O("pagehide"), a = f({
+		client: e.client ?? w(),
 		openRoom: e.openRoom ?? p,
 		scheduler: e.scheduler ?? o,
 		preferences: t,
 		decode: n.decode ?? ((e, t) => c(e, { signal: t })),
-		createAudioElement: n.createAudioElement ?? x,
+		createAudioElement: n.createAudioElement ?? D,
 		releaseAudioElement: n.releaseAudioElement ?? ((e) => {
 			e.srcObject = null, e.remove();
 		}),
 		startMeter: n.startMeter ?? ((e, t) => typeof MediaStream > "u" ? null : s(new MediaStream([e]), t)),
-		browserSupported: e.browserSupported ?? (() => g()),
+		browserSupported: e.browserSupported ?? (() => x()),
 		now: n.now ?? (() => Date.now()),
 		newIdempotencyKey: n.newIdempotencyKey ?? (() => u()),
 		...r ? { subscribeWorkspaceChange: r } : {},
@@ -96,20 +103,47 @@ function C(e = {}) {
 		...n.stallMs === void 0 ? {} : { stallMs: n.stallMs },
 		...n.readinessProbe === void 0 ? {} : { readinessProbe: n.readinessProbe },
 		...e.onLog ? { onLog: e.onLog } : {}
-	});
+	}), l = _(e.avatarVoices), d = e.avatarVoiceStore ?? E, S = () => d.getState(), C = (n, r) => {
+		let i = h(S(), {
+			avatarVoices: l,
+			avatarId: t.getState().avatarId,
+			...e.defaultAvatarVoiceMode ? { hostDefault: e.defaultAvatarVoiceMode } : {}
+		});
+		return i === null ? null : g(i, n, r.listVoices());
+	}, k = (e, t) => {
+		let n = {
+			...e,
+			voice: t
+		};
+		return n.audioOutput = v(a.createOutput(), () => {
+			n.voice = e.voice;
+		}, (e) => a.subscribe(() => {
+			a.getSnapshot().phase !== "ready" && e();
+		})), n;
+	};
 	return {
 		decorateSpeechEngine: (e) => ({
 			id: e.id,
 			isSupported: () => e.isSupported(),
 			listVoices: () => e.listVoices(),
 			subscribeVoices: (t) => e.subscribeVoices(t),
-			speak: (t, n, r) => e.speak(t, a.route(n, e) === "avatar" ? {
-				...n,
-				audioOutput: a.createOutput()
-			} : n, r),
+			speak: (t, n, r) => {
+				let i = C(n.lang, e), o = i === null ? n : {
+					...n,
+					voice: i
+				};
+				if (a.route(o, e) !== "avatar") {
+					e.speak(t, n, r);
+					return;
+				}
+				e.speak(t, i === null ? {
+					...n,
+					audioOutput: a.createOutput()
+				} : k(n, i), r);
+			},
 			cancel: () => e.cancel()
 		}),
-		Stage: ({ expanded: t, fallback: n }) => /* @__PURE__ */ h(m, {
+		Stage: ({ expanded: t, fallback: n }) => /* @__PURE__ */ b(m, {
 			controller: a,
 			expanded: t,
 			fallback: n,
@@ -121,9 +155,25 @@ function C(e = {}) {
 			switchOff: () => a.switchOff(),
 			voiceLive: (e) => a.setVoiceLive(e)
 		},
+		tab: {
+			offered: {
+				subscribe: (e) => a.subscribe(e),
+				getSnapshot: () => a.getSnapshot().tabOffered
+			},
+			setOpen: (e) => a.setTabOpen(e),
+			heldByVoice: () => a.getSnapshot().heldByVoice,
+			View: (t) => /* @__PURE__ */ b(y, {
+				...t,
+				controller: a,
+				avatarVoices: l,
+				voiceStore: d,
+				...e.avatarNames ? { avatarNames: e.avatarNames } : {},
+				...e.defaultAvatarVoiceMode ? { defaultAvatarVoiceMode: e.defaultAvatarVoiceMode } : {}
+			})
+		},
 		controller: a,
 		dispose: () => a.dispose()
 	};
 }
 //#endregion
-export { C as createLiveAvatarSeam, g as isLiveAvatarBrowserSupported, _ as liveAvatarAuthorization, v as liveAvatarWorkspaceAuthorization };
+export { k as createLiveAvatarSeam, x as isLiveAvatarBrowserSupported, S as liveAvatarAuthorization, C as liveAvatarWorkspaceAuthorization };

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

@@ -30,11 +30,27 @@ export type LiveAvatarPhase =
 /** Ending the session. */
  | 'ending';
 export type LiveAvatarNotice = 'interrupted' | 'voice-only' | 'time-limit';
+/** A Turn off this soon after the tab's start click is the second click of a double click, not a choice (BOFF-9341, critic #2). */
+export declare const LIVE_AVATAR_TAB_OFF_GUARD_MS = 1000;
 export interface LiveAvatarSnapshot {
-    /** A voice conversation is live: the only time the avatar is offered (P2). */
+    /** A voice conversation is live: outside the Avatar tab, the only time the avatar is offered (P2). */
     readonly voiceLive: boolean;
-    /** The toggle may be shown: the browser can show the avatar, it was not refused on this page, and a voice conversation is live. */
+    /**
+     * The avatar may be asked for now: the browser can show it, it was not refused on this page, and a voice conversation is live or the
+     * Avatar tab is open.
+     */
     readonly offered: boolean;
+    /** The Avatar tab is open (BOFF-9341): while it is, the tab owns the avatar. */
+    readonly tabOpen: boolean;
+    /** The Avatar tab may be offered: the browser can show the avatar, and it was not refused on this page. */
+    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.
+     */
+    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. */
+    readonly heldByVoice: boolean;
     readonly phase: LiveAvatarPhase;
     /** The avatars the server offers, from the last availability answer. */
     readonly avatars: readonly string[];
@@ -104,26 +120,49 @@ export interface LiveAvatarControllerDeps {
     readonly readinessProbe?: AvatarReadinessProbeOptions | false;
     readonly onLog?: (event: LiveAvatarLogEvent) => void;
 }
+/** How a `requestOn` ends once the server offers the avatar. */
+export interface LiveAvatarRequestOptions {
+    /**
+     * Omitted: today's rule (the voice stage's toggle): the chooser, or a start at once when this page already confirmed this disclosure
+     * and there is nothing to choose. `false`: the chooser only, never a start (the tab opening, "Try again", a workspace switch).
+     * `true`: the person's Turn on, with the disclosure on screen: start with `avatarId` (else the one selected) once the answer comes,
+     * only if it is still offered and the disclosure version is the one shown at the click; otherwise the chooser.
+     */
+    readonly start?: boolean;
+    readonly avatarId?: string;
+}
 export interface LiveAvatarController {
     subscribe(listener: () => void): () => void;
     getSnapshot(): LiveAvatarSnapshot;
-    /** From the seam (P2): a voice conversation is live, or over. */
+    /** From the seam (P2): a voice conversation is live, or over. While the Avatar tab is open, its end ends nothing. */
     setVoiceLive(live: boolean): void;
-    /** The person asked for the avatar: ask the server whether it is offered, then show the chooser and the disclosure. */
-    requestOn(): void;
+    /** The person asked for the avatar: ask the server whether it is offered, then show the chooser and the disclosure (`options`). */
+    requestOn(options?: LiveAvatarRequestOptions): void;
     /** The person confirmed the disclosure: start a session with the chosen avatar. */
     confirm(): 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
+     * OFF (`user`), except an avatar `heldByVoice`, which stays on for Voice.
+     */
+    setTabOpen(open: boolean): void;
     /** The person declined the disclosure. */
     cancelChoice(): void;
     selectAvatar(avatarId: string): void;
-    /** Avatar OFF: the toggle, the compact view's stop, the end of the voice conversation (P2). Idempotent. */
+    /**
+     * Avatar OFF: the toggle, the compact view's stop, the tab's Turn off, the end of the voice conversation (P2). Idempotent. In the tab,
+     * an OFF within `LIVE_AVATAR_TAB_OFF_GUARD_MS` of the start click, while it is still starting, is ignored (a double click).
+     */
     switchOff(): void;
     /** A user gesture: let the avatar's sound play (autoplay) and wake the level meter. */
     resumeAudio(): void;
     /** The stage that shows the avatar mounted (or unmounted): replies go to the avatar only while it is shown (D4). */
     setStageMounted(mounted: boolean): void;
-    /** The stage's video element, or null when it goes. */
-    attachVideo(element: HTMLVideoElement | null): void;
+    /**
+     * A view's video element (a React 19 ref callback): the avatar's video shows in the latest one mounted. The returned cleanup releases
+     * THAT element only, so a view going never blanks another (the tab adopting the voice stage's avatar). `null`: release the current one.
+     */
+    attachVideo(element: HTMLVideoElement | null): (() => void) | undefined;
     /** Where one reply goes: the avatar, or the speakers (untouched). */
     route(options: SpeechSpeakOptions, base: SpeechEngine): 'avatar' | 'speakers';
     /** A fresh audio output for one reply routed to the avatar. */