@burdenoff/fe-libs 2026.1029.2 → 2026.1029.4

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

@@ -407,6 +407,16 @@ export interface AssistantModeConfig {
     id: AssistantMode;
     label: string;
     description: string;
+    /**
+     * One line under the mode's name in the COMPACT presentation's Mode menu
+     * (BOFF-10055): what the mode does, in the product's confirmed wording.
+     * Translated at display time under `modeShortDescription.<id>`
+     * (`productCopy.ts`), which `assistantI18nSeedCopy` emits.
+     *
+     * ★ Not `description`: that is the long description, already seeded under
+     * `modeDescription.<id>` with a different meaning. Absent: no line.
+     */
+    shortDescription?: string;
     suggestions: readonly string[];
     /** Only offered to a workspace admin, `sandbox:admin` here (see useAssistantApiAccess). */
     requiresAdmin?: boolean;

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

@@ -41,7 +41,8 @@ import { AssistantModeConfig } from './conversation';
  * - A mode's `description` and `suggestions`, and the page label from
  *   `describeCurrentPage()`, are the product's words too. Since BOFF-8060 (F5)
  *   they are translated AT DISPLAY TIME under keys derived from their English
- *   (`suggestion.<mode>.<slug>`, `modeDescription.<mode>`, `page.<slug>`; see
+ *   (`suggestion.<mode>.<slug>`, `modeDescription.<mode>`,
+ *   `modeShortDescription.<mode>`, `page.<slug>`; see
  *   `productCopy.ts`). They stay out of the shared manifest, and
  *   `assistantI18nSeedCopy` emits them from the product's own modes and the
  *   `pageLabels` it passes — so a product passes its ENGLISH, never a
@@ -352,6 +353,8 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly 'composer.dropHere': "Drop files to attach";
     readonly 'composer.hint': "Enter to send · Shift+Enter for newline · drag or paste files to attach";
     readonly 'composer.placeholder': "Ask me anything…";
+    readonly 'composer.stop': "Stop the reply";
+    readonly 'composer.stopped': "Reply stopped.";
     readonly 'composer.voiceStart': "Dictate a message";
     readonly 'composer.voiceStarting': "Starting the microphone — tap to cancel";
     readonly 'composer.voiceStop': "Stop dictation";
@@ -500,9 +503,19 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly 'message.stopSpeaking': "Stop reading aloud";
     readonly 'message.stopSpeakingShort': "Stop";
     readonly 'messageList.ariaLabel': "Conversation messages";
+    readonly 'modeMenu.disabledBusy': "Mode can't change right now.";
+    readonly 'modeMenu.disabledReplying': "Mode can't change while the assistant is replying. Stop the reply to change it.";
+    readonly 'modeMenu.staticLabel': "Mode: {{mode}}";
+    readonly 'modeMenu.trigger': "Assistant mode: {{mode}}";
     readonly 'modeSelector.ariaLabel': "Select assistant mode";
     readonly 'modeSelector.auto': "Auto";
     readonly 'modeSelector.autoHint': "Answers your questions, and proposes changes for you to approve";
+    readonly 'modeSwitch.confirm': "Switch to {{mode}}";
+    readonly 'modeSwitch.draftKept': "What you typed stays in the message box.";
+    readonly 'modeSwitch.intro': "If you switch now:";
+    readonly 'modeSwitch.newConversation': "{{mode}} continues in a new conversation. This one stays in History.";
+    readonly 'modeSwitch.title': "Switch to {{mode}}?";
+    readonly 'modeSwitch.withdrawn': "{{count}} change(s) waiting for your approval will be withdrawn.";
     readonly 'offer.announce': "Suggested page: {{page}}";
     readonly 'offer.expired': "That suggestion has expired. Ask again, or use the menu.";
     readonly 'offer.hintLink': "Tap, or say “take me there”.";
@@ -708,7 +721,7 @@ export declare const ASSISTANT_I18N_MANIFEST: Readonly<Record<string, string>>;
  * The part of a mode that decides its keys and English: the pill, plus (when
  * given) its description and suggestion chips (BOFF-8060, F5).
  */
-export type AssistantModeCopySource = Pick<AssistantModeConfig, 'id' | 'label' | 'producesArtifacts'> & Partial<Pick<AssistantModeConfig, 'description' | 'suggestions'>>;
+export type AssistantModeCopySource = Pick<AssistantModeConfig, 'id' | 'label' | 'producesArtifacts'> & Partial<Pick<AssistantModeConfig, 'description' | 'shortDescription' | 'suggestions'>>;
 /**
  * `mode.<id>` for each mode a product offers, in the product's own words.
  *

package/dist/shared/assistant/i18nManifest.js

@@ -246,6 +246,8 @@ var g = {
 	"composer.dropHere": "Drop files to attach",
 	"composer.hint": "Enter to send · Shift+Enter for newline · drag or paste files to attach",
 	"composer.placeholder": "Ask me anything…",
+	"composer.stop": "Stop the reply",
+	"composer.stopped": "Reply stopped.",
 	"composer.voiceStart": "Dictate a message",
 	"composer.voiceStarting": "Starting the microphone — tap to cancel",
 	"composer.voiceStop": "Stop dictation",
@@ -394,9 +396,19 @@ var g = {
 	"message.stopSpeaking": "Stop reading aloud",
 	"message.stopSpeakingShort": "Stop",
 	"messageList.ariaLabel": "Conversation messages",
+	"modeMenu.disabledBusy": "Mode can't change right now.",
+	"modeMenu.disabledReplying": "Mode can't change while the assistant is replying. Stop the reply to change it.",
+	"modeMenu.staticLabel": "Mode: {{mode}}",
+	"modeMenu.trigger": "Assistant mode: {{mode}}",
 	"modeSelector.ariaLabel": "Select assistant mode",
 	"modeSelector.auto": "Auto",
 	"modeSelector.autoHint": "Answers your questions, and proposes changes for you to approve",
+	"modeSwitch.confirm": "Switch to {{mode}}",
+	"modeSwitch.draftKept": "What you typed stays in the message box.",
+	"modeSwitch.intro": "If you switch now:",
+	"modeSwitch.newConversation": "{{mode}} continues in a new conversation. This one stays in History.",
+	"modeSwitch.title": "Switch to {{mode}}?",
+	"modeSwitch.withdrawn": "{{count}} change(s) waiting for your approval will be withdrawn.",
 	"offer.announce": "Suggested page: {{page}}",
 	"offer.expired": "That suggestion has expired. Ask again, or use the menu.",
 	"offer.hintLink": "Tap, or say “take me there”.",

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

@@ -168,6 +168,10 @@ export * from './preview/bridgeHostContext';
 export * from './preview/AssistantPreviewOverlay';
 export * from './ui/composer/AssistantLanguageSelector';
 export * from './ui/composer/AssistantModeSelector';
+export * from './ui/composer/AssistantModeMenu';
+export * from './ui/composer/modeMenuKeys';
+export * from './ui/composer/modeSwitchPlan';
+export * from './ui/composer/imeEnter';
 export * from './ui/composer/AssistantVoiceButton';
 export * from './ui/composer/AssistantVoiceSelector';
 export * from './ui/composer/AssistantVoiceGraceSelector';

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

@@ -13,6 +13,7 @@
  *
  *   suggestion.<modeId>.<slug(english)>   a suggestion chip
  *   modeDescription.<modeId>              a mode's description
+ *   modeShortDescription.<modeId>         a mode's one-line Mode-menu text
  *   page.<slug(english)>                  a page label
  *
  * `slug` is the lower-camel ASCII of the English ("Show overdue tasks" ->
@@ -62,6 +63,12 @@ export declare function assistantCopySlug(english: string): string | null;
 export declare function assistantSuggestionKey(modeId: string, english: string): string | null;
 /** `modeDescription.<modeId>`. */
 export declare function assistantModeDescriptionKey(modeId: string): string;
+/**
+ * `modeShortDescription.<modeId>`: the one line under a mode in the compact
+ * Mode menu (BOFF-10055). A separate family from `modeDescription.<modeId>`,
+ * which holds the long description and is already seeded with that meaning.
+ */
+export declare function assistantModeShortDescriptionKey(modeId: string): string;
 /** `page.<slug>`, or null for a label that cannot be keyed. */
 export declare function assistantPageLabelKey(english: string): string | null;
 /** Translate one piece of product copy, or return it unchanged when unkeyable. */
@@ -71,6 +78,7 @@ export declare function assistantProductCopyEntries(args: {
     modes: readonly {
         id: string;
         description?: string;
+        shortDescription?: string;
         suggestions?: readonly string[];
     }[];
     pageLabels?: readonly string[];

package/dist/shared/assistant/productCopy.js

@@ -21,13 +21,16 @@ function o(e) {
 	return `modeDescription.${e}`;
 }
 function s(e) {
+	return `modeShortDescription.${e}`;
+}
+function c(e) {
 	let t = i(e);
 	return t === null ? null : `page.${t}`;
 }
-function c(e, t, n) {
+function l(e, t, n) {
 	return t === null ? n : e(t, n);
 }
-function l(e) {
+function u(e) {
 	let t = {}, n = (e, n) => {
 		if (e === null) return;
 		let r = t[e];
@@ -35,11 +38,11 @@ function l(e) {
 		t[e] = n;
 	};
 	for (let t of e.modes) {
-		t.description && t.description.trim() !== "" && n(o(t.id), t.description);
+		t.description && t.description.trim() !== "" && n(o(t.id), t.description), t.shortDescription && t.shortDescription.trim() !== "" && n(s(t.id), t.shortDescription);
 		for (let e of t.suggestions ?? []) n(a(t.id, e), e);
 	}
-	for (let t of e.pageLabels ?? []) n(s(t), t);
+	for (let t of e.pageLabels ?? []) n(c(t), t);
 	return t;
 }
 //#endregion
-export { e as MAX_COPY_SLUG_LENGTH, i as assistantCopySlug, o as assistantModeDescriptionKey, s as assistantPageLabelKey, l as assistantProductCopyEntries, a as assistantSuggestionKey, c as translateProductCopy };
+export { e as MAX_COPY_SLUG_LENGTH, i as assistantCopySlug, o as assistantModeDescriptionKey, s as assistantModeShortDescriptionKey, c as assistantPageLabelKey, u as assistantProductCopyEntries, a as assistantSuggestionKey, l as translateProductCopy };

package/dist/shared/assistant/turnTimeline.js

@@ -107,7 +107,7 @@ function _() {
 	return [...i.values()].map(u);
 }
 function v() {
-	i.clear();
+	i.clear(), a = 0;
 }
 var y = [
 	{

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

@@ -131,6 +131,17 @@ export interface TurnTimingReportingOptions {
     /** How this panel sends a batch — reading workspace and credentials when it does. */
     send: TurnTimingSender;
 }
+/**
+ * Register timing-only cleanup for a turn stopped on pagehide. The callback
+ * finishes its timeline and returns its id; the reporter reads that snapshot
+ * synchronously before flushing, regardless of Window listener order. Also
+ * call the returned `settle` before clearing the owner's id in its own exit
+ * handler. Normal notifications remain asynchronous. Unregister on unmount.
+ */
+export declare function registerTurnTimingPageExit(finish: () => string | undefined): {
+    settle: () => void;
+    unregister: () => void;
+};
 /**
  * Report this page's finished turns. The first call starts the page-wide
  * reporter, which runs for the page load (see the header); each panel lends it

package/dist/shared/assistant/turnTimingReporter.js

@@ -2,10 +2,10 @@ import { graphqlFetch as e } from "../graphql/fetch.js";
 import "../../shared-graphql.js";
 import { REPORT_MY_ASSISTANT_TURN_TIMINGS as t } from "./operations.js";
 import { getCapability as n, isUnknownFieldError as r, markSupported as i, markUnsupported as a } from "./capabilities.js";
-import { subscribeTurnTimelines as o, turnClockMs as s } from "./turnTimeline.js";
-import { buildAbandonedTurnReport as c, buildTurnTimingReport as l, isFinishedTurn as u } from "./turnTimingReport.js";
+import { subscribeTurnTimelines as o, turnClockMs as s, turnTimeline as c } from "./turnTimeline.js";
+import { buildAbandonedTurnReport as l, buildTurnTimingReport as u, isFinishedTurn as d } from "./turnTimingReport.js";
 //#region src/shared/assistant/turnTimingReporter.ts
-var d = {
+var f = {
 	flushAt: 5,
 	flushAfterMs: 15e3,
 	maxQueued: 50,
@@ -15,7 +15,7 @@ var d = {
 	rememberedTurns: 200,
 	maxRunningTurns: 20
 };
-function f() {
+function p() {
 	try {
 		let e = globalThis.crypto === void 0 ? null : globalThis.crypto;
 		if (!e) return null;
@@ -29,22 +29,22 @@ function f() {
 		return null;
 	}
 }
-var p = (e, t) => {
+var m = (e, t) => {
 	let n = setTimeout(e, t);
 	return () => clearTimeout(n);
 };
-function m(e) {
-	let t = d, n = e.schedule ?? p, r = e.now ?? Date.now, i = e.turnClock ?? s, a = e.nonce ?? f, o = () => {
+function h(e) {
+	let t = f, n = e.schedule ?? m, r = e.now ?? Date.now, i = e.turnClock ?? s, a = e.nonce ?? p, o = () => {
 		try {
 			return e.isPageHidden?.() === !0;
 		} catch {
 			return !1;
 		}
-	}, m = /* @__PURE__ */ new Set(), h = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map(), _ = [], v = null, y = !1, b = !1, x = 0, S = !1, C = !1, w = !1, T = (e) => {
-		for (m.add(e); m.size > t.rememberedTurns;) {
-			let e = m.values().next().value;
+	}, c = /* @__PURE__ */ new Set(), h = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map(), _ = [], v = null, y = !1, b = !1, x = 0, S = !1, C = !1, w = !1, T = (e) => {
+		for (c.add(e); c.size > t.rememberedTurns;) {
+			let e = c.values().next().value;
 			if (e === void 0) break;
-			m.delete(e);
+			c.delete(e);
 		}
 	}, E = () => {
 		let e = v;
@@ -102,7 +102,7 @@ function m(e) {
 		let e = i();
 		for (let [t, n] of [...g]) {
 			g.delete(t), T(t);
-			let r = c(n, e);
+			let r = l(n, e);
 			r && _.push(r);
 		}
 		_.length > t.maxQueued && _.splice(0, _.length - t.maxQueued);
@@ -134,7 +134,7 @@ function m(e) {
 	}
 	function F(e, n, r) {
 		T(e);
-		let i = l(n);
+		let i = u(n);
 		i && (_.push(i), _.length > t.maxQueued && _.splice(0, _.length - t.maxQueued), r && (o() ? P({
 			final: !0,
 			keepalive: !0,
@@ -155,8 +155,8 @@ function m(e) {
 	return {
 		observe: (e) => {
 			try {
-				if (S || m.has(e.turnId)) return;
-				if (!u(e)) {
+				if (S || c.has(e.turnId)) return;
+				if (!d(e)) {
 					L(e);
 					return;
 				}
@@ -194,23 +194,23 @@ function m(e) {
 		})
 	};
 }
-var h = new Set([
+var g = new Set([
 	"GRAPHQL_VALIDATION_FAILED",
 	"BAD_USER_INPUT",
 	"FORBIDDEN"
 ]);
-function g(e) {
+function _(e) {
 	if (typeof e.message == "string" && r(e.message)) return !0;
 	let t = e.extensions?.code;
-	return typeof t == "string" && h.has(t);
+	return typeof t == "string" && g.has(t);
 }
-function _(e) {
+function v(e) {
 	return typeof e == "object" && !!e && !Array.isArray(e);
 }
-function v(e) {
-	if (!_(e)) return null;
+function y(e) {
+	if (!v(e)) return null;
 	let t = e.reportMyAssistantTurnTimings;
-	if (!_(t)) return null;
+	if (!v(t)) return null;
 	let { enabled: n, accepted: r, rejected: i, duplicate: a, rateLimited: o } = t;
 	return typeof n != "boolean" || typeof r != "number" || typeof i != "number" || typeof a != "boolean" || typeof o != "boolean" ? null : {
 		enabled: n,
@@ -220,12 +220,12 @@ function v(e) {
 		rateLimited: o
 	};
 }
-function y(e) {
-	return !_(e) || !Array.isArray(e.errors) ? [] : e.errors.filter(_);
+function b(e) {
+	return !v(e) || !Array.isArray(e.errors) ? [] : e.errors.filter(v);
 }
-var b = { kind: "dropped" }, x = { kind: "unsupported" };
-async function S(n, i, a = e) {
-	if (!i.workspaceId) return b;
+var x = { kind: "dropped" }, S = { kind: "unsupported" };
+async function C(n, i, a = e) {
+	if (!i.workspaceId) return x;
 	try {
 		let e = await a({
 			gateway: "workspace",
@@ -244,78 +244,95 @@ async function S(n, i, a = e) {
 			extraHeaders: { "x-request-id": `bf-assistant-${n.nonce}` },
 			...n.keepalive ? { keepalive: !0 } : {}
 		});
-		if (y(e).some(g)) return x;
-		let r = v(e.data);
+		if (b(e).some(_)) return S;
+		let r = y(e.data);
 		return r ? {
 			kind: "receipt",
 			receipt: r
-		} : b;
+		} : x;
 	} catch (e) {
-		return r(e) || y(e).some(g) ? x : b;
+		return r(e) || b(e).some(_) ? S : x;
 	}
 }
-var C = [], w = null, T = null;
-function E() {
+var w = [], T = null, E = null, D = /* @__PURE__ */ new Set();
+function O(e) {
+	let t = () => {
+		try {
+			let t = e(), n = t ? c(t) : void 0;
+			n && d(n) && E?.reporter.observe(n);
+		} catch {}
+	};
+	return D.add(t), {
+		settle: t,
+		unregister: () => {
+			D.delete(t);
+		}
+	};
+}
+function k() {
 	return typeof document < "u" && document?.visibilityState === "hidden";
 }
-function D(e) {
+function A(e) {
 	let t = typeof window > "u" ? null : window, n = typeof document > "u" ? null : document, r = () => e.flush({
 		final: !0,
 		keepalive: !0,
 		abandonRunning: !0
 	}), i = () => {
+		for (let e of [...D]) e();
+		r();
+	}, a = () => {
 		n?.visibilityState === "hidden" && e.flush({
 			final: !0,
 			keepalive: !0,
 			keepAwaitingAudio: !0
 		});
 	};
-	return t?.addEventListener?.("pagehide", r), n?.addEventListener?.("freeze", r), n?.addEventListener?.("visibilitychange", i), () => {
-		t?.removeEventListener?.("pagehide", r), n?.removeEventListener?.("freeze", r), n?.removeEventListener?.("visibilitychange", i);
+	return t?.addEventListener?.("pagehide", i), n?.addEventListener?.("freeze", r), n?.addEventListener?.("visibilitychange", a), () => {
+		t?.removeEventListener?.("pagehide", i), n?.removeEventListener?.("freeze", r), n?.removeEventListener?.("visibilitychange", a);
 	};
 }
-function O() {
-	return C[C.length - 1]?.send ?? w;
+function j() {
+	return w[w.length - 1]?.send ?? T;
 }
-function k() {
+function M() {
 	let e = () => void 0, t = () => void 0, n = !1, r = {
-		reporter: m({
+		reporter: h({
 			send: (e) => {
-				let t = O();
-				return t ? t(e) : Promise.resolve(b);
+				let t = j();
+				return t ? t(e) : Promise.resolve(x);
 			},
 			onSupported: () => i("turnTimings"),
-			isPageHidden: E,
+			isPageHidden: k,
 			onUnsupported: () => {
-				a("turnTimings"), T === r && (T = null), r.release();
+				a("turnTimings"), E === r && (E = null), r.release();
 			}
 		}),
 		release: () => {
 			n || (n = !0, e(), t());
 		}
 	};
-	return e = o((e) => r.reporter.observe(e)), t = D(r.reporter), r;
+	return e = o((e) => r.reporter.observe(e)), t = A(r.reporter), r;
 }
-var A = () => void 0;
-function j(e) {
+var N = () => void 0;
+function P(e) {
 	try {
-		if (n("turnTimings") === "unsupported") return A;
+		if (n("turnTimings") === "unsupported") return N;
 		let t = { send: e.send };
-		C.push(t), T ||= k();
+		w.push(t), E ||= M();
 		let r = !1;
 		return () => {
 			if (r) return;
 			r = !0;
-			let e = C.indexOf(t);
-			e >= 0 && C.splice(e, 1), w = t.send;
+			let e = w.indexOf(t);
+			e >= 0 && w.splice(e, 1), T = t.send;
 		};
 	} catch {
-		return A;
+		return N;
 	}
 }
-function M() {
-	let e = T;
-	T = null, C.length = 0, w = null, e && (e.release(), e.reporter.dispose());
+function F() {
+	let e = E;
+	E = null, w.length = 0, T = null, e && (e.release(), e.reporter.dispose());
 }
 //#endregion
-export { d as TURN_TIMING_REPORTING, f as createTurnTimingNonce, m as createTurnTimingReporter, M as resetTurnTimingReporting, S as sendAssistantTurnTimings, j as startTurnTimingReporting };
+export { f as TURN_TIMING_REPORTING, p as createTurnTimingNonce, h as createTurnTimingReporter, O as registerTurnTimingPageExit, F as resetTurnTimingReporting, C as sendAssistantTurnTimings, P as startTurnTimingReporting };

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

@@ -4,6 +4,7 @@ import { WorkspaceWriteAccess } from '../useWorkspaceWriteAccess';
 import { AssistantNavigate } from './AssistantMarkdownRenderer';
 import { AssistantLiveAvatarSeam } from './assistantLiveAvatarSeam';
 import { AssistantPreviewController } from '../preview/types';
+import { AssistantPresentation } from './composer/AssistantComposer';
 export type AIAssistantPanelProps = PanelProps & {
     /** When provided, renders a dock/float toggle in the header. */
     docked?: boolean;
@@ -104,6 +105,14 @@ export type AIAssistantPanelProps = PanelProps & {
      * a prop chain. See `assistantLiveAvatarSeam`.
      */
     liveAvatar?: AssistantLiveAvatarSeam;
+    /**
+     * BOFF-10055: how the assistant is presented. Absent or `classic`: exactly the
+     * panel of before. `compact` opts this product into the redesigned composer
+     * (Slice 1: the card, the Mode menu, Stop, IME-safe Enter and the mode-switch
+     * confirmation). A product passes it through `AssistantOverlay`'s
+     * `panelProps`, behind its own flag.
+     */
+    presentation?: AssistantPresentation;
 };
 /**
  * The panel.