@raviolelabs/engram-mcp 0.2.0

package/dist/memory/core/source-registry.js

@@ -0,0 +1,86 @@
+import { ulid } from 'ulid';
+import { getDb } from '../../db/index.js';
+function rowToSource(row) {
+    return {
+        id: row.id,
+        module_id: row.module_id,
+        external_id: row.external_id,
+        display_name: row.display_name,
+        config: JSON.parse(row.config_json || '{}'),
+        last_synced_at: row.last_synced_at ?? null,
+        last_modified_remote: row.last_modified_remote ?? null,
+        last_error: row.last_error ?? null,
+        enabled: !!row.enabled,
+        created_at: row.created_at,
+    };
+}
+class SourceRegistry {
+    /**
+     * Add a watched source.
+     * IDEMPOTENT: if (module_id, external_id) already exists, returns the existing id
+     * without inserting a duplicate row. Callers can check `alreadyExists` on the result.
+     */
+    add(input) {
+        const existing = getDb()
+            .prepare(`SELECT id FROM watched_sources WHERE module_id = ? AND external_id = ? LIMIT 1`)
+            .get(input.module_id, input.external_id);
+        if (existing)
+            return existing.id;
+        const id = ulid();
+        getDb()
+            .prepare(`INSERT INTO watched_sources
+         (id, module_id, external_id, display_name, config_json, enabled, created_at)
+         VALUES (?, ?, ?, ?, ?, 1, ?)`)
+            .run(id, input.module_id, input.external_id, input.display_name, JSON.stringify(input.config ?? {}), Date.now());
+        return id;
+    }
+    /**
+     * Like add(), but also signals whether the source already existed.
+     */
+    addWithStatus(input) {
+        const existing = getDb()
+            .prepare(`SELECT id FROM watched_sources WHERE module_id = ? AND external_id = ? LIMIT 1`)
+            .get(input.module_id, input.external_id);
+        if (existing)
+            return { id: existing.id, alreadyExists: true };
+        const id = this.add(input);
+        return { id, alreadyExists: false };
+    }
+    get(id) {
+        const row = getDb().prepare('SELECT * FROM watched_sources WHERE id = ?').get(id);
+        return row ? rowToSource(row) : undefined;
+    }
+    list(module_id) {
+        const rows = module_id
+            ? getDb()
+                .prepare('SELECT * FROM watched_sources WHERE module_id = ? ORDER BY created_at')
+                .all(module_id)
+            : getDb()
+                .prepare('SELECT * FROM watched_sources ORDER BY module_id, created_at')
+                .all();
+        return rows.map(rowToSource);
+    }
+    listEnabled(module_id) {
+        const rows = getDb()
+            .prepare('SELECT * FROM watched_sources WHERE module_id = ? AND enabled = 1 ORDER BY created_at')
+            .all(module_id);
+        return rows.map(rowToSource);
+    }
+    recordSync(id, remoteModifiedAt = null, error) {
+        getDb()
+            .prepare(`UPDATE watched_sources
+         SET last_synced_at = ?, last_modified_remote = ?, last_error = ?
+         WHERE id = ?`)
+            .run(Date.now(), remoteModifiedAt, error ?? null, id);
+    }
+    setEnabled(id, enabled) {
+        getDb()
+            .prepare('UPDATE watched_sources SET enabled = ? WHERE id = ?')
+            .run(enabled ? 1 : 0, id);
+    }
+    remove(id) {
+        getDb().prepare('DELETE FROM watched_sources WHERE id = ?').run(id);
+    }
+}
+export const sourceRegistry = new SourceRegistry();
+//# sourceMappingURL=source-registry.js.map

package/dist/memory/core/source-registry.js.map

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

package/dist/memory/core/store.d.ts

@@ -0,0 +1,40 @@
+import { EventEmitter } from 'events';
+import type { EmbeddingsConfig, PropertyExtractionConfig } from '../../config/schema.js';
+import type { MemoryItem, SearchResult } from '../../types.js';
+import type { OpsLogger } from '../../sync/ops-log.js';
+import type { EngramAlgorithms, EngramPrompts } from '../../core/server/mcp-handler.js';
+export interface MemoryStoreOptions {
+    embeddings: EmbeddingsConfig;
+    propertyExtraction?: PropertyExtractionConfig;
+    /** Algorithm overrides from private extensions (optional). */
+    algorithms?: EngramAlgorithms;
+    /** Prompt overrides from private extensions (optional). */
+    prompts?: EngramPrompts;
+}
+export declare class MemoryStore {
+    private options;
+    readonly events: EventEmitter<[never]>;
+    private opsLogger?;
+    constructor(options: MemoryStoreOptions);
+    /** Exposed for public tools that need algorithm overrides (e.g. search_all, suggest_properties). */
+    get algorithms(): EngramAlgorithms;
+    /** Exposed for public tools that need prompt overrides (e.g. suggest_properties). */
+    get prompts(): EngramPrompts;
+    /** Wire an OpsLogger — every mutation will be logged for sync. */
+    setOpsLogger(logger: OpsLogger): void;
+    insert(item: MemoryItem): Promise<void>;
+    getById(id: string): MemoryItem | undefined;
+    search(memoryType: string, query: string, limit?: number): Promise<SearchResult[]>;
+    delete(id: string): Promise<void>;
+    deleteBySourceId(sourceId: string): Promise<void>;
+    findRelated(memoryId: string, limit?: number): Promise<SearchResult[]>;
+    /** OSS basic: wikilinks-only reverse-link lookup. */
+    findRelatedBasic(memoryId: string, limit?: number): Promise<SearchResult[]>;
+    setProperties(id: string, patch: Partial<import('../../types.js').MemoryProperties>): boolean;
+    /** Insert a MemoryItem that came from sync replay — skip ops logging to avoid re-logging. */
+    insertWithoutLog(item: MemoryItem): Promise<void>;
+    /** Delete vector entry only (no SQLite + no ops log). Used during tombstone finalization. */
+    deleteVectorIfExists(memoryId: string): Promise<void>;
+    listTypes(): string[];
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/memory/core/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/memory/core/store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAWtC,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAIxF,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C,8DAA8D;IAC9D,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,qBAAa,WAAW;IAIV,OAAO,CAAC,OAAO;IAH3B,QAAQ,CAAC,MAAM,wBAAsB;IACrC,OAAO,CAAC,SAAS,CAAC,CAAY;gBAEV,OAAO,EAAE,kBAAkB;IAE/C,oGAAoG;IACpG,IAAI,UAAU,IAAI,gBAAgB,CAEjC;IAED,qFAAqF;IACrF,IAAI,OAAO,IAAI,aAAa,CAE3B;IAED,kEAAkE;IAClE,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAI/B,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAmF7C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAkCrC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiB9E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCjC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAQxE,qDAAqD;IAC/C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IA2C7E,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,OAAO;IAqB7F,6FAA6F;IACvF,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD,6FAA6F;IACvF,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB3D,SAAS,IAAI,MAAM,EAAE;CAMtB"}

package/dist/memory/core/store.js

@@ -0,0 +1,257 @@
+// src/memory/core/store.ts
+import { EventEmitter } from 'events';
+import { getDb } from '../../db/index.js';
+import { indexChunk, semanticSearch, deleteChunk, } from '../../vector/store.js';
+import { embed } from '../../embeddings/index.js';
+import { chunkText as chunkTextBasic } from './chunker.js';
+import { createLogger } from '../../logger.js';
+import { extractProperties } from './property-extractor.js';
+const log = createLogger('memory-store');
+export class MemoryStore {
+    options;
+    events = new EventEmitter();
+    opsLogger;
+    constructor(options) {
+        this.options = options;
+    }
+    /** Exposed for public tools that need algorithm overrides (e.g. search_all, suggest_properties). */
+    get algorithms() {
+        return this.options.algorithms ?? {};
+    }
+    /** Exposed for public tools that need prompt overrides (e.g. suggest_properties). */
+    get prompts() {
+        return this.options.prompts ?? {};
+    }
+    /** Wire an OpsLogger — every mutation will be logged for sync. */
+    setOpsLogger(logger) {
+        this.opsLogger = logger;
+    }
+    async insert(item) {
+        // Log op BEFORE writing to SQLite (ops log is source of truth for sync)
+        if (this.opsLogger) {
+            this.opsLogger.append('add_memory', item.id, { item });
+        }
+        // Property extraction is OPT-IN (off by default). EngramMCP does not run a
+        // local LLM during ingestion — the calling agent (Claude/GPT/etc.) is the
+        // LLM and should provide title/tags directly via add_note/remember_exchange.
+        // Power users who want background auto-extraction can flip propertyExtraction.enabled
+        // to true in ~/.engram/config.json (requires local Ollama with the configured model).
+        if (this.options.propertyExtraction?.enabled) {
+            const needsExtraction = !item.properties.title || !item.properties.tags || item.properties.tags.length === 0;
+            if (needsExtraction) {
+                const extracted = await extractProperties(item.content, this.options.propertyExtraction, this.options.prompts?.extractionSystemPrompt);
+                item.properties = {
+                    ...item.properties,
+                    title: item.properties.title ?? extracted.title,
+                    tags: item.properties.tags ?? extracted.tags,
+                    sentiment: item.properties.sentiment ?? extracted.sentiment,
+                    action_required: item.properties.action_required ?? extracted.action_required,
+                    custom: { ...(item.properties.custom ?? {}), ...(extracted.custom ?? {}) },
+                };
+            }
+        }
+        const db = getDb();
+        const insert = db.prepare(`
+      INSERT OR REPLACE INTO memories
+        (id, type, source_id, content, content_hash, properties_json,
+         wikilinks_json, related_ids_json, embedding_model, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        insert.run(item.id, item.type, item.source_id, item.content, item.content_hash, JSON.stringify(item.properties), JSON.stringify(item.wikilinks), JSON.stringify(item.related_ids), item.embedding_model, Date.parse(item.properties.created_at));
+        // FTS index
+        db.prepare(`INSERT INTO memories_fts (id, content, title, tags) VALUES (?, ?, ?, ?)`).run(item.id, item.content, item.properties.title ?? '', (item.properties.tags ?? []).join(' '));
+        // Vector index — chunk + embed + store per chunk
+        // Use private semantic chunker if loaded, else OSS paragraph/sentence fallback
+        const chunkFn = this.options.algorithms?.chunkText ?? chunkTextBasic;
+        const chunks = await Promise.resolve(chunkFn(item.content));
+        for (let i = 0; i < chunks.length; i++) {
+            const vec = await embed(chunks[i], this.options.embeddings);
+            const chunkId = chunks.length === 1 ? item.id : `${item.id}:${i}`;
+            await indexChunk(item.type, {
+                id: chunkId,
+                source_id: item.source_id,
+                chunk_index: i,
+                content: chunks[i],
+                created_at: Date.parse(item.properties.created_at),
+                field1: item.properties.title ?? '',
+                field2: (item.properties.tags ?? []).join(','),
+            }, vec);
+        }
+        log.debug(`Inserted memory ${item.id} (${chunks.length} chunks) in type=${item.type}`);
+        this.events.emit('memory.added', item);
+    }
+    getById(id) {
+        const row = getDb()
+            .prepare(`SELECT id, type, source_id, content, content_hash, properties_json,
+                wikilinks_json, related_ids_json, embedding_model
+         FROM memories WHERE id = ?`)
+            .get(id);
+        if (!row)
+            return undefined;
+        return {
+            id: row.id,
+            type: row.type,
+            source_id: row.source_id,
+            content: row.content,
+            content_hash: row.content_hash,
+            properties: JSON.parse(row.properties_json),
+            wikilinks: JSON.parse(row.wikilinks_json),
+            related_ids: JSON.parse(row.related_ids_json),
+            embedding_model: row.embedding_model,
+        };
+    }
+    async search(memoryType, query, limit = 10) {
+        const hits = await semanticSearch(memoryType, query, this.options.embeddings, limit);
+        const results = [];
+        for (const hit of hits) {
+            // Derive memory id from chunk id (strip ":<index>" if present)
+            const memoryId = hit.chunk.id.includes(':') ? hit.chunk.id.split(':')[0] : hit.chunk.id;
+            const memory = this.getById(memoryId);
+            if (!memory)
+                continue;
+            results.push({
+                memory,
+                score: hit.similarity,
+                snippet: hit.chunk.content.slice(0, 200),
+            });
+        }
+        return results;
+    }
+    async delete(id) {
+        const item = this.getById(id);
+        if (!item)
+            return;
+        // Log op + insert tombstone (grace period for conflict resolution)
+        if (this.opsLogger) {
+            const opId = this.opsLogger.append('delete_memory', id, { memory_id: id });
+            const now = Date.now();
+            const GRACE_MS = 5 * 60 * 1000;
+            getDb()
+                .prepare(`INSERT OR REPLACE INTO tombstones (memory_id, deleted_at, op_id, grace_until, finalized)
+           VALUES (?, ?, ?, ?, 0)`)
+                .run(id, now, opId, now + GRACE_MS);
+        }
+        const db = getDb();
+        db.prepare('DELETE FROM memories WHERE id = ?').run(id);
+        db.prepare('DELETE FROM memories_fts WHERE id = ?').run(id);
+        await deleteChunk(item.type, id);
+        // Chunked items: also delete suffixed chunk ids
+        for (let i = 0; i < 50; i++) {
+            try {
+                await deleteChunk(item.type, `${id}:${i}`);
+            }
+            catch {
+                break;
+            }
+        }
+        if (item)
+            this.events.emit('memory.deleted', { id, type: item.type });
+    }
+    async deleteBySourceId(sourceId) {
+        const rows = getDb()
+            .prepare('SELECT id, type FROM memories WHERE source_id = ?')
+            .all(sourceId);
+        for (const row of rows) {
+            await this.delete(row.id);
+        }
+    }
+    async findRelated(memoryId, limit = 10) {
+        // Use private smart version if loaded, else fall back to wikilinks-only basic
+        if (this.options.algorithms?.findRelated) {
+            return this.options.algorithms.findRelated(this, memoryId, limit);
+        }
+        return this.findRelatedBasic(memoryId, limit);
+    }
+    /** OSS basic: wikilinks-only reverse-link lookup. */
+    async findRelatedBasic(memoryId, limit = 10) {
+        const source = this.getById(memoryId);
+        if (!source)
+            return [];
+        // Wikilinks: memories whose content contains [[source.id]] or [[source.title]]
+        const target = source.properties.title ?? source.id;
+        const wikilinked = getDb()
+            .prepare(`SELECT id, type, source_id, content, content_hash, properties_json,
+                wikilinks_json, related_ids_json, embedding_model
+         FROM memories
+         WHERE content LIKE ? AND id <> ?
+         LIMIT ?`)
+            .all(`%[[${target}]]%`, memoryId, limit);
+        return wikilinked.map((row) => ({
+            memory: {
+                id: row.id,
+                type: row.type,
+                source_id: row.source_id,
+                content: row.content,
+                content_hash: row.content_hash,
+                properties: JSON.parse(row.properties_json),
+                wikilinks: JSON.parse(row.wikilinks_json),
+                related_ids: JSON.parse(row.related_ids_json),
+                embedding_model: row.embedding_model,
+            },
+            score: 1.0, // explicit wikilink — high confidence
+            snippet: row.content.slice(0, 200),
+        }));
+    }
+    setProperties(id, patch) {
+        const item = this.getById(id);
+        if (!item)
+            return false;
+        // Log op before writing
+        if (this.opsLogger) {
+            this.opsLogger.append('update_properties', id, { memory_id: id, delta: patch });
+        }
+        const merged = { ...item.properties, ...patch };
+        getDb()
+            .prepare('UPDATE memories SET properties_json = ? WHERE id = ?')
+            .run(JSON.stringify(merged), id);
+        // Update FTS title/tags
+        getDb()
+            .prepare('UPDATE memories_fts SET title = ?, tags = ? WHERE id = ?')
+            .run(merged.title ?? '', (merged.tags ?? []).join(' '), id);
+        this.events.emit('memory.updated', { id });
+        return true;
+    }
+    /** Insert a MemoryItem that came from sync replay — skip ops logging to avoid re-logging. */
+    async insertWithoutLog(item) {
+        const savedLogger = this.opsLogger;
+        this.opsLogger = undefined;
+        try {
+            await this.insert(item);
+        }
+        finally {
+            this.opsLogger = savedLogger;
+        }
+    }
+    /** Delete vector entry only (no SQLite + no ops log). Used during tombstone finalization. */
+    async deleteVectorIfExists(memoryId) {
+        // Look up the memory type from SQLite (may already be deleted — that's fine)
+        const row = getDb()
+            .prepare(`SELECT type FROM memories WHERE id = ?`)
+            .get(memoryId);
+        const memType = row?.type;
+        if (!memType)
+            return; // already gone from SQLite — LanceDB likely also gone
+        try {
+            await deleteChunk(memType, memoryId);
+            // Also try chunk variants
+            for (let i = 0; i < 50; i++) {
+                try {
+                    await deleteChunk(memType, `${memoryId}:${i}`);
+                }
+                catch {
+                    break;
+                }
+            }
+        }
+        catch {
+            // Vector may not exist — ignore
+        }
+    }
+    listTypes() {
+        const rows = getDb()
+            .prepare(`SELECT DISTINCT type FROM memories ORDER BY type`)
+            .all();
+        return rows.map((r) => r.type);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/core/store.js.map

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

package/dist/memory/core/wikilinks.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Extract Obsidian-style wikilinks from text.
+ *
+ * Supports:
+ *   [[target]]
+ *   [[target|alias]]
+ *   [[target#section]]
+ *   [[target#section|alias]]
+ *
+ * Returns target portion (no alias, no section), deduplicated.
+ */
+export declare function extractWikilinks(content: string): string[];
+//# sourceMappingURL=wikilinks.d.ts.map

package/dist/memory/core/wikilinks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikilinks.d.ts","sourceRoot":"","sources":["../../../src/memory/core/wikilinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAW1D"}

package/dist/memory/core/wikilinks.js

@@ -0,0 +1,25 @@
+/**
+ * Extract Obsidian-style wikilinks from text.
+ *
+ * Supports:
+ *   [[target]]
+ *   [[target|alias]]
+ *   [[target#section]]
+ *   [[target#section|alias]]
+ *
+ * Returns target portion (no alias, no section), deduplicated.
+ */
+export function extractWikilinks(content) {
+    const matches = content.match(/\[\[([^\]]+)\]\]/g);
+    if (!matches)
+        return [];
+    const targets = matches.map((m) => {
+        const inner = m.slice(2, -2);
+        // strip alias after |
+        const noAlias = inner.split('|')[0];
+        // strip section after #
+        return noAlias.split('#')[0].trim();
+    });
+    return Array.from(new Set(targets)).filter((t) => t.length > 0);
+}
+//# sourceMappingURL=wikilinks.js.map

package/dist/memory/core/wikilinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikilinks.js","sourceRoot":"","sources":["../../../src/memory/core/wikilinks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,sBAAsB;QACtB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,wBAAwB;QACxB,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/memory/modules/_custom/generic-module.d.ts

@@ -0,0 +1,7 @@
+import type { MemoryModule, MCPToolDefinition } from '../../core/module-interface.js';
+import type { MemoryStore } from '../../core/store.js';
+import type { EngramConfig } from '../../../config/schema.js';
+import type { CustomTypeDefinition } from './persistence.js';
+export declare function createGenericModule(def: CustomTypeDefinition, config: EngramConfig): MemoryModule;
+export declare function buildGenericModuleTools(def: CustomTypeDefinition, store: MemoryStore, config: EngramConfig): MCPToolDefinition[];
+//# sourceMappingURL=generic-module.d.ts.map

package/dist/memory/modules/_custom/generic-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-module.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/_custom/generic-module.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAiC7D,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,YAAY,GACnB,YAAY,CAuBd;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,oBAAoB,EACzB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,GACnB,iBAAiB,EAAE,CAgErB"}

package/dist/memory/modules/_custom/generic-module.js

@@ -0,0 +1,108 @@
+// src/memory/modules/_custom/generic-module.ts
+import { ulid } from 'ulid';
+import { createHash } from 'crypto';
+import { extractWikilinks } from '../../core/wikilinks.js';
+function buildGenericItem(typeName, input, embeddingModel) {
+    const now = new Date().toISOString();
+    const properties = {
+        title: input.properties?.title,
+        tags: input.properties?.tags,
+        created_at: input.properties?.created_at ?? now,
+        ingested_at: now,
+        source_url: input.properties?.source_url,
+        author: input.properties?.author,
+        sentiment: input.properties?.sentiment,
+        action_required: input.properties?.action_required,
+        expires_at: input.properties?.expires_at,
+        custom: input.properties?.custom,
+    };
+    return {
+        id: ulid(),
+        type: typeName,
+        source_id: input.source_id ?? `${typeName}:${Date.now()}`,
+        content: input.content,
+        content_hash: createHash('sha256').update(input.content).digest('hex'),
+        properties,
+        wikilinks: extractWikilinks(input.content),
+        related_ids: [],
+        embedding_model: embeddingModel,
+    };
+}
+export function createGenericModule(def, config) {
+    let store = null;
+    const embeddingModel = `${config.embeddings.provider}/${config.embeddings.model}`;
+    return {
+        id: def.type_name,
+        displayName: def.display_name,
+        isCustom: true,
+        async onBoot(ctx) {
+            store = ctx.store;
+        },
+        async onShutdown() { },
+        async ingest(input) {
+            if (!store)
+                throw new Error('Module not booted');
+            const item = buildGenericItem(def.type_name, input, embeddingModel);
+            await store.insert(item);
+            return [item];
+        },
+        tools: [],
+    };
+}
+export function buildGenericModuleTools(def, store, config) {
+    const embeddingModel = `${config.embeddings.provider}/${config.embeddings.model}`;
+    return [
+        {
+            name: `add_${def.type_name}`,
+            description: `Add a new item to the user-defined "${def.display_name}" memory type. The calling LLM must provide title and tags directly.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    content: { type: 'string' },
+                    title: { type: 'string' },
+                    tags: { type: 'array', items: { type: 'string' } },
+                    custom: {
+                        type: 'object',
+                        description: 'Custom fields specific to this memory type.',
+                    },
+                },
+                required: ['content'],
+            },
+            handler: async (args) => {
+                const item = buildGenericItem(def.type_name, {
+                    content: args.content,
+                    source_id: args.source_id ?? `${def.type_name}:${Date.now()}`,
+                    properties: {
+                        title: args.title,
+                        tags: args.tags,
+                        custom: args.custom,
+                    },
+                }, embeddingModel);
+                await store.insert(item);
+                return { id: item.id, type: def.type_name };
+            },
+        },
+        {
+            name: `search_${def.type_name}`,
+            description: `Search the user-defined "${def.display_name}" memory type by semantic similarity. The calling LLM must provide a descriptive query.`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string' },
+                    limit: { type: 'number', default: 10 },
+                },
+                required: ['query'],
+            },
+            handler: async (args) => {
+                const hits = await store.search(def.type_name, args.query, args.limit ?? 10);
+                return hits.map((h) => ({
+                    id: h.memory.id,
+                    score: h.score,
+                    snippet: h.snippet,
+                    title: h.memory.properties.title,
+                }));
+            },
+        },
+    ];
+}
+//# sourceMappingURL=generic-module.js.map

package/dist/memory/modules/_custom/generic-module.js.map

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

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

@@ -0,0 +1,15 @@
+export interface CustomTypeDefinition {
+    type_name: string;
+    display_name: string;
+    schema_json: string | null;
+    created_at: number;
+}
+export declare function validateTypeName(name: string): void;
+export declare function createCustomType(input: {
+    type_name: string;
+    display_name: string;
+    schema?: object;
+}): CustomTypeDefinition;
+export declare function listCustomTypes(): CustomTypeDefinition[];
+export declare function deleteCustomType(typeName: string): void;
+//# sourceMappingURL=persistence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../../src/memory/modules/_custom/persistence.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CASnD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,oBAAoB,CAgBvB;AAED,wBAAgB,eAAe,IAAI,oBAAoB,EAAE,CAMxD;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAGvD"}