@xdarkicex/openclaw-memory-libravdb 1.4.24 → 1.4.26

package/README.md

@@ -20,7 +20,7 @@ assembly; durable recall; and sidecar-owned compaction.
 
 New install? Start here: [Install guide](./docs/install.md). Preferred setup on
 macOS: install `libravdbd` with Homebrew, install the OpenClaw plugin, then
-assign the plugin to both required slots.
+assign the plugin to the OpenClaw memory slot.
 
 ## Install
 
@@ -31,18 +31,20 @@ brew services start libravdbd
 openclaw plugins install @xdarkicex/openclaw-memory-libravdb
 ```
 
-Then activate both plugin slots in `~/.openclaw/openclaw.json`:
+Then activate the plugin in `~/.openclaw/openclaw.json`:
 
 ```json
 {
   "plugins": {
     "slots": {
-      "memory": "libravdb-memory",
-      "contextEngine": "libravdb-memory"
+      "memory": "libravdb-memory"
     },
-    "configs": {
+    "entries": {
       "libravdb-memory": {
-        "sidecarPath": "auto"
+        "enabled": true,
+        "config": {
+          "sidecarPath": "auto"
+        }
       }
     }
   }
@@ -78,9 +80,12 @@ If your daemon runs elsewhere, set `sidecarPath`:
 ```json
 {
   "plugins": {
-    "configs": {
+    "entries": {
       "libravdb-memory": {
-        "sidecarPath": "tcp:127.0.0.1:37421"
+        "enabled": true,
+        "config": {
+          "sidecarPath": "tcp:127.0.0.1:37421"
+        }
       }
     }
   }
@@ -89,7 +94,8 @@ If your daemon runs elsewhere, set `sidecarPath`:
 
 ## Highlights
 
-- **Dual slot ownership** - owns both OpenClaw `memory` and `contextEngine`.
+- **Memory capability ownership** - owns the OpenClaw `memory` slot and
+  registers the context engine capability at runtime.
 - **Memory runtime bridge** - routes built-in `memory_search` calls to the same
   libraVDB-backed sidecar on hosts that expose the runtime API.
 - **Three memory scopes** - keeps active session, durable user, and global memory

package/dist/context-engine.d.ts

@@ -1,5 +1,5 @@
 import type { PluginRuntime } from "./plugin-runtime.js";
-import type { LoggerLike, PluginConfig, RecallCache, SearchResult } from "./types.js";
+import type { LoggerLike, PluginConfig } from "./types.js";
 import { AssembleContextInternalResponse } from "@xdarkicex/libravdb-contracts";
 type KernelCompatibleMessage = {
     role: string;
@@ -49,7 +49,7 @@ export declare function normalizeAssembleResult(result: {
     systemPromptAddition?: string;
     debug?: AssembleContextInternalResponse["debug"];
 }): OpenClawCompatibleAssembleResult;
-export declare function buildContextEngineFactory(runtime: PluginRuntime, cfg: PluginConfig, recallCache: RecallCache<SearchResult>, logger?: LoggerLike): {
+export declare function buildContextEngineFactory(runtime: PluginRuntime, cfg: PluginConfig, logger?: LoggerLike): {
     info: {
         id: string;
         name: string;

package/dist/context-engine.js

@@ -332,7 +332,7 @@ export function normalizeAssembleResult(result) {
         ...(result.debug != null ? { debug: result.debug } : {}),
     };
 }
-export function buildContextEngineFactory(runtime, cfg, recallCache, logger = console) {
+export function buildContextEngineFactory(runtime, cfg, logger = console) {
     let cachedIdentity = null;
     function resolveUserId(args) {
         // Framework-provided userId takes priority (channels, future SDK compat).
@@ -350,6 +350,16 @@ export function buildContextEngineFactory(runtime, cfg, recallCache, logger = co
         return cachedIdentity.userId;
     }
     const getDynamicCompactThreshold = (tokenBudget) => resolveDynamicCompactThreshold(tokenBudget, cfg.compactThreshold, cfg.compactionThresholdFraction);
+    async function getKernelOrNull(phase) {
+        try {
+            return await runtime.getKernel();
+        }
+        catch (error) {
+            logger.warn?.(`LibraVDB ${phase} kernel unavailable, falling back to sidecar: ` +
+                `${error instanceof Error ? error.message : String(error)}`);
+            return null;
+        }
+    }
     const buildAssemblyConfig = (tokenBudget) => ({
         useSessionRecallProjection: cfg.useSessionRecallProjection,
         useSessionSummarySearchExperiment: cfg.useSessionSummarySearchExperiment,
@@ -475,7 +485,7 @@ export function buildContextEngineFactory(runtime, cfg, recallCache, logger = co
     }
     async function runCompaction(args) {
         const request = buildCompactSessionRequest(args);
-        const kernel = runtime.getKernel();
+        const kernel = await getKernelOrNull("compact");
         try {
             if (kernel) {
                 return normalizeCompactResult(await kernel.compactSession(request), {
@@ -544,7 +554,7 @@ export function buildContextEngineFactory(runtime, cfg, recallCache, logger = co
             });
             logger.info?.(`LibraVDB bootstrap sessionId=${args.sessionId} userId=${userId} ` +
                 `sessionKey=${args.sessionKey ?? "(none)"}`);
-            const kernel = runtime.getKernel();
+            const kernel = await getKernelOrNull("bootstrap");
             if (kernel) {
                 try {
                     await kernel.initializeSession({
@@ -577,7 +587,7 @@ export function buildContextEngineFactory(runtime, cfg, recallCache, logger = co
                 `role=${message.role} heartbeat=${args.isHeartbeat ?? false} ` +
                 `contentLen=${message.content.length}`);
             try {
-                const kernel = runtime.getKernel();
+                const kernel = await getKernelOrNull("ingest");
                 if (kernel) {
                     return await kernel.ingestMessage({
                         sessionId: args.sessionId,
@@ -650,7 +660,7 @@ export function buildContextEngineFactory(runtime, cfg, recallCache, logger = co
                     return buildBudgetFallbackContext(messages, args.tokenBudget);
                 }
             }
-            const kernel = runtime.getKernel();
+            const kernel = await getKernelOrNull("assemble");
             if (kernel) {
                 try {
                     const assembled = normalizeAssembleResult(await kernel.assembleContext({
@@ -713,7 +723,7 @@ export function buildContextEngineFactory(runtime, cfg, recallCache, logger = co
             logger.info?.(`LibraVDB afterTurn sessionId=${args.sessionId} userId=${userId} ` +
                 `messageCount=${msgCount} heartbeat=${args.isHeartbeat ?? false}`);
             try {
-                const kernel = runtime.getKernel();
+                const kernel = await getKernelOrNull("afterTurn");
                 const currentTokenCount = normalizeCurrentTokenCount(typeof args.runtimeContext?.currentTokenCount === "number"
                     ? args.runtimeContext.currentTokenCount
                     : undefined);

package/dist/index.js

@@ -7,7 +7,6 @@ import { createDreamPromotionHandle } from "./dream-promotion.js";
 import { createMarkdownIngestionHandle } from "./markdown-ingest.js";
 import { buildMemoryPromptSection } from "./memory-provider.js";
 import { buildMemoryRuntimeBridge } from "./memory-runtime.js";
-import { createRecallCache } from "./recall-cache.js";
 import { createPluginRuntime } from "./plugin-runtime.js";
 export const MEMORY_ID = "libravdb-memory";
 const LIGHTWEIGHT_MODES = new Set(["cli-metadata", "setup-only"]);
@@ -51,7 +50,6 @@ export function register(api) {
     const runtime = runtimeOrNull;
     if (!runtime)
         return; // unreachable but satisfies the type checker
-    const recallCache = createRecallCache();
     // Exclusive slot check: refuse to register if another plugin owns the memory slot.
     // plugins.slots.memory is the only configurable slot; context engine exclusivity
     // is enforced by the registry at runtime (no config surface for it).
@@ -63,10 +61,10 @@ export function register(api) {
     }
     // Migrated from three legacy calls to a single registerMemoryCapability.
     api.registerMemoryCapability(MEMORY_ID, {
-        promptBuilder: buildMemoryPromptSection(runtime.getRpc, cfg, recallCache),
+        promptBuilder: buildMemoryPromptSection(runtime.getRpc, cfg),
         runtime: buildMemoryRuntimeBridge(runtime.getRpc, cfg),
     });
-    api.registerContextEngine(MEMORY_ID, () => buildContextEngineFactory(runtime, cfg, recallCache, api.logger ?? console));
+    api.registerContextEngine(MEMORY_ID, () => buildContextEngineFactory(runtime, cfg, api.logger ?? console));
     const markdownIngestion = createMarkdownIngestionHandle(cfg, runtime.getRpc, api.logger ?? console);
     const dreamPromotion = createDreamPromotionHandle(cfg, runtime.getRpc, api.logger ?? console);
     runtime.onShutdown(async () => {

package/dist/memory-provider.d.ts

@@ -1,4 +1,4 @@
 import type { MemoryPromptSectionBuilder } from "openclaw/plugin-sdk/plugin-entry";
-import type { PluginConfig, RecallCache, SearchResult } from "./types.js";
+import type { PluginConfig } from "./types.js";
 import type { RpcGetter } from "./plugin-runtime.js";
-export declare function buildMemoryPromptSection(_getRpc: RpcGetter, _cfg: PluginConfig, _recallCache: RecallCache<SearchResult>): MemoryPromptSectionBuilder;
+export declare function buildMemoryPromptSection(_getRpc: RpcGetter, _cfg: PluginConfig): MemoryPromptSectionBuilder;

package/dist/memory-provider.js

@@ -4,7 +4,7 @@ const MEMORY_PROMPT_HEADER = [
     "in context via the context-engine assembler when available and relevant.",
     "",
 ];
-export function buildMemoryPromptSection(_getRpc, _cfg, _recallCache) {
+export function buildMemoryPromptSection(_getRpc, _cfg) {
     return function memoryPromptSection({ availableTools: _availableTools, citationsMode: _citationsMode, }) {
         // OpenClaw builds the memory prompt section synchronously for embedded runs.
         // Actual retrieval and ranking happen in the context engine during assemble().

package/dist/memory-runtime.js

@@ -124,6 +124,9 @@ function createMemorySearchManager(getRpc, cfg, defaults, initialStatus) {
 }
 async function searchResolvedCollections(rpc, cfg, userId, sessionId, queryText, k) {
     const collections = resolveSearchCollections(cfg, userId, sessionId);
+    if (collections.length === 0) {
+        return { results: [] };
+    }
     return collections.length === 1
         ? await rpc.call("search_text", {
             collection: collections[0],
@@ -138,20 +141,24 @@ async function searchResolvedCollections(rpc, cfg, userId, sessionId, queryText,
         });
 }
 function resolveSearchCollections(cfg, userId, sessionId) {
+    if (cfg.crossSessionRecall === false) {
+        return sessionId ? [resolveSessionSearchCollection(cfg, sessionId)] : [];
+    }
     const collections = [`user:${userId}`, "global"];
     if (!sessionId) {
         return collections;
     }
+    collections.unshift(resolveSessionSearchCollection(cfg, sessionId));
+    return collections;
+}
+function resolveSessionSearchCollection(cfg, sessionId) {
     if (cfg.useSessionSummarySearchExperiment) {
-        collections.unshift(`session_summary:${sessionId}`);
-        return collections;
+        return `session_summary:${sessionId}`;
     }
     if (cfg.useSessionRecallProjection) {
-        collections.unshift(`session_recall:${sessionId}`);
-        return collections;
+        return `session_recall:${sessionId}`;
     }
-    collections.unshift(`session:${sessionId}`);
-    return collections;
+    return `session:${sessionId}`;
 }
 function firstString(...values) {
     return values.find((value) => typeof value === "string" && value.length > 0);

package/dist/plugin-runtime.d.ts

@@ -22,7 +22,7 @@ export interface LifecycleHint {
 export type RuntimeShutdownTask = () => Promise<void> | void;
 export interface PluginRuntime {
     getRpc: RpcGetter;
-    getKernel(): GrpcKernelClient | null;
+    getKernel(): Promise<GrpcKernelClient | null>;
     emitLifecycleHint(hint: LifecycleHint): Promise<void>;
     onShutdown(task: RuntimeShutdownTask): void;
     shutdown(): Promise<void>;

package/dist/plugin-runtime.js

@@ -11,7 +11,6 @@ export function createPluginRuntime(cfg, logger = console) {
     let started = null;
     let stopped = false;
     let shuttingDown = false;
-    let resolvedKernel = null;
     const shutdownTasks = [];
     const ensureStarted = async () => {
         if (stopped) {
@@ -49,7 +48,6 @@ export function createPluginRuntime(cfg, logger = console) {
                         logger.warn?.(`LibraVDB: failed to initialize gRPC kernel client: ${formatError(error)}`);
                     }
                 }
-                resolvedKernel = kernel;
                 return { rpc, sidecar, kernel };
             })().catch((error) => {
                 started = null;
@@ -62,10 +60,8 @@ export function createPluginRuntime(cfg, logger = console) {
         async getRpc() {
             return (await ensureStarted()).rpc;
         },
-        getKernel() {
-            if (!started)
-                return null;
-            return resolvedKernel;
+        async getKernel() {
+            return (await ensureStarted()).kernel;
         },
         async emitLifecycleHint(hint) {
             try {

package/dist/types.d.ts

@@ -163,17 +163,3 @@ export interface SidecarHandle {
 export interface RpcCallOptions {
     timeoutMs: number;
 }
-export interface RecallCacheEntry<T = unknown> {
-    userId: string;
-    queryText: string;
-    durableVariantHits: T[];
-    userHits?: T[];
-    globalHits?: T[];
-    authoredVariantHits?: T[];
-}
-export interface RecallCache<T = unknown> {
-    put(entry: RecallCacheEntry<T>): void;
-    get(key: Pick<RecallCacheEntry<T>, "userId" | "queryText">): RecallCacheEntry<T> | undefined;
-    take(key: Pick<RecallCacheEntry<T>, "userId" | "queryText">): RecallCacheEntry<T> | undefined;
-    clearUser(userId: string): void;
-}

package/docs/architecture.md

@@ -8,8 +8,8 @@ internal sequencing.
 
 LibraVDB Memory is split into two cooperating pieces:
 
-- a TypeScript OpenClaw plugin that owns the `memory` and `contextEngine`
-  slots
+- a TypeScript OpenClaw plugin that owns the `memory` slot and registers
+  context-engine capability at runtime
 - a Go sidecar daemon that owns storage, retrieval, and compaction
 
 The plugin keeps the host integration light and stable. The daemon keeps the

package/docs/features.md

@@ -27,16 +27,19 @@ Example:
 ```json
 {
   "plugins": {
-    "configs": {
+    "entries": {
       "libravdb-memory": {
-        "markdownIngestionEnabled": true,
-        "markdownIngestionRoots": [
-          "/Users/<you>/.openclaw/memory"
-        ],
-        "markdownIngestionObsidianEnabled": true,
-        "markdownIngestionObsidianRoots": [
-          "/Users/<you>/Documents/Obsidian/Main"
-        ]
+        "enabled": true,
+        "config": {
+          "markdownIngestionEnabled": true,
+          "markdownIngestionRoots": [
+            "/Users/<you>/.openclaw/memory"
+          ],
+          "markdownIngestionObsidianEnabled": true,
+          "markdownIngestionObsidianRoots": [
+            "/Users/<you>/Documents/Obsidian/Main"
+          ]
+        }
       }
     }
   }
@@ -84,12 +87,15 @@ Automatic diary watching:
 ```json
 {
   "plugins": {
-    "configs": {
+    "entries": {
       "libravdb-memory": {
-        "dreamPromotionEnabled": true,
-        "dreamPromotionDiaryPath": "/Users/<you>/DREAMS.md",
-        "dreamPromotionUserId": "<userId>",
-        "dreamPromotionDebounceMs": 150
+        "enabled": true,
+        "config": {
+          "dreamPromotionEnabled": true,
+          "dreamPromotionDiaryPath": "/Users/<you>/DREAMS.md",
+          "dreamPromotionUserId": "<userId>",
+          "dreamPromotionDebounceMs": 150
+        }
       }
     }
   }

package/docs/install.md

@@ -37,8 +37,7 @@ openclaw plugins install @xdarkicex/openclaw-memory-libravdb
 ```
 
 If you use the OpenClaw.ai plugin UI instead of the CLI, install the same
-package and then assign the plugin id `libravdb-memory` to both the `memory`
-and `contextEngine` slots.
+package and then assign the plugin id `libravdb-memory` to the `memory` slot.
 
 Activate the plugin in `~/.openclaw/openclaw.json`:
 
@@ -46,8 +45,7 @@ Activate the plugin in `~/.openclaw/openclaw.json`:
 {
   "plugins": {
     "slots": {
-      "memory": "libravdb-memory",
-      "contextEngine": "libravdb-memory"
+      "memory": "libravdb-memory"
     }
   }
 }
@@ -59,12 +57,14 @@ If you run the daemon on a non-default endpoint, add a plugin config:
 {
   "plugins": {
     "slots": {
-      "memory": "libravdb-memory",
-      "contextEngine": "libravdb-memory"
+      "memory": "libravdb-memory"
     },
-    "configs": {
+    "entries": {
       "libravdb-memory": {
-        "sidecarPath": "unix:/Users/<you>/.clawdb/run/libravdb.sock"
+        "enabled": true,
+        "config": {
+          "sidecarPath": "unix:/Users/<you>/.clawdb/run/libravdb.sock"
+        }
       }
     }
   }
@@ -158,7 +158,7 @@ you wrap it in `brew services`, `systemd`, or `launchd`.
 ### Plugin Lifecycle
 
 - Install the package with `openclaw plugins install`.
-- Activate it by assigning `libravdb-memory` to both `memory` and `contextEngine`.
+- Activate it by assigning `libravdb-memory` to the `memory` slot.
 - Update it with your normal OpenClaw plugin update flow.
 - Disable it by removing the slot assignment from `~/.openclaw/openclaw.json`.
 

package/docs/installation.md

@@ -60,21 +60,20 @@ or run `libravdbd serve` in a terminal for validation.
 
 ## Activation
 
-Assign `libravdb-memory` to both OpenClaw slots:
+Assign `libravdb-memory` to the OpenClaw memory slot:
 
 ```json
 {
   "plugins": {
     "slots": {
-      "memory": "libravdb-memory",
-      "contextEngine": "libravdb-memory"
+      "memory": "libravdb-memory"
     }
   }
 }
 ```
 
-Treat partial assignment as a misconfiguration. This plugin is designed to own
-memory prompt injection and the context-engine lifecycle together.
+The plugin registers both memory and context-engine capabilities at runtime;
+current OpenClaw config only needs the `memory` slot assignment.
 
 If the daemon uses a non-default endpoint, add `sidecarPath`:
 
@@ -82,12 +81,14 @@ If the daemon uses a non-default endpoint, add `sidecarPath`:
 {
   "plugins": {
     "slots": {
-      "memory": "libravdb-memory",
-      "contextEngine": "libravdb-memory"
+      "memory": "libravdb-memory"
     },
-    "configs": {
+    "entries": {
       "libravdb-memory": {
-        "sidecarPath": "unix:/Users/<you>/.clawdb/run/libravdb.sock"
+        "enabled": true,
+        "config": {
+          "sidecarPath": "unix:/Users/<you>/.clawdb/run/libravdb.sock"
+        }
       }
     }
   }
@@ -177,9 +178,9 @@ setup, or republish the release with corrected checksums.
 
 ### Default memory still appears active
 
-Confirm that `libravdb-memory` is assigned to both `memory` and
-`contextEngine`. Without both slot entries, OpenClaw's default memory path can
-continue to run in parallel.
+Confirm that `libravdb-memory` is assigned to `plugins.slots.memory`.
+Without that slot entry, OpenClaw's default memory path can continue to run in
+parallel.
 
 ### Lifecycle journal looks empty
 

package/docs/uninstall.md

@@ -18,9 +18,9 @@ Remove the plugin from the active OpenClaw slot in `~/.openclaw/openclaw.json`:
 }
 ```
 
-Treat that JSON as a minimal example only. If you assigned `libravdb-memory`
-under both `memory` and `contextEngine`, remove those two slot entries and
-leave any other plugin slots intact.
+Treat that JSON as a minimal example only. If you assigned
+`libravdb-memory` under `memory`, remove that slot entry and leave any other
+plugin slots intact.
 
 If you installed the package through the OpenClaw.ai plugin UI, remove or
 disable the same package there as well. If you use the CLI, remove it through

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

package/package.json

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

package/dist/recall-cache.d.ts

@@ -1,2 +0,0 @@
-import type { RecallCache } from "./types.js";
-export declare function createRecallCache<T = unknown>(): RecallCache<T>;

package/dist/recall-cache.js

@@ -1,30 +0,0 @@
-export function createRecallCache() {
-    const entries = new Map();
-    return {
-        put(entry) {
-            entries.set(cacheKey(entry.userId, entry.queryText), entry);
-        },
-        get(key) {
-            return entries.get(cacheKey(key.userId, key.queryText));
-        },
-        take(key) {
-            const id = cacheKey(key.userId, key.queryText);
-            const hit = entries.get(id);
-            if (hit) {
-                entries.delete(id);
-            }
-            return hit;
-        },
-        clearUser(userId) {
-            const prefix = `${userId}\n`;
-            for (const key of entries.keys()) {
-                if (key.startsWith(prefix)) {
-                    entries.delete(key);
-                }
-            }
-        },
-    };
-}
-function cacheKey(userId, queryText) {
-    return `${userId}\n${queryText}`;
-}