@hasna/mementos 0.10.18 → 0.10.19

package/dist/mcp/index.js

@@ -9937,6 +9937,62 @@ server.tool("memory_health", "Comprehensive health check for memories. Detects:
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("memory_diff", "Show what changed between two versions of a memory. Compares value, importance, scope. Omit v1/v2 to diff the two most recent versions.", {
+  id: exports_external.string().optional().describe("Memory ID or partial ID"),
+  key: exports_external.string().optional().describe("Memory key (alternative to id)"),
+  v1: exports_external.coerce.number().optional().describe("First version number (default: second-to-last)"),
+  v2: exports_external.coerce.number().optional().describe("Second version number (default: current/latest)")
+}, async (args) => {
+  try {
+    let memId;
+    if (args.id) {
+      memId = resolvePartialId(getDatabase(), "memories", args.id) ?? args.id;
+    } else if (args.key) {
+      const row = getDatabase().query("SELECT id FROM memories WHERE key = ? LIMIT 1").get(args.key);
+      memId = row?.id;
+    }
+    if (!memId)
+      return { content: [{ type: "text", text: `Memory not found: ${args.id || args.key}` }], isError: true };
+    const memory = getMemory(memId);
+    if (!memory)
+      return { content: [{ type: "text", text: `Memory not found: ${memId}` }], isError: true };
+    const versions = getMemoryVersions(memId);
+    const allVersions = [
+      ...versions,
+      { version: memory.version, value: memory.value, importance: memory.importance, scope: memory.scope, created_at: memory.updated_at, summary: memory.summary }
+    ].sort((a, b) => a.version - b.version);
+    if (allVersions.length < 2) {
+      return { content: [{ type: "text", text: `Only 1 version exists for "${memory.key}". No diff available.` }] };
+    }
+    const v1Num = args.v1 ?? allVersions[allVersions.length - 2]?.version ?? 1;
+    const v2Num = args.v2 ?? allVersions[allVersions.length - 1]?.version ?? memory.version;
+    const ver1 = allVersions.find((v) => v.version === v1Num);
+    const ver2 = allVersions.find((v) => v.version === v2Num);
+    if (!ver1 || !ver2) {
+      return { content: [{ type: "text", text: `Versions not found: v${v1Num}, v${v2Num}. Available: ${allVersions.map((v) => `v${v.version}`).join(", ")}` }], isError: true };
+    }
+    const parts = [`Diff for "${memory.key}" (v${v1Num} \u2192 v${v2Num})`];
+    parts.push(`Time: ${ver1.created_at?.slice(0, 16)} \u2192 ${ver2.created_at?.slice(0, 16)}`);
+    if (ver1.value !== ver2.value) {
+      parts.push(`
+--- v${v1Num} value ---`);
+      parts.push(ver1.value.slice(0, 500) + (ver1.value.length > 500 ? "..." : ""));
+      parts.push(`
++++ v${v2Num} value +++`);
+      parts.push(ver2.value.slice(0, 500) + (ver2.value.length > 500 ? "..." : ""));
+    } else {
+      parts.push("value: unchanged");
+    }
+    if (ver1.importance !== ver2.importance)
+      parts.push(`importance: ${ver1.importance} \u2192 ${ver2.importance}`);
+    if (ver1.scope !== ver2.scope)
+      parts.push(`scope: ${ver1.scope} \u2192 ${ver2.scope}`);
+    return { content: [{ type: "text", text: parts.join(`
+`) }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 server.tool("memory_search", "Search memories by keyword across key, value, summary, and tags", {
   query: exports_external.string(),
   scope: exports_external.enum(["global", "shared", "private"]).optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.10.18",
+  "version": "0.10.19",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",