@burdenoff/fe-libs 2026.1004.2 → 2026.1004.4

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

@@ -0,0 +1,49 @@
+/**
+ * ★ BOFF-8060 (N1b, C4b-lite): product-declared ENTITY routes — pages of one
+ * record (`/bigconsole/dashboards/:id`) that no sidebar entry names, so
+ * "take me there" cannot find them in the navigation. A product declares the
+ * templates it owns; the matcher below is the only thing that ever treats a
+ * path as one.
+ *
+ * PURE: no React, no DOM. The default is NO routes, so every product behaves
+ * as before until it supplies some.
+ *
+ * ★★ WHY THE `exclude` LISTS EXIST. A template like `/healthybowl/crops/:id`
+ * also matches `/healthybowl/crops/fields`, which is a STATIC page of the
+ * router and not a crop. Every param lists the router's static siblings it must
+ * never swallow. A router guard test in each app renders every template and
+ * every static sibling to prove the two lists agree with the real router.
+ */
+export type EntityParamKind = "id" | "slug" | "int";
+export interface EntityParam {
+    kind: EntityParamKind;
+    /** Static sibling segments of the router this param must never match (case-insensitive: the router is). */
+    exclude?: readonly string[];
+}
+export interface AssistantEntityRoute {
+    /** Stable id, e.g. `bigconsole-dashboard`. The resolved target is `entity:<id>`. */
+    id: string;
+    /** A path template: `/bigconsole/dashboards/:id`. A segment starting `:` is a param. */
+    pattern: string;
+    /** One entry per param in `pattern`. */
+    params: Readonly<Record<string, EntityParam>>;
+    /**
+     * The id of a navigation entry the person must be able to SEE (the whole
+     * visible tree, groups included) for this route to resolve. Absent: a
+     * product-declared static route, which resolves for everyone who reaches it.
+     */
+    visibleWith?: string;
+    /** What the page is called in a sentence: `{ key: "entity.dashboard", fallback: "dashboard" }`. */
+    noun: {
+        key: string;
+        fallback: string;
+    };
+}
+export interface EntityMatch {
+    route: AssistantEntityRoute;
+    params: Record<string, string>;
+}
+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/entityRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityRoutes.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/uiActions/entityRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,2GAA2G;IAC3G,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,oFAAoF;IACpF,EAAE,EAAE,MAAM,CAAC;IACX,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAC9C;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mGAAmG;IACnG,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAoBD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAeD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,oBAAoB,EAAE,GACtC,WAAW,GAAG,IAAI,CA8BpB;AAED,oGAAoG;AACpG,wBAAgB,eAAe,CAC7B,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvC,MAAM,GAAG,IAAI,CAef"}

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

@@ -0,0 +1,53 @@
+//#region src/shared/assistant/uiActions/entityRoutes.ts
+var e = {
+	id: /^[A-Za-z0-9_-]{1,128}$/,
+	slug: /^[A-Za-z0-9_.-]{1,128}$/,
+	int: /^[0-9]{1,9}$/
+};
+function t(t, n) {
+	return !(!e[t].test(n) || t === "slug" && (n === "." || n === ".." || n.includes("..")));
+}
+function n(e) {
+	if (!e.startsWith("/") || e.startsWith("//") || e.includes("?") || e.includes("#") || /%(?:2f|5c|2e)/i.test(e) || e.includes("\\")) return null;
+	let t = (e.length > 1 && e.endsWith("/") ? e.slice(0, -1) : e).slice(1).split("/");
+	return t.some((e) => e === "") ? null : t;
+}
+function r(e, r) {
+	let i = n(e);
+	if (i === null) return null;
+	for (let e of r) {
+		let n = e.pattern.slice(1).split("/");
+		if (n.length !== i.length) continue;
+		let r = {}, a = !0;
+		for (let o = 0; o < n.length && a; o += 1) {
+			let s = n[o] ?? "", c = i[o] ?? "";
+			if (!s.startsWith(":")) {
+				a = s.toLowerCase() === c.toLowerCase();
+				continue;
+			}
+			let l = s.slice(1), u = e.params[l];
+			a = u !== void 0 && t(u.kind, c) && !(u.exclude ?? []).some((e) => e.toLowerCase() === c.toLowerCase()), a && (r[l] = c);
+		}
+		if (a) return {
+			route: e,
+			params: r
+		};
+	}
+	return null;
+}
+function i(e, t) {
+	let n = [];
+	for (let r of e.pattern.slice(1).split("/")) {
+		if (!r.startsWith(":")) {
+			n.push(r);
+			continue;
+		}
+		let e = t[r.slice(1)];
+		if (e === void 0) return null;
+		n.push(e);
+	}
+	let i = `/${n.join("/")}`;
+	return r(i, [e]) ? i : null;
+}
+//#endregion
+export { i as fillEntityRoute, r as matchEntityRoute };

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

@@ -0,0 +1,28 @@
+/**
+ * ★ BOFF-8060 (N1b, C3b-link): the in-app links of one assistant reply, in the
+ * order the person reads them. "Take me there" acts on exactly these.
+ *
+ * PURE: markdown text in, paths out — no React and no DOM. It parses with the
+ * parser react-markdown 10 uses (`remark-parse` + `remark-gfm`), and judges
+ * every href with the SAME functions the renderer judges it with
+ * (`assistantUrlTransform`, `classifyAssistantHref`, `assistantRoutePath`), so
+ * a link is "in-app" here exactly when the renderer draws it as an in-app
+ * anchor. A parity test renders a corpus through the real renderer and
+ * compares the two sets.
+ *
+ * What is NOT a link the person can click, and so is never acted on:
+ * - code (fenced or inline) and raw HTML — the renderer prints them as text;
+ * - an image (a picture is not a link; `![x](/a)` has no anchor);
+ * - a reference whose definition does not exist;
+ * - an href the policy blocks, or one that leaves the app (external, a
+ *   protocol-relative `//host`, `/\host`).
+ */
+export interface InAppLink {
+    /** What the link says, at most `LINK_TEXT_MAX` characters (the path when it says nothing). */
+    text: string;
+    /** The router path: pathname + search + hash, never an absolute URL. */
+    path: string;
+}
+export declare const LINK_TEXT_MAX = 80;
+export declare function extractInAppLinks(markdown: string): InAppLink[];
+//# sourceMappingURL=inAppLinks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inAppLinks.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/uiActions/inAppLinks.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,SAAS;IACxB,8FAA8F;IAC9F,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,aAAa,KAAK,CAAC;AA0DhC,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CA0B/D"}

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

@@ -0,0 +1,51 @@
+import e from "../../../node_modules/remark-parse/lib/index.js";
+import { unified as t } from "../../../node_modules/unified/lib/index.js";
+import n from "../../../node_modules/remark-gfm/lib/index.js";
+import { assistantRoutePath as r, classifyAssistantHref as i, transformAssistantUrl as a } from "./assistantHref.js";
+//#region src/shared/assistant/uiActions/inAppLinks.ts
+var o = 80, s = t().use(e).use(n), c = (e) => e.trim().replace(/\s+/g, " ").toLowerCase(), l = new Set([
+	"code",
+	"inlineCode",
+	"html",
+	"image",
+	"imageReference",
+	"definition"
+]);
+function u(e) {
+	return e.type === "text" || e.type === "inlineCode" ? e.value ?? "" : e.type === "image" || e.type === "imageReference" ? e.alt ?? "" : (e.children ?? []).map(u).join("");
+}
+function d(e, t) {
+	if (e.type === "definition" && e.identifier !== void 0 && e.url !== void 0) {
+		let n = c(e.identifier);
+		t.has(n) || t.set(n, e.url);
+	}
+	for (let n of e.children ?? []) d(n, t);
+}
+function f(e) {
+	let t = a(e, "href", "a");
+	return i(t) === "internal" ? r(t) : null;
+}
+function p(e) {
+	if (!e.trim()) return [];
+	let t = s.parse(e), n = /* @__PURE__ */ new Map();
+	d(t, n);
+	let r = [], i = /* @__PURE__ */ new Set(), a = (e) => {
+		if (l.has(e.type)) return;
+		let t;
+		if (e.type === "link" ? t = e.url : e.type === "linkReference" && e.identifier !== void 0 && (t = n.get(c(e.identifier))), t !== void 0) {
+			let n = f(t);
+			if (n !== null && !i.has(n)) {
+				i.add(n);
+				let t = u(e).replace(/\s+/g, " ").trim();
+				r.push({
+					text: (t || n).slice(0, 80),
+					path: n
+				});
+			}
+		}
+		for (let t of e.children ?? []) a(t);
+	};
+	return a(t), r;
+}
+//#endregion
+export { o as LINK_TEXT_MAX, p as extractInAppLinks };

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

@@ -0,0 +1,52 @@
+import { LocalDestination } from '../localUiCommands';
+import { ResolveContext, ResolvedLinks } from './resolveTarget';
+/**
+ * ★ BOFF-8060 (N1b): what "take me there" and "the second one" act on, built
+ * LIVE at send time from the conversation — never from render state, never
+ * from a re-query of the registry for candidates.
+ *
+ * Both are limited to the NEWEST assistant message on the surface the command
+ * came from (chat thread for a typed command, that voice session's spoken
+ * turns for a spoken one) and only while no later person message exists there.
+ * A hidden reply from another conversation, an older reply and a reply of the
+ * other surface are never read.
+ */
+export interface SurfaceMessage {
+    id: string;
+    role: string;
+    metadata?: ({
+        voice?: boolean;
+        voiceSessionId?: string;
+        localAction?: unknown;
+    } & Record<string, unknown>) | undefined;
+}
+/** The newest assistant message on the surface, or null when a person message came after it. */
+export declare function latestReplyOnSurface<T extends SurfaceMessage>(messages: readonly T[], voiceSessionId: string | undefined): T | null;
+export declare function rememberPresentedList(messageId: string, candidates: readonly LocalDestination[]): void;
+export declare const presentedListFor: (messageId: string) => LocalDestination[] | undefined;
+/** @internal for tests */
+export declare const clearPresentedLists: () => void;
+export interface PendingChoice {
+    /** One entry per line shown; null where that line can no longer be opened. null overall: unreadable (an entity list after a reload). */
+    candidates: ReadonlyArray<LocalDestination | null> | null;
+    /**
+     * The ids the list's record carries, kept so a reply that merely points at an
+     * unreadable list can keep it pending (the next pick must not reach a model
+     * that never saw the list either).
+     */
+    candidateIds: readonly string[];
+}
+export interface NavigationContext {
+    links: ResolvedLinks;
+    pendingChoice: PendingChoice | null;
+}
+/**
+ * @param text what the person SEES of the message (`spokenTurnText`), never raw
+ *   content: a link inside a tool-step description is not a link they saw.
+ */
+export declare function buildNavigationContext(input: {
+    reply: SurfaceMessage | null;
+    text: string;
+    resolve: ResolveContext;
+}): NavigationContext | null;
+//# sourceMappingURL=linkContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linkContext.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/uiActions/linkContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EACL,CAAC;QACC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5B,SAAS,CAAC;CACf;AAYD,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,cAAc,EAC3D,QAAQ,EAAE,SAAS,CAAC,EAAE,EACtB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,CAAC,GAAG,IAAI,CAQV;AAaD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,SAAS,gBAAgB,EAAE,GACtC,IAAI,CAWN;AAED,eAAO,MAAM,gBAAgB,GAC3B,WAAW,MAAM,KAChB,gBAAgB,EAAE,GAAG,SAAqC,CAAC;AAE9D,0BAA0B;AAC1B,eAAO,MAAM,mBAAmB,QAAO,IAAyB,CAAC;AAIjE,MAAM,WAAW,aAAa;IAC5B,wIAAwI;IACxI,UAAU,EAAE,aAAa,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D;;;;OAIG;IACH,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC;AAiDD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,iBAAiB,GAAG,IAAI,CAI3B"}

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

@@ -0,0 +1,60 @@
+import { isEntityTarget as e, resolveInAppLinks as t, resolveUiTarget as n } from "./resolveTarget.js";
+import { extractInAppLinks as r } from "./inAppLinks.js";
+//#region src/shared/assistant/uiActions/linkContext.ts
+var i = (e, t) => {
+	let n = e.metadata?.voice === !0;
+	return t === void 0 ? !n : n && e.metadata?.voiceSessionId === t;
+};
+function a(e, t) {
+	for (let n = e.length - 1; n >= 0; --n) {
+		let r = e[n];
+		if (!(!r || !i(r, t))) {
+			if (r.role === "user") return null;
+			if (r.role === "assistant") return r;
+		}
+	}
+	return null;
+}
+var o = 50, s = /* @__PURE__ */ new Map();
+function c(e, t) {
+	for (s.delete(e), s.set(e, t.map((e) => ({ ...e }))); s.size > o;) {
+		let e = s.keys().next();
+		if (e.done) break;
+		s.delete(e.value);
+	}
+}
+var l = (e) => s.get(e), u = () => s.clear(), d = null, f = (e) => {
+	if (d?.text === e) return d.links;
+	let t = r(e);
+	return d = {
+		text: e,
+		links: t
+	}, t;
+};
+function p(t, r) {
+	let i = t.metadata?.localAction;
+	if (typeof i != "object" || !i) return null;
+	let a = i;
+	if (a.kind !== "choose-destination") return null;
+	let o = l(t.id);
+	if (o) return {
+		candidates: o.map((t) => n(t.path, r, e(t) ? t.label : void 0)),
+		candidateIds: o.map((e) => e.id)
+	};
+	let s = Array.isArray(a.candidateIds) ? a.candidateIds : [], c = s.filter((e) => typeof e == "string"), u = s.map((e) => typeof e == "string" ? r.destinations.find((t) => t.id === e) ?? null : null);
+	return u.length === 0 || u.some((e) => e === null) ? {
+		candidates: null,
+		candidateIds: c
+	} : {
+		candidates: u,
+		candidateIds: c
+	};
+}
+function m(e) {
+	return e.reply ? {
+		links: t(f(e.text), e.resolve),
+		pendingChoice: p(e.reply, e.resolve)
+	} : null;
+}
+//#endregion
+export { m as buildNavigationContext, u as clearPresentedLists, a as latestReplyOnSurface, l as presentedListFor, c as rememberPresentedList };

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

@@ -0,0 +1,73 @@
+import { LocalDestination } from '../localUiCommands';
+import { AssistantEntityRoute } from './entityRoutes';
+/**
+ * ★ BOFF-8060 (N1b, named records): "open the Coffee Shop Sales dashboard".
+ *
+ * A PRODUCT ADAPTER knows how to look one kind of record up by name through the
+ * product's own (RBAC-filtered) API; this module is the PURE half — the grammar
+ * that recognises such a request and the plan that turns the adapters' answers
+ * into "open it", "which of these?" or "nothing found". Nothing here reaches
+ * the network.
+ *
+ * Rules that keep it safe:
+ * - an adapter can only produce a path by FILLING an entity route the product
+ *   declared (`fillEntityRoute` re-validates it), never an arbitrary string;
+ * - the route's `visibleWith` navigation entry must be in the person's visible
+ *   tree, or the adapter is not consulted at all;
+ * - no match is NOT an answer: the sentence goes to the model as before.
+ */
+export interface AssistantRecordMatch {
+    /** The route params that identify the record (`{ id: "…" }`). */
+    params: Readonly<Record<string, string>>;
+    /** The record's own name, as the person sees it in the app. */
+    name: string;
+}
+export interface AssistantRecordAdapter {
+    /** Stable id, e.g. `bigconsole-dashboard`. */
+    id: string;
+    /** What people call the kind, lower case, singular and plural: `["dashboard", "dashboards"]`. */
+    nouns: readonly string[];
+    /** The kind's name in a sentence (translated): `{ key: "entity.dashboard", fallback: "dashboard" }`. */
+    noun: {
+        key: string;
+        fallback: string;
+    };
+    /** The id of the `AssistantEntityRoute` a match opens. */
+    entityRouteId: string;
+    /**
+     * The records this person may open whose name fits `name`. Called only for a
+     * recognised request. A rejection counts as "none found"; it is aborted when
+     * the panel stops waiting.
+     */
+    find: (name: string, signal: AbortSignal) => Promise<readonly AssistantRecordMatch[]>;
+}
+export interface RecordRequest {
+    /** The name as said, lower case. */
+    name: string;
+    /** Adapters named by the sentence's noun; empty: every adapter. */
+    adapterIds: string[];
+}
+export declare function parseRecordRequest(utterance: string, adapters: readonly Pick<AssistantRecordAdapter, "id" | "nouns">[]): RecordRequest | null;
+export interface RecordAnswer {
+    adapter: Pick<AssistantRecordAdapter, "id">;
+    route: AssistantEntityRoute;
+    /** The kind's translated name. */
+    noun: string;
+    matches: readonly AssistantRecordMatch[];
+}
+export type RecordPlan = {
+    kind: "none";
+} | {
+    kind: "open";
+    destination: LocalDestination;
+} | {
+    kind: "choose";
+    /** `kinds`: the same name in different kinds of record; `records`: several of one kind. */
+    why: "kinds" | "records";
+    candidates: LocalDestination[];
+    /** The distinct kind names among the candidates, in order. */
+    nouns: string[];
+};
+export declare const RECORD_CHOICE_MAX = 4;
+export declare function planRecordResolution(name: string, answers: readonly RecordAnswer[]): RecordPlan;
+//# sourceMappingURL=recordNames.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recordNames.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/uiActions/recordNames.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG5E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,iGAAiG;IACjG,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,wGAAwG;IACxG,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,IAAI,EAAE,CACJ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AA4CD,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,IAAI,CAAC,sBAAsB,EAAE,IAAI,GAAG,OAAO,CAAC,EAAE,GAChE,aAAa,GAAG,IAAI,CA6CtB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC5C,KAAK,EAAE,oBAAoB,CAAC;IAC5B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC1C;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,gBAAgB,CAAA;CAAE,GAC/C;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,2FAA2F;IAC3F,GAAG,EAAE,OAAO,GAAG,SAAS,CAAC;IACzB,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEN,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAkBnC,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,UAAU,CA8CZ"}

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

@@ -0,0 +1,75 @@
+import { fillEntityRoute as e } from "./entityRoutes.js";
+import { ENTITY_TARGET_PREFIX as t } from "./resolveTarget.js";
+//#region src/shared/assistant/uiActions/recordNames.ts
+var n = (e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), r = new Set(/* @__PURE__ */ "it.that.this.there.here.back.them.those.one.link.page.screen.list.tab.section.view.all.my.the.new.first.second.third.fourth.last.next.previous.settings".split(".")), i = /(?:^| )(?:page|screen|list|tab|section|view|settings|menu)$/, a = 60, o = "(?:open|go to|take me to|pull up|bring up|navigate to|switch to|show me)", s = "(?:open|go to|take me to|pull up|bring up|navigate to)";
+function c(e, t) {
+	if (t.length === 0) return null;
+	let c = (e) => t.filter((t) => t.nouns.includes(e)).map((e) => e.id), l = [...new Set(t.flatMap((e) => e.nouns))].sort((e, t) => t.length - e.length), u = (e) => {
+		let t = e.trim();
+		return t.length >= 2 && t.length <= a && !r.has(t) && !i.test(t);
+	};
+	if (l.length > 0) {
+		let t = l.map((e) => n(e)).join("|"), r = RegExp(`^${o} (?:the |my )?(${t}) (?:(?:called|named) )?(.+)$`).exec(e);
+		if (r && u(r[2] ?? "")) {
+			let e = c(r[1] ?? "");
+			if (e.length > 0) return {
+				name: (r[2] ?? "").trim(),
+				adapterIds: e
+			};
+		}
+		let i = RegExp(`^${o} (?:the |my )?(.+?) (${t})$`).exec(e);
+		if (i && u(i[1] ?? "")) {
+			let e = c(i[2] ?? "");
+			if (e.length > 0) return {
+				name: (i[1] ?? "").trim(),
+				adapterIds: e
+			};
+		}
+	}
+	let d = RegExp(`^${s} (?:the |my )?(.+)$`).exec(e);
+	return d && u(d[1] ?? "") && (d[1] ?? "").length >= 3 ? {
+		name: (d[1] ?? "").trim(),
+		adapterIds: []
+	} : null;
+}
+var l = 4, u = (e) => e.normalize("NFKC").toLowerCase().replace(/[^\p{L}\p{N}\s]/gu, " ").replace(/\s+/g, " ").trim();
+function d(e, t) {
+	let n = t.split(" ");
+	return e.split(" ").every((e) => n.some((t) => t.startsWith(e)));
+}
+function f(n, r) {
+	let i = u(n);
+	if (!i) return { kind: "none" };
+	let a = [];
+	for (let n of r) for (let r of n.matches) {
+		let o = e(n.route, r.params);
+		if (o === null) continue;
+		let s = u(r.name), c = s === i;
+		!c && !d(i, s) || a.some((e) => e.destination.path === o) || a.push({
+			adapterId: n.adapter.id,
+			noun: n.noun,
+			exact: c,
+			destination: {
+				id: `${t}${n.route.id}`,
+				label: r.name.trim().slice(0, 80) || n.noun,
+				path: o,
+				context: n.noun
+			}
+		});
+	}
+	let o = a.some((e) => e.exact) ? a.filter((e) => e.exact) : a, s = o[0];
+	if (!s) return { kind: "none" };
+	if (o.length === 1) return {
+		kind: "open",
+		destination: s.destination
+	};
+	let c = new Set(o.map((e) => e.adapterId)), l = o.slice(0, 4);
+	return {
+		kind: "choose",
+		why: c.size > 1 ? "kinds" : "records",
+		candidates: l.map((e) => e.destination),
+		nouns: [...new Set(l.map((e) => e.noun))]
+	};
+}
+//#endregion
+export { l as RECORD_CHOICE_MAX, c as parseRecordRequest, f as planRecordResolution };

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

@@ -0,0 +1,43 @@
+import { LocalDestination } from '../localUiCommands';
+import { AssistantEntityRoute } from './entityRoutes';
+import { InAppLink } from './inAppLinks';
+/**
+ * ★ BOFF-8060 (N1b): which of the in-app paths a reply linked the panel may
+ * take the person to. PURE.
+ *
+ * A path resolves only to a place the person is already offered:
+ * 1. a NAVIGATION destination — what the RBAC-filtered sidebar shows
+ *    (`navDestinations`), matched by its target path or its own path;
+ * 2. a product-declared ENTITY route whose `visibleWith` navigation entry is in
+ *    the person's visible tree — or a declared static route with no
+ *    `visibleWith` (the product's reviewed decision).
+ * Anything else is "unresolved": the panel says it cannot open that link, and
+ * the person can still click it themselves.
+ */
+export interface ResolveContext {
+    destinations: readonly LocalDestination[];
+    entityRoutes?: readonly AssistantEntityRoute[] | undefined;
+    /** Every id in the person's visible navigation tree, groups and parents included. */
+    visibleNavIds: ReadonlySet<string>;
+    /** The translated noun of an entity route ("dashboard"); default: its English fallback. */
+    nounLabel?: ((noun: AssistantEntityRoute["noun"]) => string) | undefined;
+}
+/** The entity-target id prefix: `entity:<routeId>`. */
+export declare const ENTITY_TARGET_PREFIX = "entity:";
+export declare function isEntityTarget(target: Pick<LocalDestination, "id">): boolean;
+/** Every `id` in a navigation tree (the VISIBLE one), children included. */
+export declare function navEntryIds(entries: readonly {
+    id: string;
+    children?: readonly {
+        id: string;
+    }[] | undefined;
+}[]): Set<string>;
+export declare function resolveUiTarget(path: string, context: ResolveContext, linkText?: string): LocalDestination | null;
+export interface ResolvedLinks {
+    /** In reply order, de-duplicated by path. */
+    targets: LocalDestination[];
+    /** How many in-app links the reply has that did NOT resolve. */
+    unresolved: number;
+}
+export declare function resolveInAppLinks(links: readonly InAppLink[], context: ResolveContext): ResolvedLinks;
+//# sourceMappingURL=resolveTarget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveTarget.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/uiActions/resolveTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC1C,YAAY,CAAC,EAAE,SAAS,oBAAoB,EAAE,GAAG,SAAS,CAAC;IAC3D,qFAAqF;IACrF,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,2FAA2F;IAC3F,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,GAAG,SAAS,CAAC;CAC1E;AAKD,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,GAAG,OAAO,CAE5E;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,GAAG,SAAS,CAAC;CAClD,EAAE,GACF,GAAG,CAAC,MAAM,CAAC,CAkBb;AAKD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,EACvB,QAAQ,CAAC,EAAE,MAAM,GAChB,gBAAgB,GAAG,IAAI,CAgCzB;AAED,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,OAAO,EAAE,cAAc,GACtB,aAAa,CAUf"}

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

@@ -0,0 +1,49 @@
+import { matchEntityRoute as e } from "./entityRoutes.js";
+import { isCurrentPath as t } from "../localUiCommands.js";
+//#region src/shared/assistant/uiActions/resolveTarget.ts
+var n = /\[?REDACTED_[A-Z_]+\]?|%5BREDACTED_/i, r = "entity:";
+function i(e) {
+	return e.id.startsWith(r);
+}
+function a(e) {
+	let t = /* @__PURE__ */ new Set(), n = (e) => {
+		for (let r of e) t.add(r.id), r.children?.length && n(r.children);
+	};
+	return n(e), t;
+}
+var o = (e) => e.split("#")[0]?.split("?")[0] ?? e;
+function s(i, a, s) {
+	if (!i.startsWith("/") || i.startsWith("//") || n.test(i)) return null;
+	for (let e of a.destinations) {
+		if ([e.path, ...e.aliases ?? []].find((e) => t(e, i)) === void 0) continue;
+		let n = t(e.path, i);
+		return {
+			...e,
+			path: n ? i : e.path
+		};
+	}
+	let c = e(i, a.entityRoutes ?? []);
+	if (c === null) return null;
+	let { route: l } = c;
+	if (l.visibleWith !== void 0 && !a.visibleNavIds.has(l.visibleWith)) return null;
+	let u = a.nounLabel ? a.nounLabel(l.noun) : l.noun.fallback;
+	return {
+		id: `${r}${l.id}`,
+		label: (s ?? "").trim() || u,
+		path: o(i),
+		context: u
+	};
+}
+function c(e, t) {
+	let n = [], r = 0;
+	for (let i of e) {
+		let e = s(i.path, t, i.text);
+		e === null ? r += 1 : n.some((t) => t.path === e.path) || n.push(e);
+	}
+	return {
+		targets: n,
+		unresolved: r
+	};
+}
+//#endregion
+export { r as ENTITY_TARGET_PREFIX, i as isEntityTarget, a as navEntryIds, c as resolveInAppLinks, s as resolveUiTarget };

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

@@ -0,0 +1,30 @@
+import { LocalDestination } from '../localUiCommands';
+/**
+ * ★ BOFF-8060 (N1b, §4.9 — N2 plumbing, DORMANT): the pages this person may be
+ * sent to, offered to the model so a future (N2) rule can point at the right
+ * one. Nothing consumes it yet: a product must opt in
+ * (`LocalUiCommandOptions.uiCatalogue`), and an older sandbox ignores an
+ * unknown body key — the same precedent as `conversationId` and `writeReply`.
+ * The field stays labelled `source` until the N2 image is live.
+ *
+ * It is built ONLY from what the RBAC-filtered sidebar really shows: never
+ * from the optimistic list shown while permissions load, never when a
+ * permission fetch failed, and never from a simulated role's navigation.
+ */
+export interface AssistantUiCatalogueEntry {
+    id: string;
+    label: string;
+    context?: string;
+    path: string;
+}
+export interface AssistantUiCatalogue {
+    v: 1;
+    entries: AssistantUiCatalogueEntry[];
+}
+export declare const UI_CATALOGUE_MAX_ENTRIES = 120;
+export declare const UI_CATALOGUE_MAX_BYTES: number;
+export declare function buildUiCatalogue(destinations: readonly LocalDestination[], gate: {
+    permissionsSettled: boolean;
+    simulating: boolean;
+}): AssistantUiCatalogue | null;
+//# sourceMappingURL=uiCatalogue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"uiCatalogue.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/uiActions/uiCatalogue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,CAAC,EAAE,CAAC,CAAC;IACL,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC;AAED,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,sBAAsB,QAAW,CAAC;AAK/C,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,SAAS,gBAAgB,EAAE,EACzC,IAAI,EAAE;IAAE,kBAAkB,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GACzD,oBAAoB,GAAG,IAAI,CAkB7B"}

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

@@ -0,0 +1,22 @@
+//#region src/shared/assistant/uiActions/uiCatalogue.ts
+var e = 120, t = 8 * 1024, n = (e) => new TextEncoder().encode(JSON.stringify(e)).length;
+function r(e, t) {
+	if (!t.permissionsSettled || t.simulating) return null;
+	let r = [];
+	for (let t of e.slice(0, 120)) r.push({
+		id: t.id,
+		label: t.label,
+		...t.context ? { context: t.context } : {},
+		path: t.path
+	});
+	for (; r.length > 0 && n({
+		v: 1,
+		entries: r
+	}) > 8192;) r.pop();
+	return r.length > 0 ? {
+		v: 1,
+		entries: r
+	} : null;
+}
+//#endregion
+export { t as UI_CATALOGUE_MAX_BYTES, e as UI_CATALOGUE_MAX_ENTRIES, r as buildUiCatalogue };

package/dist/shared/components/assistantWidget/MessageContent.js

@@ -1,4 +1,5 @@
-import { assistantRoutePath as e, browserShouldHandle as t, classifyAssistantHref as n } from "../../assistant/ui/AssistantMarkdownRenderer.js";
+import { assistantRoutePath as e, classifyAssistantHref as t } from "../../assistant/uiActions/assistantHref.js";
+import { browserShouldHandle as n } from "../../assistant/ui/AssistantMarkdownRenderer.js";
 import { Fragment as r } from "react";
 import { Fragment as i, jsx as a } from "react/jsx-runtime";
 //#region src/shared/components/assistantWidget/MessageContent.tsx
@@ -11,12 +12,12 @@ var c = ({ content: c, onNavigate: l }) => {
 	for (let i of c.matchAll(f)) {
 		let [o, f, p] = i, m = i.index ?? 0;
 		m > d && u.push(/* @__PURE__ */ a(r, { children: c.slice(d, m) }, `t${String(d)}`));
-		let h = p ? n(p) : "blocked", g = h === "internal" ? e(p) : null, _ = h === "external" && s(p);
+		let h = p ? t(p) : "blocked", g = h === "internal" ? e(p) : null, _ = h === "external" && s(p);
 		f && p && (g || _) ? u.push(/* @__PURE__ */ a("a", {
 			href: g ?? p,
 			"data-testid": "assistant-message-link",
 			...g ? { onClick: l ? (e) => {
-				t(e) || (e.preventDefault(), l(g));
+				n(e) || (e.preventDefault(), l(g));
 			} : void 0 } : {
 				target: "_blank",
 				rel: "noopener noreferrer"