brains-mcp 1.61.2

package/dist/search/embeddings.js

@@ -0,0 +1,91 @@
+/**
+ * embeddings.ts
+ *
+ * OpenAI text-embedding-3-small client for wiki page vectors.
+ * Used at ingest time (upsertPage) and at query time (hybrid search).
+ *
+ * Cost: $0.020 / 1M tokens (text-embedding-3-small).
+ * Falls back silently when OPENAI_API_KEY is unset so the server
+ * continues to function with FTS-only search.
+ */
+import OpenAI from "openai";
+export const EMBEDDING_MODEL = "text-embedding-3-small";
+export const EMBEDDING_DIMS = 1536;
+let _client = null;
+function getClient() {
+    const key = process.env.OPENAI_API_KEY?.trim();
+    if (!key)
+        return null;
+    if (!_client)
+        _client = new OpenAI({ apiKey: key });
+    return _client;
+}
+export function isEmbeddingEnabled() {
+    return Boolean(process.env.OPENAI_API_KEY?.trim()) &&
+        process.env.ENABLE_HYBRID_RETRIEVAL === "true";
+}
+/**
+ * Generate a single embedding for `text`.
+ * Returns null when OPENAI_API_KEY is unset or the API call fails.
+ * Text is truncated to ~8000 tokens before sending (model max is 8192).
+ */
+export async function generateEmbedding(text) {
+    const client = getClient();
+    if (!client)
+        return null;
+    const truncated = text.slice(0, 32_000); // ~8k tokens safety margin
+    try {
+        const response = await client.embeddings.create({
+            model: EMBEDDING_MODEL,
+            input: truncated,
+        });
+        return response.data[0]?.embedding ?? null;
+    }
+    catch (err) {
+        console.error("[embeddings] generateEmbedding failed:", err instanceof Error ? err.message : String(err));
+        return null;
+    }
+}
+/**
+ * Generate embeddings for a batch of texts.
+ * OpenAI allows up to 2048 inputs per request; callers should chunk larger batches.
+ * Returns an array of the same length; failed entries are null.
+ */
+export async function generateEmbeddings(texts) {
+    if (texts.length === 0)
+        return [];
+    const client = getClient();
+    if (!client)
+        return texts.map(() => null);
+    const truncated = texts.map((t) => t.slice(0, 32_000));
+    try {
+        const response = await client.embeddings.create({
+            model: EMBEDDING_MODEL,
+            input: truncated,
+        });
+        const out = texts.map(() => null);
+        for (const item of response.data) {
+            out[item.index] = item.embedding;
+        }
+        return out;
+    }
+    catch (err) {
+        console.error("[embeddings] generateEmbeddings batch failed:", err instanceof Error ? err.message : String(err));
+        return texts.map(() => null);
+    }
+}
+/**
+ * Build the text to embed for a page: title + summary + (first 2000 chars of content).
+ * Keeping content short reduces token cost while preserving semantic signal.
+ */
+export function buildEmbeddingInput(title, summary, content) {
+    const parts = [];
+    if (title)
+        parts.push(title);
+    if (summary)
+        parts.push(summary);
+    if (content)
+        parts.push(content.slice(0, 2000));
+    return parts.join("\n\n");
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/search/embeddings.js.map

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

package/dist/search/fileWatcher.d.ts

@@ -0,0 +1,28 @@
+import type { StorageClient } from "../storage/client.js";
+import type { SqliteSearchIndex } from "./sqliteIndex.js";
+export interface WikiFileWatcher {
+    /** Stop watching and release filesystem handles. */
+    close(): Promise<void>;
+    /** Resolves once chokidar's initial scan completes and events are live. */
+    whenReady(): Promise<void>;
+    /** Resolves once any pending or in-flight resync has settled (tests). */
+    whenIdle(): Promise<void>;
+}
+export interface WikiFileWatcherOptions {
+    debounceMs?: number;
+    /** Injectable for tests; defaults to console.warn. */
+    onError?: (err: unknown) => void;
+}
+/**
+ * Watches the local wiki directory for markdown changes made outside the app
+ * (e.g. moves/renames in Obsidian) and reconciles the SQLite search index.
+ *
+ * Without this, an external move only surfaces on the next `search` call (which
+ * triggers a throttled `ensureSynced`); the watcher closes that gap so the
+ * index follows the filesystem in near real time.
+ *
+ * Only meaningful for the local storage backend — the Supabase backend has no
+ * local source of truth to watch. Caller is responsible for that gate.
+ */
+export declare function startWikiFileWatcher(wikiDir: string, drive: StorageClient, index: SqliteSearchIndex, options?: WikiFileWatcherOptions): WikiFileWatcher;
+//# sourceMappingURL=fileWatcher.d.ts.map

package/dist/search/fileWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWatcher.d.ts","sourceRoot":"","sources":["../../src/search/fileWatcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAI1D,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,2EAA2E;IAC3E,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAuFjB"}

package/dist/search/fileWatcher.js

@@ -0,0 +1,103 @@
+import path from "path";
+import chokidar from "chokidar";
+const DEFAULT_DEBOUNCE_MS = 400;
+/**
+ * Watches the local wiki directory for markdown changes made outside the app
+ * (e.g. moves/renames in Obsidian) and reconciles the SQLite search index.
+ *
+ * Without this, an external move only surfaces on the next `search` call (which
+ * triggers a throttled `ensureSynced`); the watcher closes that gap so the
+ * index follows the filesystem in near real time.
+ *
+ * Only meaningful for the local storage backend — the Supabase backend has no
+ * local source of truth to watch. Caller is responsible for that gate.
+ */
+export function startWikiFileWatcher(wikiDir, drive, index, options = {}) {
+    const debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    const onError = options.onError ?? ((err) => console.warn("[watch] resync failed:", err));
+    const watcher = chokidar.watch(wikiDir, {
+        ignoreInitial: true, // startBackgroundSync already covers the initial state
+        persistent: true,
+        // Skip hidden entries — notably the `.cache/` sqlite db (and its WAL), which
+        // the index itself writes; reacting to those would create a feedback loop.
+        ignored: (target) => path.basename(target).startsWith("."),
+        // Coalesce the burst of events an editor emits while saving a file.
+        awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 },
+    });
+    let debounceTimer = null;
+    let resyncInFlight = null;
+    let dirtyDuringResync = false;
+    let idleResolvers = [];
+    let ready = false;
+    let readyResolvers = [];
+    watcher.once("ready", () => {
+        ready = true;
+        const resolvers = readyResolvers;
+        readyResolvers = [];
+        for (const resolve of resolvers)
+            resolve();
+    });
+    const settleIdle = () => {
+        if (debounceTimer || resyncInFlight)
+            return;
+        const resolvers = idleResolvers;
+        idleResolvers = [];
+        for (const resolve of resolvers)
+            resolve();
+    };
+    const runResync = () => {
+        if (resyncInFlight) {
+            // A resync is already running; remember that more changed and re-run after.
+            dirtyDuringResync = true;
+            return;
+        }
+        const run = index
+            .syncNow(drive)
+            .catch(onError)
+            .finally(() => {
+            resyncInFlight = null;
+            if (dirtyDuringResync) {
+                dirtyDuringResync = false;
+                runResync();
+            }
+            else {
+                settleIdle();
+            }
+        });
+        resyncInFlight = run;
+    };
+    const scheduleResync = (changedPath) => {
+        if (!changedPath.endsWith(".md"))
+            return;
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(() => {
+            debounceTimer = null;
+            runResync();
+        }, debounceMs);
+    };
+    watcher
+        .on("add", scheduleResync)
+        .on("change", scheduleResync)
+        .on("unlink", scheduleResync)
+        .on("error", onError);
+    return {
+        async close() {
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = null;
+            await watcher.close();
+        },
+        whenReady() {
+            if (ready)
+                return Promise.resolve();
+            return new Promise((resolve) => readyResolvers.push(resolve));
+        },
+        whenIdle() {
+            if (!debounceTimer && !resyncInFlight)
+                return Promise.resolve();
+            return new Promise((resolve) => idleResolvers.push(resolve));
+        },
+    };
+}
+//# sourceMappingURL=fileWatcher.js.map

package/dist/search/fileWatcher.js.map

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

package/dist/search/hotQueryCache.d.ts

@@ -0,0 +1,31 @@
+/**
+ * hotQueryCache.ts
+ *
+ * In-memory TTL cache for search results targeting the top-N repeated queries.
+ * Phase 4 speed improvement: near-zero cost cache hits for repeated MCP searches.
+ *
+ * Design:
+ *   - Keyed by (userId, normalised query) — safe across multi-user Supabase deployments.
+ *   - Short TTL (default 7 s) keeps results fresh enough for interactive use.
+ *   - Capped at MAX_ENTRIES; oldest entry evicted when full.
+ *   - Warm-up queries Supabase request_events for the top-20 terms (last 7 d)
+ *     and pre-runs those searches so the first real request is already cached.
+ */
+export interface HotCacheStats {
+    size: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+}
+export declare function getHotCached(userId: string, query: string): object | null;
+export declare function setHotCached(userId: string, query: string, result: object): void;
+export declare function getHotCacheStats(): HotCacheStats;
+export declare function clearHotCache(): void;
+/**
+ * Fetch the top-N query strings from request_events (last 7 days) and return
+ * them so the caller can pre-warm the cache by running those searches.
+ *
+ * Returns an empty array when Supabase is not configured or the query fails.
+ */
+export declare function fetchTopQueries(supabaseUrl: string, serviceRoleKey: string, limit?: number): Promise<string[]>;
+//# sourceMappingURL=hotQueryCache.d.ts.map

package/dist/search/hotQueryCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotQueryCache.d.ts","sourceRoot":"","sources":["../../src/search/hotQueryCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAyBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASzE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAShF;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAShD;AAED,wBAAgB,aAAa,IAAI,IAAI,CAIpC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,KAAK,SAAK,GACT,OAAO,CAAC,MAAM,EAAE,CAAC,CA+BnB"}

package/dist/search/hotQueryCache.js

@@ -0,0 +1,103 @@
+/**
+ * hotQueryCache.ts
+ *
+ * In-memory TTL cache for search results targeting the top-N repeated queries.
+ * Phase 4 speed improvement: near-zero cost cache hits for repeated MCP searches.
+ *
+ * Design:
+ *   - Keyed by (userId, normalised query) — safe across multi-user Supabase deployments.
+ *   - Short TTL (default 7 s) keeps results fresh enough for interactive use.
+ *   - Capped at MAX_ENTRIES; oldest entry evicted when full.
+ *   - Warm-up queries Supabase request_events for the top-20 terms (last 7 d)
+ *     and pre-runs those searches so the first real request is already cached.
+ */
+const HOT_CACHE_TTL_MS = 7_000;
+const HOT_CACHE_MAX_ENTRIES = 50;
+const cache = new Map();
+let totalHits = 0;
+let totalMisses = 0;
+function normKey(userId, query) {
+    return `${userId}\0${query.trim().toLowerCase()}`;
+}
+function evictExpired() {
+    const now = Date.now();
+    for (const [k, v] of cache) {
+        if (now > v.expiresAt)
+            cache.delete(k);
+    }
+}
+export function getHotCached(userId, query) {
+    evictExpired();
+    const entry = cache.get(normKey(userId, query));
+    if (!entry) {
+        totalMisses++;
+        return null;
+    }
+    totalHits++;
+    return entry.result;
+}
+export function setHotCached(userId, query, result) {
+    evictExpired();
+    const key = normKey(userId, query);
+    if (!cache.has(key) && cache.size >= HOT_CACHE_MAX_ENTRIES) {
+        // Evict the oldest (first inserted) entry.
+        const oldest = cache.keys().next().value;
+        if (oldest !== undefined)
+            cache.delete(oldest);
+    }
+    cache.set(key, { result, expiresAt: Date.now() + HOT_CACHE_TTL_MS });
+}
+export function getHotCacheStats() {
+    evictExpired();
+    const total = totalHits + totalMisses;
+    return {
+        size: cache.size,
+        hits: totalHits,
+        misses: totalMisses,
+        hitRate: total === 0 ? 0 : totalHits / total,
+    };
+}
+export function clearHotCache() {
+    cache.clear();
+    totalHits = 0;
+    totalMisses = 0;
+}
+/**
+ * Fetch the top-N query strings from request_events (last 7 days) and return
+ * them so the caller can pre-warm the cache by running those searches.
+ *
+ * Returns an empty array when Supabase is not configured or the query fails.
+ */
+export async function fetchTopQueries(supabaseUrl, serviceRoleKey, limit = 20) {
+    const url = `${supabaseUrl}/rest/v1/request_events` +
+        `?select=query_text` +
+        `&path=eq./api/v1/search` +
+        `&query_text=not.is.null` +
+        `&ts=gte.${new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString()}` +
+        `&limit=500`;
+    try {
+        const res = await fetch(url, {
+            headers: {
+                apikey: serviceRoleKey,
+                authorization: `Bearer ${serviceRoleKey}`,
+            },
+        });
+        if (!res.ok)
+            return [];
+        const rows = (await res.json());
+        const freq = new Map();
+        for (const row of rows) {
+            const q = row.query_text.trim().toLowerCase();
+            if (q)
+                freq.set(q, (freq.get(q) ?? 0) + 1);
+        }
+        return [...freq.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, limit)
+            .map(([q]) => q);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=hotQueryCache.js.map

package/dist/search/hotQueryCache.js.map

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