@xdarkicex/openclaw-memory-libravdb 1.10.9 → 1.10.13

package/dist/context-engine.js

@@ -1725,6 +1725,26 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             return null;
         }
     }
+    async function injectPersonaContext(params) {
+        try {
+            const resp = await params.client.getUserCard({ userId: "__bot_persona__" });
+            if (!resp.cardJson)
+                return null;
+            let card;
+            try {
+                card = JSON.parse(resp.cardJson).card ?? resp.cardJson;
+            }
+            catch {
+                card = resp.cardJson;
+            }
+            if (!card || card.trim().length === 0)
+                return null;
+            return '<bot_persona>\n' + card + '\n</bot_persona>';
+        }
+        catch {
+            return null;
+        }
+    }
     async function runCompaction(args) {
         const request = buildCompactSessionRequest(args);
         try {
@@ -2029,12 +2049,16 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                         systemPromptAddition: assembled.systemPromptAddition,
                     });
                     const userCardContext = await injectUserCardContext({ client, userId });
+                    const personaContext = await injectPersonaContext({ client });
                     const rulesContext = buildRulesContext();
-                    // Only inject continuity, user card, and rules on session bootstrap.
-                    // After the first turn, predictive context handles it.
+                    // Only inject on session bootstrap.
                     const isSessionBootstrap = messages.length <= 1;
                     let withContext = assembled;
                     if (isSessionBootstrap) {
+                        // Persona first — identity of the bot itself.
+                        if (personaContext) {
+                            withContext = { ...withContext, systemPromptAddition: appendSystemPromptAddition(withContext.systemPromptAddition, personaContext) };
+                        }
                         if (userCardContext) {
                             withContext = { ...withContext, systemPromptAddition: appendSystemPromptAddition(withContext.systemPromptAddition, userCardContext) };
                         }

package/dist/index.js

@@ -20281,6 +20281,22 @@ ${cached}
       return null;
     }
   }
+  async function injectPersonaContext(params) {
+    try {
+      const resp = await params.client.getUserCard({ userId: "__bot_persona__" });
+      if (!resp.cardJson) return null;
+      let card;
+      try {
+        card = JSON.parse(resp.cardJson).card ?? resp.cardJson;
+      } catch {
+        card = resp.cardJson;
+      }
+      if (!card || card.trim().length === 0) return null;
+      return "<bot_persona>\n" + card + "\n</bot_persona>";
+    } catch {
+      return null;
+    }
+  }
   async function runCompaction(args) {
     const request3 = buildCompactSessionRequest(args);
     try {
@@ -20575,10 +20591,14 @@ ${cached}
             systemPromptAddition: assembled.systemPromptAddition
           });
           const userCardContext = await injectUserCardContext({ client, userId });
+          const personaContext = await injectPersonaContext({ client });
           const rulesContext = buildRulesContext();
           const isSessionBootstrap = messages.length <= 1;
           let withContext = assembled;
           if (isSessionBootstrap) {
+            if (personaContext) {
+              withContext = { ...withContext, systemPromptAddition: appendSystemPromptAddition(withContext.systemPromptAddition, personaContext) };
+            }
             if (userCardContext) {
               withContext = { ...withContext, systemPromptAddition: appendSystemPromptAddition(withContext.systemPromptAddition, userCardContext) };
             }
@@ -31187,7 +31207,8 @@ function buildToolGuidance(availableTools) {
       "Only use memory_search if the card is empty or missing.",
       "",
       "**Autonomous card maintenance:**",
-      hasGetCard ? "- When you learn something new about ANY speaker (relationships, jobs, life events, preferences, beliefs), silently call `update_user_card` to keep their card current. You are building a picture of the user's world \u2014 everyone they mention matters. Don't wait to be asked. Update cards proactively." : "",
+      hasGetCard ? "- When ANY speaker is mentioned with new or changed information (status, relationships, jobs, life events, feelings), call `update_user_card` BEFORE responding. Update the card first, then reply. Do NOT wait to be asked. Build the world picture proactively. Every person the user mentions matters." : "",
+      hasGetCard ? "- If a card for the speaker doesn't exist yet, CREATE one with `update_user_card`. Better to have a stub card than no card at all." : "",
       ""
     );
   }
@@ -31196,7 +31217,10 @@ function buildToolGuidance(availableTools) {
     "facts, earliest interactions, and channel history. Do not answer memory",
     "questions from prior transcript claims \u2014 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."] : [],
+    ...availableTools.has("memory_get") ? [
+      "After a `memory_search` hit, call `memory_get` when exact wording or more context is needed.",
+      "IMPORTANT: If a search snippet is cluttered with metadata, do NOT claim nothing was found. Call `memory_get` on the hit's path to read the full record first. The data is there \u2014 expand before giving up."
+    ] : [],
     ""
   );
   const hasDescribe = availableTools.has("memory_describe");
@@ -31784,6 +31808,55 @@ function createListUserCardsTool(getClient, logger = console) {
     }
   };
 }
+function createSetPersonaTool(getClient, logger = console) {
+  return {
+    name: "set_persona",
+    label: "Set Persona",
+    description: "Define who YOU are \u2014 your personality, tone, boundaries, and behavior. Write in prose like you're describing yourself. This is injected as <bot_persona> at the start of every session. Update it when your persona changes. The LLM will embody this persona in all interactions.",
+    parameters: {
+      type: "object",
+      additionalProperties: false,
+      properties: {
+        persona: { type: "string", description: "Prose description of how you should behave." }
+      },
+      required: ["persona"]
+    },
+    execute: async (_toolCallId, rawParams) => {
+      const params = rawParams;
+      const persona = typeof params?.persona === "string" ? params.persona.trim() : "";
+      if (!persona) return jsonResult2({ ok: false, error: "set_persona requires a persona string" });
+      try {
+        const client = await getClient();
+        const resp = await client.upsertUserCard({
+          userId: "__bot_persona__",
+          cardJson: JSON.stringify({ card: persona, updatedAt: Date.now() })
+        });
+        return jsonResult2({ ok: resp.ok });
+      } catch (error2) {
+        logger.warn?.(`set_persona failed: ${formatError(error2)}`);
+        return jsonResult2({ ok: false, error: formatError(error2) });
+      }
+    }
+  };
+}
+function createGetPersonaTool(getClient, logger = console) {
+  return {
+    name: "get_persona",
+    label: "Get Persona",
+    description: "Read your current persona. Returns the full prose description of how you should behave.",
+    parameters: { type: "object", additionalProperties: false, properties: {} },
+    execute: async () => {
+      try {
+        const client = await getClient();
+        const resp = await client.getUserCard({ userId: "__bot_persona__" });
+        return jsonResult2({ persona: resp.cardJson || null });
+      } catch (error2) {
+        logger.warn?.(`get_persona failed: ${formatError(error2)}`);
+        return jsonResult2({ error: formatError(error2) });
+      }
+    }
+  };
+}
 
 // src/memory-tools.ts
 var MEMORY_SEARCH_SCHEMA = {
@@ -35605,6 +35678,14 @@ function register(api) {
     api.registerTool?.(() => createGetRuleTool(logger), { names: ["get_rule"] });
     api.registerTool?.(() => createListRulesTool(logger), { names: ["list_rules"] });
     api.registerTool?.(() => createDeleteRuleTool(logger), { names: ["delete_rule"] });
+    api.registerTool?.(() => {
+      const getClient = runtimeOrNull.getClient;
+      return createSetPersonaTool(getClient, logger);
+    }, { names: ["set_persona"] });
+    api.registerTool?.(() => {
+      const getClient = runtimeOrNull.getClient;
+      return createGetPersonaTool(getClient, logger);
+    }, { names: ["get_persona"] });
   }
   if (isLightweight || isDiscovery) {
     if (!isLightweight) {

package/dist/memory-provider.js

@@ -29,10 +29,13 @@ function buildToolGuidance(availableTools) {
     const hasGetCard = availableTools.has("get_user_card");
     const hasListCards = availableTools.has("list_user_cards");
     if (hasGetCard || hasListCards) {
-        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.", "", "**Autonomous card maintenance:**", hasGetCard ? "- When you learn something new about ANY speaker (relationships, jobs, life events, preferences, beliefs), silently call `update_user_card` to keep their card current. You are building a picture of the user's world — everyone they mention matters. Don't wait to be asked. Update cards proactively." : "", "");
+        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.", "", "**Autonomous card maintenance:**", hasGetCard ? "- When ANY speaker is mentioned with new or changed information (status, relationships, jobs, life events, feelings), call `update_user_card` BEFORE responding. Update the card first, then reply. Do NOT wait to be asked. Build the world picture proactively. Every person the user mentions matters." : "", hasGetCard ? "- If a card for the speaker doesn't exist yet, CREATE one with `update_user_card`. Better to have a stub card than no card at all." : "", "");
     }
     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."]
+        ? [
+            "After a `memory_search` hit, call `memory_get` when exact wording or more context is needed.",
+            "IMPORTANT: If a search snippet is cluttered with metadata, do NOT claim nothing was found. Call `memory_get` on the hit's path to read the full record first. The data is there — expand before giving up."
+        ]
         : []), "");
     // ── Summaries / recall (when available) ──
     const hasDescribe = availableTools.has("memory_describe");

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

@@ -213,4 +213,38 @@ export declare function createListUserCardsTool(getClient: ClientGetter, logger?
     };
     execute: (_toolCallId: string, _rawParams: unknown) => Promise<ToolResult<ListUserCardsDetails>>;
 };
+export declare function createSetPersonaTool(getClient: ClientGetter, logger?: LoggerLike): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly persona: {
+                readonly type: "string";
+                readonly description: "Prose description of how you should behave.";
+            };
+        };
+        readonly required: readonly ["persona"];
+    };
+    execute: (_toolCallId: string, rawParams: unknown) => Promise<ToolResult<{
+        ok: boolean;
+        error?: string;
+    }>>;
+};
+export declare function createGetPersonaTool(getClient: ClientGetter, logger?: LoggerLike): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {};
+    };
+    execute: () => Promise<ToolResult<{
+        persona?: string | null;
+        error?: string;
+    }>>;
+};
 export {};

package/dist/tools/memory-recall.js

@@ -601,3 +601,59 @@ export function createListUserCardsTool(getClient, logger = console) {
         },
     };
 }
+// ── Persona tools — identity of the bot itself ──
+export function createSetPersonaTool(getClient, logger = console) {
+    return {
+        name: "set_persona",
+        label: "Set Persona",
+        description: "Define who YOU are — your personality, tone, boundaries, and behavior. " +
+            "Write in prose like you're describing yourself. This is injected as " +
+            "<bot_persona> at the start of every session. Update it when your persona " +
+            "changes. The LLM will embody this persona in all interactions.",
+        parameters: {
+            type: "object",
+            additionalProperties: false,
+            properties: {
+                persona: { type: "string", description: "Prose description of how you should behave." },
+            },
+            required: ["persona"],
+        },
+        execute: async (_toolCallId, rawParams) => {
+            const params = rawParams;
+            const persona = typeof params?.persona === "string" ? params.persona.trim() : "";
+            if (!persona)
+                return jsonResult({ ok: false, error: "set_persona requires a persona string" });
+            try {
+                const client = await getClient();
+                const resp = await client.upsertUserCard({
+                    userId: "__bot_persona__",
+                    cardJson: JSON.stringify({ card: persona, updatedAt: Date.now() }),
+                });
+                return jsonResult({ ok: resp.ok });
+            }
+            catch (error) {
+                logger.warn?.(`set_persona failed: ${formatError(error)}`);
+                return jsonResult({ ok: false, error: formatError(error) });
+            }
+        },
+    };
+}
+export function createGetPersonaTool(getClient, logger = console) {
+    return {
+        name: "get_persona",
+        label: "Get Persona",
+        description: "Read your current persona. Returns the full prose description of how you should behave.",
+        parameters: { type: "object", additionalProperties: false, properties: {} },
+        execute: async () => {
+            try {
+                const client = await getClient();
+                const resp = await client.getUserCard({ userId: "__bot_persona__" });
+                return jsonResult({ persona: resp.cardJson || null });
+            }
+            catch (error) {
+                logger.warn?.(`get_persona failed: ${formatError(error)}`);
+                return jsonResult({ error: formatError(error) });
+            }
+        },
+    };
+}

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.9",
+  "version": "1.10.13",
   "kind": [
     "memory",
     "context-engine"
@@ -22,7 +22,9 @@
       "set_rule",
       "get_rule",
       "list_rules",
-      "delete_rule"
+      "delete_rule",
+      "set_persona",
+      "get_persona"
     ]
   },
   "activation": {

package/package.json

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