@hasna/mementos 0.4.31 → 0.4.33

package/dist/mcp/index.js

@@ -6368,6 +6368,42 @@ server.tool("memory_forget", "Delete a memory by ID or key", {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("memory_stale", "Find memories not accessed recently. Useful for cleanup or review.", {
+  days: exports_external.coerce.number().optional(),
+  project_id: exports_external.string().optional(),
+  agent_id: exports_external.string().optional(),
+  limit: exports_external.coerce.number().optional()
+}, async (args) => {
+  try {
+    const days = args.days || 30;
+    const db = getDatabase();
+    const conditions = [
+      "status = 'active'",
+      `(accessed_at IS NULL OR accessed_at < datetime('now', '-${days} days'))`,
+      "pinned = 0"
+    ];
+    const params = [];
+    if (args.project_id) {
+      conditions.push("project_id = ?");
+      params.push(args.project_id);
+    }
+    if (args.agent_id) {
+      conditions.push("agent_id = ?");
+      params.push(args.agent_id);
+    }
+    const limit = args.limit || 20;
+    const rows = db.query(`SELECT id, key, value, importance, scope, category, accessed_at, access_count FROM memories WHERE ${conditions.join(" AND ")} ORDER BY COALESCE(accessed_at, created_at) ASC LIMIT ?`).all(...params, limit);
+    if (rows.length === 0) {
+      return { content: [{ type: "text", text: `No stale memories found (last accessed > ${days} days ago).` }] };
+    }
+    const lines = rows.map((m) => `[${m.importance}] ${m.key} (${m.scope}/${m.category}) \u2014 last accessed: ${m.accessed_at?.slice(0, 10) || "never"}, ${m.access_count} reads`);
+    return { content: [{ type: "text", text: `${rows.length} stale memor${rows.length === 1 ? "y" : "ies"} (not accessed in ${days}+ days):
+${lines.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(),
@@ -6375,6 +6411,7 @@ server.tool("memory_search", "Search memories by keyword across key, value, summ
   tags: exports_external.array(exports_external.string()).optional(),
   agent_id: exports_external.string().optional(),
   project_id: exports_external.string().optional(),
+  session_id: exports_external.string().optional(),
   limit: exports_external.coerce.number().optional()
 }, async (args) => {
   try {
@@ -6384,6 +6421,7 @@ server.tool("memory_search", "Search memories by keyword across key, value, summ
       tags: args.tags,
       agent_id: args.agent_id,
       project_id: args.project_id,
+      session_id: args.session_id,
       search: args.query,
       limit: args.limit || 20
     };
@@ -7349,6 +7387,17 @@ var FULL_SCHEMAS = {
     },
     example: '{"key":"old-preference","scope":"global"}'
   },
+  memory_stale: {
+    description: "Find memories not accessed recently \u2014 useful for cleanup review (same pattern as get_stale_tasks in todos).",
+    category: "memory",
+    params: {
+      days: { type: "number", description: "Stale threshold in days (default 30)" },
+      project_id: { type: "string", description: "Filter by project" },
+      agent_id: { type: "string", description: "Filter by agent" },
+      limit: { type: "number", description: "Max results (default 20)" }
+    },
+    example: '{"days":14,"project_id":"proj-uuid"}'
+  },
   memory_search: {
     description: "Full-text search across key, value, summary, and tags.",
     category: "memory",
@@ -7359,6 +7408,7 @@ var FULL_SCHEMAS = {
       tags: { type: "array", description: "Tag filter", items: { type: "string" } },
       agent_id: { type: "string", description: "Agent UUID filter" },
       project_id: { type: "string", description: "Project UUID filter" },
+      session_id: { type: "string", description: "Session ID filter" },
       limit: { type: "number", description: "Max results (default 20)" }
     },
     example: '{"query":"typescript","scope":"global","limit":10}'

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;AA2qCH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA6H9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAosCH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA6H9C"}

package/dist/server/index.js

@@ -2293,6 +2293,30 @@ addRoute("GET", "/api/activity", (_req, url) => {
   `).all(...params);
   return json({ activity: rows, days, total: rows.reduce((s, r) => s + r.memories_created, 0) });
 });
+addRoute("GET", "/api/memories/stale", (_req, url) => {
+  const q = getSearchParams(url);
+  const days = Math.min(parseInt(q["days"] || "30", 10), 365);
+  const projectId = q["project_id"];
+  const agentId = q["agent_id"];
+  const limit = Math.min(parseInt(q["limit"] || "20", 10), 100);
+  const db = getDatabase();
+  const conds = [
+    "status = 'active'",
+    `(accessed_at IS NULL OR accessed_at < datetime('now', '-${days} days'))`,
+    "pinned = 0"
+  ];
+  const params = [];
+  if (projectId) {
+    conds.push("project_id = ?");
+    params.push(projectId);
+  }
+  if (agentId) {
+    conds.push("agent_id = ?");
+    params.push(agentId);
+  }
+  const rows = db.query(`SELECT id, key, value, importance, scope, category, accessed_at, access_count, created_at FROM memories WHERE ${conds.join(" AND ")} ORDER BY COALESCE(accessed_at, created_at) ASC LIMIT ?`).all(...params, limit);
+  return json({ memories: rows, count: rows.length, days });
+});
 addRoute("GET", "/api/report", (_req, url) => {
   const q = getSearchParams(url);
   const days = Math.min(parseInt(q["days"] || "7", 10), 365);

package/package.json

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