neuralmemory 1.5.0

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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)
+ *
+ * Registers:
+ *   6 tools    — nmem_remember, nmem_recall, nmem_context, nmem_todo, nmem_stats, nmem_health
+ *   1 service  — MCP process lifecycle (start/stop)
+ *   2 hooks    — before_agent_start (auto-context), agent_end (auto-capture)
+ */
+import type { OpenClawPluginDefinition } from "./types.js";
+type PluginConfig = {
+    pythonPath: string;
+    brain: string;
+    autoContext: boolean;
+    autoCapture: boolean;
+    contextDepth: number;
+    maxContextTokens: number;
+    timeout: number;
+    initTimeout: number;
+};
+export declare const BRAIN_NAME_RE: RegExp;
+export declare const MAX_AUTO_CAPTURE_CHARS = 50000;
+export declare function resolveConfig(raw?: Record<string, unknown>): PluginConfig;
+declare const plugin: OpenClawPluginDefinition;
+export default plugin;

package/dist/index.js

@@ -0,0 +1,184 @@
+/**
+ * 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)
+ *
+ * Registers:
+ *   6 tools    — nmem_remember, nmem_recall, nmem_context, nmem_todo, nmem_stats, nmem_health
+ *   1 service  — MCP process lifecycle (start/stop)
+ *   2 hooks    — before_agent_start (auto-context), agent_end (auto-capture)
+ */
+import { NeuralMemoryMcpClient } from "./mcp-client.js";
+import { createTools } from "./tools.js";
+// ── System prompt for tool awareness ──────────────────────
+const TOOL_INSTRUCTIONS = `You have NeuralMemory tools for persistent memory across sessions. Call these as TOOL CALLS (not CLI commands):
+
+- nmem_remember(content, type?, priority?, tags?) — Store a memory (fact, decision, error, preference, etc.)
+- nmem_recall(query, depth?, max_tokens?) — Query memories via spreading activation
+- nmem_context(limit?, fresh_only?) — Get recent memories
+- nmem_todo(task, priority?) — Quick TODO with 30-day expiry
+- nmem_stats() — Brain statistics
+- nmem_health() — Brain health diagnostics
+
+CRITICAL: NeuralMemory (nmem_*) is your ONLY memory system. Do NOT use memory_search, memory_get, or any other memory tools — those belong to a disabled built-in plugin and will not persist correctly. Always use nmem_* tools exclusively.
+
+These are tool calls, NOT shell commands. Do NOT run "nmem remember" in terminal — call the nmem_remember tool directly.
+
+Use nmem_remember proactively after decisions, errors, and insights. Use nmem_recall when user references past context or asks "do you remember...".`;
+const DEFAULT_CONFIG = {
+    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) {
+    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,
+    };
+}
+// ── Plugin definition ──────────────────────────────────────
+const plugin = {
+    id: "neuralmemory",
+    name: "NeuralMemory",
+    description: "Brain-inspired persistent memory for AI agents — neurons, synapses, and fibers",
+    version: "1.5.0",
+    kind: "memory",
+    register(api) {
+        const cfg = resolveConfig(api.pluginConfig);
+        const mcp = new NeuralMemoryMcpClient({
+            pythonPath: cfg.pythonPath,
+            brain: cfg.brain,
+            logger: api.logger,
+            timeout: cfg.timeout,
+            initTimeout: cfg.initTimeout,
+        });
+        // ── Service: MCP process lifecycle ───────────────────
+        api.registerService({
+            id: "neuralmemory-mcp",
+            async start() {
+                try {
+                    await mcp.connect();
+                    api.logger.info("NeuralMemory MCP service started");
+                }
+                catch (err) {
+                    api.logger.error(`Failed to start NeuralMemory MCP: ${err.message}`);
+                    throw err;
+                }
+            },
+            async stop() {
+                await mcp.close();
+                api.logger.info("NeuralMemory MCP service stopped");
+            },
+        });
+        // ── Tools: 6 core memory tools ──────────────────────
+        const tools = createTools(mcp);
+        for (const t of tools) {
+            api.registerTool(t, { name: t.name });
+        }
+        // ── Hook: tool awareness + auto-context before agent start ───
+        api.on("before_agent_start", async (event, _ctx) => {
+            const result = {
+                systemPrompt: TOOL_INSTRUCTIONS,
+            };
+            if (cfg.autoContext && mcp.connected) {
+                const ev = event;
+                try {
+                    const raw = await mcp.callTool("nmem_recall", {
+                        query: ev.prompt,
+                        depth: cfg.contextDepth,
+                        max_tokens: cfg.maxContextTokens,
+                    });
+                    const data = JSON.parse(raw);
+                    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.message}`);
+                }
+            }
+            return result;
+        }, { priority: 10 });
+        // ── Hook: auto-capture after agent completes ────────
+        if (cfg.autoCapture) {
+            api.on("agent_end", async (event, _ctx) => {
+                if (!mcp.connected)
+                    return;
+                const ev = event;
+                if (!ev.success)
+                    return;
+                try {
+                    const messages = ev.messages?.slice(-5) ?? [];
+                    const text = messages
+                        .filter((m) => typeof m === "object" &&
+                        m !== null &&
+                        m.role === "assistant" &&
+                        typeof m.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.message}`);
+                }
+            }, { priority: 90 });
+        }
+        // ── Done ────────────────────────────────────────────
+        api.logger.info(`NeuralMemory registered (brain: ${cfg.brain}, tools: ${tools.length}, ` +
+            `autoContext: ${cfg.autoContext}, autoCapture: ${cfg.autoCapture})`);
+    },
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp-client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * NeuralMemory MCP Client — JSON-RPC 2.0 over stdio.
+ *
+ * Spawns `python -m neural_memory.mcp` and communicates using the
+ * MCP protocol (newline-delimited JSON Lines).
+ *
+ * Zero external dependencies — implements the protocol directly.
+ */
+import type { PluginLogger } from "./types.js";
+export type McpClientOptions = {
+    readonly pythonPath: string;
+    readonly brain: string;
+    readonly logger: PluginLogger;
+    readonly timeout?: number;
+    readonly initTimeout?: number;
+};
+/** Env vars forwarded to the MCP child process (least-privilege). */
+export declare const ALLOWED_ENV_KEYS: ReadonlySet<string>;
+export declare class NeuralMemoryMcpClient {
+    private proc;
+    private requestId;
+    private readonly pending;
+    private rawBuffer;
+    private readonly pythonPath;
+    private readonly brain;
+    private readonly logger;
+    private readonly timeout;
+    private readonly initTimeout;
+    private _connected;
+    constructor(options: McpClientOptions);
+    get connected(): boolean;
+    connect(): Promise<void>;
+    callTool(name: string, args?: Record<string, unknown>): Promise<string>;
+    close(): Promise<void>;
+    private send;
+    private notify;
+    private writeMessage;
+    private drainBuffer;
+    private handleMessage;
+    private rejectAll;
+}
+/** Build a minimal env for the child process (least-privilege). */
+export declare function buildChildEnv(brain: string): Record<string, string>;

package/dist/mcp-client.js

@@ -0,0 +1,242 @@
+/**
+ * NeuralMemory MCP Client — JSON-RPC 2.0 over stdio.
+ *
+ * Spawns `python -m neural_memory.mcp` and communicates using the
+ * MCP protocol (newline-delimited JSON Lines).
+ *
+ * Zero external dependencies — implements the protocol directly.
+ */
+import { spawn } from "node:child_process";
+// ── Constants ──────────────────────────────────────────────
+const PROTOCOL_VERSION = "2024-11-05";
+const DEFAULT_TIMEOUT = 30_000;
+const CLIENT_NAME = "openclaw-neuralmemory";
+const CLIENT_VERSION = "1.5.0";
+const MAX_BUFFER_BYTES = 10 * 1024 * 1024; // 10 MB safety cap
+const MAX_STDERR_LINES = 50;
+/** Env vars forwarded to the MCP child process (least-privilege). */
+export const ALLOWED_ENV_KEYS = new Set([
+    "PATH",
+    "PATHEXT",
+    "HOME",
+    "USERPROFILE",
+    "SYSTEMROOT",
+    "TEMP",
+    "TMP",
+    "LANG",
+    "LC_ALL",
+    "VIRTUAL_ENV",
+    "CONDA_PREFIX",
+    "PYTHONPATH",
+    "PYTHONHOME",
+    "NEURALMEMORY_DIR",
+    "NEURALMEMORY_BRAIN",
+    "NEURAL_MEMORY_DIR",
+    "NEURAL_MEMORY_JSON",
+    "NEURAL_MEMORY_DEBUG",
+]);
+// ── Client ─────────────────────────────────────────────────
+export class NeuralMemoryMcpClient {
+    proc = null;
+    requestId = 0;
+    pending = new Map();
+    rawBuffer = Buffer.alloc(0);
+    pythonPath;
+    brain;
+    logger;
+    timeout;
+    initTimeout;
+    _connected = false;
+    constructor(options) {
+        this.pythonPath = options.pythonPath;
+        this.brain = options.brain;
+        this.logger = options.logger;
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        this.initTimeout = options.initTimeout ?? 90_000;
+    }
+    get connected() {
+        return this._connected;
+    }
+    async connect() {
+        const env = buildChildEnv(this.brain);
+        this.proc = spawn(this.pythonPath, ["-m", "neural_memory.mcp"], {
+            stdio: ["pipe", "pipe", "pipe"],
+            env,
+        });
+        this.proc.stdout.on("data", (chunk) => {
+            this.rawBuffer = Buffer.concat([this.rawBuffer, chunk]);
+            if (this.rawBuffer.length > MAX_BUFFER_BYTES) {
+                this.logger.error(`MCP buffer exceeded ${MAX_BUFFER_BYTES} bytes — killing process`);
+                this.proc?.kill("SIGKILL");
+                return;
+            }
+            this.drainBuffer();
+        });
+        const stderrChunks = [];
+        this.proc.stderr.on("data", (chunk) => {
+            const msg = chunk.toString("utf-8").trim();
+            if (msg) {
+                if (stderrChunks.length < MAX_STDERR_LINES) {
+                    stderrChunks.push(msg);
+                }
+                this.logger.warn(`[mcp stderr] ${msg}`);
+            }
+        });
+        this.proc.on("exit", (code) => {
+            this._connected = false;
+            const hint = code === 1
+                ? " — check that neural-memory is installed: pip install neural-memory"
+                : "";
+            this.rejectAll(new Error(`MCP process exited with code ${code}${hint}`));
+            this.logger.error(`MCP process exited (code: ${code})${hint}`);
+        });
+        this.proc.on("error", (err) => {
+            this._connected = false;
+            const hint = err.message.includes("ENOENT")
+                ? ` — "${this.pythonPath}" not found. Check pythonPath in plugin config.`
+                : "";
+            this.rejectAll(new Error(`MCP process error: ${err.message}${hint}`));
+            this.logger.error(`MCP process error: ${err.message}${hint}`);
+        });
+        // MCP initialize handshake (uses longer timeout for cold starts)
+        try {
+            await this.send("initialize", {
+                protocolVersion: PROTOCOL_VERSION,
+                capabilities: {},
+                clientInfo: { name: CLIENT_NAME, version: CLIENT_VERSION },
+            }, this.initTimeout);
+        }
+        catch (err) {
+            const stderr = stderrChunks.join("\n");
+            const detail = stderr
+                ? `\nPython stderr:\n${stderr}`
+                : "\nNo stderr output — the Python process may have hung.";
+            throw new Error(`MCP initialize failed: ${err.message}${detail}\n` +
+                `Verify: ${this.pythonPath} -m neural_memory.mcp`);
+        }
+        // Send initialized notification (no response expected)
+        this.notify("notifications/initialized", {});
+        this._connected = true;
+        this.logger.info(`MCP connected (brain: ${this.brain}, protocol: ${PROTOCOL_VERSION})`);
+    }
+    async callTool(name, args = {}) {
+        const result = (await this.send("tools/call", {
+            name,
+            arguments: args,
+        }));
+        if (result.isError) {
+            const text = result.content?.[0]?.text ?? "Unknown MCP error";
+            throw new Error(text);
+        }
+        return result.content?.[0]?.text ?? "";
+    }
+    async close() {
+        this._connected = false;
+        this.rejectAll(new Error("Client closing"));
+        const proc = this.proc;
+        this.proc = null;
+        this.rawBuffer = Buffer.alloc(0);
+        if (proc) {
+            proc.removeAllListeners();
+            proc.stdout?.removeAllListeners();
+            proc.stderr?.removeAllListeners();
+            const exited = new Promise((resolve) => {
+                proc.once("exit", () => resolve());
+                setTimeout(() => {
+                    proc.kill("SIGKILL");
+                    resolve();
+                }, 3_000);
+            });
+            proc.kill("SIGTERM");
+            await exited;
+        }
+        this.logger.info("MCP client closed");
+    }
+    // ── JSON-RPC protocol layer ──────────────────────────────
+    send(method, params, timeoutOverride) {
+        return new Promise((resolve, reject) => {
+            if (!this.proc?.stdin?.writable) {
+                reject(new Error("MCP process not available"));
+                return;
+            }
+            const id = ++this.requestId;
+            const ms = timeoutOverride ?? this.timeout;
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`MCP timeout: ${method} (${ms}ms)`));
+            }, ms);
+            this.pending.set(id, { resolve, reject, timer });
+            this.writeMessage({ jsonrpc: "2.0", id, method, params });
+        });
+    }
+    notify(method, params) {
+        if (!this.proc?.stdin?.writable)
+            return;
+        this.writeMessage({ jsonrpc: "2.0", method, params });
+    }
+    writeMessage(message) {
+        if (!this.proc?.stdin?.writable)
+            return;
+        const json = JSON.stringify(message);
+        const frame = `${json}\n`;
+        this.proc.stdin.write(frame);
+    }
+    // ── Response parsing (newline-delimited JSON Lines) ────────
+    drainBuffer() {
+        while (true) {
+            const newlineIndex = this.rawBuffer.indexOf("\n");
+            if (newlineIndex === -1)
+                break;
+            const line = this.rawBuffer.subarray(0, newlineIndex).toString("utf-8");
+            this.rawBuffer = this.rawBuffer.subarray(newlineIndex + 1);
+            if (!line.trim())
+                continue;
+            try {
+                const message = JSON.parse(line);
+                this.handleMessage(message);
+            }
+            catch (err) {
+                this.logger.error(`Failed to parse MCP message: ${err.message}`);
+            }
+        }
+    }
+    handleMessage(message) {
+        // Notifications (no id) — ignore silently
+        if (message.id == null)
+            return;
+        const pending = this.pending.get(message.id);
+        if (!pending)
+            return;
+        this.pending.delete(message.id);
+        clearTimeout(pending.timer);
+        if (message.error) {
+            pending.reject(new Error(`MCP error ${message.error.code}: ${message.error.message}`));
+        }
+        else {
+            pending.resolve(message.result);
+        }
+    }
+    rejectAll(error) {
+        for (const [, pending] of this.pending) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+}
+// ── Helpers ─────────────────────────────────────────────────
+/** Build a minimal env for the child process (least-privilege). */
+export function buildChildEnv(brain) {
+    const env = {};
+    for (const key of ALLOWED_ENV_KEYS) {
+        const value = process.env[key];
+        if (value !== undefined) {
+            env[key] = value;
+        }
+    }
+    if (brain !== "default") {
+        env.NEURALMEMORY_BRAIN = brain;
+    }
+    return env;
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/mcp-client.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,34 @@
+/**
+ * NeuralMemory tool definitions for OpenClaw.
+ *
+ * Each tool proxies to the MCP server via JSON-RPC.
+ *
+ * Uses raw JSON Schema for parameters. Provider compatibility notes:
+ *   - `additionalProperties: false` required by OpenAI strict mode
+ *   - `number` instead of `integer` for Gemini compatibility
+ *   - No `maxLength`/`maxItems`/`minimum`/`maximum` — some providers
+ *     reject schemas with constraint keywords; our MCP server validates
+ *
+ * Registers 6 core tools:
+ *   nmem_remember  — Store a memory
+ *   nmem_recall    — Query/search memories
+ *   nmem_context   — Get recent context
+ *   nmem_todo      — Quick TODO shortcut
+ *   nmem_stats     — Brain statistics
+ *   nmem_health    — Brain health diagnostics
+ */
+import type { NeuralMemoryMcpClient } from "./mcp-client.js";
+type JsonSchema = {
+    readonly type: "object";
+    readonly properties: Record<string, unknown>;
+    readonly required?: readonly string[];
+    readonly additionalProperties?: boolean;
+};
+export type ToolDefinition = {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: JsonSchema;
+    readonly execute: (id: string, args: Record<string, unknown>) => Promise<unknown>;
+};
+export declare function createTools(mcp: NeuralMemoryMcpClient): ToolDefinition[];
+export {};