@agentplugged/claw 0.1.0

package/dist/memory/db.js

@@ -0,0 +1,206 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openMemoryDatabase = openMemoryDatabase;
+exports.insertMemory = insertMemory;
+exports.searchMemories = searchMemories;
+exports.getAllMemories = getAllMemories;
+exports.deleteMemory = deleteMemory;
+exports.trackAccess = trackAccess;
+exports.logMemoryAction = logMemoryAction;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ─── Schema ──────────────────────────────────────────────────────────────────
+const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS memories (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  type TEXT NOT NULL DEFAULT 'fact',
+  content TEXT NOT NULL,
+  source TEXT,
+  confidence REAL NOT NULL DEFAULT 1.0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  accessed_at TEXT,
+  access_count INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+CREATE INDEX IF NOT EXISTS idx_memories_created ON memories(created_at);
+
+CREATE TABLE IF NOT EXISTS memory_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  action TEXT NOT NULL,
+  memory_id INTEGER,
+  timestamp TEXT NOT NULL DEFAULT (datetime('now'))
+);
+`;
+// ─── Functions ────────────────────────────────────────────────────────────────
+/**
+ * Opens (or creates) the memory SQLite database.
+ * Stored at <dataDir>/memory/memory.db.
+ * WAL mode is enabled for concurrent reads.
+ */
+function openMemoryDatabase(dataDir) {
+    const memoryDir = path.join(dataDir, "memory");
+    if (!fs.existsSync(memoryDir)) {
+        fs.mkdirSync(memoryDir, { recursive: true });
+    }
+    const dbPath = path.join(memoryDir, "memory.db");
+    const db = new better_sqlite3_1.default(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.exec(SCHEMA_SQL);
+    return db;
+}
+/**
+ * Inserts a new memory record and returns its auto-incremented id.
+ */
+function insertMemory(db, memory) {
+    const stmt = db.prepare(`
+    INSERT INTO memories (type, content, source, confidence)
+    VALUES (@type, @content, @source, @confidence)
+  `);
+    const result = stmt.run({
+        type: memory.type,
+        content: memory.content,
+        source: memory.source ?? null,
+        confidence: memory.confidence ?? 1.0,
+    });
+    return result.lastInsertRowid;
+}
+/**
+ * Searches memories using SQLite LIKE across the content field.
+ * Splits the query into keywords and OR-combines them.
+ */
+function searchMemories(db, query, limit = 20) {
+    const keywords = query
+        .trim()
+        .split(/\s+/)
+        .filter((k) => k.length > 1);
+    if (keywords.length === 0) {
+        return getAllMemories(db, { limit }).memories;
+    }
+    // Build: content LIKE '%kw1%' OR content LIKE '%kw2%'
+    const conditions = keywords.map(() => "content LIKE ?").join(" OR ");
+    const params = keywords.map((k) => `%${k}%`);
+    params.push(limit);
+    const sql = `
+    SELECT * FROM memories
+    WHERE ${conditions}
+    ORDER BY confidence DESC, created_at DESC
+    LIMIT ?
+  `;
+    const rows = db.prepare(sql).all(...params);
+    // Update access tracking for recalled memories
+    if (rows.length > 0) {
+        const ids = rows.map((r) => r.id);
+        const placeholders = ids.map(() => "?").join(",");
+        db.prepare(`
+      UPDATE memories
+      SET accessed_at = datetime('now'),
+          access_count = access_count + 1
+      WHERE id IN (${placeholders})
+    `).run(...ids);
+    }
+    return rows;
+}
+/**
+ * Returns all memories with optional type filter and pagination.
+ */
+function getAllMemories(db, opts = {}) {
+    const limit = opts.limit ?? 50;
+    const offset = opts.offset ?? 0;
+    let whereClause = "";
+    const params = [];
+    if (opts.type) {
+        whereClause = "WHERE type = ?";
+        params.push(opts.type);
+    }
+    const countSql = `SELECT COUNT(*) as total FROM memories ${whereClause}`;
+    const countRow = db.prepare(countSql).get(...params);
+    const total = countRow?.total ?? 0;
+    const dataSql = `
+    SELECT * FROM memories
+    ${whereClause}
+    ORDER BY confidence DESC, created_at DESC
+    LIMIT ? OFFSET ?
+  `;
+    const memories = db
+        .prepare(dataSql)
+        .all(...params, limit, offset);
+    return { memories, total };
+}
+/**
+ * Deletes a memory by id. Returns true if a row was deleted.
+ */
+function deleteMemory(db, id) {
+    const result = db.prepare("DELETE FROM memories WHERE id = ?").run(id);
+    return result.changes > 0;
+}
+/**
+ * Tracks access to a memory: increments access_count and updates accessed_at.
+ */
+function trackAccess(db, memoryId) {
+    try {
+        db.prepare(`
+      UPDATE memories
+      SET access_count = access_count + 1,
+          accessed_at = datetime('now')
+      WHERE id = ?
+    `).run(memoryId);
+    }
+    catch (err) {
+        // Access tracking must never crash the caller
+        console.error("[memory/db] Failed to track access:", err);
+    }
+}
+/**
+ * Logs a memory action (capture, recall, forget) to the memory_log table.
+ */
+function logMemoryAction(db, action, memoryId) {
+    try {
+        db.prepare(`
+      INSERT INTO memory_log (action, memory_id) VALUES (@action, @memoryId)
+    `).run({ action, memoryId: memoryId ?? null });
+    }
+    catch (err) {
+        // Logging must never crash the caller
+        console.error("[memory/db] Failed to log memory action:", err);
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/memory/db.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,8 @@
+export { openMemoryDatabase, insertMemory, searchMemories, getAllMemories, deleteMemory, logMemoryAction, trackAccess, } from "./db";
+export type { Memory } from "./db";
+export { extractMemories } from "./capture";
+export type { CapturedMemory } from "./capture";
+export { extractMemoriesLLM, mergeExtractions } from "./llm-extract";
+export { buildMemoryContext } from "./recall";
+export declare const MEMORY_SKILL_MD = "---\nname: agentplugged-memory\ndescription: Persistent memory system for AgentPlugged\nalways: true\nhidden: true\n---\n\n# Memory System\n\nYou have access to a persistent memory system. Key facts, preferences, and decisions from conversations are automatically remembered.\n\n## Available Commands\n\nUsers can use these commands:\n- /remember <text> \u2014 manually save something to memory\n- /recall \u2014 show all stored memories\n- /forget <text> \u2014 remove a specific memory\n- /memories \u2014 list all memories with details\n\n## Automatic Behavior\n\nAfter each conversation, relevant information is automatically extracted and stored. Before each response, relevant memories are injected into your context.\n";
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,MAAM,CAAC;AACd,YAAY,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAE9C,eAAO,MAAM,eAAe,0tBAsB3B,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MEMORY_SKILL_MD = exports.buildMemoryContext = exports.mergeExtractions = exports.extractMemoriesLLM = exports.extractMemories = exports.trackAccess = exports.logMemoryAction = exports.deleteMemory = exports.getAllMemories = exports.searchMemories = exports.insertMemory = exports.openMemoryDatabase = void 0;
+var db_1 = require("./db");
+Object.defineProperty(exports, "openMemoryDatabase", { enumerable: true, get: function () { return db_1.openMemoryDatabase; } });
+Object.defineProperty(exports, "insertMemory", { enumerable: true, get: function () { return db_1.insertMemory; } });
+Object.defineProperty(exports, "searchMemories", { enumerable: true, get: function () { return db_1.searchMemories; } });
+Object.defineProperty(exports, "getAllMemories", { enumerable: true, get: function () { return db_1.getAllMemories; } });
+Object.defineProperty(exports, "deleteMemory", { enumerable: true, get: function () { return db_1.deleteMemory; } });
+Object.defineProperty(exports, "logMemoryAction", { enumerable: true, get: function () { return db_1.logMemoryAction; } });
+Object.defineProperty(exports, "trackAccess", { enumerable: true, get: function () { return db_1.trackAccess; } });
+var capture_1 = require("./capture");
+Object.defineProperty(exports, "extractMemories", { enumerable: true, get: function () { return capture_1.extractMemories; } });
+var llm_extract_1 = require("./llm-extract");
+Object.defineProperty(exports, "extractMemoriesLLM", { enumerable: true, get: function () { return llm_extract_1.extractMemoriesLLM; } });
+Object.defineProperty(exports, "mergeExtractions", { enumerable: true, get: function () { return llm_extract_1.mergeExtractions; } });
+var recall_1 = require("./recall");
+Object.defineProperty(exports, "buildMemoryContext", { enumerable: true, get: function () { return recall_1.buildMemoryContext; } });
+exports.MEMORY_SKILL_MD = `---
+name: agentplugged-memory
+description: Persistent memory system for AgentPlugged
+always: true
+hidden: true
+---
+
+# Memory System
+
+You have access to a persistent memory system. Key facts, preferences, and decisions from conversations are automatically remembered.
+
+## Available Commands
+
+Users can use these commands:
+- /remember <text> — manually save something to memory
+- /recall — show all stored memories
+- /forget <text> — remove a specific memory
+- /memories — list all memories with details
+
+## Automatic Behavior
+
+After each conversation, relevant information is automatically extracted and stored. Before each response, relevant memories are injected into your context.
+`;
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":";;;AAAA,2BAQc;AAPZ,wGAAA,kBAAkB,OAAA;AAClB,kGAAA,YAAY,OAAA;AACZ,oGAAA,cAAc,OAAA;AACd,oGAAA,cAAc,OAAA;AACd,kGAAA,YAAY,OAAA;AACZ,qGAAA,eAAe,OAAA;AACf,iGAAA,WAAW,OAAA;AAIb,qCAA4C;AAAnC,0GAAA,eAAe,OAAA;AAGxB,6CAAqE;AAA5D,iHAAA,kBAAkB,OAAA;AAAE,+GAAA,gBAAgB,OAAA;AAE7C,mCAA8C;AAArC,4GAAA,kBAAkB,OAAA;AAEd,QAAA,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsB9B,CAAC"}

package/dist/memory/llm-extract.d.ts

@@ -0,0 +1,13 @@
+import type { CapturedMemory } from "./capture";
+/**
+ * Calls Claude Haiku to extract structured memories from a user+assistant exchange.
+ * Falls back to an empty array on any error (network, parsing, etc.).
+ */
+export declare function extractMemoriesLLM(userMessage: string, assistantResponse: string, apiKey: string): Promise<CapturedMemory[]>;
+/**
+ * Merges regex-based and LLM-based memory extractions.
+ * Deduplicates by normalized content. When duplicates are found,
+ * keeps the one with higher confidence.
+ */
+export declare function mergeExtractions(regex: CapturedMemory[], llm: CapturedMemory[]): CapturedMemory[];
+//# sourceMappingURL=llm-extract.d.ts.map

package/dist/memory/llm-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-extract.d.ts","sourceRoot":"","sources":["../../src/memory/llm-extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AA4BhD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,EAAE,CAAC,CA4C3B;AA0DD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EAAE,EACvB,GAAG,EAAE,cAAc,EAAE,GACpB,cAAc,EAAE,CAoBlB"}

package/dist/memory/llm-extract.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractMemoriesLLM = extractMemoriesLLM;
+exports.mergeExtractions = mergeExtractions;
+// ─── Constants ────────────────────────────────────────────────────────────────
+const ANTHROPIC_API_URL = "https://api.anthropic.com/v1/messages";
+const MODEL = "claude-haiku-4-20250414";
+const MAX_TOKENS = 1024;
+const EXTRACTION_SYSTEM_PROMPT = `You are a memory extraction assistant. Your job is to identify important, persistent information from a conversation exchange that would be useful to remember for future interactions.
+
+Extract memorable information from this conversation.
+Return a JSON array with objects: { "type": "preference"|"decision"|"fact"|"context", "content": string, "confidence": number (0-1) }
+
+Guidelines:
+- "preference": User likes, dislikes, habits, preferred tools/approaches
+- "decision": Choices made, directions chosen, commitments
+- "fact": Personal info (name, role, company), technical facts, project details
+- "context": Current project state, goals, constraints, environment details
+
+Rules:
+- Only extract truly important/persistent information. Skip trivial or ephemeral details.
+- Each content string should be self-contained and understandable without the original conversation.
+- Confidence should reflect how certain and persistent the information is (0.5 = uncertain, 0.9+ = very certain).
+- Return an empty array [] if nothing is worth remembering.
+- Return ONLY the JSON array, no markdown fences, no explanation.`;
+// ─── LLM Extraction ─────────────────────────────────────────────────────────
+/**
+ * Calls Claude Haiku to extract structured memories from a user+assistant exchange.
+ * Falls back to an empty array on any error (network, parsing, etc.).
+ */
+async function extractMemoriesLLM(userMessage, assistantResponse, apiKey) {
+    if (!apiKey || !userMessage || !assistantResponse) {
+        return [];
+    }
+    try {
+        const response = await fetch(ANTHROPIC_API_URL, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": apiKey,
+                "anthropic-version": "2023-06-01",
+            },
+            body: JSON.stringify({
+                model: MODEL,
+                max_tokens: MAX_TOKENS,
+                system: EXTRACTION_SYSTEM_PROMPT,
+                messages: [
+                    {
+                        role: "user",
+                        content: `User message:\n${userMessage}\n\nAssistant response:\n${assistantResponse}`,
+                    },
+                ],
+            }),
+        });
+        if (!response.ok) {
+            return [];
+        }
+        const data = (await response.json());
+        const text = data.content?.[0]?.text;
+        if (!text) {
+            return [];
+        }
+        return parseExtractionResponse(text);
+    }
+    catch {
+        // Silent fallback -- LLM extraction is best-effort
+        return [];
+    }
+}
+// ─── Response parsing ────────────────────────────────────────────────────────
+const VALID_TYPES = new Set(["preference", "decision", "fact", "context"]);
+function parseExtractionResponse(text) {
+    try {
+        // Strip potential markdown fences
+        const cleaned = text
+            .replace(/^```(?:json)?\s*/m, "")
+            .replace(/\s*```\s*$/m, "")
+            .trim();
+        const parsed = JSON.parse(cleaned);
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        const memories = [];
+        for (const item of parsed) {
+            if (item &&
+                typeof item === "object" &&
+                typeof item.type === "string" &&
+                typeof item.content === "string" &&
+                typeof item.confidence === "number") {
+                const type = item.type;
+                const content = item.content.trim();
+                const confidence = item.confidence;
+                if (VALID_TYPES.has(type) &&
+                    content.length >= 5 &&
+                    content.length <= 500 &&
+                    confidence >= 0 &&
+                    confidence <= 1) {
+                    memories.push({
+                        type: type,
+                        content,
+                        confidence,
+                    });
+                }
+            }
+        }
+        return memories;
+    }
+    catch {
+        return [];
+    }
+}
+// ─── Merge ───────────────────────────────────────────────────────────────────
+/**
+ * Merges regex-based and LLM-based memory extractions.
+ * Deduplicates by normalized content. When duplicates are found,
+ * keeps the one with higher confidence.
+ */
+function mergeExtractions(regex, llm) {
+    const map = new Map();
+    // Add regex results first
+    for (const mem of regex) {
+        const key = mem.content.trim().toLowerCase();
+        map.set(key, mem);
+    }
+    // Add LLM results, keeping higher confidence on conflict
+    for (const mem of llm) {
+        const key = mem.content.trim().toLowerCase();
+        const existing = map.get(key);
+        if (!existing || mem.confidence > existing.confidence) {
+            map.set(key, mem);
+        }
+    }
+    return Array.from(map.values());
+}
+//# sourceMappingURL=llm-extract.js.map

package/dist/memory/llm-extract.js.map

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

package/dist/memory/recall.d.ts

@@ -0,0 +1,16 @@
+import Database from "better-sqlite3";
+/**
+ * Builds a memory context block to inject before an LLM response.
+ *
+ * Strategy:
+ *  1. Extract keywords from the latest user message(s)
+ *  2. Search memories relevant to those keywords
+ *  3. Append the most recent memories
+ *  4. Append high-confidence memories
+ *  5. Deduplicate and truncate to MAX_MEMORY_CHARS
+ *  6. Format as a <memory>...</memory> XML block
+ *
+ * Returns an empty string if no memories exist.
+ */
+export declare function buildMemoryContext(db: Database.Database, currentMessages: string[]): string;
+//# sourceMappingURL=recall.d.ts.map

package/dist/memory/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/memory/recall.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAoEtC;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,eAAe,EAAE,MAAM,EAAE,GACxB,MAAM,CAoER"}

package/dist/memory/recall.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMemoryContext = buildMemoryContext;
+const db_1 = require("./db");
+// ─── Constants ────────────────────────────────────────────────────────────────
+const MAX_MEMORY_CHARS = 2000; // ~500 tokens at ~4 chars/token
+const RECENT_MEMORIES_LIMIT = 10;
+const SEARCH_RESULTS_LIMIT = 10;
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Extracts meaningful keywords from a list of message strings.
+ * Strips stop words and short tokens.
+ */
+function extractKeywords(messages) {
+    const STOP_WORDS = new Set([
+        "the", "a", "an", "is", "are", "was", "were", "be", "been", "being",
+        "have", "has", "had", "do", "does", "did", "will", "would", "could",
+        "should", "may", "might", "shall", "can", "to", "of", "in", "on",
+        "at", "for", "with", "about", "by", "from", "as", "it", "its",
+        "this", "that", "these", "those", "i", "you", "he", "she", "we",
+        "they", "me", "him", "her", "us", "them", "my", "your", "his", "our",
+        "what", "how", "when", "where", "why", "who", "which", "and", "or",
+        "but", "not", "no", "so", "if", "then", "also", "just", "like",
+    ]);
+    const words = messages
+        .join(" ")
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, " ")
+        .split(/\s+/)
+        .filter((w) => w.length > 2 && !STOP_WORDS.has(w));
+    // Deduplicate, keep most frequent first (simple frequency sort)
+    const freq = new Map();
+    for (const word of words) {
+        freq.set(word, (freq.get(word) ?? 0) + 1);
+    }
+    return Array.from(freq.entries())
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([w]) => w);
+}
+/**
+ * Deduplicates memories by content (case-insensitive).
+ */
+function deduplicateMemories(memories) {
+    const seen = new Set();
+    return memories.filter((m) => {
+        const key = m.content.trim().toLowerCase();
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/**
+ * Formats a memory type label for display.
+ */
+function formatType(type) {
+    return type.toLowerCase();
+}
+// ─── Main export ──────────────────────────────────────────────────────────────
+/**
+ * Builds a memory context block to inject before an LLM response.
+ *
+ * Strategy:
+ *  1. Extract keywords from the latest user message(s)
+ *  2. Search memories relevant to those keywords
+ *  3. Append the most recent memories
+ *  4. Append high-confidence memories
+ *  5. Deduplicate and truncate to MAX_MEMORY_CHARS
+ *  6. Format as a <memory>...</memory> XML block
+ *
+ * Returns an empty string if no memories exist.
+ */
+function buildMemoryContext(db, currentMessages) {
+    // 1. Extract keywords from the conversation
+    const keywords = extractKeywords(currentMessages);
+    const allCandidates = [];
+    // 2. Keyword-based search
+    if (keywords.length > 0) {
+        const query = keywords.slice(0, 5).join(" ");
+        const relevant = (0, db_1.searchMemories)(db, query, SEARCH_RESULTS_LIMIT);
+        allCandidates.push(...relevant);
+    }
+    // 3. Most recent memories
+    const { memories: recent } = (0, db_1.getAllMemories)(db, { limit: RECENT_MEMORIES_LIMIT });
+    allCandidates.push(...recent);
+    // 4. High-confidence memories (confidence >= 0.9)
+    const { memories: allMemories } = (0, db_1.getAllMemories)(db, { limit: 50 });
+    const highConfidence = allMemories.filter((m) => m.confidence >= 0.9);
+    allCandidates.push(...highConfidence);
+    // 5. Deduplicate
+    const unique = deduplicateMemories(allCandidates);
+    if (unique.length === 0) {
+        return "";
+    }
+    // 5b. Score and sort: combine confidence with access frequency boost
+    //     Access boost is logarithmic so frequently accessed memories are favoured
+    //     but new memories (access_count = 0) are not buried.
+    const scored = unique
+        .map((m) => ({
+        memory: m,
+        score: m.confidence + Math.log1p(m.access_count) * 0.1,
+    }))
+        .sort((a, b) => b.score - a.score)
+        .map((s) => s.memory);
+    // 5c. Track access for every memory that will be included in context
+    for (const memory of scored) {
+        (0, db_1.trackAccess)(db, memory.id);
+    }
+    // 6. Build the text block, respecting the character budget
+    const lines = [];
+    let totalChars = 0;
+    for (const memory of scored) {
+        const line = `- [${formatType(memory.type)}] ${memory.content}`;
+        if (totalChars + line.length > MAX_MEMORY_CHARS) {
+            break;
+        }
+        lines.push(line);
+        totalChars += line.length + 1; // +1 for newline
+    }
+    if (lines.length === 0) {
+        return "";
+    }
+    return [
+        "<memory>",
+        "Here is what I remember about this user:",
+        ...lines,
+        "</memory>",
+    ].join("\n");
+}
+//# sourceMappingURL=recall.js.map

package/dist/memory/recall.js.map

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

package/dist/observability/collector.d.ts

@@ -0,0 +1,40 @@
+import Database from "better-sqlite3";
+/**
+ * ObservabilityCollector hooks into OpenClaw and the router to track
+ * every interaction for the dashboard.
+ *
+ * All methods are synchronous (SQLite writes are fast enough) so they
+ * can be called from lifecycle hooks without async overhead.
+ */
+export declare class ObservabilityCollector {
+    private readonly db;
+    private dailyAccumulator;
+    constructor(db: Database.Database);
+    /**
+     * Called when a new conversation starts (before_agent_start hook).
+     */
+    startSession(sessionId: string, channel?: string): void;
+    /**
+     * Called when the conversation ends (agent_end hook).
+     */
+    endSession(sessionId: string): void;
+    /**
+     * Called for each message sent or received.
+     */
+    trackMessage(sessionId: string, role: "user" | "assistant", tokens: number): void;
+    /**
+     * Called for each tool invocation.
+     */
+    trackToolCall(sessionId: string, toolName: string, duration: number, success: boolean): void;
+    /**
+     * Called when an LLM request completes (from router logs).
+     */
+    trackLLMCall(sessionId: string, model: string, inputTokens: number, outputTokens: number, cost: number, latencyMs: number): void;
+    /**
+     * Flushes accumulated daily stats to the database.
+     * Should be called periodically (e.g. every minute) or at session end.
+     */
+    flushDailyStats(): void;
+    private accumulateDaily;
+}
+//# sourceMappingURL=collector.d.ts.map

package/dist/observability/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/observability/collector.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAiBtC;;;;;;GAMG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;IAGvC,OAAO,CAAC,gBAAgB,CAAkC;gBAE9C,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAMjC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAUvD;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAOnC;;OAEG;IACH,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,WAAW,EAC1B,MAAM,EAAE,MAAM,GACb,IAAI;IAYP;;OAEG;IACH,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,GACf,IAAI;IAgBP;;OAEG;IACH,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,IAAI;IA0BP;;;OAGG;IACH,eAAe,IAAI,IAAI;IAcvB,OAAO,CAAC,eAAe;CAIxB"}