@xdarkicex/openclaw-memory-libravdb 1.4.38 → 1.4.40

package/dist/cli.js

@@ -276,13 +276,22 @@ async function runSearch(runtime, cfg, queryArg, opts, logger) {
         process.exitCode = 1;
         return;
     }
+    let maxResults;
+    let explicitMinScore;
+    try {
+        maxResults = normalizeCliLimit(opts?.maxResults ?? opts?.limit, "--max-results");
+        explicitMinScore = normalizeCliScore(opts?.minScore, "--min-score");
+    }
+    catch (validationError) {
+        logger.error(formatError(validationError));
+        process.exitCode = 1;
+        return;
+    }
     try {
         const bridge = buildMemoryRuntimeBridge(runtime.getRpc, cfg);
         const { manager } = await bridge.getMemorySearchManager({
             agentId: opts?.agent,
         });
-        const maxResults = normalizeLimit(opts?.maxResults ?? opts?.limit);
-        const explicitMinScore = normalizeNumber(opts?.minScore);
         const minScore = explicitMinScore ?? resolveDefaultSearchMinScore(manager.status(), cfg);
         const results = (await manager.search({
             query,
@@ -336,10 +345,16 @@ async function runFlush(runtime, opts, logger) {
     }
 }
 async function runExport(runtime, opts, logger) {
+    const namespace = resolveCliNamespace(opts);
+    if (!namespace) {
+        logger.error("LibraVDB export requires a namespace. Provide --user-id or --session-key.");
+        process.exitCode = 1;
+        return;
+    }
     try {
         const rpc = await runtime.getRpc();
         const result = await rpc.call("export_memory", {
-            namespace: resolveCliNamespace(opts),
+            namespace,
         });
         for (const record of result.records ?? []) {
             stdout.write(`${JSON.stringify(record)}\n`);
@@ -351,11 +366,20 @@ async function runExport(runtime, opts, logger) {
     }
 }
 async function runJournal(runtime, opts, logger) {
+    let limit;
+    try {
+        limit = normalizeCliLimit(opts?.limit, "--limit");
+    }
+    catch (validationError) {
+        logger.error(formatError(validationError));
+        process.exitCode = 1;
+        return;
+    }
     try {
         const rpc = await runtime.getRpc();
         const result = await rpc.call("list_lifecycle_journal", {
             sessionId: opts?.sessionId?.trim() || undefined,
-            limit: normalizeLimit(opts?.limit),
+            limit,
         });
         for (const record of result.results ?? []) {
             stdout.write(`${JSON.stringify(record)}\n`);
@@ -400,17 +424,30 @@ function formatError(error) {
     }
     return String(error);
 }
-function normalizeLimit(limit) {
-    if (typeof limit === "number" && Number.isFinite(limit) && limit > 0) {
-        return Math.floor(limit);
+function normalizeCliLimit(limit, optionName) {
+    if (limit === undefined)
+        return undefined;
+    const parsed = parseStrictNumber(limit);
+    if (Number.isFinite(parsed) && Number.isInteger(parsed) && parsed > 0) {
+        return parsed;
     }
-    if (typeof limit === "string") {
-        const parsed = Number.parseInt(limit, 10);
-        if (Number.isFinite(parsed) && parsed > 0) {
-            return parsed;
-        }
+    throw new Error(`Invalid value for ${optionName}: must be a positive integer`);
+}
+function normalizeCliScore(value, optionName) {
+    if (value === undefined)
+        return undefined;
+    const parsed = parseStrictNumber(value);
+    if (Number.isFinite(parsed) && parsed >= 0 && parsed <= 1) {
+        return parsed;
     }
-    return undefined;
+    throw new Error(`Invalid value for ${optionName}: must be a number between 0 and 1`);
+}
+function parseStrictNumber(value) {
+    if (typeof value === "number") {
+        return value;
+    }
+    const trimmed = value.trim();
+    return trimmed === "" ? NaN : Number(trimmed);
 }
 function normalizeNumber(value) {
     if (typeof value === "number" && Number.isFinite(value)) {

package/dist/context-engine.d.ts

@@ -8,8 +8,9 @@ type KernelCompatibleMessage = {
 };
 type OpenClawCompatibleMessage = {
     role: string;
-    content: string;
+    content: string | unknown[];
     id?: string;
+    [key: string]: unknown;
 };
 type OpenClawCompatibleAssembleResult = {
     messages: OpenClawCompatibleMessage[];
@@ -76,11 +77,7 @@ export declare function buildContextEngineFactory(runtime: PluginRuntime, cfg: P
         sessionId: string;
         sessionKey?: string;
         userId?: string;
-        messages: Array<{
-            role: string;
-            content: unknown;
-            id?: string;
-        }>;
+        messages: OpenClawCompatibleMessage[];
         tokenBudget: number;
         prompt?: string;
         currentTokenCount?: number;
@@ -96,11 +93,7 @@ export declare function buildContextEngineFactory(runtime: PluginRuntime, cfg: P
         sessionId: string;
         sessionKey?: string;
         userId?: string;
-        messages: Array<{
-            role: string;
-            content: unknown;
-            id?: string;
-        }>;
+        messages: OpenClawCompatibleMessage[];
         prePromptMessageCount?: number;
         isHeartbeat?: boolean;
         tokenBudget?: number;

package/dist/context-engine.js

@@ -85,9 +85,13 @@ function normalizeKernelContent(content) {
     return content.map(stringifyKernelBlock).filter((part) => part.length > 0).join("\n");
 }
 function approximateTokenCount(text) {
-    if (!text)
+    if (typeof text === "string") {
+        return Math.ceil(text.length / APPROX_CHARS_PER_TOKEN);
+    }
+    if (!Array.isArray(text)) {
         return 0;
-    return Math.ceil(text.length / APPROX_CHARS_PER_TOKEN);
+    }
+    return Math.ceil(normalizeKernelContent(text).length / APPROX_CHARS_PER_TOKEN);
 }
 function approximateMessageTokens(message) {
     // Approximate per-message wrapper overhead so trimming is conservative.
@@ -162,10 +166,11 @@ function truncateContentToTokenBudget(content, tokenBudget) {
     if (tokenBudget <= 0)
         return "";
     const maxChars = Math.max(1, tokenBudget * APPROX_CHARS_PER_TOKEN);
-    if (content.length <= maxChars)
-        return content;
+    const normalized = normalizeKernelContent(content);
+    if (normalized.length <= maxChars)
+        return normalized;
     // Keep the tail so recent tool output / latest answer content is preserved.
-    return content.slice(content.length - maxChars);
+    return normalized.slice(normalized.length - maxChars);
 }
 function trimMessagesToBudget(messages, tokenBudget) {
     if (tokenBudget <= 0 || messages.length === 0) {
@@ -399,7 +404,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             return assembled;
         const existingBlocks = [
             assembled.systemPromptAddition,
-            ...assembled.messages.map((message) => message.content),
+            ...assembled.messages.map((message) => normalizeKernelContent(message.content)),
         ]
             .flatMap((block) => block.split(/\n+/))
             .map((block) => block.trim())
@@ -657,7 +662,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 if (!compactionResult.ok) {
                     logger.warn?.(`LibraVDB predictive compaction blocked assemble path at ${currentContextTokens} tokens ` +
                         `(threshold=${dynamicCompactThreshold}): ${compactionResult.reason ?? "compaction failed"}`);
-                    return buildBudgetFallbackContext(messages, args.tokenBudget);
+                    return buildBudgetFallbackContext(args.messages, args.tokenBudget);
                 }
             }
             const kernel = await getKernelOrNull("assemble");
@@ -682,7 +687,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 }
                 catch (error) {
                     logger.warn?.(`LibraVDB assemble kernel failed, using budget-clamped fallback context: ${error instanceof Error ? error.message : String(error)}`);
-                    return buildBudgetFallbackContext(messages, args.tokenBudget);
+                    return buildBudgetFallbackContext(args.messages, args.tokenBudget);
                 }
             }
             const rpc = await runtime.getRpc();
@@ -707,7 +712,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             }
             catch (error) {
                 logger.warn?.(`LibraVDB assemble sidecar failed, using budget-clamped fallback context: ${error instanceof Error ? error.message : String(error)}`);
-                return buildBudgetFallbackContext(messages, args.tokenBudget);
+                return buildBudgetFallbackContext(args.messages, args.tokenBudget);
             }
         },
         async compact(args) {

package/dist/index.js

@@ -33354,13 +33354,21 @@ async function runSearch(runtime, cfg, queryArg, opts, logger) {
     process.exitCode = 1;
     return;
   }
+  let maxResults;
+  let explicitMinScore;
+  try {
+    maxResults = normalizeCliLimit(opts?.maxResults ?? opts?.limit, "--max-results");
+    explicitMinScore = normalizeCliScore(opts?.minScore, "--min-score");
+  } catch (validationError) {
+    logger.error(formatError2(validationError));
+    process.exitCode = 1;
+    return;
+  }
   try {
     const bridge = buildMemoryRuntimeBridge(runtime.getRpc, cfg);
     const { manager } = await bridge.getMemorySearchManager({
       agentId: opts?.agent
     });
-    const maxResults = normalizeLimit(opts?.maxResults ?? opts?.limit);
-    const explicitMinScore = normalizeNumber2(opts?.minScore);
     const minScore = explicitMinScore ?? resolveDefaultSearchMinScore(manager.status(), cfg);
     const results = await manager.search(
       {
@@ -33414,10 +33422,16 @@ async function runFlush(runtime, opts, logger) {
   }
 }
 async function runExport(runtime, opts, logger) {
+  const namespace = resolveCliNamespace(opts);
+  if (!namespace) {
+    logger.error("LibraVDB export requires a namespace. Provide --user-id or --session-key.");
+    process.exitCode = 1;
+    return;
+  }
   try {
     const rpc = await runtime.getRpc();
     const result = await rpc.call("export_memory", {
-      namespace: resolveCliNamespace(opts)
+      namespace
     });
     for (const record of result.records ?? []) {
       stdout.write(`${JSON.stringify(record)}
@@ -33429,11 +33443,19 @@ async function runExport(runtime, opts, logger) {
   }
 }
 async function runJournal(runtime, opts, logger) {
+  let limit;
+  try {
+    limit = normalizeCliLimit(opts?.limit, "--limit");
+  } catch (validationError) {
+    logger.error(formatError2(validationError));
+    process.exitCode = 1;
+    return;
+  }
   try {
     const rpc = await runtime.getRpc();
     const result = await rpc.call("list_lifecycle_journal", {
       sessionId: opts?.sessionId?.trim() || void 0,
-      limit: normalizeLimit(opts?.limit)
+      limit
     });
     for (const record of result.results ?? []) {
       stdout.write(`${JSON.stringify(record)}
@@ -33478,17 +33500,28 @@ function formatError2(error) {
   }
   return String(error);
 }
-function normalizeLimit(limit) {
-  if (typeof limit === "number" && Number.isFinite(limit) && limit > 0) {
-    return Math.floor(limit);
+function normalizeCliLimit(limit, optionName) {
+  if (limit === void 0) return void 0;
+  const parsed = parseStrictNumber(limit);
+  if (Number.isFinite(parsed) && Number.isInteger(parsed) && parsed > 0) {
+    return parsed;
   }
-  if (typeof limit === "string") {
-    const parsed = Number.parseInt(limit, 10);
-    if (Number.isFinite(parsed) && parsed > 0) {
-      return parsed;
-    }
+  throw new Error(`Invalid value for ${optionName}: must be a positive integer`);
+}
+function normalizeCliScore(value, optionName) {
+  if (value === void 0) return void 0;
+  const parsed = parseStrictNumber(value);
+  if (Number.isFinite(parsed) && parsed >= 0 && parsed <= 1) {
+    return parsed;
   }
-  return void 0;
+  throw new Error(`Invalid value for ${optionName}: must be a number between 0 and 1`);
+}
+function parseStrictNumber(value) {
+  if (typeof value === "number") {
+    return value;
+  }
+  const trimmed = value.trim();
+  return trimmed === "" ? NaN : Number(trimmed);
 }
 function normalizeNumber2(value) {
   if (typeof value === "number" && Number.isFinite(value)) {
@@ -33631,8 +33664,13 @@ function normalizeKernelContent(content) {
   return content.map(stringifyKernelBlock).filter((part) => part.length > 0).join("\n");
 }
 function approximateTokenCount(text) {
-  if (!text) return 0;
-  return Math.ceil(text.length / APPROX_CHARS_PER_TOKEN);
+  if (typeof text === "string") {
+    return Math.ceil(text.length / APPROX_CHARS_PER_TOKEN);
+  }
+  if (!Array.isArray(text)) {
+    return 0;
+  }
+  return Math.ceil(normalizeKernelContent(text).length / APPROX_CHARS_PER_TOKEN);
 }
 function approximateMessageTokens(message) {
   return approximateTokenCount(message.content) + 8;
@@ -33698,8 +33736,9 @@ function logPredictiveCompactionOutcome(params) {
 function truncateContentToTokenBudget(content, tokenBudget) {
   if (tokenBudget <= 0) return "";
   const maxChars = Math.max(1, tokenBudget * APPROX_CHARS_PER_TOKEN);
-  if (content.length <= maxChars) return content;
-  return content.slice(content.length - maxChars);
+  const normalized = normalizeKernelContent(content);
+  if (normalized.length <= maxChars) return normalized;
+  return normalized.slice(normalized.length - maxChars);
 }
 function trimMessagesToBudget(messages, tokenBudget) {
   if (tokenBudget <= 0 || messages.length === 0) {
@@ -33919,7 +33958,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
     if (tokens.length === 0) return assembled;
     const existingBlocks = [
       assembled.systemPromptAddition,
-      ...assembled.messages.map((message) => message.content)
+      ...assembled.messages.map((message) => normalizeKernelContent(message.content))
     ].flatMap((block) => block.split(/\n+/)).map((block) => block.trim()).filter((block) => block.length > 0);
     const missingTokens = tokens.filter(
       (token) => !existingBlocks.some((block) => isExactRecallFact(block, token))
@@ -34161,7 +34200,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
           logger.warn?.(
             `LibraVDB predictive compaction blocked assemble path at ${currentContextTokens} tokens (threshold=${dynamicCompactThreshold}): ${compactionResult.reason ?? "compaction failed"}`
           );
-          return buildBudgetFallbackContext(messages, args.tokenBudget);
+          return buildBudgetFallbackContext(args.messages, args.tokenBudget);
         }
       }
       const kernel = await getKernelOrNull("assemble");
@@ -34190,7 +34229,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
           logger.warn?.(
             `LibraVDB assemble kernel failed, using budget-clamped fallback context: ${error instanceof Error ? error.message : String(error)}`
           );
-          return buildBudgetFallbackContext(messages, args.tokenBudget);
+          return buildBudgetFallbackContext(args.messages, args.tokenBudget);
         }
       }
       const rpc = await runtime.getRpc();
@@ -34219,7 +34258,7 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
         logger.warn?.(
           `LibraVDB assemble sidecar failed, using budget-clamped fallback context: ${error instanceof Error ? error.message : String(error)}`
         );
-        return buildBudgetFallbackContext(messages, args.tokenBudget);
+        return buildBudgetFallbackContext(args.messages, args.tokenBudget);
       }
     },
     async compact(args) {
@@ -39552,7 +39591,7 @@ function formatError5(error) {
 function enrichStartupError(error, healthMessage) {
   const rawMessage = error instanceof Error ? error.message : String(error);
   const message = rawMessage.trim() || "LibraVDB daemon startup failed";
-  if (message.includes("install and start libravdbd separately") || message.includes("package does not provision the daemon binary")) {
+  if (message.includes("package does not provision the daemon binary")) {
     return error instanceof Error ? error : new Error(message);
   }
   const shouldHint = /health check|daemon unavailable|connection refused|ECONNREFUSED|ENOENT|fallback mode|ONNX Runtime|embedder/i.test(

package/dist/plugin-runtime.js

@@ -133,7 +133,7 @@ function formatError(error) {
 export function enrichStartupError(error, healthMessage) {
     const rawMessage = error instanceof Error ? error.message : String(error);
     const message = rawMessage.trim() || "LibraVDB daemon startup failed";
-    if (message.includes("install and start libravdbd separately") || message.includes("package does not provision the daemon binary")) {
+    if (message.includes("package does not provision the daemon binary")) {
         return error instanceof Error ? error : new Error(message);
     }
     const shouldHint = /health check|daemon unavailable|connection refused|ECONNREFUSED|ENOENT|fallback mode|ONNX Runtime|embedder/i.test(`${message} ${healthMessage ?? ""}`);

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

package/package.json

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