@raviolelabs/engram-mcp 0.2.0

package/dist/memory/modules/_custom/persistence.js

@@ -0,0 +1,47 @@
+// src/memory/modules/_custom/persistence.ts
+import { getDb } from '../../../db/index.js';
+import { createLogger } from '../../../logger.js';
+const log = createLogger('custom:persistence');
+const TYPE_NAME_RE = /^[a-z][a-z0-9_]{0,30}$/;
+const RESERVED_NAMES = [
+    'notes',
+    'conversations',
+    'drive',
+    'notion',
+    'youtube',
+    'audio',
+    'obsidian',
+];
+export function validateTypeName(name) {
+    if (!TYPE_NAME_RE.test(name)) {
+        throw new Error(`Invalid type name "${name}". Must be lowercase, start with a letter, max 31 chars, [a-z0-9_].`);
+    }
+    if (RESERVED_NAMES.includes(name)) {
+        throw new Error(`Type name "${name}" is reserved.`);
+    }
+}
+export function createCustomType(input) {
+    validateTypeName(input.type_name);
+    const def = {
+        type_name: input.type_name,
+        display_name: input.display_name,
+        schema_json: input.schema ? JSON.stringify(input.schema) : null,
+        created_at: Date.now(),
+    };
+    getDb()
+        .prepare(`INSERT INTO custom_types (type_name, display_name, schema_json, created_at)
+       VALUES (?, ?, ?, ?)`)
+        .run(def.type_name, def.display_name, def.schema_json, def.created_at);
+    log.info(`Registered custom type: ${def.type_name}`);
+    return def;
+}
+export function listCustomTypes() {
+    return getDb()
+        .prepare(`SELECT type_name, display_name, schema_json, created_at FROM custom_types ORDER BY type_name`)
+        .all();
+}
+export function deleteCustomType(typeName) {
+    getDb().prepare('DELETE FROM custom_types WHERE type_name = ?').run(typeName);
+    log.info(`Deleted custom type: ${typeName}`);
+}
+//# sourceMappingURL=persistence.js.map

package/dist/memory/modules/_custom/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../../../src/memory/modules/_custom/persistence.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AAS/C,MAAM,YAAY,GAAG,wBAAwB,CAAC;AAE9C,MAAM,cAAc,GAAG;IACrB,OAAO;IACP,eAAe;IACf,OAAO;IACP,QAAQ;IACR,SAAS;IACT,OAAO;IACP,UAAU;CACX,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,sBAAsB,IAAI,qEAAqE,CAChG,CAAC;IACJ,CAAC;IACD,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,gBAAgB,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAIhC;IACC,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,GAAG,GAAyB;QAChC,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/D,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;KACvB,CAAC;IACF,KAAK,EAAE;SACJ,OAAO,CACN;2BACqB,CACtB;SACA,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACzE,GAAG,CAAC,IAAI,CAAC,2BAA2B,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,EAAE;SACX,OAAO,CACN,8FAA8F,CAC/F;SACA,GAAG,EAA4B,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,KAAK,EAAE,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9E,GAAG,CAAC,IAAI,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/memory/modules/_custom/tests/custom-types.test.d.ts

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

package/dist/memory/modules/_custom/tests/custom-types.test.d.ts.map

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

package/dist/memory/modules/_custom/tests/custom-types.test.js

@@ -0,0 +1,89 @@
+// src/memory/modules/_custom/tests/custom-types.test.ts
+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 { moduleRegistry } from '../../../core/module-registry.js';
+import { ToolRouter } from '../../../../mcp-server/tool-router.js';
+import { buildCustomTypeTools, loadAndRegisterCustomTypes } from '../tools.js';
+import { createCustomType, listCustomTypes, deleteCustomType } from '../persistence.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: {},
+    mcp: { stdio: true, httpPort: 7777 },
+};
+describe('custom types e2e', () => {
+    let tmpDir;
+    let store;
+    let router;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'engram-custom-'));
+        initDb(tmpDir);
+        initVectorStore(tmpDir);
+        store = new MemoryStore({ embeddings: config.embeddings });
+        router = new ToolRouter();
+        // Clear the registry between tests
+        for (const m of moduleRegistry.list()) {
+            moduleRegistry.modules.delete(m.id);
+        }
+        moduleRegistry.booted = false;
+    });
+    afterEach(() => {
+        closeDb();
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('persistence: create + list + delete', () => {
+        createCustomType({ type_name: 'recipes', display_name: 'Recipes' });
+        let defs = listCustomTypes();
+        expect(defs.map((d) => d.type_name)).toContain('recipes');
+        deleteCustomType('recipes');
+        defs = listCustomTypes();
+        expect(defs.map((d) => d.type_name)).not.toContain('recipes');
+    });
+    it('rejects reserved names', () => {
+        expect(() => createCustomType({ type_name: 'notes', display_name: 'Notes' })).toThrow(/reserved/);
+    });
+    it('create_custom_type registers add_X / search_X tools live', async () => {
+        const tools = buildCustomTypeTools(store, config, router);
+        const result = (await tools.find((t) => t.name === 'create_custom_type').handler({
+            type_name: 'recipes',
+            display_name: 'Recipes',
+        }));
+        expect(result.tools).toContain('add_recipes');
+        expect(result.tools).toContain('search_recipes');
+        // The tool router now has them
+        const addRecipe = router.list().find((t) => t.name === 'add_recipes');
+        const searchRecipe = router.list().find((t) => t.name === 'search_recipes');
+        await addRecipe.handler({
+            content: 'Pasta carbonara: pancetta, eggs, pecorino, black pepper. Tossed off-heat to keep eggs creamy.',
+            title: 'Carbonara',
+        });
+        const hits = (await searchRecipe.handler({ query: 'pasta eggs cheese' }));
+        expect(hits.length).toBeGreaterThan(0);
+    }, 30_000);
+    it('loadAndRegisterCustomTypes restores types at boot', async () => {
+        createCustomType({ type_name: 'recipes', display_name: 'Recipes' });
+        createCustomType({ type_name: 'dream_journal', display_name: 'Dream Journal' });
+        loadAndRegisterCustomTypes(store, config, router);
+        const toolNames = router.list().map((t) => t.name);
+        expect(toolNames).toContain('add_recipes');
+        expect(toolNames).toContain('search_recipes');
+        expect(toolNames).toContain('add_dream_journal');
+        expect(toolNames).toContain('search_dream_journal');
+    });
+});
+//# sourceMappingURL=custom-types.test.js.map

package/dist/memory/modules/_custom/tests/custom-types.test.js.map

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

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

@@ -0,0 +1,7 @@
+import type { MCPToolDefinition } from '../../core/module-interface.js';
+import type { MemoryStore } from '../../core/store.js';
+import type { EngramConfig } from '../../../config/schema.js';
+import { ToolRouter } from '../../../mcp-server/tool-router.js';
+export declare function buildCustomTypeTools(store: MemoryStore, config: EngramConfig, router: ToolRouter): MCPToolDefinition[];
+export declare function loadAndRegisterCustomTypes(store: MemoryStore, config: EngramConfig, router: ToolRouter): void;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/_custom/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;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAWhE,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,UAAU,GACjB,iBAAiB,EAAE,CA0DrB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,UAAU,GACjB,IAAI,CASN"}

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

@@ -0,0 +1,72 @@
+// src/memory/modules/_custom/tools.ts
+import { createLogger } from '../../../logger.js';
+import { moduleRegistry } from '../../core/module-registry.js';
+import { createCustomType, listCustomTypes, deleteCustomType, } from './persistence.js';
+import { createGenericModule, buildGenericModuleTools } from './generic-module.js';
+const log = createLogger('custom:tools');
+export function buildCustomTypeTools(store, config, router) {
+    return [
+        {
+            name: 'create_custom_type',
+            description: 'Create a new user-defined memory type at runtime. Auto-exposes add_<name> and search_<name> tools. Name must be lowercase snake_case.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    type_name: { type: 'string', description: 'lowercase, snake_case, [a-z0-9_]' },
+                    display_name: { type: 'string' },
+                    schema: {
+                        type: 'object',
+                        description: 'Optional JSON Schema for the custom-properties field.',
+                    },
+                },
+                required: ['type_name', 'display_name'],
+            },
+            handler: async (args) => {
+                const def = createCustomType({
+                    type_name: args.type_name,
+                    display_name: args.display_name,
+                    schema: args.schema,
+                });
+                const mod = createGenericModule(def, config);
+                moduleRegistry.register(mod);
+                await mod.onBoot({ store });
+                const tools = buildGenericModuleTools(def, store, config);
+                router.registerMany(tools);
+                log.info(`Live-registered custom type ${def.type_name} with tools ${tools.map((t) => t.name).join(', ')}`);
+                return { type_name: def.type_name, tools: tools.map((t) => t.name) };
+            },
+        },
+        {
+            name: 'list_custom_types',
+            description: 'List user-defined memory types.',
+            inputSchema: { type: 'object', properties: {} },
+            handler: async () => {
+                return listCustomTypes();
+            },
+        },
+        {
+            name: 'delete_custom_type',
+            description: 'Delete a custom type definition. Does NOT delete the memories already stored under that type; existing memories remain searchable.',
+            inputSchema: {
+                type: 'object',
+                properties: { type_name: { type: 'string' } },
+                required: ['type_name'],
+            },
+            handler: async (args) => {
+                deleteCustomType(args.type_name);
+                return { deleted: args.type_name };
+            },
+        },
+    ];
+}
+export function loadAndRegisterCustomTypes(store, config, router) {
+    const defs = listCustomTypes();
+    for (const def of defs) {
+        const mod = createGenericModule(def, config);
+        moduleRegistry.register(mod);
+        void mod.onBoot({ store });
+        router.registerMany(buildGenericModuleTools(def, store, config));
+        log.info(`Loaded custom type at boot: ${def.type_name}`);
+    }
+}
+//# sourceMappingURL=tools.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { MemoryItem } from '../../../types.js';
+import type { TranscriptResult } from './transcriber.js';
+export interface AudioIngestInput {
+    audioPath: string;
+    transcript: TranscriptResult;
+    embeddingModel: string;
+}
+export declare function buildAudioItem(input: AudioIngestInput): MemoryItem;
+//# sourceMappingURL=ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/audio/ingest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CA0BlE"}

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

@@ -0,0 +1,32 @@
+// src/memory/modules/audio/ingest.ts
+import { ulid } from 'ulid';
+import { createHash } from 'crypto';
+import path from 'path';
+export function buildAudioItem(input) {
+    const now = new Date().toISOString();
+    const base = path.basename(input.audioPath);
+    const properties = {
+        title: base,
+        created_at: now,
+        ingested_at: now,
+        source_url: `file://${input.audioPath}`,
+        custom: {
+            audio_path: input.audioPath,
+            duration_seconds: input.transcript.duration,
+            language: input.transcript.language,
+            segments: input.transcript.segments,
+        },
+    };
+    return {
+        id: ulid(),
+        type: 'audio',
+        source_id: `audio:${input.audioPath}`,
+        content: input.transcript.full_text,
+        content_hash: createHash('sha256').update(input.transcript.full_text).digest('hex'),
+        properties,
+        wikilinks: [],
+        related_ids: [],
+        embedding_model: input.embeddingModel,
+    };
+}
+//# sourceMappingURL=ingest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../../src/memory/modules/audio/ingest.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAUxB,MAAM,UAAU,cAAc,CAAC,KAAuB;IACpD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAqB;QACnC,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,GAAG;QACf,WAAW,EAAE,GAAG;QAChB,UAAU,EAAE,UAAU,KAAK,CAAC,SAAS,EAAE;QACvC,MAAM,EAAE;YACN,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,gBAAgB,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ;YAC3C,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ;YACnC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ;SACpC;KACF,CAAC;IACF,OAAO;QACL,EAAE,EAAE,IAAI,EAAE;QACV,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,SAAS,KAAK,CAAC,SAAS,EAAE;QACrC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS;QACnC,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACnF,UAAU;QACV,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,KAAK,CAAC,cAAc;KACtC,CAAC;AACJ,CAAC"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/audio/module.ts"],"names":[],"mappings":"AACA,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;AAG9D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAerE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,gEAE7E"}

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

@@ -0,0 +1,18 @@
+import { buildAudioTools } from './tools.js';
+export function createAudioModule(_config) {
+    return {
+        id: 'audio',
+        displayName: 'Audio (Whisper)',
+        isCustom: false,
+        async onBoot() { },
+        async onShutdown() { },
+        async ingest() {
+            throw new Error('audio.ingest is not used; use add_audio_file MCP tool');
+        },
+        tools: [],
+    };
+}
+export function buildAudioModuleTools(store, config) {
+    return buildAudioTools(store, config);
+}
+//# sourceMappingURL=module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../../src/memory/modules/audio/module.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,UAAU,iBAAiB,CAAC,OAAqB;IACrD,OAAO;QACL,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,KAAK;QAEf,KAAK,CAAC,MAAM,KAAI,CAAC;QACjB,KAAK,CAAC,UAAU,KAAI,CAAC;QAErB,KAAK,CAAC,MAAM;YACV,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QAED,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAkB,EAAE,MAAoB;IAC5E,OAAO,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC"}

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

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

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

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

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

@@ -0,0 +1,57 @@
+// src/memory/modules/audio/tests/audio.test.ts
+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 { buildAudioModuleTools } from '../module.js';
+const TEST_AUDIO = path.join(import.meta.dirname, 'fixtures', 'hello.wav');
+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: 'tiny.en', language: 'en' },
+    youtube: { enabled: true, preferLanguage: 'en', fallbackToYtdlp: true },
+    modules: { audio: { enabled: true } },
+    mcp: { stdio: true, httpPort: 7777 },
+};
+describe('audio module e2e (real Whisper + LanceDB)', () => {
+    let tmpDir;
+    let store;
+    beforeEach(() => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'engram-audio-'));
+        initDb(tmpDir);
+        initVectorStore(tmpDir);
+        store = new MemoryStore({ embeddings: config.embeddings });
+    });
+    afterEach(() => {
+        closeDb();
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('add_audio_file → search_audio finds the transcript', async () => {
+        if (!fs.existsSync(TEST_AUDIO)) {
+            console.warn('Skipping: hello.wav fixture not generated');
+            return;
+        }
+        const tools = buildAudioModuleTools(store, config);
+        const addRes = (await tools.find((t) => t.name === 'add_audio_file').handler({
+            path: TEST_AUDIO,
+        }));
+        expect(addRes.id).toBeDefined();
+        expect(addRes.duration).toBeGreaterThan(0);
+        const hits = (await tools.find((t) => t.name === 'search_audio').handler({
+            query: 'hello test',
+        }));
+        expect(hits.some((h) => h.id === addRes.id)).toBe(true);
+    }, 180_000);
+});
+//# sourceMappingURL=audio.test.js.map

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

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

package/dist/memory/modules/audio/tests/transcriber.test.d.ts

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

package/dist/memory/modules/audio/tests/transcriber.test.d.ts.map

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

package/dist/memory/modules/audio/tests/transcriber.test.js

@@ -0,0 +1,27 @@
+// src/memory/modules/audio/tests/transcriber.test.ts
+import { describe, it, expect } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import { transcribeAudio } from '../transcriber.js';
+const TEST_AUDIO = path.join(import.meta.dirname, 'fixtures', 'hello.wav');
+describe('whisper transcriber (real whisper.cpp)', () => {
+    it('skips if test audio is not present', () => {
+        if (!fs.existsSync(TEST_AUDIO)) {
+            console.warn(`Test audio not found: ${TEST_AUDIO}. Create it with:`);
+            console.warn(`  say -o ${TEST_AUDIO} --data-format=LEF32@16000 'hello world this is a test'`);
+            return;
+        }
+    });
+    it('transcribes a short audio file', async () => {
+        if (!fs.existsSync(TEST_AUDIO))
+            return; // skip when fixture missing
+        const result = await transcribeAudio(TEST_AUDIO, {
+            enabled: true,
+            model: 'tiny.en',
+            language: 'en',
+        });
+        expect(result.full_text.toLowerCase()).toMatch(/hello|test/);
+        expect(result.segments.length).toBeGreaterThan(0);
+    }, 120_000);
+});
+//# sourceMappingURL=transcriber.test.js.map

package/dist/memory/modules/audio/tests/transcriber.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriber.test.js","sourceRoot":"","sources":["../../../../../src/memory/modules/audio/tests/transcriber.test.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAE3E,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,yBAAyB,UAAU,mBAAmB,CAAC,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,YAAY,UAAU,yDAAyD,CAAC,CAAC;YAC9F,OAAO;QACT,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CACA,gCAAgC,EAChC,KAAK,IAAI,EAAE;QACT,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,CAAC,4BAA4B;QAEpE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE;YAC/C,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC,EACD,OAAO,CACR,CAAC;AACJ,CAAC,CAAC,CAAC"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/audio/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;AAM9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,iBAAiB,EAAE,CA8D7F"}

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

@@ -0,0 +1,60 @@
+// src/memory/modules/audio/tools.ts
+import { createLogger } from '../../../logger.js';
+import { transcribeAudio } from './transcriber.js';
+import { buildAudioItem } from './ingest.js';
+const log = createLogger('audio:tools');
+export function buildAudioTools(store, config) {
+    const embeddingModel = `${config.embeddings.provider}/${config.embeddings.model}`;
+    return [
+        {
+            name: 'add_audio_file',
+            description: 'Transcribe an audio file using local Whisper.cpp and add it to memory as a searchable transcript. Supports common audio formats (wav, mp3, m4a, ogg). The transcript is indexed under the `audio` memory type. The filename is used as the title; you (the calling LLM) can later call update to add better title/tags after reviewing the transcript via suggest_properties.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Absolute path to the audio file on the local filesystem.',
+                    },
+                },
+                required: ['path'],
+            },
+            handler: async (args) => {
+                const audioPath = args.path;
+                const transcript = await transcribeAudio(audioPath, config.whisper, config);
+                const item = buildAudioItem({ audioPath, transcript, embeddingModel });
+                await store.insert(item);
+                log.info(`Ingested audio ${audioPath} as memory ${item.id} (${transcript.segments.length} segments, ${transcript.duration.toFixed(1)}s)`);
+                return {
+                    id: item.id,
+                    duration: transcript.duration,
+                    segments: transcript.segments.length,
+                    full_text_preview: transcript.full_text.slice(0, 200),
+                };
+            },
+        },
+        {
+            name: 'search_audio',
+            description: 'Search transcribed audio memories by semantic similarity. Returns matching transcript snippets with metadata. Use this to find previously transcribed audio files by content.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'Natural language query to search audio transcripts.' },
+                    limit: { type: 'number', default: 10, description: 'Maximum number of results to return.' },
+                },
+                required: ['query'],
+            },
+            handler: async (args) => {
+                const hits = await store.search('audio', args.query, args.limit ?? 10);
+                return hits.map((h) => ({
+                    id: h.memory.id,
+                    score: h.score,
+                    snippet: h.snippet,
+                    title: h.memory.properties.title,
+                    duration: h.memory.properties.custom?.duration_seconds,
+                }));
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../../src/memory/modules/audio/tools.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;AAExC,MAAM,UAAU,eAAe,CAAC,KAAkB,EAAE,MAAoB;IACtE,MAAM,cAAc,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAElF,OAAO;QACL;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,+WAA+W;YACjX,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,0DAA0D;qBACxE;iBACF;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACnB;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAc,CAAC;gBACtC,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC5E,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;gBACvE,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACzB,GAAG,CAAC,IAAI,CACN,kBAAkB,SAAS,cAAc,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,QAAQ,CAAC,MAAM,cAAc,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAChI,CAAC;gBACF,OAAO;oBACL,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM;oBACpC,iBAAiB,EAAE,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;iBACtD,CAAC;YACJ,CAAC;SACF;QACD;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,+KAA+K;YACjL,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;oBAC7F,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,sCAAsC,EAAE;iBAC5F;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,MAAM,CAC7B,OAAO,EACP,IAAI,CAAC,KAAe,EACnB,IAAI,CAAC,KAAgB,IAAI,EAAE,CAC7B,CAAC;gBACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACtB,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;oBACf,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK;oBAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,gBAAgB;iBACvD,CAAC,CAAC,CAAC;YACN,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/memory/modules/audio/transcriber.d.ts

@@ -0,0 +1,15 @@
+import type { WhisperConfig, EngramConfig } from '../../../config/schema.js';
+export interface TranscriptSegment {
+    start: number;
+    end: number;
+    text: string;
+}
+export interface TranscriptResult {
+    language: string;
+    duration: number;
+    segments: TranscriptSegment[];
+    full_text: string;
+}
+export declare function transcribeAudio(audioPath: string, config: WhisperConfig, engramConfig?: EngramConfig): Promise<TranscriptResult>;
+export declare function getWhisperModelDir(): string;
+//# sourceMappingURL=transcriber.d.ts.map

package/dist/memory/modules/audio/transcriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriber.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/audio/transcriber.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI7E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAmBD,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,EACrB,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAkB3B;AAqLD,wBAAgB,kBAAkB,IAAI,MAAM,CAK3C"}