exovault-mcp-server 1.0.0

package/dist/tools/create-note.js

@@ -0,0 +1,60 @@
+import { insertNote, resolvePendingLinks } from "../db.js";
+import { encrypt, hashPendingTarget } from "../crypto.js";
+import { logMcpUsageEvent } from "../usage.js";
+import { generateBlindTokens } from "./blind-index.js";
+import { syncWikiLinks } from "./wiki-link-sync.js";
+export async function createNote(ctx, vaultId, title, content, tags) {
+    // Wrap plain text in <p> tags for Tiptap compatibility
+    const htmlContent = content.includes("<")
+        ? content
+        : `<p>${content}</p>`;
+    const [encTitle, encContent] = await Promise.all([
+        encrypt(title, ctx.masterKey),
+        encrypt(htmlContent, ctx.masterKey),
+    ]);
+    const noteData = {
+        user_id: ctx.userId,
+        vault_id: vaultId,
+        encrypted_title: encTitle.ciphertext,
+        title_iv: encTitle.iv,
+        encrypted_content: encContent.ciphertext,
+        content_iv: encContent.iv,
+        content_type: "markdown",
+        embedding_status: "pending",
+    };
+    if (tags && tags.length > 0) {
+        const encTags = await encrypt(JSON.stringify(tags), ctx.masterKey);
+        noteData.encrypted_tags = encTags.ciphertext;
+        noteData.tags_iv = encTags.iv;
+    }
+    // Generate blind index tokens from title + content + tags
+    if (ctx.mekHex) {
+        const searchableText = [title, content, ...(tags ?? [])].join(" ");
+        const blindTokens = generateBlindTokens(searchableText, ctx.mekHex);
+        if (blindTokens.length > 0) {
+            noteData.blind_tokens = blindTokens;
+        }
+    }
+    const result = await insertNote(ctx.supabase, noteData);
+    // Parse [[wiki-links]] from content and create knowledge_links
+    await syncWikiLinks(ctx.supabase, "note", result.id, ctx.userId, content, vaultId, ctx.masterKey);
+    // Resolve pending wiki-links that match this new note's title
+    try {
+        const titleHash = hashPendingTarget(title);
+        const hashMap = new Map([[titleHash, result.id]]);
+        await resolvePendingLinks(ctx.supabase, ctx.userId, hashMap);
+    }
+    catch {
+        // Best-effort: pending resolution is supplementary
+    }
+    const payload = JSON.stringify({ noteId: result.id });
+    await logMcpUsageEvent({
+        supabase: ctx.supabase,
+        userId: ctx.userId,
+        vaultId,
+        operationType: "mcp_create_note",
+        inputText: `${title}\n${content}`,
+        outputText: payload,
+    });
+    return payload;
+}

package/dist/tools/create-note.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-note.js","sourceRoot":"","sources":["../../src/tools/create-note.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAe,EACf,OAAe,EACf,KAAa,EACb,OAAe,EACf,IAAe;IAEf,uDAAuD;IACvD,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QACvC,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC;IAExB,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/C,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC;QAC7B,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC;KACpC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAqC;QACjD,OAAO,EAAE,GAAG,CAAC,MAAM;QACnB,QAAQ,EAAE,OAAO;QACjB,eAAe,EAAE,QAAQ,CAAC,UAAU;QACpC,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,iBAAiB,EAAE,UAAU,CAAC,UAAU;QACxC,UAAU,EAAE,UAAU,CAAC,EAAE;QACzB,YAAY,EAAE,UAAU;QACxB,gBAAgB,EAAE,SAAS;KAC5B,CAAC;IAEF,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QACnE,QAAQ,CAAC,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;QAC7C,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC;IAChC,CAAC;IAED,0DAA0D;IAC1D,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,mBAAmB,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACpE,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,QAAQ,CAAC,YAAY,GAAG,WAAW,CAAC;QACtC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAExD,+DAA+D;IAC/D,MAAM,aAAa,CACjB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,EAC3C,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,SAAS,CAChC,CAAC;IAEF,8DAA8D;IAC9D,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,mBAAmB,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,gBAAgB,CAAC;QACrB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO;QACP,aAAa,EAAE,iBAAiB;QAChC,SAAS,EAAE,GAAG,KAAK,KAAK,OAAO,EAAE;QACjC,UAAU,EAAE,OAAO;KACpB,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tools/create-vault.d.ts

@@ -0,0 +1,5 @@
+import type { McpContext } from "../auth.js";
+export declare function createVault(ctx: McpContext, name: string, options?: {
+    icon?: string;
+    color?: string;
+}): Promise<string>;

package/dist/tools/create-vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-vault.d.ts","sourceRoot":"","sources":["../../src/tools/create-vault.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA0F7C,wBAAsB,WAAW,CAC/B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,MAAM,CAAC,CA+DjB"}

package/dist/tools/create-vault.js

@@ -0,0 +1,121 @@
+import { decrypt, encrypt } from "../crypto.js";
+import { getMemoryByExternalWriteId, getNoteByImportSource, getVaults, insertMemory, insertNote, } from "../db.js";
+import { logMcpUsageEvent } from "../usage.js";
+import { getVaultInstructionIds, getVaultInstructionTemplate, } from "./vault-instruction-template.js";
+async function seedVaultInstructionArtifacts(ctx, vaultId, vaultName) {
+    const template = getVaultInstructionTemplate(vaultName);
+    const ids = getVaultInstructionIds(vaultId);
+    const [existingNote, existingMemory] = await Promise.all([
+        getNoteByImportSource(ctx.supabase, ctx.userId, vaultId, ids.noteImportSource, ids.noteImportSourceId),
+        getMemoryByExternalWriteId(ctx.supabase, ctx.userId, ids.memoryExternalWriteId),
+    ]);
+    if (!existingNote) {
+        const [encTitle, encContent, encTags] = await Promise.all([
+            encrypt(template.noteTitle, ctx.masterKey),
+            encrypt(template.noteContent, ctx.masterKey),
+            encrypt(JSON.stringify(template.noteTags), ctx.masterKey),
+        ]);
+        await insertNote(ctx.supabase, {
+            user_id: ctx.userId,
+            vault_id: vaultId,
+            encrypted_title: encTitle.ciphertext,
+            title_iv: encTitle.iv,
+            encrypted_content: encContent.ciphertext,
+            content_iv: encContent.iv,
+            content_type: "markdown",
+            encrypted_tags: encTags.ciphertext,
+            tags_iv: encTags.iv,
+            embedding_status: "pending",
+            import_source: ids.noteImportSource,
+            import_source_id: ids.noteImportSourceId,
+            import_source_meta: {
+                system: true,
+                kind: "agent_memory_instruction",
+                instructionVersion: 1,
+            },
+        });
+    }
+    if (!existingMemory) {
+        const [encMemory, encSummary] = await Promise.all([
+            encrypt(template.memoryContent, ctx.masterKey),
+            encrypt(template.memorySummary, ctx.masterKey),
+        ]);
+        await insertMemory(ctx.supabase, {
+            user_id: ctx.userId,
+            vault_id: vaultId,
+            memory_type: template.memoryType,
+            external_write_id: ids.memoryExternalWriteId,
+            encrypted_content: encMemory.ciphertext,
+            content_iv: encMemory.iv,
+            encrypted_summary: encSummary.ciphertext,
+            summary_iv: encSummary.iv,
+            importance: template.importance,
+            confidence: template.confidence,
+            write_reason: "Auto-seeded vault instruction on create",
+            metadata: {
+                system: true,
+                kind: "agent_memory_instruction",
+                instructionVersion: 1,
+            },
+            indexing_status: "pending",
+        });
+    }
+}
+export async function createVault(ctx, name, options) {
+    const desired = name.trim();
+    if (!desired) {
+        return JSON.stringify({ success: false, error: "Vault name is required" });
+    }
+    // Idempotent create by exact decrypted name for this user.
+    const existingVaults = await getVaults(ctx.supabase, ctx.userId);
+    for (const v of existingVaults) {
+        try {
+            const decrypted = await decrypt(v.encrypted_name, v.name_iv, ctx.masterKey);
+            if (decrypted.toLowerCase() === desired.toLowerCase()) {
+                await seedVaultInstructionArtifacts(ctx, v.id, decrypted);
+                return JSON.stringify({
+                    success: true,
+                    created: false,
+                    vaultId: v.id,
+                    name: decrypted,
+                });
+            }
+        }
+        catch {
+            // ignore decryption errors and continue
+        }
+    }
+    const { ciphertext, iv } = await encrypt(desired, ctx.masterKey);
+    const { data, error } = await ctx.supabase
+        .from("vaults")
+        .insert({
+        user_id: ctx.userId,
+        encrypted_name: ciphertext,
+        name_iv: iv,
+        icon: options?.icon ?? "folder",
+        color: options?.color ?? "#6366f1",
+    })
+        .select("id, icon, color")
+        .single();
+    if (error || !data) {
+        throw new Error(`Failed to create vault: ${error?.message ?? "Unknown error"}`);
+    }
+    await seedVaultInstructionArtifacts(ctx, data.id, desired);
+    const payload = JSON.stringify({
+        success: true,
+        created: true,
+        vaultId: data.id,
+        name: desired,
+        icon: data.icon,
+        color: data.color,
+    });
+    await logMcpUsageEvent({
+        supabase: ctx.supabase,
+        userId: ctx.userId,
+        vaultId: data.id,
+        operationType: "mcp_create_vault",
+        inputText: desired,
+        outputText: payload,
+    });
+    return payload;
+}

package/dist/tools/create-vault.js.map

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

package/dist/tools/decrypt-helpers.d.ts

@@ -0,0 +1,31 @@
+export interface DecryptedNoteFields {
+    title: string;
+    content: string;
+    tags: string[];
+}
+export interface DecryptedMemoryCore {
+    content: string;
+    summary: string | null;
+}
+/**
+ * Decrypt the encrypted fields of a note row.
+ * Tags are gracefully handled — returns empty array if decryption or JSON.parse fails.
+ */
+export declare function decryptNoteFields(note: {
+    encrypted_title: string;
+    title_iv: string;
+    encrypted_content: string;
+    content_iv: string;
+    encrypted_tags?: string | null;
+    tags_iv?: string | null;
+}, masterKey: CryptoKey): Promise<DecryptedNoteFields>;
+/**
+ * Decrypt the encrypted content and optional summary of a memory row.
+ * Summary decryption failure is swallowed (returns null).
+ */
+export declare function decryptMemoryFields(memory: {
+    encrypted_content: string;
+    content_iv: string;
+    encrypted_summary?: string | null;
+    summary_iv?: string | null;
+}, masterKey: CryptoKey): Promise<DecryptedMemoryCore>;

package/dist/tools/decrypt-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decrypt-helpers.d.ts","sourceRoot":"","sources":["../../src/tools/decrypt-helpers.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE;IACJ,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,EACD,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAiB9B;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE;IACN,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,EACD,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAO9B"}

package/dist/tools/decrypt-helpers.js

@@ -0,0 +1,33 @@
+import { decrypt } from "../crypto.js";
+/**
+ * Decrypt the encrypted fields of a note row.
+ * Tags are gracefully handled — returns empty array if decryption or JSON.parse fails.
+ */
+export async function decryptNoteFields(note, masterKey) {
+    const [title, content] = await Promise.all([
+        decrypt(note.encrypted_title, note.title_iv, masterKey),
+        decrypt(note.encrypted_content, note.content_iv, masterKey),
+    ]);
+    let tags = [];
+    if (note.encrypted_tags && note.tags_iv) {
+        try {
+            const tagsJson = await decrypt(note.encrypted_tags, note.tags_iv, masterKey);
+            tags = JSON.parse(tagsJson);
+        }
+        catch {
+            // ignore — tags are best-effort
+        }
+    }
+    return { title, content, tags };
+}
+/**
+ * Decrypt the encrypted content and optional summary of a memory row.
+ * Summary decryption failure is swallowed (returns null).
+ */
+export async function decryptMemoryFields(memory, masterKey) {
+    const content = await decrypt(memory.encrypted_content, memory.content_iv, masterKey);
+    const summary = memory.encrypted_summary && memory.summary_iv
+        ? await decrypt(memory.encrypted_summary, memory.summary_iv, masterKey).catch(() => null)
+        : null;
+    return { content, summary };
+}

package/dist/tools/decrypt-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decrypt-helpers.js","sourceRoot":"","sources":["../../src/tools/decrypt-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAavC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAOC,EACD,SAAoB;IAEpB,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;KAC5D,CAAC,CAAC;IAEH,IAAI,IAAI,GAAa,EAAE,CAAC;IACxB,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC7E,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAKC,EACD,SAAoB;IAEpB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACtF,MAAM,OAAO,GACX,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,UAAU;QAC3C,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QACzF,CAAC,CAAC,IAAI,CAAC;IACX,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/tools/delete-note.d.ts

@@ -0,0 +1,2 @@
+import type { McpContext } from "../auth.js";
+export declare function deleteNote(ctx: McpContext, noteId: string): Promise<string>;

package/dist/tools/delete-note.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-note.d.ts","sourceRoot":"","sources":["../../src/tools/delete-note.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,wBAAsB,UAAU,CAC9B,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/tools/delete-note.js

@@ -0,0 +1,21 @@
+import { getNote, deleteNote as dbDeleteNote } from "../db.js";
+import { decrypt } from "../crypto.js";
+import { logMcpUsageEvent } from "../usage.js";
+export async function deleteNote(ctx, noteId) {
+    const note = await getNote(ctx.supabase, ctx.userId, noteId);
+    if (!note) {
+        return JSON.stringify({ success: false, error: "Note not found" });
+    }
+    const title = await decrypt(note.encrypted_title, note.title_iv, ctx.masterKey);
+    await dbDeleteNote(ctx.supabase, noteId, ctx.userId);
+    const payload = JSON.stringify({ success: true, deletedTitle: title });
+    await logMcpUsageEvent({
+        supabase: ctx.supabase,
+        userId: ctx.userId,
+        vaultId: note.vault_id,
+        operationType: "mcp_delete_note",
+        inputText: noteId,
+        outputText: payload,
+    });
+    return payload;
+}

package/dist/tools/delete-note.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-note.js","sourceRoot":"","sources":["../../src/tools/delete-note.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAe,EACf,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;IAEhF,MAAM,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,MAAM,gBAAgB,CAAC;QACrB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,IAAI,CAAC,QAAQ;QACtB,aAAa,EAAE,iBAAiB;QAChC,SAAS,EAAE,MAAM;QACjB,UAAU,EAAE,OAAO;KACpB,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tools/explore-graph.d.ts

@@ -0,0 +1,11 @@
+import type { McpContext } from "../auth.js";
+interface ExploreInput {
+    query?: string;
+    nodeId?: string;
+    nodeType?: "note" | "memory";
+    maxHops?: number;
+    maxNodes?: number;
+    vaultId?: string;
+}
+export declare function exploreGraph(ctx: McpContext, input: ExploreInput): Promise<string>;
+export {};

package/dist/tools/explore-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-graph.d.ts","sourceRoot":"","sources":["../../src/tools/explore-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAwB7C,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAoED,wBAAsB,YAAY,CAChC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,MAAM,CAAC,CAqLjB"}

package/dist/tools/explore-graph.js

@@ -0,0 +1,169 @@
+import { matchMemoryEmbeddings, matchNoteEmbeddings, getKnowledgeGraph, getMemoriesByIds, getNotesByIds, } from "../db.js";
+import { decrypt } from "../crypto.js";
+import { decryptMemoryFields } from "./decrypt-helpers.js";
+import { generateQueryEmbedding } from "../openai.js";
+import { resolveEmbeddingConfig } from "../embedding-config.js";
+import { logMcpUsageEvent } from "../usage.js";
+const PREVIEW_CHARS = 200;
+const DEFAULT_MAX_HOPS = 2;
+const DEFAULT_MAX_NODES = 50;
+const MAX_SEED_COUNT = 5;
+const SEMANTIC_THRESHOLD = 0.4;
+const SEMANTIC_TOP_K = 10;
+// ── Helpers ──────────────────────────────────────────────────────────
+function clip(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max)}...`;
+}
+async function memoryToNode(m, masterKey) {
+    const { content, summary } = await decryptMemoryFields(m, masterKey);
+    return {
+        id: m.id,
+        type: "memory",
+        summary: summary ?? clip(content, PREVIEW_CHARS),
+        memoryType: m.memory_type,
+        importance: m.importance,
+        confidence: m.confidence,
+        entities: m.entities,
+        updatedAt: m.updated_at,
+    };
+}
+async function noteToNode(n, masterKey) {
+    const title = await decrypt(n.encrypted_title, n.title_iv, masterKey);
+    const content = await decrypt(n.encrypted_content, n.content_iv, masterKey).catch(() => "");
+    return {
+        id: n.id,
+        type: "note",
+        title,
+        preview: clip(content, PREVIEW_CHARS),
+        updatedAt: n.updated_at,
+    };
+}
+// ── Main ─────────────────────────────────────────────────────────────
+export async function exploreGraph(ctx, input) {
+    const { query, nodeId, nodeType, maxHops, maxNodes } = input;
+    // Validate: need at least one entry method
+    if (!query && !nodeId) {
+        return JSON.stringify({
+            error: "Provide at least one of `query` (semantic search for entry points) or `nodeId` + `nodeType` (start from a specific node).",
+        });
+    }
+    const hops = Math.min(maxHops ?? DEFAULT_MAX_HOPS, 5);
+    const nodes = Math.min(maxNodes ?? DEFAULT_MAX_NODES, 200);
+    // ── Step 1: Resolve entry points ─────────────────────────────────
+    const seedIds = [];
+    if (nodeId) {
+        // Direct node entry
+        seedIds.push({ id: nodeId, type: nodeType ?? "memory" });
+    }
+    if (query) {
+        // Semantic search for memory entry points
+        const embeddingConfig = resolveEmbeddingConfig(ctx);
+        if (!embeddingConfig) {
+            return JSON.stringify({
+                error: "No embedding configuration available. Set openaiApiKey in config or EMBEDDING_API_KEY env var.",
+            });
+        }
+        const embedding = await generateQueryEmbedding(query, embeddingConfig.apiKey, { baseUrl: embeddingConfig.baseUrl, model: embeddingConfig.model });
+        // Search both memory and note embeddings in parallel
+        const [memoryMatches, noteMatches] = await Promise.all([
+            matchMemoryEmbeddings(ctx.supabase, embedding, ctx.userId, SEMANTIC_THRESHOLD, SEMANTIC_TOP_K),
+            matchNoteEmbeddings(ctx.supabase, embedding, ctx.userId, SEMANTIC_THRESHOLD, SEMANTIC_TOP_K),
+        ]);
+        // Deduplicate by id, keep highest similarity, merge into unified list
+        const best = new Map();
+        for (const m of memoryMatches) {
+            const existing = best.get(m.memory_id);
+            if (!existing || m.similarity > existing.similarity) {
+                best.set(m.memory_id, { similarity: m.similarity, type: "memory" });
+            }
+        }
+        for (const n of noteMatches) {
+            const existing = best.get(n.note_id);
+            if (!existing || n.similarity > existing.similarity) {
+                best.set(n.note_id, { similarity: n.similarity, type: "note" });
+            }
+        }
+        const sorted = Array.from(best.entries())
+            .sort((a, b) => b[1].similarity - a[1].similarity)
+            .slice(0, MAX_SEED_COUNT);
+        for (const [id, { type }] of sorted) {
+            if (!seedIds.some((s) => s.id === id)) {
+                seedIds.push({ id, type });
+            }
+        }
+    }
+    if (seedIds.length === 0) {
+        return JSON.stringify({
+            entryPoints: [],
+            nodes: [],
+            edges: [],
+            stats: { totalNodes: 0, totalEdges: 0, maxHopReached: 0 },
+        });
+    }
+    // ── Step 2: Graph expansion ──────────────────────────────────────
+    const allEdges = [];
+    const discoveredNodeIds = new Map(); // id → type
+    let maxHopReached = 0;
+    // Include seed nodes themselves
+    for (const seed of seedIds) {
+        discoveredNodeIds.set(seed.id, seed.type);
+    }
+    // Expand from each seed in parallel
+    const graphResults = await Promise.all(seedIds.map((seed) => getKnowledgeGraph(ctx.supabase, ctx.userId, seed.type, seed.id, hops, nodes)));
+    const edgeSet = new Set(); // dedup edges by "from|to|relation"
+    for (const neighbors of graphResults) {
+        for (const n of neighbors) {
+            // Track node
+            discoveredNodeIds.set(n.node_id, n.node_type);
+            maxHopReached = Math.max(maxHopReached, n.hop);
+            // Track edge (deduplicate)
+            const edgeKey = `${n.from_id}|${n.node_id}|${n.relation}`;
+            if (!edgeSet.has(edgeKey)) {
+                edgeSet.add(edgeKey);
+                allEdges.push({
+                    from: n.from_id,
+                    to: n.node_id,
+                    relation: n.relation,
+                });
+            }
+        }
+    }
+    // ── Step 3: Fetch node details ───────────────────────────────────
+    const memoryIds = Array.from(discoveredNodeIds.entries())
+        .filter(([, type]) => type === "memory")
+        .map(([id]) => id);
+    const noteIds = Array.from(discoveredNodeIds.entries())
+        .filter(([, type]) => type === "note")
+        .map(([id]) => id);
+    const [memories, notes] = await Promise.all([
+        memoryIds.length > 0
+            ? getMemoriesByIds(ctx.supabase, ctx.userId, memoryIds)
+            : [],
+        noteIds.length > 0
+            ? getNotesByIds(ctx.supabase, ctx.userId, noteIds)
+            : [],
+    ]);
+    // ── Step 4: Decrypt and format ───────────────────────────────────
+    const graphNodes = await Promise.all([
+        ...memories.map((m) => memoryToNode(m, ctx.masterKey)),
+        ...notes.map((n) => noteToNode(n, ctx.masterKey)),
+    ]);
+    const entryPoints = seedIds.map((s) => s.id);
+    const payload = JSON.stringify({
+        entryPoints,
+        nodes: graphNodes,
+        edges: allEdges,
+        stats: {
+            totalNodes: graphNodes.length,
+            totalEdges: allEdges.length,
+            maxHopReached,
+        },
+    }, null, 2);
+    await logMcpUsageEvent({
+        supabase: ctx.supabase,
+        userId: ctx.userId,
+        operationType: "mcp_explore_graph",
+        outputText: payload,
+    }).catch(() => { });
+    return payload;
+}

package/dist/tools/explore-graph.js.map

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

package/dist/tools/get-related-memories.d.ts

@@ -0,0 +1,2 @@
+import type { McpContext } from "../auth.js";
+export declare function getRelatedMemories(ctx: McpContext, memoryId: string, limit?: number): Promise<string>;

package/dist/tools/get-related-memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-related-memories.d.ts","sourceRoot":"","sources":["../../src/tools/get-related-memories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAgEjB"}

package/dist/tools/get-related-memories.js

@@ -0,0 +1,59 @@
+import { getRelatedMemoriesById } from "../db.js";
+import { logMcpUsageEvent } from "../usage.js";
+import { decryptNoteFields, decryptMemoryFields } from "./decrypt-helpers.js";
+export async function getRelatedMemories(ctx, memoryId, limit) {
+    const result = await getRelatedMemoriesById(ctx.supabase, ctx.userId, memoryId, limit ?? 20);
+    if (!result.source) {
+        return JSON.stringify({ error: "Memory not found", memoryId });
+    }
+    const { content: sourceContent, summary: sourceSummary } = await decryptMemoryFields(result.source, ctx.masterKey);
+    const decryptList = async (memories) => {
+        return Promise.all(memories.map(async (m) => {
+            const { content, summary } = await decryptMemoryFields(m, ctx.masterKey);
+            return {
+                id: m.id,
+                memoryType: m.memory_type,
+                content,
+                summary,
+                importance: m.importance,
+                confidence: m.confidence,
+                entities: m.entities,
+                relatedMemoryIds: m.related_memory_ids,
+                supersededById: m.superseded_by_id,
+                updatedAt: m.updated_at,
+            };
+        }));
+    };
+    const decryptedNotes = await Promise.all(result.linkedNotes.map(async (n) => {
+        const { title, tags } = await decryptNoteFields(n, ctx.masterKey);
+        return {
+            id: n.id,
+            title,
+            tags,
+            vaultId: n.vault_id,
+            updatedAt: n.updated_at,
+        };
+    }));
+    const payload = JSON.stringify({
+        source: {
+            id: result.source.id,
+            memoryType: result.source.memory_type,
+            content: sourceContent,
+            summary: sourceSummary,
+            entities: result.source.entities,
+            relatedMemoryIds: result.source.related_memory_ids,
+            supersededById: result.source.superseded_by_id,
+        },
+        related: await decryptList(result.related),
+        linkedNotes: decryptedNotes,
+        entityMatches: await decryptList(result.entityMatches),
+        supersessionChain: await decryptList(result.supersessionChain),
+    }, null, 2);
+    await logMcpUsageEvent({
+        supabase: ctx.supabase,
+        userId: ctx.userId,
+        operationType: "mcp_get_related_memories",
+        outputText: payload,
+    });
+    return payload;
+}

package/dist/tools/get-related-memories.js.map

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

package/dist/tools/knowledge-links.d.ts

@@ -0,0 +1,17 @@
+import type { McpContext } from "../auth.js";
+import { type NodeType } from "../db.js";
+export declare function getLinks(ctx: McpContext, input: {
+    nodeType: NodeType;
+    nodeId: string;
+    direction?: "outgoing" | "incoming" | "both";
+    limit?: number;
+}): Promise<string>;
+export declare function addLink(ctx: McpContext, input: {
+    sourceType: NodeType;
+    sourceId: string;
+    targetType: NodeType;
+    targetId: string;
+    relationType: string;
+    label?: string;
+}): Promise<string>;
+export declare function removeLink(ctx: McpContext, linkId: string): Promise<string>;

package/dist/tools/knowledge-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-links.d.ts","sourceRoot":"","sources":["../../src/tools/knowledge-links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,EAIL,KAAK,QAAQ,EAGd,MAAM,UAAU,CAAC;AA8BlB,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE;IACL,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAOD,wBAAsB,OAAO,CAC3B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE;IACL,UAAU,EAAE,QAAQ,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,QAAQ,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC,MAAM,CAAC,CA8CjB;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAajB"}