@burdenoff/fe-libs 2026.1014.4 → 2026.1015.1

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

@@ -1,36 +1,83 @@
 import { StoreApi, UseBoundStore } from 'zustand';
 import { PersistStorage } from 'zustand/middleware';
+import { HostedSpeaker } from '../speech/hostedVoiceCatalogue';
 /** The base storage name; the profile prefix is added by the profile-scoped storage. */
 export declare const AVATAR_PREFERENCES_STORAGE_NAME = "hb-ai-assistant-avatar";
 /**
- * Which voice the avatar speaks with: the voice the person already picked for
- * the assistant (`mine`, the default: their current voice is kept), or the one
- * recommended for the chosen avatar (`paired`).
+ * Which voice the avatar speaks with (BOFF-9341). Only replies the avatar takes
+ * use it; the assistant's own voice, the one Chat reads aloud with, is never
+ * changed by it.
+ *  - `mine`: the voice the person already picked for the assistant ("Keep my
+ *    current voice");
+ *  - `paired`: the speaker the HOST configured for the avatar on screen
+ *    ("Default for this avatar"), so it follows the face when the face is
+ *    switched; a face with none configured keeps the assistant's voice;
+ *  - `speaker`: one of the hosted speakers (`avatarSpeaker`), in the language
+ *    of each reply.
+ */
+export type AvatarVoiceMode = 'mine' | 'paired' | 'speaker';
+/** A mode a host may make the default (`createLiveAvatarSeam`'s `defaultAvatarVoiceMode`): a speaker is the person's own pick. */
+export type AvatarVoiceDefault = Exclude<AvatarVoiceMode, 'speaker'>;
+/** What applies when neither the person nor the host chose: their current voice is kept. */
+export declare const DEFAULT_AVATAR_VOICE_MODE: AvatarVoiceDefault;
+/**
+ * What is written. `v` is this file's own format number (see the header); it
+ * stays 1, because every field is validated on merge and an older build reads
+ * the two it knows (`avatarId`, and `voiceMode`, where anything it does not
+ * know reads as `mine`).
+ *
+ * ★★ `voiceChosen` marks a voice the PERSON chose. Builds before BOFF-9341 had
+ * no voice control and wrote `voiceMode: 'mine'` as a default; read as a
+ * choice, it would hide the host's default (`defaultAvatarVoiceMode`) from
+ * everyone who ever used the avatar. Without the mark, a stored voice is no
+ * choice at all.
  */
-export type AvatarVoiceMode = 'paired' | 'mine';
-export declare const DEFAULT_AVATAR_VOICE_MODE: AvatarVoiceMode;
-/** What is written. `v` is this file's own format number (see the header). */
 export interface AvatarPreferencesPersisted {
     v: 1;
     avatarId: string | null;
-    voiceMode: AvatarVoiceMode;
+    voiceMode: AvatarVoiceMode | null;
+    avatarSpeaker: HostedSpeaker | null;
+    voiceChosen: boolean;
+}
+/** The person's voice choice for the avatar, as the seam reads it. */
+export interface AvatarVoicePreference {
+    /** Null until the person chooses: the host's default applies, else `DEFAULT_AVATAR_VOICE_MODE`. */
+    readonly voiceMode: AvatarVoiceMode | null;
+    /** The speaker of `voiceMode: 'speaker'`, and null in every other mode. */
+    readonly avatarSpeaker: HostedSpeaker | null;
 }
-export interface AvatarPreferencesState {
+export interface AvatarPreferencesState extends AvatarVoicePreference {
     /** Never persisted: every page load starts with the avatar OFF. */
     avatarEnabled: boolean;
     /** The chosen avatar, or null before one is chosen. */
     avatarId: string | null;
-    voiceMode: AvatarVoiceMode;
     setAvatarEnabled: (enabled: boolean) => void;
     setAvatarId: (avatarId: string | null) => void;
-    setVoiceMode: (mode: AvatarVoiceMode) => void;
+    /** The person picks "Keep my current voice" or "Default for this avatar". Anything else is ignored. */
+    setVoiceMode: (mode: AvatarVoiceDefault) => void;
+    /** The person picks one of the hosted speakers. Anything not in `HOSTED_SPEAKERS` is ignored. */
+    setAvatarSpeaker: (speaker: HostedSpeaker) => void;
 }
 export declare function resolveStoredAvatarId(value: unknown): string | null;
-export declare function resolveStoredAvatarVoiceMode(value: unknown): AvatarVoiceMode;
-export declare function avatarPreferencesToPersist(state: Pick<AvatarPreferencesState, 'avatarId' | 'voiceMode'>): AvatarPreferencesPersisted;
+/** A stored voice mode this build knows, or null (no choice): never a guess. */
+export declare function resolveStoredAvatarVoiceMode(value: unknown): AvatarVoiceMode | null;
+/**
+ * The voice choice a stored snapshot holds: a mode and, for `speaker`, a speaker
+ * this build offers. Not marked as the person's (`voiceChosen`), or a speaker
+ * mode without a valid speaker (a hand edit, or a speaker a later build added):
+ * no choice, so the host's default applies again rather than a voice nobody
+ * picked.
+ */
+export declare function resolveStoredAvatarVoice(stored: Record<string, unknown>): AvatarVoicePreference;
+/**
+ * The mode that applies: the person's choice ALWAYS wins; then the host's
+ * default (`createLiveAvatarSeam`'s `defaultAvatarVoiceMode`); then `mine`.
+ */
+export declare function resolveAvatarVoiceMode(preference: AvatarVoicePreference, hostDefault?: AvatarVoiceDefault): AvatarVoiceMode;
+export declare function avatarPreferencesToPersist(state: Pick<AvatarPreferencesState, 'avatarId' | 'voiceMode' | 'avatarSpeaker'>): AvatarPreferencesPersisted;
 /**
- * Fold what storage holds into the live state. Only the two preference fields
- * are taken, each validated; `avatarEnabled` and the actions always come from
+ * Fold what storage holds into the live state. Only the preference fields are
+ * taken, each validated; `avatarEnabled` and the actions always come from
  * `current`, whatever the stored value says.
  */
 export declare function mergePersistedAvatarPreferences(persisted: unknown, current: AvatarPreferencesState): AvatarPreferencesState;

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

@@ -1,46 +1,79 @@
 import { createProfileScopedStorage as e } from "../../utils/profileScopedStorage.js";
 import "../../../shared-utils.js";
 import { createGuardedAssistantStorage as t } from "../guardedStorage.js";
-import { create as n } from "zustand";
-import { persist as r } from "zustand/middleware";
+import { isHostedSpeaker as n } from "../speech/hostedVoiceCatalogue.js";
+import { create as r } from "zustand";
+import { persist as i } from "zustand/middleware";
 //#region src/shared/assistant/avatar/avatarPreferences.ts
-var i = "hb-ai-assistant-avatar", a = "mine", o = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
-function s(e) {
-	return typeof e == "string" && o.test(e) ? e : null;
-}
+var a = "hb-ai-assistant-avatar", o = "mine", s = /^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/;
 function c(e) {
-	return e === "mine" || e === "paired" ? e : a;
+	return typeof e == "string" && s.test(e) ? e : null;
 }
 function l(e) {
+	return e === "mine" || e === "paired" || e === "speaker" ? e : null;
+}
+function u(e) {
+	let t = {
+		voiceMode: null,
+		avatarSpeaker: null
+	};
+	if (e.voiceChosen !== !0) return t;
+	let r = l(e.voiceMode);
+	return r === null ? t : r === "speaker" ? n(e.avatarSpeaker) ? {
+		voiceMode: r,
+		avatarSpeaker: e.avatarSpeaker
+	} : t : {
+		voiceMode: r,
+		avatarSpeaker: null
+	};
+}
+function d(e, t = o) {
+	return e.voiceMode ?? t;
+}
+function f(e) {
 	return {
 		v: 1,
 		avatarId: e.avatarId,
-		voiceMode: e.voiceMode
+		voiceMode: e.voiceMode,
+		avatarSpeaker: e.voiceMode === "speaker" ? e.avatarSpeaker : null,
+		voiceChosen: e.voiceMode !== null
 	};
 }
-function u(e, t) {
+function p(e, t) {
 	let n = typeof e == "object" && e ? e : {};
 	return {
 		...t,
-		avatarId: s(n.avatarId),
-		voiceMode: c(n.voiceMode)
+		avatarId: c(n.avatarId),
+		...u(n)
 	};
 }
-function d(e) {
-	return n()(r((e) => ({
+function m(e) {
+	return r()(i((e) => ({
 		avatarEnabled: !1,
 		avatarId: null,
-		voiceMode: a,
+		voiceMode: null,
+		avatarSpeaker: null,
 		setAvatarEnabled: (t) => e({ avatarEnabled: t }),
-		setAvatarId: (t) => e({ avatarId: s(t) }),
-		setVoiceMode: (t) => e({ voiceMode: c(t) })
+		setAvatarId: (t) => e({ avatarId: c(t) }),
+		setVoiceMode: (t) => {
+			t !== "mine" && t !== "paired" || e({
+				voiceMode: t,
+				avatarSpeaker: null
+			});
+		},
+		setAvatarSpeaker: (t) => {
+			n(t) && e({
+				voiceMode: "speaker",
+				avatarSpeaker: t
+			});
+		}
 	}), {
-		name: i,
+		name: a,
 		storage: e,
-		partialize: l,
-		merge: u
+		partialize: f,
+		merge: p
 	}));
 }
-var f = d(t(e()));
+var h = m(t(e()));
 //#endregion
-export { i as AVATAR_PREFERENCES_STORAGE_NAME, a as DEFAULT_AVATAR_VOICE_MODE, l as avatarPreferencesToPersist, d as createAvatarPreferencesStore, u as mergePersistedAvatarPreferences, s as resolveStoredAvatarId, c as resolveStoredAvatarVoiceMode, f as useAvatarPreferencesStore };
+export { a as AVATAR_PREFERENCES_STORAGE_NAME, o as DEFAULT_AVATAR_VOICE_MODE, f as avatarPreferencesToPersist, m as createAvatarPreferencesStore, p as mergePersistedAvatarPreferences, d as resolveAvatarVoiceMode, c as resolveStoredAvatarId, u as resolveStoredAvatarVoice, l as resolveStoredAvatarVoiceMode, h as useAvatarPreferencesStore };

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

@@ -0,0 +1,33 @@
+import { FC } from 'react';
+import { HostedSpeaker } from '../../speech/hostedVoiceCatalogue';
+import { SpeechVoiceLike } from '../../speech/types';
+import { LiveAvatarTabProps } from '../../ui/assistantLiveAvatarSeam';
+import { AvatarVoiceDefault, AvatarVoicePreference } from '../avatarPreferences';
+import { LiveAvatarVoices } from './avatarVoice';
+import { LiveAvatarController } from './liveAvatarController';
+/** The person's avatar voice choice: read by the engine decorator per reply, written by the tab's select. STABLE. */
+export interface LiveAvatarVoiceStore {
+    getState(): AvatarVoicePreference;
+    subscribe(listener: () => void): () => void;
+    setVoiceMode(mode: AvatarVoiceDefault): void;
+    setAvatarSpeaker(speaker: HostedSpeaker): void;
+}
+export interface LiveAvatarTabViewProps extends LiveAvatarTabProps {
+    readonly controller: LiveAvatarController;
+    /** Display names for the avatar ids the server offers; without one the chooser numbers them. */
+    readonly avatarNames?: Readonly<Record<string, string>>;
+    /** The host's speaker per avatar ("Default for this avatar"). */
+    readonly avatarVoices: LiveAvatarVoices;
+    readonly defaultAvatarVoiceMode?: AvatarVoiceDefault;
+    readonly voiceStore: LiveAvatarVoiceStore;
+    /** Wall-clock milliseconds: the retry time and the Turn off guard. Tests pass their own. */
+    readonly now?: () => number;
+}
+/** A voice name as the person reads it: a hosted voice by its speaker ("Kore"), any other by its own name. */
+export declare function avatarVoiceDisplayName(name: string): string;
+/**
+ * `speaker` in the language the person speaks, as the engine lists it for that language (`voiceChoices`); null when it is not offered
+ * there (no hosted voice for the language, or a hosted engine latched off, which lists none).
+ */
+export declare function avatarPreviewVoice(speaker: HostedSpeaker, voiceChoices: readonly SpeechVoiceLike[]): SpeechVoiceLike | null;
+export declare const LiveAvatarTabView: FC<LiveAvatarTabViewProps>;

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

@@ -0,0 +1,278 @@
+import { HOSTED_SPEAKERS as e, isHostedSpeaker as t } from "../../speech/hostedVoiceCatalogue.js";
+import { useAvatarCopy as n } from "../useAvatarCopy.js";
+import { useAssistantSpeech as ee } from "../../ui/AssistantSpeechProvider.js";
+import { resolveAvatarVoiceMode as te } from "../avatarPreferences.js";
+import "./liveAvatarController.js";
+import { liveAvatarStatusText as ne } from "./liveAvatarStatus.js";
+import { hostedAvatarVoice as r } from "./avatarVoice.js";
+import { useCallback as re, useEffect as i, useId as a, useLayoutEffect as ie, useRef as o, useState as s, useSyncExternalStore as c } from "react";
+import { Volume2 as l } from "lucide-react";
+import { jsx as u, jsxs as d } from "react/jsx-runtime";
+//#region src/shared/assistant/avatar/live/LiveAvatarTabView.tsx
+var f = "mine", p = "paired", m = "speaker:", h = /-Chirp3-HD-([A-Za-z]+)$/;
+function g(e) {
+	let n = h.exec(e)?.[1];
+	return n !== void 0 && t(n) ? n : e;
+}
+function _(e, t) {
+	let n = t.find((e) => e.source === "hosted")?.lang;
+	return n === void 0 ? null : r(e, n, t);
+}
+var v = "text-xs font-medium text-text-secondary", y = "text-xs text-text-muted", b = "focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong", x = `inline-flex min-h-11 w-full items-center justify-center gap-2 rounded-xl border border-border-default bg-bg-elevated px-4 text-sm font-medium text-text-primary transition-colors hover:bg-bg-raised aria-disabled:cursor-default aria-disabled:opacity-60 aria-disabled:hover:bg-bg-elevated ${b}`, ae = `inline-flex min-h-11 w-full items-center justify-center rounded-xl bg-action-primary-bg px-4 text-sm font-medium text-action-primary-text transition-colors hover:bg-action-primary-bg-hover aria-disabled:cursor-default aria-disabled:opacity-60 aria-disabled:hover:bg-action-primary-bg ${b}`, oe = "relative inline-flex min-h-11 min-w-0 max-w-full cursor-pointer items-center rounded-full border px-4 text-sm font-medium transition-colors focus-within:ring-2 focus-within:ring-border-strong", se = "absolute inset-0 m-0 size-full cursor-pointer appearance-none rounded-full opacity-0", S = ({ controller: r, shown: h, voice: S, handsFreeOff: C, leaveHintId: ce, startVoiceRef: w, avatarNames: le, avatarVoices: ue, defaultAvatarVoiceMode: de, voiceStore: T, now: E = Date.now }) => {
+	let D = n(), O = ee(), k = a(), A = a(), j = a(), M = a(), N = a(), P = o(null), F = c(r.subscribe, r.getSnapshot, r.getSnapshot), I = c(T.subscribe, T.getState, T.getState);
+	i(() => {
+		if (h) return r.setStageMounted(!0), () => r.setStageMounted(!1);
+	}, [r, h]), i(() => {
+		let e = r.getSnapshot();
+		e.phase === "off" && e.avatars.length === 0 && r.requestOn({ start: !1 });
+	}, [r]);
+	let { phase: L } = F, R = L === "starting" || L === "connecting" || L === "ready" || L === "ending", [z, B] = s(!1);
+	z && (L === "off" || L === "choosing" || L === "ready" || L === "ending") && B(!1);
+	let V = E(), fe = F.retryAt !== null && F.retryAt > V, H = ne(F, D, V), U = F.selectedAvatarId, W = (e) => {
+		let t = F.avatars.indexOf(e);
+		return le?.[e] ?? (t === -1 ? D.chooserNone : `${D.chooserLabel} ${t + 1}`);
+	}, G = L === "ready" ? { kind: "turn-off" } : L === "ending" ? { kind: "ending" } : z || L === "starting" || L === "connecting" ? { kind: "starting" } : F.offered ? {
+		kind: "turn-on",
+		ready: !fe && U !== null && (L === "choosing" || L === "off" && F.avatars.includes(U))
+	} : null, K = o(null), q = G?.kind === "turn-off";
+	ie(() => {
+		K.current = q ? E() : null;
+	}, [q, E]);
+	let pe = re((e) => {
+		if (e !== null) return () => {
+			e.ownerDocument.activeElement === e && P.current?.focus();
+		};
+	}, []), me = () => {
+		if (G !== null) switch (G.kind) {
+			case "turn-on":
+				if (!G.ready || U === null) return;
+				B(!0), L === "choosing" ? r.confirm() : r.requestOn({
+					start: !0,
+					avatarId: U
+				});
+				return;
+			case "turn-off": {
+				let e = K.current;
+				if (e !== null && E() - e < 1e3) return;
+				r.switchOff();
+				return;
+			}
+			case "starting":
+			case "ending": return;
+		}
+	}, J = te(I, de), Y = U === null ? null : ue.get(U) ?? null, X = J === "speaker" && I.avatarSpeaker !== null ? `${m}${I.avatarSpeaker}` : J === "paired" && Y !== null ? p : f, Z = X === p ? Y : X.startsWith(m) ? I.avatarSpeaker : null, Q = X === f ? O.activeVoiceName : Z === null ? null : _(Z, O.voiceChoices)?.name ?? null, he = O.speakingMessageId !== null || O.spokenChunks !== null, $ = Q !== null && !S.live && !he, ge = O.activeVoiceName ? D.voiceModeMineNamed(g(O.activeVoiceName)) : D.voiceModeMine, _e = (e) => {
+		if (e === f || e === p) {
+			T.setVoiceMode(e);
+			return;
+		}
+		let n = e.slice(8);
+		e.startsWith(m) && t(n) && T.setAvatarSpeaker(n);
+	}, ve = L === "ending" ? D.stateEnding : L === "connecting" || L === "ready" ? D.stageWaiting : L === "starting" ? D.stateStarting : D.stateOff, ye = L === "off" && F.avatars.length === 0 && F.problem !== null && F.offered;
+	return /* @__PURE__ */ d("div", {
+		ref: P,
+		tabIndex: -1,
+		className: "flex min-h-full shrink-0 flex-col gap-3 focus:outline-none",
+		"data-testid": "assistant-avatar-tab-view",
+		children: [
+			/* @__PURE__ */ u("div", {
+				className: "flex max-h-80 min-h-[7.5rem] grow basis-30 justify-center",
+				children: /* @__PURE__ */ d("div", {
+					className: "relative aspect-square h-full max-w-full overflow-hidden rounded-2xl border border-border-subtle bg-bg-sunken",
+					"data-testid": "assistant-avatar-tab-frame",
+					"data-phase": L,
+					children: [
+						R ? /* @__PURE__ */ u("video", {
+							ref: r.attachVideo,
+							className: `size-full object-cover ${F.videoReady ? "" : "invisible"}`,
+							"aria-label": D.stageLabel,
+							autoPlay: !0,
+							muted: !0,
+							playsInline: !0,
+							"data-testid": "assistant-avatar-tab-video"
+						}) : null,
+						R && F.videoReady ? null : /* @__PURE__ */ u("p", {
+							className: "absolute inset-0 flex items-center justify-center p-3 text-center text-sm text-text-muted",
+							children: ve
+						}),
+						F.audioBlocked ? /* @__PURE__ */ d("button", {
+							type: "button",
+							onClick: () => r.resumeAudio(),
+							className: `absolute inset-x-2 bottom-2 inline-flex min-h-11 items-center justify-center gap-1.5 rounded-xl bg-bg-elevated px-3 text-xs font-medium text-text-primary ${b}`,
+							"data-testid": "assistant-avatar-tab-sound",
+							children: [/* @__PURE__ */ u(l, {
+								className: "size-4 shrink-0",
+								"aria-hidden": "true"
+							}), /* @__PURE__ */ u("span", { children: D.problem("playback-blocked") })]
+						}) : null
+					]
+				})
+			}),
+			/* @__PURE__ */ u("p", {
+				className: H === null ? "sr-only" : "text-center text-sm text-text-secondary",
+				role: "status",
+				"data-testid": "assistant-avatar-tab-status",
+				children: H ?? ""
+			}),
+			F.avatars.length > 1 && !R ? /* @__PURE__ */ d("fieldset", {
+				className: "flex min-w-0 flex-col gap-1.5",
+				"data-testid": "assistant-avatar-tab-chooser",
+				children: [/* @__PURE__ */ u("legend", {
+					className: v,
+					children: D.chooserTitle
+				}), /* @__PURE__ */ u("div", {
+					className: "flex flex-wrap gap-2",
+					children: F.avatars.map((e) => {
+						let t = e === U, n = W(e);
+						return /* @__PURE__ */ d("label", {
+							className: `${oe} ${t ? "border-transparent bg-action-primary-bg text-action-primary-text" : "border-border-default bg-bg-elevated text-text-secondary hover:bg-bg-raised hover:text-text-primary"}`,
+							title: t ? D.chooserSelected(n) : D.chooserOption(n),
+							children: [/* @__PURE__ */ u("input", {
+								type: "radio",
+								name: A,
+								value: e,
+								checked: t,
+								onChange: () => r.selectAvatar(e),
+								className: se,
+								"data-avatar-id": e
+							}), /* @__PURE__ */ u("span", {
+								className: "truncate",
+								children: n
+							})]
+						}, e);
+					})
+				})]
+			}) : F.avatars.length > 0 && U !== null ? /* @__PURE__ */ d("div", {
+				className: "flex flex-col gap-0.5",
+				"data-testid": "assistant-avatar-tab-chosen",
+				children: [/* @__PURE__ */ d("p", {
+					className: "flex min-w-0 items-baseline gap-2 text-sm",
+					children: [/* @__PURE__ */ u("span", {
+						className: v,
+						children: D.chooserLabel
+					}), /* @__PURE__ */ u("span", {
+						className: "truncate text-text-primary",
+						children: W(U)
+					})]
+				}), R && F.avatars.length > 1 ? /* @__PURE__ */ u("p", {
+					className: y,
+					children: D.chooserLocked
+				}) : null]
+			}) : L === "choosing" ? /* @__PURE__ */ u("p", {
+				className: y,
+				"data-testid": "assistant-avatar-tab-empty",
+				children: D.chooserEmpty
+			}) : null,
+			/* @__PURE__ */ d("div", {
+				className: "flex flex-col gap-1",
+				children: [
+					/* @__PURE__ */ u("label", {
+						htmlFor: j,
+						className: v,
+						children: D.voiceModeLabel
+					}),
+					/* @__PURE__ */ d("div", {
+						className: "flex items-center gap-2",
+						children: [/* @__PURE__ */ d("select", {
+							id: j,
+							value: X,
+							onChange: (e) => _e(e.target.value),
+							"aria-describedby": M,
+							className: `min-h-11 min-w-0 flex-1 rounded-xl border border-border-default bg-bg-elevated px-3 text-sm text-text-primary scheme-normal dark:scheme-dark [&_option]:bg-bg-surface [&_option]:text-text-primary ${b}`,
+							"data-testid": "assistant-avatar-tab-voice",
+							children: [
+								/* @__PURE__ */ u("option", {
+									value: f,
+									children: ge
+								}),
+								Y === null ? null : /* @__PURE__ */ u("option", {
+									value: p,
+									children: D.voiceModeDefaultNamed(Y)
+								}),
+								e.map((e) => /* @__PURE__ */ u("option", {
+									value: `${m}${e}`,
+									children: e
+								}, e))
+							]
+						}), /* @__PURE__ */ u("button", {
+							type: "button",
+							onClick: () => {
+								$ && Q !== null && O.previewVoice(Q);
+							},
+							"aria-disabled": !$,
+							"aria-label": D.hearVoice,
+							title: D.hearVoice,
+							className: `inline-flex size-11 shrink-0 items-center justify-center rounded-xl border border-border-default bg-bg-elevated text-text-secondary transition-colors hover:bg-bg-raised hover:text-text-primary aria-disabled:cursor-default aria-disabled:opacity-60 ${b}`,
+							"data-testid": "assistant-avatar-tab-hear",
+							children: /* @__PURE__ */ u(l, {
+								className: "size-5",
+								"aria-hidden": "true"
+							})
+						})]
+					}),
+					/* @__PURE__ */ u("p", {
+						id: M,
+						className: y,
+						children: D.voiceModeHint
+					})
+				]
+			}),
+			R ? null : /* @__PURE__ */ u("p", {
+				id: k,
+				className: "text-xs text-text-secondary",
+				"data-testid": "assistant-avatar-tab-disclosure",
+				children: D.consent
+			}),
+			G === null ? null : /* @__PURE__ */ u("button", {
+				ref: pe,
+				type: "button",
+				onClick: me,
+				"aria-disabled": G.kind === "turn-on" ? !G.ready : G.kind !== "turn-off",
+				"aria-describedby": G.kind === "turn-on" ? k : void 0,
+				className: G.kind === "turn-off" ? x : ae,
+				"data-testid": "assistant-avatar-tab-switch",
+				"data-slot": G.kind,
+				children: G.kind === "turn-off" ? D.stop : G.kind === "starting" ? D.turnOnStarting : G.kind === "ending" ? D.stateEnding : D.consentConfirm
+			}),
+			ye ? /* @__PURE__ */ u("button", {
+				type: "button",
+				onClick: () => r.requestOn({ start: !1 }),
+				className: x,
+				"data-testid": "assistant-avatar-tab-retry",
+				children: D.chooserRetry
+			}) : null,
+			S.live ? null : /* @__PURE__ */ d("div", {
+				className: "flex flex-col gap-1",
+				children: [/* @__PURE__ */ u("button", {
+					ref: w,
+					type: "button",
+					onClick: () => {
+						S.blocked === null && S.start();
+					},
+					"aria-disabled": S.blocked !== null,
+					"aria-describedby": S.blocked === null ? void 0 : N,
+					className: x,
+					"data-testid": "assistant-avatar-tab-start-voice",
+					children: D.startVoice
+				}), S.blocked === null ? null : /* @__PURE__ */ u("p", {
+					id: N,
+					className: y,
+					"data-testid": "assistant-avatar-tab-voice-blocked",
+					children: S.impossible && !R ? `${S.blocked} ${D.askNeedsVoice}` : S.blocked
+				})]
+			}),
+			C && !F.voiceLive ? /* @__PURE__ */ u("p", {
+				className: y,
+				"data-testid": "assistant-avatar-tab-hands-free",
+				children: D.handsFreeOff
+			}) : null,
+			R && !F.heldByVoice ? /* @__PURE__ */ u("p", {
+				id: ce,
+				className: y,
+				"data-testid": "assistant-avatar-tab-leave-hint",
+				children: D.tabLeaveHint
+			}) : null
+		]
+	});
+};
+//#endregion
+export { S as LiveAvatarTabView, _ as avatarPreviewVoice, g as avatarVoiceDisplayName };

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

@@ -99,6 +99,11 @@ export interface AvatarRefusal {
     readonly hide: boolean;
     /** The server's disclosure version changed (`consent_required`): ask availability again, show the disclosure to confirm again. */
     readonly showDisclosure?: true;
+    /**
+     * A "not now" refusal (busy, started too quickly, the avatar time used up): when the server said when to try again (its Retry-After),
+     * in seconds. Absent when it said nothing: the person is then told no time, and nothing waits for one.
+     */
+    readonly retryAfterSeconds?: number;
 }
 /**
  * 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

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

@@ -224,8 +224,24 @@ function y(e) {
 		}
 	};
 }
-function b(e) {
-	if (!(e instanceof s) || e.status === 0) return {
+var b = new Set([
+	"capacity",
+	"rate-limited",
+	"budget-exhausted"
+]);
+function x(e) {
+	if (!(e instanceof s)) return {
+		problem: "connection",
+		hide: !1
+	};
+	let t = S(e);
+	return t.problem !== null && b.has(t.problem) && e.retryAfterSeconds !== null ? {
+		...t,
+		retryAfterSeconds: e.retryAfterSeconds
+	} : t;
+}
+function S(e) {
+	if (e.status === 0) return {
 		problem: "connection",
 		hide: !1
 	};
@@ -274,11 +290,14 @@ function b(e) {
 			problem: "start-timeout",
 			hide: !1
 		};
-		case "avatar_paused":
-		case "budget_exhausted": return {
+		case "avatar_paused": return {
 			problem: "paused",
 			hide: !1
 		};
+		case "budget_exhausted": return {
+			problem: "budget-exhausted",
+			hide: !1
+		};
 		case "avatar_unavailable": return {
 			problem: "unavailable",
 			hide: !1
@@ -309,7 +328,7 @@ function b(e) {
 		};
 	}
 }
-function x(e) {
+function C(e) {
 	return e === "unavailable" ? {
 		problem: "capacity",
 		hide: !1
@@ -319,4 +338,4 @@ function x(e) {
 	};
 }
 //#endregion
-export { e as AVATAR_API_PATH, s as AvatarApiError, a as avatarApiBaseFromTtsEndpoint, x as avatarAvailabilityRefusal, c as avatarIdempotencyKey, b as avatarRefusalFor, y as createAvatarSessionClient };
+export { e as AVATAR_API_PATH, s as AvatarApiError, a as avatarApiBaseFromTtsEndpoint, C as avatarAvailabilityRefusal, c as avatarIdempotencyKey, x as avatarRefusalFor, y as createAvatarSessionClient };

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

@@ -0,0 +1,43 @@
+import { HostedSpeaker } from '../../speech/hostedVoiceCatalogue';
+import { SpeechAudioOutput, SpeechVoiceLike } from '../../speech/types';
+import { AvatarVoiceDefault, AvatarVoicePreference } from '../avatarPreferences';
+/** The host's speaker per avatar id, validated (`liveAvatarVoicesFrom`). */
+export type LiveAvatarVoices = ReadonlyMap<string, HostedSpeaker>;
+/**
+ * The host's `avatarVoices` as this module reads them: only plausible avatar ids, each with a speaker the hosted tier offers. A host's
+ * JavaScript can pass anything, and a Map keeps an id such as `constructor` from reading an object's own machinery.
+ */
+export declare function liveAvatarVoicesFrom(input: unknown): LiveAvatarVoices;
+/** Everything the speaker depends on besides the person's choice. */
+export interface AvatarSpeakerContext {
+    /** The host's default for a person who has not chosen (`createLiveAvatarSeam`'s `defaultAvatarVoiceMode`). */
+    readonly hostDefault?: AvatarVoiceDefault;
+    readonly avatarVoices: LiveAvatarVoices;
+    /** The avatar the reply goes to: the one the person started. */
+    readonly avatarId: string | null;
+}
+/** The speaker the avatar's replies use now, or null: the assistant's own voice. */
+export declare function avatarSpeakerFor(preference: AvatarVoicePreference, context: AvatarSpeakerContext): HostedSpeaker | null;
+/**
+ * `speaker` in the language of a reply (`lang`, the app's tag), as the engine lists it; null when the vendor has no voice for that
+ * language, or the engine does not offer it now (a hosted engine latched off lists no hosted voice). Null keeps the assistant's voice.
+ */
+export declare function hostedAvatarVoice(speaker: HostedSpeaker, lang: string, voices: readonly SpeechVoiceLike[]): SpeechVoiceLike | null;
+/**
+ * ★★ The avatar left mid-reply (switched off, its session ended, or its output failed): the rest of that reply plays on the speakers
+ * (`SpeechAudioOutput`'s leave rule), and must not go on in the AVATAR's voice there. `restore` is called once, the moment the avatar
+ * stops being the reply's destination, so every piece synthesised AFTER it is asked for in the assistant's voice. That moment is the
+ * first of:
+ *  - `leaves` reporting it: the session the reply went to is no longer ready (the controller's own state, which changes in the same
+ *    call that ends the session, before the output answers anything);
+ *  - the output rejecting a `write` or `drain` (a leave, a failure, or a refusal, after which nothing plays at all).
+ *
+ * What cannot be changed: the pieces already synthesised when the avatar left. The hosted engine never synthesises a piece twice
+ * (a fallback replays the bytes it has) and keeps one piece ahead, so at most two pieces are in the avatar's voice: the one handed to the
+ * avatar (not played again when it may have been heard there, R4) and the one fetched after it, which plays on the speakers. Every later
+ * piece is in the assistant's voice.
+ *
+ * The reply over (its last `drain` resolved, or `cancel()`), nothing is watched any more. The output's calls are passed through
+ * untouched, their promises included: the engine sees exactly what the output said.
+ */
+export declare function restoreVoiceWhenOutputLeaves(output: SpeechAudioOutput, restore: () => void, leaves?: (onLeave: () => void) => () => void): SpeechAudioOutput;