@xdarkicex/openclaw-memory-libravdb 1.8.7 → 1.8.9

package/dist/context-engine.js

@@ -11,7 +11,7 @@ const DEFAULT_COMPACTION_THRESHOLD_FRACTION = 0.8;
 const STRUCTURED_MARKER_RE = /\b[A-Z][A-Z0-9]*(?:_[A-Z0-9]+){2,}_\d{6,}\b/g;
 const DISTINCTIVE_IDENTIFIER_RE = /\b([A-Za-z][A-Za-z0-9]*(?:[_-][A-Za-z0-9]+){1,})\b/g;
 const QUOTED_PHRASE_RE = /"([^"]{4,})"|'([^']{4,})'/g;
-const EXACT_RECALL_SEARCH_K = 32;
+const EXACT_RECALL_SEARCH_K = 10;
 const EXACT_RECALL_MAX_TOKENS = 4;
 const RESERVED_CURRENT_TURN_TOKENS = 150;
 const AFTER_TURN_INGEST_MAX_TOKENS = 2048;
@@ -1265,6 +1265,13 @@ const SUBAGENT_BUDGET_MAX = 200;
 function subagentKey(sessionKey) {
     return sessionKey.trim();
 }
+function normalizeSubagentTokenBudget(value) {
+    if (typeof value !== "number")
+        return 8000;
+    if (!Number.isFinite(value) || value < 0)
+        return 8000;
+    return Math.floor(value);
+}
 // consumeSubagentBudget deducts tokens from the subagent's budget.
 // Returns the granted budget, or -1 if no budget exists (not a subagent).
 export function consumeSubagentBudget(sessionKey, tokens) {
@@ -1283,7 +1290,14 @@ export function consumeSubagentBudget(sessionKey, tokens) {
     const budget = subagentBudgets.get(subagentKey(sessionKey));
     if (!budget)
         return -1; // not a subagent — no budget cap
-    const granted = Math.min(tokens, budget.remaining);
+    const requested = Math.floor(tokens);
+    if (!Number.isFinite(requested) || requested <= 0)
+        return 0;
+    if (!Number.isFinite(budget.remaining) || budget.remaining <= 0) {
+        budget.remaining = 0;
+        return 0;
+    }
+    const granted = Math.min(requested, budget.remaining);
     budget.remaining = Math.max(0, budget.remaining - granted);
     return granted;
 }
@@ -1628,15 +1642,20 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
     }
     async function injectContinuityContext(params) {
         try {
+            // Use a natural-language query that semantically matches the
+            // pointer record text ("Previous session continuity — ...").
+            // Fetch enough results so the exact ID match isn't crowded out
+            // by stronger semantic hits in the user collection.
             const continuityHits = await params.client.searchTextCollections({
                 collections: [resolveUserCollection(params.userId)],
-                text: "__session_continuity__",
-                k: 1,
+                text: "previous session context continuity",
+                k: 8,
                 excludeByCollection: {},
             });
             const continuityHit = continuityHits.results?.find((r) => r.id === "__session_continuity__");
-            if (!continuityHit)
-                return null;
+            if (!continuityHit) {
+                return '<continuity_context>\nNo prior session context available. Use memory_search to recall previous conversations.\n</continuity_context>';
+            }
             let meta = {};
             if (continuityHit.metadataJson && continuityHit.metadataJson.length > 0) {
                 try {
@@ -1645,15 +1664,17 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 catch { /* metadata parse failed, use empty */ }
             }
             const summaryId = meta.summary_id;
-            if (!summaryId)
-                return null;
+            if (!summaryId) {
+                const sid = meta.session_id ?? params.sessionId;
+                return '<continuity_context>\nThe previous session (' + sid + ') was not compacted. Use memory_search with queries about what was discussed to recall context.\n</continuity_context>';
+            }
             const expanded = await params.client.expandSummary({
                 sessionId: meta.session_id ?? params.sessionId,
                 summaryId,
                 maxDepth: 2,
             });
             if (!expanded.text)
-                return null;
+                return '<continuity_context>\nFailed to expand prior session summary. Use memory_search to recall previous conversations.\n</continuity_context>';
             return '<continuity_context>\nThe following is a summary of the previous session. Use it for context about what was discussed before the reset.\n' + expanded.text + '\n</continuity_context>';
         }
         catch {
@@ -2104,9 +2125,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             // Grant the subagent a token budget for memory expansion.
             // Default 8000 tokens — enough for a focused expansion,
             // small enough to prevent context window destruction.
-            const budget = typeof cfg.subagentTokenBudget === "number"
-                ? cfg.subagentTokenBudget
-                : 8000;
+            const budget = normalizeSubagentTokenBudget(cfg.subagentTokenBudget);
             const seconds = typeof params.ttlMs === "number" && params.ttlMs > 0
                 ? Math.ceil(params.ttlMs / 1000)
                 : 120;

package/dist/index.js

@@ -26761,7 +26761,7 @@ var DEFAULT_COMPACTION_THRESHOLD_FRACTION = 0.8;
 var STRUCTURED_MARKER_RE = /\b[A-Z][A-Z0-9]*(?:_[A-Z0-9]+){2,}_\d{6,}\b/g;
 var DISTINCTIVE_IDENTIFIER_RE = /\b([A-Za-z][A-Za-z0-9]*(?:[_-][A-Za-z0-9]+){1,})\b/g;
 var QUOTED_PHRASE_RE = /"([^"]{4,})"|'([^']{4,})'/g;
-var EXACT_RECALL_SEARCH_K = 32;
+var EXACT_RECALL_SEARCH_K = 10;
 var EXACT_RECALL_MAX_TOKENS = 4;
 var RESERVED_CURRENT_TURN_TOKENS = 150;
 var AFTER_TURN_INGEST_MAX_TOKENS = 2048;
@@ -27807,6 +27807,11 @@ var SUBAGENT_BUDGET_MAX = 200;
 function subagentKey(sessionKey) {
   return sessionKey.trim();
 }
+function normalizeSubagentTokenBudget(value) {
+  if (typeof value !== "number") return 8e3;
+  if (!Number.isFinite(value) || value < 0) return 8e3;
+  return Math.floor(value);
+}
 function consumeSubagentBudget(sessionKey, tokens) {
   const now = Date.now();
   for (const [key, b] of subagentBudgets) {
@@ -27818,7 +27823,13 @@ function consumeSubagentBudget(sessionKey, tokens) {
   }
   const budget = subagentBudgets.get(subagentKey(sessionKey));
   if (!budget) return -1;
-  const granted = Math.min(tokens, budget.remaining);
+  const requested = Math.floor(tokens);
+  if (!Number.isFinite(requested) || requested <= 0) return 0;
+  if (!Number.isFinite(budget.remaining) || budget.remaining <= 0) {
+    budget.remaining = 0;
+    return 0;
+  }
+  const granted = Math.min(requested, budget.remaining);
   budget.remaining = Math.max(0, budget.remaining - granted);
   return granted;
 }
@@ -28148,14 +28159,16 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
     try {
       const continuityHits = await params.client.searchTextCollections({
         collections: [resolveUserCollection(params.userId)],
-        text: "__session_continuity__",
-        k: 1,
+        text: "previous session context continuity",
+        k: 8,
         excludeByCollection: {}
       });
       const continuityHit = continuityHits.results?.find(
         (r) => r.id === "__session_continuity__"
       );
-      if (!continuityHit) return null;
+      if (!continuityHit) {
+        return "<continuity_context>\nNo prior session context available. Use memory_search to recall previous conversations.\n</continuity_context>";
+      }
       let meta = {};
       if (continuityHit.metadataJson && continuityHit.metadataJson.length > 0) {
         try {
@@ -28164,13 +28177,16 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
         }
       }
       const summaryId = meta.summary_id;
-      if (!summaryId) return null;
+      if (!summaryId) {
+        const sid = meta.session_id ?? params.sessionId;
+        return "<continuity_context>\nThe previous session (" + sid + ") was not compacted. Use memory_search with queries about what was discussed to recall context.\n</continuity_context>";
+      }
       const expanded = await params.client.expandSummary({
         sessionId: meta.session_id ?? params.sessionId,
         summaryId,
         maxDepth: 2
       });
-      if (!expanded.text) return null;
+      if (!expanded.text) return "<continuity_context>\nFailed to expand prior session summary. Use memory_search to recall previous conversations.\n</continuity_context>";
       return "<continuity_context>\nThe following is a summary of the previous session. Use it for context about what was discussed before the reset.\n" + expanded.text + "\n</continuity_context>";
     } catch {
       return null;
@@ -28621,7 +28637,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
       }
     },
     async prepareSubagentSpawn(params) {
-      const budget = typeof cfg.subagentTokenBudget === "number" ? cfg.subagentTokenBudget : 8e3;
+      const budget = normalizeSubagentTokenBudget(cfg.subagentTokenBudget);
       const seconds = typeof params.ttlMs === "number" && params.ttlMs > 0 ? Math.ceil(params.ttlMs / 1e3) : 120;
       const key = subagentKey(params.childSessionKey);
       subagentBudgets.set(key, {
@@ -36120,7 +36136,7 @@ function createMemoryDescribeTool(getClient, getSessionId = () => void 0, logger
     }
   };
 }
-function createMemoryExpandTool(getClient, getSessionKey, logger = console) {
+function createMemoryExpandTool(getClient, getSessionKey, logger = console, getSessionId = () => void 0) {
   return {
     name: "memory_expand",
     label: "Memory Expand",
@@ -36133,7 +36149,7 @@ function createMemoryExpandTool(getClient, getSessionKey, logger = console) {
       if (summaryIds.length === 0) throw new Error("memory_expand requires at least one summaryId");
       const maxDepth = readNum(params, "maxDepth", { integer: true, min: 0 }) ?? 1;
       let maxTokens = readNum(params, "maxTokens", { integer: true }) ?? MAX_EXPAND_TOKENS;
-      const sessionId = readStr(params, "sessionId") ?? "";
+      const sessionId = readStr(params, "sessionId") ?? getSessionId() ?? "";
       const sessionKey = getSessionKey();
       if (sessionKey) {
         const grantedTokens = consumeSubagentBudget(sessionKey, maxTokens);
@@ -40017,7 +40033,8 @@ function register(api) {
     api.registerTool?.((ctx) => {
       const getClient = runtimeOrNull.getClient;
       const getSessionKey = () => ctx.sessionKey;
-      return createMemoryExpandTool(getClient, getSessionKey, logger);
+      const getSessionId = () => ctx.sessionId;
+      return createMemoryExpandTool(getClient, getSessionKey, logger, getSessionId);
     }, { names: ["memory_expand"] });
     api.registerTool?.((ctx) => {
       const getClient = runtimeOrNull.getClient;

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

@@ -67,7 +67,7 @@ export declare function createMemoryDescribeTool(getClient: ClientGetter, getSes
     };
     execute: (_toolCallId: string, rawParams: unknown) => Promise<ToolResult<MemoryDescribeDetails>>;
 };
-export declare function createMemoryExpandTool(getClient: ClientGetter, getSessionKey: () => string | undefined, logger?: LoggerLike): {
+export declare function createMemoryExpandTool(getClient: ClientGetter, getSessionKey: () => string | undefined, logger?: LoggerLike, getSessionId?: () => string | undefined): {
     name: string;
     label: string;
     description: string;

package/dist/tools/memory-recall.js

@@ -187,7 +187,7 @@ export function createMemoryDescribeTool(getClient, getSessionId = () => undefin
         },
     };
 }
-export function createMemoryExpandTool(getClient, getSessionKey, logger = console) {
+export function createMemoryExpandTool(getClient, getSessionKey, logger = console, getSessionId = () => undefined) {
     return {
         name: "memory_expand",
         label: "Memory Expand",
@@ -204,7 +204,7 @@ export function createMemoryExpandTool(getClient, getSessionKey, logger = consol
                 throw new Error("memory_expand requires at least one summaryId");
             const maxDepth = readNum(params, "maxDepth", { integer: true, min: 0 }) ?? 1;
             let maxTokens = readNum(params, "maxTokens", { integer: true }) ?? MAX_EXPAND_TOKENS;
-            const sessionId = readStr(params, "sessionId") ?? "";
+            const sessionId = readStr(params, "sessionId") ?? getSessionId() ?? "";
             // Subagent budget gate: if this is a subagent, check remaining expansion budget.
             const sessionKey = getSessionKey();
             if (sessionKey) {

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.8.7",
+  "version": "1.8.9",
   "kind": [
     "memory",
     "context-engine"
@@ -12,7 +12,10 @@
     "contextEngine": true,
     "tools": [
       "memory_search",
-      "memory_get"
+      "memory_get",
+      "memory_describe",
+      "memory_expand",
+      "memory_grep"
     ]
   },
   "activation": {

package/package.json

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