nodebench-mcp 2.48.0 → 2.50.0

package/dist/benchmarks/testProviderBus.js

@@ -0,0 +1,272 @@
+/**
+ * testProviderBus.ts — Integration test for ProviderBus WebSocket event bus.
+ *
+ * Tests: auth, registration, event routing, disconnect cleanup.
+ * Run: npx tsx src/benchmarks/testProviderBus.ts
+ */
+import { createServer } from "node:http";
+import { WebSocket } from "ws";
+import { ProviderBus, } from "../../../../server/providerBus.js";
+import { generateApiKey, getMemoryStore, } from "../../../../server/mcpAuth.js";
+// ═══════════════════════════════════════════════════════════════════════════
+// Test helpers
+// ═══════════════════════════════════════════════════════════════════════════
+const results = [];
+function record(name, pass, detail) {
+    results.push({ name, pass, detail });
+    const icon = pass ? "PASS" : "FAIL";
+    console.log(`  [${icon}] ${name}${detail ? ` — ${detail}` : ""}`);
+}
+/** Wait for a WS message matching a predicate, with timeout. */
+function waitForMessage(ws, predicate, timeoutMs = 5000) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            ws.removeListener("message", handler);
+            reject(new Error(`Timed out waiting for message (${timeoutMs}ms)`));
+        }, timeoutMs);
+        function handler(data) {
+            try {
+                const parsed = JSON.parse(typeof data === "string" ? data : data.toString("utf-8"));
+                if (predicate(parsed)) {
+                    clearTimeout(timer);
+                    ws.removeListener("message", handler);
+                    resolve(parsed);
+                }
+            }
+            catch {
+                // ignore parse errors, keep waiting
+            }
+        }
+        ws.on("message", handler);
+    });
+}
+/** Connect a WS client to the bus with Bearer auth. Returns the ws + first message. */
+function connectClient(port, apiKey) {
+    return new Promise((resolve, reject) => {
+        const ws = new WebSocket(`ws://127.0.0.1:${port}/bus`, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+        });
+        let firstMessage = null;
+        let resolved = false;
+        ws.on("message", (data) => {
+            if (!firstMessage) {
+                try {
+                    firstMessage = JSON.parse(typeof data === "string" ? data : data.toString("utf-8"));
+                }
+                catch { /* ignore */ }
+                if (!resolved) {
+                    resolved = true;
+                    resolve({ ws, firstMessage });
+                }
+            }
+        });
+        ws.on("open", () => {
+            // Give a brief window for the welcome message to arrive
+            setTimeout(() => {
+                if (!resolved) {
+                    resolved = true;
+                    resolve({ ws, firstMessage });
+                }
+            }, 500);
+        });
+        ws.on("error", (err) => {
+            if (!resolved) {
+                resolved = true;
+                reject(err);
+            }
+        });
+    });
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Setup: HTTP server + ProviderBus + seed an API key
+// ═══════════════════════════════════════════════════════════════════════════
+async function run() {
+    console.log("\n=== ProviderBus Integration Tests ===\n");
+    // 1. Generate a valid API key and seed it into the in-memory store
+    const generated = generateApiKey();
+    const rawKey = generated.rawKey;
+    const store = getMemoryStore();
+    const keyRecord = {
+        keyHash: generated.keyHash,
+        keyHashPrefix: generated.keyHashPrefix,
+        userId: "test-user-1",
+        permissions: ["tools:read", "tools:execute"],
+        rateLimits: { perMinute: 100, perDay: 10_000 },
+        createdAt: Date.now(),
+        lastUsedAt: Date.now(),
+        revokedAt: null,
+    };
+    store.set(generated.keyHashPrefix, keyRecord);
+    // 2. Create HTTP server
+    const httpServer = createServer((_req, res) => {
+        res.writeHead(404);
+        res.end();
+    });
+    // 3. Create ProviderBus with short timeouts for testing
+    const busConfig = {
+        maxConnections: 10,
+        heartbeatIntervalMs: 60_000, // long — we don't need heartbeats during test
+        idleTimeoutMs: 60_000,
+        rateLimitPerMinute: 100,
+    };
+    const bus = new ProviderBus(busConfig);
+    bus.attachToServer(httpServer, "/bus");
+    // Wire upgrade handling
+    httpServer.on("upgrade", (req, socket, head) => {
+        const url = new URL(req.url ?? "/", `http://127.0.0.1`);
+        if (url.pathname === "/bus") {
+            bus.handleUpgrade(req, socket, head).catch((err) => {
+                console.error(`  [ERROR] handleUpgrade error:`, err);
+            });
+        }
+        else {
+            socket.destroy();
+        }
+    });
+    // 4. Start listening
+    const port = await new Promise((resolve) => {
+        httpServer.listen(0, "127.0.0.1", () => {
+            const addr = httpServer.address();
+            if (typeof addr === "object" && addr !== null) {
+                resolve(addr.port);
+            }
+        });
+    });
+    console.log(`  Server listening on 127.0.0.1:${port}`);
+    console.log("");
+    try {
+        // ── Test 1: Connect with valid API key ──────────────────────────────
+        let ws;
+        try {
+            const conn = await connectClient(port, rawKey);
+            ws = conn.ws;
+            const welcome = conn.firstMessage;
+            record("Connect with valid API key", welcome !== null && welcome.type === "heartbeat" && typeof welcome.providerId === "string", welcome ? `providerId=${welcome.providerId}` : "no welcome message received");
+        }
+        catch (err) {
+            record("Connect with valid API key", false, String(err));
+            // Can't continue without a connection
+            return;
+        }
+        // ── Test 2: Connect with invalid API key ─────────────────────────────
+        try {
+            const badConn = await connectClient(port, "nb_key_00000000000000000000000000000000");
+            // If we get here the connection opened — wait briefly for a close
+            await new Promise((resolve, reject) => {
+                badConn.ws.on("close", () => resolve());
+                badConn.ws.on("error", () => resolve());
+                setTimeout(() => {
+                    badConn.ws.close();
+                    reject(new Error("Bad key connection was not rejected"));
+                }, 2000);
+            });
+            record("Reject invalid API key", true);
+        }
+        catch (err) {
+            // Connection refused or error is also acceptable (socket destroyed before upgrade completes)
+            const msg = String(err);
+            if (msg.includes("not rejected")) {
+                record("Reject invalid API key", false, msg);
+            }
+            else {
+                record("Reject invalid API key", true, "Connection rejected/errored as expected");
+            }
+        }
+        // ── Test 3: Register as a provider ───────────────────────────────────
+        try {
+            ws.send(JSON.stringify({
+                type: "register",
+                registration: {
+                    providerName: "test-agent",
+                    providerType: "custom",
+                    capabilities: ["chat", "tool_execution"],
+                    version: "1.0.0",
+                },
+            }));
+            const registered = await waitForMessage(ws, (m) => m.type === "registered", 3000);
+            record("Register as provider", registered.type === "registered" && typeof registered.providerId === "string", `providerId=${registered.providerId}`);
+        }
+        catch (err) {
+            record("Register as provider", false, String(err));
+        }
+        // ── Test 4: Send an event ────────────────────────────────────────────
+        try {
+            const eventPromise = new Promise((resolve) => {
+                bus.once("event", (evt) => {
+                    resolve(evt.type === "chat.message" && evt.payload?.text === "hello");
+                });
+                setTimeout(() => resolve(false), 3000);
+            });
+            ws.send(JSON.stringify({
+                type: "event",
+                event: {
+                    type: "chat.message",
+                    payload: { text: "hello" },
+                },
+            }));
+            const eventReceived = await eventPromise;
+            record("Send event and bus emits it", eventReceived);
+            // Verify event log
+            const log = bus.getEventLog(10);
+            const found = log.some((e) => e.type === "chat.message");
+            record("Event logged in event log", found, `log size=${log.length}`);
+        }
+        catch (err) {
+            record("Send event and bus emits it", false, String(err));
+        }
+        // ── Test 5: Health snapshot ──────────────────────────────────────────
+        try {
+            const health = bus.getHealthSnapshot();
+            record("Health snapshot returns data", health.status === "healthy" && health.providers.connected >= 1, `connected=${health.providers.connected}, registered=${health.providers.registered}`);
+        }
+        catch (err) {
+            record("Health snapshot returns data", false, String(err));
+        }
+        // ── Test 6: Connected providers list ─────────────────────────────────
+        try {
+            const providers = bus.getConnectedProviders();
+            const testProvider = providers.find((p) => p.providerName === "test-agent");
+            record("Connected providers list includes test-agent", !!testProvider && testProvider.providerType === "custom", testProvider
+                ? `capabilities=${testProvider.capabilities.join(",")}`
+                : "not found");
+        }
+        catch (err) {
+            record("Connected providers list includes test-agent", false, String(err));
+        }
+        // ── Test 7: Disconnect and cleanup ──────────────────────────────────
+        try {
+            const disconnectPromise = new Promise((resolve) => {
+                bus.once("provider:disconnected", () => resolve(true));
+                setTimeout(() => resolve(false), 3000);
+            });
+            ws.close();
+            const disconnected = await disconnectPromise;
+            record("Disconnect fires provider:disconnected", disconnected);
+            // Verify cleanup
+            const afterProviders = bus.getConnectedProviders();
+            record("Provider removed from connected list after disconnect", afterProviders.length === 0, `remaining=${afterProviders.length}`);
+        }
+        catch (err) {
+            record("Disconnect and cleanup", false, String(err));
+        }
+    }
+    finally {
+        // Cleanup
+        bus.shutdown();
+        store.delete(generated.keyHashPrefix);
+        httpServer.close();
+        // Summary
+        console.log("\n=== Summary ===");
+        const passed = results.filter((r) => r.pass).length;
+        const total = results.length;
+        console.log(`  ${passed}/${total} tests passed\n`);
+        if (passed < total) {
+            process.exit(1);
+        }
+    }
+}
+run().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=testProviderBus.js.map

package/dist/benchmarks/testProviderBus.js.map

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

package/dist/benchmarks/testSupermemory.d.ts

@@ -0,0 +1,8 @@
+/**
+ * testSupermemory.ts — Unit test for SupermemoryProvider.
+ *
+ * Tests WITHOUT a real API key: verifies graceful error handling,
+ * interface compliance, and error class hierarchy.
+ * Run: npx tsx src/benchmarks/testSupermemory.ts
+ */
+export {};

package/dist/benchmarks/testSupermemory.js

@@ -0,0 +1,187 @@
+/**
+ * testSupermemory.ts — Unit test for SupermemoryProvider.
+ *
+ * Tests WITHOUT a real API key: verifies graceful error handling,
+ * interface compliance, and error class hierarchy.
+ * Run: npx tsx src/benchmarks/testSupermemory.ts
+ */
+import { SupermemoryProvider, SupermemoryError, SupermemoryAuthError, SupermemoryRateLimitError, } from "../providers/supermemoryProvider.js";
+// ═══════════════════════════════════════════════════════════════════════════
+// Test helpers
+// ═══════════════════════════════════════════════════════════════════════════
+const results = [];
+function record(name, pass, detail) {
+    results.push({ name, pass, detail });
+    const icon = pass ? "PASS" : "FAIL";
+    console.log(`  [${icon}] ${name}${detail ? ` — ${detail}` : ""}`);
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Tests
+// ═══════════════════════════════════════════════════════════════════════════
+async function run() {
+    console.log("\n=== SupermemoryProvider Tests ===\n");
+    // ── Test 1: Constructor creates a valid instance ───────────────────────
+    const provider = new SupermemoryProvider();
+    record("Constructor creates instance", provider instanceof SupermemoryProvider);
+    // ── Test 2: Implements MemoryProvider interface (all 12 methods + 2 props)
+    const requiredMethods = [
+        "connect",
+        "disconnect",
+        "isConnected",
+        "store",
+        "update",
+        "delete",
+        "recall",
+        "get",
+        "list",
+        "relate",
+        "getProfile",
+        "sync",
+    ];
+    const requiredProps = ["name", "type"];
+    let allMethodsPresent = true;
+    const missingMethods = [];
+    for (const method of requiredMethods) {
+        if (typeof provider[method] !== "function") {
+            allMethodsPresent = false;
+            missingMethods.push(method);
+        }
+    }
+    record(`Implements all ${requiredMethods.length} MemoryProvider methods`, allMethodsPresent, missingMethods.length > 0 ? `missing: ${missingMethods.join(", ")}` : undefined);
+    let allPropsPresent = true;
+    const missingProps = [];
+    for (const prop of requiredProps) {
+        if (provider[prop] === undefined) {
+            allPropsPresent = false;
+            missingProps.push(prop);
+        }
+    }
+    record(`Has required readonly properties (name, type)`, allPropsPresent, missingProps.length > 0 ? `missing: ${missingProps.join(", ")}` : undefined);
+    // ── Test 3: name and type values ─────────────────────────────────────
+    record("name is 'supermemory'", provider.name === "supermemory", `actual: "${provider.name}"`);
+    record("type is 'supermemory'", provider.type === "supermemory", `actual: "${provider.type}"`);
+    // ── Test 4: isConnected() before connect() ────────────────────────────
+    record("isConnected() is false before connect()", provider.isConnected() === false);
+    // ── Test 5: connect() with invalid key — should not throw ─────────────
+    // The provider marks itself as connected even if the API returns errors
+    // (except for explicit 401 from the validation request).
+    // With a fake key hitting a real endpoint, we may get a network error
+    // or a 401. The connect() method catches network errors and still marks connected.
+    try {
+        await provider.connect({ apiKey: "test-invalid-key" });
+        // If connect succeeds (network error caught internally), isConnected should be true
+        record("connect() with invalid key does not throw", true);
+        record("isConnected() returns true after connect()", provider.isConnected() === true);
+    }
+    catch (err) {
+        // connect() only rethrows SupermemoryAuthError (401).
+        // A real 401 from the API is expected behavior.
+        if (err instanceof SupermemoryAuthError) {
+            record("connect() with invalid key throws SupermemoryAuthError", true, "401 from API");
+            record("isConnected() returns false after auth failure", provider.isConnected() === false);
+        }
+        else {
+            record("connect() with invalid key does not throw", false, String(err));
+        }
+    }
+    // ── Test 6: store() with invalid key — should throw ───────────────────
+    // Re-connect to ensure connected state for store/recall tests
+    const provider2 = new SupermemoryProvider();
+    try {
+        await provider2.connect({ apiKey: "test-invalid-key-2" });
+    }
+    catch {
+        // If 401 from connect, we still test store behavior
+    }
+    if (provider2.isConnected()) {
+        // store() should fail with auth error from the API
+        try {
+            await provider2.store({ content: "test memory content" });
+            record("store() throws on invalid API key", false, "did not throw");
+        }
+        catch (err) {
+            if (err instanceof SupermemoryAuthError) {
+                record("store() throws SupermemoryAuthError on invalid key", true);
+                record("SupermemoryAuthError has statusCode 401", err.statusCode === 401, `actual: ${err.statusCode}`);
+                record("SupermemoryAuthError.name is correct", err.name === "SupermemoryAuthError");
+            }
+            else if (err instanceof SupermemoryError) {
+                // Network error or other API error — still a valid failure mode
+                record("store() throws SupermemoryError on invalid key", true, `${err.name}: ${err.message}`);
+            }
+            else {
+                record("store() throws on invalid API key", false, String(err));
+            }
+        }
+        // ── Test 7: recall() with invalid key — should throw ────────────────
+        try {
+            await provider2.recall("test query");
+            record("recall() throws on invalid API key", false, "did not throw");
+        }
+        catch (err) {
+            if (err instanceof SupermemoryAuthError) {
+                record("recall() throws SupermemoryAuthError on invalid key", true);
+            }
+            else if (err instanceof SupermemoryError) {
+                record("recall() throws SupermemoryError on invalid key", true, `${err.name}: ${err.message}`);
+            }
+            else {
+                record("recall() throws on invalid API key", false, String(err));
+            }
+        }
+    }
+    else {
+        record("store()/recall() tests skipped", true, "provider not connected (401 on connect)");
+    }
+    // ── Test 8: Error class hierarchy ─────────────────────────────────────
+    const authErr = new SupermemoryAuthError();
+    record("SupermemoryAuthError extends SupermemoryError", authErr instanceof SupermemoryError);
+    record("SupermemoryAuthError extends Error", authErr instanceof Error);
+    record("SupermemoryAuthError.statusCode is 401", authErr.statusCode === 401);
+    const rateLimitErr = new SupermemoryRateLimitError(5000);
+    record("SupermemoryRateLimitError extends SupermemoryError", rateLimitErr instanceof SupermemoryError);
+    record("SupermemoryRateLimitError.statusCode is 429", rateLimitErr.statusCode === 429);
+    record("SupermemoryRateLimitError.retryAfterMs is set", rateLimitErr.retryAfterMs === 5000);
+    // ── Test 9: sync() returns no-op result ───────────────────────────────
+    const provider3 = new SupermemoryProvider();
+    try {
+        await provider3.connect({ apiKey: "test-sync-key" });
+    }
+    catch {
+        // ignore auth error
+    }
+    if (provider3.isConnected()) {
+        try {
+            const syncResult = await provider3.sync("both");
+            record("sync() returns no-op SyncResult", syncResult.pushed === 0 &&
+                syncResult.pulled === 0 &&
+                syncResult.conflicts === 0 &&
+                syncResult.direction === "both", `direction=${syncResult.direction}, pushed=${syncResult.pushed}`);
+        }
+        catch (err) {
+            record("sync() returns no-op SyncResult", false, String(err));
+        }
+    }
+    // ── Test 10: disconnect() ─────────────────────────────────────────────
+    if (provider3.isConnected()) {
+        await provider3.disconnect();
+        record("disconnect() sets isConnected to false", provider3.isConnected() === false);
+    }
+    // ── Test 11: TypeScript structural compatibility ──────────────────────
+    // Verify the provider satisfies MemoryProvider at the type level
+    const _typeCheck = new SupermemoryProvider();
+    record("Structural type compatibility with MemoryProvider", true);
+    // Summary
+    console.log("\n=== Summary ===");
+    const passed = results.filter((r) => r.pass).length;
+    const total = results.length;
+    console.log(`  ${passed}/${total} tests passed\n`);
+    if (passed < total) {
+        process.exit(1);
+    }
+}
+run().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=testSupermemory.js.map

package/dist/benchmarks/testSupermemory.js.map

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

package/dist/tools/founderTrackingTools.d.ts

@@ -1,6 +1,6 @@
 /**
  * founderTrackingTools — Temporal action tracking across sessions, days, weeks,
- * months, quarters, and years.
+ * months, quarters, and years. Plus agent compatibility validation.
  *
  * Every significant action records before/after state and reasoning.
  * Aggregation queries run in SQL for efficiency.

package/dist/tools/founderTrackingTools.js

@@ -1,11 +1,12 @@
 /**
  * founderTrackingTools — Temporal action tracking across sessions, days, weeks,
- * months, quarters, and years.
+ * months, quarters, and years. Plus agent compatibility validation.
  *
  * Every significant action records before/after state and reasoning.
  * Aggregation queries run in SQL for efficiency.
  */
 import { getDb, genId } from "../db.js";
+import { validateAgentCompatibilityTool } from "../benchmarks/agentValidation.js";
 /* ------------------------------------------------------------------ */
 /*  Module-level session ID (unique per process)                       */
 /* ------------------------------------------------------------------ */
@@ -952,5 +953,6 @@ export const founderTrackingTools = [
             };
         },
     },
+    validateAgentCompatibilityTool,
 ];
 //# sourceMappingURL=founderTrackingTools.js.map