@burdenoff/fe-libs 2026.1016.2 → 2026.1016.3

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

@@ -0,0 +1,47 @@
+import { AssistantConversationProcessing } from '../../conversation';
+import { ReplySpeechOutcome } from '../../speech/replySpeechRequests';
+import { AvatarTabExchange } from './avatarAskGate';
+/**
+ * Where the exchange is:
+ *  - `thinking`: the turn is on its way;
+ *  - `speaking`: the answer is being read aloud now (Stop is offered);
+ *  - `done`: the turn is over and nothing more will happen to its audio (read, stopped, or left to Chat's own rules);
+ *  - `not-spoken`: the avatar was not there to take it (off, covered, ending, no hosted voice), or the reply was released;
+ *  - `cut`: the avatar stopped part way through (Turn off, the time limit, the avatar leaving) after part of it was read;
+ *  - `not-heard`: the avatar's audio output refused it, as what played before could not be shown to have stopped;
+ *  - `failed`: the turn itself failed.
+ */
+export type AvatarTabExchangeState = 'thinking' | 'speaking' | 'done' | 'not-spoken' | 'cut' | 'not-heard' | 'failed';
+/** Pure: the state from the turn's processing entry, the reply's registry outcome, and the speech provider. */
+export declare function avatarTabExchangeState(input: {
+    readonly replyId: string;
+    readonly processing: AssistantConversationProcessing | undefined;
+    readonly outcome: ReplySpeechOutcome | null;
+    /** The speech provider is reading this reply now. */
+    readonly speaking: boolean;
+    /**
+     * The reply's message exists yet. A local navigation's reply id is known when the question is written, and the reply
+     * itself only once the move settles: until then the conversation's processing entry may still be an earlier turn's.
+     */
+    readonly replied: boolean;
+    /**
+     * A navigation asked from the tab is still settling, and this is its reply. A move that settles with no reply (kept
+     * by the navigator, its conversation gone) clears it: nothing is on its way then.
+     */
+    readonly navigating: boolean;
+}): AvatarTabExchangeState;
+export interface AvatarTabExchangeView {
+    readonly exchange: AvatarTabExchange;
+    /** The question as it was sent. */
+    readonly question: string;
+    /** The answer's prose so far: tool lines stripped as the transcript strips them, so it is what the avatar reads. */
+    readonly answer: string;
+    /** The conversation's title when the question went into one that already had turns before it (critic m9), else null. */
+    readonly askedIn: string | null;
+    readonly state: AvatarTabExchangeState;
+}
+/**
+ * The last exchange the tab asked, live; null before the first (or once it is gone from the store). `navigatingReplyId`:
+ * the reply of a navigation asked from the tab that is still settling (`AvatarTabAsk.navigatingReplyId`).
+ */
+export declare function useAvatarTabExchange(last: AvatarTabExchange | null, navigatingReplyId: string | null): AvatarTabExchangeView | null;

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

@@ -0,0 +1,50 @@
+import { useAssistantStore as e } from "../../store.js";
+import { replyRequestsVersion as t, replySpeechRequest as n, subscribeReplyRequests as r } from "../../speech/replySpeechRequests.js";
+import { isTurnInFlight as i } from "../../turnState.js";
+import { parseToolActivity as a } from "../AssistantToolActivity.js";
+import { useAssistantSpeech as o } from "../AssistantSpeechProvider.js";
+import { useSyncExternalStore as s } from "react";
+//#region src/shared/assistant/ui/avatar/avatarTabExchange.ts
+function c(e) {
+	let { processing: t, outcome: n } = e, r = t !== void 0 && (t.messageId === null || t.messageId === e.replyId);
+	if (r && t.status === "error") return "failed";
+	if (r && i(t.status)) return "thinking";
+	if (e.speaking || n === "speaking") return "speaking";
+	switch (n) {
+		case "not-cleared": return "not-heard";
+		case "cut": return "cut";
+		case "declined":
+		case "dropped":
+		case "failed": return "not-spoken";
+		case "pending":
+		case null: return !e.replied && e.navigating ? "thinking" : "done";
+		case "spoken":
+		case "stopped": return "done";
+		default: return n;
+	}
+}
+function l(i, l) {
+	let u = i?.conversationId ?? null, d = e((e) => u === null ? void 0 : e.conversations.find((e) => e.id === u)), f = e((e) => u === null ? void 0 : e.processingByConversationId[u]);
+	s(r, t, t);
+	let { speakingMessageId: p } = o();
+	if (i === null || d === void 0) return null;
+	let m = d.messages.findIndex((e) => e.id === i.questionId), h = d.messages[m];
+	if (h === void 0) return null;
+	let g = d.messages.find((e) => e.id === i.replyId), _ = a(g?.content ?? "").text.trim(), v = d.title.trim();
+	return {
+		exchange: i,
+		question: h.content,
+		answer: _,
+		askedIn: m > 0 && v !== "" ? v : null,
+		state: c({
+			replyId: i.replyId,
+			processing: f,
+			outcome: n(i.replyId)?.outcome ?? null,
+			speaking: p === i.replyId,
+			replied: g !== void 0,
+			navigating: l === i.replyId
+		})
+	};
+}
+//#endregion
+export { c as avatarTabExchangeState, l as useAvatarTabExchange };

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

@@ -46,6 +46,13 @@ export declare function nextPanelOverlays(current: PanelOverlayState, toggled: "
 export interface PanelLayerState extends PanelOverlayState {
     /** The Avatar tab is the view on screen; absent where the panel offers none. */
     readonly avatarOpen?: boolean;
+    /**
+     * ★ BOFF-9360 (critic M5): the answer to the tab's own typed question is
+     * being read aloud, and the tab is shown. Escape stops that reading before
+     * it leaves the tab. Only the chat area says so (`setReplyEscape`), and only
+     * while nothing covers the tab.
+     */
+    readonly tabReplySpeaking?: boolean;
 }
 /**
  * What Escape should dismiss.
@@ -58,7 +65,7 @@ export interface PanelLayerState extends PanelOverlayState {
  * Escape is "back out of the thing I just opened"; here it destroyed a
  * conversation instead.
  */
-export declare function escapeDismisses(current: PanelLayerState): "overlay" | "tab" | "panel";
+export declare function escapeDismisses(current: PanelLayerState): "overlay" | "tab-reply" | "tab" | "panel";
 /**
  * Attribute marking the assistant panel's root element.
  *

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

@@ -10,7 +10,7 @@ function t(t, n) {
 	};
 }
 function n(e) {
-	return e.historyOpen || e.previewOpen ? "overlay" : e.avatarOpen === !0 ? "tab" : "panel";
+	return e.historyOpen || e.previewOpen ? "overlay" : e.avatarOpen === !0 ? e.tabReplySpeaking === !0 ? "tab-reply" : "tab" : "panel";
 }
 var r = "data-assistant-panel", i = "data-assistant-overlay", a = "data-assistant-voice-session";
 function o(e) {