@raviolelabs/engram-mcp 0.2.0

package/dist/webapp/api/sync-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-status.js","sourceRoot":"","sources":["../../../src/webapp/api/sync-status.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG1C,MAAM,UAAU,gBAAgB;IAC9B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;QAC9D,IAAI,EAAE,CAAC;QACP,IAAI,CAAC;YACH,EAAE,GAAG,KAAK,EAAE,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;YACvD,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,uDAAuD;QACvD,MAAM,SAAS,GAAG,EAAE;aACjB,OAAO,CAAC,sEAAsE,CAAC;aAC/E,GAAG,EAAE,CAAC;QAET,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,oDAAoD,EAAE,CAAC,CAAC;YAC3F,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAChB,EAAE,CAAC,OAAO,CAAC,yDAAyD,CAAC,CAAC,GAAG,EAC1E,CAAC,CAAC,CAAC;QAEJ,MAAM,YAAY,GAChB,EAAE,CAAC,OAAO,CAAC,qDAAqD,CAAC,CAAC,GAAG,EACtE,CAAC,CAAC,CAAC;QAEJ,MAAM,UAAU,GACd,EAAE;aACC,OAAO,CAAC,0DAA0D,CAAC;aACnE,GAAG,EACP,CAAC,CAAC,CAAC;QAEJ,MAAM,SAAS,GAAG,EAAE;aACjB,OAAO,CAAC,uEAAuE,CAAC;aAChF,GAAG,EAA+E,CAAC;QAEtF,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,SAAS;YACpB,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI;YACnE,UAAU,EAAE,SAAS,EAAE,UAAU,IAAI,CAAC;YACtC,WAAW,EAAE,YAAY;YACzB,WAAW,EAAE,YAAY;YACzB,eAAe,EAAE,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/webapp/api/types.d.ts

@@ -0,0 +1,3 @@
+import { Router } from 'express';
+export declare function typesApi(): Router;
+//# sourceMappingURL=types.d.ts.map

package/dist/webapp/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/webapp/api/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,wBAAgB,QAAQ,IAAI,MAAM,CAcjC"}

package/dist/webapp/api/types.js

@@ -0,0 +1,20 @@
+// src/webapp/api/types.ts
+import { Router } from 'express';
+import { moduleRegistry } from '../../memory/core/module-registry.js';
+import { listCustomTypes } from '../../memory/modules/_custom/persistence.js';
+export function typesApi() {
+    const r = Router();
+    r.get('/', (_req, res) => {
+        const builtins = moduleRegistry.list()
+            .filter((m) => !m.isCustom)
+            .map((m) => ({ id: m.id, display_name: m.displayName, is_custom: false }));
+        const customs = listCustomTypes().map((d) => ({
+            id: d.type_name,
+            display_name: d.display_name,
+            is_custom: true,
+        }));
+        res.json([...builtins, ...customs]);
+    });
+    return r;
+}
+//# sourceMappingURL=types.js.map

package/dist/webapp/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/webapp/api/types.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAE9E,MAAM,UAAU,QAAQ;IACtB,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;IACnB,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE;aACnC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;aAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5C,EAAE,EAAE,CAAC,CAAC,SAAS;YACf,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC,CAAC;QACJ,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/webapp/api/views.d.ts

@@ -0,0 +1,25 @@
+import { Router } from 'express';
+export interface SavedView {
+    id: string;
+    name: string;
+    description: string | null;
+    definition: {
+        filters?: Array<{
+            field: string;
+            op: string;
+            value: unknown;
+        }>;
+        sort?: {
+            field: string;
+            direction: 'asc' | 'desc';
+        };
+        group_by?: string;
+        layout?: 'table' | 'gallery' | 'list';
+        types?: string[];
+    };
+    pinned: boolean;
+    created_at: number;
+    updated_at: number;
+}
+export declare function viewsApi(): Router;
+//# sourceMappingURL=views.d.ts.map

package/dist/webapp/api/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../../src/webapp/api/views.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE;QACV,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;SAAE,CAAC;QACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;QACtC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,IAAI,MAAM,CA0EjC"}

package/dist/webapp/api/views.js

@@ -0,0 +1,54 @@
+// src/webapp/api/views.ts
+import { Router } from 'express';
+import { ulid } from 'ulid';
+import { getDb } from '../../db/index.js';
+export function viewsApi() {
+    const r = Router();
+    r.get('/', (_req, res) => {
+        const rows = getDb()
+            .prepare(`SELECT * FROM saved_views ORDER BY pinned DESC, updated_at DESC`)
+            .all();
+        res.json(rows.map((row) => ({
+            id: row.id,
+            name: row.name,
+            description: row.description ?? null,
+            definition: JSON.parse(row.definition_json),
+            pinned: !!row.pinned,
+            created_at: row.created_at,
+            updated_at: row.updated_at,
+        })));
+    });
+    r.post('/', (req, res) => {
+        const body = req.body;
+        if (!body.name || !body.definition) {
+            res.status(400).json({ error: 'name and definition required' });
+            return;
+        }
+        const id = ulid();
+        const now = Date.now();
+        getDb()
+            .prepare(`INSERT INTO saved_views
+         (id, name, description, definition_json, pinned, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, body.name, body.description ?? null, JSON.stringify(body.definition), body.pinned ? 1 : 0, now, now);
+        res.json({ id });
+    });
+    r.put('/:id', (req, res) => {
+        const body = req.body;
+        getDb()
+            .prepare(`UPDATE saved_views SET name = COALESCE(?, name),
+                                description = COALESCE(?, description),
+                                definition_json = COALESCE(?, definition_json),
+                                pinned = COALESCE(?, pinned),
+                                updated_at = ?
+         WHERE id = ?`)
+            .run(body.name ?? null, body.description ?? null, body.definition ? JSON.stringify(body.definition) : null, body.pinned !== undefined ? (body.pinned ? 1 : 0) : null, Date.now(), req.params.id);
+        res.json({ updated: req.params.id });
+    });
+    r.delete('/:id', (req, res) => {
+        getDb().prepare('DELETE FROM saved_views WHERE id = ?').run(req.params.id);
+        res.json({ deleted: req.params.id });
+    });
+    return r;
+}
+//# sourceMappingURL=views.js.map

package/dist/webapp/api/views.js.map

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

package/dist/webapp/mcp-http.d.ts

@@ -0,0 +1,2 @@
+export * from '../core/server/mcp-http.js';
+//# sourceMappingURL=mcp-http.d.ts.map

package/dist/webapp/mcp-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http.d.ts","sourceRoot":"","sources":["../../src/webapp/mcp-http.ts"],"names":[],"mappings":"AACA,cAAc,4BAA4B,CAAC"}

package/dist/webapp/mcp-http.js

@@ -0,0 +1,3 @@
+// Re-export shim — canonical location is src/core/server/mcp-http.ts
+export * from '../core/server/mcp-http.js';
+//# sourceMappingURL=mcp-http.js.map

package/dist/webapp/mcp-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http.js","sourceRoot":"","sources":["../../src/webapp/mcp-http.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,cAAc,4BAA4B,CAAC"}

package/dist/webapp/server.d.ts

@@ -0,0 +1,2 @@
+export * from '../core/server/http.js';
+//# sourceMappingURL=server.d.ts.map

package/dist/webapp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/webapp/server.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC"}

package/dist/webapp/server.js

@@ -0,0 +1,3 @@
+// Re-export shim — canonical location is src/core/server/http.ts
+export * from '../core/server/http.js';
+//# sourceMappingURL=server.js.map

package/dist/webapp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/webapp/server.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,cAAc,wBAAwB,CAAC"}

package/dist/webapp/tests/api.test.d.ts

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

package/dist/webapp/tests/api.test.d.ts.map

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

package/dist/webapp/tests/api.test.js

@@ -0,0 +1,125 @@
+// src/webapp/tests/api.test.ts
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import express from 'express';
+import { initDb, closeDb } from '../../db/index.js';
+import { initVectorStore } from '../../vector/store.js';
+import { MemoryStore } from '../../memory/core/store.js';
+import { memoriesApi } from '../api/memories.js';
+import { viewsApi } from '../api/views.js';
+import { dailyApi } from '../api/daily.js';
+import { settingsApi } from '../api/settings.js';
+import { ulid } from 'ulid';
+const embeddingsConfig = {
+    provider: 'ollama',
+    baseUrl: 'http://localhost:11434',
+    model: 'nomic-embed-text',
+    dimensions: 768,
+};
+describe('webapp REST API', () => {
+    let tmpDir;
+    let store;
+    let app;
+    beforeEach(async () => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'engram-api-'));
+        initDb(tmpDir);
+        initVectorStore(tmpDir);
+        store = new MemoryStore({ embeddings: embeddingsConfig });
+        app = express();
+        // strict: false is required so settings can store any JSON value (string, number, bool, etc.)
+        app.use(express.json({ strict: false }));
+        app.use('/api/memories', memoriesApi(store));
+        app.use('/api/views', viewsApi());
+        app.use('/api/daily', dailyApi());
+        app.use('/api/settings', settingsApi());
+    });
+    afterEach(() => {
+        closeDb();
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('memories: list + get + delete', async () => {
+        const now = new Date().toISOString();
+        const id = ulid();
+        await store.insert({
+            id,
+            type: 'notes',
+            source_id: 'x',
+            content: 'hello',
+            content_hash: 'h',
+            properties: { created_at: now, ingested_at: now },
+            wikilinks: [],
+            related_ids: [],
+            embedding_model: 'm',
+        });
+        const server = app.listen(0);
+        const port = server.address().port;
+        try {
+            const list = await fetch(`http://localhost:${port}/api/memories`);
+            const body = (await list.json());
+            expect(body.some((m) => m.id === id)).toBe(true);
+            const single = await fetch(`http://localhost:${port}/api/memories/${id}`);
+            const itemBody = (await single.json());
+            expect(itemBody.content).toBe('hello');
+            const del = await fetch(`http://localhost:${port}/api/memories/${id}`, {
+                method: 'DELETE',
+            });
+            expect(del.ok).toBe(true);
+            expect(store.getById(id)).toBeUndefined();
+        }
+        finally {
+            await new Promise((resolve) => server.close(() => resolve()));
+        }
+    });
+    it('views: create + list + update + delete', async () => {
+        const server = app.listen(0);
+        const port = server.address().port;
+        try {
+            const create = await fetch(`http://localhost:${port}/api/views`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    name: 'Recent notes',
+                    definition: { filters: [{ field: 'type', op: 'eq', value: 'notes' }] },
+                }),
+            });
+            const { id } = (await create.json());
+            const list = await fetch(`http://localhost:${port}/api/views`);
+            const views = (await list.json());
+            expect(views.find((v) => v.id === id)?.name).toBe('Recent notes');
+            const upd = await fetch(`http://localhost:${port}/api/views/${id}`, {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ name: 'Renamed' }),
+            });
+            expect(upd.ok).toBe(true);
+            const del = await fetch(`http://localhost:${port}/api/views/${id}`, {
+                method: 'DELETE',
+            });
+            expect(del.ok).toBe(true);
+        }
+        finally {
+            await new Promise((resolve) => server.close(() => resolve()));
+        }
+    });
+    it('settings: read/write', async () => {
+        const server = app.listen(0);
+        const port = server.address().port;
+        try {
+            const put = await fetch(`http://localhost:${port}/api/settings/theme`, {
+                method: 'PUT',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify('dark'),
+            });
+            expect(put.ok).toBe(true);
+            const get = await fetch(`http://localhost:${port}/api/settings`);
+            const body = (await get.json());
+            expect(body.theme).toBe('dark');
+        }
+        finally {
+            await new Promise((resolve) => server.close(() => resolve()));
+        }
+    });
+});
+//# sourceMappingURL=api.test.js.map

package/dist/webapp/tests/api.test.js.map

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

package/dist/webapp/tests/mcp-http.test.d.ts

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

package/dist/webapp/tests/mcp-http.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http.test.d.ts","sourceRoot":"","sources":["../../../src/webapp/tests/mcp-http.test.ts"],"names":[],"mappings":""}

package/dist/webapp/tests/mcp-http.test.js

@@ -0,0 +1,47 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import express from 'express';
+import { ToolRouter } from '../../mcp-server/tool-router.js';
+import { mountMcpHttp } from '../mcp-http.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+describe('HTTP MCP transport', () => {
+    let server;
+    let baseUrl;
+    let client;
+    beforeAll(async () => {
+        const router = new ToolRouter();
+        router.register({
+            name: 'echo',
+            description: 'echo back',
+            inputSchema: {
+                type: 'object',
+                properties: { text: { type: 'string' } },
+                required: ['text'],
+            },
+            handler: async (args) => ({ echoed: args.text }),
+        });
+        const app = express();
+        mountMcpHttp(app, router);
+        server = app.listen(0);
+        const address = server.address();
+        const port = typeof address === 'object' && address ? address.port : 0;
+        baseUrl = `http://localhost:${port}`;
+        const transport = new StreamableHTTPClientTransport(new URL(`${baseUrl}/mcp`));
+        client = new Client({ name: 'mcp-http-test', version: '0.0.0' }, { capabilities: {} });
+        await client.connect(transport);
+    }, 15_000);
+    afterAll(async () => {
+        await client.close();
+        await new Promise((resolve) => server.close(() => resolve()));
+    });
+    it('lists tools', async () => {
+        const res = await client.listTools();
+        expect(res.tools.map((t) => t.name)).toContain('echo');
+    });
+    it('calls a tool', async () => {
+        const res = await client.callTool({ name: 'echo', arguments: { text: 'hi' } });
+        const payload = JSON.parse(res.content[0].text);
+        expect(payload.echoed).toBe('hi');
+    });
+});
+//# sourceMappingURL=mcp-http.test.js.map

package/dist/webapp/tests/mcp-http.test.js.map

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

package/dist/webapp/websocket.d.ts

@@ -0,0 +1,2 @@
+export * from '../core/server/websocket.js';
+//# sourceMappingURL=websocket.d.ts.map

package/dist/webapp/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/webapp/websocket.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC"}

package/dist/webapp/websocket.js

@@ -0,0 +1,3 @@
+// Re-export shim — canonical location is src/core/server/websocket.ts
+export * from '../core/server/websocket.js';
+//# sourceMappingURL=websocket.js.map

package/dist/webapp/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/webapp/websocket.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,cAAc,6BAA6B,CAAC"}

package/package.json

@@ -0,0 +1,128 @@
+{
+  "name": "@raviolelabs/engram-mcp",
+  "version": "0.2.0",
+  "description": "EngramMCP \u2014 local-first semantic memory layer for AI agents",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "engram-mcp": "dist/scripts/serve.js",
+    "engram-mcp-install": "dist/scripts/install.js",
+    "engram-mcp-pair": "dist/scripts/pair.js",
+    "engram-mcp-rebuild": "dist/scripts/rebuild.js",
+    "engram-mcp-service": "dist/scripts/service.js"
+  },
+  "scripts": {
+    "dev": "tsx watch src/scripts/serve.ts",
+    "reindex": "tsx src/scripts/reindex.ts",
+    "install:wizard": "tsx src/scripts/install.ts",
+    "pair": "tsx src/scripts/pair.ts",
+    "rebuild": "tsx src/scripts/rebuild.ts",
+    "build": "tsc && chmod +x dist/scripts/serve.js dist/scripts/install.js dist/scripts/pair.js dist/scripts/rebuild.js dist/scripts/service.js",
+    "pack-binary": "tsx scripts/pack-binary.ts",
+    "start": "node dist/scripts/serve.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "dev:client": "vite --config src/client/vite.config.ts",
+    "build:client": "vite build --config src/client/vite.config.ts",
+    "build:all": "npm run build:client && npm run build"
+  },
+  "dependencies": {
+    "@lancedb/lancedb": "0.27.1",
+    "@modelcontextprotocol/sdk": "1.28.0",
+    "@notionhq/client": "2.3.0",
+    "@tanstack/react-query": "^5.50.0",
+    "@types/multer": "^2.1.0",
+    "better-sqlite3": "^12.8.0",
+    "cytoscape": "^3.33.3",
+    "cytoscape-fcose": "^2.2.0",
+    "express": "^5.0.0",
+    "fast-xml-parser": "^5.8.0",
+    "googleapis": "144.0.0",
+    "libsodium-wrappers": "^0.8.4",
+    "multer": "^2.1.1",
+    "node-cron": "3.0.3",
+    "nodejs-whisper": "^0.2.4",
+    "pdf-parse": "^2.4.5",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router-dom": "^7.0.0",
+    "secrets.js-grempe": "^2.0.0",
+    "ulid": "2.4.0",
+    "ws": "^8.18.0",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.3.0",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/cytoscape": "^3.21.9",
+    "@types/express": "^5.0.0",
+    "@types/libsodium-wrappers": "^0.7.14",
+    "@types/node": "^22.0.0",
+    "@types/node-cron": "3.0.11",
+    "@types/pdf-parse": "^1.1.5",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/ws": "^8.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.59.3",
+    "@typescript-eslint/parser": "^8.59.3",
+    "@vitejs/plugin-react": "^4.3.0",
+    "@yao-pkg/pkg": "^5.12.0",
+    "autoprefixer": "^10.4.0",
+    "eslint": "^9.0.0",
+    "postcss": "^8.4.0",
+    "prettier": "^3.0.0",
+    "tailwindcss": "^4.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "vite": "^5.4.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist/",
+    "src/private/README.md",
+    "README.md",
+    "SKILL.md",
+    "CLAUDE.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "pkg": {
+    "assets": [
+      "dist/**/*.json",
+      "dist/**/*.node"
+    ],
+    "scripts": [
+      "dist/**/*.js"
+    ]
+  },
+  "homepage": "https://engram-mcp.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RavioleLabs/engram-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/RavioleLabs/engram-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "semantic-search",
+    "embeddings",
+    "local-first",
+    "rag",
+    "ai-agents",
+    "claude",
+    "cursor"
+  ],
+  "author": "RavioleLabs <hello@raviolelabs.com> (https://raviolelabs.com)"
+}

package/src/private/README.md

@@ -0,0 +1,49 @@
+# src/private/ — Engram Premium Extensions
+
+This directory is **GITIGNORED** and only ships on hosted Engram deployments.
+
+The public OSS repository (`github.com/RavioleLabs/engram-mcp`) does not include this directory.
+When building from source (OSS), the dynamic import in `src/tools/index.ts` gracefully skips this
+directory if it is absent.
+
+## Structure
+
+```
+src/private/
+├── index.ts              # Entry: exports registerPrivateExtensions(ctx)
+├── README.md             # This file
+├── tools/                # Premium MCP tools
+│   ├── smart-search.ts   # Advanced cross-cut semantic ranking (cross-encoder)
+│   ├── auto-categorize.ts # ML-based custom type suggestion
+│   └── index.ts
+├── algorithms/           # Smarter OSS algorithm overrides
+│   ├── advanced-find-related.ts  # Multi-signal weighted relation discovery
+│   └── memory-clustering.ts     # Graph clustering for memory organization
+└── prompts/              # Carefully-tuned LLM prompts (IP)
+    └── extraction-system.ts     # Property extraction system prompt (v2)
+```
+
+## Candidates for migration here (from OSS)
+
+| OSS location | What to move | Status |
+|---|---|---|
+| `src/memory/core/property-extractor.ts` | `SYSTEM_PROMPT` constant | Planned |
+| `src/memory/core/store.ts` `findRelated()` | Advanced multi-signal version | Planned |
+| `src/memory/public/tools.ts` `search_all` | Cross-encoder re-ranking | Planned |
+| `src/memory/public/tools.ts` `suggest_properties` | Optimized prompt template | Planned |
+
+## How to add a new private tool
+
+1. Create `src/private/tools/my-tool.ts` implementing `MCPToolDefinition`
+2. Add a `registerMyTool(ctx)` export
+3. Import and call it from `src/private/index.ts` `registerPrivateExtensions`
+4. The tool will appear in the MCP server alongside public tools
+
+## How to override a public algorithm
+
+1. Create `src/private/algorithms/my-override.ts`
+2. Export a function with the same signature as the OSS version
+3. In `src/private/index.ts`, patch the relevant module/store method:
+   ```ts
+   ctx.store.findRelated = myAdvancedFindRelated.bind(null, ctx.store);
+   ```