@particle-academy/agent-integrations 0.41.0 → 0.43.0

package/dist/components-shared-whiteboard.cjs

@@ -43,14 +43,37 @@ var MCP_PROTOCOL_VERSION = "2025-06-18";
 var ToolRegistry = class {
   constructor() {
     this.tools = /* @__PURE__ */ new Map();
+    /**
+     * Tools that existed and were withdrawn, kept so a call that races an unmount
+     * can say WHICH thing happened.
+     *
+     * The tool surface is dynamic by design — "site tools always, page tools while
+     * mounted" — so an agent deciding to call a tool while the human navigates
+     * away is normal traffic, not an edge case. Reporting that as `Unknown tool`
+     * is the least useful thing available: it reads as "the agent is broken" or
+     * "you asked for something imaginary", when the truth is "that surface just
+     * closed".
+     *
+     * Names only. Nothing about the handler is retained, so this cannot keep a
+     * disposed surface alive.
+     */
+    this.withdrawn = /* @__PURE__ */ new Set();
   }
   registerTool(definition, handler) {
     this.tools.set(definition.name, { definition, handler });
+    this.withdrawn.delete(definition.name);
     this.onToolsChanged();
     return () => {
-      if (this.tools.delete(definition.name)) this.onToolsChanged();
+      if (this.tools.delete(definition.name)) {
+        this.withdrawn.add(definition.name);
+        this.onToolsChanged();
+      }
     };
   }
+  /** Why `name` is not callable, phrased for whoever has to act on it. */
+  missingToolMessage(name) {
+    return this.withdrawn.has(name) ? `Tool "${name}" was withdrawn: the surface it targets is no longer mounted. Call tools/list for the current surface \u2014 the site-wide tools remain available.` : `Unknown tool: ${name}`;
+  }
   getTool(name) {
     return this.tools.get(name) ?? null;
   }
@@ -60,7 +83,7 @@ var ToolRegistry = class {
   async callTool(name, args = {}) {
     const tool = this.tools.get(name);
     if (!tool) {
-      throw new Error(`Unknown tool: ${name}`);
+      throw new Error(this.missingToolMessage(name));
     }
     return tool.handler(args);
   }
@@ -141,7 +164,7 @@ var MicroMcpServer = class extends ToolRegistry {
         }
         const tool = this.tools.get(name);
         if (!tool) {
-          throw rpcError(JSONRPC_METHOD_NOT_FOUND, `Unknown tool: ${name}`);
+          throw rpcError(JSONRPC_METHOD_NOT_FOUND, this.missingToolMessage(name));
         }
         const result = await tool.handler(args, { transport });
         return result;