@particle-academy/agent-integrations 0.49.0 → 0.51.0

package/dist/index.cjs

@@ -60,13 +60,23 @@ var ToolRegistry = class {
      */
     this.withdrawn = /* @__PURE__ */ new Set();
   }
-  registerTool(definition, handler) {
-    this.tools.set(definition.name, { definition, handler });
-    this.withdrawn.delete(definition.name);
+  registerTool(definition, handler, options = {}) {
+    const name = definition.name;
+    const { owner, replace = false } = options;
+    const held = this.tools.get(name);
+    if (held && !replace && (owner === void 0 || held.owner !== owner)) {
+      throw new Error(
+        `Tool "${name}" is already registered by ${describeOwner(held.owner)}; ${describeOwner(owner)} cannot register it too. Two registrants for one name would leave the first one listed but unreachable. Give one of them a different tool name, dispose the first registration, or pass { replace: true } to take the name over deliberately.`
+      );
+    }
+    const record = owner === void 0 ? { definition, handler } : { definition, handler, owner };
+    this.tools.set(name, record);
+    this.withdrawn.delete(name);
     this.onToolsChanged();
     return () => {
-      if (this.tools.delete(definition.name)) {
-        this.withdrawn.add(definition.name);
+      if (this.tools.get(name) === record) {
+        this.tools.delete(name);
+        this.withdrawn.add(name);
         this.onToolsChanged();
       }
     };
@@ -95,6 +105,9 @@ var ToolRegistry = class {
   onToolsChanged() {
   }
 };
+function describeOwner(owner) {
+  return owner === void 0 ? "an unnamed registrant (pass { owner } to registerTool to identify it)" : `"${owner}"`;
+}
 
 // src/mcp/server.ts
 var MicroMcpServer = class extends ToolRegistry {
@@ -434,7 +447,7 @@ function registerTuiBridge(host, options) {
       } catch (error) {
         return errorResult(error instanceof Error ? error.message : String(error));
       }
-    }));
+    }, { owner: "tui" }));
   };
   const publish = async (surfaceId, type, payload, actor = defaultActor, priority = "normal") => options.eventStore.append({ appId: options.appId, sessionId: options.sessionId, surfaceId, type, payload, actor, priority });
   register("tui_surfaces_list", "List addressable Fancy TUI surfaces and commands.", {}, [], () => options.registry.list().map((surface) => ({ id: surface.id, kind: surface.kind, label: surface.label, commands: surface.commands?.map((command) => ({ name: command.name, description: command.description, policy: command.policy ?? "execute", inputSchema: command.inputSchema })) ?? [] })));
@@ -514,6 +527,7 @@ function registerTuiBridge(host, options) {
 
 // src/undo/undo-tools.ts
 var installedHosts = /* @__PURE__ */ new WeakSet();
+var UNDO_TOOLS_OWNER = "agent-undo";
 function ensureUndoToolsRegistered(host, options = {}) {
   if (installedHosts.has(host)) return;
   installedHosts.add(host);
@@ -538,7 +552,8 @@ function registerUndoTools(host, options = {}) {
         const entry = await fancyAutoCommon.undoOne(agentOf(args));
         if (!entry) return errorResult("Nothing to undo.");
         return textResult(`Undid: ${entry.label}`, { entry: serialize(entry) });
-      }
+      },
+      { owner: UNDO_TOOLS_OWNER }
     )
   );
   disposers.push(
@@ -556,7 +571,8 @@ function registerUndoTools(host, options = {}) {
         const entry = await fancyAutoCommon.redoOne(agentOf(args));
         if (!entry) return errorResult("Nothing to redo.");
         return textResult(`Redid: ${entry.label}`, { entry: serialize(entry) });
-      }
+      },
+      { owner: UNDO_TOOLS_OWNER }
     )
   );
   disposers.push(
@@ -574,7 +590,8 @@ function registerUndoTools(host, options = {}) {
         const history = fancyAutoCommon.readHistory(agentOf(args)).map(serialize);
         const text = history.map((e) => `${new Date(e.timestamp).toISOString()} ${e.bridgeId} ${e.action}: ${e.label}`).join("\n");
         return textResult(text || "(empty)", history);
-      }
+      },
+      { owner: UNDO_TOOLS_OWNER }
     )
   );
   return () => disposers.forEach((d) => d());
@@ -595,6 +612,7 @@ function registerFormBridge(host, options) {
   const agent = { ...DEFAULT_AGENT, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const disposers = [];
+  const bridgeId = `form:${adapter.id}`;
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const formId = adapter.id;
   const target = (args) => ({
@@ -625,7 +643,8 @@ function registerFormBridge(host, options) {
           description,
           inputSchema: { type: "object", properties, required, additionalProperties: false }
         },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -743,7 +762,7 @@ function registerFormBridge(host, options) {
     true
   );
   return {
-    id: `form:${formId}`,
+    id: bridgeId,
     title: adapter.title ?? formId,
     dispose: () => {
       for (const d of disposers) d();
@@ -757,6 +776,7 @@ function registerSheetsBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT2, ...options.agent ?? {} };
   const disposers = [];
+  const bridgeId = "sheets";
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (sheetId, address) => ({
     kind: "sheet",
@@ -786,7 +806,8 @@ function registerSheetsBridge(host, options) {
           description,
           inputSchema: { type: "object", properties, required, additionalProperties: false }
         },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -966,7 +987,7 @@ function registerSheetsBridge(host, options) {
     (args) => target(getSheetId(args), String(args.address ?? ""))
   );
   return {
-    id: "sheets",
+    id: bridgeId,
     title: "Sheets",
     dispose: () => {
       for (const d of disposers) d();
@@ -1105,6 +1126,7 @@ function registerCodeBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT3, ...options.agent ?? {} };
   const disposers = [];
+  const bridgeId = `code:${adapter.id}`;
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = {
     kind: "code",
@@ -1144,7 +1166,8 @@ function registerCodeBridge(host, options) {
           description,
           inputSchema: { type: "object", properties, required, additionalProperties: false }
         },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -1292,7 +1315,7 @@ function registerCodeBridge(host, options) {
     false
   );
   return {
-    id: `code:${adapter.id}`,
+    id: bridgeId,
     title: adapter.title ?? adapter.id,
     dispose: () => {
       for (const d of disposers) d();
@@ -1306,6 +1329,7 @@ function registerChartsBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT4, ...options.agent ?? {} };
   const disposers = [];
+  const bridgeId = `chart:${adapter.id}`;
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = {
     kind: "chart",
@@ -1331,7 +1355,8 @@ function registerChartsBridge(host, options) {
     disposers.push(
       host.registerTool(
         { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -1407,7 +1432,7 @@ function registerChartsBridge(host, options) {
     true
   );
   return {
-    id: `chart:${adapter.id}`,
+    id: bridgeId,
     title: adapter.title ?? adapter.id,
     dispose: () => {
       for (const d of disposers) d();
@@ -1421,6 +1446,7 @@ function registerGridBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT5, ...options.agent ?? {} };
   const disposers = [];
+  const bridgeId = `grid:${adapter.id}`;
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (part) => ({
     kind: "grid",
@@ -1450,7 +1476,8 @@ function registerGridBridge(host, options) {
           description,
           inputSchema: { type: "object", properties, required, additionalProperties: false }
         },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -1608,7 +1635,7 @@ function registerGridBridge(host, options) {
     );
   }
   return {
-    id: `grid:${adapter.id}`,
+    id: bridgeId,
     title: adapter.title ?? adapter.id,
     dispose: () => {
       for (const d of disposers) d();
@@ -1623,6 +1650,7 @@ function registerSceneBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT6, ...options.agent ?? {} };
   const disposers = [];
+  const bridgeId = `scene:${adapter.id}`;
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (objectId) => ({
     kind: "scene",
@@ -1648,7 +1676,8 @@ function registerSceneBridge(host, options) {
     disposers.push(
       host.registerTool(
         { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -1801,7 +1830,7 @@ function registerSceneBridge(host, options) {
     true
   );
   return {
-    id: `scene:${adapter.id}`,
+    id: bridgeId,
     title: adapter.title ?? adapter.id,
     dispose: () => {
       for (const d of disposers) d();
@@ -1845,6 +1874,7 @@ function registerScreensBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT7, ...options.agent ?? {} };
   const disposers = [];
+  const bridgeId = "screens";
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (screenId) => ({
     kind: "screens",
@@ -1868,7 +1898,8 @@ function registerScreensBridge(host, options) {
     disposers.push(
       host.registerTool(
         { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -2037,7 +2068,7 @@ function registerScreensBridge(host, options) {
     (args) => target(String(args.screen ?? ""))
   );
   return {
-    id: "screens",
+    id: bridgeId,
     title: "Screens",
     dispose: () => {
       for (const d of disposers) d();
@@ -2051,6 +2082,7 @@ function registerSlidesBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT8, ...options.agent ?? {} };
   const disposers = [];
+  const bridgeId = "slides";
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const deckTarget = () => ({
     kind: "deck",
@@ -2097,7 +2129,8 @@ function registerSlidesBridge(host, options) {
             additionalProperties: false
           }
         },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -2462,7 +2495,7 @@ function registerSlidesBridge(host, options) {
     (args) => elementTarget(str(args?.slideId), str(args?.elementId))
   );
   return {
-    id: "slides",
+    id: bridgeId,
     title: "Slides",
     dispose: () => {
       for (const d of disposers.splice(0)) d();
@@ -2497,6 +2530,7 @@ function registerMapBridge(host, options) {
   const { adapter } = options;
   const agent = { ...DEFAULT_AGENT9, ...options.agent ?? {} };
   const disposers = [];
+  const bridgeId = "map";
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const mTarget = (args, result) => ({
     kind: "map",
@@ -2528,7 +2562,8 @@ function registerMapBridge(host, options) {
             additionalProperties: false
           }
         },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -2807,7 +2842,7 @@ function registerMapBridge(host, options) {
     }
   );
   return {
-    id: "map",
+    id: bridgeId,
     title: "Map",
     dispose: () => {
       for (const d of disposers) d();
@@ -2819,6 +2854,7 @@ function registerMapBridge(host, options) {
 function registerGitBridge(host, options) {
   const agent = { id: "agent", name: "Agent", color: "#a855f7", ...options.agent ?? {} };
   const disposers = [];
+  const bridgeId = "git";
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const reg = (name, description, properties, required, handler, mutation2 = false) => {
     const wrapped = async (args) => {
@@ -2838,7 +2874,7 @@ function registerGitBridge(host, options) {
       name,
       description,
       inputSchema: { type: "object", properties, required, additionalProperties: false }
-    }, final));
+    }, final, { owner: bridgeId }));
   };
   reg("git_status", "Read normalized working-tree and branch status.", {}, [], async () => {
     const result = await options.adapter.status();
@@ -2899,7 +2935,7 @@ function registerGitBridge(host, options) {
     draft: { type: "boolean" },
     apply: { type: "boolean" }
   }, ["title", "sourceBranch", "targetBranch"]);
-  return { id: "git", title: "Git", dispose: () => disposers.forEach((dispose) => dispose()) };
+  return { id: bridgeId, title: "Git", dispose: () => disposers.forEach((dispose) => dispose()) };
 }
 
 // src/bridges/files.ts
@@ -2943,6 +2979,7 @@ function registerFilesBridge(host, options) {
   const agent = { ...DEFAULT_AGENT10, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const disposers = [];
+  const bridgeId = "files";
   const guard = (path) => {
     if (options.root !== void 0) assertPathWithinRoot(options.root, path);
     return path;
@@ -2978,7 +3015,8 @@ function registerFilesBridge(host, options) {
             additionalProperties: false
           }
         },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -3168,7 +3206,7 @@ function registerFilesBridge(host, options) {
     fTarget
   );
   return {
-    id: "files",
+    id: bridgeId,
     title: "Files",
     dispose: () => {
       for (const d of disposers) d();
@@ -3184,6 +3222,7 @@ function registerTerminalBridge(host, options) {
   const pendingMode = options.pendingMode ?? true;
   const screenId = options.screenId ?? options.adapter?.screenId;
   const disposers = [];
+  const bridgeId = "terminal";
   const staged = /* @__PURE__ */ new Map();
   let seq = 0;
   ensureUndoToolsRegistered(host);
@@ -3250,7 +3289,8 @@ function registerTerminalBridge(host, options) {
           description,
           inputSchema: { type: "object", properties, required, additionalProperties: false }
         },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -3447,7 +3487,7 @@ function registerTerminalBridge(host, options) {
     );
   }
   return {
-    id: "terminal",
+    id: bridgeId,
     title: "Terminal",
     dispose: () => {
       disposers.forEach((d) => d());
@@ -3492,6 +3532,7 @@ function registerNavigationBridge(host, options) {
   const agent = { ...DEFAULT_AGENT12, ...options.agent ?? {} };
   const pendingMode = options.pendingMode ?? true;
   const disposers = [];
+  const bridgeId = "navigation";
   let groundedRevision = null;
   const staleIntent = async () => {
     const current = await adapter.getRevision?.();
@@ -3535,7 +3576,8 @@ function registerNavigationBridge(host, options) {
           description,
           inputSchema: { type: "object", properties, required, additionalProperties: false }
         },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -3626,11 +3668,11 @@ function registerNavigationBridge(host, options) {
         bridgeId: "navigation",
         action: "nav_visit",
         label: `Navigate to ${url}`,
-        undo: () => {
-          adapter.visit(from);
+        undo: async () => {
+          await adapter.visit(from);
         },
-        redo: () => {
-          adapter.visit(url);
+        redo: async () => {
+          await adapter.visit(url);
         }
       });
       return textResult(`Navigated to ${url}`, { url });
@@ -3771,7 +3813,7 @@ function registerNavigationBridge(host, options) {
     (args) => target(`Submit ${String(args.handle ?? "")}`, String(args.handle ?? ""))
   );
   return {
-    id: "navigation",
+    id: bridgeId,
     title: "Co-browsing",
     dispose: () => {
       for (const d of disposers) d();
@@ -3789,6 +3831,7 @@ function registerCatalogBridge(host, options) {
   const pendingMode = options.pendingMode ?? true;
   const catalogId = adapter.id ?? "catalog";
   const disposers = [];
+  const bridgeId = `catalog:${catalogId}`;
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (elementId, label) => ({
     kind: "custom",
@@ -3814,7 +3857,8 @@ function registerCatalogBridge(host, options) {
     disposers.push(
       host.registerTool(
         { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -3911,8 +3955,12 @@ function registerCatalogBridge(host, options) {
         bridgeId: catalogId,
         action: "catalog_create_product",
         label: `Created product ${product.id} (${product.name})`,
-        undo: () => void adapter.products.remove(product.id),
-        redo: () => void adapter.createProduct({ ...product })
+        undo: async () => {
+          await adapter.products.remove(product.id);
+        },
+        redo: async () => {
+          await adapter.createProduct({ ...product });
+        }
       });
       return textResult(`Created product ${product.id} (${product.name})`, product);
     },
@@ -3953,8 +4001,12 @@ function registerCatalogBridge(host, options) {
         bridgeId: catalogId,
         action: "catalog_create_price",
         label: `Created price ${price.id} on ${productId}`,
-        undo: () => void adapter.prices.remove(price.id),
-        redo: () => void adapter.createPrice({ ...price })
+        undo: async () => {
+          await adapter.prices.remove(price.id);
+        },
+        redo: async () => {
+          await adapter.createPrice({ ...price });
+        }
       });
       return textResult(`Created ${type} price ${price.id} on ${productId}`, price);
     },
@@ -3978,8 +4030,12 @@ function registerCatalogBridge(host, options) {
         bridgeId: catalogId,
         action: "catalog_delete_product",
         label: `Deleted product ${id} (${product.name})`,
-        undo: () => void adapter.createProduct({ ...snapshot }),
-        redo: () => void adapter.products.remove(id)
+        undo: async () => {
+          await adapter.createProduct({ ...snapshot });
+        },
+        redo: async () => {
+          await adapter.products.remove(id);
+        }
       });
       return textResult(`Deleted product ${id}`, { id });
     },
@@ -4003,8 +4059,12 @@ function registerCatalogBridge(host, options) {
         bridgeId: catalogId,
         action: "catalog_delete_price",
         label: `Deleted price ${id}`,
-        undo: () => void adapter.createPrice({ ...snapshot }),
-        redo: () => void adapter.prices.remove(id)
+        undo: async () => {
+          await adapter.createPrice({ ...snapshot });
+        },
+        redo: async () => {
+          await adapter.prices.remove(id);
+        }
       });
       return textResult(`Deleted price ${id}`, { id });
     },
@@ -4072,7 +4132,7 @@ function registerCatalogBridge(host, options) {
     (args) => target(str4(args.priceId), `checkout ${str4(args.priceId)}`)
   );
   return {
-    id: `catalog:${catalogId}`,
+    id: bridgeId,
     title: adapter.title ?? "Catalog",
     dispose: () => {
       for (const d of disposers.splice(0)) d();
@@ -4090,6 +4150,7 @@ function registerFeaturesBridge(host, options) {
   const pendingMode = options.pendingMode ?? true;
   const featuresId = adapter.id ?? "features";
   const disposers = [];
+  const bridgeId = `features:${featuresId}`;
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (elementId, label) => ({
     kind: "custom",
@@ -4115,7 +4176,8 @@ function registerFeaturesBridge(host, options) {
     disposers.push(
       host.registerTool(
         { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -4234,10 +4296,12 @@ function registerFeaturesBridge(host, options) {
         action: "features_grant",
         label: `Granted group ${groupKey}`,
         // Only reverse if WE added it (idempotent assign — don't revoke a pre-existing grant).
-        undo: () => {
-          if (!already) void adapter.detachGroup(args.subject, groupKey);
+        undo: async () => {
+          if (!already) await adapter.detachGroup(args.subject, groupKey);
         },
-        redo: () => void adapter.assignGroup(args.subject, groupKey)
+        redo: async () => {
+          await adapter.assignGroup(args.subject, groupKey);
+        }
       });
       return textResult(`Granted group ${groupKey}`, { subject: args.subject, group: groupKey });
     },
@@ -4260,10 +4324,12 @@ function registerFeaturesBridge(host, options) {
         bridgeId: featuresId,
         action: "features_revoke",
         label: `Revoked group ${groupKey}`,
-        undo: () => {
-          if (had) void adapter.assignGroup(args.subject, groupKey);
+        undo: async () => {
+          if (had) await adapter.assignGroup(args.subject, groupKey);
         },
-        redo: () => void adapter.detachGroup(args.subject, groupKey)
+        redo: async () => {
+          await adapter.detachGroup(args.subject, groupKey);
+        }
       });
       return textResult(`Revoked group ${groupKey}`, { subject: args.subject, group: groupKey });
     },
@@ -4286,7 +4352,7 @@ function registerFeaturesBridge(host, options) {
     (args) => target(str5(args.feature), `consume ${str5(args.feature)}`)
   );
   return {
-    id: `features:${featuresId}`,
+    id: bridgeId,
     title: adapter.title ?? "Features",
     dispose: () => {
       for (const d of disposers.splice(0)) d();
@@ -4321,6 +4387,7 @@ function registerPasskeyBridge(host, options) {
   const agent = { ...DEFAULT_AGENT15, ...options.agent ?? {} };
   const surfaceId = adapter.id ?? "passkeys";
   const disposers = [];
+  const bridgeId = `passkeys:${surfaceId}`;
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   const target = (elementId, label) => ({
     kind: "custom",
@@ -4355,7 +4422,8 @@ function registerPasskeyBridge(host, options) {
             additionalProperties: false
           }
         },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -4421,8 +4489,12 @@ function registerPasskeyBridge(host, options) {
         bridgeId: surfaceId,
         action: "passkey_rename",
         label: `Renamed passkey to ${name || "(unnamed)"}`,
-        undo: () => void adapter.rename({ id, name: previous }),
-        redo: () => void adapter.rename({ id, name })
+        undo: async () => {
+          await adapter.rename({ id, name: previous });
+        },
+        redo: async () => {
+          await adapter.rename({ id, name });
+        }
       });
       return textResult(`Renamed passkey ${id} to ${name || "(unnamed)"}`, { id, name, previous });
     },
@@ -4472,7 +4544,7 @@ function registerPasskeyBridge(host, options) {
     (args) => target(void 0, `begin enrollment${args.name ? ` (${str6(args.name)})` : ""}`)
   );
   return {
-    id: `passkeys:${surfaceId}`,
+    id: bridgeId,
     title: adapter.title ?? "Passkeys",
     dispose: () => {
       for (const d of disposers.splice(0)) d();
@@ -4488,6 +4560,7 @@ function registerDocBridge(host, options) {
   const makeNode = options.makeNode ?? (({ id, type, parent, order }, props) => ({ id, type, parent, order, props }));
   const describeNode = options.describeNode ?? ((n) => ({ id: n.id, type: n.type, parent: n.parent, props: Object.keys(n.props ?? {}) }));
   const disposers = [];
+  const bridgeId = surface;
   ensureUndoToolsRegistered(host, { defaultAgentId: agent.id });
   let idSeq = 0;
   const mintId = () => {
@@ -4548,7 +4621,8 @@ function registerDocBridge(host, options) {
     disposers.push(
       host.registerTool(
         { name, description, inputSchema: { type: "object", properties, required, additionalProperties: false } },
-        final
+        final,
+        { owner: bridgeId }
       )
     );
   };
@@ -4723,7 +4797,7 @@ function registerDocBridge(host, options) {
     false
   );
   return {
-    id: surface,
+    id: bridgeId,
     title: surface,
     dispose: () => {
       for (const d of disposers) d();
@@ -4876,7 +4950,9 @@ function registerScreenDocBridge(host, options) {
         authored.length ? `${authored.length} addressable, ${syntheticCount} positional` : `no addressable ids \u2014 all ${syntheticCount} nodes are positional`,
         { addressable: authored, syntheticCount }
       );
-    })
+    }),
+    // Same registrant as the doc bridge above, which registers under its surface.
+    { owner: surface }
   );
   return {
     id: surface,