exovault-mcp-server 1.0.0

package/dist/tools/update-memory.js

@@ -0,0 +1,230 @@
+import { getMemoriesByIds, updateMemory as dbUpdateMemory, bulkInsertKnowledgeLinks, deleteLinksForNode, } from "../db.js";
+import { encrypt, decrypt } from "../crypto.js";
+import { extractEntities } from "../entity-extraction.js";
+import { generateBlindTokens } from "./blind-index.js";
+import { generateEmbeddings } from "../openai.js";
+import { logMcpUsageEvent } from "../usage.js";
+import { resolveEmbeddingConfig } from "../embedding-config.js";
+import { syncWikiLinks, deleteWikiLinksForNode } from "./wiki-link-sync.js";
+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 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;
+}
+export async function updateMemoryTool(ctx, input) {
+    // Fetch existing memory to verify ownership
+    const [existing] = await getMemoriesByIds(ctx.supabase, ctx.userId, [input.memoryId]);
+    if (!existing) {
+        throw new Error("Memory not found");
+    }
+    const updates = {};
+    let contentChanged = false;
+    // Encrypt new content if provided
+    if (input.content !== undefined) {
+        const enc = await encrypt(input.content, ctx.masterKey);
+        updates.encrypted_content = enc.ciphertext;
+        updates.content_iv = enc.iv;
+        contentChanged = true;
+    }
+    // Encrypt new summary if provided
+    if (input.summary !== undefined) {
+        if (input.summary) {
+            const enc = await encrypt(input.summary, ctx.masterKey);
+            updates.encrypted_summary = enc.ciphertext;
+            updates.summary_iv = enc.iv;
+        }
+        else {
+            // Empty string = clear summary
+            updates.encrypted_summary = null;
+            updates.summary_iv = null;
+        }
+        contentChanged = true;
+    }
+    if (input.memoryType !== undefined)
+        updates.memory_type = input.memoryType;
+    if (input.importance !== undefined)
+        updates.importance = input.importance;
+    if (input.confidence !== undefined)
+        updates.confidence = input.confidence;
+    if (input.relatedMemoryIds !== undefined)
+        updates.related_memory_ids = input.relatedMemoryIds;
+    if (input.sourceNoteIds !== undefined)
+        updates.source_note_ids = input.sourceNoteIds;
+    if (input.isArchived !== undefined)
+        updates.is_archived = input.isArchived;
+    // Merge metadata (task-specific fields like taskStatus, assignedAgentId)
+    if (input.metadata !== undefined) {
+        const existingMeta = (existing.metadata ?? {});
+        updates.metadata = { ...existingMeta, ...input.metadata };
+    }
+    // Auto-extract entities if content changed and no explicit entities provided
+    if (input.entities !== undefined) {
+        updates.entities = input.entities;
+    }
+    else if (contentChanged && input.content) {
+        const extracted = await extractEntities(ctx, input.content, input.summary);
+        if (extracted)
+            updates.entities = extracted;
+    }
+    // Regenerate blind index tokens when content changes
+    if (contentChanged && input.content) {
+        const blindTokens = generateBlindTokens(input.content, ctx.mekHex);
+        if (blindTokens.length > 0)
+            updates.blind_tokens = blindTokens;
+    }
+    // Mark for re-indexing if content changed
+    if (contentChanged) {
+        updates.indexing_status = "pending";
+    }
+    if (Object.keys(updates).length === 0) {
+        return JSON.stringify({ memoryId: input.memoryId, updated: false, reason: "no_changes" });
+    }
+    const updated = await dbUpdateMemory(ctx.supabase, input.memoryId, ctx.userId, updates);
+    // Dual-write: sync knowledge_links when relationship params change
+    if (input.relatedMemoryIds !== undefined || input.sourceNoteIds !== undefined) {
+        try {
+            await deleteLinksForNode(ctx.supabase, ctx.userId, "memory", input.memoryId);
+            const links = [];
+            const relIds = input.relatedMemoryIds ?? existing.related_memory_ids;
+            if (relIds?.length) {
+                for (const rel of relIds) {
+                    links.push({
+                        user_id: ctx.userId,
+                        source_type: "memory",
+                        source_id: input.memoryId,
+                        target_type: "memory",
+                        target_id: rel.memoryId,
+                        relation_type: rel.relationType,
+                        created_by: "agent",
+                    });
+                }
+            }
+            const noteIds = input.sourceNoteIds ?? existing.source_note_ids;
+            if (noteIds?.length) {
+                for (const noteId of noteIds) {
+                    links.push({
+                        user_id: ctx.userId,
+                        source_type: "memory",
+                        source_id: input.memoryId,
+                        target_type: "note",
+                        target_id: noteId,
+                        relation_type: "source_of",
+                        created_by: "agent",
+                    });
+                }
+            }
+            if (links.length > 0) {
+                await bulkInsertKnowledgeLinks(ctx.supabase, links);
+            }
+        }
+        catch (err) {
+            process.stderr.write(`[update-memory] knowledge_links sync failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    }
+    // Re-sync wiki-links when content changes
+    if (contentChanged && input.content) {
+        await deleteWikiLinksForNode(ctx.supabase, ctx.userId, "memory", input.memoryId);
+        await syncWikiLinks(ctx.supabase, "memory", input.memoryId, ctx.userId, input.content, updated.vault_id ?? null, ctx.masterKey);
+    }
+    // Re-index embeddings if content changed
+    let indexed = false;
+    let embeddingCount = 0;
+    let indexingReason;
+    if (contentChanged) {
+        const plainContent = input.content
+            ?? await decrypt(existing.encrypted_content, existing.content_iv, ctx.masterKey);
+        const plainSummary = input.summary !== undefined
+            ? input.summary || undefined
+            : existing.encrypted_summary && existing.summary_iv
+                ? await decrypt(existing.encrypted_summary, existing.summary_iv, ctx.masterKey).catch(() => undefined)
+                : undefined;
+        const embeddingConfig = resolveEmbeddingConfig(ctx);
+        if (embeddingConfig) {
+            const base = plainSummary
+                ? `Summary: ${plainSummary.trim()}\n\n${plainContent.trim()}`
+                : plainContent.trim();
+            const chunks = chunkText(base);
+            if (chunks.length > 0) {
+                try {
+                    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}`);
+                    }
+                    // Import replaceMemoryEmbeddings lazily to avoid circular dependency risk
+                    const { replaceMemoryEmbeddings } = await import("../db.js");
+                    const { createHash } = await import("node:crypto");
+                    const contentHash = createHash("sha256")
+                        .update(chunks.map((c) => c.text).join("\n\n"), "utf8")
+                        .digest("hex");
+                    await replaceMemoryEmbeddings(ctx.supabase, {
+                        memoryId: input.memoryId,
+                        userId: ctx.userId,
+                        embeddingModel: embeddingConfig.model,
+                        contentHash,
+                        rows: vectors.map((embedding, i) => ({
+                            chunkIndex: chunks[i]?.index ?? i,
+                            embedding,
+                            tokenCount: estimateTokens(chunks[i]?.text ?? ""),
+                        })),
+                    });
+                    await dbUpdateMemory(ctx.supabase, input.memoryId, ctx.userId, {
+                        indexing_status: "ready",
+                        last_indexed_at: new Date().toISOString(),
+                        indexing_error: null,
+                    });
+                    indexed = true;
+                    embeddingCount = vectors.length;
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message.slice(0, 2000) : "embedding_failed";
+                    await dbUpdateMemory(ctx.supabase, input.memoryId, ctx.userId, {
+                        indexing_status: "failed",
+                        indexing_error: message,
+                    });
+                    indexingReason = message;
+                }
+            }
+        }
+        else {
+            indexingReason = "missing_embedding_api_key";
+        }
+    }
+    const payload = JSON.stringify({
+        memoryId: updated.id,
+        updated: true,
+        contentChanged,
+        indexed,
+        embeddingCount,
+        indexingReason: indexingReason ?? null,
+    });
+    await logMcpUsageEvent({
+        supabase: ctx.supabase,
+        userId: ctx.userId,
+        vaultId: updated.vault_id ?? undefined,
+        operationType: "mcp_update_memory",
+        inputText: input.content,
+        outputText: payload,
+    });
+    return payload;
+}

package/dist/tools/update-memory.js.map

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

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

@@ -0,0 +1,2 @@
+import type { McpContext } from "../auth.js";
+export declare function updateNote(ctx: McpContext, noteId: string, title?: string, content?: string, tags?: string[]): Promise<string>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-note.d.ts","sourceRoot":"","sources":["../../src/tools/update-note.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,wBAAsB,UAAU,CAC9B,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,CAAC,CAmFjB"}

package/dist/tools/update-note.js

@@ -0,0 +1,79 @@
+import { getNote, updateNote as dbUpdateNote, resolvePendingLinks } from "../db.js";
+import { encrypt, decrypt, hashPendingTarget } from "../crypto.js";
+import { generateBlindTokens } from "./blind-index.js";
+import { syncWikiLinks, deleteWikiLinksForNode } from "./wiki-link-sync.js";
+export async function updateNote(ctx, noteId, title, content, tags) {
+    // Verify note exists and belongs to user
+    const note = await getNote(ctx.supabase, ctx.userId, noteId);
+    if (!note) {
+        return JSON.stringify({ success: false, error: "Note not found" });
+    }
+    const updates = {};
+    if (title !== undefined) {
+        const enc = await encrypt(title, ctx.masterKey);
+        updates.encrypted_title = enc.ciphertext;
+        updates.title_iv = enc.iv;
+    }
+    if (content !== undefined) {
+        const htmlContent = content.includes("<")
+            ? content
+            : `<p>${content}</p>`;
+        const enc = await encrypt(htmlContent, ctx.masterKey);
+        updates.encrypted_content = enc.ciphertext;
+        updates.content_iv = enc.iv;
+        updates.embedding_status = "stale";
+    }
+    if (tags !== undefined) {
+        const enc = await encrypt(JSON.stringify(tags), ctx.masterKey);
+        updates.encrypted_tags = enc.ciphertext;
+        updates.tags_iv = enc.iv;
+        // Tags change also makes embeddings stale
+        if (!updates.embedding_status) {
+            updates.embedding_status = "stale";
+        }
+    }
+    if (Object.keys(updates).length === 0) {
+        return JSON.stringify({ success: true, message: "No changes provided" });
+    }
+    // Regenerate blind tokens from all fields (current + updated)
+    if (ctx.mekHex && (title !== undefined || content !== undefined || tags !== undefined)) {
+        try {
+            const currentTitle = title ?? await decrypt(note.encrypted_title, note.title_iv, ctx.masterKey);
+            const currentContent = content ?? await decrypt(note.encrypted_content, note.content_iv, ctx.masterKey);
+            let currentTags = [];
+            if (tags !== undefined) {
+                currentTags = tags;
+            }
+            else if (note.encrypted_tags && note.tags_iv) {
+                try {
+                    currentTags = JSON.parse(await decrypt(note.encrypted_tags, note.tags_iv, ctx.masterKey));
+                }
+                catch { /* ignore */ }
+            }
+            const searchableText = [currentTitle, currentContent, ...currentTags].join(" ");
+            const blindTokens = generateBlindTokens(searchableText, ctx.mekHex);
+            if (blindTokens.length > 0) {
+                updates.blind_tokens = blindTokens;
+            }
+        }
+        catch { /* blind token generation is best-effort */ }
+    }
+    await dbUpdateNote(ctx.supabase, noteId, ctx.userId, updates);
+    // Re-sync wiki-links when content changes
+    if (content !== undefined) {
+        await deleteWikiLinksForNode(ctx.supabase, ctx.userId, "note", noteId);
+        await syncWikiLinks(ctx.supabase, "note", noteId, ctx.userId, content, note.vault_id, ctx.masterKey);
+    }
+    // Resolve pending wiki-links when title changes
+    if (title !== undefined) {
+        try {
+            const titleHash = hashPendingTarget(title);
+            const hashMap = new Map([[titleHash, noteId]]);
+            await resolvePendingLinks(ctx.supabase, ctx.userId, hashMap);
+        }
+        catch {
+            // Best-effort
+        }
+    }
+    return JSON.stringify({ success: true });
+}

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

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

package/dist/tools/vault-instruction-template.d.ts

@@ -0,0 +1,17 @@
+export declare const VAULT_INSTRUCTION_VERSION = 4;
+export interface VaultInstructionTemplate {
+    noteTitle: string;
+    noteContent: string;
+    noteTags: string[];
+    memoryType: string;
+    memorySummary: string;
+    memoryContent: string;
+    importance: number;
+    confidence: number;
+}
+export declare function getVaultInstructionTemplate(vaultName?: string): VaultInstructionTemplate;
+export declare function getVaultInstructionIds(vaultId: string): {
+    noteImportSource: string;
+    noteImportSourceId: string;
+    memoryExternalWriteId: string;
+};

package/dist/tools/vault-instruction-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-instruction-template.d.ts","sourceRoot":"","sources":["../../src/tools/vault-instruction-template.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,2BAA2B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,wBAAwB,CAqExF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM;;;;EAOrD"}

package/dist/tools/vault-instruction-template.js

@@ -0,0 +1,77 @@
+// SYNC NOTE: Keep this file in sync with src/lib/memory/vault-instruction-template.ts
+export const VAULT_INSTRUCTION_VERSION = 4;
+export function getVaultInstructionTemplate(vaultName) {
+    const scopeLabel = vaultName?.trim() ? `for vault "${vaultName.trim()}"` : "for this vault";
+    const noteTitle = "Agent Memory Instructions";
+    const memorySummary = `System instructions v${VAULT_INSTRUCTION_VERSION} ${scopeLabel}.`;
+    // v4: Slimmed to core protocol only. Detailed reference (memory types, relationship
+    // fields, importance guide, etc.) moved to instructions.md default document, which
+    // is returned once per session via session_start instead of on every tool call.
+    const memoryContent = [
+        `ExoVault Memory Protocol v${VAULT_INSTRUCTION_VERSION}`,
+        "",
+        "## Core Protocol",
+        "1. Scope all memory operations to the relevant vaultId.",
+        "2. SEARCH FIRST: Run search_memories before writing to check for existing entries.",
+        "3. Use externalWriteId for idempotency on every write.",
+        "4. Set importance (1-5) and confidence (1-5) on every write.",
+        "5. Extract entities (people, projects, tools) and include them in the entities field.",
+        "6. Link related memories using relatedMemoryIds with appropriate relation types.",
+        "7. When correcting knowledge, create a new memory with supersededById pointing to the old one.",
+        "",
+        "Memory types: fact, skill, preference, constraint, task, episodic, correction.",
+        "Set dedup: true for server-side semantic dedup. Use compact: true on search, then read_memories for full content.",
+        "Include agentId and agentRunId on every write. See instructions.md for full type reference and examples.",
+        "",
+        "## Episodic Memory Quality",
+        "End-of-session episodic memories must capture WHAT was discussed, decided, and accomplished — not tool call stats.",
+        "Good: \"Discussed auth architecture. Decided on JWT with refresh tokens over session cookies. Created Auth Design note and planned OAuth implementation.\"",
+        "Bad: \"Session: 16min, 8 tool calls. Searched: auth. Wrote 2 items.\"",
+        "Include: topics explored, decisions made, outcomes/artifacts produced, unresolved questions for next session.",
+    ].join("\n");
+    const noteContent = [
+        "# Agent Memory Instructions",
+        "",
+        `Instruction version: ${VAULT_INSTRUCTION_VERSION}`,
+        "",
+        "Use this protocol whenever an agent reads or writes long-term memory:",
+        "",
+        "1. Set `vaultId` on every memory call.",
+        "2. Read-first workflow:",
+        "   - run semantic/keyword memory search for the task",
+        "   - use entity search to find related knowledge",
+        "   - read the top matching memory entries before planning actions",
+        "3. Write workflow:",
+        "   - use the correct memoryType (fact, skill, preference, constraint, task, episodic, correction)",
+        "   - include `externalWriteId` for idempotency",
+        "   - set `importance` and `confidence` explicitly (1-5)",
+        "   - extract and include `entities` for cross-linking",
+        "   - link to related memories with `relatedMemoryIds`",
+        "   - track source notes with `sourceNoteIds`",
+        "4. Correction workflow:",
+        "   - when knowledge changes, create a new memory with type `correction`",
+        "   - set `supersededById` on the new memory to point to the old one",
+        "   - the system will automatically archive the old memory",
+        "5. Exploration workflow:",
+        "   - use `get_related_memories` to traverse the knowledge graph",
+        "   - use entity search to find all memories about a topic",
+    ].join("\n");
+    return {
+        noteTitle,
+        noteContent,
+        noteTags: ["system", "instruction", "memory-protocol", `v${VAULT_INSTRUCTION_VERSION}`],
+        memoryType: "instruction",
+        memorySummary,
+        memoryContent,
+        importance: 5,
+        confidence: 5,
+    };
+}
+export function getVaultInstructionIds(vaultId) {
+    const base = `system:vault:${vaultId}:instruction:v${VAULT_INSTRUCTION_VERSION}`;
+    return {
+        noteImportSource: "system_seed",
+        noteImportSourceId: `${base}:note`,
+        memoryExternalWriteId: `${base}:memory`,
+    };
+}

package/dist/tools/vault-instruction-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-instruction-template.js","sourceRoot":"","sources":["../../src/tools/vault-instruction-template.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAa3C,MAAM,UAAU,2BAA2B,CAAC,SAAkB;IAC5D,MAAM,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC5F,MAAM,SAAS,GAAG,2BAA2B,CAAC;IAC9C,MAAM,aAAa,GAAG,wBAAwB,yBAAyB,IAAI,UAAU,GAAG,CAAC;IAEzF,oFAAoF;IACpF,mFAAmF;IACnF,gFAAgF;IAChF,MAAM,aAAa,GAAG;QACpB,6BAA6B,yBAAyB,EAAE;QACxD,EAAE;QACF,kBAAkB;QAClB,yDAAyD;QACzD,oFAAoF;QACpF,wDAAwD;QACxD,8DAA8D;QAC9D,uFAAuF;QACvF,kFAAkF;QAClF,gGAAgG;QAChG,EAAE;QACF,gFAAgF;QAChF,mHAAmH;QACnH,0GAA0G;QAC1G,EAAE;QACF,4BAA4B;QAC5B,oHAAoH;QACpH,4JAA4J;QAC5J,uEAAuE;QACvE,+GAA+G;KAChH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,WAAW,GAAG;QAClB,6BAA6B;QAC7B,EAAE;QACF,wBAAwB,yBAAyB,EAAE;QACnD,EAAE;QACF,uEAAuE;QACvE,EAAE;QACF,wCAAwC;QACxC,yBAAyB;QACzB,sDAAsD;QACtD,kDAAkD;QAClD,mEAAmE;QACnE,oBAAoB;QACpB,mGAAmG;QACnG,gDAAgD;QAChD,yDAAyD;QACzD,uDAAuD;QACvD,uDAAuD;QACvD,8CAA8C;QAC9C,yBAAyB;QACzB,yEAAyE;QACzE,qEAAqE;QACrE,2DAA2D;QAC3D,0BAA0B;QAC1B,iEAAiE;QACjE,2DAA2D;KAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACL,SAAS;QACT,WAAW;QACX,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,IAAI,yBAAyB,EAAE,CAAC;QACvF,UAAU,EAAE,aAAa;QACzB,aAAa;QACb,aAAa;QACb,UAAU,EAAE,CAAC;QACb,UAAU,EAAE,CAAC;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,IAAI,GAAG,gBAAgB,OAAO,iBAAiB,yBAAyB,EAAE,CAAC;IACjF,OAAO;QACL,gBAAgB,EAAE,aAAa;QAC/B,kBAAkB,EAAE,GAAG,IAAI,OAAO;QAClC,qBAAqB,EAAE,GAAG,IAAI,SAAS;KACxC,CAAC;AACJ,CAAC"}

package/dist/tools/wiki-link-sync.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Write-time wiki-link parsing for memories and notes.
+ *
+ * Extracts [[wiki-links]] from plaintext content and creates knowledge_links
+ * entries. Resolved links point to existing notes; unresolved links are stored
+ * as pending with a SHA-256 hash for later resolution.
+ *
+ * Best-effort: errors are logged but never fail the parent write operation.
+ */
+import type { SupabaseClient } from "@supabase/supabase-js";
+type NodeType = "note" | "memory";
+export interface WikiLinkSyncResult {
+    resolved: number;
+    pending: number;
+}
+/**
+ * Parse [[wiki-links]] from plaintext content and create knowledge_links rows.
+ *
+ * @param supabase - Supabase client (authenticated)
+ * @param sourceType - "note" or "memory"
+ * @param sourceId - ID of the source node
+ * @param userId - Owner user ID
+ * @param plaintext - Decrypted content to parse for wiki-links
+ * @param vaultId - Vault scope for note title resolution (null = all vaults)
+ * @param masterKey - CryptoKey for decrypting note titles; if undefined, all links become pending
+ */
+export declare function syncWikiLinks(supabase: SupabaseClient, sourceType: NodeType, sourceId: string, userId: string, plaintext: string, vaultId?: string | null, masterKey?: CryptoKey): Promise<WikiLinkSyncResult>;
+/**
+ * Delete only wiki_link-type outgoing links for a node.
+ * Used before re-syncing when content changes (update operations).
+ * Best-effort: errors are logged but do not propagate.
+ */
+export declare function deleteWikiLinksForNode(supabase: SupabaseClient, userId: string, nodeType: NodeType, nodeId: string): Promise<void>;
+export {};

package/dist/tools/wiki-link-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-link-sync.d.ts","sourceRoot":"","sources":["../../src/tools/wiki-link-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,KAAK,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAQlC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,QAAQ,EACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,EACvB,SAAS,CAAC,EAAE,SAAS,GACpB,OAAO,CAAC,kBAAkB,CAAC,CAsF7B;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/tools/wiki-link-sync.js

@@ -0,0 +1,132 @@
+/**
+ * Write-time wiki-link parsing for memories and notes.
+ *
+ * Extracts [[wiki-links]] from plaintext content and creates knowledge_links
+ * entries. Resolved links point to existing notes; unresolved links are stored
+ * as pending with a SHA-256 hash for later resolution.
+ *
+ * Best-effort: errors are logged but never fail the parent write operation.
+ */
+import { extractWikiLinks, normalizeWikiLinkTarget } from "../wiki-link-parser.js";
+import { decrypt, hashPendingTarget } from "../crypto.js";
+import { getNotes, bulkInsertKnowledgeLinks } from "../db.js";
+/** Placeholder UUID for pending links (target not yet resolved). */
+const PENDING_TARGET_ID = "00000000-0000-0000-0000-000000000000";
+/** Maximum number of note titles to load for resolution. */
+const NOTE_TITLE_LIMIT = 500;
+/**
+ * Parse [[wiki-links]] from plaintext content and create knowledge_links rows.
+ *
+ * @param supabase - Supabase client (authenticated)
+ * @param sourceType - "note" or "memory"
+ * @param sourceId - ID of the source node
+ * @param userId - Owner user ID
+ * @param plaintext - Decrypted content to parse for wiki-links
+ * @param vaultId - Vault scope for note title resolution (null = all vaults)
+ * @param masterKey - CryptoKey for decrypting note titles; if undefined, all links become pending
+ */
+export async function syncWikiLinks(supabase, sourceType, sourceId, userId, plaintext, vaultId, masterKey) {
+    const wikiLinks = extractWikiLinks(plaintext);
+    if (wikiLinks.length === 0)
+        return { resolved: 0, pending: 0 };
+    // Deduplicate by normalized target name
+    const seen = new Set();
+    const uniqueTargets = [];
+    for (const wl of wikiLinks) {
+        const normalized = normalizeWikiLinkTarget(wl.target);
+        if (!normalized || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        uniqueTargets.push(normalized);
+    }
+    if (uniqueTargets.length === 0)
+        return { resolved: 0, pending: 0 };
+    // Build a normalized-title → noteId map by decrypting existing note titles
+    const titleMap = new Map();
+    if (masterKey) {
+        try {
+            const noteRows = await getNotes(supabase, userId, vaultId ?? undefined, NOTE_TITLE_LIMIT);
+            for (const note of noteRows) {
+                try {
+                    const title = await decrypt(note.encrypted_title, note.title_iv, masterKey);
+                    const normalized = normalizeWikiLinkTarget(title);
+                    if (normalized) {
+                        titleMap.set(normalized, note.id);
+                    }
+                }
+                catch {
+                    // Skip notes that fail to decrypt
+                }
+            }
+        }
+        catch {
+            // If note fetch fails entirely, all links become pending — that's fine
+        }
+    }
+    // Resolve each unique wiki-link target
+    const links = [];
+    let resolved = 0;
+    let pending = 0;
+    for (const normalized of uniqueTargets) {
+        const noteId = titleMap.get(normalized);
+        if (noteId) {
+            links.push({
+                user_id: userId,
+                source_type: sourceType,
+                source_id: sourceId,
+                target_type: "note",
+                target_id: noteId,
+                relation_type: "wiki_link",
+                is_pending: false,
+                created_by: "wiki-link-sync",
+            });
+            resolved++;
+        }
+        else {
+            // Find the original target name for hashing (before normalization)
+            const originalTarget = wikiLinks.find((wl) => normalizeWikiLinkTarget(wl.target) === normalized)?.target ?? normalized;
+            links.push({
+                user_id: userId,
+                source_type: sourceType,
+                source_id: sourceId,
+                target_type: "note",
+                target_id: PENDING_TARGET_ID,
+                relation_type: "wiki_link",
+                is_pending: true,
+                pending_target_hash: hashPendingTarget(originalTarget),
+                created_by: "wiki-link-sync",
+            });
+            pending++;
+        }
+    }
+    try {
+        await bulkInsertKnowledgeLinks(supabase, links);
+    }
+    catch (err) {
+        process.stderr.write(`[wiki-link-sync] bulkInsert failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        return { resolved: 0, pending: 0 };
+    }
+    return { resolved, pending };
+}
+/**
+ * Delete only wiki_link-type outgoing links for a node.
+ * Used before re-syncing when content changes (update operations).
+ * Best-effort: errors are logged but do not propagate.
+ */
+export async function deleteWikiLinksForNode(supabase, userId, nodeType, nodeId) {
+    try {
+        const { error } = await supabase
+            .from("knowledge_links")
+            .delete()
+            .eq("user_id", userId)
+            .eq("source_type", nodeType)
+            .eq("source_id", nodeId)
+            .eq("relation_type", "wiki_link");
+        if (error) {
+            process.stderr.write(`[wiki-link-sync] deleteWikiLinks failed: ${error.message}\n`);
+        }
+    }
+    catch (err) {
+        process.stderr.write(`[wiki-link-sync] deleteWikiLinks error: ${err instanceof Error ? err.message : String(err)}\n`);
+    }
+}

package/dist/tools/wiki-link-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-link-sync.js","sourceRoot":"","sources":["../../src/tools/wiki-link-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,wBAAwB,EAAyB,MAAM,UAAU,CAAC;AAIrF,oEAAoE;AACpE,MAAM,iBAAiB,GAAG,sCAAsC,CAAC;AAEjE,4DAA4D;AAC5D,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAO7B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAwB,EACxB,UAAoB,EACpB,QAAgB,EAChB,MAAc,EACd,SAAiB,EACjB,OAAuB,EACvB,SAAqB;IAErB,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAE/D,wCAAwC;IACxC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,uBAAuB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QAClD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAEnE,2EAA2E;IAC3E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,IAAI,SAAS,EAAE,gBAAgB,CAAC,CAAC;YAC1F,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;oBAC5E,MAAM,UAAU,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;oBAClD,IAAI,UAAU,EAAE,CAAC;wBACf,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,kCAAkC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;QACzE,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,MAAM,KAAK,GAAmD,EAAE,CAAC;IACjE,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,UAAU,IAAI,aAAa,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,MAAM;gBACf,WAAW,EAAE,UAAU;gBACvB,SAAS,EAAE,QAAQ;gBACnB,WAAW,EAAE,MAAM;gBACnB,SAAS,EAAE,MAAM;gBACjB,aAAa,EAAE,WAA+B;gBAC9C,UAAU,EAAE,KAAK;gBACjB,UAAU,EAAE,gBAAgB;aAC7B,CAAC,CAAC;YACH,QAAQ,EAAE,CAAC;QACb,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,CACnC,CAAC,EAAE,EAAE,EAAE,CAAC,uBAAuB,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,UAAU,CAC1D,EAAE,MAAM,IAAI,UAAU,CAAC;YAExB,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,MAAM;gBACf,WAAW,EAAE,UAAU;gBACvB,SAAS,EAAE,QAAQ;gBACnB,WAAW,EAAE,MAAM;gBACnB,SAAS,EAAE,iBAAiB;gBAC5B,aAAa,EAAE,WAA+B;gBAC9C,UAAU,EAAE,IAAI;gBAChB,mBAAmB,EAAE,iBAAiB,CAAC,cAAc,CAAC;gBACtD,UAAU,EAAE,gBAAgB;aAC7B,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,wBAAwB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uCAAuC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC5F,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACrC,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAwB,EACxB,MAAc,EACd,QAAkB,EAClB,MAAc;IAEd,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ;aAC7B,IAAI,CAAC,iBAAiB,CAAC;aACvB,MAAM,EAAE;aACR,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;aACrB,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC;aAC3B,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;aACvB,EAAE,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QACpC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4CAA4C,KAAK,CAAC,OAAO,IAAI,CAC9D,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2CAA2C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAChG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/wrap-tool-handler.d.ts

@@ -0,0 +1,8 @@
+import type { ToolResponse } from "../auto-session.js";
+/**
+ * Wraps a tool handler that returns a plain string result.
+ * Handles try/catch and ok/err wrapping so tool handlers can focus on logic.
+ *
+ * Composes with `auto.wrap()` — both accept and return `(T) => Promise<ToolResponse>`.
+ */
+export declare function wrapToolHandler<T>(handler: (args: T) => Promise<string>): (args: T) => Promise<ToolResponse>;

package/dist/tools/wrap-tool-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-tool-handler.d.ts","sourceRoot":"","sources":["../../src/tools/wrap-tool-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,GACpC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAapC"}