@matterfact/embed 0.11.3 → 0.13.0

package/dist/index.cjs

@@ -12,6 +12,36 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/pageContextMode.ts
+function parsePageContextMode(value) {
+  if (typeof value === "boolean") return value ? "full" : "off";
+  if (value == null) return "full";
+  const s = String(value).trim().toLowerCase();
+  if (s === "full" || s === "declared" || s === "off") return s;
+  if (s === "true" || s === "on" || s === "1" || s === "yes") return "full";
+  if (s === "false" || s === "0" || s === "no") return "off";
+  return "full";
+}
+function clampPageContextMode(adminMax, hostRequest) {
+  return RANK[adminMax] <= RANK[hostRequest] ? adminMax : hostRequest;
+}
+function allowsDeclared(mode) {
+  return mode !== "off";
+}
+function allowsAuto(mode) {
+  return mode === "full";
+}
+var RANK;
+var init_pageContextMode = __esm({
+  "src/pageContextMode.ts"() {
+    RANK = {
+      off: 0,
+      declared: 1,
+      full: 2
+    };
+  }
+});
+
 // src/redact.ts
 function redact(text) {
   let out = text;
@@ -436,7 +466,7 @@ function mfTools(win) {
   if (typeof document2 === "function") {
     out.push({
       name: "mf.resolveDocument",
-      description: 'Resolve a matterfact document (dossier, report, briefing) that is NOT on the current page to a concrete id. Call it with the document type and a key (e.g. a ticker) when the site map shows the document lives on another route. Returns {id, label, href}. Cite the result inline as <MFRef kind="document" id="<id>" label="<label>" /> \u2014 it renders as a chip that opens the document in the side panel; href is its "open on page" deeplink.',
+      description: `Resolve a matterfact document (dossier, report, briefing) that is NOT on the current page to a concrete id. Call it with the document type and the subject's key, when the site map shows the document lives on another route. For the key, use the current route parameter VERBATIM when the page context states one (e.g. ticker = BP~+LN+Equity \u2192 key "BP~+LN+Equity"): it is the host's own identifier and often differs from the ticker or name a person would write. Do not normalise, decode or re-spell it, and do not substitute what the user typed. Returns {id, label, href}. Cite the result inline as <MFRef kind="document" id="<id>" label="<label>" /> \u2014 it renders as a chip that opens the document in the side panel; href is its "open on page" deeplink.`,
       inputSchema: {
         type: "object",
         properties: {
@@ -1043,9 +1073,16 @@ __export(context_exports, {
   redact: () => redact,
   sendRegion: () => sendRegion,
   sendSnapshot: () => sendSnapshot,
+  setPageContextMax: () => setPageContextMax,
   start: () => start,
   stop: () => stop
 });
+function effectivePageContextMode() {
+  return clampPageContextMode(adminPageContextMax, hostPageContextMode);
+}
+function pageContextOn() {
+  return allowsDeclared(effectivePageContextMode());
+}
 function isPrivate(el) {
   if (el.closest("[data-mf-private]")) return true;
   const tag = el.tagName;
@@ -1132,8 +1169,9 @@ async function resolveDeclaredContext() {
   return mf?.context ?? {};
 }
 async function publishContext() {
-  if (!pageContextOn) return;
+  if (!pageContextOn()) return;
   const declared = await resolveDeclaredContext();
+  if (!pageContextOn()) return;
   send?.({ type: "host.context", context: buildPageContext(declared) });
 }
 function provideContext() {
@@ -1194,7 +1232,7 @@ function readSitemap2() {
   return Array.isArray(s) ? s : [];
 }
 function publishSitemap() {
-  if (!pageContextOn) return;
+  if (!pageContextOn()) return;
   const sitemap = readSitemap2();
   if (sitemap.length) send?.({ type: "host.sitemap", sitemap });
 }
@@ -1211,6 +1249,7 @@ function navigateHost(href) {
   location.assign(target.href);
 }
 function pushActivity(e) {
+  if (!allowsAuto(effectivePageContextMode())) return;
   activity.push({ ...e, seq: ++activitySeq, ts: Date.now() });
   if (activity.length > MAX_ACTIVITY) activity.shift();
   send?.({ type: "host.activity", events: [activity[activity.length - 1]] });
@@ -1275,6 +1314,7 @@ function watchNavigation() {
     publishSitemap();
     publishTools();
   };
+  if (navFire) return;
   navFire = fire;
   for (const name of ["pushState", "replaceState"]) {
     const orig = history[name];
@@ -1328,7 +1368,7 @@ function scheduleFocus() {
   }, 250);
 }
 async function sendSnapshot(emit) {
-  if (!pageContextOn) return;
+  if (!allowsAuto(effectivePageContextMode())) return;
   const hoist = detectHoist(() => readHoistRuntime());
   if (hoist) {
     const { rows } = readHoistConfig(
@@ -1344,6 +1384,7 @@ async function sendSnapshot(emit) {
     return;
   }
   const { snapshot: snapshot2 } = await loadSnapshotModule();
+  if (!allowsAuto(effectivePageContextMode())) return;
   const { yaml, truncated, visibleRefs } = snapshot2();
   emit({
     type: "host.snapshot",
@@ -1353,8 +1394,9 @@ async function sendSnapshot(emit) {
   emit({ type: "host.focus", focus: lastFocus });
 }
 async function sendRegion(ref, emit) {
-  if (!pageContextOn) return;
+  if (!allowsAuto(effectivePageContextMode())) return;
   const { snapshotRegion: snapshotRegion2, resolveRef: resolveRef2 } = await loadSnapshotModule();
+  if (!allowsAuto(effectivePageContextMode())) return;
   const el = resolveRef2(ref);
   if (!el) {
     emit({
@@ -1368,15 +1410,6 @@ async function sendRegion(ref, emit) {
   emit({ type: "host.region", ref, yaml: redact(yaml) });
 }
 async function callTool(call, emit) {
-  if (!pageContextOn) {
-    emit({
-      type: "host.toolResult",
-      callId: call.callId,
-      ok: false,
-      error: "host tools are disabled"
-    });
-    return;
-  }
   const win = typeof window !== "undefined" ? window : void 0;
   const cls = toolClass(call.name);
   const startedAt = Date.now();
@@ -1403,13 +1436,39 @@ async function callTool(call, emit) {
     error: r.error
   });
 }
-function stop() {
+function installAutoObservers() {
+  document.addEventListener("click", onClick, { capture: true, passive: true });
+  document.addEventListener("submit", onSubmit, {
+    capture: true,
+    passive: true
+  });
+  document.addEventListener("change", onChange, {
+    capture: true,
+    passive: true
+  });
+  document.addEventListener("selectionchange", scheduleFocus, { passive: true });
+  document.addEventListener("focusin", scheduleFocus, {
+    capture: true,
+    passive: true
+  });
+  window.addEventListener("scroll", scheduleFocus, {
+    capture: true,
+    passive: true
+  });
+}
+function removeAutoObservers() {
   document.removeEventListener("click", onClick, { capture: true });
   document.removeEventListener("submit", onSubmit, { capture: true });
   document.removeEventListener("change", onChange, { capture: true });
   document.removeEventListener("selectionchange", scheduleFocus);
   document.removeEventListener("focusin", scheduleFocus, { capture: true });
   window.removeEventListener("scroll", scheduleFocus, { capture: true });
+  if (focusTimer) {
+    clearTimeout(focusTimer);
+    focusTimer = null;
+  }
+}
+function unwatchNavigation() {
   if (navFire) {
     window.removeEventListener("popstate", navFire);
     navFire = null;
@@ -1422,10 +1481,10 @@ function stop() {
     history.replaceState = origReplaceState;
     origReplaceState = null;
   }
-  if (focusTimer) {
-    clearTimeout(focusTimer);
-    focusTimer = null;
-  }
+}
+function stop() {
+  removeAutoObservers();
+  unwatchNavigation();
   send = null;
   contextProvider = void 0;
   activity.length = 0;
@@ -1433,45 +1492,41 @@ function stop() {
   widgetOrigin = "";
   snapshotModule?.clearRefs();
 }
+function setPageContextMax(max) {
+  adminPageContextMax = parsePageContextMode(max);
+  applyObservation();
+}
+function applyObservation() {
+  const mode = effectivePageContextMode();
+  if (allowsAuto(mode)) {
+    installAutoObservers();
+  } else {
+    removeAutoObservers();
+    activity.length = 0;
+    lastFocus = {};
+  }
+  if (allowsDeclared(mode)) {
+    watchNavigation();
+  } else {
+    unwatchNavigation();
+  }
+}
 function start(emit, origin, pageContext = true, provider) {
   stop();
   send = emit;
   widgetOrigin = origin || "";
   lastUrl = location.pathname;
-  pageContextOn = pageContext;
+  hostPageContextMode = parsePageContextMode(pageContext);
   contextProvider = provider;
-  if (pageContextOn) {
+  if (allowsDeclared(effectivePageContextMode())) {
     void publishContext();
     publishArtifactGrants();
     publishSitemap();
-    watchNavigation();
-    document.addEventListener("click", onClick, {
-      capture: true,
-      passive: true
-    });
-    document.addEventListener("submit", onSubmit, {
-      capture: true,
-      passive: true
-    });
-    document.addEventListener("change", onChange, {
-      capture: true,
-      passive: true
-    });
-    document.addEventListener("selectionchange", scheduleFocus, {
-      passive: true
-    });
-    document.addEventListener("focusin", scheduleFocus, {
-      capture: true,
-      passive: true
-    });
-    window.addEventListener("scroll", scheduleFocus, {
-      capture: true,
-      passive: true
-    });
   }
+  applyObservation();
   const theme = matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
   emit({ type: "host.theme", mode: theme });
-  if (pageContextOn) {
+  {
     const w = typeof window !== "undefined" ? window : void 0;
     const tools = advertise(w);
     if (tools.length) {
@@ -1498,9 +1553,10 @@ function publishTools() {
     });
   }
 }
-var widgetOrigin, MAX_ACTIVITY, send, activitySeq, activity, lastUrl, pageContextOn, contextProvider, navFire, origPushState, origReplaceState, snapshotModule, FORM_CONTROLS, ACTIONABLE, lastFocus, focusTimer, snapshotSeq;
+var widgetOrigin, MAX_ACTIVITY, send, activitySeq, activity, lastUrl, hostPageContextMode, adminPageContextMax, contextProvider, navFire, origPushState, origReplaceState, snapshotModule, FORM_CONTROLS, ACTIONABLE, lastFocus, focusTimer, snapshotSeq;
 var init_context = __esm({
   "src/context.ts"() {
+    init_pageContextMode();
     init_redact();
     init_hoist();
     init_hoist_runtime();
@@ -1512,7 +1568,8 @@ var init_context = __esm({
     activitySeq = 0;
     activity = [];
     lastUrl = "";
-    pageContextOn = true;
+    hostPageContextMode = "full";
+    adminPageContextMax = "full";
     navFire = null;
     origPushState = null;
     origReplaceState = null;
@@ -1751,11 +1808,19 @@ function dockBox(g, vw, _vh) {
 var DEFAULT_ORIGIN = "https://app.matterfact.com";
 function devRequested() {
   try {
-    return new URLSearchParams(location.search).get("mfdev") === "1";
+    if (new URLSearchParams(location.search).get("mfdev") === "1") return true;
+    try {
+      return localStorage.getItem("mfdev") === "1";
+    } catch {
+      return false;
+    }
   } catch {
     return false;
   }
 }
+function alog(m, x) {
+  if (devRequested()) console.info("[embed auth] host: " + m, x ?? "");
+}
 function readConfig() {
   const el = document.currentScript ?? document.querySelector('script[data-key][src*="embed"]');
   const publishableKey = el?.dataset.key;
@@ -1771,13 +1836,21 @@ function readConfig() {
     );
   }
   const pageContextAttr = el?.dataset.pageContext?.toLowerCase();
+  let pageContext = true;
+  if (pageContextAttr === "off" || pageContextAttr === "false" || pageContextAttr === "0") {
+    pageContext = false;
+  } else if (pageContextAttr === "declared") {
+    pageContext = "declared";
+  } else if (pageContextAttr === "full" || pageContextAttr === "on" || pageContextAttr === "true" || pageContextAttr === "1") {
+    pageContext = true;
+  }
   return {
     publishableKey,
     origin: el?.dataset.origin || DEFAULT_ORIGIN,
     theme: el?.dataset.theme || "auto",
     surface: el?.dataset.surface || "",
     container,
-    pageContext: pageContextAttr !== "off" && pageContextAttr !== "false" && pageContextAttr !== "0"
+    pageContext
     // No `data-dev` — see the `dev` field's doc comment: the URL trigger is the
     // point for the script-tag path, so there is deliberately no script-tag knob here.
     // No `data-actions` either: the action policy lives entirely in the lazy chunk,
@@ -2047,6 +2120,11 @@ var EmbedHost = class {
       case "widget.requestContext":
         void this.loadContext().then((m) => m.provideContext());
         break;
+      case "widget.pageContextMax":
+        void this.loadContext().then((m) => {
+          m.setPageContextMax(msg.mode);
+        });
+        break;
       case "widget.requestSnapshot":
         void this.loadContext().then((m) => m.sendSnapshot(this.send));
         break;
@@ -2151,6 +2229,13 @@ var EmbedHost = class {
       case "widget.chat":
         this.emit({ type: "chat", phase: msg.phase, chatId: msg.chatId });
         break;
+      case "widget.artifactParams":
+        this.emit({
+          type: "artifactParams",
+          params: msg.params,
+          source: msg.source
+        });
+        break;
     }
   }
   /**
@@ -2258,14 +2343,22 @@ var EmbedHost = class {
    */
   async provideAuth() {
     const provider = this.config.authTokenProvider ?? globalThis.matterfact?.getEmbedAuthToken;
-    if (!provider) return;
-    if (++this.ac > 5) return;
+    if (!provider) {
+      alog("no provider");
+      return;
+    }
+    if (++this.ac > 5) {
+      alog("storm cap");
+      return;
+    }
     try {
       const token = await provider();
       if (token) this.send({ type: "host.auth", token, expiresAt: 0 });
       this.emit({ type: "auth", phase: token ? "granted" : "failed" });
-    } catch {
+      alog(token ? "token" : "empty");
+    } catch (e) {
       this.emit({ type: "auth", phase: "failed" });
+      alog("threw", e);
     }
   }
   loadContext() {
@@ -2288,6 +2381,23 @@ var EmbedHost = class {
     this.queue = [];
     for (const m of pending) this.send(m);
   }
+  /**
+   * Push artifact param values into the widget — a PARTIAL patch; only the named
+   * params change. Buffered like every other host→widget message until the widget
+   * says it's listening.
+   *
+   * Explicit and deliberate, so it applies even to a param whose page-context binding
+   * the viewer has overridden (spec §7.3).
+   */
+  setArtifactParams(params) {
+    if (params == null || typeof params !== "object" || Array.isArray(params)) {
+      console.error(
+        "[matterfact] setArtifactParams expects an object of param values"
+      );
+      return;
+    }
+    this.send({ type: "host.artifactParams", params });
+  }
   /** Tear down: stop listening and remove the host element. For the React wrapper's
    * unmount — the vanilla `<script>` loader lives for the page's lifetime and never
    * calls this. */
@@ -2305,6 +2415,10 @@ var EmbedHost = class {
 function mount(config) {
   const host = new EmbedHost(config);
   host.mount();
+  window.matterfact = {
+    ...window.matterfact ?? {},
+    setArtifactParams: (params) => host.setArtifactParams(params)
+  };
   return host;
 }