@hasna/mementos 0.4.19 → 0.4.21

package/dist/mcp/index.js

@@ -5376,6 +5376,28 @@ function cleanExpiredMemories(db) {
   }
   return count;
 }
+function getMemoryVersions(memoryId, db) {
+  const d = db || getDatabase();
+  try {
+    const rows = d.query("SELECT * FROM memory_versions WHERE memory_id = ? ORDER BY version ASC").all(memoryId);
+    return rows.map((row) => ({
+      id: row["id"],
+      memory_id: row["memory_id"],
+      version: row["version"],
+      value: row["value"],
+      importance: row["importance"],
+      scope: row["scope"],
+      category: row["category"],
+      tags: JSON.parse(row["tags"] || "[]"),
+      summary: row["summary"] || null,
+      pinned: !!row["pinned"],
+      status: row["status"],
+      created_at: row["created_at"]
+    }));
+  } catch {
+    return [];
+  }
+}
 
 // src/lib/search.ts
 function parseMemoryRow2(row) {
@@ -6144,6 +6166,35 @@ server.tool("memory_get", "Get a single memory by ID.", {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("memory_versions", "Get version history for a memory. Shows what changed across updates.", {
+  id: exports_external.string()
+}, async (args) => {
+  try {
+    const id = resolveId(args.id);
+    const memory = getMemory(id);
+    if (!memory) {
+      return { content: [{ type: "text", text: `Memory not found: ${args.id}` }] };
+    }
+    const versions = getMemoryVersions(id);
+    if (versions.length === 0) {
+      return { content: [{ type: "text", text: `No version history for "${memory.key}" (current: v${memory.version})` }] };
+    }
+    const lines = versions.map((v) => `v${v.version} [${v.created_at.slice(0, 16)}] scope=${v.scope} importance=${v.importance} status=${v.status}
+  value: ${v.value.slice(0, 120)}${v.value.length > 120 ? "..." : ""}`);
+    return {
+      content: [{
+        type: "text",
+        text: `Version history for "${memory.key}" (${versions.length} version${versions.length === 1 ? "" : "s"}, current: v${memory.version}):
+
+${lines.join(`
+
+`)}`
+      }]
+    };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 server.tool("memory_list", "List memories. Default: compact lines. full=true for complete JSON objects.", {
   scope: exports_external.enum(["global", "shared", "private"]).optional(),
   category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional(),
@@ -7083,6 +7134,14 @@ var FULL_SCHEMAS = {
     },
     example: '{"key":"preferred-language","value":"TypeScript","scope":"global","importance":8,"tags":["language","preference"]}'
   },
+  memory_versions: {
+    description: "Get full version history for a memory \u2014 all past values, scopes, importance scores.",
+    category: "memory",
+    params: {
+      id: { type: "string", description: "Memory ID (partial OK)", required: true }
+    },
+    example: '{"id":"abc12345"}'
+  },
   memory_get: {
     description: "Get a single memory by ID (partial IDs resolved).",
     category: "memory",

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAynCH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkH9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAkoCH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkH9C"}

package/dist/server/index.js

@@ -1456,6 +1456,28 @@ function cleanExpiredMemories(db) {
   }
   return count;
 }
+function getMemoryVersions(memoryId, db) {
+  const d = db || getDatabase();
+  try {
+    const rows = d.query("SELECT * FROM memory_versions WHERE memory_id = ? ORDER BY version ASC").all(memoryId);
+    return rows.map((row) => ({
+      id: row["id"],
+      memory_id: row["memory_id"],
+      version: row["version"],
+      value: row["value"],
+      importance: row["importance"],
+      scope: row["scope"],
+      category: row["category"],
+      tags: JSON.parse(row["tags"] || "[]"),
+      summary: row["summary"] || null,
+      pinned: !!row["pinned"],
+      status: row["status"],
+      created_at: row["created_at"]
+    }));
+  } catch {
+    return [];
+  }
+}
 
 // src/lib/search.ts
 function parseMemoryRow2(row) {
@@ -2478,6 +2500,13 @@ addRoute("PATCH", "/api/memories/:id", async (req, _url, params) => {
     throw e;
   }
 });
+addRoute("GET", "/api/memories/:id/versions", (_req, _url, params) => {
+  const memory = getMemory(params["id"]);
+  if (!memory)
+    return errorResponse("Memory not found", 404);
+  const versions = getMemoryVersions(memory.id);
+  return json({ versions, count: versions.length, current_version: memory.version });
+});
 addRoute("DELETE", "/api/memories/:id", (_req, _url, params) => {
   const deleted = deleteMemory(params["id"]);
   if (!deleted) {

package/package.json

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