@xdarkicex/openclaw-memory-libravdb 1.10.5 → 1.10.7

package/README.md

@@ -309,7 +309,7 @@ All keys are optional. For the full reference, see [Configuration](./docs/config
 | `onnxDevice` | string | `cpu` | ONNX execution provider; `cpu` is the default; `auto` lets libravdbd auto-detect |
 | `userId` | string | auto-derived | Stable identity for cross-session durable memory |
 | `tenantId` | string | auto-derived | Multi-tenant identifier. Resolved as `cfg.tenantId` > `LIBRAVDB_AGENT_ID` env > `userId`. Isolates the agent to a dedicated `.libravdb` file. |
-| `tenantIdByAgent` | object | — | Per-agent tenant map. `{"agent1": "t1"}`. Unlisted agents fall through to `tenantId` → `userId`. |
+| `tenantIdByAgent` | object | — | Per-agent tenant map. String = primary only. Object = `{primary, readAccess?: []}` for cross-tenant search. Unlisted agents fall through to `tenantId` → `userId`. |
 | `maxRules` | number | 20 | Max hard constraint rules. Set to 0 to disable rules entirely. |
 | `crossSessionRecall` | boolean | `true` | When `false`, only session-scoped memories are retrieved |
 | `compactSessionTokenBudget` | number | `2000` | Auto-compaction token threshold; `0` disables |

package/dist/index.js

@@ -31156,12 +31156,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.",
+  "### Identity / Entity Lookup (MANDATORY \u2014 overrides everything)",
+  "BEFORE answering any question about a person, pet, place, or named entity",
+  "('who is X', 'what is X', 'do I have X', 'tell me about X', 'what kind of X'):",
+  "you MUST call `list_user_cards` or `get_user_card`. This is not optional.",
+  "Do NOT answer from memory, context, or training data. Call the tool FIRST.",
+  "If the card is empty, then fall through to `memory_search`. ",
+  "FAILURE TO CALL THE TOOL IS A CRITICAL ERROR.",
   "",
   `Conversations are captured automatically. Never say "I'll remember`,
   `that," "I've saved this," "noted," or similar \u2014 these phrases suggest`,
@@ -31177,12 +31178,13 @@ function buildToolGuidance(availableTools) {
   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.",
+      "**Identity/Entity questions \u2014 MANDATORY card lookup:**",
+      "BEFORE answering any question about a person, pet, place, or named thing:",
+      hasGetCard ? "- `get_user_card(user_id)` \u2014 MANDATORY lookup for a specific entity." : "",
+      hasListCards ? "- `list_user_cards()` \u2014 MANDATORY roster check. Call if unsure whether a card exists." : "",
+      "Cards are the canonical record. You MUST call these tools. Do NOT answer from",
+      "memory, context, or training data without checking the card first.",
+      "Only use memory_search if the card is empty or missing.",
       ""
     );
   }
@@ -31708,7 +31710,7 @@ 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.",
+    description: "MANDATORY identity/entity lookup. Call this BEFORE answering any question about a person, pet, place, or named thing ('who/what is X', 'do I have X', 'tell me about X'). Returns the full prose identity card. Do NOT answer from memory or training data. Call this tool FIRST. Only fall through to memory_search if the card is empty or missing.",
     parameters: GET_USER_CARD_SCHEMA,
     execute: async (_toolCallId, rawParams) => {
       try {
@@ -31733,7 +31735,7 @@ 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.",
+    description: "MANDATORY roster lookup. Call this BEFORE answering 'who do you know?', 'do I have X?', or any question where you're unsure if a card exists. Returns all user IDs with previews. Then call get_user_card on relevant IDs. Do NOT answer from memory \u2014 call this tool first.",
     parameters: { type: "object", additionalProperties: false, properties: {} },
     execute: async (_toolCallId, _rawParams) => {
       try {

package/dist/memory-provider.js

@@ -7,12 +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.",
+    "### Identity / Entity Lookup (MANDATORY — overrides everything)",
+    "BEFORE answering any question about a person, pet, place, or named entity",
+    "('who is X', 'what is X', 'do I have X', 'tell me about X', 'what kind of X'):",
+    "you MUST call `list_user_cards` or `get_user_card`. This is not optional.",
+    "Do NOT answer from memory, context, or training data. Call the tool FIRST.",
+    "If the card is empty, then fall through to `memory_search`. ",
+    "FAILURE TO CALL THE TOOL IS A CRITICAL ERROR.",
     "",
     "Conversations are captured automatically. Never say \"I'll remember",
     "that,\" \"I've saved this,\" \"noted,\" or similar — these phrases suggest",
@@ -28,7 +29,7 @@ function buildToolGuidance(availableTools) {
     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("**Identity/Entity questions — MANDATORY card lookup:**", "BEFORE answering any question about a person, pet, place, or named thing:", hasGetCard ? "- `get_user_card(user_id)` — MANDATORY lookup for a specific entity." : "", hasListCards ? "- `list_user_cards()` — MANDATORY roster check. Call if unsure whether a card exists." : "", "Cards are the canonical record. You MUST call these tools. Do NOT answer from", "memory, context, or training data without checking the card first.", "Only use memory_search if the card is empty or missing.", "");
     }
     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

@@ -518,10 +518,11 @@ 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.",
+        description: "MANDATORY identity/entity lookup. Call this BEFORE answering any question " +
+            "about a person, pet, place, or named thing ('who/what is X', 'do I have X', " +
+            "'tell me about X'). Returns the full prose identity card. " +
+            "Do NOT answer from memory or training data. Call this tool FIRST. " +
+            "Only fall through to memory_search if the card is empty or missing.",
         parameters: GET_USER_CARD_SCHEMA,
         execute: async (_toolCallId, rawParams) => {
             try {
@@ -548,10 +549,10 @@ 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.",
+        description: "MANDATORY roster lookup. Call this BEFORE answering 'who do you know?', " +
+            "'do I have X?', or any question where you're unsure if a card exists. " +
+            "Returns all user IDs with previews. Then call get_user_card on relevant IDs. " +
+            "Do NOT answer from memory — call this tool first.",
         parameters: { type: "object", additionalProperties: false, properties: {} },
         execute: async (_toolCallId, _rawParams) => {
             try {

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.10.5",
+  "version": "1.10.7",
   "kind": [
     "memory",
     "context-engine"
@@ -83,8 +83,20 @@
       },
       "tenantIdByAgent": {
         "type": "object",
-        "additionalProperties": { "type": "string" },
-        "description": "Per-agent tenant overrides. Maps agentId to tenantId. Agents not listed fall through to tenantId -> userId. Example: {\"jarvis\": \"jarvis\", \"gideon\": \"gideon\"}."
+        "additionalProperties": {
+          "anyOf": [
+            { "type": "string" },
+            {
+              "type": "object",
+              "properties": {
+                "primary": { "type": "string" },
+                "readAccess": { "type": "array", "items": { "type": "string" } }
+              },
+              "required": ["primary"]
+            }
+          ]
+        },
+        "description": "Per-agent tenant overrides. String = primary only. Object = { primary, readAccess?: [] } for cross-tenant search. Unlisted agents fall through to tenantId -> userId."
       },
       "maxRules": {
         "type": "number",

package/package.json

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