@particle-academy/agent-integrations 0.2.4 → 0.3.4

package/dist/chunk-OEIULP2L.js

@@ -0,0 +1,158 @@
+import { wrapToolWithActivity } from './chunk-52S7XYZK.js';
+import { textResult, errorResult } from './chunk-QGCF7YKW.js';
+
+// src/bridges/forms.ts
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerFormBridge(server, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT, ...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
+  );
+  reg(
+    "form_focus",
+    "Move browser focus to a field (host-implemented). Useful before streaming text into it.",
+    { field: { type: "string" } },
+    ["field"],
+    (args) => {
+      const name = String(args.field ?? "");
+      if (!adapter.focus) return errorResult("Host did not provide a focus implementation.");
+      if (!adapter.getFields().find((f) => f.name === name)) {
+        return errorResult(`Unknown field: ${name}`);
+      }
+      adapter.focus(name);
+      return textResult(`Focused ${name}`, { field: name });
+    },
+    true
+  );
+  reg(
+    "form_submit",
+    "Submit the form. Host returns ok + values (or an error).",
+    {},
+    [],
+    async () => {
+      if (!adapter.submit) return errorResult("Host did not provide a submit implementation.");
+      const result = await adapter.submit();
+      if (!result.ok) return errorResult(result.error ?? "Submit failed");
+      return textResult("Submitted", { values: result.values });
+    },
+    true
+  );
+  return {
+    id: `form:${formId}`,
+    title: adapter.title ?? formId,
+    dispose: () => {
+      for (const d of disposers) d();
+    }
+  };
+}
+
+export { registerFormBridge };
+//# sourceMappingURL=chunk-OEIULP2L.js.map
+//# sourceMappingURL=chunk-OEIULP2L.js.map

package/dist/chunk-OEIULP2L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/forms.ts"],"names":[],"mappings":"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","file":"chunk-OEIULP2L.js","sourcesContent":["import { textResult, errorResult } from \"../mcp/server\";\nimport type { MicroMcpServer } from \"../mcp/server\";\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 * Field descriptor — what the host says about each form field. Mirrors the\n * subset of HTML / react-fancy input shapes agents care about.\n */\nexport type FormFieldDescriptor = {\n  /** Form-local field name. Matches the key the host uses in its values map. */\n  name: string;\n  /** Display label. */\n  label?: string;\n  /** Logical type. Drives validation + agent expectations. */\n  type:\n    | \"text\"\n    | \"textarea\"\n    | \"number\"\n    | \"email\"\n    | \"password\"\n    | \"url\"\n    | \"date\"\n    | \"select\"\n    | \"multi-select\"\n    | \"checkbox\"\n    | \"switch\"\n    | \"radio\"\n    | \"file\"\n    | \"json\";\n  /** Allowed values for select / radio. */\n  options?: Array<{ value: string; label: string }>;\n  /** Whether the field must be filled before submit. */\n  required?: boolean;\n  /** Free-text hint surfaced to the agent. */\n  description?: string;\n  /** Default value (presented in get_value when nothing set). */\n  defaultValue?: unknown;\n};\n\n/**\n * Adapter the host wires per form. Matches the controlled-state pattern\n * react-fancy already uses (`value` / `onValueChange`); this adapter just\n * exposes those state slots in a form-shaped way the bridge can call.\n */\nexport type FormBridgeAdapter = {\n  /** Stable id for the form (used in form_describe + presence target). */\n  id: string;\n  /** Display title for human-readable logs. */\n  title?: string;\n  /** Optional fancy-screens screen id this form belongs to. */\n  screenId?: string;\n  /** Field descriptors. The bridge uses these for schema introspection\n   *  (form_describe). Agents call this first to know what to fill. */\n  getFields: () => FormFieldDescriptor[];\n  /** Read a single field's current value. */\n  getValue: (name: string) => unknown;\n  /** Read all values as { fieldName: value }. */\n  getValues: () => Record<string, unknown>;\n  /** Set a single field's value. The host wires this to its setState. */\n  setValue: (name: string, value: unknown) => void;\n  /** Set many at once. Defaults to calling setValue in a loop. */\n  setValues?: (values: Record<string, unknown>) => void;\n  /** Programmatically focus a field (host implements DOM focus). Optional. */\n  focus?: (name: string) => void;\n  /** Submit the form. Returns the values that were submitted (or rejection). */\n  submit?: () => Promise<{ ok: boolean; values?: Record<string, unknown>; error?: string }>;\n};\n\nexport type FormBridgeOptions = {\n  adapter: FormBridgeAdapter;\n  /** Identity tagged into activity events. */\n  agent?: { id: string; name?: string; color?: string };\n};\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\n\n/**\n * registerFormBridge — wires schema-driven MCP access to a single form.\n * Hosts can register multiple bridges (one per form on the screen) by\n * giving each adapter a distinct `id`.\n */\nexport function registerFormBridge(\n  server: MicroMcpServer,\n  options: FormBridgeOptions,\n): Bridge {\n  const { adapter } = options;\n  const agent = { ...DEFAULT_AGENT, ...(options.agent ?? {}) };\n  const disposers: Array<() => void> = [];\n  const formId = adapter.id;\n\n  const target = (args: any): AgentTarget => ({\n    kind: \"form\",\n    screenId: adapter.screenId,\n    elementId: typeof args?.field === \"string\" ? `${formId}:${args.field}` : formId,\n    label: typeof args?.field === \"string\"\n      ? `${adapter.title ?? formId} → ${args.field}`\n      : adapter.title ?? formId,\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: { id: agent.id, name: agent.name, color: agent.color },\n          kind: \"form\",\n          screenId: adapter.screenId,\n          resolveTarget: ({ args }) => target(args),\n        })\n      : wrapped;\n    disposers.push(\n      server.registerTool(\n        {\n          name,\n          description,\n          inputSchema: { type: \"object\", properties: properties as any, required, additionalProperties: false },\n        },\n        final as any,\n      ),\n    );\n  };\n\n  // ───────────── Read tools ─────────────\n\n  reg(\n    \"form_describe\",\n    `Describe the form \"${formId}\" — fields, types, options, required flags. Call this first to know what's fillable.`,\n    {},\n    [],\n    () => {\n      const fields = adapter.getFields();\n      const text = fields\n        .map((f) => `${f.name}${f.required ? \"*\" : \"\"} (${f.type})${f.label ? ` — ${f.label}` : \"\"}`)\n        .join(\"\\n\");\n      return textResult(text || \"(no fields)\", { id: formId, title: adapter.title, fields });\n    },\n    false,\n  );\n\n  reg(\n    \"form_get_value\",\n    \"Read a single field's current value.\",\n    { field: { type: \"string\" } },\n    [\"field\"],\n    (args) => {\n      const name = String(args.field ?? \"\");\n      if (!adapter.getFields().find((f) => f.name === name)) {\n        return errorResult(`Unknown field: ${name}`);\n      }\n      const value = adapter.getValue(name);\n      return textResult(JSON.stringify(value), { field: name, value });\n    },\n    false,\n  );\n\n  reg(\n    \"form_get_values\",\n    \"Read every field's current value as a JSON object.\",\n    {},\n    [],\n    () => {\n      const values = adapter.getValues();\n      return textResult(JSON.stringify(values, null, 2), values);\n    },\n    false,\n  );\n\n  // ───────────── Mutation tools ─────────────\n\n  reg(\n    \"form_set_value\",\n    \"Set one field's value. The host's controlled state updates and the human sees the field change.\",\n    {\n      field: { type: \"string\" },\n      value: { description: \"Value to set. Type depends on the field's `type`.\" },\n    },\n    [\"field\", \"value\"],\n    (args) => {\n      const name = String(args.field ?? \"\");\n      const fieldDef = adapter.getFields().find((f) => f.name === name);\n      if (!fieldDef) return errorResult(`Unknown field: ${name}`);\n      adapter.setValue(name, args.value);\n      return textResult(`${name} ← ${JSON.stringify(args.value)}`, { field: name, value: args.value });\n    },\n    true,\n  );\n\n  reg(\n    \"form_set_values\",\n    \"Set multiple fields atomically. Pass a `values` object keyed by field name.\",\n    { values: { type: \"object\" } },\n    [\"values\"],\n    (args) => {\n      const values = (args.values && typeof args.values === \"object\") ? args.values as Record<string, unknown> : {};\n      const fields = adapter.getFields();\n      const known = new Set(fields.map((f) => f.name));\n      const unknownKeys = Object.keys(values).filter((k) => !known.has(k));\n      if (unknownKeys.length) return errorResult(`Unknown fields: ${unknownKeys.join(\", \")}`);\n      if (adapter.setValues) {\n        adapter.setValues(values);\n      } else {\n        for (const [k, v] of Object.entries(values)) adapter.setValue(k, v);\n      }\n      return textResult(`Set ${Object.keys(values).length} field(s)`, { values });\n    },\n    true,\n  );\n\n  reg(\n    \"form_focus\",\n    \"Move browser focus to a field (host-implemented). Useful before streaming text into it.\",\n    { field: { type: \"string\" } },\n    [\"field\"],\n    (args) => {\n      const name = String(args.field ?? \"\");\n      if (!adapter.focus) return errorResult(\"Host did not provide a focus implementation.\");\n      if (!adapter.getFields().find((f) => f.name === name)) {\n        return errorResult(`Unknown field: ${name}`);\n      }\n      adapter.focus(name);\n      return textResult(`Focused ${name}`, { field: name });\n    },\n    true,\n  );\n\n  reg(\n    \"form_submit\",\n    \"Submit the form. Host returns ok + values (or an error).\",\n    {},\n    [],\n    async () => {\n      if (!adapter.submit) return errorResult(\"Host did not provide a submit implementation.\");\n      const result = await adapter.submit();\n      if (!result.ok) return errorResult(result.error ?? \"Submit failed\");\n      return textResult(\"Submitted\", { values: result.values });\n    },\n    true,\n  );\n\n  return {\n    id: `form:${formId}`,\n    title: adapter.title ?? formId,\n    dispose: () => {\n      for (const d of disposers) d();\n    },\n  };\n}\n"]}

package/dist/chunk-PDBF4W7E.js

@@ -0,0 +1,280 @@
+import { wrapToolWithActivity } from './chunk-52S7XYZK.js';
+import { textResult, errorResult } from './chunk-QGCF7YKW.js';
+
+// src/bridges/sheets.ts
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerSheetsBridge(server, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
+  const disposers = [];
+  const target = (sheetId, address) => ({
+    kind: "sheet",
+    screenId: adapter.screenId,
+    elementId: address ? `${sheetId}!${address}` : sheetId,
+    label: address ? `${sheetId}!${address}` : sheetId
+  });
+  const reg = (name, description, properties, required, handler, isMutation, resolveTarget) => {
+    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: "sheet",
+      screenId: adapter.screenId,
+      resolveTarget: ({ args, result }) => resolveTarget?.(args, result) ?? target(getSheetId(args))
+    }) : wrapped;
+    disposers.push(
+      server.registerTool(
+        {
+          name,
+          description,
+          inputSchema: { type: "object", properties, required, additionalProperties: false }
+        },
+        final
+      )
+    );
+  };
+  function activeSheetId() {
+    return adapter.getWorkbook().activeSheetId;
+  }
+  function getSheetId(args) {
+    return typeof args.sheet === "string" ? args.sheet : activeSheetId();
+  }
+  function getSheet(workbook, sheetId) {
+    return workbook.sheets.find((s) => s.id === sheetId);
+  }
+  reg(
+    "sheet_describe",
+    "Describe the workbook: every sheet's id, name, dimensions, cell count, active sheet. Call before reading or writing.",
+    {},
+    [],
+    () => {
+      const wb = adapter.getWorkbook();
+      const summary = {
+        activeSheetId: wb.activeSheetId,
+        sheets: wb.sheets.map((s) => ({
+          id: s.id,
+          name: s.name,
+          cellCount: Object.keys(s.cells).length,
+          columnCount: Object.keys(s.columnWidths).length,
+          frozenRows: s.frozenRows,
+          frozenCols: s.frozenCols
+        }))
+      };
+      const text = `Active: ${summary.activeSheetId}
+` + summary.sheets.map((s) => `${s.id} "${s.name}" \u2014 ${s.cellCount} cells`).join("\n");
+      return textResult(text, summary);
+    },
+    false
+  );
+  reg(
+    "sheet_get_cell",
+    "Read a single cell's raw + computed value.",
+    {
+      sheet: { type: "string", description: "Sheet id (defaults to active)." },
+      address: { type: "string", description: 'A1-style address, e.g. "B12".' }
+    },
+    ["address"],
+    (args) => {
+      const sheetId = getSheetId(args);
+      const address = String(args.address);
+      const sheet = getSheet(adapter.getWorkbook(), sheetId);
+      if (!sheet) return errorResult(`No sheet ${sheetId}`);
+      const cell = sheet.cells[address];
+      if (!cell) {
+        return textResult(`(empty)`, { sheet: sheetId, address, value: null });
+      }
+      return textResult(`${address} = ${JSON.stringify(cell.computedValue ?? cell.value)}`, { ...cell, sheet: sheetId, address });
+    },
+    false
+  );
+  reg(
+    "sheet_get_range",
+    "Read a rectangular range as a 2D array of values.",
+    {
+      sheet: { type: "string" },
+      start: { type: "string", description: "Top-left A1 address." },
+      end: { type: "string", description: "Bottom-right A1 address." }
+    },
+    ["start", "end"],
+    (args) => {
+      const sheetId = getSheetId(args);
+      const sheet = getSheet(adapter.getWorkbook(), sheetId);
+      if (!sheet) return errorResult(`No sheet ${sheetId}`);
+      const grid = readRange(sheet, String(args.start), String(args.end));
+      return textResult(JSON.stringify(grid), { sheet: sheetId, start: args.start, end: args.end, values: grid });
+    },
+    false
+  );
+  reg(
+    "sheet_set_cell",
+    "Set a single cell's value. To set a formula, pass a string starting with '='.",
+    {
+      sheet: { type: "string" },
+      address: { type: "string" },
+      value: { description: "string | number | boolean | null. Strings starting with '=' are stored as formulas." }
+    },
+    ["address", "value"],
+    (args) => {
+      const sheetId = getSheetId(args);
+      const address = String(args.address);
+      const value = args.value;
+      const wb = adapter.getWorkbook();
+      const sheet = getSheet(wb, sheetId);
+      if (!sheet) return errorResult(`No sheet ${sheetId}`);
+      const next = mergeCells(wb, sheetId, { [address]: cellOf(address, value) });
+      adapter.setWorkbook(next);
+      return textResult(`${sheetId}!${address} \u2190 ${JSON.stringify(value)}`, { sheet: sheetId, address, value });
+    },
+    true,
+    (args) => target(getSheetId(args), String(args.address ?? ""))
+  );
+  reg(
+    "sheet_set_range",
+    'Set many cells atomically. `cells` is an object map of { "A1": value, "B2": value, ... }.',
+    {
+      sheet: { type: "string" },
+      cells: { type: "object" }
+    },
+    ["cells"],
+    (args) => {
+      const sheetId = getSheetId(args);
+      const wb = adapter.getWorkbook();
+      const sheet = getSheet(wb, sheetId);
+      if (!sheet) return errorResult(`No sheet ${sheetId}`);
+      const cells = args.cells && typeof args.cells === "object" ? args.cells : {};
+      const updates = {};
+      for (const [addr, v] of Object.entries(cells)) updates[addr] = cellOf(addr, v);
+      const next = mergeCells(wb, sheetId, updates);
+      adapter.setWorkbook(next);
+      return textResult(`Set ${Object.keys(cells).length} cells in ${sheetId}`, { sheet: sheetId, count: Object.keys(cells).length });
+    },
+    true
+  );
+  reg(
+    "sheet_add_sheet",
+    "Add a new sheet (tab) to the workbook.",
+    { id: { type: "string" }, name: { type: "string" } },
+    ["id", "name"],
+    (args) => {
+      const wb = adapter.getWorkbook();
+      const id = String(args.id);
+      const name = String(args.name);
+      if (wb.sheets.find((s) => s.id === id)) return errorResult(`Sheet ${id} already exists`);
+      const next = {
+        ...wb,
+        sheets: [
+          ...wb.sheets,
+          {
+            id,
+            name,
+            cells: {},
+            columnWidths: {},
+            mergedRegions: [],
+            columnFilters: {},
+            frozenRows: 0,
+            frozenCols: 0
+          }
+        ]
+      };
+      adapter.setWorkbook(next);
+      return textResult(`Added sheet ${id} ("${name}")`, { id, name });
+    },
+    true,
+    (args) => target(String(args.id ?? ""))
+  );
+  reg(
+    "sheet_set_active",
+    "Switch to a different sheet tab.",
+    { sheet: { type: "string" } },
+    ["sheet"],
+    (args) => {
+      const sheetId = String(args.sheet);
+      const wb = adapter.getWorkbook();
+      if (!getSheet(wb, sheetId)) return errorResult(`No sheet ${sheetId}`);
+      adapter.setWorkbook({ ...wb, activeSheetId: sheetId });
+      return textResult(`Active sheet \u2192 ${sheetId}`, { sheet: sheetId });
+    },
+    true
+  );
+  reg(
+    "sheet_set_active_cell",
+    "Move the active cell selection (host implements DOM focus + scroll).",
+    { sheet: { type: "string" }, address: { type: "string" } },
+    ["address"],
+    (args) => {
+      if (!adapter.setActiveCell) return errorResult("Host did not provide setActiveCell.");
+      const sheetId = getSheetId(args);
+      adapter.setActiveCell(sheetId, String(args.address));
+      return textResult(`Active cell \u2192 ${sheetId}!${args.address}`, { sheet: sheetId, address: args.address });
+    },
+    true,
+    (args) => target(getSheetId(args), String(args.address ?? ""))
+  );
+  return {
+    id: "sheets",
+    title: "Sheets",
+    dispose: () => {
+      for (const d of disposers) d();
+    }
+  };
+}
+function cellOf(address, value) {
+  return { address, value };
+}
+function mergeCells(wb, sheetId, updates) {
+  return {
+    ...wb,
+    sheets: wb.sheets.map(
+      (s) => s.id !== sheetId ? s : { ...s, cells: { ...s.cells, ...updates } }
+    )
+  };
+}
+function parseAddress(addr) {
+  const m = /^([A-Za-z]+)(\d+)$/.exec(addr.trim());
+  if (!m) throw new Error(`Bad address: ${addr}`);
+  const letters = m[1].toUpperCase();
+  let col = 0;
+  for (let i = 0; i < letters.length; i++) {
+    col = col * 26 + (letters.charCodeAt(i) - 64);
+  }
+  return { col: col - 1, row: parseInt(m[2], 10) - 1 };
+}
+function colToLetter(col) {
+  let s = "";
+  let n = col + 1;
+  while (n > 0) {
+    const r = (n - 1) % 26;
+    s = String.fromCharCode(65 + r) + s;
+    n = Math.floor((n - 1) / 26);
+  }
+  return s;
+}
+function readRange(sheet, startAddr, endAddr) {
+  const start = parseAddress(startAddr);
+  const end = parseAddress(endAddr);
+  const r0 = Math.min(start.row, end.row);
+  const r1 = Math.max(start.row, end.row);
+  const c0 = Math.min(start.col, end.col);
+  const c1 = Math.max(start.col, end.col);
+  const grid = [];
+  for (let r = r0; r <= r1; r++) {
+    const row = [];
+    for (let c = c0; c <= c1; c++) {
+      const addr = `${colToLetter(c)}${r + 1}`;
+      const cell = sheet.cells[addr];
+      row.push(cell?.computedValue ?? cell?.value ?? null);
+    }
+    grid.push(row);
+  }
+  return grid;
+}
+
+export { registerSheetsBridge };
+//# sourceMappingURL=chunk-PDBF4W7E.js.map
+//# sourceMappingURL=chunk-PDBF4W7E.js.map

package/dist/chunk-PDBF4W7E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/sheets.ts"],"names":[],"mappings":"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","file":"chunk-PDBF4W7E.js","sourcesContent":["import { textResult, errorResult } from \"../mcp/server\";\nimport type { MicroMcpServer } from \"../mcp/server\";\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 * Loose types — kept here so the bridge builds without a hard dep on\n * @particle-academy/fancy-sheets. They mirror the public surface of\n * `WorkbookData` / `SheetData` / `CellData` from that package.\n */\ntype CellValue = string | number | boolean | null;\ntype CellData = { address: string; value: CellValue; format?: unknown; comment?: unknown; computedValue?: CellValue };\ntype SheetData = {\n  id: string;\n  name: string;\n  cells: Record<string, CellData>;\n  columnWidths: Record<number, number>;\n  mergedRegions: Array<{ start: string; end: string }>;\n  columnFilters: Record<number, string>;\n  sortColumn?: number;\n  sortDirection?: \"asc\" | \"desc\";\n  frozenRows: number;\n  frozenCols: number;\n};\ntype WorkbookData = { sheets: SheetData[]; activeSheetId: string };\n\nexport type SheetsBridgeAdapter = {\n  /** fancy-screens screen id (optional) so activity events know which screen the sheet lives in. */\n  screenId?: string;\n  /** Read the current workbook. */\n  getWorkbook: () => WorkbookData;\n  /** Replace the workbook. Host wires this to its onChange. */\n  setWorkbook: (next: WorkbookData) => void;\n  /** Optional: programmatically change the active cell. */\n  setActiveCell?: (sheetId: string, address: string) => void;\n};\n\nexport type SheetsBridgeOptions = {\n  adapter: SheetsBridgeAdapter;\n  agent?: { id: string; name?: string; color?: string };\n};\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\n\n/**\n * registerSheetsBridge — schema-aware MCP access to a fancy-sheets workbook.\n * Tools are sheet-aware (every mutator takes an explicit `sheet` id, defaulting\n * to the active sheet when omitted) so an agent can author multi-sheet docs.\n */\nexport function registerSheetsBridge(\n  server: MicroMcpServer,\n  options: SheetsBridgeOptions,\n): Bridge {\n  const { adapter } = options;\n  const agent = { ...DEFAULT_AGENT, ...(options.agent ?? {}) };\n  const disposers: Array<() => void> = [];\n\n  const target = (sheetId: string, address?: string): AgentTarget => ({\n    kind: \"sheet\",\n    screenId: adapter.screenId,\n    elementId: address ? `${sheetId}!${address}` : sheetId,\n    label: address ? `${sheetId}!${address}` : sheetId,\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    resolveTarget?: (args: JsonObject, result: any) => AgentTarget | null,\n  ) => {\n    const wrapped = async (args: JsonObject) => {\n      try {\n        return await handler(args);\n      } catch (e) {\n        return errorResult(e instanceof Error ? e.message : String(e));\n      }\n    };\n    const final = isMutation\n      ? wrapToolWithActivity(wrapped, {\n          toolName: name,\n          agent,\n          kind: \"sheet\",\n          screenId: adapter.screenId,\n          resolveTarget: ({ args, result }) =>\n            resolveTarget?.(args, result) ?? target(getSheetId(args)),\n        })\n      : wrapped;\n    disposers.push(\n      server.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  function activeSheetId(): string {\n    return adapter.getWorkbook().activeSheetId;\n  }\n  function getSheetId(args: JsonObject): string {\n    return typeof args.sheet === \"string\" ? args.sheet : activeSheetId();\n  }\n  function getSheet(workbook: WorkbookData, sheetId: string): SheetData | undefined {\n    return workbook.sheets.find((s) => s.id === sheetId);\n  }\n\n  // ───────────── Read tools ─────────────\n\n  reg(\n    \"sheet_describe\",\n    \"Describe the workbook: every sheet's id, name, dimensions, cell count, active sheet. Call before reading or writing.\",\n    {},\n    [],\n    () => {\n      const wb = adapter.getWorkbook();\n      const summary = {\n        activeSheetId: wb.activeSheetId,\n        sheets: wb.sheets.map((s) => ({\n          id: s.id,\n          name: s.name,\n          cellCount: Object.keys(s.cells).length,\n          columnCount: Object.keys(s.columnWidths).length,\n          frozenRows: s.frozenRows,\n          frozenCols: s.frozenCols,\n        })),\n      };\n      const text = `Active: ${summary.activeSheetId}\\n` + summary.sheets\n        .map((s) => `${s.id} \"${s.name}\" — ${s.cellCount} cells`)\n        .join(\"\\n\");\n      return textResult(text, summary);\n    },\n    false,\n  );\n\n  reg(\n    \"sheet_get_cell\",\n    \"Read a single cell's raw + computed value.\",\n    {\n      sheet: { type: \"string\", description: \"Sheet id (defaults to active).\" },\n      address: { type: \"string\", description: \"A1-style address, e.g. \\\"B12\\\".\" },\n    },\n    [\"address\"],\n    (args) => {\n      const sheetId = getSheetId(args);\n      const address = String(args.address);\n      const sheet = getSheet(adapter.getWorkbook(), sheetId);\n      if (!sheet) return errorResult(`No sheet ${sheetId}`);\n      const cell = sheet.cells[address];\n      if (!cell) {\n        return textResult(`(empty)`, { sheet: sheetId, address, value: null });\n      }\n      return textResult(`${address} = ${JSON.stringify(cell.computedValue ?? cell.value)}`, { ...cell, sheet: sheetId, address });\n    },\n    false,\n  );\n\n  reg(\n    \"sheet_get_range\",\n    \"Read a rectangular range as a 2D array of values.\",\n    {\n      sheet: { type: \"string\" },\n      start: { type: \"string\", description: \"Top-left A1 address.\" },\n      end: { type: \"string\", description: \"Bottom-right A1 address.\" },\n    },\n    [\"start\", \"end\"],\n    (args) => {\n      const sheetId = getSheetId(args);\n      const sheet = getSheet(adapter.getWorkbook(), sheetId);\n      if (!sheet) return errorResult(`No sheet ${sheetId}`);\n      const grid = readRange(sheet, String(args.start), String(args.end));\n      return textResult(JSON.stringify(grid), { sheet: sheetId, start: args.start, end: args.end, values: grid });\n    },\n    false,\n  );\n\n  // ───────────── Mutation tools ─────────────\n\n  reg(\n    \"sheet_set_cell\",\n    \"Set a single cell's value. To set a formula, pass a string starting with '='.\",\n    {\n      sheet: { type: \"string\" },\n      address: { type: \"string\" },\n      value: { description: \"string | number | boolean | null. Strings starting with '=' are stored as formulas.\" },\n    },\n    [\"address\", \"value\"],\n    (args) => {\n      const sheetId = getSheetId(args);\n      const address = String(args.address);\n      const value = args.value as CellValue;\n      const wb = adapter.getWorkbook();\n      const sheet = getSheet(wb, sheetId);\n      if (!sheet) return errorResult(`No sheet ${sheetId}`);\n      const next = mergeCells(wb, sheetId, { [address]: cellOf(address, value) });\n      adapter.setWorkbook(next);\n      return textResult(`${sheetId}!${address} ← ${JSON.stringify(value)}`, { sheet: sheetId, address, value });\n    },\n    true,\n    (args) => target(getSheetId(args), String(args.address ?? \"\")),\n  );\n\n  reg(\n    \"sheet_set_range\",\n    \"Set many cells atomically. `cells` is an object map of { \\\"A1\\\": value, \\\"B2\\\": value, ... }.\",\n    {\n      sheet: { type: \"string\" },\n      cells: { type: \"object\" },\n    },\n    [\"cells\"],\n    (args) => {\n      const sheetId = getSheetId(args);\n      const wb = adapter.getWorkbook();\n      const sheet = getSheet(wb, sheetId);\n      if (!sheet) return errorResult(`No sheet ${sheetId}`);\n      const cells = (args.cells && typeof args.cells === \"object\") ? args.cells as Record<string, CellValue> : {};\n      const updates: Record<string, CellData> = {};\n      for (const [addr, v] of Object.entries(cells)) updates[addr] = cellOf(addr, v);\n      const next = mergeCells(wb, sheetId, updates);\n      adapter.setWorkbook(next);\n      return textResult(`Set ${Object.keys(cells).length} cells in ${sheetId}`, { sheet: sheetId, count: Object.keys(cells).length });\n    },\n    true,\n  );\n\n  reg(\n    \"sheet_add_sheet\",\n    \"Add a new sheet (tab) to the workbook.\",\n    { id: { type: \"string\" }, name: { type: \"string\" } },\n    [\"id\", \"name\"],\n    (args) => {\n      const wb = adapter.getWorkbook();\n      const id = String(args.id);\n      const name = String(args.name);\n      if (wb.sheets.find((s) => s.id === id)) return errorResult(`Sheet ${id} already exists`);\n      const next: WorkbookData = {\n        ...wb,\n        sheets: [\n          ...wb.sheets,\n          {\n            id, name, cells: {}, columnWidths: {}, mergedRegions: [],\n            columnFilters: {}, frozenRows: 0, frozenCols: 0,\n          },\n        ],\n      };\n      adapter.setWorkbook(next);\n      return textResult(`Added sheet ${id} (\"${name}\")`, { id, name });\n    },\n    true,\n    (args) => target(String(args.id ?? \"\")),\n  );\n\n  reg(\n    \"sheet_set_active\",\n    \"Switch to a different sheet tab.\",\n    { sheet: { type: \"string\" } },\n    [\"sheet\"],\n    (args) => {\n      const sheetId = String(args.sheet);\n      const wb = adapter.getWorkbook();\n      if (!getSheet(wb, sheetId)) return errorResult(`No sheet ${sheetId}`);\n      adapter.setWorkbook({ ...wb, activeSheetId: sheetId });\n      return textResult(`Active sheet → ${sheetId}`, { sheet: sheetId });\n    },\n    true,\n  );\n\n  reg(\n    \"sheet_set_active_cell\",\n    \"Move the active cell selection (host implements DOM focus + scroll).\",\n    { sheet: { type: \"string\" }, address: { type: \"string\" } },\n    [\"address\"],\n    (args) => {\n      if (!adapter.setActiveCell) return errorResult(\"Host did not provide setActiveCell.\");\n      const sheetId = getSheetId(args);\n      adapter.setActiveCell(sheetId, String(args.address));\n      return textResult(`Active cell → ${sheetId}!${args.address}`, { sheet: sheetId, address: args.address });\n    },\n    true,\n    (args) => target(getSheetId(args), String(args.address ?? \"\")),\n  );\n\n  return {\n    id: \"sheets\",\n    title: \"Sheets\",\n    dispose: () => {\n      for (const d of disposers) d();\n    },\n  };\n}\n\n// ───────────── helpers ─────────────\n\nfunction cellOf(address: string, value: CellValue): CellData {\n  return { address, value };\n}\n\nfunction mergeCells(wb: WorkbookData, sheetId: string, updates: Record<string, CellData>): WorkbookData {\n  return {\n    ...wb,\n    sheets: wb.sheets.map((s) =>\n      s.id !== sheetId ? s : { ...s, cells: { ...s.cells, ...updates } },\n    ),\n  };\n}\n\n/** Parse \"B12\" → { col: 1, row: 11 }. Letters are 1-based, rows 1-based. */\nfunction parseAddress(addr: string): { col: number; row: number } {\n  const m = /^([A-Za-z]+)(\\d+)$/.exec(addr.trim());\n  if (!m) throw new Error(`Bad address: ${addr}`);\n  const letters = m[1].toUpperCase();\n  let col = 0;\n  for (let i = 0; i < letters.length; i++) {\n    col = col * 26 + (letters.charCodeAt(i) - 64);\n  }\n  return { col: col - 1, row: parseInt(m[2], 10) - 1 };\n}\n\nfunction colToLetter(col: number): string {\n  let s = \"\";\n  let n = col + 1;\n  while (n > 0) {\n    const r = (n - 1) % 26;\n    s = String.fromCharCode(65 + r) + s;\n    n = Math.floor((n - 1) / 26);\n  }\n  return s;\n}\n\nfunction readRange(sheet: SheetData, startAddr: string, endAddr: string): CellValue[][] {\n  const start = parseAddress(startAddr);\n  const end = parseAddress(endAddr);\n  const r0 = Math.min(start.row, end.row);\n  const r1 = Math.max(start.row, end.row);\n  const c0 = Math.min(start.col, end.col);\n  const c1 = Math.max(start.col, end.col);\n  const grid: CellValue[][] = [];\n  for (let r = r0; r <= r1; r++) {\n    const row: CellValue[] = [];\n    for (let c = c0; c <= c1; c++) {\n      const addr = `${colToLetter(c)}${r + 1}`;\n      const cell = sheet.cells[addr];\n      row.push(cell?.computedValue ?? cell?.value ?? null);\n    }\n    grid.push(row);\n  }\n  return grid;\n}\n"]}

package/dist/chunk-PHPXKSWI.js

@@ -0,0 +1,120 @@
+import { wrapToolWithActivity } from './chunk-52S7XYZK.js';
+import { textResult, errorResult } from './chunk-QGCF7YKW.js';
+
+// src/bridges/charts.ts
+var DEFAULT_AGENT = { id: "agent", name: "Agent", color: "#a855f7" };
+function registerChartsBridge(server, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
+  const disposers = [];
+  const target = {
+    kind: "chart",
+    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: "chart",
+      screenId: adapter.screenId,
+      resolveTarget: () => target
+    }) : wrapped;
+    disposers.push(
+      server.registerTool(
+        { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
+        final
+      )
+    );
+  };
+  reg(
+    "chart_describe",
+    `Describe the chart "${adapter.id}" \u2014 series count, type guesses, axis info.`,
+    {},
+    [],
+    () => {
+      const opt = adapter.getOption();
+      const series = Array.isArray(opt.series) ? opt.series : [];
+      const summary = {
+        id: adapter.id,
+        title: adapter.title,
+        seriesCount: series.length,
+        seriesTypes: series.map((s) => s?.type ?? "unknown"),
+        hasXAxis: !!opt.xAxis,
+        hasYAxis: !!opt.yAxis
+      };
+      return textResult(JSON.stringify(summary), summary);
+    },
+    false
+  );
+  reg(
+    "chart_get_option",
+    "Read the full ECharts option object the chart is rendering.",
+    {},
+    [],
+    () => {
+      const opt = adapter.getOption();
+      return textResult(JSON.stringify(opt, null, 2), opt);
+    },
+    false
+  );
+  reg(
+    "chart_set_option",
+    "Replace the entire ECharts option. Use chart_update_option for partial updates.",
+    { option: { type: "object" } },
+    ["option"],
+    (args) => {
+      const opt = args.option && typeof args.option === "object" ? args.option : {};
+      adapter.setOption(opt);
+      return textResult("Replaced chart option", {});
+    },
+    true
+  );
+  reg(
+    "chart_update_option",
+    "Shallow-merge a partial option update \u2014 only the keys you provide change.",
+    { partial: { type: "object" } },
+    ["partial"],
+    (args) => {
+      const partial = args.partial && typeof args.partial === "object" ? args.partial : {};
+      if (adapter.updateOption) {
+        adapter.updateOption(partial);
+      } else {
+        adapter.setOption({ ...adapter.getOption(), ...partial });
+      }
+      return textResult("Merged chart option", { keys: Object.keys(partial) });
+    },
+    true
+  );
+  reg(
+    "chart_update_data",
+    "Update only the data (typically the `series` field). Leaves layout / axes / colors alone.",
+    { data: { description: "New series array (or whatever shape the host's adapter expects)." } },
+    ["data"],
+    (args) => {
+      if (!adapter.updateData) return errorResult("Host did not provide updateData.");
+      adapter.updateData(args.data);
+      return textResult("Updated chart data", {});
+    },
+    true
+  );
+  return {
+    id: `chart:${adapter.id}`,
+    title: adapter.title ?? adapter.id,
+    dispose: () => {
+      for (const d of disposers) d();
+    }
+  };
+}
+
+export { registerChartsBridge };
+//# sourceMappingURL=chunk-PHPXKSWI.js.map
+//# sourceMappingURL=chunk-PHPXKSWI.js.map

package/dist/chunk-PHPXKSWI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridges/charts.ts"],"names":[],"mappings":"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","file":"chunk-PHPXKSWI.js","sourcesContent":["import { textResult, errorResult } from \"../mcp/server\";\nimport type { MicroMcpServer } from \"../mcp/server\";\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 wires a single fancy-echarts chart to the bridge. Charts are\n * already prop-driven, so the adapter just exposes the data + option\n * setters and a way to read what's currently rendered.\n */\nexport type ChartsBridgeAdapter = {\n  /** Stable id for this chart instance. */\n  id: string;\n  title?: string;\n  screenId?: string;\n  /** Read the current ECharts option object the chart is rendering. */\n  getOption: () => Record<string, unknown>;\n  /** Replace the entire option. */\n  setOption: (option: Record<string, unknown>) => void;\n  /** Convenience: shallow-merge a partial option update. */\n  updateOption?: (partial: Record<string, unknown>) => void;\n  /** Read just the data series (subset of option for quick agent reads). */\n  getData?: () => unknown;\n  /** Update only the data, leaving axes/colors/etc. alone. */\n  updateData?: (data: unknown) => void;\n};\n\nexport type ChartsBridgeOptions = {\n  adapter: ChartsBridgeAdapter;\n  agent?: { id: string; name?: string; color?: string };\n};\n\nconst DEFAULT_AGENT = { id: \"agent\", name: \"Agent\", color: \"#a855f7\" };\n\n/**\n * registerChartsBridge — schema-aware MCP access to a single chart.\n */\nexport function registerChartsBridge(\n  server: MicroMcpServer,\n  options: ChartsBridgeOptions,\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: \"chart\",\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 { return await handler(args); }\n      catch (e) { return errorResult(e instanceof Error ? e.message : String(e)); }\n    };\n    const final = isMutation\n      ? wrapToolWithActivity(wrapped, {\n          toolName: name, agent, kind: \"chart\", screenId: adapter.screenId,\n          resolveTarget: () => target,\n        })\n      : wrapped;\n    disposers.push(\n      server.registerTool(\n        { name, description, inputSchema: { type: \"object\", properties: properties as any, required, additionalProperties: false } },\n        final as any,\n      ),\n    );\n  };\n\n  reg(\n    \"chart_describe\",\n    `Describe the chart \"${adapter.id}\" — series count, type guesses, axis info.`,\n    {},\n    [],\n    () => {\n      const opt = adapter.getOption();\n      const series = Array.isArray(opt.series) ? opt.series : [];\n      const summary = {\n        id: adapter.id,\n        title: adapter.title,\n        seriesCount: series.length,\n        seriesTypes: series.map((s: any) => s?.type ?? \"unknown\"),\n        hasXAxis: !!opt.xAxis,\n        hasYAxis: !!opt.yAxis,\n      };\n      return textResult(JSON.stringify(summary), summary);\n    },\n    false,\n  );\n\n  reg(\n    \"chart_get_option\",\n    \"Read the full ECharts option object the chart is rendering.\",\n    {},\n    [],\n    () => {\n      const opt = adapter.getOption();\n      return textResult(JSON.stringify(opt, null, 2), opt);\n    },\n    false,\n  );\n\n  reg(\n    \"chart_set_option\",\n    \"Replace the entire ECharts option. Use chart_update_option for partial updates.\",\n    { option: { type: \"object\" } },\n    [\"option\"],\n    (args) => {\n      const opt = (args.option && typeof args.option === \"object\") ? args.option as Record<string, unknown> : {};\n      adapter.setOption(opt);\n      return textResult(\"Replaced chart option\", { });\n    },\n    true,\n  );\n\n  reg(\n    \"chart_update_option\",\n    \"Shallow-merge a partial option update — only the keys you provide change.\",\n    { partial: { type: \"object\" } },\n    [\"partial\"],\n    (args) => {\n      const partial = (args.partial && typeof args.partial === \"object\") ? args.partial as Record<string, unknown> : {};\n      if (adapter.updateOption) {\n        adapter.updateOption(partial);\n      } else {\n        adapter.setOption({ ...adapter.getOption(), ...partial });\n      }\n      return textResult(\"Merged chart option\", { keys: Object.keys(partial) });\n    },\n    true,\n  );\n\n  reg(\n    \"chart_update_data\",\n    \"Update only the data (typically the `series` field). Leaves layout / axes / colors alone.\",\n    { data: { description: \"New series array (or whatever shape the host's adapter expects).\" } },\n    [\"data\"],\n    (args) => {\n      if (!adapter.updateData) return errorResult(\"Host did not provide updateData.\");\n      adapter.updateData(args.data);\n      return textResult(\"Updated chart data\", { });\n    },\n    true,\n  );\n\n  return {\n    id: `chart:${adapter.id}`,\n    title: adapter.title ?? adapter.id,\n    dispose: () => { for (const d of disposers) d(); },\n  };\n}\n"]}