@particle-academy/agent-integrations 0.44.0 → 0.45.0

package/dist/components-shared-whiteboard.js

@@ -1,11 +1,11 @@
 import { ShareControls, AgentCursor, AgentActivityHighlight, AgentPanel } from './chunk-QDC7MXBH.js';
 import { createSessionDescriptor, attachSseRelay } from './chunk-6TZ5IBRN.js';
 import { attachInProcess } from './chunk-AFUULW5E.js';
-import { registerWhiteboardBridge } from './chunk-2LSU3NFO.js';
-import './chunk-HVDHT7DM.js';
+import { registerWhiteboardBridge } from './chunk-LQB42OSA.js';
+import './chunk-R4XXOGQH.js';
 import './chunk-2VENWGLZ.js';
 import './chunk-C3TYI5TJ.js';
-import { MicroMcpServer } from './chunk-QJYRWEXD.js';
+import { MicroMcpServer } from './chunk-CZV3WUW5.js';
 import { useState, useRef, useEffect, useCallback, useMemo } from 'react';
 import { Board, Connector, Shape, StickyNote, CursorLayer } from '@particle-academy/fancy-whiteboard';
 import { jsxs, jsx } from 'react/jsx-runtime';

package/dist/index.cjs

@@ -101,10 +101,18 @@ var MicroMcpServer = class extends ToolRegistry {
   constructor(options) {
     super();
     this.transports = /* @__PURE__ */ new Set();
-    this.notifyListChangedScheduled = false;
+    /**
+     * Transports owed a `tools/list_changed` at the end of this tick. Empty when
+     * none is scheduled. See {@link scheduleListChangedNotification}.
+     */
+    this.listChangedOwed = /* @__PURE__ */ new Set();
     this.info = options.info;
     this.capabilities = options.capabilities ?? { tools: { listChanged: true } };
     this.instructions = options.instructions;
+    if (options.protocolVersions && options.protocolVersions.length === 0) {
+      throw new Error("MicroMcpServer: protocolVersions is empty \u2014 a server must speak at least one protocol revision.");
+    }
+    this.protocolVersions = options.protocolVersions ? [...options.protocolVersions] : [MCP_PROTOCOL_VERSION];
   }
   attach(transport) {
     this.transports.add(transport);
@@ -150,7 +158,7 @@ var MicroMcpServer = class extends ToolRegistry {
     switch (method) {
       case "initialize":
         return {
-          protocolVersion: MCP_PROTOCOL_VERSION,
+          protocolVersion: this.negotiate(params?.protocolVersion),
           capabilities: this.capabilities,
           serverInfo: this.info,
           ...this.instructions ? { instructions: this.instructions } : {}
@@ -176,12 +184,31 @@ var MicroMcpServer = class extends ToolRegistry {
         throw rpcError(JSONRPC_METHOD_NOT_FOUND, `Unsupported method: ${method}`);
     }
   }
+  /** The revision to answer `initialize` with: the one asked for if spoken, else the newest. */
+  negotiate(requested) {
+    return typeof requested === "string" && this.protocolVersions.includes(requested) ? requested : this.protocolVersions[0];
+  }
+  /**
+   * Tell the transports that SAW the old tool list that it changed.
+   *
+   * Changes in one tick coalesce into one notification. The recipients are the
+   * transports attached at the moment of a change, not at the moment the
+   * notification goes out: a transport attached afterwards never had the old
+   * list, so "your list is stale" is noise to it — and on stdio, where a host
+   * builds the server and attaches stdin/stdout in the same tick, it was the
+   * first frame a client received, before it had even sent `initialize`.
+   */
   scheduleListChangedNotification() {
-    if (this.notifyListChangedScheduled) return;
-    this.notifyListChangedScheduled = true;
+    if (this.transports.size === 0) return;
+    const scheduled = this.listChangedOwed.size > 0;
+    for (const t of this.transports) this.listChangedOwed.add(t);
+    if (scheduled) return;
     queueMicrotask(() => {
-      this.notifyListChangedScheduled = false;
-      this.broadcast({ jsonrpc: "2.0", method: "notifications/tools/list_changed" });
+      const owed = this.listChangedOwed;
+      this.listChangedOwed = /* @__PURE__ */ new Set();
+      for (const t of owed) {
+        if (this.transports.has(t)) t.send({ jsonrpc: "2.0", method: "notifications/tools/list_changed" });
+      }
     });
   }
   /** Send an application notification to every client, or one attached transport. */