@xdarkicex/openclaw-memory-libravdb 1.4.37 → 1.4.39

package/dist/cli.js

@@ -276,17 +276,27 @@ 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 minScore = normalizeNumber(opts?.minScore);
+        const minScore = explicitMinScore ?? resolveDefaultSearchMinScore(manager.status(), cfg);
         const results = (await manager.search({
             query,
             ...(maxResults ? { maxResults } : {}),
-            ...(minScore !== undefined ? { minScore } : {}),
+            minScore,
         }));
         if (opts?.json) {
             console.log(JSON.stringify({ results }, null, 2));
@@ -307,6 +317,9 @@ async function runSearch(runtime, cfg, queryArg, opts, logger) {
         process.exitCode = 1;
     }
 }
+function resolveDefaultSearchMinScore(status, cfg) {
+    return normalizeNumber(status?.gatingThreshold) ?? normalizeNumber(cfg.ingestionGateThreshold) ?? 0.35;
+}
 async function runFlush(runtime, opts, logger) {
     const namespace = resolveCliNamespace(opts);
     if (!namespace) {
@@ -332,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`);
@@ -347,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`);
@@ -396,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/index.js

@@ -33354,18 +33354,27 @@ 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 minScore = normalizeNumber2(opts?.minScore);
+    const minScore = explicitMinScore ?? resolveDefaultSearchMinScore(manager.status(), cfg);
     const results = await manager.search(
       {
         query,
         ...maxResults ? { maxResults } : {},
-        ...minScore !== void 0 ? { minScore } : {}
+        minScore
       }
     );
     if (opts?.json) {
@@ -33386,6 +33395,9 @@ async function runSearch(runtime, cfg, queryArg, opts, logger) {
     process.exitCode = 1;
   }
 }
+function resolveDefaultSearchMinScore(status, cfg) {
+  return normalizeNumber2(status?.gatingThreshold) ?? normalizeNumber2(cfg.ingestionGateThreshold) ?? 0.35;
+}
 async function runFlush(runtime, opts, logger) {
   const namespace = resolveCliNamespace(opts);
   if (!namespace) {
@@ -33410,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)}
@@ -33425,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)}
@@ -33474,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)) {
@@ -39548,7 +39585,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(
@@ -39653,6 +39690,16 @@ function register(api) {
       await dreamPromotion.stop();
     }
   });
+  api.registerRuntimeLifecycle?.({
+    id: "libravdb-shutdown",
+    description: "Shut down the vector service runtime on plugin disable",
+    async cleanup(ctx) {
+      if (ctx.reason === "disable") {
+        logger.info?.("LibraVDB disable \u2014 shutting down runtime");
+        await runtime.shutdown();
+      }
+    }
+  });
   api.on("before_reset", createBeforeResetHook(runtime, api.logger ?? console));
   api.on("session_end", createSessionEndHook(runtime, api.logger ?? console));
   api.on("agent_end", async (event) => {

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

package/package.json

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