@raviolelabs/engram-mcp 0.2.0

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

@@ -0,0 +1,177 @@
+// src/memory/modules/audio/transcriber.ts
+import path from 'path';
+import os from 'os';
+import fs from 'fs';
+import { createLogger } from '../../../logger.js';
+const log = createLogger('audio:transcriber');
+/**
+ * Transcribe audio using the configured provider.
+ * - provider: "local"          → whisper.cpp via nodejs-whisper (default, free)
+ * - provider: "engram-hosted"  → POST to api.engram-mcp.com/api/whisper (Pro)
+ *   Falls back to local whisper if the API call fails and local whisper is available.
+ */
+import { ENGRAM_API_BASE } from '../../../cloud/endpoints.js';
+export async function transcribeAudio(audioPath, config, engramConfig) {
+    if (!fs.existsSync(audioPath)) {
+        throw new Error(`Audio file not found: ${audioPath}`);
+    }
+    const provider = config.provider ?? 'local';
+    if (provider === 'engram-hosted') {
+        try {
+            return await transcribeEngram(audioPath, engramConfig);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            log.warn(`Engram-hosted whisper failed (${msg}), falling back to local whisper.cpp`);
+            // Fall through to local transcription
+        }
+    }
+    return transcribeLocal(audioPath, config);
+}
+// ── Engram-hosted transcription ───────────────────────────────────────────────
+async function transcribeEngram(audioPath, engramConfig) {
+    const apiKey = engramConfig?.engramAccount?.apiKey;
+    if (!apiKey) {
+        throw new Error('Engram-hosted whisper requires an API key. ' +
+            'Set engramAccount.apiKey in ~/.engram/config.json or switch whisper.provider to "local".');
+    }
+    const baseUrl = (ENGRAM_API_BASE).replace(/\/$/, '');
+    const url = `${baseUrl}/api/whisper`;
+    const audioBuffer = fs.readFileSync(audioPath);
+    const audioDurationSeconds = estimateAudioDuration(audioBuffer);
+    const formData = new FormData();
+    const blob = new Blob([audioBuffer], { type: 'audio/wav' });
+    formData.append('audio', blob, path.basename(audioPath));
+    log.info(`Transcribing ${audioPath} via Engram-hosted whisper (~${audioDurationSeconds}s)`);
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'X-Audio-Duration-Seconds': String(audioDurationSeconds),
+        },
+        body: formData,
+        signal: AbortSignal.timeout(120_000),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        let parsed = {};
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch { /* ignore */ }
+        if (res.status === 403 || parsed.error === 'pro_required') {
+            throw new Error('Engram-hosted whisper requires a Pro subscription ($9/mo). ' +
+                'Upgrade at https://engram-mcp.com/billing, or switch whisper.provider to "local".');
+        }
+        if (res.status === 402 || parsed.error === 'quota_exceeded') {
+            throw new Error('Engram whisper quota exceeded for this month. ' +
+                'Enable overage in your account, or wait for the next billing cycle.');
+        }
+        throw new Error(`Engram whisper API ${res.status}: ${body.slice(0, 200)}`);
+    }
+    const data = (await res.json());
+    if (data.overage_billed) {
+        log.warn(`Engram whisper overage billed — ${data.seconds_used}s used this request. ` +
+            `Check your usage at https://engram-mcp.com/billing.`);
+    }
+    log.info(`Engram-hosted whisper complete — ${data.seconds_used}s billed, ${data.seconds_remaining}s remaining`);
+    const fullText = data.transcript ?? '';
+    return {
+        language: data.language ?? 'unknown',
+        duration: audioDurationSeconds,
+        segments: fullText ? [{ start: 0, end: audioDurationSeconds, text: fullText }] : [],
+        full_text: fullText,
+    };
+}
+/**
+ * Rough audio duration estimate from file size.
+ * Assumes 16kHz mono WAV (~16KB/s). Accurate enough for billing rounding.
+ */
+function estimateAudioDuration(buffer) {
+    return Math.max(1, Math.ceil(buffer.length / 16_000));
+}
+// ── Local whisper.cpp transcription (original implementation) ─────────────────
+async function transcribeLocal(audioPath, config) {
+    const { nodewhisper } = (await import('nodejs-whisper'));
+    const startMs = Date.now();
+    log.info(`Transcribing ${audioPath} with local whisper model=${config.model}`);
+    // nodewhisper will write <audioPath>.json alongside the audio file
+    const jsonOutputPath = `${audioPath}.json`;
+    // Remove stale JSON if present
+    if (fs.existsSync(jsonOutputPath))
+        fs.unlinkSync(jsonOutputPath);
+    // nodejs-whisper's Logger type requires a `log` method in addition to debug/info/warn/error
+    const whisperLogger = { ...log, log: log.info };
+    const rawResult = (await nodewhisper(audioPath, {
+        modelName: config.model,
+        autoDownloadModelName: config.model,
+        removeWavFileAfterTranscription: false,
+        withCuda: false,
+        logger: whisperLogger,
+        whisperOptions: {
+            outputInText: false,
+            outputInVtt: false,
+            outputInSrt: false,
+            outputInCsv: false,
+            outputInJson: true,
+            outputInJsonFull: true,
+            outputInWords: false,
+            outputInLrc: false,
+            translateToEnglish: false,
+            wordTimestamps: false,
+            timestamps_length: 20,
+            splitOnWord: false,
+        },
+    }));
+    let segments = [];
+    let detectedLanguage = config.language === 'auto' ? 'unknown' : config.language;
+    // Prefer the JSON file written by whisper-cli for structured segment data
+    if (fs.existsSync(jsonOutputPath)) {
+        try {
+            const jsonText = fs.readFileSync(jsonOutputPath, 'utf-8');
+            const parsed = JSON.parse(jsonText);
+            if (parsed.result?.language)
+                detectedLanguage = parsed.result.language;
+            if (Array.isArray(parsed.transcription)) {
+                segments = parsed.transcription.map((s) => ({
+                    start: parseTimestamp(s.timestamps.from),
+                    end: parseTimestamp(s.timestamps.to),
+                    text: s.text.trim(),
+                }));
+            }
+        }
+        catch (e) {
+            log.warn(`Failed to parse whisper JSON output at ${jsonOutputPath}: ${e}`);
+        }
+    }
+    // Fallback: parse stdout as plain text
+    if (segments.length === 0) {
+        const rawStr = String(rawResult).trim();
+        if (rawStr) {
+            segments = [{ start: 0, end: 0, text: rawStr }];
+        }
+    }
+    const elapsed = Date.now() - startMs;
+    log.info(`Transcribed ${audioPath} in ${elapsed}ms — ${segments.length} segments`);
+    return {
+        language: detectedLanguage,
+        duration: segments.length ? segments[segments.length - 1].end : 0,
+        segments,
+        full_text: segments.map((s) => s.text).join('\n'),
+    };
+}
+function parseTimestamp(ts) {
+    // Format: "00:00:01,234" or "00:00:01.234"
+    const match = ts.match(/(\d{1,2}):(\d{2}):(\d{2})[.,](\d+)/);
+    if (!match)
+        return 0;
+    const [, h, m, s, ms] = match;
+    return Number(h) * 3600 + Number(m) * 60 + Number(s) + Number(ms) / 1000;
+}
+export function getWhisperModelDir() {
+    const home = process.env.DATA_DIR
+        ? process.env.DATA_DIR.replace(/^~/, os.homedir())
+        : path.join(os.homedir(), '.engram');
+    return path.join(home, 'whisper-models');
+}
+//# sourceMappingURL=transcriber.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { MemoryItem, MemoryProperties } from '../../../types.js';
+export interface ExchangeInput {
+    user_message: string;
+    assistant_message: string;
+    source_id?: string;
+    agent?: string;
+    properties?: Partial<MemoryProperties>;
+}
+export declare function buildExchangeItem(input: ExchangeInput, embeddingModel: string): MemoryItem;
+//# sourceMappingURL=ingest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/conversations/ingest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGtE,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACxC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,GAAG,UAAU,CAgC1F"}

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

@@ -0,0 +1,38 @@
+import { ulid } from 'ulid';
+import { createHash } from 'crypto';
+import { extractWikilinks } from '../../core/wikilinks.js';
+export function buildExchangeItem(input, embeddingModel) {
+    const now = new Date().toISOString();
+    const content = formatExchange(input.user_message, input.assistant_message);
+    const properties = {
+        created_at: input.properties?.created_at ?? now,
+        ingested_at: now,
+        title: input.properties?.title,
+        tags: input.properties?.tags,
+        source_url: input.properties?.source_url,
+        author: input.agent ?? input.properties?.author,
+        sentiment: input.properties?.sentiment,
+        action_required: input.properties?.action_required,
+        expires_at: input.properties?.expires_at,
+        custom: {
+            ...(input.properties?.custom ?? {}),
+            user_msg_length: input.user_message.length,
+            assistant_msg_length: input.assistant_message.length,
+        },
+    };
+    return {
+        id: ulid(),
+        type: 'conversations',
+        source_id: input.source_id ?? `agent:${input.agent ?? 'unknown'}:${Date.now()}`,
+        content,
+        content_hash: createHash('sha256').update(content).digest('hex'),
+        properties,
+        wikilinks: extractWikilinks(content),
+        related_ids: [],
+        embedding_model: embeddingModel,
+    };
+}
+function formatExchange(userMsg, assistantMsg) {
+    return `User: ${userMsg.trim()}\n\nAssistant: ${assistantMsg.trim()}`;
+}
+//# sourceMappingURL=ingest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../../src/memory/modules/conversations/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAU3D,MAAM,UAAU,iBAAiB,CAAC,KAAoB,EAAE,cAAsB;IAC5E,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE5E,MAAM,UAAU,GAAqB;QACnC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,IAAI,GAAG;QAC/C,WAAW,EAAE,GAAG;QAChB,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK;QAC9B,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU;QACxC,MAAM,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,MAAM;QAC/C,SAAS,EAAE,KAAK,CAAC,UAAU,EAAE,SAAS;QACtC,eAAe,EAAE,KAAK,CAAC,UAAU,EAAE,eAAe;QAClD,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU;QACxC,MAAM,EAAE;YACN,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC;YACnC,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM;YAC1C,oBAAoB,EAAE,KAAK,CAAC,iBAAiB,CAAC,MAAM;SACrD;KACF,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,IAAI,EAAE;QACV,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS,KAAK,CAAC,KAAK,IAAI,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;QAC/E,OAAO;QACP,YAAY,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAChE,UAAU;QACV,SAAS,EAAE,gBAAgB,CAAC,OAAO,CAAC;QACpC,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,cAAc;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,YAAoB;IAC3D,OAAO,SAAS,OAAO,CAAC,IAAI,EAAE,kBAAkB,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;AACxE,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/conversations/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,gCAAgC,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CA4C5E;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,gEAErF"}

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

@@ -0,0 +1,43 @@
+import { buildExchangeItem } from './ingest.js';
+import { buildConversationsTools } from './tools.js';
+export function createConversationsModule(config) {
+    let ctx = null;
+    const embeddingModel = `${config.embeddings.provider}/${config.embeddings.model}`;
+    return {
+        id: 'conversations',
+        displayName: 'Conversations',
+        isCustom: false,
+        async onBoot(c) {
+            ctx = c;
+        },
+        async onShutdown() { },
+        async ingest(input) {
+            if (!ctx)
+                throw new Error('Module not booted');
+            // Expect input.content to be JSON: { user_message, assistant_message }
+            let payload;
+            try {
+                payload = JSON.parse(input.content);
+            }
+            catch {
+                throw new Error('conversations.ingest expects content to be JSON with {user_message, assistant_message}');
+            }
+            if (!payload.user_message || !payload.assistant_message) {
+                throw new Error('conversations.ingest requires user_message and assistant_message');
+            }
+            const item = buildExchangeItem({
+                user_message: payload.user_message,
+                assistant_message: payload.assistant_message,
+                source_id: input.source_id,
+                properties: input.properties,
+            }, embeddingModel);
+            await ctx.store.insert(item);
+            return [item];
+        },
+        tools: [],
+    };
+}
+export function buildConversationsModuleTools(store, config) {
+    return buildConversationsTools(store, config);
+}
+//# sourceMappingURL=module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../../src/memory/modules/conversations/module.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGrD,MAAM,UAAU,yBAAyB,CAAC,MAAoB;IAC5D,IAAI,GAAG,GAA+B,IAAI,CAAC;IAC3C,MAAM,cAAc,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAElF,OAAO;QACL,EAAE,EAAE,eAAe;QACnB,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,KAAK;QAEf,KAAK,CAAC,MAAM,CAAC,CAAC;YACZ,GAAG,GAAG,CAAC,CAAC;QACV,CAAC;QAED,KAAK,CAAC,UAAU,KAAI,CAAC;QAErB,KAAK,CAAC,MAAM,CAAC,KAAkB;YAC7B,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAC/C,uEAAuE;YACvE,IAAI,OAA8D,CAAC;YACnE,IAAI,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBACxD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;YACtF,CAAC;YACD,MAAM,IAAI,GAAG,iBAAiB,CAC5B;gBACE,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,EACD,cAAc,CACf,CAAC;YACF,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QAED,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,KAAkB,EAAE,MAAoB;IACpF,OAAO,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAChD,CAAC"}

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

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

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

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

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

@@ -0,0 +1,70 @@
+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 { createConversationsModule, buildConversationsModuleTools } 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, // keep tests fast; extraction tested separately
+        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: { conversations: { enabled: true } },
+    mcp: { stdio: true, httpPort: 7777 },
+};
+describe('conversations module', () => {
+    let tmpDir;
+    let store;
+    beforeEach(async () => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'engram-conv-'));
+        initDb(tmpDir);
+        initVectorStore(tmpDir);
+        store = new MemoryStore({ embeddings: config.embeddings });
+        const mod = createConversationsModule(config);
+        await mod.onBoot({ store });
+    });
+    afterEach(() => {
+        closeDb();
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('remember_exchange stores and search_conversations retrieves it', async () => {
+        const tools = buildConversationsModuleTools(store, config);
+        const remember = tools.find((t) => t.name === 'remember_exchange');
+        const search = tools.find((t) => t.name === 'search_conversations');
+        await remember.handler({
+            user_message: 'What do you think of bonding curves for prediction markets?',
+            assistant_message: 'Bonding curves give continuous liquidity and avoid the LP problem of CPMM. Trade-off: harder pricing.',
+            agent: 'claude-code',
+        });
+        const results = (await search.handler({ query: 'prediction market liquidity' }));
+        expect(results.length).toBeGreaterThan(0);
+        expect(results[0].agent).toBe('claude-code');
+        expect(results[0].score).toBeGreaterThan(0.3);
+    }, 30_000);
+    it('ingest() via module accepts JSON content', async () => {
+        const mod = createConversationsModule(config);
+        await mod.onBoot({ store });
+        const items = await mod.ingest({
+            content: JSON.stringify({
+                user_message: 'hi',
+                assistant_message: 'hello',
+            }),
+            source_id: 'test:1',
+        });
+        expect(items).toHaveLength(1);
+        expect(items[0].type).toBe('conversations');
+        expect(items[0].content).toContain('User: hi');
+        expect(items[0].content).toContain('Assistant: hello');
+    });
+});
+//# sourceMappingURL=conversations.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.test.js","sourceRoot":"","sources":["../../../../../src/memory/modules/conversations/tests/conversations.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,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAGxF,MAAM,MAAM,GAAiB;IAC3B,OAAO,EAAE,WAAW;IACpB,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAiB,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,EAAE;IAC1H,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,kBAAkB,EAAE;QAClB,OAAO,EAAE,KAAK,EAAE,gDAAgD;QAChE,OAAO,EAAE,wBAAwB;QACjC,KAAK,EAAE,aAAa;QACpB,SAAS,EAAE,GAAG;KACf;IACD,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;IAC/D,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;IACvE,OAAO,EAAE,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IAC7C,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;CACrC,CAAC;AAEF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,IAAI,MAAc,CAAC;IACnB,IAAI,KAAkB,CAAC;IAEvB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,MAAM,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,CAAC;QACf,eAAe,CAAC,MAAM,CAAC,CAAC;QACxB,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9B,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,gEAAgE,EAAE,KAAK,IAAI,EAAE;QAC9E,MAAM,KAAK,GAAG,6BAA6B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAmB,CAAE,CAAC;QACpE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAE,CAAC;QAErE,MAAM,QAAQ,CAAC,OAAO,CAAC;YACrB,YAAY,EAAE,6DAA6D;YAC3E,iBAAiB,EACf,uGAAuG;YACzG,KAAK,EAAE,aAAa;SACrB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAI7E,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC,EAAE,MAAM,CAAC,CAAC;IAEX,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,GAAG,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC;YAC7B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;gBACtB,YAAY,EAAE,IAAI;gBAClB,iBAAiB,EAAE,OAAO;aAC3B,CAAC;YACF,SAAS,EAAE,QAAQ;SACpB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/conversations/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,uBAAuB,CACrC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB,iBAAiB,EAAE,CAiFrB"}

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

@@ -0,0 +1,75 @@
+import { buildExchangeItem } from './ingest.js';
+export function buildConversationsTools(store, config) {
+    return [
+        {
+            name: 'remember_exchange',
+            description: 'Save a user/assistant exchange to long-term memory. Call this after meaningful conversations the user may want to recall later. Provide both messages verbatim. IMPORTANT: you (the calling LLM) must ALSO provide `title` (3-7 words summarizing the exchange) and 3-5 `tags`. EngramMCP does not run an LLM internally — you are the LLM that understands this exchange, so you must label it.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    user_message: { type: 'string', description: 'The user\'s message verbatim' },
+                    assistant_message: {
+                        type: 'string',
+                        description: 'The assistant\'s reply verbatim',
+                    },
+                    agent: {
+                        type: 'string',
+                        description: 'Identifier for the agent runtime (e.g. claude-code, cursor)',
+                    },
+                    title: {
+                        type: 'string',
+                        description: 'Short title summarizing the exchange (3-7 words). Required for good retrieval.',
+                    },
+                    tags: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: '3-5 lowercase keywords. Required for good retrieval.',
+                    },
+                },
+                required: ['user_message', 'assistant_message'],
+            },
+            handler: async (args) => {
+                const title = args.title;
+                const tags = args.tags;
+                const item = buildExchangeItem({
+                    user_message: args.user_message,
+                    assistant_message: args.assistant_message,
+                    agent: args.agent,
+                    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 exchange is retrievable later.';
+                }
+                return response;
+            },
+        },
+        {
+            name: 'search_conversations',
+            description: 'Search past user/assistant conversations by semantic similarity. Use when looking for what was discussed or decided previously.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string' },
+                    limit: { type: 'number', default: 10 },
+                },
+                required: ['query'],
+            },
+            handler: async (args) => {
+                const hits = await store.search('conversations', args.query, args.limit ?? 10);
+                return hits.map((h) => ({
+                    id: h.memory.id,
+                    score: h.score,
+                    snippet: h.snippet,
+                    title: h.memory.properties.title,
+                    tags: h.memory.properties.tags,
+                    agent: h.memory.properties.author,
+                    created_at: h.memory.properties.created_at,
+                }));
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { EngramConfig } from '../../../config/schema.js';
+export interface DriveFileMetadata {
+    id: string;
+    name: string;
+    mimeType: string;
+    modifiedTime: string;
+    size?: string;
+}
+export declare function getFileMetadata(fileId: string, config: EngramConfig): Promise<DriveFileMetadata>;
+export declare function downloadFileContent(fileId: string, mimeType: string, config: EngramConfig): Promise<string | null>;
+export declare function listFiles(config: EngramConfig, options?: {
+    pageToken?: string;
+    pageSize?: number;
+    query?: string;
+}): Promise<{
+    files: DriveFileMetadata[];
+    nextPageToken?: string;
+}>;
+//# sourceMappingURL=connector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/drive/connector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAU9D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAS5B;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBxB;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACtE,OAAO,CAAC;IAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAWjE"}

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

@@ -0,0 +1,52 @@
+import { createLogger } from '../../../logger.js';
+import { getValidAccessToken } from './oauth.js';
+const log = createLogger('drive:connector');
+const EXPORTABLE = {
+    'application/vnd.google-apps.document': 'text/plain',
+    'application/vnd.google-apps.spreadsheet': 'text/csv',
+    'application/vnd.google-apps.presentation': 'text/plain',
+};
+export async function getFileMetadata(fileId, config) {
+    const token = await getValidAccessToken(config);
+    const url = new URL(`https://www.googleapis.com/drive/v3/files/${encodeURIComponent(fileId)}`);
+    url.searchParams.set('fields', 'id,name,mimeType,modifiedTime,size');
+    const res = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+    if (!res.ok) {
+        throw new Error(`Drive metadata fetch failed: ${res.status} ${await res.text()}`);
+    }
+    return (await res.json());
+}
+export async function downloadFileContent(fileId, mimeType, config) {
+    const token = await getValidAccessToken(config);
+    let url;
+    if (EXPORTABLE[mimeType]) {
+        url = `https://www.googleapis.com/drive/v3/files/${encodeURIComponent(fileId)}/export?mimeType=${encodeURIComponent(EXPORTABLE[mimeType])}`;
+    }
+    else if (mimeType.startsWith('text/')) {
+        url = `https://www.googleapis.com/drive/v3/files/${encodeURIComponent(fileId)}?alt=media`;
+    }
+    else {
+        log.warn(`Drive file ${fileId} has unsupported mimeType ${mimeType} — skipping`);
+        return null;
+    }
+    const res = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+    if (!res.ok) {
+        throw new Error(`Drive content fetch failed: ${res.status}`);
+    }
+    return await res.text();
+}
+export async function listFiles(config, options = {}) {
+    const token = await getValidAccessToken(config);
+    const url = new URL('https://www.googleapis.com/drive/v3/files');
+    url.searchParams.set('fields', 'files(id,name,mimeType,modifiedTime,size),nextPageToken');
+    url.searchParams.set('pageSize', String(options.pageSize ?? 50));
+    if (options.query)
+        url.searchParams.set('q', options.query);
+    if (options.pageToken)
+        url.searchParams.set('pageToken', options.pageToken);
+    const res = await fetch(url, { headers: { Authorization: `Bearer ${token}` } });
+    if (!res.ok)
+        throw new Error(`Drive list failed: ${res.status}`);
+    return (await res.json());
+}
+//# sourceMappingURL=connector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../../src/memory/modules/drive/connector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGjD,MAAM,GAAG,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAE5C,MAAM,UAAU,GAA2B;IACzC,sCAAsC,EAAE,YAAY;IACpD,yCAAyC,EAAE,UAAU;IACrD,0CAA0C,EAAE,YAAY;CACzD,CAAC;AAUF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,MAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,6CAA6C,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/F,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,oCAAoC,CAAC,CAAC;IACrE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,CAAC,MAAM,IAAI,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAsB,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,QAAgB,EAChB,MAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAEhD,IAAI,GAAW,CAAC;IAChB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,GAAG,GAAG,6CAA6C,kBAAkB,CAAC,MAAM,CAAC,oBAAoB,kBAAkB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;IAC9I,CAAC;SAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,GAAG,GAAG,6CAA6C,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC;IAC5F,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,cAAc,MAAM,6BAA6B,QAAQ,aAAa,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAAoB,EACpB,UAAqE,EAAE;IAEvE,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,2CAA2C,CAAC,CAAC;IACjE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,yDAAyD,CAAC,CAAC;IAC1F,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,KAAK;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,SAAS;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAE5E,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAChF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA2D,CAAC;AACtF,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/drive/ingest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAuBlE"}

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

@@ -0,0 +1,27 @@
+import { ulid } from 'ulid';
+import { createHash } from 'crypto';
+export function buildDriveItem(input) {
+    const now = new Date().toISOString();
+    const properties = {
+        title: input.metadata.name,
+        created_at: input.metadata.modifiedTime ?? now,
+        ingested_at: now,
+        source_url: `https://drive.google.com/file/d/${input.metadata.id}/view`,
+        custom: {
+            mime_type: input.metadata.mimeType,
+            drive_file_id: input.metadata.id,
+        },
+    };
+    return {
+        id: ulid(),
+        type: 'drive',
+        source_id: `drive:${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/drive/ingest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../../src/memory/modules/drive/ingest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAUpC,MAAM,UAAU,cAAc,CAAC,KAAuB;IACpD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,UAAU,GAAqB;QACnC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI;QAC1B,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,YAAY,IAAI,GAAG;QAC9C,WAAW,EAAE,GAAG;QAChB,UAAU,EAAE,mCAAmC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO;QACvE,MAAM,EAAE;YACN,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ;YAClC,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE;SACjC;KACF,CAAC;IACF,OAAO;QACL,EAAE,EAAE,IAAI,EAAE;QACV,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,SAAS,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE;QACvC,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/drive/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 createDriveModule(config: EngramConfig): MemoryModule;
+export declare function buildDriveModuleTools(store: MemoryStore, config: EngramConfig): import("../../core/module-interface.js").MCPToolDefinition[];
+//# sourceMappingURL=module.d.ts.map