cozo-memory 1.2.11 → 1.2.13

package/README.md

@@ -473,7 +473,7 @@ Built with:
 
 Research foundations:
 - GraphRAG-R1 (Yu et al., WWW 2026) - conceptual inspiration for adaptive retrieval
-- HopRAG (ACL 2025)
-- T-GRAG (Li et al., 2025)
+- HopRAG (ACL 2025) - conceptual inspiration for multi-hop reasoning
+- T-GRAG (Li et al., 2025) - conceptual inspiration for temporal conflict resolution
 - FEEG Framework (Samuel et al., 2026) - conceptual inspiration for query intent classification
-- Allan-Poe (arXiv:2511.00855)
+- Allan-Poe (arXiv:2511.00855) - conceptual inspiration for dynamic fusion

package/dist/index.js

@@ -3415,7 +3415,11 @@ Format MUST start with "ExecutiveSummary: " followed by the consolidated content
             const incTl = args.include_timeline === true;
             const entRes = await this.db.run(`?[name, type, metadata, ts] := *entity{id: $id, name, type, metadata, created_at, @ "NOW"}, ts = to_int(created_at)`, { id: args.entity_id });
             if (entRes.rows.length === 0)
-                return { error: "Entity not found" };
+                return {
+                    error: "Entity not found",
+                    entity_id: args.entity_id,
+                    hint: "Make sure you are passing an entity ID (not an observation ID or relation ID). Use 'list_entities' or 'search' to find valid entity IDs.",
+                };
             const e = entRes.rows[0];
             const metadata = (e[2] || {});
             const created_at_us = e[3];
@@ -3562,12 +3566,13 @@ Format MUST start with "ExecutiveSummary: " followed by the consolidated content
             targetIds = [...new Set(targetIds)];
             let deleted_observations = 0;
             let deleted_relations = 0;
-            const deleted_entities = [];
+            const deleted = [];
+            const not_found = [];
             const errors = [];
             for (const id of targetIds) {
                 const exists = await this.db.run('?[name] := *entity{id: $id, name, @ "NOW"}', { id });
                 if (exists.rows.length === 0) {
-                    errors.push({ id, error: "Entity not found" });
+                    not_found.push(id);
                     continue;
                 }
                 if (dryRun) {
@@ -3576,26 +3581,28 @@ Format MUST start with "ExecutiveSummary: " followed by the consolidated content
                     const relInC = await this.db.run('?[count(f)] := *relationship{from_id: f, to_id: $id, @ "NOW"}', { id });
                     deleted_observations += Number(obsC.rows[0]?.[0] || 0);
                     deleted_relations += Number(relOutC.rows[0]?.[0] || 0) + Number(relInC.rows[0]?.[0] || 0);
-                    deleted_entities.push(id);
+                    deleted.push(id);
                 }
                 else {
                     const res = await this.deleteEntity({ entity_id: id });
                     if (res.error) {
-                        errors.push({ id, error: res.message || res.error });
+                        errors.push(`${id}: ${res.message || res.error}`);
                         continue;
                     }
                     deleted_observations += Number(res.deleted?.observations || 0);
                     deleted_relations += Number(res.deleted?.outgoing_relations || 0) + Number(res.deleted?.incoming_relations || 0);
-                    deleted_entities.push(id);
+                    deleted.push(id);
                 }
             }
             return {
                 status: dryRun ? "dry_run" : "deleted",
-                deleted_count: deleted_entities.length,
-                deleted_entities,
+                deleted_count: deleted.length,
+                deleted,
+                not_found,
+                errors,
+                deleted_entities: deleted,
                 deleted_observations,
                 deleted_relations,
-                ...(errors.length ? { errors } : {}),
             };
         }
         catch (error) {
@@ -4093,6 +4100,22 @@ Format MUST start with "ExecutiveSummary: " followed by the consolidated content
             continue_on_error: zod_1.z.boolean().optional().describe("For batch: continue after failures (non-transactional)"),
             transactional: zod_1.z.boolean().optional().describe("For batch: all-or-nothing (default true)"),
         });
+        // Normalizes common parameter aliases that LLMs frequently send so they
+        // pass discriminatedUnion validation (which doesn't support z.preprocess).
+        const normalizeAliases = (args) => {
+            if (!args || typeof args !== "object")
+                return args;
+            const a = { ...args };
+            if (a.action === "create_entity" && a.entity_type && !a.type)
+                a.type = a.entity_type;
+            if (a.action === "update_entity" && a.entity_id && !a.id)
+                a.id = a.entity_id;
+            if (a.action === "stop_session" && a.session_id && !a.id)
+                a.id = a.session_id;
+            if (a.action === "stop_task" && a.task_id && !a.id)
+                a.id = a.task_id;
+            return a;
+        };
         this.mcp.addTool({
             name: "mutate_memory",
             description: `Write access to memory. Select operation via 'action'.
@@ -4109,8 +4132,10 @@ Note: Inference rules must return exactly 5 columns: [from_id, to_id, relation_t
             execute: async (args) => {
                 await this.initPromise;
                 console.error(`[mutate_memory] Call with:`, JSON.stringify(args, null, 2));
+                // Normalize common parameter aliases that LLMs frequently send before validation.
+                const normalizedArgs = normalizeAliases(args);
                 // Zod discriminatedUnion is strict. We try to parse it more flexibly.
-                const parsed = MutateMemorySchema.safeParse(args);
+                const parsed = MutateMemorySchema.safeParse(normalizedArgs);
                 if (!parsed.success) {
                     console.error(`[mutate_memory] Validation error:`, JSON.stringify(parsed.error.issues, null, 2));
                     return JSON.stringify({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cozo-memory",
-  "version": "1.2.11",
+  "version": "1.2.13",
   "mcpName": "io.github.tobs-code/cozo-memory",
   "description": "Local-first persistent memory system for AI agents with hybrid search, graph reasoning, and MCP integration",
   "main": "dist/index.js",