memory-journal-mcp 4.4.2 → 5.0.0

package/dist/server/Scheduler.js

@@ -0,0 +1,201 @@
+/**
+ * Memory Journal MCP Server - Scheduler
+ *
+ * Lightweight in-process scheduler for periodic maintenance jobs.
+ * Only meaningful for HTTP/SSE transport (long-lived server processes).
+ * Uses setInterval for simplicity — no external dependencies.
+ */
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Scheduler
+// ============================================================================
+/**
+ * Scheduler — runs periodic maintenance jobs for long-lived server processes.
+ *
+ * Jobs:
+ * - **backup**: Exports database to timestamped file, then prunes old backups.
+ * - **vacuum**: Runs `PRAGMA optimize` and flushes database to disk.
+ * - **rebuild-index**: Rebuilds vector search index from all entries.
+ */
+export class Scheduler {
+    options;
+    db;
+    vectorManager;
+    timers = [];
+    started = false;
+    constructor(options, db, vectorManager) {
+        this.options = options;
+        this.db = db;
+        this.vectorManager = vectorManager ?? null;
+    }
+    /**
+     * Start all enabled scheduled jobs.
+     * Each job runs on its own interval and failures are isolated.
+     */
+    start() {
+        if (this.started) {
+            logger.warning('Scheduler already started, ignoring duplicate start()', {
+                module: 'Scheduler',
+            });
+            return;
+        }
+        this.started = true;
+        const { backupIntervalMinutes, vacuumIntervalMinutes, rebuildIndexIntervalMinutes } = this.options;
+        if (backupIntervalMinutes > 0) {
+            this.scheduleJob('backup', backupIntervalMinutes, () => this.runBackup());
+        }
+        if (vacuumIntervalMinutes > 0) {
+            this.scheduleJob('vacuum', vacuumIntervalMinutes, () => this.runVacuumOptimize());
+        }
+        if (rebuildIndexIntervalMinutes > 0) {
+            if (this.vectorManager) {
+                this.scheduleJob('rebuild-index', rebuildIndexIntervalMinutes, () => this.runRebuildIndex());
+            }
+            else {
+                logger.warning('rebuild-index-interval specified but vector manager not available, skipping', { module: 'Scheduler' });
+            }
+        }
+        if (this.timers.length > 0) {
+            const summary = this.timers.map((t) => `${t.name} (${String(t.intervalMinutes)}min)`);
+            logger.info(`Scheduler started: ${summary.join(', ')}`, { module: 'Scheduler' });
+        }
+        else {
+            logger.info('Scheduler started with no jobs enabled', { module: 'Scheduler' });
+        }
+    }
+    /**
+     * Stop all scheduled jobs and clear timers.
+     * Safe to call multiple times.
+     */
+    stop() {
+        for (const job of this.timers) {
+            clearInterval(job.timer);
+        }
+        if (this.timers.length > 0) {
+            logger.info(`Scheduler stopped, cleared ${String(this.timers.length)} job(s)`, {
+                module: 'Scheduler',
+            });
+        }
+        this.timers.length = 0;
+        this.started = false;
+    }
+    /**
+     * Get the current status of all scheduled jobs.
+     */
+    getStatus() {
+        return {
+            active: this.started,
+            jobs: this.timers.map((t) => ({
+                name: t.name,
+                enabled: true,
+                intervalMinutes: t.intervalMinutes,
+                lastRun: t.lastRun?.toISOString() ?? null,
+                lastResult: t.lastResult,
+                lastError: t.lastError,
+                nextRun: t.lastRun
+                    ? new Date(t.lastRun.getTime() + t.intervalMinutes * 60_000).toISOString()
+                    : new Date(Date.now() + t.intervalMinutes * 60_000).toISOString(),
+                runCount: t.runCount,
+            })),
+        };
+    }
+    // ========================================================================
+    // Private — Job scheduling
+    // ========================================================================
+    /**
+     * Schedule a recurring job.
+     */
+    scheduleJob(name, intervalMinutes, fn) {
+        const intervalMs = intervalMinutes * 60_000;
+        const jobTimer = {
+            name,
+            intervalMinutes,
+            timer: setInterval(() => {
+                void this.executeJob(jobTimer, fn);
+            }, intervalMs),
+            lastRun: null,
+            lastResult: null,
+            lastError: null,
+            runCount: 0,
+        };
+        this.timers.push(jobTimer);
+    }
+    /**
+     * Execute a job with error isolation and status tracking.
+     */
+    async executeJob(job, fn) {
+        const startTime = Date.now();
+        try {
+            await fn();
+            job.lastRun = new Date(startTime);
+            job.lastResult = 'success';
+            job.lastError = null;
+            job.runCount++;
+        }
+        catch (error) {
+            job.lastRun = new Date(startTime);
+            job.lastResult = 'error';
+            job.lastError = error instanceof Error ? error.message : String(error);
+            job.runCount++;
+            logger.error(`Scheduled job '${job.name}' failed`, {
+                module: 'Scheduler',
+                operation: job.name,
+                error: job.lastError,
+            });
+        }
+    }
+    // ========================================================================
+    // Private — Job implementations
+    // ========================================================================
+    /**
+     * Backup job: export database to file, then cleanup old backups.
+     */
+    async runBackup() {
+        const result = this.db.exportToFile();
+        logger.info('Scheduled backup created', {
+            module: 'Scheduler',
+            operation: 'backup',
+            context: { filename: result.filename, sizeBytes: result.sizeBytes },
+        });
+        const cleanup = this.db.deleteOldBackups(this.options.keepBackups);
+        if (cleanup.deleted.length > 0) {
+            logger.info(`Backup cleanup: deleted ${String(cleanup.deleted.length)}, kept ${String(cleanup.kept)}`, {
+                module: 'Scheduler',
+                operation: 'backup-cleanup',
+            });
+        }
+        await Promise.resolve();
+    }
+    /**
+     * Vacuum/optimize job: run PRAGMA optimize and flush to disk.
+     *
+     * Note: sql.js uses an in-memory database. PRAGMA optimize updates
+     * internal statistics, and flushSave() ensures the disk file is current.
+     * A full VACUUM on sql.js only compacts the in-memory representation.
+     */
+    async runVacuumOptimize() {
+        const rawDb = this.db.getRawDb();
+        rawDb.run('PRAGMA optimize');
+        this.db.flushSave();
+        logger.info('Scheduled database optimize completed', {
+            module: 'Scheduler',
+            operation: 'vacuum',
+        });
+        await Promise.resolve();
+    }
+    /**
+     * Rebuild index job: full vector index rebuild from database entries.
+     */
+    async runRebuildIndex() {
+        if (!this.vectorManager) {
+            return;
+        }
+        const count = await this.vectorManager.rebuildIndex(this.db);
+        logger.info(`Scheduled vector index rebuild: ${String(count)} entries indexed`, {
+            module: 'Scheduler',
+            operation: 'rebuild-index',
+            context: { entriesIndexed: count },
+        });
+    }
+}
+//# sourceMappingURL=Scheduler.js.map

package/dist/server/Scheduler.js.map

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

package/dist/transports/http.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Memory Journal MCP Server - HTTP Transport
+ *
+ * Dual-protocol HTTP transport:
+ * - `/mcp` — Streamable HTTP transport (MCP 2025-03-26)
+ * - `/sse` + `/messages` — Legacy SSE transport (MCP 2024-11-05)
+ *
+ * Modes:
+ * - Stateful (default): Multi-session management with SSE streaming
+ * - Stateless (opt-in): Lightweight serverless-compatible mode
+ *
+ * Security: headers, CORS, rate limiting, body size enforcement.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Scheduler } from '../server/Scheduler.js';
+/**
+ * HTTP transport configuration
+ */
+export interface HttpTransportConfig {
+    port: number;
+    host: string;
+    corsOrigin: string;
+    stateless: boolean;
+    authToken?: string;
+}
+/**
+ * HTTP Transport for Memory Journal MCP Server
+ *
+ * Supports two transport protocols simultaneously:
+ * 1. Streamable HTTP (MCP 2025-03-26) via `/mcp` — preferred for modern clients
+ * 2. Legacy SSE (MCP 2024-11-05) via `/sse` + `/messages` — backward compatibility
+ */
+export declare class HttpTransport {
+    private readonly app;
+    private readonly config;
+    private readonly transports;
+    private readonly sseTransports;
+    private readonly sessionLastActivity;
+    private httpServer;
+    private sessionSweepTimer;
+    constructor(config: HttpTransportConfig);
+    /**
+     * Initialize and start the HTTP transport
+     */
+    start(server: McpServer, scheduler: Scheduler | null): Promise<void>;
+    /**
+     * Graceful shutdown
+     */
+    stop(scheduler: Scheduler | null): Promise<void>;
+    /**
+     * Setup stateless transport (single transport, no session management)
+     */
+    private setupStateless;
+    /** Update the last-activity timestamp for a session */
+    private touchSession;
+    /**
+     * Setup stateful transport (multi-session, SSE streaming)
+     */
+    private setupStateful;
+    /**
+     * Setup Legacy SSE endpoints for backward compatibility.
+     * Stateful mode only.
+     */
+    private setupLegacySSE;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/transports/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transports/http.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAOxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AASvD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmD;IAC9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;IACtE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA4B;IAChE,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,iBAAiB,CAA8C;gBAE3D,MAAM,EAAE,mBAAmB;IAKvC;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IA4J1E;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAyDtD;;OAEG;YACW,cAAc;IAwC5B,uDAAuD;IACvD,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0MrB;;;OAGG;IACH,OAAO,CAAC,cAAc;CA4FzB"}