@hasna/mementos 0.10.12 → 0.10.14

package/dist/mcp/index.js

@@ -10586,6 +10586,74 @@ IDs: ${created.join(", ")}` : ""}`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("memory_briefing", "Lightweight delta briefing: what memories changed since an agent's last session. Use at session start instead of memory_context to avoid re-reading everything.", {
+  agent_id: exports_external.string().optional().describe("Agent ID or name. If provided, defaults since to agent's last_seen_at."),
+  since: exports_external.string().optional().describe("ISO 8601 timestamp. Defaults to agent's last_seen_at if agent_id provided, otherwise 24h ago."),
+  project_id: exports_external.string().optional(),
+  scope: exports_external.enum(["global", "shared", "private"]).optional(),
+  limit: exports_external.coerce.number().optional().describe("Max memories per category (default: 20)")
+}, async (args) => {
+  try {
+    const db = getDatabase();
+    const limit = args.limit || 20;
+    let since = args.since;
+    if (!since && args.agent_id) {
+      const ag = getAgent(args.agent_id);
+      if (ag?.last_seen_at)
+        since = ag.last_seen_at;
+    }
+    if (!since) {
+      since = new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
+    }
+    const scopeClause = args.scope ? `AND scope = ?` : "";
+    const projectClause = args.project_id ? `AND project_id = ?` : "";
+    const extraParams = [
+      ...args.scope ? [args.scope] : [],
+      ...args.project_id ? [args.project_id] : []
+    ];
+    const newMems = db.prepare(`SELECT id, key, value, summary, importance, scope, category, agent_id, created_at
+         FROM memories WHERE status = 'active' AND created_at > ? ${scopeClause} ${projectClause}
+         ORDER BY importance DESC, created_at DESC LIMIT ?`).all(since, ...extraParams, limit);
+    const updatedMems = db.prepare(`SELECT id, key, value, summary, importance, scope, category, agent_id, updated_at
+         FROM memories WHERE status = 'active' AND updated_at > ? AND created_at <= ? ${scopeClause} ${projectClause}
+         ORDER BY importance DESC, updated_at DESC LIMIT ?`).all(since, since, ...extraParams, limit);
+    const expiredMems = db.prepare(`SELECT id, key, scope, category, updated_at, status
+         FROM memories WHERE status != 'active' AND updated_at > ? ${scopeClause} ${projectClause}
+         ORDER BY updated_at DESC LIMIT ?`).all(since, ...extraParams, Math.min(limit, 10));
+    const parts = [`Memory briefing since ${since}`];
+    if (newMems.length > 0) {
+      parts.push(`
+**New (${newMems.length}):**`);
+      for (const m of newMems) {
+        parts.push(`\u2022 [${m.scope}/${m.category}] ${m.key} (importance:${m.importance}${m.agent_id ? `, by:${m.agent_id}` : ""}): ${(m.summary || m.value).slice(0, 100)}`);
+      }
+    }
+    if (updatedMems.length > 0) {
+      parts.push(`
+**Updated (${updatedMems.length}):**`);
+      for (const m of updatedMems) {
+        parts.push(`\u2022 [${m.scope}] ${m.key}: ${(m.summary || m.value).slice(0, 80)}`);
+      }
+    }
+    if (expiredMems.length > 0) {
+      parts.push(`
+**Expired/archived (${expiredMems.length}):**`);
+      for (const m of expiredMems) {
+        parts.push(`\u2022 [${m.scope}] ${m.key} \u2014 ${m.status}`);
+      }
+    }
+    if (newMems.length === 0 && updatedMems.length === 0 && expiredMems.length === 0) {
+      parts.push(`
+No memory changes since last session.`);
+    }
+    parts.push(`
+Summary: ${newMems.length} new, ${updatedMems.length} updated, ${expiredMems.length} expired.`);
+    return { content: [{ type: "text", text: parts.join(`
+`) }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 server.tool("memory_context", "Get memories relevant to current context, filtered by scope/importance/recency.", {
   agent_id: exports_external.string().optional(),
   project_id: exports_external.string().optional(),
@@ -10604,6 +10672,9 @@ server.tool("memory_context", "Get memories relevant to current context, filtere
     if (memories.length === 0) {
       return { content: [{ type: "text", text: "No memories in current context." }] };
     }
+    for (const m of memories) {
+      touchMemory(m.id);
+    }
     const lines = memories.map((m) => `[${m.scope}/${m.category}] ${m.key}: ${m.value} (importance: ${m.importance})`);
     return { content: [{ type: "text", text: lines.join(`
 `) }] };

package/package.json

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