@particle-academy/agent-integrations 0.3.4 → 0.5.0

package/dist/index.cjs

@@ -2,7 +2,6 @@
 
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
-var fancyWhiteboard = require('@particle-academy/fancy-whiteboard');
 
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -63,10 +62,43 @@ var JSONRPC_INVALID_PARAMS = -32602;
 var JSONRPC_INTERNAL_ERROR = -32603;
 var MCP_PROTOCOL_VERSION = "2025-06-18";
 
+// src/mcp/tool-host.ts
+var ToolRegistry = class {
+  constructor() {
+    this.tools = /* @__PURE__ */ new Map();
+  }
+  registerTool(definition, handler) {
+    this.tools.set(definition.name, { definition, handler });
+    this.onToolsChanged();
+    return () => {
+      if (this.tools.delete(definition.name)) this.onToolsChanged();
+    };
+  }
+  getTool(name) {
+    return this.tools.get(name) ?? null;
+  }
+  listTools() {
+    return Array.from(this.tools.values()).map((t) => t.definition);
+  }
+  async callTool(name, args = {}) {
+    const tool = this.tools.get(name);
+    if (!tool) {
+      throw new Error(`Unknown tool: ${name}`);
+    }
+    return tool.handler(args);
+  }
+  /**
+   * Hook for subclasses (e.g. MicroMcpServer) to notify subscribers
+   * when the tool catalog changes. Default no-op.
+   */
+  onToolsChanged() {
+  }
+};
+
 // src/mcp/server.ts
-var MicroMcpServer = class {
+var MicroMcpServer = class extends ToolRegistry {
   constructor(options) {
-    this.tools = /* @__PURE__ */ new Map();
+    super();
     this.transports = /* @__PURE__ */ new Set();
     this.notifyListChangedScheduled = false;
     this.info = options.info;
@@ -82,18 +114,13 @@ var MicroMcpServer = class {
       transport.close?.();
     }
   }
-  registerTool(definition, handler) {
-    this.tools.set(definition.name, { definition, handler });
-    this.scheduleListChangedNotification();
-    return () => this.unregisterTool(definition.name);
-  }
   unregisterTool(name) {
     if (this.tools.delete(name)) {
       this.scheduleListChangedNotification();
     }
   }
-  listTools() {
-    return Array.from(this.tools.values()).map((t) => t.definition);
+  onToolsChanged() {
+    this.scheduleListChangedNotification();
   }
   /**
    * Receive a JSON-RPC frame from a client (called by the transport).
@@ -281,142 +308,20 @@ function extractMeta(result) {
   return void 0;
 }
 
-// src/undo/undo-stack.ts
-var stacks = /* @__PURE__ */ new Map();
-var CAP = 200;
-function getStack(agentId) {
-  let s = stacks.get(agentId);
-  if (!s) {
-    s = { past: [], future: [] };
-    stacks.set(agentId, s);
-  }
-  return s;
-}
-function pushUndoEntry(agentId, entry) {
-  const s = getStack(agentId);
-  s.past.push(entry);
-  if (s.past.length > CAP) s.past.splice(0, s.past.length - CAP);
-  s.future.length = 0;
-}
-async function undoOne(agentId) {
-  const s = getStack(agentId);
-  const entry = s.past.pop();
-  if (!entry) return null;
-  await entry.undo();
-  s.future.push(entry);
-  return entry;
-}
-async function redoOne(agentId) {
-  const s = getStack(agentId);
-  const entry = s.future.pop();
-  if (!entry) return null;
-  await entry.redo();
-  s.past.push(entry);
-  return entry;
-}
-function readHistory(agentId) {
-  return getStack(agentId).past.slice();
-}
-function clearStack(agentId) {
-  stacks.delete(agentId);
-}
-function resetAllUndoStacks() {
-  stacks.clear();
-}
-
-// src/undo/undo-tools.ts
-var installedServers = /* @__PURE__ */ new WeakSet();
-function ensureUndoToolsRegistered(server, options = {}) {
-  if (installedServers.has(server)) return;
-  installedServers.add(server);
-  registerUndoTools(server, options);
-}
-function registerUndoTools(server, options = {}) {
-  const defaultAgent = options.defaultAgentId ?? "agent";
-  const disposers = [];
-  const agentOf = (args) => typeof args?.agentId === "string" ? args.agentId : defaultAgent;
-  disposers.push(
-    server.registerTool(
-      {
-        name: "agent_undo",
-        description: "Undo the most recent action on the agent's stack. Optional agentId targets a specific agent.",
-        inputSchema: {
-          type: "object",
-          properties: { agentId: { type: "string" } },
-          additionalProperties: false
-        }
-      },
-      async (args) => {
-        const entry = await undoOne(agentOf(args));
-        if (!entry) return errorResult("Nothing to undo.");
-        return textResult(`Undid: ${entry.label}`, { entry: serialize(entry) });
-      }
-    )
-  );
-  disposers.push(
-    server.registerTool(
-      {
-        name: "agent_redo",
-        description: "Redo the most recently undone action.",
-        inputSchema: {
-          type: "object",
-          properties: { agentId: { type: "string" } },
-          additionalProperties: false
-        }
-      },
-      async (args) => {
-        const entry = await redoOne(agentOf(args));
-        if (!entry) return errorResult("Nothing to redo.");
-        return textResult(`Redid: ${entry.label}`, { entry: serialize(entry) });
-      }
-    )
-  );
-  disposers.push(
-    server.registerTool(
-      {
-        name: "agent_history",
-        description: "List the agent's undo stack (oldest first). Useful for understanding what's reversible.",
-        inputSchema: {
-          type: "object",
-          properties: { agentId: { type: "string" } },
-          additionalProperties: false
-        }
-      },
-      async (args) => {
-        const history2 = readHistory(agentOf(args)).map(serialize);
-        const text = history2.map((e) => `${new Date(e.timestamp).toISOString()} ${e.bridgeId} ${e.action}: ${e.label}`).join("\n");
-        return textResult(text || "(empty)", history2);
-      }
-    )
-  );
-  return () => disposers.forEach((d) => d());
-}
-function serialize(entry) {
-  return {
-    timestamp: entry.timestamp,
-    bridgeId: entry.bridgeId,
-    action: entry.action,
-    label: entry.label
-  };
-}
-
-// src/bridges/whiteboard.ts
+// src/bridges/forms.ts
 var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
-var VALID_SHAPES = ["rect", "rounded-rect", "ellipse", "diamond", "triangle", "line", "arrow", "text"];
-var num = (v, fallback) => typeof v === "number" && Number.isFinite(v) ? v : fallback ?? 0;
-var str = (v, fallback = "") => typeof v === "string" ? v : fallback;
-var bool = (v, fallback = false) => typeof v === "boolean" ? v : fallback;
-var newId = (prefix) => `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 7)}`;
-function registerWhiteboardBridge(server, options) {
+function registerFormBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
   const disposers = [];
-  ensureUndoToolsRegistered(server, { defaultAgentId: agent.id });
-  const wbTarget = (args, result) => ({
-    kind: "whiteboard",
-    elementId: result?.structuredContent?.id ?? args?.id
+  const formId = adapter.id;
+  const target = (args) => ({
+    kind: "form",
+    screenId: adapter.screenId,
+    elementId: typeof args?.field === "string" ? `${formId}:${args.field}` : formId,
+    label: typeof args?.field === "string" ? `${adapter.title ?? formId} \u2192 ${args.field}` : adapter.title ?? formId
   });
-  const reg = (name, description, inputProperties, required, handler, resolveTarget) => {
+  const reg = (name, description, properties, required, handler, isMutation) => {
     const wrapped = async (args) => {
       try {
         return await handler(args);
@@ -424,860 +329,98 @@ function registerWhiteboardBridge(server, options) {
         return errorResult(e instanceof Error ? e.message : String(e));
       }
     };
-    const final = resolveTarget ? wrapToolWithActivity(wrapped, {
+    const final = isMutation ? wrapToolWithActivity(wrapped, {
       toolName: name,
       agent: { id: agent.id, name: agent.name, color: agent.color },
-      kind: "whiteboard",
-      resolveTarget: ({ args, result }) => resolveTarget(args, result)
+      kind: "form",
+      screenId: adapter.screenId,
+      resolveTarget: ({ args }) => target(args)
     }) : wrapped;
     disposers.push(
-      server.registerTool(
+      host.registerTool(
         {
           name,
           description,
-          inputSchema: {
-            type: "object",
-            properties: inputProperties,
-            required,
-            additionalProperties: false
-          }
+          inputSchema: { type: "object", properties, required, additionalProperties: false }
         },
         final
       )
     );
   };
-  reg("whiteboard_get_state", "Get the full board state: viewport, all items, strokes.", {}, [], () => {
-    const state = {
-      viewport: adapter.getViewport(),
-      notes: adapter.getNotes(),
-      shapes: adapter.getShapes(),
-      connectors: adapter.getConnectors(),
-      strokes: adapter.getStrokes()
-    };
-    return textResult(JSON.stringify(state, null, 2), state);
-  });
-  reg("whiteboard_list_items", "List notes, shapes, and connectors with id, kind, and bounds.", {}, [], () => {
-    const items = [];
-    for (const n of adapter.getNotes()) {
-      items.push({
-        id: n.id,
-        kind: "sticky",
-        summary: `"${(n.text ?? "").slice(0, 40)}" @(${Math.round(n.x)},${Math.round(n.y)}) ${n.width}\xD7${n.height}`
-      });
-    }
-    for (const s of adapter.getShapes()) {
-      items.push({
-        id: s.id,
-        kind: `shape:${s.shape}`,
-        summary: `${s.text ? `"${s.text}" ` : ""}@(${Math.round(s.x)},${Math.round(s.y)}) ${s.width}\xD7${s.height}`
-      });
-    }
-    for (const c of adapter.getConnectors()) {
-      items.push({ id: c.id, kind: "connector", summary: `from=${JSON.stringify(c.from)} to=${JSON.stringify(c.to)}` });
-    }
-    return textResult(items.map((i) => `${i.kind} ${i.id}: ${i.summary}`).join("\n") || "(empty board)", items);
-  });
-  reg(
-    "whiteboard_get_item",
-    "Get a single item (sticky / shape / connector) by id.",
-    { id: { type: "string" } },
-    ["id"],
-    (args) => {
-      const id = str(args.id);
-      const all = [...adapter.getNotes(), ...adapter.getShapes(), ...adapter.getConnectors()];
-      const found = all.find((x) => x.id === id);
-      if (!found) return errorResult(`No item with id ${id}`);
-      return textResult(JSON.stringify(found, null, 2), found);
-    }
-  );
   reg(
-    "whiteboard_add_sticky",
-    "Add a sticky note. Position is in world coordinates.",
-    {
-      x: { type: "number" },
-      y: { type: "number" },
-      text: { type: "string" },
-      width: { type: "number" },
-      height: { type: "number" },
-      color: { type: "string", description: "CSS color, e.g. #fde68a" }
-    },
-    ["x", "y"],
-    async (args) => {
-      const x = num(args.x);
-      const y = num(args.y);
-      const width = num(args.width, 180);
-      const height = num(args.height, 140);
-      const note = {
-        id: newId("n"),
-        kind: "sticky",
-        x,
-        y,
-        width,
-        height,
-        text: str(args.text),
-        color: typeof args.color === "string" ? args.color : "#fde68a",
-        authorId: agent.id
-      };
-      adapter.setNotes((all) => [...all, note]);
-      pushUndoEntry(agent.id, {
-        timestamp: Date.now(),
-        bridgeId: "whiteboard",
-        action: "whiteboard_add_sticky",
-        label: `Added sticky ${note.id}`,
-        undo: () => adapter.setNotes((all) => all.filter((n) => n.id !== note.id)),
-        redo: () => adapter.setNotes((all) => [...all, note])
-      });
-      return textResult(`Added sticky ${note.id}`, note);
+    "form_describe",
+    `Describe the form "${formId}" \u2014 fields, types, options, required flags. Call this first to know what's fillable.`,
+    {},
+    [],
+    () => {
+      const fields = adapter.getFields();
+      const text = fields.map((f) => `${f.name}${f.required ? "*" : ""} (${f.type})${f.label ? ` \u2014 ${f.label}` : ""}`).join("\n");
+      return textResult(text || "(no fields)", { id: formId, title: adapter.title, fields });
     },
-    wbTarget
+    false
   );
   reg(
-    "whiteboard_stream_text",
-    "Type text into a sticky note character-by-character so the human can read it forming. The tool returns once streaming finishes.",
-    {
-      id: { type: "string" },
-      text: { type: "string" },
-      cps: { type: "number", description: "Characters per second. Default 25." },
-      append: { type: "boolean", description: "Append to existing text instead of replacing. Default false." }
-    },
-    ["id", "text"],
-    async (args) => {
-      const id = str(args.id);
-      const target = str(args.text);
-      const cps = Math.max(1, num(args.cps, 25));
-      const append = bool(args.append);
-      const startNote = adapter.getNotes().find((n) => n.id === id);
-      if (!startNote) return errorResult(`No sticky with id ${id}`);
-      const base = append ? startNote.text ?? "" : "";
-      const interval = Math.max(8, Math.round(1e3 / cps));
-      for (let i = 0; i <= target.length; i++) {
-        const nextText = base + target.slice(0, i);
-        adapter.setNotes((all) => all.map((n) => n.id === id ? { ...n, text: nextText } : n));
-        if (i < target.length) await new Promise((r) => setTimeout(r, interval));
+    "form_get_value",
+    "Read a single field's current value.",
+    { field: { type: "string" } },
+    ["field"],
+    (args) => {
+      const name = String(args.field ?? "");
+      if (!adapter.getFields().find((f) => f.name === name)) {
+        return errorResult(`Unknown field: ${name}`);
       }
-      return textResult(`Streamed ${target.length} chars to ${id}`, { id, text: base + target });
-    }
-  );
-  reg(
-    "whiteboard_update_sticky",
-    "Update fields on a sticky note. Only provided fields are changed.",
-    {
-      id: { type: "string" },
-      x: { type: "number" },
-      y: { type: "number" },
-      width: { type: "number" },
-      height: { type: "number" },
-      text: { type: "string" },
-      color: { type: "string" }
-    },
-    ["id"],
-    async (args) => {
-      const id = str(args.id);
-      const existing = adapter.getNotes().find((n) => n.id === id);
-      if (!existing) return errorResult(`No sticky with id ${id}`);
-      const nextX = args.x !== void 0 ? num(args.x) : existing.x;
-      const nextY = args.y !== void 0 ? num(args.y) : existing.y;
-      const nextW = args.width !== void 0 ? num(args.width) : existing.width;
-      const nextH = args.height !== void 0 ? num(args.height) : existing.height;
-      let updated = null;
-      adapter.setNotes(
-        (all) => all.map((n) => {
-          if (n.id !== id) return n;
-          updated = {
-            ...n,
-            x: nextX,
-            y: nextY,
-            width: nextW,
-            height: nextH,
-            ...args.text !== void 0 ? { text: str(args.text) } : {},
-            ...args.color !== void 0 ? { color: str(args.color) } : {}
-          };
-          return updated;
-        })
-      );
-      return textResult(`Updated sticky ${id}`, updated);
+      const value = adapter.getValue(name);
+      return textResult(JSON.stringify(value), { field: name, value });
     },
-    wbTarget
+    false
   );
   reg(
-    "whiteboard_add_shape",
-    `Add a shape. Kind must be one of: ${VALID_SHAPES.join(", ")}.`,
-    {
-      shape: { type: "string", enum: VALID_SHAPES },
-      x: { type: "number" },
-      y: { type: "number" },
-      width: { type: "number" },
-      height: { type: "number" },
-      text: { type: "string" },
-      fill: { type: "string" },
-      stroke: { type: "string" },
-      flipX: { type: "boolean" },
-      flipY: { type: "boolean" }
-    },
-    ["shape", "x", "y", "width", "height"],
-    async (args) => {
-      const kind = str(args.shape);
-      if (!VALID_SHAPES.includes(kind)) return errorResult(`Invalid shape kind: ${kind}`);
-      const x = num(args.x);
-      const y = num(args.y);
-      const width = num(args.width);
-      const height = num(args.height);
-      const shape = {
-        id: newId("s"),
-        kind: "shape",
-        shape: kind,
-        x,
-        y,
-        width,
-        height,
-        ...args.text !== void 0 ? { text: str(args.text) } : {},
-        ...args.fill !== void 0 ? { fill: str(args.fill) } : {},
-        ...args.stroke !== void 0 ? { stroke: str(args.stroke) } : {},
-        ...args.flipX !== void 0 ? { flipX: bool(args.flipX) } : {},
-        ...args.flipY !== void 0 ? { flipY: bool(args.flipY) } : {}
-      };
-      adapter.setShapes((all) => [...all, shape]);
-      return textResult(`Added ${kind} ${shape.id}`, shape);
+    "form_get_values",
+    "Read every field's current value as a JSON object.",
+    {},
+    [],
+    () => {
+      const values = adapter.getValues();
+      return textResult(JSON.stringify(values, null, 2), values);
     },
-    wbTarget
+    false
   );
   reg(
-    "whiteboard_update_shape",
-    "Update fields on a shape.",
+    "form_set_value",
+    "Set one field's value. The host's controlled state updates and the human sees the field change.",
     {
-      id: { type: "string" },
-      x: { type: "number" },
-      y: { type: "number" },
-      width: { type: "number" },
-      height: { type: "number" },
-      text: { type: "string" },
-      fill: { type: "string" },
-      stroke: { type: "string" }
+      field: { type: "string" },
+      value: { description: "Value to set. Type depends on the field's `type`." }
     },
-    ["id"],
-    async (args) => {
-      const id = str(args.id);
-      const existing = adapter.getShapes().find((s) => s.id === id);
-      if (!existing) return errorResult(`No shape with id ${id}`);
-      const nextX = args.x !== void 0 ? num(args.x) : existing.x;
-      const nextY = args.y !== void 0 ? num(args.y) : existing.y;
-      const nextW = args.width !== void 0 ? num(args.width) : existing.width;
-      const nextH = args.height !== void 0 ? num(args.height) : existing.height;
-      let updated = null;
-      adapter.setShapes(
-        (all) => all.map((s) => {
-          if (s.id !== id) return s;
-          updated = {
-            ...s,
-            x: nextX,
-            y: nextY,
-            width: nextW,
-            height: nextH,
-            ...args.text !== void 0 ? { text: str(args.text) } : {},
-            ...args.fill !== void 0 ? { fill: str(args.fill) } : {},
-            ...args.stroke !== void 0 ? { stroke: str(args.stroke) } : {}
-          };
-          return updated;
-        })
-      );
-      return textResult(`Updated shape ${id}`, updated);
+    ["field", "value"],
+    (args) => {
+      const name = String(args.field ?? "");
+      const fieldDef = adapter.getFields().find((f) => f.name === name);
+      if (!fieldDef) return errorResult(`Unknown field: ${name}`);
+      adapter.setValue(name, args.value);
+      return textResult(`${name} \u2190 ${JSON.stringify(args.value)}`, { field: name, value: args.value });
     },
-    wbTarget
+    true
   );
   reg(
-    "whiteboard_add_connector",
-    "Connect two items by id, or specify explicit world-space points.",
-    {
-      from: { description: "Item id (string) or {x,y}" },
-      to: { description: "Item id (string) or {x,y}" },
-      color: { type: "string" }
-    },
-    ["from", "to"],
+    "form_set_values",
+    "Set multiple fields atomically. Pass a `values` object keyed by field name.",
+    { values: { type: "object" } },
+    ["values"],
     (args) => {
-      const c = {
-        id: newId("c"),
-        kind: "connector",
-        from: args.from,
-        to: args.to,
-        ...args.color !== void 0 ? { color: str(args.color) } : {}
-      };
-      adapter.setConnectors((all) => [...all, c]);
-      return textResult(`Added connector ${c.id}`, c);
+      const values = args.values && typeof args.values === "object" ? args.values : {};
+      const fields = adapter.getFields();
+      const known = new Set(fields.map((f) => f.name));
+      const unknownKeys = Object.keys(values).filter((k) => !known.has(k));
+      if (unknownKeys.length) return errorResult(`Unknown fields: ${unknownKeys.join(", ")}`);
+      if (adapter.setValues) {
+        adapter.setValues(values);
+      } else {
+        for (const [k, v] of Object.entries(values)) adapter.setValue(k, v);
+      }
+      return textResult(`Set ${Object.keys(values).length} field(s)`, { values });
     },
-    wbTarget
-  );
-  reg(
-    "whiteboard_add_stroke",
-    "Add a freeform pen stroke. Points are absolute screen coords (matching the Drawing layer).",
-    {
-      points: {
-        type: "array",
-        description: "Array of {x,y} points"
-      },
-      color: { type: "string" },
-      size: { type: "number" }
-    },
-    ["points"],
-    (args) => {
-      const points = (Array.isArray(args.points) ? args.points : []).map((p) => ({
-        x: num(p?.x),
-        y: num(p?.y)
-      }));
-      if (!points.length) return errorResult("Stroke requires at least one point");
-      const stroke = {
-        id: newId("st"),
-        points,
-        color: typeof args.color === "string" ? args.color : "#0f172a",
-        size: typeof args.size === "number" ? args.size : 2,
-        authorId: agent.id
-      };
-      adapter.setStrokes((all) => [...all, stroke]);
-      return textResult(`Added stroke ${stroke.id} (${points.length} points)`, stroke);
-    },
-    wbTarget
-  );
-  reg(
-    "whiteboard_delete_item",
-    "Remove any item by id (sticky / shape / connector / stroke).",
-    { id: { type: "string" } },
-    ["id"],
-    (args) => {
-      const id = str(args.id);
-      const removedNotes = adapter.getNotes().filter((x) => x.id === id);
-      const removedShapes = adapter.getShapes().filter((x) => x.id === id);
-      const removedConnectors = adapter.getConnectors().filter((x) => x.id === id);
-      const removedStrokes = adapter.getStrokes().filter((x) => x.id === id);
-      const removed = removedNotes.length + removedShapes.length + removedConnectors.length + removedStrokes.length > 0;
-      if (!removed) return errorResult(`No item with id ${id}`);
-      adapter.setNotes((all) => all.filter((x) => x.id !== id));
-      adapter.setShapes((all) => all.filter((x) => x.id !== id));
-      adapter.setConnectors((all) => all.filter((x) => x.id !== id));
-      adapter.setStrokes((all) => all.filter((x) => x.id !== id));
-      pushUndoEntry(agent.id, {
-        timestamp: Date.now(),
-        bridgeId: "whiteboard",
-        action: "whiteboard_delete_item",
-        label: `Deleted ${id}`,
-        undo: () => {
-          if (removedNotes.length) adapter.setNotes((all) => [...all, ...removedNotes]);
-          if (removedShapes.length) adapter.setShapes((all) => [...all, ...removedShapes]);
-          if (removedConnectors.length) adapter.setConnectors((all) => [...all, ...removedConnectors]);
-          if (removedStrokes.length) adapter.setStrokes((all) => [...all, ...removedStrokes]);
-        },
-        redo: () => {
-          adapter.setNotes((all) => all.filter((x) => x.id !== id));
-          adapter.setShapes((all) => all.filter((x) => x.id !== id));
-          adapter.setConnectors((all) => all.filter((x) => x.id !== id));
-          adapter.setStrokes((all) => all.filter((x) => x.id !== id));
-        }
-      });
-      return textResult(`Deleted ${id}`);
-    },
-    wbTarget
-  );
-  reg(
-    "whiteboard_set_viewport",
-    "Pan / zoom the viewport.",
-    { x: { type: "number" }, y: { type: "number" }, zoom: { type: "number" } },
-    [],
-    (args) => {
-      const v = adapter.getViewport();
-      const next = {
-        x: args.x !== void 0 ? num(args.x) : v.x,
-        y: args.y !== void 0 ? num(args.y) : v.y,
-        zoom: args.zoom !== void 0 ? num(args.zoom) : v.zoom
-      };
-      adapter.setViewport(next);
-      return textResult(`Viewport \u2192 ${JSON.stringify(next)}`, next);
-    },
-    wbTarget
-  );
-  reg(
-    "whiteboard_set_agent_cursor",
-    "Move the agent's presence cursor (or pass null to hide it).",
-    {
-      x: { type: "number" },
-      y: { type: "number" },
-      hide: { type: "boolean" }
-    },
-    [],
-    (args) => {
-      if (!adapter.setAgentCursor) return errorResult("Host did not provide setAgentCursor");
-      if (bool(args.hide)) {
-        adapter.setAgentCursor(null);
-        return textResult("Agent cursor hidden");
-      }
-      const cursor = {
-        userId: agent.id,
-        name: agent.name,
-        color: agent.color,
-        x: num(args.x),
-        y: num(args.y)
-      };
-      adapter.setAgentCursor(cursor);
-      return textResult(`Cursor \u2192 (${cursor.x}, ${cursor.y})`, cursor);
-    },
-    wbTarget
-  );
-  return {
-    id: "whiteboard",
-    title: "Whiteboard",
-    dispose: () => {
-      for (const d of disposers) d();
-      adapter.setAgentCursor?.(null);
-    }
-  };
-}
-
-// src/bridges/flow.ts
-var DEFAULT_AGENT2 = { id: "agent", name: "Agent", color: "#a855f7" };
-var num2 = (v, fallback) => typeof v === "number" && Number.isFinite(v) ? v : 0;
-var str2 = (v, fallback = "") => typeof v === "string" ? v : fallback;
-var newId2 = (prefix) => `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 7)}`;
-function registerFlowBridge(server, options) {
-  const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT2, ...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(
-      server.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 = str2(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(str2(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 = str2(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 = newId2("n");
-      const config = { ...defaults, ...args.config && typeof args.config === "object" ? args.config : {} };
-      const node = {
-        id,
-        type: kindName,
-        position: { x: num2(args.x), y: num2(args.y) },
-        data: {
-          kind: kindName,
-          label: str2(args.label),
-          ...args.description ? { description: str2(args.description) } : {},
-          config,
-          ...kindName === "note" && args.body ? { body: str2(args.body) } : {}
-        }
-      };
-      adapter.setNodes((all) => [...all, node]);
-      return textResult(`Added ${kindName} ${id} ("${str2(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 = str2(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 ? num2(args.x) : n.position.x,
-              y: args.y !== void 0 ? num2(args.y) : n.position.y
-            },
-            data: {
-              ...n.data,
-              ...args.label !== void 0 ? { label: str2(args.label) } : {},
-              ...args.description !== void 0 ? { description: str2(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 = str2(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 = str2(args.source);
-      const target = str2(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: newId2("e"),
-        source,
-        target,
-        ...args.sourceHandle ? { sourceHandle: str2(args.sourceHandle) } : {},
-        ...args.targetHandle ? { targetHandle: str2(args.targetHandle) } : {},
-        ...args.label ? { label: str2(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 = str2(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 = str2(args.id);
-      const status = str2(args.status);
-      const text = args.text !== void 0 ? str2(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();
-    }
-  };
-}
-
-// src/bridges/forms.ts
-var DEFAULT_AGENT3 = { id: "agent", name: "Agent", color: "#a855f7" };
-function registerFormBridge(server, options) {
-  const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT3, ...options.agent ?? {} };
-  const disposers = [];
-  const formId = adapter.id;
-  const target = (args) => ({
-    kind: "form",
-    screenId: adapter.screenId,
-    elementId: typeof args?.field === "string" ? `${formId}:${args.field}` : formId,
-    label: typeof args?.field === "string" ? `${adapter.title ?? formId} \u2192 ${args.field}` : adapter.title ?? formId
-  });
-  const reg = (name, description, properties, required, handler, isMutation) => {
-    const wrapped = async (args) => {
-      try {
-        return await handler(args);
-      } catch (e) {
-        return errorResult(e instanceof Error ? e.message : String(e));
-      }
-    };
-    const final = isMutation ? wrapToolWithActivity(wrapped, {
-      toolName: name,
-      agent: { id: agent.id, name: agent.name, color: agent.color },
-      kind: "form",
-      screenId: adapter.screenId,
-      resolveTarget: ({ args }) => target(args)
-    }) : wrapped;
-    disposers.push(
-      server.registerTool(
-        {
-          name,
-          description,
-          inputSchema: { type: "object", properties, required, additionalProperties: false }
-        },
-        final
-      )
-    );
-  };
-  reg(
-    "form_describe",
-    `Describe the form "${formId}" \u2014 fields, types, options, required flags. Call this first to know what's fillable.`,
-    {},
-    [],
-    () => {
-      const fields = adapter.getFields();
-      const text = fields.map((f) => `${f.name}${f.required ? "*" : ""} (${f.type})${f.label ? ` \u2014 ${f.label}` : ""}`).join("\n");
-      return textResult(text || "(no fields)", { id: formId, title: adapter.title, fields });
-    },
-    false
-  );
-  reg(
-    "form_get_value",
-    "Read a single field's current value.",
-    { field: { type: "string" } },
-    ["field"],
-    (args) => {
-      const name = String(args.field ?? "");
-      if (!adapter.getFields().find((f) => f.name === name)) {
-        return errorResult(`Unknown field: ${name}`);
-      }
-      const value = adapter.getValue(name);
-      return textResult(JSON.stringify(value), { field: name, value });
-    },
-    false
-  );
-  reg(
-    "form_get_values",
-    "Read every field's current value as a JSON object.",
-    {},
-    [],
-    () => {
-      const values = adapter.getValues();
-      return textResult(JSON.stringify(values, null, 2), values);
-    },
-    false
-  );
-  reg(
-    "form_set_value",
-    "Set one field's value. The host's controlled state updates and the human sees the field change.",
-    {
-      field: { type: "string" },
-      value: { description: "Value to set. Type depends on the field's `type`." }
-    },
-    ["field", "value"],
-    (args) => {
-      const name = String(args.field ?? "");
-      const fieldDef = adapter.getFields().find((f) => f.name === name);
-      if (!fieldDef) return errorResult(`Unknown field: ${name}`);
-      adapter.setValue(name, args.value);
-      return textResult(`${name} \u2190 ${JSON.stringify(args.value)}`, { field: name, value: args.value });
-    },
-    true
-  );
-  reg(
-    "form_set_values",
-    "Set multiple fields atomically. Pass a `values` object keyed by field name.",
-    { values: { type: "object" } },
-    ["values"],
-    (args) => {
-      const values = args.values && typeof args.values === "object" ? args.values : {};
-      const fields = adapter.getFields();
-      const known = new Set(fields.map((f) => f.name));
-      const unknownKeys = Object.keys(values).filter((k) => !known.has(k));
-      if (unknownKeys.length) return errorResult(`Unknown fields: ${unknownKeys.join(", ")}`);
-      if (adapter.setValues) {
-        adapter.setValues(values);
-      } else {
-        for (const [k, v] of Object.entries(values)) adapter.setValue(k, v);
-      }
-      return textResult(`Set ${Object.keys(values).length} field(s)`, { values });
-    },
-    true
+    true
   );
   reg(
     "form_focus",
@@ -1318,10 +461,10 @@ function registerFormBridge(server, options) {
 }
 
 // src/bridges/sheets.ts
-var DEFAULT_AGENT4 = { id: "agent", name: "Agent", color: "#a855f7" };
-function registerSheetsBridge(server, options) {
+var DEFAULT_AGENT2 = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerSheetsBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT4, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT2, ...options.agent ?? {} };
   const disposers = [];
   const target = (sheetId, address) => ({
     kind: "sheet",
@@ -1345,7 +488,7 @@ function registerSheetsBridge(server, options) {
       resolveTarget: ({ args, result }) => resolveTarget?.(args, result) ?? target(getSheetId(args))
     }) : wrapped;
     disposers.push(
-      server.registerTool(
+      host.registerTool(
         {
           name,
           description,
@@ -1588,14 +731,93 @@ function readRange(sheet, startAddr, endAddr) {
     }
     grid.push(row);
   }
-  return grid;
+  return grid;
+}
+
+// src/sheets-adapter.ts
+init_registry();
+function useSheetsAdapter(initial, options = {}) {
+  const [workbook, setWorkbook] = react.useState(initial);
+  const [activeCell, setActiveCellState] = react.useState(null);
+  const workbookRef = react.useRef(workbook);
+  workbookRef.current = workbook;
+  const setActiveCell = react.useCallback((sheetId, address) => {
+    setWorkbook((cur) => cur.activeSheetId === sheetId ? cur : { ...cur, activeSheetId: sheetId });
+    setActiveCellState(address);
+  }, []);
+  const onActiveCellChange = react.useCallback((address) => {
+    setActiveCellState(address);
+  }, []);
+  const setWorkbookRef = react.useRef(setWorkbook);
+  setWorkbookRef.current = setWorkbook;
+  const adapter = react.useMemo(
+    () => ({
+      screenId: options.screenId,
+      getWorkbook: () => workbookRef.current,
+      setWorkbook: (next) => setWorkbookRef.current(next),
+      setActiveCell
+    }),
+    [options.screenId, setActiveCell]
+  );
+  return {
+    workbook,
+    setWorkbook,
+    onActiveCellChange,
+    adapter,
+    setActiveCell,
+    activeCell
+  };
+}
+function useSheetsActivityHighlights(options = {}) {
+  const ttlMs = options.ttlMs ?? 2200;
+  const screenId = options.screenId;
+  const [, force] = react.useState(0);
+  const hitsRef = react.useRef(/* @__PURE__ */ new Map());
+  react.useEffect(() => {
+    const off = onActivity((event) => {
+      if (event.target?.kind !== "sheet") return;
+      if (screenId && event.target.screenId && event.target.screenId !== screenId) return;
+      const elementId = event.target.elementId;
+      if (!elementId || !elementId.includes("!")) return;
+      hitsRef.current.set(elementId, { event, expiresAt: Date.now() + ttlMs });
+      force((n) => n + 1);
+    });
+    return off;
+  }, [screenId, ttlMs]);
+  react.useEffect(() => {
+    const t = window.setInterval(() => {
+      const now = Date.now();
+      let dirty = false;
+      for (const [k, v] of hitsRef.current) {
+        if (v.expiresAt < now) {
+          hitsRef.current.delete(k);
+          dirty = true;
+        }
+      }
+      if (dirty) force((n) => n + 1);
+    }, 500);
+    return () => window.clearInterval(t);
+  }, []);
+  const out = {};
+  for (const [elementId, { event }] of hitsRef.current) {
+    const idx = elementId.indexOf("!");
+    const address = elementId.slice(idx + 1);
+    if (!address) continue;
+    const color = event.agentColor ?? "#a855f7";
+    out[address] = {
+      color,
+      backgroundColor: color + "33",
+      label: event.agentName ?? event.agentId ?? "agent"
+    };
+  }
+  return out;
 }
 
 // src/bridges/code.ts
-var DEFAULT_AGENT5 = { id: "agent", name: "Agent", color: "#a855f7" };
-function registerCodeBridge(server, options) {
+var DEFAULT_AGENT3 = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerCodeBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT5, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT3, ...options.agent ?? {} };
   const disposers = [];
   const target = {
     kind: "code",
@@ -1619,7 +841,7 @@ function registerCodeBridge(server, options) {
       resolveTarget: () => target
     }) : wrapped;
     disposers.push(
-      server.registerTool(
+      host.registerTool(
         {
           name,
           description,
@@ -1758,10 +980,10 @@ function registerCodeBridge(server, options) {
 }
 
 // src/bridges/charts.ts
-var DEFAULT_AGENT6 = { id: "agent", name: "Agent", color: "#a855f7" };
-function registerChartsBridge(server, options) {
+var DEFAULT_AGENT4 = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerChartsBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT6, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT4, ...options.agent ?? {} };
   const disposers = [];
   const target = {
     kind: "chart",
@@ -1785,7 +1007,7 @@ function registerChartsBridge(server, options) {
       resolveTarget: () => target
     }) : wrapped;
     disposers.push(
-      server.registerTool(
+      host.registerTool(
         { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
         final
       )
@@ -1872,10 +1094,10 @@ function registerChartsBridge(server, options) {
 }
 
 // src/bridges/scene.ts
-var DEFAULT_AGENT7 = { id: "agent", name: "Agent", color: "#a855f7" };
-function registerSceneBridge(server, options) {
+var DEFAULT_AGENT5 = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerSceneBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT7, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT5, ...options.agent ?? {} };
   const disposers = [];
   const target = (objectId) => ({
     kind: "scene",
@@ -1899,13 +1121,13 @@ function registerSceneBridge(server, options) {
       resolveTarget: ({ args }) => target(objectIdFromArgs?.(args))
     }) : wrapped;
     disposers.push(
-      server.registerTool(
+      host.registerTool(
         { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
         final
       )
     );
   };
-  const newId3 = (kind) => `${kind}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+  const newId = (kind) => `${kind}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
   reg(
     "scene_describe",
     "Describe the scene \u2014 object count, kinds, camera position.",
@@ -1949,7 +1171,7 @@ function registerSceneBridge(server, options) {
     ["kind"],
     (args) => {
       const obj = {
-        id: newId3(String(args.kind)),
+        id: newId(String(args.kind)),
         kind: String(args.kind),
         position: parseTriple(args.position),
         rotation: parseTriple(args.rotation),
@@ -2067,6 +1289,180 @@ function parseTriple(v) {
   if (out.some((x) => !Number.isFinite(x))) return void 0;
   return out;
 }
+
+// src/bridges/screens.ts
+var DEFAULT_AGENT6 = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerScreensBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT6, ...options.agent ?? {} };
+  const disposers = [];
+  const target = (screenId) => ({
+    kind: "screens",
+    screenId,
+    label: `Screen ${screenId}`
+  });
+  const reg = (name, description, properties, required, handler, isMutation, targetFromArgs) => {
+    const wrapped = async (args) => {
+      try {
+        return await handler(args);
+      } catch (e) {
+        return errorResult(e instanceof Error ? e.message : String(e));
+      }
+    };
+    const final = isMutation ? wrapToolWithActivity(wrapped, {
+      toolName: name,
+      agent,
+      kind: "screens",
+      resolveTarget: ({ args }) => targetFromArgs?.(args) ?? null
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
+        final
+      )
+    );
+  };
+  reg(
+    "screens_list",
+    "List every screen the host has registered. Returns id, title, active flag, and optional kind.",
+    {},
+    [],
+    () => {
+      const screens = adapter.listScreens();
+      const text = screens.map((s) => `${s.active ? "\u25B8" : " "} ${s.id}${s.title ? ` \u2014 ${s.title}` : ""}${s.kind ? ` [${s.kind}]` : ""}`).join("\n");
+      return textResult(text || "(no screens)", { screens, active: adapter.getActive() });
+    },
+    false
+  );
+  reg(
+    "screens_describe_active",
+    "Get the currently-active screen id (or null).",
+    {},
+    [],
+    () => {
+      const active = adapter.getActive();
+      return textResult(active ?? "(none)", { active });
+    },
+    false
+  );
+  reg(
+    "screens_list_kinds",
+    "List the screen kinds (templates) the host knows how to instantiate. Use this before screens_create to know what's available.",
+    {},
+    [],
+    () => {
+      if (!adapter.listKinds) return errorResult("Host did not register a kind catalog. Cannot create screens dynamically.");
+      const kinds = adapter.listKinds();
+      const text = kinds.map((k) => `${k.kind}${k.label ? ` \u2014 ${k.label}` : ""}${k.description ? ` (${k.description})` : ""}`).join("\n");
+      return textResult(text || "(no kinds registered)", kinds);
+    },
+    false
+  );
+  reg(
+    "screens_create",
+    "Instantiate a new screen from a template kind + config. Switches the active view to the new screen.",
+    {
+      id: { type: "string", description: "Stable screen id. Must be unique." },
+      title: { type: "string" },
+      kind: { type: "string", description: "Template kind \u2014 call screens_list_kinds for the catalog." },
+      config: { type: "object", description: "Template-specific config (e.g. { fields: [...] } for a form)." }
+    },
+    ["id", "kind"],
+    (args) => {
+      if (!adapter.createScreen) return errorResult("Host did not provide createScreen.");
+      const id = String(args.id);
+      const kind = String(args.kind);
+      if (adapter.listScreens().find((s) => s.id === id)) {
+        return errorResult(`Screen ${id} already exists. Use screens_destroy first or pick a fresh id.`);
+      }
+      adapter.createScreen({
+        id,
+        title: typeof args.title === "string" ? args.title : void 0,
+        kind,
+        config: args.config && typeof args.config === "object" ? args.config : void 0
+      });
+      adapter.setActive(id);
+      return textResult(`Created ${kind} screen "${id}"`, { id, kind });
+    },
+    true,
+    (args) => target(String(args.id ?? ""))
+  );
+  reg(
+    "screens_destroy",
+    "Remove a previously-created screen. Active screen falls back to the first remaining one (or null).",
+    { id: { type: "string" } },
+    ["id"],
+    (args) => {
+      if (!adapter.destroyScreen) return errorResult("Host did not provide destroyScreen.");
+      const id = String(args.id);
+      if (!adapter.listScreens().find((s) => s.id === id)) {
+        return errorResult(`No screen with id ${id}`);
+      }
+      adapter.destroyScreen(id);
+      return textResult(`Destroyed screen ${id}`, { id });
+    },
+    true,
+    (args) => target(String(args.id ?? ""))
+  );
+  reg(
+    "screens_set_layout",
+    "Change the layout of an existing composite screen. Layouts: 'single', 'split-h' (left/right), 'split-v' (top/bottom), 'grid-2x2', 'stack' (tabs).",
+    {
+      id: { type: "string" },
+      layout: { type: "string", enum: ["single", "split-h", "split-v", "grid-2x2", "stack"] }
+    },
+    ["id", "layout"],
+    (args) => {
+      if (!adapter.updateScreenContent) return errorResult("Host did not provide updateScreenContent.");
+      adapter.updateScreenContent(String(args.id), { layout: String(args.layout) });
+      return textResult(`Layout of ${args.id} \u2192 ${args.layout}`, { id: args.id, layout: args.layout });
+    },
+    true,
+    (args) => target(String(args.id ?? ""))
+  );
+  reg(
+    "screens_update_content",
+    "Merge new config into an existing screen (e.g. add a field to a form, append a sheet column, change chart series).",
+    {
+      id: { type: "string" },
+      partial: { type: "object", description: "Shallow-merged into the screen's config." }
+    },
+    ["id", "partial"],
+    (args) => {
+      if (!adapter.updateScreenContent) return errorResult("Host did not provide updateScreenContent.");
+      const id = String(args.id);
+      const partial = args.partial && typeof args.partial === "object" ? args.partial : {};
+      adapter.updateScreenContent(id, partial);
+      return textResult(`Updated content of ${id}`, { id });
+    },
+    true,
+    (args) => target(String(args.id ?? ""))
+  );
+  reg(
+    "screens_navigate",
+    "Switch the human's view to a different screen. The host updates its router / tab state and re-renders.",
+    { screen: { type: "string", description: "Screen id to activate." } },
+    ["screen"],
+    (args) => {
+      const screenId = String(args.screen ?? "");
+      const screens = adapter.listScreens();
+      if (!screens.find((s) => s.id === screenId)) {
+        return errorResult(`No screen registered with id "${screenId}". Call screens_list first.`);
+      }
+      adapter.setActive(screenId);
+      return textResult(`Navigated to ${screenId}`, { screen: screenId });
+    },
+    true,
+    (args) => target(String(args.screen ?? ""))
+  );
+  return {
+    id: "screens",
+    title: "Screens",
+    dispose: () => {
+      for (const d of disposers) d();
+    }
+  };
+}
 function AgentPanel({ agent, activity, onSubmit, busy, actions, className, style }) {
   const scrollRef = react.useRef(null);
   const inputRef = react.useRef(null);
@@ -2432,72 +1828,245 @@ function ShareControls({
           label: "Paste into Claude Desktop / Cline MCP server config",
           value: JSON.stringify(config, null, 2)
         }
-      ),
-      tab === "curl" && /* @__PURE__ */ jsxRuntime.jsx(
-        CopyBox,
-        {
-          label: "Connect from a terminal (verifies the relay is reachable)",
-          value: curl,
-          multiline: true
+      ),
+      tab === "curl" && /* @__PURE__ */ jsxRuntime.jsx(
+        CopyBox,
+        {
+          label: "Connect from a terminal (verifies the relay is reachable)",
+          value: curl,
+          multiline: true
+        }
+      )
+    ] })
+  ] });
+}
+function TabButton({ tab, active, setTab, children }) {
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "button",
+    {
+      type: "button",
+      role: "tab",
+      "aria-selected": tab === active,
+      className: `fai-share__tab${tab === active ? " is-active" : ""}`,
+      onClick: () => setTab(tab),
+      children
+    }
+  );
+}
+function CopyBox({ label, value, multiline }) {
+  const [copied, setCopied] = react.useState(false);
+  const copy = async () => {
+    try {
+      await navigator.clipboard.writeText(value);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 1200);
+    } catch {
+    }
+  };
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "fai-share__panel-label", children: label }),
+    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fai-share__copy", children: [
+      /* @__PURE__ */ jsxRuntime.jsx("pre", { className: `fai-share__pre${multiline ? " is-multi" : ""}`, children: value }),
+      /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: "fai-share__copy-btn", onClick: copy, children: copied ? "Copied" : "Copy" })
+    ] })
+  ] });
+}
+function buildCurlRecipe(session) {
+  const base = typeof window !== "undefined" ? `${window.location.protocol}//${window.location.host}` : "http://localhost";
+  const inbox = `${base}/whiteboard-share/${session.id}/inbox?token=${session.token}`;
+  const events = `${base}/whiteboard-share/${session.id}/events?token=${session.token}`;
+  return [
+    `# 1) In one terminal, subscribe to server-pushed frames (SSE)`,
+    `curl -N "${events}"`,
+    ``,
+    `# 2) In another terminal, send an initialize handshake`,
+    `curl -X POST "${inbox}" \\`,
+    `  -H 'content-type: application/json' \\`,
+    `  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'`,
+    ``,
+    `# 3) List the tools the bridge exposes`,
+    `curl -X POST "${inbox}" \\`,
+    `  -H 'content-type: application/json' \\`,
+    `  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'`,
+    ``,
+    `# 4) Add a sticky note`,
+    `curl -X POST "${inbox}" \\`,
+    `  -H 'content-type: application/json' \\`,
+    `  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"whiteboard_add_sticky","arguments":{"x":300,"y":300,"text":"hello from curl"}}}'`
+  ].join("\n");
+}
+
+// src/presence/index.ts
+init_registry();
+
+// src/presence/use-agent-activity.ts
+init_registry();
+function useAgentActivity(filter, options = {}) {
+  const cap = options.capacity ?? 50;
+  const [events, setEvents] = react.useState(() => readActivityHistory(filter).slice(-cap));
+  react.useEffect(() => {
+    setEvents(readActivityHistory(filter).slice(-cap));
+    return onActivity((event) => {
+      setEvents((prev) => {
+        const next = prev.length >= cap ? prev.slice(prev.length - cap + 1) : prev.slice();
+        next.push(event);
+        return next;
+      });
+    }, filter);
+  }, [filter?.agentId, filter?.screenId, filter?.kind, cap]);
+  return { events, latest: events.length > 0 ? events[events.length - 1] : null };
+}
+function useAgentActivityForScreen(screenId, options = {}) {
+  const { events, latest } = useAgentActivity({ screenId }, options);
+  const fadeAfter = latest?.ttlMs ?? 1500;
+  const [isAgentActive, setActive] = react.useState(false);
+  react.useEffect(() => {
+    if (!latest) {
+      setActive(false);
+      return;
+    }
+    setActive(true);
+    const timer = setTimeout(() => setActive(false), fadeAfter);
+    return () => clearTimeout(timer);
+  }, [latest, fadeAfter]);
+  return { events, latest, isAgentActive };
+}
+
+// src/undo/undo-stack.ts
+var stacks = /* @__PURE__ */ new Map();
+var CAP = 200;
+function getStack(agentId) {
+  let s = stacks.get(agentId);
+  if (!s) {
+    s = { past: [], future: [] };
+    stacks.set(agentId, s);
+  }
+  return s;
+}
+function pushUndoEntry(agentId, entry) {
+  const s = getStack(agentId);
+  s.past.push(entry);
+  if (s.past.length > CAP) s.past.splice(0, s.past.length - CAP);
+  s.future.length = 0;
+}
+async function undoOne(agentId) {
+  const s = getStack(agentId);
+  const entry = s.past.pop();
+  if (!entry) return null;
+  await entry.undo();
+  s.future.push(entry);
+  return entry;
+}
+async function redoOne(agentId) {
+  const s = getStack(agentId);
+  const entry = s.future.pop();
+  if (!entry) return null;
+  await entry.redo();
+  s.past.push(entry);
+  return entry;
+}
+function readHistory(agentId) {
+  return getStack(agentId).past.slice();
+}
+function clearStack(agentId) {
+  stacks.delete(agentId);
+}
+function resetAllUndoStacks() {
+  stacks.clear();
+}
+
+// src/undo/undo-tools.ts
+var installedHosts = /* @__PURE__ */ new WeakSet();
+function ensureUndoToolsRegistered(host, options = {}) {
+  if (installedHosts.has(host)) return;
+  installedHosts.add(host);
+  registerUndoTools(host, options);
+}
+function registerUndoTools(host, options = {}) {
+  const defaultAgent = options.defaultAgentId ?? "agent";
+  const disposers = [];
+  const agentOf = (args) => typeof args?.agentId === "string" ? args.agentId : defaultAgent;
+  disposers.push(
+    host.registerTool(
+      {
+        name: "agent_undo",
+        description: "Undo the most recent action on the agent's stack. Optional agentId targets a specific agent.",
+        inputSchema: {
+          type: "object",
+          properties: { agentId: { type: "string" } },
+          additionalProperties: false
+        }
+      },
+      async (args) => {
+        const entry = await undoOne(agentOf(args));
+        if (!entry) return errorResult("Nothing to undo.");
+        return textResult(`Undid: ${entry.label}`, { entry: serialize(entry) });
+      }
+    )
+  );
+  disposers.push(
+    host.registerTool(
+      {
+        name: "agent_redo",
+        description: "Redo the most recently undone action.",
+        inputSchema: {
+          type: "object",
+          properties: { agentId: { type: "string" } },
+          additionalProperties: false
         }
-      )
-    ] })
-  ] });
-}
-function TabButton({ tab, active, setTab, children }) {
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    "button",
-    {
-      type: "button",
-      role: "tab",
-      "aria-selected": tab === active,
-      className: `fai-share__tab${tab === active ? " is-active" : ""}`,
-      onClick: () => setTab(tab),
-      children
-    }
+      },
+      async (args) => {
+        const entry = await redoOne(agentOf(args));
+        if (!entry) return errorResult("Nothing to redo.");
+        return textResult(`Redid: ${entry.label}`, { entry: serialize(entry) });
+      }
+    )
+  );
+  disposers.push(
+    host.registerTool(
+      {
+        name: "agent_history",
+        description: "List the agent's undo stack (oldest first). Useful for understanding what's reversible.",
+        inputSchema: {
+          type: "object",
+          properties: { agentId: { type: "string" } },
+          additionalProperties: false
+        }
+      },
+      async (args) => {
+        const history2 = readHistory(agentOf(args)).map(serialize);
+        const text = history2.map((e) => `${new Date(e.timestamp).toISOString()} ${e.bridgeId} ${e.action}: ${e.label}`).join("\n");
+        return textResult(text || "(empty)", history2);
+      }
+    )
   );
+  return () => disposers.forEach((d) => d());
 }
-function CopyBox({ label, value, multiline }) {
-  const [copied, setCopied] = react.useState(false);
-  const copy = async () => {
-    try {
-      await navigator.clipboard.writeText(value);
-      setCopied(true);
-      setTimeout(() => setCopied(false), 1200);
-    } catch {
-    }
+function serialize(entry) {
+  return {
+    timestamp: entry.timestamp,
+    bridgeId: entry.bridgeId,
+    action: entry.action,
+    label: entry.label
   };
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
-    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "fai-share__panel-label", children: label }),
-    /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "fai-share__copy", children: [
-      /* @__PURE__ */ jsxRuntime.jsx("pre", { className: `fai-share__pre${multiline ? " is-multi" : ""}`, children: value }),
-      /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", className: "fai-share__copy-btn", onClick: copy, children: copied ? "Copied" : "Copy" })
-    ] })
-  ] });
 }
-function buildCurlRecipe(session) {
-  const base = typeof window !== "undefined" ? `${window.location.protocol}//${window.location.host}` : "http://localhost";
-  const inbox = `${base}/whiteboard-share/${session.id}/inbox?token=${session.token}`;
-  const events = `${base}/whiteboard-share/${session.id}/events?token=${session.token}`;
-  return [
-    `# 1) In one terminal, subscribe to server-pushed frames (SSE)`,
-    `curl -N "${events}"`,
-    ``,
-    `# 2) In another terminal, send an initialize handshake`,
-    `curl -X POST "${inbox}" \\`,
-    `  -H 'content-type: application/json' \\`,
-    `  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'`,
-    ``,
-    `# 3) List the tools the bridge exposes`,
-    `curl -X POST "${inbox}" \\`,
-    `  -H 'content-type: application/json' \\`,
-    `  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'`,
-    ``,
-    `# 4) Add a sticky note`,
-    `curl -X POST "${inbox}" \\`,
-    `  -H 'content-type: application/json' \\`,
-    `  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"whiteboard_add_sticky","arguments":{"x":300,"y":300,"text":"hello from curl"}}}'`
-  ].join("\n");
+function useUndoStack(agentId, intervalMs = 500) {
+  const [history2, setHistory] = react.useState(() => readHistory(agentId));
+  react.useEffect(() => {
+    let cancelled = false;
+    const tick = () => {
+      if (cancelled) return;
+      setHistory(readHistory(agentId));
+    };
+    const id = setInterval(tick, intervalMs);
+    tick();
+    return () => {
+      cancelled = true;
+      clearInterval(id);
+    };
+  }, [agentId, intervalMs]);
+  const refresh = react.useCallback(() => setHistory(readHistory(agentId)), [agentId]);
+  return { history: history2, refresh };
 }
 
 // src/sharing/sse-relay.ts
@@ -2612,329 +2181,6 @@ function attachSseRelay(server, options) {
   });
   return transport;
 }
-var DEFAULT_AGENT8 = { id: "agent", name: "Agent", color: "#a855f7" };
-function SharedWhiteboard({
-  initialNotes = [],
-  initialShapes = [],
-  initialConnectors = [],
-  initialStrokes = [],
-  initialViewport = { x: 0, y: 0, zoom: 1 },
-  agent = DEFAULT_AGENT8,
-  shareBaseUrl = "/whiteboard-share",
-  onRegisterSession,
-  showAgentPanel = true,
-  showShareControls = true,
-  broadcastEdits = true,
-  height = 640,
-  header,
-  className,
-  style
-}) {
-  const [notes, setNotes] = react.useState(initialNotes);
-  const [shapes, setShapes] = react.useState(initialShapes);
-  const [connectors, setConnectors] = react.useState(initialConnectors);
-  const [strokes, setStrokes] = react.useState(initialStrokes);
-  const [viewport, setViewport] = react.useState(initialViewport);
-  const [agentCursor, setAgentCursor] = react.useState(null);
-  const [activity, setActivity] = react.useState([]);
-  const [highlight, setHighlight] = react.useState(null);
-  const stateRefs = react.useRef({ notes, shapes, connectors, strokes, viewport });
-  react.useEffect(() => {
-    stateRefs.current = { notes, shapes, connectors, strokes, viewport };
-  }, [notes, shapes, connectors, strokes, viewport]);
-  const serverRef = react.useRef(null);
-  const inProcRef = react.useRef(null);
-  const bridgeRef = react.useRef(null);
-  react.useEffect(() => {
-    const server = new MicroMcpServer({
-      info: { name: "shared-whiteboard", version: "0.2.0" },
-      instructions: "Collaborative whiteboard. Use whiteboard_* tools to read or modify the board."
-    });
-    bridgeRef.current = registerWhiteboardBridge(server, {
-      adapter: {
-        getNotes: () => stateRefs.current.notes,
-        setNotes: (next) => setNotes(typeof next === "function" ? next : () => next),
-        getShapes: () => stateRefs.current.shapes,
-        setShapes: (next) => setShapes(typeof next === "function" ? next : () => next),
-        getConnectors: () => stateRefs.current.connectors,
-        setConnectors: (next) => setConnectors(typeof next === "function" ? next : () => next),
-        getStrokes: () => stateRefs.current.strokes,
-        setStrokes: (next) => setStrokes(typeof next === "function" ? next : () => next),
-        getViewport: () => stateRefs.current.viewport,
-        setViewport,
-        setAgentCursor
-      },
-      agent
-    });
-    inProcRef.current = attachInProcess(server);
-    serverRef.current = server;
-    const off = inProcRef.current.onServerMessage((msg) => {
-      if (msg?.id !== void 0 && "result" in msg && msg.result?.structuredContent?.id) {
-        const id = msg.result.structuredContent.id;
-        requestAnimationFrame(() => pulseFor(id));
-      }
-    });
-    return () => {
-      off();
-      bridgeRef.current?.dispose();
-      bridgeRef.current = null;
-      if (inProcRef.current) server.detach(inProcRef.current);
-    };
-  }, []);
-  const pulseFor = (id) => {
-    const n = stateRefs.current.notes.find((x) => x.id === id);
-    if (n) return setHighlight({ pulseKey: Date.now(), bounds: { x: n.x, y: n.y, width: n.width, height: n.height } });
-    const s = stateRefs.current.shapes.find((x) => x.id === id);
-    if (s) return setHighlight({ pulseKey: Date.now(), bounds: { x: s.x, y: s.y, width: s.width, height: s.height } });
-  };
-  const log = react.useCallback((entry) => {
-    setActivity((all) => [...all.slice(-200), { id: `a_${Date.now()}_${all.length}`, at: Date.now(), ...entry }]);
-  }, []);
-  const [session, setSession] = react.useState(null);
-  const [relayState, setRelayState] = react.useState("idle");
-  const sseRef = react.useRef(null);
-  const logEsRef = react.useRef(null);
-  const startShare = async () => {
-    if (session || !serverRef.current || !shareBaseUrl) return;
-    const desc = createSessionDescriptor();
-    try {
-      if (onRegisterSession) {
-        await onRegisterSession(desc);
-      } else {
-        const csrf = document.querySelector('meta[name="csrf-token"]')?.content ?? "";
-        const reg = await fetch(`${shareBaseUrl}/register`, {
-          method: "POST",
-          headers: { "content-type": "application/json", "x-csrf-token": csrf, accept: "application/json" },
-          body: JSON.stringify({ session: desc.id, token: desc.token })
-        });
-        if (!reg.ok) throw new Error(`registration failed (HTTP ${reg.status})`);
-      }
-    } catch (e) {
-      log({ kind: "error", source: "share", text: e instanceof Error ? e.message : String(e) });
-      return;
-    }
-    const relay = attachSseRelay(serverRef.current, {
-      baseUrl: shareBaseUrl,
-      sessionId: desc.id,
-      token: desc.token
-    });
-    sseRef.current = relay;
-    relay.onStateChange(setRelayState);
-    const es = new EventSource(`${shareBaseUrl}/${desc.id}/events?token=${desc.token}&direction=inbound`);
-    es.addEventListener("mcp", (ev) => {
-      try {
-        const frame = JSON.parse(ev.data);
-        if (frame.method === "notifications/peer_joined") {
-          setAgentCursor((c) => c ?? { userId: agent.id, name: agent.name, color: agent.color, x: 60, y: 60 });
-          log({ kind: "info", source: "presence", text: `${agent.name ?? "Agent"} connected` });
-          return;
-        }
-        if (frame.method === "notifications/peer_left") {
-          setAgentCursor(null);
-          log({ kind: "info", source: "presence", text: `${agent.name ?? "Agent"} disconnected` });
-          return;
-        }
-        if (frame.method === "notifications/agent_message") {
-          log({ kind: "message", source: agent.name ?? "Agent", text: String(frame.params?.text ?? "") });
-        } else if (frame.method === "notifications/agent_status") {
-          log({ kind: "info", source: agent.name ?? "Agent", text: String(frame.params?.text ?? "") });
-        } else if (frame.method?.startsWith("notifications/")) {
-        } else {
-          log({ kind: "tool", source: "remote", text: `\u2190 ${frame.method ?? `id:${frame.id}`}`, detail: frame });
-        }
-      } catch {
-      }
-    });
-    logEsRef.current = es;
-    setSession(desc);
-    log({ kind: "info", source: "share", text: `Sharing started \xB7 session ${desc.id}` });
-  };
-  const stopShare = async () => {
-    if (!session) return;
-    const desc = session;
-    setSession(null);
-    logEsRef.current?.close();
-    logEsRef.current = null;
-    if (sseRef.current && serverRef.current) serverRef.current.detach(sseRef.current);
-    sseRef.current = null;
-    setRelayState("closed");
-    if (shareBaseUrl) {
-      const csrf = document.querySelector('meta[name="csrf-token"]')?.content ?? "";
-      await fetch(`${shareBaseUrl}/${desc.id}/unregister?token=${encodeURIComponent(desc.token)}`, {
-        method: "POST",
-        headers: { "x-csrf-token": csrf, accept: "application/json" }
-      }).catch(() => {
-      });
-    }
-    log({ kind: "info", source: "share", text: "Sharing stopped." });
-  };
-  const lastBroadcastRef = react.useRef(0);
-  react.useEffect(() => {
-    if (!broadcastEdits || !sseRef.current || !session) return;
-    const now = Date.now();
-    if (now - lastBroadcastRef.current < 80) return;
-    lastBroadcastRef.current = now;
-    sseRef.current.send({
-      jsonrpc: "2.0",
-      method: "notifications/state_update",
-      params: { notes, shapes, connectors, viewport, ts: now }
-    });
-  }, [notes, shapes, connectors, viewport, session, broadcastEdits]);
-  const handleSubmit = (text) => {
-    if (!sseRef.current) {
-      log({ kind: "error", source: "you", text: "Start a shared session first." });
-      return;
-    }
-    sseRef.current.send({
-      jsonrpc: "2.0",
-      method: "notifications/user_message",
-      params: { text, ts: Date.now() }
-    });
-    log({ kind: "message", source: "You", text });
-  };
-  const cursors = react.useMemo(() => [], []);
-  const statusText = (() => {
-    switch (relayState) {
-      case "open":
-        return "live";
-      case "connecting":
-        return "connecting\u2026";
-      case "error":
-        return "error";
-      case "closed":
-        return "closed";
-      default:
-        return void 0;
-    }
-  })();
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: ["fai-shared-whiteboard", className ?? ""].filter(Boolean).join(" "), style, children: [
-    header,
-    showShareControls && shareBaseUrl !== null && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "fai-shared-whiteboard__controls", children: /* @__PURE__ */ jsxRuntime.jsx(ShareControls, { session, onStart: startShare, onStop: stopShare, status: statusText }) }),
-    /* @__PURE__ */ jsxRuntime.jsxs(
-      "div",
-      {
-        className: "fai-shared-whiteboard__layout",
-        style: {
-          display: "grid",
-          gap: 16,
-          gridTemplateColumns: showAgentPanel ? "1fr 360px" : "1fr"
-        },
-        children: [
-          /* @__PURE__ */ jsxRuntime.jsx(
-            "div",
-            {
-              className: "fai-shared-whiteboard__board",
-              style: {
-                position: "relative",
-                overflow: "hidden",
-                borderRadius: 12,
-                border: "1px solid #e4e4e7",
-                background: "radial-gradient(circle at 1px 1px, rgba(0,0,0,0.07) 1px, transparent 0)",
-                backgroundSize: "20px 20px",
-                height
-              },
-              children: /* @__PURE__ */ jsxRuntime.jsxs(fancyWhiteboard.Board, { viewport, onViewportChange: setViewport, style: { width: "100%", height: "100%" }, children: [
-                connectors.map((c) => {
-                  const a = resolveCenter(c.from, notes, shapes);
-                  const b = resolveCenter(c.to, notes, shapes);
-                  if (!a || !b) return null;
-                  return /* @__PURE__ */ jsxRuntime.jsx(fancyWhiteboard.Connector, { from: a, to: b, color: c.color ?? "#64748b" }, c.id);
-                }),
-                shapes.map((s) => /* @__PURE__ */ jsxRuntime.jsx(fancyWhiteboard.Shape, { item: s, onChange: (next) => setShapes((all) => all.map((x) => x.id === next.id ? next : x)) }, s.id)),
-                notes.map((n) => /* @__PURE__ */ jsxRuntime.jsx(fancyWhiteboard.StickyNote, { item: n, onChange: (next) => setNotes((all) => all.map((x) => x.id === next.id ? next : x)) }, n.id)),
-                /* @__PURE__ */ jsxRuntime.jsx(fancyWhiteboard.CursorLayer, { cursors }),
-                agentCursor && /* @__PURE__ */ jsxRuntime.jsx(AgentCursor, { x: agentCursor.x, y: agentCursor.y, name: agentCursor.name, color: agentCursor.color }),
-                highlight && /* @__PURE__ */ jsxRuntime.jsx(
-                  AgentActivityHighlight,
-                  {
-                    x: highlight.bounds.x,
-                    y: highlight.bounds.y,
-                    width: highlight.bounds.width,
-                    height: highlight.bounds.height,
-                    color: agent.color ?? "#a855f7",
-                    pulseKey: highlight.pulseKey
-                  }
-                )
-              ] })
-            }
-          ),
-          showAgentPanel && /* @__PURE__ */ jsxRuntime.jsx("div", { style: { height }, children: /* @__PURE__ */ jsxRuntime.jsx(
-            AgentPanel,
-            {
-              agent,
-              activity,
-              onSubmit: handleSubmit
-            }
-          ) })
-        ]
-      }
-    )
-  ] });
-}
-function resolveCenter(ref, notes, shapes) {
-  if (typeof ref === "string") {
-    const n = notes.find((x) => x.id === ref);
-    if (n) return { x: n.x + n.width / 2, y: n.y + n.height / 2 };
-    const s = shapes.find((x) => x.id === ref);
-    if (s) return { x: s.x + s.width / 2, y: s.y + s.height / 2 };
-    return null;
-  }
-  return ref;
-}
-
-// src/presence/index.ts
-init_registry();
-
-// src/presence/use-agent-activity.ts
-init_registry();
-function useAgentActivity(filter, options = {}) {
-  const cap = options.capacity ?? 50;
-  const [events, setEvents] = react.useState(() => readActivityHistory(filter).slice(-cap));
-  react.useEffect(() => {
-    setEvents(readActivityHistory(filter).slice(-cap));
-    return onActivity((event) => {
-      setEvents((prev) => {
-        const next = prev.length >= cap ? prev.slice(prev.length - cap + 1) : prev.slice();
-        next.push(event);
-        return next;
-      });
-    }, filter);
-  }, [filter?.agentId, filter?.screenId, filter?.kind, cap]);
-  return { events, latest: events.length > 0 ? events[events.length - 1] : null };
-}
-function useAgentActivityForScreen(screenId, options = {}) {
-  const { events, latest } = useAgentActivity({ screenId }, options);
-  const fadeAfter = latest?.ttlMs ?? 1500;
-  const [isAgentActive, setActive] = react.useState(false);
-  react.useEffect(() => {
-    if (!latest) {
-      setActive(false);
-      return;
-    }
-    setActive(true);
-    const timer = setTimeout(() => setActive(false), fadeAfter);
-    return () => clearTimeout(timer);
-  }, [latest, fadeAfter]);
-  return { events, latest, isAgentActive };
-}
-function useUndoStack(agentId, intervalMs = 500) {
-  const [history2, setHistory] = react.useState(() => readHistory(agentId));
-  react.useEffect(() => {
-    let cancelled = false;
-    const tick = () => {
-      if (cancelled) return;
-      setHistory(readHistory(agentId));
-    };
-    const id = setInterval(tick, intervalMs);
-    tick();
-    return () => {
-      cancelled = true;
-      clearInterval(id);
-    };
-  }, [agentId, intervalMs]);
-  const refresh = react.useCallback(() => setHistory(readHistory(agentId)), [agentId]);
-  return { history: history2, refresh };
-}
 
 exports.AgentActivityHighlight = AgentActivityHighlight;
 exports.AgentCursor = AgentCursor;
@@ -2946,8 +2192,8 @@ exports.MicroMcpServer = MicroMcpServer;
 exports.RelayTransport = RelayTransport;
 exports.ScreensActivityBridge = ScreensActivityBridge;
 exports.ShareControls = ShareControls;
-exports.SharedWhiteboard = SharedWhiteboard;
 exports.SseRelayTransport = SseRelayTransport;
+exports.ToolRegistry = ToolRegistry;
 exports.attachInProcess = attachInProcess;
 exports.attachRelay = attachRelay;
 exports.attachSseRelay = attachSseRelay;
@@ -2967,12 +2213,11 @@ exports.readUndoHistory = readHistory;
 exports.redoOne = redoOne;
 exports.registerChartsBridge = registerChartsBridge;
 exports.registerCodeBridge = registerCodeBridge;
-exports.registerFlowBridge = registerFlowBridge;
 exports.registerFormBridge = registerFormBridge;
 exports.registerSceneBridge = registerSceneBridge;
+exports.registerScreensBridge = registerScreensBridge;
 exports.registerSheetsBridge = registerSheetsBridge;
 exports.registerUndoTools = registerUndoTools;
-exports.registerWhiteboardBridge = registerWhiteboardBridge;
 exports.resetActivityRegistry = resetActivityRegistry;
 exports.resetAllUndoStacks = resetAllUndoStacks;
 exports.rpcError = rpcError;
@@ -2980,6 +2225,8 @@ exports.textResult = textResult;
 exports.undoOne = undoOne;
 exports.useAgentActivity = useAgentActivity;
 exports.useAgentActivityForScreen = useAgentActivityForScreen;
+exports.useSheetsActivityHighlights = useSheetsActivityHighlights;
+exports.useSheetsAdapter = useSheetsAdapter;
 exports.useUndoStack = useUndoStack;
 exports.wrapToolWithActivity = wrapToolWithActivity;
 //# sourceMappingURL=index.cjs.map