@hasna/mementos 0.10.5 → 0.10.8

package/dist/db/locks.d.ts

@@ -48,5 +48,16 @@ export declare function listAgentLocks(agentId: string, db?: Database): Resource
 /**
  * Delete all expired locks. Called automatically by other lock functions.
  */
+export interface ExpiredLockInfo {
+    id: string;
+    resource_type: string;
+    resource_id: string;
+    agent_id: string;
+    lock_type: string;
+}
+/**
+ * Clean expired locks and return info about what was cleaned for notification purposes.
+ */
+export declare function cleanExpiredLocksWithInfo(db?: Database): ExpiredLockInfo[];
 export declare function cleanExpiredLocks(db?: Database): number;
 //# sourceMappingURL=locks.d.ts.map

package/dist/db/locks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../src/db/locks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAC5F,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,QAAsB,EAChC,UAAU,SAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAuDrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAOnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAI3E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,EAAE,CAgBhB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAcrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,YAAY,EAAE,CAS7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAIvD"}
+{"version":3,"file":"locks.d.ts","sourceRoot":"","sources":["../../src/db/locks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAC5F,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,YAAY,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,QAAsB,EAChC,UAAU,SAAM,EAChB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAuDrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAOnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,QAAQ,GACZ,MAAM,CAOR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAI3E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,EAAE,CAgBhB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,QAAQ,EACnB,EAAE,CAAC,EAAE,QAAQ,GACZ,YAAY,GAAG,IAAI,CAcrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,YAAY,EAAE,CAS7E;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,eAAe,EAAE,CAS1E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAIvD"}

package/dist/mcp/index.js

@@ -3257,6 +3257,40 @@ var init_built_in_hooks = __esm(() => {
   });
 });
 
+// src/mcp/memory-broadcast.ts
+var exports_memory_broadcast = {};
+__export(exports_memory_broadcast, {
+  broadcastSharedMemory: () => broadcastSharedMemory
+});
+async function broadcastSharedMemory(memory, savingAgentId) {
+  if (!memory.project_id)
+    return;
+  try {
+    const listRes = await fetch(`${CONVERSATIONS_API}/api/v1/agents?active=true&project_id=${memory.project_id}`, {
+      signal: AbortSignal.timeout(3000)
+    });
+    if (!listRes.ok)
+      return;
+    const { agents } = await listRes.json();
+    if (!agents?.length)
+      return;
+    const otherAgents = agents.filter((a) => a.id !== savingAgentId);
+    if (!otherAgents.length)
+      return;
+    const notification = `[Memory Update] Agent ${savingAgentId} saved shared memory: "${memory.key}" \u2014 ${memory.summary || memory.value.slice(0, 100)}. Consider recalling this memory if relevant to your current task.`;
+    await Promise.all(otherAgents.map((agent) => fetch(`${CONVERSATIONS_API}/api/v1/messages`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ from: savingAgentId, to: agent.id, content: notification }),
+      signal: AbortSignal.timeout(3000)
+    }).catch(() => {})));
+  } catch {}
+}
+var CONVERSATIONS_API;
+var init_memory_broadcast = __esm(() => {
+  CONVERSATIONS_API = process.env.CONVERSATIONS_API_URL || "http://localhost:7020";
+});
+
 // src/mcp/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -7483,6 +7517,14 @@ function listAgentLocks(agentId, db) {
   const rows = d.query("SELECT * FROM resource_locks WHERE agent_id = ? AND expires_at > datetime('now') ORDER BY locked_at DESC").all(agentId);
   return rows.map(parseLockRow);
 }
+function cleanExpiredLocksWithInfo(db) {
+  const d = db || getDatabase();
+  const expired = d.query("SELECT id, resource_type, resource_id, agent_id, lock_type FROM resource_locks WHERE expires_at <= datetime('now')").all();
+  if (expired.length > 0) {
+    d.run("DELETE FROM resource_locks WHERE expires_at <= datetime('now')");
+  }
+  return expired;
+}
 function cleanExpiredLocks(db) {
   const d = db || getDatabase();
   const result = d.run("DELETE FROM resource_locks WHERE expires_at <= datetime('now')");
@@ -9160,6 +9202,12 @@ server.tool("memory_save", "Save/upsert a memory. scope: global=all agents, shar
     const memory = createMemory(input);
     if (args.agent_id)
       touchAgent(args.agent_id);
+    if (memory.scope === "shared" && memory.project_id && args.agent_id) {
+      try {
+        const { broadcastSharedMemory: broadcastSharedMemory2 } = await Promise.resolve().then(() => (init_memory_broadcast(), exports_memory_broadcast));
+        broadcastSharedMemory2(memory, args.agent_id).catch(() => {});
+      } catch {}
+    }
     return { content: [{ type: "text", text: `Saved: ${memory.key} (${memory.id.slice(0, 8)})` }] };
   } catch (e) {
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
@@ -11144,9 +11192,22 @@ server.tool("list_agent_locks", "List all active resource locks held by an agent
     content: [{ type: "text", text: locks.length === 0 ? "No active locks." : JSON.stringify(locks, null, 2) }]
   };
 });
-server.tool("clean_expired_locks", "Delete all expired resource locks.", {}, async () => {
-  const count = cleanExpiredLocks();
-  return { content: [{ type: "text", text: `Cleaned ${count} expired lock(s).` }] };
+server.tool("clean_expired_locks", "Delete all expired resource locks. Notifies holding agents via conversations DM.", {}, async () => {
+  const expired = cleanExpiredLocksWithInfo();
+  const count = expired.length;
+  if (count > 0) {
+    const conversationsUrl = process.env.CONVERSATIONS_API_URL || "http://localhost:7020";
+    for (const lock of expired) {
+      const msg = `Your ${lock.lock_type} lock on ${lock.resource_type}/${lock.resource_id} has expired. Another agent may now acquire it.`;
+      fetch(`${conversationsUrl}/api/v1/messages`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ from: "system", to: lock.agent_id, content: msg }),
+        signal: AbortSignal.timeout(2000)
+      }).catch(() => {});
+    }
+  }
+  return { content: [{ type: "text", text: `Cleaned ${count} expired lock(s)${count > 0 ? ` and notified ${count} agent(s)` : ""}.` }] };
 });
 server.tool("set_focus", "Set focus for an agent on a project. Memory ops will auto-scope to that project's shared + agent private + global memories.", {
   agent_id: exports_external.string(),

package/dist/mcp/memory-broadcast.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Memory broadcast utility — notifies active agents when shared memories are saved.
+ * Uses the conversations MCP service if available.
+ * Non-blocking: failures are silently ignored.
+ */
+import type { Memory } from '../types/index.js';
+/**
+ * Broadcast a newly saved shared memory to all active agents on the project
+ * via the conversations MCP send_message endpoint.
+ */
+export declare function broadcastSharedMemory(memory: Memory, savingAgentId: string): Promise<void>;
+//# sourceMappingURL=memory-broadcast.d.ts.map

package/dist/mcp/memory-broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-broadcast.d.ts","sourceRoot":"","sources":["../../src/mcp/memory-broadcast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAIhD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhG"}

package/package.json

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