@raviolelabs/engram-mcp 0.2.0

package/dist/core/server/instructions.js

@@ -0,0 +1,36 @@
+export const ENGRAM_INSTRUCTIONS = `
+EngramMCP is the user's persistent semantic memory layer.
+
+Tool naming varies by client. Some clients prefix tools with \`mcp__engram__<name>\` (Claude Code) while others use bare names (Anthropic API native, OpenAI API). Use whichever form your runtime exposes.
+
+PRIORITY RULE: When the user asks about themselves — what they did, when, what they prefer, their projects, their notes, decisions, conversations — call \`recall\` or \`recent\` FIRST, before any filesystem search or auto-memory grep.
+
+USE engram WHEN:
+- User asks "what did I do [today/yesterday/recently]?" → recent + recall
+- User asks "remember when I X?" or "what about Y?" → recall(query: "Y")
+- User says "remember that..." or "rappelle-toi..." → remember(content, title, tags)
+- User asks about their past projects, decisions, preferences → recall
+
+DO NOT use engram FOR:
+- Code questions (use file reads / grep)
+- General knowledge (use your training)
+- Web research (use WebFetch / WebSearch)
+
+ANTI-PATTERNS:
+- Calling recall with the verbatim user question. Extract the topic noun first. "what did I say about Alice?" → recall("alice"), NOT recall("what did I say about Alice").
+- Skipping engram and grep-ing ~/.claude/projects/*/memory/. Auto-memory is for Claude's INTERNAL context (user role, project conventions), NOT for the user's personal log.
+- Saving to filesystem when user says "remember". Always use remember(), never write feedback files.
+
+WHEN TO REMEMBER:
+- User shares preferences, facts, decisions, or context worth keeping
+- After a meaningful exchange that establishes new context
+- ALWAYS with title (3-7 words) + 2-5 tags
+
+ANTI-LOOP CONTRACTS:
+- All write tools are idempotent — same content returns same id.
+- If recall returns empty, the answer is genuinely "no memories" — do NOT retry with same query.
+- Respect retry_after_ms hints on get_ingest_status polling.
+
+See the description of each tool for specific anti-loop and retry behavior.
+`.trim();
+//# sourceMappingURL=instructions.js.map

package/dist/core/server/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../src/core/server/instructions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkClC,CAAC,IAAI,EAAE,CAAC"}

package/dist/core/server/mcp-handler.d.ts

@@ -0,0 +1,39 @@
+import { MemoryStore } from '../../memory/core/store.js';
+import { ToolRouter } from './tool-router.js';
+import type { EngramConfig } from '../../config/schema.js';
+export interface EngramAlgorithms {
+    /** Smart findRelated: wikilinks + semantic search with dedup. */
+    findRelated?: (store: MemoryStore, id: string, limit: number) => Promise<import('../../types.js').SearchResult[]>;
+    /** Smart searchAll: per-type weighting, recency boost, MMR diversification. */
+    searchAll?: (store: MemoryStore, query: string, limit: number, types?: string[]) => Promise<Array<{
+        id: string;
+        type: string;
+        score: number;
+        snippet: string;
+        title?: string;
+    }>>;
+    /** Semantic-boundary chunking via local Ollama topic-shift detection. */
+    chunkText?: (text: string, opts?: import('../../memory/core/chunker.js').ChunkOptions) => string[] | Promise<string[]>;
+    /** Pairwise cosine semantic edges for memory graph (capped at 50 nodes). */
+    graphSemanticEdges?: (store: MemoryStore, nodeIds: string[]) => Promise<Array<import('../../webapp/api/graph.js').GraphEdge>>;
+}
+export interface EngramPrompts {
+    /** Full 5-field extraction system prompt (title, tags, sentiment, action_required, summary). */
+    extractionSystemPrompt?: string;
+    /** Verbose 4-field suggest-properties instruction template. */
+    suggestPropertiesInstruction?: (memoryId: string, content: string, currentProps: object) => string;
+}
+export interface EngramRuntime {
+    store: MemoryStore;
+    router: ToolRouter;
+    algorithms: EngramAlgorithms;
+    prompts: EngramPrompts;
+    shutdown: () => Promise<void>;
+}
+export interface BuildEngramRuntimeOptions {
+    /** @deprecated All tools are now always public. This flag is ignored. */
+    adminMode?: boolean;
+}
+export declare function buildEngramRuntime(config: EngramConfig, opts?: BuildEngramRuntimeOptions): Promise<EngramRuntime>;
+export declare function startStdioMcpServer(runtime: EngramRuntime): Promise<void>;
+//# sourceMappingURL=mcp-handler.d.ts.map

package/dist/core/server/mcp-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-handler.d.ts","sourceRoot":"","sources":["../../../src/core/server/mcp-handler.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAiBzD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAa3D,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,gBAAgB,EAAE,YAAY,EAAE,CAAC,CAAC;IAClH,+EAA+E;IAC/E,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACjL,yEAAyE;IACzE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,8BAA8B,EAAE,YAAY,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvH,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,2BAA2B,EAAE,SAAS,CAAC,CAAC,CAAC;CAC/H;AAED,MAAM,WAAW,aAAa;IAC5B,gGAAgG;IAChG,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,+DAA+D;IAC/D,4BAA4B,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;CACpG;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,GAAE,yBAA8B,GAAG,OAAO,CAAC,aAAa,CAAC,CA8J3H;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C/E"}

package/dist/core/server/mcp-handler.js

@@ -0,0 +1,204 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { createLogger } from '../logger.js';
+import { initDb, getDb } from '../db/index.js';
+import { initVectorStore } from '../../vector/store.js';
+import { MemoryStore } from '../../memory/core/store.js';
+import { moduleRegistry } from '../../memory/core/module-registry.js';
+import { createNotesModule } from '../../memory/modules/notes/module.js';
+import { createConversationsModule, } from '../../memory/modules/conversations/module.js';
+import { createDriveModule } from '../../memory/modules/drive/module.js';
+import { createNotionModule } from '../../memory/modules/notion/module.js';
+import { createAudioModule } from '../../memory/modules/audio/module.js';
+import { createYoutubeModule } from '../../memory/modules/youtube/module.js';
+import { buildPublicTools } from '../../memory/public/tools.js';
+import { createObsidianModule, } from '../../memory/modules/obsidian/module.js';
+import { loadAndRegisterCustomTypes, } from '../../memory/modules/_custom/tools.js';
+import { ToolRouter } from './tool-router.js';
+import { ENGRAM_INSTRUCTIONS } from './instructions.js';
+import { startTransitPoller } from '../../cloud/transit-poller.js';
+import { deriveMasterKey } from '../../cloud/crypto.js';
+import { getOrCreateDeviceIdentity } from '../../sync/ed25519.js';
+import { OpsLogger } from '../../sync/ops-log.js';
+import { ReplayApplier } from '../../sync/apply.js';
+import { ChannelClient } from '../../sync/channel-client.js';
+import { replayFromCloud } from '../../sync/replay.js';
+const log = createLogger('mcp-server');
+export async function buildEngramRuntime(config, opts = {}) {
+    initDb(config.dataDir);
+    initVectorStore(config.dataDir);
+    // Startup GC: sweep ingest jobs older than 7 days
+    try {
+        const { gcJobsOnStartup } = await import('../../ingest/jobs.js');
+        gcJobsOnStartup();
+    }
+    catch {
+        // Non-critical
+    }
+    const algorithms = {};
+    const prompts = {};
+    const store = new MemoryStore({
+        embeddings: config.embeddings,
+        propertyExtraction: config.propertyExtraction,
+        algorithms,
+        prompts,
+    });
+    // Register modules
+    moduleRegistry.register(createNotesModule(config));
+    moduleRegistry.register(createConversationsModule(config));
+    moduleRegistry.register(createDriveModule(config));
+    moduleRegistry.register(createNotionModule(config));
+    moduleRegistry.register(createAudioModule(config));
+    moduleRegistry.register(createYoutubeModule(config));
+    moduleRegistry.register(createObsidianModule(config));
+    await moduleRegistry.bootAll({ store });
+    // Build tool router — all 21 tools always registered (no admin flag needed)
+    const router = new ToolRouter();
+    router.registerMany(buildPublicTools(store, config));
+    loadAndRegisterCustomTypes(store, config, router);
+    // --- Cloud transit poller (opt-in, only if user has paired) ---
+    let pollerStop = null;
+    if (config.engramAccount) {
+        const passphrase = process.env.ENGRAM_PASSPHRASE ?? '';
+        if (!passphrase) {
+            log.warn('engramAccount configured but ENGRAM_PASSPHRASE env var not set — ' +
+                'cloud transit poller will not start. Set ENGRAM_PASSPHRASE to activate.');
+        }
+        else {
+            try {
+                const masterKey = await deriveMasterKey(passphrase, config.engramAccount.masterKeySalt);
+                const poller = startTransitPoller({ store, config, masterKey });
+                pollerStop = poller.stop;
+                log.info('Cloud transit poller activated');
+            }
+            catch (e) {
+                log.error(`Failed to start transit poller: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+    }
+    // --- Plan N: Ops-log bidirectional sync (opt-in via config.sync.enabled) ---
+    let channelClientStop = null;
+    if (config.sync?.enabled) {
+        const db = getDb();
+        const identity = getOrCreateDeviceIdentity(db);
+        const passphrase = process.env.ENGRAM_PASSPHRASE ?? '';
+        if (!passphrase) {
+            log.warn('sync.enabled is true but ENGRAM_PASSPHRASE env var not set — ' +
+                'ops logger requires a master key. Set ENGRAM_PASSPHRASE to activate sync.');
+        }
+        else if (!config.sync.cloudBaseUrl) {
+            log.warn('sync.enabled is true but sync.cloudBaseUrl is not set — sync deactivated.');
+        }
+        else {
+            try {
+                // Derive master key from passphrase (same derivation as Plan K)
+                const masterKeySalt = config.engramAccount?.masterKeySalt ?? '';
+                if (!masterKeySalt)
+                    throw new Error('sync requires engramAccount.masterKeySalt');
+                const masterKeyRaw = await deriveMasterKey(passphrase, masterKeySalt);
+                const masterKey = Buffer.from(masterKeyRaw);
+                const opsLogger = new OpsLogger(db, identity, masterKey);
+                store.setOpsLogger(opsLogger);
+                log.info('ops logger wired — all writes will be logged for sync');
+                const applier = new ReplayApplier(db, store, masterKey);
+                const jwtToken = config.engramAccount?.jwt ?? '';
+                const channelClient = new ChannelClient({
+                    cloudBaseUrl: config.sync.cloudBaseUrl,
+                    jwtToken,
+                    deviceId: identity.device_id,
+                    opsLogger,
+                    applier,
+                    localDeviceId: identity.device_id,
+                });
+                // Wire push-on-write events
+                store.events.on('memory.added', () => channelClient.pushNow().catch(() => { }));
+                store.events.on('memory.deleted', () => channelClient.pushNow().catch(() => { }));
+                store.events.on('memory.updated', () => channelClient.pushNow().catch(() => { }));
+                // Boot catch-up replay before starting live subscription
+                log.info('starting boot catch-up replay…');
+                replayFromCloud({
+                    cloudBaseUrl: config.sync.cloudBaseUrl,
+                    jwtToken,
+                    localDeviceId: identity.device_id,
+                    opsLogger,
+                    applier,
+                })
+                    .then(({ applied }) => {
+                    log.info('boot catch-up done', { applied });
+                    channelClient.start();
+                })
+                    .catch((err) => {
+                    log.warn('boot catch-up failed, starting live sub anyway', { err });
+                    channelClient.start();
+                });
+                channelClientStop = () => channelClient.stop();
+                log.info('sync channel client configured', {
+                    deviceId: identity.device_id.slice(0, 8) + '…',
+                    cloudBaseUrl: config.sync.cloudBaseUrl,
+                });
+            }
+            catch (e) {
+                log.error(`Failed to start sync: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+    }
+    const shutdown = async () => {
+        channelClientStop?.();
+        pollerStop?.();
+        await moduleRegistry.shutdownAll();
+    };
+    const runtime = { store, router, algorithms, prompts, shutdown };
+    // Load private extensions (gitignored — only present on hosted Engram deployments).
+    // The path is computed at runtime so TypeScript won't fail when src/private/ is absent.
+    try {
+        const privatePath = new URL('../../private/index.js', import.meta.url).href;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = await import(/* @vite-ignore */ privatePath);
+        await mod.registerPrivateExtensions(runtime);
+        log.info('Private extensions loaded');
+    }
+    catch {
+        log.debug('No private extensions — OSS build');
+    }
+    return runtime;
+}
+export async function startStdioMcpServer(runtime) {
+    const { router } = runtime;
+    const server = new Server({
+        name: 'engram-mcp',
+        version: '0.2.0',
+    }, {
+        capabilities: { tools: {} },
+        instructions: ENGRAM_INSTRUCTIONS,
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: router.list().map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const name = request.params.name;
+        const args = (request.params.arguments ?? {});
+        try {
+            const result = await router.call(name, args);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+            };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            log.warn(`Tool ${name} failed: ${msg}`);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: msg }) }],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log.info('EngramMCP server listening on stdio');
+}
+//# sourceMappingURL=mcp-handler.js.map

package/dist/core/server/mcp-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-handler.js","sourceRoot":"","sources":["../../../src/core/server/mcp-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EACL,yBAAyB,GAC1B,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EACL,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,0BAA0B,GAC3B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAmCvC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAoB,EAAE,OAAkC,EAAE;IACjG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEhC,kDAAkD;IAClD,IAAI,CAAC;QACH,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACjE,eAAe,EAAE,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,MAAM,UAAU,GAAqB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,UAAU;QACV,OAAO;KACR,CAAC,CAAC;IAEH,mBAAmB;IACnB,cAAc,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,cAAc,CAAC,QAAQ,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,cAAc,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,cAAc,CAAC,QAAQ,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IACpD,cAAc,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,cAAc,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IACrD,cAAc,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,MAAM,cAAc,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAExC,4EAA4E;IAC5E,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAChC,MAAM,CAAC,YAAY,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAElD,iEAAiE;IACjE,IAAI,UAAU,GAAwB,IAAI,CAAC;IAC3C,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,GAAG,CAAC,IAAI,CACN,mEAAmE;gBACjE,yEAAyE,CAC5E,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,eAAe,CACrC,UAAU,EACV,MAAM,CAAC,aAAa,CAAC,aAAa,CACnC,CAAC;gBACF,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBAChE,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;gBACzB,GAAG,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,KAAK,CACP,mCAAmC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAChF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,IAAI,iBAAiB,GAAwB,IAAI,CAAC;IAClD,IAAI,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAE/C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;QACvD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,GAAG,CAAC,IAAI,CACN,+DAA+D;gBAC7D,2EAA2E,CAC9E,CAAC;QACJ,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACrC,GAAG,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;QACxF,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,gEAAgE;gBAChE,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,EAAE,aAAa,IAAI,EAAE,CAAC;gBAChE,IAAI,CAAC,aAAa;oBAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;gBAEjF,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;gBACtE,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC5C,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;gBACzD,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;gBAC9B,GAAG,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;gBAElE,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;gBACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,EAAE,GAAG,IAAI,EAAE,CAAC;gBAEjD,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC;oBACtC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY;oBACtC,QAAQ;oBACR,QAAQ,EAAE,QAAQ,CAAC,SAAS;oBAC5B,SAAS;oBACT,OAAO;oBACP,aAAa,EAAE,QAAQ,CAAC,SAAS;iBAClC,CAAC,CAAC;gBAEH,4BAA4B;gBAC5B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;gBAC/E,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;gBACjF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC;gBAEjF,yDAAyD;gBACzD,GAAG,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;gBAC3C,eAAe,CAAC;oBACd,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY;oBACtC,QAAQ;oBACR,aAAa,EAAE,QAAQ,CAAC,SAAS;oBACjC,SAAS;oBACT,OAAO;iBACR,CAAC;qBACC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;oBACpB,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC5C,aAAa,CAAC,KAAK,EAAE,CAAC;gBACxB,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBACb,GAAG,CAAC,IAAI,CAAC,gDAAgD,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;oBACpE,aAAa,CAAC,KAAK,EAAE,CAAC;gBACxB,CAAC,CAAC,CAAC;gBAEL,iBAAiB,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;gBAC/C,GAAG,CAAC,IAAI,CAAC,gCAAgC,EAAE;oBACzC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG;oBAC9C,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY;iBACvC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,KAAK,CACP,yBAAyB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACtE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,iBAAiB,EAAE,EAAE,CAAC;QACtB,UAAU,EAAE,EAAE,CAAC;QACf,MAAM,cAAc,CAAC,WAAW,EAAE,CAAC;IACrC,CAAC,CAAC;IAEF,MAAM,OAAO,GAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAEhF,oFAAoF;IACpF,wFAAwF;IACxF,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QAC5E,8DAA8D;QAC9D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,WAAW,CAAQ,CAAC;QAChE,MAAO,GAAG,CAAC,yBAAiE,CAAC,OAAO,CAAC,CAAC;QACtF,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,GAAG,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAsB;IAC9D,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE3B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,YAAY,EAAE,mBAAmB;KAClC,CACF,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC;KACJ,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;QACjC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAA4B,CAAC;QACzE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;aAC1D,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACvD,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,YAAY,GAAG,EAAE,CAAC,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;gBACjE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;AAClD,CAAC"}

package/dist/core/server/mcp-http.d.ts

@@ -0,0 +1,4 @@
+import type { Express } from 'express';
+import type { ToolRouter } from './tool-router.js';
+export declare function mountMcpHttp(app: Express, router: ToolRouter): void;
+//# sourceMappingURL=mcp-http.d.ts.map

package/dist/core/server/mcp-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-http.d.ts","sourceRoot":"","sources":["../../../src/core/server/mcp-http.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC;AAG1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAsCnD,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAmBnE"}

package/dist/core/server/mcp-http.js

@@ -0,0 +1,56 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import express from 'express';
+import { createLogger } from '../logger.js';
+import { ENGRAM_INSTRUCTIONS } from './instructions.js';
+const log = createLogger('mcp-http');
+function buildServer(router) {
+    const server = new Server({ name: 'engram-mcp', version: '0.2.0' }, { capabilities: { tools: {} }, instructions: ENGRAM_INSTRUCTIONS });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: router.list().map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const name = request.params.name;
+        const args = (request.params.arguments ?? {});
+        try {
+            const result = await router.call(name, args);
+            return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            log.warn(`Tool ${name} failed: ${msg}`);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: msg }) }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+export function mountMcpHttp(app, router) {
+    app.use('/mcp', express.json({ limit: '4mb' }));
+    app.post('/mcp', async (req, res) => {
+        // A fresh Server + Transport per request (stateless mode — sessionIdGenerator: undefined)
+        const server = buildServer(router);
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+        try {
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            log.warn(`MCP HTTP error: ${msg}`);
+            if (!res.headersSent)
+                res.status(500).json({ error: msg });
+        }
+    });
+    log.info('Mounted MCP HTTP transport at POST /mcp');
+}
+//# sourceMappingURL=mcp-http.js.map

package/dist/core/server/mcp-http.js.map

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

package/dist/core/server/tool-router.d.ts

@@ -0,0 +1,9 @@
+import type { MCPToolDefinition } from '../../memory/core/module-interface.js';
+export declare class ToolRouter {
+    private tools;
+    register(tool: MCPToolDefinition): void;
+    registerMany(tools: MCPToolDefinition[]): void;
+    list(): MCPToolDefinition[];
+    call(name: string, args: Record<string, unknown>): Promise<unknown>;
+}
+//# sourceMappingURL=tool-router.d.ts.map

package/dist/core/server/tool-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-router.d.ts","sourceRoot":"","sources":["../../../src/core/server/tool-router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAI/E,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAwC;IAErD,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAOvC,YAAY,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAI9C,IAAI,IAAI,iBAAiB,EAAE;IAIrB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAK1E"}

package/dist/core/server/tool-router.js

@@ -0,0 +1,25 @@
+import { createLogger } from '../logger.js';
+const log = createLogger('tool-router');
+export class ToolRouter {
+    tools = new Map();
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            log.warn(`Tool ${tool.name} re-registered (overwriting)`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    registerMany(tools) {
+        for (const t of tools)
+            this.register(t);
+    }
+    list() {
+        return [...this.tools.values()];
+    }
+    async call(name, args) {
+        const tool = this.tools.get(name);
+        if (!tool)
+            throw new Error(`Unknown tool: ${name}`);
+        return tool.handler(args);
+    }
+}
+//# sourceMappingURL=tool-router.js.map

package/dist/core/server/tool-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-router.js","sourceRoot":"","sources":["../../../src/core/server/tool-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAExC,MAAM,OAAO,UAAU;IACb,KAAK,GAAG,IAAI,GAAG,EAA6B,CAAC;IAErD,QAAQ,CAAC,IAAuB;QAC9B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,8BAA8B,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,YAAY,CAAC,KAA0B;QACrC,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAA6B;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/core/server/websocket.d.ts

@@ -0,0 +1,4 @@
+import type { Server as HttpServer } from 'http';
+import type { MemoryStore } from '../../memory/core/store.js';
+export declare function mountWebSocket(server: HttpServer, store: MemoryStore): void;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/core/server/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/core/server/websocket.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAsB3E"}

package/dist/core/server/websocket.js

@@ -0,0 +1,25 @@
+import { WebSocketServer, WebSocket } from 'ws';
+import { createLogger } from '../logger.js';
+const log = createLogger('webapp:ws');
+export function mountWebSocket(server, store) {
+    const wss = new WebSocketServer({ server, path: '/ws' });
+    const broadcast = (event, data) => {
+        const payload = JSON.stringify({ event, data });
+        for (const client of wss.clients) {
+            if (client.readyState === WebSocket.OPEN) {
+                try {
+                    client.send(payload);
+                }
+                catch (e) {
+                    log.warn(`ws send failed: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+        }
+    };
+    store.events.on('memory.added', (item) => broadcast('memory.added', { id: item.id, type: item.type }));
+    store.events.on('memory.deleted', (data) => broadcast('memory.deleted', data));
+    store.events.on('memory.updated', (data) => broadcast('memory.updated', data));
+    wss.on('connection', () => log.debug('ws client connected'));
+    log.info('WebSocket mounted on /ws');
+}
+//# sourceMappingURL=websocket.js.map

package/dist/core/server/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../../src/core/server/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;AAEtC,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,KAAkB;IACnE,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,IAAa,EAAE,EAAE;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;gBACzC,IAAI,CAAC;oBACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACvB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/E,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC;IAE/E,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC7D,GAAG,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;AACvC,CAAC"}

package/dist/db/index.d.ts

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

package/dist/db/index.d.ts.map

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

package/dist/db/index.js

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

package/dist/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,cAAc,qBAAqB,CAAC"}

package/dist/embeddings/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Embedding dispatcher — routes to the configured provider.
+ *
+ * Supported providers:
+ *   - ollama          (local, Free default — nomic-embed-text)
+ *   - engram          (hosted Pro tier — api.engram-mcp.com, requires apiKey)
+ *   - voyage          (Voyage AI, requires apiKey)
+ *   - openai          (OpenAI, requires apiKey)
+ *   - openai-compatible (BYO endpoint, requires baseUrl)
+ */
+import type { EmbeddingsConfig } from '../config/schema.js';
+/**
+ * Embed a single text string. Returns a Float32Array of the embedding vector.
+ */
+export declare function embed(text: string, config: EmbeddingsConfig): Promise<Float32Array>;
+/**
+ * Embed multiple texts sequentially (avoids overwhelming the provider).
+ */
+export declare function embedBatch(texts: string[], config: EmbeddingsConfig): Promise<Float32Array[]>;
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+export declare function serializeEmbedding(vec: Float32Array): Buffer;
+export declare function deserializeEmbedding(buf: Buffer): Float32Array;
+export declare function checkEmbeddingModel(config: EmbeddingsConfig): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/embeddings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAW5D;;GAEG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsBzF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EAAE,EACf,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB;AAID,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAWzE;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAE5D;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAE9D;AAID,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CASpF"}

package/dist/embeddings/index.js

@@ -0,0 +1,86 @@
+/**
+ * Embedding dispatcher — routes to the configured provider.
+ *
+ * Supported providers:
+ *   - ollama          (local, Free default — nomic-embed-text)
+ *   - engram          (hosted Pro tier — api.engram-mcp.com, requires apiKey)
+ *   - voyage          (Voyage AI, requires apiKey)
+ *   - openai          (OpenAI, requires apiKey)
+ *   - openai-compatible (BYO endpoint, requires baseUrl)
+ */
+import { createLogger } from '../logger.js';
+import { embedOllama } from './providers/ollama.js';
+import { embedEngram } from './providers/engram.js';
+import { embedVoyage } from './providers/voyage.js';
+import { embedOpenAI } from './providers/openai.js';
+import { embedOpenAICompat } from './providers/openai-compat.js';
+const log = createLogger('embeddings');
+// ─── Core embed call ──────────────────────────────────────────────────────────
+/**
+ * Embed a single text string. Returns a Float32Array of the embedding vector.
+ */
+export async function embed(text, config) {
+    switch (config.provider) {
+        case 'ollama':
+            return embedOllama(text, config);
+        case 'engram':
+        case 'engram-hosted':
+            return embedEngram(text, config);
+        case 'voyage':
+            return embedVoyage(text, config);
+        case 'openai':
+            return embedOpenAI(text, config);
+        case 'openai-compatible':
+            if (!config.baseUrl)
+                throw new Error('openai-compatible requires baseUrl');
+            return embedOpenAICompat(text, {
+                baseUrl: config.baseUrl,
+                model: config.model,
+                apiKey: config.apiKey,
+                dimensions: config.dimensions,
+            });
+        default:
+            throw new Error(`Unknown embeddings provider: ${config.provider}`);
+    }
+}
+/**
+ * Embed multiple texts sequentially (avoids overwhelming the provider).
+ */
+export async function embedBatch(texts, config) {
+    const out = [];
+    for (const t of texts)
+        out.push(await embed(t, config));
+    return out;
+}
+// ─── Math ─────────────────────────────────────────────────────────────────────
+export function cosineSimilarity(a, b) {
+    let dot = 0, nA = 0, nB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        nA += a[i] * a[i];
+        nB += b[i] * b[i];
+    }
+    if (nA === 0 || nB === 0)
+        return 0;
+    return dot / (Math.sqrt(nA) * Math.sqrt(nB));
+}
+// ─── SQLite serialization ─────────────────────────────────────────────────────
+export function serializeEmbedding(vec) {
+    return Buffer.from(vec.buffer);
+}
+export function deserializeEmbedding(buf) {
+    return new Float32Array(buf.buffer, buf.byteOffset, buf.byteLength / 4);
+}
+// ─── Health check ─────────────────────────────────────────────────────────────
+export async function checkEmbeddingModel(config) {
+    try {
+        await embed('test', config);
+        log.info(`Embedding model ready: ${config.provider}/${config.model}`);
+        return true;
+    }
+    catch (e) {
+        log.warn(`Embedding model unavailable: ${e instanceof Error ? e.message : String(e)}`);
+        return false;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/embeddings/index.js.map

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

package/dist/embeddings/providers/engram.d.ts

@@ -0,0 +1,7 @@
+import type { EmbeddingsConfig } from '../../config/schema.js';
+/**
+ * Embed a single text via the Engram-hosted endpoint.
+ * Internally uses the batch API (texts: [text]) and returns the first vector.
+ */
+export declare function embedEngram(text: string, config: EmbeddingsConfig): Promise<Float32Array>;
+//# sourceMappingURL=engram.d.ts.map

package/dist/embeddings/providers/engram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engram.d.ts","sourceRoot":"","sources":["../../../src/embeddings/providers/engram.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAwE/F"}