@xdarkicex/openclaw-memory-libravdb 1.8.5 → 1.8.7

package/README.md

@@ -318,12 +318,22 @@ libravdbd migrate --from ~/.libravdbd/data.libravdb --tenant <tenantId>
 
 ## Vector Service Configuration (YAML) & Kubernetes
 
-`libravdbd` is heavily configurable via environment variables or a YAML configuration file. The vector service looks for `config.yaml` in this order:
-1. `LIBRAVDB_CONFIG=/path/to/config.yaml`
+`libravdbd` is configured via environment variables or a YAML configuration file. The vector service looks for a config file in this order:
+
+1. `LIBRAVDB_CONFIG=/path/to/config.yaml` (env var — set this for custom paths)
 2. `/etc/libravdbd/config.yaml`
 3. `~/.libravdbd/config.yaml`
 
-Example `config.yaml` for a Kubernetes StatefulSet deployment in multi-tenant mode:
+Env vars override YAML values. All fields are optional — the daemon ships with sensible defaults.
+
+**Reference YAML files:**
+
+| Backend | File | Description |
+|---------|------|-------------|
+| GGUF (recommended) | [`docs/yaml/default-gguf.yaml`](docs/yaml/default-gguf.yaml) | llama.cpp backend, 3-5x faster on CPU |
+| ONNX (fallback) | [`docs/yaml/default-onnx.yaml`](docs/yaml/default-onnx.yaml) | ONNX Runtime backend, wider platform support |
+
+**Kubernetes example** (multi-tenant mode with GGUF):
 
 ```yaml
 # /etc/libravdbd/config.yaml
@@ -333,6 +343,7 @@ tenant_max_open: 128
 grpc_endpoint: "tcp:0.0.0.0:9090"
 embedding_backend: "gguf"
 embedding_profile: "nomic-embed-text-v1.5"
+llama_lib_path: "/var/lib/libravdbd/models/llama/llama-linux-amd64/lib/libllama.so"
 drain_timeout: "25s" # Must be less than k8s terminationGracePeriodSeconds
 ```
 
@@ -480,3 +491,4 @@ service checkout. For the full source workflow, read [Development](./docs/develo
 - default data path: `$HOME/.libravdbd/data_nomic-embed-text-v1_5.libravdb`
 - default macOS/Linux endpoint: `unix:$HOME/.libravdbd/run/libravdb.sock`
 - default Windows endpoint: `tcp:127.0.0.1:37421`
+

package/dist/context-engine.d.ts

@@ -124,7 +124,11 @@ export declare function buildContextEngineFactory(runtime: PluginRuntime, cfg: P
         isHeartbeat?: boolean;
         tokenBudget?: number;
         runtimeContext?: Record<string, unknown>;
-    }): Promise<import("@xdarkicex/libravdb-contracts").AfterTurnKernelResponse>;
+    }): Promise<import("@xdarkicex/libravdb-contracts").AfterTurnKernelResponse | {
+        ok: boolean;
+        skipped: boolean;
+        reason: string;
+    }>;
     prepareSubagentSpawn(params: {
         parentSessionKey: string;
         childSessionKey: string;

package/dist/context-engine.js

@@ -1626,6 +1626,40 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 : {}),
         };
     }
+    async function injectContinuityContext(params) {
+        try {
+            const continuityHits = await params.client.searchTextCollections({
+                collections: [resolveUserCollection(params.userId)],
+                text: "__session_continuity__",
+                k: 1,
+                excludeByCollection: {},
+            });
+            const continuityHit = continuityHits.results?.find((r) => r.id === "__session_continuity__");
+            if (!continuityHit)
+                return null;
+            let meta = {};
+            if (continuityHit.metadataJson && continuityHit.metadataJson.length > 0) {
+                try {
+                    meta = JSON.parse(new TextDecoder().decode(continuityHit.metadataJson));
+                }
+                catch { /* metadata parse failed, use empty */ }
+            }
+            const summaryId = meta.summary_id;
+            if (!summaryId)
+                return null;
+            const expanded = await params.client.expandSummary({
+                sessionId: meta.session_id ?? params.sessionId,
+                summaryId,
+                maxDepth: 2,
+            });
+            if (!expanded.text)
+                return null;
+            return '<continuity_context>\nThe following is a summary of the previous session. Use it for context about what was discussed before the reset.\n' + expanded.text + '\n</continuity_context>';
+        }
+        catch {
+            return null;
+        }
+    }
     async function runCompaction(args) {
         const request = buildCompactSessionRequest(args);
         try {
@@ -1857,7 +1891,18 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                     emitDebug: true,
                 });
                 const assembled = normalizeAssembleResult(resp, args.messages);
-                let enforced = enforceTokenBudgetInvariant(await augmentWithExactRecall(assembled, {
+                const continuityContext = await injectContinuityContext({
+                    client,
+                    userId,
+                    sessionId,
+                    logger,
+                    tokenBudget: args.tokenBudget,
+                    systemPromptAddition: assembled.systemPromptAddition,
+                });
+                const withContinuity = continuityContext
+                    ? { ...assembled, systemPromptAddition: appendSystemPromptAddition(assembled.systemPromptAddition, continuityContext) }
+                    : assembled;
+                let enforced = enforceTokenBudgetInvariant(await augmentWithExactRecall(withContinuity, {
                     queryText: strippedPrompt || (messages[messages.length - 1]?.content ?? ""),
                     userId,
                     sessionId,
@@ -1974,6 +2019,11 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 `overlapIndex=${overlapIndex} startIndex=${startIndex} ` +
                 `prePromptMessageCount=${args.prePromptMessageCount ?? "unknown"} ` +
                 `heartbeat=${args.isHeartbeat ?? false}`);
+            if (newMessages.length === 0) {
+                logger.info?.(`LibraVDB afterTurn skipped sessionId=${sessionId} reason=no-new-messages ` +
+                    `messageCount=${messages.length} overlapIndex=${overlapIndex}`);
+                return { ok: true, skipped: true, reason: "no-new-messages" };
+            }
             try {
                 const client = await runtime.getClient();
                 const currentTokenCount = normalizeCurrentTokenCount(typeof args.runtimeContext?.currentTokenCount === "number"

package/dist/index.js

@@ -28144,6 +28144,38 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
       ...typeof cfg.continuityPriorContextTokens === "number" ? { continuityPriorContextTokens: cfg.continuityPriorContextTokens } : {}
     };
   }
+  async function injectContinuityContext(params) {
+    try {
+      const continuityHits = await params.client.searchTextCollections({
+        collections: [resolveUserCollection(params.userId)],
+        text: "__session_continuity__",
+        k: 1,
+        excludeByCollection: {}
+      });
+      const continuityHit = continuityHits.results?.find(
+        (r) => r.id === "__session_continuity__"
+      );
+      if (!continuityHit) return null;
+      let meta = {};
+      if (continuityHit.metadataJson && continuityHit.metadataJson.length > 0) {
+        try {
+          meta = JSON.parse(new TextDecoder().decode(continuityHit.metadataJson));
+        } catch {
+        }
+      }
+      const summaryId = meta.summary_id;
+      if (!summaryId) return null;
+      const expanded = await params.client.expandSummary({
+        sessionId: meta.session_id ?? params.sessionId,
+        summaryId,
+        maxDepth: 2
+      });
+      if (!expanded.text) return null;
+      return "<continuity_context>\nThe following is a summary of the previous session. Use it for context about what was discussed before the reset.\n" + expanded.text + "\n</continuity_context>";
+    } catch {
+      return null;
+    }
+  }
   async function runCompaction(args) {
     const request3 = buildCompactSessionRequest(args);
     try {
@@ -28376,8 +28408,17 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
           emitDebug: true
         });
         const assembled = normalizeAssembleResult(resp, args.messages);
+        const continuityContext = await injectContinuityContext({
+          client,
+          userId,
+          sessionId,
+          logger,
+          tokenBudget: args.tokenBudget,
+          systemPromptAddition: assembled.systemPromptAddition
+        });
+        const withContinuity = continuityContext ? { ...assembled, systemPromptAddition: appendSystemPromptAddition(assembled.systemPromptAddition, continuityContext) } : assembled;
         let enforced = enforceTokenBudgetInvariant(
-          await augmentWithExactRecall(assembled, {
+          await augmentWithExactRecall(withContinuity, {
             queryText: strippedPrompt || (messages[messages.length - 1]?.content ?? ""),
             userId,
             sessionId,
@@ -28501,6 +28542,12 @@ function buildContextEngineFactory(runtime, cfg, logger = console) {
       logger.info?.(
         `LibraVDB afterTurn sessionId=${sessionId} userId=${userId} messageCount=${messages.length} newMessages=${newMessages.length} overlapIndex=${overlapIndex} startIndex=${startIndex} prePromptMessageCount=${args.prePromptMessageCount ?? "unknown"} heartbeat=${args.isHeartbeat ?? false}`
       );
+      if (newMessages.length === 0) {
+        logger.info?.(
+          `LibraVDB afterTurn skipped sessionId=${sessionId} reason=no-new-messages messageCount=${messages.length} overlapIndex=${overlapIndex}`
+        );
+        return { ok: true, skipped: true, reason: "no-new-messages" };
+      }
       try {
         const client = await runtime.getClient();
         const currentTokenCount = normalizeCurrentTokenCount(

package/docs/yaml/default-gguf.yaml

@@ -0,0 +1,52 @@
+# Vector Service — GGUF backend (recommended)
+#
+# Place at /etc/libravdbd/config.yaml, ~/.libravdbd/config.yaml,
+# or any path pointed to by LIBRAVDB_CONFIG.
+#
+# GGUF/llama.cpp is 3-5x faster than ONNX on CPU.
+# Requires libllama.dylib/.so and a .gguf model file.
+# Provision: scripts/provision.sh (shipped with the daemon release).
+#
+# All fields are optional. Env vars override YAML values.
+
+# --- storage ---
+db_path: ""
+
+# --- transport ---
+grpc_endpoint: ""            # unix:/path/to/sock or tcp:host:port
+
+# --- embedding ---
+embedding_backend: gguf      # gguf only — does not fall back to ONNX
+embedding_profile: nomic-embed-text-v1.5
+fallback_profile: bge-small-en-v1.5
+embedding_normalize: true
+embedding_dimensions: 768
+
+# --- gguf ---
+llama_lib_path: ""           # path to libllama.dylib/.so (empty = auto-resolve)
+                             # Linux example: /var/lib/libravdbd/models/llama/llama-linux-amd64/lib/libllama.so
+                             # macOS example: /opt/homebrew/opt/libravdbd/models/llama/llama-darwin-arm64/lib/libllama.dylib
+
+# --- summarizer ---
+summarizer_backend: bundled  # bundled (=extractive, always used regardless)
+
+# --- gating ---
+gating_threshold: 0.35
+gating_w1c: 0.35
+gating_w2c: 0.40
+gating_w3c: 0.25
+gating_w1t: 0.40
+gating_w2t: 0.35
+gating_w3t: 0.25
+gating_tech_norm: 1.5
+
+# --- timeouts ---
+embed_timeout: 5s
+drain_timeout: 25s
+
+# --- circuit breaker ---
+circuit_max_failures: 3
+circuit_cooldown: 60s
+
+# --- lifecycle ---
+lifecycle_journal_max_entries: 500

package/docs/yaml/default-onnx.yaml

@@ -0,0 +1,47 @@
+# Vector Service — ONNX backend (default fallback)
+#
+# Place at /etc/libravdbd/config.yaml, ~/.libravdbd/config.yaml,
+# or any path pointed to by LIBRAVDB_CONFIG.
+#
+# All fields are optional. Env vars override YAML values.
+
+# --- storage ---
+db_path: ""
+
+# --- transport ---
+grpc_endpoint: ""            # unix:/path/to/sock or tcp:host:port
+
+# --- embedding ---
+embedding_backend: bundled   # bundled (=gguf-first, onnx fallback), onnx-local, gguf, remote
+embedding_profile: nomic-embed-text-v1.5
+fallback_profile: bge-small-en-v1.5
+embedding_model_path: ""
+embedding_tokenizer_path: ""
+embedding_dimensions: 768
+embedding_normalize: true
+onnx_runtime_path: ""        # path to libonnxruntime.dylib/.so (empty = auto-resolve)
+onnx_device: ""              # auto, cpu, cuda, coreml, openvino, directml
+
+# --- summarizer ---
+summarizer_backend: bundled  # bundled (=extractive, always used regardless)
+
+# --- gating ---
+gating_threshold: 0.35
+gating_w1c: 0.35
+gating_w2c: 0.40
+gating_w3c: 0.25
+gating_w1t: 0.40
+gating_w2t: 0.35
+gating_w3t: 0.25
+gating_tech_norm: 1.5
+
+# --- timeouts ---
+embed_timeout: 5s
+drain_timeout: 25s
+
+# --- circuit breaker ---
+circuit_max_failures: 3
+circuit_cooldown: 60s
+
+# --- lifecycle ---
+lifecycle_journal_max_entries: 500

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

package/package.json

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