synabun 2026.3.307 → 2026.3.310

package/mcp-server/dist/services/local-embeddings.js

@@ -0,0 +1,71 @@
+/**
+ * Local embedding generation using Transformers.js (ONNX runtime).
+ * Drop-in replacement for embeddings.ts — same exported function signatures.
+ * Uses all-MiniLM-L6-v2 (384 dimensions, ~23MB quantized model).
+ * No API key, no internet required after first model download.
+ */
+const MODEL_NAME = 'Xenova/all-MiniLM-L6-v2';
+export const EMBEDDING_DIMENSIONS = 384;
+let extractor = null;
+let initPromise = null;
+/**
+ * Lazy-loads the embedding pipeline. First call downloads the model (~23MB)
+ * and caches it permanently in ~/.cache/huggingface/. Subsequent calls reuse
+ * the cached model with no network access needed.
+ */
+async function getExtractor() {
+    if (extractor)
+        return extractor;
+    // Prevent concurrent initialization (multiple tools calling at once)
+    if (initPromise)
+        return initPromise;
+    initPromise = (async () => {
+        // Dynamic import to avoid blocking module load
+        const { pipeline } = await import('@huggingface/transformers');
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        extractor = await pipeline('feature-extraction', MODEL_NAME, {
+            dtype: 'fp32',
+        });
+        return extractor;
+    })();
+    try {
+        return await initPromise;
+    }
+    finally {
+        initPromise = null;
+    }
+}
+/**
+ * Generate a single embedding vector for the given text.
+ * Returns a 384-dimensional normalized vector (unit length).
+ */
+export async function generateEmbedding(text) {
+    const ext = await getExtractor();
+    const output = await ext(text, { pooling: 'mean', normalize: true });
+    return Array.from(output.data);
+}
+/**
+ * Generate embeddings for multiple texts.
+ * Processes sequentially to avoid memory spikes on large batches.
+ */
+export async function generateEmbeddingBatch(texts) {
+    if (texts.length === 0)
+        return [];
+    if (texts.length === 1)
+        return [await generateEmbedding(texts[0])];
+    const ext = await getExtractor();
+    const results = [];
+    for (const text of texts) {
+        const output = await ext(text, { pooling: 'mean', normalize: true });
+        results.push(Array.from(output.data));
+    }
+    return results;
+}
+/**
+ * Trigger model download/warmup without generating an actual embedding.
+ * Call this at server startup for faster first-use latency.
+ */
+export async function warmupEmbeddings() {
+    await getExtractor();
+}
+//# sourceMappingURL=local-embeddings.js.map

package/mcp-server/dist/services/local-embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-embeddings.js","sourceRoot":"","sources":["../../src/services/local-embeddings.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAExC,IAAI,SAAS,GAAqC,IAAI,CAAC;AACvD,IAAI,WAAW,GAA8C,IAAI,CAAC;AAElE;;;;GAIG;AACH,KAAK,UAAU,YAAY;IACzB,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAEhC,qEAAqE;IACrE,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;QACxB,+CAA+C;QAC/C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC/D,8DAA8D;QAC9D,SAAS,GAAG,MAAO,QAAgB,CAAC,oBAAoB,EAAE,UAAU,EAAE;YACpE,KAAK,EAAE,MAAM;SACd,CAA8B,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,CAAC;QACH,OAAO,MAAM,WAAW,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,MAAM,GAAG,GAAG,MAAM,YAAY,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAAe;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnE,MAAM,GAAG,GAAG,MAAM,YAAY,EAAE,CAAC;IACjC,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAoB,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,YAAY,EAAE,CAAC;AACvB,CAAC"}

package/mcp-server/dist/services/neural-interface.d.ts

@@ -0,0 +1,92 @@
+/**
+ * HTTP client for communicating with the Neural Interface Express server.
+ * The MCP server delegates all browser operations to the Neural Interface
+ * which manages Playwright sessions, CDP screencast, stealth, etc.
+ */
+export interface BrowserSessionInfo {
+    id: string;
+    url: string;
+    title: string;
+    createdAt: number;
+    clients: number;
+}
+interface NiResponse {
+    ok?: boolean;
+    error?: string;
+    [key: string]: unknown;
+}
+/**
+ * Resolve which session ID to use.
+ * - If sessionId provided, return it immediately (server returns 404 if invalid).
+ * - If 1 session exists, auto-select it.
+ * - If 0 sessions exist and autoCreate is true, create one.
+ * - If multiple sessions and no ID, return error listing them.
+ */
+export declare function resolveSession(sessionId?: string, autoCreate?: {
+    url?: string;
+}): Promise<{
+    sessionId: string;
+} | {
+    error: string;
+}>;
+export declare function invalidateCache(reason: string): Promise<void>;
+export declare function listSessions(): Promise<NiResponse>;
+export declare function createSession(url?: string): Promise<NiResponse>;
+export declare function closeSession(sessionId: string): Promise<NiResponse>;
+export declare function navigate(sessionId: string, url: string): Promise<NiResponse>;
+export declare function goBack(sessionId: string): Promise<NiResponse>;
+export declare function goForward(sessionId: string): Promise<NiResponse>;
+export declare function reload(sessionId: string): Promise<NiResponse>;
+export declare function click(sessionId: string, selector: string, nthMatch?: number): Promise<NiResponse>;
+export declare function fill(sessionId: string, selector: string, value: string, nthMatch?: number): Promise<NiResponse>;
+export declare function type(sessionId: string, selector: string | null, text: string, nthMatch?: number): Promise<NiResponse>;
+export declare function hover(sessionId: string, selector: string, nthMatch?: number): Promise<NiResponse>;
+export declare function selectOption(sessionId: string, selector: string, value: string, nthMatch?: number): Promise<NiResponse>;
+export declare function pressKey(sessionId: string, key: string): Promise<NiResponse>;
+export declare function scroll(sessionId: string, opts: {
+    direction: string;
+    distance?: number;
+    selector?: string;
+}): Promise<NiResponse>;
+export declare function upload(sessionId: string, selector: string, filePaths: string[], nthMatch?: number): Promise<NiResponse>;
+export declare function snapshot(sessionId: string, selector?: string): Promise<NiResponse>;
+export declare function getContent(sessionId: string): Promise<NiResponse>;
+export declare function getMarkdown(sessionId: string): Promise<NiResponse>;
+export declare function fetchMarkdown(url: string, timeout?: number): Promise<NiResponse>;
+export declare function screenshot(sessionId: string): Promise<NiResponse>;
+export declare function evaluate(sessionId: string, script: string): Promise<NiResponse>;
+export declare function waitFor(sessionId: string, opts: {
+    selector?: string;
+    state?: string;
+    loadState?: string;
+    timeout?: number;
+}): Promise<NiResponse>;
+export declare function getWhiteboard(): Promise<NiResponse>;
+export declare function addWhiteboardElements(elements: Record<string, unknown>[], coordMode?: string, layout?: string): Promise<NiResponse>;
+export declare function updateWhiteboardElement(id: string, updates: Record<string, unknown>, coordMode?: string): Promise<NiResponse>;
+export declare function removeWhiteboardElement(id: string): Promise<NiResponse>;
+export declare function clearWhiteboard(): Promise<NiResponse>;
+export declare function whiteboardScreenshot(): Promise<NiResponse>;
+export declare function getCards(): Promise<NiResponse>;
+export declare function openCard(memoryId: string, opts?: {
+    left?: number;
+    top?: number;
+    compact?: boolean;
+    coordMode?: string;
+}): Promise<NiResponse>;
+export declare function closeCard(memoryId?: string): Promise<NiResponse>;
+export declare function updateCard(memoryId: string, updates: Record<string, unknown>, coordMode?: string): Promise<NiResponse>;
+export declare function cardsScreenshot(): Promise<NiResponse>;
+export declare function tictactoeStart(piece?: string): Promise<NiResponse>;
+export declare function tictactoeMove(cell: number): Promise<NiResponse>;
+export declare function tictactoeState(): Promise<NiResponse>;
+export declare function tictactoeEnd(): Promise<NiResponse>;
+export declare function gitStatus(path: string): Promise<NiResponse>;
+export declare function gitDiff(path: string, maxLines?: number): Promise<NiResponse>;
+export declare function gitCommit(path: string, message: string, files?: string[]): Promise<NiResponse>;
+export declare function gitLog(path: string, count?: number): Promise<NiResponse>;
+export declare function gitBranches(path: string): Promise<NiResponse>;
+export declare function listImages(): Promise<NiResponse>;
+export declare function deleteImage(filename: string): Promise<NiResponse>;
+export {};
+//# sourceMappingURL=neural-interface.d.ts.map

package/mcp-server/dist/services/neural-interface.d.ts.map

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

package/mcp-server/dist/services/neural-interface.js

@@ -0,0 +1,238 @@
+/**
+ * HTTP client for communicating with the Neural Interface Express server.
+ * The MCP server delegates all browser operations to the Neural Interface
+ * which manages Playwright sessions, CDP screencast, stealth, etc.
+ */
+const BASE_URL = process.env.NEURAL_INTERFACE_URL
+    || `http://localhost:${process.env.NEURAL_PORT || '3344'}`;
+const DEFAULT_TIMEOUT = 10_000;
+const LONG_TIMEOUT = 30_000;
+async function request(method, path, body, timeout = DEFAULT_TIMEOUT) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+        const opts = {
+            method,
+            headers: { 'Content-Type': 'application/json' },
+            signal: controller.signal,
+        };
+        if (body && method !== 'GET') {
+            opts.body = JSON.stringify(body);
+        }
+        const res = await fetch(`${BASE_URL}${path}`, opts);
+        const data = await res.json();
+        if (!res.ok && !data.error) {
+            data.error = `HTTP ${res.status}`;
+        }
+        return data;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('abort')) {
+            return { error: `Request timed out after ${timeout}ms` };
+        }
+        return { error: `Neural Interface unreachable: ${msg}. Is the Neural Interface server running?` };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Resolve which session ID to use.
+ * - If sessionId provided, return it immediately (server returns 404 if invalid).
+ * - If 1 session exists, auto-select it.
+ * - If 0 sessions exist and autoCreate is true, create one.
+ * - If multiple sessions and no ID, return error listing them.
+ */
+export async function resolveSession(sessionId, autoCreate) {
+    // Agent-scoped browser session — set by the agent orchestrator to pin
+    // this MCP instance to a specific browser session (multi-agent isolation).
+    const pinnedSession = process.env.SYNABUN_BROWSER_SESSION;
+    if (pinnedSession && !sessionId) {
+        return { sessionId: pinnedSession };
+    }
+    if (sessionId) {
+        // Trust the server — it will 404 if the session doesn't exist.
+        // Skipping the extra GET /api/browser/sessions verification call saves a full round-trip.
+        return { sessionId };
+    }
+    // List sessions
+    const data = await request('GET', '/api/browser/sessions');
+    if (data.error)
+        return { error: data.error };
+    const sessions = (data.sessions || []);
+    if (sessions.length === 1) {
+        return { sessionId: sessions[0].id };
+    }
+    if (sessions.length === 0) {
+        if (autoCreate) {
+            const created = await request('POST', '/api/browser/sessions', {
+                url: autoCreate.url || 'about:blank',
+            });
+            if (created.error)
+                return { error: `Failed to auto-create session: ${created.error}` };
+            return { sessionId: created.sessionId };
+        }
+        return { error: 'No browser sessions open. Use browser_session to create one first, or use browser_navigate with a URL to auto-create.' };
+    }
+    // Multiple sessions — require explicit ID
+    const list = sessions.map(s => `  ${s.id} — ${s.title || s.url}`).join('\n');
+    return { error: `Multiple browser sessions open. Specify sessionId:\n${list}` };
+}
+// ── Cache invalidation ──
+export async function invalidateCache(reason) {
+    try {
+        await request('POST', '/api/cache/invalidate', { reason });
+    }
+    catch {
+        // Fire-and-forget — don't block MCP tools if Neural Interface is down
+    }
+}
+// ── Session management ──
+export async function listSessions() {
+    return request('GET', '/api/browser/sessions');
+}
+export async function createSession(url) {
+    return request('POST', '/api/browser/sessions', {
+        url: url || 'about:blank',
+    });
+}
+export async function closeSession(sessionId) {
+    return request('DELETE', `/api/browser/sessions/${sessionId}`);
+}
+// ── Navigation ──
+export async function navigate(sessionId, url) {
+    return request('POST', `/api/browser/sessions/${sessionId}/navigate`, { url }, LONG_TIMEOUT);
+}
+export async function goBack(sessionId) {
+    return request('POST', `/api/browser/sessions/${sessionId}/back`);
+}
+export async function goForward(sessionId) {
+    return request('POST', `/api/browser/sessions/${sessionId}/forward`);
+}
+export async function reload(sessionId) {
+    return request('POST', `/api/browser/sessions/${sessionId}/reload`, undefined, LONG_TIMEOUT);
+}
+// ── Interaction (selector-based) ──
+export async function click(sessionId, selector, nthMatch) {
+    return request('POST', `/api/browser/sessions/${sessionId}/click`, { selector, ...(nthMatch !== undefined && { nthMatch }) });
+}
+export async function fill(sessionId, selector, value, nthMatch) {
+    return request('POST', `/api/browser/sessions/${sessionId}/fill`, { selector, value, ...(nthMatch !== undefined && { nthMatch }) });
+}
+export async function type(sessionId, selector, text, nthMatch) {
+    return request('POST', `/api/browser/sessions/${sessionId}/type`, { selector, text, ...(nthMatch !== undefined && { nthMatch }) });
+}
+export async function hover(sessionId, selector, nthMatch) {
+    return request('POST', `/api/browser/sessions/${sessionId}/hover`, { selector, ...(nthMatch !== undefined && { nthMatch }) });
+}
+export async function selectOption(sessionId, selector, value, nthMatch) {
+    return request('POST', `/api/browser/sessions/${sessionId}/select`, { selector, value, ...(nthMatch !== undefined && { nthMatch }) });
+}
+export async function pressKey(sessionId, key) {
+    return request('POST', `/api/browser/sessions/${sessionId}/press`, { key });
+}
+export async function scroll(sessionId, opts) {
+    return request('POST', `/api/browser/sessions/${sessionId}/scroll`, opts);
+}
+export async function upload(sessionId, selector, filePaths, nthMatch) {
+    return request('POST', `/api/browser/sessions/${sessionId}/upload`, { selector, filePaths, ...(nthMatch !== undefined && { nthMatch }) }, LONG_TIMEOUT);
+}
+// ── Observation ──
+export async function snapshot(sessionId, selector) {
+    if (selector)
+        return request('POST', `/api/browser/sessions/${sessionId}/snapshot`, { selector });
+    return request('GET', `/api/browser/sessions/${sessionId}/snapshot`);
+}
+export async function getContent(sessionId) {
+    return request('GET', `/api/browser/sessions/${sessionId}/content`);
+}
+export async function getMarkdown(sessionId) {
+    return request('GET', `/api/browser/sessions/${sessionId}/markdown`, undefined, LONG_TIMEOUT);
+}
+export async function fetchMarkdown(url, timeout) {
+    return request('POST', '/api/fetch-markdown', { url, timeout }, LONG_TIMEOUT);
+}
+export async function screenshot(sessionId) {
+    return request('GET', `/api/browser/sessions/${sessionId}/screenshot-base64`);
+}
+// ── Advanced ──
+export async function evaluate(sessionId, script) {
+    return request('POST', `/api/browser/sessions/${sessionId}/evaluate`, { script }, LONG_TIMEOUT);
+}
+export async function waitFor(sessionId, opts) {
+    return request('POST', `/api/browser/sessions/${sessionId}/wait`, opts, LONG_TIMEOUT);
+}
+// ── Whiteboard ──
+export async function getWhiteboard() {
+    return request('GET', '/api/whiteboard');
+}
+export async function addWhiteboardElements(elements, coordMode, layout) {
+    return request('POST', '/api/whiteboard/elements', { elements, coordMode, layout });
+}
+export async function updateWhiteboardElement(id, updates, coordMode) {
+    return request('PUT', `/api/whiteboard/elements/${id}`, { updates, coordMode });
+}
+export async function removeWhiteboardElement(id) {
+    return request('DELETE', `/api/whiteboard/elements/${id}`);
+}
+export async function clearWhiteboard() {
+    return request('POST', '/api/whiteboard/clear');
+}
+export async function whiteboardScreenshot() {
+    return request('GET', '/api/whiteboard/screenshot', undefined, 15_000);
+}
+// ── Cards (Memory Card MCP integration) ──
+export async function getCards() {
+    return request('GET', '/api/cards');
+}
+export async function openCard(memoryId, opts) {
+    return request('POST', '/api/cards/open', { memoryId, ...opts });
+}
+export async function closeCard(memoryId) {
+    return request('POST', '/api/cards/close', memoryId ? { memoryId } : {});
+}
+export async function updateCard(memoryId, updates, coordMode) {
+    return request('PUT', `/api/cards/${memoryId}`, { ...updates, coordMode });
+}
+export async function cardsScreenshot() {
+    return request('GET', '/api/cards/screenshot', undefined, 15_000);
+}
+// ── TicTacToe ──
+export async function tictactoeStart(piece) {
+    return request('POST', '/api/games/tictactoe/start', { piece });
+}
+export async function tictactoeMove(cell) {
+    return request('POST', '/api/games/tictactoe/move', { cell });
+}
+export async function tictactoeState() {
+    return request('GET', '/api/games/tictactoe/state');
+}
+export async function tictactoeEnd() {
+    return request('POST', '/api/games/tictactoe/end');
+}
+// ── Git ──
+export async function gitStatus(path) {
+    return request('GET', `/api/git/status?path=${encodeURIComponent(path)}`);
+}
+export async function gitDiff(path, maxLines) {
+    const qs = `path=${encodeURIComponent(path)}${maxLines ? `&maxLines=${maxLines}` : ''}`;
+    return request('GET', `/api/git/diff?${qs}`, undefined, LONG_TIMEOUT);
+}
+export async function gitCommit(path, message, files) {
+    return request('POST', '/api/git/commit', { path, message, files });
+}
+export async function gitLog(path, count) {
+    return request('GET', `/api/git/log?path=${encodeURIComponent(path)}&count=${count || 10}`);
+}
+export async function gitBranches(path) {
+    return request('GET', `/api/terminal/branches?path=${encodeURIComponent(path)}`);
+}
+// ── Image store ──
+export async function listImages() {
+    return request('GET', '/api/images');
+}
+export async function deleteImage(filename) {
+    return request('DELETE', `/api/images/${encodeURIComponent(filename)}`);
+}
+//# sourceMappingURL=neural-interface.js.map

package/mcp-server/dist/services/neural-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neural-interface.js","sourceRoot":"","sources":["../../src/services/neural-interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB;OAC5C,oBAAoB,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM,EAAE,CAAC;AAC7D,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,YAAY,GAAG,MAAM,CAAC;AAgB5B,KAAK,UAAU,OAAO,CACpB,MAAc,EACd,IAAY,EACZ,IAA8B,EAC9B,OAAO,GAAG,eAAe;IAEzB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,MAAM,IAAI,GAAgB;YACxB,MAAM;YACN,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC;QACF,IAAI,IAAI,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,GAAG,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAgB,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,GAAG,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,KAAK,EAAE,2BAA2B,OAAO,IAAI,EAAE,CAAC;QAC3D,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,iCAAiC,GAAG,2CAA2C,EAAE,CAAC;IACpG,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAkB,EAClB,UAA6B;IAE7B,sEAAsE;IACtE,2EAA2E;IAC3E,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAC1D,IAAI,aAAa,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;IACtC,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,+DAA+D;QAC/D,0FAA0F;QAC1F,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;IAED,gBAAgB;IAChB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;IAC3D,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAyB,CAAC;IAE/D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACvC,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE;gBAC7D,GAAG,EAAE,UAAU,CAAC,GAAG,IAAI,aAAa;aACrC,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,KAAK;gBAAE,OAAO,EAAE,KAAK,EAAE,kCAAkC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACvF,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAmB,EAAE,CAAC;QACpD,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,uHAAuH,EAAE,CAAC;IAC5I,CAAC;IAED,0CAA0C;IAC1C,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO,EAAE,KAAK,EAAE,uDAAuD,IAAI,EAAE,EAAE,CAAC;AAClF,CAAC;AAED,2BAA2B;AAE3B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc;IAClD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;AACH,CAAC;AAED,2BAA2B;AAE3B,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,OAAO,OAAO,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAY;IAC9C,OAAO,OAAO,CAAC,MAAM,EAAE,uBAAuB,EAAE;QAC9C,GAAG,EAAE,GAAG,IAAI,aAAa;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAClD,OAAO,OAAO,CAAC,QAAQ,EAAE,yBAAyB,SAAS,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,mBAAmB;AAEnB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAiB,EAAE,GAAW;IAC3D,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,WAAW,EAAE,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,SAAiB;IAC5C,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB;IAC/C,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,UAAU,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,SAAiB;IAC5C,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AAC/F,CAAC;AAED,qCAAqC;AAErC,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,SAAiB,EAAE,QAAgB,EAAE,QAAiB;IAChF,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AAChI,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,SAAiB,EAAE,QAAgB,EAAE,KAAa,EAAE,QAAiB;IAC9F,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AACtI,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,SAAiB,EAAE,QAAuB,EAAE,IAAY,EAAE,QAAiB;IACpG,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AACrI,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,SAAiB,EAAE,QAAgB,EAAE,QAAiB;IAChF,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AAChI,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB,EAAE,QAAgB,EAAE,KAAa,EAAE,QAAiB;IACtG,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;AACxI,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAiB,EAAE,GAAW;IAC3D,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,SAAiB,EACjB,IAAiE;IAEjE,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,SAAS,EAAE,IAA+B,CAAC,CAAC;AACvG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,SAAiB,EACjB,QAAgB,EAChB,SAAmB,EACnB,QAAiB;IAEjB,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;AAC1J,CAAC;AAED,oBAAoB;AAEpB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAiB,EAAE,QAAiB;IACjE,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,WAAW,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClG,OAAO,OAAO,CAAC,KAAK,EAAE,yBAAyB,SAAS,WAAW,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,OAAO,OAAO,CAAC,KAAK,EAAE,yBAAyB,SAAS,UAAU,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAiB;IACjD,OAAO,OAAO,CAAC,KAAK,EAAE,yBAAyB,SAAS,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,OAAgB;IAC/D,OAAO,OAAO,CAAC,MAAM,EAAE,qBAAqB,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,OAAO,OAAO,CAAC,KAAK,EAAE,yBAAyB,SAAS,oBAAoB,CAAC,CAAC;AAChF,CAAC;AAED,iBAAiB;AAEjB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,SAAiB,EAAE,MAAc;IAC9D,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,SAAiB,EACjB,IAAiF;IAEjF,OAAO,OAAO,CAAC,MAAM,EAAE,yBAAyB,SAAS,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;AACxF,CAAC;AAED,mBAAmB;AAEnB,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAmC,EACnC,SAAkB,EAClB,MAAe;IAEf,OAAO,OAAO,CAAC,MAAM,EAAE,0BAA0B,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAA6B,CAAC,CAAC;AACjH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,EAAU,EACV,OAAgC,EAChC,SAAkB;IAElB,OAAO,OAAO,CAAC,KAAK,EAAE,4BAA4B,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAA6B,CAAC,CAAC;AAC7G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,EAAU;IACtD,OAAO,OAAO,CAAC,QAAQ,EAAE,4BAA4B,EAAE,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,OAAO,OAAO,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,OAAO,OAAO,CAAC,KAAK,EAAE,4BAA4B,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC;AAED,4CAA4C;AAE5C,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,OAAO,OAAO,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAgB,EAChB,IAA6E;IAE7E,OAAO,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,GAAG,IAAI,EAA6B,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAiB;IAC/C,OAAO,OAAO,CAAC,MAAM,EAAE,kBAAkB,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAA6B,CAAC,CAAC;AACtG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,OAAgC,EAChC,SAAkB;IAElB,OAAO,OAAO,CAAC,KAAK,EAAE,cAAc,QAAQ,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAA6B,CAAC,CAAC;AACxG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,OAAO,OAAO,CAAC,KAAK,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED,kBAAkB;AAElB,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAc;IACjD,OAAO,OAAO,CAAC,MAAM,EAAE,4BAA4B,EAAE,EAAE,KAAK,EAA6B,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,OAAO,OAAO,CAAC,MAAM,EAAE,2BAA2B,EAAE,EAAE,IAAI,EAA6B,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,OAAO,OAAO,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,OAAO,OAAO,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;AACrD,CAAC;AAED,YAAY;AAEZ,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,OAAO,OAAO,CAAC,KAAK,EAAE,wBAAwB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,QAAiB;IAC3D,MAAM,EAAE,GAAG,QAAQ,kBAAkB,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACxF,OAAO,OAAO,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe,EAAE,KAAgB;IAC7E,OAAO,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAA6B,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,KAAc;IACvD,OAAO,OAAO,CAAC,KAAK,EAAE,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,OAAO,OAAO,CAAC,KAAK,EAAE,+BAA+B,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,oBAAoB;AAEpB,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,OAAO,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,OAAO,OAAO,CAAC,QAAQ,EAAE,eAAe,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/mcp-server/dist/services/sqlite.d.ts

@@ -0,0 +1,85 @@
+/**
+ * SQLite storage layer.
+ * Uses Node.js built-in node:sqlite (available since Node 22.5.0).
+ * Vectors stored as Float32Array BLOBs, cosine similarity computed in JS.
+ */
+import type { MemoryPayload, MemoryStats, SessionChunkPayload } from '../types.js';
+export declare const CATEGORIES_POINT_ID = "00000000-0000-0000-0000-000000000000";
+export declare function ensureCollection(): Promise<void>;
+export declare function ensureSessionCollection(): Promise<void>;
+/** Combined init function for cleaner startup */
+export declare function ensureDatabase(): Promise<void>;
+export declare function upsertMemory(id: string, vector: number[], payload: MemoryPayload): Promise<void>;
+export declare function searchMemories(vector: number[], limit: number, filter?: Record<string, unknown>, scoreThreshold?: number): Promise<{
+    id: string;
+    score: number;
+    payload: MemoryPayload;
+}[]>;
+export declare function getMemory(id: string): Promise<{
+    id: string;
+    payload: MemoryPayload;
+} | null>;
+export declare function updatePayload(id: string, payload: Partial<MemoryPayload>): Promise<void>;
+export declare function updateVector(id: string, vector: number[], payload: MemoryPayload): Promise<void>;
+export declare function updatePayloadByFilter(filter: Record<string, unknown>, payload: Partial<MemoryPayload>): Promise<void>;
+export declare function deleteMemory(id: string): Promise<void>;
+export declare function softDeleteMemory(id: string): Promise<void>;
+export declare function restoreMemory(id: string): Promise<void>;
+export declare function scrollMemories(filter?: Record<string, unknown>, limit?: number, offset?: string): Promise<{
+    points: {
+        id: string;
+        payload: MemoryPayload;
+    }[];
+    next_page_offset: string | null;
+}>;
+export declare function countMemories(filter?: Record<string, unknown>): Promise<number>;
+export declare function getMemoryStats(): Promise<MemoryStats>;
+/**
+ * Search memories using FTS5 full-text search (keyword fallback).
+ * Returns results scored by BM25 relevance. Used when vector similarity
+ * scores are low (exact identifiers, error codes, proper nouns).
+ */
+export declare function searchMemoriesFTS(query: string, limit: number, filter?: Record<string, unknown>, excludeIds?: Set<string>): Promise<Array<{
+    id: string;
+    score: number;
+    payload: MemoryPayload;
+}>>;
+export declare function searchSessionChunks(vector: number[], limit: number, filter?: Record<string, unknown>, scoreThreshold?: number): Promise<{
+    id: string;
+    score: number;
+    payload: SessionChunkPayload;
+}[]>;
+export declare function upsertSessionChunks(points: Array<{
+    id: string;
+    vector: number[];
+    payload: SessionChunkPayload;
+}>): Promise<void>;
+export declare function scrollSessionChunks(filter?: Record<string, unknown>, limit?: number, offset?: string): Promise<{
+    points: {
+        id: string;
+        payload: SessionChunkPayload;
+    }[];
+    next_page_offset: string | null;
+}>;
+export declare function countSessionChunks(filter?: Record<string, unknown>): Promise<number>;
+interface StoredCategory {
+    name: string;
+    description: string;
+    created_at: string;
+    parent?: string;
+    color?: string;
+    is_parent?: boolean;
+}
+export declare function getCategories(): Promise<StoredCategory[] | null>;
+export declare function saveCategories(categories: StoredCategory[]): Promise<void>;
+/**
+ * Close the database connection. Call on process exit.
+ */
+export declare function closeDatabase(): void;
+/**
+ * Reopen the database at the current SQLITE_DB_PATH.
+ * Call after updating process.env.SQLITE_DB_PATH to switch databases.
+ */
+export declare function reopenDatabase(): Promise<void>;
+export {};
+//# sourceMappingURL=sqlite.d.ts.map

package/mcp-server/dist/services/sqlite.d.ts.map

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