@raviolelabs/engram-mcp 0.2.0

package/dist/memory/modules/notes/tests/notes.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { initDb, closeDb } from '../../../../db/index.js';
+import { initVectorStore } from '../../../../vector/store.js';
+import { MemoryStore } from '../../../core/store.js';
+import { createNotesModule, buildNotesModuleTools } from '../module.js';
+const config = {
+    dataDir: '~/.engram',
+    embeddings: { provider: 'ollama', baseUrl: 'http://localhost:11434', model: 'nomic-embed-text', dimensions: 768 },
+    drive: undefined,
+    notion: undefined,
+    propertyExtraction: {
+        enabled: true,
+        baseUrl: 'http://localhost:11434',
+        model: 'llama3.2:3b',
+        maxTokens: 300,
+    },
+    whisper: { enabled: true, model: 'small.en', language: 'auto' },
+    youtube: { enabled: true, preferLanguage: 'en', fallbackToYtdlp: true },
+    modules: { notes: { enabled: true } },
+    mcp: { stdio: true, httpPort: 7777 },
+};
+describe('notes module', () => {
+    let tmpDir;
+    let store;
+    beforeEach(async () => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'engram-notes-'));
+        initDb(tmpDir);
+        initVectorStore(tmpDir);
+        store = new MemoryStore({ embeddings: config.embeddings });
+        const mod = createNotesModule(config);
+        await mod.onBoot({ store });
+    });
+    afterEach(() => {
+        closeDb();
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('add_note tool inserts and search_notes retrieves it', async () => {
+        const tools = buildNotesModuleTools(store, config);
+        const addNote = tools.find((t) => t.name === 'add_note');
+        const searchNotes = tools.find((t) => t.name === 'search_notes');
+        await addNote.handler({ content: 'EngramMCP is a memory layer for AI agents' });
+        const results = (await searchNotes.handler({ query: 'AI memory' }));
+        expect(results.length).toBeGreaterThan(0);
+        expect(results[0].score).toBeGreaterThan(0);
+    });
+    it('extracts wikilinks from content', async () => {
+        const mod = createNotesModule(config);
+        await mod.onBoot({ store });
+        const items = await mod.ingest({
+            content: 'See [[ProjectX]] and [[Notes]].',
+            source_id: 'manual:test',
+        });
+        expect(items[0].wikilinks).toEqual(['ProjectX', 'Notes']);
+    });
+});
+//# sourceMappingURL=notes.test.js.map

package/dist/memory/modules/notes/tests/notes.test.js.map

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

package/dist/memory/modules/notes/tools.d.ts

@@ -0,0 +1,5 @@
+import type { MCPToolDefinition } from '../../core/module-interface.js';
+import type { MemoryStore } from '../../core/store.js';
+import type { EngramConfig } from '../../../config/schema.js';
+export declare function buildNotesTools(store: MemoryStore, config: EngramConfig): MCPToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/memory/modules/notes/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/notes/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,iBAAiB,EAAE,CAuE7F"}

package/dist/memory/modules/notes/tools.js

@@ -0,0 +1,69 @@
+import { buildNoteItem } from './ingest.js';
+export function buildNotesTools(store, config) {
+    return [
+        {
+            name: 'add_note',
+            description: 'Add a free-form text note to memory. Use this when the user wants to save a thought, idea, or piece of text. IMPORTANT: you (the calling LLM) should ALWAYS provide a short `title` (3-7 words summarizing the content) and 3-5 lowercase `tags`. EngramMCP does not run an LLM internally — you are the LLM that understands this content, so you must label it. Memories without title/tags are harder to retrieve later.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    content: { type: 'string', description: 'The note text (verbatim)' },
+                    title: {
+                        type: 'string',
+                        description: 'Short title summarizing the note (3-7 words). Required for good retrieval.',
+                    },
+                    tags: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: '3-5 lowercase keywords. Required for good retrieval.',
+                    },
+                    source_id: { type: 'string', description: 'Optional source identifier' },
+                },
+                required: ['content'],
+            },
+            handler: async (args) => {
+                const content = args.content;
+                const source_id = args.source_id ?? `manual:${Date.now()}`;
+                const title = args.title;
+                const tags = args.tags;
+                const item = buildNoteItem({
+                    content,
+                    source_id,
+                    properties: { title, tags },
+                }, `${config.embeddings.provider}/${config.embeddings.model}`);
+                await store.insert(item);
+                const response = { id: item.id, type: item.type };
+                if (!title || !tags || tags.length === 0) {
+                    response.hint =
+                        'You did not provide title and/or tags. Consider calling update with a 3-7 word title and 3-5 tags so this memory is retrievable later.';
+                }
+                return response;
+            },
+        },
+        {
+            name: 'search_notes',
+            description: 'Search the user\'s notes by semantic similarity. Returns ranked results with snippets.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string' },
+                    limit: { type: 'number', default: 10 },
+                },
+                required: ['query'],
+            },
+            handler: async (args) => {
+                const query = args.query;
+                const limit = args.limit ?? 10;
+                const hits = await store.search('notes', query, limit);
+                return hits.map((h) => ({
+                    id: h.memory.id,
+                    score: h.score,
+                    snippet: h.snippet,
+                    title: h.memory.properties.title,
+                    tags: h.memory.properties.tags,
+                }));
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/memory/modules/notes/tools.js.map

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

package/dist/memory/modules/notion/connector.d.ts

@@ -0,0 +1,10 @@
+export interface NotionPageMetadata {
+    id: string;
+    title: string;
+    last_edited_time: string;
+    url: string;
+}
+export declare function getPageMetadata(pageId: string): Promise<NotionPageMetadata>;
+export declare function fetchPageText(pageId: string, depth?: number): Promise<string>;
+export declare function searchPages(query: string, limit?: number): Promise<NotionPageMetadata[]>;
+//# sourceMappingURL=connector.d.ts.map

package/dist/memory/modules/notion/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/notion/connector.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgBjF;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1F;AAgED,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAqB1F"}

package/dist/memory/modules/notion/connector.js

@@ -0,0 +1,112 @@
+import { Client } from '@notionhq/client';
+import { createLogger } from '../../../logger.js';
+import { getNotionToken } from './oauth.js';
+const log = createLogger('notion:connector');
+const DEFAULT_DEPTH = 3;
+const BLOCK_BUDGET = 500;
+const CONTENT_CAP = 50_000;
+function client() {
+    return new Client({ auth: getNotionToken() });
+}
+async function withRetry(fn, label) {
+    for (let attempt = 0; attempt < 3; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (e) {
+            const err = e;
+            if (err.status === 429) {
+                const retryAfter = Number(err.headers?.['retry-after'] ?? 5);
+                const waitMs = retryAfter * 1000 * Math.pow(2, attempt);
+                log.warn(`[notion] 429 on ${label} — retry ${attempt + 1}/3 after ${waitMs}ms`);
+                await new Promise((r) => setTimeout(r, waitMs));
+                continue;
+            }
+            throw e;
+        }
+    }
+    throw new Error(`${label} failed after retries`);
+}
+export async function getPageMetadata(pageId) {
+    const c = client();
+    const page = (await withRetry(() => c.pages.retrieve({ page_id: pageId }), 'pages.retrieve'));
+    const titleProp = Object.values(page.properties).find((p) => p.type === 'title');
+    const title = titleProp?.title?.map((t) => t.plain_text).join('') ?? '(untitled)';
+    return {
+        id: page.id,
+        title,
+        last_edited_time: page.last_edited_time,
+        url: page.url,
+    };
+}
+export async function fetchPageText(pageId, depth = DEFAULT_DEPTH) {
+    const c = client();
+    const ctx = { blocksFetched: 0 };
+    return await fetchBlocks(c, pageId, depth, ctx);
+}
+async function fetchBlocks(c, blockId, remainingDepth, ctx) {
+    if (remainingDepth < 0 || ctx.blocksFetched > BLOCK_BUDGET)
+        return '';
+    let cursor;
+    const parts = [];
+    do {
+        const res = await withRetry(() => c.blocks.children.list({
+            block_id: blockId,
+            start_cursor: cursor,
+            page_size: 100,
+        }), 'blocks.children.list');
+        cursor = res.has_more ? res.next_cursor : undefined;
+        for (const b of res.results) {
+            ctx.blocksFetched++;
+            if (ctx.blocksFetched > BLOCK_BUDGET)
+                break;
+            parts.push(blockToText(b));
+            if (b.has_children && remainingDepth > 0) {
+                parts.push(await fetchBlocks(c, b.id, remainingDepth - 1, ctx));
+            }
+        }
+    } while (cursor);
+    return parts.join('\n').slice(0, CONTENT_CAP);
+}
+function blockToText(b) {
+    const type = b.type;
+    const data = b[type];
+    if (!data)
+        return '';
+    const richText = data.rich_text ?? [];
+    const text = richText.map((rt) => rt.plain_text).join('');
+    switch (type) {
+        case 'heading_1': return `# ${text}`;
+        case 'heading_2': return `## ${text}`;
+        case 'heading_3': return `### ${text}`;
+        case 'bulleted_list_item': return `- ${text}`;
+        case 'numbered_list_item': return `1. ${text}`;
+        case 'to_do': return `[${data.checked ? 'x' : ' '}] ${text}`;
+        case 'paragraph':
+        case 'quote':
+        case 'callout': return text;
+        case 'code': {
+            const language = data.language ?? '';
+            return `\`\`\`${language}\n${text}\n\`\`\``;
+        }
+        default: return text;
+    }
+}
+export async function searchPages(query, limit = 25) {
+    const c = client();
+    const res = (await withRetry(() => c.search({
+        query,
+        filter: { property: 'object', value: 'page' },
+        page_size: limit,
+    }), 'search'));
+    return res.results.map((page) => {
+        const titleProp = Object.values(page.properties).find((p) => p.type === 'title');
+        return {
+            id: page.id,
+            title: titleProp?.title?.map((t) => t.plain_text).join('') ?? '(untitled)',
+            last_edited_time: page.last_edited_time,
+            url: page.url,
+        };
+    });
+}
+//# sourceMappingURL=connector.js.map

package/dist/memory/modules/notion/connector.js.map

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

package/dist/memory/modules/notion/ingest.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryItem } from '../../../types.js';
+import type { NotionPageMetadata } from './connector.js';
+export interface NotionIngestInput {
+    metadata: NotionPageMetadata;
+    content: string;
+    embeddingModel: string;
+}
+export declare function buildNotionItem(input: NotionIngestInput): MemoryItem;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/memory/modules/notion/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/notion/ingest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,UAAU,CAoBpE"}

package/dist/memory/modules/notion/ingest.js

@@ -0,0 +1,24 @@
+import { ulid } from 'ulid';
+import { createHash } from 'crypto';
+export function buildNotionItem(input) {
+    const now = new Date().toISOString();
+    const properties = {
+        title: input.metadata.title,
+        created_at: input.metadata.last_edited_time,
+        ingested_at: now,
+        source_url: input.metadata.url,
+        custom: { notion_page_id: input.metadata.id },
+    };
+    return {
+        id: ulid(),
+        type: 'notion',
+        source_id: `notion:${input.metadata.id}`,
+        content: input.content,
+        content_hash: createHash('sha256').update(input.content).digest('hex'),
+        properties,
+        wikilinks: [],
+        related_ids: [],
+        embedding_model: input.embeddingModel,
+    };
+}
+//# sourceMappingURL=ingest.js.map

package/dist/memory/modules/notion/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../../src/memory/modules/notion/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAUpC,MAAM,UAAU,eAAe,CAAC,KAAwB;IACtD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,UAAU,GAAqB;QACnC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK;QAC3B,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,gBAAgB;QAC3C,WAAW,EAAE,GAAG;QAChB,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG;QAC9B,MAAM,EAAE,EAAE,cAAc,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE;KAC9C,CAAC;IACF,OAAO;QACL,EAAE,EAAE,IAAI,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,UAAU,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE;QACxC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACtE,UAAU;QACV,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,KAAK,CAAC,cAAc;KACtC,CAAC;AACJ,CAAC"}

package/dist/memory/modules/notion/module.d.ts

@@ -0,0 +1,6 @@
+import type { MemoryModule } from '../../core/module-interface.js';
+import type { MemoryStore } from '../../core/store.js';
+import type { EngramConfig } from '../../../config/schema.js';
+export declare function createNotionModule(config: EngramConfig): MemoryModule;
+export declare function buildNotionModuleTools(store: MemoryStore, config: EngramConfig): import("../../core/module-interface.js").MCPToolDefinition[];
+//# sourceMappingURL=module.d.ts.map

package/dist/memory/modules/notion/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/notion/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA6BrE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,gEAE9E"}

package/dist/memory/modules/notion/module.js

@@ -0,0 +1,31 @@
+import { buildNotionTools } from './tools.js';
+import { startNotionWatcher, stopNotionWatcher } from './watcher.js';
+export function createNotionModule(config) {
+    let store = null;
+    return {
+        id: 'notion',
+        displayName: 'Notion',
+        isCustom: false,
+        async onBoot(ctx) {
+            store = ctx.store;
+        },
+        async onShutdown() {
+            stopNotionWatcher();
+        },
+        async ingest() {
+            throw new Error('notion.ingest is not used; use the ingest_notion_page MCP tool');
+        },
+        startWatcher() {
+            if (store)
+                startNotionWatcher(store, config);
+        },
+        stopWatcher() {
+            stopNotionWatcher();
+        },
+        tools: [],
+    };
+}
+export function buildNotionModuleTools(store, config) {
+    return buildNotionTools(store, config);
+}
+//# sourceMappingURL=module.js.map

package/dist/memory/modules/notion/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../../src/memory/modules/notion/module.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,IAAI,KAAK,GAAuB,IAAI,CAAC;IACrC,OAAO;QACL,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,KAAK;QAEf,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,UAAU;YACd,iBAAiB,EAAE,CAAC;QACtB,CAAC;QAED,KAAK,CAAC,MAAM;YACV,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QAED,YAAY;YACV,IAAI,KAAK;gBAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;QAED,WAAW;YACT,iBAAiB,EAAE,CAAC;QACtB,CAAC;QAED,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAkB,EAAE,MAAoB;IAC7E,OAAO,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/memory/modules/notion/oauth.d.ts

@@ -0,0 +1,19 @@
+import type { EngramConfig } from '../../../config/schema.js';
+export interface NotionTokens {
+    access_token: string;
+    bot_id: string;
+    workspace_id: string;
+    workspace_name: string;
+    workspace_icon?: string;
+}
+export declare function isNotionConnected(): boolean;
+export declare function getNotionToken(): string;
+export declare function getNotionWorkspace(): {
+    id: string;
+    name: string;
+} | undefined;
+export declare function startNotionOAuthFlow(config: EngramConfig): Promise<{
+    authUrl: string;
+    waitForCallback: Promise<NotionTokens>;
+}>;
+//# sourceMappingURL=oauth.d.ts.map

package/dist/memory/modules/notion/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/notion/oauth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAmCD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED,wBAAgB,kBAAkB,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAI7E;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;CAAE,CAAC,CA4EtE"}

package/dist/memory/modules/notion/oauth.js

@@ -0,0 +1,117 @@
+import http from 'http';
+import { URL } from 'url';
+import { getDb } from '../../../db/index.js';
+import { createLogger } from '../../../logger.js';
+const log = createLogger('notion:oauth');
+function loadTokens() {
+    const row = getDb()
+        .prepare(`SELECT access_token, extra_json FROM oauth_tokens WHERE provider = 'notion'`)
+        .get();
+    if (!row)
+        return undefined;
+    const extra = row.extra_json ? JSON.parse(row.extra_json) : {};
+    return {
+        access_token: row.access_token,
+        bot_id: extra.bot_id ?? '',
+        workspace_id: extra.workspace_id ?? '',
+        workspace_name: extra.workspace_name ?? '',
+        workspace_icon: extra.workspace_icon,
+    };
+}
+function saveTokens(t) {
+    const extra = {
+        bot_id: t.bot_id,
+        workspace_id: t.workspace_id,
+        workspace_name: t.workspace_name,
+        workspace_icon: t.workspace_icon,
+    };
+    getDb()
+        .prepare(`INSERT OR REPLACE INTO oauth_tokens
+         (provider, access_token, refresh_token, expires_at, extra_json, updated_at)
+       VALUES ('notion', ?, NULL, NULL, ?, ?)`)
+        .run(t.access_token, JSON.stringify(extra), Date.now());
+}
+export function isNotionConnected() {
+    return !!loadTokens();
+}
+export function getNotionToken() {
+    const t = loadTokens();
+    if (!t)
+        throw new Error('Notion not connected — run connect_notion first');
+    return t.access_token;
+}
+export function getNotionWorkspace() {
+    const t = loadTokens();
+    if (!t)
+        return undefined;
+    return { id: t.workspace_id, name: t.workspace_name };
+}
+export async function startNotionOAuthFlow(config) {
+    if (!config.notion)
+        throw new Error('notion.clientId/clientSecret not configured');
+    const { clientId, clientSecret, redirectPort } = config.notion;
+    const redirectUri = `http://localhost:${redirectPort}/oauth/callback/notion`;
+    const authUrl = new URL('https://api.notion.com/v1/oauth/authorize');
+    authUrl.searchParams.set('client_id', clientId);
+    authUrl.searchParams.set('redirect_uri', redirectUri);
+    authUrl.searchParams.set('response_type', 'code');
+    authUrl.searchParams.set('owner', 'user');
+    const waitForCallback = new Promise((resolve, reject) => {
+        const server = http.createServer(async (req, res) => {
+            if (!req.url?.startsWith('/oauth/callback/notion')) {
+                res.writeHead(404).end();
+                return;
+            }
+            const u = new URL(req.url, `http://localhost:${redirectPort}`);
+            const code = u.searchParams.get('code');
+            if (!code) {
+                res.writeHead(400).end('Missing code');
+                return;
+            }
+            try {
+                const basic = Buffer.from(`${clientId}:${clientSecret}`).toString('base64');
+                const tokenRes = await fetch('https://api.notion.com/v1/oauth/token', {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                        Authorization: `Basic ${basic}`,
+                    },
+                    body: JSON.stringify({
+                        grant_type: 'authorization_code',
+                        code,
+                        redirect_uri: redirectUri,
+                    }),
+                });
+                if (!tokenRes.ok) {
+                    const txt = await tokenRes.text();
+                    throw new Error(`Notion token exchange failed: ${tokenRes.status} ${txt.slice(0, 300)}`);
+                }
+                const data = (await tokenRes.json());
+                const tokens = {
+                    access_token: data.access_token,
+                    bot_id: data.bot_id,
+                    workspace_id: data.workspace_id,
+                    workspace_name: data.workspace_name,
+                    workspace_icon: data.workspace_icon,
+                };
+                saveTokens(tokens);
+                res.writeHead(200, { 'Content-Type': 'text/html' });
+                res.end(`<html><body><h2>Connected to Notion workspace: ${tokens.workspace_name}.</h2><p>You can close this tab.</p></body></html>`);
+                server.close();
+                log.info(`Notion OAuth completed for workspace ${tokens.workspace_name}`);
+                resolve(tokens);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                res.writeHead(500).end(`Error: ${msg}`);
+                server.close();
+                reject(e);
+            }
+        });
+        server.listen(redirectPort, () => {
+            log.info(`Notion OAuth callback server listening on :${redirectPort}`);
+        });
+    });
+    return { authUrl: authUrl.toString(), waitForCallback };
+}
+//# sourceMappingURL=oauth.js.map

package/dist/memory/modules/notion/oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.js","sourceRoot":"","sources":["../../../../src/memory/modules/notion/oauth.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,GAAG,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAUzC,SAAS,UAAU;IACjB,MAAM,GAAG,GAAG,KAAK,EAAE;SAChB,OAAO,CACN,6EAA6E,CAC9E;SACA,GAAG,EAAqE,CAAC;IAC5E,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,OAAO;QACL,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;QAC1B,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;QACtC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,EAAE;QAC1C,cAAc,EAAE,KAAK,CAAC,cAAc;KACrC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,CAAe;IACjC,MAAM,KAAK,GAAG;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,cAAc,EAAE,CAAC,CAAC,cAAc;QAChC,cAAc,EAAE,CAAC,CAAC,cAAc;KACjC,CAAC;IACF,KAAK,EAAE;SACJ,OAAO,CACN;;8CAEwC,CACzC;SACA,GAAG,CAAC,CAAC,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC3E,OAAO,CAAC,CAAC,YAAY,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAoB;IAEpB,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACnF,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/D,MAAM,WAAW,GAAG,oBAAoB,YAAY,wBAAwB,CAAC;IAE7E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,2CAA2C,CAAC,CAAC;IACrE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAChD,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACtD,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAClD,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAE1C,MAAM,eAAe,GAAG,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YAClD,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,wBAAwB,CAAC,EAAE,CAAC;gBACnD,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;gBACzB,OAAO;YACT,CAAC;YACD,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,oBAAoB,YAAY,EAAE,CAAC,CAAC;YAC/D,MAAM,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBACvC,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC5E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,uCAAuC,EAAE;oBACpE,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;wBAClC,aAAa,EAAE,SAAS,KAAK,EAAE;qBAChC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,UAAU,EAAE,oBAAoB;wBAChC,IAAI;wBACJ,YAAY,EAAE,WAAW;qBAC1B,CAAC;iBACH,CAAC,CAAC;gBACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;oBAClC,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC3F,CAAC;gBACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAMlC,CAAC;gBACF,MAAM,MAAM,GAAiB;oBAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,cAAc,EAAE,IAAI,CAAC,cAAc;oBACnC,cAAc,EAAE,IAAI,CAAC,cAAc;iBACpC,CAAC;gBACF,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC;gBACpD,GAAG,CAAC,GAAG,CACL,kDAAkD,MAAM,CAAC,cAAc,oDAAoD,CAC5H,CAAC;gBACF,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,GAAG,CAAC,IAAI,CAAC,wCAAwC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;gBAC1E,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvD,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;gBACxC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,CAAC,CAAC,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,GAAG,EAAE;YAC/B,GAAG,CAAC,IAAI,CAAC,8CAA8C,YAAY,EAAE,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,CAAC;AAC1D,CAAC"}

package/dist/memory/modules/notion/tests/notion.test.d.ts

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

package/dist/memory/modules/notion/tests/notion.test.d.ts.map

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

package/dist/memory/modules/notion/tests/notion.test.js

@@ -0,0 +1,53 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { initDb, closeDb, getDb } from '../../../../db/index.js';
+import { initVectorStore } from '../../../../vector/store.js';
+import { MemoryStore } from '../../../core/store.js';
+import { isNotionConnected, getNotionToken } from '../oauth.js';
+import { buildNotionItem } from '../ingest.js';
+const embeddingsConfig = {
+    provider: 'ollama',
+    baseUrl: 'http://localhost:11434',
+    model: 'nomic-embed-text',
+    dimensions: 768,
+};
+describe('notion module integration (token + ingest)', () => {
+    let tmpDir;
+    let store;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'engram-notion-'));
+        initDb(tmpDir);
+        initVectorStore(tmpDir);
+        store = new MemoryStore({ embeddings: embeddingsConfig });
+    });
+    afterEach(() => {
+        closeDb();
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('stores OAuth tokens via direct DB write and reads them back', () => {
+        getDb()
+            .prepare(`INSERT INTO oauth_tokens (provider, access_token, refresh_token, expires_at, extra_json, updated_at)
+         VALUES ('notion', 'secret_xyz', NULL, NULL, '{"workspace_id":"w1","workspace_name":"MyOrg","bot_id":"b1"}', ?)`)
+            .run(Date.now());
+        expect(isNotionConnected()).toBe(true);
+        expect(getNotionToken()).toBe('secret_xyz');
+    });
+    it('buildNotionItem + insert + search', async () => {
+        const item = buildNotionItem({
+            metadata: {
+                id: 'page-1',
+                title: 'Engineering Standards',
+                last_edited_time: '2026-05-15T10:00:00Z',
+                url: 'https://www.notion.so/Engineering-Standards-page-1',
+            },
+            content: 'Use TypeScript strict mode. Use ULIDs. Avoid `any` type.',
+            embeddingModel: 'nomic-embed-text:v1.5',
+        });
+        await store.insert(item);
+        const hits = await store.search('notion', 'TypeScript guidelines', 5);
+        expect(hits[0].memory.id).toBe(item.id);
+    });
+});
+//# sourceMappingURL=notion.test.js.map

package/dist/memory/modules/notion/tests/notion.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion.test.js","sourceRoot":"","sources":["../../../../../src/memory/modules/notion/tests/notion.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,gBAAgB,GAAG;IACvB,QAAQ,EAAE,QAAiB;IAC3B,OAAO,EAAE,wBAAwB;IACjC,KAAK,EAAE,kBAAkB;IACzB,UAAU,EAAE,GAAG;CAChB,CAAC;AAEF,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,IAAI,MAAc,CAAC;IACnB,IAAI,KAAkB,CAAC;IAEvB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,CAAC;QACf,eAAe,CAAC,MAAM,CAAC,CAAC;QACxB,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,CAAC;QACV,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,KAAK,EAAE;aACJ,OAAO,CACN;wHACgH,CACjH;aACA,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACnB,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,IAAI,GAAG,eAAe,CAAC;YAC3B,QAAQ,EAAE;gBACR,EAAE,EAAE,QAAQ;gBACZ,KAAK,EAAE,uBAAuB;gBAC9B,gBAAgB,EAAE,sBAAsB;gBACxC,GAAG,EAAE,oDAAoD;aAC1D;YACD,OAAO,EAAE,0DAA0D;YACnE,cAAc,EAAE,uBAAuB;SACxC,CAAC,CAAC;QACH,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,uBAAuB,EAAE,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/memory/modules/notion/tools.d.ts

@@ -0,0 +1,5 @@
+import type { MCPToolDefinition } from '../../core/module-interface.js';
+import type { MemoryStore } from '../../core/store.js';
+import type { EngramConfig } from '../../../config/schema.js';
+export declare function buildNotionTools(store: MemoryStore, config: EngramConfig): MCPToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/memory/modules/notion/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/notion/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAQ9D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,iBAAiB,EAAE,CAsH9F"}