@mysten-incubation/oc-memwal 0.0.1-dev.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAGxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAGlF"}

package/dist/tools/index.js

@@ -0,0 +1,15 @@
+/**
+ * Agent-callable tools — require tools.allow config to be visible to the LLM.
+ *
+ * Tools accept an optional namespace parameter. The before_prompt_build hook
+ * injects the current agent's namespace into the system prompt, guiding the
+ * LLM to pass the correct namespace. Falls back to defaultNamespace if omitted.
+ */
+import { registerSearchTool } from "./search.js";
+import { registerStoreTool } from "./store.js";
+/** Register all agent-callable tools. */
+export function registerTools(api, client, config) {
+    registerSearchTool(api, client, config);
+    registerStoreTool(api, client, config);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,yCAAyC;AACzC,MAAM,UAAU,aAAa,CAAC,GAAQ,EAAE,MAAc,EAAE,MAAoB;IAC1E,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/tools/search.d.ts

@@ -0,0 +1,13 @@
+/**
+ * memory_search tool — semantic recall.
+ *
+ * Requires tools.allow config to be visible to the LLM.
+ * Accepts an optional namespace parameter; the before_prompt_build hook
+ * injects the current agent's namespace into the system prompt, guiding
+ * the LLM to pass the correct value.
+ */
+import type { MemWal } from "@mysten-incubation/memwal";
+import type { PluginConfig } from "../types.js";
+/** Register the memory_search agent tool. */
+export declare function registerSearchTool(api: any, client: MemWal, config: PluginConfig): void;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAIxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,6CAA6C;AAC7C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAoFvF"}

package/dist/tools/search.js

@@ -0,0 +1,83 @@
+/**
+ * memory_search tool — semantic recall.
+ *
+ * Requires tools.allow config to be visible to the LLM.
+ * Accepts an optional namespace parameter; the before_prompt_build hook
+ * injects the current agent's namespace into the system prompt, guiding
+ * the LLM to pass the correct value.
+ */
+import { Type } from "@sinclair/typebox";
+import { looksLikeInjection } from "../capture.js";
+import { escapeForPrompt, toolError } from "../format.js";
+/** Register the memory_search agent tool. */
+export function registerSearchTool(api, client, config) {
+    api.registerTool({
+        name: "memory_search",
+        label: "Memory Search",
+        description: "Search long-term memory for relevant past information, facts, " +
+            "preferences, and decisions. Returns memories ranked by relevance. " +
+            "Pass the namespace parameter to scope the search to the current agent's memory.",
+        parameters: Type.Object({
+            query: Type.String({ description: "Search query" }),
+            limit: Type.Optional(Type.Number({ description: "Max results (default: 5)" })),
+            namespace: Type.Optional(Type.String({
+                description: "Memory namespace to search (use the namespace from system context)",
+            })),
+        }),
+        async execute(_id, params) {
+            const { query, limit = 5, namespace } = params;
+            // LLM may omit namespace (e.g. tools.allow set but hooks disabled) — fall back safely
+            const ns = namespace || config.defaultNamespace;
+            try {
+                const result = await client.recall(query, limit, ns);
+                if (!result.results?.length) {
+                    return {
+                        content: [
+                            { type: "text", text: "No relevant memories found." },
+                        ],
+                        details: { count: 0, namespace: ns },
+                    };
+                }
+                // Filter out injection attempts and escape text before returning
+                // to the LLM — same protection as the recall hook path
+                const safe = result.results.filter((r) => !looksLikeInjection(r.text));
+                if (!safe.length) {
+                    return {
+                        content: [
+                            { type: "text", text: "No relevant memories found." },
+                        ],
+                        details: { count: 0, namespace: ns },
+                    };
+                }
+                // MemWal returns L2 distance — convert to similarity % for readability
+                const formatted = safe
+                    .map((r, i) => {
+                    const relevance = Math.round((1 - r.distance) * 100);
+                    return `${i + 1}. ${escapeForPrompt(r.text)} (${relevance}% relevance)`;
+                })
+                    .join("\n");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Found ${safe.length} memories:\n\n${formatted}`,
+                        },
+                    ],
+                    details: {
+                        count: safe.length,
+                        namespace: ns,
+                        memories: safe.map((r) => ({
+                            text: r.text,
+                            blob_id: r.blob_id,
+                            relevance: Math.round((1 - r.distance) * 100) / 100,
+                        })),
+                    },
+                };
+            }
+            catch (err) {
+                return toolError("Memory search failed", err);
+            }
+        },
+    }, { name: "memory_search" });
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * memory_store tool — explicit save.
+ *
+ * Uses analyze() instead of remember() so the server LLM extracts
+ * individual facts from the text, producing cleaner, more searchable
+ * memories (same approach as Mem0's memory_store).
+ */
+import type { MemWal } from "@mysten-incubation/memwal";
+import type { PluginConfig } from "../types.js";
+/** Register the memory_store agent tool. */
+export declare function registerStoreTool(api: any, client: MemWal, config: PluginConfig): void;
+//# sourceMappingURL=store.d.ts.map

package/dist/tools/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/tools/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAIxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAoFtF"}

package/dist/tools/store.js

@@ -0,0 +1,87 @@
+/**
+ * memory_store tool — explicit save.
+ *
+ * Uses analyze() instead of remember() so the server LLM extracts
+ * individual facts from the text, producing cleaner, more searchable
+ * memories (same approach as Mem0's memory_store).
+ */
+import { Type } from "@sinclair/typebox";
+import { looksLikeInjection } from "../capture.js";
+import { toolError } from "../format.js";
+/** Register the memory_store agent tool. */
+export function registerStoreTool(api, client, config) {
+    api.registerTool({
+        name: "memory_store",
+        label: "Memory Store",
+        description: "Save important information to encrypted long-term memory. " +
+            "Use when the user asks to remember something or when you " +
+            "identify important facts worth preserving. " +
+            "Pass the namespace parameter to store in the current agent's memory.",
+        parameters: Type.Object({
+            text: Type.String({
+                description: "Information to store in memory",
+            }),
+            namespace: Type.Optional(Type.String({
+                description: "Memory namespace to store in (use the namespace from system context)",
+            })),
+        }),
+        async execute(_id, params) {
+            const { text, namespace } = params;
+            const ns = namespace || config.defaultNamespace;
+            // Defence in depth: reject injection on write, not just on read.
+            // The recall hook filters on retrieval, but polluted data could
+            // surface through other read paths (memory_search, future tools).
+            if (looksLikeInjection(text)) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Cannot store text containing disallowed patterns.",
+                        },
+                    ],
+                    details: { error: "injection_rejected" },
+                };
+            }
+            if (!text || text.trim().length < 3) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Cannot store empty or very short text.",
+                        },
+                    ],
+                    details: { error: "text_too_short" },
+                };
+            }
+            try {
+                const result = await client.analyze(text.trim(), ns);
+                const factCount = result.facts?.length ?? 0;
+                // Show first 3 extracted facts as confirmation, or raw text truncation as fallback
+                const preview = result.facts
+                    ?.map((f) => f.text)
+                    .slice(0, 3)
+                    .join("; ") ?? text.slice(0, 100);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: factCount > 0
+                                ? `Stored ${factCount} fact${factCount === 1 ? "" : "s"}: ${preview}`
+                                : `No memorable facts extracted from the input.`,
+                        },
+                    ],
+                    details: {
+                        action: "created",
+                        namespace: ns,
+                        factCount,
+                        facts: result.facts,
+                    },
+                };
+            }
+            catch (err) {
+                return toolError("Failed to store memory", err);
+            }
+        },
+    }, { name: "memory_store" });
+}
+//# sourceMappingURL=store.js.map

package/dist/tools/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared types for the MemWal OpenClaw plugin.
+ */
+export interface PluginConfig {
+    /** Ed25519 private key (hex). */
+    privateKey: string;
+    /** MemWalAccount object ID on Sui. */
+    accountId: string;
+    /** MemWal server URL. */
+    serverUrl: string;
+    /** Default namespace for memory scoping (default: "default"). */
+    defaultNamespace: string;
+    /** Auto-inject relevant memories before each agent turn. */
+    autoRecall: boolean;
+    /** Auto-extract and store facts after each agent turn. */
+    autoCapture: boolean;
+    /** Max memories to inject per auto-recall. */
+    maxRecallResults: number;
+    /** Min relevance threshold (0-1) for auto-recall filtering. */
+    minRelevance: number;
+    /** Number of recent messages to send for auto-capture. */
+    captureMaxMessages: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,WAAW,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,kBAAkB,EAAE,MAAM,CAAC;CAC5B"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for the MemWal OpenClaw plugin.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/openclaw.plugin.json

@@ -0,0 +1,101 @@
+{
+  "id": "memory-memwal",
+  "kind": "memory",
+  "name": "Memory (MemWal)",
+  "description": "Encrypted, decentralized long-term memory via MemWal + Walrus",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "privateKey": {
+        "type": "string",
+        "description": "Ed25519 private key (hex). Supports ${ENV_VAR}."
+      },
+      "accountId": {
+        "type": "string",
+        "description": "MemWalAccount object ID on Sui (0x...)"
+      },
+      "serverUrl": {
+        "type": "string",
+        "description": "MemWal server URL"
+      },
+      "defaultNamespace": {
+        "type": "string",
+        "description": "Default namespace for memory scoping (default: 'default')"
+      },
+      "autoRecall": {
+        "type": "boolean",
+        "description": "Auto-inject relevant memories before each turn"
+      },
+      "autoCapture": {
+        "type": "boolean",
+        "description": "Auto-extract and store facts after each turn"
+      },
+      "maxRecallResults": {
+        "type": "number",
+        "minimum": 1,
+        "maximum": 20,
+        "description": "Max memories per auto-recall"
+      },
+      "minRelevance": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "description": "Min relevance threshold for auto-recall"
+      },
+      "captureMaxMessages": {
+        "type": "number",
+        "minimum": 1,
+        "maximum": 50,
+        "description": "Recent messages window for auto-capture"
+      }
+    },
+    "required": ["privateKey", "accountId", "serverUrl"]
+  },
+  "uiHints": {
+    "privateKey": {
+      "label": "Ed25519 Private Key",
+      "sensitive": true,
+      "placeholder": "64-character hex string or ${ENV_VAR}",
+      "help": "Get from app.memwal.com. Supports ${ENV_VAR} syntax."
+    },
+    "accountId": {
+      "label": "MemWalAccount ID",
+      "placeholder": "0x3247e3da...",
+      "help": "MemWalAccount object ID on Sui. Get from app.memwal.com."
+    },
+    "serverUrl": {
+      "label": "MemWal Server URL",
+      "placeholder": "https://relayer.dev.memwal.ai"
+    },
+    "defaultNamespace": {
+      "label": "Default Namespace",
+      "placeholder": "default",
+      "help": "Memory scope for the main agent. Other agents auto-scope by name.",
+      "advanced": true
+    },
+    "autoRecall": {
+      "label": "Auto-Recall",
+      "help": "Inject relevant memories before each turn"
+    },
+    "autoCapture": {
+      "label": "Auto-Capture",
+      "help": "Extract and store facts after each turn"
+    },
+    "maxRecallResults": {
+      "label": "Max Recall Results",
+      "placeholder": "5",
+      "advanced": true
+    },
+    "minRelevance": {
+      "label": "Min Relevance",
+      "placeholder": "0.3",
+      "advanced": true
+    },
+    "captureMaxMessages": {
+      "label": "Capture Window",
+      "placeholder": "10",
+      "advanced": true
+    }
+  }
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@mysten-incubation/oc-memwal",
+  "version": "0.0.1-dev.0",
+  "type": "module",
+  "description": "NemoClaw/OpenClaw memory plugin — encrypted, decentralized long-term memory via MemWal + Walrus",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "openclaw.plugin.json",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@mysten-incubation/memwal": "^0.0.1",
+    "@sinclair/typebox": "0.34.48",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.3.11"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\""
+  }
+}