abmind 0.0.1 → 0.1.0

package/dist/src/memory-index.js

@@ -0,0 +1,310 @@
+import { getAbmindEnv } from "./env-schema.js";
+import { logWarn } from "./mem-logger.js";
+import { classifyTurn } from "./turn-classifier.js";
+/** Weight applied to the log1p emotion boost in search ranking. */
+export const EMOTION_BOOST_WEIGHT = 0.5;
+// Time-decay: recent memories score higher, emotional ones resist decay
+/** Compute recency factor with emotion override. */
+export function recencyFactor(createdAt, emotionScore) {
+    const ageDays = (Date.now() - createdAt) / (24 * 3600000);
+    const decay = Math.max(getAbmindEnv().recallDecayFloor, 1 - ageDays / getAbmindEnv().recallDecayDays);
+    const emotionBoost = 1 + Math.abs(emotionScore) * getAbmindEnv().recallEmotionBoost;
+    return decay * emotionBoost;
+}
+/** Strip diacritical marks (accents) from a string using Unicode NFD decomposition. */
+function stripAccents(str) {
+    return str.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+}
+/**
+ * Sanitize a raw query string for safe use in an FTS5 MATCH clause.
+ *
+ * Wraps each whitespace-delimited token in double quotes (stripping any
+ * internal quotes) with a trailing `*` for prefix matching. Quoting
+ * neutralizes all FTS5 operators (OR, NOT, NEAR, ^, *, :, -, etc.)
+ * without needing a blacklist. Prefix matching is critical for
+ * agglutinative languages (e.g. Hungarian) where "jelszó" needs to
+ * match "jelszóra", "jelszót", etc.
+ * Returns empty string if no valid tokens remain.
+ */
+export function sanitizeFtsQuery(query, mode = "and") {
+    const tokens = query.split(/\s+/).filter(Boolean);
+    if (tokens.length === 0)
+        return "";
+    const joiner = mode === "or" ? " OR " : " ";
+    return tokens.map((t) => `"${t.replace(/"/g, "")}"*`).join(joiner);
+}
+/** Compute final score for an extracted memory FTS row. */
+function scoreExtractedRow(row, baseScore) {
+    const emotionBoost = EMOTION_BOOST_WEIGHT * Math.log(1 + Math.abs(row.emotion_score));
+    const recallBoost = 0.1 * (row.recall_count ?? 0);
+    const relevanceBoost = (row.relevance_score ?? 0) > 0 ? 0.2 : 0;
+    const trustFactor = 0.5 + 0.5 * (row.trust ?? 0) / 3;
+    const credibilityFactor = (row.credibility !== null && row.credibility <= 2) ? 1.25 : 1;
+    const tierBoost = row.tier === "core" ? 1.3 : 1;
+    return (baseScore + emotionBoost) * (1 + recallBoost) * (1 + relevanceBoost) * trustFactor * credibilityFactor * tierBoost * recencyFactor(row.created_at, row.emotion_score);
+}
+/** Map an extracted memory FTS row to a MemorySearchResult. */
+function mapExtractedRow(row, score) {
+    return {
+        id: row.id,
+        content: row.content_en,
+        content_original: row.content_original,
+        memory_type: row.memory_type,
+        created_at: row.created_at,
+        source_message_ids: row.source_message_ids ?? undefined,
+        trust: row.trust ?? 0,
+        integrity: row.integrity ?? 2,
+        credibility: row.credibility ?? 6,
+        classification: row.classification ?? 1,
+        tier: "extracted",
+        score,
+    };
+}
+/**
+ * SQLite FTS5 full-text search index over conversation messages.
+ *
+ * Messages are inserted into the `messages` table; an AFTER INSERT trigger
+ * automatically populates the `messages_fts` virtual table. Searches use
+ * BM25 ranking via FTS5's built-in `rank` column.
+ */
+export class MemoryIndex {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Index a message for full-text search by inserting into the messages table.
+     * The FTS trigger auto-indexes the content. Also runs the #348 turn classifier
+     * to store cheap hints for later middle-tier rendering (classifier is pure
+     * function, microseconds cost, runs regardless of CONTEXT_TIER_ENABLED flag).
+     * Returns the inserted message id.
+     */
+    index(record) {
+        const hints = classifyTurn(record.role, record.content);
+        const stmt = this.db.prepare(`INSERT INTO messages (user_id, session_id, role, content, timestamp, platform_message_id, type_hint, topic_hint, emotion_hint)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        const result = stmt.run(record.userId, record.sessionId, record.role, record.content, record.timestamp, record.platformMessageId ?? null, hints.typeHint, hints.topicHint, hints.emotionHint);
+        return Number(result.lastInsertRowid);
+    }
+    /**
+     * Search messages by query using FTS5 BM25 ranking.
+     *
+     * FTS5 `rank` values are negative (more negative = more relevant),
+     * so we ORDER BY rank ASC and convert to positive scores for output.
+     */
+    search(query, opts, mode = "and") {
+        if (!query.trim())
+            return [];
+        const sanitizedQuery = sanitizeFtsQuery(query, mode);
+        if (!sanitizedQuery)
+            return [];
+        const conditions = [];
+        const params = [];
+        // Use LIKE since messages_fts was dropped in migration v10
+        const keywords = query.trim().split(/\s+/).filter(Boolean);
+        if (keywords.length === 0)
+            return [];
+        const kwCondition = keywords.map(kw => {
+            params.push(`%${kw}%`);
+            return "m.content LIKE ?";
+        }).join(mode === "or" ? " OR " : " AND ");
+        conditions.push(`(${kwCondition})`);
+        if (opts?.userId !== undefined) {
+            conditions.push("m.user_id = ?");
+            params.push(opts.userId);
+        }
+        if (opts?.startTime !== undefined) {
+            conditions.push("m.timestamp >= ?");
+            params.push(opts.startTime);
+        }
+        if (opts?.endTime !== undefined) {
+            conditions.push("m.timestamp <= ?");
+            params.push(opts.endTime);
+        }
+        const limit = opts?.limit ?? 20;
+        params.push(limit);
+        const sql = `
+      SELECT m.id, m.user_id, m.session_id, m.role, m.content, m.timestamp, -1.0 as rank
+      FROM messages m
+      WHERE ${conditions.join(" AND ")}
+      ORDER BY m.timestamp DESC
+      LIMIT ?
+    `;
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map((row) => ({
+            record: {
+                role: row.role,
+                content: row.content,
+                timestamp: row.timestamp,
+                userId: row.user_id,
+                sessionId: row.session_id,
+            },
+            score: Math.abs(Number(row.rank)),
+        }));
+    }
+    /** Remove all indexed entries for a session. */
+    removeSession(userId, sessionId) {
+        this.db
+            .prepare("DELETE FROM messages WHERE user_id = ? AND session_id = ?")
+            .run(userId, sessionId);
+    }
+    /**
+     * Substring search — catches compound words that FTS5 prefix matching misses.
+     * Uses accent-insensitive matching by fetching all messages for the chat
+     * and filtering in JS with Unicode NFD normalization.
+     * Tokens shorter than 3 chars are skipped. Results scored by number of matching tokens.
+     */
+    substringSearch(query, opts, mode = "or") {
+        const tokens = query
+            .replace(/[^\w\s\u00C0-\u024F]/g, " ")
+            .split(/\s+/)
+            .filter((t) => t.length >= 3)
+            .map((t) => t.toLowerCase());
+        if (tokens.length === 0)
+            return [];
+        // Normalize tokens: strip accents for accent-insensitive matching
+        const normalizedTokens = tokens.map((t) => stripAccents(t));
+        // Fetch candidate messages from DB (filtered by chat/time only)
+        const conditions = [];
+        const params = [];
+        if (opts?.userId !== undefined) {
+            conditions.push("user_id = ?");
+            params.push(opts.userId);
+        }
+        if (opts?.startTime !== undefined) {
+            conditions.push("timestamp >= ?");
+            params.push(opts.startTime);
+        }
+        if (opts?.endTime !== undefined) {
+            conditions.push("timestamp <= ?");
+            params.push(opts.endTime);
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+        const sql = `
+      SELECT id, user_id, session_id, role, content, timestamp
+      FROM messages
+      ${whereClause}
+      ORDER BY timestamp DESC
+    `;
+        const rows = this.db.prepare(sql).all(...params);
+        // Score by number of matching tokens (accent-insensitive)
+        const limit = opts?.limit ?? 20;
+        const results = [];
+        for (const row of rows) {
+            const normalizedContent = stripAccents(row.content.toLowerCase());
+            const matchCount = normalizedTokens.filter((t) => normalizedContent.includes(t)).length;
+            if (matchCount === 0)
+                continue;
+            if (mode === "and" && matchCount < normalizedTokens.length)
+                continue;
+            results.push({
+                record: {
+                    role: row.role,
+                    content: row.content,
+                    timestamp: row.timestamp,
+                    userId: row.user_id,
+                    sessionId: row.session_id,
+                },
+                score: matchCount / normalizedTokens.length,
+            });
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, limit);
+    }
+    /** Remove oldest entries for a chat beyond the limit, keeping the most recent. */
+    prune(userId, maxMessages) {
+        this.db
+            .prepare(`DELETE FROM messages WHERE user_id = ? AND id NOT IN (
+           SELECT id FROM messages WHERE user_id = ? ORDER BY timestamp DESC LIMIT ?
+         )`)
+            .run(userId, userId, maxMessages);
+    }
+    /**
+     * Search extracted memories by English content using FTS5 on extracted_memories_fts.
+     *
+     * Joins with extracted_memories for metadata. Supports userId, time range,
+     * and limit filters. Returns MemorySearchResult[] with tier="extracted".
+     * Returns empty array on error.
+     */
+    searchExtracted(query, opts, mode = "and") {
+        try {
+            if (!query.trim())
+                return [];
+            const sanitizedQuery = sanitizeFtsQuery(query, mode);
+            if (!sanitizedQuery)
+                return [];
+            const conditions = ["extracted_memories_fts MATCH ?"];
+            const params = [sanitizedQuery];
+            // Classification filter — always exclude restricted (3), cap at maxClassification
+            const maxCls = Math.min(opts?.maxClassification ?? 2, 2);
+            conditions.push("COALESCE(em.classification, 1) <= ?");
+            params.push(maxCls);
+            // Privacy: class 0-1 shared, class 2+ private to owner
+            if (opts?.userId !== undefined) {
+                conditions.push("(COALESCE(em.classification, 1) <= 1 OR em.user_id = ?)");
+                params.push(opts.userId);
+            }
+            if (opts?.startTime !== undefined) {
+                conditions.push("em.created_at >= ?");
+                params.push(opts.startTime);
+            }
+            if (opts?.endTime !== undefined) {
+                conditions.push("em.created_at <= ?");
+                params.push(opts.endTime);
+            }
+            const limit = opts?.limit ?? 20;
+            params.push(limit);
+            const sql = `
+        SELECT em.id, em.content_en, em.content_original, em.memory_type,
+               em.created_at, em.preserve_original, em.emotion_score,
+               em.recall_count, em.relevance_score, em.source_message_ids,
+               em.trust, em.integrity, em.credibility, em.classification, em.tier, rank
+        FROM extracted_memories em
+        JOIN extracted_memories_fts ON extracted_memories_fts.rowid = em.id
+        WHERE ${conditions.join(" AND ")}
+        ORDER BY rank * (1.0 + 0.1 * COALESCE(em.recall_count, 0))
+                      * CASE WHEN COALESCE(em.relevance_score, 0) > 0 THEN 1.2 ELSE 1.0 END
+                      / (0.5 + 0.5 * COALESCE(em.trust, 0) / 3.0)
+                      * CASE WHEN COALESCE(em.credibility, 6) <= 2 THEN 0.8 ELSE 1.0 END
+               ASC
+        LIMIT ?
+      `;
+            const rows = this.db.prepare(sql).all(...params);
+            return rows.map((row) => mapExtractedRow(row, scoreExtractedRow(row, Math.abs(row.rank))));
+        }
+        catch (err) {
+            logWarn("memory-index", `searchExtracted failed: ${err instanceof Error ? err.message : String(err)}`);
+            return [];
+        }
+    }
+    /** Bump recall_count and last_recalled_at for the given extracted memory IDs. */
+    bumpRecallCount(ids) {
+        if (ids.length === 0)
+            return;
+        try {
+            const now = Date.now();
+            const stmt = this.db.prepare("UPDATE extracted_memories SET recall_count = recall_count + 1, last_recalled_at = ? WHERE id = ?");
+            for (const id of ids)
+                stmt.run(now, id);
+        }
+        catch (err) {
+            logWarn("memory-index", `bumpRecallCount failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Index an extracted memory in the FTS5 indexes.
+     * Indexes content_en into extracted_memories_fts (porter).
+     * Trigram indexes are maintained by SQLite triggers.
+     */
+    indexExtractedMemory(memory) {
+        try {
+            this.db
+                .prepare("INSERT INTO extracted_memories_fts(rowid, content_en) VALUES (?, ?)")
+                .run(memory.id, memory.content_en);
+        }
+        catch (err) {
+            logWarn("memory-index", `indexExtractedMemory failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+//# sourceMappingURL=memory-index.js.map

package/dist/src/memory-index.js.map

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

package/dist/src/memory-ipc-client.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Memory IPC client — MemoryBackend that talks to the IPC server over Unix socket.
+ * Used by CLI tools when the socket is available (~0ms startup vs ~200ms for SQLite).
+ */
+import type { InstantStoreParams, InstantStoreResult, EditMemoryParams, EditMemoryResult, ForgetResult } from "./mem-types.js";
+import type { RecallParams, RecallResult } from "./recall-engine.js";
+import type { MergeResult, MemoryBackend } from "./memory-backend.js";
+export declare class IpcBackend implements MemoryBackend {
+    private readonly socketPath;
+    initialize(): Promise<void>;
+    close(): void;
+    instantStore(params: InstantStoreParams): Promise<InstantStoreResult>;
+    editMemory(params: EditMemoryParams): Promise<EditMemoryResult>;
+    reclassifyMemory(id: number, level: number, userOverride: boolean): Promise<void>;
+    adjustRelevance(id: number, delta: number): Promise<void>;
+    mergeMemories(idA: number, idB: number): Promise<MergeResult>;
+    cascadeDelete(ids: number[], userId: string): Promise<ForgetResult>;
+    recall(params: RecallParams): Promise<RecallResult>;
+}
+/** Check if the IPC socket is available. */
+export declare function isIpcAvailable(): Promise<boolean>;
+//# sourceMappingURL=memory-ipc-client.d.ts.map

package/dist/src/memory-ipc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-ipc-client.d.ts","sourceRoot":"","sources":["../../src/memory-ipc-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/H,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAgCtE,qBAAa,UAAW,YAAW,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAExC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,KAAK,IAAI,IAAI;IAEP,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIrE,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI/D,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI7D,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAInE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;CAG1D;AAED,4CAA4C;AAC5C,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAOvD"}

package/dist/src/memory-ipc-client.js

@@ -0,0 +1,75 @@
+/**
+ * Memory IPC client — MemoryBackend that talks to the IPC server over Unix socket.
+ * Used by CLI tools when the socket is available (~0ms startup vs ~200ms for SQLite).
+ */
+import * as net from "node:net";
+import { getSocketPath } from "./memory-ipc-server.js";
+let nextId = 1;
+function call(socketPath, method, params) {
+    return new Promise((resolve, reject) => {
+        const conn = net.createConnection(socketPath);
+        const id = nextId++;
+        let buffer = "";
+        conn.on("connect", () => {
+            conn.write(JSON.stringify({ id, method, params }) + "\n");
+        });
+        conn.on("data", (chunk) => {
+            buffer += chunk.toString();
+            const nl = buffer.indexOf("\n");
+            if (nl === -1)
+                return;
+            conn.end();
+            try {
+                const res = JSON.parse(buffer.slice(0, nl));
+                if (res.ok)
+                    resolve(res.result);
+                else
+                    reject(new Error(res.error));
+            }
+            catch (e) {
+                reject(e);
+            }
+        });
+        conn.on("error", reject);
+        conn.setTimeout(10_000, () => { conn.destroy(); reject(new Error("IPC timeout")); });
+    });
+}
+export class IpcBackend {
+    socketPath = getSocketPath();
+    async initialize() {
+        await call(this.socketPath, "ping", {});
+    }
+    close() { }
+    async instantStore(params) {
+        return call(this.socketPath, "store", params);
+    }
+    async editMemory(params) {
+        return call(this.socketPath, "edit", params);
+    }
+    async reclassifyMemory(id, level, userOverride) {
+        await call(this.socketPath, "reclassify", { id, level, userOverride });
+    }
+    async adjustRelevance(id, delta) {
+        await call(this.socketPath, "adjustRelevance", { id, delta });
+    }
+    async mergeMemories(idA, idB) {
+        return call(this.socketPath, "merge", { idA, idB });
+    }
+    async cascadeDelete(ids, userId) {
+        return call(this.socketPath, "delete", { ids, userId });
+    }
+    async recall(params) {
+        return call(this.socketPath, "recall", params);
+    }
+}
+/** Check if the IPC socket is available. */
+export async function isIpcAvailable() {
+    try {
+        await call(getSocketPath(), "ping", {});
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=memory-ipc-client.js.map

package/dist/src/memory-ipc-client.js.map

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

package/dist/src/memory-ipc-server.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Memory IPC server — keeps DB open, serves CLI tools over Unix socket.
+ * Runs inside the bridge process. Protocol: newline-delimited JSON.
+ */
+import type { MemoryBackend } from "./memory-backend.js";
+export declare function getSocketPath(): string;
+export declare class MemoryIpcServer {
+    private readonly backend;
+    private server;
+    private readonly socketPath;
+    constructor(backend: MemoryBackend);
+    start(): Promise<void>;
+    stop(): void;
+    private handleRequest;
+    private dispatch;
+}
+//# sourceMappingURL=memory-ipc-server.d.ts.map

package/dist/src/memory-ipc-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-ipc-server.d.ts","sourceRoot":"","sources":["../../src/memory-ipc-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAKD,qBAAa,eAAe;IAId,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAEP,OAAO,EAAE,aAAa;IAI7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB5B,IAAI,IAAI,IAAI;IAMZ,OAAO,CAAC,aAAa;YAeP,QAAQ;CAcvB"}

package/dist/src/memory-ipc-server.js

@@ -0,0 +1,86 @@
+/**
+ * Memory IPC server — keeps DB open, serves CLI tools over Unix socket.
+ * Runs inside the bridge process. Protocol: newline-delimited JSON.
+ */
+import * as net from "node:net";
+import * as fs from "node:fs";
+import { join } from "node:path";
+import { abmindHome } from "./mem-paths.js";
+import { logInfo } from "./mem-logger.js";
+const TAG = "memory-ipc";
+export function getSocketPath() {
+    return join(abmindHome(), "memory.sock");
+}
+export class MemoryIpcServer {
+    backend;
+    server = null;
+    socketPath;
+    constructor(backend) {
+        this.backend = backend;
+        this.socketPath = getSocketPath();
+    }
+    async start() {
+        try {
+            fs.unlinkSync(this.socketPath);
+        }
+        catch { /* doesn't exist */ }
+        this.server = net.createServer((conn) => {
+            let buffer = "";
+            conn.on("data", (chunk) => {
+                buffer += chunk.toString();
+                let nl;
+                while ((nl = buffer.indexOf("\n")) !== -1) {
+                    const line = buffer.slice(0, nl);
+                    buffer = buffer.slice(nl + 1);
+                    this.handleRequest(line, conn);
+                }
+            });
+            conn.on("error", () => { });
+        });
+        await new Promise((resolve, reject) => {
+            this.server.listen(this.socketPath, () => resolve());
+            this.server.on("error", reject);
+        });
+        logInfo(TAG, `Listening on ${this.socketPath}`);
+    }
+    stop() {
+        this.server?.close();
+        try {
+            fs.unlinkSync(this.socketPath);
+        }
+        catch { /* */ }
+        this.server = null;
+    }
+    handleRequest(line, conn) {
+        let req;
+        try {
+            req = JSON.parse(line);
+        }
+        catch {
+            conn.write(JSON.stringify({ id: 0, ok: false, error: "invalid JSON" }) + "\n");
+            return;
+        }
+        this.dispatch(req).then((result) => conn.write(JSON.stringify({ id: req.id, ok: true, result }) + "\n"), (err) => conn.write(JSON.stringify({ id: req.id, ok: false, error: err instanceof Error ? err.message : String(err) }) + "\n"));
+    }
+    async dispatch(req) {
+        const p = req.params;
+        switch (req.method) {
+            case "store": return this.backend.instantStore(p);
+            case "edit": return this.backend.editMemory(p);
+            case "recall": return this.backend.recall(p);
+            case "delete": return this.backend.cascadeDelete(p["ids"], p["userId"]);
+            case "reclassify": {
+                this.backend.reclassifyMemory(p["id"], p["level"], p["userOverride"]);
+                return { ok: true };
+            }
+            case "adjustRelevance": {
+                this.backend.adjustRelevance(p["id"], p["delta"]);
+                return { ok: true };
+            }
+            case "merge": return this.backend.mergeMemories(p["idA"], p["idB"]);
+            case "ping": return "pong";
+            default: throw new Error(`Unknown method: ${req.method}`);
+        }
+    }
+}
+//# sourceMappingURL=memory-ipc-server.js.map

package/dist/src/memory-ipc-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-ipc-server.js","sourceRoot":"","sources":["../../src/memory-ipc-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG1C,MAAM,GAAG,GAAG,YAAY,CAAC;AAEzB,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,UAAU,EAAE,EAAE,aAAa,CAAC,CAAC;AAC3C,CAAC;AAKD,MAAM,OAAO,eAAe;IAIG;IAHrB,MAAM,GAAsB,IAAI,CAAC;IACxB,UAAU,CAAS;IAEpC,YAA6B,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;QACjD,IAAI,CAAC,UAAU,GAAG,aAAa,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;QAErE,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE;YACtC,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBACxB,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC3B,IAAI,EAAU,CAAC;gBACf,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;oBAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACjC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;oBAC9B,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,CAAC,MAAO,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACtD,IAAI,CAAC,MAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,EAAE,gBAAgB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,IAAI;QACF,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEO,aAAa,CAAC,IAAY,EAAE,IAAgB;QAClD,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CACrB,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAc,CAAC,GAAG,IAAI,CAAC,EAC3F,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAc,CAAC,GAAG,IAAI,CAAC,CAC3I,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,GAAY;QACjC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAiC,CAAC;QAChD,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAQ,CAAC,CAAC;YACzD,KAAK,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAQ,CAAC,CAAC;YACtD,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAQ,CAAC,CAAC;YACpD,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAa,EAAE,CAAC,CAAC,QAAQ,CAAW,CAAC,CAAC;YAC9F,KAAK,YAAY,CAAC,CAAC,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAW,EAAE,CAAC,CAAC,OAAO,CAAW,EAAE,CAAC,CAAC,cAAc,CAAY,CAAC,CAAC;gBAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YAAC,CAAC;YACjJ,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAW,EAAE,CAAC,CAAC,OAAO,CAAW,CAAC,CAAC;gBAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;YAAC,CAAC;YACvH,KAAK,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAW,EAAE,CAAC,CAAC,KAAK,CAAW,CAAC,CAAC;YACxF,KAAK,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC;YAC3B,OAAO,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF"}