nodebench-mcp 2.33.0 → 2.34.0

package/dist/providers/memoryProviderRegistry.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MemoryProviderRegistry — Singleton registry for MemoryProvider instances.
+ *
+ * Auto-registers LocalMemoryProvider as the default provider on first access.
+ * External providers (Supermemory, Zep, Graphiti) can be registered at runtime.
+ *
+ * Usage:
+ *   const registry = MemoryProviderRegistry.getInstance();
+ *   const local = registry.getDefault();
+ *   await local.connect({ userId: "user-123" });
+ *   const id = await local.store({ content: "Meeting notes..." });
+ */
+import type { MemoryProvider } from "./memoryProvider.js";
+export declare class MemoryProviderRegistry {
+    private static instance;
+    private providers;
+    private defaultName;
+    private constructor();
+    static getInstance(): MemoryProviderRegistry;
+    /** Reset the singleton (for tests only) */
+    static resetInstance(): void;
+    /**
+     * Register a provider. Overwrites if a provider with the same name
+     * already exists. Returns the registry for chaining.
+     */
+    register(provider: MemoryProvider): MemoryProviderRegistry;
+    /**
+     * Unregister a provider by name. Cannot unregister the default provider
+     * unless another default is set first.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Set which registered provider is the default.
+     */
+    setDefault(name: string): void;
+    /**
+     * Get a provider by name. Returns undefined if not found.
+     */
+    get(name: string): MemoryProvider | undefined;
+    /**
+     * Get the default provider (LocalMemoryProvider unless changed).
+     */
+    getDefault(): MemoryProvider;
+    /**
+     * List all registered providers with their connection status.
+     */
+    listProviders(): Array<{
+        name: string;
+        type: string;
+        isDefault: boolean;
+        isConnected: boolean;
+    }>;
+    /**
+     * Get the count of registered providers.
+     */
+    get size(): number;
+    /**
+     * Check if a provider is registered.
+     */
+    has(name: string): boolean;
+}

package/dist/providers/memoryProviderRegistry.js

@@ -0,0 +1,107 @@
+/**
+ * MemoryProviderRegistry — Singleton registry for MemoryProvider instances.
+ *
+ * Auto-registers LocalMemoryProvider as the default provider on first access.
+ * External providers (Supermemory, Zep, Graphiti) can be registered at runtime.
+ *
+ * Usage:
+ *   const registry = MemoryProviderRegistry.getInstance();
+ *   const local = registry.getDefault();
+ *   await local.connect({ userId: "user-123" });
+ *   const id = await local.store({ content: "Meeting notes..." });
+ */
+import { LocalMemoryProvider } from "./localMemoryProvider.js";
+// ═══════════════════════════════════════════════════════════════════════════
+// Registry
+// ═══════════════════════════════════════════════════════════════════════════
+const DEFAULT_PROVIDER_NAME = "local-sqlite";
+export class MemoryProviderRegistry {
+    static instance = null;
+    providers = new Map();
+    defaultName = DEFAULT_PROVIDER_NAME;
+    constructor() {
+        // Auto-register LocalMemoryProvider as the default
+        const local = new LocalMemoryProvider();
+        this.providers.set(local.name, local);
+    }
+    // ── Singleton access ───────────────────────────────────────────────────
+    static getInstance() {
+        if (!MemoryProviderRegistry.instance) {
+            MemoryProviderRegistry.instance = new MemoryProviderRegistry();
+        }
+        return MemoryProviderRegistry.instance;
+    }
+    /** Reset the singleton (for tests only) */
+    static resetInstance() {
+        MemoryProviderRegistry.instance = null;
+    }
+    // ── Registration ───────────────────────────────────────────────────────
+    /**
+     * Register a provider. Overwrites if a provider with the same name
+     * already exists. Returns the registry for chaining.
+     */
+    register(provider) {
+        this.providers.set(provider.name, provider);
+        return this;
+    }
+    /**
+     * Unregister a provider by name. Cannot unregister the default provider
+     * unless another default is set first.
+     */
+    unregister(name) {
+        if (name === this.defaultName && this.providers.size > 1) {
+            throw new Error(`Cannot unregister default provider "${name}" — set a new default first`);
+        }
+        return this.providers.delete(name);
+    }
+    /**
+     * Set which registered provider is the default.
+     */
+    setDefault(name) {
+        if (!this.providers.has(name)) {
+            throw new Error(`Provider "${name}" is not registered`);
+        }
+        this.defaultName = name;
+    }
+    // ── Retrieval ──────────────────────────────────────────────────────────
+    /**
+     * Get a provider by name. Returns undefined if not found.
+     */
+    get(name) {
+        return this.providers.get(name);
+    }
+    /**
+     * Get the default provider (LocalMemoryProvider unless changed).
+     */
+    getDefault() {
+        const provider = this.providers.get(this.defaultName);
+        if (!provider) {
+            throw new Error(`Default provider "${this.defaultName}" not found — registry may be corrupted`);
+        }
+        return provider;
+    }
+    /**
+     * List all registered providers with their connection status.
+     */
+    listProviders() {
+        return [...this.providers.values()].map((p) => ({
+            name: p.name,
+            type: p.type,
+            isDefault: p.name === this.defaultName,
+            isConnected: p.isConnected(),
+        }));
+    }
+    /**
+     * Get the count of registered providers.
+     */
+    get size() {
+        return this.providers.size;
+    }
+    /**
+     * Check if a provider is registered.
+     */
+    has(name) {
+        return this.providers.has(name);
+    }
+}
+//# sourceMappingURL=memoryProviderRegistry.js.map

package/dist/providers/memoryProviderRegistry.js.map

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

package/dist/providers/supermemoryProvider.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SupermemoryProvider — Cloud-backed MemoryProvider using the Supermemory REST API.
+ *
+ * Authenticates via Bearer token, supports project scoping via x-sm-project header.
+ * All data lives in Supermemory's cloud — sync() is a no-op since it's cloud-native.
+ *
+ * API base: https://api.supermemory.com/v3
+ */
+import type { MemoryProvider, ProviderConfig, MemoryInput, Memory, MemoryRelation, RecallOptions, ListOptions, UserProfile, SyncResult } from "./memoryProvider.js";
+export declare class SupermemoryError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly responseBody?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, responseBody?: string | undefined);
+}
+export declare class SupermemoryAuthError extends SupermemoryError {
+    constructor(message?: string);
+}
+export declare class SupermemoryRateLimitError extends SupermemoryError {
+    readonly retryAfterMs?: number | undefined;
+    constructor(retryAfterMs?: number | undefined);
+}
+export declare class SupermemoryProvider implements MemoryProvider {
+    readonly name = "supermemory";
+    readonly type: "supermemory";
+    private config;
+    private connected;
+    private baseUrl;
+    private apiKey;
+    private projectId?;
+    connect(config: ProviderConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    private ensureConnected;
+    private request;
+    store(memory: MemoryInput): Promise<string>;
+    update(id: string, memory: MemoryInput): Promise<void>;
+    delete(id: string): Promise<void>;
+    recall(query: string, options?: RecallOptions): Promise<Memory[]>;
+    get(id: string): Promise<Memory | null>;
+    list(options?: ListOptions): Promise<Memory[]>;
+    relate(fromId: string, toId: string, relation: MemoryRelation): Promise<void>;
+    getProfile(userId?: string): Promise<UserProfile | null>;
+    /**
+     * Fallback: build a basic UserProfile by listing memories for the user.
+     * Used when the API doesn't have a dedicated profile endpoint.
+     */
+    private buildProfileFromList;
+    sync(direction: "push" | "pull" | "both"): Promise<SyncResult>;
+    /**
+     * Convert a Supermemory API memory response to the MemoryProvider Memory type.
+     * Supermemory stores scope/tags/source inside metadata — we extract them.
+     */
+    private apiMemoryToMemory;
+    /**
+     * Convert a Supermemory search result to a Memory with relevance score.
+     */
+    private searchResultToMemory;
+}

package/dist/providers/supermemoryProvider.js

@@ -0,0 +1,432 @@
+/**
+ * SupermemoryProvider — Cloud-backed MemoryProvider using the Supermemory REST API.
+ *
+ * Authenticates via Bearer token, supports project scoping via x-sm-project header.
+ * All data lives in Supermemory's cloud — sync() is a no-op since it's cloud-native.
+ *
+ * API base: https://api.supermemory.com/v3
+ */
+// ═══════════════════════════════════════════════════════════════════════════
+// Constants
+// ═══════════════════════════════════════════════════════════════════════════
+const DEFAULT_BASE_URL = "https://api.supermemory.com/v3";
+const REQUEST_TIMEOUT_MS = 30_000;
+// ═══════════════════════════════════════════════════════════════════════════
+// Error types
+// ═══════════════════════════════════════════════════════════════════════════
+export class SupermemoryError extends Error {
+    statusCode;
+    responseBody;
+    constructor(message, statusCode, responseBody) {
+        super(message);
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+        this.name = "SupermemoryError";
+    }
+}
+export class SupermemoryAuthError extends SupermemoryError {
+    constructor(message = "Supermemory authentication failed — check your API key") {
+        super(message, 401);
+        this.name = "SupermemoryAuthError";
+    }
+}
+export class SupermemoryRateLimitError extends SupermemoryError {
+    retryAfterMs;
+    constructor(retryAfterMs) {
+        super("Supermemory rate limit exceeded — retry later", 429);
+        this.retryAfterMs = retryAfterMs;
+        this.name = "SupermemoryRateLimitError";
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// SupermemoryProvider
+// ═══════════════════════════════════════════════════════════════════════════
+export class SupermemoryProvider {
+    name = "supermemory";
+    type = "supermemory";
+    config = {};
+    connected = false;
+    baseUrl = DEFAULT_BASE_URL;
+    apiKey = "";
+    projectId;
+    // ── Lifecycle ──────────────────────────────────────────────────────────
+    async connect(config) {
+        if (!config.apiKey) {
+            throw new SupermemoryError("SupermemoryProvider requires an apiKey in ProviderConfig");
+        }
+        this.config = config;
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
+        this.projectId = config.options?.projectId ?? undefined;
+        // Validate connectivity with a lightweight request
+        try {
+            // TODO: Verify health/ping endpoint — may be GET /health or GET /me
+            await this.request("GET", "/memories", { params: { limit: "1" } });
+            this.connected = true;
+        }
+        catch (err) {
+            if (err instanceof SupermemoryAuthError) {
+                throw err;
+            }
+            // Network errors during connect — mark as connected anyway since
+            // the config is valid; individual calls will surface errors.
+            this.connected = true;
+        }
+    }
+    async disconnect() {
+        this.connected = false;
+        this.apiKey = "";
+        this.projectId = undefined;
+    }
+    isConnected() {
+        return this.connected && this.apiKey.length > 0;
+    }
+    ensureConnected() {
+        if (!this.connected || !this.apiKey) {
+            throw new SupermemoryError("SupermemoryProvider is not connected — call connect() first");
+        }
+    }
+    // ── HTTP Layer ─────────────────────────────────────────────────────────
+    async request(method, path, options) {
+        let url = `${this.baseUrl}${path}`;
+        // Append query params
+        if (options?.params) {
+            const qs = new URLSearchParams(options.params).toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        if (this.projectId) {
+            headers["x-sm-project"] = this.projectId;
+        }
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: options?.body ? JSON.stringify(options.body) : undefined,
+                signal: controller.signal,
+            });
+            if (response.status === 401 || response.status === 403) {
+                throw new SupermemoryAuthError();
+            }
+            if (response.status === 429) {
+                const retryAfter = response.headers.get("Retry-After");
+                const retryMs = retryAfter ? parseInt(retryAfter, 10) * 1000 : undefined;
+                throw new SupermemoryRateLimitError(retryMs);
+            }
+            if (response.status === 404) {
+                return null;
+            }
+            if (!response.ok) {
+                const bodyText = await response.text().catch(() => "");
+                throw new SupermemoryError(`Supermemory API error: ${response.status} ${response.statusText}`, response.status, bodyText);
+            }
+            // 204 No Content — common for DELETE/PUT
+            if (response.status === 204) {
+                return undefined;
+            }
+            return (await response.json());
+        }
+        catch (err) {
+            if (err instanceof SupermemoryError)
+                throw err;
+            if (err instanceof DOMException && err.name === "AbortError") {
+                throw new SupermemoryError(`Supermemory request timed out after ${REQUEST_TIMEOUT_MS}ms: ${method} ${path}`);
+            }
+            throw new SupermemoryError(`Supermemory network error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    // ── CRUD ───────────────────────────────────────────────────────────────
+    async store(memory) {
+        this.ensureConnected();
+        const userId = memory.userId ?? this.config.userId ?? "default";
+        /** TODO: Verify exact POST /memories request body shape */
+        const body = {
+            content: memory.content,
+            metadata: {
+                ...(memory.metadata ?? {}),
+                scope: memory.scope ?? "general",
+                tags: memory.tags ?? [],
+                source: memory.source ?? "",
+                userId,
+                ...(memory.timestamp ? { timestamp: memory.timestamp } : {}),
+            },
+        };
+        const result = await this.request("POST", "/memories", { body });
+        return result.id;
+    }
+    async update(id, memory) {
+        this.ensureConnected();
+        /** TODO: Verify PUT /memories/:id request body shape */
+        const body = {
+            content: memory.content,
+            metadata: {
+                ...(memory.metadata ?? {}),
+                scope: memory.scope ?? "general",
+                tags: memory.tags ?? [],
+                source: memory.source ?? "",
+            },
+        };
+        const result = await this.request("PUT", `/memories/${encodeURIComponent(id)}`, { body });
+        if (result === null) {
+            throw new SupermemoryError(`Memory not found: ${id}`, 404);
+        }
+    }
+    async delete(id) {
+        this.ensureConnected();
+        await this.request("DELETE", `/memories/${encodeURIComponent(id)}`);
+    }
+    // ── Retrieval ──────────────────────────────────────────────────────────
+    async recall(query, options) {
+        this.ensureConnected();
+        if (!query.trim())
+            return [];
+        const userId = options?.userId ?? this.config.userId;
+        /** TODO: Verify POST /search request body — may use "q" or "query" field */
+        const body = {
+            query,
+            limit: options?.limit ?? 10,
+        };
+        // Build filters object
+        const filters = {};
+        if (options?.scope)
+            filters.scope = options.scope;
+        if (options?.source)
+            filters.source = options.source;
+        if (userId)
+            filters.userId = userId;
+        if (options?.tags?.length)
+            filters.tags = options.tags;
+        if (options?.after)
+            filters.after = options.after;
+        if (options?.before)
+            filters.before = options.before;
+        if (options?.minScore !== undefined)
+            filters.minScore = options.minScore;
+        if (Object.keys(filters).length > 0) {
+            body.filters = filters;
+        }
+        const response = await this.request("POST", "/search", { body });
+        if (!response?.results)
+            return [];
+        return response.results.map((r) => this.searchResultToMemory(r));
+    }
+    async get(id) {
+        this.ensureConnected();
+        const result = await this.request("GET", `/memories/${encodeURIComponent(id)}`);
+        if (!result)
+            return null;
+        return this.apiMemoryToMemory(result);
+    }
+    async list(options) {
+        this.ensureConnected();
+        const params = {};
+        params.limit = String(options?.limit ?? 50);
+        if (options?.offset)
+            params.offset = String(options.offset);
+        if (options?.orderBy)
+            params.orderBy = options.orderBy;
+        if (options?.orderDirection)
+            params.orderDirection = options.orderDirection;
+        // Filters as query params
+        const userId = options?.userId ?? this.config.userId;
+        if (options?.scope)
+            params.scope = options.scope;
+        if (options?.source)
+            params.source = options.source;
+        if (userId)
+            params.userId = userId;
+        if (options?.tags?.length)
+            params.tags = options.tags.join(",");
+        /** TODO: Verify GET /memories query param names — may differ from this mapping */
+        const response = await this.request("GET", "/memories", { params });
+        if (!response?.memories)
+            return [];
+        let results = response.memories.map((m) => this.apiMemoryToMemory(m));
+        // Post-filter by tags if the API doesn't support tag filtering natively
+        if (options?.tags?.length) {
+            const tagSet = new Set(options.tags);
+            results = results.filter((m) => m.tags.some((t) => tagSet.has(t)));
+        }
+        return results;
+    }
+    // ── Relations ──────────────────────────────────────────────────────────
+    async relate(fromId, toId, relation) {
+        this.ensureConnected();
+        /**
+         * TODO: Verify if Supermemory has a native relations API.
+         * If POST /memories/:id/relations exists, use it directly.
+         * Fallback: store the relation as metadata on the source memory.
+         */
+        try {
+            await this.request("POST", `/memories/${encodeURIComponent(fromId)}/relations`, {
+                body: {
+                    targetId: toId,
+                    type: relation.type,
+                    label: relation.label,
+                    confidence: relation.confidence ?? 1.0,
+                    metadata: relation.metadata ?? {},
+                },
+            });
+        }
+        catch (err) {
+            // If the relations endpoint doesn't exist (404 or 405), fall back to
+            // storing the relation as metadata on the source memory.
+            if (err instanceof SupermemoryError &&
+                (err.statusCode === 404 || err.statusCode === 405)) {
+                const sourceMemory = await this.get(fromId);
+                if (!sourceMemory) {
+                    throw new SupermemoryError(`Source memory not found: ${fromId}`, 404);
+                }
+                const existingRelations = sourceMemory.metadata._relations ?? [];
+                existingRelations.push({
+                    targetId: toId,
+                    type: relation.type,
+                    label: relation.label,
+                    confidence: relation.confidence ?? 1.0,
+                    metadata: relation.metadata ?? {},
+                    createdAt: new Date().toISOString(),
+                });
+                await this.update(fromId, {
+                    content: sourceMemory.content,
+                    metadata: {
+                        ...sourceMemory.metadata,
+                        _relations: existingRelations,
+                    },
+                    scope: sourceMemory.scope,
+                    tags: sourceMemory.tags,
+                    source: sourceMemory.source,
+                });
+                return;
+            }
+            throw err;
+        }
+    }
+    // ── Profile ────────────────────────────────────────────────────────────
+    async getProfile(userId) {
+        this.ensureConnected();
+        const uid = userId ?? this.config.userId ?? "default";
+        /** TODO: Verify profile endpoint — may be GET /profile, GET /users/me, or GET /users/:id/profile */
+        try {
+            const response = await this.request("GET", "/profile", { params: { userId: uid } });
+            if (!response)
+                return null;
+            return {
+                userId: response.userId ?? uid,
+                memoryCount: response.memoryCount ?? 0,
+                scopes: response.scopes ?? [],
+                topTags: response.topTags ?? [],
+                topSources: response.topSources ?? [],
+                firstMemoryAt: response.firstMemoryAt ?? null,
+                lastMemoryAt: response.lastMemoryAt ?? null,
+            };
+        }
+        catch (err) {
+            // If profile endpoint doesn't exist, build a basic profile from list
+            if (err instanceof SupermemoryError &&
+                (err.statusCode === 404 || err.statusCode === 405)) {
+                return this.buildProfileFromList(uid);
+            }
+            throw err;
+        }
+    }
+    /**
+     * Fallback: build a basic UserProfile by listing memories for the user.
+     * Used when the API doesn't have a dedicated profile endpoint.
+     */
+    async buildProfileFromList(userId) {
+        const memories = await this.list({ userId, limit: 50, orderBy: "createdAt", orderDirection: "asc" });
+        if (memories.length === 0)
+            return null;
+        const scopeSet = new Set();
+        const tagCounts = new Map();
+        const sourceCounts = new Map();
+        for (const m of memories) {
+            scopeSet.add(m.scope);
+            for (const tag of m.tags) {
+                tagCounts.set(tag, (tagCounts.get(tag) ?? 0) + 1);
+            }
+            if (m.source) {
+                sourceCounts.set(m.source, (sourceCounts.get(m.source) ?? 0) + 1);
+            }
+        }
+        return {
+            userId,
+            memoryCount: memories.length,
+            scopes: [...scopeSet],
+            topTags: [...tagCounts.entries()]
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 10)
+                .map(([tag, count]) => ({ tag, count })),
+            topSources: [...sourceCounts.entries()]
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 10)
+                .map(([source, count]) => ({ source, count })),
+            firstMemoryAt: memories[0]?.createdAt ?? null,
+            lastMemoryAt: memories[memories.length - 1]?.createdAt ?? null,
+        };
+    }
+    // ── Sync ───────────────────────────────────────────────────────────────
+    async sync(direction) {
+        // Supermemory is cloud-native — all operations hit the API directly.
+        // No local cache to sync. Return a no-op result.
+        return {
+            direction,
+            pushed: 0,
+            pulled: 0,
+            conflicts: 0,
+            errors: 0,
+            completedAt: new Date().toISOString(),
+        };
+    }
+    // ── Mapping helpers ────────────────────────────────────────────────────
+    /**
+     * Convert a Supermemory API memory response to the MemoryProvider Memory type.
+     * Supermemory stores scope/tags/source inside metadata — we extract them.
+     */
+    apiMemoryToMemory(m) {
+        const metadata = m.metadata ?? {};
+        const scope = metadata.scope ?? "general";
+        const tags = metadata.tags ?? [];
+        const source = metadata.source ?? "";
+        const userId = metadata.userId ?? this.config.userId ?? "default";
+        // Remove our injected fields from metadata to keep it clean
+        const cleanMeta = { ...metadata };
+        delete cleanMeta.scope;
+        delete cleanMeta.tags;
+        delete cleanMeta.source;
+        delete cleanMeta.userId;
+        delete cleanMeta.timestamp;
+        return {
+            id: m.id,
+            content: m.content,
+            metadata: cleanMeta,
+            scope,
+            tags: Array.isArray(tags) ? tags : [],
+            source,
+            userId,
+            createdAt: m.createdAt ?? new Date().toISOString(),
+            updatedAt: m.updatedAt ?? m.createdAt ?? new Date().toISOString(),
+        };
+    }
+    /**
+     * Convert a Supermemory search result to a Memory with relevance score.
+     */
+    searchResultToMemory(r) {
+        const base = this.apiMemoryToMemory(r);
+        return {
+            ...base,
+            relevanceScore: r.score ?? undefined,
+        };
+    }
+}
+//# sourceMappingURL=supermemoryProvider.js.map