@burdenoff/fe-libs 2026.1016.2 → 2026.1017.1

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

@@ -36,9 +36,31 @@ export interface LiveAvatarTabOfferedStore {
     /** This browser can show the avatar (desktop Chrome first), and it was not refused on this page. */
     getSnapshot: () => boolean;
 }
+/**
+ * ★ BOFF-9360: whether the avatar can take the answer to a typed question now (`liveAvatarAskState` maps the
+ * controller's snapshot): `ready`; `sound-blocked` (on, its sound blocked until a tap); `ending` (stopping, or near its
+ * time limit); `starting`; `locked` (off until the time a refusal named); `off`.
+ */
+export type LiveAvatarAskState = 'off' | 'locked' | 'starting' | 'ready' | 'sound-blocked' | 'ending';
+/** `LiveAvatarAskState` as a store read with `useSyncExternalStore`. STABLE. */
+export interface LiveAvatarAskStore {
+    subscribe: (onChange: () => void) => () => void;
+    getSnapshot: () => LiveAvatarAskState;
+}
 /** The Avatar tab's part of the seam (`createLiveAvatarSeam` builds it). STABLE, like the rest of the seam. */
 export interface LiveAvatarTabSeam {
     readonly offered: LiveAvatarTabOfferedStore;
+    /**
+     * ★ BOFF-9360: whether a typed question's answer can be spoken by the avatar now; the tab's ask box sends only
+     * while it is `ready`. Optional: a tab seam without it is read as `off`, so its box never sends.
+     *
+     * ★★ THE TYPED-QUESTION CONTRACT. Asking from the tab never starts, confirms, restarts or extends a session:
+     * nothing in that path calls `requestOn`, `confirm` or `setVoiceLive`, and a send changes no timer (a reply the
+     * avatar speaks re-arms its idle clock and holds the graceful end until it finishes, exactly as a voice reply does,
+     * always within the server's own end). D4 holds per reply: a reply goes to the avatar only when it starts while
+     * the tab is shown.
+     */
+    readonly ask?: LiveAvatarAskStore;
     /**
      * Told when the Avatar tab opens and closes; idempotent. Opening starts
      * nothing paid. Closing is the person's OFF for the tab's avatar, except one
@@ -68,6 +90,14 @@ export interface LiveAvatarTabVoice {
     /** Start it: the composer's own start (`startVoiceWithPrewarm`). Opens the microphone; never called by anything but its button. */
     readonly start: () => void;
 }
+/**
+ * ★ BOFF-9360: what to say about asking under Turn on while the avatar is off (`avatarTabAskLine`, critic M3):
+ *  - `none`: typing and voice can both ask (or will, once the avatar is on or the wait is over);
+ *  - `by-typing`: voice cannot start here for a reason that lasts, but typing can;
+ *  - `needs-voice`: typing is off here for a reason that lasts, but a voice conversation can ask;
+ *  - `nothing`: neither can, so turning the avatar on here would be of no use.
+ */
+export type LiveAvatarTabAskLine = 'none' | 'by-typing' | 'needs-voice' | 'nothing';
 /** What the panel hands the tab's `View`. */
 export interface LiveAvatarTabProps {
     /**
@@ -83,6 +113,11 @@ export interface LiveAvatarTabProps {
     readonly leaveHintId: string;
     /** The "Start a voice conversation" button: focus returns to it when a voice conversation started in the tab ends. */
     readonly startVoiceRef: RefObject<HTMLButtonElement | null>;
+    /**
+     * ★ BOFF-9360: the line about asking, when the tab has an ask box. Absent (no box): the line is today's, from
+     * `voice.impossible` alone ("…you ask it questions in a voice conversation").
+     */
+    readonly askLine?: LiveAvatarTabAskLine;
 }
 /** The ids the tab row and the two tab panels share (`AIAssistantPanel` makes them). */
 export interface LiveAvatarTabIds {
@@ -109,6 +144,11 @@ export interface LiveAvatarTabState {
     readonly ids?: LiveAvatarTabIds | null;
     /** A full-surface overlay (History, the preview) covers the panel: the tab under it is not shown (D4). */
     readonly covered?: boolean;
+    /**
+     * ★ BOFF-9360 (critic M5): the chat area hands the panel how to stop the tab's own answer while it is read aloud
+     * and the tab is shown, and null when that ends. The panel's Escape then stops the reading before it leaves the tab.
+     */
+    readonly setReplyEscape?: (stop: (() => void) | null) => void;
 }
 /**
  * @internal Provided by `AIAssistantPanel` and read by the assistant's own

package/dist/shared/assistant/ui/avatar/AssistantAvatarTab.d.ts

@@ -1,5 +1,6 @@
 import { FC } from 'react';
 import { LiveAvatarTabSeam, LiveAvatarTabVoice } from '../assistantLiveAvatarSeam';
+import { AvatarTabAsk } from './avatarAskGate';
 export interface AssistantAvatarTabProps {
     readonly tab: LiveAvatarTabSeam;
     /** This panel's id, and the Avatar tab that labels it. */
@@ -9,5 +10,10 @@ export interface AssistantAvatarTabProps {
     /** Nothing covers the tab (D4): see `LiveAvatarTabProps.shown`. */
     readonly shown: boolean;
     readonly voice: LiveAvatarTabVoice;
+    /**
+     * ★ BOFF-9360: typed questions: the gate, the send and the last exchange
+     * (`AssistantChatArea`), for the tab's ask box. Absent: no ask box.
+     */
+    readonly ask?: AvatarTabAsk;
 }
 export declare const AssistantAvatarTab: FC<AssistantAvatarTabProps>;

package/dist/shared/assistant/ui/avatar/AssistantAvatarTab.js

@@ -1,70 +1,117 @@
-import { ASSISTANT_VOICE_SESSION_ATTR as e } from "../panelOverlays.js";
-import { useLiveAvatarHandsFreeGuard as t } from "../assistantLiveAvatarSeam.js";
-import { useEffect as n, useLayoutEffect as r, useRef as i, useState as a } from "react";
-import { jsx as o } from "react/jsx-runtime";
+import { clearReplyRequests as e } from "../../speech/replySpeechRequests.js";
+import { useAvatarCopy as t } from "../../avatar/useAvatarCopy.js";
+import { ASSISTANT_VOICE_SESSION_ATTR as n } from "../panelOverlays.js";
+import { useLiveAvatarHandsFreeGuard as r } from "../assistantLiveAvatarSeam.js";
+import { avatarAskBlockerLasts as i } from "./avatarAskGate.js";
+import { AvatarTabAskBox as a } from "./AvatarTabAskBox.js";
+import { AvatarTabLastExchange as o } from "./AvatarTabLastExchange.js";
+import { useAvatarTabExchange as s } from "./avatarTabExchange.js";
+import { useEffect as c, useLayoutEffect as l, useRef as u, useState as d } from "react";
+import { jsx as f, jsxs as p } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/avatar/AssistantAvatarTab.tsx
-var s = 180;
-function c(t, n) {
-	let [i, o] = a(0);
-	return r(() => {
-		if (!n) return;
-		let r = t.current?.parentElement?.querySelector(`[${e}]`);
+var m = 180;
+function h(e, t) {
+	let [r, i] = d(0);
+	return l(() => {
+		if (!t) return;
+		let r = e.current?.parentElement?.querySelector(`[${n}]`);
 		if (!r) return;
-		let i = () => {
+		let a = () => {
 			let e = typeof r.getBoundingClientRect == "function" ? r.getBoundingClientRect().height : 0;
-			o(Math.round(e));
+			i(Math.round(e));
 		};
-		if (i(), typeof ResizeObserver > "u") return;
-		let a = new ResizeObserver(i);
-		return a.observe(r), () => a.disconnect();
-	}, [t, n]), n ? i > 0 ? i : s : 0;
+		if (a(), typeof ResizeObserver > "u") return;
+		let o = new ResizeObserver(a);
+		return o.observe(r), () => o.disconnect();
+	}, [e, t]), t ? r > 0 ? r : m : 0;
 }
-function l() {
+function g() {
 	if (typeof document > "u") return !1;
 	let e = document.activeElement;
 	return e === null || e === document.body || !e.isConnected || e.hasAttribute("data-assistant-panel");
 }
-var u = ({ tab: e, id: a, labelledBy: s, leaveHintId: u, shown: d, voice: f }) => {
-	let p = i(null), m = i(null), h = t(), g = c(p, f.live), _ = i(null);
-	r(() => {
-		let t = (_.current?.setup ?? 0) + 1;
-		return _.current = {
-			tab: e,
-			setup: t
-		}, e.setOpen(!0), () => {
+var _ = ({ state: e, restored: n }) => {
+	let r = t();
+	return /* @__PURE__ */ f("p", {
+		className: "sr-only",
+		"aria-live": "polite",
+		"aria-atomic": "true",
+		"data-testid": "assistant-avatar-tab-ask-live",
+		children: e === "thinking" ? r.askThinking : e === "not-spoken" ? r.askNotSpoken : e === "cut" ? r.askCut : e === "not-heard" ? r.askNotHeard : e === "failed" ? n ? r.askFailed : r.askFailedInChat : ""
+	});
+}, v = ({ tab: t, id: n, labelledBy: m, leaveHintId: v, shown: y, voice: b, ask: x }) => {
+	let S = u(null), C = u(null), w = u(null), T = r(), E = h(S, b.live), D = u(null);
+	l(() => {
+		let n = (D.current?.setup ?? 0) + 1;
+		return D.current = {
+			tab: t,
+			setup: n
+		}, t.setOpen(!0), () => {
 			queueMicrotask(() => {
-				let n = _.current;
-				n !== null && n.tab === e && n.setup !== t || e.setOpen(!1);
+				let r = D.current;
+				r !== null && r.tab === t && r.setup !== n || (t.setOpen(!1), e());
 			});
 		};
-	}, [e]);
-	let v = i(f.live);
-	return n(() => {
-		let e = v.current;
-		v.current = f.live, !(!e || f.live) && l() && m.current?.focus();
-	}, [f.live]), /* @__PURE__ */ o("div", {
-		ref: p,
+	}, [t]);
+	let O = u(b.live);
+	c(() => {
+		let e = O.current;
+		O.current = b.live, !(!e || b.live) && g() && w.current?.focus();
+	}, [b.live]);
+	let k = s(x?.last ?? null, x?.navigatingReplyId ?? null), A = b.live ? void 0 : x, [j, M] = d(null), N = k?.state === "failed" ? k.exchange.replyId : null, P = k?.question ?? "", F = x?.draft;
+	l(() => {
+		if (N === null || F === void 0 || j?.replyId === N) return;
+		let e = F.get().trim() === "";
+		e && F.set(P), M({
+			replyId: N,
+			restored: e
+		});
+	}, [
+		N,
+		P,
+		F,
+		j
+	]);
+	let I = j === null || j.replyId !== N || j.restored;
+	return /* @__PURE__ */ p("div", {
+		ref: S,
 		role: "tabpanel",
-		id: a,
-		"aria-labelledby": s,
+		id: n,
+		"aria-labelledby": m,
 		className: "absolute inset-0 z-[5] flex flex-col bg-bg-surface",
 		"data-testid": "assistant-avatar-tab",
-		children: /* @__PURE__ */ o("div", {
-			className: "flex min-h-0 flex-1 flex-col overflow-y-auto px-4 pt-4",
-			style: {
-				paddingBottom: g + 16,
-				scrollPaddingBottom: g + 16
-			},
-			"data-testid": "assistant-avatar-tab-column",
-			children: /* @__PURE__ */ o(e.View, {
-				shown: d,
-				voice: f,
-				handsFreeOff: h,
-				leaveHintId: u,
-				startVoiceRef: m
-			})
-		})
+		children: [
+			/* @__PURE__ */ p("div", {
+				className: "flex min-h-0 flex-1 flex-col overflow-y-auto px-4 pt-4",
+				style: {
+					paddingBottom: E + 16,
+					scrollPaddingBottom: E + 16
+				},
+				"data-testid": "assistant-avatar-tab-column",
+				children: [/* @__PURE__ */ f(t.View, {
+					shown: y,
+					voice: b,
+					handsFreeOff: T,
+					leaveHintId: v,
+					startVoiceRef: w,
+					...x ? { askLine: x.line } : {}
+				}), A ? /* @__PURE__ */ f(o, {
+					view: k,
+					invite: !i(A.blocker),
+					restored: I,
+					focusAfterStop: C
+				}, k?.exchange.replyId ?? "none") : null]
+			}),
+			A ? /* @__PURE__ */ f(a, {
+				ask: A,
+				inputRef: C
+			}) : null,
+			x ? /* @__PURE__ */ f(_, {
+				state: k?.state ?? null,
+				restored: I
+			}) : null
+		]
 	});
 };
 //#endregion
-export { u as AssistantAvatarTab };
+export { v as AssistantAvatarTab };

package/dist/shared/assistant/ui/avatar/AvatarTabAskBox.d.ts

@@ -0,0 +1,8 @@
+import { FC, RefObject } from 'react';
+import { AvatarTabAsk } from './avatarAskGate';
+export interface AvatarTabAskBoxProps {
+    readonly ask: AvatarTabAsk;
+    /** The textarea: where focus goes back to after a send, and after Stop. */
+    readonly inputRef: RefObject<HTMLTextAreaElement | null>;
+}
+export declare const AvatarTabAskBox: FC<AvatarTabAskBoxProps>;

package/dist/shared/assistant/ui/avatar/AvatarTabAskBox.js

@@ -0,0 +1,87 @@
+import { useAvatarCopy as e } from "../../avatar/useAvatarCopy.js";
+import { useAvatarTabDraft as t } from "./avatarTabDraft.js";
+import { useId as n, useLayoutEffect as r, useRef as i, useState as a } from "react";
+import { ArrowUp as o } from "lucide-react";
+import { jsx as s, jsxs as c } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/avatar/AvatarTabAskBox.tsx
+var l = "focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong", u = 229;
+function d(e) {
+	return e.nativeEvent.isComposing === !0 || e.nativeEvent.keyCode === u;
+}
+function f(e) {
+	return e !== void 0 && Array.from(e).includes("Files");
+}
+var p = ({ ask: u, inputRef: p }) => {
+	let m = e(), h = n(), [g, _] = a(!1), v = i(!1);
+	r(() => {
+		v.current = !1;
+	});
+	let y = t(u.draft), b = u.blocker === null ? null : m.askBlocked(u.blocker), x = u.blocker === null && y.trim() !== "", S = b ?? (g ? m.askNoFiles : m.askHint), C = (e) => {
+		if (!(v.current || !x)) {
+			if (v.current = !0, !u.send(u.draft.get()).accepted) {
+				v.current = !1;
+				return;
+			}
+			u.draft.set(""), _(!1), e === "button" && p.current?.focus();
+		}
+	};
+	return /* @__PURE__ */ c("div", {
+		className: "shrink-0 border-t border-border-subtle bg-bg-surface px-4 pb-3 pt-2",
+		"data-testid": "assistant-avatar-tab-ask",
+		children: [/* @__PURE__ */ c("div", {
+			className: "flex items-end gap-2",
+			children: [/* @__PURE__ */ s("textarea", {
+				ref: p,
+				value: y,
+				onChange: (e) => {
+					u.draft.set(e.target.value), g && _(!1);
+				},
+				onKeyDown: (e) => {
+					if (d(e)) {
+						e.key === "Escape" && e.stopPropagation();
+						return;
+					}
+					e.key !== "Enter" || e.shiftKey || (e.preventDefault(), C("key"));
+				},
+				onDragOver: (e) => {
+					f(e.dataTransfer?.types) && e.preventDefault();
+				},
+				onDrop: (e) => {
+					f(e.dataTransfer?.types) && (e.preventDefault(), e.stopPropagation(), _(!0));
+				},
+				onPaste: (e) => {
+					let t = e.clipboardData;
+					f(t?.types) && (_(!0), Array.from(t.types).includes("text/plain") || e.preventDefault());
+				},
+				rows: 1,
+				dir: "auto",
+				"aria-label": m.askLabel,
+				"aria-describedby": h,
+				placeholder: m.askPlaceholder,
+				className: `field-sizing-content max-h-[7.5rem] min-h-11 min-w-0 flex-1 resize-none rounded-xl border border-border-default bg-bg-elevated px-3 py-2.5 text-sm text-text-primary placeholder:text-text-muted ${l}`,
+				"data-testid": "assistant-avatar-tab-ask-input"
+			}), /* @__PURE__ */ s("button", {
+				type: "button",
+				onClick: () => C("button"),
+				"aria-disabled": !x,
+				"aria-label": m.askSend,
+				"aria-describedby": h,
+				title: m.askSend,
+				className: `inline-flex size-11 shrink-0 items-center justify-center rounded-xl bg-action-primary-bg 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 ${l}`,
+				"data-testid": "assistant-avatar-tab-ask-send",
+				children: /* @__PURE__ */ s(o, {
+					className: "size-5",
+					"aria-hidden": "true"
+				})
+			})]
+		}), /* @__PURE__ */ s("p", {
+			id: h,
+			className: "mt-1 text-xs text-text-muted",
+			"data-testid": "assistant-avatar-tab-ask-hint",
+			"data-reason": u.blocker ?? void 0,
+			children: S
+		})]
+	});
+};
+//#endregion
+export { p as AvatarTabAskBox };

package/dist/shared/assistant/ui/avatar/AvatarTabLastExchange.d.ts

@@ -0,0 +1,13 @@
+import { FC, RefObject } from 'react';
+import { AvatarTabExchangeView } from './avatarTabExchange';
+export interface AvatarTabLastExchangeProps {
+    /** The last exchange, or null before the first. */
+    readonly view: AvatarTabExchangeView | null;
+    /** Say the empty prompt before the first question (not where typing is off for a reason that lasts). */
+    readonly invite: boolean;
+    /** A failed turn's question went back into the box (it was empty), so the line may say so. */
+    readonly restored: boolean;
+    /** Where focus goes when Stop leaves while holding it: the ask box. */
+    readonly focusAfterStop: RefObject<HTMLTextAreaElement | null>;
+}
+export declare const AvatarTabLastExchange: FC<AvatarTabLastExchangeProps>;

package/dist/shared/assistant/ui/avatar/AvatarTabLastExchange.js

@@ -0,0 +1,97 @@
+import { AssistantMarkdownRenderer as e } from "../AssistantMarkdownRenderer.js";
+import { useAvatarCopy as t } from "../../avatar/useAvatarCopy.js";
+import { useAssistantSpeech as n } from "../AssistantSpeechProvider.js";
+import { useCallback as r, useId as i, useLayoutEffect as a, useRef as o, useState as s } from "react";
+import { Square as c } from "lucide-react";
+import { jsx as l, jsxs as u } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/avatar/AvatarTabLastExchange.tsx
+var d = "text-xs font-medium text-text-secondary", f = "text-xs text-text-muted", p = "inline-flex min-h-11 shrink-0 items-center justify-center gap-1.5 rounded-xl border border-border-default bg-bg-elevated px-3 text-xs font-medium text-text-primary transition-colors hover:bg-bg-raised focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong", m = 160, h = ({ view: h, invite: g, restored: _, focusAfterStop: v }) => {
+	let y = t(), b = n(), x = i(), S = o(null), [C, w] = s(!1), T = h?.answer ?? "", [E, D] = s(null), O = E ?? (T.length > m || T.split("\n").length > 4);
+	a(() => {
+		let e = S.current;
+		if (e === null || C) return;
+		let t = () => {
+			e.clientHeight > 0 && D(e.scrollHeight > e.clientHeight + 1);
+		};
+		if (t(), typeof ResizeObserver > "u") return;
+		let n = new ResizeObserver(t);
+		return n.observe(e), () => n.disconnect();
+	}, [T, C]);
+	let k = r((e) => {
+		if (e !== null) return () => {
+			e.ownerDocument.activeElement === e && v.current?.focus();
+		};
+	}, [v]);
+	if (h === null) return g ? /* @__PURE__ */ l("p", {
+		className: f,
+		"data-testid": "assistant-avatar-tab-ask-empty",
+		children: y.askEmpty
+	}) : null;
+	let A = h.state === "speaking", j = h.state === "thinking" ? y.askThinking : h.state === "not-spoken" ? y.askNotSpoken : h.state === "cut" ? y.askCut : h.state === "not-heard" ? y.askNotHeard : h.state === "failed" ? _ ? y.askFailed : y.askFailedInChat : y.askAlsoInChat;
+	return /* @__PURE__ */ u("section", {
+		"aria-label": y.askExchangeLabel,
+		className: "flex min-w-0 shrink-0 flex-col gap-1 border-t border-border-subtle pt-3",
+		"data-testid": "assistant-avatar-tab-exchange",
+		"data-state": h.state,
+		children: [
+			/* @__PURE__ */ l("p", {
+				className: d,
+				children: y.askYouAsked
+			}),
+			/* @__PURE__ */ l("p", {
+				dir: "auto",
+				className: "line-clamp-2 break-words text-sm text-text-primary",
+				"data-testid": "assistant-avatar-tab-question",
+				children: h.question
+			}),
+			h.askedIn === null ? null : /* @__PURE__ */ l("p", {
+				dir: "auto",
+				className: `${f} truncate`,
+				"data-testid": "assistant-avatar-tab-asked-in",
+				children: y.askAskedIn(h.askedIn)
+			}),
+			/* @__PURE__ */ u("div", {
+				className: "flex min-h-11 items-center justify-between gap-2",
+				children: [/* @__PURE__ */ l("p", {
+					className: d,
+					children: y.askAnswer
+				}), A ? /* @__PURE__ */ u("button", {
+					ref: k,
+					type: "button",
+					onClick: () => b.stop(),
+					"aria-label": y.askStop,
+					className: p,
+					"data-testid": "assistant-avatar-tab-answer-stop",
+					children: [/* @__PURE__ */ l(c, {
+						className: "size-3.5",
+						"aria-hidden": "true"
+					}), /* @__PURE__ */ l("span", { children: y.askStopShort })]
+				}) : null]
+			}),
+			T === "" ? null : /* @__PURE__ */ l("div", {
+				ref: S,
+				id: x,
+				dir: "auto",
+				className: `min-w-0 text-sm text-text-primary ${C ? "" : "line-clamp-4"}`,
+				"data-testid": "assistant-avatar-tab-answer",
+				children: /* @__PURE__ */ l(e, { content: T })
+			}),
+			T !== "" && (O || C) ? /* @__PURE__ */ l("button", {
+				type: "button",
+				onClick: () => w((e) => !e),
+				"aria-expanded": C,
+				"aria-controls": x,
+				className: `${p} self-start`,
+				"data-testid": "assistant-avatar-tab-answer-toggle",
+				children: C ? y.askShowLess : y.askShowAll
+			}) : null,
+			/* @__PURE__ */ l("p", {
+				className: f,
+				"data-testid": "assistant-avatar-tab-exchange-status",
+				children: j
+			})
+		]
+	});
+};
+//#endregion
+export { h as AvatarTabLastExchange };

package/dist/shared/assistant/ui/avatar/avatarAskGate.d.ts

@@ -0,0 +1,104 @@
+import { AutoRouteConversation } from '../../autoRouting';
+import { AssistantMode } from '../../types';
+import { LiveAvatarAskState, LiveAvatarTabAskLine } from '../assistantLiveAvatarSeam';
+import { VoiceStartBlocker } from '../voice/voiceStartGate';
+import { AvatarTabDraft } from './avatarTabDraft';
+/** Why the tab's Send is off, most lasting first. */
+export type AvatarAskBlocker = 
+/** A voice conversation is live: the box is hidden, the strip takes its place, the draft is kept. */
+'hidden-voice'
+/** This conversation takes no new turn (saved before server history). */
+ | 'read-only'
+/** The person picked a mode that writes (Auto off): typed questions work only in Ask (critic M4). */
+ | 'mode-picked'
+/** Auto would continue in the write mode this conversation was moved up to: a new conversation asks in Ask. */
+ | 'mode-escalated'
+/** The avatar is off: Turn on first. Typing is allowed; nothing starts it. */
+ | 'avatar-off'
+/** The avatar is stopping, near its time limit, or Turn on waits for a time a refusal named (critic m11). */
+ | 'avatar-again'
+/** The avatar is on, but the browser blocks its sound until a tap on its frame (critic m1). */
+ | 'sound'
+/** The avatar is being started. */
+ | 'starting'
+/** Not now: a turn in flight, an approval, history loading, navigation, the consent dialog, a reply's declines. */
+ | 'busy'
+/** Not now: a Chat Send is saving its attachments. */
+ | 'committing';
+export interface AvatarAskGateInput {
+    /** A voice conversation is live (started in the tab or adopted from Voice). */
+    readonly voiceLive: boolean;
+    /** The open conversation is read-only. */
+    readonly readOnly: boolean;
+    /** Where the send would land writes (`avatarAskWrites`), and why; null when it does not. */
+    readonly writes: 'picked' | 'escalated' | null;
+    /** The avatar, as the tab seam's ask store says (`liveAvatarAskState`). */
+    readonly avatar: LiveAvatarAskState;
+    /** The conversation cannot take a turn now (the composer's `disabled`, plus the consent dialog and a reply's declines). */
+    readonly busy: boolean;
+    /** A Chat Send is saving its attachments. */
+    readonly committing: boolean;
+}
+/** Null when a typed question can be sent now; else the first reason it cannot, in the pinned order (critic M3). */
+export declare function avatarAskBlocker(input: AvatarAskGateInput): AvatarAskBlocker | null;
+/** A reason nothing the person waits out (or Turn on) will lift here: the conversation or its mode. */
+export declare function avatarAskBlockerLasts(blocker: AvatarAskBlocker | null): boolean;
+/** The line about asking, said under Turn on while the avatar is off (critic M3): `LiveAvatarTabAskLine`. */
+export type AvatarTabAskLine = LiveAvatarTabAskLine;
+export declare function avatarTabAskLine(ask: AvatarAskBlocker | null, voice: VoiceStartBlocker | null): AvatarTabAskLine;
+/**
+ * Would a typed question sent now land in a mode that writes, and why? The same routing the send will run: under
+ * Auto, `resolveAutoRoute` with intent `read` (a fresh draft never escalates; a conversation Auto already moved up
+ * "continues" in the write mode); otherwise the selected mode. `conversation` is the open one, or null when there is
+ * none or it is not continued (read-only, another workspace's), as `handleSend` reads it.
+ */
+export declare function avatarAskWrites(input: {
+    readonly auto: boolean;
+    readonly selectedMode: AssistantMode;
+    readonly conversation: AutoRouteConversation | null;
+    /** The mode is write-capable, or needs confirmed writes. */
+    readonly modeWrites: (mode: AssistantMode) => boolean;
+}): 'picked' | 'escalated' | null;
+/** One exchange the tab asked: where its question landed, and the reply it waits for. */
+export interface AvatarTabExchange {
+    readonly conversationId: string;
+    readonly questionId: string;
+    readonly replyId: string;
+}
+/**
+ * What a typed question from the tab became (critic M7). The box clears only when it was accepted.
+ *  - not accepted: nothing was written; the draft stays.
+ *  - accepted and recorded: the question and its reply's id (the reply may still be on its way).
+ *  - accepted, nothing recorded: a command carried out that records no exchange (a new conversation, the delete
+ *    confirmation opening).
+ */
+export type AvatarTabAskResult = {
+    readonly accepted: false;
+} | ({
+    readonly accepted: true;
+    readonly recorded: true;
+} & AvatarTabExchange) | {
+    readonly accepted: true;
+    readonly recorded: false;
+};
+/** What the chat area hands the Avatar tab for its ask box. */
+export interface AvatarTabAsk {
+    /** Why Send is off now, or null. */
+    readonly blocker: AvatarAskBlocker | null;
+    /** The line about asking under Turn on (critic M3). */
+    readonly line: AvatarTabAskLine;
+    /** Send a typed question; never starts, confirms or extends the avatar. */
+    readonly send: (text: string) => AvatarTabAskResult;
+    /** The last exchange asked from the tab in this opening, in the open conversation; null before the first. */
+    readonly last: AvatarTabExchange | null;
+    /**
+     * The reply id of a navigation asked from the tab that is still settling, or null. Its reply is written only once the
+     * move settles, and a move that is kept writes none: "Thinking…" lasts only while this names the exchange's reply.
+     */
+    readonly navigatingReplyId: string | null;
+    /**
+     * The box's words, kept by the chat area: they survive the tab closing and a voice conversation (which hides the
+     * box), and are never Chat's draft, nor moved into it. A store, so a keystroke re-renders the box alone.
+     */
+    readonly draft: AvatarTabDraft;
+}

package/dist/shared/assistant/ui/avatar/avatarAskGate.js

@@ -0,0 +1,39 @@
+import { resolveAutoRoute as e } from "../../autoRouting.js";
+import { voiceStartBlockerLasts as t } from "../voice/voiceStartGate.js";
+//#region src/shared/assistant/ui/avatar/avatarAskGate.ts
+function n(e) {
+	if (e.voiceLive) return "hidden-voice";
+	if (e.readOnly) return "read-only";
+	if (e.writes === "picked") return "mode-picked";
+	if (e.writes === "escalated") return "mode-escalated";
+	switch (e.avatar) {
+		case "off": return "avatar-off";
+		case "locked":
+		case "ending": return "avatar-again";
+		case "sound-blocked": return "sound";
+		case "starting": return "starting";
+		case "ready": break;
+		default: return e.avatar;
+	}
+	return e.busy ? "busy" : e.committing ? "committing" : null;
+}
+function r(e) {
+	return e === "read-only" || e === "mode-picked" || e === "mode-escalated";
+}
+function i(e, n) {
+	let i = r(e), a = t(n);
+	return i && a ? "nothing" : i ? "needs-voice" : a ? "by-typing" : "none";
+}
+function a(t) {
+	if (t.auto) {
+		let n = e({
+			intent: "read",
+			dictated: !1,
+			conversation: t.conversation
+		});
+		return t.modeWrites(n.mode) ? "escalated" : null;
+	}
+	return t.modeWrites(t.selectedMode) ? "picked" : null;
+}
+//#endregion
+export { n as avatarAskBlocker, r as avatarAskBlockerLasts, a as avatarAskWrites, i as avatarTabAskLine };

package/dist/shared/assistant/ui/avatar/avatarTabDraft.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The Avatar tab's ask box words (BOFF-9360), as a small store the chat area owns.
+ *
+ * ★ Owned by the chat area, so the words survive the tab closing, a voice conversation (which hides the box) and a
+ * conversation switch; never Chat's draft, nor moved into it. A store, not the chat area's state: a keystroke
+ * re-renders the ask box alone, never the chat area (the transcript under the tab with it) nor the tab's view.
+ */
+export interface AvatarTabDraft {
+    /** The words now. */
+    readonly get: () => string;
+    /** Replace the words; listeners hear only a change. */
+    readonly set: (text: string) => void;
+    readonly subscribe: (listener: () => void) => () => void;
+}
+export declare function createAvatarTabDraft(initial?: string): AvatarTabDraft;
+/** The words, live: only the component that shows them re-renders as they change. */
+export declare function useAvatarTabDraft(draft: AvatarTabDraft): string;

package/dist/shared/assistant/ui/avatar/avatarTabDraft.js

@@ -0,0 +1,22 @@
+import { useSyncExternalStore as e } from "react";
+//#region src/shared/assistant/ui/avatar/avatarTabDraft.ts
+function t(e = "") {
+	let t = e, n = /* @__PURE__ */ new Set();
+	return {
+		get: () => t,
+		set: (e) => {
+			if (e !== t) {
+				t = e;
+				for (let e of [...n]) e();
+			}
+		},
+		subscribe: (e) => (n.add(e), () => {
+			n.delete(e);
+		})
+	};
+}
+function n(t) {
+	return e(t.subscribe, t.get, t.get);
+}
+//#endregion
+export { t as createAvatarTabDraft, n as useAvatarTabDraft };