@burdenoff/fe-libs 2026.1016.2 → 2026.1016.3

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

@@ -1,99 +1,137 @@
 import { useI18n as e } from "../../providers/shell/I18nProvider.js";
 import { useAssistantTr as t } from "../i18n.js";
-import { useMemo as n } from "react";
+import { VOICE_THINKING_LABEL as n } from "../voice/voiceStatus.js";
+import { useMemo as r } from "react";
 //#region src/shared/assistant/avatar/useAvatarCopy.ts
-var r = {
+var i = {
 	hour: "numeric",
 	minute: "2-digit"
-}, i = {
+}, a = {
 	month: "short",
 	day: "numeric",
 	hour: "numeric",
 	minute: "2-digit"
 };
-function a(e, t, n) {
-	let a = new Date(e).toDateString() === new Date(t).toDateString() ? r : i;
+function o(e, t, n) {
+	let r = new Date(e).toDateString() === new Date(t).toDateString() ? i : a;
 	try {
-		return new Intl.DateTimeFormat(n, a).format(e);
+		return new Intl.DateTimeFormat(n, r).format(e);
 	} catch {
-		return new Intl.DateTimeFormat("en", a).format(e);
+		return new Intl.DateTimeFormat("en", r).format(e);
 	}
 }
-function o() {
-	let r = t(), { locale: i } = e();
-	return n(() => ({
-		toggle: r("avatar.toggle", "Live avatar"),
-		toggleHint: r("avatar.toggleHint", "Show the assistant as a speaking avatar during voice conversations."),
-		stop: r("avatar.stop", "Turn off the avatar"),
-		consent: r("avatar.consent", "Turning on Avatar shares the assistant's reply audio with LiveKit and Protoface to animate the avatar. This feature does not send your microphone audio to Protoface."),
-		consentConfirm: r("avatar.consentConfirm", "Turn on the avatar"),
-		consentCancel: r("avatar.consentCancel", "Not now"),
-		stateOff: r("avatar.stateOff", "Avatar off"),
-		stateOn: r("avatar.stateOn", "Avatar on"),
-		stateStarting: r("avatar.stateStarting", "Starting the avatar…"),
-		stateReady: r("avatar.stateReady", "Avatar ready"),
-		stateEnding: r("avatar.stateEnding", "Stopping the avatar…"),
-		stateInterrupted: r("avatar.stateInterrupted", "The avatar was interrupted. You can keep talking."),
-		stateVoiceOnly: r("avatar.stateVoiceOnly", "The avatar is unavailable right now. Continuing with voice only."),
-		stateTimeLimit: r("avatar.stateTimeLimit", "The avatar reached its time limit. Continuing with voice only."),
-		stageLabel: r("avatar.stageLabel", "Live avatar"),
-		stageWaiting: r("avatar.stageWaiting", "Waiting for the avatar…"),
-		chooserTitle: r("avatar.chooserTitle", "Choose an avatar"),
-		chooserLabel: r("avatar.chooserLabel", "Avatar"),
-		chooserNone: r("avatar.chooserNone", "No avatar chosen"),
-		chooserLoading: r("avatar.chooserLoading", "Loading avatars…"),
-		chooserEmpty: r("avatar.chooserEmpty", "No avatars are available."),
-		chooserRetry: r("avatar.chooserRetry", "Try again"),
-		chooserOption: (e) => r("avatar.chooserOption", "Use {{name}}", { name: e }),
-		chooserSelected: (e) => r("avatar.chooserSelected", "{{name}} (selected)", { name: e }),
-		voiceModeLabel: r("avatar.voiceModeLabel", "Avatar voice"),
-		voiceModeDefaultNamed: (e) => r("avatar.voiceModeDefaultNamed", "Default for this avatar ({{name}})", { name: e }),
-		voiceModeMine: r("avatar.voiceModeMine", "Keep my current voice"),
-		voiceModeMineNamed: (e) => r("avatar.voiceModeMineNamed", "Keep my current voice ({{name}})", { name: e }),
-		voiceModeHint: r("avatar.voiceModeNextReplyHint", "Used from the avatar's next reply. The assistant's own voice doesn't change."),
-		tabsLabel: r("avatar.tabsLabel", "Assistant views"),
-		tabChat: r("avatar.tabChat", "Chat"),
-		tabAvatar: r("avatar.tabAvatar", "Avatar"),
-		chooserLocked: r("avatar.chooserLocked", "Turn off the avatar to change it."),
-		tabLeaveHint: r("avatar.tabLeaveHint", "Leaving the Avatar tab turns the avatar off."),
-		availableAgain: (e) => r("avatar.availableAgain", "You can start it again at {{time}}.", { time: e }),
-		retryTime: (e, t) => a(e, t, i),
-		stateTimeLimitNoVoice: r("avatar.stateTimeLimitNoVoice", "The avatar reached its time limit."),
-		stateVoiceOnlyNoVoice: r("avatar.stateVoiceOnlyNoVoice", "The avatar is unavailable right now."),
-		turnOnStarting: r("avatar.turnOnStarting", "Starting the avatar…"),
-		startVoice: r("voiceSession.start", "Start a voice conversation"),
-		hearVoice: r("voice.preview", "Hear this voice"),
+function s() {
+	let i = t(), { locale: a } = e();
+	return r(() => ({
+		toggle: i("avatar.toggle", "Live avatar"),
+		toggleHint: i("avatar.toggleHint", "Show the assistant as a speaking avatar during voice conversations."),
+		stop: i("avatar.stop", "Turn off the avatar"),
+		consent: i("avatar.consent", "Turning on Avatar shares the assistant's reply audio with LiveKit and Protoface to animate the avatar. This feature does not send your microphone audio to Protoface."),
+		consentConfirm: i("avatar.consentConfirm", "Turn on the avatar"),
+		consentCancel: i("avatar.consentCancel", "Not now"),
+		stateOff: i("avatar.stateOff", "Avatar off"),
+		stateOn: i("avatar.stateOn", "Avatar on"),
+		stateStarting: i("avatar.stateStarting", "Starting the avatar…"),
+		stateReady: i("avatar.stateReady", "Avatar ready"),
+		stateEnding: i("avatar.stateEnding", "Stopping the avatar…"),
+		stateInterrupted: i("avatar.stateInterrupted", "The avatar was interrupted. You can keep talking."),
+		stateVoiceOnly: i("avatar.stateVoiceOnly", "The avatar is unavailable right now. Continuing with voice only."),
+		stateTimeLimit: i("avatar.stateTimeLimit", "The avatar reached its time limit. Continuing with voice only."),
+		stageLabel: i("avatar.stageLabel", "Live avatar"),
+		stageWaiting: i("avatar.stageWaiting", "Waiting for the avatar…"),
+		chooserTitle: i("avatar.chooserTitle", "Choose an avatar"),
+		chooserLabel: i("avatar.chooserLabel", "Avatar"),
+		chooserNone: i("avatar.chooserNone", "No avatar chosen"),
+		chooserLoading: i("avatar.chooserLoading", "Loading avatars…"),
+		chooserEmpty: i("avatar.chooserEmpty", "No avatars are available."),
+		chooserRetry: i("avatar.chooserRetry", "Try again"),
+		chooserOption: (e) => i("avatar.chooserOption", "Use {{name}}", { name: e }),
+		chooserSelected: (e) => i("avatar.chooserSelected", "{{name}} (selected)", { name: e }),
+		voiceModeLabel: i("avatar.voiceModeLabel", "Avatar voice"),
+		voiceModeDefaultNamed: (e) => i("avatar.voiceModeDefaultNamed", "Default for this avatar ({{name}})", { name: e }),
+		voiceModeMine: i("avatar.voiceModeMine", "Keep my current voice"),
+		voiceModeMineNamed: (e) => i("avatar.voiceModeMineNamed", "Keep my current voice ({{name}})", { name: e }),
+		voiceModeHint: i("avatar.voiceModeNextReplyHint", "Used from the avatar's next reply. The assistant's own voice doesn't change."),
+		tabsLabel: i("avatar.tabsLabel", "Assistant views"),
+		tabChat: i("avatar.tabChat", "Chat"),
+		tabAvatar: i("avatar.tabAvatar", "Avatar"),
+		chooserLocked: i("avatar.chooserLocked", "Turn off the avatar to change it."),
+		tabLeaveHint: i("avatar.tabLeaveHint", "Leaving the Avatar tab turns the avatar off."),
+		availableAgain: (e) => i("avatar.availableAgain", "You can start it again at {{time}}.", { time: e }),
+		retryTime: (e, t) => o(e, t, a),
+		stateTimeLimitNoVoice: i("avatar.stateTimeLimitNoVoice", "The avatar reached its time limit."),
+		stateVoiceOnlyNoVoice: i("avatar.stateVoiceOnlyNoVoice", "The avatar is unavailable right now."),
+		turnOnStarting: i("avatar.turnOnStarting", "Starting the avatar…"),
+		startVoice: i("voiceSession.start", "Start a voice conversation"),
+		hearVoice: i("voice.preview", "Hear this voice"),
 		voiceStartBlocked: (e) => {
 			switch (e) {
-				case "unavailable": return r("avatar.voiceStartUnavailable", "Voice conversations aren’t available here.");
-				case "mode": return r("avatar.voiceStartMode", "Voice conversations aren’t available in this mode.");
-				case "read-only": return r("avatar.voiceStartReadOnly", "This conversation can’t take new questions. Start a new conversation to ask by voice.");
-				case "busy": return r("avatar.voiceStartBusy", "You can start a voice conversation when the assistant is ready.");
-				case "committing": return r("avatar.voiceStartCommitting", "You can start a voice conversation once your attachments are saved.");
-				case "dictating": return r("avatar.voiceStartDictating", "Stop dictating to start a voice conversation.");
+				case "unavailable": return i("avatar.voiceStartUnavailable", "Voice conversations aren’t available here.");
+				case "mode": return i("avatar.voiceStartMode", "Voice conversations aren’t available in this mode.");
+				case "read-only": return i("avatar.voiceStartReadOnly", "This conversation can’t take new questions. Start a new conversation to ask by voice.");
+				case "busy": return i("avatar.voiceStartBusy", "You can start a voice conversation when the assistant is ready.");
+				case "committing": return i("avatar.voiceStartCommitting", "You can start a voice conversation once your attachments are saved.");
+				case "dictating": return i("avatar.voiceStartDictating", "Stop dictating to start a voice conversation.");
 			}
 		},
-		askNeedsVoice: r("avatar.askNeedsVoice", "You can still turn the avatar on, but you ask it questions in a voice conversation."),
-		handsFreeOff: r("avatar.handsFreeOff", "Hands-free interrupt is off, so the avatar's voice can't interrupt itself. It stays off after you turn the avatar off; turn it back on in More options. You can still tap to interrupt."),
+		askNeedsVoice: i("avatar.askNeedsVoice", "You can still turn the avatar on, but you ask it questions in a voice conversation."),
+		askByTyping: i("avatar.askByTyping", "You can still turn the avatar on and type your questions below."),
+		askNothing: i("avatar.askNothing", "You can't ask the avatar anything in this conversation."),
+		askLabel: i("avatar.askLabel", "Type a question for the avatar"),
+		askPlaceholder: i("avatar.askPlaceholder", "Ask the avatar…"),
+		askHint: i("avatar.askHint", "Enter to send · Shift+Enter for a new line"),
+		askSend: i("chatInput.send", "Send message"),
+		askBlocked: (e) => {
+			switch (e) {
+				case "hidden-voice": return null;
+				case "read-only": return i("avatar.askReadOnly", "This conversation can't take new questions. Start a new conversation to ask one.");
+				case "mode-picked": return i("avatar.askModePicked", "Typed questions work only in Ask. You can change that in Chat, but leaving this tab turns the avatar off.");
+				case "mode-escalated": return i("avatar.askMode", "This conversation can make changes, so typed questions to the avatar aren't available here. Start a new conversation to ask one.");
+				case "avatar-off": return i("avatar.askNeedsAvatar", "Turn on the avatar to send your question. You can type it now.");
+				case "avatar-again": return i("avatar.askAgain", "You can send your question when the avatar is on again.");
+				case "sound": return i("avatar.askSound", "Turn on the avatar's sound first.");
+				case "starting": return i("avatar.askStarting", "You can send your question when the avatar is ready.");
+				case "busy": return i("avatar.askBusy", "You can send your question when the assistant is ready.");
+				case "committing": return i("avatar.askCommitting", "You can send your question once the files in Chat are saved.");
+			}
+		},
+		askNoFiles: i("avatar.askNoFiles", "To attach files, use Chat."),
+		askEmpty: i("avatar.askEmpty", "Type a question below, and the avatar answers it aloud."),
+		askExchangeLabel: i("avatar.askExchangeLabel", "Last question and answer"),
+		askYouAsked: i("avatar.askYouAsked", "You asked"),
+		askAnswer: i("avatar.askAnswer", "Answer"),
+		askAskedIn: (e) => i("avatar.askAskedIn", "Asked in: {{title}}", { title: e }),
+		askShowAll: i("avatar.askShowAll", "Show the whole answer"),
+		askShowLess: i("avatar.askShowLess", "Show less"),
+		askThinking: i(n.key, n.fallback),
+		askNotSpoken: i("avatar.askNotSpoken", "The avatar wasn't available, so this answer wasn't read aloud."),
+		askCut: i("avatar.askCut", "The avatar stopped before the end of this answer. The whole answer is in Chat."),
+		askNotHeard: i("avatar.askNotHeard", "This answer wasn't read aloud: the avatar may still have been finishing the last answer."),
+		askFailed: i("avatar.askFailed", "The assistant couldn't answer. Your question is back in the box."),
+		askFailedInChat: i("avatar.askFailedInChat", "The assistant couldn't answer. Your question is still in Chat."),
+		askAlsoInChat: i("avatar.askAlsoInChat", "This answer is also in Chat."),
+		askStop: i("message.stopSpeaking", "Stop reading aloud"),
+		askStopShort: i("message.stopSpeakingShort", "Stop"),
+		handsFreeOff: i("avatar.handsFreeOff", "Hands-free interrupt is off, so the avatar's voice can't interrupt itself. It stays off after you turn the avatar off; turn it back on in More options. You can still tap to interrupt."),
 		problem: (e, t = {}) => {
-			let n = t.voiceLive !== !1, i = t.timed === !0;
+			let n = t.voiceLive !== !1, r = t.timed === !0;
 			switch (e) {
-				case "unavailable": return r("avatar.problemUnavailable", "The avatar isn’t available here.");
-				case "not-ready": return r("avatar.problemNotReady", "This avatar isn’t ready yet. Try another one.");
-				case "already-running": return r("avatar.problemAlreadyRunning", "An avatar is already running for you.");
-				case "capacity": return i ? r("avatar.problemCapacityTimed", "Avatars are busy right now.") : r("avatar.problemCapacity", "Avatars are busy right now. Try again in a moment.");
-				case "rate-limited": return i ? r("avatar.problemRateLimitedTimed", "You started avatars too quickly.") : r("avatar.problemRateLimited", "You started avatars too quickly. Wait a minute and try again.");
-				case "paused": return r("avatar.problemPaused", "Avatars are paused for now.");
-				case "budget-exhausted": return r("avatar.problemBudgetExhausted", "Avatar time is used up for now.");
-				case "start-timeout": return r("avatar.problemStartTimeout", "The avatar took too long to start. Try again in a moment.");
-				case "provider": return n ? r("avatar.problemProvider", "The avatar had a problem. Voice continues without it.") : r("avatar.problemProviderNoVoice", "The avatar had a problem.");
-				case "connection": return r("avatar.problemConnection", "The connection to the avatar was lost.");
-				case "needs-hosted-voice": return r("avatar.problemNeedsHostedVoice", "The avatar needs one of the assistant’s own voices. Choose one in the voice settings.");
-				case "unsupported-browser": return r("avatar.problemUnsupportedBrowser", "This browser can’t show the avatar.");
-				case "playback-blocked": return r("avatar.problemPlaybackBlocked", "The browser blocked the avatar’s sound. Tap the avatar to turn it on.");
+				case "unavailable": return i("avatar.problemUnavailable", "The avatar isn’t available here.");
+				case "not-ready": return i("avatar.problemNotReady", "This avatar isn’t ready yet. Try another one.");
+				case "already-running": return i("avatar.problemAlreadyRunning", "An avatar is already running for you.");
+				case "capacity": return r ? i("avatar.problemCapacityTimed", "Avatars are busy right now.") : i("avatar.problemCapacity", "Avatars are busy right now. Try again in a moment.");
+				case "rate-limited": return r ? i("avatar.problemRateLimitedTimed", "You started avatars too quickly.") : i("avatar.problemRateLimited", "You started avatars too quickly. Wait a minute and try again.");
+				case "paused": return i("avatar.problemPaused", "Avatars are paused for now.");
+				case "budget-exhausted": return i("avatar.problemBudgetExhausted", "Avatar time is used up for now.");
+				case "start-timeout": return i("avatar.problemStartTimeout", "The avatar took too long to start. Try again in a moment.");
+				case "provider": return n ? i("avatar.problemProvider", "The avatar had a problem. Voice continues without it.") : i("avatar.problemProviderNoVoice", "The avatar had a problem.");
+				case "connection": return i("avatar.problemConnection", "The connection to the avatar was lost.");
+				case "needs-hosted-voice": return i("avatar.problemNeedsHostedVoice", "The avatar needs one of the assistant’s own voices. Choose one in the voice settings.");
+				case "unsupported-browser": return i("avatar.problemUnsupportedBrowser", "This browser can’t show the avatar.");
+				case "playback-blocked": return i("avatar.problemPlaybackBlocked", "The browser blocked the avatar’s sound. Tap the avatar to turn it on.");
 			}
 		}
-	}), [r, i]);
+	}), [i, a]);
 }
 //#endregion
-export { a as formatAvatarRetryTime, o as useAvatarCopy };
+export { o as formatAvatarRetryTime, s as useAvatarCopy };

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

@@ -216,7 +216,35 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly "attachments.unsupportedImage": "This device can't read that image format, so it can't be resized to send. Save it as JPEG and try again.";
     readonly "attachments.uploading": "Uploading…";
     readonly "attachments.voiceDropped": "{{count}} attachment(s) couldn't be saved and weren't sent.";
+    readonly "avatar.askAgain": "You can send your question when the avatar is on again.";
+    readonly "avatar.askAlsoInChat": "This answer is also in Chat.";
+    readonly "avatar.askAnswer": "Answer";
+    readonly "avatar.askAskedIn": "Asked in: {{title}}";
+    readonly "avatar.askBusy": "You can send your question when the assistant is ready.";
+    readonly "avatar.askByTyping": "You can still turn the avatar on and type your questions below.";
+    readonly "avatar.askCommitting": "You can send your question once the files in Chat are saved.";
+    readonly "avatar.askCut": "The avatar stopped before the end of this answer. The whole answer is in Chat.";
+    readonly "avatar.askEmpty": "Type a question below, and the avatar answers it aloud.";
+    readonly "avatar.askExchangeLabel": "Last question and answer";
+    readonly "avatar.askFailed": "The assistant couldn't answer. Your question is back in the box.";
+    readonly "avatar.askFailedInChat": "The assistant couldn't answer. Your question is still in Chat.";
+    readonly "avatar.askHint": "Enter to send · Shift+Enter for a new line";
+    readonly "avatar.askLabel": "Type a question for the avatar";
+    readonly "avatar.askMode": "This conversation can make changes, so typed questions to the avatar aren't available here. Start a new conversation to ask one.";
+    readonly "avatar.askModePicked": "Typed questions work only in Ask. You can change that in Chat, but leaving this tab turns the avatar off.";
+    readonly "avatar.askNeedsAvatar": "Turn on the avatar to send your question. You can type it now.";
     readonly "avatar.askNeedsVoice": "You can still turn the avatar on, but you ask it questions in a voice conversation.";
+    readonly "avatar.askNoFiles": "To attach files, use Chat.";
+    readonly "avatar.askNotHeard": "This answer wasn't read aloud: the avatar may still have been finishing the last answer.";
+    readonly "avatar.askNotSpoken": "The avatar wasn't available, so this answer wasn't read aloud.";
+    readonly "avatar.askNothing": "You can't ask the avatar anything in this conversation.";
+    readonly "avatar.askPlaceholder": "Ask the avatar…";
+    readonly "avatar.askReadOnly": "This conversation can't take new questions. Start a new conversation to ask one.";
+    readonly "avatar.askShowAll": "Show the whole answer";
+    readonly "avatar.askShowLess": "Show less";
+    readonly "avatar.askSound": "Turn on the avatar's sound first.";
+    readonly "avatar.askStarting": "You can send your question when the avatar is ready.";
+    readonly "avatar.askYouAsked": "You asked";
     readonly "avatar.availableAgain": "You can start it again at {{time}}.";
     readonly "avatar.chooserEmpty": "No avatars are available.";
     readonly "avatar.chooserLabel": "Avatar";

package/dist/shared/assistant/i18nManifest.js

@@ -110,7 +110,35 @@ var m = {
 	"attachments.unsupportedImage": "This device can't read that image format, so it can't be resized to send. Save it as JPEG and try again.",
 	"attachments.uploading": "Uploading…",
 	"attachments.voiceDropped": "{{count}} attachment(s) couldn't be saved and weren't sent.",
+	"avatar.askAgain": "You can send your question when the avatar is on again.",
+	"avatar.askAlsoInChat": "This answer is also in Chat.",
+	"avatar.askAnswer": "Answer",
+	"avatar.askAskedIn": "Asked in: {{title}}",
+	"avatar.askBusy": "You can send your question when the assistant is ready.",
+	"avatar.askByTyping": "You can still turn the avatar on and type your questions below.",
+	"avatar.askCommitting": "You can send your question once the files in Chat are saved.",
+	"avatar.askCut": "The avatar stopped before the end of this answer. The whole answer is in Chat.",
+	"avatar.askEmpty": "Type a question below, and the avatar answers it aloud.",
+	"avatar.askExchangeLabel": "Last question and answer",
+	"avatar.askFailed": "The assistant couldn't answer. Your question is back in the box.",
+	"avatar.askFailedInChat": "The assistant couldn't answer. Your question is still in Chat.",
+	"avatar.askHint": "Enter to send · Shift+Enter for a new line",
+	"avatar.askLabel": "Type a question for the avatar",
+	"avatar.askMode": "This conversation can make changes, so typed questions to the avatar aren't available here. Start a new conversation to ask one.",
+	"avatar.askModePicked": "Typed questions work only in Ask. You can change that in Chat, but leaving this tab turns the avatar off.",
+	"avatar.askNeedsAvatar": "Turn on the avatar to send your question. You can type it now.",
 	"avatar.askNeedsVoice": "You can still turn the avatar on, but you ask it questions in a voice conversation.",
+	"avatar.askNoFiles": "To attach files, use Chat.",
+	"avatar.askNotHeard": "This answer wasn't read aloud: the avatar may still have been finishing the last answer.",
+	"avatar.askNotSpoken": "The avatar wasn't available, so this answer wasn't read aloud.",
+	"avatar.askNothing": "You can't ask the avatar anything in this conversation.",
+	"avatar.askPlaceholder": "Ask the avatar…",
+	"avatar.askReadOnly": "This conversation can't take new questions. Start a new conversation to ask one.",
+	"avatar.askShowAll": "Show the whole answer",
+	"avatar.askShowLess": "Show less",
+	"avatar.askSound": "Turn on the avatar's sound first.",
+	"avatar.askStarting": "You can send your question when the avatar is ready.",
+	"avatar.askYouAsked": "You asked",
 	"avatar.availableAgain": "You can start it again at {{time}}.",
 	"avatar.chooserEmpty": "No avatars are available.",
 	"avatar.chooserLabel": "Avatar",

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

@@ -46,6 +46,7 @@ export * from './speech/routingSpeechEngine';
 export * from './speech/hostedVoiceCatalogue';
 export * from './speech/pieceSink';
 export * from './speech/speechFeed';
+export * from './speech/replySpeechRequests';
 export * from './voice/useVoiceInput';
 export * from './voice/voiceStageState';
 export * from './voice/voiceStatus';
@@ -227,6 +228,11 @@ export * from './ui/assistantLiveAvatarSeam';
 export * from './ui/AssistantAvatarTabs';
 export * from './ui/avatar/AssistantAvatarTab';
 export * from './ui/voice/voiceStartGate';
+export * from './ui/avatar/avatarAskGate';
+export * from './ui/avatar/AvatarTabAskBox';
+export * from './ui/avatar/AvatarTabLastExchange';
+export * from './ui/avatar/avatarTabExchange';
+export * from './ui/avatar/avatarTabDraft';
 export * from './useAssistantApiAccess';
 export * from './useConversationTurns';
 export * from './transportErrors';
@@ -334,6 +340,8 @@ export * from './avatar/live/liveAvatarController';
 export * from './avatar/live/liveKitAvatarRoom';
 export * from './avatar/live/LiveAvatarStage';
 export * from './avatar/live/LiveAvatarTabView';
+export * from './avatar/live/avatarFaces';
+export * from './avatar/live/AvatarFace';
 export * from './avatar/live/liveAvatarStatus';
 export * from './avatar/live/createLiveAvatarSeam';
 export * from './avatar/live/avatarVoice';

package/dist/shared/assistant/speech/replySpeechRequests.d.ts

@@ -0,0 +1,84 @@
+/**
+ * The replies the Avatar tab asked to hear on the avatar (BOFF-9360): typed
+ * questions whose answers the avatar speaks, whatever Chat's auto-read is.
+ *
+ * ★★ Only the tab writes here. A reply is registered where the chat area
+ * creates it for a question sent from the tab, with the conversation and the
+ * question it belongs to (critic M2): a reply this module has never seen is
+ * spoken by today's rules, so a host without the live avatar, and every reply
+ * that was not asked from the tab, behaves exactly as before.
+ *
+ * ★★ Fail-safe by construction. A reply missing from here (evicted, never
+ * registered, released) stays text: the worst a gap can do is leave an answer
+ * silent, never speak one that should not be heard.
+ *
+ * ★ Each entry carries what happened to its speech (`outcome`), so the tab can
+ * say it without claiming anything was heard: it records what the audio path
+ * did, never what the person heard.
+ *
+ * ★ Module scope on purpose, like `speechFeed` and `supersededTurns`: the chat
+ * area (which registers), the speech provider (which speaks and settles) and
+ * the tab (which reads) are components that do not know each other.
+ *
+ * ★ Bounded: the tab asks one question at a time, so 16 entries is far more
+ * than one opening of the tab needs; the oldest is dropped first.
+ */
+/** What became of one registered reply's speech. */
+export type ReplySpeechOutcome = 
+/** Registered; the reply has not been spoken or refused yet. */
+'pending'
+/** Being spoken. */
+ | 'speaking'
+/** Spoken to its end. */
+ | 'spoken'
+/** The avatar would not take it (off, covered, ending, sound blocked, no hosted voice), so it was not read aloud. */
+ | 'declined'
+/** It left the avatar part way (an end, a failure), and the rest was stopped, never moved to the speakers (critic M1). */
+ | 'cut'
+/** The avatar's audio output refused it (D7 b): what it played before could not be shown to have stopped. */
+ | 'not-cleared'
+/** A Stop, a newer reply, a conversation switch or a hidden panel stopped it. */
+ | 'stopped'
+/** The voice failed. */
+ | 'failed'
+/** Released unspoken: its conversation is no longer the open one, or the tab closed. */
+ | 'dropped';
+/** One reply the tab asked to hear on the avatar. */
+export interface ReplySpeechRequest {
+    /** The conversation the question landed in (it may have been created by the send). */
+    readonly conversationId: string;
+    readonly questionId: string;
+    readonly replyId: string;
+    readonly outcome: ReplySpeechOutcome;
+}
+/** Record that the reply `replyId`, the answer to `questionId` in `conversationId`, should be spoken on the avatar. */
+export declare function requestReplyOnAvatar(request: {
+    readonly conversationId: string;
+    readonly questionId: string;
+    readonly replyId: string;
+}): void;
+/** Is `replyId` registered and not yet spoken or refused? Null and undefined never are. */
+export declare function replyWantsAvatar(replyId: string | null | undefined): boolean;
+/** The registered request for `replyId`, or null. */
+export declare function replySpeechRequest(replyId: string | null | undefined): ReplySpeechRequest | null;
+/**
+ * What became of `replyId`'s speech. Only a reply still pending or speaking moves, and `speaking` only from
+ * `pending`: the first outcome that ends it is the one kept. Unknown ids are ignored.
+ */
+export declare function settleReplyRequest(replyId: string | null | undefined, outcome: Exclude<ReplySpeechOutcome, 'pending'>): void;
+/**
+ * ★★ Critic M2: release every pending request whose conversation is not `activeConversationId`, read from the live
+ * store by the caller. Never on a timer, and never the open conversation's: a send that creates its conversation
+ * registers the reply in it before any switch handler runs, so its own reply survives the switch it caused.
+ */
+export declare function releaseReplyRequestsOutside(activeConversationId: string | null): void;
+/** Forget every request: the Avatar tab closed. A reply arriving later follows Chat's own auto-read. */
+export declare function clearReplyRequests(): void;
+/** Is any request still waiting for its reply? */
+export declare function hasPendingReplyRequests(): boolean;
+/** Subscribe to every change; returns an unsubscribe function. For `useSyncExternalStore`. */
+export declare function subscribeReplyRequests(listener: () => void): () => void;
+/** A number that changes on every change: a `useSyncExternalStore` snapshot. */
+export declare function replyRequestsVersion(): number;
+/** Tests only. */
+export declare function resetReplyRequestsForTest(): void;

package/dist/shared/assistant/speech/replySpeechRequests.js

@@ -0,0 +1,70 @@
+//#region src/shared/assistant/speech/replySpeechRequests.ts
+var e = 16, t = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Set(), r = 0;
+function i() {
+	r += 1;
+	for (let e of [...n]) e();
+}
+var a = new Set([
+	"spoken",
+	"declined",
+	"cut",
+	"not-cleared",
+	"stopped",
+	"failed",
+	"dropped"
+]);
+function o(n) {
+	for (t.delete(n.replyId), t.set(n.replyId, {
+		conversationId: n.conversationId,
+		questionId: n.questionId,
+		replyId: n.replyId,
+		outcome: "pending"
+	}); t.size > e;) {
+		let e = t.keys().next();
+		if (e.done) break;
+		t.delete(e.value);
+	}
+	i();
+}
+function s(e) {
+	return typeof e == "string" && t.get(e)?.outcome === "pending";
+}
+function c(e) {
+	return typeof e == "string" ? t.get(e) ?? null : null;
+}
+function l(e, n) {
+	if (typeof e != "string") return;
+	let r = t.get(e);
+	!r || a.has(r.outcome) || n === "speaking" && r.outcome !== "pending" || (t.set(e, {
+		...r,
+		outcome: n
+	}), i());
+}
+function u(e) {
+	let n = !1;
+	for (let [r, i] of t) i.outcome !== "pending" || i.conversationId === e || (t.set(r, {
+		...i,
+		outcome: "dropped"
+	}), n = !0);
+	n && i();
+}
+function d() {
+	t.size !== 0 && (t.clear(), i());
+}
+function f() {
+	for (let e of t.values()) if (e.outcome === "pending") return !0;
+	return !1;
+}
+function p(e) {
+	return n.add(e), () => {
+		n.delete(e);
+	};
+}
+function m() {
+	return r;
+}
+function h() {
+	t.clear(), n.clear(), r = 0;
+}
+//#endregion
+export { d as clearReplyRequests, f as hasPendingReplyRequests, u as releaseReplyRequestsOutside, m as replyRequestsVersion, c as replySpeechRequest, s as replyWantsAvatar, o as requestReplyOnAvatar, h as resetReplyRequestsForTest, l as settleReplyRequest, p as subscribeReplyRequests };

package/dist/shared/assistant/speech/routingSpeechEngine.js

@@ -5,7 +5,8 @@ import { selectVoiceForLocale as n } from "../voice/speechVoices.js";
 function r(e) {
 	switch (e) {
 		case "cancelled":
-		case "output-not-cleared": return !1;
+		case "output-not-cleared":
+		case "output-left": return !1;
 		case "not-allowed":
 		case "unsupported":
 		case "unknown": return !0;

package/dist/shared/assistant/speech/types.d.ts

@@ -27,6 +27,19 @@ export interface SpeechSpeakOptions {
      * stop, whether the reply is one `speak()` or a queue that grows by appends.
      */
     audioOutput?: SpeechAudioOutput;
+    /**
+     * ★★ BOFF-9360 (critic M1): heard on the avatar, or nowhere. Set by the
+     * speech provider for a reply asked from the Avatar tab while Chat's
+     * auto-read is off, and read only by the live avatar's engine decorator
+     * (`wouldSpeakOnAvatar`); every other engine ignores it.
+     *
+     * Such a reply is never moved to the speakers: when its avatar output
+     * leaves it (the avatar is switched off, the tab closes, the session ends)
+     * or fails, part way or before its first piece, the rest is STOPPED and the
+     * reply ends with `onError('output-left')`. A device-voice fallback is off
+     * for it too. A refusal (`output-not-cleared`) is reported as it always is.
+     */
+    avatarOnly?: boolean;
 }
 /**
  * Somewhere other than the speakers to play a reply's hosted audio
@@ -138,8 +151,13 @@ export interface SpeechOutputRefusal {
  * played before could not be shown to have stopped. Nothing re-speaks it, the
  * device voice included, and its text stays where it is. Only a reply with an
  * `audioOutput` can end this way.
+ *
+ * `output-left` ends an `avatarOnly` reply (BOFF-9360) that stopped going to
+ * the avatar, or was never given to it: the rest of it was stopped, never
+ * played on the speakers. Only the live avatar's engine decorator reports it,
+ * and nothing re-speaks it.
  */
-export type SpeechErrorReason = 'cancelled' | 'not-allowed' | 'unsupported' | 'unknown' | 'output-not-cleared';
+export type SpeechErrorReason = 'cancelled' | 'not-allowed' | 'unsupported' | 'unknown' | 'output-not-cleared' | 'output-left';
 export interface SpeechSpeakHandlers {
     /**
      * Audio has actually begun playing — not merely been requested.
@@ -187,4 +205,13 @@ export interface SpeechEngine {
     speak(chunks: readonly string[], options: SpeechSpeakOptions, handlers?: SpeechSpeakHandlers): void;
     /** Stop immediately and drop anything queued. Safe to call when idle. */
     cancel(): void;
+    /**
+     * ★ BOFF-9360: would `speak` with these options play the reply on the live
+     * avatar right now? The decorated live-avatar engine only (it asks the same
+     * per-reply route its `speak` asks, with the same avatar voice, so the two
+     * cannot disagree); every other engine omits it, which callers read as
+     * "no". Asked by the speech provider before an `avatarOnly` reply starts,
+     * and only then.
+     */
+    wouldSpeakOnAvatar?(options: SpeechSpeakOptions): boolean;
 }