@burdenoff/fe-libs 2026.1008.3 → 2026.1009.1

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

@@ -0,0 +1,32 @@
+import { FocusReturnDocument } from '../../hooks/useReturnFocus';
+/**
+ * ★ BOFF-8975 (N4 tap-confirm): where keyboard focus goes after "Keep editing"
+ * on an "Open {page}" OFFER.
+ *
+ * The tap claims the offer BEFORE it asks anything (a second tap, "yes" or
+ * "take me there" must do nothing), and a claimed offer draws no link, so the
+ * link the person pressed is removed from the page and focus falls to
+ * `<body>`. The dialog's own focus return (`ModalShell`, BOFF-8085) cannot
+ * help: the opener it recorded is gone. When "Keep editing" gives the offer
+ * back, a NEW link is drawn; the person must find themselves on it, or, if it
+ * did not come back (the page left the menu, the offer ran out), on the
+ * composer — never at the top of the page.
+ *
+ * Rules, the dialog's own:
+ *  - ★ Only after the dialog is gone from the page: while its content is
+ *    mounted focus is in it, and Radix returns focus on its own timer.
+ *  - ★ Only when focus was DROPPED (`focusWasDropped`): if the person, or the
+ *    dialog's own return, put focus somewhere on purpose, it stays there.
+ *  - ★ Bounded: the link and the composer come back a render or two later (the
+ *    composer is disabled while the navigation settles); give up after
+ *    `FOCUS_AFTER_KEEP_MAX_MS`, leaving focus as the browser has it.
+ */
+export declare const FOCUS_AFTER_KEEP_INTERVAL_MS = 40;
+export declare const FOCUS_AFTER_KEEP_MAX_MS = 2000;
+type FocusAfterKeepDocument = FocusReturnDocument & Pick<Document, "querySelectorAll">;
+/**
+ * Start returning focus for the offer `offerId`, whose link was given back.
+ * Returns a function that stops it (the panel unmounted, or a newer question).
+ */
+export declare function startFocusReturnAfterKeep(doc: FocusAfterKeepDocument, offerId: string): () => void;
+export {};

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

@@ -0,0 +1,18 @@
+import { focusWasDropped as e, returnFocusTo as t } from "../../hooks/useReturnFocus.js";
+//#region src/shared/assistant/ui/leaveConfirmFocus.ts
+var n = 40, r = 2e3, i = "assistant-ui-offer-link", a = "assistant-input", o = "assistant-leave-confirm-dialog", s = (e, t) => Array.from(e.querySelectorAll(`[data-testid="${t}"]`));
+function c(n, r) {
+	let c = Date.now(), l = null, u = !1, d = () => {
+		l = null, !u && (Date.now() - c > 2e3 || (() => {
+			if (s(n, o).length > 0) return !1;
+			if (!e(n)) return !0;
+			let c = s(n, i).find((e) => e.getAttribute("data-offer-id") === r), l = s(n, a)[0];
+			return t(n, [c, l]) !== null;
+		})() || (l = setTimeout(d, 40)));
+	};
+	return l = setTimeout(d, 40), () => {
+		u = !0, l !== null && clearTimeout(l), l = null;
+	};
+}
+//#endregion
+export { n as FOCUS_AFTER_KEEP_INTERVAL_MS, r as FOCUS_AFTER_KEEP_MAX_MS, c as startFocusReturnAfterKeep };

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

@@ -0,0 +1,49 @@
+import { UnsavedChange } from '../../navigation/unsavedChanges';
+import { AssistantNavigate, AssistantNavigateSurface } from './AssistantMarkdownRenderer';
+/**
+ * ★ BOFF-8060 (N4 tap-confirm): "Open page" must not silently discard a draft.
+ *
+ * The leave-page guard (`useUnsavedChanges`) refuses a move the ASSISTANT starts
+ * and never one the PERSON starts, so tapping "Open {page}" (or a link in a
+ * reply, or "Connect a source") from a dirty editor threw the draft away
+ * without a word. This wraps the panel's navigator so that a person's tap, with
+ * something unsaved on the page, asks first:
+ *
+ * ```
+ * initiator is not "person"      -> inner(...)         (the N4 refusal, unchanged)
+ * nothing unsaved                -> inner(...)         (SYNC, exactly as before)
+ * target opens in a new tab      -> inner(...)         (the draft is not touched)
+ * otherwise                      -> ask; Keep -> { kind: "kept" }, Leave -> inner(...)
+ * ```
+ *
+ * Pure: how the question is put to the person (`ask`) is injected, so every
+ * rule is tested without a DOM. The dialog lives in `leaveConfirm.tsx`.
+ *
+ * ★ Fail-safe in one direction only: anything that is not an explicit "leave"
+ * (a rejected or throwing `ask`, an unmounted dialog) keeps the draft.
+ */
+export type LeaveDecision = "leave" | "keep";
+/**
+ * What a decision reports, for counting. ★ Never a label, a path or any text:
+ * `editorIds` are the stable ids products register (`dashboard-editor`), not
+ * what the person calls them.
+ */
+export interface LeaveConfirmReport {
+    decision: "left" | "kept";
+    surface: AssistantNavigateSurface | "unknown";
+    editorCount: number;
+    editorIds: readonly string[];
+}
+export interface LeaveConfirmDeps {
+    /** The unsaved changes on the page right now (`listUnsavedChanges`). */
+    list: () => UnsavedChange[];
+    /**
+     * Does this path open in a new tab / outside the shell? Then the draft is
+     * left alone and nothing is asked. Absent: every path asks (the safe side).
+     */
+    isShellLess?: (path: string) => boolean;
+    /** Put the question to the person. Resolves once they have decided. */
+    ask: (unsaved: readonly UnsavedChange[]) => Promise<LeaveDecision>;
+    report?: (report: LeaveConfirmReport) => void;
+}
+export declare function createLeaveConfirmNavigate(inner: AssistantNavigate, deps: LeaveConfirmDeps): AssistantNavigate;

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

@@ -0,0 +1,33 @@
+//#region src/shared/assistant/ui/leaveConfirmNavigate.ts
+var e = { kind: "kept" };
+function t(t, n) {
+	let r = !1;
+	return (i, a, o) => {
+		if (a !== "person") return t(i, a, o);
+		let s = n.list();
+		if (s.length === 0 || n.isShellLess?.(i)) return t(i, a, o);
+		if (r) return e;
+		r = !0;
+		let c = o?.surface ?? "unknown", l = s.map((e) => e.id), u;
+		try {
+			u = n.ask(s);
+		} catch {
+			u = Promise.resolve("keep");
+		}
+		return u.catch(() => "keep").then((a) => {
+			r = !1;
+			let s = a === "leave";
+			try {
+				n.report?.({
+					decision: s ? "left" : "kept",
+					surface: c,
+					editorCount: l.length,
+					editorIds: l
+				});
+			} catch {}
+			return s ? t(i, "person", o) : e;
+		});
+	};
+}
+//#endregion
+export { t as createLeaveConfirmNavigate };

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

@@ -182,4 +182,3 @@ export declare function panelOwnsEscape(panel: {
     contains(node: Node | null): boolean;
     hasAttribute(name: string): boolean;
 } | null, active: Node | null, body: Node | null): boolean;
-//# sourceMappingURL=panelOverlays.d.ts.map

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

@@ -9,4 +9,3 @@ interface DropdownEscapeHandlers {
  */
 export declare function useDropdownEscape(buttonRef: RefObject<HTMLElement | null>, close: () => void): DropdownEscapeHandlers;
 export {};
-//# sourceMappingURL=useDropdownEscape.d.ts.map

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

@@ -1,4 +1,3 @@
 export declare function useOverlayFocus<T extends HTMLElement>(
 /** `data-testid` of the control that opens this overlay, for focus return. */
 returnFocusTestId?: string): import('react').RefObject<T | null>;
-//# sourceMappingURL=useOverlayFocus.d.ts.map

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

@@ -52,4 +52,3 @@ export declare function subscribeReducedMotion(onChange: () => void): () => void
  * a constant server snapshot instead.
  */
 export declare function usePrefersReducedMotion(): boolean;
-//# sourceMappingURL=usePrefersReducedMotion.d.ts.map

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

@@ -195,4 +195,3 @@ export declare function useVoiceSession({ onSubmit, latestReply, language, grace
     answerLocally: (item: VoiceAnnouncement) => void;
 };
 export {};
-//# sourceMappingURL=useVoiceSession.d.ts.map

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

@@ -58,4 +58,3 @@ export interface WriteProposalConfirmController {
     asking: boolean;
 }
 export declare function useWriteProposalConfirm(actions: WriteProposalConfirmActions): WriteProposalConfirmController;
-//# sourceMappingURL=useWriteProposalConfirm.d.ts.map

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

@@ -131,4 +131,3 @@ export declare function useWriteProposals(options: {
     /** Sandboxes a failover replaced: their cards are inert. */
     retiredSandboxes: ReadonlySet<string>;
 };
-//# sourceMappingURL=useWriteProposals.d.ts.map

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

@@ -30,4 +30,3 @@ interface Props {
 }
 export declare const AssistantVoiceOrb: FC<Props>;
 export {};
-//# sourceMappingURL=AssistantVoiceOrb.d.ts.map

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

@@ -120,4 +120,3 @@ interface Props {
  */
 export declare const AssistantVoiceSession: FC<Props>;
 export {};
-//# sourceMappingURL=AssistantVoiceSession.d.ts.map

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

@@ -20,4 +20,3 @@ export declare const AssistantVoiceSessionButton: FC<{
     onStart: () => void;
     disabled?: boolean;
 }>;
-//# sourceMappingURL=AssistantVoiceSessionButton.d.ts.map

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

@@ -24,4 +24,3 @@ interface Props {
  */
 export declare const HandsFreePrivacyNotice: FC<Props>;
 export {};
-//# sourceMappingURL=HandsFreePrivacyNotice.d.ts.map

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

@@ -62,4 +62,3 @@ interface Props {
 export declare const CAPTION_SCROLL_ATTR = "data-caption-scroll";
 export declare const VoiceCaption: FC<Props>;
 export {};
-//# sourceMappingURL=VoiceCaption.d.ts.map

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

@@ -40,4 +40,3 @@ interface Props {
 }
 export declare const VoiceConversationView: FC<Props>;
 export {};
-//# sourceMappingURL=VoiceConversationView.d.ts.map

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

@@ -55,4 +55,3 @@ interface Props {
 }
 export declare const VoiceMiniController: FC<Props>;
 export {};
-//# sourceMappingURL=VoiceMiniController.d.ts.map

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

@@ -51,4 +51,3 @@ interface Props {
 }
 export declare const VoiceStage: FC<Props>;
 export {};
-//# sourceMappingURL=VoiceStage.d.ts.map

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

@@ -59,4 +59,3 @@ export declare const VoiceStatusText: FC<{
     rotating?: boolean;
     className: string;
 }>;
-//# sourceMappingURL=VoiceStatusText.d.ts.map

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

@@ -64,4 +64,3 @@ interface Props {
 }
 export declare const VoiceTranscriptDrawer: FC<Props>;
 export {};
-//# sourceMappingURL=VoiceTranscriptDrawer.d.ts.map

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

@@ -36,4 +36,3 @@ interface Props {
 }
 export declare const VoiceWaveform: FC<Props>;
 export {};
-//# sourceMappingURL=VoiceWaveform.d.ts.map

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

@@ -54,4 +54,3 @@ export declare function escapeBelongsToLayerAbove(input: {
     session: Element | null;
     doc: Pick<Document, "activeElement" | "querySelectorAll">;
 }): boolean;
-//# sourceMappingURL=voiceSessionEscape.d.ts.map

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

@@ -93,4 +93,3 @@ export interface WriteProposalConfirmState {
  * unknown execution state is fenced, so every doubt removes the button.
  */
 export declare function writeProposalConfirmState(view: WriteProposalView, capabilities: SandboxWriteCapabilities | null | undefined): WriteProposalConfirmState;
-//# sourceMappingURL=writeProposalPresentation.d.ts.map

package/dist/shared/assistant/uiActions/actOnResolve.d.ts

@@ -105,4 +105,3 @@ export type ActOnResolveDecision =
 };
 /** The act-on-resolve decision (design §8). Every guard, in order; the first that fails holds. */
 export declare function decideActOnResolve(input: ActOnResolveInput): ActOnResolveDecision;
-//# sourceMappingURL=actOnResolve.d.ts.map

package/dist/shared/assistant/uiActions/assistantHref.d.ts

@@ -33,4 +33,3 @@ export declare function classifyAssistantHref(href: string | null | undefined, b
  * out they got it wrong.
  */
 export declare function assistantRoutePath(href: string | null | undefined, baseOrigin?: string): string | null;
-//# sourceMappingURL=assistantHref.d.ts.map

package/dist/shared/assistant/uiActions/backStack.d.ts

@@ -32,4 +32,3 @@ export declare const assistantBackStack: BackStack;
  * model.
  */
 export declare function isBackRunnable(stack: Pick<BackStack, "top">, currentPath: string, newestAssistantMessageId: string | null): boolean;
-//# sourceMappingURL=backStack.d.ts.map

package/dist/shared/assistant/uiActions/deixis.d.ts

@@ -26,4 +26,3 @@ export type ChoiceRequest =
     context: string;
 };
 export declare function parseChoice(utterance: string): ChoiceRequest | null;
-//# sourceMappingURL=deixis.d.ts.map

package/dist/shared/assistant/uiActions/entityRoutes.d.ts

@@ -46,4 +46,3 @@ export interface EntityMatch {
 export declare function matchEntityRoute(path: string, routes: readonly AssistantEntityRoute[]): EntityMatch | null;
 /** Fill a template with params, or null when one is missing or invalid. Used by record adapters. */
 export declare function fillEntityRoute(route: AssistantEntityRoute, params: Readonly<Record<string, string>>): string | null;
-//# sourceMappingURL=entityRoutes.d.ts.map

package/dist/shared/assistant/uiActions/inAppLinks.d.ts

@@ -25,4 +25,3 @@ export interface InAppLink {
 }
 export declare const LINK_TEXT_MAX = 80;
 export declare function extractInAppLinks(markdown: string): InAppLink[];
-//# sourceMappingURL=inAppLinks.d.ts.map

package/dist/shared/assistant/uiActions/linkContext.d.ts

@@ -78,4 +78,3 @@ export declare function buildNavigationContext(input: {
     /** ★ N3: the reply's live offers, already re-validated (`liveOffersFor`). */
     offers?: readonly OfferedTarget[];
 }): NavigationContext | null;
-//# sourceMappingURL=linkContext.d.ts.map

package/dist/shared/assistant/uiActions/navIntent.d.ts

@@ -55,4 +55,3 @@ export interface NavIntentTarget {
  * page the person did not name is never acted on — it stays an offer.
  */
 export declare function navIntentRelevant(intent: NavIntent, target: NavIntentTarget): boolean;
-//# sourceMappingURL=navIntent.d.ts.map

package/dist/shared/assistant/uiActions/navigateAction.d.ts

@@ -1,9 +1,9 @@
 import { AssistantNavigateAction, AssistantNavigateOfferTrigger, AssistantNavigateOutcome, AssistantNavigateVia } from '../conversation';
 import { LocalDestination } from '../localUiCommands';
-import { NavigationOutcome } from './navigationOutcome';
+import { DecidedNavigationOutcome } from './navigationOutcome';
 /** The server keeps a `localAction` of at most 1024 bytes; stay well inside it. */
 export declare const NAVIGATE_RECORD_BUDGET_BYTES = 900;
-export declare function outcomeStatus(outcome: NavigationOutcome): AssistantNavigateOutcome;
+export declare function outcomeStatus(outcome: DecidedNavigationOutcome): AssistantNavigateOutcome;
 /**
  * ★ BOFF-8060 (N1a): the history record of a navigation.
  *
@@ -16,7 +16,7 @@ export declare function buildNavigateAction(input: {
     path: string;
     alreadyHere: boolean;
     via: AssistantNavigateVia;
-    outcome?: NavigationOutcome;
+    outcome?: DecidedNavigationOutcome;
     /** ★ BOFF-8060 (N3): how an offer was accepted. Kept only with `via: "offer"`. */
     offer?: {
         trigger: AssistantNavigateOfferTrigger;
@@ -43,4 +43,3 @@ interface SurfaceMessage {
  */
 export declare function newestAssistantOnSurface(messages: readonly SurfaceMessage[], voiceSessionId: string | undefined): string | null;
 export {};
-//# sourceMappingURL=navigateAction.d.ts.map

package/dist/shared/assistant/uiActions/navigationOutcome.d.ts

@@ -1,4 +1,4 @@
-import { AssistantNavigate, AssistantNavigateInitiator } from '../ui/AssistantMarkdownRenderer';
+import { AssistantNavigate, AssistantNavigateInitiator, AssistantNavigateSurface } from '../ui/AssistantMarkdownRenderer';
 import { UnsavedChange } from '../../navigation/unsavedChanges';
 /**
  * ★ BOFF-8060 (N1a, C7): never claim success before the landing is checked.
@@ -32,7 +32,19 @@ export type NavigationOutcome = {
     unsaved?: readonly UnsavedChange[];
 } | {
     status: "unconfirmed";
+}
+/**
+ * ★ BOFF-8060 (N4 tap-confirm): the person tapped, was asked about their
+ * unsaved changes and chose to keep editing. Nothing was routed and nothing
+ * changed, so there is nothing to say and nothing to record.
+ */
+ | {
+    status: "kept";
 };
+/** An outcome that says something happened (or why it did not): everything but `kept`. */
+export type DecidedNavigationOutcome = Exclude<NavigationOutcome, {
+    status: "kept";
+}>;
 export interface NavigationDeps {
     /** The current pathname + search. */
     readPath: () => string;
@@ -45,9 +57,12 @@ export interface NavigationDeps {
     /**
      * ★ BOFF-8060 (N4): who started it. Absent means the assistant, which the
      * navigator refuses while the page holds unsaved changes; only a tap the
-     * person made on an "Open {page}" link passes `"person"`.
+     * person made on an "Open {page}" link passes `"person"`, and with unsaved
+     * changes on the page the navigator then asks first (N4 tap-confirm).
      */
     initiator?: AssistantNavigateInitiator;
+    /** Which surface the person tapped; counted, never shown. */
+    surface?: AssistantNavigateSurface;
 }
 /** Poll interval, quiet window and ceiling (ms). */
 export declare const NAVIGATION_POLL_MS = 50;
@@ -61,6 +76,11 @@ export declare function pathnameOf(value: string): string;
  * Polls every 50 ms and stops when the location has been unchanged for 250 ms
  * or 1.5 s have passed. A throttled background timer still fires (at about one
  * second), so the worst case ends by about 2.5 s.
+ *
+ * ★ BOFF-8060 (N4 tap-confirm): a navigator may answer with a PROMISE, which is
+ * how it asks the person "Leave without saving?". The wait for the answer is
+ * the person's, not the router's: the start path is read before the call, and
+ * the clock and the polling start only once the navigator has decided. A
+ * rejected promise is `not-routable`; `kept` is `{ status: "kept" }`.
  */
 export declare function runNavigation(navigate: AssistantNavigate | null, path: string, deps: NavigationDeps): Promise<NavigationOutcome>;
-//# sourceMappingURL=navigationOutcome.d.ts.map

package/dist/shared/assistant/uiActions/navigationOutcome.js

@@ -21,45 +21,55 @@ function a(t, n, r, a) {
 		landedPath: o
 	};
 }
-function o(e, t, n) {
+function o(e) {
+	return typeof e == "object" && !!e && "then" in e && typeof e.then == "function";
+}
+function s(e, t, n) {
 	if (!e) return Promise.resolve({
 		status: "refused",
 		reason: "no-router"
 	});
 	let r = n.readPath(), i;
 	try {
-		i = e(t, n.initiator ?? "assistant");
+		let r = n.initiator ?? "assistant";
+		i = n.surface ? e(t, r, { surface: n.surface }) : e(t, r);
 	} catch {
 		return Promise.resolve({
 			status: "refused",
 			reason: "not-routable"
 		});
 	}
-	return i && i.kind === "new-tab" ? Promise.resolve({ status: "new-tab" }) : i && i.kind === "refused" ? Promise.resolve(i.unsaved && i.unsaved.length > 0 ? {
+	return o(i) ? i.then((e) => c(t, r, e, n), () => ({
+		status: "refused",
+		reason: "not-routable"
+	})) : c(t, r, i, n);
+}
+function c(e, t, n, r) {
+	return n && n.kind === "kept" ? Promise.resolve({ status: "kept" }) : n && n.kind === "new-tab" ? Promise.resolve({ status: "new-tab" }) : n && n.kind === "refused" ? Promise.resolve(n.unsaved && n.unsaved.length > 0 ? {
 		status: "refused",
-		reason: i.reason,
-		unsaved: i.unsaved
+		reason: n.reason,
+		unsaved: n.unsaved
 	} : {
 		status: "refused",
-		reason: i.reason
-	}) : new Promise((e) => {
-		let i = n.now(), o = n.readPath(), s = i, c = () => {
+		reason: n.reason
+	}) : new Promise((n) => {
+		let i = r.now(), o = r.readPath(), s = i, c = () => {
 			let l;
 			try {
-				l = n.readPath();
+				l = r.readPath();
 			} catch {
-				e({ status: "unconfirmed" });
+				n({ status: "unconfirmed" });
 				return;
 			}
-			let u = n.now();
+			let u = r.now();
 			if (l !== o && (o = l, s = u), u - s >= 250 || u - i >= 1500) {
-				e(a(t, r, l, n.isShellLess));
+				n(a(e, t, l, r.isShellLess));
 				return;
 			}
-			n.schedule(c, 50);
+			r.schedule(c, 50);
 		};
-		n.schedule(c, 50);
+		r.schedule(c, 50);
 	});
 }
 //#endregion
-export { r as NAVIGATION_CEILING_MS, t as NAVIGATION_POLL_MS, n as NAVIGATION_QUIET_MS, i as pathnameOf, o as runNavigation };
+export { r as NAVIGATION_CEILING_MS, t as NAVIGATION_POLL_MS, n as NAVIGATION_QUIET_MS, i as pathnameOf, s as runNavigation };

package/dist/shared/assistant/uiActions/offerYesOnSurface.d.ts

@@ -36,4 +36,3 @@ export interface UiOfferYesOnSurface<T extends SurfaceMessage> {
     reply: T | null;
 }
 export declare function offerYesOnSurface<T extends SurfaceMessage>(session: UiOfferSession, input: UiOfferYesOnSurfaceInput<T>): UiOfferYesOnSurface<T>;
-//# sourceMappingURL=offerYesOnSurface.d.ts.map

package/dist/shared/assistant/uiActions/recordNames.d.ts

@@ -115,4 +115,3 @@ export declare function lookupNamedRecords(input: {
     nounOf: (adapter: AssistantRecordAdapter) => string;
     timeoutMs?: number;
 }): Promise<RecordPlan>;
-//# sourceMappingURL=recordNames.d.ts.map

package/dist/shared/assistant/uiActions/resolveTarget.d.ts

@@ -40,4 +40,3 @@ export interface ResolvedLinks {
     unresolved: number;
 }
 export declare function resolveInAppLinks(links: readonly InAppLink[], context: ResolveContext): ResolvedLinks;
-//# sourceMappingURL=resolveTarget.d.ts.map

package/dist/shared/assistant/uiActions/uiCatalogue.d.ts

@@ -41,4 +41,3 @@ export declare function buildUiCatalogue(destinations: readonly LocalDestination
      */
     sentBefore?: boolean;
 }): AssistantUiCatalogue | null;
-//# sourceMappingURL=uiCatalogue.d.ts.map

package/dist/shared/assistant/uiActions/uiOffers.d.ts

@@ -228,17 +228,49 @@ export interface UiOfferYesInput extends UiOfferLiveContext {
     /** The product's own write approval (`proposal-v1` or not). */
     productWriteApproval: string | null | undefined;
     /** The issuing sandbox's own `/health`, as recorded. */
-    capabilitiesOf: (sandboxId: string) => {
-        uiOffers?: boolean;
-        writeApprovalMode?: string;
-    } | null | undefined;
+    capabilitiesOf: (sandboxId: string) => UiOfferSandboxCapabilities | null | undefined;
 }
+/**
+ * The slice of a sandbox's recorded `/health` (`SandboxWriteCapabilities`) that
+ * decides whether its turns may carry offers.
+ */
+export interface UiOfferSandboxCapabilities {
+    /** `/health` `capabilities.uiOffers === 1`. */
+    uiOffers?: boolean;
+    /** `proposal-v1` only for exactly that string; the sandbox's write-approval stamp. */
+    writeApprovalMode?: string;
+    /** `/health` `capabilities.writeProposals === "v1"`: the image is 5a-aware. */
+    proposals?: boolean;
+}
+/**
+ * ★★ BOFF-8060 (N3, design §3.1): may offers be read from, and a bare "yes"
+ * accepted against, a turn sent to the sandbox that reported `capabilities`?
+ *
+ * The sandbox must serve offers (`uiOffers`) AND be 5a-aware: either it
+ * reports `writeApprovalMode: "proposal-v1"` (a Build / Take-action sandbox,
+ * stamped at provision) or it reports `writeProposals: "v1"`. The second half
+ * is what admits an ASK sandbox: Ask requests nothing about writes, carries no
+ * write-approval stamp, and so reports `legacy` whatever the client asks (the
+ * server ignores `writeApproval` on an Ask provision; measured on alpha image
+ * 2026.1007.109). Requiring `proposal-v1` alone therefore recorded no Ask or
+ * Auto-read turn and refused every typed "yes" there.
+ *
+ * ★ This is only half of "may a bare yes accept": Y1's product half, and Y2's
+ * requirement that the turn was sent in a mode that cannot write, stay in
+ * `offerYesState`; a real Build turn is write-capable, so a bare "yes" is still
+ * never an acceptance there (the offer link works).
+ *
+ * ONE function, used by the panel's turn recording and by Y1, so the two cannot
+ * disagree: a turn recorded by one and refused by the other would show a link
+ * whose typed "yes" goes to the model.
+ */
+export declare function sandboxServesUiOffers(capabilities: UiOfferSandboxCapabilities | null | undefined): boolean;
 /**
  * Whether a bare "yes" accepts an offer, for the 5a binder's precedence row
  * (design §6, guards Y1–Y6; Y7 — a bare English affirm — is the binder's).
  *
- * `acceptable` only when ALL hold: the product and the issuing sandbox are
- * proposal-v1 and the sandbox serves offers (Y1); the sandbox's transport is
+ * `acceptable` only when ALL hold: the product is proposal-v1 and the issuing
+ * sandbox serves offers and is 5a-aware (Y1, `sandboxServesUiOffers`); the sandbox's transport is
  * read AND the mode the turn was sent in cannot write (Y2); exactly one live
  * offer under the newest reply on the surface (Y3); the model asked about it
  * (Y4); the reply asked one question, last (Y5); in time, unused, resolvable
@@ -246,4 +278,3 @@ export interface UiOfferYesInput extends UiOfferLiveContext {
  * time. Everything else is `none`, and the binder keeps its 5a meaning.
  */
 export declare function offerYesState(session: UiOfferSession, input: UiOfferYesInput): UiOfferYesState;
-//# sourceMappingURL=uiOffers.d.ts.map

package/dist/shared/assistant/uiActions/uiOffers.js

@@ -173,23 +173,24 @@ function S(e) {
 	let n = t.replace(x, "");
 	return /[?؟？]$/.test(n);
 }
-function C(e, t) {
+function C(e) {
+	return e?.uiOffers === !0 && (e.writeApprovalMode === "proposal-v1" || e.proposals === !0);
+}
+function w(e, t) {
 	let n = t.newestReply;
 	if (!n) return "none";
 	let r = e.turnFor(n.id);
-	if (!r || !t.actorId || r.actorId !== t.actorId || !t.conversationId || r.conversationId !== t.conversationId || t.productWriteApproval !== "proposal-v1") return "none";
-	let i = t.capabilitiesOf(r.sandboxId);
-	if (i?.uiOffers !== !0 || i.writeApprovalMode !== "proposal-v1" || r.writeCapable !== !1 || !S(n.text)) return "none";
-	let a = e.offersFor(n.id).filter((e) => !e.used), o = e.liveOffersFor(n.id, t), s = (e) => e.transport === "read" && e.ask;
-	if (o.length === 1) {
-		let e = o[0];
-		return e && a.length === 1 && s(e.offer) ? "acceptable" : "none";
-	}
-	if (o.length === 0 && a.length === 1) {
+	if (!r || !t.actorId || r.actorId !== t.actorId || !t.conversationId || r.conversationId !== t.conversationId || t.productWriteApproval !== "proposal-v1" || !C(t.capabilitiesOf(r.sandboxId)) || r.writeCapable !== !1 || !S(n.text)) return "none";
+	let i = e.offersFor(n.id).filter((e) => !e.used), a = e.liveOffersFor(n.id, t), o = (e) => e.transport === "read" && e.ask;
+	if (a.length === 1) {
 		let e = a[0];
-		if (e && s(e) && !g(e, t.perfNow) && m(e, t.registry)) return "expired";
+		return e && i.length === 1 && o(e.offer) ? "acceptable" : "none";
+	}
+	if (a.length === 0 && i.length === 1) {
+		let e = i[0];
+		if (e && o(e) && !g(e, t.perfNow) && m(e, t.registry)) return "expired";
 	}
 	return "none";
 }
 //#endregion
-export { i as UI_OFFER_CATALOGUE_ID_PATTERN, o as UI_OFFER_CONVERSATION_ID_PATTERN, r as UI_OFFER_ID_PATTERN, t as UI_OFFER_LIFETIME_MS, e as UI_OFFER_MAX_PER_READ, a as UI_OFFER_MESSAGE_ID_PATTERN, n as UI_OFFER_SESSION_MAX, v as UiOfferSession, S as asksOneQuestionLast, C as offerYesState, p as parseUiOffers, m as resolveOffer, h as uiOfferAgeMs, y as uiOfferHintKind, g as uiOfferInTime };
+export { i as UI_OFFER_CATALOGUE_ID_PATTERN, o as UI_OFFER_CONVERSATION_ID_PATTERN, r as UI_OFFER_ID_PATTERN, t as UI_OFFER_LIFETIME_MS, e as UI_OFFER_MAX_PER_READ, a as UI_OFFER_MESSAGE_ID_PATTERN, n as UI_OFFER_SESSION_MAX, v as UiOfferSession, S as asksOneQuestionLast, w as offerYesState, p as parseUiOffers, m as resolveOffer, C as sandboxServesUiOffers, h as uiOfferAgeMs, y as uiOfferHintKind, g as uiOfferInTime };

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

@@ -105,4 +105,3 @@ export declare function retryPendingUsageReports(ledger: string, workspaceId: st
  * widget that shows `error.message` shows the same English.
  */
 export declare function usageSendRefusal(kind: UsageReportFailureKind): AssistantSendRefusal;
-//# sourceMappingURL=usageReporting.d.ts.map

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

@@ -55,4 +55,3 @@ export interface AssistantApiAccess {
     loading: boolean;
 }
 export declare function useAssistantApiAccess(workspaceId: string, userId: string | null): AssistantApiAccess;
-//# sourceMappingURL=useAssistantApiAccess.d.ts.map

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

@@ -52,4 +52,3 @@ export interface UseAssistantAttachmentsOptions {
     perFileChars?: number;
 }
 export declare function useAssistantAttachments(options?: UseAssistantAttachmentsOptions): UseAssistantAttachmentsResult;
-//# sourceMappingURL=useAssistantAttachments.d.ts.map

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

@@ -11,4 +11,3 @@ import { AssistantMode } from './types';
  * their answer; the worst case is the reprovision this was avoiding.
  */
 export declare function useAssistantHeartbeat(sessionId: string | null, mode: AssistantMode | null, isOpen: boolean): void;
-//# sourceMappingURL=useAssistantHeartbeat.d.ts.map

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

@@ -23,4 +23,3 @@ interface Options {
  */
 export declare function useAssistantKeyboardShortcuts({ panelRef, inputRef, onClose }: Options): void;
 export {};
-//# sourceMappingURL=useAssistantKeyboardShortcuts.d.ts.map

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

@@ -14,4 +14,3 @@ export declare function useAttachmentUrlResolver(): (fileId: string) => Promise<
  * the committer (and the failed rollbacks it remembers) survives re-renders.
  */
 export declare function useAttachmentCommitter(onChange: NonNullable<CommitOptions['onChange']>): AttachmentCommitter;
-//# sourceMappingURL=useAttachmentCommitter.d.ts.map