@matterfact/embed 0.9.0 → 0.10.0

package/dist/index.d.cts

@@ -102,6 +102,38 @@ interface ArtifactGrant {
     owner: string;
     token: string;
 }
+/**
+ * A DECLARED artifact grant — the `<MatterfactAgent artifacts>` prop (or
+ * `window.matterfact.artifacts`). Same wire shape as a grant discovered by scanning
+ * co-embedded `<MatterfactArtifact>` iframes, plus an optional `label`; it feeds the
+ * SAME `host.artifactGrants` channel. This is how a host makes a board reachable from
+ * a route where its iframe ISN'T mounted, without hidden zero-size iframes smuggling
+ * the token into the DOM. The token stays in the grant channel, never in message text.
+ */
+interface DeclaredArtifact {
+    slug: string;
+    owner: string;
+    token: string;
+    label?: string;
+}
+/**
+ * One host-tool lifecycle event, surfaced to the host via `onToolEvent` (and the dev
+ * panel) — the host's own telemetry hook. Fired loader-side; a throwing or slow
+ * callback here NEVER blocks or breaks the call path.
+ *
+ *  - `advertise` — the merged tool list changed (fired with the new set's names).
+ *  - `call`      — a tool call is about to run (`args` present).
+ *  - `result`    — the call settled (`ok`/`error`/`ms`).
+ */
+interface ToolEvent {
+    phase: 'advertise' | 'call' | 'result';
+    name: string;
+    toolClass: 'hoist' | 'mf' | 'app';
+    args?: unknown;
+    ok?: boolean;
+    error?: string;
+    ms?: number;
+}
 /**
  * A snapshot of the page as the agent sees it.
  *
@@ -661,4 +693,4 @@ declare class EmbedHost {
  */
 declare function mount(config: LoaderConfig): EmbedHost;
 
-export { type ActivityEvent, type ArtifactGrant, CHANNEL, type ContentClass, type DomSnapshot, type ElementRef, EmbedHost, type Envelope, type FocusContext, type HostToWidget, type HostTool, type LoaderConfig, PROTOCOL_VERSION, type PageContext, type PageEntity, type SiteMapEntry, type ToolCall, type WidgetToHost, envelope, isEnvelope, mount, readConfig };
+export { type ActivityEvent, type ArtifactGrant, CHANNEL, type ContentClass, type DeclaredArtifact, type DomSnapshot, type ElementRef, EmbedHost, type Envelope, type FocusContext, type HostToWidget, type HostTool, type LoaderConfig, PROTOCOL_VERSION, type PageContext, type PageEntity, type SiteMapEntry, type ToolCall, type ToolEvent, type WidgetToHost, envelope, isEnvelope, mount, readConfig };

package/dist/index.d.ts

@@ -102,6 +102,38 @@ interface ArtifactGrant {
     owner: string;
     token: string;
 }
+/**
+ * A DECLARED artifact grant — the `<MatterfactAgent artifacts>` prop (or
+ * `window.matterfact.artifacts`). Same wire shape as a grant discovered by scanning
+ * co-embedded `<MatterfactArtifact>` iframes, plus an optional `label`; it feeds the
+ * SAME `host.artifactGrants` channel. This is how a host makes a board reachable from
+ * a route where its iframe ISN'T mounted, without hidden zero-size iframes smuggling
+ * the token into the DOM. The token stays in the grant channel, never in message text.
+ */
+interface DeclaredArtifact {
+    slug: string;
+    owner: string;
+    token: string;
+    label?: string;
+}
+/**
+ * One host-tool lifecycle event, surfaced to the host via `onToolEvent` (and the dev
+ * panel) — the host's own telemetry hook. Fired loader-side; a throwing or slow
+ * callback here NEVER blocks or breaks the call path.
+ *
+ *  - `advertise` — the merged tool list changed (fired with the new set's names).
+ *  - `call`      — a tool call is about to run (`args` present).
+ *  - `result`    — the call settled (`ok`/`error`/`ms`).
+ */
+interface ToolEvent {
+    phase: 'advertise' | 'call' | 'result';
+    name: string;
+    toolClass: 'hoist' | 'mf' | 'app';
+    args?: unknown;
+    ok?: boolean;
+    error?: string;
+    ms?: number;
+}
 /**
  * A snapshot of the page as the agent sees it.
  *
@@ -661,4 +693,4 @@ declare class EmbedHost {
  */
 declare function mount(config: LoaderConfig): EmbedHost;
 
-export { type ActivityEvent, type ArtifactGrant, CHANNEL, type ContentClass, type DomSnapshot, type ElementRef, EmbedHost, type Envelope, type FocusContext, type HostToWidget, type HostTool, type LoaderConfig, PROTOCOL_VERSION, type PageContext, type PageEntity, type SiteMapEntry, type ToolCall, type WidgetToHost, envelope, isEnvelope, mount, readConfig };
+export { type ActivityEvent, type ArtifactGrant, CHANNEL, type ContentClass, type DeclaredArtifact, type DomSnapshot, type ElementRef, EmbedHost, type Envelope, type FocusContext, type HostToWidget, type HostTool, type LoaderConfig, PROTOCOL_VERSION, type PageContext, type PageEntity, type SiteMapEntry, type ToolCall, type ToolEvent, type WidgetToHost, envelope, isEnvelope, mount, readConfig };

package/dist/index.js

@@ -718,7 +718,7 @@ var EmbedHost = class {
     }
   }
   loadContext() {
-    this.context ?? (this.context = import('./context-ACFBWIFH.js').then((m) => {
+    this.context ?? (this.context = import('./context-SSQ4HUP3.js').then((m) => {
       m.start(
         this.send,
         this.config.origin,