@particle-academy/agent-integrations 0.4.0 → 0.5.0

package/README.md

@@ -16,6 +16,51 @@ npm install @particle-academy/agent-integrations
 import "@particle-academy/agent-integrations/styles.css";
 ```
 
+## Tree-shake-safe imports
+
+The root barrel is **core-only** — MCP server, presence, undo, sharing,
+plus the bridges and components that don't depend on optional peer
+packages (`fancy-sheets`, `fancy-forms`, `fancy-code`, `fancy-charts`,
+`fancy-scene`, `fancy-screens`).
+
+Bridges whose peer is optional (`fancy-whiteboard`, `fancy-flow`) and
+the `SharedWhiteboard` component are reachable **only via subpath
+imports** so a consumer that hasn't installed those peers bundles
+cleanly:
+
+```ts
+// Core — always safe:
+import {
+  MicroMcpServer,
+  attachInProcess,
+  registerSheetsBridge,
+  useSheetsAdapter,
+  useSheetsActivityHighlights,
+} from "@particle-academy/agent-integrations";
+
+// Optional peers — subpath imports:
+import { registerWhiteboardBridge } from "@particle-academy/agent-integrations/bridges/whiteboard";
+import { registerFlowBridge }       from "@particle-academy/agent-integrations/bridges/flow";
+import { SharedWhiteboard }         from "@particle-academy/agent-integrations/components/shared-whiteboard";
+```
+
+Every bridge has a matching subpath if you'd rather import surgically:
+
+| Bridge              | Subpath                                                |
+| ------------------- | ------------------------------------------------------ |
+| whiteboard          | `…/bridges/whiteboard`                                 |
+| flow                | `…/bridges/flow`                                       |
+| sheets              | `…/bridges/sheets`                                     |
+| forms               | `…/bridges/forms`                                      |
+| code                | `…/bridges/code`                                       |
+| charts              | `…/bridges/charts`                                     |
+| scene               | `…/bridges/scene`                                      |
+| screens             | `…/bridges/screens`                                    |
+| sheets adapter hook | `…/sheets-adapter`                                     |
+| presence            | `…/presence`                                           |
+| undo                | `…/undo`                                               |
+| sharing             | `…/sharing`                                            |
+
 ## When you don't need an MCP server
 
 If your agent runs in the same JS process as the surfaces it drives (an embedded chat widget, an in-page worker, an SSR-time tool loop), you don't need any of MCP's JSON-RPC framing. Use **`ToolRegistry`** — a plain in-memory tool host that the bridges register against. Agents drive the surface with `host.callTool("sheet_set_cell", { … })` directly.

package/dist/bridges-flow.js

@@ -1,6 +1,343 @@
-export { registerFlowBridge } from './chunk-N3H4DXY5.js';
-import './chunk-52S7XYZK.js';
+import { wrapToolWithActivity } from './chunk-52S7XYZK.js';
 import './chunk-JU2N4KK6.js';
-import './chunk-4KAIV6OD.js';
+import { errorResult, textResult } from './chunk-4KAIV6OD.js';
+
+// src/bridges/flow.ts
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+var num = (v, fallback) => typeof v === "number" && Number.isFinite(v) ? v : 0;
+var str = (v, fallback = "") => typeof v === "string" ? v : fallback;
+var newId = (prefix) => `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 7)}`;
+function registerFlowBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
+  const disposers = [];
+  const flTarget = (args, result) => ({
+    kind: "flow",
+    elementId: result?.structuredContent?.id ?? args?.id
+  });
+  const reg = (name, description, properties, required, handler, resolveTarget) => {
+    const wrapped = async (args) => {
+      try {
+        return await handler(args);
+      } catch (e) {
+        return errorResult(e instanceof Error ? e.message : String(e));
+      }
+    };
+    const final = resolveTarget ? wrapToolWithActivity(wrapped, {
+      toolName: name,
+      agent: { id: agent.id, name: agent.name, color: agent.color },
+      kind: "flow",
+      resolveTarget: ({ args, result }) => resolveTarget(args, result)
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        {
+          name,
+          description,
+          inputSchema: { type: "object", properties, required, additionalProperties: false }
+        },
+        final
+      )
+    );
+  };
+  reg("flow_get_state", "Get the full graph: nodes + edges.", {}, [], () => {
+    const state = { nodes: adapter.getNodes(), edges: adapter.getEdges() };
+    return textResult(JSON.stringify(state, null, 2), state);
+  });
+  reg("flow_list_nodes", "Summarise every node: id, kind, label, position, status.", {}, [], () => {
+    const items = adapter.getNodes().map((n) => ({
+      id: n.id,
+      kind: n.type,
+      label: n.data?.label,
+      x: Math.round(n.position.x),
+      y: Math.round(n.position.y),
+      status: n.data?.status ?? "idle"
+    }));
+    const text = items.map((i) => `${i.kind} ${i.id}: "${i.label}" @(${i.x},${i.y}) [${i.status}]`).join("\n") || "(empty graph)";
+    return textResult(text, items);
+  });
+  reg(
+    "flow_get_node",
+    "Get a single node's full record by id.",
+    { id: { type: "string" } },
+    ["id"],
+    (args) => {
+      const id = str(args.id);
+      const node = adapter.getNodes().find((n) => n.id === id);
+      if (!node) return errorResult(`No node with id ${id}`);
+      return textResult(JSON.stringify(node, null, 2), node);
+    }
+  );
+  reg(
+    "flow_list_node_kinds",
+    "List every node kind registered in fancy-flow's registry. Use this to discover what's authorable before adding nodes.",
+    { category: { type: "string", description: "Optional category filter: trigger | logic | data | ai | io | human | output | custom." } },
+    [],
+    async () => {
+      try {
+        const { listNodeKinds } = await import('@particle-academy/fancy-flow');
+        const cat = adapter ? void 0 : void 0;
+        const all = (cat ? listNodeKinds(cat) : listNodeKinds()).map((k) => ({
+          name: k.name,
+          category: k.category,
+          label: k.label,
+          description: k.description,
+          icon: k.icon,
+          accent: k.accent,
+          inputs: k.inputs ?? [],
+          outputs: k.outputs ?? [],
+          configFields: (k.configSchema ?? []).map((f) => ({ key: f.key, type: f.type, label: f.label, required: !!f.required }))
+        }));
+        const text = all.map((k) => `${k.category}/${k.name}: ${k.label}${k.description ? " \u2014 " + k.description : ""}`).join("\n");
+        return textResult(text || "(no kinds registered)", all);
+      } catch (e) {
+        return errorResult(`fancy-flow registry not available: ${e instanceof Error ? e.message : String(e)}`);
+      }
+    }
+  );
+  reg(
+    "flow_get_node_schema",
+    "Get the full configSchema + ports for a node kind. Use to know exactly what fields a kind accepts before calling flow_add_node.",
+    { name: { type: "string" } },
+    ["name"],
+    async (args) => {
+      try {
+        const { getNodeKind } = await import('@particle-academy/fancy-flow');
+        const k = getNodeKind(str(args.name));
+        if (!k) return errorResult(`No kind registered: ${args.name}`);
+        const summary = {
+          name: k.name,
+          category: k.category,
+          label: k.label,
+          description: k.description,
+          inputs: k.inputs ?? [],
+          outputs: k.outputs ?? [],
+          configSchema: k.configSchema ?? [],
+          defaultConfig: k.defaultConfig ?? null
+        };
+        return textResult(JSON.stringify(summary, null, 2), summary);
+      } catch (e) {
+        return errorResult(`fancy-flow registry not available: ${e instanceof Error ? e.message : String(e)}`);
+      }
+    }
+  );
+  reg("flow_list_edges", "Summarise every edge.", {}, [], () => {
+    const items = adapter.getEdges().map((e) => ({
+      id: e.id,
+      from: `${e.source}${e.sourceHandle ? `:${e.sourceHandle}` : ""}`,
+      to: `${e.target}${e.targetHandle ? `:${e.targetHandle}` : ""}`
+    }));
+    return textResult(items.map((i) => `${i.id}: ${i.from} \u2192 ${i.to}`).join("\n") || "(no edges)", items);
+  });
+  reg(
+    "flow_add_node",
+    "Add a node of any kind registered in fancy-flow's registry. Call flow_list_node_kinds first to discover what's available.",
+    {
+      kind: { type: "string", description: "Registry kind name (e.g. memory_store, llm_call, branch)." },
+      label: { type: "string" },
+      x: { type: "number" },
+      y: { type: "number" },
+      description: { type: "string" },
+      config: { type: "object", description: "Config fields per the kind's configSchema." },
+      body: { type: "string", description: "Note kinds only \u2014 body text." }
+    },
+    ["kind", "label", "x", "y"],
+    async (args) => {
+      const kindName = str(args.kind);
+      let kindDef = null;
+      try {
+        const { getNodeKind, defaultConfigFor } = await import('@particle-academy/fancy-flow');
+        kindDef = getNodeKind(kindName);
+        var defaults = kindDef ? defaultConfigFor(kindDef) : {};
+      } catch {
+        var defaults = {};
+      }
+      const isLegacy = ["trigger", "action", "decision", "output", "note", "subgraph"].includes(kindName);
+      if (!kindDef && !isLegacy) {
+        return errorResult(`Unknown kind: ${kindName} \u2014 call flow_list_node_kinds for the registry.`);
+      }
+      const id = newId("n");
+      const config = { ...defaults, ...args.config && typeof args.config === "object" ? args.config : {} };
+      const node = {
+        id,
+        type: kindName,
+        position: { x: num(args.x), y: num(args.y) },
+        data: {
+          kind: kindName,
+          label: str(args.label),
+          ...args.description ? { description: str(args.description) } : {},
+          config,
+          ...kindName === "note" && args.body ? { body: str(args.body) } : {}
+        }
+      };
+      adapter.setNodes((all) => [...all, node]);
+      return textResult(`Added ${kindName} ${id} ("${str(args.label)}")`, node);
+    },
+    flTarget
+  );
+  reg(
+    "flow_update_node",
+    "Update fields on a node. Only provided fields change.",
+    {
+      id: { type: "string" },
+      label: { type: "string" },
+      x: { type: "number" },
+      y: { type: "number" },
+      description: { type: "string" },
+      config: { type: "object" }
+    },
+    ["id"],
+    (args) => {
+      const id = str(args.id);
+      let updated = null;
+      adapter.setNodes(
+        (all) => all.map((n) => {
+          if (n.id !== id) return n;
+          updated = {
+            ...n,
+            position: {
+              x: args.x !== void 0 ? num(args.x) : n.position.x,
+              y: args.y !== void 0 ? num(args.y) : n.position.y
+            },
+            data: {
+              ...n.data,
+              ...args.label !== void 0 ? { label: str(args.label) } : {},
+              ...args.description !== void 0 ? { description: str(args.description) } : {},
+              ...args.config && typeof args.config === "object" ? { config: { ...n.data.config ?? {}, ...args.config } } : {}
+            }
+          };
+          return updated;
+        })
+      );
+      if (!updated) return errorResult(`No node with id ${id}`);
+      return textResult(`Updated node ${id}`, updated);
+    },
+    flTarget
+  );
+  reg(
+    "flow_delete_node",
+    "Remove a node by id (also removes any connected edges).",
+    { id: { type: "string" } },
+    ["id"],
+    (args) => {
+      const id = str(args.id);
+      if (!adapter.getNodes().some((n) => n.id === id)) {
+        return errorResult(`No node with id ${id}`);
+      }
+      adapter.setNodes((all) => all.filter((n) => n.id !== id));
+      adapter.setEdges((all) => all.filter((e) => e.source !== id && e.target !== id));
+      return textResult(`Deleted node ${id}`);
+    },
+    flTarget
+  );
+  reg(
+    "flow_connect",
+    "Create an edge between two nodes (optionally specifying handle ids).",
+    {
+      source: { type: "string" },
+      target: { type: "string" },
+      sourceHandle: { type: "string" },
+      targetHandle: { type: "string" },
+      label: { type: "string" }
+    },
+    ["source", "target"],
+    (args) => {
+      const source = str(args.source);
+      const target = str(args.target);
+      const all = adapter.getNodes();
+      if (!all.find((n) => n.id === source)) return errorResult(`No source node ${source}`);
+      if (!all.find((n) => n.id === target)) return errorResult(`No target node ${target}`);
+      const edge = {
+        id: newId("e"),
+        source,
+        target,
+        ...args.sourceHandle ? { sourceHandle: str(args.sourceHandle) } : {},
+        ...args.targetHandle ? { targetHandle: str(args.targetHandle) } : {},
+        ...args.label ? { label: str(args.label) } : {}
+      };
+      adapter.setEdges((existing) => [...existing, edge]);
+      return textResult(`Connected ${source}${edge.sourceHandle ? `:${edge.sourceHandle}` : ""} \u2192 ${target}${edge.targetHandle ? `:${edge.targetHandle}` : ""}`, edge);
+    },
+    flTarget
+  );
+  reg(
+    "flow_disconnect",
+    "Remove an edge by id.",
+    { id: { type: "string" } },
+    ["id"],
+    (args) => {
+      const id = str(args.id);
+      if (!adapter.getEdges().some((e) => e.id === id)) {
+        return errorResult(`No edge ${id}`);
+      }
+      adapter.setEdges((all) => all.filter((e) => e.id !== id));
+      return textResult(`Disconnected ${id}`);
+    },
+    flTarget
+  );
+  reg(
+    "flow_set_node_status",
+    "Manually set a node's status badge (idle | queued | running | done | error) and optional text. Useful for narration outside a run.",
+    {
+      id: { type: "string" },
+      status: { type: "string", enum: ["idle", "queued", "running", "done", "error"] },
+      text: { type: "string" }
+    },
+    ["id", "status"],
+    (args) => {
+      const id = str(args.id);
+      const status = str(args.status);
+      const text = args.text !== void 0 ? str(args.text) : void 0;
+      if (adapter.setNodeStatus) {
+        adapter.setNodeStatus(id, status, text);
+      } else {
+        let found = false;
+        adapter.setNodes(
+          (all) => all.map((n) => {
+            if (n.id !== id) return n;
+            found = true;
+            return { ...n, data: { ...n.data, status, statusText: text } };
+          })
+        );
+        if (!found) return errorResult(`No node with id ${id}`);
+      }
+      return textResult(`${id} \u2192 ${status}${text ? ` (${text})` : ""}`);
+    },
+    flTarget
+  );
+  reg(
+    "flow_run",
+    "Trigger a run of the current graph. Returns the topological result. Requires the host to have wired `run` into the adapter.",
+    {},
+    [],
+    async () => {
+      if (!adapter.run) return errorResult("Host did not provide a run handler.");
+      const result = await adapter.run();
+      return textResult(result.ok ? "Run complete" : `Run failed: ${result.error ?? "unknown"}`, result);
+    },
+    flTarget
+  );
+  reg(
+    "flow_cancel",
+    "Cancel an in-flight run.",
+    {},
+    [],
+    () => {
+      if (!adapter.cancel) return errorResult("Host did not provide a cancel handler.");
+      adapter.cancel();
+      return textResult("Run cancelled");
+    },
+    flTarget
+  );
+  return {
+    id: "flow",
+    title: "Flow",
+    dispose: () => {
+      for (const d of disposers) d();
+    }
+  };
+}
+
+export { registerFlowBridge };
 //# sourceMappingURL=bridges-flow.js.map
 //# sourceMappingURL=bridges-flow.js.map

package/dist/bridges-flow.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"bridges-flow.js"}
+{"version":3,"sources":["../src/bridges/flow.ts"],"names":[],"mappings":"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","file":"bridges-flow.js","sourcesContent":["// Loose types so this bridge builds standalone without a hard dep on\n// fancy-flow. Hosts that have fancy-flow installed get full editor\n// integration via the runtime dynamic imports below.\ntype FlowNode = {\n  id: string;\n  type?: string;\n  position: { x: number; y: number };\n  data: { kind?: string; label?: string; description?: string; status?: string; statusText?: string; config?: Record<string, unknown>; [k: string]: unknown };\n};\ntype FlowEdge = {\n  id: string;\n  source: string;\n  target: string;\n  sourceHandle?: string;\n  targetHandle?: string;\n  label?: string;\n  [k: string]: unknown;\n};\ntype FlowGraph = { nodes: FlowNode[]; edges: FlowEdge[] };\ntype NodeRunStatus = \"idle\" | \"queued\" | \"running\" | \"done\" | \"error\";\ntype ExecutorRegistry = Record<string, unknown>;\ntype RunResult = { ok: boolean; outputs: Record<string, unknown>; error?: string };\n\nimport { textResult, errorResult } from \"../mcp/server\";\nimport type { ToolHost } from \"../mcp/tool-host\";\nimport type { JsonObject } from \"../mcp/types\";\nimport type { Bridge } from \"./types\";\nimport { wrapToolWithActivity } from \"../presence/wrap-tool-with-activity\";\nimport type { AgentTarget as FlAgentTarget } from \"../presence/types\";\n\n/**\n * Adapter the host provides — same shape as the editor's local state plus\n * an optional `run`/`cancel` pair so agents can trigger executions.\n */\nexport type FlowBridgeAdapter = {\n  getNodes: () => FlowNode[];\n  setNodes: (next: FlowNode[] | ((prev: FlowNode[]) => FlowNode[])) => void;\n  getEdges: () => FlowEdge[];\n  setEdges: (next: FlowEdge[] | ((prev: FlowEdge[]) => FlowEdge[])) => void;\n  /** Optional: invoke runFlow with the host's executor registry. */\n  run?: (executors?: ExecutorRegistry) => Promise<RunResult>;\n  /** Optional: cancel the in-flight run. */\n  cancel?: () => void;\n  /** Optional: set per-node status text without going through the runner\n   *  (useful for agents narrating). */\n  setNodeStatus?: (id: string, status: NodeRunStatus, text?: string) => void;\n};\n\nexport type FlowBridgeOptions = {\n  adapter: FlowBridgeAdapter;\n  /** Identity tagged onto agent-authored nodes. */\n  agent?: { id: string; name?: string; color?: string };\n};\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\nconst KINDS: string[] = [\"trigger\", \"action\", \"decision\", \"output\", \"note\", \"subgraph\"];\n\nconst num = (v: unknown, fallback?: number): number =>\n  typeof v === \"number\" && Number.isFinite(v) ? v : fallback ?? 0;\nconst str = (v: unknown, fallback = \"\"): string => (typeof v === \"string\" ? v : fallback);\n\nconst newId = (prefix: string) =>\n  `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 7)}`;\n\n/**\n * registerFlowBridge — wires an MCP tool set against a fancy-flow editor's\n * controlled state. Mirrors the whiteboard bridge in shape: read tools,\n * mutation tools (add / update / delete nodes + edges), and optional\n * run/cancel if the host provides those callbacks.\n */\nexport function registerFlowBridge(\n  host: ToolHost,\n  options: FlowBridgeOptions,\n): Bridge {\n  const { adapter } = options;\n  const agent = { ...DEFAULT_AGENT, ...(options.agent ?? {}) };\n  const disposers: Array<() => void> = [];\n\n  // Activity-target resolver shared by every mutation tool. Pulls element id\n  // from the freshly-added node/edge (structuredContent), falling back to args.\n  const flTarget = (args: any, result: any): FlAgentTarget => ({\n    kind: \"flow\",\n    elementId: (result?.structuredContent?.id as string | undefined) ?? (args?.id as string | undefined),\n  });\n\n  const reg = (\n    name: string,\n    description: string,\n    properties: Record<string, unknown>,\n    required: string[],\n    handler: (args: JsonObject) => Promise<any> | any,\n    resolveTarget?: (args: JsonObject, result: any) => FlAgentTarget | null,\n  ) => {\n    const wrapped = async (args: JsonObject) => {\n      try {\n        return await handler(args);\n      } catch (e) {\n        return errorResult(e instanceof Error ? e.message : String(e));\n      }\n    };\n    const final = resolveTarget\n      ? wrapToolWithActivity(wrapped, {\n          toolName: name,\n          agent: { id: agent.id, name: agent.name, color: agent.color },\n          kind: \"flow\",\n          resolveTarget: ({ args, result }) => resolveTarget(args, result),\n        })\n      : wrapped;\n    disposers.push(\n      host.registerTool(\n        {\n          name,\n          description,\n          inputSchema: { type: \"object\", properties: properties as any, required, additionalProperties: false },\n        },\n        final as any,\n      ),\n    );\n  };\n\n  // ───────────── Read tools ─────────────\n\n  reg(\"flow_get_state\", \"Get the full graph: nodes + edges.\", {}, [], () => {\n    const state: FlowGraph = { nodes: adapter.getNodes(), edges: adapter.getEdges() };\n    return textResult(JSON.stringify(state, null, 2), state);\n  });\n\n  reg(\"flow_list_nodes\", \"Summarise every node: id, kind, label, position, status.\", {}, [], () => {\n    const items = adapter.getNodes().map((n) => ({\n      id: n.id,\n      kind: n.type,\n      label: n.data?.label,\n      x: Math.round(n.position.x),\n      y: Math.round(n.position.y),\n      status: n.data?.status ?? \"idle\",\n    }));\n    const text = items.map((i) => `${i.kind} ${i.id}: \"${i.label}\" @(${i.x},${i.y}) [${i.status}]`).join(\"\\n\") || \"(empty graph)\";\n    return textResult(text, items);\n  });\n\n  reg(\n    \"flow_get_node\",\n    \"Get a single node's full record by id.\",\n    { id: { type: \"string\" } },\n    [\"id\"],\n    (args) => {\n      const id = str(args.id);\n      const node = adapter.getNodes().find((n) => n.id === id);\n      if (!node) return errorResult(`No node with id ${id}`);\n      return textResult(JSON.stringify(node, null, 2), node);\n    },\n  );\n\n  reg(\n    \"flow_list_node_kinds\",\n    \"List every node kind registered in fancy-flow's registry. Use this to discover what's authorable before adding nodes.\",\n    { category: { type: \"string\", description: \"Optional category filter: trigger | logic | data | ai | io | human | output | custom.\" } },\n    [],\n    async () => {\n      // Dynamic import keeps the bridge usable even when fancy-flow isn't loaded.\n      try {\n        // @ts-ignore — optional peer dep, may not be installed\n        const { listNodeKinds } = await import(\"@particle-academy/fancy-flow\" as any);\n        const cat = adapter ? undefined : undefined; // placeholder\n        const all = (cat ? listNodeKinds(cat) : listNodeKinds()).map((k: any) => ({\n          name: k.name,\n          category: k.category,\n          label: k.label,\n          description: k.description,\n          icon: k.icon,\n          accent: k.accent,\n          inputs: k.inputs ?? [],\n          outputs: k.outputs ?? [],\n          configFields: (k.configSchema ?? []).map((f: any) => ({ key: f.key, type: f.type, label: f.label, required: !!f.required })),\n        }));\n        const text = all.map((k: any) => `${k.category}/${k.name}: ${k.label}${k.description ? \" — \" + k.description : \"\"}`).join(\"\\n\");\n        return textResult(text || \"(no kinds registered)\", all);\n      } catch (e) {\n        return errorResult(`fancy-flow registry not available: ${e instanceof Error ? e.message : String(e)}`);\n      }\n    },\n  );\n\n  reg(\n    \"flow_get_node_schema\",\n    \"Get the full configSchema + ports for a node kind. Use to know exactly what fields a kind accepts before calling flow_add_node.\",\n    { name: { type: \"string\" } },\n    [\"name\"],\n    async (args) => {\n      try {\n        // @ts-ignore — optional peer dep\n        const { getNodeKind } = await import(\"@particle-academy/fancy-flow\" as any);\n        const k: any = getNodeKind(str(args.name));\n        if (!k) return errorResult(`No kind registered: ${args.name}`);\n        const summary = {\n          name: k.name,\n          category: k.category,\n          label: k.label,\n          description: k.description,\n          inputs: k.inputs ?? [],\n          outputs: k.outputs ?? [],\n          configSchema: k.configSchema ?? [],\n          defaultConfig: k.defaultConfig ?? null,\n        };\n        return textResult(JSON.stringify(summary, null, 2), summary);\n      } catch (e) {\n        return errorResult(`fancy-flow registry not available: ${e instanceof Error ? e.message : String(e)}`);\n      }\n    },\n  );\n\n  reg(\"flow_list_edges\", \"Summarise every edge.\", {}, [], () => {\n    const items = adapter.getEdges().map((e) => ({\n      id: e.id,\n      from: `${e.source}${e.sourceHandle ? `:${e.sourceHandle}` : \"\"}`,\n      to: `${e.target}${e.targetHandle ? `:${e.targetHandle}` : \"\"}`,\n    }));\n    return textResult(items.map((i) => `${i.id}: ${i.from} → ${i.to}`).join(\"\\n\") || \"(no edges)\", items);\n  });\n\n  // ───────────── Node CRUD ─────────────\n\n  reg(\n    \"flow_add_node\",\n    \"Add a node of any kind registered in fancy-flow's registry. Call flow_list_node_kinds first to discover what's available.\",\n    {\n      kind: { type: \"string\", description: \"Registry kind name (e.g. memory_store, llm_call, branch).\" },\n      label: { type: \"string\" },\n      x: { type: \"number\" },\n      y: { type: \"number\" },\n      description: { type: \"string\" },\n      config: { type: \"object\", description: \"Config fields per the kind's configSchema.\" },\n      body: { type: \"string\", description: \"Note kinds only — body text.\" },\n    },\n    [\"kind\", \"label\", \"x\", \"y\"],\n    async (args) => {\n      const kindName = str(args.kind);\n      // Resolve the kind dynamically from the registry. Falls back to the\n      // legacy 6-pack so old graphs keep working.\n      let kindDef: any = null;\n      try {\n        // @ts-ignore — optional peer dep\n        const { getNodeKind, defaultConfigFor } = await import(\"@particle-academy/fancy-flow\" as any);\n        kindDef = getNodeKind(kindName);\n        var defaults: Record<string, unknown> = kindDef ? defaultConfigFor(kindDef) : {};\n      } catch {\n        var defaults: Record<string, unknown> = {};\n      }\n      const isLegacy = [\"trigger\", \"action\", \"decision\", \"output\", \"note\", \"subgraph\"].includes(kindName);\n      if (!kindDef && !isLegacy) {\n        return errorResult(`Unknown kind: ${kindName} — call flow_list_node_kinds for the registry.`);\n      }\n      const id = newId(\"n\");\n      const config = { ...defaults, ...((args.config && typeof args.config === \"object\") ? (args.config as Record<string, unknown>) : {}) };\n      const node: FlowNode = {\n        id,\n        type: kindName,\n        position: { x: num(args.x), y: num(args.y) },\n        data: {\n          kind: kindName,\n          label: str(args.label),\n          ...(args.description ? { description: str(args.description) } : {}),\n          config,\n          ...(kindName === \"note\" && args.body ? { body: str(args.body) } : {}),\n        } as any,\n      };\n      adapter.setNodes((all) => [...all, node]);\n      return textResult(`Added ${kindName} ${id} (\"${str(args.label)}\")`, node);\n    },\n    flTarget,\n  );\n\n  reg(\n    \"flow_update_node\",\n    \"Update fields on a node. Only provided fields change.\",\n    {\n      id: { type: \"string\" },\n      label: { type: \"string\" },\n      x: { type: \"number\" },\n      y: { type: \"number\" },\n      description: { type: \"string\" },\n      config: { type: \"object\" },\n    },\n    [\"id\"],\n    (args) => {\n      const id = str(args.id);\n      let updated: FlowNode | null = null;\n      adapter.setNodes((all) =>\n        all.map((n) => {\n          if (n.id !== id) return n;\n          updated = {\n            ...n,\n            position: {\n              x: args.x !== undefined ? num(args.x) : n.position.x,\n              y: args.y !== undefined ? num(args.y) : n.position.y,\n            },\n            data: {\n              ...n.data,\n              ...(args.label !== undefined ? { label: str(args.label) } : {}),\n              ...(args.description !== undefined ? { description: str(args.description) } : {}),\n              ...(args.config && typeof args.config === \"object\"\n                ? { config: { ...(n.data.config ?? {}), ...(args.config as Record<string, unknown>) } }\n                : {}),\n            },\n          };\n          return updated;\n        }),\n      );\n      if (!updated) return errorResult(`No node with id ${id}`);\n      return textResult(`Updated node ${id}`, updated);\n    },\n    flTarget,\n  );\n\n  reg(\n    \"flow_delete_node\",\n    \"Remove a node by id (also removes any connected edges).\",\n    { id: { type: \"string\" } },\n    [\"id\"],\n    (args) => {\n      const id = str(args.id);\n      // Validate existence BEFORE scheduling the state update — React's\n      // functional updaters may run async in strict mode, so checking a\n      // flag set inside the updater would race the response.\n      if (!adapter.getNodes().some((n) => n.id === id)) {\n        return errorResult(`No node with id ${id}`);\n      }\n      adapter.setNodes((all) => all.filter((n) => n.id !== id));\n      adapter.setEdges((all) => all.filter((e) => e.source !== id && e.target !== id));\n      return textResult(`Deleted node ${id}`);\n    },\n    flTarget,\n  );\n\n  // ───────────── Edges ─────────────\n\n  reg(\n    \"flow_connect\",\n    \"Create an edge between two nodes (optionally specifying handle ids).\",\n    {\n      source: { type: \"string\" },\n      target: { type: \"string\" },\n      sourceHandle: { type: \"string\" },\n      targetHandle: { type: \"string\" },\n      label: { type: \"string\" },\n    },\n    [\"source\", \"target\"],\n    (args) => {\n      const source = str(args.source);\n      const target = str(args.target);\n      const all = adapter.getNodes();\n      if (!all.find((n) => n.id === source)) return errorResult(`No source node ${source}`);\n      if (!all.find((n) => n.id === target)) return errorResult(`No target node ${target}`);\n      const edge: FlowEdge = {\n        id: newId(\"e\"),\n        source,\n        target,\n        ...(args.sourceHandle ? { sourceHandle: str(args.sourceHandle) } : {}),\n        ...(args.targetHandle ? { targetHandle: str(args.targetHandle) } : {}),\n        ...(args.label ? { label: str(args.label) } : {}),\n      };\n      adapter.setEdges((existing) => [...existing, edge]);\n      return textResult(`Connected ${source}${edge.sourceHandle ? `:${edge.sourceHandle}` : \"\"} → ${target}${edge.targetHandle ? `:${edge.targetHandle}` : \"\"}`, edge);\n    },\n    flTarget,\n  );\n\n  reg(\n    \"flow_disconnect\",\n    \"Remove an edge by id.\",\n    { id: { type: \"string\" } },\n    [\"id\"],\n    (args) => {\n      const id = str(args.id);\n      if (!adapter.getEdges().some((e) => e.id === id)) {\n        return errorResult(`No edge ${id}`);\n      }\n      adapter.setEdges((all) => all.filter((e) => e.id !== id));\n      return textResult(`Disconnected ${id}`);\n    },\n    flTarget,\n  );\n\n  // ───────────── Status / run ─────────────\n\n  reg(\n    \"flow_set_node_status\",\n    \"Manually set a node's status badge (idle | queued | running | done | error) and optional text. Useful for narration outside a run.\",\n    {\n      id: { type: \"string\" },\n      status: { type: \"string\", enum: [\"idle\", \"queued\", \"running\", \"done\", \"error\"] },\n      text: { type: \"string\" },\n    },\n    [\"id\", \"status\"],\n    (args) => {\n      const id = str(args.id);\n      const status = str(args.status) as NodeRunStatus;\n      const text = args.text !== undefined ? str(args.text) : undefined;\n      if (adapter.setNodeStatus) {\n        adapter.setNodeStatus(id, status, text);\n      } else {\n        // Fall back to mutating the node data directly.\n        let found = false;\n        adapter.setNodes((all) =>\n          all.map((n) => {\n            if (n.id !== id) return n;\n            found = true;\n            return { ...n, data: { ...n.data, status, statusText: text } };\n          }),\n        );\n        if (!found) return errorResult(`No node with id ${id}`);\n      }\n      return textResult(`${id} → ${status}${text ? ` (${text})` : \"\"}`);\n    },\n    flTarget,\n  );\n\n  reg(\n    \"flow_run\",\n    \"Trigger a run of the current graph. Returns the topological result. Requires the host to have wired `run` into the adapter.\",\n    {},\n    [],\n    async () => {\n      if (!adapter.run) return errorResult(\"Host did not provide a run handler.\");\n      const result = await adapter.run();\n      return textResult(result.ok ? \"Run complete\" : `Run failed: ${result.error ?? \"unknown\"}`, result);\n    },\n    flTarget,\n  );\n\n  reg(\n    \"flow_cancel\",\n    \"Cancel an in-flight run.\",\n    {},\n    [],\n    () => {\n      if (!adapter.cancel) return errorResult(\"Host did not provide a cancel handler.\");\n      adapter.cancel();\n      return textResult(\"Run cancelled\");\n    },\n    flTarget,\n  );\n\n  return {\n    id: \"flow\",\n    title: \"Flow\",\n    dispose: () => {\n      for (const d of disposers) d();\n    },\n  };\n}\n"]}

package/dist/{chunk-E4AICMFZ.js → chunk-5XELJIJR.js}

@@ -71,7 +71,7 @@ function useSheetsActivityHighlights(options = {}) {
     const color = event.agentColor ?? "#a855f7";
     out[address] = {
       color,
-      background: color + "33",
+      backgroundColor: color + "33",
       label: event.agentName ?? event.agentId ?? "agent"
     };
   }
@@ -79,5 +79,5 @@ function useSheetsActivityHighlights(options = {}) {
 }
 
 export { useSheetsActivityHighlights, useSheetsAdapter };
-//# sourceMappingURL=chunk-E4AICMFZ.js.map
-//# sourceMappingURL=chunk-E4AICMFZ.js.map
+//# sourceMappingURL=chunk-5XELJIJR.js.map
+//# sourceMappingURL=chunk-5XELJIJR.js.map

package/dist/chunk-5XELJIJR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sheets-adapter.ts"],"names":[],"mappings":"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","file":"chunk-5XELJIJR.js","sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { SheetsBridgeAdapter } from \"./bridges/sheets\";\nimport { onActivity } from \"./presence/registry\";\nimport type { AgentActivityEvent } from \"./presence/types\";\n\n/**\n * Shared-session helpers for `@particle-academy/fancy-sheets`.\n *\n * fancy-sheets' `SheetWorkbook` is already controlled (`data` + `onChange`).\n * The two missing pieces for a clean shared-session experience are:\n *\n *   1. an adapter object the host can hand to {@link registerSheetsBridge}\n *      without writing boilerplate, and\n *   2. a derived `CellHighlightMap` so agent edits visibly pulse on the\n *      humans' screens — wired from the presence registry's per-bridge\n *      activity stream.\n *\n * These are kept as host-side hooks (not part of the bridge itself) so\n * agent-integrations keeps zero hard deps on fancy-sheets. The host\n * imports SheetWorkbook directly and feeds these hooks' outputs into\n * its props.\n *\n *   const wb = useSheetsAdapter(initial, { screenId: \"deal-sheet\" });\n *   const highlights = useSheetsActivityHighlights({ screenId: \"deal-sheet\" });\n *\n *   useEffect(() => {\n *     const bridge = registerSheetsBridge(host, { adapter: wb.adapter });\n *     return bridge.dispose;\n *   }, [host, wb.adapter]);\n *\n *   <SheetWorkbook\n *     data={wb.workbook}\n *     onChange={wb.setWorkbook}\n *     highlights={highlights}\n *     onActiveCellChange={wb.onActiveCellChange}\n *   />\n */\n\n// Loose structural mirror of fancy-sheets' WorkbookData — kept local so\n// this helper doesn't pull a runtime dep on the package. The constraint\n// only names the fields the hook itself reads (`sheets` + `activeSheetId`);\n// it does NOT add a `[k: string]: unknown` index signature, so consumers\n// can pass the real `WorkbookData` from fancy-sheets through without\n// triggering an \"index signature missing\" error.\nexport type WorkbookLike = {\n  sheets: Array<{ id: string; name: string }>;\n  activeSheetId: string;\n};\n\nexport type SheetsAdapterOptions = {\n  /** Tags the bridge's screen id so presence events route correctly. */\n  screenId?: string;\n};\n\nexport type UseSheetsAdapterResult<W extends WorkbookLike> = {\n  /** Controlled workbook state. Wire to `<SheetWorkbook data={…} />`. */\n  workbook: W;\n  /** Setter for the controlled state. Wire to `<SheetWorkbook onChange={…} />`. */\n  setWorkbook: (next: W) => void;\n  /** Wire to `<SheetWorkbook onActiveCellChange={…} />` to track focus. */\n  onActiveCellChange: (address: string) => void;\n  /** Stable adapter to hand to `registerSheetsBridge({ adapter })`. */\n  adapter: SheetsBridgeAdapter;\n  /** Imperative: set the active sheet + cell. Mirrors the adapter's hook. */\n  setActiveCell: (sheetId: string, address: string) => void;\n  /** Read-only: the address last focused (any source). */\n  activeCell: string | null;\n};\n\n/**\n * useSheetsAdapter — one-liner glue between fancy-sheets' SheetWorkbook\n * and the sheets bridge.\n *\n *   const wb = useSheetsAdapter(initialWorkbook, { screenId: \"...\" });\n *\n *   useEffect(() => registerSheetsBridge(host, { adapter: wb.adapter }).dispose,\n *             [host, wb.adapter]);\n *\n *   <SheetWorkbook\n *     data={wb.workbook}\n *     onChange={wb.setWorkbook}\n *     onActiveCellChange={wb.onActiveCellChange}\n *   />\n */\nexport function useSheetsAdapter<W extends WorkbookLike>(\n  initial: W,\n  options: SheetsAdapterOptions = {},\n): UseSheetsAdapterResult<W> {\n  const [workbook, setWorkbook] = useState<W>(initial);\n  const [activeCell, setActiveCellState] = useState<string | null>(null);\n  const workbookRef = useRef(workbook);\n  workbookRef.current = workbook;\n\n  const setActiveCell = useCallback((sheetId: string, address: string) => {\n    setWorkbook((cur) => (cur.activeSheetId === sheetId ? cur : { ...cur, activeSheetId: sheetId }));\n    setActiveCellState(address);\n  }, []);\n\n  const onActiveCellChange = useCallback((address: string) => {\n    setActiveCellState(address);\n  }, []);\n\n  // Adapter must be stable across renders so the bridge's tool catalog\n  // doesn't churn — bind it to refs that hold the latest state + setter.\n  const setWorkbookRef = useRef(setWorkbook);\n  setWorkbookRef.current = setWorkbook;\n\n  const adapter = useMemo<SheetsBridgeAdapter>(\n    () => ({\n      screenId: options.screenId,\n      getWorkbook: () => workbookRef.current as unknown as ReturnType<SheetsBridgeAdapter[\"getWorkbook\"]>,\n      setWorkbook: (next) => setWorkbookRef.current(next as unknown as W),\n      setActiveCell,\n    }),\n    [options.screenId, setActiveCell],\n  );\n\n  return {\n    workbook,\n    setWorkbook,\n    onActiveCellChange,\n    adapter,\n    setActiveCell,\n    activeCell,\n  };\n}\n\n/**\n * Mirror of fancy-sheets' `CellHighlight` — structurally identical so the\n * map returned from {@link useSheetsActivityHighlights} can be passed\n * straight into `<SheetWorkbook highlights={…} />` without any casts.\n *\n * Fields match `@particle-academy/fancy-sheets` exactly:\n *   - `color: string` (required) — border/outline color\n *   - `backgroundColor?: string` — auto-derived from `color` if omitted\n *   - `label?: string` — small badge in the cell's top-left corner\n */\nexport type SheetsCellHighlight = {\n  /** Border/outline color (any CSS color value). Required. */\n  color: string;\n  /** Background tint; if omitted, derived from `color` at low alpha. */\n  backgroundColor?: string;\n  /** Optional label rendered in a chip on the cell. */\n  label?: string;\n};\n\nexport type SheetsCellHighlightMap = Record<string, SheetsCellHighlight>;\n\nexport type SheetsHighlightOptions = {\n  /** Only include events for this screen (recommended). */\n  screenId?: string;\n  /** Highlight TTL in ms before a hit fades from the map. Default 2200. */\n  ttlMs?: number;\n};\n\n/**\n * useSheetsActivityHighlights — subscribe to the presence registry,\n * produce a CellHighlightMap reflecting recent sheet-bridge activity.\n *\n * Pass the result straight into `<SheetWorkbook highlights={…} />`. Each\n * agent edit pulses in the agent's color for `ttlMs` then fades out.\n *\n * The bridge's target shape is `${sheetId}!${address}` — this hook\n * filters for the currently-active sheet and exposes only its cells.\n *\n *   const highlights = useSheetsActivityHighlights({ screenId: \"deal-sheet\" });\n *   <SheetWorkbook highlights={highlights} … />\n */\nexport function useSheetsActivityHighlights(\n  options: SheetsHighlightOptions = {},\n): SheetsCellHighlightMap {\n  const ttlMs = options.ttlMs ?? 2200;\n  const screenId = options.screenId;\n  const [, force] = useState(0);\n  const hitsRef = useRef<\n    Map<string, { event: AgentActivityEvent; expiresAt: number }>\n  >(new Map());\n\n  useEffect(() => {\n    const off = onActivity((event) => {\n      if (event.target?.kind !== \"sheet\") return;\n      if (screenId && event.target.screenId && event.target.screenId !== screenId) return;\n      const elementId = event.target.elementId;\n      if (!elementId || !elementId.includes(\"!\")) return;\n      hitsRef.current.set(elementId, { event, expiresAt: Date.now() + ttlMs });\n      force((n) => n + 1);\n    });\n    return off;\n  }, [screenId, ttlMs]);\n\n  // Periodic GC — drop expired entries and force a re-render.\n  useEffect(() => {\n    const t = window.setInterval(() => {\n      const now = Date.now();\n      let dirty = false;\n      for (const [k, v] of hitsRef.current) {\n        if (v.expiresAt < now) {\n          hitsRef.current.delete(k);\n          dirty = true;\n        }\n      }\n      if (dirty) force((n) => n + 1);\n    }, 500);\n    return () => window.clearInterval(t);\n  }, []);\n\n  // Re-derived on every render — the listener + GC timer above call\n  // `force` so renders happen exactly when the map changes.\n  const out: SheetsCellHighlightMap = {};\n  for (const [elementId, { event }] of hitsRef.current) {\n    const idx = elementId.indexOf(\"!\");\n    const address = elementId.slice(idx + 1);\n    if (!address) continue;\n    const color = event.agentColor ?? \"#a855f7\";\n    out[address] = {\n      color,\n      backgroundColor: color + \"33\",\n      label: event.agentName ?? event.agentId ?? \"agent\",\n    };\n  }\n  return out;\n}\n"]}

package/dist/{chunk-6LTKCNLF.js → chunk-AFUULW5E.js}

@@ -32,37 +32,6 @@ function attachInProcess(server) {
   return transport;
 }
 
-// src/mcp/transports/relay.ts
-var RelayTransport = class {
-  constructor(channel) {
-    this.channel = channel;
-  }
-  bindServer(server) {
-    this.server = server;
-  }
-  send(message) {
-    this.channel.sendToRemote(message);
-  }
-  /**
-   * Host calls this with each frame received from the remote agent. Accepts
-   * either a parsed object or a raw JSON string.
-   */
-  async deliverFromRemote(payload) {
-    if (!this.server) throw new Error("RelayTransport has no bound server");
-    const message = typeof payload === "string" ? JSON.parse(payload) : payload;
-    await this.server.receive(this, message);
-  }
-  close() {
-    this.channel.onClose?.();
-  }
-};
-function attachRelay(server, channel) {
-  const transport = new RelayTransport(channel);
-  transport.bindServer(server);
-  server.attach(transport);
-  return transport;
-}
-
-export { InProcessTransport, RelayTransport, attachInProcess, attachRelay };
-//# sourceMappingURL=chunk-6LTKCNLF.js.map
-//# sourceMappingURL=chunk-6LTKCNLF.js.map
+export { InProcessTransport, attachInProcess };
+//# sourceMappingURL=chunk-AFUULW5E.js.map
+//# sourceMappingURL=chunk-AFUULW5E.js.map

package/dist/chunk-AFUULW5E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/transports/in-process.ts"],"names":[],"mappings":";AAeO,IAAM,qBAAN,MAA8C;AAAA,EAA9C,WAAA,GAAA;AAEL,IAAA,IAAA,CAAQ,SAAA,uBAAgB,GAAA,EAAmC;AAAA,EAAA;AAAA;AAAA,EAG3D,WAAW,MAAA,EAA8B;AACvC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA;AAAA,EAGA,KAAK,OAAA,EAA+B;AAClC,IAAA,KAAA,MAAW,CAAA,IAAK,IAAA,CAAK,SAAA,EAAW,CAAA,CAAE,OAAO,CAAA;AAAA,EAC3C;AAAA;AAAA,EAGA,MAAM,QAAQ,OAAA,EAAwC;AACpD,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,EAAQ,MAAM,IAAI,MAAM,wCAAwC,CAAA;AAC1E,IAAA,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AAAA,EACzC;AAAA;AAAA,EAGA,gBAAgB,QAAA,EAAqD;AACnE,IAAA,IAAA,CAAK,SAAA,CAAU,IAAI,QAAQ,CAAA;AAC3B,IAAA,OAAO,MAAM,IAAA,CAAK,SAAA,CAAU,MAAA,CAAO,QAAQ,CAAA;AAAA,EAC7C;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,UAAU,KAAA,EAAM;AAAA,EACvB;AACF;AAKO,SAAS,gBAAgB,MAAA,EAA4C;AAC1E,EAAA,MAAM,SAAA,GAAY,IAAI,kBAAA,EAAmB;AACzC,EAAA,SAAA,CAAU,WAAW,MAAM,CAAA;AAC3B,EAAA,MAAA,CAAO,OAAO,SAAS,CAAA;AACvB,EAAA,OAAO,SAAA;AACT","file":"chunk-AFUULW5E.js","sourcesContent":["import type { JsonRpcMessage } from \"../types\";\nimport type { MicroMcpServer, Transport } from \"../server\";\n\n/**\n * InProcessTransport — direct function-call wiring between an in-page MCP\n * client (e.g. an embedded chat agent) and a MicroMcpServer running in\n * the same JS context. No serialization, no network.\n *\n * Usage:\n *\n *   const t = new InProcessTransport();\n *   server.attach(t);\n *   t.onServerMessage((msg) => { ... });   // client subscribes\n *   t.send({ jsonrpc: \"2.0\", id: 1, method: \"tools/list\" }); // client → server\n */\nexport class InProcessTransport implements Transport {\n  private server?: MicroMcpServer;\n  private listeners = new Set<(msg: JsonRpcMessage) => void>();\n\n  /** Bind to a server. Called from the client's setup, not directly. */\n  bindServer(server: MicroMcpServer): void {\n    this.server = server;\n  }\n\n  /** Server → client (delivered to subscribed listeners). */\n  send(message: JsonRpcMessage): void {\n    for (const l of this.listeners) l(message);\n  }\n\n  /** Client → server. Awaitable so callers can flush. */\n  async deliver(message: JsonRpcMessage): Promise<void> {\n    if (!this.server) throw new Error(\"InProcessTransport has no bound server\");\n    await this.server.receive(this, message);\n  }\n\n  /** Subscribe to messages the server pushes to this client. */\n  onServerMessage(listener: (msg: JsonRpcMessage) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  close(): void {\n    this.listeners.clear();\n  }\n}\n\n/**\n * Convenience: create a server-attached in-process transport in one call.\n */\nexport function attachInProcess(server: MicroMcpServer): InProcessTransport {\n  const transport = new InProcessTransport();\n  transport.bindServer(server);\n  server.attach(transport);\n  return transport;\n}\n"]}

package/dist/chunk-G6N2TQVO.js

@@ -0,0 +1,34 @@
+// src/mcp/transports/relay.ts
+var RelayTransport = class {
+  constructor(channel) {
+    this.channel = channel;
+  }
+  bindServer(server) {
+    this.server = server;
+  }
+  send(message) {
+    this.channel.sendToRemote(message);
+  }
+  /**
+   * Host calls this with each frame received from the remote agent. Accepts
+   * either a parsed object or a raw JSON string.
+   */
+  async deliverFromRemote(payload) {
+    if (!this.server) throw new Error("RelayTransport has no bound server");
+    const message = typeof payload === "string" ? JSON.parse(payload) : payload;
+    await this.server.receive(this, message);
+  }
+  close() {
+    this.channel.onClose?.();
+  }
+};
+function attachRelay(server, channel) {
+  const transport = new RelayTransport(channel);
+  transport.bindServer(server);
+  server.attach(transport);
+  return transport;
+}
+
+export { RelayTransport, attachRelay };
+//# sourceMappingURL=chunk-G6N2TQVO.js.map
+//# sourceMappingURL=chunk-G6N2TQVO.js.map

package/dist/chunk-G6N2TQVO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/transports/relay.ts"],"names":[],"mappings":";AAyBO,IAAM,iBAAN,MAA0C;AAAA,EAE/C,YAAoB,OAAA,EAAuB;AAAvB,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAAA,EAAwB;AAAA,EAE5C,WAAW,MAAA,EAA8B;AACvC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA,EAEA,KAAK,OAAA,EAA+B;AAClC,IAAA,IAAA,CAAK,OAAA,CAAQ,aAAa,OAAO,CAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,kBAAkB,OAAA,EAAiD;AACvE,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,EAAQ,MAAM,IAAI,MAAM,oCAAoC,CAAA;AACtE,IAAA,MAAM,UAAU,OAAO,OAAA,KAAY,WAC9B,IAAA,CAAK,KAAA,CAAM,OAAO,CAAA,GACnB,OAAA;AACJ,IAAA,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,IAAA,EAAM,OAAO,CAAA;AAAA,EACzC;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,QAAQ,OAAA,IAAU;AAAA,EACzB;AACF;AAKO,SAAS,WAAA,CAAY,QAAwB,OAAA,EAAuC;AACzF,EAAA,MAAM,SAAA,GAAY,IAAI,cAAA,CAAe,OAAO,CAAA;AAC5C,EAAA,SAAA,CAAU,WAAW,MAAM,CAAA;AAC3B,EAAA,MAAA,CAAO,OAAO,SAAS,CAAA;AACvB,EAAA,OAAO,SAAA;AACT","file":"chunk-G6N2TQVO.js","sourcesContent":["import type { JsonRpcMessage } from \"../types\";\nimport type { MicroMcpServer, Transport } from \"../server\";\n\n/**\n * RelayTransport — wraps any duplex JSON-frame channel (e.g. a Reverb\n * websocket private channel, a WebRTC data channel) so external agents\n * can talk to a browser-side MicroMcpServer.\n *\n * The host app owns the actual channel. This class only handles framing\n * (JSON.stringify / JSON.parse) and the server contract.\n *\n * Channel contract:\n *   - host calls `transport.deliverFromRemote(payload)` with each frame\n *     it receives from the remote agent\n *   - host implements `sendToRemote(frame)` so the transport can deliver\n *     server → client frames outward\n *\n * See docs/relay-protocol.md for the wire format.\n */\nexport type RelayChannel = {\n  sendToRemote: (frame: JsonRpcMessage) => void;\n  /** Optional: notify the channel that the server is gone. */\n  onClose?: () => void;\n};\n\nexport class RelayTransport implements Transport {\n  private server?: MicroMcpServer;\n  constructor(private channel: RelayChannel) {}\n\n  bindServer(server: MicroMcpServer): void {\n    this.server = server;\n  }\n\n  send(message: JsonRpcMessage): void {\n    this.channel.sendToRemote(message);\n  }\n\n  /**\n   * Host calls this with each frame received from the remote agent. Accepts\n   * either a parsed object or a raw JSON string.\n   */\n  async deliverFromRemote(payload: JsonRpcMessage | string): Promise<void> {\n    if (!this.server) throw new Error(\"RelayTransport has no bound server\");\n    const message = typeof payload === \"string\"\n      ? (JSON.parse(payload) as JsonRpcMessage)\n      : payload;\n    await this.server.receive(this, message);\n  }\n\n  close(): void {\n    this.channel.onClose?.();\n  }\n}\n\n/**\n * Convenience wiring. Returns the bound transport.\n */\nexport function attachRelay(server: MicroMcpServer, channel: RelayChannel): RelayTransport {\n  const transport = new RelayTransport(channel);\n  transport.bindServer(server);\n  server.attach(transport);\n  return transport;\n}\n"]}

package/dist/chunk-IJ6JX5VC.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-IJ6JX5VC.js.map
+//# sourceMappingURL=chunk-IJ6JX5VC.js.map

package/dist/chunk-IJ6JX5VC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-IJ6JX5VC.js"}

package/dist/{chunk-JMYPUAFH.js → chunk-LVQXIUJH.js}

@@ -168,5 +168,5 @@ function attachSseRelay(server, options) {
 }
 
 export { SseRelayTransport, attachSseRelay, buildShareConfig, buildShareUrl, constantTimeEqual, createSessionDescriptor, describeSession, readSessionFromUrl };
-//# sourceMappingURL=chunk-JMYPUAFH.js.map
-//# sourceMappingURL=chunk-JMYPUAFH.js.map
+//# sourceMappingURL=chunk-LVQXIUJH.js.map
+//# sourceMappingURL=chunk-LVQXIUJH.js.map