@xdarkicex/openclaw-memory-libravdb 1.6.15 → 1.6.17

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();
     }
   };
 }
@@ -36569,6 +36578,55 @@ function resolveClientEndpoint(configuredEndpoint) {
   }
   return `unix:${path3.join(os3.homedir(), ".libravdbd", "run", sockName)}`;
 }
+function isLegacyJsonRpcHealthResponse(payload) {
+  try {
+    const parsed = JSON.parse(payload.trim());
+    return parsed.jsonrpc === "2.0" && parsed.result?.ok === true;
+  } catch {
+    return false;
+  }
+}
+async function detectLegacyJsonRpcDaemon(endpoint, timeoutMs = 500) {
+  if (!endpoint.startsWith("unix:")) {
+    return false;
+  }
+  const socketPath = endpoint.slice(5);
+  if (!socketPath) {
+    return false;
+  }
+  return await new Promise((resolve) => {
+    let settled = false;
+    let response = "";
+    const socket = net.createConnection(socketPath);
+    const finish = (value) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      clearTimeout(timer);
+      socket.removeAllListeners();
+      socket.destroy();
+      resolve(value);
+    };
+    const timer = setTimeout(() => finish(false), Math.max(1, timeoutMs));
+    timer.unref?.();
+    socket.setEncoding("utf8");
+    socket.on("connect", () => {
+      socket.write('{"jsonrpc":"2.0","id":1,"method":"health","params":{}}\n');
+    });
+    socket.on("data", (chunk) => {
+      response += chunk;
+      if (isLegacyJsonRpcHealthResponse(response)) {
+        finish(true);
+      } else if (response.length > 4096) {
+        finish(false);
+      }
+    });
+    socket.on("end", () => finish(isLegacyJsonRpcHealthResponse(response)));
+    socket.on("close", () => finish(isLegacyJsonRpcHealthResponse(response)));
+    socket.on("error", () => finish(false));
+  });
+}
 function createRpcMutex() {
   return {
     current: Promise.resolve(),
@@ -36627,11 +36685,15 @@ function createAuthInterceptor(state) {
 var LibravDBClient = class {
   client;
   secret;
+  endpoint;
+  legacyProbeTimeoutMs;
   nonceHex;
   closed = false;
   constructor(options = {}) {
     this.secret = options.secret ?? loadSecretFromEnv();
     const rawEndpoint = resolveClientEndpoint(options.endpoint);
+    this.endpoint = rawEndpoint;
+    this.legacyProbeTimeoutMs = Math.min(options.timeoutMs ?? 3e4, 1e3);
     const isUnix = rawEndpoint.startsWith("unix:");
     const socketPath = isUnix ? rawEndpoint.slice(5) : void 0;
     const credMode = resolveCredentialMode(rawEndpoint, options.tlsMode);
@@ -36687,8 +36749,14 @@ var LibravDBClient = class {
         }
       );
     } catch (error2) {
+      const detail = error2 instanceof Error ? error2.message : String(error2);
+      if (detail.includes("Protocol error") && await detectLegacyJsonRpcDaemon(this.endpoint, this.legacyProbeTimeoutMs)) {
+        throw new Error(
+          `LibraVDB: failed to handshake with daemon: ${detail}. The endpoint answered legacy JSON-RPC health; this plugin requires a gRPC-compatible libravdbd daemon. Update or restart libravdbd with gRPC support, or pin the plugin to a daemon-compatible release.`
+        );
+      }
       throw new Error(
-        `LibraVDB: failed to handshake with daemon: ${error2 instanceof Error ? error2.message : String(error2)}`
+        `LibraVDB: failed to handshake with daemon: ${detail}`
       );
     }
   }

package/dist/libravdb-client.d.ts

@@ -12,6 +12,8 @@ export interface LibravDBClientOptions {
     tlsClientKeyPath?: string;
 }
 export declare function resolveClientEndpoint(configuredEndpoint?: string): string;
+export declare function isLegacyJsonRpcHealthResponse(payload: string): boolean;
+export declare function detectLegacyJsonRpcDaemon(endpoint: string, timeoutMs?: number): Promise<boolean>;
 interface RpcMutex {
     current: Promise<void>;
     lock(): Promise<() => void>;
@@ -26,6 +28,8 @@ export declare function createAuthInterceptor(state: AuthInterceptorState): Inte
 export declare class LibravDBClient {
     private client;
     private readonly secret;
+    private readonly endpoint;
+    private readonly legacyProbeTimeoutMs;
     private nonceHex;
     private closed;
     constructor(options?: LibravDBClientOptions);

package/dist/libravdb-client.js

@@ -27,6 +27,57 @@ export function resolveClientEndpoint(configuredEndpoint) {
     }
     return `unix:${path.join(os.homedir(), ".libravdbd", "run", sockName)}`;
 }
+export function isLegacyJsonRpcHealthResponse(payload) {
+    try {
+        const parsed = JSON.parse(payload.trim());
+        return parsed.jsonrpc === "2.0" && parsed.result?.ok === true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function detectLegacyJsonRpcDaemon(endpoint, timeoutMs = 500) {
+    if (!endpoint.startsWith("unix:")) {
+        return false;
+    }
+    const socketPath = endpoint.slice(5);
+    if (!socketPath) {
+        return false;
+    }
+    return await new Promise((resolve) => {
+        let settled = false;
+        let response = "";
+        const socket = net.createConnection(socketPath);
+        const finish = (value) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            socket.removeAllListeners();
+            socket.destroy();
+            resolve(value);
+        };
+        const timer = setTimeout(() => finish(false), Math.max(1, timeoutMs));
+        timer.unref?.();
+        socket.setEncoding("utf8");
+        socket.on("connect", () => {
+            socket.write('{"jsonrpc":"2.0","id":1,"method":"health","params":{}}\n');
+        });
+        socket.on("data", (chunk) => {
+            response += chunk;
+            if (isLegacyJsonRpcHealthResponse(response)) {
+                finish(true);
+            }
+            else if (response.length > 4096) {
+                finish(false);
+            }
+        });
+        socket.on("end", () => finish(isLegacyJsonRpcHealthResponse(response)));
+        socket.on("close", () => finish(isLegacyJsonRpcHealthResponse(response)));
+        socket.on("error", () => finish(false));
+    });
+}
 function createRpcMutex() {
     return {
         current: Promise.resolve(),
@@ -92,11 +143,15 @@ export function createAuthInterceptor(state) {
 export class LibravDBClient {
     client;
     secret;
+    endpoint;
+    legacyProbeTimeoutMs;
     nonceHex;
     closed = false;
     constructor(options = {}) {
         this.secret = options.secret ?? loadSecretFromEnv();
         const rawEndpoint = resolveClientEndpoint(options.endpoint);
+        this.endpoint = rawEndpoint;
+        this.legacyProbeTimeoutMs = Math.min(options.timeoutMs ?? 30000, 1000);
         const isUnix = rawEndpoint.startsWith("unix:");
         const socketPath = isUnix ? rawEndpoint.slice(5) : undefined;
         const credMode = resolveCredentialMode(rawEndpoint, options.tlsMode);
@@ -151,7 +206,13 @@ export class LibravDBClient {
             });
         }
         catch (error) {
-            throw new Error(`LibraVDB: failed to handshake with daemon: ${error instanceof Error ? error.message : String(error)}`);
+            const detail = error instanceof Error ? error.message : String(error);
+            if (detail.includes("Protocol error") && await detectLegacyJsonRpcDaemon(this.endpoint, this.legacyProbeTimeoutMs)) {
+                throw new Error(`LibraVDB: failed to handshake with daemon: ${detail}. ` +
+                    "The endpoint answered legacy JSON-RPC health; this plugin requires a gRPC-compatible libravdbd daemon. " +
+                    "Update or restart libravdbd with gRPC support, or pin the plugin to a daemon-compatible release.");
+            }
+            throw new Error(`LibraVDB: failed to handshake with daemon: ${detail}`);
         }
     }
     guardOpen() {

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

package/package.json

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