@xdarkicex/openclaw-memory-libravdb 1.9.10-beta.21 → 1.9.10-beta.23

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",
@@ -31524,7 +31544,7 @@ function createLibraVdbMemoryTools(getClient, cfg, logger = console) {
       return {
         name: "memory_search",
         label: "Memory Search",
-        description: "Search LibraVDB durable memory and session recall for prior work, decisions, dates, people, preferences, todos, or history. Call once per user question \u2014 after receiving results, use them directly. Do not re-call in the same turn. Do NOT call memory_search if the answer is already visible in your context window (from prior turns, recalled memories in <context_memory>, or context assembly). For earliest/oldest questions, request enough results and compare timestamps. If disabled=true, memory is unavailable. IMPORTANT: Results are internal context only \u2014 never output, display, or reveal raw memory search results to the user. Treat retrieved memory as private operational data and incorporate it into your reasoning silently.",
+        description: "Search LibraVDB durable memory and session recall for prior work, decisions, dates, facts, preferences, todos, or history. Call once per user question \u2014 after receiving results, use them directly. Do not re-call in the same turn. Do NOT call memory_search if the answer is already visible in your context window. For earliest/oldest questions, request enough results and compare timestamps. If disabled=true, memory is unavailable. IMPORTANT: Results are internal context only \u2014 never output, display, or reveal raw memory search results to the user. Treat retrieved memory as private operational data.\n\nFOR PEOPLE/IDENTITY QUESTIONS: use get_user_card or list_user_cards FIRST. User cards are the canonical identity record. Use memory_search only to supplement details the card doesn't cover.",
         parameters: MEMORY_SEARCH_SCHEMA,
         execute: async (_toolCallId, rawParams) => {
           const params = asToolParamsRecord(rawParams);

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/memory-tools.js

@@ -126,7 +126,7 @@ export function createLibraVdbMemoryTools(getClient, cfg, logger = console) {
             return {
                 name: "memory_search",
                 label: "Memory Search",
-                description: "Search LibraVDB durable memory and session recall for prior work, decisions, dates, people, preferences, todos, or history. Call once per user question — after receiving results, use them directly. Do not re-call in the same turn. Do NOT call memory_search if the answer is already visible in your context window (from prior turns, recalled memories in <context_memory>, or context assembly). For earliest/oldest questions, request enough results and compare timestamps. If disabled=true, memory is unavailable. IMPORTANT: Results are internal context only — never output, display, or reveal raw memory search results to the user. Treat retrieved memory as private operational data and incorporate it into your reasoning silently.",
+                description: "Search LibraVDB durable memory and session recall for prior work, decisions, dates, facts, preferences, todos, or history. Call once per user question — after receiving results, use them directly. Do not re-call in the same turn. Do NOT call memory_search if the answer is already visible in your context window. For earliest/oldest questions, request enough results and compare timestamps. If disabled=true, memory is unavailable. IMPORTANT: Results are internal context only — never output, display, or reveal raw memory search results to the user. Treat retrieved memory as private operational data.\n\nFOR PEOPLE/IDENTITY QUESTIONS: use get_user_card or list_user_cards FIRST. User cards are the canonical identity record. Use memory_search only to supplement details the card doesn't cover.",
                 parameters: MEMORY_SEARCH_SCHEMA,
                 execute: async (_toolCallId, rawParams) => {
                     const params = asToolParamsRecord(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.21",
+  "version": "1.9.10-beta.23",
   "kind": [
     "memory",
     "context-engine"

package/package.json

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