neuralmemory 1.6.1 → 1.7.0

package/dist/tools.js

@@ -1,25 +1,108 @@
 /**
- * NeuralMemory tool definitions for OpenClaw.
+ * NeuralMemory dynamic tool proxy for OpenClaw.
  *
- * Each tool proxies to the MCP server via JSON-RPC.
+ * Fetches all available tools from the MCP server via `tools/list` and
+ * converts them into OpenClaw tool definitions. This means the plugin
+ * automatically exposes every tool the MCP server provides — no hardcoded
+ * schemas to maintain.
  *
- * 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
+ * Provider compatibility:
+ *   - Strips constraint keywords (`minimum`, `maximum`, `maxLength`,
+ *     `maxItems`, `minLength`) that some providers reject
+ *   - Adds `additionalProperties: false` on all object schemas for
+ *     OpenAI strict mode
+ *   - Ensures every object type has a `properties` field (required by
+ *     Anthropic SDK validation)
+ *   - Uses `number` instead of `integer` for Gemini compatibility
+ */
+// ── Schema normalization ───────────────────────────────────
+/** Keywords that some LLM providers reject in function schemas. */
+const STRIP_KEYS = new Set([
+    "minimum",
+    "maximum",
+    "maxLength",
+    "minLength",
+    "maxItems",
+    "minItems",
+    "exclusiveMinimum",
+    "exclusiveMaximum",
+]);
+/**
+ * Recursively normalize a JSON Schema node for provider compatibility:
+ * - Strip constraint keywords
+ * - Replace `integer` with `number` (Gemini compat)
+ * - Add `additionalProperties: false` to objects (OpenAI strict mode)
+ * - Ensure every object has `properties` (Anthropic SDK)
  */
+function normalizeSchema(node) {
+    if (node === null || node === undefined || typeof node !== "object") {
+        return node;
+    }
+    if (Array.isArray(node)) {
+        return node.map(normalizeSchema);
+    }
+    const obj = node;
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (STRIP_KEYS.has(key))
+            continue;
+        if (key === "type" && value === "integer") {
+            result[key] = "number";
+        }
+        else if (key === "properties" && typeof value === "object" && value !== null) {
+            // Recurse into each property definition
+            const props = {};
+            for (const [propName, propSchema] of Object.entries(value)) {
+                props[propName] = normalizeSchema(propSchema);
+            }
+            result[key] = props;
+        }
+        else if (key === "items" && typeof value === "object" && value !== null) {
+            result[key] = normalizeSchema(value);
+        }
+        else if ((key === "anyOf" || key === "oneOf" || key === "allOf") &&
+            Array.isArray(value)) {
+            result[key] = value.map(normalizeSchema);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    // Ensure objects have `properties` and `additionalProperties`
+    if (result["type"] === "object") {
+        if (!("properties" in result) || result["properties"] === undefined) {
+            result["properties"] = {};
+        }
+        if (!("additionalProperties" in result)) {
+            result["additionalProperties"] = false;
+        }
+    }
+    return result;
+}
+/**
+ * Convert an MCP inputSchema into a provider-safe OpenClaw JsonSchema.
+ * Falls back to an empty-properties object if the schema is missing/invalid.
+ */
+function toSafeSchema(inputSchema) {
+    if (!inputSchema || typeof inputSchema !== "object") {
+        return { type: "object", properties: {}, additionalProperties: false };
+    }
+    const normalized = normalizeSchema(inputSchema);
+    return {
+        type: "object",
+        properties: (normalized["properties"] ?? {}),
+        ...(Array.isArray(normalized["required"]) && normalized["required"].length > 0
+            ? { required: normalized["required"] }
+            : {}),
+        additionalProperties: false,
+    };
+}
 // ── Tool factory ───────────────────────────────────────────
-export function createTools(mcp) {
-    const call = async (toolName, args) => {
+/**
+ * Create a tool call helper that auto-reconnects to MCP.
+ */
+function makeCallFn(mcp) {
+    return async (toolName, args) => {
         if (!mcp.connected) {
             try {
                 await mcp.ensureConnected();
@@ -47,6 +130,33 @@ export function createTools(mcp) {
             };
         }
     };
+}
+/**
+ * Convert a single MCP tool definition into an OpenClaw ToolDefinition.
+ */
+function mcpToolToOpenClaw(mcpTool, call) {
+    return {
+        name: mcpTool.name,
+        description: mcpTool.description ?? `NeuralMemory tool: ${mcpTool.name}`,
+        parameters: toSafeSchema(mcpTool.inputSchema),
+        execute: (_id, args) => call(mcpTool.name, args),
+    };
+}
+/**
+ * Fetch all tools from the MCP server and convert them to OpenClaw format.
+ * Must be called after MCP connection is established.
+ */
+export async function createToolsFromMcp(mcp) {
+    const mcpTools = await mcp.listTools();
+    const call = makeCallFn(mcp);
+    return mcpTools.map((t) => mcpToolToOpenClaw(t, call));
+}
+/**
+ * Fallback: create minimal hardcoded tools if MCP tools/list fails.
+ * Ensures the plugin still works even if the MCP server is an older version.
+ */
+export function createFallbackTools(mcp) {
+    const call = makeCallFn(mcp);
     return [
         {
             name: "nmem_remember",
@@ -55,39 +165,21 @@ export function createTools(mcp) {
             parameters: {
                 type: "object",
                 properties: {
-                    content: {
-                        type: "string",
-                        description: "The content to remember",
-                    },
+                    content: { type: "string", description: "The content to remember" },
                     type: {
                         type: "string",
                         enum: [
-                            "fact",
-                            "decision",
-                            "preference",
-                            "todo",
-                            "insight",
-                            "context",
-                            "instruction",
-                            "error",
-                            "workflow",
-                            "reference",
+                            "fact", "decision", "preference", "todo", "insight",
+                            "context", "instruction", "error", "workflow", "reference",
                         ],
                         description: "Memory type (auto-detected if not specified)",
                     },
-                    priority: {
-                        type: "number",
-                        description: "Priority 0-10 (5=normal, 10=critical)",
-                    },
+                    priority: { type: "number", description: "Priority 0-10 (5=normal, 10=critical)" },
                     tags: {
                         type: "array",
                         items: { type: "string" },
                         description: "Tags for categorization",
                     },
-                    expires_days: {
-                        type: "number",
-                        description: "Days until memory expires (1-3650)",
-                    },
                 },
                 required: ["content"],
                 additionalProperties: false,
@@ -101,22 +193,9 @@ export function createTools(mcp) {
             parameters: {
                 type: "object",
                 properties: {
-                    query: {
-                        type: "string",
-                        description: "The query to search memories",
-                    },
-                    depth: {
-                        type: "number",
-                        description: "Search depth: 0=instant, 1=context, 2=habit, 3=deep",
-                    },
-                    max_tokens: {
-                        type: "number",
-                        description: "Maximum tokens in response (default: 500)",
-                    },
-                    min_confidence: {
-                        type: "number",
-                        description: "Minimum confidence threshold (0-1)",
-                    },
+                    query: { type: "string", description: "The query to search memories" },
+                    depth: { type: "number", description: "Search depth: 0=instant, 1=context, 2=habit, 3=deep" },
+                    max_tokens: { type: "number", description: "Maximum tokens in response (default: 500)" },
                 },
                 required: ["query"],
                 additionalProperties: false,
@@ -125,63 +204,26 @@ export function createTools(mcp) {
         },
         {
             name: "nmem_context",
-            description: "Get recent context from NeuralMemory. Use this at the start of " +
-                "tasks to inject relevant recent memories.",
+            description: "Get recent context from NeuralMemory.",
             parameters: {
                 type: "object",
                 properties: {
-                    limit: {
-                        type: "number",
-                        description: "Number of recent memories (default: 10, max: 200)",
-                    },
-                    fresh_only: {
-                        type: "boolean",
-                        description: "Only include memories less than 30 days old",
-                    },
+                    limit: { type: "number", description: "Number of recent memories (default: 10)" },
                 },
                 additionalProperties: false,
             },
             execute: (_id, args) => call("nmem_context", args),
         },
-        {
-            name: "nmem_todo",
-            description: "Quick shortcut to add a TODO memory with 30-day expiry.",
-            parameters: {
-                type: "object",
-                properties: {
-                    task: {
-                        type: "string",
-                        description: "The task to remember",
-                    },
-                    priority: {
-                        type: "number",
-                        description: "Priority 0-10 (default: 5)",
-                    },
-                },
-                required: ["task"],
-                additionalProperties: false,
-            },
-            execute: (_id, args) => call("nmem_todo", args),
-        },
         {
             name: "nmem_stats",
             description: "Get brain statistics including memory counts and freshness.",
-            parameters: {
-                type: "object",
-                properties: {},
-                additionalProperties: false,
-            },
+            parameters: { type: "object", properties: {}, additionalProperties: false },
             execute: (_id, args) => call("nmem_stats", args),
         },
         {
             name: "nmem_health",
-            description: "Get brain health diagnostics including grade, purity score, " +
-                "and recommendations.",
-            parameters: {
-                type: "object",
-                properties: {},
-                additionalProperties: false,
-            },
+            description: "Get brain health diagnostics including grade and recommendations.",
+            parameters: { type: "object", properties: {}, additionalProperties: false },
             execute: (_id, args) => call("nmem_health", args),
         },
     ];

package/dist/tools.js.map

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

package/openclaw.plugin.json

@@ -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.6.0",
+  "version": "1.7.0",
   "configSchema": {
     "jsonSchema": {
       "type": "object",

package/package.json

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

package/src/index.ts

@@ -7,8 +7,12 @@
  * 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).
+ *
  * Registers:
- *   6 tools    — nmem_remember, nmem_recall, nmem_context, nmem_todo, nmem_stats, nmem_health
+ *   N tools    — dynamically from MCP server (fallback: 5 core tools)
  *   1 service  — MCP process lifecycle (start/stop)
  *   2 hooks    — before_agent_start (auto-context), agent_end (auto-capture)
  */
@@ -18,28 +22,33 @@ import type {
   OpenClawPluginApi,
   BeforeAgentStartEvent,
   BeforeAgentStartResult,
-  AgentContext,
   AgentEndEvent,
 } from "./types.js";
 import { NeuralMemoryMcpClient } from "./mcp-client.js";
-import { createTools } from "./tools.js";
+import { createToolsFromMcp, createFallbackTools } from "./tools.js";
+import type { ToolDefinition } 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):
+/**
+ * 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):
 
-- 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
+${toolList}
 
 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...".`;
+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 ─────────────────────────────────────────────────
 
@@ -126,10 +135,10 @@ const plugin: OpenClawPluginDefinition = {
   name: "NeuralMemory",
   description:
     "Brain-inspired persistent memory for AI agents — neurons, synapses, and fibers",
-  version: "1.6.0",
+  version: "1.7.0",
   kind: "memory",
 
-  register(api: OpenClawPluginApi): void {
+  async register(api: OpenClawPluginApi): Promise<void> {
     const cfg = resolveConfig(api.pluginConfig);
 
     const mcp = new NeuralMemoryMcpClient({
@@ -140,20 +149,69 @@ const plugin: OpenClawPluginDefinition = {
       initTimeout: cfg.initTimeout,
     });
 
+    // ── Connect MCP + fetch tools during registration ───
+    // Tools must be registered in register() — OpenClaw may
+    // freeze the tool list before service.start() is called.
+
+    let registeredTools: ToolDefinition[];
+
+    try {
+      await mcp.connect();
+      api.logger.info("NeuralMemory MCP connected");
+    } catch (err) {
+      api.logger.error(
+        `Failed to connect NeuralMemory MCP: ${(err as Error).message}`,
+      );
+      // Register fallback tools so the plugin is still partially usable
+      registeredTools = createFallbackTools(mcp);
+      for (const t of registeredTools) {
+        api.registerTool(t, { name: t.name });
+      }
+      api.logger.warn(
+        `Registered ${registeredTools.length} fallback tools (MCP not connected)`,
+      );
+      return;
+    }
+
+    // Fetch tools dynamically from MCP server
+    try {
+      registeredTools = await createToolsFromMcp(mcp);
+      api.logger.info(
+        `Fetched ${registeredTools.length} tools from MCP server`,
+      );
+    } catch (err) {
+      api.logger.warn(
+        `Failed to fetch MCP tools, using fallback: ${(err as Error).message}`,
+      );
+      registeredTools = createFallbackTools(mcp);
+    }
+
+    // Register all tools with OpenClaw
+    for (const t of registeredTools) {
+      api.registerTool(t, { name: t.name });
+    }
+
+    api.logger.info(
+      `Registered ${registeredTools.length} NeuralMemory tools`,
+    );
+
     // ── Service: MCP process lifecycle ───────────────────
 
     api.registerService({
       id: "neuralmemory-mcp",
 
       async start(): Promise<void> {
-        try {
-          await mcp.connect();
-          api.logger.info("NeuralMemory MCP service started");
-        } catch (err) {
-          api.logger.error(
-            `Failed to start NeuralMemory MCP: ${(err as Error).message}`,
-          );
-          throw err;
+        // MCP already connected during register()
+        if (!mcp.connected) {
+          try {
+            await mcp.connect();
+            api.logger.info("NeuralMemory MCP reconnected in service.start()");
+          } catch (err) {
+            api.logger.error(
+              `Failed to start NeuralMemory MCP: ${(err as Error).message}`,
+            );
+            throw err;
+          }
         }
       },
 
@@ -163,14 +221,6 @@ const plugin: OpenClawPluginDefinition = {
       },
     });
 
-    // ── 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(
@@ -180,7 +230,7 @@ const plugin: OpenClawPluginDefinition = {
         _ctx: unknown,
       ): Promise<BeforeAgentStartResult | void> => {
         const result: BeforeAgentStartResult = {
-          systemPrompt: TOOL_INSTRUCTIONS,
+          systemPrompt: buildToolInstructions(registeredTools),
         };
 
         if (cfg.autoContext && mcp.connected) {
@@ -257,8 +307,9 @@ const plugin: OpenClawPluginDefinition = {
     // ── Done ────────────────────────────────────────────
 
     api.logger.info(
-      `NeuralMemory registered (brain: ${cfg.brain}, tools: ${tools.length}, ` +
-        `autoContext: ${cfg.autoContext}, autoCapture: ${cfg.autoCapture})`,
+      `NeuralMemory registered (brain: ${cfg.brain}, ` +
+        `autoContext: ${cfg.autoContext}, autoCapture: ${cfg.autoCapture}) — ` +
+        `tools will be loaded dynamically from MCP on service start`,
     );
   },
 };

package/src/mcp-client.ts

@@ -26,6 +26,13 @@ type JsonRpcMessage = {
   error?: { code: number; message: string; data?: unknown };
 };
 
+/** Raw tool definition from MCP `tools/list` response. */
+export type McpToolDefinition = {
+  name: string;
+  description?: string;
+  inputSchema?: Record<string, unknown>;
+};
+
 export type McpClientOptions = {
   readonly pythonPath: string;
   readonly brain: string;
@@ -39,7 +46,7 @@ export type McpClientOptions = {
 const PROTOCOL_VERSION = "2024-11-05";
 const DEFAULT_TIMEOUT = 30_000;
 const CLIENT_NAME = "openclaw-neuralmemory";
-const CLIENT_VERSION = "1.6.0";
+const CLIENT_VERSION = "1.7.0";
 const MAX_BUFFER_BYTES = 10 * 1024 * 1024; // 10 MB safety cap
 const MAX_STDERR_LINES = 50;
 
@@ -190,6 +197,17 @@ export class NeuralMemoryMcpClient {
     );
   }
 
+  /**
+   * Fetch all available tools from the MCP server via `tools/list`.
+   * Returns the raw MCP tool definitions (name, description, inputSchema).
+   */
+  async listTools(): Promise<McpToolDefinition[]> {
+    const result = (await this.send("tools/list", {})) as {
+      tools?: McpToolDefinition[];
+    };
+    return result.tools ?? [];
+  }
+
   async callTool(
     name: string,
     args: Record<string, unknown> = {},