memorandum-mcp 0.1.0

package/dist/store.js

@@ -0,0 +1,389 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { writeFile, rename, mkdir, access } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { LRUCache } from 'lru-cache';
+import safeRegex from 'safe-regex2';
+/**
+ * LRU-backed in-memory fact store with namespacing, TTL support,
+ * optional semantic indexing, and JSON file persistence.
+ */
+export class MemoryStore {
+    cache;
+    config;
+    storagePath;
+    logger;
+    semanticIndex = null;
+    dirty = false;
+    lastSavedAt = null;
+    constructor(config, paths, logger) {
+        this.config = config;
+        this.storagePath = paths.factsPath;
+        this.logger = logger;
+        this.cache = new LRUCache({
+            max: config.max_entries,
+            noDisposeOnSet: true,
+            dispose: (_value, key) => {
+                const parsed = MemoryStore.parseKey(key);
+                this.logger.warn({ key: parsed.key, namespace: parsed.namespace }, 'Fact evicted from memory (LRU)');
+                if (this.semanticIndex) {
+                    this.semanticIndex.removeFact(parsed.key, parsed.namespace);
+                }
+            },
+        });
+    }
+    /** Attaches a semantic index for embedding-based fact retrieval. */
+    setSemanticIndex(index) {
+        this.semanticIndex = index;
+    }
+    /**
+     * Creates a composite cache key by joining namespace and key with a null byte.
+     * @param namespace - The namespace portion of the key.
+     * @param key - The fact key within the namespace.
+     * @returns The composite key string.
+     */
+    static makeKey(namespace, key) {
+        return `${namespace}\0${key}`;
+    }
+    /**
+     * Splits a composite cache key back into its namespace and key parts.
+     * Falls back to the "default" namespace when no separator is found.
+     * @param compositeKey - The composite key to parse.
+     * @returns An object containing the namespace and key.
+     */
+    static parseKey(compositeKey) {
+        const idx = compositeKey.indexOf('\0');
+        if (idx === -1)
+            return { namespace: 'default', key: compositeKey };
+        return { namespace: compositeKey.slice(0, idx), key: compositeKey.slice(idx + 1) };
+    }
+    getRemainingTtlSeconds(compositeKey) {
+        const ttlMs = this.cache.getRemainingTTL(compositeKey);
+        const hasTtl = ttlMs > 0 && ttlMs !== Infinity;
+        return hasTtl ? Math.ceil(ttlMs / 1000) : null;
+    }
+    /**
+     * Writes or updates a fact in the store.
+     * @param key - Fact identifier.
+     * @param value - The fact payload.
+     * @param namespace - Namespace to store the fact under.
+     * @param ttlSeconds - Optional time-to-live in seconds.
+     * @returns An object indicating whether a new fact was created.
+     */
+    write(key, value, namespace, ttlSeconds) {
+        const compositeKey = MemoryStore.makeKey(namespace, key);
+        const existing = this.cache.get(compositeKey);
+        const now = Date.now();
+        const entry = {
+            value,
+            namespace,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+        };
+        const options = ttlSeconds != null ? { ttl: ttlSeconds * 1000 } : undefined;
+        this.cache.set(compositeKey, entry, options);
+        this.dirty = true;
+        const created = existing == null;
+        this.logger.debug({ key, namespace, created }, created ? 'Fact created' : 'Fact updated');
+        if (this.semanticIndex) {
+            this.semanticIndex.enqueueFact(key, namespace, value);
+        }
+        return { created };
+    }
+    /**
+     * Reads a single fact by key and namespace.
+     * @param key - Fact identifier.
+     * @param namespace - Namespace the fact belongs to.
+     * @returns The fact metadata including TTL info, or null if not found.
+     */
+    read(key, namespace) {
+        const compositeKey = MemoryStore.makeKey(namespace, key);
+        const entry = this.cache.get(compositeKey);
+        if (entry == null)
+            return null;
+        const ttlSeconds = this.getRemainingTtlSeconds(compositeKey);
+        return {
+            key, namespace,
+            value: entry.value,
+            createdAt: entry.createdAt,
+            updatedAt: entry.updatedAt,
+            ttl: ttlSeconds,
+            remainingTtl: ttlSeconds,
+        };
+    }
+    /**
+     * Lists facts with optional namespace filtering, glob pattern matching, and pagination.
+     * Can optionally include values and store-level statistics.
+     */
+    list(options) {
+        const results = [];
+        let patternRegex = null;
+        if (options.pattern) {
+            const escaped = options.pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+            const regexStr = escaped.replace(/\*/g, '.*').replace(/\?/g, '.');
+            if (!safeRegex(`^${regexStr}$`)) {
+                throw new Error(`Unsafe pattern (potential ReDoS): ${options.pattern}`);
+            }
+            patternRegex = new RegExp(`^${regexStr}$`);
+        }
+        for (const [compositeKey, entry] of this.cache.entries()) {
+            if (results.length >= options.limit)
+                break;
+            const parsed = MemoryStore.parseKey(compositeKey);
+            if (options.namespace && parsed.namespace !== options.namespace)
+                continue;
+            if (patternRegex && !patternRegex.test(parsed.key))
+                continue;
+            const ttlSeconds = this.getRemainingTtlSeconds(compositeKey);
+            const fact = {
+                key: parsed.key, namespace: parsed.namespace,
+                createdAt: entry.createdAt, updatedAt: entry.updatedAt,
+                ttl: ttlSeconds, remainingTtl: ttlSeconds,
+            };
+            if (options.includeValues)
+                fact.value = entry.value;
+            results.push(fact);
+        }
+        const response = { facts: results };
+        if (options.includeStats) {
+            response.stats = {
+                totalFacts: this.cache.size,
+                maxEntries: this.config.max_entries,
+                namespaceCount: this.getNamespaces().length,
+                lastSavedAt: this.lastSavedAt,
+            };
+        }
+        return response;
+    }
+    /** Returns all namespaces with their respective fact counts. */
+    getNamespaces() {
+        const counts = new Map();
+        for (const compositeKey of this.cache.keys()) {
+            const { namespace } = MemoryStore.parseKey(compositeKey);
+            counts.set(namespace, (counts.get(namespace) ?? 0) + 1);
+        }
+        return Array.from(counts.entries()).map(([namespace, count]) => ({ namespace, count }));
+    }
+    /**
+     * Searches facts by regex pattern, matching against both keys and values.
+     * Validates the regex for safety against ReDoS before executing.
+     */
+    search(options) {
+        if (!safeRegex(options.query)) {
+            throw new Error(`Unsafe regexp (potential ReDoS): ${options.query}`);
+        }
+        let regex;
+        try {
+            regex = new RegExp(options.query, 'i');
+        }
+        catch {
+            throw new Error(`Invalid regexp: ${options.query}`);
+        }
+        const results = [];
+        let totalMatches = 0;
+        for (const [compositeKey, entry] of this.cache.entries()) {
+            const parsed = MemoryStore.parseKey(compositeKey);
+            if (options.namespace && parsed.namespace !== options.namespace)
+                continue;
+            const keyMatch = regex.test(parsed.key);
+            const valueStr = JSON.stringify(entry.value);
+            const valueMatch = regex.test(valueStr);
+            if (!keyMatch && !valueMatch)
+                continue;
+            totalMatches++;
+            if (results.length < options.limit) {
+                const ttlSeconds = this.getRemainingTtlSeconds(compositeKey);
+                results.push({
+                    key: parsed.key, namespace: parsed.namespace,
+                    value: entry.value,
+                    createdAt: entry.createdAt, updatedAt: entry.updatedAt,
+                    ttl: ttlSeconds, remainingTtl: ttlSeconds,
+                    match_in: keyMatch && valueMatch ? 'both' : keyMatch ? 'key' : 'value',
+                });
+            }
+        }
+        return { results, total_matches: totalMatches, limit: options.limit };
+    }
+    get size() { return this.cache.size; }
+    get maxEntries() { return this.config.max_entries; }
+    /**
+     * Deletes a single fact by key and namespace.
+     * @param key - Fact identifier.
+     * @param namespace - Namespace the fact belongs to.
+     * @returns True if the fact existed and was deleted.
+     */
+    delete(key, namespace) {
+        const compositeKey = MemoryStore.makeKey(namespace, key);
+        const existed = this.cache.has(compositeKey);
+        if (existed) {
+            this.cache.delete(compositeKey);
+            this.dirty = true;
+        }
+        return existed;
+    }
+    /**
+     * Deletes all facts within the given namespace.
+     * @param namespace - The namespace to clear.
+     * @returns The number of facts deleted.
+     */
+    deleteNamespace(namespace) {
+        const keysToDelete = [];
+        for (const compositeKey of this.cache.keys()) {
+            if (MemoryStore.parseKey(compositeKey).namespace === namespace) {
+                keysToDelete.push(compositeKey);
+            }
+        }
+        for (const key of keysToDelete)
+            this.cache.delete(key);
+        if (keysToDelete.length > 0)
+            this.dirty = true;
+        return keysToDelete.length;
+    }
+    /**
+     * Persists the cache to disk using atomic write (temp file + rename).
+     * Skips saving when no changes have been made or when the cache is empty
+     * but the file on disk still contains data (safety guard).
+     * @returns True if the save was performed successfully.
+     */
+    async save() {
+        if (!this.dirty)
+            return false;
+        const filePath = this.storagePath;
+        if (this.cache.size === 0 && existsSync(filePath)) {
+            try {
+                const diskRaw = readFileSync(filePath, 'utf-8');
+                const diskData = JSON.parse(diskRaw);
+                if (Array.isArray(diskData) && diskData.length > 0) {
+                    this.logger.warn({ diskEntries: diskData.length }, 'Skipping save: disk has data but cache is empty');
+                    return false;
+                }
+            }
+            catch { /* proceed */ }
+        }
+        try {
+            const dir = dirname(filePath);
+            try {
+                await access(dir);
+            }
+            catch {
+                await mkdir(dir, { recursive: true });
+            }
+            const data = JSON.stringify(this.cache.dump());
+            const tmpPath = `${filePath}.${process.pid}-${Date.now()}.tmp`;
+            await writeFile(tmpPath, data, 'utf-8');
+            await rename(tmpPath, filePath);
+            this.dirty = false;
+            this.lastSavedAt = Date.now();
+            this.logger.debug({ path: filePath, facts: this.cache.size }, 'Memory saved to disk');
+            return true;
+        }
+        catch (err) {
+            this.logger.error({ path: filePath, error: err instanceof Error ? err.message : String(err) }, 'Failed to save memory');
+            return false;
+        }
+    }
+    /** Loads facts from the on-disk JSON file into the cache. Starts empty if the file is missing or corrupt. */
+    async load() {
+        const filePath = this.storagePath;
+        try {
+            if (!existsSync(filePath)) {
+                this.logger.info({ path: filePath }, 'No memory file found, starting empty');
+                return;
+            }
+            const raw = readFileSync(filePath, 'utf-8');
+            const data = JSON.parse(raw);
+            this.cache.load(data);
+            this.dirty = false;
+            this.logger.debug({ path: filePath, facts: this.cache.size }, 'Memory loaded from disk');
+        }
+        catch (err) {
+            this.logger.warn({ path: filePath, error: err instanceof Error ? err.message : String(err) }, 'Failed to load memory, starting empty');
+        }
+    }
+    autosaveTimer = null;
+    /**
+     * Starts a recurring autosave timer that persists dirty state to disk.
+     * @param intervalMs - Interval between saves in milliseconds. Values <= 0 are ignored.
+     */
+    startAutosave(intervalMs) {
+        this.stopAutosave();
+        if (intervalMs <= 0)
+            return;
+        this.autosaveTimer = setInterval(() => {
+            this.save().catch((err) => {
+                this.logger.warn({ error: err instanceof Error ? err.message : String(err) }, 'Autosave failed');
+            });
+        }, intervalMs);
+        this.autosaveTimer.unref();
+    }
+    /** Stops the autosave timer if one is running. */
+    stopAutosave() {
+        if (this.autosaveTimer) {
+            clearInterval(this.autosaveTimer);
+            this.autosaveTimer = null;
+        }
+    }
+    /**
+     * Exports all facts as a versioned JSON-serializable object.
+     * Includes TTL remaining at the time of export.
+     * @returns An export payload with version, timestamp, count, and fact data.
+     */
+    export() {
+        const data = [];
+        for (const [compositeKey, entry] of this.cache.entries()) {
+            const parsed = MemoryStore.parseKey(compositeKey);
+            data.push({
+                key: parsed.key, namespace: parsed.namespace,
+                value: entry.value,
+                createdAt: entry.createdAt, updatedAt: entry.updatedAt,
+                ttl_seconds: this.getRemainingTtlSeconds(compositeKey),
+            });
+        }
+        return { version: 1, exported_at: Date.now(), facts_count: data.length, data };
+    }
+    /**
+     * Imports facts from a JSON string previously produced by {@link export}.
+     * @param dataStr - JSON string containing the export payload.
+     * @param merge - When true, merges into existing data; when false, replaces all facts.
+     * @returns Summary with imported and overwritten counts.
+     */
+    import(dataStr, merge) {
+        let parsed;
+        try {
+            parsed = JSON.parse(dataStr);
+        }
+        catch {
+            throw new Error('Invalid import data: not valid JSON');
+        }
+        if (parsed.version !== 1)
+            throw new Error(`Unsupported import format version: ${String(parsed.version)}`);
+        if (!Array.isArray(parsed.data))
+            throw new Error('Invalid import data: missing data array');
+        if (!merge)
+            this.cache.clear();
+        this.dirty = true;
+        let importedCount = 0;
+        let overwrittenCount = 0;
+        for (const item of parsed.data) {
+            const key = item.key;
+            const namespace = item.namespace;
+            if (!key || !namespace)
+                continue;
+            const compositeKey = MemoryStore.makeKey(namespace, key);
+            if (this.cache.has(compositeKey))
+                overwrittenCount++;
+            const now = Date.now();
+            const entry = {
+                value: item.value,
+                namespace,
+                createdAt: item.createdAt ?? now,
+                updatedAt: item.updatedAt ?? item.createdAt ?? now,
+            };
+            const ttlSeconds = item.ttl_seconds;
+            const options = ttlSeconds != null && ttlSeconds > 0 ? { ttl: ttlSeconds * 1000 } : undefined;
+            this.cache.set(compositeKey, entry, options);
+            importedCount++;
+        }
+        return { success: true, imported_count: importedCount, overwritten_count: overwrittenCount };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Logger } from 'pino';
+import { MemoryStore } from './store.js';
+export type SyncFn = () => Promise<{
+    flushed_embeddings: number;
+    saved_stores: string[];
+}>;
+/**
+ * Registers memory_write, memory_read, and memory_manage tools on the MCP server.
+ * @param server - The MCP server instance to register tools on.
+ * @param store - The memory store used for reading, writing, and managing facts.
+ * @param _logger - Logger instance (reserved for future use).
+ * @param syncFn - Optional custom sync function; falls back to `store.save()` if not provided.
+ */
+export declare function registerMemoryTools(server: McpServer, store: MemoryStore, _logger: Logger, syncFn?: SyncFn): void;

package/dist/tools.js

@@ -0,0 +1,104 @@
+import { toMcpErrorResponse } from './errors.js';
+import { MemoryWriteDisplaySchema, MemoryWriteInputSchema, MemoryReadDisplaySchema, MemoryReadInputSchema, MemoryManageDisplaySchema, MemoryManageInputSchema, } from './types.js';
+/**
+ * Registers memory_write, memory_read, and memory_manage tools on the MCP server.
+ * @param server - The MCP server instance to register tools on.
+ * @param store - The memory store used for reading, writing, and managing facts.
+ * @param _logger - Logger instance (reserved for future use).
+ * @param syncFn - Optional custom sync function; falls back to `store.save()` if not provided.
+ */
+export function registerMemoryTools(server, store, _logger, syncFn) {
+    server.registerTool('memory_write', {
+        title: 'Write Memory',
+        description: 'Write a fact to memory. The key and namespace should be meaningful.',
+        inputSchema: MemoryWriteDisplaySchema,
+    }, async (rawInput) => {
+        try {
+            const input = MemoryWriteInputSchema.parse(rawInput);
+            const result = store.write(input.key, input.value, input.namespace, input.ttl_seconds);
+            const output = { success: true, key: input.key, namespace: input.namespace, created: result.created };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output) }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return toMcpErrorResponse(error);
+        }
+    });
+    server.registerTool('memory_read', {
+        title: 'Read Memory',
+        description: 'Read a fact by key and namespace. Returns content with metadata or null if not found.',
+        inputSchema: MemoryReadDisplaySchema,
+    }, async (rawInput) => {
+        try {
+            const input = MemoryReadInputSchema.parse(rawInput);
+            const result = store.read(input.key, input.namespace);
+            const output = result ? { ...result } : { found: false };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output) }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return toMcpErrorResponse(error);
+        }
+    });
+    server.registerTool('memory_manage', {
+        title: 'Manage Memory',
+        description: 'Manage memory: delete, list, search, namespaces, export, import, sync.',
+        inputSchema: MemoryManageDisplaySchema,
+    }, async (rawInput) => {
+        try {
+            const input = MemoryManageInputSchema.parse(rawInput);
+            let output = {};
+            switch (input.action) {
+                case 'list':
+                    output = store.list({
+                        namespace: input.namespace, pattern: input.pattern,
+                        limit: input.limit, includeValues: input.include_values, includeStats: input.include_stats,
+                    });
+                    break;
+                case 'namespaces':
+                    output = { namespaces: store.getNamespaces() };
+                    break;
+                case 'search':
+                    output = store.search({ query: input.query, namespace: input.namespace, limit: input.limit });
+                    break;
+                case 'delete': {
+                    const deleted = store.delete(input.key, input.namespace);
+                    output = { success: true, deleted };
+                    break;
+                }
+                case 'delete_namespace': {
+                    const deletedCount = store.deleteNamespace(input.namespace);
+                    output = { success: true, deleted_count: deletedCount };
+                    break;
+                }
+                case 'export':
+                    output = store.export();
+                    break;
+                case 'import':
+                    output = store.import(input.data, input.merge);
+                    break;
+                case 'sync':
+                    if (syncFn) {
+                        output = await syncFn();
+                    }
+                    else {
+                        const written = await store.save();
+                        output = { flushed_embeddings: 0, saved_stores: written ? ['facts'] : [] };
+                    }
+                    break;
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output) }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            return toMcpErrorResponse(error);
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+export declare const KEY_MAX_LEN = 256;
+export declare const NAMESPACE_MAX_LEN = 64;
+export declare const NAMESPACE_REGEX: RegExp;
+export declare const DEFAULT_NAMESPACE = "default";
+export declare const DEFAULT_LIST_LIMIT = 50;
+export declare const DEFAULT_SEARCH_LIMIT = 20;
+export interface FactEntry {
+    value: unknown;
+    namespace: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface FactMetadata {
+    key: string;
+    namespace: string;
+    value: unknown;
+    createdAt: number;
+    updatedAt: number;
+    ttl: number | null;
+    remainingTtl: number | null;
+}
+export interface NamespaceInfo {
+    namespace: string;
+    count: number;
+}
+export interface MemoryStats {
+    totalFacts: number;
+    maxEntries: number;
+    namespaceCount: number;
+    lastSavedAt: number | null;
+}
+export declare const MemoryWriteDisplaySchema: z.ZodObject<{
+    key: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodUnknown>;
+    namespace: z.ZodOptional<z.ZodString>;
+    ttl_seconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const MemoryReadDisplaySchema: z.ZodObject<{
+    key: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const MemoryManageDisplaySchema: z.ZodObject<{
+    action: z.ZodOptional<z.ZodString>;
+    key: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    pattern: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    include_values: z.ZodOptional<z.ZodBoolean>;
+    include_stats: z.ZodOptional<z.ZodBoolean>;
+    query: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodString>;
+    merge: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const MemoryWriteInputSchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodUnknown;
+    namespace: z.ZodDefault<z.ZodString>;
+    ttl_seconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const MemoryReadInputSchema: z.ZodObject<{
+    key: z.ZodString;
+    namespace: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+export declare const MemoryManageInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"delete">;
+    key: z.ZodString;
+    namespace: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"delete_namespace">;
+    namespace: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"list">;
+    namespace: z.ZodOptional<z.ZodString>;
+    pattern: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    include_values: z.ZodDefault<z.ZodBoolean>;
+    include_stats: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"search">;
+    query: z.ZodString;
+    namespace: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"namespaces">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"export">;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"import">;
+    data: z.ZodString;
+    merge: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    action: z.ZodLiteral<"sync">;
+}, z.core.$strict>], "action">;
+export type MemoryWriteInput = z.infer<typeof MemoryWriteInputSchema>;
+export type MemoryReadInput = z.infer<typeof MemoryReadInputSchema>;
+export type MemoryManageInput = z.infer<typeof MemoryManageInputSchema>;