mindweave 0.0.1 → 2.1.2

package/dist/mcp/discover.js

@@ -0,0 +1,128 @@
+/**
+ * discover.ts — deciding, once per connection, which MCP a server actually speaks.
+ *
+ * 2026-07-28 added `server/discover`, a required RPC that reports a server's supported
+ * protocol versions, capabilities and identity before any other call. That is the happy
+ * path. The problem is everything else: the overwhelming majority of servers deployed
+ * today predate the revision, have never heard of the method, and expect the
+ * `initialize` handshake that 2026-07-28 deleted.
+ *
+ * So connecting is a PROBE, not an assumption:
+ *
+ *   1. Call `server/discover`. If it answers, take the newest version we both know
+ *      and speak that dialect.
+ *   2. If it comes back "method not found", that IS the compatibility signal — the
+ *      server is pre-stateless. Fall back to `initialize`, and speak whatever version
+ *      it reports back.
+ *   3. If neither works, the server is not usable; the pool records it as failed and
+ *      the session carries on without it.
+ *
+ * The decision itself (`negotiate`) is a pure function over two version lists, so the
+ * whole matrix is unit-tested rather than discovered against live servers. Only the
+ * probe does I/O.
+ */
+import { PREFERRED_VERSION, SUPPORTED_VERSIONS, dialectFor, isMethodNotFound, } from "./protocol.js";
+/**
+ * Pick the best protocol version we and the server both support (pure).
+ *
+ * "Best" is NEWEST, not first-listed: a server may advertise in any order, and taking
+ * its preference would silently pin us to an old dialect whenever a server lists
+ * chronologically. Returns null when there is no overlap at all, which is a real
+ * outcome (`UnsupportedProtocolVersionError`) and not an error to swallow.
+ */
+export function negotiate(serverVersions, clientVersions = SUPPORTED_VERSIONS) {
+    const ours = new Set(clientVersions);
+    const shared = serverVersions.filter((v) => ours.has(v));
+    if (shared.length === 0)
+        return null;
+    // ISO dates sort lexicographically, so this is a plain descending sort.
+    return shared.sort().reverse()[0];
+}
+/**
+ * A single version string reported by a legacy `initialize` (pure).
+ *
+ * Old servers answer with one `protocolVersion`, not a list. If we know it, use it. If
+ * we do not, the server is speaking something outside our range and we do NOT guess:
+ * pretending to speak an unknown revision is how a client ends up sending fields a
+ * server rejects halfway through a session.
+ */
+export function acceptLegacyVersion(reported, clientVersions = SUPPORTED_VERSIONS) {
+    if (typeof reported !== "string" || !reported.trim())
+        return null;
+    return clientVersions.includes(reported) ? reported : null;
+}
+/** Raised when a server answers but shares no protocol revision with us. */
+export class UnsupportedProtocolVersionError extends Error {
+    serverVersions;
+    constructor(serverVersions) {
+        super(`no shared MCP protocol version (server offers ${serverVersions.join(", ") || "nothing"}; ` +
+            `this client speaks ${SUPPORTED_VERSIONS.join(", ")})`);
+        this.serverVersions = serverVersions;
+        this.name = "UnsupportedProtocolVersionError";
+    }
+}
+/**
+ * Run the probe against a live server and settle on a dialect.
+ *
+ * Note the ORDER: `server/discover` first, always. Trying `initialize` first would
+ * work against everything today and quietly rot, because a 2026-07-28 server has no
+ * `initialize` to answer. Leading with the new method and treating method-not-found as
+ * the legacy signal is the direction that ages correctly.
+ */
+export async function probe(rpc, identity, capabilities) {
+    try {
+        const result = (await rpc.request("server/discover"));
+        const offered = Array.isArray(result?.protocolVersions) ? result.protocolVersions.filter((v) => typeof v === "string") : [];
+        const chosen = negotiate(offered);
+        if (!chosen)
+            throw new UnsupportedProtocolVersionError(offered);
+        return {
+            version: chosen,
+            dialect: dialectFor(chosen),
+            capabilities: asRecord(result?.capabilities),
+            legacy: false,
+            ...(serverInfoOf(result?.serverInfo) ? { serverInfo: serverInfoOf(result?.serverInfo) } : {}),
+        };
+    }
+    catch (error) {
+        // A version mismatch is a real answer, not a reason to try the old path.
+        if (error instanceof UnsupportedProtocolVersionError)
+            throw error;
+        if (!looksLikeMethodNotFound(error))
+            throw error;
+    }
+    // Legacy path: this server predates `server/discover`.
+    const init = (await rpc.request("initialize", {
+        protocolVersion: PREFERRED_VERSION,
+        capabilities,
+        clientInfo: { name: identity.name, version: identity.version },
+    }));
+    const version = acceptLegacyVersion(init?.protocolVersion);
+    if (!version) {
+        throw new UnsupportedProtocolVersionError(typeof init?.protocolVersion === "string" ? [init.protocolVersion] : []);
+    }
+    rpc.notify("notifications/initialized");
+    return {
+        version,
+        dialect: dialectFor(version),
+        capabilities: asRecord(init?.capabilities),
+        legacy: true,
+        ...(serverInfoOf(init?.serverInfo) ? { serverInfo: serverInfoOf(init?.serverInfo) } : {}),
+    };
+}
+/** Does a thrown transport error carry a JSON-RPC "method not found"? */
+function looksLikeMethodNotFound(error) {
+    const e = error;
+    const code = typeof e?.code === "number" ? e.code : NaN;
+    const message = typeof e?.message === "string" ? e.message : "";
+    return isMethodNotFound(code, message);
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function serverInfoOf(info) {
+    if (!info || typeof info.name !== "string" || !info.name.trim())
+        return undefined;
+    return { name: info.name, ...(typeof info.version === "string" ? { version: info.version } : {}) };
+}
+//# sourceMappingURL=discover.js.map

package/dist/mcp/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/mcp/discover.ts"],"names":[],"mappings":"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"}