@particle-academy/agent-integrations 0.22.0 → 0.24.0

package/dist/index.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 var fancyAutoCommon = require('@particle-academy/fancy-auto-common');
+var fancySheets = require('@particle-academy/fancy-sheets');
 var react = require('react');
 var fancySlides = require('@particle-academy/fancy-slides');
 var jsxRuntime = require('react/jsx-runtime');
@@ -437,8 +438,6 @@ function registerFormBridge(host, options) {
     }
   };
 }
-
-// src/bridges/sheets.ts
 var DEFAULT_AGENT2 = { id: "agent", name: "Agent", color: "#a855f7" };
 function registerSheetsBridge(host, options) {
   const { adapter } = options;
@@ -562,10 +561,8 @@ function registerSheetsBridge(host, options) {
       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);
+      if (!getSheet(wb, sheetId)) return errorResult(`No sheet ${sheetId}`);
+      adapter.setWorkbook(fancySheets.reduceWorkbook(wb, setCellOp(sheetId, address, value)));
       return textResult(`${sheetId}!${address} \u2190 ${JSON.stringify(value)}`, { sheet: sheetId, address, value });
     },
     true,
@@ -582,12 +579,10 @@ function registerSheetsBridge(host, options) {
     (args) => {
       const sheetId = getSheetId(args);
       const wb = adapter.getWorkbook();
-      const sheet = getSheet(wb, sheetId);
-      if (!sheet) return errorResult(`No sheet ${sheetId}`);
+      if (!getSheet(wb, sheetId)) 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);
+      let next = wb;
+      for (const [addr, v] of Object.entries(cells)) next = fancySheets.reduceWorkbook(next, setCellOp(sheetId, addr, v));
       adapter.setWorkbook(next);
       return textResult(`Set ${Object.keys(cells).length} cells in ${sheetId}`, { sheet: sheetId, count: Object.keys(cells).length });
     },
@@ -661,16 +656,11 @@ function registerSheetsBridge(host, options) {
     }
   };
 }
-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 setCellOp(sheet, address, value) {
+  if (typeof value === "string" && value.startsWith("=")) {
+    return { type: "set_cell", sheet, address, value, formula: value.slice(1) };
+  }
+  return { type: "set_cell", sheet, address, value };
 }
 function parseAddress(addr) {
   const m = /^([A-Za-z]+)(\d+)$/.exec(addr.trim());
@@ -1567,7 +1557,7 @@ function registerSlidesBridge(host, options) {
     ["title"],
     (args) => {
       const title = str(args.title);
-      adapter.apply({ kind: "deck_set_title", title });
+      adapter.apply({ op: "deck.setTitle", title });
       return textResult(`Title set to "${title}"`, { title });
     },
     true,
@@ -1588,7 +1578,7 @@ function registerSlidesBridge(host, options) {
       } else {
         return errorResult("theme must be a string name or an object with a `name` field.");
       }
-      adapter.apply({ kind: "deck_apply_theme", theme });
+      adapter.apply({ op: "deck.setTheme", theme });
       return textResult(`Applied theme: ${theme.name}`, { theme });
     },
     true,
@@ -1610,7 +1600,7 @@ function registerSlidesBridge(host, options) {
       } catch (e) {
         return errorResult(e instanceof Error ? e.message : String(e));
       }
-      adapter.apply({ kind: "deck_set", deck });
+      adapter.apply({ op: "deck.replace", deck });
       return textResult(`Loaded deck "${deck.title}" (${deck.slides.length} slides)`, { id: deck.id, slides: deck.slides.length });
     },
     true,
@@ -1637,7 +1627,7 @@ function registerSlidesBridge(host, options) {
         metadata: incoming.metadata
       };
       const index = clamp(num(args.index, deck.slides.length), 0, deck.slides.length);
-      adapter.apply({ kind: "slide_add", index, slide });
+      adapter.apply({ op: "slide.add", index, slide });
       return textResult(`Added slide ${slide.id} at index ${index}`, { id: slide.id, index });
     },
     true,
@@ -1650,7 +1640,7 @@ function registerSlidesBridge(host, options) {
     ["id"],
     (args) => {
       const id = str(args.id);
-      adapter.apply({ kind: "slide_remove", id });
+      adapter.apply({ op: "slide.remove", slideId: id });
       return textResult(`Removed slide ${id}`, { id });
     },
     true,
@@ -1664,7 +1654,7 @@ function registerSlidesBridge(host, options) {
     (args) => {
       const id = str(args.id);
       const toIndex = num(args.toIndex, 0);
-      adapter.apply({ kind: "slide_reorder", id, toIndex });
+      adapter.apply({ op: "slide.reorder", slideId: id, toIndex });
       return textResult(`Moved slide ${id} \u2192 ${toIndex}`, { id, toIndex });
     },
     true,
@@ -1678,7 +1668,7 @@ function registerSlidesBridge(host, options) {
     (args) => {
       const id = str(args.id);
       const layout = str(args.layout);
-      adapter.apply({ kind: "slide_set_layout", id, layout: layout ?? "blank" });
+      adapter.apply({ op: "slide.setLayout", slideId: id, layout: layout ?? "blank" });
       return textResult(`Slide ${id} layout \u2192 ${layout}`, { id, layout });
     },
     true,
@@ -1692,7 +1682,7 @@ function registerSlidesBridge(host, options) {
     (args) => {
       const id = str(args.id);
       const notes = str(args.notes);
-      adapter.apply({ kind: "slide_set_notes", id, notes });
+      adapter.apply({ op: "slide.setNotes", slideId: id, notes });
       return textResult(`Notes updated on slide ${id}`, { id });
     },
     true,
@@ -1709,7 +1699,7 @@ function registerSlidesBridge(host, options) {
     (args) => {
       const id = str(args.id);
       const bg = args.background && typeof args.background === "object" ? args.background : void 0;
-      adapter.apply({ kind: "slide_set_background", id, background: bg });
+      adapter.apply({ op: "slide.setBackground", slideId: id, background: bg });
       return textResult(`Background set on slide ${id}`, { id });
     },
     true,
@@ -1728,7 +1718,7 @@ function registerSlidesBridge(host, options) {
     (args) => {
       const id = str(args.id);
       const transition = args.transition && typeof args.transition === "object" ? args.transition : void 0;
-      adapter.apply({ kind: "slide_set_transition", id, transition });
+      adapter.apply({ op: "slide.setTransition", slideId: id, transition });
       return textResult(`Transition set on slide ${id}`, { id });
     },
     true,
@@ -1750,7 +1740,7 @@ function registerSlidesBridge(host, options) {
         id: incoming.id ?? fancySlides.elementId(),
         ...incoming
       };
-      adapter.apply({ kind: "element_add", slideId, element });
+      adapter.apply({ op: "element.add", slideId, element });
       return textResult(`Added ${element.type} element ${element.id} on ${slideId}`, { id: element.id, slideId });
     },
     true,
@@ -1764,7 +1754,7 @@ function registerSlidesBridge(host, options) {
     (args) => {
       const slideId = str(args.slideId);
       const elementId = str(args.elementId);
-      adapter.apply({ kind: "element_remove", slideId, elementId });
+      adapter.apply({ op: "element.remove", slideId, elementId });
       return textResult(`Removed element ${elementId} from ${slideId}`, { slideId, elementId });
     },
     true,
@@ -1783,7 +1773,7 @@ function registerSlidesBridge(host, options) {
       const slideId = str(args.slideId);
       const elementId = str(args.elementId);
       const patch = args.patch && typeof args.patch === "object" ? args.patch : {};
-      adapter.apply({ kind: "element_update", slideId, elementId, patch });
+      adapter.apply({ op: "element.update", slideId, elementId, patch });
       return textResult(`Patched element ${elementId}`, { keys: Object.keys(patch) });
     },
     true,
@@ -1804,7 +1794,7 @@ function registerSlidesBridge(host, options) {
       const elementId = str(args.elementId);
       const x = clamp(num(args.x, 0), 0, 1);
       const y = clamp(num(args.y, 0), 0, 1);
-      adapter.apply({ kind: "element_move", slideId, elementId, x, y });
+      adapter.apply({ op: "element.move", slideId, elementId, x, y });
       return textResult(`Moved element ${elementId} \u2192 (${x}, ${y})`, { x, y });
     },
     true,
@@ -1825,7 +1815,7 @@ function registerSlidesBridge(host, options) {
       const elementId = str(args.elementId);
       const w = clamp(num(args.w, 0), 0, 1);
       const h = clamp(num(args.h, 0), 0, 1);
-      adapter.apply({ kind: "element_resize", slideId, elementId, w, h });
+      adapter.apply({ op: "element.resize", slideId, elementId, w, h });
       return textResult(`Resized element ${elementId} \u2192 (${w}, ${h})`, { w, h });
     },
     true,
@@ -1846,7 +1836,7 @@ function registerSlidesBridge(host, options) {
       const slideId = str(args.slideId);
       const elementId = str(args.elementId);
       const animation = args.animation && typeof args.animation === "object" ? args.animation : void 0;
-      adapter.apply({ kind: "element_set_animation", slideId, elementId, animation });
+      adapter.apply({ op: "element.setAnimation", slideId, elementId, animation });
       return textResult(`Animation ${animation ? "set on" : "cleared from"} element ${elementId}`, { elementId });
     },
     true,
@@ -2282,11 +2272,221 @@ function registerMapBridge(host, options) {
   };
 }
 
+// src/bridges/files.ts
+var DEFAULT_AGENT9 = { id: "agent", name: "Agent", color: "#0ea5e9" };
+var str3 = (v, fallback = "") => typeof v === "string" ? v : fallback;
+var num3 = (v, fallback) => typeof v === "number" && Number.isFinite(v) ? v : 0;
+var asPaths = (v) => {
+  if (typeof v === "string") {
+    return [v];
+  }
+  if (Array.isArray(v)) {
+    return v.filter((x) => typeof x === "string");
+  }
+  return [];
+};
+function registerFilesBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT9, ...options.agent ?? {} };
+  const disposers = [];
+  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
+  const fTarget = (args, _result) => ({
+    kind: "files",
+    elementId: args?.path ?? void 0
+  });
+  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: "files",
+      resolveTarget: ({ args, result }) => resolveTarget(args, result)
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        {
+          name,
+          description,
+          inputSchema: {
+            type: "object",
+            properties,
+            required,
+            additionalProperties: false
+          }
+        },
+        final
+      )
+    );
+  };
+  reg(
+    "files_get_state",
+    "Get the file browser's current directory, selected path(s), and expanded folders.",
+    {},
+    [],
+    () => {
+      const state = {
+        path: adapter.getPath(),
+        selected: adapter.getSelection(),
+        expanded: adapter.getExpanded()
+      };
+      return textResult(JSON.stringify(state, null, 2), state);
+    }
+  );
+  reg(
+    "files_list",
+    "List the direct children of a folder (files + subfolders). Omit `path` for the current directory. Loads lazily from the host's provider/snapshot \u2014 never an eager tree walk.",
+    { path: { type: "string", description: "Folder path to list; defaults to the current directory." } },
+    [],
+    async (args) => {
+      const path = args.path !== void 0 ? str3(args.path) : adapter.getPath();
+      const entries = await adapter.listChildren(path);
+      const summary = entries.map((e) => ({
+        path: e.path,
+        name: e.name,
+        kind: e.kind,
+        ...e.size !== void 0 ? { size: e.size } : {},
+        ...e.mtime !== void 0 ? { mtime: e.mtime } : {}
+      }));
+      const text = summary.map((e) => `${e.kind === "dir" ? "\u{1F4C1}" : "\u{1F4C4}"} ${e.path}`).join("\n") || `(empty: ${path})`;
+      return textResult(text, { path, entries: summary });
+    }
+  );
+  reg(
+    "files_navigate",
+    "Set the current directory (as if the user clicked a breadcrumb or opened a folder).",
+    { path: { type: "string" } },
+    ["path"],
+    (args) => {
+      const path = str3(args.path);
+      const prev = adapter.getPath();
+      adapter.setPath(path);
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "files",
+        action: "files_navigate",
+        label: `Navigated to ${path}`,
+        undo: () => adapter.setPath(prev),
+        redo: () => adapter.setPath(path)
+      });
+      return textResult(`Current directory \u2192 ${path}`, { path });
+    },
+    fTarget
+  );
+  reg(
+    "files_expand",
+    "Expand a folder in the tree (loads its children if needed).",
+    { path: { type: "string" } },
+    ["path"],
+    (args) => {
+      const path = str3(args.path);
+      if (adapter.getExpanded().includes(path)) {
+        return textResult(`${path} already expanded`, { path, expanded: true });
+      }
+      adapter.setExpanded((prev) => [...prev, path]);
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "files",
+        action: "files_expand",
+        label: `Expanded ${path}`,
+        undo: () => adapter.setExpanded((prev) => prev.filter((p) => p !== path)),
+        redo: () => adapter.setExpanded((prev) => prev.includes(path) ? prev : [...prev, path])
+      });
+      return textResult(`Expanded ${path}`, { path, expanded: true });
+    },
+    fTarget
+  );
+  reg(
+    "files_collapse",
+    "Collapse a folder in the tree.",
+    { path: { type: "string" } },
+    ["path"],
+    (args) => {
+      const path = str3(args.path);
+      if (!adapter.getExpanded().includes(path)) {
+        return textResult(`${path} already collapsed`, { path, expanded: false });
+      }
+      adapter.setExpanded((prev) => prev.filter((p) => p !== path));
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "files",
+        action: "files_collapse",
+        label: `Collapsed ${path}`,
+        undo: () => adapter.setExpanded((prev) => prev.includes(path) ? prev : [...prev, path]),
+        redo: () => adapter.setExpanded((prev) => prev.filter((p) => p !== path))
+      });
+      return textResult(`Collapsed ${path}`, { path, expanded: false });
+    },
+    fTarget
+  );
+  reg(
+    "files_select",
+    "Set the selection to the given path(s). Pass a single `path`, or `paths` for a multi-select browser; either empty clears the selection.",
+    {
+      path: { type: "string", description: "A single path to select." },
+      paths: { type: "array", items: { type: "string" }, description: "Multiple paths (multi-select browsers)." }
+    },
+    [],
+    (args) => {
+      const next = args.paths !== void 0 ? asPaths(args.paths) : asPaths(args.path);
+      const prev = adapter.getSelection();
+      adapter.setSelection(next);
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "files",
+        action: "files_select",
+        label: next.length ? `Selected ${next.join(", ")}` : "Cleared selection",
+        undo: () => adapter.setSelection(prev),
+        redo: () => adapter.setSelection(next)
+      });
+      return textResult(next.length ? `Selected ${next.join(", ")}` : "Cleared selection", {
+        selected: next
+      });
+    },
+    fTarget
+  );
+  reg(
+    "files_request_snapshot",
+    "Request a fresh snapshot subtree rooted at `path` (snapshot mode) \u2014 e.g. to pull a remote machine's current tree. Requires the host to wire requestSnapshot.",
+    {
+      path: { type: "string", description: "Root of the subtree; defaults to the current directory." },
+      depth: { type: "number", description: "How many levels deep to materialize (host-defined default)." }
+    },
+    [],
+    async (args) => {
+      if (!adapter.requestSnapshot) {
+        return errorResult("Host did not wire requestSnapshot (snapshot mode not enabled).");
+      }
+      const path = args.path !== void 0 ? str3(args.path) : adapter.getPath();
+      const depth = args.depth !== void 0 ? num3(args.depth) : void 0;
+      const tree = await adapter.requestSnapshot(path, depth);
+      const count = Array.isArray(tree) ? tree.length : 0;
+      return textResult(`Snapshot of ${path}: ${count} top-level entr${count === 1 ? "y" : "ies"}.`, {
+        path,
+        snapshot: tree
+      });
+    },
+    fTarget
+  );
+  return {
+    id: "files",
+    title: "Files",
+    dispose: () => {
+      for (const d of disposers) d();
+    }
+  };
+}
+
 // src/bridges/terminal.ts
-var DEFAULT_AGENT9 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT10 = { id: "agent", name: "Agent", color: "#a855f7" };
 var truncate = (s, n = 60) => s.length > n ? s.slice(0, n) + "\u2026" : s;
 function registerTerminalBridge(host, options) {
-  const agent = { ...DEFAULT_AGENT9, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT10, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? false;
   const screenId = options.screenId ?? options.adapter?.screenId;
   const disposers = [];
@@ -2551,10 +2751,10 @@ function registerTerminalBridge(host, options) {
 }
 
 // src/bridges/navigation.ts
-var DEFAULT_AGENT10 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT11 = { id: "agent", name: "Agent", color: "#a855f7" };
 function registerNavigationBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT10, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT11, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const disposers = [];
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
@@ -2759,12 +2959,12 @@ function registerNavigationBridge(host, options) {
 }
 
 // src/bridges/catalog.ts
-var DEFAULT_AGENT11 = { id: "agent", name: "Agent", color: "#a855f7" };
-var str3 = (v, fallback = "") => typeof v === "string" ? v : fallback;
-var num3 = (v, fallback = 0) => typeof v === "number" && Number.isFinite(v) ? v : fallback;
+var DEFAULT_AGENT12 = { id: "agent", name: "Agent", color: "#a855f7" };
+var str4 = (v, fallback = "") => typeof v === "string" ? v : fallback;
+var num4 = (v, fallback = 0) => typeof v === "number" && Number.isFinite(v) ? v : fallback;
 function registerCatalogBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT11, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT12, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const catalogId = adapter.id ?? "catalog";
   const disposers = [];
@@ -2834,7 +3034,7 @@ function registerCatalogBridge(host, options) {
     { id: { type: "string" }, withTrashed: { type: "boolean" } },
     ["id"],
     async (args) => {
-      const id = str3(args.id);
+      const id = str4(args.id);
       const product = await adapter.products.find(id, { withTrashed: args.withTrashed === true });
       if (!product) return errorResult(`No product with id ${id}`);
       const prices = await adapter.prices.forProduct(id, { withTrashed: args.withTrashed === true });
@@ -2850,7 +3050,7 @@ function registerCatalogBridge(host, options) {
     [],
     async (args) => {
       const withTrashed = args.withTrashed === true;
-      const prices = args.productId !== void 0 ? await adapter.prices.forProduct(str3(args.productId), { withTrashed }) : await adapter.prices.all({ withTrashed });
+      const prices = args.productId !== void 0 ? await adapter.prices.forProduct(str4(args.productId), { withTrashed }) : await adapter.prices.all({ withTrashed });
       const list = prices.map((p) => ({
         id: p.id,
         productId: p.productId,
@@ -2876,13 +3076,13 @@ function registerCatalogBridge(host, options) {
     },
     ["name"],
     async (args) => {
-      const name = str3(args.name);
+      const name = str4(args.name);
       if (!name) return errorResult("name is required.");
       const product = await adapter.createProduct({
         name,
-        ...args.description !== void 0 ? { description: str3(args.description) } : {},
+        ...args.description !== void 0 ? { description: str4(args.description) } : {},
         ...args.active !== void 0 ? { active: args.active === true } : {},
-        ...args.lookupKey !== void 0 ? { lookupKey: str3(args.lookupKey) } : {},
+        ...args.lookupKey !== void 0 ? { lookupKey: str4(args.lookupKey) } : {},
         ...args.metadata && typeof args.metadata === "object" ? { metadata: args.metadata } : {}
       });
       fancyAutoCommon.pushUndoEntry(agent.id, {
@@ -2895,7 +3095,7 @@ function registerCatalogBridge(host, options) {
       });
       return textResult(`Created product ${product.id} (${product.name})`, product);
     },
-    (args) => target(void 0, `create product ${str3(args.name)}`)
+    (args) => target(void 0, `create product ${str4(args.name)}`)
   );
   reg(
     "catalog_create_price",
@@ -2912,19 +3112,19 @@ function registerCatalogBridge(host, options) {
     },
     ["productId", "currency", "unitAmount", "type"],
     async (args) => {
-      const productId = str3(args.productId);
+      const productId = str4(args.productId);
       const product = await adapter.products.find(productId);
       if (!product) return errorResult(`No product with id ${productId}`);
-      const type = str3(args.type);
+      const type = str4(args.type);
       if (type !== "recurring" && type !== "one_time") return errorResult("type must be 'recurring' or 'one_time'.");
       const price = await adapter.createPrice({
         productId,
-        currency: str3(args.currency),
-        unitAmount: num3(args.unitAmount),
+        currency: str4(args.currency),
+        unitAmount: num4(args.unitAmount),
         type,
-        ...args.recurringInterval !== void 0 ? { recurringInterval: str3(args.recurringInterval) } : {},
-        ...args.nickname !== void 0 ? { nickname: str3(args.nickname) } : {},
-        ...args.lookupKey !== void 0 ? { lookupKey: str3(args.lookupKey) } : {},
+        ...args.recurringInterval !== void 0 ? { recurringInterval: str4(args.recurringInterval) } : {},
+        ...args.nickname !== void 0 ? { nickname: str4(args.nickname) } : {},
+        ...args.lookupKey !== void 0 ? { lookupKey: str4(args.lookupKey) } : {},
         ...args.metadata && typeof args.metadata === "object" ? { metadata: args.metadata } : {}
       });
       fancyAutoCommon.pushUndoEntry(agent.id, {
@@ -2937,7 +3137,7 @@ function registerCatalogBridge(host, options) {
       });
       return textResult(`Created ${type} price ${price.id} on ${productId}`, price);
     },
-    (args) => target(str3(args.productId), `create price on ${str3(args.productId)}`)
+    (args) => target(str4(args.productId), `create price on ${str4(args.productId)}`)
   );
   reg(
     "catalog_delete_product",
@@ -2945,7 +3145,7 @@ function registerCatalogBridge(host, options) {
     { id: { type: "string" }, confirm: { type: "boolean" } },
     ["id"],
     async (args) => {
-      const id = str3(args.id);
+      const id = str4(args.id);
       const product = await adapter.products.find(id, { withTrashed: true });
       if (!product) return errorResult(`No product with id ${id}`);
       const blocked = await guardDestructive("catalog_delete_product", id, product.name, args.confirm === true);
@@ -2962,7 +3162,7 @@ function registerCatalogBridge(host, options) {
       });
       return textResult(`Deleted product ${id}`, { id });
     },
-    (args) => target(str3(args.id), `delete product ${str3(args.id)}`)
+    (args) => target(str4(args.id), `delete product ${str4(args.id)}`)
   );
   reg(
     "catalog_delete_price",
@@ -2970,7 +3170,7 @@ function registerCatalogBridge(host, options) {
     { id: { type: "string" }, confirm: { type: "boolean" } },
     ["id"],
     async (args) => {
-      const id = str3(args.id);
+      const id = str4(args.id);
       const price = await adapter.prices.find(id, { withTrashed: true });
       if (!price) return errorResult(`No price with id ${id}`);
       const blocked = await guardDestructive("catalog_delete_price", id, id, args.confirm === true);
@@ -2987,7 +3187,7 @@ function registerCatalogBridge(host, options) {
       });
       return textResult(`Deleted price ${id}`, { id });
     },
-    (args) => target(str3(args.id), `delete price ${str3(args.id)}`)
+    (args) => target(str4(args.id), `delete price ${str4(args.id)}`)
   );
   reg(
     "catalog_sync_product",
@@ -2996,13 +3196,13 @@ function registerCatalogBridge(host, options) {
     ["id"],
     async (args) => {
       if (!adapter.syncProductAndPrices) return errorResult("Host did not wire Stripe sync.");
-      const id = str3(args.id);
+      const id = str4(args.id);
       const product = await adapter.products.find(id);
       if (!product) return errorResult(`No product with id ${id}`);
       const synced = await adapter.syncProductAndPrices(product);
       return textResult(`Synced product ${id} to Stripe (${synced.externalId ?? "no external id"})`, synced);
     },
-    (args) => target(str3(args.id), `sync product ${str3(args.id)}`)
+    (args) => target(str4(args.id), `sync product ${str4(args.id)}`)
   );
   reg(
     "catalog_test_connection",
@@ -3029,13 +3229,13 @@ function registerCatalogBridge(host, options) {
     },
     ["priceId", "successUrl", "cancelUrl"],
     async (args) => {
-      const priceId = str3(args.priceId);
+      const priceId = str4(args.priceId);
       const price = await adapter.prices.find(priceId);
       if (!price) return errorResult(`No price with id ${priceId}`);
       const checkoutArgs = {
-        successUrl: str3(args.successUrl),
-        cancelUrl: str3(args.cancelUrl),
-        ...args.customer !== void 0 ? { customer: str3(args.customer) } : {},
+        successUrl: str4(args.successUrl),
+        cancelUrl: str4(args.cancelUrl),
+        ...args.customer !== void 0 ? { customer: str4(args.customer) } : {},
         ...args.metadata && typeof args.metadata === "object" ? { metadata: args.metadata } : {}
       };
       let url;
@@ -3044,11 +3244,11 @@ function registerCatalogBridge(host, options) {
         url = await adapter.getSubscriptionCheckoutUrl(price, checkoutArgs);
       } else {
         if (!adapter.getOneTimeCheckoutUrl) return errorResult("Host did not wire one-time checkout.");
-        url = await adapter.getOneTimeCheckoutUrl(price, { ...checkoutArgs, quantity: num3(args.quantity, 1) });
+        url = await adapter.getOneTimeCheckoutUrl(price, { ...checkoutArgs, quantity: num4(args.quantity, 1) });
       }
       return textResult(url || "(no url)", { priceId, type: price.type, url });
     },
-    (args) => target(str3(args.priceId), `checkout ${str3(args.priceId)}`)
+    (args) => target(str4(args.priceId), `checkout ${str4(args.priceId)}`)
   );
   return {
     id: `catalog:${catalogId}`,
@@ -3060,12 +3260,12 @@ function registerCatalogBridge(host, options) {
 }
 
 // src/bridges/features.ts
-var DEFAULT_AGENT12 = { id: "agent", name: "Agent", color: "#a855f7" };
-var str4 = (v, fallback = "") => typeof v === "string" ? v : fallback;
-var num4 = (v, fallback = 0) => typeof v === "number" && Number.isFinite(v) ? v : fallback;
+var DEFAULT_AGENT13 = { id: "agent", name: "Agent", color: "#a855f7" };
+var str5 = (v, fallback = "") => typeof v === "string" ? v : fallback;
+var num5 = (v, fallback = 0) => typeof v === "number" && Number.isFinite(v) ? v : fallback;
 function registerFeaturesBridge(host, options) {
   const { adapter } = options;
-  const agent = { ...DEFAULT_AGENT12, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT13, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const featuresId = adapter.id ?? "features";
   const disposers = [];
@@ -3126,7 +3326,7 @@ function registerFeaturesBridge(host, options) {
     { feature: { type: "string" }, subject: { description: "Opaque subject." }, context: { description: "Optional context." } },
     ["feature"],
     async (args) => {
-      const feature = str4(args.feature);
+      const feature = str5(args.feature);
       const allowed = await adapter.canAccess(feature, args.subject, args.context);
       const remaining = await adapter.remaining(feature, args.subject, args.context);
       const out = { feature, allowed, remaining };
@@ -3141,7 +3341,7 @@ function registerFeaturesBridge(host, options) {
     ["feature"],
     async (args) => {
       if (!adapter.explain) return errorResult("Host did not wire explain().");
-      const result = await adapter.explain(str4(args.feature), args.subject, args.context);
+      const result = await adapter.explain(str5(args.feature), args.subject, args.context);
       return textResult(JSON.stringify(result, null, 2), result);
     },
     false
@@ -3170,15 +3370,15 @@ function registerFeaturesBridge(host, options) {
     },
     ["key"],
     (args) => {
-      const key = str4(args.key);
+      const key = str5(args.key);
       if (!key) return errorResult("key is required.");
       const existed = adapter.registryKeys().includes(key);
       const definition = {
-        ...args.name !== void 0 ? { name: str4(args.name) } : {},
-        ...args.description !== void 0 ? { description: str4(args.description) } : {},
-        ...args.type !== void 0 ? { type: str4(args.type) } : {},
+        ...args.name !== void 0 ? { name: str5(args.name) } : {},
+        ...args.description !== void 0 ? { description: str5(args.description) } : {},
+        ...args.type !== void 0 ? { type: str5(args.type) } : {},
         ...args.enabled !== void 0 ? { enabled: args.enabled === true } : {},
-        ...args.limit !== void 0 ? { limit: num4(args.limit) } : {}
+        ...args.limit !== void 0 ? { limit: num5(args.limit) } : {}
       };
       adapter.registerFeature(key, definition);
       fancyAutoCommon.pushUndoEntry(agent.id, {
@@ -3193,7 +3393,7 @@ function registerFeaturesBridge(host, options) {
       });
       return textResult(`${existed ? "Redefined" : "Defined"} feature ${key} (${definition.type ?? "boolean"})`, { key, definition });
     },
-    (args) => target(str4(args.key), `define ${str4(args.key)}`)
+    (args) => target(str5(args.key), `define ${str5(args.key)}`)
   );
   reg(
     "features_grant",
@@ -3201,7 +3401,7 @@ function registerFeaturesBridge(host, options) {
     { subject: { description: "Opaque subject." }, group: { type: "string", description: "Feature group key." }, confirm: { type: "boolean" } },
     ["subject", "group"],
     async (args) => {
-      const groupKey = str4(args.group);
+      const groupKey = str5(args.group);
       if (!groupKey) return errorResult("group is required.");
       const blocked = await guardGrant("features_grant", args.subject, groupKey, args.confirm === true);
       if (blocked) return blocked;
@@ -3220,7 +3420,7 @@ function registerFeaturesBridge(host, options) {
       });
       return textResult(`Granted group ${groupKey}`, { subject: args.subject, group: groupKey });
     },
-    (args) => target(str4(args.group), `grant ${str4(args.group)}`)
+    (args) => target(str5(args.group), `grant ${str5(args.group)}`)
   );
   reg(
     "features_revoke",
@@ -3228,7 +3428,7 @@ function registerFeaturesBridge(host, options) {
     { subject: { description: "Opaque subject." }, group: { type: "string" }, confirm: { type: "boolean" } },
     ["subject", "group"],
     async (args) => {
-      const groupKey = str4(args.group);
+      const groupKey = str5(args.group);
       if (!groupKey) return errorResult("group is required.");
       const blocked = await guardGrant("features_revoke", args.subject, groupKey, args.confirm === true);
       if (blocked) return blocked;
@@ -3246,7 +3446,7 @@ function registerFeaturesBridge(host, options) {
       });
       return textResult(`Revoked group ${groupKey}`, { subject: args.subject, group: groupKey });
     },
-    (args) => target(str4(args.group), `revoke ${str4(args.group)}`)
+    (args) => target(str5(args.group), `revoke ${str5(args.group)}`)
   );
   reg(
     "features_consume",
@@ -3255,14 +3455,14 @@ function registerFeaturesBridge(host, options) {
     ["feature", "subject"],
     async (args) => {
       if (!adapter.tryConsume) return errorResult("Host did not wire usage metering (tryConsume).");
-      const feature = str4(args.feature);
-      const amount = num4(args.amount, 1);
+      const feature = str5(args.feature);
+      const amount = num5(args.amount, 1);
       const ok = await adapter.tryConsume(feature, args.subject, amount, args.context);
       const remaining = await adapter.remaining(feature, args.subject, args.context);
       const out = { feature, ok, amount, remaining };
       return textResult(JSON.stringify(out), out);
     },
-    (args) => target(str4(args.feature), `consume ${str4(args.feature)}`)
+    (args) => target(str5(args.feature), `consume ${str5(args.feature)}`)
   );
   return {
     id: `features:${featuresId}`,
@@ -3467,11 +3667,11 @@ function attachSseRelay(server, options) {
 
 // src/sharing/use-co-browse-session.ts
 init_registry();
-var DEFAULT_AGENT13 = { id: "agent", name: "Agent", color: "#a855f7" };
+var DEFAULT_AGENT14 = { id: "agent", name: "Agent", color: "#a855f7" };
 var USER = { id: "human", name: "You" };
 function useCoBrowseSession(options) {
   const { adapter, extraBridges } = options;
-  const agent = { ...DEFAULT_AGENT13, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT14, ...options.agent ?? {} };
   const relayBaseUrl = options.relayBaseUrl ?? "/agent-relay";
   const serverRef = react.useRef(null);
   const relayRef = react.useRef(null);
@@ -4697,6 +4897,7 @@ exports.registerCatalogBridge = registerCatalogBridge;
 exports.registerChartsBridge = registerChartsBridge;
 exports.registerCodeBridge = registerCodeBridge;
 exports.registerFeaturesBridge = registerFeaturesBridge;
+exports.registerFilesBridge = registerFilesBridge;
 exports.registerFormBridge = registerFormBridge;
 exports.registerMapBridge = registerMapBridge;
 exports.registerNavigationBridge = registerNavigationBridge;