exovault-mcp-server 1.0.0

package/dist/scripts/backfill-memory-embeddings.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+import { createHash } from "node:crypto";
+import { initialize } from "../auth.js";
+import { decrypt } from "../crypto.js";
+import { replaceMemoryEmbeddings, updateMemory } from "../db.js";
+import { generateEmbeddings } from "../openai.js";
+const OPENAI_EMBEDDING_MODEL = "text-embedding-3-small";
+const DEEPSEEK_EMBEDDING_MODEL = "deepseek-embedding";
+const VECTOR_DIMS = 1536;
+const CHARS_PER_TOKEN = 4;
+const CHUNK_TARGET_CHARS = 2400;
+const CHUNK_OVERLAP_CHARS = 400;
+function estimateTokens(text) {
+    return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+function buildContentHash(raw) {
+    return createHash("sha256").update(raw, "utf8").digest("hex");
+}
+function chunkText(plaintext) {
+    const text = plaintext.trim();
+    if (!text)
+        return [];
+    if (text.length <= CHUNK_TARGET_CHARS)
+        return [{ text, index: 0 }];
+    const chunks = [];
+    let start = 0;
+    let idx = 0;
+    while (start < text.length) {
+        const end = Math.min(start + CHUNK_TARGET_CHARS, text.length);
+        chunks.push({ text: text.slice(start, end).trim(), index: idx++ });
+        if (end >= text.length)
+            break;
+        start = Math.max(0, end - CHUNK_OVERLAP_CHARS);
+    }
+    return chunks;
+}
+function parseLimitArg() {
+    const arg = process.argv.find((v) => v.startsWith("--limit="));
+    if (!arg)
+        return 200;
+    const value = Number(arg.split("=")[1]);
+    return Number.isFinite(value) && value > 0 ? Math.floor(value) : 200;
+}
+async function loadBackfillCandidates(ctx, limit) {
+    const { data, error } = await ctx.supabase
+        .from("memories")
+        .select("*")
+        .eq("user_id", ctx.userId)
+        .eq("is_archived", false)
+        .in("indexing_status", ["pending", "failed", "stale"])
+        .order("updated_at", { ascending: false })
+        .limit(limit);
+    if (error) {
+        throw new Error(`Failed to load candidate memories: ${error.message}`);
+    }
+    return (data ?? []);
+}
+async function main() {
+    const ctx = await initialize();
+    const limit = parseLimitArg();
+    const envApiKey = process.env.RLM_EMBEDDING_API_KEY ??
+        process.env.EMBEDDING_API_KEY ??
+        process.env.OPENAI_API_KEY;
+    const embeddingConfig = envApiKey
+        ? {
+            apiKey: envApiKey,
+            baseUrl: process.env.RLM_EMBEDDING_BASE_URL ?? process.env.EMBEDDING_BASE_URL ?? "https://api.openai.com/v1",
+            model: process.env.RLM_EMBEDDING_MODEL ?? process.env.EMBEDDING_MODEL ?? OPENAI_EMBEDDING_MODEL,
+        }
+        : ctx.openaiApiKey
+            ? {
+                apiKey: ctx.openaiApiKey,
+                baseUrl: "https://api.openai.com/v1",
+                model: OPENAI_EMBEDDING_MODEL,
+            }
+            : ctx.llmConfig
+                ? {
+                    apiKey: ctx.llmConfig.apiKey,
+                    baseUrl: ctx.llmConfig.baseUrl,
+                    model: process.env.RLM_EMBEDDING_MODEL ?? DEEPSEEK_EMBEDDING_MODEL,
+                }
+                : null;
+    if (!embeddingConfig) {
+        throw new Error("No embedding-capable key found in MCP config (openaiApiKey or llmApiKey).");
+    }
+    const candidates = await loadBackfillCandidates(ctx, limit);
+    if (candidates.length === 0) {
+        process.stdout.write("No candidate memories found for backfill.\n");
+        return;
+    }
+    let ok = 0;
+    let failed = 0;
+    for (const memory of candidates) {
+        try {
+            const content = await decrypt(memory.encrypted_content, memory.content_iv, ctx.masterKey);
+            const summary = memory.encrypted_summary && memory.summary_iv
+                ? await decrypt(memory.encrypted_summary, memory.summary_iv, ctx.masterKey).catch(() => null)
+                : null;
+            const base = summary?.trim() ? `Summary: ${summary.trim()}\n\n${content.trim()}` : content.trim();
+            const chunks = chunkText(base);
+            if (chunks.length === 0) {
+                await updateMemory(ctx.supabase, memory.id, ctx.userId, {
+                    indexing_status: "failed",
+                    indexing_error: "no_chunks_generated",
+                });
+                failed += 1;
+                continue;
+            }
+            await updateMemory(ctx.supabase, memory.id, ctx.userId, {
+                indexing_status: "embedding",
+                indexing_error: null,
+            });
+            const vectors = await generateEmbeddings(chunks.map((c) => c.text), embeddingConfig.apiKey, {
+                baseUrl: embeddingConfig.baseUrl,
+                model: embeddingConfig.model,
+            });
+            const badVector = vectors.find((v) => v.length !== VECTOR_DIMS);
+            if (badVector) {
+                throw new Error(`embedding_dimensions_mismatch expected=${VECTOR_DIMS} got=${badVector.length} model=${embeddingConfig.model}`);
+            }
+            await replaceMemoryEmbeddings(ctx.supabase, {
+                memoryId: memory.id,
+                userId: ctx.userId,
+                embeddingModel: embeddingConfig.model,
+                contentHash: buildContentHash(chunks.map((c) => c.text).join("\n\n")),
+                rows: vectors.map((embedding, i) => ({
+                    chunkIndex: chunks[i]?.index ?? i,
+                    embedding,
+                    tokenCount: estimateTokens(chunks[i]?.text ?? ""),
+                })),
+            });
+            await updateMemory(ctx.supabase, memory.id, ctx.userId, {
+                indexing_status: "ready",
+                indexing_error: null,
+                last_indexed_at: new Date().toISOString(),
+            });
+            ok += 1;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message.slice(0, 2000) : "backfill_failed";
+            await updateMemory(ctx.supabase, memory.id, ctx.userId, {
+                indexing_status: "failed",
+                indexing_error: message,
+            });
+            failed += 1;
+        }
+    }
+    process.stdout.write(`Backfill complete. processed=${candidates.length} ready=${ok} failed=${failed}\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`Backfill failed: ${err.message}\n`);
+    process.exit(1);
+});

package/dist/scripts/backfill-memory-embeddings.js.map

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

package/dist/session-buffer.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Session buffer — tracks tool call activity during a local MCP session.
+ *
+ * The buffer accumulates tool calls (with truncated I/O summaries) so that
+ * when the session ends (idle timeout, stdin EOF, SIGTERM), we can generate
+ * a rule-based episodic summary or feed the activity log to an LLM for
+ * structured extraction.
+ *
+ * Buffer data is kept in-memory and periodically written to a JSON file
+ * at `~/.exovault-mcp/sessions/session-{agentRunId}.json` as a crash
+ * recovery mechanism.
+ */
+export type ActivityCategory = "read" | "write" | "search" | "system";
+export interface SessionActivity {
+    tool: string;
+    timestamp: string;
+    category: ActivityCategory;
+    inputSummary?: string;
+    outputSummary?: string;
+}
+export interface SessionBufferData {
+    agentRunId: string;
+    agentId: string;
+    startedAt: string;
+    vaultId: string;
+    activities: SessionActivity[];
+    memoriesWritten: string[];
+    lastActivityAt: string;
+    lastFlushedAt: string | null;
+    /** Rich transcript entries for auto-episodic generation (higher char limits than activity summaries). */
+    transcript: TranscriptEntry[];
+}
+/**
+ * A rich transcript entry capturing meaningful context from a tool call.
+ * Unlike SessionActivity (200-char summaries for lightweight tracking),
+ * transcript entries capture enough content for episodic generation.
+ */
+export interface TranscriptEntry {
+    tool: string;
+    timestamp: string;
+    /** Human-readable summary of what this tool call did, with actual content. */
+    context: string;
+}
+/** Tool name → category mapping. */
+export declare const TOOL_CATEGORIES: Record<string, ActivityCategory>;
+export declare function categorizeTool(toolName: string): ActivityCategory;
+export interface SessionBuffer {
+    recordActivity(tool: string, inputSummary?: string, outputSummary?: string): void;
+    /** Record a rich transcript entry for auto-episodic generation. */
+    recordTranscript(tool: string, context: string): void;
+    recordMemoryWrite(memoryId: string): void;
+    markFlushed(): void;
+    wasCheckpointed(): boolean;
+    getSearchCount(): number;
+    getWriteCount(): number;
+    getReadCount(): number;
+    getTotalCount(): number;
+    getData(): SessionBufferData;
+}
+export declare function createSessionBuffer(config: {
+    agentRunId: string;
+    agentId: string;
+    vaultId: string;
+}): SessionBuffer;
+/**
+ * Build a conversation turn from the session activity for auto-ingestion.
+ * Returns null if there's nothing meaningful to ingest (empty or system-only).
+ */
+export declare function buildTurnContent(data: SessionBufferData): string | null;
+/**
+ * Build a rule-based episodic summary from the session buffer.
+ * Used as a fallback when LLM extraction is skipped or budget-exhausted.
+ * Always available at $0.00.
+ *
+ * Synthesizes WHAT was discussed, explored, decided, and accomplished
+ * using tool call metadata (inputs + outputs).
+ */
+export declare function buildRuleBasedEpisodic(data: SessionBufferData): string;
+/**
+ * Determine if a tool call should generate a transcript entry.
+ * Only "rich" tools (writes, searches, graph, checkpoint) are worth capturing.
+ */
+export declare function shouldTranscript(toolName: string): boolean;
+/**
+ * Extract a human-readable context string from a tool call's args and result.
+ * Returns null if the tool shouldn't be transcribed.
+ *
+ * The args object is the raw tool input (not yet stringified).
+ * The resultText is the text content from the tool response.
+ */
+export declare function extractToolContext(toolName: string, args: Record<string, unknown>, resultText?: string): string | null;
+/**
+ * Minimum number of transcript entries to qualify for auto-episodic generation.
+ * Below this threshold, the session is too thin to be worth summarizing.
+ */
+export declare const MIN_TRANSCRIPT_ENTRIES_FOR_EPISODIC = 3;
+/**
+ * Build a narrative episodic summary from transcript entries.
+ * Used when the agent didn't call context_checkpoint but the session
+ * has enough rich tool context to generate a useful summary.
+ *
+ * Returns null if the transcript is too thin.
+ */
+export declare function buildTranscriptEpisodic(data: SessionBufferData): string | null;

package/dist/session-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-buffer.d.ts","sourceRoot":"","sources":["../src/session-buffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yGAAyG;IACzG,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,oCAAoC;AACpC,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAoC5D,CAAC;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAEjE;AAOD,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClF,mEAAmE;IACnE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,WAAW,IAAI,IAAI,CAAC;IACpB,eAAe,IAAI,OAAO,CAAC;IAC3B,cAAc,IAAI,MAAM,CAAC;IACzB,aAAa,IAAI,MAAM,CAAC;IACxB,YAAY,IAAI,MAAM,CAAC;IACvB,aAAa,IAAI,MAAM,CAAC;IACxB,OAAO,IAAI,iBAAiB,CAAC;CAC9B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,aAAa,CA4EhB;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAkBvE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAiCtE;AAwID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CA0Ff;AAMD;;;GAGG;AACH,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAkB9E"}