mr-memory 2.18.4 → 2.20.0

package/index.ts

@@ -872,6 +872,80 @@ const memoryRouterPlugin = {
             await runUpload({ memoryKey, endpoint, targetPath, stateDir, workspacePath, hasWorkspaceFlag: !!opts.workspace, hasBrainFlag: !!opts.brain, embeddings });
           });
 
+        mr.command("search")
+          .description("Search memories in vault")
+          .argument("<query>", "Search query")
+          .option("-n, --limit <number>", "Number of results", "5")
+          .option("--json", "Output raw JSON response")
+          .action(async (query: string, opts: { limit: string; json?: boolean }) => {
+            if (!memoryKey) { console.error("Not configured. Run: openclaw mr <key>"); return; }
+            const limit = parseInt(opts.limit, 10) || 5;
+            try {
+              const res = await fetch(`${endpoint}/v1/memory/search`, {
+                method: "POST",
+                headers: {
+                  Authorization: `Bearer ${memoryKey}`,
+                  "Content-Type": "application/json",
+                },
+                body: JSON.stringify({ query, limit }),
+              });
+              if (!res.ok) {
+                const err = await res.json() as { error?: string };
+                console.error(`Search failed: ${err.error || `HTTP ${res.status}`}`);
+                return;
+              }
+              const data = await res.json() as {
+                query: string;
+                sessionId: string | null;
+                memoryKey: string;
+                totalMemories: number;
+                tokenCount: number;
+                windowBreakdown: Record<string, number>;
+                metrics: Record<string, number>;
+                memories: Array<{
+                  id: number;
+                  content: string;
+                  score: number;
+                  window: string;
+                  timestampHuman: string;
+                  timestamp: number;
+                  role: string;
+                  source: string;
+                }>;
+              };
+
+              // Raw JSON output
+              if (opts.json) {
+                console.log(JSON.stringify(data, null, 2));
+                return;
+              }
+
+              if (data.totalMemories === 0) {
+                console.log("No results found.");
+                return;
+              }
+              const modelLabel = embeddings ? ` (${embeddings})` : " (bge)";
+              console.log(`\n🔍 ${data.totalMemories} results for "${query}"${modelLabel}\n`);
+              for (let i = 0; i < data.memories.length; i++) {
+                const m = data.memories[i];
+                const score = (m.score * 100).toFixed(1);
+                const date = new Date(m.timestampHuman).toLocaleDateString("en-US", {
+                  month: "short", day: "numeric", year: "numeric",
+                });
+                const windowIcon = m.window === "immediate" ? "⚡" : m.window === "short" ? "🔥" : m.window === "long" ? "🧠" : "📚";
+                console.log(`  ${i + 1}. ${windowIcon} ${score}% | ${m.role} | ${date} | id:${m.id}`);
+                console.log(`     ${m.content}\n`);
+              }
+              console.log(`  Tokens: ${data.tokenCount} | Windows: ${JSON.stringify(data.windowBreakdown)}`);
+              if (data.metrics) {
+                const ms = data.metrics;
+                console.log(`  Latency: ${ms.raceMs ?? ms.totalMs ?? '-'}ms`);
+              }
+            } catch (err) {
+              console.error(`Failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+          });
+
         mr.command("delete")
           .description("Clear all memories from vault")
           .action(async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mr-memory",
-  "version": "2.18.4",
+  "version": "2.20.0",
   "description": "MemoryRouter persistent memory plugin for OpenClaw — your AI remembers every conversation",
   "type": "module",
   "files": [