@xdarkicex/openclaw-memory-libravdb 1.6.14 → 1.6.16

package/README.md

@@ -33,6 +33,19 @@ brew install libravdbd
 brew services start libravdbd
 ```
 
+> **After upgrades:** Always restart the daemon so the newly installed binary takes effect:
+> ```bash
+> # macOS (Homebrew)
+> brew services restart libravdbd
+>
+> # Linux (systemd)
+> systemctl --user restart libravdbd
+>
+> # Linux (no systemd — kill and restart manually)
+> killall libravdbd && libravdbd &
+> ```
+> Failing to restart leaves the old process running — it will not auto-replace a live background service. If you see "Protocol error" or connection failures after an upgrade, this is almost always the cause.
+
 **Linux (APT)**
 
 ```bash

package/dist/context-engine.d.ts

@@ -99,5 +99,6 @@ export declare function buildContextEngineFactory(runtime: PluginRuntime, cfg: P
         tokenBudget?: number;
         runtimeContext?: Record<string, unknown>;
     }): Promise<import("@xdarkicex/libravdb-contracts").AfterTurnKernelResponse>;
+    dispose(): Promise<void>;
 };
 export {};

package/dist/context-engine.js

@@ -521,6 +521,7 @@ export function normalizeAssembleResult(result) {
 }
 export function buildContextEngineFactory(runtime, cfg, logger = console) {
     const predictiveContextCache = new Map();
+    const PREDICTIVE_CACHE_MAX_SIZE = 100;
     let cachedIdentity = null;
     let cachedSessionKey;
     function resolveUserId(args) {
@@ -743,6 +744,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
         ownsCompaction: true,
         async bootstrap(args) {
             const sessionId = requireSessionId(args.sessionId, "bootstrap");
+            predictiveContextCache.delete(sessionId);
             const userId = resolveUserId({
                 userIdOverride: args.userId,
                 sessionKey: args.sessionKey,
@@ -925,6 +927,11 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 });
                 const predictions = result.predictions;
                 if (Array.isArray(predictions) && predictions.length > 0) {
+                    if (predictiveContextCache.size >= PREDICTIVE_CACHE_MAX_SIZE) {
+                        const oldest = predictiveContextCache.keys().next().value;
+                        if (oldest !== undefined)
+                            predictiveContextCache.delete(oldest);
+                    }
                     predictiveContextCache.set(sessionId, predictions);
                 }
                 return result;
@@ -934,6 +941,9 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                     `${error instanceof Error ? error.message : String(error)}`);
                 throw error;
             }
-        }
+        },
+        async dispose() {
+            predictiveContextCache.clear();
+        },
     };
 }

package/dist/index.js

@@ -27036,6 +27036,7 @@ function normalizeAssembleResult(result) {
 }
 function buildContextEngineFactory(runtime, cfg, logger = console) {
   const predictiveContextCache = /* @__PURE__ */ new Map();
+  const PREDICTIVE_CACHE_MAX_SIZE = 100;
   let cachedIdentity = null;
   let cachedSessionKey;
   function resolveUserId(args) {
@@ -27245,6 +27246,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
     ownsCompaction: true,
     async bootstrap(args) {
       const sessionId = requireSessionId(args.sessionId, "bootstrap");
+      predictiveContextCache.delete(sessionId);
       const userId = resolveUserId({
         userIdOverride: args.userId,
         sessionKey: args.sessionKey
@@ -27438,6 +27440,10 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
         });
         const predictions = result.predictions;
         if (Array.isArray(predictions) && predictions.length > 0) {
+          if (predictiveContextCache.size >= PREDICTIVE_CACHE_MAX_SIZE) {
+            const oldest = predictiveContextCache.keys().next().value;
+            if (oldest !== void 0) predictiveContextCache.delete(oldest);
+          }
           predictiveContextCache.set(sessionId, predictions);
         }
         return result;
@@ -27447,6 +27453,9 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
         );
         throw error2;
       }
+    },
+    async dispose() {
+      predictiveContextCache.clear();
     }
   };
 }

package/dist/types.d.ts

@@ -19,13 +19,19 @@ export interface PluginConfig {
     /** Optional ONNX execution provider override passed through to libravdbd.
      *  Use "cpu" to bypass CoreML/MPS on Intel Macs or fragile GPU/NPU providers. */
     onnxDevice?: "auto" | "cpu" | "cuda" | "coreml" | "directml" | "openvino";
-    embeddingBackend?: "bundled" | "onnx-local" | "custom-local";
+    embeddingBackend?: "bundled" | "onnx-local" | "custom-local" | "remote";
     embeddingProfile?: string;
     fallbackProfile?: string;
     embeddingModelPath?: string;
     embeddingTokenizerPath?: string;
     embeddingDimensions?: number;
     embeddingNormalize?: boolean;
+    /** HTTP endpoint URL for the remote embedder backend (when embeddingBackend is 'remote') */
+    embeddingEndpoint?: string;
+    /** Model identifier for the remote embedder backend */
+    embeddingRemoteModel?: string;
+    /** API key for the remote embedder endpoint */
+    embeddingAPIKey?: string;
     summarizerBackend?: "bundled" | "onnx-local" | "ollama-local" | "custom-local";
     summarizerProfile?: string;
     summarizerRuntimePath?: string;

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.14",
+  "version": "1.6.16",
   "kind": [
     "memory",
     "context-engine"
@@ -19,6 +19,21 @@
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
+    "if": {
+      "properties": {
+        "embeddingBackend": {
+          "const": "remote"
+        }
+      },
+      "required": [
+        "embeddingBackend"
+      ]
+    },
+    "then": {
+      "required": [
+        "embeddingEndpoint"
+      ]
+    },
     "properties": {
       "dbPath": {
         "type": "string"
@@ -142,8 +157,10 @@
         "enum": [
           "bundled",
           "onnx-local",
-          "custom-local"
-        ]
+          "custom-local",
+          "remote"
+        ],
+        "description": "Embedder backend: bundled (built-in ONNX), onnx-local (local ONNX model), custom-local (custom ONNX), remote (HTTP API)"
       },
       "embeddingProfile": {
         "type": "string",
@@ -165,6 +182,18 @@
       "embeddingNormalize": {
         "type": "boolean"
       },
+      "embeddingEndpoint": {
+        "type": "string",
+        "description": "HTTP endpoint URL for the remote embedder backend (required when embeddingBackend is 'remote')"
+      },
+      "embeddingRemoteModel": {
+        "type": "string",
+        "description": "Model identifier used when embeddingBackend is 'remote', e.g. 'nomic-embed-text-v1.5'"
+      },
+      "embeddingAPIKey": {
+        "type": "string",
+        "description": "API key for the remote embedder endpoint (when embeddingBackend is 'remote')"
+      },
       "summarizerBackend": {
         "type": "string",
         "enum": [

package/package.json

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