@raviolelabs/engram-mcp 0.2.0

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

@@ -0,0 +1,116 @@
+import { createLogger } from '../../../logger.js';
+import { searchPages, getPageMetadata, fetchPageText } from './connector.js';
+import { startNotionOAuthFlow, isNotionConnected, getNotionWorkspace } from './oauth.js';
+import { buildNotionItem } from './ingest.js';
+import { sourceRegistry } from '../../core/source-registry.js';
+const log = createLogger('notion:tools');
+export function buildNotionTools(store, config) {
+    const embeddingModel = `${config.embeddings.provider}/${config.embeddings.model}`;
+    return [
+        {
+            name: 'connect_notion',
+            description: 'Start a Notion OAuth flow. Returns an auth URL the user opens in a browser. After consent, tokens are saved locally (workspace-scoped).',
+            inputSchema: { type: 'object', properties: {} },
+            handler: async () => {
+                if (isNotionConnected()) {
+                    const ws = getNotionWorkspace();
+                    return { already_connected: true, workspace: ws?.name };
+                }
+                const flow = await startNotionOAuthFlow(config);
+                const result = await Promise.race([
+                    flow.waitForCallback.then((t) => ({ connected: true, workspace: t.workspace_name })),
+                    new Promise((resolve) => setTimeout(() => resolve({ timeout: true }), 300_000)),
+                ]);
+                return { auth_url: flow.authUrl, ...result };
+            },
+        },
+        {
+            name: 'list_notion_pages',
+            description: 'Search the user\'s Notion workspace for pages.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string' },
+                    limit: { type: 'number', default: 25 },
+                },
+            },
+            handler: async (args) => {
+                if (!isNotionConnected())
+                    return { error: 'Notion not connected' };
+                return await searchPages(args.query ?? '', args.limit ?? 25);
+            },
+        },
+        {
+            name: 'ingest_notion_page',
+            description: 'Fetch one Notion page now and index it. No watching.',
+            inputSchema: {
+                type: 'object',
+                properties: { page_id: { type: 'string' } },
+                required: ['page_id'],
+            },
+            handler: async (args) => {
+                const meta = await getPageMetadata(args.page_id);
+                const content = await fetchPageText(meta.id);
+                const item = buildNotionItem({ metadata: meta, content, embeddingModel });
+                await store.insert(item);
+                log.info(`Ingested Notion page ${meta.title} as ${item.id}`);
+                return { id: item.id, title: meta.title };
+            },
+        },
+        {
+            name: 'watch_notion_page',
+            description: 'Add a Notion page to the watched-sources list. Re-synced every 15 min.',
+            inputSchema: {
+                type: 'object',
+                properties: { page_id: { type: 'string' } },
+                required: ['page_id'],
+            },
+            handler: async (args) => {
+                const meta = await getPageMetadata(args.page_id);
+                const sourceId = sourceRegistry.add({
+                    module_id: 'notion',
+                    external_id: meta.id,
+                    display_name: meta.title,
+                });
+                const content = await fetchPageText(meta.id);
+                const item = buildNotionItem({ metadata: meta, content, embeddingModel });
+                await store.insert(item);
+                sourceRegistry.recordSync(sourceId, meta.last_edited_time);
+                return { source_id: sourceId, watching: meta.title };
+            },
+        },
+        {
+            name: 'unwatch_notion_page',
+            description: 'Remove a Notion page from the watched list.',
+            inputSchema: {
+                type: 'object',
+                properties: { source_id: { type: 'string' } },
+                required: ['source_id'],
+            },
+            handler: async (args) => {
+                sourceRegistry.remove(args.source_id);
+                return { removed: true };
+            },
+        },
+        {
+            name: 'search_notion',
+            description: 'Search ingested Notion pages by semantic similarity.',
+            inputSchema: {
+                type: 'object',
+                properties: { query: { type: 'string' }, limit: { type: 'number', default: 10 } },
+                required: ['query'],
+            },
+            handler: async (args) => {
+                const hits = await store.search('notion', args.query, args.limit ?? 10);
+                return hits.map((h) => ({
+                    id: h.memory.id,
+                    score: h.score,
+                    snippet: h.snippet,
+                    title: h.memory.properties.title,
+                    source_url: h.memory.properties.source_url,
+                }));
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

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

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

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

@@ -0,0 +1,5 @@
+import type { MemoryStore } from '../../core/store.js';
+import type { EngramConfig } from '../../../config/schema.js';
+export declare function startNotionWatcher(store: MemoryStore, config: EngramConfig): void;
+export declare function stopNotionWatcher(): void;
+//# sourceMappingURL=watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/notion/watcher.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAQ9D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAwBjF;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC"}

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

@@ -0,0 +1,41 @@
+import cron from 'node-cron';
+import { createLogger } from '../../../logger.js';
+import { sourceRegistry } from '../../core/source-registry.js';
+import { getPageMetadata, fetchPageText } from './connector.js';
+import { buildNotionItem } from './ingest.js';
+const log = createLogger('notion:watcher');
+let task = null;
+export function startNotionWatcher(store, config) {
+    const embeddingModel = `${config.embeddings.provider}/${config.embeddings.model}`;
+    task = cron.schedule('*/15 * * * *', async () => {
+        const sources = sourceRegistry.listEnabled('notion');
+        for (const s of sources) {
+            try {
+                const meta = await getPageMetadata(s.external_id);
+                if (s.last_modified_remote && meta.last_edited_time === s.last_modified_remote)
+                    continue;
+                const content = await fetchPageText(meta.id);
+                await store.deleteBySourceId(`notion:${meta.id}`);
+                const item = buildNotionItem({ metadata: meta, content, embeddingModel });
+                await store.insert(item);
+                sourceRegistry.recordSync(s.id, meta.last_edited_time);
+                log.info(`Re-synced notion:${meta.id} (${meta.title})`);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                sourceRegistry.recordSync(s.id, s.last_modified_remote, msg);
+                log.warn(`Notion watcher error on ${s.external_id}: ${msg}`);
+            }
+        }
+    });
+    task.start();
+    log.info('Notion watcher started (every 15min)');
+}
+export function stopNotionWatcher() {
+    if (task) {
+        task.stop();
+        task = null;
+        log.info('Notion watcher stopped');
+    }
+}
+//# sourceMappingURL=watcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../../../src/memory/modules/notion/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,IAA4B,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAE3C,IAAI,IAAI,GAAyB,IAAI,CAAC;AAEtC,MAAM,UAAU,kBAAkB,CAAC,KAAkB,EAAE,MAAoB;IACzE,MAAM,cAAc,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAElF,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,OAAO,GAAG,cAAc,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;gBAClD,IAAI,CAAC,CAAC,oBAAoB,IAAI,IAAI,CAAC,gBAAgB,KAAK,CAAC,CAAC,oBAAoB;oBAAE,SAAS;gBACzF,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC7C,MAAM,KAAK,CAAC,gBAAgB,CAAC,UAAU,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClD,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;gBAC1E,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACzB,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBACvD,GAAG,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;YAC1D,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,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;gBAC7D,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,WAAW,KAAK,GAAG,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,KAAK,EAAE,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,GAAG,IAAI,CAAC;QACZ,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACrC,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { MemoryItem } from '../../../types.js';
+import type { ObsidianFile } from './vault-reader.js';
+export interface ObsidianIngestInput {
+    file: ObsidianFile;
+    vaultRoot: string;
+    embeddingModel: string;
+}
+export declare function buildObsidianItem(input: ObsidianIngestInput): MemoryItem;
+//# sourceMappingURL=ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/obsidian/ingest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,UAAU,CA+BxE"}

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

@@ -0,0 +1,80 @@
+import { ulid } from 'ulid';
+import { createHash } from 'crypto';
+import path from 'path';
+import { extractWikilinks } from '../../core/wikilinks.js';
+export function buildObsidianItem(input) {
+    const now = new Date().toISOString();
+    const modifiedIso = new Date(input.file.modifiedAt).toISOString();
+    const title = extractTitle(input.file.content) ?? path.basename(input.file.relativePath, '.md');
+    // Optional: parse frontmatter for tags
+    const tags = parseFrontmatterTags(input.file.content);
+    const properties = {
+        title,
+        tags,
+        created_at: modifiedIso,
+        ingested_at: now,
+        source_url: `file://${input.file.absolutePath}`,
+        custom: {
+            vault_root: input.vaultRoot,
+            relative_path: input.file.relativePath,
+        },
+    };
+    return {
+        id: ulid(),
+        type: 'obsidian',
+        source_id: `obsidian:${input.file.absolutePath}`,
+        content: input.file.content,
+        content_hash: createHash('sha256').update(input.file.content).digest('hex'),
+        properties,
+        wikilinks: extractWikilinks(input.file.content),
+        related_ids: [],
+        embedding_model: input.embeddingModel,
+    };
+}
+function extractTitle(content) {
+    const lines = content.split(/\r?\n/);
+    // 1. YAML frontmatter title:
+    if (lines[0]?.trim() === '---') {
+        for (let i = 1; i < lines.length; i++) {
+            if (lines[i].trim() === '---')
+                break;
+            const m = lines[i].match(/^title:\s*(.+)$/);
+            if (m)
+                return m[1].replace(/^["']|["']$/g, '').trim();
+        }
+    }
+    // 2. First H1
+    for (const line of lines) {
+        const m = line.match(/^#\s+(.+)$/);
+        if (m)
+            return m[1].trim();
+    }
+    return undefined;
+}
+function parseFrontmatterTags(content) {
+    const lines = content.split(/\r?\n/);
+    if (lines[0]?.trim() !== '---')
+        return undefined;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === '---')
+            break;
+        // tags: [a, b, c]
+        const inline = lines[i].match(/^tags:\s*\[([^\]]+)\]/);
+        if (inline) {
+            return inline[1].split(',').map((s) => s.trim().replace(/^["']|["']$/g, ''));
+        }
+        // tags:\n  - a\n  - b
+        if (/^tags:\s*$/.test(lines[i])) {
+            const tags = [];
+            for (let j = i + 1; j < lines.length; j++) {
+                const m = lines[j].match(/^\s+-\s+(.+)$/);
+                if (!m)
+                    break;
+                tags.push(m[1].trim().replace(/^["']|["']$/g, ''));
+            }
+            return tags;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=ingest.js.map

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

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

package/dist/memory/modules/obsidian/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 createObsidianModule(config: EngramConfig): MemoryModule;
+export declare function buildObsidianModuleTools(store: MemoryStore, config: EngramConfig): import("../../core/module-interface.js").MCPToolDefinition[];
+//# sourceMappingURL=module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/obsidian/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,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA6BvE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,gEAEhF"}

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

@@ -0,0 +1,31 @@
+import { buildObsidianTools } from './tools.js';
+import { startObsidianWatchers, stopObsidianWatchers } from './watcher.js';
+export function createObsidianModule(config) {
+    let store = null;
+    return {
+        id: 'obsidian',
+        displayName: 'Obsidian Vault',
+        isCustom: false,
+        async onBoot(ctx) {
+            store = ctx.store;
+        },
+        async onShutdown() {
+            stopObsidianWatchers();
+        },
+        async ingest() {
+            throw new Error('obsidian.ingest is not used; use add_obsidian_vault MCP tool');
+        },
+        startWatcher() {
+            if (store)
+                startObsidianWatchers(store, config);
+        },
+        stopWatcher() {
+            stopObsidianWatchers();
+        },
+        tools: [],
+    };
+}
+export function buildObsidianModuleTools(store, config) {
+    return buildObsidianTools(store, config);
+}
+//# sourceMappingURL=module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../../src/memory/modules/obsidian/module.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,IAAI,KAAK,GAAuB,IAAI,CAAC;IACrC,OAAO;QACL,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,gBAAgB;QAC7B,QAAQ,EAAE,KAAK;QAEf,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,UAAU;YACd,oBAAoB,EAAE,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,MAAM;YACV,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QAED,YAAY;YACV,IAAI,KAAK;gBAAE,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,WAAW;YACT,oBAAoB,EAAE,CAAC;QACzB,CAAC;QAED,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAkB,EAAE,MAAoB;IAC/E,OAAO,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC"}

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

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

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

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

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

@@ -0,0 +1,65 @@
+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 { buildObsidianModuleTools, createObsidianModule } 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: false,
+        baseUrl: 'http://localhost:11434',
+        model: 'llama3.2:3b',
+        maxTokens: 300,
+    },
+    whisper: { enabled: true, model: 'small.en', language: 'auto' },
+    youtube: { enabled: true, preferLanguage: 'en', fallbackToYtdlp: false },
+    modules: { obsidian: { enabled: true } },
+    mcp: { stdio: true, httpPort: 7777 },
+};
+describe('obsidian module e2e', () => {
+    let tmpData;
+    let vault;
+    let store;
+    beforeEach(async () => {
+        tmpData = fs.mkdtempSync(path.join(os.tmpdir(), 'engram-obs-data-'));
+        vault = fs.mkdtempSync(path.join(os.tmpdir(), 'engram-obs-vault-'));
+        initDb(tmpData);
+        initVectorStore(tmpData);
+        store = new MemoryStore({ embeddings: config.embeddings });
+        fs.writeFileSync(path.join(vault, 'engineering-standards.md'), `---\ntitle: Engineering Standards\ntags: [code, standards]\n---\n# Engineering Standards\n\nUse TypeScript strict mode and ULIDs.\n\nSee [[Code Review]] for review process.\n`);
+        fs.writeFileSync(path.join(vault, 'code-review.md'), `# Code Review\n\nEvery PR needs at least 1 reviewer.\n`);
+        const mod = createObsidianModule(config);
+        await mod.onBoot({ store });
+    });
+    afterEach(() => {
+        closeDb();
+        fs.rmSync(tmpData, { recursive: true, force: true });
+        fs.rmSync(vault, { recursive: true, force: true });
+    });
+    it('add_obsidian_vault indexes every markdown file', async () => {
+        const tools = buildObsidianModuleTools(store, config);
+        const result = (await tools.find((t) => t.name === 'add_obsidian_vault').handler({
+            vault_path: vault,
+        }));
+        expect(result.files_ingested).toBe(2);
+    }, 30_000);
+    it('parses frontmatter title and tags', async () => {
+        const tools = buildObsidianModuleTools(store, config);
+        await tools.find((t) => t.name === 'add_obsidian_vault').handler({ vault_path: vault });
+        const types = store.listTypes();
+        expect(types).toContain('obsidian');
+        const hits = await store.search('obsidian', 'standards typescript ULID', 5);
+        expect(hits.length).toBeGreaterThan(0);
+        const top = hits[0].memory;
+        expect(top.properties.title).toBe('Engineering Standards');
+        expect(top.properties.tags).toContain('code');
+        expect(top.wikilinks).toContain('Code Review');
+    }, 30_000);
+});
+//# sourceMappingURL=obsidian.test.js.map

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

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

package/dist/memory/modules/obsidian/tests/vault-reader.test.d.ts

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

package/dist/memory/modules/obsidian/tests/vault-reader.test.d.ts.map

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

package/dist/memory/modules/obsidian/tests/vault-reader.test.js

@@ -0,0 +1,37 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { readVault } from '../vault-reader.js';
+describe('vault-reader', () => {
+    let vault;
+    beforeEach(() => {
+        vault = fs.mkdtempSync(path.join(os.tmpdir(), 'obsidian-vault-'));
+        fs.writeFileSync(path.join(vault, 'note1.md'), '# First note\n[[note2]] reference');
+        fs.mkdirSync(path.join(vault, 'sub'));
+        fs.writeFileSync(path.join(vault, 'sub', 'note2.md'), '# Second\nlots of content');
+        // Files that should be ignored
+        fs.mkdirSync(path.join(vault, '.obsidian'));
+        fs.writeFileSync(path.join(vault, '.obsidian', 'workspace.json'), '{}');
+        fs.writeFileSync(path.join(vault, 'photo.png'), 'not markdown');
+        // .obsidianignore
+        fs.writeFileSync(path.join(vault, '.obsidianignore'), 'archive/*\nprivate/**\n');
+        fs.mkdirSync(path.join(vault, 'archive'));
+        fs.writeFileSync(path.join(vault, 'archive', 'old.md'), 'should not appear');
+    });
+    afterEach(() => {
+        fs.rmSync(vault, { recursive: true, force: true });
+    });
+    it('returns markdown files only, respecting .obsidianignore + .obsidian/', async () => {
+        const files = await readVault(vault);
+        const rels = files.map((f) => f.relativePath).sort();
+        expect(rels).toEqual(['note1.md', 'sub/note2.md']);
+    });
+    it('reads content correctly', async () => {
+        const files = await readVault(vault);
+        const note1 = files.find((f) => f.relativePath === 'note1.md');
+        expect(note1?.content).toContain('First note');
+        expect(note1?.content).toContain('[[note2]]');
+    });
+});
+//# sourceMappingURL=vault-reader.test.js.map

package/dist/memory/modules/obsidian/tests/vault-reader.test.js.map

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

package/dist/memory/modules/obsidian/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 buildObsidianTools(store: MemoryStore, config: EngramConfig): MCPToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/obsidian/tools.ts"],"names":[],"mappings":"AAEA,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;AAO9D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB,iBAAiB,EAAE,CAqGrB"}

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

@@ -0,0 +1,101 @@
+import path from 'path';
+import { createLogger } from '../../../logger.js';
+import { readVault } from './vault-reader.js';
+import { buildObsidianItem } from './ingest.js';
+import { sourceRegistry } from '../../core/source-registry.js';
+const log = createLogger('obsidian:tools');
+export function buildObsidianTools(store, config) {
+    const embeddingModel = `${config.embeddings.provider}/${config.embeddings.model}`;
+    return [
+        {
+            name: 'add_obsidian_vault',
+            description: 'Index every markdown file in an Obsidian vault path and add to memory. One-shot ingestion.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    vault_path: {
+                        type: 'string',
+                        description: 'Absolute path to the vault root.',
+                    },
+                },
+                required: ['vault_path'],
+            },
+            handler: async (args) => {
+                const vaultPath = path.resolve(args.vault_path);
+                const files = await readVault(vaultPath);
+                let count = 0;
+                for (const file of files) {
+                    const item = buildObsidianItem({ file, vaultRoot: vaultPath, embeddingModel });
+                    await store.deleteBySourceId(item.source_id);
+                    await store.insert(item);
+                    count++;
+                }
+                log.info(`Ingested ${count} files from ${vaultPath}`);
+                return { vault_path: vaultPath, files_ingested: count };
+            },
+        },
+        {
+            name: 'watch_obsidian_vault',
+            description: 'Add an Obsidian vault to the watched-sources list. The watcher polls the filesystem and re-ingests changed files on the fly.',
+            inputSchema: {
+                type: 'object',
+                properties: { vault_path: { type: 'string' } },
+                required: ['vault_path'],
+            },
+            handler: async (args) => {
+                const vaultPath = path.resolve(args.vault_path);
+                const sourceId = sourceRegistry.add({
+                    module_id: 'obsidian',
+                    external_id: vaultPath,
+                    display_name: path.basename(vaultPath),
+                    config: { vault_path: vaultPath },
+                });
+                // initial full ingest
+                const files = await readVault(vaultPath);
+                for (const file of files) {
+                    const item = buildObsidianItem({ file, vaultRoot: vaultPath, embeddingModel });
+                    await store.deleteBySourceId(item.source_id);
+                    await store.insert(item);
+                }
+                sourceRegistry.recordSync(sourceId, new Date().toISOString());
+                return { source_id: sourceId, files_ingested: files.length, watching: vaultPath };
+            },
+        },
+        {
+            name: 'unwatch_obsidian_vault',
+            description: 'Remove an Obsidian vault from the watched-sources list (does not delete memories).',
+            inputSchema: {
+                type: 'object',
+                properties: { source_id: { type: 'string' } },
+                required: ['source_id'],
+            },
+            handler: async (args) => {
+                sourceRegistry.remove(args.source_id);
+                return { removed: true };
+            },
+        },
+        {
+            name: 'search_obsidian',
+            description: 'Search ingested Obsidian notes by semantic similarity.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string' },
+                    limit: { type: 'number', default: 10 },
+                },
+                required: ['query'],
+            },
+            handler: async (args) => {
+                const hits = await store.search('obsidian', args.query, args.limit ?? 10);
+                return hits.map((h) => ({
+                    id: h.memory.id,
+                    score: h.score,
+                    snippet: h.snippet,
+                    title: h.memory.properties.title,
+                    relative_path: h.memory.properties.custom?.relative_path,
+                }));
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

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

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

package/dist/memory/modules/obsidian/vault-reader.d.ts

@@ -0,0 +1,8 @@
+export interface ObsidianFile {
+    absolutePath: string;
+    relativePath: string;
+    content: string;
+    modifiedAt: number;
+}
+export declare function readVault(vaultRoot: string): Promise<ObsidianFile[]>;
+//# sourceMappingURL=vault-reader.d.ts.map

package/dist/memory/modules/obsidian/vault-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-reader.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/obsidian/vault-reader.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAO1E"}