@xdarkicex/openclaw-memory-libravdb 1.4.22 → 1.4.23

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/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.23",
   "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.23",
   "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": {