@xdarkicex/openclaw-memory-libravdb 1.9.10-beta.9 → 1.10.1-beta.1

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 exact IDs from memory_search or memory_get results.",
+        },
         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,49 @@ 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 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) => {
             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) {
@@ -422,3 +454,149 @@ const RECALL_GUIDANCE = [
 export function memoryRecallPromptSection() {
     return [...RECALL_GUIDANCE];
 }
+// ── User Card tool schemas ──
+const UPDATE_USER_CARD_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        user_id: {
+            type: "string",
+            description: "The user ID to update the card for.",
+        },
+        card: {
+            type: "string",
+            description: "Prose description of what you've learned about this person. Write like describing a friend. Include identity, values, history, communication style, triggers, and what matters to them. Merge with previous understanding — don't replace entirely unless the user explicitly contradicts the record. Max ~1200 characters.",
+        },
+    },
+    required: ["user_id", "card"],
+};
+const GET_USER_CARD_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        user_id: {
+            type: "string",
+            description: "The user ID to retrieve the card for.",
+        },
+    },
+    required: ["user_id"],
+};
+// ── User Card tool factories ──
+export function createUpdateUserCardTool(getClient, logger = console) {
+    return {
+        name: "update_user_card",
+        label: "Update User Card",
+        description: "Write what you've learned about a speaker. Prose format — write like you're describing a friend. " +
+            "Include identity, values, history, communication style, triggers, and what matters to them. " +
+            "This is the canonical record of who they are. If something changes, update it. " +
+            "Merge with previous understanding, don't replace entirely unless the user explicitly contradicts the record.",
+        parameters: UPDATE_USER_CARD_SCHEMA,
+        execute: async (_toolCallId, rawParams) => {
+            try {
+                const params = asParams(rawParams);
+                const userId = readStr(params, "user_id");
+                const card = readStr(params, "card");
+                if (!userId)
+                    return jsonResult({ ok: false, error: "update_user_card requires user_id" });
+                if (!card)
+                    return jsonResult({ ok: false, error: "update_user_card requires card" });
+                const client = await getClient();
+                const resp = await client.upsertUserCard({
+                    userId,
+                    cardJson: JSON.stringify({ card, updatedAt: Date.now() }),
+                });
+                return jsonResult({ ok: resp.ok });
+            }
+            catch (error) {
+                logger.warn?.(`update_user_card failed: ${formatError(error)}`);
+                return jsonResult({ error: formatError(error), ok: false });
+            }
+        },
+    };
+}
+export function createGetUserCardTool(getClient, logger = console) {
+    return {
+        name: "get_user_card",
+        label: "Get User Card",
+        description: "PRIMARY identity lookup. Call this FIRST whenever someone asks about a person " +
+            "('who is X', 'tell me about X', 'what do you know about X'). " +
+            "Returns the full prose identity card with metadata. " +
+            "Only use memory_search AFTER get_user_card if the card lacks detail.",
+        parameters: GET_USER_CARD_SCHEMA,
+        execute: async (_toolCallId, rawParams) => {
+            try {
+                const params = asParams(rawParams);
+                const userId = readStr(params, "user_id");
+                if (!userId)
+                    return jsonResult({ card: null, error: "get_user_card requires user_id" });
+                const client = await getClient();
+                const resp = await client.getUserCard({ userId });
+                return jsonResult({
+                    card: resp.cardJson || null,
+                    updatedAt: resp.updatedAt ? Number(resp.updatedAt) : undefined,
+                    version: resp.version || undefined,
+                });
+            }
+            catch (error) {
+                logger.warn?.(`get_user_card failed: ${formatError(error)}`);
+                return jsonResult({ error: formatError(error) });
+            }
+        },
+    };
+}
+export function createListUserCardsTool(getClient, logger = console) {
+    return {
+        name: "list_user_cards",
+        label: "List User Cards",
+        description: "List every person you have a user card for. Returns user IDs and card previews. " +
+            "Use this FIRST when asked about multiple people, 'who do you know?', 'who is everyone?', " +
+            "or when you're unsure which people have cards. Then use get_user_card on specific IDs " +
+            "for full detail. Use memory_search only to supplement gaps.",
+        parameters: { type: "object", additionalProperties: false, properties: {} },
+        execute: async (_toolCallId, _rawParams) => {
+            try {
+                const client = await getClient();
+                const resp = await client.listByMeta({
+                    collection: "",
+                    key: "type",
+                    value: "user_card",
+                });
+                const users = [];
+                for (const result of resp.results) {
+                    let userId = "";
+                    let preview = "";
+                    let updatedAt;
+                    let version;
+                    if (result.metadataJson && result.metadataJson.length > 0) {
+                        try {
+                            const decoder = new TextDecoder();
+                            const meta = JSON.parse(decoder.decode(result.metadataJson));
+                            userId = typeof meta._user_id === "string" ? meta._user_id : "";
+                            const cardJson = typeof meta.card_json === "string" ? meta.card_json : null;
+                            if (cardJson) {
+                                try {
+                                    preview = JSON.parse(cardJson).card ?? cardJson;
+                                }
+                                catch {
+                                    preview = cardJson;
+                                }
+                                preview = preview.slice(0, 200);
+                            }
+                            updatedAt = typeof meta.updated_at === "number" ? meta.updated_at : undefined;
+                            version = typeof meta.version === "number" ? meta.version : undefined;
+                        }
+                        catch { /* best-effort metadata parse */ }
+                    }
+                    if (!userId)
+                        continue;
+                    users.push({ user_id: userId, preview, updated_at: updatedAt, version });
+                }
+                return jsonResult({ users, total: users.length });
+            }
+            catch (error) {
+                logger.warn?.(`list_user_cards failed: ${formatError(error)}`);
+                return jsonResult({ users: [], total: 0, error: formatError(error) });
+            }
+        },
+    };
+}

package/openclaw.plugin.json

@@ -1,8 +1,8 @@
 {
   "id": "libravdb-memory",
   "name": "LibraVDB Memory",
-  "description": "Persistent vector memory with three-tier hybrid scoring",
-  "version": "1.9.10-beta.9",
+  "description": "Cognitive memory engine — causal graph reasoning, predictive context, identity tracking, and hybrid vector recall with back-door adjustment scoring",
+  "version": "1.10.1-beta.1",
   "kind": [
     "memory",
     "context-engine"
@@ -15,7 +15,14 @@
       "memory_get",
       "memory_describe",
       "memory_expand",
-      "memory_grep"
+      "memory_grep",
+      "update_user_card",
+      "get_user_card",
+      "list_user_cards",
+      "set_rule",
+      "get_rule",
+      "list_rules",
+      "delete_rule"
     ]
   },
   "activation": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.9.10-beta.9",
+  "version": "1.10.1-beta.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -65,7 +65,7 @@
     "build:daemon": "bash scripts/build-daemon.sh"
   },
   "devDependencies": {
-    "@bufbuild/protobuf": "1.7.2",
+    "@bufbuild/protobuf": "1.10.1",
     "@grpc/grpc-js": "^1.14.3",
     "@grpc/proto-loader": "^0.8.0",
     "@openclaw/plugin-inspector": "0.3.7",
@@ -80,11 +80,6 @@
   "dependencies": {
     "@connectrpc/connect": "^1.7.0",
     "@connectrpc/connect-node": "^1.7.0",
-    "@xdarkicex/libravdb-contracts": "^2.0.20"
-  },
-  "pnpm": {
-    "overrides": {
-      "undici": "8.3.0"
-    }
+    "@xdarkicex/libravdb-contracts": "^2.0.27"
   }
 }