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

package/dist/index.js

@@ -23495,7 +23495,7 @@ Any.fields = proto3.util.newFieldList(() => [
   }
 ]);
 
-// node_modules/.pnpm/@xdarkicex+libravdb-contracts@2.0.25/node_modules/@xdarkicex/libravdb-contracts/gen/js/libravdb/ipc/v1/rpc_pb.js
+// node_modules/.pnpm/@xdarkicex+libravdb-contracts@2.0.27/node_modules/@xdarkicex/libravdb-contracts/gen/js/libravdb/ipc/v1/rpc_pb.js
 var IngestMode;
 (function(IngestMode2) {
   IngestMode2[IngestMode2["REPLACE"] = 0] = "REPLACE";
@@ -26473,6 +26473,12 @@ var ExpandSummaryRequest = class _ExpandSummaryRequest extends Message {
    * @generated from field: int32 max_depth = 3;
    */
   maxDepth = 0;
+  /**
+   * Graph mode: walk causal edges from this record ID.
+   *
+   * @generated from field: string record_id = 4;
+   */
+  recordId = "";
   constructor(data) {
     super();
     proto3.util.initPartial(data, this);
@@ -26500,6 +26506,13 @@ var ExpandSummaryRequest = class _ExpandSummaryRequest extends Message {
       kind: "scalar",
       T: 5
       /* ScalarType.INT32 */
+    },
+    {
+      no: 4,
+      name: "record_id",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
     }
   ]);
   static fromBinary(bytes, options) {
@@ -29618,6 +29631,24 @@ var ExpandSummaryResponse = class _ExpandSummaryResponse extends Message {
    * @generated from field: bytes metadata_json = 3;
    */
   metadataJson = new Uint8Array(0);
+  /**
+   * Graph mode fields (populated when record_id is set):
+   *
+   * @generated from field: repeated string why_ids = 4;
+   */
+  whyIds = [];
+  /**
+   * @generated from field: repeated string how_ids = 5;
+   */
+  howIds = [];
+  /**
+   * @generated from field: repeated string hop_targets = 6;
+   */
+  hopTargets = [];
+  /**
+   * @generated from field: repeated libravdb.ipc.v1.ConnectedRecord connected = 7;
+   */
+  connected = [];
   constructor(data) {
     super();
     proto3.util.initPartial(data, this);
@@ -29645,7 +29676,11 @@ var ExpandSummaryResponse = class _ExpandSummaryResponse extends Message {
       kind: "scalar",
       T: 12
       /* ScalarType.BYTES */
-    }
+    },
+    { no: 4, name: "why_ids", kind: "scalar", T: 9, repeated: true },
+    { no: 5, name: "how_ids", kind: "scalar", T: 9, repeated: true },
+    { no: 6, name: "hop_targets", kind: "scalar", T: 9, repeated: true },
+    { no: 7, name: "connected", kind: "message", T: ConnectedRecord, repeated: true }
   ]);
   static fromBinary(bytes, options) {
     return new _ExpandSummaryResponse().fromBinary(bytes, options);
@@ -29660,6 +29695,85 @@ var ExpandSummaryResponse = class _ExpandSummaryResponse extends Message {
     return proto3.util.equals(_ExpandSummaryResponse, a, b);
   }
 };
+var ConnectedRecord = class _ConnectedRecord extends Message {
+  /**
+   * @generated from field: string record_id = 1;
+   */
+  recordId = "";
+  /**
+   * @generated from field: string text = 2;
+   */
+  text = "";
+  /**
+   * @generated from field: int32 depth = 3;
+   */
+  depth = 0;
+  /**
+   * @generated from field: double edge_weight = 4;
+   */
+  edgeWeight = 0;
+  /**
+   * "why_ids", "how_ids", or "hop_targets"
+   *
+   * @generated from field: string edge_type = 5;
+   */
+  edgeType = "";
+  constructor(data) {
+    super();
+    proto3.util.initPartial(data, this);
+  }
+  static runtime = proto3;
+  static typeName = "libravdb.ipc.v1.ConnectedRecord";
+  static fields = proto3.util.newFieldList(() => [
+    {
+      no: 1,
+      name: "record_id",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 2,
+      name: "text",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    },
+    {
+      no: 3,
+      name: "depth",
+      kind: "scalar",
+      T: 5
+      /* ScalarType.INT32 */
+    },
+    {
+      no: 4,
+      name: "edge_weight",
+      kind: "scalar",
+      T: 1
+      /* ScalarType.DOUBLE */
+    },
+    {
+      no: 5,
+      name: "edge_type",
+      kind: "scalar",
+      T: 9
+      /* ScalarType.STRING */
+    }
+  ]);
+  static fromBinary(bytes, options) {
+    return new _ConnectedRecord().fromBinary(bytes, options);
+  }
+  static fromJson(jsonValue, options) {
+    return new _ConnectedRecord().fromJson(jsonValue, options);
+  }
+  static fromJsonString(jsonString, options) {
+    return new _ConnectedRecord().fromJsonString(jsonString, options);
+  }
+  static equals(a, b) {
+    return proto3.util.equals(_ConnectedRecord, a, b);
+  }
+};
 var QueryRawSessionResponse = class _QueryRawSessionResponse extends Message {
   /**
    * @generated from field: repeated libravdb.ipc.v1.KernelMessage messages = 1;
@@ -30931,6 +31045,17 @@ 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',
+      "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",
+      ""
+    );
+  }
   lines.push("LibraVDB memory is vector-backed and retrieved through tools, not files.", "");
   return lines;
 }
@@ -30973,11 +31098,15 @@ var MEMORY_EXPAND_SCHEMA = {
       items: { type: "string" },
       description: "Summary IDs (sum_xxx format) to expand. Use results from memory_search or memory_describe."
     },
+    record_id: {
+      type: "string",
+      description: "Record ID for causal graph traversal. Use '__user_card__' for identity-anchored expansion."
+    },
     maxDepth: {
       type: "number",
       minimum: 0,
       maximum: 5,
-      description: "Max tree traversal depth per summary (default: 1). 0 returns only the cue/metadata."
+      description: "Max tree/graph traversal depth (default: 1). 0 returns only edge metadata."
     },
     maxTokens: {
       type: "number",
@@ -30987,10 +31116,9 @@ var MEMORY_EXPAND_SCHEMA = {
     },
     sessionId: {
       type: "string",
-      description: "Session ID the summary belongs to. If omitted, uses the current session."
+      description: "Session ID. If omitted, uses the current session."
     }
-  },
-  required: ["summaryIds"]
+  }
 };
 var MEMORY_GREP_SCHEMA = {
   type: "object",
@@ -31112,16 +31240,42 @@ function createMemoryExpandTool(getClient, getSessionKey, logger = console, getS
   return {
     name: "memory_expand",
     label: "Memory Expand",
-    description: "Expand compacted summaries to recover full detail. Walks the summary tree up to maxDepth levels. For large expansions (>2500 tokens), spawns a sub-agent to protect context. Use memory_describe first to check if expansion is warranted \u2014 many questions can be answered from the eviction cue alone.",
+    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.",
     parameters: MEMORY_EXPAND_SCHEMA,
     execute: async (_toolCallId, rawParams) => {
       const params = asParams(rawParams);
+      const recordId = readStr(params, "record_id");
       const rawIds = params.summaryIds;
       const summaryIds = Array.isArray(rawIds) ? rawIds.filter((v) => typeof v === "string" && v.trim().length > 0) : [];
-      if (summaryIds.length === 0) throw new Error("memory_expand requires at least one summaryId");
       const maxDepth = readNum(params, "maxDepth", { integer: true, min: 0 }) ?? 1;
       let maxTokens = readNum(params, "maxTokens", { integer: true }) ?? MAX_EXPAND_TOKENS;
       const sessionId = readStr(params, "sessionId") ?? getSessionId() ?? "";
+      if (recordId) {
+        try {
+          const client = await getClient();
+          const resp = await client.expandSummary({ recordId, maxDepth });
+          let text = resp.text ?? "";
+          const connected = resp.connected;
+          if (connected && connected.length > 0) {
+            text = connected.map(
+              (c) => `[depth=${c.depth}] ${c.recordId}: ${c.text || ""}`
+            ).join("\n\n");
+          }
+          if (!text && resp.whyIds?.length) {
+            text = `why_ids: ${resp.whyIds.join(", ")}
+how_ids: ${resp.howIds?.join(", ") ?? "none"}
+hop_targets: ${resp.hopTargets?.join(", ") ?? "none"}`;
+          }
+          return {
+            content: [{ type: "text", text: text || "(no graph edges found)" }],
+            details: { summaryId: recordId, depth: maxDepth, text: text || "", truncated: false, exceededBudget: false, parentCount: connected?.length ?? 0 }
+          };
+        } catch (error2) {
+          logger.warn?.(`memory_expand graph mode failed: ${formatError(error2)}`);
+          return { content: [{ type: "text", text: `Graph expansion failed: ${formatError(error2)}` }], details: { summaryId: recordId, depth: maxDepth, text: "", truncated: false, exceededBudget: false, parentCount: 0 } };
+        }
+      }
+      if (summaryIds.length === 0) throw new Error("memory_expand requires at least one summaryId or record_id");
       const sessionKey = getSessionKey();
       if (sessionKey) {
         const grantedTokens = consumeSubagentBudget(sessionKey, maxTokens);
@@ -34150,7 +34304,7 @@ function createGrpcTransport(options) {
   return createTransport(validateNodeTransportOptions(options));
 }
 
-// node_modules/.pnpm/@xdarkicex+libravdb-contracts@2.0.25/node_modules/@xdarkicex/libravdb-contracts/gen/js/libravdb/ipc/v1/rpc_connect.js
+// node_modules/.pnpm/@xdarkicex+libravdb-contracts@2.0.27/node_modules/@xdarkicex/libravdb-contracts/gen/js/libravdb/ipc/v1/rpc_connect.js
 var LibravDB = {
   typeName: "libravdb.ipc.v1.LibravDB",
   methods: {

package/dist/memory-provider.js

@@ -50,6 +50,10 @@ function buildToolGuidance(availableTools) {
         }
         lines.push("", "**Do not guess specifics from a summary cue — expand if in doubt.**", "");
     }
+    // ── 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("LibraVDB memory is vector-backed and retrieved through tools, not files.", "");
     return lines;
 }

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

@@ -82,11 +82,15 @@ export declare function createMemoryExpandTool(getClient: ClientGetter, getSessi
                 };
                 readonly description: "Summary IDs (sum_xxx format) to expand. Use results from memory_search or memory_describe.";
             };
+            readonly record_id: {
+                readonly type: "string";
+                readonly description: "Record ID for causal graph traversal. Use '__user_card__' for identity-anchored expansion.";
+            };
             readonly maxDepth: {
                 readonly type: "number";
                 readonly minimum: 0;
                 readonly maximum: 5;
-                readonly description: "Max tree traversal depth per summary (default: 1). 0 returns only the cue/metadata.";
+                readonly description: "Max tree/graph traversal depth (default: 1). 0 returns only edge metadata.";
             };
             readonly maxTokens: {
                 readonly type: "number";
@@ -96,10 +100,9 @@ export declare function createMemoryExpandTool(getClient: ClientGetter, getSessi
             };
             readonly sessionId: {
                 readonly type: "string";
-                readonly description: "Session ID the summary belongs to. If omitted, uses the current session.";
+                readonly description: "Session ID. If omitted, uses the current session.";
             };
         };
-        readonly required: readonly ["summaryIds"];
     };
     execute: (_toolCallId: string, rawParams: unknown) => Promise<ToolResult<MemoryExpandDetails>>;
 };

package/dist/tools/memory-recall.js

@@ -31,11 +31,15 @@ const MEMORY_EXPAND_SCHEMA = {
             items: { type: "string" },
             description: "Summary IDs (sum_xxx format) to expand. Use results from memory_search or memory_describe.",
         },
+        record_id: {
+            type: "string",
+            description: "Record ID for causal graph traversal. Use '__user_card__' for identity-anchored expansion.",
+        },
         maxDepth: {
             type: "number",
             minimum: 0,
             maximum: 5,
-            description: "Max tree traversal depth per summary (default: 1). 0 returns only the cue/metadata.",
+            description: "Max tree/graph traversal depth (default: 1). 0 returns only edge metadata.",
         },
         maxTokens: {
             type: "number",
@@ -45,10 +49,9 @@ const MEMORY_EXPAND_SCHEMA = {
         },
         sessionId: {
             type: "string",
-            description: "Session ID the summary belongs to. If omitted, uses the current session.",
+            description: "Session ID. If omitted, uses the current session.",
         },
     },
-    required: ["summaryIds"],
 };
 const MEMORY_GREP_SCHEMA = {
     type: "object",
@@ -191,20 +194,46 @@ export function createMemoryExpandTool(getClient, getSessionKey, logger = consol
     return {
         name: "memory_expand",
         label: "Memory Expand",
-        description: "Expand compacted summaries to recover full detail. Walks the summary tree " +
-            "up to maxDepth levels. For large expansions (>2500 tokens), spawns a " +
-            "sub-agent to protect context. Use memory_describe first to check if expansion " +
-            "is warranted — many questions can be answered from the eviction cue alone.",
+        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. " +
+            "Use memory_describe first to check if expansion is warranted.",
         parameters: MEMORY_EXPAND_SCHEMA,
         execute: async (_toolCallId, rawParams) => {
             const params = asParams(rawParams);
+            const recordId = readStr(params, "record_id");
             const rawIds = params.summaryIds;
             const summaryIds = Array.isArray(rawIds) ? rawIds.filter((v) => typeof v === "string" && v.trim().length > 0) : [];
-            if (summaryIds.length === 0)
-                throw new Error("memory_expand requires at least one summaryId");
             const maxDepth = readNum(params, "maxDepth", { integer: true, min: 0 }) ?? 1;
             let maxTokens = readNum(params, "maxTokens", { integer: true }) ?? MAX_EXPAND_TOKENS;
             const sessionId = readStr(params, "sessionId") ?? getSessionId() ?? "";
+            // Graph mode: walk causal edges from a record ID.
+            if (recordId) {
+                try {
+                    const client = await getClient();
+                    const resp = await client.expandSummary({ recordId, maxDepth });
+                    let text = resp.text ?? "";
+                    const connected = resp.connected;
+                    if (connected && connected.length > 0) {
+                        text = connected.map((c) => `[depth=${c.depth}] ${c.recordId}: ${c.text || ""}`).join("\n\n");
+                    }
+                    if (!text && resp.whyIds?.length) {
+                        text = `why_ids: ${resp.whyIds.join(", ")}\nhow_ids: ${resp.howIds?.join(", ") ?? "none"}\nhop_targets: ${resp.hopTargets?.join(", ") ?? "none"}`;
+                    }
+                    return {
+                        content: [{ type: "text", text: text || "(no graph edges found)" }],
+                        details: { summaryId: recordId, depth: maxDepth, text: text || "", truncated: false, exceededBudget: false, parentCount: connected?.length ?? 0 },
+                    };
+                }
+                catch (error) {
+                    logger.warn?.(`memory_expand graph mode failed: ${formatError(error)}`);
+                    return { content: [{ type: "text", text: `Graph expansion failed: ${formatError(error)}` }], details: { summaryId: recordId, depth: maxDepth, text: "", truncated: false, exceededBudget: false, parentCount: 0 } };
+                }
+            }
+            if (summaryIds.length === 0)
+                throw new Error("memory_expand requires at least one summaryId or record_id");
             // Subagent budget gate: if this is a subagent, check remaining expansion budget.
             const sessionKey = getSessionKey();
             if (sessionKey) {

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.24",
+  "version": "1.9.10-beta.25",
   "kind": [
     "memory",
     "context-engine"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.9.10-beta.24",
+  "version": "1.9.10-beta.25",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -80,6 +80,6 @@
   "dependencies": {
     "@connectrpc/connect": "^1.7.0",
     "@connectrpc/connect-node": "^1.7.0",
-    "@xdarkicex/libravdb-contracts": "^2.0.25"
+    "@xdarkicex/libravdb-contracts": "^2.0.27"
   }
 }