@xdarkicex/openclaw-memory-libravdb 1.4.22 → 1.4.24

package/dist/cli.js

@@ -19,7 +19,7 @@ export function registerMemoryCli(api, runtime, cfg, logger = console) {
             // Non-full modes register structure only so `openclaw memory --help` works.
             // No runtime available — do not attach action handlers.
             ensureCommand(root, "status").description("Show sidecar health, record counts, and active thresholds");
-            ensureCommand(root, "index").description("Refresh delegated LibraVDB memory index state");
+            ensureCommand(root, "index").description("Rebuild LibraVDB memory vector index (requires --force)");
             ensureCommand(root, "search").description("Search LibraVDB memory");
             ensureCommand(root, "flush").description("Wipe a durable memory namespace after confirmation");
             ensureCommand(root, "export").description("Stream stored memories as newline-delimited JSON");
@@ -32,7 +32,6 @@ export function registerMemoryCli(api, runtime, cfg, logger = console) {
             .option("--agent <id>", "Agent id")
             .option("--json", "Print JSON")
             .option("--deep", "Probe daemon readiness")
-            .option("--index", "Refresh delegated index state before printing status")
             .option("--fix", "Accepted for OpenClaw memory CLI compatibility")
             .option("--verbose", "Verbose logging")
             .action(async (opts) => {
@@ -41,9 +40,12 @@ export function registerMemoryCli(api, runtime, cfg, logger = console) {
             });
         });
         ensureCommand(root, "index")
-            .description("Refresh delegated LibraVDB memory index state")
+            .description("Rebuild LibraVDB memory vector index (requires --force)")
             .option("--agent <id>", "Agent id")
-            .option("--force", "Force refresh where supported")
+            .option("--user-id <userId>", "User id")
+            .option("--session-key <sessionKey>", "Session key")
+            .option("--collections <list>", "Comma-separated collection names to reindex")
+            .option("--force", "Required: confirm index rebuild")
             .option("--verbose", "Verbose logging")
             .action(async (opts) => {
             await runCliCommand(runtime, logger, async () => {
@@ -142,9 +144,6 @@ async function runCliCommand(runtime, logger, action) {
     }
 }
 async function runStatus(runtime, cfg, logger, opts = {}) {
-    if (opts.index) {
-        await runIndex(runtime, cfg, { ...opts, verbose: false }, logger, { quiet: true });
-    }
     try {
         const rpc = await runtime.getRpc();
         const status = await rpc.call("status", {});
@@ -189,38 +188,40 @@ async function runStatus(runtime, cfg, logger, opts = {}) {
         process.exitCode = 1;
     }
 }
-async function runIndex(runtime, cfg, opts, logger, params = {}) {
+async function runIndex(runtime, _cfg, opts, logger, params = {}) {
+    if (!opts?.force) {
+        logger.error("LibraVDB index rebuild requires --force. This re-embeds all stored documents with the current model and may be slow.");
+        process.exitCode = 1;
+        return;
+    }
+    const namespace = resolveCliNamespace(opts);
+    const collections = opts?.collections
+        ?.split(",")
+        .map((c) => c.trim())
+        .filter((c) => c.length > 0);
     try {
-        const bridge = buildMemoryRuntimeBridge(runtime.getRpc, cfg);
-        const { manager } = await bridge.getMemorySearchManager({
-            agentId: opts?.agent,
-            purpose: "status",
-        });
-        await manager.sync?.({
-            reason: "cli",
-            force: Boolean(opts?.force),
+        const rpc = await runtime.getRpc();
+        const result = await rpc.call("rebuild_index", {
+            namespace: namespace ?? "",
+            ...(collections?.length ? { collections } : {}),
         });
-        const status = manager.status();
-        if (status.ok === false) {
-            logger.error(`LibraVDB index refresh unavailable: ${status.message ?? "sidecar unavailable"}`);
-            process.exitCode = 1;
-            return;
+        if (!params.quiet) {
+            console.log(`Collections processed: ${result.collectionsProcessed ?? 0}`);
+            console.log(`Records reindexed:     ${result.recordsReindexed ?? 0}`);
+            if ((result.collectionsRecreated ?? 0) > 0) {
+                console.log(`Collections recreated: ${result.collectionsRecreated} (embedding dimensions changed)`);
+            }
         }
-        if (opts?.verbose && !params.quiet) {
-            console.table({
-                Provider: status.provider ?? "libravdb",
-                Model: status.model ?? status.embeddingProfile ?? "unknown",
-                "Turns stored": status.turnCount ?? 0,
-                "Memories stored": status.memoryCount ?? 0,
-                Message: status.message ?? "ok",
-            });
+        for (const err of result.errors ?? []) {
+            logger.warn?.(`LibraVDB index rebuild: ${err}`);
         }
-        if (!params.quiet) {
-            console.log("LibraVDB memory index refresh delegated to the sidecar.");
+        if ((result.errors?.length ?? 0) > 0 && (result.recordsReindexed ?? 0) === 0) {
+            logger.error("LibraVDB index rebuild completed with errors and no records reindexed.");
+            process.exitCode = 1;
         }
     }
     catch (error) {
-        logger.error(`LibraVDB index refresh failed: ${formatError(error)}`);
+        logger.error(`LibraVDB index rebuild failed: ${formatError(error)}`);
         process.exitCode = 1;
     }
 }
@@ -390,8 +391,9 @@ function normalizeQueryArg(value) {
 function resolveCliNamespace(opts) {
     const userId = opts?.userId?.trim();
     const sessionKey = opts?.sessionKey?.trim();
-    if (!userId && !sessionKey) {
+    const agentId = opts?.agent?.trim();
+    if (!userId && !sessionKey && !agentId) {
         return undefined;
     }
-    return resolveDurableNamespace({ userId, sessionKey });
+    return resolveDurableNamespace({ userId, sessionKey, agentId });
 }

package/dist/context-engine.d.ts

@@ -1,6 +1,6 @@
 import type { PluginRuntime } from "./plugin-runtime.js";
 import type { LoggerLike, PluginConfig, RecallCache, SearchResult } from "./types.js";
-import { AssembleContextInternalResponse } from "./generated/libravdb/ipc/v1/rpc_pb.js";
+import { AssembleContextInternalResponse } from "@xdarkicex/libravdb-contracts";
 type KernelCompatibleMessage = {
     role: string;
     content: string;

package/dist/index.js

@@ -69,6 +69,12 @@ export function register(api) {
     api.registerContextEngine(MEMORY_ID, () => buildContextEngineFactory(runtime, cfg, recallCache, api.logger ?? console));
     const markdownIngestion = createMarkdownIngestionHandle(cfg, runtime.getRpc, api.logger ?? console);
     const dreamPromotion = createDreamPromotionHandle(cfg, runtime.getRpc, api.logger ?? console);
+    runtime.onShutdown(async () => {
+        await markdownIngestion.stop();
+    });
+    runtime.onShutdown(async () => {
+        await dreamPromotion.stop();
+    });
     void markdownIngestion.start().catch((error) => {
         api.logger?.warn?.(`LibraVDB markdown ingestion failed to start: ${error instanceof Error ? error.message : String(error)}`);
     });
@@ -78,8 +84,6 @@ export function register(api) {
     api.on("before_reset", createBeforeResetHook(runtime, api.logger ?? console));
     api.on("session_end", createSessionEndHook(runtime, api.logger ?? console));
     api.on("gateway_stop", async () => {
-        await dreamPromotion.stop();
-        await markdownIngestion.stop();
         await runtime.shutdown();
     });
 }

package/dist/markdown-ingest.js

@@ -73,9 +73,11 @@ class DirectoryMarkdownSourceAdapter {
     logger;
     states = new Map();
     fileStates = new Map();
+    activeScans = new Set();
     tokenizerId;
     coreDoc;
     started = false;
+    stopping = false;
     constructor(kind, config, getRpc, logger, fsApi) {
         this.kind = kind;
         this.roots = config.roots;
@@ -93,10 +95,11 @@ class DirectoryMarkdownSourceAdapter {
             return;
         }
         this.started = true;
+        this.stopping = false;
         await this.refresh();
     }
     async refresh() {
-        if (!this.started) {
+        if (!this.started || this.stopping) {
             return;
         }
         for (const root of this.roots) {
@@ -104,6 +107,7 @@ class DirectoryMarkdownSourceAdapter {
         }
     }
     async stop() {
+        this.stopping = true;
         for (const state of this.states.values()) {
             if (state.scanState.timer) {
                 clearTimeout(state.scanState.timer);
@@ -114,6 +118,9 @@ class DirectoryMarkdownSourceAdapter {
             }
             state.directoryWatchers.clear();
         }
+        if (this.activeScans.size > 0) {
+            await Promise.allSettled([...this.activeScans]);
+        }
         this.states.clear();
         this.fileStates.clear();
         this.started = false;
@@ -138,27 +145,46 @@ class DirectoryMarkdownSourceAdapter {
         return created;
     }
     async scanRoot(root) {
+        if (!this.started || this.stopping) {
+            return;
+        }
         const rootState = this.getRootState(root);
         if (rootState.scanState.scanning) {
             rootState.scanState.dirty = true;
             return;
         }
         rootState.scanState.scanning = true;
+        const scan = (async () => {
+            try {
+                const currentFiles = new Set();
+                await this.walkDirectory(rootState, rootState.root, currentFiles);
+                if (!this.stopping) {
+                    await this.pruneDeletedFiles(rootState, currentFiles);
+                    rootState.knownFiles = currentFiles;
+                }
+            }
+            finally {
+                rootState.scanState.scanning = false;
+                if (rootState.scanState.dirty) {
+                    rootState.scanState.dirty = false;
+                    if (!this.stopping) {
+                        this.scheduleRootScan(rootState);
+                    }
+                }
+            }
+        })();
+        this.activeScans.add(scan);
         try {
-            const currentFiles = new Set();
-            await this.walkDirectory(rootState, rootState.root, currentFiles);
-            await this.pruneDeletedFiles(rootState, currentFiles);
-            rootState.knownFiles = currentFiles;
+            await scan;
         }
         finally {
-            rootState.scanState.scanning = false;
-            if (rootState.scanState.dirty) {
-                rootState.scanState.dirty = false;
-                this.scheduleRootScan(rootState);
-            }
+            this.activeScans.delete(scan);
         }
     }
     scheduleRootScan(rootState) {
+        if (!this.started || this.stopping) {
+            return;
+        }
         if (rootState.scanState.scanning) {
             rootState.scanState.dirty = true;
             return;
@@ -187,6 +213,9 @@ class DirectoryMarkdownSourceAdapter {
             return;
         }
         for (const entry of entries) {
+            if (this.stopping) {
+                return;
+            }
             const child = path.join(dir, entry.name);
             if (entry.isDirectory()) {
                 await this.walkDirectory(rootState, child, currentFiles);
@@ -203,7 +232,9 @@ class DirectoryMarkdownSourceAdapter {
                 await this.syncMarkdownFile(rootState, child);
             }
             catch (error) {
-                this.logger.warn?.(`[markdown-ingest] sync failed for ${child}: ${formatError(error)}`);
+                if (!this.stopping) {
+                    this.logger.warn?.(`[markdown-ingest] sync failed for ${child}: ${formatError(error)}`);
+                }
             }
         }
     }
@@ -213,7 +244,9 @@ class DirectoryMarkdownSourceAdapter {
         }
         try {
             const watcher = this.fsApi.watch(dir, () => {
-                this.scheduleRootScan(rootState);
+                if (!this.stopping) {
+                    this.scheduleRootScan(rootState);
+                }
             });
             watcher.on("error", (error) => {
                 this.logger.warn?.(`[markdown-ingest] watch error for ${dir}: ${formatError(error)}`);

package/dist/plugin-runtime.d.ts

@@ -19,10 +19,12 @@ export interface LifecycleHint {
     nextSessionId?: string;
     nextSessionKey?: string;
 }
+export type RuntimeShutdownTask = () => Promise<void> | void;
 export interface PluginRuntime {
     getRpc: RpcGetter;
     getKernel(): GrpcKernelClient | null;
     emitLifecycleHint(hint: LifecycleHint): Promise<void>;
+    onShutdown(task: RuntimeShutdownTask): void;
     shutdown(): Promise<void>;
 }
 export declare function createPluginRuntime(cfg: PluginConfig, logger?: LoggerLike): PluginRuntime;

package/dist/plugin-runtime.js

@@ -10,7 +10,9 @@ export function resolveStartupHealthTimeoutMs(cfg) {
 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) {
             throw new Error("LibraVDB plugin runtime has been shut down");
@@ -74,7 +76,25 @@ export function createPluginRuntime(cfg, logger = console) {
                 logger.warn?.(`LibraVDB lifecycle hint dropped: ${formatError(error)}`);
             }
         },
+        onShutdown(task) {
+            if (stopped || shuttingDown) {
+                return;
+            }
+            shutdownTasks.push(task);
+        },
         async shutdown() {
+            if (stopped || shuttingDown) {
+                return;
+            }
+            shuttingDown = true;
+            for (const task of shutdownTasks.splice(0).reverse()) {
+                try {
+                    await task();
+                }
+                catch (error) {
+                    logger.warn?.(`LibraVDB shutdown task failed: ${formatError(error)}`);
+                }
+            }
             stopped = true;
             if (!started) {
                 return;

package/dist/rpc-protobuf-codecs.d.ts

@@ -1,4 +1,4 @@
-import { AfterTurnKernelRequest, AfterTurnKernelResponse, AssembleContextInternalRequest, AssembleContextInternalResponse, BootstrapSessionKernelRequest, BootstrapSessionKernelResponse, CompactSessionRequest, CompactSessionResponse, DeleteAuthoredDocumentResponse, DreamPromotionResponse, ExportMemoryResponse, FlushNamespaceResponse, FlushResponse, HealthResponse, IngestMarkdownDocumentResponse, IngestMessageKernelRequest, IngestMessageKernelResponse, MemoryStatusResponse, RankCandidatesRequest, RankCandidatesResponse, SearchTextResponse, SessionLifecycleHintResponse } from "./generated/libravdb/ipc/v1/rpc_pb.js";
+import { AfterTurnKernelRequest, AfterTurnKernelResponse, AssembleContextInternalRequest, AssembleContextInternalResponse, BootstrapSessionKernelRequest, BootstrapSessionKernelResponse, CompactSessionRequest, CompactSessionResponse, DeleteAuthoredDocumentResponse, DreamPromotionResponse, ExportMemoryResponse, FlushNamespaceResponse, FlushResponse, HealthResponse, IngestMarkdownDocumentResponse, IngestMessageKernelRequest, IngestMessageKernelResponse, MemoryStatusResponse, RankCandidatesRequest, RankCandidatesResponse, RebuildIndexRequest, RebuildIndexResponse, SearchTextResponse, SessionLifecycleHintResponse } from "@xdarkicex/libravdb-contracts";
 import type { LifecycleHint } from "./plugin-runtime.js";
 export type RpcMethodCodec<Params = unknown, Result = unknown> = {
     encodeParams(params: Params): Uint8Array;
@@ -66,5 +66,6 @@ export declare const rpcProtobufCodecs: {
     assemble_context_internal: RpcMethodCodec<AssembleContextInternalRequest, AssembleContextInternalResponse>;
     compact_session: RpcMethodCodec<CompactSessionRequest, CompactSessionResponse>;
     rank_candidates: RpcMethodCodec<RankCandidatesRequest, RankCandidatesResponse>;
+    rebuild_index: RpcMethodCodec<RebuildIndexRequest, RebuildIndexResponse>;
 };
 export declare function getRpcMethodCodec(method: string): RpcMethodCodec<any, any> | undefined;

package/dist/rpc-protobuf-codecs.js

@@ -1,4 +1,4 @@
-import { AfterTurnKernelRequest, AfterTurnKernelResponse, AssembleContextInternalRequest, AssembleContextInternalResponse, BootstrapSessionKernelRequest, BootstrapSessionKernelResponse, CompactSessionRequest, CompactSessionResponse, DeleteAuthoredDocumentRequest, DeleteAuthoredDocumentResponse, DreamPromotionResponse, ExportMemoryRequest, ExportMemoryResponse, FlushNamespaceRequest, FlushNamespaceResponse, FlushResponse, HealthResponse, IngestMarkdownDocumentRequest, IngestMarkdownDocumentResponse, IngestMessageKernelRequest, IngestMessageKernelResponse, ListCollectionRequest, ListLifecycleJournalRequest, MemoryStatusResponse, PromoteDreamEntriesRequest, RankCandidatesRequest, RankCandidatesResponse, SearchTextCollectionsRequest, SearchTextRequest, SearchTextResponse, SessionLifecycleHintRequest, SessionLifecycleHintResponse, StringList, } from "./generated/libravdb/ipc/v1/rpc_pb.js";
+import { AfterTurnKernelRequest, AfterTurnKernelResponse, AssembleContextInternalRequest, AssembleContextInternalResponse, BootstrapSessionKernelRequest, BootstrapSessionKernelResponse, CompactSessionRequest, CompactSessionResponse, DeleteAuthoredDocumentRequest, DeleteAuthoredDocumentResponse, DreamPromotionResponse, ExportMemoryRequest, ExportMemoryResponse, FlushNamespaceRequest, FlushNamespaceResponse, FlushResponse, HealthResponse, IngestMarkdownDocumentRequest, IngestMarkdownDocumentResponse, IngestMessageKernelRequest, IngestMessageKernelResponse, ListCollectionRequest, ListLifecycleJournalRequest, MemoryStatusResponse, PromoteDreamEntriesRequest, RankCandidatesRequest, RankCandidatesResponse, RebuildIndexRequest, RebuildIndexResponse, SearchTextCollectionsRequest, SearchTextRequest, SearchTextResponse, SessionLifecycleHintRequest, SessionLifecycleHintResponse, StringList, } from "@xdarkicex/libravdb-contracts";
 function encodeMessage(schema, init) {
     return new schema(init).toBinary();
 }
@@ -78,6 +78,7 @@ export const rpcProtobufCodecs = {
     assemble_context_internal: codec((params) => encodeMessage(AssembleContextInternalRequest, params), normalizeAssembleContextInternalResponse),
     compact_session: codec((params) => encodeMessage(CompactSessionRequest, params), (bytes) => decodeProtobufResult(CompactSessionResponse, bytes)),
     rank_candidates: codec((params) => encodeMessage(RankCandidatesRequest, params), (bytes) => decodeProtobufResult(RankCandidatesResponse, bytes)),
+    rebuild_index: codec((params) => encodeMessage(RebuildIndexRequest, params), (bytes) => decodeProtobufResult(RebuildIndexResponse, bytes)),
 };
 export function getRpcMethodCodec(method) {
     return rpcProtobufCodecs[method];

package/dist/rpc.js

@@ -1,4 +1,4 @@
-import { RpcRequest, RpcResponse } from "./generated/libravdb/ipc/v1/rpc_pb.js";
+import { RpcRequest, RpcResponse } from "@xdarkicex/libravdb-contracts";
 import { getRpcMethodCodec } from "./rpc-protobuf-codecs.js";
 export class RpcClient {
     socket;

package/dist/types.d.ts

@@ -47,7 +47,6 @@ export interface PluginConfig {
     markdownIngestionObsidianDebounceMs?: number;
     markdownIngestionInclude?: string[];
     markdownIngestionExclude?: string[];
-    markdownIngestionCollection?: string;
     markdownIngestionDebounceMs?: number;
     dreamPromotionEnabled?: boolean;
     dreamPromotionDiaryPath?: string;

package/docs/features.md

@@ -51,7 +51,6 @@ Relevant config fields:
 | `markdownIngestionRoots` | Generic markdown roots to watch. |
 | `markdownIngestionInclude` | Optional include globs for generic roots. |
 | `markdownIngestionExclude` | Optional exclude globs for generic roots. |
-| `markdownIngestionCollection` | Target collection for generic markdown, default `global`. |
 | `markdownIngestionDebounceMs` | Watch debounce window, default `150`. |
 | `markdownIngestionObsidianEnabled` | Enables Obsidian ingestion when vault roots exist. |
 | `markdownIngestionObsidianRoots` | Obsidian vault roots to watch. |

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.22",
+  "version": "1.4.24",
   "kind": [
     "memory",
     "context-engine"
@@ -197,10 +197,6 @@
           "type": "string"
         }
       },
-      "markdownIngestionCollection": {
-        "type": "string",
-        "default": "global"
-      },
       "markdownIngestionDebounceMs": {
         "type": "number",
         "default": 150

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.4.22",
+  "version": "1.4.24",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -38,7 +38,7 @@
     }
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && mkdir -p dist/proto dist/generated && cp -rf api/proto/. dist/proto/ && cp -rf src/generated/. dist/generated/",
+    "build": "tsc -p tsconfig.build.json && mkdir -p dist/proto && cp -rf api/proto/. dist/proto/",
     "check": "tsc --noEmit && pnpm run test:ts",
     "test:ts": "tsc -p tsconfig.tests.json && node --test .ts-build/test/unit/*.test.js",
     "test:integration": "tsc -p tsconfig.tests.json && node --test .ts-build/test/integration/checklist-validation.test.js .ts-build/test/integration/dream-promotion.test.js .ts-build/test/integration/host-flow.test.js .ts-build/test/integration/markdown-ingest.test.js .ts-build/test/integration/sidecar-lifecycle.test.js",
@@ -56,6 +56,7 @@
     "@bufbuild/protobuf": "1.7.2",
     "@grpc/grpc-js": "^1.14.3",
     "@grpc/proto-loader": "^0.8.0",
+    "@xdarkicex/libravdb-contracts": "^0.0.1",
     "openclaw": "*"
   },
   "devDependencies": {