exovault-mcp-server 1.0.0

package/dist/tools/search-and-read.js

@@ -0,0 +1,208 @@
+import { getNotes, getNotesByIds, getVault, matchNoteEmbeddings } from "../db.js";
+import { decrypt } from "../crypto.js";
+import { stripHtml } from "../strip-html.js";
+import { STOPWORDS } from "../stopwords.js";
+import { generateQueryEmbedding } from "../openai.js";
+import { logMcpUsageEvent } from "../usage.js";
+/**
+ * Combined search + full read: runs hybrid search (70% semantic + 30% keyword),
+ * then returns the full decrypted content of the top matches.
+ *
+ * Fallback chain:
+ *   1. Hybrid (semantic + keyword) — if OpenAI key is available
+ *   2. Keyword-only — if no OpenAI key or semantic fails
+ *   3. Recency-fallback — if no keyword matches at all
+ */
+export async function searchAndRead(ctx, query, maxNotes = 5) {
+    let embeddingTokens = 0;
+    // ── Keyword search ──────────────────────────────────────────────────────────
+    const terms = query
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((t) => t.length > 2 && !STOPWORDS.has(t));
+    // Fetch all non-trashed notes for keyword scoring
+    const allNotes = await getNotes(ctx.supabase, ctx.userId, undefined, 500);
+    // Decrypt all notes for keyword scoring (also reusable for final output)
+    const decryptedMap = new Map();
+    await Promise.all(allNotes.map(async (n) => {
+        const [title, content] = await Promise.all([
+            decrypt(n.encrypted_title, n.title_iv, ctx.masterKey),
+            decrypt(n.encrypted_content, n.content_iv, ctx.masterKey),
+        ]);
+        let tags = [];
+        if (n.encrypted_tags && n.tags_iv) {
+            try {
+                const tagsJson = await decrypt(n.encrypted_tags, n.tags_iv, ctx.masterKey);
+                tags = JSON.parse(tagsJson);
+            }
+            catch {
+                // ignore
+            }
+        }
+        decryptedMap.set(n.id, { title, content, tags, note: n });
+    }));
+    // Score by keyword (3x title, 2x tags, 1x content)
+    const keywordScores = new Map();
+    if (terms.length > 0) {
+        for (const [noteId, dec] of decryptedMap) {
+            const titleLower = dec.title.toLowerCase();
+            const tagsLower = dec.tags.map((t) => t.toLowerCase());
+            const contentLower = stripHtml(dec.content).toLowerCase();
+            let score = 0;
+            for (const term of terms) {
+                if (titleLower.includes(term))
+                    score += 3;
+                if (tagsLower.some((tag) => tag.includes(term)))
+                    score += 2;
+                if (contentLower.includes(term))
+                    score += 1;
+            }
+            if (score > 0)
+                keywordScores.set(noteId, score);
+        }
+    }
+    // ── Semantic search (if available) ──────────────────────────────────────────
+    const semanticScores = new Map();
+    if (ctx.openaiApiKey) {
+        try {
+            embeddingTokens = Math.ceil(query.length / 4);
+            const embedding = await generateQueryEmbedding(query, ctx.openaiApiKey);
+            const matches = await matchNoteEmbeddings(ctx.supabase, embedding, ctx.userId, 0.4, // lower threshold for hybrid — keyword compensates
+            maxNotes * 5);
+            // Deduplicate to note level — keep best similarity
+            for (const m of matches) {
+                const existing = semanticScores.get(m.note_id);
+                if (existing === undefined || m.similarity > existing) {
+                    semanticScores.set(m.note_id, m.similarity);
+                }
+            }
+        }
+        catch {
+            // Semantic search failed — fall through to keyword-only
+        }
+    }
+    // ── Merge: 70% semantic + 30% keyword ───────────────────────────────────────
+    const combinedScores = new Map();
+    const allCandidateIds = new Set([
+        ...keywordScores.keys(),
+        ...semanticScores.keys(),
+    ]);
+    if (semanticScores.size > 0 && keywordScores.size > 0) {
+        // Hybrid mode
+        const maxSemantic = Math.max(...semanticScores.values());
+        const maxKeyword = Math.max(...keywordScores.values());
+        for (const noteId of allCandidateIds) {
+            let score = 0;
+            const sem = semanticScores.get(noteId);
+            if (sem !== undefined && maxSemantic > 0) {
+                score += (sem / maxSemantic) * 0.7;
+            }
+            const kw = keywordScores.get(noteId);
+            if (kw !== undefined && maxKeyword > 0) {
+                score += (kw / maxKeyword) * 0.3;
+            }
+            combinedScores.set(noteId, score);
+        }
+    }
+    else if (keywordScores.size > 0) {
+        // Keyword-only fallback
+        for (const [id, score] of keywordScores) {
+            combinedScores.set(id, score);
+        }
+    }
+    else if (semanticScores.size > 0) {
+        // Semantic-only fallback
+        for (const [id, score] of semanticScores) {
+            combinedScores.set(id, score);
+        }
+    }
+    // ── Select top notes ────────────────────────────────────────────────────────
+    let topIds;
+    if (combinedScores.size > 0) {
+        topIds = Array.from(combinedScores.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, maxNotes)
+            .map(([id]) => id);
+    }
+    else {
+        // Recency fallback — return most recently updated notes
+        topIds = allNotes.slice(0, maxNotes).map((n) => n.id);
+    }
+    // ── Build full-content results ──────────────────────────────────────────────
+    // Some IDs from semantic search might not be in decryptedMap (if >500 notes).
+    // Fetch any missing notes.
+    const missingIds = topIds.filter((id) => !decryptedMap.has(id));
+    if (missingIds.length > 0) {
+        const extraNotes = await getNotesByIds(ctx.supabase, ctx.userId, missingIds);
+        await Promise.all(extraNotes.map(async (n) => {
+            const [title, content] = await Promise.all([
+                decrypt(n.encrypted_title, n.title_iv, ctx.masterKey),
+                decrypt(n.encrypted_content, n.content_iv, ctx.masterKey),
+            ]);
+            let tags = [];
+            if (n.encrypted_tags && n.tags_iv) {
+                try {
+                    const tagsJson = await decrypt(n.encrypted_tags, n.tags_iv, ctx.masterKey);
+                    tags = JSON.parse(tagsJson);
+                }
+                catch {
+                    // ignore
+                }
+            }
+            decryptedMap.set(n.id, { title, content, tags, note: n });
+        }));
+    }
+    // Cache vault names
+    const vaultNameCache = new Map();
+    async function getVaultName(vaultId) {
+        const cached = vaultNameCache.get(vaultId);
+        if (cached !== undefined)
+            return cached;
+        const vault = await getVault(ctx.supabase, ctx.userId, vaultId);
+        let name = "";
+        if (vault) {
+            name = await decrypt(vault.encrypted_name, vault.name_iv, ctx.masterKey);
+        }
+        vaultNameCache.set(vaultId, name);
+        return name;
+    }
+    const results = await Promise.all(topIds.map(async (noteId) => {
+        const dec = decryptedMap.get(noteId);
+        if (!dec)
+            return null;
+        const vaultName = await getVaultName(dec.note.vault_id);
+        return {
+            id: noteId,
+            title: dec.title,
+            content: dec.content,
+            tags: dec.tags,
+            vaultName,
+            vaultId: dec.note.vault_id,
+            score: combinedScores.get(noteId) ?? 0,
+            createdAt: dec.note.created_at,
+            updatedAt: dec.note.updated_at,
+        };
+    }));
+    const searchMode = semanticScores.size > 0 && keywordScores.size > 0
+        ? "hybrid"
+        : semanticScores.size > 0
+            ? "semantic-only"
+            : keywordScores.size > 0
+                ? "keyword-only"
+                : "recency-fallback";
+    const payload = JSON.stringify({
+        searchMode,
+        totalCandidates: allCandidateIds.size,
+        notes: results.filter(Boolean),
+    }, null, 2);
+    await logMcpUsageEvent({
+        supabase: ctx.supabase,
+        userId: ctx.userId,
+        operationType: "mcp_search_and_read",
+        modelId: embeddingTokens > 0 ? "text-embedding-3-small" : undefined,
+        inputText: query,
+        outputText: payload,
+        embeddingTokens,
+    });
+    return payload;
+}

package/dist/tools/search-and-read.js.map

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

package/dist/tools/search-memories.d.ts

@@ -0,0 +1,13 @@
+import type { McpContext } from "../auth.js";
+export declare function searchMemories(ctx: McpContext, input: {
+    query: string;
+    topK?: number;
+    threshold?: number;
+    vaultId?: string;
+    memoryType?: string;
+    includeArchived?: boolean;
+    entity?: string;
+    compact?: boolean;
+    decayHalfLife?: number;
+    diversity?: number;
+}): Promise<string>;

package/dist/tools/search-memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-memories.d.ts","sourceRoot":"","sources":["../../src/tools/search-memories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkD7C,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,KAAK,EAAE;IACL,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,MAAM,CAAC,CA0RjB"}

package/dist/tools/search-memories.js

@@ -0,0 +1,272 @@
+import { getMemoriesByIds, getMemories, matchMemoryEmbeddings, matchMemoriesByBlindTokens, searchMemoriesByEntity, getKnowledgeGraph, touchMemories, getEmbeddingsForMemories, } from "../db.js";
+import { decryptMemoryFields } from "./decrypt-helpers.js";
+import { generateQueryEmbedding } from "../openai.js";
+import { logMcpUsageEvent } from "../usage.js";
+import { resolveEmbeddingConfig } from "../embedding-config.js";
+import { generateBlindTokens } from "./blind-index.js";
+import { fuseWithRRFScored } from "./rrf.js";
+import { applyTemporalDecayBatch, } from "./temporal-decay.js";
+import { selectMMR } from "./mmr.js";
+const FALLBACK_CONTENT_PREVIEW_CHARS = 500;
+const COMPACT_CONTENT_CHARS = 200;
+// RRF signal weights
+const WEIGHT_SEMANTIC = 1.0;
+const WEIGHT_BLIND_INDEX = 0.8;
+const WEIGHT_GRAPH = 0.6;
+// Graph expansion: how many initial results to expand, and relation weights
+const GRAPH_EXPAND_TOP_N = 5;
+const GRAPH_RELATION_WEIGHTS = {
+    refines: 1.0,
+    derived_from: 0.9,
+    part_of: 0.9,
+    supersedes: 0.8,
+    references: 0.7,
+    source_of: 0.7,
+    wiki_link: 0.6,
+    contradicts: 0.5,
+    manual: 0.5,
+};
+function clip(text, maxChars) {
+    return text.length <= maxChars ? text : `${text.slice(0, maxChars)}...`;
+}
+export async function searchMemories(ctx, input) {
+    const topK = input.topK ?? 10;
+    const threshold = input.threshold ?? 0.4;
+    // Entity-based search: use JSONB containment instead of semantic search
+    if (input.entity) {
+        const entityResults = await searchMemoriesByEntity(ctx.supabase, ctx.userId, input.entity, topK);
+        const filtered = entityResults
+            .filter((m) => (input.vaultId ? m.vault_id === input.vaultId : true))
+            .filter((m) => (input.includeArchived ? true : !m.is_archived))
+            .filter((m) => (input.memoryType ? m.memory_type === input.memoryType : true));
+        const results = await Promise.all(filtered.map(async (m) => {
+            const { content, summary } = await decryptMemoryFields(m, ctx.masterKey);
+            const displayContent = input.compact
+                ? clip(content, COMPACT_CONTENT_CHARS)
+                : content;
+            return {
+                id: m.id,
+                memoryType: m.memory_type,
+                content: displayContent,
+                contentTruncated: input.compact ? content.length > COMPACT_CONTENT_CHARS : false,
+                summary,
+                similarity: 0,
+                importance: m.importance,
+                confidence: m.confidence,
+                vaultId: m.vault_id,
+                agentId: m.agent_id,
+                indexingStatus: m.indexing_status,
+                relatedMemoryIds: m.related_memory_ids,
+                sourceNoteIds: m.source_note_ids,
+                supersededById: m.superseded_by_id,
+                entities: m.entities,
+                updatedAt: m.updated_at,
+            };
+        }));
+        // Track access for returned results (fire-and-forget)
+        touchMemories(ctx.supabase, ctx.userId, results.map((r) => r.id));
+        const payload = JSON.stringify({
+            searchMode: "entity",
+            compact: input.compact ?? false,
+            entity: input.entity,
+            memories: results,
+        }, null, 2);
+        await logMcpUsageEvent({
+            supabase: ctx.supabase,
+            userId: ctx.userId,
+            operationType: "mcp_search_memories",
+            inputText: input.entity,
+            outputText: payload,
+        });
+        return payload;
+    }
+    let embeddingTokens = 0;
+    const semanticIds = [];
+    const semanticScores = new Map();
+    const blindIds = [];
+    let semanticError = null;
+    const embeddingConfig = resolveEmbeddingConfig(ctx);
+    // ── Signal 1 + Signal 2: run in parallel ──────────────────────────────
+    const semanticPromise = (async () => {
+        if (!embeddingConfig)
+            return;
+        try {
+            embeddingTokens = Math.ceil(input.query.length / 4);
+            const queryEmbedding = await generateQueryEmbedding(input.query, embeddingConfig.apiKey, {
+                baseUrl: embeddingConfig.baseUrl,
+                model: embeddingConfig.model,
+            });
+            const matches = await matchMemoryEmbeddings(ctx.supabase, queryEmbedding, ctx.userId, threshold, topK * 4);
+            // De-dup by memory_id (keep highest similarity)
+            const best = new Map();
+            for (const m of matches) {
+                const existing = best.get(m.memory_id);
+                if (existing === undefined || m.similarity > existing) {
+                    best.set(m.memory_id, m.similarity);
+                }
+            }
+            const sorted = Array.from(best.entries()).sort((a, b) => b[1] - a[1]);
+            for (const [id, score] of sorted) {
+                semanticScores.set(id, score);
+            }
+            semanticIds.push(...sorted.map(([id]) => id));
+        }
+        catch (err) {
+            process.stderr.write(`[search-memories] Semantic search error: ${err instanceof Error ? err.message : String(err)}\n`);
+            semanticError = "embedding_unavailable";
+        }
+    })();
+    const blindPromise = (async () => {
+        if (!ctx.mekHex)
+            return;
+        try {
+            const queryTokenHashes = generateBlindTokens(input.query, ctx.mekHex);
+            if (queryTokenHashes.length === 0)
+                return;
+            const matches = await matchMemoriesByBlindTokens(ctx.supabase, queryTokenHashes, ctx.userId, input.vaultId, topK * 2, input.includeArchived ?? false);
+            blindIds.push(...matches.map((m) => m.memory_id));
+        }
+        catch (err) {
+            process.stderr.write(`[search-memories] Blind index search error: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    })();
+    await Promise.all([semanticPromise, blindPromise]);
+    // ── Signal 3: Graph expansion on top-N unique results from signals 1+2 ─
+    const graphIds = [];
+    const initialHits = new Set([...semanticIds, ...blindIds]);
+    const seedIds = [...initialHits].slice(0, GRAPH_EXPAND_TOP_N);
+    if (seedIds.length > 0) {
+        try {
+            const graphResults = await Promise.all(seedIds.map((id) => getKnowledgeGraph(ctx.supabase, ctx.userId, "memory", id, 1, 10)));
+            // Collect neighbor memory IDs ranked by relation weight
+            const neighborScores = new Map();
+            for (const neighbors of graphResults) {
+                for (const n of neighbors) {
+                    if (n.node_type !== "memory" || initialHits.has(n.node_id))
+                        continue;
+                    const weight = GRAPH_RELATION_WEIGHTS[n.relation] ?? 0.5;
+                    const current = neighborScores.get(n.node_id) ?? 0;
+                    neighborScores.set(n.node_id, Math.max(current, weight));
+                }
+            }
+            graphIds.push(...Array.from(neighborScores.entries())
+                .sort((a, b) => b[1] - a[1])
+                .map(([id]) => id));
+        }
+        catch (err) {
+            process.stderr.write(`[search-memories] Graph expansion error: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    }
+    // ── RRF Fusion + Temporal Decay ──────────────────────────────────────
+    let rankedIds = [];
+    let searchMode = "hybrid";
+    const halfLife = input.decayHalfLife ?? 30;
+    const hasSignals = semanticIds.length > 0 || blindIds.length > 0;
+    if (hasSignals) {
+        const lists = [];
+        if (semanticIds.length > 0)
+            lists.push({ ids: semanticIds, weight: WEIGHT_SEMANTIC });
+        if (blindIds.length > 0)
+            lists.push({ ids: blindIds, weight: WEIGHT_BLIND_INDEX });
+        if (graphIds.length > 0)
+            lists.push({ ids: graphIds, weight: WEIGHT_GRAPH });
+        // Get scored candidates — fetch topK*2 for decay re-ranking headroom
+        const rrfScored = fuseWithRRFScored(lists).slice(0, topK * 2);
+        searchMode = lists.length === 1 && semanticIds.length > 0 ? "semantic" : "hybrid";
+        // Fetch candidate rows for updatedAt + importance
+        const candidateIds = rrfScored.map((r) => r.id);
+        const candidateRows = await getMemoriesByIds(ctx.supabase, ctx.userId, candidateIds);
+        const candidateMap = new Map(candidateRows.map((r) => [r.id, r]));
+        // Build scored candidates and apply temporal decay
+        const scoredCandidates = rrfScored
+            .filter((r) => candidateMap.has(r.id))
+            .map((r) => {
+            const row = candidateMap.get(r.id);
+            return {
+                id: r.id,
+                score: r.score,
+                updatedAt: new Date(row.updated_at),
+                importance: row.importance,
+            };
+        });
+        const decayed = applyTemporalDecayBatch(scoredCandidates, halfLife);
+        // MMR diversity re-ranking
+        const diversityLambda = input.diversity ?? 0.7;
+        const decayedTop = decayed.slice(0, Math.max(topK, 20));
+        const decayedScoreMap = new Map(decayedTop.map((r) => [r.id, r.score]));
+        const decayedIds = decayedTop.map((r) => r.id);
+        const embeddingRows = await getEmbeddingsForMemories(ctx.supabase, ctx.userId, decayedIds);
+        const embeddingMap = new Map(embeddingRows.map((r) => [r.memory_id, r.embedding]));
+        const mmrCandidates = decayedIds.map((id) => ({
+            id,
+            relevanceScore: decayedScoreMap.get(id) ?? 0,
+            embedding: embeddingMap.get(id) ?? null,
+        }));
+        const mmrResults = selectMMR(mmrCandidates, topK, diversityLambda);
+        rankedIds = mmrResults.map((r) => r.id);
+    }
+    else {
+        searchMode = "fallback-recency";
+        const recent = await getMemories(ctx.supabase, ctx.userId, {
+            vaultId: input.vaultId,
+            includeArchived: input.includeArchived,
+            limit: topK,
+        });
+        rankedIds = recent
+            .filter((m) => (input.memoryType ? m.memory_type === input.memoryType : true))
+            .map((m) => m.id);
+    }
+    const memories = await getMemoriesByIds(ctx.supabase, ctx.userId, rankedIds);
+    const byId = new Map(memories.map((m) => [m.id, m]));
+    const ordered = rankedIds
+        .map((id) => byId.get(id))
+        .filter((m) => !!m)
+        .filter((m) => (input.vaultId ? m.vault_id === input.vaultId : true))
+        .filter((m) => (input.includeArchived ? true : !m.is_archived))
+        .filter((m) => (input.memoryType ? m.memory_type === input.memoryType : true));
+    const results = await Promise.all(ordered.map(async (m) => {
+        const { content, summary } = await decryptMemoryFields(m, ctx.masterKey);
+        const shouldClip = input.compact || searchMode === "fallback-recency";
+        const clipLimit = input.compact ? COMPACT_CONTENT_CHARS : FALLBACK_CONTENT_PREVIEW_CHARS;
+        return {
+            id: m.id,
+            memoryType: m.memory_type,
+            content: shouldClip ? clip(content, clipLimit) : content,
+            contentTruncated: shouldClip && content.length > clipLimit,
+            summary,
+            similarity: semanticScores.get(m.id) ?? 0,
+            importance: m.importance,
+            confidence: m.confidence,
+            vaultId: m.vault_id,
+            agentId: m.agent_id,
+            indexingStatus: m.indexing_status,
+            relatedMemoryIds: m.related_memory_ids,
+            sourceNoteIds: m.source_note_ids,
+            supersededById: m.superseded_by_id,
+            entities: m.entities,
+            updatedAt: m.updated_at,
+        };
+    }));
+    // Track access for returned results (fire-and-forget)
+    touchMemories(ctx.supabase, ctx.userId, results.map((r) => r.id));
+    const payload = JSON.stringify({
+        searchMode,
+        compact: input.compact ?? false,
+        threshold,
+        semanticMatchCount: semanticIds.length,
+        blindIndexMatchCount: blindIds.length,
+        graphExpansionCount: graphIds.length,
+        semanticError,
+        memories: results,
+    }, null, 2);
+    await logMcpUsageEvent({
+        supabase: ctx.supabase,
+        userId: ctx.userId,
+        operationType: "mcp_search_memories",
+        modelId: embeddingTokens > 0 ? embeddingConfig?.model : undefined,
+        inputText: input.query,
+        outputText: payload,
+        embeddingTokens,
+    });
+    return payload;
+}

package/dist/tools/search-memories.js.map

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

package/dist/tools/search-notes.d.ts

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

package/dist/tools/search-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-notes.d.ts","sourceRoot":"","sources":["../../src/tools/search-notes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAsD7C,wBAAsB,WAAW,CAC/B,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,SAAK,GACT,OAAO,CAAC,MAAM,CAAC,CA0EjB"}

package/dist/tools/search-notes.js

@@ -0,0 +1,94 @@
+import { getNotes, getNotesByIds, matchNotesByBlindTokens } from "../db.js";
+import { stripHtml } from "../strip-html.js";
+import { STOPWORDS } from "../stopwords.js";
+import { generateBlindTokens } from "./blind-index.js";
+import { decryptNoteFields } from "./decrypt-helpers.js";
+/**
+ * Parse a raw query into normalized search terms (lowercase, no stopwords, min 3 chars).
+ * NOTE: Keep in sync with src/lib/search/keyword-search.ts parseSearchTerms()
+ */
+function parseSearchTerms(query) {
+    return query
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((t) => t.length > 2 && !STOPWORDS.has(t));
+}
+/**
+ * Score a note against pre-processed search terms.
+ * Weighted: title 3x, tags 2x, content 1x.
+ * NOTE: Keep scoring logic in sync with src/lib/search/keyword-search.ts scoreNote()
+ */
+function scoreNote(terms, title, tags, content) {
+    const titleLower = title.toLowerCase();
+    const tagsLower = tags.map((t) => t.toLowerCase());
+    const contentLower = stripHtml(content).toLowerCase();
+    let score = 0;
+    const matchedFields = new Set();
+    for (const term of terms) {
+        if (titleLower.includes(term)) {
+            score += 3;
+            matchedFields.add("title");
+        }
+        if (tagsLower.some((tag) => tag.includes(term))) {
+            score += 2;
+            matchedFields.add("tags");
+        }
+        if (contentLower.includes(term)) {
+            score += 1;
+            matchedFields.add("content");
+        }
+    }
+    return { score, matchedFields: Array.from(matchedFields) };
+}
+export async function searchNotes(ctx, query, vaultId, limit = 10) {
+    const terms = parseSearchTerms(query);
+    if (terms.length === 0) {
+        return JSON.stringify({ searchMode: "no_terms", blindIndexMatchCount: 0, notes: [] });
+    }
+    let candidateNotes;
+    let searchMode = "full_scan";
+    let blindIndexMatchCount = 0;
+    if (ctx.mekHex) {
+        try {
+            const queryTokenHashes = generateBlindTokens(query, ctx.mekHex);
+            if (queryTokenHashes.length > 0) {
+                const blindMatches = await matchNotesByBlindTokens(ctx.supabase, queryTokenHashes, ctx.userId, vaultId, limit * 3);
+                blindIndexMatchCount = blindMatches.length;
+                if (blindMatches.length > 0) {
+                    searchMode = "blind_index";
+                    const matchedIds = blindMatches.map((m) => m.note_id);
+                    candidateNotes = await getNotesByIds(ctx.supabase, ctx.userId, matchedIds);
+                }
+            }
+        }
+        catch {
+            // Blind index failed — fall back to full scan
+        }
+    }
+    // ── Fallback: full scan (decrypt all, score client-side) ────────────
+    if (!candidateNotes) {
+        candidateNotes = await getNotes(ctx.supabase, ctx.userId, vaultId, 500);
+    }
+    const scored = [];
+    await Promise.all(candidateNotes.map(async (n) => {
+        const { title, content, tags } = await decryptNoteFields(n, ctx.masterKey);
+        const { score, matchedFields } = scoreNote(terms, title, tags, content);
+        if (score > 0) {
+            scored.push({
+                id: n.id,
+                title,
+                tags,
+                preview: stripHtml(content).slice(0, 200),
+                score,
+                vaultId: n.vault_id,
+                matchedFields,
+            });
+        }
+    }));
+    scored.sort((a, b) => b.score - a.score);
+    return JSON.stringify({
+        searchMode,
+        blindIndexMatchCount,
+        notes: scored.slice(0, limit),
+    }, null, 2);
+}

package/dist/tools/search-notes.js.map

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

package/dist/tools/semantic-search.d.ts

@@ -0,0 +1,7 @@
+import type { McpContext } from "../auth.js";
+/**
+ * Semantic search: generates an embedding for the query, finds similar note
+ * chunks via pgvector, deduplicates to note level (keeping best similarity),
+ * and returns previews with similarity scores.
+ */
+export declare function semanticSearch(ctx: McpContext, query: string, topK?: number, threshold?: number): Promise<string>;