@xdarkicex/openclaw-memory-libravdb 1.6.16 → 1.6.18

package/dist/context-engine.d.ts

@@ -12,10 +12,12 @@ type OpenClawCompatibleMessage = {
     id?: string;
     [key: string]: unknown;
 };
+type OpenClawCompatiblePromptAuthority = "preassembly_may_overflow";
 type OpenClawCompatibleAssembleResult = {
     messages: OpenClawCompatibleMessage[];
     estimatedTokens: number;
     systemPromptAddition: string;
+    promptAuthority: OpenClawCompatiblePromptAuthority;
     debug?: AssembleContextInternalResponse["debug"];
 };
 type OpenClawCompatibleCompactResult = {

package/dist/context-engine.js

@@ -1,6 +1,7 @@
 import { resolveIdentity } from "./identity.js";
 import { resolveUserCollection } from "./memory-scopes.js";
 const APPROX_CHARS_PER_TOKEN = 4;
+const PROMPT_AUTHORITY_PREASSEMBLY_MAY_OVERFLOW = "preassembly_may_overflow";
 const ASSEMBLE_BUDGET_HEADROOM_TOKENS = 256;
 const ASSEMBLE_BUDGET_HEADROOM_FRACTION = 0.2;
 const DEFAULT_COMPACTION_THRESHOLD_FRACTION = 0.8;
@@ -10,6 +11,7 @@ const QUOTED_PHRASE_RE = /"([^"]{4,})"|'([^']{4,})'/g;
 const EXACT_RECALL_SEARCH_K = 32;
 const EXACT_RECALL_MAX_TOKENS = 4;
 const RESERVED_CURRENT_TURN_TOKENS = 150;
+const AFTER_TURN_INGEST_MAX_TOKENS = 2048;
 const COMMON_QUERY_WORDS = new Set([
     "what", "does", "mean", "remember", "recall", "about", "this", "that",
     "the", "and", "for", "with", "from", "your", "have", "been", "were",
@@ -226,6 +228,18 @@ function trimMessagesToBudget(messages, tokenBudget) {
     }
     return [{ ...last, content: truncated }];
 }
+function boundAfterTurnMessagesForIngest(messages, logger, sessionId) {
+    const estimatedTokens = approximateMessagesTokens(messages);
+    if (estimatedTokens <= AFTER_TURN_INGEST_MAX_TOKENS) {
+        return messages;
+    }
+    const bounded = trimMessagesToBudget(messages, AFTER_TURN_INGEST_MAX_TOKENS)
+        .map((message) => normalizeKernelMessage(message));
+    logger.warn?.(`LibraVDB afterTurn trimmed oversized ingest payload sessionId=${sessionId} ` +
+        `estimatedTokens=${estimatedTokens} maxTokens=${AFTER_TURN_INGEST_MAX_TOKENS} ` +
+        `forwardedMessages=${bounded.length}`);
+    return bounded;
+}
 function enforceTokenBudgetInvariant(result, tokenBudget) {
     if (typeof tokenBudget !== "number" || !Number.isFinite(tokenBudget) || tokenBudget <= 0) {
         return result;
@@ -262,11 +276,19 @@ function buildBudgetFallbackContext(messages, tokenBudget) {
         messages: fallbackMessages,
         estimatedTokens: approximateMessagesTokens(fallbackMessages),
         systemPromptAddition: "",
+        promptAuthority: PROMPT_AUTHORITY_PREASSEMBLY_MAY_OVERFLOW,
     };
 }
 function resolvePredictiveCompactionTokenCount(args) {
-    return (normalizeCurrentTokenCount(args.currentTokenCount) ??
-        approximateMessagesTokens(args.messages) + approximateTokenCount(args.prompt ?? ""));
+    const currentTokenCount = normalizeCurrentTokenCount(args.currentTokenCount);
+    const sourcePressureEstimate = normalizeCurrentTokenCount(approximateMessagesTokens(args.messages) + approximateTokenCount(args.prompt ?? ""));
+    if (currentTokenCount == null) {
+        return sourcePressureEstimate ?? 1;
+    }
+    if (sourcePressureEstimate == null) {
+        return currentTokenCount;
+    }
+    return Math.max(currentTokenCount, sourcePressureEstimate);
 }
 function resolveAfterTurnPredictiveCompactionTokenCount(args) {
     const currentTokenCount = normalizeCurrentTokenCount(args.currentTokenCount);
@@ -516,6 +538,7 @@ export function normalizeAssembleResult(result) {
         messages,
         estimatedTokens: typeof result.estimatedTokens === "number" ? result.estimatedTokens : 0,
         systemPromptAddition: typeof result.systemPromptAddition === "string" ? result.systemPromptAddition : "",
+        promptAuthority: PROMPT_AUTHORITY_PREASSEMBLY_MAY_OVERFLOW,
         ...(result.debug != null ? { debug: result.debug } : {}),
     };
 }
@@ -902,6 +925,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             });
             const afterTurnMessages = selectAfterTurnMessages(args.messages, args.prePromptMessageCount, logger);
             const messages = normalizeKernelMessages(afterTurnMessages);
+            const ingestMessages = boundAfterTurnMessagesForIngest(messages, logger, sessionId);
             const msgCount = messages.length;
             logger.info?.(`LibraVDB afterTurn sessionId=${sessionId} userId=${userId} ` +
                 `messageCount=${msgCount} totalMessages=${args.messages.length} ` +
@@ -916,7 +940,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                     sessionId,
                     sessionKey: args.sessionKey,
                     userId,
-                    messages,
+                    messages: ingestMessages,
                     isHeartbeat: args.isHeartbeat,
                 });
                 await performAfterTurnPredictiveCompaction({

package/dist/index.js

@@ -26516,6 +26516,7 @@ function resolveCliMemoryOperationScope(opts) {
 
 // src/context-engine.ts
 var APPROX_CHARS_PER_TOKEN = 4;
+var PROMPT_AUTHORITY_PREASSEMBLY_MAY_OVERFLOW = "preassembly_may_overflow";
 var ASSEMBLE_BUDGET_HEADROOM_TOKENS = 256;
 var ASSEMBLE_BUDGET_HEADROOM_FRACTION = 0.2;
 var DEFAULT_COMPACTION_THRESHOLD_FRACTION = 0.8;
@@ -26525,6 +26526,7 @@ var QUOTED_PHRASE_RE = /"([^"]{4,})"|'([^']{4,})'/g;
 var EXACT_RECALL_SEARCH_K = 32;
 var EXACT_RECALL_MAX_TOKENS = 4;
 var RESERVED_CURRENT_TURN_TOKENS = 150;
+var AFTER_TURN_INGEST_MAX_TOKENS = 2048;
 var COMMON_QUERY_WORDS = /* @__PURE__ */ new Set([
   "what",
   "does",
@@ -26749,6 +26751,17 @@ function trimMessagesToBudget(messages, tokenBudget) {
   }
   return [{ ...last, content: truncated }];
 }
+function boundAfterTurnMessagesForIngest(messages, logger, sessionId) {
+  const estimatedTokens = approximateMessagesTokens(messages);
+  if (estimatedTokens <= AFTER_TURN_INGEST_MAX_TOKENS) {
+    return messages;
+  }
+  const bounded = trimMessagesToBudget(messages, AFTER_TURN_INGEST_MAX_TOKENS).map((message) => normalizeKernelMessage(message));
+  logger.warn?.(
+    `LibraVDB afterTurn trimmed oversized ingest payload sessionId=${sessionId} estimatedTokens=${estimatedTokens} maxTokens=${AFTER_TURN_INGEST_MAX_TOKENS} forwardedMessages=${bounded.length}`
+  );
+  return bounded;
+}
 function enforceTokenBudgetInvariant(result, tokenBudget) {
   if (typeof tokenBudget !== "number" || !Number.isFinite(tokenBudget) || tokenBudget <= 0) {
     return result;
@@ -26787,11 +26800,22 @@ function buildBudgetFallbackContext(messages, tokenBudget) {
   return {
     messages: fallbackMessages,
     estimatedTokens: approximateMessagesTokens(fallbackMessages),
-    systemPromptAddition: ""
+    systemPromptAddition: "",
+    promptAuthority: PROMPT_AUTHORITY_PREASSEMBLY_MAY_OVERFLOW
   };
 }
 function resolvePredictiveCompactionTokenCount(args) {
-  return normalizeCurrentTokenCount(args.currentTokenCount) ?? approximateMessagesTokens(args.messages) + approximateTokenCount(args.prompt ?? "");
+  const currentTokenCount = normalizeCurrentTokenCount(args.currentTokenCount);
+  const sourcePressureEstimate = normalizeCurrentTokenCount(
+    approximateMessagesTokens(args.messages) + approximateTokenCount(args.prompt ?? "")
+  );
+  if (currentTokenCount == null) {
+    return sourcePressureEstimate ?? 1;
+  }
+  if (sourcePressureEstimate == null) {
+    return currentTokenCount;
+  }
+  return Math.max(currentTokenCount, sourcePressureEstimate);
 }
 function resolveAfterTurnPredictiveCompactionTokenCount(args) {
   const currentTokenCount = normalizeCurrentTokenCount(args.currentTokenCount);
@@ -27031,6 +27055,7 @@ function normalizeAssembleResult(result) {
     messages,
     estimatedTokens: typeof result.estimatedTokens === "number" ? result.estimatedTokens : 0,
     systemPromptAddition: typeof result.systemPromptAddition === "string" ? result.systemPromptAddition : "",
+    promptAuthority: PROMPT_AUTHORITY_PREASSEMBLY_MAY_OVERFLOW,
     ...result.debug != null ? { debug: result.debug } : {}
   };
 }
@@ -27416,6 +27441,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
       });
       const afterTurnMessages = selectAfterTurnMessages(args.messages, args.prePromptMessageCount, logger);
       const messages = normalizeKernelMessages(afterTurnMessages);
+      const ingestMessages = boundAfterTurnMessagesForIngest(messages, logger, sessionId);
       const msgCount = messages.length;
       logger.info?.(
         `LibraVDB afterTurn sessionId=${sessionId} userId=${userId} messageCount=${msgCount} totalMessages=${args.messages.length} prePromptMessageCount=${args.prePromptMessageCount ?? "unknown"} heartbeat=${args.isHeartbeat ?? false}`
@@ -27429,7 +27455,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
           sessionId,
           sessionKey: args.sessionKey,
           userId,
-          messages,
+          messages: ingestMessages,
           isHeartbeat: args.isHeartbeat
         });
         await performAfterTurnPredictiveCompaction({
@@ -36578,6 +36604,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(),
@@ -36636,11 +36711,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);
@@ -36696,8 +36775,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.16",
+  "version": "1.6.18",
   "kind": [
     "memory",
     "context-engine"

package/package.json

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