@matterfact/embed 0.11.3 → 0.13.0

package/dist/react.d.cts

@@ -108,7 +108,30 @@ interface ToolEvent {
  *  - `chat`         — a chat-turn moment. Content-free: phase + opaque chatId only.
  *  - `tool`         — a host-tool lifecycle event (the `ToolEvent` shape, tagged). Also
  *    still delivered untagged to the legacy `onToolEvent` hook for back-compat.
+ *  - `artifactParams` — an artifact param changed in the widget.
  */
+/**
+ * A value an artifact param can carry. Mirrors the app's `ParamValue`
+ * (`enum` / `enum[]` / `entity` / `date` / `daterange` / `boolean` / `number`)
+ * DELIBERATELY BY COPY, not by import: this is a wire contract between two
+ * independently-deployed artifacts, and a shared type would let a rename
+ * compile on both sides while still breaking the wire. Bump PROTOCOL_VERSION
+ * instead. See this file's header.
+ */
+type ArtifactParamValue = string | string[] | number | boolean
+/** `daterange`: a [from, to] pair of YYYY-MM-DD strings. */
+ | [string, string];
+/**
+ * Artifact params on the wire, keyed by declared param name.
+ *
+ * Values are typed but NOT verified against the artifact's declared spec —
+ * a host can send anything, and the widget's param store coerces each value
+ * to its declared type (or drops it) on arrival. This type says what a
+ * well-behaved host means to send, not what the widget trusts it to have sent.
+ */
+type ArtifactParams = {
+    [name: string]: ArtifactParamValue;
+};
 type MatterfactEvent = {
     type: 'ready';
 } | {
@@ -130,7 +153,11 @@ type MatterfactEvent = {
     chatId?: string;
 } | ({
     type: 'tool';
-} & ToolEvent);
+} & ToolEvent) | {
+    type: 'artifactParams';
+    params: ArtifactParams;
+    source: 'user' | 'context';
+};
 
 /**
  * The Hoist adapter — a pure transform from a `HoistRuntime` (already read out of
@@ -255,7 +282,7 @@ interface MatterfactAgentProps {
      * Default `true`. Pass `false` for a host that wants agent chat with nothing
      * about the page ever reaching it.
      */
-    pageContext?: boolean;
+    pageContext?: boolean | 'full' | 'declared' | 'off';
     /**
      * Force dev mode programmatically. The URL trigger (`?mfdev=1`, see `loader.ts`)
      * still works unchanged — this is the React-prop equivalent, and the two are

package/dist/react.d.ts

@@ -108,7 +108,30 @@ interface ToolEvent {
  *  - `chat`         — a chat-turn moment. Content-free: phase + opaque chatId only.
  *  - `tool`         — a host-tool lifecycle event (the `ToolEvent` shape, tagged). Also
  *    still delivered untagged to the legacy `onToolEvent` hook for back-compat.
+ *  - `artifactParams` — an artifact param changed in the widget.
  */
+/**
+ * A value an artifact param can carry. Mirrors the app's `ParamValue`
+ * (`enum` / `enum[]` / `entity` / `date` / `daterange` / `boolean` / `number`)
+ * DELIBERATELY BY COPY, not by import: this is a wire contract between two
+ * independently-deployed artifacts, and a shared type would let a rename
+ * compile on both sides while still breaking the wire. Bump PROTOCOL_VERSION
+ * instead. See this file's header.
+ */
+type ArtifactParamValue = string | string[] | number | boolean
+/** `daterange`: a [from, to] pair of YYYY-MM-DD strings. */
+ | [string, string];
+/**
+ * Artifact params on the wire, keyed by declared param name.
+ *
+ * Values are typed but NOT verified against the artifact's declared spec —
+ * a host can send anything, and the widget's param store coerces each value
+ * to its declared type (or drops it) on arrival. This type says what a
+ * well-behaved host means to send, not what the widget trusts it to have sent.
+ */
+type ArtifactParams = {
+    [name: string]: ArtifactParamValue;
+};
 type MatterfactEvent = {
     type: 'ready';
 } | {
@@ -130,7 +153,11 @@ type MatterfactEvent = {
     chatId?: string;
 } | ({
     type: 'tool';
-} & ToolEvent);
+} & ToolEvent) | {
+    type: 'artifactParams';
+    params: ArtifactParams;
+    source: 'user' | 'context';
+};
 
 /**
  * The Hoist adapter — a pure transform from a `HoistRuntime` (already read out of
@@ -255,7 +282,7 @@ interface MatterfactAgentProps {
      * Default `true`. Pass `false` for a host that wants agent chat with nothing
      * about the page ever reaching it.
      */
-    pageContext?: boolean;
+    pageContext?: boolean | 'full' | 'declared' | 'off';
     /**
      * Force dev mode programmatically. The URL trigger (`?mfdev=1`, see `loader.ts`)
      * still works unchanged — this is the React-prop equivalent, and the two are

package/dist/react.js

@@ -229,11 +229,19 @@ function dockBox(g, vw, _vh) {
 // src/loader.ts
 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 ?? "");
+}
 var POS_KEY = "mf.embed.pos";
 var EmbedHost = class {
   constructor(config) {
@@ -495,6 +503,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;
@@ -600,6 +613,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;
     }
   }
   /**
@@ -707,18 +727,26 @@ 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() {
-    this.context ?? (this.context = import("./context-IK5MECUW.js").then((m) => {
+    this.context ?? (this.context = import("./context-IJK345PN.js").then((m) => {
       m.start(
         this.send,
         this.config.origin,
@@ -737,6 +765,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. */
@@ -754,6 +799,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;
 }