@icex-labs/openclaw-memory-engine 4.0.0 → 4.1.0

package/index.js

@@ -32,6 +32,7 @@ import { analyzePatterns, formatReflection } from "./lib/reflection.js";
 import { runQualityPass, formatQualityReport } from "./lib/quality.js";
 import { migrateFromJsonl } from "./lib/store-sqlite.js";
 import { generateDashboard } from "./lib/dashboard.js";
+import { captureMessage } from "./lib/auto-capture.js";
 
 import { readFileSync } from "node:fs";
 
@@ -131,6 +132,35 @@ export default definePluginEntry({
       } catch { /* ignore startup errors */ }
     }, 10000); // delay 10s after gateway start
 
+    // ═══════════════════════════════════════════════════════════════════
+    // Auto-capture hooks: passively store facts from conversations
+    // No reliance on agent calling tools — memory happens automatically
+    // ═══════════════════════════════════════════════════════════════════
+
+    api.registerHook("message:received", (event) => {
+      const ctx = event.context;
+      if (!ctx?.content) return;
+
+      // Resolve workspace from session key
+      const agentId = extractAgentId(event.sessionKey);
+      const wsDir = resolveWorkspace({ agentId });
+
+      captureMessage(wsDir, ctx.content, "user-message");
+    });
+
+    api.registerHook("message:sent", (event) => {
+      const ctx = event.context;
+      if (!ctx?.content || !ctx?.success) return;
+
+      // Only capture agent replies, not system messages
+      if (ctx.content.length < 50) return;
+
+      const agentId = extractAgentId(event.sessionKey);
+      const wsDir = resolveWorkspace({ agentId });
+
+      captureMessage(wsDir, ctx.content, "agent-reply");
+    });
+
     // ─── core_memory_read ───
     api.registerTool(withAgent((agentId) => ({
       name: "core_memory_read",

package/lib/auto-capture.js

@@ -0,0 +1,89 @@
+/**
+ * Auto-capture: hook into message:received and message:sent events
+ * to automatically extract and store facts in archival memory.
+ *
+ * No reliance on the agent calling tools — memory happens passively.
+ */
+
+import { appendRecord } from "./archival.js";
+import { indexEmbedding } from "./embedding.js";
+import { extractTriples, addTriple } from "./graph.js";
+import { resolveWorkspace } from "./paths.js";
+
+// Minimum message length to consider for fact extraction
+const MIN_LENGTH = 20;
+
+// Skip patterns — don't store these as facts
+const SKIP_PATTERNS = [
+  /^(hi|hello|hey|ok|thanks|good morning|good night|早|晚安|你好|嗯|好的|谢谢)/i,
+  /^HEARTBEAT_OK$/,
+  /^\//,  // slash commands
+  /^(yes|no|yeah|nah|sure|maybe)$/i,
+];
+
+// High-value content patterns — always store these
+const HIGH_VALUE_PATTERNS = [
+  /\b(decided|decision|plan|scheduled|booked|bought|sold|paid|签|买|卖|预约|决定)\b/i,
+  /\b(doctor|lawyer|immigration|IRCC|IBKR|account|password|address|phone|email)\b/i,
+  /\b(remember|don't forget|提醒|记住|别忘)\b/i,
+  /\$\d{2,}/,  // dollar amounts
+  /\b\d{4}-\d{2}-\d{2}\b/,  // dates
+];
+
+// Entity inference (same as quality.js but lightweight)
+const ENTITY_PATTERNS = [
+  [/\b(IBKR|invest|portfolio|HELOC|mortgage|bank|\$\d{3,})/i, "finance"],
+  [/\b(immigration|PR|IRCC|CBSA|visa|lawyer|律师)/i, "immigration"],
+  [/\b(doctor|医生|hospital|health|medication|药)/i, "health"],
+  [/\b(car|vehicle|Escalade|GX550|ES350|Tesla|tire|车)/i, "vehicles"],
+  [/\b(school|homework|exam|swimming|lesson|学校|课)/i, "education"],
+  [/\b(deploy|k3d|ArgoCD|kubectl|CI|cluster)/i, "infrastructure"],
+  [/\b(quant|trading|backtest|signal|strategy)/i, "quant"],
+];
+
+function inferEntity(text) {
+  for (const [pat, name] of ENTITY_PATTERNS) {
+    if (pat.test(text)) return name;
+  }
+  return "conversation";
+}
+
+function shouldCapture(content) {
+  if (!content || content.length < MIN_LENGTH) return false;
+  if (SKIP_PATTERNS.some((p) => p.test(content.trim()))) return false;
+  return true;
+}
+
+function isHighValue(content) {
+  return HIGH_VALUE_PATTERNS.some((p) => p.test(content));
+}
+
+/**
+ * Process an incoming or outgoing message and auto-store if valuable.
+ */
+export function captureMessage(ws, content, source = "auto-capture") {
+  if (!shouldCapture(content)) return null;
+
+  const importance = isHighValue(content) ? 7 : 4;
+  const entity = inferEntity(content);
+
+  // Trim very long messages to first 500 chars
+  const trimmed = content.length > 500 ? content.slice(0, 497) + "..." : content;
+
+  const record = appendRecord(ws, {
+    content: trimmed,
+    entity,
+    tags: [source],
+    importance,
+  });
+
+  // Background: index embedding + extract graph triples
+  indexEmbedding(ws, record).catch(() => {});
+
+  const triples = extractTriples(trimmed);
+  for (const t of triples) {
+    addTriple(ws, t.s, t.r, t.o, record.id);
+  }
+
+  return record;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icex-labs/openclaw-memory-engine",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "MemGPT-style hierarchical memory plugin for OpenClaw — core memory block + archival storage with semantic search",
   "type": "module",
   "main": "index.js",