@hasna/mementos 0.10.16 → 0.10.17

package/dist/mcp/index.js

@@ -10820,11 +10820,13 @@ Summary: ${newMems.length} new, ${updatedMems.length} updated, ${expiredMems.len
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
-server.tool("memory_context", "Get memories relevant to current context, filtered by scope/importance/recency.", {
+server.tool("memory_context", "Get memories relevant to current context. Uses time-weighted scoring: score = importance \xD7 decay(age). Pinned memories are exempt. Returns effective_score on each memory.", {
   agent_id: exports_external.string().optional(),
   project_id: exports_external.string().optional(),
   scope: exports_external.enum(["global", "shared", "private"]).optional(),
-  limit: exports_external.coerce.number().optional()
+  limit: exports_external.coerce.number().optional(),
+  decay_halflife_days: exports_external.coerce.number().optional().describe("Importance half-life in days (default: 90). Lower = more weight on recent memories."),
+  no_decay: exports_external.coerce.boolean().optional().describe("Set true to disable decay and sort purely by importance.")
 }, async (args) => {
   try {
     const filter = {
@@ -10832,16 +10834,31 @@ server.tool("memory_context", "Get memories relevant to current context, filtere
       agent_id: args.agent_id,
       project_id: args.project_id,
       status: "active",
-      limit: args.limit || 30
+      limit: (args.limit || 30) * 2
     };
     const memories = listMemories(filter);
     if (memories.length === 0) {
       return { content: [{ type: "text", text: "No memories in current context." }] };
     }
-    for (const m of memories) {
+    const halflifeDays = args.decay_halflife_days ?? 90;
+    const now2 = Date.now();
+    const scored = memories.map((m) => {
+      let effectiveScore = m.importance;
+      if (!args.no_decay && !m.pinned) {
+        const ageMs = now2 - new Date(m.updated_at).getTime();
+        const ageDays = ageMs / (1000 * 60 * 60 * 24);
+        const decayFactor = Math.pow(0.5, ageDays / halflifeDays);
+        effectiveScore = m.importance * decayFactor;
+      }
+      return { ...m, effective_score: Math.round(effectiveScore * 100) / 100 };
+    });
+    const limit = args.limit || 30;
+    scored.sort((a, b) => b.effective_score - a.effective_score);
+    const top = scored.slice(0, limit);
+    for (const m of top) {
       touchMemory(m.id);
     }
-    const lines = memories.map((m) => `[${m.scope}/${m.category}] ${m.key}: ${m.value} (importance: ${m.importance})`);
+    const lines = top.map((m) => `[${m.scope}/${m.category}] ${m.key}: ${m.value} (score: ${m.effective_score}, raw: ${m.importance}${m.pinned ? ", pinned" : ""})`);
     return { content: [{ type: "text", text: lines.join(`
 `) }] };
   } catch (e) {

package/package.json

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