@xdarkicex/openclaw-memory-libravdb 1.6.18 → 1.6.19

package/README.md

@@ -49,6 +49,9 @@ brew services start libravdbd
 **Linux (APT)**
 
 ```bash
+curl -fsSL https://xDarkicex.github.io/apt-libravdbd/gpg.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/libravdbd.gpg
+echo "deb https://xDarkicex.github.io/apt-libravdbd stable main" | sudo tee /etc/apt/sources.list.d/libravdbd.list
+sudo apt update
 sudo apt install libravdbd
 systemctl --user enable --now libravdbd
 ```

package/dist/context-engine.d.ts

@@ -90,6 +90,9 @@ export declare function buildContextEngineFactory(runtime: PluginRuntime, cfg: P
         targetSize?: number;
         tokenBudget?: number;
         currentTokenCount?: number;
+        compactionTarget?: "budget" | "threshold";
+        runtimeContext?: Record<string, unknown>;
+        abortSignal?: AbortSignal;
     }): Promise<OpenClawCompatibleCompactResult>;
     afterTurn(args: {
         sessionId: string;

package/dist/context-engine.js

@@ -173,6 +173,13 @@ function resolvePredictiveCompactionTarget(params) {
         ? belowThresholdTarget
         : Math.max(1, currentTokenCount - 1);
 }
+function readRuntimeNumber(runtimeContext, key) {
+    const value = runtimeContext?.[key];
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function isManualCompactionRequested(runtimeContext) {
+    return runtimeContext?.manualCompaction === true;
+}
 function logPredictiveCompactionAttempt(params) {
     params.logger.info?.(`LibraVDB predictive compaction trigger phase=${params.phase} sessionId=${params.sessionId} ` +
         `currentTokenCount=${params.currentTokenCount} threshold=${params.threshold} ` +
@@ -915,7 +922,39 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             }
         },
         async compact(args) {
-            return await runCompaction(args);
+            const tokenBudget = normalizeTokenBudget(args.tokenBudget) ??
+                normalizeTokenBudget(readRuntimeNumber(args.runtimeContext, "tokenBudget"));
+            const currentTokenCount = normalizeCurrentTokenCount(args.currentTokenCount) ??
+                normalizeCurrentTokenCount(readRuntimeNumber(args.runtimeContext, "currentTokenCount"));
+            const forceCompaction = args.force === true || isManualCompactionRequested(args.runtimeContext);
+            const threshold = getDynamicCompactThreshold(tokenBudget);
+            if (!forceCompaction &&
+                currentTokenCount != null &&
+                threshold != null &&
+                currentTokenCount < threshold) {
+                return {
+                    ok: true,
+                    compacted: false,
+                    reason: "below threshold",
+                    result: {
+                        tokensBefore: currentTokenCount,
+                        details: {
+                            threshold,
+                            targetTokens: args.compactionTarget === "threshold" ? threshold : tokenBudget,
+                        },
+                    },
+                };
+            }
+            const runArgs = {
+                ...args,
+                force: forceCompaction || args.force,
+                ...(tokenBudget != null ? { tokenBudget } : {}),
+                ...(currentTokenCount != null ? { currentTokenCount } : {}),
+                ...(args.compactionTarget === "threshold" && threshold != null
+                    ? { targetSize: threshold }
+                    : {}),
+            };
+            return await runCompaction(runArgs);
         },
         async afterTurn(args) {
             const sessionId = requireSessionId(args.sessionId, "afterTurn");

package/dist/index.js

@@ -26702,6 +26702,13 @@ function resolvePredictiveCompactionTarget(params) {
   const belowThresholdTarget = Math.max(1, threshold - 1);
   return belowThresholdTarget < currentTokenCount ? belowThresholdTarget : Math.max(1, currentTokenCount - 1);
 }
+function readRuntimeNumber(runtimeContext, key) {
+  const value = runtimeContext?.[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function isManualCompactionRequested(runtimeContext) {
+  return runtimeContext?.manualCompaction === true;
+}
 function logPredictiveCompactionAttempt(params) {
   params.logger.info?.(
     `LibraVDB predictive compaction trigger phase=${params.phase} sessionId=${params.sessionId} currentTokenCount=${params.currentTokenCount} threshold=${params.threshold} targetSize=${params.targetSize} tokenBudget=${params.tokenBudget ?? "unknown"}`
@@ -27431,7 +27438,32 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
       }
     },
     async compact(args) {
-      return await runCompaction(args);
+      const tokenBudget = normalizeTokenBudget(args.tokenBudget) ?? normalizeTokenBudget(readRuntimeNumber(args.runtimeContext, "tokenBudget"));
+      const currentTokenCount = normalizeCurrentTokenCount(args.currentTokenCount) ?? normalizeCurrentTokenCount(readRuntimeNumber(args.runtimeContext, "currentTokenCount"));
+      const forceCompaction = args.force === true || isManualCompactionRequested(args.runtimeContext);
+      const threshold = getDynamicCompactThreshold(tokenBudget);
+      if (!forceCompaction && currentTokenCount != null && threshold != null && currentTokenCount < threshold) {
+        return {
+          ok: true,
+          compacted: false,
+          reason: "below threshold",
+          result: {
+            tokensBefore: currentTokenCount,
+            details: {
+              threshold,
+              targetTokens: args.compactionTarget === "threshold" ? threshold : tokenBudget
+            }
+          }
+        };
+      }
+      const runArgs = {
+        ...args,
+        force: forceCompaction || args.force,
+        ...tokenBudget != null ? { tokenBudget } : {},
+        ...currentTokenCount != null ? { currentTokenCount } : {},
+        ...args.compactionTarget === "threshold" && threshold != null ? { targetSize: threshold } : {}
+      };
+      return await runCompaction(runArgs);
     },
     async afterTurn(args) {
       const sessionId = requireSessionId(args.sessionId, "afterTurn");

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.18",
+  "version": "1.6.19",
   "kind": [
     "memory",
     "context-engine"

package/package.json

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