@particle-academy/agent-integrations 0.2.4 → 0.4.0

package/dist/chunk-E4AICMFZ.js

@@ -0,0 +1,83 @@
+import { onActivity } from './chunk-JU2N4KK6.js';
+import { useState, useRef, useCallback, useMemo, useEffect } from 'react';
+
+function useSheetsAdapter(initial, options = {}) {
+  const [workbook, setWorkbook] = useState(initial);
+  const [activeCell, setActiveCellState] = useState(null);
+  const workbookRef = useRef(workbook);
+  workbookRef.current = workbook;
+  const setActiveCell = useCallback((sheetId, address) => {
+    setWorkbook((cur) => cur.activeSheetId === sheetId ? cur : { ...cur, activeSheetId: sheetId });
+    setActiveCellState(address);
+  }, []);
+  const onActiveCellChange = useCallback((address) => {
+    setActiveCellState(address);
+  }, []);
+  const setWorkbookRef = useRef(setWorkbook);
+  setWorkbookRef.current = setWorkbook;
+  const adapter = 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] = useState(0);
+  const hitsRef = useRef(/* @__PURE__ */ new Map());
+  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]);
+  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,
+      background: color + "33",
+      label: event.agentName ?? event.agentId ?? "agent"
+    };
+  }
+  return out;
+}
+
+export { useSheetsActivityHighlights, useSheetsAdapter };
+//# sourceMappingURL=chunk-E4AICMFZ.js.map
+//# sourceMappingURL=chunk-E4AICMFZ.js.map

package/dist/chunk-E4AICMFZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sheets-adapter.ts"],"names":[],"mappings":"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","file":"chunk-E4AICMFZ.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 type mirror of fancy-sheets' WorkbookData — kept local so this\n// helper doesn't pull a runtime dep on the package. Apps using the helper\n// import the real `WorkbookData` from fancy-sheets and pass it through.\nexport type WorkbookLike = {\n  sheets: Array<{ id: string; name: string; [k: string]: unknown }>;\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 * Loose mirror of fancy-sheets' `CellHighlightMap`. Each key is a cell\n * address (`\"B12\"`); each value is the visual treatment to apply.\n */\nexport type SheetsCellHighlight = {\n  color?: string;\n  /** Background tint; if omitted, derived from `color` at low alpha. */\n  background?: string;\n  /** Optional label rendered in a chip on the cell. */\n  label?: string;\n  /** Optional className appended to the cell. */\n  className?: 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      background: color + \"33\",\n      label: event.agentName ?? event.agentId ?? \"agent\",\n    };\n  }\n  return out;\n}\n"]}

package/dist/chunk-GQ7XXK7G.js

@@ -0,0 +1,124 @@
+import { errorResult, textResult } from './chunk-4KAIV6OD.js';
+
+// 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
+        }
+      },
+      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 history = readHistory(agentOf(args)).map(serialize);
+        const text = history.map((e) => `${new Date(e.timestamp).toISOString()} ${e.bridgeId} ${e.action}: ${e.label}`).join("\n");
+        return textResult(text || "(empty)", history);
+      }
+    )
+  );
+  return () => disposers.forEach((d) => d());
+}
+function serialize(entry) {
+  return {
+    timestamp: entry.timestamp,
+    bridgeId: entry.bridgeId,
+    action: entry.action,
+    label: entry.label
+  };
+}
+
+export { clearStack, ensureUndoToolsRegistered, pushUndoEntry, readHistory, redoOne, registerUndoTools, resetAllUndoStacks, undoOne };
+//# sourceMappingURL=chunk-GQ7XXK7G.js.map
+//# sourceMappingURL=chunk-GQ7XXK7G.js.map

package/dist/chunk-GQ7XXK7G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/undo/undo-stack.ts","../src/undo/undo-tools.ts"],"names":[],"mappings":"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","file":"chunk-GQ7XXK7G.js","sourcesContent":["/**\n * Generic undo/redo stack keyed by `agentId`. Each entry holds:\n *  - `do` — re-applies the action (for redo)\n *  - `undo` — reverses it\n *  - `label` — human-readable summary surfaced in agent_history\n *\n * Bridges register entries by calling `pushUndoEntry` after a successful\n * mutation. The corresponding MCP tools (`agent_undo`, `agent_redo`,\n * `agent_history`) are registered once per server via `registerUndoTools`.\n *\n * Stacks are per-agent so multiple agents can rewind independently.\n */\n\nexport type UndoEntry = {\n  /** Wall-clock ms. */\n  timestamp: number;\n  /** Bridge id (e.g. \"whiteboard\", \"form:signup\"). */\n  bridgeId: string;\n  /** Tool name that produced the entry. */\n  action: string;\n  /** Short human label, e.g. `Added sticky n_abc`. */\n  label: string;\n  /** Reverse the action. */\n  undo: () => void | Promise<void>;\n  /** Re-apply the action (used when redoing after an undo). */\n  redo: () => void | Promise<void>;\n};\n\ntype Stack = { past: UndoEntry[]; future: UndoEntry[] };\n\nconst stacks = new Map<string, Stack>();\nconst CAP = 200;\n\nfunction getStack(agentId: string): Stack {\n  let s = stacks.get(agentId);\n  if (!s) {\n    s = { past: [], future: [] };\n    stacks.set(agentId, s);\n  }\n  return s;\n}\n\n/** Push a new undo entry on the agent's stack. Clears the redo (future) stack. */\nexport function pushUndoEntry(agentId: string, entry: UndoEntry): void {\n  const s = getStack(agentId);\n  s.past.push(entry);\n  if (s.past.length > CAP) s.past.splice(0, s.past.length - CAP);\n  s.future.length = 0;\n}\n\n/** Pop and undo the most recent entry. Returns the entry that ran, or null. */\nexport async function undoOne(agentId: string): Promise<UndoEntry | null> {\n  const s = getStack(agentId);\n  const entry = s.past.pop();\n  if (!entry) return null;\n  await entry.undo();\n  s.future.push(entry);\n  return entry;\n}\n\n/** Re-apply the most recently undone entry. Returns it, or null if no future. */\nexport async function redoOne(agentId: string): Promise<UndoEntry | null> {\n  const s = getStack(agentId);\n  const entry = s.future.pop();\n  if (!entry) return null;\n  await entry.redo();\n  s.past.push(entry);\n  return entry;\n}\n\n/** Read the past stack (oldest first). */\nexport function readHistory(agentId: string): UndoEntry[] {\n  return getStack(agentId).past.slice();\n}\n\n/** Wipe an agent's stacks. */\nexport function clearStack(agentId: string): void {\n  stacks.delete(agentId);\n}\n\n/** Test/teardown helper. */\nexport function resetAllUndoStacks(): void {\n  stacks.clear();\n}\n","import { textResult, errorResult } from \"../mcp/server\";\nimport type { ToolHost } from \"../mcp/tool-host\";\nimport { readHistory, redoOne, undoOne } from \"./undo-stack\";\n\nexport type UndoToolsOptions = {\n  /** Default agent id when the caller doesn't pass one. */\n  defaultAgentId?: string;\n};\n\n/**\n * Idempotent tracker so multiple bridges on the same server only register\n * agent_undo / agent_redo / agent_history once.\n */\nconst installedHosts = new WeakSet<ToolHost>();\n\n/**\n * ensureUndoToolsRegistered — bridges call this on construction. Safe to\n * call repeatedly with the same server; subsequent calls are no-ops.\n */\nexport function ensureUndoToolsRegistered(host: ToolHost, options: UndoToolsOptions = {}): void {\n  if (installedHosts.has(host)) return;\n  installedHosts.add(host);\n  registerUndoTools(host, options);\n}\n\n/**\n * registerUndoTools — add agent_undo / agent_redo / agent_history to the\n * server. Returns a disposer that unregisters all three.\n */\nexport function registerUndoTools(host: ToolHost, options: UndoToolsOptions = {}): () => void {\n  const defaultAgent = options.defaultAgentId ?? \"agent\";\n  const disposers: Array<() => void> = [];\n  const agentOf = (args: any): string =>\n    typeof args?.agentId === \"string\" ? args.agentId : defaultAgent;\n\n  disposers.push(\n    host.registerTool(\n      {\n        name: \"agent_undo\",\n        description: \"Undo the most recent action on the agent's stack. Optional agentId targets a specific agent.\",\n        inputSchema: {\n          type: \"object\",\n          properties: { agentId: { type: \"string\" } },\n          additionalProperties: false,\n        },\n      },\n      async (args) => {\n        const entry = await undoOne(agentOf(args));\n        if (!entry) return errorResult(\"Nothing to undo.\");\n        return textResult(`Undid: ${entry.label}`, { entry: serialize(entry) });\n      },\n    ),\n  );\n\n  disposers.push(\n    host.registerTool(\n      {\n        name: \"agent_redo\",\n        description: \"Redo the most recently undone action.\",\n        inputSchema: {\n          type: \"object\",\n          properties: { agentId: { type: \"string\" } },\n          additionalProperties: false,\n        },\n      },\n      async (args) => {\n        const entry = await redoOne(agentOf(args));\n        if (!entry) return errorResult(\"Nothing to redo.\");\n        return textResult(`Redid: ${entry.label}`, { entry: serialize(entry) });\n      },\n    ),\n  );\n\n  disposers.push(\n    host.registerTool(\n      {\n        name: \"agent_history\",\n        description: \"List the agent's undo stack (oldest first). Useful for understanding what's reversible.\",\n        inputSchema: {\n          type: \"object\",\n          properties: { agentId: { type: \"string\" } },\n          additionalProperties: false,\n        },\n      },\n      async (args) => {\n        const history = readHistory(agentOf(args)).map(serialize);\n        const text = history.map((e) => `${new Date(e.timestamp).toISOString()} ${e.bridgeId} ${e.action}: ${e.label}`).join(\"\\n\");\n        return textResult(text || \"(empty)\", history);\n      },\n    ),\n  );\n\n  return () => disposers.forEach((d) => d());\n}\n\nfunction serialize(entry: import(\"./undo-stack\").UndoEntry) {\n  return {\n    timestamp: entry.timestamp,\n    bridgeId: entry.bridgeId,\n    action: entry.action,\n    label: entry.label,\n  };\n}\n"]}

package/dist/chunk-HSTW7ZNO.js

@@ -0,0 +1,172 @@
+import { wrapToolWithActivity } from './chunk-52S7XYZK.js';
+import { textResult, errorResult } from './chunk-4KAIV6OD.js';
+
+// src/bridges/code.ts
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerCodeBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
+  const disposers = [];
+  const target = {
+    kind: "code",
+    screenId: adapter.screenId,
+    elementId: adapter.id,
+    label: adapter.title ?? adapter.id
+  };
+  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,
+      kind: "code",
+      screenId: adapter.screenId,
+      resolveTarget: () => target
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        {
+          name,
+          description,
+          inputSchema: { type: "object", properties, required, additionalProperties: false }
+        },
+        final
+      )
+    );
+  };
+  reg(
+    "code_describe",
+    `Describe the editor "${adapter.id}" \u2014 language + length + has-selection.`,
+    {},
+    [],
+    () => {
+      const value = adapter.getValue();
+      const language = adapter.getLanguage?.() ?? "unknown";
+      const summary = { id: adapter.id, language, length: value.length, lines: value.split("\n").length };
+      return textResult(JSON.stringify(summary), summary);
+    },
+    false
+  );
+  reg(
+    "code_get_value",
+    "Read the full document text.",
+    {},
+    [],
+    () => {
+      const value = adapter.getValue();
+      return textResult(value, { value });
+    },
+    false
+  );
+  reg(
+    "code_get_selection",
+    "Read the currently-selected text (empty string if no selection).",
+    {},
+    [],
+    () => {
+      if (!adapter.getSelection) return errorResult("Host did not provide getSelection.");
+      const value = adapter.getSelection();
+      return textResult(value, { value });
+    },
+    false
+  );
+  reg(
+    "code_set_value",
+    "Replace the entire document.",
+    { value: { type: "string" } },
+    ["value"],
+    (args) => {
+      const value = String(args.value ?? "");
+      adapter.setValue(value);
+      return textResult(`Replaced document (${value.length} chars)`, { length: value.length });
+    },
+    true
+  );
+  reg(
+    "code_append",
+    "Append text to the end of the document.",
+    { text: { type: "string" } },
+    ["text"],
+    (args) => {
+      const text = String(args.text ?? "");
+      const next = adapter.getValue() + text;
+      adapter.setValue(next);
+      return textResult(`Appended ${text.length} chars`, { length: next.length });
+    },
+    true
+  );
+  reg(
+    "code_stream_append",
+    "Type characters into the document one at a time so the human can read it forming. Returns when streaming finishes.",
+    {
+      text: { type: "string" },
+      cps: { type: "number", description: "Characters per second. Default 25." }
+    },
+    ["text"],
+    async (args) => {
+      const text = String(args.text ?? "");
+      const cps = Math.max(1, Number(args.cps ?? 25));
+      const interval = Math.max(8, Math.round(1e3 / cps));
+      const start = adapter.getValue();
+      for (let i = 1; i <= text.length; i++) {
+        adapter.setValue(start + text.slice(0, i));
+        if (i < text.length) await new Promise((r) => setTimeout(r, interval));
+      }
+      return textResult(`Streamed ${text.length} chars`, { length: text.length });
+    },
+    true
+  );
+  reg(
+    "code_replace_selection",
+    "Replace the currently-selected text with the supplied text.",
+    { text: { type: "string" } },
+    ["text"],
+    (args) => {
+      if (!adapter.replaceSelection) return errorResult("Host did not provide replaceSelection.");
+      adapter.replaceSelection(String(args.text ?? ""));
+      return textResult("Selection replaced", {});
+    },
+    true
+  );
+  reg(
+    "code_set_language",
+    "Switch the active syntax highlighting / formatter.",
+    { language: { type: "string", description: "e.g. 'javascript', 'php', 'sql'." } },
+    ["language"],
+    (args) => {
+      if (!adapter.setLanguage) return errorResult("Host did not provide setLanguage.");
+      const lang = String(args.language ?? "");
+      adapter.setLanguage(lang);
+      return textResult(`Language \u2192 ${lang}`, { language: lang });
+    },
+    true
+  );
+  reg(
+    "code_focus",
+    "Move browser focus to the editor.",
+    {},
+    [],
+    () => {
+      if (!adapter.focus) return errorResult("Host did not provide focus.");
+      adapter.focus();
+      return textResult("Focused", {});
+    },
+    true
+  );
+  return {
+    id: `code:${adapter.id}`,
+    title: adapter.title ?? adapter.id,
+    dispose: () => {
+      for (const d of disposers) d();
+    }
+  };
+}
+
+export { registerCodeBridge };
+//# sourceMappingURL=chunk-HSTW7ZNO.js.map
+//# sourceMappingURL=chunk-HSTW7ZNO.js.map

package/dist/chunk-HSTW7ZNO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/code.ts"],"names":[],"mappings":";;;;AAuCA,IAAM,gBAAgB,EAAE,EAAA,EAAI,SAAS,IAAA,EAAM,OAAA,EAAS,OAAO,SAAA,EAAU;AAQ9D,SAAS,kBAAA,CACd,MACA,OAAA,EACQ;AACR,EAAA,MAAM,EAAE,SAAQ,GAAI,OAAA;AACpB,EAAA,MAAM,KAAA,GAAQ,EAAE,GAAG,aAAA,EAAe,GAAI,OAAA,CAAQ,KAAA,IAAS,EAAC,EAAG;AAC3D,EAAA,MAAM,YAA+B,EAAC;AAEtC,EAAA,MAAM,MAAA,GAAsB;AAAA,IAC1B,IAAA,EAAM,MAAA;AAAA,IACN,UAAU,OAAA,CAAQ,QAAA;AAAA,IAClB,WAAW,OAAA,CAAQ,EAAA;AAAA,IACnB,KAAA,EAAO,OAAA,CAAQ,KAAA,IAAS,OAAA,CAAQ;AAAA,GAClC;AAEA,EAAA,MAAM,MAAM,CACV,IAAA,EACA,aACA,UAAA,EACA,QAAA,EACA,SACA,UAAA,KACG;AACH,IAAA,MAAM,OAAA,GAAU,OAAO,IAAA,KAAqB;AAC1C,MAAA,IAAI;AACF,QAAA,OAAO,MAAM,QAAQ,IAAI,CAAA;AAAA,MAC3B,SAAS,CAAA,EAAG;AACV,QAAA,OAAO,YAAY,CAAA,YAAa,KAAA,GAAQ,EAAE,OAAA,GAAU,MAAA,CAAO,CAAC,CAAC,CAAA;AAAA,MAC/D;AAAA,IACF,CAAA;AACA,IAAA,MAAM,KAAA,GAAQ,UAAA,GACV,oBAAA,CAAqB,OAAA,EAAS;AAAA,MAC5B,QAAA,EAAU,IAAA;AAAA,MACV,KAAA;AAAA,MACA,IAAA,EAAM,MAAA;AAAA,MACN,UAAU,OAAA,CAAQ,QAAA;AAAA,MAClB,eAAe,MAAM;AAAA,KACtB,CAAA,GACD,OAAA;AACJ,IAAA,SAAA,CAAU,IAAA;AAAA,MACR,IAAA,CAAK,YAAA;AAAA,QACH;AAAA,UACE,IAAA;AAAA,UACA,WAAA;AAAA,UACA,aAAa,EAAE,IAAA,EAAM,UAAU,UAAA,EAA+B,QAAA,EAAU,sBAAsB,KAAA;AAAM,SACtG;AAAA,QACA;AAAA;AACF,KACF;AAAA,EACF,CAAA;AAEA,EAAA,GAAA;AAAA,IACE,eAAA;AAAA,IACA,CAAA,qBAAA,EAAwB,QAAQ,EAAE,CAAA,2CAAA,CAAA;AAAA,IAClC,EAAC;AAAA,IACD,EAAC;AAAA,IACD,MAAM;AACJ,MAAA,MAAM,KAAA,GAAQ,QAAQ,QAAA,EAAS;AAC/B,MAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,WAAA,IAAc,IAAK,SAAA;AAC5C,MAAA,MAAM,OAAA,GAAU,EAAE,EAAA,EAAI,OAAA,CAAQ,IAAI,QAAA,EAAU,MAAA,EAAQ,KAAA,CAAM,MAAA,EAAQ,KAAA,EAAO,KAAA,CAAM,KAAA,CAAM,IAAI,EAAE,MAAA,EAAO;AAClG,MAAA,OAAO,UAAA,CAAW,IAAA,CAAK,SAAA,CAAU,OAAO,GAAG,OAAO,CAAA;AAAA,IACpD,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,GAAA;AAAA,IACE,gBAAA;AAAA,IACA,8BAAA;AAAA,IACA,EAAC;AAAA,IACD,EAAC;AAAA,IACD,MAAM;AACJ,MAAA,MAAM,KAAA,GAAQ,QAAQ,QAAA,EAAS;AAC/B,MAAA,OAAO,UAAA,CAAW,KAAA,EAAO,EAAE,KAAA,EAAO,CAAA;AAAA,IACpC,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,GAAA;AAAA,IACE,oBAAA;AAAA,IACA,kEAAA;AAAA,IACA,EAAC;AAAA,IACD,EAAC;AAAA,IACD,MAAM;AACJ,MAAA,IAAI,CAAC,OAAA,CAAQ,YAAA,EAAc,OAAO,YAAY,oCAAoC,CAAA;AAClF,MAAA,MAAM,KAAA,GAAQ,QAAQ,YAAA,EAAa;AACnC,MAAA,OAAO,UAAA,CAAW,KAAA,EAAO,EAAE,KAAA,EAAO,CAAA;AAAA,IACpC,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,GAAA;AAAA,IACE,gBAAA;AAAA,IACA,8BAAA;AAAA,IACA,EAAE,KAAA,EAAO,EAAE,IAAA,EAAM,UAAS,EAAE;AAAA,IAC5B,CAAC,OAAO,CAAA;AAAA,IACR,CAAC,IAAA,KAAS;AACR,MAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,KAAA,IAAS,EAAE,CAAA;AACrC,MAAA,OAAA,CAAQ,SAAS,KAAK,CAAA;AACtB,MAAA,OAAO,UAAA,CAAW,sBAAsB,KAAA,CAAM,MAAM,WAAW,EAAE,MAAA,EAAQ,KAAA,CAAM,MAAA,EAAQ,CAAA;AAAA,IACzF,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,GAAA;AAAA,IACE,aAAA;AAAA,IACA,yCAAA;AAAA,IACA,EAAE,IAAA,EAAM,EAAE,IAAA,EAAM,UAAS,EAAE;AAAA,IAC3B,CAAC,MAAM,CAAA;AAAA,IACP,CAAC,IAAA,KAAS;AACR,MAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,CAAK,IAAA,IAAQ,EAAE,CAAA;AACnC,MAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,QAAA,EAAS,GAAI,IAAA;AAClC,MAAA,OAAA,CAAQ,SAAS,IAAI,CAAA;AACrB,MAAA,OAAO,UAAA,CAAW,YAAY,IAAA,CAAK,MAAM,UAAU,EAAE,MAAA,EAAQ,IAAA,CAAK,MAAA,EAAQ,CAAA;AAAA,IAC5E,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,GAAA;AAAA,IACE,oBAAA;AAAA,IACA,oHAAA;AAAA,IACA;AAAA,MACE,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,MACvB,GAAA,EAAK,EAAE,IAAA,EAAM,QAAA,EAAU,aAAa,oCAAA;AAAqC,KAC3E;AAAA,IACA,CAAC,MAAM,CAAA;AAAA,IACP,OAAO,IAAA,KAAS;AACd,MAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,CAAK,IAAA,IAAQ,EAAE,CAAA;AACnC,MAAA,MAAM,GAAA,GAAM,KAAK,GAAA,CAAI,CAAA,EAAG,OAAO,IAAA,CAAK,GAAA,IAAO,EAAE,CAAC,CAAA;AAC9C,MAAA,MAAM,QAAA,GAAW,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,KAAA,CAAM,GAAA,GAAO,GAAG,CAAC,CAAA;AACnD,MAAA,MAAM,KAAA,GAAQ,QAAQ,QAAA,EAAS;AAC/B,MAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,IAAK,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AACrC,QAAA,OAAA,CAAQ,SAAS,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA;AACzC,QAAA,IAAI,CAAA,GAAI,IAAA,CAAK,MAAA,EAAQ,MAAM,IAAI,OAAA,CAAQ,CAAC,CAAA,KAAM,UAAA,CAAW,CAAA,EAAG,QAAQ,CAAC,CAAA;AAAA,MACvE;AACA,MAAA,OAAO,UAAA,CAAW,YAAY,IAAA,CAAK,MAAM,UAAU,EAAE,MAAA,EAAQ,IAAA,CAAK,MAAA,EAAQ,CAAA;AAAA,IAC5E,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,GAAA;AAAA,IACE,wBAAA;AAAA,IACA,6DAAA;AAAA,IACA,EAAE,IAAA,EAAM,EAAE,IAAA,EAAM,UAAS,EAAE;AAAA,IAC3B,CAAC,MAAM,CAAA;AAAA,IACP,CAAC,IAAA,KAAS;AACR,MAAA,IAAI,CAAC,OAAA,CAAQ,gBAAA,EAAkB,OAAO,YAAY,wCAAwC,CAAA;AAC1F,MAAA,OAAA,CAAQ,gBAAA,CAAiB,MAAA,CAAO,IAAA,CAAK,IAAA,IAAQ,EAAE,CAAC,CAAA;AAChD,MAAA,OAAO,UAAA,CAAW,oBAAA,EAAsB,EAAG,CAAA;AAAA,IAC7C,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,GAAA;AAAA,IACE,mBAAA;AAAA,IACA,oDAAA;AAAA,IACA,EAAE,QAAA,EAAU,EAAE,MAAM,QAAA,EAAU,WAAA,EAAa,oCAAmC,EAAE;AAAA,IAChF,CAAC,UAAU,CAAA;AAAA,IACX,CAAC,IAAA,KAAS;AACR,MAAA,IAAI,CAAC,OAAA,CAAQ,WAAA,EAAa,OAAO,YAAY,mCAAmC,CAAA;AAChF,MAAA,MAAM,IAAA,GAAO,MAAA,CAAO,IAAA,CAAK,QAAA,IAAY,EAAE,CAAA;AACvC,MAAA,OAAA,CAAQ,YAAY,IAAI,CAAA;AACxB,MAAA,OAAO,WAAW,CAAA,gBAAA,EAAc,IAAI,IAAI,EAAE,QAAA,EAAU,MAAM,CAAA;AAAA,IAC5D,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,GAAA;AAAA,IACE,YAAA;AAAA,IACA,mCAAA;AAAA,IACA,EAAC;AAAA,IACD,EAAC;AAAA,IACD,MAAM;AACJ,MAAA,IAAI,CAAC,OAAA,CAAQ,KAAA,EAAO,OAAO,YAAY,6BAA6B,CAAA;AACpE,MAAA,OAAA,CAAQ,KAAA,EAAM;AACd,MAAA,OAAO,UAAA,CAAW,SAAA,EAAW,EAAG,CAAA;AAAA,IAClC,CAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,CAAA,KAAA,EAAQ,OAAA,CAAQ,EAAE,CAAA,CAAA;AAAA,IACtB,KAAA,EAAO,OAAA,CAAQ,KAAA,IAAS,OAAA,CAAQ,EAAA;AAAA,IAChC,SAAS,MAAM;AACb,MAAA,KAAA,MAAW,CAAA,IAAK,WAAW,CAAA,EAAE;AAAA,IAC/B;AAAA,GACF;AACF","file":"chunk-HSTW7ZNO.js","sourcesContent":["import { 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 } from \"../presence/types\";\n\n/**\n * Adapter the host wires to a fancy-code CodeEditor (typically via the\n * useCodeEditor hook's context value).\n */\nexport type CodeBridgeAdapter = {\n  /** Stable id for this editor instance. */\n  id: string;\n  /** Display label. */\n  title?: string;\n  /** Optional fancy-screens screen id. */\n  screenId?: string;\n  /** Read the current document text. */\n  getValue: () => string;\n  /** Replace the document. */\n  setValue: (value: string) => void;\n  /** Read the current selection text (empty string if none). */\n  getSelection?: () => string;\n  /** Replace the current selection with text. */\n  replaceSelection?: (text: string) => void;\n  /** Programmatic focus. */\n  focus?: () => void;\n  /** Read / set the active language. */\n  getLanguage?: () => string;\n  /** Set the active language. */\n  setLanguage?: (lang: string) => void;\n};\n\nexport type CodeBridgeOptions = {\n  adapter: CodeBridgeAdapter;\n  agent?: { id: string; name?: string; color?: string };\n};\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\n\n/**\n * registerCodeBridge — schema-aware MCP access to a single CodeEditor.\n * Tools cover read, full replace, append, selection replace, language\n * switch, and a streaming append helper for \"type characters into the\n * editor over time\" UX.\n */\nexport function registerCodeBridge(\n  host: ToolHost,\n  options: CodeBridgeOptions,\n): Bridge {\n  const { adapter } = options;\n  const agent = { ...DEFAULT_AGENT, ...(options.agent ?? {}) };\n  const disposers: Array<() => void> = [];\n\n  const target: AgentTarget = {\n    kind: \"code\",\n    screenId: adapter.screenId,\n    elementId: adapter.id,\n    label: adapter.title ?? adapter.id,\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    isMutation: boolean,\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 = isMutation\n      ? wrapToolWithActivity(wrapped, {\n          toolName: name,\n          agent,\n          kind: \"code\",\n          screenId: adapter.screenId,\n          resolveTarget: () => target,\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  reg(\n    \"code_describe\",\n    `Describe the editor \"${adapter.id}\" — language + length + has-selection.`,\n    {},\n    [],\n    () => {\n      const value = adapter.getValue();\n      const language = adapter.getLanguage?.() ?? \"unknown\";\n      const summary = { id: adapter.id, language, length: value.length, lines: value.split(\"\\n\").length };\n      return textResult(JSON.stringify(summary), summary);\n    },\n    false,\n  );\n\n  reg(\n    \"code_get_value\",\n    \"Read the full document text.\",\n    {},\n    [],\n    () => {\n      const value = adapter.getValue();\n      return textResult(value, { value });\n    },\n    false,\n  );\n\n  reg(\n    \"code_get_selection\",\n    \"Read the currently-selected text (empty string if no selection).\",\n    {},\n    [],\n    () => {\n      if (!adapter.getSelection) return errorResult(\"Host did not provide getSelection.\");\n      const value = adapter.getSelection();\n      return textResult(value, { value });\n    },\n    false,\n  );\n\n  reg(\n    \"code_set_value\",\n    \"Replace the entire document.\",\n    { value: { type: \"string\" } },\n    [\"value\"],\n    (args) => {\n      const value = String(args.value ?? \"\");\n      adapter.setValue(value);\n      return textResult(`Replaced document (${value.length} chars)`, { length: value.length });\n    },\n    true,\n  );\n\n  reg(\n    \"code_append\",\n    \"Append text to the end of the document.\",\n    { text: { type: \"string\" } },\n    [\"text\"],\n    (args) => {\n      const text = String(args.text ?? \"\");\n      const next = adapter.getValue() + text;\n      adapter.setValue(next);\n      return textResult(`Appended ${text.length} chars`, { length: next.length });\n    },\n    true,\n  );\n\n  reg(\n    \"code_stream_append\",\n    \"Type characters into the document one at a time so the human can read it forming. Returns when streaming finishes.\",\n    {\n      text: { type: \"string\" },\n      cps: { type: \"number\", description: \"Characters per second. Default 25.\" },\n    },\n    [\"text\"],\n    async (args) => {\n      const text = String(args.text ?? \"\");\n      const cps = Math.max(1, Number(args.cps ?? 25));\n      const interval = Math.max(8, Math.round(1000 / cps));\n      const start = adapter.getValue();\n      for (let i = 1; i <= text.length; i++) {\n        adapter.setValue(start + text.slice(0, i));\n        if (i < text.length) await new Promise((r) => setTimeout(r, interval));\n      }\n      return textResult(`Streamed ${text.length} chars`, { length: text.length });\n    },\n    true,\n  );\n\n  reg(\n    \"code_replace_selection\",\n    \"Replace the currently-selected text with the supplied text.\",\n    { text: { type: \"string\" } },\n    [\"text\"],\n    (args) => {\n      if (!adapter.replaceSelection) return errorResult(\"Host did not provide replaceSelection.\");\n      adapter.replaceSelection(String(args.text ?? \"\"));\n      return textResult(\"Selection replaced\", { });\n    },\n    true,\n  );\n\n  reg(\n    \"code_set_language\",\n    \"Switch the active syntax highlighting / formatter.\",\n    { language: { type: \"string\", description: \"e.g. 'javascript', 'php', 'sql'.\" } },\n    [\"language\"],\n    (args) => {\n      if (!adapter.setLanguage) return errorResult(\"Host did not provide setLanguage.\");\n      const lang = String(args.language ?? \"\");\n      adapter.setLanguage(lang);\n      return textResult(`Language → ${lang}`, { language: lang });\n    },\n    true,\n  );\n\n  reg(\n    \"code_focus\",\n    \"Move browser focus to the editor.\",\n    {},\n    [],\n    () => {\n      if (!adapter.focus) return errorResult(\"Host did not provide focus.\");\n      adapter.focus();\n      return textResult(\"Focused\", { });\n    },\n    true,\n  );\n\n  return {\n    id: `code:${adapter.id}`,\n    title: adapter.title ?? adapter.id,\n    dispose: () => {\n      for (const d of disposers) d();\n    },\n  };\n}\n"]}