@xdarkicex/openclaw-memory-libravdb 1.9.10-beta.25 → 1.9.10-beta.27

package/dist/index.js

@@ -31048,11 +31048,11 @@ function buildToolGuidance(availableTools) {
   if (hasExpand) {
     lines.push(
       "### Causal Graph Traversal",
-      "When the user asks about causes, patterns, or relationships between people/events:",
-      "1. Start with `get_user_card` to anchor on identity",
-      '2. Call `memory_expand` with `record_id="__user_card__"` to walk causal edges',
+      "When the user asks about causes, patterns, or relationships:",
+      "1. `memory_search` for the people/events in question to get record IDs",
+      "2. `memory_expand` with the most relevant `record_id` to walk causal edges",
       "3. Follow interesting edges \u2014 use `memory_get` for full detail on connected records",
-      "4. Use `memory_search` only as fallback for facts the graph doesn't cover",
+      "4. Use `get_user_card` to cross-reference identity context",
       ""
     );
   }
@@ -31100,7 +31100,7 @@ var MEMORY_EXPAND_SCHEMA = {
     },
     record_id: {
       type: "string",
-      description: "Record ID for causal graph traversal. Use '__user_card__' for identity-anchored expansion."
+      description: "Record ID for causal graph traversal. Use exact IDs from memory_search or memory_get results."
     },
     maxDepth: {
       type: "number",
@@ -31240,7 +31240,7 @@ function createMemoryExpandTool(getClient, getSessionKey, logger = console, getS
   return {
     name: "memory_expand",
     label: "Memory Expand",
-    description: "Expand compacted summaries OR walk causal graph edges from a record. Summary mode: walk the summary tree up to maxDepth levels. Graph mode (use record_id): walk causal edges (why_ids/how_ids/hop_targets) from a record \u2014 use '__user_card__' for identity-anchored traversal after get_user_card. For large expansions (>2500 tokens), spawns a sub-agent. Use memory_describe first to check if expansion is warranted.",
+    description: "Expand compacted summaries OR walk causal graph edges from ANY record. Summary mode (summaryIds): walk the summary tree up to maxDepth levels. Graph mode (record_id): walk causal edges (why_ids/how_ids/hop_targets) from a record ID. Use exact IDs from memory_search or memory_get results \u2014 any ingested turn, memory, or summary has graph edges. After get_user_card for context, search for related people/events then expand the most relevant hit. For large expansions, spawns a sub-agent. Use memory_describe first to check if expansion is warranted.",
     parameters: MEMORY_EXPAND_SCHEMA,
     execute: async (_toolCallId, rawParams) => {
       const params = asParams(rawParams);

package/dist/memory-provider.js

@@ -52,7 +52,7 @@ function buildToolGuidance(availableTools) {
     }
     // ── Causal graph traversal (when expand supports record_id) ──
     if (hasExpand) {
-        lines.push("### Causal Graph Traversal", "When the user asks about causes, patterns, or relationships between people/events:", "1. Start with `get_user_card` to anchor on identity", "2. Call `memory_expand` with `record_id=\"__user_card__\"` to walk causal edges", "3. Follow interesting edges — use `memory_get` for full detail on connected records", "4. Use `memory_search` only as fallback for facts the graph doesn't cover", "");
+        lines.push("### Causal Graph Traversal", "When the user asks about causes, patterns, or relationships:", "1. `memory_search` for the people/events in question to get record IDs", "2. `memory_expand` with the most relevant `record_id` to walk causal edges", "3. Follow interesting edges — use `memory_get` for full detail on connected records", "4. Use `get_user_card` to cross-reference identity context", "");
     }
     lines.push("LibraVDB memory is vector-backed and retrieved through tools, not files.", "");
     return lines;

package/dist/tools/memory-recall.d.ts

@@ -84,7 +84,7 @@ export declare function createMemoryExpandTool(getClient: ClientGetter, getSessi
             };
             readonly record_id: {
                 readonly type: "string";
-                readonly description: "Record ID for causal graph traversal. Use '__user_card__' for identity-anchored expansion.";
+                readonly description: "Record ID for causal graph traversal. Use exact IDs from memory_search or memory_get results.";
             };
             readonly maxDepth: {
                 readonly type: "number";

package/dist/tools/memory-recall.js

@@ -33,7 +33,7 @@ const MEMORY_EXPAND_SCHEMA = {
         },
         record_id: {
             type: "string",
-            description: "Record ID for causal graph traversal. Use '__user_card__' for identity-anchored expansion.",
+            description: "Record ID for causal graph traversal. Use exact IDs from memory_search or memory_get results.",
         },
         maxDepth: {
             type: "number",
@@ -194,11 +194,14 @@ export function createMemoryExpandTool(getClient, getSessionKey, logger = consol
     return {
         name: "memory_expand",
         label: "Memory Expand",
-        description: "Expand compacted summaries OR walk causal graph edges from a record. " +
-            "Summary mode: walk the summary tree up to maxDepth levels. " +
-            "Graph mode (use record_id): walk causal edges (why_ids/how_ids/hop_targets) " +
-            "from a record — use '__user_card__' for identity-anchored traversal after " +
-            "get_user_card. For large expansions (>2500 tokens), spawns a sub-agent. " +
+        description: "Expand compacted summaries OR walk causal graph edges from ANY record. " +
+            "Summary mode (summaryIds): walk the summary tree up to maxDepth levels. " +
+            "Graph mode (record_id): walk causal edges (why_ids/how_ids/hop_targets) " +
+            "from a record ID. Use exact IDs from memory_search or memory_get results — " +
+            "any ingested turn, memory, or summary has graph edges. " +
+            "After get_user_card for context, search for related people/events then " +
+            "expand the most relevant hit. " +
+            "For large expansions, spawns a sub-agent. " +
             "Use memory_describe first to check if expansion is warranted.",
         parameters: MEMORY_EXPAND_SCHEMA,
         execute: async (_toolCallId, rawParams) => {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "libravdb-memory",
   "name": "LibraVDB Memory",
   "description": "Cognitive memory engine — causal graph reasoning, predictive context, identity tracking, and hybrid vector recall with back-door adjustment scoring",
-  "version": "1.9.10-beta.25",
+  "version": "1.9.10-beta.27",
   "kind": [
     "memory",
     "context-engine"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.9.10-beta.25",
+  "version": "1.9.10-beta.27",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",