@xdarkicex/openclaw-memory-libravdb 1.10.10 → 1.10.14-beta.1

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

@@ -26,6 +26,13 @@ type MemoryExpandDetails = {
     truncated: boolean;
     exceededBudget: boolean;
     parentCount: number;
+    connected?: Array<{
+        recordId: string;
+        text: string;
+        depth: number;
+        edgeType: string;
+        edgeWeight: number;
+    }>;
     error?: string;
 };
 type MemoryGrepDetails = {
@@ -213,4 +220,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

@@ -199,8 +199,6 @@ export function createMemoryExpandTool(getClient, getSessionKey, logger = consol
             "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,
@@ -218,16 +216,22 @@ export function createMemoryExpandTool(getClient, getSessionKey, logger = consol
                     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");
+                    const connected = (resp.connected ?? []).map((c) => ({
+                        recordId: c.recordId,
+                        text: c.text ?? "",
+                        depth: c.depth,
+                        edgeType: c.edgeType || "unknown",
+                        edgeWeight: c.edgeWeight ?? 0,
+                    }));
+                    if (connected.length > 0) {
+                        text = connected.map((c) => `[depth=${c.depth} edge=${c.edgeType} weight=${c.edgeWeight}] ${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 },
+                        details: { summaryId: recordId, depth: maxDepth, text: text || "", truncated: false, exceededBudget: false, parentCount: connected.length, connected },
                     };
                 }
                 catch (error) {
@@ -601,3 +605,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.10",
+  "version": "1.10.14-beta.1",
   "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.10",
+  "version": "1.10.14-beta.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",