@hasna/mementos 0.4.17 → 0.4.19

package/dist/mcp/index.js

@@ -6357,6 +6357,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(),
@@ -7146,6 +7189,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;AAynCH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkH9C"}

package/dist/server/index.js

@@ -2217,6 +2217,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") {

package/package.json

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