abmind 0.0.1 → 0.1.0

package/dist/src/memory-backend.js

@@ -0,0 +1,43 @@
+/**
+ * MemoryBackend — transport-agnostic memory API for CLI tools + tool-registry.
+ *
+ * ┌────────────────────────────────────────────────────────────────────────────┐
+ * │ When to use                                                                │
+ * ├────────────────────────────────────────────────────────────────────────────┤
+ * │ Consumers that may run in-process OR talk to a separate abmind process     │
+ * │ over an IPC socket. The interface hides the transport — the caller just    │
+ * │ awaits a Promise and doesn't care whether storage is local SQLite or       │
+ * │ remote-over-socket.                                                        │
+ * │                                                                            │
+ * │ Use when:                                                                  │
+ * │   - CLI tools (abmind store/edit/merge/recall — they use createMemoryBackend)  │
+ * │   - Direct-API tool-registry (agentbridge's memory_store / memory_recall / │
+ * │     memory_edit tools register a MemoryBackend once at boot)               │
+ * │   - MCP server adapter                                                     │
+ * │   - Ecosystem plugins (openclaw, future hosts) that don't own the process  │
+ * └────────────────────────────────────────────────────────────────────────────┘
+ *
+ * Implementations:
+ *   SqliteBackend   in-process (sqlite-backend.ts) — wraps MemoryManager
+ *   IpcBackend      over Unix socket (memory-ipc-client.ts) — talks to a
+ *                   long-running abmind process via memory-ipc-server.ts
+ *
+ * Factory: `createMemoryBackend(config)` in backend-factory.ts picks the
+ * right one (tries IPC socket first, falls back to SQLite).
+ *
+ * Relationship to IMemoryCore/IMemorySystem (see imemory-system.ts):
+ *   IMemoryCore/IMemorySystem  = in-process, direct object reference,
+ *                                includes read + context-building methods
+ *   MemoryBackend              = transport-agnostic, async-only, focused on
+ *                                the write + recall paths callers need from
+ *                                outside the host's process
+ *
+ * Rule of thumb:
+ *   - Running inside the host process? → IMemoryCore (read) or IMemorySystem (full)
+ *   - Shelled-out CLI / tool call / IPC boundary? → MemoryBackend
+ *
+ * All methods are async — even local SQLite calls return Promises — so swap
+ * of transport is source-compatible.
+ */
+export {};
+//# sourceMappingURL=memory-backend.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-backend.js","sourceRoot":"","sources":["../../src/memory-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG"}

package/dist/src/memory-compressor.d.ts

@@ -0,0 +1,17 @@
+export declare function setKnownEntities(entities: Map<string, string>): void;
+export interface CompressInput {
+    content_en: string;
+    topic: string;
+    emotion_tags: string;
+    importance_flags: string;
+    memory_type?: string;
+    confidence?: number;
+    date?: string;
+}
+/**
+ * Compress a memory into ABM-L format.
+ * Primary flag from memory_type. Secondary flags from detection (additive).
+ * No truncation — wake-up builder handles length.
+ */
+export declare function compress(input: CompressInput): string;
+//# sourceMappingURL=memory-compressor.d.ts.map

package/dist/src/memory-compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-compressor.d.ts","sourceRoot":"","sources":["../../src/memory-compressor.ts"],"names":[],"mappings":"AAuDA,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEpE;AAyED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAwCrD"}

package/dist/src/memory-compressor.js

@@ -0,0 +1,147 @@
+import { localMonth } from "./local-time.js";
+/** Memory type → primary flag character. */
+const TYPE_FLAG = {
+    fact: "F", decision: "D", preference: "P", event: "E",
+    lesson: "L", feedback: "K", story: "S",
+};
+/** Detected importance flag → secondary flag character. */
+const DETECTED_FLAG = {
+    decision: "D", origin: "O", core_belief: "B", pivot: "V",
+    technical: "T", correction: "C", preference: "P", milestone: "M",
+};
+/**
+ * Filler words to strip. Excludes:
+ * - Negations (don't, not, never, no, won't, can't, haven't, shouldn't, isn't, aren't, wasn't, weren't)
+ * - Pronouns (I, my, me, you, your, we, our, they, their)
+ */
+const FILLER = /\b(basically|essentially|actually|really|very|just|quite|rather|simply|that|this|these|those|its|also|so|then|well|some|about|there)\b/gi;
+const MULTI_SPACE = /\s{2,}/g;
+/** Platform/term abbreviations. */
+const ABBREVIATIONS = [
+    [/\bTelegram\b/g, "TG"],
+    [/\bDiscord\b/g, "DC"],
+    [/\bOpenRouter\b/g, "OR"],
+    [/\bauthentication\b/gi, "auth"],
+    [/\bconfiguration\b/gi, "config"],
+    [/\bdevelopment\b/gi, "dev"],
+    [/\bdeveloper experience\b/gi, "DX"],
+    [/\bGoogle Drive\b/g, "GDrive"],
+];
+/** Topic inference from content keywords. */
+const TOPIC_HINTS = [
+    [/\b(code|deploy|api|database|server|framework|stack|pipeline|git|npm|typescript|sqlite|fts5|bug|error|crash|architecture|refactor)\b/i, "coding"],
+    [/\b(prefer|language|timezone|CET|bilingual|dark.?mode|vim|style|personality|sarcastic|humor)\b/i, "personal"],
+    [/\b(cron|schedule|task|backup|report|daily|weekly|heartbeat|deploy\.sh)\b/i, "work"],
+    [/\b(price|pricing|cost|budget|subscription|billing|invoice|money)\b/i, "finance"],
+    [/\b(health|sleep|exercise|stress|burnout|tired)\b/i, "health"],
+    [/\b(project|ship|launch|release|milestone|roadmap)\b/i, "projects"],
+];
+/** Known entity whitelist — only these get @referenced. */
+/** Set known entities from core-tier memories. Called before compression. */
+let knownEntities = new Map();
+export function setKnownEntities(entities) {
+    knownEntities = entities;
+}
+function applyEntities(text) {
+    let result = text;
+    // Apply known entities (longest first)
+    const sorted = [...knownEntities.entries()].sort((a, b) => b[0].length - a[0].length);
+    for (const [name, ref] of sorted) {
+        result = result.replace(new RegExp(`\\b${name}\\b`, "gi"), ref);
+    }
+    return result;
+}
+function applyAbbreviations(text) {
+    let result = text;
+    for (const [pattern, replacement] of ABBREVIATIONS) {
+        result = result.replace(pattern, replacement);
+    }
+    return result;
+}
+function applyRelationships(text) {
+    return text
+        .replace(/\binstead of\b/gi, ">over")
+        .replace(/\breplaces?\b/gi, ">replaces")
+        .replace(/\bcauses?\b/gi, ">causes")
+        .replace(/\bblocks?\b/gi, ">blocks")
+        .replace(/\bleads? to\b/gi, "→")
+        .replace(/\bbecomes?\b/gi, "→")
+        .replace(/\bbecause\b/gi, "∵");
+}
+function stripFiller(text) {
+    return text.replace(FILLER, "").replace(MULTI_SPACE, " ").trim();
+}
+function preserveTechnical(text) {
+    const preserved = new Map();
+    let idx = 0;
+    const cleaned = text.replace(/(?:\/[\w./-]+|~\/[\w./-]+|https?:\/\/\S+|`[^`]+`|\b\d+\.\d+\.\d+\b|-\d{4,})/g, (match) => {
+        const key = `__TECH${idx++}__`;
+        preserved.set(key, match);
+        return key;
+    });
+    return { preserved, cleaned };
+}
+function restoreTechnical(text, preserved) {
+    let result = text;
+    for (const [key, value] of preserved) {
+        result = result.replace(key, value);
+    }
+    return result;
+}
+/** Infer topic from content when topic is 'general'. */
+function inferTopic(content, currentTopic) {
+    if (currentTopic !== "general")
+        return currentTopic;
+    for (const [pattern, topic] of TOPIC_HINTS) {
+        if (pattern.test(content))
+            return topic;
+    }
+    return "general";
+}
+/** Convert numbered/bulleted lists to pipe-separated. */
+function pipeifyLists(text) {
+    // "1) foo. 2) bar. 3) baz" → "foo | bar | baz"
+    return text
+        .replace(/\d+\)\s*/g, "")
+        .replace(/\s*\.\s*(?=\S)/g, " | ")
+        .replace(/\s*;\s*/g, " | ")
+        .replace(/\s*,\s*(?=\d{1,2}[:.])/g, " | "); // comma before times: "10:00, 10:15" → "10:00 | 10:15"
+}
+/**
+ * Compress a memory into ABM-L format.
+ * Primary flag from memory_type. Secondary flags from detection (additive).
+ * No truncation — wake-up builder handles length.
+ */
+export function compress(input) {
+    const { content_en, emotion_tags, importance_flags, confidence, date } = input;
+    // Infer topic
+    const topic = inferTopic(content_en, input.topic);
+    // Build prefix: primary flag from memory_type, secondary from detection
+    const primaryFlag = TYPE_FLAG[input.memory_type ?? "fact"] ?? "F";
+    const secondaryFlags = importance_flags
+        .split(",").filter(Boolean)
+        .map(f => DETECTED_FLAG[f.trim()] ?? "")
+        .filter(f => f && f !== primaryFlag) // don't duplicate primary
+        .join("");
+    const flags = primaryFlag + secondaryFlags;
+    const emotionShort = emotion_tags.split(",")[0]?.trim().slice(0, 6) || "—";
+    const conf = confidence ?? 3;
+    const dateStr = date ?? localMonth();
+    const prefix = `[${flags}|${topic}|${emotionShort}|${conf}|${dateStr}]`;
+    // Compress content
+    const { preserved, cleaned } = preserveTechnical(content_en);
+    let body = cleaned;
+    body = applyEntities(body);
+    body = applyAbbreviations(body);
+    body = applyRelationships(body);
+    body = pipeifyLists(body);
+    body = stripFiller(body);
+    body = restoreTechnical(body, preserved);
+    // Collapse parenthetical reasons
+    body = body.replace(/\s*∵\s*(.{3,60}?)(?:\.|$)/g, " ($1)");
+    // Clean up
+    body = body.replace(MULTI_SPACE, " ").replace(/\s+([.,;:!?])/g, "$1").trim();
+    // No truncation — stored ABM-L captures everything
+    return `${prefix} ${body}`;
+}
+//# sourceMappingURL=memory-compressor.js.map

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

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

package/dist/src/memory-config.d.ts

@@ -0,0 +1,30 @@
+/** Configuration for the local memory layer. */
+export type MemoryConfig = {
+    memoryEnabled: boolean;
+    memoryDir: string;
+    maxMessagesPerChat: number;
+    diskBudgetBytes: number;
+    stalenessThresholdMs: number;
+    restoreMessageCount: number;
+    /** Maximum token size per ingestion chunk. */
+    ingestChunkMaxTokens: number;
+    /** Embedding model name for hot-swap detection. */
+    embeddingModel: string;
+    /** Relevance threshold for topic-based forgetting. */
+    forgetThreshold: number;
+    /** Search enhancement configuration for temporal decay, MMR, and timeouts. */
+    searchEnhancements: {
+        searchTimeoutMs: number;
+        decayHalflifeDays: number;
+        mmrLambda: number;
+        compactThresholdPct: number;
+    };
+};
+/** Default values for all memory configuration fields. */
+export declare const MEMORY_CONFIG_DEFAULTS: MemoryConfig;
+/**
+ * Load memory configuration from `process.env` with sensible defaults.
+ * Invalid values produce a warning and fall back to defaults (never throws).
+ */
+export declare function loadMemoryConfig(): MemoryConfig;
+//# sourceMappingURL=memory-config.d.ts.map

package/dist/src/memory-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-config.d.ts","sourceRoot":"","sources":["../../src/memory-config.ts"],"names":[],"mappings":"AAMA,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,8CAA8C;IAC9C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,kBAAkB,EAAE;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,SAAS,EAAE,MAAM,CAAC;QAClB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,EAAE,YAgBpC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAkD/C"}

package/dist/src/memory-config.js

@@ -0,0 +1,62 @@
+import { getAbmindEnv } from "./env-schema.js";
+import { join } from "node:path";
+import { parseBoolEnv, parseNumberEnv } from "./mem-env.js";
+import { abmindHome } from "./mem-paths.js";
+import { loadMemoryEnv } from "./mem-config-env.js";
+/** Default values for all memory configuration fields. */
+export const MEMORY_CONFIG_DEFAULTS = {
+    memoryEnabled: true,
+    memoryDir: join(abmindHome(), "memory"),
+    maxMessagesPerChat: 1000,
+    diskBudgetBytes: 500 * 1024 * 1024,
+    stalenessThresholdMs: 24 * 3600_000,
+    restoreMessageCount: 50,
+    ingestChunkMaxTokens: 512,
+    embeddingModel: "nomic-embed-text",
+    forgetThreshold: 0.8,
+    searchEnhancements: {
+        searchTimeoutMs: 1000,
+        decayHalflifeDays: 30,
+        mmrLambda: 0.7,
+        compactThresholdPct: 85,
+    },
+};
+/**
+ * Load memory configuration from `process.env` with sensible defaults.
+ * Invalid values produce a warning and fall back to defaults (never throws).
+ */
+export function loadMemoryConfig() {
+    // Source ~/.abmind/config/.env.memory into process.env before reading.
+    // Host env wins via ?? semantics. Eliminates the bug class where callers
+    // (CLI/MCP/plugin) would forget to invoke the loader. See #210.
+    loadMemoryEnv();
+    const memoryEnabled = parseBoolEnv("MEMORY_ENABLED", MEMORY_CONFIG_DEFAULTS.memoryEnabled);
+    const memoryDir = getAbmindEnv().memoryDir;
+    const maxMessagesPerChat = parseNumberEnv("MEMORY_MAX_MESSAGES_PER_CHAT", MEMORY_CONFIG_DEFAULTS.maxMessagesPerChat);
+    const diskBudgetMb = parseNumberEnv("MEMORY_DISK_BUDGET_MB", 500);
+    const diskBudgetBytes = diskBudgetMb * 1024 * 1024;
+    const stalenessHours = parseNumberEnv("MEMORY_STALENESS_HOURS", 24);
+    const stalenessThresholdMs = stalenessHours * 3_600_000;
+    const restoreMessageCount = parseNumberEnv("MEMORY_RESTORE_MESSAGES", MEMORY_CONFIG_DEFAULTS.restoreMessageCount);
+    const ingestChunkMaxTokens = parseNumberEnv("MEMORY_INGEST_CHUNK_MAX_TOKENS", MEMORY_CONFIG_DEFAULTS.ingestChunkMaxTokens);
+    const embeddingModel = getAbmindEnv().embeddingModel;
+    const forgetThreshold = parseNumberEnv("MEMORY_FORGET_THRESHOLD", MEMORY_CONFIG_DEFAULTS.forgetThreshold);
+    return {
+        memoryEnabled,
+        memoryDir,
+        maxMessagesPerChat,
+        diskBudgetBytes,
+        stalenessThresholdMs,
+        restoreMessageCount,
+        ingestChunkMaxTokens,
+        embeddingModel,
+        forgetThreshold,
+        searchEnhancements: {
+            searchTimeoutMs: parseNumberEnv("MEMORY_SEARCH_TIMEOUT_MS", MEMORY_CONFIG_DEFAULTS.searchEnhancements.searchTimeoutMs),
+            decayHalflifeDays: parseNumberEnv("MEMORY_DECAY_HALFLIFE_DAYS", MEMORY_CONFIG_DEFAULTS.searchEnhancements.decayHalflifeDays),
+            mmrLambda: parseNumberEnv("MEMORY_MMR_LAMBDA", MEMORY_CONFIG_DEFAULTS.searchEnhancements.mmrLambda),
+            compactThresholdPct: parseNumberEnv("MEMORY_COMPACT_THRESHOLD_PCT", MEMORY_CONFIG_DEFAULTS.searchEnhancements.compactThresholdPct),
+        },
+    };
+}
+//# sourceMappingURL=memory-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-config.js","sourceRoot":"","sources":["../../src/memory-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAyBpD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,sBAAsB,GAAiB;IAClD,aAAa,EAAE,IAAI;IACnB,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC;IACvC,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IAClC,oBAAoB,EAAE,EAAE,GAAG,QAAQ;IACnC,mBAAmB,EAAE,EAAE;IACvB,oBAAoB,EAAE,GAAG;IACzB,cAAc,EAAE,kBAAkB;IAClC,eAAe,EAAE,GAAG;IACpB,kBAAkB,EAAE;QAClB,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,EAAE;QACrB,SAAS,EAAE,GAAG;QACd,mBAAmB,EAAE,EAAE;KACxB;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,uEAAuE;IACvE,yEAAyE;IACzE,gEAAgE;IAChE,aAAa,EAAE,CAAC;IAEhB,MAAM,aAAa,GAAG,YAAY,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC,SAAS,CAAC;IAE3C,MAAM,kBAAkB,GAAG,cAAc,CACvC,8BAA8B,EAC9B,sBAAsB,CAAC,kBAAkB,CAC1C,CAAC;IACF,MAAM,YAAY,GAAG,cAAc,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,eAAe,GAAG,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;IAEnD,MAAM,cAAc,GAAG,cAAc,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IACpE,MAAM,oBAAoB,GAAG,cAAc,GAAG,SAAS,CAAC;IAExD,MAAM,mBAAmB,GAAG,cAAc,CACxC,yBAAyB,EACzB,sBAAsB,CAAC,mBAAmB,CAC3C,CAAC;IAEF,MAAM,oBAAoB,GAAG,cAAc,CACzC,gCAAgC,EAChC,sBAAsB,CAAC,oBAAoB,CAC5C,CAAC;IAEF,MAAM,cAAc,GAAG,YAAY,EAAE,CAAC,cAAc,CAAC;IAErD,MAAM,eAAe,GAAG,cAAc,CAAC,yBAAyB,EAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;IAE1G,OAAO;QACL,aAAa;QACb,SAAS;QACT,kBAAkB;QAClB,eAAe;QACf,oBAAoB;QACpB,mBAAmB;QACnB,oBAAoB;QACpB,cAAc;QACd,eAAe;QACf,kBAAkB,EAAE;YAClB,eAAe,EAAE,cAAc,CAAC,0BAA0B,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,eAAe,CAAC;YACtH,iBAAiB,EAAE,cAAc,CAAC,4BAA4B,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,iBAAiB,CAAC;YAC5H,SAAS,EAAE,cAAc,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,SAAS,CAAC;YACnG,mBAAmB,EAAE,cAAc,CAAC,8BAA8B,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,mBAAmB,CAAC;SACnI;KACF,CAAC;AACJ,CAAC"}

package/dist/src/memory-db.d.ts

@@ -0,0 +1,7 @@
+import Database from "better-sqlite3";
+/**
+ * Opens (or creates) the SQLite database at the given path, registers
+ * custom functions, and ensures the schema exists.
+ */
+export declare function initializeDatabase(dbPath: string): Database.Database;
+//# sourceMappingURL=memory-db.d.ts.map

package/dist/src/memory-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-db.d.ts","sourceRoot":"","sources":["../../src/memory-db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAkKtC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAYpE"}

package/dist/src/memory-db.js

@@ -0,0 +1,173 @@
+import Database from "better-sqlite3";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { logInfo } from "./mem-logger.js";
+const TAG = "memory-db";
+// ── Custom scalar functions (registered before schema init, used at runtime) ──
+function registerFunctions(db) {
+    db.function("strip_emojis", (text) => {
+        if (typeof text !== "string")
+            return text;
+        return text.replace(/[\p{Emoji_Presentation}\p{Extended_Pictographic}]/gu, "").replace(/ {2,}/g, " ").trim();
+    });
+    db.function("strip_diacritics", (text) => {
+        if (typeof text !== "string")
+            return text;
+        return text.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
+    });
+}
+// ── Schema ──────────────────────────────────────────────────────────────────
+function ensureSchema(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS messages (
+      id INTEGER PRIMARY KEY AUTOINCREMENT, user_id TEXT NOT NULL, session_id TEXT NOT NULL,
+      role TEXT NOT NULL, content TEXT NOT NULL, timestamp INTEGER NOT NULL,
+      platform_message_id INTEGER, emotion_score INTEGER DEFAULT 0,
+      type_hint TEXT, topic_hint TEXT, emotion_hint TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_messages_chat_ts ON messages(user_id, timestamp);
+    CREATE INDEX IF NOT EXISTS idx_messages_platform_id ON messages(user_id, platform_message_id);
+
+    CREATE TABLE IF NOT EXISTS ingested_documents (
+      id INTEGER PRIMARY KEY AUTOINCREMENT, user_id TEXT NOT NULL, source_type TEXT NOT NULL,
+      identifier TEXT NOT NULL, chunk_count INTEGER NOT NULL, ingested_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_ingested_docs_chat ON ingested_documents(user_id);
+
+    CREATE TABLE IF NOT EXISTS extracted_memories (
+      id INTEGER PRIMARY KEY AUTOINCREMENT, user_id TEXT NOT NULL,
+      content_original TEXT NOT NULL, content_en TEXT NOT NULL,
+      memory_type TEXT NOT NULL DEFAULT 'fact', source_timestamp INTEGER NOT NULL,
+      preserve_original INTEGER NOT NULL DEFAULT 0, preserved_keyword TEXT, created_at INTEGER NOT NULL,
+      emotion_score INTEGER DEFAULT 0, recall_count INTEGER DEFAULT 0, last_recalled_at INTEGER,
+      relevance_score INTEGER DEFAULT 0, confidence INTEGER DEFAULT 3, source_message_ids TEXT,
+      classification INTEGER DEFAULT 1, trust INTEGER DEFAULT 0, integrity INTEGER DEFAULT 2,
+      credibility INTEGER DEFAULT 6, embedding BLOB, edited_at INTEGER, edited_by TEXT,
+      emotion_tags TEXT, importance_flags TEXT, emotion_arc TEXT, signature BLOB,
+      source_type TEXT DEFAULT 'conversation', topic TEXT DEFAULT 'general', tier TEXT DEFAULT 'general',
+      valid_from TEXT, valid_to TEXT, emotion_context TEXT,
+      encrypted INTEGER DEFAULT 0
+    );
+    CREATE INDEX IF NOT EXISTS idx_extracted_memories_chat_ts ON extracted_memories(user_id, source_timestamp DESC);
+    CREATE INDEX IF NOT EXISTS idx_extracted_memories_preserve ON extracted_memories(preserve_original) WHERE preserve_original = 1;
+    CREATE INDEX IF NOT EXISTS idx_extracted_memories_chat_created ON extracted_memories(user_id, created_at DESC);
+    CREATE INDEX IF NOT EXISTS idx_em_topic ON extracted_memories(topic);
+    CREATE INDEX IF NOT EXISTS idx_em_tier ON extracted_memories(tier);
+    CREATE INDEX IF NOT EXISTS idx_em_valid ON extracted_memories(valid_to);
+
+    CREATE VIRTUAL TABLE IF NOT EXISTS extracted_memories_fts USING fts5(
+      content_en, content=extracted_memories, content_rowid=id, tokenize='porter unicode61'
+    );
+    CREATE TRIGGER IF NOT EXISTS extracted_memories_ai AFTER INSERT ON extracted_memories BEGIN
+      INSERT INTO extracted_memories_fts(rowid, content_en) VALUES (new.id, new.content_en);
+    END;
+    CREATE TRIGGER IF NOT EXISTS extracted_memories_ad AFTER DELETE ON extracted_memories BEGIN
+      INSERT INTO extracted_memories_fts(extracted_memories_fts, rowid, content_en) VALUES('delete', old.id, old.content_en);
+    END;
+    CREATE TRIGGER IF NOT EXISTS extracted_memories_au AFTER UPDATE OF content_en ON extracted_memories BEGIN
+      INSERT INTO extracted_memories_fts(extracted_memories_fts, rowid, content_en) VALUES('delete', old.id, old.content_en);
+      INSERT INTO extracted_memories_fts(rowid, content_en) VALUES (new.id, new.content_en);
+    END;
+
+    CREATE TABLE IF NOT EXISTS extraction_watermarks (user_id TEXT PRIMARY KEY, last_processed_timestamp INTEGER NOT NULL);
+
+    CREATE VIRTUAL TABLE IF NOT EXISTS content_en_trigram USING fts5(content, tokenize='trigram');
+    CREATE TRIGGER IF NOT EXISTS content_en_trigram_ai AFTER INSERT ON extracted_memories BEGIN
+      INSERT INTO content_en_trigram(rowid, content) VALUES (new.id, strip_diacritics(COALESCE(new.content_en, '') || ' ' || COALESCE(new.preserved_keyword, '')));
+    END;
+    CREATE TRIGGER IF NOT EXISTS content_en_trigram_ad AFTER DELETE ON extracted_memories BEGIN
+      DELETE FROM content_en_trigram WHERE rowid = old.id;
+    END;
+    CREATE TRIGGER IF NOT EXISTS content_en_trigram_au AFTER UPDATE OF content_en, preserved_keyword ON extracted_memories BEGIN
+      DELETE FROM content_en_trigram WHERE rowid = old.id;
+      INSERT INTO content_en_trigram(rowid, content) VALUES (new.id, strip_diacritics(COALESCE(new.content_en, '') || ' ' || COALESCE(new.preserved_keyword, '')));
+    END;
+
+    CREATE VIRTUAL TABLE IF NOT EXISTS content_original_trigram USING fts5(content, tokenize='trigram');
+    CREATE TRIGGER IF NOT EXISTS content_original_trigram_ai AFTER INSERT ON extracted_memories BEGIN
+      INSERT INTO content_original_trigram(rowid, content) VALUES (new.id, strip_diacritics(COALESCE(new.content_original, '')));
+    END;
+    CREATE TRIGGER IF NOT EXISTS content_original_trigram_ad AFTER DELETE ON extracted_memories BEGIN
+      DELETE FROM content_original_trigram WHERE rowid = old.id;
+    END;
+    CREATE TRIGGER IF NOT EXISTS content_original_trigram_au AFTER UPDATE OF content_original ON extracted_memories BEGIN
+      DELETE FROM content_original_trigram WHERE rowid = old.id;
+      INSERT INTO content_original_trigram(rowid, content) VALUES (new.id, strip_diacritics(COALESCE(new.content_original, '')));
+    END;
+
+    CREATE TABLE IF NOT EXISTS entity_graph (
+      id INTEGER PRIMARY KEY,
+      entity_a TEXT NOT NULL,
+      entity_b TEXT NOT NULL,
+      relation TEXT NOT NULL,
+      source_memory_id INTEGER,
+      created_at INTEGER NOT NULL,
+      last_seen_at INTEGER NOT NULL,
+      UNIQUE(entity_a, entity_b, relation)
+    );
+    CREATE INDEX IF NOT EXISTS idx_eg_a ON entity_graph(entity_a);
+    CREATE INDEX IF NOT EXISTS idx_eg_b ON entity_graph(entity_b);
+
+    CREATE TABLE IF NOT EXISTS context_watermarks (
+      chat_id TEXT PRIMARY KEY,
+      watermark_message_id INTEGER NOT NULL,
+      compaction_count INTEGER DEFAULT 0,
+      last_compacted_at INTEGER,
+      last_failed_at INTEGER,
+      pending_compaction INTEGER DEFAULT 0,
+      model TEXT,
+      token_estimate INTEGER
+    );
+
+    CREATE TABLE IF NOT EXISTS context_summaries (
+      id INTEGER PRIMARY KEY,
+      chat_id TEXT NOT NULL,
+      depth INTEGER NOT NULL DEFAULT 0,
+      content TEXT NOT NULL,
+      token_estimate INTEGER NOT NULL,
+      source_message_start INTEGER NOT NULL,
+      source_message_end INTEGER NOT NULL,
+      classification INTEGER NOT NULL DEFAULT 1,
+      archived INTEGER NOT NULL DEFAULT 0,
+      model TEXT,
+      created_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_ctx_summaries_chat ON context_summaries(chat_id, archived, created_at);
+  `);
+    // Migrations for existing DBs — ALTER TABLE ADD COLUMN is idempotent via try/catch.
+    // Adds #348 turn-classifier hint columns (nullable, backwards-compatible).
+    for (const col of ["type_hint", "topic_hint", "emotion_hint"]) {
+        try {
+            db.exec(`ALTER TABLE messages ADD COLUMN ${col} TEXT`);
+        }
+        catch (err) {
+            // Column already exists (from CREATE TABLE path on fresh DB, or prior migration run)
+            if (!(err instanceof Error && err.message.includes("duplicate column")))
+                throw err;
+        }
+    }
+    // #244 — recall_timestamps for spacing effect
+    try {
+        db.exec(`ALTER TABLE extracted_memories ADD COLUMN recall_timestamps TEXT DEFAULT '[]'`);
+    }
+    catch (err) {
+        if (!(err instanceof Error && err.message.includes("duplicate column")))
+            throw err;
+    }
+}
+// ── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Opens (or creates) the SQLite database at the given path, registers
+ * custom functions, and ensures the schema exists.
+ */
+export function initializeDatabase(dbPath) {
+    mkdirSync(dirname(dbPath), { recursive: true });
+    const db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    registerFunctions(db);
+    ensureSchema(db);
+    logInfo(TAG, `Database initialized at ${dbPath}`);
+    return db;
+}
+//# sourceMappingURL=memory-db.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-db.js","sourceRoot":"","sources":["../../src/memory-db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,MAAM,GAAG,GAAG,WAAW,CAAC;AAExB,iFAAiF;AAEjF,SAAS,iBAAiB,CAAC,EAAqB;IAC9C,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAa,EAAE,EAAE;QAC5C,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,qDAAqD,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,IAAa,EAAE,EAAE;QAChD,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAE/E,SAAS,YAAY,CAAC,EAAqB;IACzC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmHP,CAAC,CAAC;IAEH,oFAAoF;IACpF,2EAA2E;IAC3E,KAAK,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,mCAAmC,GAAG,OAAO,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,qFAAqF;YACrF,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;gBAAE,MAAM,GAAG,CAAC;QACrF,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,+EAA+E,CAAC,CAAC;IAC3F,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;YAAE,MAAM,GAAG,CAAC;IACrF,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,CAAC;IAEjB,OAAO,CAAC,GAAG,EAAE,2BAA2B,MAAM,EAAE,CAAC,CAAC;IAClD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/src/memory-editor.d.ts

@@ -0,0 +1,32 @@
+import type Database from "better-sqlite3";
+import type { InstantStoreParams, InstantStoreResult, EditMemoryParams, EditMemoryResult, ForgetResult } from "./mem-types.js";
+/** Handles all mutations on extracted memories: edit, store, merge, delete. */
+export declare class MemoryEditor {
+    private readonly db;
+    constructor(db: Database.Database);
+    /** Edit an existing extracted memory. Unified mutation path for all field updates. */
+    editMemory(params: EditMemoryParams): EditMemoryResult;
+    /** Immediately persist a memory from the agent's instant_store tool. */
+    instantStore(params: InstantStoreParams): Promise<InstantStoreResult>;
+    /** Adjust relevance_score on an existing extracted memory. */
+    adjustRelevance(id: number, delta: number): void;
+    /** Reclassify a memory's confidentiality level. */
+    reclassifyMemory(id: number, level: number, userOverride?: boolean): {
+        ok: boolean;
+        error?: string;
+    };
+    /** Merge two extracted memories: keep newer, combine Darwinism scores, delete older. */
+    mergeMemories(idA: number, idB: number): {
+        merged: boolean;
+        keptId: number;
+        deletedId: number;
+    } | {
+        merged: false;
+        error: string;
+    };
+    /** Cascade deletion through all storage layers for the given message IDs. */
+    cascadeDelete(messageIds: number[], userId: string): ForgetResult;
+    /** Embed a newly inserted memory (fire-and-forget). */
+    private embedNewMemory;
+}
+//# sourceMappingURL=memory-editor.d.ts.map

package/dist/src/memory-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-editor.d.ts","sourceRoot":"","sources":["../../src/memory-editor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAe/H,+EAA+E;AAC/E,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAElD,sFAAsF;IACtF,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB;IAiItD,wEAAwE;IAClE,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+F3E,8DAA8D;IAC9D,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIhD,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAIlG,wFAAwF;IACxF,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAuBlI,6EAA6E;IAC7E,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY;IAajE,uDAAuD;IACvD,OAAO,CAAC,cAAc;CAUvB"}