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

package/dist/index.js

@@ -30853,6 +30853,13 @@ var MEMORY_PROMPT_HEADER = [
   "answer from memory until you have called it. Once you have results,",
   "use them \u2014 do not re-call in the same turn.",
   "",
+  "### Identity / People Lookup (OVERRIDES memory_search)",
+  "When asked about a specific person ('who is X', 'what do you know",
+  "about X', 'tell me about X'): call `get_user_card` or `list_user_cards`",
+  "FIRST. User cards are the canonical identity record written by you.",
+  "Only use `memory_search` AFTER the card if the card lacks detail.",
+  "Do NOT call memory_search first for people questions.",
+  "",
   `Conversations are captured automatically. Never say "I'll remember`,
   `that," "I've saved this," "noted," or similar \u2014 these phrases suggest`,
   "manual effort where none exists. Just act on the request.",
@@ -30863,6 +30870,19 @@ function buildToolGuidance(availableTools) {
     return [];
   }
   const lines = [];
+  const hasGetCard = availableTools.has("get_user_card");
+  const hasListCards = availableTools.has("list_user_cards");
+  if (hasGetCard || hasListCards) {
+    lines.push(
+      "**Identity/People questions \u2014 ALWAYS use user cards first:**",
+      hasGetCard ? "- `get_user_card(user_id)` \u2014 primary lookup for a specific person." : "",
+      hasListCards ? "- `list_user_cards()` \u2014 list everyone you have cards for, or when unsure who has cards." : "",
+      "User cards are the canonical identity record. Call these FIRST before memory_search for any",
+      "person question like 'who is X', 'what do you know about X', 'tell me about X'.",
+      "Only use memory_search to supplement details the card doesn't cover.",
+      ""
+    );
+  }
   lines.push(
     "Call `memory_search` once per user question for prior turns, remembered",
     "facts, earliest interactions, and channel history. Do not answer memory",
@@ -31314,12 +31334,12 @@ function createUpdateUserCardTool(getClient, logger = console) {
     description: "Write what you've learned about a speaker. Prose format \u2014 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) => {
-      const params = asParams(rawParams);
-      const userId = readStr(params, "user_id");
-      const card = readStr(params, "card");
-      if (!userId) throw new Error("update_user_card requires user_id");
-      if (!card) throw new Error("update_user_card requires card");
       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,
@@ -31340,10 +31360,10 @@ function createGetUserCardTool(getClient, logger = console) {
     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) => {
-      const params = asParams(rawParams);
-      const userId = readStr(params, "user_id");
-      if (!userId) throw new Error("get_user_card requires user_id");
       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({

package/dist/memory-provider.js

@@ -7,6 +7,13 @@ const MEMORY_PROMPT_HEADER = [
     "answer from memory until you have called it. Once you have results,",
     "use them — do not re-call in the same turn.",
     "",
+    "### Identity / People Lookup (OVERRIDES memory_search)",
+    "When asked about a specific person ('who is X', 'what do you know",
+    "about X', 'tell me about X'): call `get_user_card` or `list_user_cards`",
+    "FIRST. User cards are the canonical identity record written by you.",
+    "Only use `memory_search` AFTER the card if the card lacks detail.",
+    "Do NOT call memory_search first for people questions.",
+    "",
     "Conversations are captured automatically. Never say \"I'll remember",
     "that,\" \"I've saved this,\" \"noted,\" or similar — these phrases suggest",
     "manual effort where none exists. Just act on the request.",
@@ -17,6 +24,12 @@ function buildToolGuidance(availableTools) {
         return [];
     }
     const lines = [];
+    // ── User card tools (identity-first override) ──
+    const hasGetCard = availableTools.has("get_user_card");
+    const hasListCards = availableTools.has("list_user_cards");
+    if (hasGetCard || hasListCards) {
+        lines.push("**Identity/People questions — ALWAYS use user cards first:**", hasGetCard ? "- `get_user_card(user_id)` — primary lookup for a specific person." : "", hasListCards ? "- `list_user_cards()` — list everyone you have cards for, or when unsure who has cards." : "", "User cards are the canonical identity record. Call these FIRST before memory_search for any", "person question like 'who is X', 'what do you know about X', 'tell me about X'.", "Only use memory_search to supplement details the card doesn't cover.", "");
+    }
     lines.push("Call `memory_search` once per user question for prior turns, remembered", "facts, earliest interactions, and channel history. Do not answer memory", "questions from prior transcript claims — perform a search every time.", "After receiving results, use them directly; do not re-call in the same turn.", ...(availableTools.has("memory_get")
         ? ["After a `memory_search` hit, call `memory_get` when exact wording or more context is needed."]
         : []), "");

package/dist/tools/memory-recall.js

@@ -460,14 +460,14 @@ export function createUpdateUserCardTool(getClient, logger = console) {
             "Merge with previous understanding, don't replace entirely unless the user explicitly contradicts the record.",
         parameters: UPDATE_USER_CARD_SCHEMA,
         execute: async (_toolCallId, rawParams) => {
-            const params = asParams(rawParams);
-            const userId = readStr(params, "user_id");
-            const card = readStr(params, "card");
-            if (!userId)
-                throw new Error("update_user_card requires user_id");
-            if (!card)
-                throw new Error("update_user_card requires card");
             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,
@@ -492,11 +492,11 @@ export function createGetUserCardTool(getClient, logger = console) {
             "Only use memory_search AFTER get_user_card if the card lacks detail.",
         parameters: GET_USER_CARD_SCHEMA,
         execute: async (_toolCallId, rawParams) => {
-            const params = asParams(rawParams);
-            const userId = readStr(params, "user_id");
-            if (!userId)
-                throw new Error("get_user_card requires user_id");
             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({

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

package/package.json

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