@burdenoff/fe-libs 2026.1014.5 → 2026.1015.2

package/dist/shared/assistant/ui/composer/AssistantComposer.js

@@ -14,53 +14,72 @@ import { AssistantVoiceButton as ae, ListeningDot as oe } from "./AssistantVoice
 import { AssistantVoiceSessionButton as se } from "../voice/AssistantVoiceSessionButton.js";
 import { useAssistantAttachments as ce } from "../../useAssistantAttachments.js";
 import { useCallback as s, useEffect as c, useLayoutEffect as le, useMemo as ue, useRef as l, useState as u } from "react";
-import { ArrowUp as de, Loader2 as d } from "lucide-react";
-import { jsx as f, jsxs as p } from "react/jsx-runtime";
+import { ArrowUp as de, Loader2 as fe } from "lucide-react";
+import { jsx as d, jsxs as f } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/composer/AssistantComposer.tsx
-var fe = 200, m = ({ writeAccessDenied: m = !1, onSend: h, disabled: g = !1, readOnly: pe = !1, placeholder: me, mode: he, availableModes: _, attachmentCharsPerFile: ge, onModeChange: _e, auto: ve, onStartVoiceSession: v, onDraftStart: y }) => {
-	let b = r(), { locale: x } = e(), S = g || pe, C = l(null), [w, T] = u(""), [E, D] = u(!1), [O, k] = u(!1), A = l(!1), [j, M] = u(null), N = l(0), { attachments: P, isBusy: ye, preparingCount: be, sendBlocker: F, rejection: I, addFiles: L, remove: xe, retry: Se, clear: R, clearRejection: Ce, canAddMore: we, commit: z, cancelCommit: B } = ce({ perFileChars: ge }), V = w.trim() !== "" || P.length > 0, H = l(!1);
+var pe = 200, p = ({ writeAccessDenied: p = !1, onSend: m, disabled: h = !1, readOnly: me = !1, placeholder: he, mode: ge, availableModes: g, attachmentCharsPerFile: _e, onModeChange: ve, auto: ye, onStartVoiceSession: be, onDraftStart: _, suspendDictation: v = !1, onVoiceStateChange: y }) => {
+	let b = r(), { locale: x } = e(), S = h || me, C = l(null), [w, T] = u(""), [E, D] = u(!1), [O, xe] = u(!1), k = l(!1), [A, j] = u(null), M = l(0), { attachments: N, isBusy: Se, preparingCount: Ce, sendBlocker: P, rejection: F, addFiles: I, remove: we, retry: Te, clear: L, clearRejection: Ee, canAddMore: De, commit: R, cancelCommit: z } = ce({ perFileChars: _e }), B = w.trim() !== "" || N.length > 0, V = l(!1);
 	c(() => {
-		V && !H.current ? (H.current = !0, y?.()) : V || (H.current = !1);
-	}, [V, y]);
-	let Te = s((e) => {
+		B && !V.current ? (V.current = !0, _?.()) : B || (V.current = !1);
+	}, [B, _]);
+	let H = s((e) => {
 		T((t) => t ? `${t.replace(/\s+$/, "")} ${e}` : e);
 	}, []), U = i((e) => e.assistantLanguage), W = n({
-		onFinalize: Te,
+		onFinalize: H,
 		language: ue(() => te(U, x), [U, x]).tag
-	}), Ee = me ?? b("composer.placeholder", "Ask me anything…"), G = w.trim(), K = a(P), q = P.filter((e) => e.status === "error"), J = (G.length > 0 || K.length > 0) && !S && !O && F === null, Y = K.some((e) => !e.fileId && !e.inlineOnly), X = l(S);
-	X.current = S;
+	}), G = W.isActive, K = W.interim, q = W.stop;
+	c(() => {
+		!v || !G || (K.trim() !== "" && H(K.trim()), q());
+	}, [
+		v,
+		G,
+		K,
+		q,
+		H
+	]), c(() => {
+		y?.({
+			committing: O,
+			dictating: G
+		});
+	}, [
+		y,
+		O,
+		G
+	]);
+	let Oe = he ?? b("composer.placeholder", "Ask me anything…"), ke = w.trim(), J = a(N), Y = N.filter((e) => e.status === "error"), X = (ke.length > 0 || J.length > 0) && !S && !O && P === null, Ae = J.some((e) => !e.fileId && !e.inlineOnly), je = l(S);
+	je.current = S;
 	let Z = l(!0);
 	c(() => (Z.current = !0, () => {
 		Z.current = !1;
 	}), []), le(() => {
 		let e = C.current;
-		e && (e.style.height = "auto", e.style.height = `${Math.min(e.scrollHeight, fe)}px`);
+		e && (e.style.height = "auto", e.style.height = `${Math.min(e.scrollHeight, pe)}px`);
 	}, [w]);
 	let Q = s(async () => {
-		if (!J || A.current) return;
+		if (!X || k.current) return;
 		W.isActive && W.stop();
 		let e = w.trim();
-		if (M(null), !Y) {
-			h(e, K), T(""), R();
+		if (j(null), !Ae) {
+			m(e, J), T(""), L();
 			return;
 		}
 		let t = i.getState().activeConversationId;
-		A.current = !0, k(!0);
+		k.current = !0, xe(!0);
 		try {
-			let n = await z();
+			let n = await R();
 			if (!Z.current) {
 				n.ok && await n.rollback();
 				return;
 			}
 			if (!n.ok) {
-				n.cancelled || M({
+				n.cancelled || j({
 					kind: "failed",
 					failures: n.failures
 				});
 				return;
 			}
-			if (X.current) {
-				await n.rollback(), Z.current && M({
+			if (je.current) {
+				await n.rollback(), Z.current && j({
 					kind: "busy",
 					failures: []
 				});
@@ -68,52 +87,52 @@ var fe = 200, m = ({ writeAccessDenied: m = !1, onSend: h, disabled: g = !1, rea
 			}
 			let r = i.getState();
 			if (!(r.activeConversationId === t && (t === null || r.conversations.some((e) => e.id === t)))) {
-				await n.rollback(), Z.current && M({
+				await n.rollback(), Z.current && j({
 					kind: "moved",
 					failures: []
 				});
 				return;
 			}
-			h(e, a(n.attachments)), n.handedOver(), T(""), R();
+			m(e, a(n.attachments)), n.handedOver(), T(""), L();
 		} finally {
-			A.current = !1, Z.current && k(!1);
+			k.current = !1, Z.current && xe(!1);
 		}
 	}, [
-		J,
-		Y,
-		z,
-		h,
-		w,
-		K,
+		X,
+		Ae,
 		R,
+		m,
+		w,
+		J,
+		L,
 		W
-	]), $ = s(() => {
-		B(), C.current?.focus();
-	}, [B]);
+	]), Me = s(() => {
+		z(), C.current?.focus();
+	}, [z]);
 	c(() => {
-		M(null);
-	}, [P.length]);
-	let De = (e) => {
+		j(null);
+	}, [N.length]);
+	let Ne = (e) => {
 		if (e.kind === "busy") return b("attachments.saveBusy", "The assistant started another reply, so nothing was sent. Your message and files are still here.");
 		if (e.kind === "moved") return b("attachments.saveMoved", "You switched conversations while the files were being saved, so nothing was sent. Your message and files are still here.");
 		let { failures: t } = e;
 		if (t.some((e) => e.code === o.quotaExceeded || e.code === o.quotaNotProvisioned)) return `${b("attachments.quotaFull", "File storage is full or not set up for this workspace, so the attachments couldn't be saved. Nothing was sent.")} ${b("attachments.retrySend", "Press Send to try again, or remove the file.")}`;
-		let n = t[0], r = P.find((e) => e.id === n?.id)?.filename ?? "";
+		let n = t[0], r = N.find((e) => e.id === n?.id)?.filename ?? "";
 		return `${t.length <= 1 ? b("attachments.saveFailedOne", "{{name}} couldn't be saved, so nothing was sent.", { name: r }) : b("attachments.saveFailedMany", "{{count}} attachments couldn't be saved, so nothing was sent.", { count: t.length })} ${b("attachments.retrySend", "Press Send to try again, or remove the file.")}`;
-	}, Oe = s((e) => {
+	}, Pe = s((e) => {
 		e.key === "Enter" && !e.shiftKey && (e.preventDefault(), Q());
-	}, [Q]), ke = s((e) => {
+	}, [Q]), Fe = s((e) => {
 		let t = Array.from(e.clipboardData?.files ?? []);
-		t.length !== 0 && (e.preventDefault(), L(t));
-	}, [L]), Ae = s((e) => {
-		Array.from(e.dataTransfer?.types ?? []).includes("Files") && (N.current += 1, D(!0));
-	}, []), je = s(() => {
-		N.current = Math.max(0, N.current - 1), N.current === 0 && D(!1);
-	}, []), Me = s((e) => {
+		t.length !== 0 && (e.preventDefault(), I(t));
+	}, [I]), Ie = s((e) => {
+		Array.from(e.dataTransfer?.types ?? []).includes("Files") && (M.current += 1, D(!0));
+	}, []), Le = s(() => {
+		M.current = Math.max(0, M.current - 1), M.current === 0 && D(!1);
+	}, []), Re = s((e) => {
 		Array.from(e.dataTransfer?.types ?? []).includes("Files") && e.preventDefault();
-	}, []), Ne = s((e) => {
-		e.preventDefault(), N.current = 0, D(!1), L(e.dataTransfer?.files ?? null);
-	}, [L]), Pe = (e) => {
+	}, []), ze = s((e) => {
+		e.preventDefault(), M.current = 0, D(!1), I(e.dataTransfer?.files ?? null);
+	}, [I]), Be = (e) => {
 		switch (e) {
 			case "too-many": return b("attachments.tooMany", "You can attach up to {{max}} files per message.", { max: 5 });
 			case "too-large": return b("attachments.tooLarge", "That file is larger than 10 MB.");
@@ -122,7 +141,7 @@ var fe = 200, m = ({ writeAccessDenied: m = !1, onSend: h, disabled: g = !1, rea
 			case "unsupported-image": return b("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.");
 			case "too-large-to-save": return b("attachments.tooLargeToSave", "That file is over 5 MB, so it can't be saved to Files, and no text could be read from it.");
 		}
-	}, Fe = (() => {
+	}, $ = (() => {
 		switch (W.error) {
 			case "not-allowed": return b("voice.denied", "Microphone access is blocked. Allow it in your browser settings to dictate.");
 			case "audio-capture": return b("voice.noMic", "No microphone was found.");
@@ -132,136 +151,136 @@ var fe = 200, m = ({ writeAccessDenied: m = !1, onSend: h, disabled: g = !1, rea
 			default: return null;
 		}
 	})();
-	return /* @__PURE__ */ p("div", {
+	return /* @__PURE__ */ f("div", {
 		className: "flex-shrink-0 px-3 pb-3 pt-1.5",
 		children: [
-			/* @__PURE__ */ p("div", {
-				onDragEnter: Ae,
-				onDragLeave: je,
-				onDragOver: Me,
-				onDrop: Ne,
+			/* @__PURE__ */ f("div", {
+				onDragEnter: Ie,
+				onDragLeave: Le,
+				onDragOver: Re,
+				onDrop: ze,
 				className: `rounded-2xl border p-2 shadow-sm transition-colors focus-within:border-action-primary-bg focus-within:ring-2 focus-within:ring-action-primary-bg/15 ${E ? "border-action-primary-bg border-dashed bg-action-primary-bg/5" : "border-border-default bg-bg-sunken"}`,
 				"data-testid": "assistant-composer",
 				children: [
-					/* @__PURE__ */ f(re, {
-						attachments: P,
-						onRemove: xe,
-						onRetry: Se,
+					/* @__PURE__ */ d(re, {
+						attachments: N,
+						onRemove: we,
+						onRetry: Te,
 						disabled: S || O,
-						preparingCount: be
+						preparingCount: Ce
 					}),
-					/* @__PURE__ */ p("div", {
+					/* @__PURE__ */ f("div", {
 						className: "flex items-end gap-2",
 						children: [
-							/* @__PURE__ */ f(ne, {
-								onFiles: L,
-								canAddMore: we,
+							/* @__PURE__ */ d(ne, {
+								onFiles: I,
+								canAddMore: De,
 								disabled: S || O,
 								showLabel: !0
 							}),
-							/* @__PURE__ */ f("textarea", {
+							/* @__PURE__ */ d("textarea", {
 								ref: C,
 								value: w,
 								onChange: (e) => T(e.target.value),
-								onKeyDown: Oe,
-								onPaste: ke,
+								onKeyDown: Pe,
+								onPaste: Fe,
 								disabled: S,
 								readOnly: O,
 								"aria-busy": O || void 0,
-								placeholder: E ? b("composer.dropHere", "Drop files to attach") : Ee,
+								placeholder: E ? b("composer.dropHere", "Drop files to attach") : Oe,
 								rows: 1,
 								className: "min-h-[36px] flex-1 resize-none self-center bg-transparent px-1 py-2 text-[15px] leading-relaxed text-text-primary placeholder:text-text-muted focus:outline-none disabled:opacity-50",
 								"aria-label": b("chatInput.ariaLabel", "Message input"),
 								"data-testid": "assistant-input"
 							}),
-							W.isSupported && /* @__PURE__ */ f(ae, {
+							W.isSupported && /* @__PURE__ */ d(ae, {
 								isListening: W.isListening,
 								isStarting: W.isStarting,
 								onToggle: W.toggle,
 								disabled: S || O
 							}),
-							v && G.length === 0 && P.length === 0 && !W.isActive ? /* @__PURE__ */ f(se, {
-								onStart: v,
+							be && ke.length === 0 && N.length === 0 && !W.isActive ? /* @__PURE__ */ d(se, {
+								onStart: be,
 								disabled: S || O
-							}) : /* @__PURE__ */ f("button", {
+							}) : /* @__PURE__ */ d("button", {
 								type: "button",
 								onClick: () => void Q(),
-								disabled: !J,
-								className: `flex size-9 flex-shrink-0 items-center justify-center rounded-full shadow-sm transition-all focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong ${J ? "bg-action-primary-bg text-action-primary-text hover:scale-105 hover:bg-action-primary-bg-hover" : "bg-bg-elevated text-text-muted"}`,
+								disabled: !X,
+								className: `flex size-9 flex-shrink-0 items-center justify-center rounded-full shadow-sm transition-all focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong ${X ? "bg-action-primary-bg text-action-primary-text hover:scale-105 hover:bg-action-primary-bg-hover" : "bg-bg-elevated text-text-muted"}`,
 								"aria-label": b("chatInput.send", "Send message"),
 								"data-testid": "assistant-send",
-								children: g || ye || O ? /* @__PURE__ */ f(d, { className: "size-4 motion-safe:animate-spin" }) : /* @__PURE__ */ f(de, { className: "size-4" })
+								children: h || Se || O ? /* @__PURE__ */ d(fe, { className: "size-4 motion-safe:animate-spin" }) : /* @__PURE__ */ d(de, { className: "size-4" })
 							})
 						]
 					}),
-					_.length > 1 && /* @__PURE__ */ f("div", {
+					g.length > 1 && /* @__PURE__ */ d("div", {
 						className: "mt-2 px-0.5",
-						children: /* @__PURE__ */ f(ie, {
-							mode: he,
-							availableModes: _,
-							onModeChange: _e,
+						children: /* @__PURE__ */ d(ie, {
+							mode: ge,
+							availableModes: g,
+							onModeChange: ve,
 							disabled: S || O,
-							auto: ve
+							auto: ye
 						})
 					})
 				]
 			}),
-			m ? /* @__PURE__ */ f("p", {
+			p ? /* @__PURE__ */ d("p", {
 				className: "mt-1.5 px-1 text-center text-[11px] text-status-warning",
 				"data-testid": "assistant-write-access-warning",
 				children: b("composer.writeAccessDenied", "Changes may not save — your role in this workspace does not currently allow edits. You can still plan and review an action.")
 			}) : null,
-			/* @__PURE__ */ f("div", {
+			/* @__PURE__ */ d("div", {
 				className: "mt-1.5 px-1 text-center text-[11px]",
 				"aria-live": "polite",
-				children: O ? /* @__PURE__ */ f(t, {
-					onDismiss: $,
-					children: /* @__PURE__ */ p("p", {
+				children: O ? /* @__PURE__ */ d(t, {
+					onDismiss: Me,
+					children: /* @__PURE__ */ f("p", {
 						className: "flex items-center justify-center gap-2 text-text-muted",
 						"data-testid": "assistant-commit-status",
 						children: [
-							/* @__PURE__ */ f(d, {
+							/* @__PURE__ */ d(fe, {
 								className: "size-3 motion-safe:animate-spin",
 								"aria-hidden": "true"
 							}),
-							/* @__PURE__ */ f("span", { children: b("attachments.saving", "Saving your attachments…") }),
-							/* @__PURE__ */ f("button", {
+							/* @__PURE__ */ d("span", { children: b("attachments.saving", "Saving your attachments…") }),
+							/* @__PURE__ */ d("button", {
 								type: "button",
-								onClick: $,
+								onClick: Me,
 								className: "rounded text-text-primary underline underline-offset-2 hover:text-action-primary-bg focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong",
 								"data-testid": "assistant-commit-cancel",
 								children: b("attachments.cancelSaving", "Cancel")
 							})
 						]
 					})
-				}) : j ? /* @__PURE__ */ f("p", {
+				}) : A ? /* @__PURE__ */ d("p", {
 					className: "text-status-error-text",
 					role: "alert",
 					"data-testid": "assistant-commit-failed",
-					children: De(j)
-				}) : W.isStarting && !W.isListening ? /* @__PURE__ */ f("p", {
+					children: Ne(A)
+				}) : W.isStarting && !W.isListening ? /* @__PURE__ */ d("p", {
 					className: "text-text-muted",
 					"data-testid": "assistant-voice-starting",
 					children: b("voice.starting", "Starting the microphone…")
-				}) : W.isListening ? /* @__PURE__ */ p("p", {
+				}) : W.isListening ? /* @__PURE__ */ f("p", {
 					className: "text-status-error-text",
 					"data-testid": "assistant-voice-status",
-					children: [/* @__PURE__ */ f(oe, {}), W.interim || b("voice.listening", "Listening… speak now, tap the square to stop")]
-				}) : Fe ? /* @__PURE__ */ f("p", {
+					children: [/* @__PURE__ */ d(oe, {}), W.interim || b("voice.listening", "Listening… speak now, tap the square to stop")]
+				}) : $ ? /* @__PURE__ */ d("p", {
 					className: "text-status-error-text",
 					"data-testid": "assistant-voice-error",
-					children: Fe
-				}) : I ? /* @__PURE__ */ f("button", {
+					children: $
+				}) : F ? /* @__PURE__ */ d("button", {
 					type: "button",
-					onClick: Ce,
+					onClick: Ee,
 					className: "text-status-error-text underline-offset-2 hover:underline",
 					"data-testid": "assistant-attachment-rejection",
-					children: Pe(I)
-				}) : F === "failed" ? /* @__PURE__ */ f("p", {
+					children: Be(F)
+				}) : P === "failed" ? /* @__PURE__ */ d("p", {
 					className: "text-status-error-text",
 					"data-testid": "assistant-attachment-blocked",
-					children: q.length === 1 ? b("attachments.blockedOne", "{{name}} didn't upload. Retry or remove it before sending.", { name: q[0].filename }) : b("attachments.blockedMany", "{{count}} attachments didn't upload. Retry or remove them before sending.", { count: q.length })
-				}) : /* @__PURE__ */ f("p", {
+					children: Y.length === 1 ? b("attachments.blockedOne", "{{name}} didn't upload. Retry or remove it before sending.", { name: Y[0].filename }) : b("attachments.blockedMany", "{{count}} attachments didn't upload. Retry or remove them before sending.", { count: Y.length })
+				}) : /* @__PURE__ */ d("p", {
 					className: "text-text-muted",
 					children: b("composer.hint", "Enter to send · Shift+Enter for newline · drag or paste files to attach")
 				})
@@ -270,4 +289,4 @@ var fe = 200, m = ({ writeAccessDenied: m = !1, onSend: h, disabled: g = !1, rea
 	});
 };
 //#endregion
-export { m as AssistantComposer };
+export { p as AssistantComposer };

package/dist/shared/assistant/ui/panelOverlays.d.ts

@@ -33,6 +33,20 @@ export declare const NO_PANEL_OVERLAY: PanelOverlayState;
  * other one swaps to it. There is deliberately no way to express "both".
  */
 export declare function nextPanelOverlays(current: PanelOverlayState, toggled: "history" | "preview"): PanelOverlayState;
+/**
+ * The overlay slot, plus the Avatar tab (BOFF-9341) where the panel offers it.
+ *
+ * ★★ The tab is NOT part of the slot. It is a view of the chat area drawn
+ * under History and the preview (`AssistantAvatarTab`, `z-[5]` below their
+ * `z-10`, the voice strip's `z-20` and the transcript drawer's `z-30`), so
+ * History can open OVER it and closing History shows it again. Escape backs
+ * out one layer at a time: the transcript drawer, the voice session, the tab,
+ * then the panel.
+ */
+export interface PanelLayerState extends PanelOverlayState {
+    /** The Avatar tab is the view on screen; absent where the panel offers none. */
+    readonly avatarOpen?: boolean;
+}
 /**
  * What Escape should dismiss.
  *
@@ -44,7 +58,7 @@ export declare function nextPanelOverlays(current: PanelOverlayState, toggled: "
  * Escape is "back out of the thing I just opened"; here it destroyed a
  * conversation instead.
  */
-export declare function escapeDismisses(current: PanelOverlayState): "overlay" | "panel";
+export declare function escapeDismisses(current: PanelLayerState): "overlay" | "tab" | "panel";
 /**
  * Attribute marking the assistant panel's root element.
  *
@@ -94,9 +108,16 @@ export declare const ASSISTANT_VOICE_SESSION_ATTR = "data-assistant-voice-sessio
  * comes first. The panel backs out of it, as `escapeDismisses` says, and marks
  * the key handled so the session does not also act on it.
  */
-export declare function voiceSessionOwnsEscape(panel: Pick<Element, "hasAttribute" | "querySelector">): boolean;
+export declare function voiceSessionOwnsEscape(panel: Pick<Element, "hasAttribute" | "querySelector"> & Partial<Pick<Element, "getAttribute">>): boolean;
+/**
+ * `data-assistant-overlay` while the Avatar tab is the view on screen and no
+ * overlay covers it (BOFF-9341): the panel then owns an Escape pressed with
+ * focus on `<body>` (a control in the tab that unmounted itself on click), so
+ * it selects Chat again instead of the host closing the whole assistant.
+ */
+export declare const AVATAR_TAB_OVERLAY = "avatar";
 /** Which overlay is showing, as the attribute value — `null` when none is. */
-export declare function activePanelOverlay(current: PanelOverlayState): "history" | "preview" | null;
+export declare function activePanelOverlay(current: PanelLayerState): "history" | "preview" | typeof AVATAR_TAB_OVERLAY | null;
 /**
  * Is `active` the panel itself, or inside it?
  *

package/dist/shared/assistant/ui/panelOverlays.js

@@ -10,24 +10,25 @@ function t(t, n) {
 	};
 }
 function n(e) {
-	return e.historyOpen || e.previewOpen ? "overlay" : "panel";
+	return e.historyOpen || e.previewOpen ? "overlay" : e.avatarOpen === !0 ? "tab" : "panel";
 }
 var r = "data-assistant-panel", i = "data-assistant-overlay", a = "data-assistant-voice-session";
 function o(e) {
-	return e.hasAttribute("data-assistant-overlay") ? !1 : e.querySelector(`[${a}]`) !== null;
+	return e.hasAttribute("data-assistant-overlay") && e.getAttribute?.("data-assistant-overlay") !== "avatar" ? !1 : e.querySelector(`[${a}]`) !== null;
 }
-function s(e) {
-	return e.historyOpen ? "history" : e.previewOpen ? "preview" : null;
+var s = "avatar";
+function c(e) {
+	return e.historyOpen ? "history" : e.previewOpen ? "preview" : e.avatarOpen === !0 ? s : null;
 }
-function c(e, t) {
+function l(e, t) {
 	return !e || !t ? !1 : e === t || e.contains(t);
 }
-function l(e = document) {
+function u(e = document) {
 	let t = e.activeElement;
-	return Array.from(e.querySelectorAll(`[${r}]`)).some((n) => u(n, t, e.body));
+	return Array.from(e.querySelectorAll(`[${r}]`)).some((n) => d(n, t, e.body));
 }
-function u(e, t, n) {
-	return e ? c(e, t) ? !0 : (t === null || t === n) && e.hasAttribute("data-assistant-overlay") : !1;
+function d(e, t, n) {
+	return e ? l(e, t) ? !0 : (t === null || t === n) && e.hasAttribute("data-assistant-overlay") : !1;
 }
 //#endregion
-export { i as ASSISTANT_OVERLAY_ATTR, r as ASSISTANT_PANEL_ATTR, a as ASSISTANT_VOICE_SESSION_ATTR, e as NO_PANEL_OVERLAY, s as activePanelOverlay, l as assistantPanelOwnsEscape, n as escapeDismisses, c as focusIsInsidePanel, t as nextPanelOverlays, u as panelOwnsEscape, o as voiceSessionOwnsEscape };
+export { i as ASSISTANT_OVERLAY_ATTR, r as ASSISTANT_PANEL_ATTR, a as ASSISTANT_VOICE_SESSION_ATTR, s as AVATAR_TAB_OVERLAY, e as NO_PANEL_OVERLAY, c as activePanelOverlay, u as assistantPanelOwnsEscape, n as escapeDismisses, l as focusIsInsidePanel, t as nextPanelOverlays, d as panelOwnsEscape, o as voiceSessionOwnsEscape };

package/dist/shared/assistant/ui/useVoiceSession.d.ts

@@ -1,6 +1,7 @@
 import { VoiceTurnTiming } from '../turnTimeline';
 import { VoiceGraceMs } from '../voice/handsFree';
 import { VoiceSessionSnapshot } from '../voice/voiceSession';
+import { VoiceReply } from '../voice/voiceReply';
 /**
  * A problem worth TELLING the user about that does not warrant killing the
  * session.
@@ -21,6 +22,18 @@ export type VoiceSessionNotice = "network" | "not-capturing" | "nothing-heard" |
  * transcript.
  */
  | "reply-not-heard";
+/**
+ * ★ BOFF-9207: why the turn just spoken ended WITHOUT an answer - a refusal
+ * before it started ("No active subscription covers ..."), or a failure. The
+ * text is the server's own reason (already in the person's language), shown as
+ * given; it is never spoken, so no new speech is paid for.
+ */
+export interface VoiceTurnRefusalNotice {
+    readonly kind: "turn-refused";
+    readonly text: string;
+}
+/** Everything the voice stage can show in its notice slot. */
+export type VoiceSessionNoticeState = VoiceSessionNotice | VoiceTurnRefusalNotice;
 /**
  * A line the PANEL says in the voice conversation, outside any turn (BOFF-7803
  * FE9: the readback of a change that waits for its button).
@@ -69,11 +82,13 @@ interface Options {
      * Id + text of the newest assistant reply. A CHANGE of id is what advances
      * the session out of `thinking` — the text alone is not enough, because two
      * consecutive replies can be identical.
+     *
+     * ★ BOFF-9207: `refused` is set when the turn ended without an answer (a
+     * refusal or a failure) and `text` is the reason. Such a turn has nothing
+     * queued for speech, so it is shown, not spoken, and never enters `speaking`.
+     * Absent for a real answer, so its object is exactly what it was.
      */
-    latestReply: {
-        id: string;
-        text: string;
-    } | null;
+    latestReply: VoiceReply | null;
     /** Language the user is speaking, so the recogniser is pointed correctly. */
     language: string;
     /**
@@ -130,7 +145,7 @@ export interface VoiceSubmitMeta {
 export declare function useVoiceSession({ onSubmit, latestReply, language, graceMs: graceChoice, onSupersede, handsFreeInterrupt, handsFreeStreamNoticeAccepted, onAcceptHandsFreeStreamNotice, onBargeIn, }: Options): {
     session: Readonly<VoiceSessionSnapshot>;
     /** A recoverable problem worth showing, or null when all is well. */
-    notice: VoiceSessionNotice | null;
+    notice: VoiceSessionNoticeState | null;
     /**
      * The reply as it is being spoken, chunk by chunk — for the live caption.
      *

package/dist/shared/assistant/ui/useVoiceSession.js

@@ -146,16 +146,23 @@ function Te({ onSubmit: Te, latestReply: f, language: p, graceMs: Ee, onSupersed
 	let Ue = u("");
 	_.phase === "listening" && (Ue.current = o(_)), l(() => {
 		if (_.phase !== "thinking") return;
-		x(!1), V();
+		x(!1), V(), j((e) => typeof e == "object" && e ? null : e);
 		let e = Ue.current.trim();
 		e && Te(e, Q.current ?? `vs-orphan-${Date.now().toString(36)}`, E.current, { correction: L.current.correcting }), E.current = {}, D.current = i;
 	}, [_.phase]), l(() => {
 		let e = ce(f?.id, _.phase, O.current, pe(f?.id));
-		e.claim && (O.current = f?.id ?? null, e.advance && f && v({
+		e.claim && (O.current = f?.id ?? null, e.advance && f && (f.refused ? (V(), j({
+			kind: "turn-refused",
+			text: f.text
+		}), v({ type: "turn-refused" })) : v({
 			type: "reply",
 			text: f.text
-		}));
-	}, [f, _.phase]), l(() => {
+		})));
+	}, [
+		f,
+		_.phase,
+		V
+	]), l(() => {
 		if (S === null || _.phase !== "thinking" || O.current === S) return;
 		if (pe(S)) {
 			C();

package/dist/shared/assistant/ui/voice/AssistantVoiceSession.d.ts

@@ -2,7 +2,7 @@ import { FC, ReactNode } from 'react';
 import { AssistantAttachment } from '../../attachments';
 import { HandsFreePrivacyNoticeActions } from '../../voice/handsfree/useHandsFreeInterrupt';
 import { VoiceSessionSnapshot } from '../../voice/voiceSession';
-import { VoiceSessionNotice } from '../useVoiceSession';
+import { VoiceSessionNoticeState } from '../useVoiceSession';
 import { VoiceTranscriptTurn } from '../../voice/turnVisibility';
 /** How much room the voice session takes: a strip, the panel, or the screen. */
 export type VoiceView = "mini" | "panel" | "full";
@@ -17,7 +17,7 @@ interface Props {
     /** Cut the assistant off mid-reply. */
     onInterrupt?: () => void;
     /** A recoverable problem to surface. Null when the microphone is healthy. */
-    notice?: VoiceSessionNotice | null;
+    notice?: VoiceSessionNoticeState | null;
     /**
      * ★ BOFF-8613 H3: the backend speech stream's privacy notice, while it must
      * be answered before the microphone opens. Null otherwise (always, unless an
@@ -98,6 +98,12 @@ interface Props {
      * — the page the model offered in that voice turn.
      */
     renderAfterTurn?: (turnId: string) => ReactNode;
+    /**
+     * ★ BOFF-9341: told the view shown, while the panel has the Avatar tab: an
+     * enlarged session covers the tab, which then is no stage (D4). Absent, the
+     * session reports nothing.
+     */
+    onViewChange?: (view: VoiceView) => void;
 }
 /**
  * Full-screen voice conversation (BOFF-7120).