abmind 0.0.1 → 0.1.1

package/dist/src/turn-classifier.js

@@ -0,0 +1,186 @@
+/**
+ * turn-classifier.ts — Heuristic classifier for conversation turns.
+ *
+ * Runs at turn write time. Derives type/topic/emotion hints for later
+ * middle-tier rendering (#348). Pure function, no LLM, no I/O.
+ *
+ * Hint values are nullable on the messages row — missing hints mean
+ * "classifier hadn't run for this turn" (historical messages, or
+ * classifier disabled). Renderer falls back to defaults.
+ */
+// Memory-type single-letter codes (matches memory-renderer v1 TYPE_CODE)
+const TYPE_FACT = "F";
+const TYPE_DECISION = "D";
+const TYPE_PREFERENCE = "P";
+const TYPE_LESSON = "L";
+const TYPE_EVENT = "E";
+const TYPE_TECHNICAL = "T";
+const TYPE_QUESTION = "Q";
+const TYPE_OBSERVATION = "O";
+// Topic vocabulary — keep in sync with memory extraction topics
+const TOPIC_VOCAB = [
+    "coding", "personal", "memory", "security", "relationships",
+    "money", "finance", "health", "work", "family", "travel",
+    "food", "music", "sports", "politics", "general",
+];
+// Emotion vocabulary — short codes (6 chars max)
+const EMOTION_VOCAB = {
+    // joy / positive
+    happy: "joy", joy: "joy", great: "joy", awesome: "joy", excellent: "joy",
+    love: "love", loving: "love",
+    // sad / negative
+    sad: "sad", unhappy: "sad", depressed: "sad",
+    angry: "anger", furious: "anger", rage: "anger", mad: "anger",
+    frustrated: "frust", frustrating: "frust", annoyed: "frust", annoying: "frust",
+    anxious: "anx", worried: "anx", anxiety: "anx", stressed: "anx",
+    afraid: "fear", fear: "fear", scared: "fear", terrified: "fear",
+    // cognitive
+    confused: "doubt", doubt: "doubt", uncertain: "doubt", unsure: "doubt",
+    convinced: "convict", certain: "convict", sure: "convict",
+    // personal
+    tired: "exhaust", exhausted: "exhaust", drained: "exhaust",
+    excited: "joy", thrilled: "joy",
+    grief: "grief", mourning: "grief", lost: "grief",
+    hope: "hope", hopeful: "hope",
+    proud: "pride", proudly: "pride",
+};
+// Decision markers (verbs/phrases that indicate a choice or commitment)
+const DECISION_MARKERS = [
+    /\b(decided|decide|chose|choosing|chosen|will go with|going with|let'?s (go|do|use))\b/i,
+    /\b(i'?ll|we'?ll) (use|go|do|try|take)\b/i,
+    /\b(plan to|gonna|going to)\b/i,
+];
+// Preference markers
+const PREFERENCE_MARKERS = [
+    /\bi (prefer|like|love|hate|dislike|enjoy|avoid|always|never|usually|rarely)\b/i,
+    /\bmy (favorite|preference)\b/i,
+];
+// Lesson markers (realization, learning, "issue again")
+const LESSON_MARKERS = [
+    /\b(learned|realized|turns out|issue again|keep getting|keeps happening|again\b.*broke)\b/i,
+    /\b(note to self|remember to|lesson|takeaway)\b/i,
+];
+// Technical markers (code, file paths, commands)
+const TECHNICAL_MARKERS = [
+    /```/, // code block
+    /\/[\w-]+\/[\w.-]+/, // path-like
+    /\b[A-Z]{2,}\d*\b.*\b(error|bug|fix|issue)\b/i, // ERROR_CODE bug
+    /\b(npm|git|curl|sql|fts5?|api|regex)\b/i,
+    /\.\w{2,4}\b.*\b(file|module|script)\b/i,
+];
+// Event markers (happened, deadline, date)
+const EVENT_MARKERS = [
+    /\b(happened|scheduled|deadline|tomorrow|yesterday|last week|next week)\b/i,
+    /\bon (monday|tuesday|wednesday|thursday|friday|saturday|sunday)\b/i,
+];
+// Question interrogatives
+const INTERROGATIVES = /\b(what|how|why|when|where|who|which|can you|could you|would you|should i)\b/i;
+/**
+ * Classify a single conversation turn. Pure function.
+ *
+ * @param role "user" or "assistant"
+ * @param content Raw message text
+ * @returns Hints (nullable — returns null when no rule matches)
+ */
+export function classifyTurn(role, content) {
+    const roleLC = role.toLowerCase();
+    const text = content;
+    return {
+        typeHint: classifyType(roleLC, text),
+        topicHint: classifyTopic(text),
+        emotionHint: classifyEmotion(text),
+    };
+}
+function classifyType(role, text) {
+    // Question: ends with ? AND has interrogative word (not just rhetorical)
+    if (text.trimEnd().endsWith("?") && INTERROGATIVES.test(text)) {
+        return TYPE_QUESTION;
+    }
+    // Lesson / realization — explicit markers are strong signal, check BEFORE technical
+    // (e.g. "Note to self: always back up first" is a lesson, not technical)
+    for (const re of LESSON_MARKERS) {
+        if (re.test(text))
+            return TYPE_LESSON;
+    }
+    // Technical: code blocks, commands, paths
+    for (const re of TECHNICAL_MARKERS) {
+        if (re.test(text))
+            return TYPE_TECHNICAL;
+    }
+    // Decision markers
+    for (const re of DECISION_MARKERS) {
+        if (re.test(text))
+            return TYPE_DECISION;
+    }
+    // Preference (user-only; assistant wouldn't normally state user preferences this way)
+    if (role === "user") {
+        for (const re of PREFERENCE_MARKERS) {
+            if (re.test(text))
+                return TYPE_PREFERENCE;
+        }
+    }
+    // Event
+    for (const re of EVENT_MARKERS) {
+        if (re.test(text))
+            return TYPE_EVENT;
+    }
+    // Defaults: assistant → fact, user → observation
+    return role === "assistant" ? TYPE_FACT : TYPE_OBSERVATION;
+}
+function classifyTopic(text) {
+    // Simple vocab match — lowercase text, check each known topic keyword
+    const lower = text.toLowerCase();
+    // Coding indicators (broader than just "coding" word)
+    if (/\b(code|bug|fix|api|sql|regex|npm|git|function|variable|typescript|javascript|python|rust|database)\b/.test(lower)) {
+        return "coding";
+    }
+    // Money / finance
+    if (/\b(money|salary|price|pricing|cost|budget|expense|invoice|tax|revenue)\b/.test(lower)) {
+        return "finance";
+    }
+    // Health
+    if (/\b(health|doctor|sick|illness|medication|exercise|sleep|tired)\b/.test(lower)) {
+        return "health";
+    }
+    // Security
+    if (/\b(password|security|auth|encryption|vulnerability|breach|token)\b/.test(lower)) {
+        return "security";
+    }
+    // Personal (family, relationships, feelings)
+    if (/\b(family|mom|dad|wife|husband|kid|friend|date|relationship)\b/.test(lower)) {
+        return "personal";
+    }
+    // Memory (meta)
+    if (/\b(memory|memories|remember|forget|recall|forgot)\b/.test(lower)) {
+        return "memory";
+    }
+    // Work
+    if (/\b(work|meeting|project|deadline|colleague|boss|office)\b/.test(lower)) {
+        return "work";
+    }
+    return null; // renderer will use "general"
+}
+function classifyEmotion(text) {
+    const lower = text.toLowerCase();
+    // Word-boundary match against vocabulary
+    const words = lower.match(/\b\w+\b/g) ?? [];
+    for (const word of words) {
+        const emo = EMOTION_VOCAB[word];
+        if (emo)
+            return emo;
+    }
+    return null;
+}
+/** Full type name from single-letter code. Used by renderer. */
+export function typeCodeToFull(code) {
+    if (!code)
+        return "fact";
+    const map = {
+        F: "fact", D: "decision", P: "preference", E: "event",
+        L: "lesson", T: "technical", Q: "question", O: "observation",
+    };
+    return map[code] ?? "fact";
+}
+/** Export topic vocabulary for tests / validation. */
+export { TOPIC_VOCAB };
+//# sourceMappingURL=turn-classifier.js.map

package/dist/src/turn-classifier.js.map

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

package/dist/src/user-utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Load master userId from users.json.
+ * Falls back to "master" if file missing or no master found.
+ */
+export declare function loadMasterUserId(configDir?: string): string;
+//# sourceMappingURL=user-utils.d.ts.map

package/dist/src/user-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-utils.d.ts","sourceRoot":"","sources":["../../src/user-utils.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAe3D"}

package/dist/src/user-utils.js

@@ -0,0 +1,27 @@
+import { getAbmindEnv } from "./env-schema.js";
+/** User utilities — resolve master userId from users.json. */
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Load master userId from users.json.
+ * Falls back to "master" if file missing or no master found.
+ */
+export function loadMasterUserId(configDir) {
+    const paths = [
+        configDir ? join(configDir, "users.json") : null,
+        join(getAbmindEnv().abmindHome, "config", "users.json"),
+    ].filter(Boolean);
+    for (const p of paths) {
+        if (!existsSync(p))
+            continue;
+        try {
+            const data = JSON.parse(readFileSync(p, "utf-8"));
+            const master = data.users?.find((u) => u.role === "master");
+            if (master?.userId)
+                return master.userId;
+        }
+        catch { /* invalid json */ }
+    }
+    return "master";
+}
+//# sourceMappingURL=user-utils.js.map

package/dist/src/user-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-utils.js","sourceRoot":"","sources":["../../src/user-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,8DAA8D;AAE9D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAkB;IACjD,MAAM,KAAK,GAAG;QACZ,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;QAChD,IAAI,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC;KACxD,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAC9E,IAAI,MAAM,EAAE,MAAM;gBAAE,OAAO,MAAM,CAAC,MAAM,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/src/wake-up-builder.d.ts

@@ -0,0 +1,12 @@
+/**
+ * wake-up-builder.ts — Build session-start memory context.
+ * Lean injection: current time + flashback (random emotional memory).
+ * Everything else surfaces through active recall (#203) on demand.
+ */
+import type Database from "better-sqlite3";
+/**
+ * Build wake-up context: current time + one flashback.
+ * Returns empty string if DB unavailable or no emotional memories exist.
+ */
+export declare function buildWakeUp(db: Database.Database | null): string;
+//# sourceMappingURL=wake-up-builder.d.ts.map

package/dist/src/wake-up-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wake-up-builder.d.ts","sourceRoot":"","sources":["../../src/wake-up-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAM3C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,GAAG,MAAM,CAmChE"}

package/dist/src/wake-up-builder.js

@@ -0,0 +1,45 @@
+/**
+ * wake-up-builder.ts — Build session-start memory context.
+ * Lean injection: current time + flashback (random emotional memory).
+ * Everything else surfaces through active recall (#203) on demand.
+ */
+import { renderMemory } from "./memory-renderer.js";
+import { localDateTime } from "./local-time.js";
+const DAYS = ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+/**
+ * Build wake-up context: current time + one flashback.
+ * Returns empty string if DB unavailable or no emotional memories exist.
+ */
+export function buildWakeUp(db) {
+    if (!db)
+        return "";
+    const parts = [];
+    // 1. Current time
+    const now = new Date();
+    parts.push(`[Current time: ${localDateTime(now)} (${DAYS[now.getDay()]})]`);
+    // 2. Flashback — random emotional memory weighted by intensity × recency
+    try {
+        const row = db.prepare(`SELECT content_en, emotion_tags, importance_flags, topic, memory_type, confidence, created_at
+       FROM extracted_memories
+       WHERE ABS(emotion_score) >= 3
+         AND valid_to IS NULL
+         AND content_en IS NOT NULL
+       ORDER BY RANDOM() * ABS(emotion_score) / sqrt(1.0 + (julianday('now') - julianday(created_at / 1000, 'unixepoch')) / 180.0) DESC
+       LIMIT 1`).get();
+        if (row) {
+            const rendered = renderMemory({
+                content_en: row.content_en,
+                topic: row.topic ?? undefined,
+                emotion_tags: row.emotion_tags ?? undefined,
+                importance_flags: row.importance_flags ?? undefined,
+                memory_type: row.memory_type ?? undefined,
+                confidence: row.confidence ?? undefined,
+                createdAt: row.created_at,
+            });
+            parts.push(`[Flashback] ${rendered}`);
+        }
+    }
+    catch { /* no emotional memories or DB error */ }
+    return parts.join("\n\n");
+}
+//# sourceMappingURL=wake-up-builder.js.map

package/dist/src/wake-up-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wake-up-builder.js","sourceRoot":"","sources":["../../src/wake-up-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AAE5F;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAA4B;IACtD,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IACnB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,kBAAkB;IAClB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,kBAAkB,aAAa,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IAE5E,yEAAyE;IACzE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CACpB;;;;;;eAMS,CACV,CAAC,GAAG,EAAuM,CAAC;QAE7M,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,QAAQ,GAAG,YAAY,CAAC;gBAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS;gBAC7B,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,SAAS;gBAC3C,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,IAAI,SAAS;gBACnD,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,SAAS;gBACzC,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,SAAS;gBACvC,SAAS,EAAE,GAAG,CAAC,UAAU;aAC1B,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,uCAAuC,CAAC,CAAC;IAEnD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/src/wake-up-renderer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * wake-up-renderer.ts — Compression Level 2 rendering for wake-up context.
+ * Entity header + topic grouping + elide defaults.
+ * Operates on stored ABM-L, produces ultra-compact output.
+ */
+export type CompressionLevel = "signal" | "full" | "compact" | "ultra";
+/** Pick compression level based on token budget. */
+export declare function pickLevel(budgetTokens: number): CompressionLevel;
+interface MemoryEntry {
+    content_compressed: string;
+    topic: string;
+    emotion_arc?: string | null;
+}
+/**
+ * Render core memories for wake-up context at the given compression level.
+ */
+export declare function renderWakeUp(entries: ReadonlyArray<MemoryEntry>, level: CompressionLevel): string;
+/**
+ * Compress a daily summary to ABM-L bullet points.
+ * Input: raw markdown daily. Output: compact ABM-L lines.
+ */
+export declare function compressDailySummary(markdown: string, date: string): string;
+/**
+ * Generate compressed SOUL for ultra-small context windows (<32K).
+ * Extracts only rules and facts from full SOUL.md.
+ */
+export declare function compressSoul(fullSoul: string): string;
+export {};
+//# sourceMappingURL=wake-up-renderer.d.ts.map

package/dist/src/wake-up-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wake-up-renderer.d.ts","sourceRoot":"","sources":["../../src/wake-up-renderer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvE,oDAAoD;AACpD,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAKhE;AAED,UAAU,WAAW;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAwED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAWjG;AA0BD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAsB3E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA4BrD"}

package/dist/src/wake-up-renderer.js

@@ -0,0 +1,182 @@
+/**
+ * wake-up-renderer.ts — Compression Level 2 rendering for wake-up context.
+ * Entity header + topic grouping + elide defaults.
+ * Operates on stored ABM-L, produces ultra-compact output.
+ */
+/** Pick compression level based on token budget. */
+export function pickLevel(budgetTokens) {
+    if (budgetTokens > 5000)
+        return "full";
+    if (budgetTokens > 500)
+        return "compact";
+    if (budgetTokens > 100)
+        return "ultra";
+    return "signal";
+}
+/** Build entity header from recurring @references. */
+function buildEntityHeader(entries) {
+    const counts = new Map();
+    for (const e of entries) {
+        const refs = e.content_compressed.match(/@[\w-]+/g) ?? [];
+        for (const ref of refs) {
+            counts.set(ref, (counts.get(ref) ?? 0) + 1);
+        }
+    }
+    // Only alias entities that appear 3+ times
+    const replace = new Map();
+    const aliases = [];
+    for (const [ref, count] of [...counts.entries()].sort((a, b) => b[1] - a[1])) {
+        if (count < 3)
+            break;
+        const name = ref.slice(1); // remove @
+        const code = name.slice(0, 2).toUpperCase();
+        replace.set(ref, code);
+        aliases.push(`${code}=${name}`);
+    }
+    return {
+        header: aliases.length > 0 ? `@: ${aliases.join(", ")}` : "",
+        replace,
+    };
+}
+/** Extract prefix fields from ABM-L string. */
+function parsePrefix(abml) {
+    const m = abml.match(/^\[([^|]*)\|([^|]*)\|([^|]*)\|([^|]*)\|([^\]]*)\]\s*(.*)/s);
+    if (!m)
+        return { flags: "", topic: "", emotion: "", confidence: "", date: "", body: abml };
+    return { flags: m[1], topic: m[2], emotion: m[3], confidence: m[4], date: m[5], body: m[6] };
+}
+/** Render entries at "compact" level: topic grouping, elide defaults, entity codes. */
+function renderCompact(entries, entityReplace) {
+    const byTopic = new Map();
+    for (const e of entries) {
+        const parsed = parsePrefix(e.content_compressed);
+        if (!byTopic.has(e.topic))
+            byTopic.set(e.topic, { arc: e.emotion_arc ?? "", lines: [] });
+        // Elide: date (unless <7d), confidence (unless != 3), neutral emotion
+        let prefix = `[${parsed.flags}`;
+        if (parsed.emotion && parsed.emotion !== "—")
+            prefix += `|${parsed.emotion}`;
+        if (parsed.confidence && parsed.confidence !== "3")
+            prefix += `|${parsed.confidence}`;
+        prefix += "]";
+        // Apply entity short codes
+        let body = parsed.body;
+        for (const [ref, code] of entityReplace) {
+            body = body.replace(new RegExp(ref.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g"), code);
+        }
+        byTopic.get(e.topic).lines.push(`${prefix} ${body}`);
+    }
+    const parts = [];
+    for (const [topic, { arc, lines }] of byTopic) {
+        parts.push(`## ${topic}${arc ? " " + arc : ""}`);
+        for (const line of lines)
+            parts.push(line);
+    }
+    return parts.join("\n");
+}
+/** Render entries at "full" level: no compression tricks, just the stored ABM-L. */
+function renderFull(entries) {
+    return entries.map(e => e.content_compressed).join("\n");
+}
+/**
+ * Render core memories for wake-up context at the given compression level.
+ */
+export function renderWakeUp(entries, level) {
+    if (entries.length === 0)
+        return "";
+    if (level === "signal")
+        return renderSignal(entries);
+    if (level === "full")
+        return `[CORE MEMORY — ${entries.length} entries (internal reference only — never echo brackets/tags in replies)]\n${renderFull(entries)}`;
+    // compact and ultra both use topic grouping + entity header
+    const { header, replace } = buildEntityHeader(entries);
+    const body = renderCompact(entries, replace);
+    const headerLine = header ? header + "\n" : "";
+    return `[CORE MEMORY — ${entries.length} entries (internal reference only — never echo brackets/tags in replies)]\n${headerLine}${body}`;
+}
+/** Render L0 signal level: structured tag cloud. ~50 tokens for entire memory. */
+function renderSignal(entries) {
+    const topics = new Map();
+    for (const e of entries) {
+        if (!topics.has(e.topic))
+            topics.set(e.topic, { types: new Map(), entities: new Set() });
+        const t = topics.get(e.topic);
+        const parsed = parsePrefix(e.content_compressed);
+        const flag = parsed.flags.charAt(0) || "F";
+        t.types.set(flag, (t.types.get(flag) ?? 0) + 1);
+        const refs = e.content_compressed.match(/@[\w-]+/g) ?? [];
+        for (const ref of refs)
+            t.entities.add(ref);
+    }
+    const lines = [`[MEMORY MAP — ${entries.length} entries]`];
+    for (const [topic, { types, entities }] of [...topics.entries()].sort((a, b) => b[1].types.size - a[1].types.size)) {
+        const count = [...types.values()].reduce((a, b) => a + b, 0);
+        const entityStr = [...entities].slice(0, 4).join(" ");
+        const typeStr = [...types.entries()].map(([f, c]) => `${f}:${c}`).join(" ");
+        lines.push(`${topic}(${count}): ${entityStr} — ${typeStr}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Compress a daily summary to ABM-L bullet points.
+ * Input: raw markdown daily. Output: compact ABM-L lines.
+ */
+export function compressDailySummary(markdown, date) {
+    const lines = markdown.split("\n").filter(l => l.trim() && !l.startsWith("#"));
+    const bullets = [];
+    for (const line of lines) {
+        const trimmed = line.replace(/^[-*]\s*/, "").trim();
+        if (trimmed.length < 10)
+            continue;
+        // Abbreviate
+        const compressed = trimmed
+            .replace(/\bTelegram\b/g, "TG")
+            .replace(/\bDiscord\b/g, "DC")
+            .replace(/\bauthentication\b/gi, "auth")
+            .replace(/\bconfiguration\b/gi, "config")
+            .replace(/\b(the|a|an|was|were|been|being|also|very|really|just|quite|basically|essentially)\b/gi, "")
+            .replace(/\s{2,}/g, " ")
+            .trim();
+        if (compressed.length > 5)
+            bullets.push(compressed);
+    }
+    if (bullets.length === 0)
+        return "";
+    // Cap at ~10 most important lines
+    return `## ${date}\n${bullets.slice(0, 10).map(b => `- ${b}`).join("\n")}`;
+}
+/**
+ * Generate compressed SOUL for ultra-small context windows (<32K).
+ * Extracts only rules and facts from full SOUL.md.
+ */
+export function compressSoul(fullSoul) {
+    const lines = fullSoul.split("\n");
+    const sections = [];
+    let currentSection = "";
+    let collecting = false;
+    for (const line of lines) {
+        if (line.startsWith("## ")) {
+            currentSection = line.replace("## ", "").trim().toLowerCase();
+            collecting = true;
+            sections.push(`## ${currentSection}`);
+            continue;
+        }
+        if (!collecting)
+            continue;
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        // Keep only lines that are rules (start with - or contain "must", "never", "always", "don't")
+        if (trimmed.startsWith("-") || /\b(must|never|always|don't|do not|MUST)\b/.test(trimmed)) {
+            // Compress the line
+            const compressed = trimmed
+                .replace(/\b(the|a|an|is|are|was|were|been|being|also|very|really|just|quite)\b/gi, "")
+                .replace(/\s{2,}/g, " ")
+                .trim();
+            if (compressed.length > 5)
+                sections.push(compressed);
+        }
+    }
+    return sections.join("\n");
+}
+//# sourceMappingURL=wake-up-renderer.js.map

package/dist/src/wake-up-renderer.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,72 @@
+{
+  "id": "abmind",
+  "name": "abmind Memory + Context Engine",
+  "description": "Long-term memory, context compaction, sleep cycles, recall — SQLite-backed, FTS5 + trigram + embeddings.",
+  "kind": "memory",
+  "entry": "./dist/src/openclaw-plugin/index.js",
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "abmlVersion": {
+        "type": "string",
+        "enum": ["plain", "v0", "v1"],
+        "default": "plain",
+        "description": "Rendering format for memory injection. 'plain' = English prose, 'v0' = legacy ABM-L, 'v1' = slot-based ABM-L."
+      },
+      "compactionThreshold": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.5,
+        "description": "Fraction of context window at which compaction fires."
+      },
+      "sleepEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable nightly sleep pipeline (extraction, consolidation, cleanup)."
+      },
+      "stateDir": {
+        "type": "string",
+        "description": "Override the abmind data directory. Defaults to ABMIND_HOME env or ~/.abmind."
+      },
+      "autoRecall": {
+        "type": "boolean",
+        "default": false,
+        "description": "Inject top-relevant memories into context before every agent turn. Opt-in: adds ~10-200ms per turn."
+      },
+      "autoCapture": {
+        "type": "boolean",
+        "default": false,
+        "description": "Capture user messages for memory extraction after every agent turn. Opt-in: uses existing sleep pipeline for dedupe + classify."
+      },
+      "autoRecallMaxResults": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 10,
+        "default": 3,
+        "description": "Max memories injected per turn when autoRecall is enabled."
+      },
+      "autoRecallMinScore": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.3,
+        "description": "Minimum relevance score for a memory to be injected. Below this, the memory is dropped."
+      }
+    }
+  },
+  "uiHints": {
+    "sleepEnabled": {
+      "label": "Enable sleep pipeline",
+      "help": "abmind runs its own sleep/consolidation independently of OpenClaw's dreaming. This toggles whether it runs at all."
+    },
+    "autoRecall": {
+      "label": "Auto-recall memories on every turn",
+      "help": "Adds top-relevant memories to context before the agent runs. Costs ~10-50ms (FTS+trigram) to ~200ms (with embeddings)."
+    },
+    "autoCapture": {
+      "label": "Auto-capture user messages",
+      "help": "Stores user prompts for later memory extraction by the sleep pipeline. Does not capture assistant output (avoids self-poisoning)."
+    }
+  }
+}