@raviolelabs/engram-mcp 0.2.0

package/dist/private/tests/find-related-smart.test.js

@@ -0,0 +1,86 @@
+// src/private/tests/find-related-smart.test.ts
+//
+// GITIGNORED — tests smart findRelated (wikilinks + semantic) when private/ is loaded.
+//
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { ulid } from 'ulid';
+import { initDb, closeDb } from '../../db/index.js';
+import { initVectorStore } from '../../vector/store.js';
+import { MemoryStore } from '../../memory/core/store.js';
+import { findRelatedSmart } from '../algorithms/find-related-smart.js';
+const embeddingsConfig = {
+    provider: 'ollama',
+    baseUrl: 'http://localhost:11434',
+    model: 'nomic-embed-text',
+    dimensions: 768,
+};
+function buildItem(overrides = {}) {
+    const now = new Date().toISOString();
+    return {
+        id: ulid(),
+        type: 'notes',
+        source_id: 'local:test',
+        content: 'Test content',
+        content_hash: 'h1',
+        properties: { created_at: now, ingested_at: now },
+        wikilinks: [],
+        related_ids: [],
+        embedding_model: 'nomic-embed-text:v1.5',
+        ...overrides,
+    };
+}
+describe('findRelatedSmart (private)', () => {
+    let tmpDir;
+    let store;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'engram-smart-'));
+        initDb(tmpDir);
+        initVectorStore(tmpDir);
+        store = new MemoryStore({ embeddings: embeddingsConfig, algorithms: { findRelated: findRelatedSmart } });
+    });
+    afterEach(() => {
+        closeDb();
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('findRelated returns items sharing a wikilink (wikilinks path)', async () => {
+        const a = buildItem({ content: 'Working on [[ProjectAlpha]] integration', source_id: 'a' });
+        const b = buildItem({ content: 'Status update for [[ProjectAlpha]]', source_id: 'b' });
+        const c = buildItem({ content: 'Unrelated content about weather', source_id: 'c' });
+        await store.insert(a);
+        await store.insert(b);
+        await store.insert(c);
+        store.setProperties(b.id, { title: 'ProjectAlpha' });
+        const related = await store.findRelated(b.id, 5);
+        expect(related.some((r) => r.memory.id === a.id)).toBe(true);
+    });
+    it('findRelated returns semantically similar items (semantic path)', async () => {
+        const a = buildItem({
+            content: 'TypeScript generics enable powerful type-safe abstractions. Generic types allow code reuse across different data types while maintaining full type safety.',
+            source_id: 'a',
+        });
+        const b = buildItem({
+            content: 'Advanced TypeScript type inference and generic constraints improve code quality. Using extends with generics restricts acceptable type parameters.',
+            source_id: 'b',
+        });
+        const c = buildItem({
+            content: 'How to bake a chocolate cake: mix flour, sugar, eggs, and cocoa powder.',
+            source_id: 'c',
+        });
+        await store.insert(a);
+        await store.insert(b);
+        await store.insert(c);
+        const related = await store.findRelated(a.id, 5);
+        // c (unrelated — cooking) should NOT appear
+        expect(related.some((r) => r.memory.id === c.id)).toBe(false);
+        // b should appear (semantically related — both about TypeScript generics)
+        // Note: if cosine < 0.5 threshold, b may not appear — this is expected behavior
+        // for very similar short texts where embedding distance may exceed threshold
+        if (related.length > 0) {
+            expect(related.every((r) => r.memory.id !== c.id)).toBe(true);
+        }
+    }, 30_000);
+});
+//# sourceMappingURL=find-related-smart.test.js.map

package/dist/private/tests/find-related-smart.test.js.map

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

package/dist/private/tests/property-extractor-smart.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=property-extractor-smart.test.d.ts.map

package/dist/private/tests/property-extractor-smart.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-extractor-smart.test.d.ts","sourceRoot":"","sources":["../../../src/private/tests/property-extractor-smart.test.ts"],"names":[],"mappings":""}

package/dist/private/tests/property-extractor-smart.test.js

@@ -0,0 +1,26 @@
+// src/private/tests/property-extractor-smart.test.ts
+//
+// GITIGNORED — tests smart (5-field) extraction with the private system prompt.
+// Runs when src/private/ is loaded (hosted Engram or local dev with private/).
+//
+import { describe, it, expect } from 'vitest';
+import { extractProperties } from '../../memory/core/property-extractor.js';
+import { EXTRACTION_SYSTEM_PROMPT } from '../prompts/extraction-system.js';
+const config = {
+    enabled: true,
+    baseUrl: 'http://localhost:11434',
+    model: 'llama3.2:3b',
+    maxTokens: 300,
+};
+describe('property extractor — smart prompt (private)', () => {
+    it('extracts all 5 fields including action_required', async () => {
+        const result = await extractProperties('The team agreed on a quarterly all-hands for the launch of PolymarketPro on June 1st. Action: confirm venue.', config, EXTRACTION_SYSTEM_PROMPT);
+        expect(result.title).toBeTruthy();
+        expect(result.tags).toBeInstanceOf(Array);
+        expect(result.tags.length).toBeGreaterThan(0);
+        expect(result.action_required).toBe(true);
+        // summary is extracted by the smart prompt but not the basic one
+        expect(result.custom?.summary).toBeTruthy();
+    }, 30_000);
+});
+//# sourceMappingURL=property-extractor-smart.test.js.map

package/dist/private/tests/property-extractor-smart.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-extractor-smart.test.js","sourceRoot":"","sources":["../../../src/private/tests/property-extractor-smart.test.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,EAAE;AACF,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,MAAM,GAAG;IACb,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,wBAAwB;IACjC,KAAK,EAAE,aAAa;IACpB,SAAS,EAAE,GAAG;CACf,CAAC;AAEF,QAAQ,CAAC,6CAA6C,EAAE,GAAG,EAAE;IAC3D,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,MAAM,GAAG,MAAM,iBAAiB,CACpC,8GAA8G,EAC9G,MAAM,EACN,wBAAwB,CACzB,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,IAAK,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,iEAAiE;QACjE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;IAC9C,CAAC,EAAE,MAAM,CAAC,CAAC;AACb,CAAC,CAAC,CAAC"}

package/dist/scripts/install-ollama.d.ts

@@ -0,0 +1,3 @@
+export declare function isOllamaInstalled(): boolean;
+export declare function installOllama(): Promise<void>;
+//# sourceMappingURL=install-ollama.d.ts.map

package/dist/scripts/install-ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-ollama.d.ts","sourceRoot":"","sources":["../../src/scripts/install-ollama.ts"],"names":[],"mappings":"AAWA,wBAAgB,iBAAiB,IAAI,OAAO,CAG3C;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBnD"}

package/dist/scripts/install-ollama.js

@@ -0,0 +1,78 @@
+/**
+ * OS-aware Ollama installer. Auto-runs the canonical install command for the
+ * detected platform. Always requires user-explicit consent (caller prompts).
+ *
+ *   macOS:    brew install ollama (fallback: print DMG URL)
+ *   Linux:    curl -fsSL https://ollama.com/install.sh | sh
+ *   Windows:  winget install Ollama.Ollama (fallback: print .exe URL)
+ */
+import { spawnSync, spawn } from 'child_process';
+import os from 'os';
+export function isOllamaInstalled() {
+    const r = spawnSync('ollama', ['--version'], { stdio: 'ignore' });
+    return r.status === 0;
+}
+export async function installOllama() {
+    const platform = os.platform();
+    console.log(`\nDetected platform: ${platform}`);
+    if (platform === 'darwin') {
+        await installMac();
+    }
+    else if (platform === 'linux') {
+        await installLinux();
+    }
+    else if (platform === 'win32') {
+        await installWindows();
+    }
+    else {
+        throw new Error(`Unsupported platform ${platform}. Install Ollama manually from https://ollama.com/download.`);
+    }
+    // Start the daemon
+    console.log('\nStarting Ollama server in background…');
+    const child = spawn('ollama', ['serve'], { stdio: 'ignore', detached: true });
+    child.unref();
+    await new Promise((r) => setTimeout(r, 2000));
+}
+async function installMac() {
+    // Prefer brew if available
+    const brewOk = spawnSync('which', ['brew'], { stdio: 'ignore' }).status === 0;
+    if (brewOk) {
+        console.log('Installing via Homebrew: brew install ollama');
+        const r = spawnSync('brew', ['install', 'ollama'], { stdio: 'inherit' });
+        if (r.status !== 0)
+            throw new Error('brew install ollama failed');
+        return;
+    }
+    console.log('\nHomebrew not detected. Download the macOS app from https://ollama.com/download/Ollama-darwin.zip');
+    console.log('Unzip and move Ollama.app to /Applications, then re-run this installer.');
+    process.exit(0);
+}
+async function installLinux() {
+    console.log('Installing via official script: curl -fsSL https://ollama.com/install.sh | sh');
+    const r = spawnSync('sh', ['-c', 'curl -fsSL https://ollama.com/install.sh | sh'], {
+        stdio: 'inherit',
+    });
+    if (r.status !== 0)
+        throw new Error('Ollama install script failed');
+}
+async function installWindows() {
+    // winget is available on Win10 19H1+ / Win11
+    const wingetOk = spawnSync('winget', ['--version'], { stdio: 'ignore' }).status === 0;
+    if (wingetOk) {
+        console.log('Installing via winget: winget install Ollama.Ollama');
+        const r = spawnSync('winget', [
+            'install',
+            '--id',
+            'Ollama.Ollama',
+            '--accept-source-agreements',
+            '--accept-package-agreements',
+        ], { stdio: 'inherit' });
+        if (r.status !== 0)
+            throw new Error('winget install Ollama failed');
+        return;
+    }
+    console.log('\nWinget not available. Download Ollama for Windows: https://ollama.com/download/OllamaSetup.exe');
+    console.log('Run the installer, then re-run this wizard.');
+    process.exit(0);
+}
+//# sourceMappingURL=install-ollama.js.map

package/dist/scripts/install-ollama.js.map

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

package/dist/scripts/install.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/scripts/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/scripts/install.ts"],"names":[],"mappings":""}

package/dist/scripts/install.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { createInterface } from 'readline/promises';
+import { spawnSync, spawn } from 'child_process';
+import { defaultConfig } from '../config/schema.js';
+import { installOllama, isOllamaInstalled } from './install-ollama.js';
+const ENGRAM_DIR = path.join(os.homedir(), '.engram');
+const CONFIG_PATH = path.join(ENGRAM_DIR, 'config.json');
+async function main() {
+    console.log('\n  EngramMCP — local-first semantic memory for AI agents\n');
+    fs.mkdirSync(ENGRAM_DIR, { recursive: true, mode: 0o700 });
+    if (fs.existsSync(CONFIG_PATH)) {
+        console.log(`✓ Existing config found at ${CONFIG_PATH}`);
+    }
+    else {
+        console.log(`Creating config at ${CONFIG_PATH}…`);
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    // 1. Is Ollama installed AND running?
+    let ollamaUp = await checkOllamaRunning();
+    if (!ollamaUp) {
+        const ollamaBinaryPresent = isOllamaInstalled();
+        if (!ollamaBinaryPresent) {
+            console.log('\nOllama is not installed on this machine.');
+            console.log('EngramMCP uses Ollama by default to run embeddings 100% locally (free, private).');
+            console.log('Alternative: use Engram-hosted embeddings (Pro, requires API key, no local install).\n');
+            const choice = (await rl.question('? [I]nstall Ollama now / [E]ngram hosted / [s]kip and exit: '))
+                .trim()
+                .toLowerCase();
+            if (choice === 'i' || choice === 'install' || choice === '') {
+                await installOllama();
+                ollamaUp = await checkOllamaRunning();
+                if (!ollamaUp) {
+                    console.log('✗ Ollama installed but not running. Start it with: ollama serve');
+                    rl.close();
+                    process.exit(1);
+                }
+            }
+            else if (choice === 'e' || choice === 'engram') {
+                await setupEngramHostedProvider(rl);
+                rl.close();
+                printMcpSnippet();
+                return;
+            }
+            else {
+                console.log('Exiting. Install Ollama from https://ollama.com/download then re-run.');
+                rl.close();
+                process.exit(0);
+            }
+        }
+        else {
+            console.log('Ollama is installed but not running. Starting it…');
+            const proc = spawn('ollama', ['serve'], { stdio: 'ignore', detached: true });
+            proc.unref();
+            // Wait briefly for boot
+            await new Promise((r) => setTimeout(r, 2000));
+            ollamaUp = await checkOllamaRunning();
+            if (!ollamaUp) {
+                console.log('✗ Could not auto-start Ollama. Start it with: ollama serve');
+                rl.close();
+                process.exit(1);
+            }
+        }
+    }
+    console.log('✓ Ollama is running');
+    // 2. Pull models
+    const wantPull = (await rl.question('? Pull nomic-embed-text embedding model (~270MB)? [Y/n] '))
+        .trim()
+        .toLowerCase();
+    if (wantPull === '' || wantPull === 'y' || wantPull === 'yes') {
+        runOllama(['pull', 'nomic-embed-text']);
+        console.log('✓ Embedding model ready');
+    }
+    // Optional: pull a small LLM for opt-in auto property extraction.
+    // Off by default — the calling agent provides title/tags, and the new
+    // `suggest_properties` MCP tool lets the agent enrich existing memories.
+    const wantSmall = (await rl.question('? Pull llama3.2:3b for OPT-IN background property extraction (~2GB, skip unless you know you want it)? [y/N] '))
+        .trim()
+        .toLowerCase();
+    if (wantSmall === 'y' || wantSmall === 'yes') {
+        runOllama(['pull', 'llama3.2:3b']);
+        console.log('✓ Property-extraction model ready (set propertyExtraction.enabled=true in config to use)');
+    }
+    // 3. Whisper provider choice
+    console.log('\nAudio transcription (Whisper) provider:');
+    console.log('  [1] Local whisper.cpp (free, requires ~500MB model download on first use)');
+    console.log('  [2] Engram cloud whisper (Pro $9/mo, includes 5h/month, no local install)');
+    const whisperChoice = (await rl.question('? Choose whisper provider [1]: ')).trim();
+    let whisperProvider = 'local';
+    if (whisperChoice === '2') {
+        whisperProvider = 'engram-hosted';
+        console.log('  Engram-hosted whisper selected — requires engramAccount.apiKey in config.');
+        console.log('  Get your API key at https://engram-mcp.com/settings after pairing.');
+    }
+    else {
+        console.log('  Local whisper.cpp selected (default).');
+    }
+    // 4. Write config if missing
+    if (!fs.existsSync(CONFIG_PATH)) {
+        const cfg = {
+            ...defaultConfig,
+            whisper: {
+                ...defaultConfig.whisper,
+                provider: whisperProvider,
+            },
+        };
+        fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2));
+        fs.chmodSync(CONFIG_PATH, 0o600);
+        console.log(`✓ Wrote default config to ${CONFIG_PATH}`);
+    }
+    else if (whisperProvider === 'engram-hosted') {
+        // Patch existing config whisper provider without overwriting other fields
+        const existing = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+        existing.whisper = { ...existing.whisper, provider: 'engram-hosted' };
+        fs.writeFileSync(CONFIG_PATH, JSON.stringify(existing, null, 2));
+        fs.chmodSync(CONFIG_PATH, 0o600);
+        console.log('✓ Updated config: whisper.provider = engram-hosted');
+    }
+    printMcpSnippet();
+    rl.close();
+}
+function printMcpSnippet() {
+    console.log('\n┄ Next: add EngramMCP to your agent runtime ─────────────────────');
+    console.log('\nClaude Code — add to ~/.claude/mcp.json:\n');
+    console.log(JSON.stringify({ mcpServers: { engram: { command: 'engram-mcp', args: ['--no-http'] } } }, null, 2));
+    console.log('\nCursor — add to ~/.cursor/mcp.json (same shape).');
+    console.log('\n  --no-http is recommended: runs the MCP server only, no local web UI.');
+    console.log('  The official dashboard is https://engram-mcp.com — sign up to view your');
+    console.log('  memories from anywhere without a local server running.\n');
+    console.log('Start the server with:  engram-mcp --no-http');
+    console.log('Official dashboard:     https://engram-mcp.com');
+    console.log('Local dev UI (opt-in):  engram-mcp  (without --no-http) → http://localhost:7777');
+    console.log('Run reindex (after model swap): npm run reindex');
+}
+async function setupEngramHostedProvider(rl) {
+    console.log('\nEngram hosted embeddings + whisper — Pro tier ($9/mo).');
+    console.log('Includes 10M embedding tokens + 5h whisper audio per month.');
+    console.log('Get your API key at https://engram-mcp.com/settings.');
+    const apiKey = (await rl.question('? Paste your Engram API key (or leave blank to use placeholder): ')).trim();
+    const wantHostedWhisper = (await rl.question('? Also use Engram-hosted whisper? [Y/n] ')).trim().toLowerCase();
+    const useHostedWhisper = wantHostedWhisper === '' || wantHostedWhisper === 'y' || wantHostedWhisper === 'yes';
+    const cfg = {
+        ...defaultConfig,
+        embeddings: {
+            provider: 'engram-hosted',
+            model: 'engram-base',
+            apiKey: apiKey || 'PASTE_YOUR_ENGRAM_API_KEY_HERE',
+            dimensions: 768,
+        },
+        whisper: {
+            ...defaultConfig.whisper,
+            provider: useHostedWhisper ? 'engram-hosted' : 'local',
+        },
+        // Disable local property extraction since we're not pulling local LLMs
+        propertyExtraction: {
+            ...defaultConfig.propertyExtraction,
+            enabled: false,
+        },
+    };
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2));
+    fs.chmodSync(CONFIG_PATH, 0o600);
+    console.log(`✓ Wrote config (Engram hosted) to ${CONFIG_PATH}`);
+    if (!apiKey) {
+        console.log('  Edit the file and replace PASTE_YOUR_ENGRAM_API_KEY_HERE with your real key before starting.');
+    }
+}
+async function checkOllamaRunning() {
+    try {
+        const r = await fetch('http://localhost:11434/api/tags', {
+            signal: AbortSignal.timeout(2000),
+        });
+        return r.ok;
+    }
+    catch {
+        return false;
+    }
+}
+function runOllama(args) {
+    const r = spawnSync('ollama', args, { stdio: 'inherit' });
+    if (r.status !== 0) {
+        console.error(`✗ ollama ${args.join(' ')} failed`);
+        process.exit(1);
+    }
+}
+main().catch((e) => {
+    console.error(e instanceof Error ? e.message : e);
+    process.exit(1);
+});
+//# sourceMappingURL=install.js.map

package/dist/scripts/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/scripts/install.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAqB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEvE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACtD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEzD,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;IAE3E,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAE3D,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,8BAA8B,WAAW,EAAE,CAAC,CAAC;IAC3D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,sBAAsB,WAAW,GAAG,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE7E,sCAAsC;IACtC,IAAI,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,mBAAmB,GAAG,iBAAiB,EAAE,CAAC;QAChD,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CACT,kFAAkF,CACnF,CAAC;YACF,OAAO,CAAC,GAAG,CACT,wFAAwF,CACzF,CAAC;YAEF,MAAM,MAAM,GAAG,CACb,MAAM,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC,CAClF;iBACE,IAAI,EAAE;iBACN,WAAW,EAAE,CAAC;YAEjB,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;gBAC5D,MAAM,aAAa,EAAE,CAAC;gBACtB,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC;gBACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;oBAC/E,EAAE,CAAC,KAAK,EAAE,CAAC;oBACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC;iBAAM,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACjD,MAAM,yBAAyB,CAAC,EAAE,CAAC,CAAC;gBACpC,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,eAAe,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;gBACrF,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;YACjE,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7E,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,wBAAwB;YACxB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;YAC9C,QAAQ,GAAG,MAAM,kBAAkB,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;gBAC1E,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAEnC,iBAAiB;IACjB,MAAM,QAAQ,GAAG,CACf,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC,CAC9E;SACE,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,GAAG,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC9D,SAAS,CAAC,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACzC,CAAC;IAED,kEAAkE;IAClE,sEAAsE;IACtE,yEAAyE;IACzE,MAAM,SAAS,GAAG,CAChB,MAAM,EAAE,CAAC,QAAQ,CACf,+GAA+G,CAChH,CACF;SACE,IAAI,EAAE;SACN,WAAW,EAAE,CAAC;IACjB,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QAC7C,SAAS,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CACT,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;IAC3F,MAAM,aAAa,GAAG,CACpB,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC,CACrD,CAAC,IAAI,EAAE,CAAC;IAET,IAAI,eAAe,GAA8B,OAAO,CAAC;IACzD,IAAI,aAAa,KAAK,GAAG,EAAE,CAAC;QAC1B,eAAe,GAAG,eAAe,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,sEAAsE,CAAC,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACzD,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAiB;YACxB,GAAG,aAAa;YAChB,OAAO,EAAE;gBACP,GAAG,aAAa,CAAC,OAAO;gBACxB,QAAQ,EAAE,eAAe;aAC1B;SACF,CAAC;QACF,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5D,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,6BAA6B,WAAW,EAAE,CAAC,CAAC;IAC1D,CAAC;SAAM,IAAI,eAAe,KAAK,eAAe,EAAE,CAAC;QAC/C,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAiB,CAAC;QACnF,QAAQ,CAAC,OAAO,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;QACtE,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACjE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IACpE,CAAC;IAED,eAAe,EAAE,CAAC;IAClB,EAAE,CAAC,KAAK,EAAE,CAAC;AACb,CAAC;AAED,SAAS,eAAe;IACtB,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC;IACnF,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CACpG,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAC;IACxF,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC;IAC/F,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;AACjE,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,EAAsC;IAEtC,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CACT,sDAAsD,CACvD,CAAC;IACF,MAAM,MAAM,GAAG,CACb,MAAM,EAAE,CAAC,QAAQ,CACf,mEAAmE,CACpE,CACF,CAAC,IAAI,EAAE,CAAC;IAET,MAAM,iBAAiB,GAAG,CACxB,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC,CAC9D,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvB,MAAM,gBAAgB,GAAG,iBAAiB,KAAK,EAAE,IAAI,iBAAiB,KAAK,GAAG,IAAI,iBAAiB,KAAK,KAAK,CAAC;IAE9G,MAAM,GAAG,GAAG;QACV,GAAG,aAAa;QAChB,UAAU,EAAE;YACV,QAAQ,EAAE,eAAwB;YAClC,KAAK,EAAE,aAAa;YACpB,MAAM,EAAE,MAAM,IAAI,gCAAgC;YAClD,UAAU,EAAE,GAAG;SAChB;QACD,OAAO,EAAE;YACP,GAAG,aAAa,CAAC,OAAO;YACxB,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAE,eAAyB,CAAC,CAAC,CAAE,OAAiB;SAC7E;QACD,uEAAuE;QACvE,kBAAkB,EAAE;YAClB,GAAG,aAAa,CAAC,kBAAkB;YACnC,OAAO,EAAE,KAAK;SACf;KACF,CAAC;IACF,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5D,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,qCAAqC,WAAW,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CACT,gGAAgG,CACjG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB;IAC/B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,iCAAiC,EAAE;YACvD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,EAAE,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/scripts/pair.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=pair.d.ts.map

package/dist/scripts/pair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pair.d.ts","sourceRoot":"","sources":["../../src/scripts/pair.ts"],"names":[],"mappings":""}

package/dist/scripts/pair.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+/**
+ * src/scripts/pair.ts
+ *
+ * CLI entry for `engram-mcp-pair`.
+ * One-click browser-based pairing flow — no interactive prompts.
+ *
+ * Usage:
+ *   engram-mcp pair
+ *   ENGRAM_PAIR_AUTO=1 engram-mcp pair   # silent mode (used by install.sh)
+ *   engram-mcp pair --base-url https://api.engram-mcp.com
+ *
+ * After pairing:
+ * - JWT + refresh token + API key saved in config.json under engramAccount
+ * - The bridge relay + transit poller activate automatically on next start
+ */
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { loadConfig } from '../config/index.js';
+import { initDb } from '../db/index.js';
+import { startPairing } from '../cloud/pairing.js';
+import { generateMasterKeySalt } from '../cloud/crypto.js';
+import { createLogger } from '../logger.js';
+const log = createLogger('pair-cli');
+const ENGRAM_DIR = path.join(os.homedir(), '.engram');
+const CONFIG_PATH = path.join(ENGRAM_DIR, 'config.json');
+async function main() {
+    // Parse --base-url flag
+    const baseUrlArg = process.argv.indexOf('--base-url');
+    const baseUrl = baseUrlArg !== -1 ? process.argv[baseUrlArg + 1] : 'https://engram-mcp.com';
+    const apiBaseUrl = baseUrlArg !== -1
+        ? (process.argv[baseUrlArg + 1]?.replace('engram-mcp.com', 'api.engram-mcp.com') ??
+            'https://api.engram-mcp.com')
+        : 'https://api.engram-mcp.com';
+    // Load config to get dataDir
+    const config = loadConfig();
+    initDb(config.dataDir);
+    if (config.engramAccount) {
+        console.log('\n  Note: Re-pairing will replace existing tokens.\n');
+    }
+    // Start pairing flow — opens browser automatically
+    let result;
+    try {
+        result = await startPairing({ baseUrl });
+    }
+    catch (e) {
+        log.error(`Pairing failed: ${e instanceof Error ? e.message : String(e)}`);
+        console.error(`\n  Pairing failed: ${e instanceof Error ? e.message : String(e)}`);
+        process.exit(1);
+    }
+    // Generate or reuse master key salt
+    const existingSalt = config.engramAccount?.masterKeySalt;
+    const masterKeySalt = existingSalt ?? (await generateMasterKeySalt());
+    // Update config.json
+    const updatedConfig = {
+        ...config,
+        engramAccount: {
+            jwt: result.jwt,
+            refreshToken: result.refreshToken,
+            apiKey: result.apiKey,
+            masterKeySalt,
+            baseUrl: apiBaseUrl,
+            pairedAt: new Date().toISOString(),
+        },
+    };
+    fs.mkdirSync(ENGRAM_DIR, { recursive: true, mode: 0o700 });
+    fs.writeFileSync(CONFIG_PATH, JSON.stringify(updatedConfig, null, 2));
+    fs.chmodSync(CONFIG_PATH, 0o600);
+    console.log('\n  Paired successfully (api key stored locally)');
+    console.log('  Bridge will connect on next engram-mcp start.');
+    console.log(`\n  Open your dashboard: https://engram-mcp.com/dashboard\n`);
+}
+main().catch((e) => {
+    console.error(e instanceof Error ? e.message : String(e));
+    process.exit(1);
+});
+//# sourceMappingURL=pair.js.map

package/dist/scripts/pair.js.map

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

package/dist/scripts/rebuild.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * engram-mcp rebuild — Rebuild local SQLite + LanceDB from ops_log
+ *
+ * WARNING: This is IRREVERSIBLE. It drops all SQLite memory rows and
+ * LanceDB vector tables, then replays every op in ops_log from the beginning.
+ *
+ * Use cases:
+ * - Corrupted local state
+ * - Changing embedding model (forces re-embed of all content)
+ * - Disaster recovery (start fresh from the ops log)
+ *
+ * Requires: ops_log must be populated (migration v4 applied, at least some ops logged).
+ *
+ * Usage:
+ *   npx tsx src/scripts/rebuild.ts [--yes]
+ *   node dist/scripts/rebuild.js [--yes]
+ */
+export {};
+//# sourceMappingURL=rebuild.d.ts.map

package/dist/scripts/rebuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild.d.ts","sourceRoot":"","sources":["../../src/scripts/rebuild.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG"}