npm - neuralmemory - Versions diffs - 1.14.0 → 1.15.0 - Mend

neuralmemory 1.14.0 → 1.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md CHANGED Viewed

@@ -54,7 +54,7 @@ Add to `~/.openclaw/openclaw.json`:
 **v1.7.0+**: The plugin dynamically fetches **all tools** from the MCP server at startup. Whatever version of `neural-memory` you have installed, the plugin automatically exposes every tool it provides — no plugin update needed when new tools are added.
-With `neural-memory>=4.6.0`, this includes **45 tools**:
+With `neural-memory>=4.6.0`, this includes **50 tools**:
 | Category | Tools |
 |----------|-------|

package/dist/index.d.ts CHANGED Viewed

@@ -28,14 +28,28 @@
  * Registers:
  *   N tools    — dynamically from MCP server (fallback: 5 core + 2 compat)
  *   1 service  — MCP process lifecycle (start/stop)
- *   2 hooks    — before_agent_start (auto-context), agent_end (auto-capture)
+ *   6 hooks    — before_agent_start (auto-context), agent_end (auto-capture),
+ *                session:compact:before (flush), command:new/reset (flush),
+ *                gateway:startup (consolidation)
  */
 import type { OpenClawPluginDefinition } from "./types.js";
+/**
+ * Strip metadata preamble from raw prompts before recall.
+ *
+ * OpenClaw + Telegram injects JSON metadata, NeuralMemory context blocks,
+ * env vars, and system boilerplate into ev.prompt. Passing these raw to
+ * nmem_recall creates junk neurons like "[concept] json message id".
+ *
+ * Stripping order matters — later passes clean up residue from earlier ones.
+ */
+export declare function stripPromptMetadata(raw: string): string;
 type PluginConfig = {
     pythonPath: string;
     brain: string;
     autoContext: boolean;
     autoCapture: boolean;
+    autoFlush: boolean;
+    autoConsolidate: boolean;
     contextDepth: number;
     maxContextTokens: number;
     timeout: number;

package/dist/index.js CHANGED Viewed

@@ -28,10 +28,46 @@
  * Registers:
  *   N tools    — dynamically from MCP server (fallback: 5 core + 2 compat)
  *   1 service  — MCP process lifecycle (start/stop)
- *   2 hooks    — before_agent_start (auto-context), agent_end (auto-capture)
+ *   6 hooks    — before_agent_start (auto-context), agent_end (auto-capture),
+ *                session:compact:before (flush), command:new/reset (flush),
+ *                gateway:startup (consolidation)
  */
 import { NeuralMemoryMcpClient } from "./mcp-client.js";
 import { createToolsFromMcp, createFallbackTools, createCompatibilityTools } from "./tools.js";
+// ── Prompt metadata stripping ─────────────────────────────
+/**
+ * Strip metadata preamble from raw prompts before recall.
+ *
+ * OpenClaw + Telegram injects JSON metadata, NeuralMemory context blocks,
+ * env vars, and system boilerplate into ev.prompt. Passing these raw to
+ * nmem_recall creates junk neurons like "[concept] json message id".
+ *
+ * Stripping order matters — later passes clean up residue from earlier ones.
+ */
+export function stripPromptMetadata(raw) {
+    let cleaned = raw;
+    // 1. Remove JSON blocks (Telegram metadata, conversation info)
+    cleaned = cleaned.replace(/^\{[\s\S]*?"(?:conversation|message_id|sender_id|sender|chat_id|update_id)"[\s\S]*?\}$/gm, "");
+    // 2. Remove NeuralMemory context sections (## Relevant Memories, etc.)
+    //    The |$ ensures sections at end-of-string are also stripped.
+    cleaned = cleaned.replace(/^#{1,3}\s*(?:Relevant Memories|Related Information|Relevant Context|Neural Memory)[\s\S]*?(?=\n#{1,3}\s|\n\n(?![-•*\s])|$)/gim, "");
+    // 3. Remove neuron-type bullet lines injected by NM context
+    cleaned = cleaned.replace(/^-\s*\[(?:concept|entity|decision|error|preference|insight|memory|fact|workflow|instruction|pattern)\].*$/gim, "");
+    // 4. Remove [NeuralMemory — ...] wrapper lines
+    cleaned = cleaned.replace(/^\[NeuralMemory\s*[—–-].*\]$/gm, "");
+    // 5. Remove metadata labels (untrusted metadata lines)
+    cleaned = cleaned.replace(/^(?:Conversation info|Sender|Context|System)\s*\(.*?\)\s*:?\s*$/gim, "");
+    // 6. Remove env/export lines
+    cleaned = cleaned.replace(/^export\s+\w+=.*$/gm, "");
+    // 7. Collapse whitespace runs
+    cleaned = cleaned.replace(/\n{3,}/g, "\n\n").trim();
+    // Fallback: if everything was stripped, use last non-empty line of raw
+    if (!cleaned) {
+        const lines = raw.split("\n").filter((l) => l.trim());
+        cleaned = lines[lines.length - 1]?.trim() ?? raw.trim();
+    }
+    return cleaned;
+}
 // ── System prompt for tool awareness ──────────────────────
 /**
  * Build a system prompt listing all registered tool names.
@@ -41,21 +77,43 @@ function buildToolInstructions(tools) {
     const toolList = tools
         .map((t) => `- ${t.name}: ${t.description.slice(0, 100)}`)
         .join("\n");
-    return `You have NeuralMemory tools for persistent memory across sessions. Call these as TOOL CALLS (not CLI commands):
-${toolList}
-NeuralMemory (nmem_*) is your primary memory system. memory_search and memory_get are legacy aliases that redirect to nmem_recall — prefer nmem_* tools directly for full functionality.
-These are tool calls, NOT shell commands. Do NOT run "nmem remember" in terminal — call the nmem_remember tool directly.
-PROACTIVE MEMORY: Use nmem_remember after decisions, errors, and insights. Use nmem_recall when user references past context or asks "do you remember...". Use nmem_remember_batch to store multiple memories at once.`;
+    return `Neural Memory gives you persistent memory across sessions. Use it proactively — each session starts fresh, so without explicit saves ALL discoveries are lost.
+These are TOOL CALLS, not CLI commands. Do NOT run "nmem remember" in terminal.
+## Available Tools
+${toolList}
+nmem_* is your primary memory system. memory_search/memory_get are legacy aliases for nmem_recall.
+## WHEN TO RECALL
+- New session starts → nmem_recall("current project context")
+- User references past event → nmem_recall("<that topic>")
+- Prefix queries with project name for precision
+## WHEN TO SAVE
+After each task: did you make a decision (type="decision", priority=7), fix a bug (type="error", priority=7), learn a preference (type="preference", priority=8), or discover an insight (type="insight", priority=6)?
+Save with: nmem_remember(content="Chose X over Y because Z", type="decision", priority=7, tags=["project", "topic"])
+## CONTENT QUALITY
+- Max 1-3 sentences. Use causal language: "Chose X because Y", "Root cause was X, fixed by Y".
+- Always include project name + topic in tags (lowercase).
+- For temporary scratch notes: nmem_remember(content="...", ephemeral=true) — auto-expires, never synced.
+## SESSION END
+nmem_auto(action="process", text="<brief session summary>")
+## COMPACT MODE
+All tools support compact=true (saves 60-80% tokens) and token_budget=N.`;
 }
 const DEFAULT_CONFIG = {
     pythonPath: "python",
     brain: "default",
     autoContext: true,
     autoCapture: true,
+    autoFlush: true,
+    autoConsolidate: true,
     contextDepth: 1,
     maxContextTokens: 500,
     timeout: 30_000,
@@ -78,6 +136,12 @@ export function resolveConfig(raw) {
         autoCapture: typeof merged.autoCapture === "boolean"
             ? merged.autoCapture
             : DEFAULT_CONFIG.autoCapture,
+        autoFlush: typeof merged.autoFlush === "boolean"
+            ? merged.autoFlush
+            : DEFAULT_CONFIG.autoFlush,
+        autoConsolidate: typeof merged.autoConsolidate === "boolean"
+            ? merged.autoConsolidate
+            : DEFAULT_CONFIG.autoConsolidate,
         contextDepth: typeof merged.contextDepth === "number" &&
             Number.isInteger(merged.contextDepth) &&
             merged.contextDepth >= 0 &&
@@ -112,7 +176,7 @@ function getOrCreateMcpClient(cfg, logger) {
     const key = `${cfg.pythonPath}::${cfg.brain}`;
     const existing = mcpClients.get(key);
     if (existing) {
-        logger.info(`Reusing existing MCP client for brain "${cfg.brain}"`);
+        logger.debug?.(`Reusing existing MCP client for brain "${cfg.brain}"`);
         return existing;
     }
     const mcp = new NeuralMemoryMcpClient({
@@ -130,7 +194,7 @@ const plugin = {
     id: "neuralmemory",
     name: "NeuralMemory",
     description: "Brain-inspired persistent memory for AI agents — neurons, synapses, and fibers",
-    version: "1.14.0",
+    version: "1.15.0",
     kind: "memory",
     register(api) {
         const cfg = resolveConfig(api.pluginConfig);
@@ -186,8 +250,9 @@ const plugin = {
             if (cfg.autoContext && mcp.connected) {
                 const ev = event;
                 try {
+                    const query = stripPromptMetadata(ev.prompt);
                     const raw = await mcp.callTool("nmem_recall", {
-                        query: ev.prompt,
+                        query,
                         depth: cfg.contextDepth,
                         max_tokens: cfg.maxContextTokens,
                     });
@@ -232,9 +297,78 @@ const plugin = {
                 }
             }, { priority: 90 });
         }
+        // ── Hook: flush memories before context compaction ──
+        if (cfg.autoFlush) {
+            api.on("session:compact:before", async (_event, _ctx) => {
+                if (!mcp.connected)
+                    return;
+                try {
+                    await mcp.callTool("nmem_auto", {
+                        action: "process",
+                        text: "[pre-compact emergency flush]",
+                    });
+                    api.logger.info("Pre-compact flush completed");
+                }
+                catch (err) {
+                    api.logger.warn(`Pre-compact flush failed: ${err.message}`);
+                }
+            }, { priority: 5 });
+            // Flush on session boundary (new/reset commands)
+            api.on("command:new", async (_event, _ctx) => {
+                if (!mcp.connected)
+                    return;
+                try {
+                    await mcp.callTool("nmem_auto", {
+                        action: "process",
+                        text: "[session boundary — command:new]",
+                    });
+                }
+                catch (err) {
+                    api.logger.warn(`Session boundary flush failed: ${err.message}`);
+                }
+            }, { priority: 10 });
+            api.on("command:reset", async (_event, _ctx) => {
+                if (!mcp.connected)
+                    return;
+                try {
+                    await mcp.callTool("nmem_auto", {
+                        action: "process",
+                        text: "[session boundary — command:reset]",
+                    });
+                }
+                catch (err) {
+                    api.logger.warn(`Session reset flush failed: ${err.message}`);
+                }
+            }, { priority: 10 });
+        }
+        // ── Hook: consolidation on gateway startup ───────────
+        if (cfg.autoConsolidate) {
+            api.on("gateway:startup", async (_event, _ctx) => {
+                if (!mcp.connected) {
+                    try {
+                        await mcp.ensureConnected();
+                    }
+                    catch (err) {
+                        api.logger.warn(`MCP connect on startup failed: ${err.message}`);
+                        return;
+                    }
+                }
+                try {
+                    await mcp.callTool("nmem_consolidate", {
+                        strategy: "enrich",
+                        compact: true,
+                    });
+                    api.logger.info("Startup consolidation completed");
+                }
+                catch (err) {
+                    api.logger.warn(`Startup consolidation failed: ${err.message}`);
+                }
+            }, { priority: 50 });
+        }
         // ── Done ────────────────────────────────────────────
         api.logger.info(`NeuralMemory registered (brain: ${cfg.brain}, ` +
-            `autoContext: ${cfg.autoContext}, autoCapture: ${cfg.autoCapture}) — ` +
+            `autoContext: ${cfg.autoContext}, autoCapture: ${cfg.autoCapture}, ` +
+            `autoFlush: ${cfg.autoFlush}, autoConsolidate: ${cfg.autoConsolidate}) — ` +
             `tools will be loaded dynamically from MCP on service start`);
     },
 };

package/dist/index.js.map CHANGED Viewed

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

package/dist/types.d.ts CHANGED Viewed

@@ -41,6 +41,19 @@ export type AgentContext = {
     sessionKey?: string;
     workspaceDir?: string;
 };
+export type SessionCompactEvent = {
+    reason?: string;
+    messagesBeforeCompact?: number;
+};
+export type CommandEvent = {
+    command: string;
+    sessionKey?: string;
+    workspaceDir?: string;
+};
+export type GatewayStartupEvent = {
+    version?: string;
+    workspaceDir?: string;
+};
 export type OpenClawPluginApi = {
     id: string;
     name: string;

package/openclaw.plugin.json CHANGED Viewed

@@ -3,7 +3,7 @@
   "kind": "memory",
   "name": "NeuralMemory",
   "description": "Brain-inspired persistent memory for AI agents — neurons, synapses, and fibers. REQUIRED: set plugins.slots.memory = \"neuralmemory\" in openclaw.json to disable the default memory-core plugin and activate NeuralMemory as the exclusive memory provider.",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "configSchema": {
     "jsonSchema": {
       "type": "object",
@@ -30,6 +30,16 @@
           "description": "Auto-extract and store memories after each agent run",
           "default": true
         },
+        "autoFlush": {
+          "type": "boolean",
+          "description": "Flush memories before context compaction and on session boundaries (new/reset)",
+          "default": true
+        },
+        "autoConsolidate": {
+          "type": "boolean",
+          "description": "Run consolidation on gateway startup to enrich and merge memories",
+          "default": true
+        },
         "contextDepth": {
           "type": "integer",
           "minimum": 0,
@@ -76,6 +86,14 @@
         "label": "Auto-capture Memories",
         "help": "Automatically extract facts, decisions, and insights after each agent run"
       },
+      "autoFlush": {
+        "label": "Auto-flush on Compact/Reset",
+        "help": "Flush unsaved memories before context compaction and when starting a new session"
+      },
+      "autoConsolidate": {
+        "label": "Auto-consolidate on Startup",
+        "help": "Run memory consolidation (enrich strategy) when the OpenClaw gateway starts"
+      },
       "contextDepth": {
         "label": "Context Depth",
         "help": "How deep to search: 0=instant lookup, 1=contextual, 2=habit patterns, 3=full graph traversal"

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "neuralmemory",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "NeuralMemory plugin for OpenClaw — brain-inspired persistent memory for AI agents",
   "type": "module",
   "main": "dist/index.js",

package/src/index.ts CHANGED Viewed

@@ -1,342 +1,534 @@
-/**
- * NeuralMemory — OpenClaw Memory Plugin
- *
- * Brain-inspired persistent memory for AI agents.
- * Occupies the exclusive "memory" plugin slot.
- *
- * Architecture:
- *   OpenClaw ←→ Plugin (TypeScript) ←→ MCP stdio ←→ NeuralMemory (Python)
- *
- * v1.7.0: Dynamic tool proxy — fetches all tools from MCP `tools/list`
- * instead of hardcoding 6 tools. Automatically exposes every tool the
- * MCP server provides (39+ tools in NM v2.28.0).
- *
- * v1.8.0: Compatible with NM v2.29.0 — RRF score fusion, graph-based
- * query expansion, and Personalized PageRank activation.
- *
- * v1.8.1: Fix async register() — OpenClaw requires synchronous registration.
- * Fallback tools registered sync; MCP connection deferred to service.start().
- *
- * v1.9.0: Backward-compat shim tools (memory_search, memory_get) to prevent
- * "allowList contains unknown entries" warnings when NM replaces memory-core.
- *
- * v1.10.0: Singleton MCP client — multiple workspaces (multi-agent) share
- * the same connected client instance, keyed by (pythonPath, brain). Fixes
- * "NeuralMemory service not running" when OpenClaw registers the plugin
- * for a second workspace after gateway startup.
- *
- * Registers:
- *   N tools    — dynamically from MCP server (fallback: 5 core + 2 compat)
- *   1 service  — MCP process lifecycle (start/stop)
- *   2 hooks    — before_agent_start (auto-context), agent_end (auto-capture)
- */
-import type {
-  OpenClawPluginDefinition,
-  OpenClawPluginApi,
-  BeforeAgentStartEvent,
-  BeforeAgentStartResult,
-  AgentEndEvent,
-} from "./types.js";
-import { NeuralMemoryMcpClient } from "./mcp-client.js";
-import type { PluginLogger } from "./types.js";
-import { createToolsFromMcp, createFallbackTools, createCompatibilityTools } from "./tools.js";
-import type { ToolDefinition } from "./tools.js";
-// ── System prompt for tool awareness ──────────────────────
-/**
- * Build a system prompt listing all registered tool names.
- * This makes the agent aware of which nmem_* tools are available.
- */
-function buildToolInstructions(tools: ToolDefinition[]): string {
-  const toolList = tools
-    .map((t) => `- ${t.name}: ${t.description.slice(0, 100)}`)
-    .join("\n");
-  return `You have NeuralMemory tools for persistent memory across sessions. Call these as TOOL CALLS (not CLI commands):
-${toolList}
-NeuralMemory (nmem_*) is your primary memory system. memory_search and memory_get are legacy aliases that redirect to nmem_recall — prefer nmem_* tools directly for full functionality.
-These are tool calls, NOT shell commands. Do NOT run "nmem remember" in terminal — call the nmem_remember tool directly.
-PROACTIVE MEMORY: Use nmem_remember after decisions, errors, and insights. Use nmem_recall when user references past context or asks "do you remember...". Use nmem_remember_batch to store multiple memories at once.`;
-}
-// ── Config ─────────────────────────────────────────────────
-type PluginConfig = {
-  pythonPath: string;
-  brain: string;
-  autoContext: boolean;
-  autoCapture: boolean;
-  contextDepth: number;
-  maxContextTokens: number;
-  timeout: number;
-  initTimeout: number;
-};
-const DEFAULT_CONFIG: Readonly<PluginConfig> = {
-  pythonPath: "python",
-  brain: "default",
-  autoContext: true,
-  autoCapture: true,
-  contextDepth: 1,
-  maxContextTokens: 500,
-  timeout: 30_000,
-  initTimeout: 90_000,
-};
-export const BRAIN_NAME_RE = /^[a-zA-Z0-9_\-.]{1,64}$/;
-export const MAX_AUTO_CAPTURE_CHARS = 50_000;
-export function resolveConfig(raw?: Record<string, unknown>): PluginConfig {
-  const merged = { ...DEFAULT_CONFIG, ...(raw ?? {}) };
-  return {
-    pythonPath:
-      typeof merged.pythonPath === "string" && merged.pythonPath.length > 0
-        ? merged.pythonPath
-        : DEFAULT_CONFIG.pythonPath,
-    brain:
-      typeof merged.brain === "string" && BRAIN_NAME_RE.test(merged.brain)
-        ? merged.brain
-        : DEFAULT_CONFIG.brain,
-    autoContext:
-      typeof merged.autoContext === "boolean"
-        ? merged.autoContext
-        : DEFAULT_CONFIG.autoContext,
-    autoCapture:
-      typeof merged.autoCapture === "boolean"
-        ? merged.autoCapture
-        : DEFAULT_CONFIG.autoCapture,
-    contextDepth:
-      typeof merged.contextDepth === "number" &&
-      Number.isInteger(merged.contextDepth) &&
-      merged.contextDepth >= 0 &&
-      merged.contextDepth <= 3
-        ? merged.contextDepth
-        : DEFAULT_CONFIG.contextDepth,
-    maxContextTokens:
-      typeof merged.maxContextTokens === "number" &&
-      Number.isInteger(merged.maxContextTokens) &&
-      merged.maxContextTokens >= 100 &&
-      merged.maxContextTokens <= 10_000
-        ? merged.maxContextTokens
-        : DEFAULT_CONFIG.maxContextTokens,
-    timeout:
-      typeof merged.timeout === "number" &&
-      Number.isFinite(merged.timeout) &&
-      merged.timeout >= 5_000 &&
-      merged.timeout <= 120_000
-        ? merged.timeout
-        : DEFAULT_CONFIG.timeout,
-    initTimeout:
-      typeof merged.initTimeout === "number" &&
-      Number.isFinite(merged.initTimeout) &&
-      merged.initTimeout >= 10_000 &&
-      merged.initTimeout <= 300_000
-        ? merged.initTimeout
-        : DEFAULT_CONFIG.initTimeout,
-  };
-}
-// ── Singleton MCP client pool ────────────────────────────────
-// Multiple workspaces may call register() independently, but all
-// should share the same MCP process per (pythonPath, brain) combo.
-const mcpClients = new Map<string, NeuralMemoryMcpClient>();
-function getOrCreateMcpClient(
-  cfg: PluginConfig,
-  logger: PluginLogger,
-): NeuralMemoryMcpClient {
-  const key = `${cfg.pythonPath}::${cfg.brain}`;
-  const existing = mcpClients.get(key);
-  if (existing) {
-    logger.info(`Reusing existing MCP client for brain "${cfg.brain}"`);
-    return existing;
-  }
-  const mcp = new NeuralMemoryMcpClient({
-    pythonPath: cfg.pythonPath,
-    brain: cfg.brain,
-    logger,
-    timeout: cfg.timeout,
-    initTimeout: cfg.initTimeout,
-  });
-  mcpClients.set(key, mcp);
-  return mcp;
-}
-// ── Plugin definition ──────────────────────────────────────
-const plugin: OpenClawPluginDefinition = {
-  id: "neuralmemory",
-  name: "NeuralMemory",
-  description:
-    "Brain-inspired persistent memory for AI agents — neurons, synapses, and fibers",
-  version: "1.14.0",
-  kind: "memory",
-  register(api: OpenClawPluginApi): void {
-    const cfg = resolveConfig(api.pluginConfig);
-    const mcp = getOrCreateMcpClient(cfg, api.logger);
-    // ── Register fallback tools synchronously ────────────
-    // OpenClaw requires register() to be synchronous.
-    // Register stable fallback tools immediately; MCP connection
-    // and dynamic tool discovery happen in service.start().
-    // Fallback tools auto-reconnect MCP on first call.
-    const registeredTools = createFallbackTools(mcp);
-    const compatTools = createCompatibilityTools(mcp);
-    for (const t of [...registeredTools, ...compatTools]) {
-      api.registerTool(t, { name: t.name });
-    }
-    api.logger.info(
-      `Registered ${registeredTools.length} NeuralMemory tools + ${compatTools.length} compat shims (sync)`,
-    );
-    // ── Service: MCP process lifecycle ───────────────────
-    api.registerService({
-      id: "neuralmemory-mcp",
-      async start(): Promise<void> {
-        if (!mcp.connected) {
-          try {
-            await mcp.connect();
-            api.logger.info("NeuralMemory MCP connected in service.start()");
-            // Log discovered tools for diagnostics (cannot re-register
-            // after register() — OpenClaw freezes the tool list).
-            try {
-              const dynamicTools = await createToolsFromMcp(mcp);
-              api.logger.info(
-                `NeuralMemory MCP discovered ${dynamicTools.length} tools`,
-              );
-            } catch (err) {
-              api.logger.warn(
-                `Tool discovery failed: ${(err as Error).message}`,
-              );
-            }
-          } catch (err) {
-            api.logger.error(
-              `Failed to start NeuralMemory MCP: ${(err as Error).message}`,
-            );
-            throw err;
-          }
-        }
-      },
-      async stop(): Promise<void> {
-        // Remove from singleton pool so next register() creates fresh client
-        const key = `${cfg.pythonPath}::${cfg.brain}`;
-        mcpClients.delete(key);
-        await mcp.close();
-        api.logger.info("NeuralMemory MCP service stopped");
-      },
-    });
-    // ── Hook: tool awareness + auto-context before agent start ───
-    api.on(
-      "before_agent_start",
-      async (
-        event: unknown,
-        _ctx: unknown,
-      ): Promise<BeforeAgentStartResult | void> => {
-        const result: BeforeAgentStartResult = {
-          systemPrompt: buildToolInstructions(registeredTools),
-        };
-        if (cfg.autoContext && mcp.connected) {
-          const ev = event as BeforeAgentStartEvent;
-          try {
-            const raw = await mcp.callTool("nmem_recall", {
-              query: ev.prompt,
-              depth: cfg.contextDepth,
-              max_tokens: cfg.maxContextTokens,
-            });
-            const data = JSON.parse(raw) as {
-              answer?: string;
-              confidence?: number;
-            };
-            if (data.answer && (data.confidence ?? 0) > 0.1) {
-              result.prependContext = `[NeuralMemory — relevant context]\n${data.answer}`;
-            }
-          } catch (err) {
-            api.logger.warn(
-              `Auto-context failed: ${(err as Error).message}`,
-            );
-          }
-        }
-        return result;
-      },
-      { priority: 10 },
-    );
-    // ── Hook: auto-capture after agent completes ────────
-    if (cfg.autoCapture) {
-      api.on(
-        "agent_end",
-        async (event: unknown, _ctx: unknown): Promise<void> => {
-          if (!mcp.connected) return;
-          const ev = event as AgentEndEvent;
-          if (!ev.success) return;
-          try {
-            const messages = ev.messages?.slice(-5) ?? [];
-            const text = messages
-              .filter(
-                (m: unknown): m is { role: string; content: string } =>
-                  typeof m === "object" &&
-                  m !== null &&
-                  (m as { role?: string }).role === "assistant" &&
-                  typeof (m as { content?: unknown }).content === "string",
-              )
-              .map((m) => m.content)
-              .join("\n")
-              .slice(0, MAX_AUTO_CAPTURE_CHARS);
-            if (text.length > 50) {
-              await mcp.callTool("nmem_auto", {
-                action: "process",
-                text,
-              });
-            }
-          } catch (err) {
-            api.logger.warn(
-              `Auto-capture failed: ${(err as Error).message}`,
-            );
-          }
-        },
-        { priority: 90 },
-      );
-    }
-    // ── Done ────────────────────────────────────────────
-    api.logger.info(
-      `NeuralMemory registered (brain: ${cfg.brain}, ` +
-        `autoContext: ${cfg.autoContext}, autoCapture: ${cfg.autoCapture}) — ` +
-        `tools will be loaded dynamically from MCP on service start`,
-    );
-  },
-};
-export default plugin;
+/**
+ * NeuralMemory — OpenClaw Memory Plugin
+ *
+ * Brain-inspired persistent memory for AI agents.
+ * Occupies the exclusive "memory" plugin slot.
+ *
+ * Architecture:
+ *   OpenClaw ←→ Plugin (TypeScript) ←→ MCP stdio ←→ NeuralMemory (Python)
+ *
+ * v1.7.0: Dynamic tool proxy — fetches all tools from MCP `tools/list`
+ * instead of hardcoding 6 tools. Automatically exposes every tool the
+ * MCP server provides (39+ tools in NM v2.28.0).
+ *
+ * v1.8.0: Compatible with NM v2.29.0 — RRF score fusion, graph-based
+ * query expansion, and Personalized PageRank activation.
+ *
+ * v1.8.1: Fix async register() — OpenClaw requires synchronous registration.
+ * Fallback tools registered sync; MCP connection deferred to service.start().
+ *
+ * v1.9.0: Backward-compat shim tools (memory_search, memory_get) to prevent
+ * "allowList contains unknown entries" warnings when NM replaces memory-core.
+ *
+ * v1.10.0: Singleton MCP client — multiple workspaces (multi-agent) share
+ * the same connected client instance, keyed by (pythonPath, brain). Fixes
+ * "NeuralMemory service not running" when OpenClaw registers the plugin
+ * for a second workspace after gateway startup.
+ *
+ * Registers:
+ *   N tools    — dynamically from MCP server (fallback: 5 core + 2 compat)
+ *   1 service  — MCP process lifecycle (start/stop)
+ *   6 hooks    — before_agent_start (auto-context), agent_end (auto-capture),
+ *                session:compact:before (flush), command:new/reset (flush),
+ *                gateway:startup (consolidation)
+ */
+import type {
+  OpenClawPluginDefinition,
+  OpenClawPluginApi,
+  BeforeAgentStartEvent,
+  BeforeAgentStartResult,
+  AgentEndEvent,
+  SessionCompactEvent,
+  CommandEvent,
+  GatewayStartupEvent,
+} from "./types.js";
+import { NeuralMemoryMcpClient } from "./mcp-client.js";
+import type { PluginLogger } from "./types.js";
+import { createToolsFromMcp, createFallbackTools, createCompatibilityTools } from "./tools.js";
+import type { ToolDefinition } from "./tools.js";
+// ── Prompt metadata stripping ─────────────────────────────
+/**
+ * Strip metadata preamble from raw prompts before recall.
+ *
+ * OpenClaw + Telegram injects JSON metadata, NeuralMemory context blocks,
+ * env vars, and system boilerplate into ev.prompt. Passing these raw to
+ * nmem_recall creates junk neurons like "[concept] json message id".
+ *
+ * Stripping order matters — later passes clean up residue from earlier ones.
+ */
+export function stripPromptMetadata(raw: string): string {
+  let cleaned = raw;
+  // 1. Remove JSON blocks (Telegram metadata, conversation info)
+  cleaned = cleaned.replace(
+    /^\{[\s\S]*?"(?:conversation|message_id|sender_id|sender|chat_id|update_id)"[\s\S]*?\}$/gm,
+    "",
+  );
+  // 2. Remove NeuralMemory context sections (## Relevant Memories, etc.)
+  //    The |$ ensures sections at end-of-string are also stripped.
+  cleaned = cleaned.replace(
+    /^#{1,3}\s*(?:Relevant Memories|Related Information|Relevant Context|Neural Memory)[\s\S]*?(?=\n#{1,3}\s|\n\n(?![-•*\s])|$)/gim,
+    "",
+  );
+  // 3. Remove neuron-type bullet lines injected by NM context
+  cleaned = cleaned.replace(
+    /^-\s*\[(?:concept|entity|decision|error|preference|insight|memory|fact|workflow|instruction|pattern)\].*$/gim,
+    "",
+  );
+  // 4. Remove [NeuralMemory — ...] wrapper lines
+  cleaned = cleaned.replace(/^\[NeuralMemory\s*[—–-].*\]$/gm, "");
+  // 5. Remove metadata labels (untrusted metadata lines)
+  cleaned = cleaned.replace(
+    /^(?:Conversation info|Sender|Context|System)\s*\(.*?\)\s*:?\s*$/gim,
+    "",
+  );
+  // 6. Remove env/export lines
+  cleaned = cleaned.replace(/^export\s+\w+=.*$/gm, "");
+  // 7. Collapse whitespace runs
+  cleaned = cleaned.replace(/\n{3,}/g, "\n\n").trim();
+  // Fallback: if everything was stripped, use last non-empty line of raw
+  if (!cleaned) {
+    const lines = raw.split("\n").filter((l) => l.trim());
+    cleaned = lines[lines.length - 1]?.trim() ?? raw.trim();
+  }
+  return cleaned;
+}
+// ── System prompt for tool awareness ──────────────────────
+/**
+ * Build a system prompt listing all registered tool names.
+ * This makes the agent aware of which nmem_* tools are available.
+ */
+function buildToolInstructions(tools: ToolDefinition[]): string {
+  const toolList = tools
+    .map((t) => `- ${t.name}: ${t.description.slice(0, 100)}`)
+    .join("\n");
+  return `Neural Memory gives you persistent memory across sessions. Use it proactively — each session starts fresh, so without explicit saves ALL discoveries are lost.
+These are TOOL CALLS, not CLI commands. Do NOT run "nmem remember" in terminal.
+## Available Tools
+${toolList}
+nmem_* is your primary memory system. memory_search/memory_get are legacy aliases for nmem_recall.
+## WHEN TO RECALL
+- New session starts → nmem_recall("current project context")
+- User references past event → nmem_recall("<that topic>")
+- Prefix queries with project name for precision
+## WHEN TO SAVE
+After each task: did you make a decision (type="decision", priority=7), fix a bug (type="error", priority=7), learn a preference (type="preference", priority=8), or discover an insight (type="insight", priority=6)?
+Save with: nmem_remember(content="Chose X over Y because Z", type="decision", priority=7, tags=["project", "topic"])
+## CONTENT QUALITY
+- Max 1-3 sentences. Use causal language: "Chose X because Y", "Root cause was X, fixed by Y".
+- Always include project name + topic in tags (lowercase).
+- For temporary scratch notes: nmem_remember(content="...", ephemeral=true) — auto-expires, never synced.
+## SESSION END
+nmem_auto(action="process", text="<brief session summary>")
+## COMPACT MODE
+All tools support compact=true (saves 60-80% tokens) and token_budget=N.`;
+}
+// ── Config ─────────────────────────────────────────────────
+type PluginConfig = {
+  pythonPath: string;
+  brain: string;
+  autoContext: boolean;
+  autoCapture: boolean;
+  autoFlush: boolean;
+  autoConsolidate: boolean;
+  contextDepth: number;
+  maxContextTokens: number;
+  timeout: number;
+  initTimeout: number;
+};
+const DEFAULT_CONFIG: Readonly<PluginConfig> = {
+  pythonPath: "python",
+  brain: "default",
+  autoContext: true,
+  autoCapture: true,
+  autoFlush: true,
+  autoConsolidate: true,
+  contextDepth: 1,
+  maxContextTokens: 500,
+  timeout: 30_000,
+  initTimeout: 90_000,
+};
+export const BRAIN_NAME_RE = /^[a-zA-Z0-9_\-.]{1,64}$/;
+export const MAX_AUTO_CAPTURE_CHARS = 50_000;
+export function resolveConfig(raw?: Record<string, unknown>): PluginConfig {
+  const merged = { ...DEFAULT_CONFIG, ...(raw ?? {}) };
+  return {
+    pythonPath:
+      typeof merged.pythonPath === "string" && merged.pythonPath.length > 0
+        ? merged.pythonPath
+        : DEFAULT_CONFIG.pythonPath,
+    brain:
+      typeof merged.brain === "string" && BRAIN_NAME_RE.test(merged.brain)
+        ? merged.brain
+        : DEFAULT_CONFIG.brain,
+    autoContext:
+      typeof merged.autoContext === "boolean"
+        ? merged.autoContext
+        : DEFAULT_CONFIG.autoContext,
+    autoCapture:
+      typeof merged.autoCapture === "boolean"
+        ? merged.autoCapture
+        : DEFAULT_CONFIG.autoCapture,
+    autoFlush:
+      typeof merged.autoFlush === "boolean"
+        ? merged.autoFlush
+        : DEFAULT_CONFIG.autoFlush,
+    autoConsolidate:
+      typeof merged.autoConsolidate === "boolean"
+        ? merged.autoConsolidate
+        : DEFAULT_CONFIG.autoConsolidate,
+    contextDepth:
+      typeof merged.contextDepth === "number" &&
+      Number.isInteger(merged.contextDepth) &&
+      merged.contextDepth >= 0 &&
+      merged.contextDepth <= 3
+        ? merged.contextDepth
+        : DEFAULT_CONFIG.contextDepth,
+    maxContextTokens:
+      typeof merged.maxContextTokens === "number" &&
+      Number.isInteger(merged.maxContextTokens) &&
+      merged.maxContextTokens >= 100 &&
+      merged.maxContextTokens <= 10_000
+        ? merged.maxContextTokens
+        : DEFAULT_CONFIG.maxContextTokens,
+    timeout:
+      typeof merged.timeout === "number" &&
+      Number.isFinite(merged.timeout) &&
+      merged.timeout >= 5_000 &&
+      merged.timeout <= 120_000
+        ? merged.timeout
+        : DEFAULT_CONFIG.timeout,
+    initTimeout:
+      typeof merged.initTimeout === "number" &&
+      Number.isFinite(merged.initTimeout) &&
+      merged.initTimeout >= 10_000 &&
+      merged.initTimeout <= 300_000
+        ? merged.initTimeout
+        : DEFAULT_CONFIG.initTimeout,
+  };
+}
+// ── Singleton MCP client pool ────────────────────────────────
+// Multiple workspaces may call register() independently, but all
+// should share the same MCP process per (pythonPath, brain) combo.
+const mcpClients = new Map<string, NeuralMemoryMcpClient>();
+function getOrCreateMcpClient(
+  cfg: PluginConfig,
+  logger: PluginLogger,
+): NeuralMemoryMcpClient {
+  const key = `${cfg.pythonPath}::${cfg.brain}`;
+  const existing = mcpClients.get(key);
+  if (existing) {
+    logger.debug?.(`Reusing existing MCP client for brain "${cfg.brain}"`);
+    return existing;
+  }
+  const mcp = new NeuralMemoryMcpClient({
+    pythonPath: cfg.pythonPath,
+    brain: cfg.brain,
+    logger,
+    timeout: cfg.timeout,
+    initTimeout: cfg.initTimeout,
+  });
+  mcpClients.set(key, mcp);
+  return mcp;
+}
+// ── Plugin definition ──────────────────────────────────────
+const plugin: OpenClawPluginDefinition = {
+  id: "neuralmemory",
+  name: "NeuralMemory",
+  description:
+    "Brain-inspired persistent memory for AI agents — neurons, synapses, and fibers",
+  version: "1.15.0",
+  kind: "memory",
+  register(api: OpenClawPluginApi): void {
+    const cfg = resolveConfig(api.pluginConfig);
+    const mcp = getOrCreateMcpClient(cfg, api.logger);
+    // ── Register fallback tools synchronously ────────────
+    // OpenClaw requires register() to be synchronous.
+    // Register stable fallback tools immediately; MCP connection
+    // and dynamic tool discovery happen in service.start().
+    // Fallback tools auto-reconnect MCP on first call.
+    const registeredTools = createFallbackTools(mcp);
+    const compatTools = createCompatibilityTools(mcp);
+    for (const t of [...registeredTools, ...compatTools]) {
+      api.registerTool(t, { name: t.name });
+    }
+    api.logger.info(
+      `Registered ${registeredTools.length} NeuralMemory tools + ${compatTools.length} compat shims (sync)`,
+    );
+    // ── Service: MCP process lifecycle ───────────────────
+    api.registerService({
+      id: "neuralmemory-mcp",
+      async start(): Promise<void> {
+        if (!mcp.connected) {
+          try {
+            await mcp.connect();
+            api.logger.info("NeuralMemory MCP connected in service.start()");
+            // Log discovered tools for diagnostics (cannot re-register
+            // after register() — OpenClaw freezes the tool list).
+            try {
+              const dynamicTools = await createToolsFromMcp(mcp);
+              api.logger.info(
+                `NeuralMemory MCP discovered ${dynamicTools.length} tools`,
+              );
+            } catch (err) {
+              api.logger.warn(
+                `Tool discovery failed: ${(err as Error).message}`,
+              );
+            }
+          } catch (err) {
+            api.logger.error(
+              `Failed to start NeuralMemory MCP: ${(err as Error).message}`,
+            );
+            throw err;
+          }
+        }
+      },
+      async stop(): Promise<void> {
+        // Remove from singleton pool so next register() creates fresh client
+        const key = `${cfg.pythonPath}::${cfg.brain}`;
+        mcpClients.delete(key);
+        await mcp.close();
+        api.logger.info("NeuralMemory MCP service stopped");
+      },
+    });
+    // ── Hook: tool awareness + auto-context before agent start ───
+    api.on(
+      "before_agent_start",
+      async (
+        event: unknown,
+        _ctx: unknown,
+      ): Promise<BeforeAgentStartResult | void> => {
+        const result: BeforeAgentStartResult = {
+          systemPrompt: buildToolInstructions(registeredTools),
+        };
+        if (cfg.autoContext && mcp.connected) {
+          const ev = event as BeforeAgentStartEvent;
+          try {
+            const query = stripPromptMetadata(ev.prompt);
+            const raw = await mcp.callTool("nmem_recall", {
+              query,
+              depth: cfg.contextDepth,
+              max_tokens: cfg.maxContextTokens,
+            });
+            const data = JSON.parse(raw) as {
+              answer?: string;
+              confidence?: number;
+            };
+            if (data.answer && (data.confidence ?? 0) > 0.1) {
+              result.prependContext = `[NeuralMemory — relevant context]\n${data.answer}`;
+            }
+          } catch (err) {
+            api.logger.warn(
+              `Auto-context failed: ${(err as Error).message}`,
+            );
+          }
+        }
+        return result;
+      },
+      { priority: 10 },
+    );
+    // ── Hook: auto-capture after agent completes ────────
+    if (cfg.autoCapture) {
+      api.on(
+        "agent_end",
+        async (event: unknown, _ctx: unknown): Promise<void> => {
+          if (!mcp.connected) return;
+          const ev = event as AgentEndEvent;
+          if (!ev.success) return;
+          try {
+            const messages = ev.messages?.slice(-5) ?? [];
+            const text = messages
+              .filter(
+                (m: unknown): m is { role: string; content: string } =>
+                  typeof m === "object" &&
+                  m !== null &&
+                  (m as { role?: string }).role === "assistant" &&
+                  typeof (m as { content?: unknown }).content === "string",
+              )
+              .map((m) => m.content)
+              .join("\n")
+              .slice(0, MAX_AUTO_CAPTURE_CHARS);
+            if (text.length > 50) {
+              await mcp.callTool("nmem_auto", {
+                action: "process",
+                text,
+              });
+            }
+          } catch (err) {
+            api.logger.warn(
+              `Auto-capture failed: ${(err as Error).message}`,
+            );
+          }
+        },
+        { priority: 90 },
+      );
+    }
+    // ── Hook: flush memories before context compaction ──
+    if (cfg.autoFlush) {
+      api.on(
+        "session:compact:before",
+        async (_event: unknown, _ctx: unknown): Promise<void> => {
+          if (!mcp.connected) return;
+          try {
+            await mcp.callTool("nmem_auto", {
+              action: "process",
+              text: "[pre-compact emergency flush]",
+            });
+            api.logger.info("Pre-compact flush completed");
+          } catch (err) {
+            api.logger.warn(
+              `Pre-compact flush failed: ${(err as Error).message}`,
+            );
+          }
+        },
+        { priority: 5 },
+      );
+      // Flush on session boundary (new/reset commands)
+      api.on(
+        "command:new",
+        async (_event: unknown, _ctx: unknown): Promise<void> => {
+          if (!mcp.connected) return;
+          try {
+            await mcp.callTool("nmem_auto", {
+              action: "process",
+              text: "[session boundary — command:new]",
+            });
+          } catch (err) {
+            api.logger.warn(
+              `Session boundary flush failed: ${(err as Error).message}`,
+            );
+          }
+        },
+        { priority: 10 },
+      );
+      api.on(
+        "command:reset",
+        async (_event: unknown, _ctx: unknown): Promise<void> => {
+          if (!mcp.connected) return;
+          try {
+            await mcp.callTool("nmem_auto", {
+              action: "process",
+              text: "[session boundary — command:reset]",
+            });
+          } catch (err) {
+            api.logger.warn(
+              `Session reset flush failed: ${(err as Error).message}`,
+            );
+          }
+        },
+        { priority: 10 },
+      );
+    }
+    // ── Hook: consolidation on gateway startup ───────────
+    if (cfg.autoConsolidate) {
+      api.on(
+        "gateway:startup",
+        async (_event: unknown, _ctx: unknown): Promise<void> => {
+          if (!mcp.connected) {
+            try {
+              await mcp.ensureConnected();
+            } catch (err) {
+              api.logger.warn(
+                `MCP connect on startup failed: ${(err as Error).message}`,
+              );
+              return;
+            }
+          }
+          try {
+            await mcp.callTool("nmem_consolidate", {
+              strategy: "enrich",
+              compact: true,
+            });
+            api.logger.info("Startup consolidation completed");
+          } catch (err) {
+            api.logger.warn(
+              `Startup consolidation failed: ${(err as Error).message}`,
+            );
+          }
+        },
+        { priority: 50 },
+      );
+    }
+    // ── Done ────────────────────────────────────────────
+    api.logger.info(
+      `NeuralMemory registered (brain: ${cfg.brain}, ` +
+        `autoContext: ${cfg.autoContext}, autoCapture: ${cfg.autoCapture}, ` +
+        `autoFlush: ${cfg.autoFlush}, autoConsolidate: ${cfg.autoConsolidate}) — ` +
+        `tools will be loaded dynamically from MCP on service start`,
+    );
+  },
+};
+export default plugin;

package/src/types.ts CHANGED Viewed

@@ -50,6 +50,22 @@ export type AgentContext = {
   workspaceDir?: string;
 };
+export type SessionCompactEvent = {
+  reason?: string;
+  messagesBeforeCompact?: number;
+};
+export type CommandEvent = {
+  command: string;           // "new", "reset", "stop"
+  sessionKey?: string;
+  workspaceDir?: string;
+};
+export type GatewayStartupEvent = {
+  version?: string;
+  workspaceDir?: string;
+};
 export type OpenClawPluginApi = {
   id: string;
   name: string;