@particle-academy/agent-integrations 0.21.2 → 0.23.0

package/dist/index.cjs

@@ -1105,7 +1105,7 @@ function registerSceneBridge(host, options) {
       )
     );
   };
-  const newId = (kind) => `${kind}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+  const newId2 = (kind) => `${kind}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
   reg(
     "scene_describe",
     "Describe the scene \u2014 object count, kinds, camera position.",
@@ -1149,7 +1149,7 @@ function registerSceneBridge(host, options) {
     ["kind"],
     (args) => {
       const obj = {
-        id: newId(String(args.kind)),
+        id: newId2(String(args.kind)),
         kind: String(args.kind),
         position: parseTriple(args.position),
         rotation: parseTriple(args.rotation),
@@ -1955,11 +1955,548 @@ function serialize(entry) {
   };
 }
 
+// src/bridges/map.ts
+var DEFAULT_AGENT8 = { id: "agent", name: "Agent", color: "#7c3aed" };
+var num2 = (v, fallback) => typeof v === "number" && Number.isFinite(v) ? v : 0;
+var str2 = (v, fallback = "") => typeof v === "string" ? v : fallback;
+var newId = (prefix) => `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 7)}`;
+function registerMapBridge(host, options) {
+  const { adapter } = options;
+  const agent = { ...DEFAULT_AGENT8, ...options.agent ?? {} };
+  const disposers = [];
+  ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
+  const mTarget = (args, result) => ({
+    kind: "map",
+    elementId: result?.structuredContent?.id ?? args?.id
+  });
+  const reg = (name, description, properties, required, handler, resolveTarget) => {
+    const wrapped = async (args) => {
+      try {
+        return await handler(args);
+      } catch (e) {
+        return errorResult(e instanceof Error ? e.message : String(e));
+      }
+    };
+    const final = resolveTarget ? wrapToolWithActivity(wrapped, {
+      toolName: name,
+      agent: { id: agent.id, name: agent.name, color: agent.color },
+      kind: "map",
+      resolveTarget: ({ args, result }) => resolveTarget(args, result)
+    }) : wrapped;
+    disposers.push(
+      host.registerTool(
+        {
+          name,
+          description,
+          inputSchema: {
+            type: "object",
+            properties,
+            required,
+            additionalProperties: false
+          }
+        },
+        final
+      )
+    );
+  };
+  reg("map_get_state", "Get the map's camera, markers, and current selection.", {}, [], () => {
+    const state = {
+      view: adapter.getView(),
+      markers: adapter.getMarkers(),
+      selectedId: adapter.getSelected()
+    };
+    return textResult(JSON.stringify(state, null, 2), state);
+  });
+  reg(
+    "map_set_view",
+    "Move the camera to an absolute position. Any omitted field is left unchanged.",
+    {
+      lat: { type: "number", description: "New center latitude." },
+      lng: { type: "number", description: "New center longitude." },
+      zoom: { type: "number", description: "New zoom level (higher = closer)." }
+    },
+    [],
+    (args) => {
+      const prev = adapter.getView();
+      const next = {
+        center: {
+          lat: args.lat !== void 0 ? num2(args.lat) : prev.center.lat,
+          lng: args.lng !== void 0 ? num2(args.lng) : prev.center.lng
+        },
+        zoom: args.zoom !== void 0 ? num2(args.zoom) : prev.zoom
+      };
+      adapter.setView(next);
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "map",
+        action: "map_set_view",
+        label: `Moved camera to ${next.center.lat.toFixed(4)},${next.center.lng.toFixed(4)} z${next.zoom}`,
+        undo: () => adapter.setView(prev),
+        redo: () => adapter.setView(next)
+      });
+      return textResult(`Camera \u2192 ${next.center.lat.toFixed(4)},${next.center.lng.toFixed(4)} z${next.zoom}`, next);
+    },
+    mTarget
+  );
+  reg(
+    "map_pan",
+    "Pan the camera by a relative offset in degrees (positive dLat = north, positive dLng = east).",
+    { dLat: { type: "number" }, dLng: { type: "number" } },
+    [],
+    (args) => {
+      const prev = adapter.getView();
+      const next = {
+        ...prev,
+        center: { lat: prev.center.lat + num2(args.dLat), lng: prev.center.lng + num2(args.dLng) }
+      };
+      adapter.setView(next);
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "map",
+        action: "map_pan",
+        label: "Panned camera",
+        undo: () => adapter.setView(prev),
+        redo: () => adapter.setView(next)
+      });
+      return textResult(`Panned to ${next.center.lat.toFixed(4)},${next.center.lng.toFixed(4)}`, next);
+    },
+    mTarget
+  );
+  reg(
+    "map_zoom",
+    "Zoom the camera by a relative delta (e.g. +1 zooms in one level, -2 out two).",
+    { delta: { type: "number" } },
+    ["delta"],
+    (args) => {
+      const prev = adapter.getView();
+      const next = { ...prev, zoom: prev.zoom + num2(args.delta) };
+      adapter.setView(next);
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "map",
+        action: "map_zoom",
+        label: `Zoom \u2192 ${next.zoom}`,
+        undo: () => adapter.setView(prev),
+        redo: () => adapter.setView(next)
+      });
+      return textResult(`Zoom \u2192 ${next.zoom}`, next);
+    }
+  );
+  reg(
+    "map_fit_bounds",
+    "Fit the camera to enclose points. Pass `points`, or omit to fit all current markers.",
+    {
+      points: {
+        type: "array",
+        description: "Points to enclose, e.g. [{lat,lng},\u2026].",
+        items: {
+          type: "object",
+          properties: { lat: { type: "number" }, lng: { type: "number" } },
+          required: ["lat", "lng"]
+        }
+      },
+      padding: { type: "number", description: "Padding in pixels (default 40)." }
+    },
+    [],
+    (args) => {
+      if (!adapter.fitBounds) {
+        return errorResult("Host did not wire fitBounds (pass the <Map onReady> handle's fitBounds).");
+      }
+      const points = Array.isArray(args.points) ? args.points.map((p) => ({ lat: num2(p?.lat), lng: num2(p?.lng) })) : adapter.getMarkers().map((m) => m.position);
+      if (!points.length) {
+        return errorResult("No points to fit (map has no markers).");
+      }
+      adapter.fitBounds(points, args.padding !== void 0 ? num2(args.padding) : void 0);
+      return textResult(`Fit camera to ${points.length} point(s).`);
+    }
+  );
+  reg(
+    "map_add_marker",
+    "Drop a marker. `id` is optional (auto-generated); `icon` is an emoji or 1\u20132 chars.",
+    {
+      id: { type: "string" },
+      lat: { type: "number" },
+      lng: { type: "number" },
+      label: { type: "string" },
+      color: { type: "string", description: "CSS color, e.g. #2563eb." },
+      icon: { type: "string", description: "Emoji / short text in the pin." },
+      draggable: { type: "boolean" },
+      data: { type: "object", description: "Arbitrary JSON payload carried with the marker." }
+    },
+    ["lat", "lng"],
+    (args) => {
+      const id = args.id ? str2(args.id) : newId("m");
+      if (adapter.getMarkers().some((m) => m.id === id)) {
+        return errorResult(`A marker with id ${id} already exists \u2014 use map_update_marker.`);
+      }
+      const marker = {
+        id,
+        position: { lat: num2(args.lat), lng: num2(args.lng) },
+        ...args.label !== void 0 ? { label: str2(args.label) } : {},
+        ...args.color !== void 0 ? { color: str2(args.color) } : {},
+        ...args.icon !== void 0 ? { icon: str2(args.icon) } : {},
+        ...args.draggable !== void 0 ? { draggable: !!args.draggable } : {},
+        ...args.data && typeof args.data === "object" ? { data: args.data } : {}
+      };
+      adapter.setMarkers((all) => [...all, marker]);
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "map",
+        action: "map_add_marker",
+        label: `Added marker ${id}`,
+        undo: () => adapter.setMarkers((all) => all.filter((m) => m.id !== id)),
+        redo: () => adapter.setMarkers((all) => [...all, marker])
+      });
+      return textResult(`Added marker ${id} at ${marker.position.lat.toFixed(4)},${marker.position.lng.toFixed(4)}`, marker);
+    },
+    mTarget
+  );
+  reg(
+    "map_update_marker",
+    "Update a marker. Only provided fields change \u2014 update lat/lng repeatedly to drive a live track.",
+    {
+      id: { type: "string" },
+      lat: { type: "number" },
+      lng: { type: "number" },
+      label: { type: "string" },
+      color: { type: "string" },
+      icon: { type: "string" },
+      draggable: { type: "boolean" }
+    },
+    ["id"],
+    (args) => {
+      const id = str2(args.id);
+      const prev = adapter.getMarkers().find((m) => m.id === id);
+      if (!prev) {
+        return errorResult(`No marker with id ${id}`);
+      }
+      const next = {
+        ...prev,
+        position: {
+          lat: args.lat !== void 0 ? num2(args.lat) : prev.position.lat,
+          lng: args.lng !== void 0 ? num2(args.lng) : prev.position.lng
+        },
+        ...args.label !== void 0 ? { label: str2(args.label) } : {},
+        ...args.color !== void 0 ? { color: str2(args.color) } : {},
+        ...args.icon !== void 0 ? { icon: str2(args.icon) } : {},
+        ...args.draggable !== void 0 ? { draggable: !!args.draggable } : {}
+      };
+      adapter.setMarkers((all) => all.map((m) => m.id === id ? next : m));
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "map",
+        action: "map_update_marker",
+        label: `Updated marker ${id}`,
+        undo: () => adapter.setMarkers((all) => all.map((m) => m.id === id ? prev : m)),
+        redo: () => adapter.setMarkers((all) => all.map((m) => m.id === id ? next : m))
+      });
+      return textResult(`Updated marker ${id}`, next);
+    },
+    mTarget
+  );
+  reg(
+    "map_remove_marker",
+    "Remove a marker by id.",
+    { id: { type: "string" } },
+    ["id"],
+    (args) => {
+      const id = str2(args.id);
+      const prev = adapter.getMarkers().find((m) => m.id === id);
+      if (!prev) {
+        return errorResult(`No marker with id ${id}`);
+      }
+      adapter.setMarkers((all) => all.filter((m) => m.id !== id));
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "map",
+        action: "map_remove_marker",
+        label: `Removed marker ${id}`,
+        undo: () => adapter.setMarkers((all) => [...all, prev]),
+        redo: () => adapter.setMarkers((all) => all.filter((m) => m.id !== id))
+      });
+      return textResult(`Removed marker ${id}`);
+    },
+    mTarget
+  );
+  reg(
+    "map_select",
+    "Select a marker (or pass no id / null to clear the selection).",
+    { id: { type: "string" } },
+    [],
+    (args) => {
+      const prev = adapter.getSelected();
+      const id = args.id === void 0 || args.id === null ? null : str2(args.id);
+      if (id !== null && !adapter.getMarkers().some((m) => m.id === id)) {
+        return errorResult(`No marker with id ${id}`);
+      }
+      adapter.setSelected(id);
+      fancyAutoCommon.pushUndoEntry(agent.id, {
+        timestamp: Date.now(),
+        bridgeId: "map",
+        action: "map_select",
+        label: id ? `Selected ${id}` : "Cleared selection",
+        undo: () => adapter.setSelected(prev),
+        redo: () => adapter.setSelected(id)
+      });
+      return textResult(id ? `Selected marker ${id}` : "Cleared selection", { selectedId: id });
+    },
+    mTarget
+  );
+  reg(
+    "map_start_track",
+    "Make the camera follow a marker as its position updates (live tracking). Requires the host to wire setFollow.",
+    { id: { type: "string" } },
+    ["id"],
+    (args) => {
+      if (!adapter.setFollow) {
+        return errorResult("Host did not wire setFollow (pass the map's `follow` setter).");
+      }
+      const id = str2(args.id);
+      if (!adapter.getMarkers().some((m) => m.id === id)) {
+        return errorResult(`No marker with id ${id}`);
+      }
+      adapter.setFollow(id);
+      return textResult(`Camera now following ${id}`, { follow: id });
+    },
+    mTarget
+  );
+  reg(
+    "map_stop_track",
+    "Stop following any marker (releases the camera). Requires the host to wire setFollow.",
+    {},
+    [],
+    () => {
+      if (!adapter.setFollow) {
+        return errorResult("Host did not wire setFollow.");
+      }
+      adapter.setFollow(null);
+      return textResult("Camera released (no longer following).", { follow: null });
+    }
+  );
+  return {
+    id: "map",
+    title: "Map",
+    dispose: () => {
+      for (const d of disposers) d();
+    }
+  };
+}
+
+// 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_AGENT8 = { 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_AGENT8, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT10, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? false;
   const screenId = options.screenId ?? options.adapter?.screenId;
   const disposers = [];
@@ -2224,10 +2761,10 @@ function registerTerminalBridge(host, options) {
 }
 
 // src/bridges/navigation.ts
-var DEFAULT_AGENT9 = { 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_AGENT9, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT11, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const disposers = [];
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
@@ -2432,12 +2969,12 @@ function registerNavigationBridge(host, options) {
 }
 
 // src/bridges/catalog.ts
-var DEFAULT_AGENT10 = { id: "agent", name: "Agent", color: "#a855f7" };
-var str2 = (v, fallback = "") => typeof v === "string" ? v : fallback;
-var num2 = (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_AGENT10, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT12, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const catalogId = adapter.id ?? "catalog";
   const disposers = [];
@@ -2507,7 +3044,7 @@ function registerCatalogBridge(host, options) {
     { id: { type: "string" }, withTrashed: { type: "boolean" } },
     ["id"],
     async (args) => {
-      const id = str2(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 });
@@ -2523,7 +3060,7 @@ function registerCatalogBridge(host, options) {
     [],
     async (args) => {
       const withTrashed = args.withTrashed === true;
-      const prices = args.productId !== void 0 ? await adapter.prices.forProduct(str2(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,
@@ -2549,13 +3086,13 @@ function registerCatalogBridge(host, options) {
     },
     ["name"],
     async (args) => {
-      const name = str2(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: str2(args.description) } : {},
+        ...args.description !== void 0 ? { description: str4(args.description) } : {},
         ...args.active !== void 0 ? { active: args.active === true } : {},
-        ...args.lookupKey !== void 0 ? { lookupKey: str2(args.lookupKey) } : {},
+        ...args.lookupKey !== void 0 ? { lookupKey: str4(args.lookupKey) } : {},
         ...args.metadata && typeof args.metadata === "object" ? { metadata: args.metadata } : {}
       });
       fancyAutoCommon.pushUndoEntry(agent.id, {
@@ -2568,7 +3105,7 @@ function registerCatalogBridge(host, options) {
       });
       return textResult(`Created product ${product.id} (${product.name})`, product);
     },
-    (args) => target(void 0, `create product ${str2(args.name)}`)
+    (args) => target(void 0, `create product ${str4(args.name)}`)
   );
   reg(
     "catalog_create_price",
@@ -2585,19 +3122,19 @@ function registerCatalogBridge(host, options) {
     },
     ["productId", "currency", "unitAmount", "type"],
     async (args) => {
-      const productId = str2(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 = str2(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: str2(args.currency),
-        unitAmount: num2(args.unitAmount),
+        currency: str4(args.currency),
+        unitAmount: num4(args.unitAmount),
         type,
-        ...args.recurringInterval !== void 0 ? { recurringInterval: str2(args.recurringInterval) } : {},
-        ...args.nickname !== void 0 ? { nickname: str2(args.nickname) } : {},
-        ...args.lookupKey !== void 0 ? { lookupKey: str2(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, {
@@ -2610,7 +3147,7 @@ function registerCatalogBridge(host, options) {
       });
       return textResult(`Created ${type} price ${price.id} on ${productId}`, price);
     },
-    (args) => target(str2(args.productId), `create price on ${str2(args.productId)}`)
+    (args) => target(str4(args.productId), `create price on ${str4(args.productId)}`)
   );
   reg(
     "catalog_delete_product",
@@ -2618,7 +3155,7 @@ function registerCatalogBridge(host, options) {
     { id: { type: "string" }, confirm: { type: "boolean" } },
     ["id"],
     async (args) => {
-      const id = str2(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);
@@ -2635,7 +3172,7 @@ function registerCatalogBridge(host, options) {
       });
       return textResult(`Deleted product ${id}`, { id });
     },
-    (args) => target(str2(args.id), `delete product ${str2(args.id)}`)
+    (args) => target(str4(args.id), `delete product ${str4(args.id)}`)
   );
   reg(
     "catalog_delete_price",
@@ -2643,7 +3180,7 @@ function registerCatalogBridge(host, options) {
     { id: { type: "string" }, confirm: { type: "boolean" } },
     ["id"],
     async (args) => {
-      const id = str2(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);
@@ -2660,7 +3197,7 @@ function registerCatalogBridge(host, options) {
       });
       return textResult(`Deleted price ${id}`, { id });
     },
-    (args) => target(str2(args.id), `delete price ${str2(args.id)}`)
+    (args) => target(str4(args.id), `delete price ${str4(args.id)}`)
   );
   reg(
     "catalog_sync_product",
@@ -2669,13 +3206,13 @@ function registerCatalogBridge(host, options) {
     ["id"],
     async (args) => {
       if (!adapter.syncProductAndPrices) return errorResult("Host did not wire Stripe sync.");
-      const id = str2(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(str2(args.id), `sync product ${str2(args.id)}`)
+    (args) => target(str4(args.id), `sync product ${str4(args.id)}`)
   );
   reg(
     "catalog_test_connection",
@@ -2702,13 +3239,13 @@ function registerCatalogBridge(host, options) {
     },
     ["priceId", "successUrl", "cancelUrl"],
     async (args) => {
-      const priceId = str2(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: str2(args.successUrl),
-        cancelUrl: str2(args.cancelUrl),
-        ...args.customer !== void 0 ? { customer: str2(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;
@@ -2717,11 +3254,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: num2(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(str2(args.priceId), `checkout ${str2(args.priceId)}`)
+    (args) => target(str4(args.priceId), `checkout ${str4(args.priceId)}`)
   );
   return {
     id: `catalog:${catalogId}`,
@@ -2733,12 +3270,12 @@ function registerCatalogBridge(host, options) {
 }
 
 // src/bridges/features.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_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_AGENT11, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT13, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const featuresId = adapter.id ?? "features";
   const disposers = [];
@@ -2799,7 +3336,7 @@ function registerFeaturesBridge(host, options) {
     { feature: { type: "string" }, subject: { description: "Opaque subject." }, context: { description: "Optional context." } },
     ["feature"],
     async (args) => {
-      const feature = str3(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 };
@@ -2814,7 +3351,7 @@ function registerFeaturesBridge(host, options) {
     ["feature"],
     async (args) => {
       if (!adapter.explain) return errorResult("Host did not wire explain().");
-      const result = await adapter.explain(str3(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
@@ -2843,15 +3380,15 @@ function registerFeaturesBridge(host, options) {
     },
     ["key"],
     (args) => {
-      const key = str3(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: str3(args.name) } : {},
-        ...args.description !== void 0 ? { description: str3(args.description) } : {},
-        ...args.type !== void 0 ? { type: str3(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: num3(args.limit) } : {}
+        ...args.limit !== void 0 ? { limit: num5(args.limit) } : {}
       };
       adapter.registerFeature(key, definition);
       fancyAutoCommon.pushUndoEntry(agent.id, {
@@ -2866,7 +3403,7 @@ function registerFeaturesBridge(host, options) {
       });
       return textResult(`${existed ? "Redefined" : "Defined"} feature ${key} (${definition.type ?? "boolean"})`, { key, definition });
     },
-    (args) => target(str3(args.key), `define ${str3(args.key)}`)
+    (args) => target(str5(args.key), `define ${str5(args.key)}`)
   );
   reg(
     "features_grant",
@@ -2874,7 +3411,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 = str3(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;
@@ -2893,7 +3430,7 @@ function registerFeaturesBridge(host, options) {
       });
       return textResult(`Granted group ${groupKey}`, { subject: args.subject, group: groupKey });
     },
-    (args) => target(str3(args.group), `grant ${str3(args.group)}`)
+    (args) => target(str5(args.group), `grant ${str5(args.group)}`)
   );
   reg(
     "features_revoke",
@@ -2901,7 +3438,7 @@ function registerFeaturesBridge(host, options) {
     { subject: { description: "Opaque subject." }, group: { type: "string" }, confirm: { type: "boolean" } },
     ["subject", "group"],
     async (args) => {
-      const groupKey = str3(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;
@@ -2919,7 +3456,7 @@ function registerFeaturesBridge(host, options) {
       });
       return textResult(`Revoked group ${groupKey}`, { subject: args.subject, group: groupKey });
     },
-    (args) => target(str3(args.group), `revoke ${str3(args.group)}`)
+    (args) => target(str5(args.group), `revoke ${str5(args.group)}`)
   );
   reg(
     "features_consume",
@@ -2928,14 +3465,14 @@ function registerFeaturesBridge(host, options) {
     ["feature", "subject"],
     async (args) => {
       if (!adapter.tryConsume) return errorResult("Host did not wire usage metering (tryConsume).");
-      const feature = str3(args.feature);
-      const amount = num3(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(str3(args.feature), `consume ${str3(args.feature)}`)
+    (args) => target(str5(args.feature), `consume ${str5(args.feature)}`)
   );
   return {
     id: `features:${featuresId}`,
@@ -3140,11 +3677,11 @@ function attachSseRelay(server, options) {
 
 // src/sharing/use-co-browse-session.ts
 init_registry();
-var DEFAULT_AGENT12 = { 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_AGENT12, ...options.agent ?? {} };
+  const agent = { ...DEFAULT_AGENT14, ...options.agent ?? {} };
   const relayBaseUrl = options.relayBaseUrl ?? "/agent-relay";
   const serverRef = react.useRef(null);
   const relayRef = react.useRef(null);
@@ -4370,7 +4907,9 @@ exports.registerCatalogBridge = registerCatalogBridge;
 exports.registerChartsBridge = registerChartsBridge;
 exports.registerCodeBridge = registerCodeBridge;
 exports.registerFeaturesBridge = registerFeaturesBridge;
+exports.registerFilesBridge = registerFilesBridge;
 exports.registerFormBridge = registerFormBridge;
+exports.registerMapBridge = registerMapBridge;
 exports.registerNavigationBridge = registerNavigationBridge;
 exports.registerSceneBridge = registerSceneBridge;
 exports.registerScreensBridge = registerScreensBridge;