@hasna/mementos 0.4.17 → 0.4.20

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(),
@@ -6357,6 +6408,49 @@ server.tool("memory_stats", "Get aggregate statistics about stored memories", {}
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("memory_activity", "Get daily memory creation activity over N days.", {
+  days: exports_external.coerce.number().optional(),
+  scope: exports_external.enum(["global", "shared", "private"]).optional(),
+  agent_id: exports_external.string().optional(),
+  project_id: exports_external.string().optional()
+}, async (args) => {
+  try {
+    const days = Math.min(args.days || 30, 365);
+    const db = getDatabase();
+    const conditions = ["status = 'active'"];
+    const params = [];
+    if (args.scope) {
+      conditions.push("scope = ?");
+      params.push(args.scope);
+    }
+    if (args.agent_id) {
+      conditions.push("agent_id = ?");
+      params.push(args.agent_id);
+    }
+    if (args.project_id) {
+      conditions.push("project_id = ?");
+      params.push(args.project_id);
+    }
+    const where = conditions.slice(1).map((c) => `AND ${c}`).join(" ");
+    const rows = db.query(`
+        SELECT date(created_at) AS date, COUNT(*) AS memories_created
+        FROM memories
+        WHERE status = 'active' AND date(created_at) >= date('now', '-${days} days') ${where}
+        GROUP BY date(created_at)
+        ORDER BY date ASC
+      `).all(...params);
+    if (rows.length === 0) {
+      return { content: [{ type: "text", text: `No memory activity in last ${days} days.` }] };
+    }
+    const total = rows.reduce((s, r) => s + r.memories_created, 0);
+    const lines = rows.map((r) => `${r.date}: ${r.memories_created} memor${r.memories_created === 1 ? "y" : "ies"}`);
+    return { content: [{ type: "text", text: `Memory activity (last ${days} days \u2014 ${total} total):
+${lines.join(`
+`)}` }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 server.tool("memory_export", "Export memories as JSON", {
   scope: exports_external.enum(["global", "shared", "private"]).optional(),
   category: exports_external.enum(["preference", "fact", "knowledge", "history"]).optional(),
@@ -7040,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",
@@ -7146,6 +7248,17 @@ var FULL_SCHEMAS = {
     },
     example: '{"query":"typescript","scope":"global","limit":10}'
   },
+  memory_activity: {
+    description: "Get daily memory creation counts over N days (max 365). Like 'git log --stat' for memories.",
+    category: "memory",
+    params: {
+      days: { type: "number", description: "Number of days to look back (default 30)" },
+      scope: { type: "string", description: "Filter by scope", enum: ["global", "shared", "private"] },
+      agent_id: { type: "string", description: "Filter by agent" },
+      project_id: { type: "string", description: "Filter by project" }
+    },
+    example: '{"days":14,"project_id":"proj-uuid"}'
+  },
   memory_stats: {
     description: "Aggregate statistics: total, by scope, by category, pinned, expired counts.",
     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;AAulCH,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) {
@@ -2217,6 +2239,43 @@ addRoute("GET", "/api/memories/stats", (_req) => {
     stats.by_agent[row.agent_id] = row.c;
   return json(stats);
 });
+addRoute("GET", "/api/activity", (_req, url) => {
+  const q = getSearchParams(url);
+  const days = Math.min(parseInt(q["days"] || "30", 10), 365);
+  const scope = q["scope"];
+  const agentId = q["agent_id"];
+  const projectId = q["project_id"];
+  const db = getDatabase();
+  const conditions = ["status = 'active'"];
+  const params = [];
+  if (scope) {
+    conditions.push("scope = ?");
+    params.push(scope);
+  }
+  if (agentId) {
+    conditions.push("agent_id = ?");
+    params.push(agentId);
+  }
+  if (projectId) {
+    conditions.push("project_id = ?");
+    params.push(projectId);
+  }
+  const where = conditions.map((c) => `AND ${c}`).join(" ");
+  const rows = db.query(`
+    SELECT
+      date(created_at) AS date,
+      COUNT(*) AS memories_created,
+      SUM(CASE WHEN scope = 'global' THEN 1 ELSE 0 END) AS global_count,
+      SUM(CASE WHEN scope = 'shared' THEN 1 ELSE 0 END) AS shared_count,
+      SUM(CASE WHEN scope = 'private' THEN 1 ELSE 0 END) AS private_count,
+      AVG(importance) AS avg_importance
+    FROM memories
+    WHERE date(created_at) >= date('now', '-${days} days') ${where}
+    GROUP BY date(created_at)
+    ORDER BY date ASC
+  `).all(...params);
+  return json({ activity: rows, days, total: rows.reduce((s, r) => s + r.memories_created, 0) });
+});
 addRoute("POST", "/api/memories/search", async (req) => {
   const body = await readJson(req);
   if (!body || typeof body["query"] !== "string") {
@@ -2441,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.17",
+  "version": "0.4.20",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",