@xdarkicex/openclaw-memory-libravdb 1.6.31 → 1.7.0

package/README.md

@@ -176,6 +176,22 @@ openclaw memory journal --limit 50
 openclaw memory dream-promote --user-id <userId> --dream-file ~/DREAMS.md
 ```
 
+### Vector Service CLI (libravdbd v1.5.0+)
+
+```bash
+# Service health and status
+libravdbd status                    # tenants, cache, DB sizes
+libravdbd health                    # OK/UNHEALTHY
+
+# Search tenant memory (same collections memory_search queries)
+libravdbd search --tenant <key> -k 10 "query"
+libravdbd search --tenant <key> --session <id> -k 10 "query"
+
+# Tenant management
+libravdbd tenant evict <key>        # force-close a tenant DB
+libravdbd migrate                   # run pending DB migrations
+```
+
 Use [Install](./docs/install.md) for service lifecycle commands and
 [Uninstall](./docs/uninstall.md) for safe shutdown and removal.
 

package/dist/context-engine.js

@@ -1297,6 +1297,9 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                             systemPromptAddition: appendSystemPromptAddition(enforced.systemPromptAddition, section.text),
                             estimatedTokens: enforced.estimatedTokens + section.tokens,
                         };
+                        logger.info?.(`LibraVDB predictive context injected sessionId=${sessionId} ` +
+                            `items=${section.injectedCount}/${predictions.length} ` +
+                            `tokens=${section.tokens}`);
                     }
                 }
                 enforced = enforceTokenBudgetInvariant(enforced, args.tokenBudget);
@@ -1426,6 +1429,11 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                             predictiveContextCache.delete(oldest);
                     }
                     predictiveContextCache.set(sessionId, predictions);
+                    logger.info?.(`LibraVDB predictive graph returned predictions sessionId=${sessionId} ` +
+                        `count=${predictions.length}`);
+                }
+                else {
+                    logger.info?.(`LibraVDB predictive graph returned no predictions sessionId=${sessionId}`);
                 }
                 return result;
             }

package/dist/index.js

@@ -27807,6 +27807,9 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
               ),
               estimatedTokens: enforced.estimatedTokens + section.tokens
             };
+            logger.info?.(
+              `LibraVDB predictive context injected sessionId=${sessionId} items=${section.injectedCount}/${predictions.length} tokens=${section.tokens}`
+            );
           }
         }
         enforced = enforceTokenBudgetInvariant(enforced, args.tokenBudget);
@@ -27927,6 +27930,13 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
             if (oldest !== void 0) predictiveContextCache.delete(oldest);
           }
           predictiveContextCache.set(sessionId, predictions);
+          logger.info?.(
+            `LibraVDB predictive graph returned predictions sessionId=${sessionId} count=${predictions.length}`
+          );
+        } else {
+          logger.info?.(
+            `LibraVDB predictive graph returned no predictions sessionId=${sessionId}`
+          );
         }
         return result;
       } catch (error2) {
@@ -34754,28 +34764,28 @@ function isOpenClawMemoryFile(filePath) {
 // src/memory-provider.ts
 var MEMORY_PROMPT_HEADER = [
   "## Memory",
-  "LibraVDB persistent memory is configured. Recalled memories may appear",
-  "in context via the context-engine assembler when available and relevant.",
+  "LibraVDB persistent memory is configured. Every turn is auto-ingested",
+  "into the vector store \u2014 you do not need to explicitly save anything.",
+  "When asked about past conversations, facts, preferences, decisions,",
+  "or anything the user might have told you before, call `memory_search`",
+  "once per user question. Do not answer from memory until you have",
+  "called it. Once you have results, use them \u2014 do not re-call.",
   ""
 ];
 function buildToolGuidance(availableTools) {
   if (!availableTools?.has("memory_search")) {
     return [];
   }
-  const lines = [
-    "For explicit memory lookup requests, call `memory_search` first.",
-    "Use it for prior turns, remembered facts, earliest interactions, and channel history.",
-    "Do not answer memory lookup requests from prior transcript claims or earlier `memory_search` results; perform a fresh `memory_search` for the current request.",
-    "For earliest or oldest memory questions, request enough results, compare timestamps in the returned snippets, and use `memory_get` if the snippet is not enough."
-  ];
-  if (availableTools.has("memory_get")) {
-    lines.push("After a `memory_search` hit, call `memory_get` when exact wording or more context is needed.");
-  }
-  lines.push(
-    "Do not treat a missing `MEMORY.md` file as missing memory; LibraVDB memory is vector-backed and retrieved through the memory tools.",
+  return [
+    "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 \u2014 perform a search every time.",
+    "After receiving results, use them directly; do not re-call in the same turn.",
+    "For earliest or oldest questions, request enough results and compare timestamps.",
+    ...availableTools.has("memory_get") ? ["After a `memory_search` hit, call `memory_get` when exact wording or more context is needed."] : [],
+    "LibraVDB memory is vector-backed and retrieved through tools, not files.",
     ""
-  );
-  return lines;
+  ];
 }
 function buildMemoryPromptSection(_getClient, _cfg) {
   return function memoryPromptSection({
@@ -34864,7 +34874,7 @@ function createLibraVdbMemoryTools(getClient, cfg, logger = console) {
       return {
         name: "memory_search",
         label: "Memory Search",
-        description: "Mandatory fresh LibraVDB recall step: semantically search durable memory and session recall before answering questions about prior work, decisions, dates, people, preferences, todos, or history. Do not reuse prior transcript claims or older memory_search results for a new memory lookup. For earliest/oldest questions, request enough results and compare timestamps in snippets. If response has disabled=true, memory retrieval is unavailable and should be surfaced to the user.",
+        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. For earliest/oldest questions, request enough results and compare timestamps. If disabled=true, memory is unavailable.",
         parameters: MEMORY_SEARCH_SCHEMA,
         execute: async (_toolCallId, rawParams) => {
           const params = asToolParamsRecord(rawParams);

package/dist/memory-provider.js

@@ -1,24 +1,29 @@
 const MEMORY_PROMPT_HEADER = [
     "## Memory",
-    "LibraVDB persistent memory is configured. Recalled memories may appear",
-    "in context via the context-engine assembler when available and relevant.",
+    "LibraVDB persistent memory is configured. Every turn is auto-ingested",
+    "into the vector store — you do not need to explicitly save anything.",
+    "When asked about past conversations, facts, preferences, decisions,",
+    "or anything the user might have told you before, call `memory_search`",
+    "once per user question. Do not answer from memory until you have",
+    "called it. Once you have results, use them — do not re-call.",
     "",
 ];
 function buildToolGuidance(availableTools) {
     if (!availableTools?.has("memory_search")) {
         return [];
     }
-    const lines = [
-        "For explicit memory lookup requests, call `memory_search` first.",
-        "Use it for prior turns, remembered facts, earliest interactions, and channel history.",
-        "Do not answer memory lookup requests from prior transcript claims or earlier `memory_search` results; perform a fresh `memory_search` for the current request.",
-        "For earliest or oldest memory questions, request enough results, compare timestamps in the returned snippets, and use `memory_get` if the snippet is not enough.",
+    return [
+        "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.",
+        "For earliest or oldest questions, request enough results and compare timestamps.",
+        ...(availableTools.has("memory_get")
+            ? ["After a `memory_search` hit, call `memory_get` when exact wording or more context is needed."]
+            : []),
+        "LibraVDB memory is vector-backed and retrieved through tools, not files.",
+        "",
     ];
-    if (availableTools.has("memory_get")) {
-        lines.push("After a `memory_search` hit, call `memory_get` when exact wording or more context is needed.");
-    }
-    lines.push("Do not treat a missing `MEMORY.md` file as missing memory; LibraVDB memory is vector-backed and retrieved through the memory tools.", "");
-    return lines;
 }
 export function buildMemoryPromptSection(_getClient, _cfg) {
     return function memoryPromptSection({ availableTools, citationsMode: _citationsMode, }) {

package/dist/memory-tools.js

@@ -80,7 +80,7 @@ export function createLibraVdbMemoryTools(getClient, cfg, logger = console) {
             return {
                 name: "memory_search",
                 label: "Memory Search",
-                description: "Mandatory fresh LibraVDB recall step: semantically search durable memory and session recall before answering questions about prior work, decisions, dates, people, preferences, todos, or history. Do not reuse prior transcript claims or older memory_search results for a new memory lookup. For earliest/oldest questions, request enough results and compare timestamps in snippets. If response has disabled=true, memory retrieval is unavailable and should be surfaced to the user.",
+                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. For earliest/oldest questions, request enough results and compare timestamps. If disabled=true, memory is unavailable.",
                 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": "Persistent vector memory with three-tier hybrid scoring",
-  "version": "1.6.31",
+  "version": "1.7.0",
   "kind": [
     "memory",
     "context-engine"

package/package.json

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