neo4j-agent-memory 0.3.17 → 0.3.19

package/dist/cypher/feedback_batch.cypher

@@ -1,7 +1,34 @@
+// :param {
+//   nowIso: "2026-01-04T22:07:53.086Z",
+//   agentId: "agent-123",
+//   halfLifeSeconds: 86400,
+//   aMin: 1.0,
+//   bMin: 1.0,
+//   w: 1.0,
+//   y: 1.0,
+//   items: [
+//     "mem_8cd773c2-208c-45ad-97ea-1b2337dca751",
+//     "mem_64fbcc73-0b5c-4041-8b6b-66514ffaf1d0",
+//     "mem_e55b80e2-6156-47bc-a964-9aef596f74a6",
+//     "mem_13189119-e3ad-4769-9f2b-2d3e3b8bc07f",
+//     "mem_137c3ff7-a81d-453d-8048-5c1b736db6ca",
+//     "mem_c0ea5643-3c61-4607-ba9f-67f4c2bb01ee",
+//     "mem_aa15e7b6-7f94-445a-9c52-3eb24a315215",
+//     "mem_e93e7bb8-b43c-44f5-a5d3-87545d67be59",
+//     "mem_b81e3709-35ae-4cab-931d-612dcc2cd43d",
+//     "mem_ce8a5b62-7ddb-4618-8a6c-93ed3b425f27",
+//     "mem_737df25b-7944-4dee-a7aa-86af93567663"
+//   ]
+// }
 WITH datetime($nowIso) AS now
-UNWIND $items AS item
+
+UNWIND $items AS memoryId
+WITH now, memoryId
+WHERE memoryId IS NOT NULL AND memoryId <> ""
+
 MATCH (a:Agent {id: $agentId})
-MATCH (m:Memory {id: item.memoryId})
+MATCH (m:Memory {id: memoryId})
+
 MERGE (a)-[r:RECALLS]->(m)
 ON CREATE SET
   r.a = 1.0,
@@ -11,32 +38,33 @@ ON CREATE SET
   r.successes = 0,
   r.failures = 0
 
-WITH now, r, item,
-     // elapsed seconds, safe
-     CASE WHEN duration.inSeconds(coalesce(r.updatedAt, now), now).seconds > 0
-          THEN duration.inSeconds(coalesce(r.updatedAt, now), now).seconds
-          ELSE 0 END AS dt
+WITH now, r,
+     CASE
+       WHEN duration.inSeconds(coalesce(r.updatedAt, now), now).seconds > 0
+       THEN duration.inSeconds(coalesce(r.updatedAt, now), now).seconds
+       ELSE 0
+     END AS dt
 
-WITH now, r, item,
+WITH now, r,
      0.5 ^ (dt / $halfLifeSeconds) AS gamma,
-     coalesce(r.a, CASE WHEN $aMin > coalesce(r.strength, 0.5) * 2.0 THEN $aMin ELSE coalesce(r.strength, 0.5) * 2.0 END) AS aPrev,
-     coalesce(r.b, CASE WHEN $bMin > (1.0 - coalesce(r.strength, 0.5)) * 2.0 THEN $bMin ELSE (1.0 - coalesce(r.strength, 0.5)) * 2.0 END) AS bPrev
+     coalesce(r.a, $aMin) AS aPrev,
+     coalesce(r.b, $bMin) AS bPrev
 
-WITH now, r, item, gamma,
+WITH now, r, gamma,
      ($aMin + gamma * (aPrev - $aMin)) AS a0,
      ($bMin + gamma * (bPrev - $bMin)) AS b0
 
-WITH now, r, item,
-     (a0 + item.w * item.y) AS a1,
-     (b0 + item.w * (1.0 - item.y)) AS b1
+WITH now, r,
+     (a0 + $w * $y) AS a1,
+     (b0 + $w * (1.0 - $y)) AS b1
 
 SET r.a = a1,
     r.b = b1,
     r.strength = a1 / (a1 + b1),
     r.evidence = a1 + b1,
     r.updatedAt = now,
-    r.uses = coalesce(r.uses,0) + 1,
-    r.successes = coalesce(r.successes,0) + CASE WHEN item.y >= 0.5 THEN 1 ELSE 0 END,
-    r.failures = coalesce(r.failures,0) + CASE WHEN item.y < 0.5 THEN 1 ELSE 0 END
+    r.uses = coalesce(r.uses, 0) + 1,
+    r.successes = coalesce(r.successes, 0) + CASE WHEN $y >= 0.5 THEN 1 ELSE 0 END,
+    r.failures = coalesce(r.failures, 0) + CASE WHEN $y < 0.5 THEN 1 ELSE 0 END
 
 RETURN count(*) AS updated;

package/dist/cypher/list_memories.cypher

@@ -1,28 +1,36 @@
-// Parameters:
+// Parameters (Neo4j Browser :param)
+// :param { kind: null, limit: 50, agentId: "" }
+
 // - $kind: Optional memory kind filter ("semantic" | "procedural" | "episodic")
 // - $limit: Max number of memories to return
 // - $agentId: Optional agent id to filter by RECALLS edges
+
 WITH
-  $kind AS kind,
+  coalesce($kind, null) AS kind,
   coalesce($limit, 50) AS limit,
-  $agentId AS agentId
+  coalesce($agentId, "") AS agentId
 
-CALL {
-  WITH kind, agentId
+CALL (kind, agentId) {
+  // If agentId provided -> only recalled by that agent
   WITH kind, agentId
   WHERE agentId IS NOT NULL AND agentId <> ""
   MATCH (:Agent {id: agentId})-[:RECALLS]->(m:Memory)
   WHERE kind IS NULL OR m.kind = kind
   RETURN m
+
   UNION
+
+  // If agentId absent -> all memories
   WITH kind, agentId
   WHERE agentId IS NULL OR agentId = ""
   MATCH (m:Memory)
   WHERE kind IS NULL OR m.kind = kind
   RETURN m
 }
-WITH m
+
+WITH m, limit
 ORDER BY m.updatedAt DESC
+
 WITH collect(
   m {
     .id,
@@ -36,4 +44,5 @@ WITH collect(
     .updatedAt
   }
 ) AS rows, limit
+
 RETURN rows[0..limit] AS memories;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neo4j-agent-memory",
-  "version": "0.3.17",
+  "version": "0.3.19",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",