@burdenoff/microfe-ggnomad 2026.1029.3 → 2026.1030.2

package/dist/services/assistantQuota.js

@@ -0,0 +1,52 @@
+import { isQuotaExhaustedError as e } from "@burdenoff/fe-libs/shared/assistant";
+//#region src/services/assistantQuota.ts
+var t = "ggnomad", n = `${t}:quota-exhausted`, r = `${t}:ai-credits-updated`, i = 1e4, a = {
+	"ai-credits": {
+		key: "ggnomad.assistant.quota.aiCredits",
+		fallback: "Your workspace has used all of its GGNomad AI credits for this billing period, so the assistant can't answer right now. Upgrade your plan or add credits in Billing to keep using it."
+	},
+	sandbox: {
+		key: "ggnomad.assistant.quota.sandbox",
+		fallback: "Your workspace has reached its limit of assistant sandboxes on the current plan, so the assistant can't start right now. Upgrade your plan in Billing to keep using it."
+	}
+};
+function o(t) {
+	return c(t, "code").includes("QUOTA_NOT_PROVISIONED") || !e(t) ? null : s(t).some((e) => e.includes("sandbox")) ? "sandbox" : "ai-credits";
+}
+function s(e) {
+	return c(e, "quotaName");
+}
+function c(e, t, n = 0) {
+	if (n > 3 || typeof e != "object" || !e) return [];
+	let r = e, i = [], a = (e) => {
+		if (typeof e != "object" || !e) return;
+		let n = e[t];
+		typeof n == "string" && n.length > 0 && i.push(n);
+	}, o = (e) => {
+		if (Array.isArray(e)) for (let t of e) typeof t == "object" && t && a(t.extensions);
+	};
+	o(r.errors), o(r.graphQLErrors);
+	let s = r.result;
+	return typeof s == "object" && s && o(s.errors), a(r.extensions), [...i, ...c(r.cause, t, n + 1)];
+}
+var l = -Infinity;
+function u(e, t = Date.now()) {
+	return t - l < 1e4 ? !1 : (l = t, typeof window < "u" && window.dispatchEvent(new CustomEvent(n, { detail: { kind: e } })), !0);
+}
+function d(e) {
+	u(o(e) ?? "ai-credits");
+}
+function f() {
+	typeof window > "u" || window.dispatchEvent(new CustomEvent(r));
+}
+function p(e, t) {
+	let n = o(e);
+	if (!n) return e;
+	u(n);
+	let { key: r, fallback: i } = a[n], s = t?.(r, i);
+	return Error(s && s !== r ? s : i, { cause: e });
+}
+//#endregion
+export { r as AI_CREDITS_UPDATED_EVENT, i as ANNOUNCE_WINDOW_MS, t as GGNOMAD_ASSISTANT_PRODUCT, n as QUOTA_EXHAUSTED_EVENT, a as QUOTA_MESSAGES, u as announceAssistantQuotaWall, o as assistantQuotaWallOf, f as handleAssistantCreditsUpdated, d as handleAssistantQuotaExhausted, s as quotaNamesIn, p as toAssistantTurnError };
+
+//# sourceMappingURL=assistantQuota.js.map

package/dist/services/assistantQuota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantQuota.js","names":[],"sources":["../../src/services/assistantQuota.ts"],"sourcesContent":["/**\n * What the GGNomad assistant does when a quota refuses it.\n *\n * Two allowances gate the assistant, both provisioned per plan in\n * global-billing-svc: `ggnomad.ai.credits` (the per-token AI credit budget,\n * charged after each answer) and `ggnomad.sandbox.environments` (the sandbox\n * the assistant runs in). When either is used up the user must be told plainly\n * and shown the way to more, never left with a generic failure:\n *\n * - the shell's `QuotaUpgradeBridge` (ggnomad-app) listens for\n *   `ggnomad:quota-exhausted` and opens ONE upgrade dialog with GGNomad's copy;\n * - the chat itself shows an explicit \"AI credits used up\" answer instead of\n *   the gateway's raw refusal text.\n *\n * The transport can see the same wall twice in one send (the advisory credits\n * preflight and the turn itself), so the dialog is announced at most once per\n * {@link ANNOUNCE_WINDOW_MS}: one refusal, one dialog, no stacked prompts.\n */\n\nimport { isQuotaExhaustedError } from '@burdenoff/fe-libs/shared/assistant';\n\n/** The product id the shared assistant and the shell's bridge use for GGNomad. */\nexport const GGNOMAD_ASSISTANT_PRODUCT = 'ggnomad';\n\n/** Quota names in global-billing-svc that gate the GGNomad assistant. */\nexport const GGNOMAD_AI_CREDITS_QUOTA = 'ggnomad.ai.credits';\nexport const GGNOMAD_SANDBOX_QUOTA = 'ggnomad.sandbox.environments';\n\n/**\n * The shared assistant's product-namespaced window events (fe-libs\n * `quotaExhaustedEventName` / `aiCreditsUpdatedEventName`: the shared code owns\n * the mechanism, the product owns the `<product>:` namespace). The shell's\n * `QuotaUpgradeBridge` listens for the first; a credits meter for the second.\n */\nexport const QUOTA_EXHAUSTED_EVENT = `${GGNOMAD_ASSISTANT_PRODUCT}:quota-exhausted`;\nexport const AI_CREDITS_UPDATED_EVENT = `${GGNOMAD_ASSISTANT_PRODUCT}:ai-credits-updated`;\n\n/** Repeated refusals inside this window open no further dialog. */\nexport const ANNOUNCE_WINDOW_MS = 10_000;\n\nexport type AssistantQuotaWall = 'ai-credits' | 'sandbox';\n\n/** English fallbacks; the i18n keys are looked up first. */\nexport const QUOTA_MESSAGES: Record<AssistantQuotaWall, { key: string; fallback: string }> = {\n  'ai-credits': {\n    key: 'ggnomad.assistant.quota.aiCredits',\n    fallback:\n      \"Your workspace has used all of its GGNomad AI credits for this billing period, so the assistant can't answer right now. Upgrade your plan or add credits in Billing to keep using it.\",\n  },\n  sandbox: {\n    key: 'ggnomad.assistant.quota.sandbox',\n    fallback:\n      \"Your workspace has reached its limit of assistant sandboxes on the current plan, so the assistant can't start right now. Upgrade your plan in Billing to keep using it.\",\n  },\n};\n\n/**\n * Which assistant wall an error is, or null when it is not an exhausted quota.\n *\n * A quota that was never provisioned (`QUOTA_NOT_PROVISIONED`) is not\n * exhaustion: buying more would not unblock it, so it is left to the generic\n * error path rather than shown as \"credits used up\".\n */\nexport function assistantQuotaWallOf(error: unknown): AssistantQuotaWall | null {\n  if (extensionValuesIn(error, 'code').includes('QUOTA_NOT_PROVISIONED')) return null;\n  if (!isQuotaExhaustedError(error)) return null;\n  return quotaNamesIn(error).some((name) => name.includes('sandbox')) ? 'sandbox' : 'ai-credits';\n}\n\n/**\n * Every `extensions.quotaName` the gateway attached to a refusal, wherever the\n * raw-fetch transport put the GraphQL errors (`errors`, `result.errors`,\n * `graphQLErrors`, or the error's `cause`).\n */\nexport function quotaNamesIn(error: unknown): string[] {\n  return extensionValuesIn(error, 'quotaName');\n}\n\nfunction extensionValuesIn(error: unknown, key: 'quotaName' | 'code', depth = 0): string[] {\n  if (depth > 3 || error === null || typeof error !== 'object') return [];\n  const host = error as Record<string, unknown>;\n  const values: string[] = [];\n  const read = (extensions: unknown) => {\n    if (extensions === null || typeof extensions !== 'object') return;\n    const value = (extensions as Record<string, unknown>)[key];\n    if (typeof value === 'string' && value.length > 0) values.push(value);\n  };\n  const collect = (list: unknown) => {\n    if (!Array.isArray(list)) return;\n    for (const item of list) {\n      if (item !== null && typeof item === 'object') {\n        read((item as { extensions?: unknown }).extensions);\n      }\n    }\n  };\n  collect(host.errors);\n  collect(host.graphQLErrors);\n  const result = host.result;\n  if (result !== null && typeof result === 'object') {\n    collect((result as { errors?: unknown }).errors);\n  }\n  read(host.extensions);\n  return [...values, ...extensionValuesIn(host.cause, key, depth + 1)];\n}\n\nlet lastAnnouncedAt = Number.NEGATIVE_INFINITY;\n\n/** Opens the shell's upgrade dialog for this wall, at most once per window. */\nexport function announceAssistantQuotaWall(\n  wall: AssistantQuotaWall,\n  now: number = Date.now()\n): boolean {\n  if (now - lastAnnouncedAt < ANNOUNCE_WINDOW_MS) return false;\n  lastAnnouncedAt = now;\n  if (typeof window !== 'undefined') {\n    window.dispatchEvent(new CustomEvent(QUOTA_EXHAUSTED_EVENT, { detail: { kind: wall } }));\n  }\n  return true;\n}\n\n/** Test seam: forget the last announcement. */\nexport function resetAssistantQuotaAnnouncements(): void {\n  lastAnnouncedAt = Number.NEGATIVE_INFINITY;\n}\n\n/** `onQuotaExhausted` for the shared transport (the advisory credits preflight). */\nexport function handleAssistantQuotaExhausted(error: unknown): void {\n  announceAssistantQuotaWall(assistantQuotaWallOf(error) ?? 'ai-credits');\n}\n\n/** `onCreditsUpdated` for the shared transport: lets a credits meter refetch. */\nexport function handleAssistantCreditsUpdated(): void {\n  if (typeof window === 'undefined') return;\n  window.dispatchEvent(new CustomEvent(AI_CREDITS_UPDATED_EVENT));\n}\n\ntype Translate = (key: string, fallback: string) => string;\n\n/**\n * The error a failed turn rethrows. A quota wall becomes an explicit message\n * (and announces the dialog); anything else is returned unchanged.\n */\nexport function toAssistantTurnError(error: unknown, translate?: Translate): unknown {\n  const wall = assistantQuotaWallOf(error);\n  if (!wall) return error;\n  announceAssistantQuotaWall(wall);\n  const { key, fallback } = QUOTA_MESSAGES[wall];\n  const translated = translate?.(key, fallback);\n  const message = translated && translated !== key ? translated : fallback;\n  return new Error(message, { cause: error });\n}\n"],"mappings":";;AAsBA,IAAa,IAA4B,WAY5B,IAAwB,GAAG,EAA0B,mBACrD,IAA2B,GAAG,EAA0B,sBAGxD,IAAqB,KAKrB,IAAgF;CAC3F,cAAc;EACZ,KAAK;EACL,UACE;CACJ;CACA,SAAS;EACP,KAAK;EACL,UACE;CACJ;AACF;AASA,SAAgB,EAAqB,GAA2C;CAG9E,OAFI,EAAkB,GAAO,MAAM,CAAC,CAAC,SAAS,uBAAuB,KACjE,CAAC,EAAsB,CAAK,IAAU,OACnC,EAAa,CAAK,CAAC,CAAC,MAAM,MAAS,EAAK,SAAS,SAAS,CAAC,IAAI,YAAY;AACpF;AAOA,SAAgB,EAAa,GAA0B;CACrD,OAAO,EAAkB,GAAO,WAAW;AAC7C;AAEA,SAAS,EAAkB,GAAgB,GAA2B,IAAQ,GAAa;CACzF,IAAI,IAAQ,KAAuB,OAAO,KAAU,aAAnC,GAA6C,OAAO,CAAC;CACtE,IAAM,IAAO,GACP,IAAmB,CAAC,GACpB,KAAQ,MAAwB;EACpC,IAA2B,OAAO,KAAe,aAA7C,GAAuD;EAC3D,IAAM,IAAS,EAAuC;EACtD,AAAI,OAAO,KAAU,YAAY,EAAM,SAAS,KAAG,EAAO,KAAK,CAAK;CACtE,GACM,KAAW,MAAkB;EAC5B,UAAM,QAAQ,CAAI,GACvB,KAAK,IAAM,KAAQ,GACjB,AAAqB,OAAO,KAAS,YAAjC,KACF,EAAM,EAAkC,UAAU;CAGxD;CAEA,AADA,EAAQ,EAAK,MAAM,GACnB,EAAQ,EAAK,aAAa;CAC1B,IAAM,IAAS,EAAK;CAKpB,OAJuB,OAAO,KAAW,YAArC,KACF,EAAS,EAAgC,MAAM,GAEjD,EAAK,EAAK,UAAU,GACb,CAAC,GAAG,GAAQ,GAAG,EAAkB,EAAK,OAAO,GAAK,IAAQ,CAAC,CAAC;AACrE;AAEA,IAAI,IAAkB;AAGtB,SAAgB,EACd,GACA,IAAc,KAAK,IAAI,GACd;CAMT,OALI,IAAM,IAAA,MAA6C,MACvD,IAAkB,GACd,OAAO,SAAW,OACpB,OAAO,cAAc,IAAI,YAAY,GAAuB,EAAE,QAAQ,EAAE,MAAM,EAAK,EAAE,CAAC,CAAC,GAElF;AACT;AAQA,SAAgB,EAA8B,GAAsB;CAClE,EAA2B,EAAqB,CAAK,KAAK,YAAY;AACxE;AAGA,SAAgB,IAAsC;CAChD,OAAO,SAAW,OACtB,OAAO,cAAc,IAAI,YAAY,CAAwB,CAAC;AAChE;AAQA,SAAgB,EAAqB,GAAgB,GAAgC;CACnF,IAAM,IAAO,EAAqB,CAAK;CACvC,IAAI,CAAC,GAAM,OAAO;CAClB,EAA2B,CAAI;CAC/B,IAAM,EAAE,QAAK,gBAAa,EAAe,IACnC,IAAa,IAAY,GAAK,CAAQ;CAE5C,OAAW,MADK,KAAc,MAAe,IAAM,IAAa,GACtC,EAAE,OAAO,EAAM,CAAC;AAC5C"}

package/dist/services/createSandboxAssistantTransport.d.ts

@@ -3,9 +3,11 @@
  *
  * The sandbox lifecycle + poll/stream loop now lives in
  * `@burdenoff/fe-libs/shared/assistant` (one implementation for all products);
- * this is a thin wrapper. The exported name/shape are unchanged so app-shell
- * imports don't move. The public return type is a LOCALLY-declared structural
- * mirror — never re-export fe-libs types (vite-plugin-dts path rewriting).
+ * this is a thin wrapper that passes the product id, GGNomad's
+ * `gatherPageContext`, and its credit-UX callbacks. The exported name/shape are
+ * unchanged so app-shell imports don't move. The public return type is a
+ * LOCALLY-declared structural mirror — never re-export fe-libs types
+ * (vite-plugin-dts path rewriting).
  */
 interface AssistantSendArgs {
     prompt: string;

package/dist/services/createSandboxAssistantTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSandboxAssistantTransport.d.ts","sourceRoot":"","sources":["../../src/services/createSandboxAssistantTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,4BAA4B,IAAI,kBAAkB,CAMjE"}
+{"version":3,"file":"createSandboxAssistantTransport.d.ts","sourceRoot":"","sources":["../../src/services/createSandboxAssistantTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAaH,UAAU,iBAAiB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,4BAA4B,IAAI,kBAAkB,CAoCjE"}

package/dist/services/createSandboxAssistantTransport.js

@@ -1,14 +1,34 @@
 import { gatherPageContext as e } from "../utils/pageContext.js";
-import { useSandboxAssistantTransport as t } from "@burdenoff/fe-libs/shared/assistant";
+import { GGNOMAD_ASSISTANT_PRODUCT as t, handleAssistantCreditsUpdated as n, handleAssistantQuotaExhausted as r, toAssistantTurnError as i } from "./assistantQuota.js";
+import { useEffect as a, useMemo as o, useRef as s } from "react";
+import { useI18n as c } from "@burdenoff/fe-libs/shared/providers/shell/I18nProvider";
+import { useSandboxAssistantTransport as l } from "@burdenoff/fe-libs/shared/assistant";
 //#region src/services/createSandboxAssistantTransport.ts
-function n() {
-	return t({
-		product: "ggnomad",
+function u() {
+	let { t: u } = c(), d = s(u);
+	a(() => {
+		d.current = u;
+	}, [u]);
+	let f = l({
+		product: t,
 		gatherPageContext: e,
-		enableCredits: !0
+		enableCredits: !0,
+		onQuotaExhausted: r,
+		onCreditsUpdated: n
 	});
+	return o(() => ({
+		sendPrompt: async (e) => {
+			try {
+				return await f.sendPrompt(e);
+			} catch (e) {
+				throw i(e, d.current);
+			}
+		},
+		prewarm: f.prewarm,
+		suspend: f.suspend
+	}), [f]);
 }
 //#endregion
-export { n as useSandboxAssistantTransport };
+export { u as useSandboxAssistantTransport };
 
 //# sourceMappingURL=createSandboxAssistantTransport.js.map

package/dist/services/createSandboxAssistantTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"createSandboxAssistantTransport.js","names":[],"sources":["../../src/services/createSandboxAssistantTransport.ts"],"sourcesContent":["/**\n * ggnomad adapter for the shared fe-libs AssistantWidget transport.\n *\n * The sandbox lifecycle + poll/stream loop now lives in\n * `@burdenoff/fe-libs/shared/assistant` (one implementation for all products);\n * this is a thin wrapper. The exported name/shape are unchanged so app-shell\n * imports don't move. The public return type is a LOCALLY-declared structural\n * mirror — never re-export fe-libs types (vite-plugin-dts path rewriting).\n */\n\nimport { useSandboxAssistantTransport as useSharedTransport } from '@burdenoff/fe-libs/shared/assistant';\nimport { gatherPageContext } from '@/utils/pageContext';\n\ninterface AssistantSendArgs {\n  prompt: string;\n  onProgress: (partialText: string) => void;\n  signal: AbortSignal;\n}\n\nexport interface AssistantTransport {\n  sendPrompt: (args: AssistantSendArgs) => Promise<{ text: string }>;\n  prewarm?: (level?: 'probe' | 'full') => void;\n  suspend?: () => void;\n}\n\nexport function useSandboxAssistantTransport(): AssistantTransport {\n  return useSharedTransport({\n    product: 'ggnomad',\n    gatherPageContext: gatherPageContext,\n    enableCredits: true,\n  });\n}\n"],"mappings":";;;AAyBA,SAAgB,IAAmD;CACjE,OAAO,EAAmB;EACxB,SAAS;EACU;EACnB,eAAe;CACjB,CAAC;AACH"}
+{"version":3,"file":"createSandboxAssistantTransport.js","names":[],"sources":["../../src/services/createSandboxAssistantTransport.ts"],"sourcesContent":["/**\n * ggnomad adapter for the shared fe-libs AssistantWidget transport.\n *\n * The sandbox lifecycle + poll/stream loop now lives in\n * `@burdenoff/fe-libs/shared/assistant` (one implementation for all products);\n * this is a thin wrapper that passes the product id, GGNomad's\n * `gatherPageContext`, and its credit-UX callbacks. The exported name/shape are\n * unchanged so app-shell imports don't move. The public return type is a\n * LOCALLY-declared structural mirror — never re-export fe-libs types\n * (vite-plugin-dts path rewriting).\n */\n\nimport { useEffect, useMemo, useRef } from 'react';\nimport { useSandboxAssistantTransport as useSharedTransport } from '@burdenoff/fe-libs/shared/assistant';\nimport { useI18n } from '@burdenoff/fe-libs/shared/providers/shell/I18nProvider';\nimport { gatherPageContext } from '@/utils/pageContext';\nimport {\n  GGNOMAD_ASSISTANT_PRODUCT,\n  handleAssistantCreditsUpdated,\n  handleAssistantQuotaExhausted,\n  toAssistantTurnError,\n} from './assistantQuota';\n\ninterface AssistantSendArgs {\n  prompt: string;\n  onProgress: (partialText: string) => void;\n  signal: AbortSignal;\n}\n\nexport interface AssistantTransport {\n  sendPrompt: (args: AssistantSendArgs) => Promise<{ text: string }>;\n  prewarm?: (level?: 'probe' | 'full') => void;\n  suspend?: () => void;\n}\n\nexport function useSandboxAssistantTransport(): AssistantTransport {\n  const { t: translate } = useI18n();\n  // The transport is built once per identity; read the current translator late.\n  const translateRef = useRef(translate);\n  useEffect(() => {\n    translateRef.current = translate;\n  }, [translate]);\n\n  const shared = useSharedTransport({\n    product: GGNOMAD_ASSISTANT_PRODUCT,\n    gatherPageContext,\n    enableCredits: true,\n    // The advisory preflight saw an exhausted allowance: open the shell's\n    // upgrade dialog (QuotaUpgradeBridge in ggnomad-app).\n    onQuotaExhausted: handleAssistantQuotaExhausted,\n    // A turn was charged: a credits meter listening on\n    // `ggnomad:ai-credits-updated` refetches its balance.\n    onCreditsUpdated: handleAssistantCreditsUpdated,\n  });\n\n  return useMemo<AssistantTransport>(\n    () => ({\n      sendPrompt: async (args) => {\n        try {\n          return await shared.sendPrompt(args);\n        } catch (error) {\n          // A refused turn says why in the chat (\"AI credits used up\") rather\n          // than surfacing the gateway's raw refusal text.\n          throw toAssistantTurnError(error, translateRef.current);\n        }\n      },\n      prewarm: shared.prewarm,\n      suspend: shared.suspend,\n    }),\n    [shared]\n  );\n}\n"],"mappings":";;;;;;AAmCA,SAAgB,IAAmD;CACjE,IAAM,EAAE,GAAG,MAAc,EAAQ,GAE3B,IAAe,EAAO,CAAS;CACrC,QAAgB;EACd,EAAa,UAAU;CACzB,GAAG,CAAC,CAAS,CAAC;CAEd,IAAM,IAAS,EAAmB;EAChC,SAAS;EACT;EACA,eAAe;EAGf,kBAAkB;EAGlB,kBAAkB;CACpB,CAAC;CAED,OAAO,SACE;EACL,YAAY,OAAO,MAAS;GAC1B,IAAI;IACF,OAAO,MAAM,EAAO,WAAW,CAAI;GACrC,SAAS,GAAO;IAGd,MAAM,EAAqB,GAAO,EAAa,OAAO;GACxD;EACF;EACA,SAAS,EAAO;EAChB,SAAS,EAAO;CAClB,IACA,CAAC,CAAM,CACT;AACF"}

package/dist/utils/pageContext.d.ts

@@ -5,7 +5,20 @@
  * floating assistant can answer "this page" / "current" questions and run
  * operations scoped to the screen the user is looking at.
  */
-export interface PageContext {
+/**
+ * What the assistant is told about the page.
+ *
+ * A `type` alias rather than an interface so it stays assignable to the shared
+ * transport's index-signature `PageContext`. Every key here is on the agent's
+ * `ALLOWED_CONTEXT_KEYS` list (ai-assistant `src/context-loader.ts`). Keys off
+ * that list are transmitted and then dropped, so the platform contract
+ * (HOW_TO_INTEGRATE_AI_ASSISTANT.md, Step 3) forbids sending `userAgent`,
+ * `timestamp`, search text or anything else that would not be used.
+ *
+ * The key is `currentUrl`, never `activeUrl`: the agent silently drops
+ * `activeUrl`.
+ */
+export type PageContext = {
     currentUrl: string;
     currentPage: string;
     entityType?: string;
@@ -13,16 +26,57 @@ export interface PageContext {
     platform: string;
     version: string;
     viewportSize: string;
-    userAgent: string;
-    timestamp: string;
+};
+/**
+ * Every page-context entity type the assistant can receive from GGNomad.
+ *
+ * Each one is a record `wspace-ggnomad-svc` owns, with a single-record read the
+ * assistant's GGNomad guide names (ai-assistant
+ * `context/api-calls/products/ggnomad.md`, "Page context"). Keep the two in
+ * step: the guide's tests pin this exact list.
+ */
+export declare const GGNOMAD_ENTITY_TYPES: readonly ["GGNOMAD_PROPERTY", "GGNOMAD_TOUR", "GGNOMAD_ACTIVITY", "GGNOMAD_EVENT", "GGNOMAD_TRIP_PLAN", "GGNOMAD_BOOKING", "GGNOMAD_PROVIDER"];
+export type GGNomadEntityType = (typeof GGNOMAD_ENTITY_TYPES)[number];
+/** Where a page's entity id comes from: a route segment, or the `?id=` a list page writes. */
+type EntitySource = 'path' | 'query';
+interface GGNomadPage {
+    /** The route as `GGNomadRoutes` registers it, relative to the MFE's base path. */
+    route: string;
+    /** Present when the page can identify one record. */
+    entity?: {
+        type: GGNomadEntityType;
+        source: EntitySource;
+    };
 }
-interface ConversationContextShape {
-    entityType?: string;
+/**
+ * Every page `GGNomadRoutes` registers, in match order (literal routes before
+ * the parameterised routes they would otherwise shadow).
+ *
+ * Detail pages carry their record in the path. The bookings and
+ * provider-analytics pages focus a record in place and write it to `?id=`
+ * through `useFocusedRecordParam` (`src/ggnomad/hooks/useFocusedRecordParam.ts`).
+ * The public storefront (`store/:slug`) is addressed by slug, not by a record
+ * id, so it sends no entity.
+ */
+export declare const GGNOMAD_PAGES: readonly GGNomadPage[];
+/** The shell mounts the MFE at `/ggnomad` (ggnomad-app `src/routes/AppRoutes.tsx`). */
+export declare const GGNOMAD_BASE_PATH = "/ggnomad";
+export interface GGNomadConversationContext {
+    /** The matched route, e.g. `ggnomad/hospitality/:id`; ids never appear here. */
+    currentPage: string;
+    entityType?: GGNomadEntityType;
     entityId?: string;
-    activeTab?: string;
-    metadata?: Record<string, unknown>;
 }
+/**
+ * Resolves the page and, where the page identifies one record, its entity type
+ * and id.
+ *
+ * Paths outside the MFE's base path (shell pages such as `/billing`) resolve to
+ * their first segment with no entity. The search string is read only for the
+ * `?id=` of a focused record; free-text search terms and other parameters are
+ * never forwarded (they can carry guest names or other personal data).
+ */
+export declare function resolveGGNomadConversationContext(pathname: string, search: string, basePath?: string): GGNomadConversationContext;
 export declare function gatherPageContext(): PageContext;
-export declare function resolveGGNomadConversationContext(pathname: string, search: string): ConversationContextShape;
 export {};
 //# sourceMappingURL=pageContext.d.ts.map

package/dist/utils/pageContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pageContext.d.ts","sourceRoot":"","sources":["../../src/utils/pageContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,wBAAwB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAoB/C;AAMD,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,wBAAwB,CAoC1B"}
+{"version":3,"file":"pageContext.d.ts","sourceRoot":"","sources":["../../src/utils/pageContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,gJAQvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,8FAA8F;AAC9F,KAAK,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAErC,UAAU,WAAW;IACnB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,YAAY,CAAA;KAAE,CAAC;CAC5D;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAyB/C,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAgCD;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAA0B,GACnC,0BAA0B,CAyB5B;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAe/C"}

package/dist/utils/pageContext.js

@@ -1,50 +1,125 @@
 //#region src/utils/pageContext.ts
-function e() {
-	let e = window.location.href, t = window.location.pathname.split("/").filter(Boolean).slice(0, 3).join("/") || "home", r = n(window.location.pathname, window.location.search);
-	return {
-		currentUrl: e,
-		currentPage: t,
-		entityType: r.entityType,
-		entityId: r.entityId,
-		platform: "ggnomad",
-		version: "2026.420.95",
-		viewportSize: `${window.innerWidth}x${window.innerHeight}`,
-		userAgent: navigator.userAgent,
-		timestamp: (/* @__PURE__ */ new Date()).toISOString()
-	};
+var e = [
+	{ route: "" },
+	{ route: "search" },
+	{ route: "travel" },
+	{ route: "hospitality" },
+	{
+		route: "hospitality/:id",
+		entity: {
+			type: "GGNOMAD_PROPERTY",
+			source: "path"
+		}
+	},
+	{ route: "tourism" },
+	{
+		route: "tourism/tours/:id",
+		entity: {
+			type: "GGNOMAD_TOUR",
+			source: "path"
+		}
+	},
+	{
+		route: "tourism/activities/:id",
+		entity: {
+			type: "GGNOMAD_ACTIVITY",
+			source: "path"
+		}
+	},
+	{ route: "entertainment" },
+	{
+		route: "entertainment/:id",
+		entity: {
+			type: "GGNOMAD_EVENT",
+			source: "path"
+		}
+	},
+	{
+		route: "bookings",
+		entity: {
+			type: "GGNOMAD_BOOKING",
+			source: "query"
+		}
+	},
+	{ route: "travel-policy" },
+	{ route: "operations" },
+	{ route: "favorites" },
+	{ route: "provider" },
+	{
+		route: "provider/analytics",
+		entity: {
+			type: "GGNOMAD_PROVIDER",
+			source: "query"
+		}
+	},
+	{
+		route: "provider/:providerId/storefront",
+		entity: {
+			type: "GGNOMAD_PROVIDER",
+			source: "path"
+		}
+	},
+	{ route: "store/:slug" },
+	{ route: "analytics" },
+	{ route: "trips" },
+	{
+		route: "trips/:id",
+		entity: {
+			type: "GGNOMAD_TRIP_PLAN",
+			source: "path"
+		}
+	}
+], t = "/ggnomad", n = /^[A-Za-z0-9_-]{1,128}$/;
+function r(e) {
+	try {
+		return decodeURIComponent(e);
+	} catch {
+		return null;
+	}
 }
-function t(e, t) {
-	return t.match(e);
+function i(e, t) {
+	let n = e === "" ? [] : e.split("/");
+	if (n.length !== t.length) return;
+	let i = null;
+	for (let e = 0; e < n.length; e += 1) {
+		let a = n[e], o = t[e];
+		if (a === void 0 || o === void 0) return;
+		if (a.startsWith(":")) i = r(o);
+		else if (a !== o) return;
+	}
+	return i;
 }
-function n(e, n) {
-	let r = new URLSearchParams(n);
-	for (let [n, r] of [
-		[/^\/ggnomad\/hospitality\/([^/]+)$/, "GGNOMAD_PROPERTY"],
-		[/^\/ggnomad\/tourism\/tours\/([^/]+)$/, "GGNOMAD_TOUR"],
-		[/^\/ggnomad\/tourism\/activities\/([^/]+)$/, "GGNOMAD_ACTIVITY"],
-		[/^\/ggnomad\/entertainment\/([^/]+)$/, "GGNOMAD_EVENT"],
-		[/^\/ggnomad\/trips\/([^/]+)$/, "GGNOMAD_TRIP_PLAN"]
-	]) {
-		let i = t(n, e);
-		if (i) return {
-			entityType: r,
-			entityId: i[1],
-			metadata: { routePattern: n.source }
+function a(r, a, o = t) {
+	let s = o.replace(/\/+$/, ""), c = r.replace(/\/+$/, "") || "/", l = s.replace(/^\/+/, "");
+	if (c !== s && !c.startsWith(`${s}/`)) return { currentPage: c.split("/").filter(Boolean)[0] ?? "home" };
+	let u = c.slice(s.length).split("/").filter(Boolean);
+	for (let t of e) {
+		let e = i(t.route, u);
+		if (e === void 0) continue;
+		let r = t.route ? `${l}/${t.route}` : l;
+		if (!t.entity) return { currentPage: r };
+		let o = t.entity.source === "path" ? e : new URLSearchParams(a).get("id");
+		return !o || !n.test(o) ? { currentPage: r } : {
+			currentPage: r,
+			entityType: t.entity.type,
+			entityId: o
 		};
 	}
-	let i = r.get("tab") ?? (() => {
-		let t = e.split("/").filter(Boolean);
-		return t.length > 2 ? t[t.length - 1] : void 0;
-	})();
+	return { currentPage: l };
+}
+function o() {
+	let { origin: e, pathname: t, search: n } = window.location, r = a(t, n);
 	return {
-		activeTab: i ?? void 0,
-		metadata: {
-			...i ? { activeTab: i } : {},
-			...r.get("q") ? { searchQuery: r.get("q") } : {}
-		}
+		currentUrl: `${e}${t}`,
+		currentPage: r.currentPage,
+		entityType: r.entityType,
+		entityId: r.entityId,
+		platform: "ggnomad",
+		version: "2026.420.95",
+		viewportSize: `${window.innerWidth}x${window.innerHeight}`
 	};
 }
 //#endregion
-export { e as gatherPageContext, n as resolveGGNomadConversationContext };
+export { t as GGNOMAD_BASE_PATH, e as GGNOMAD_PAGES, o as gatherPageContext, a as resolveGGNomadConversationContext };
 
 //# sourceMappingURL=pageContext.js.map

package/dist/utils/pageContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"pageContext.js","names":[],"sources":["../../src/utils/pageContext.ts"],"sourcesContent":["/**\n * Page context gathering for the GGNomad AI assistant.\n *\n * Captures the user's current browser context (URL, route, entity) so the\n * floating assistant can answer \"this page\" / \"current\" questions and run\n * operations scoped to the screen the user is looking at.\n */\n\nexport interface PageContext {\n  currentUrl: string;\n  currentPage: string;\n  entityType?: string;\n  entityId?: string;\n  platform: string;\n  version: string;\n  viewportSize: string;\n  userAgent: string;\n  timestamp: string;\n}\n\ninterface ConversationContextShape {\n  entityType?: string;\n  entityId?: string;\n  activeTab?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport function gatherPageContext(): PageContext {\n  const url = window.location.href;\n  const pathSegments = window.location.pathname.split('/').filter(Boolean);\n  const currentPage = pathSegments.slice(0, 3).join('/') || 'home';\n  const entity = resolveGGNomadConversationContext(\n    window.location.pathname,\n    window.location.search\n  );\n\n  return {\n    currentUrl: url,\n    currentPage,\n    entityType: entity.entityType,\n    entityId: entity.entityId,\n    platform: 'ggnomad',\n    version: import.meta.env.VITE_APP_VERSION ?? '2026.420.95',\n    viewportSize: `${window.innerWidth}x${window.innerHeight}`,\n    userAgent: navigator.userAgent,\n    timestamp: new Date().toISOString(),\n  };\n}\n\nfunction matchPath(pattern: RegExp, pathname: string): RegExpMatchArray | null {\n  return pathname.match(pattern);\n}\n\nexport function resolveGGNomadConversationContext(\n  pathname: string,\n  search: string\n): ConversationContextShape {\n  const params = new URLSearchParams(search);\n\n  const directMatches: Array<[RegExp, string]> = [\n    [/^\\/ggnomad\\/hospitality\\/([^/]+)$/, 'GGNOMAD_PROPERTY'],\n    [/^\\/ggnomad\\/tourism\\/tours\\/([^/]+)$/, 'GGNOMAD_TOUR'],\n    [/^\\/ggnomad\\/tourism\\/activities\\/([^/]+)$/, 'GGNOMAD_ACTIVITY'],\n    [/^\\/ggnomad\\/entertainment\\/([^/]+)$/, 'GGNOMAD_EVENT'],\n    [/^\\/ggnomad\\/trips\\/([^/]+)$/, 'GGNOMAD_TRIP_PLAN'],\n  ];\n\n  for (const [pattern, entityType] of directMatches) {\n    const match = matchPath(pattern, pathname);\n    if (match) {\n      return {\n        entityType,\n        entityId: match[1],\n        metadata: { routePattern: pattern.source },\n      };\n    }\n  }\n\n  const activeTab =\n    params.get('tab') ??\n    (() => {\n      const segments = pathname.split('/').filter(Boolean);\n      return segments.length > 2 ? segments[segments.length - 1] : undefined;\n    })();\n\n  return {\n    activeTab: activeTab ?? undefined,\n    metadata: {\n      ...(activeTab ? { activeTab } : {}),\n      ...(params.get('q') ? { searchQuery: params.get('q') } : {}),\n    },\n  };\n}\n"],"mappings":";AA2BA,SAAgB,IAAiC;CAC/C,IAAM,IAAM,OAAO,SAAS,MAEtB,IADe,OAAO,SAAS,SAAS,MAAM,GAAG,CAAC,CAAC,OAAO,OAC5C,CAAA,CAAa,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,QACpD,IAAS,EACb,OAAO,SAAS,UAChB,OAAO,SAAS,MAClB;CAEA,OAAO;EACL,YAAY;EACZ;EACA,YAAY,EAAO;EACnB,UAAU,EAAO;EACjB,UAAU;EACV,SAA6C;EAC7C,cAAc,GAAG,OAAO,WAAW,GAAG,OAAO;EAC7C,WAAW,UAAU;EACrB,4BAAW,IAAI,KAAK,EAAA,CAAE,YAAY;CACpC;AACF;AAEA,SAAS,EAAU,GAAiB,GAA2C;CAC7E,OAAO,EAAS,MAAM,CAAO;AAC/B;AAEA,SAAgB,EACd,GACA,GAC0B;CAC1B,IAAM,IAAS,IAAI,gBAAgB,CAAM;CAUzC,KAAK,IAAM,CAAC,GAAS,MAAe;EAPlC,CAAC,qCAAqC,kBAAkB;EACxD,CAAC,wCAAwC,cAAc;EACvD,CAAC,6CAA6C,kBAAkB;EAChE,CAAC,uCAAuC,eAAe;EACvD,CAAC,+BAA+B,mBAAmB;CAGjB,GAAe;EACjD,IAAM,IAAQ,EAAU,GAAS,CAAQ;EACzC,IAAI,GACF,OAAO;GACL;GACA,UAAU,EAAM;GAChB,UAAU,EAAE,cAAc,EAAQ,OAAO;EAC3C;CAEJ;CAEA,IAAM,IACJ,EAAO,IAAI,KAAK,YACT;EACL,IAAM,IAAW,EAAS,MAAM,GAAG,CAAC,CAAC,OAAO,OAAO;EACnD,OAAO,EAAS,SAAS,IAAI,EAAS,EAAS,SAAS,KAAK,KAAA;CAC/D,EAAA,CAAG;CAEL,OAAO;EACL,WAAW,KAAa,KAAA;EACxB,UAAU;GACR,GAAI,IAAY,EAAE,aAAU,IAAI,CAAC;GACjC,GAAI,EAAO,IAAI,GAAG,IAAI,EAAE,aAAa,EAAO,IAAI,GAAG,EAAE,IAAI,CAAC;EAC5D;CACF;AACF"}
+{"version":3,"file":"pageContext.js","names":[],"sources":["../../src/utils/pageContext.ts"],"sourcesContent":["/**\n * Page context gathering for the GGNomad AI assistant.\n *\n * Captures the user's current browser context (URL, route, entity) so the\n * floating assistant can answer \"this page\" / \"current\" questions and run\n * operations scoped to the screen the user is looking at.\n */\n\n/**\n * What the assistant is told about the page.\n *\n * A `type` alias rather than an interface so it stays assignable to the shared\n * transport's index-signature `PageContext`. Every key here is on the agent's\n * `ALLOWED_CONTEXT_KEYS` list (ai-assistant `src/context-loader.ts`). Keys off\n * that list are transmitted and then dropped, so the platform contract\n * (HOW_TO_INTEGRATE_AI_ASSISTANT.md, Step 3) forbids sending `userAgent`,\n * `timestamp`, search text or anything else that would not be used.\n *\n * The key is `currentUrl`, never `activeUrl`: the agent silently drops\n * `activeUrl`.\n */\nexport type PageContext = {\n  currentUrl: string;\n  currentPage: string;\n  entityType?: string;\n  entityId?: string;\n  platform: string;\n  version: string;\n  viewportSize: string;\n};\n\n/**\n * Every page-context entity type the assistant can receive from GGNomad.\n *\n * Each one is a record `wspace-ggnomad-svc` owns, with a single-record read the\n * assistant's GGNomad guide names (ai-assistant\n * `context/api-calls/products/ggnomad.md`, \"Page context\"). Keep the two in\n * step: the guide's tests pin this exact list.\n */\nexport const GGNOMAD_ENTITY_TYPES = [\n  'GGNOMAD_PROPERTY',\n  'GGNOMAD_TOUR',\n  'GGNOMAD_ACTIVITY',\n  'GGNOMAD_EVENT',\n  'GGNOMAD_TRIP_PLAN',\n  'GGNOMAD_BOOKING',\n  'GGNOMAD_PROVIDER',\n] as const;\n\nexport type GGNomadEntityType = (typeof GGNOMAD_ENTITY_TYPES)[number];\n\n/** Where a page's entity id comes from: a route segment, or the `?id=` a list page writes. */\ntype EntitySource = 'path' | 'query';\n\ninterface GGNomadPage {\n  /** The route as `GGNomadRoutes` registers it, relative to the MFE's base path. */\n  route: string;\n  /** Present when the page can identify one record. */\n  entity?: { type: GGNomadEntityType; source: EntitySource };\n}\n\n/**\n * Every page `GGNomadRoutes` registers, in match order (literal routes before\n * the parameterised routes they would otherwise shadow).\n *\n * Detail pages carry their record in the path. The bookings and\n * provider-analytics pages focus a record in place and write it to `?id=`\n * through `useFocusedRecordParam` (`src/ggnomad/hooks/useFocusedRecordParam.ts`).\n * The public storefront (`store/:slug`) is addressed by slug, not by a record\n * id, so it sends no entity.\n */\nexport const GGNOMAD_PAGES: readonly GGNomadPage[] = [\n  { route: '' },\n  { route: 'search' },\n  { route: 'travel' },\n  { route: 'hospitality' },\n  { route: 'hospitality/:id', entity: { type: 'GGNOMAD_PROPERTY', source: 'path' } },\n  { route: 'tourism' },\n  { route: 'tourism/tours/:id', entity: { type: 'GGNOMAD_TOUR', source: 'path' } },\n  { route: 'tourism/activities/:id', entity: { type: 'GGNOMAD_ACTIVITY', source: 'path' } },\n  { route: 'entertainment' },\n  { route: 'entertainment/:id', entity: { type: 'GGNOMAD_EVENT', source: 'path' } },\n  { route: 'bookings', entity: { type: 'GGNOMAD_BOOKING', source: 'query' } },\n  { route: 'travel-policy' },\n  { route: 'operations' },\n  { route: 'favorites' },\n  { route: 'provider' },\n  { route: 'provider/analytics', entity: { type: 'GGNOMAD_PROVIDER', source: 'query' } },\n  {\n    route: 'provider/:providerId/storefront',\n    entity: { type: 'GGNOMAD_PROVIDER', source: 'path' },\n  },\n  { route: 'store/:slug' },\n  { route: 'analytics' },\n  { route: 'trips' },\n  { route: 'trips/:id', entity: { type: 'GGNOMAD_TRIP_PLAN', source: 'path' } },\n];\n\n/** The shell mounts the MFE at `/ggnomad` (ggnomad-app `src/routes/AppRoutes.tsx`). */\nexport const GGNOMAD_BASE_PATH = '/ggnomad';\n\nexport interface GGNomadConversationContext {\n  /** The matched route, e.g. `ggnomad/hospitality/:id`; ids never appear here. */\n  currentPage: string;\n  entityType?: GGNomadEntityType;\n  entityId?: string;\n}\n\n/** Record ids are opaque tokens; anything else in `?id=` is ignored rather than forwarded. */\nconst ID_PATTERN = /^[A-Za-z0-9_-]{1,128}$/;\n\nfunction decodeSegment(segment: string): string | null {\n  try {\n    return decodeURIComponent(segment);\n  } catch {\n    return null;\n  }\n}\n\nfunction matchRoute(route: string, segments: readonly string[]): string | null | undefined {\n  const parts = route === '' ? [] : route.split('/');\n  if (parts.length !== segments.length) return undefined;\n  let captured: string | null = null;\n  for (let index = 0; index < parts.length; index += 1) {\n    const part = parts[index];\n    const segment = segments[index];\n    if (part === undefined || segment === undefined) return undefined;\n    if (part.startsWith(':')) {\n      // The last parameter is the record id (`provider/:providerId/storefront`\n      // has only one).\n      captured = decodeSegment(segment);\n    } else if (part !== segment) {\n      return undefined;\n    }\n  }\n  return captured;\n}\n\n/**\n * Resolves the page and, where the page identifies one record, its entity type\n * and id.\n *\n * Paths outside the MFE's base path (shell pages such as `/billing`) resolve to\n * their first segment with no entity. The search string is read only for the\n * `?id=` of a focused record; free-text search terms and other parameters are\n * never forwarded (they can carry guest names or other personal data).\n */\nexport function resolveGGNomadConversationContext(\n  pathname: string,\n  search: string,\n  basePath: string = GGNOMAD_BASE_PATH\n): GGNomadConversationContext {\n  const base = basePath.replace(/\\/+$/, '');\n  const normalized = pathname.replace(/\\/+$/, '') || '/';\n  const baseName = base.replace(/^\\/+/, '');\n\n  if (normalized !== base && !normalized.startsWith(`${base}/`)) {\n    const first = normalized.split('/').filter(Boolean)[0];\n    return { currentPage: first ?? 'home' };\n  }\n\n  const segments = normalized.slice(base.length).split('/').filter(Boolean);\n  for (const page of GGNOMAD_PAGES) {\n    const captured = matchRoute(page.route, segments);\n    if (captured === undefined) continue;\n    const currentPage = page.route ? `${baseName}/${page.route}` : baseName;\n    if (!page.entity) return { currentPage };\n\n    const entityId =\n      page.entity.source === 'path' ? captured : new URLSearchParams(search).get('id');\n    if (!entityId || !ID_PATTERN.test(entityId)) return { currentPage };\n    return { currentPage, entityType: page.entity.type, entityId };\n  }\n\n  // Unknown GGNomad path: the router redirects it to the dashboard.\n  return { currentPage: baseName };\n}\n\nexport function gatherPageContext(): PageContext {\n  // Queries and fragments can contain guest details, search text or credentials.\n  // Filter before transport: the sandbox's key allow-list runs after transmission.\n  const { origin, pathname, search } = window.location;\n  const context = resolveGGNomadConversationContext(pathname, search);\n\n  return {\n    currentUrl: `${origin}${pathname}`,\n    currentPage: context.currentPage,\n    entityType: context.entityType,\n    entityId: context.entityId,\n    platform: 'ggnomad',\n    version: import.meta.env.VITE_APP_VERSION ?? '2026.420.95',\n    viewportSize: `${window.innerWidth}x${window.innerHeight}`,\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@burdenoff/microfe-ggnomad",
-  "version": "2026.1029.3",
+  "version": "2026.1030.2",
   "description": "Burdenoff GGNomad Microfrontend",
   "type": "module",
   "files": [
@@ -31,7 +31,8 @@
     "lint:sanity": "if [ \"${CI:-}\" = \"true\" ]; then bun run lint; else bun run lint -- --cache --cache-location .eslintcache; fi",
     "format": "prettier --write \"src/**/*.{ts,tsx}\"",
     "type:check": "bash scripts/build-limits.sh tsc --noEmit",
-    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run codegen && bun run lint:sanity && bun run format && bun run type:check && bun run build && bun run build-storybook'",
+    "test": "bun test ./tests",
+    "sanity": "bash scripts/build-limits.sh --gate bash -c 'bun run codegen && bun run lint:sanity && bun run format && bun run type:check && bun run test && bun run build && bun run build-storybook'",
     "schema:pull": "graphql-codegen --project schema-wspace && graphql-codegen --project schema-global",
     "codegen": "graphql-codegen --project wspace && graphql-codegen --project global",
     "codegen:all": "bun run schema:pull && bun run codegen",