@xdarkicex/openclaw-memory-libravdb 1.4.21 → 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/index.js

@@ -12,16 +12,16 @@ import { createPluginRuntime } from "./plugin-runtime.js";
 export const MEMORY_ID = "libravdb-memory";
 const LIGHTWEIGHT_MODES = new Set(["cli-metadata", "setup-only"]);
 export function register(api) {
-    const mode = api.registrationMode;
+    const registrationMode = api.registrationMode;
     const logger = api.logger ?? console;
-    if (mode === "cli-metadata") {
+    if (registrationMode === "cli-metadata") {
         registerMemoryCliMetadata(api);
         return;
     }
     const cfg = api.pluginConfig;
-    const isLightweight = LIGHTWEIGHT_MODES.has(mode);
-    const isDiscovery = mode === "discovery";
-    logger.info?.(`LibraVDB registering mode=${mode} lightweight=${isLightweight} ` +
+    const isLightweight = LIGHTWEIGHT_MODES.has(registrationMode);
+    const isDiscovery = registrationMode === "discovery";
+    logger.info?.(`LibraVDB registering mode=${registrationMode} lightweight=${isLightweight} ` +
         `discovery=${isDiscovery} userId=${cfg.userId ?? "(auto)"} ` +
         `crossSessionRecall=${cfg.crossSessionRecall !== false}`);
     // Runtime creation:
@@ -41,7 +41,7 @@ export function register(api) {
             logger.info?.(`LibraVDB: discovery mode — CLI registered, context engine deferred.`);
         }
         else {
-            logger.warn?.(`LibraVDB: registration mode is "${mode}". ` +
+            logger.warn?.(`LibraVDB: registration mode is "${registrationMode}". ` +
                 `Context engine hooks (bootstrap, ingest, afterTurn) are NOT registered. ` +
                 `Memory will not be written automatically — only CLI commands are available.`);
         }

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/sidecar.js

@@ -373,6 +373,9 @@ export function buildSidecarEnv(cfg) {
     if (cfg.embeddingRuntimePath) {
         env.LIBRAVDB_ONNX_RUNTIME = cfg.embeddingRuntimePath;
     }
+    if (cfg.onnxDevice) {
+        env.LIBRAVDB_ONNX_DEVICE = cfg.onnxDevice;
+    }
     if (cfg.embeddingBackend) {
         env.LIBRAVDB_EMBEDDING_BACKEND = cfg.embeddingBackend;
     }

package/dist/types.d.ts

@@ -15,6 +15,9 @@ export interface PluginConfig {
     useSessionRecallProjection?: boolean;
     useSessionSummarySearchExperiment?: boolean;
     embeddingRuntimePath?: string;
+    /** Optional ONNX execution provider override passed through to libravdbd.
+     *  Use "cpu" to bypass CoreML/MPS on Intel Macs or fragile GPU/NPU providers. */
+    onnxDevice?: "auto" | "cpu" | "cuda" | "coreml" | "directml" | "openvino";
     embeddingBackend?: "bundled" | "onnx-local" | "custom-local";
     embeddingProfile?: string;
     fallbackProfile?: string;
@@ -44,7 +47,6 @@ export interface PluginConfig {
     markdownIngestionObsidianDebounceMs?: number;
     markdownIngestionInclude?: string[];
     markdownIngestionExclude?: string[];
-    markdownIngestionCollection?: string;
     markdownIngestionDebounceMs?: number;
     dreamPromotionEnabled?: boolean;
     dreamPromotionDiaryPath?: string;

package/docs/embedding-profiles.md

@@ -12,6 +12,7 @@ Why:
 - MiniLM keeps the local LongMemEval retrieval slice inside the target memory envelope on macOS.
 - Nomic remains available as an explicit opt-in profile for long-context experiments.
 - Nomic ONNX on macOS is fragile with CoreML execution and can trigger multi-GB RSS, so it is no longer the safe bundled default.
+- Intel Macs without reliable Metal/MPS support should set `onnxDevice: "cpu"` to force CPU ONNX execution and bypass CoreML.
 
 Current shipped profile names:
 
@@ -33,6 +34,7 @@ How it works:
 - `onnx-local` still requires local model assets through `embeddingModelPath`, typically a directory containing `embedding.json`.
 - The manifest may override or refine the profile, but explicit dimension mismatches fail closed.
 - The sidecar store persists an embedding fingerprint, so reopening an existing store with a different effective model profile will fail instead of silently mixing vector spaces.
+- `onnxDevice` is passed through as `LIBRAVDB_ONNX_DEVICE` for daemon versions that support execution-provider selection (`auto`, `cpu`, `cuda`, `coreml`, `directml`, `openvino`).
 
 Recommended usage:
 

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.21",
+  "version": "1.4.23",
   "kind": [
     "memory",
     "context-engine"
@@ -22,12 +22,59 @@
       "sidecarPath": {
         "type": "string"
       },
+      "userId": {
+        "type": "string",
+        "description": "Stable identity for cross-session durable memory. When set, sessions share memories under user:{userId}."
+      },
+      "identityPath": {
+        "type": "string",
+        "description": "Custom path for the auto-derived identity JSON file."
+      },
+      "crossSessionRecall": {
+        "type": "boolean",
+        "default": true,
+        "description": "When false, only session-scoped memories are retrieved; durable user recall is skipped."
+      },
+      "useSessionRecallProjection": {
+        "type": "boolean"
+      },
+      "grpcEndpoint": {
+        "type": "string",
+        "description": "Optional gRPC kernel endpoint for hosts using the daemon kernel transport."
+      },
+      "authoredHardBudgetFraction": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1
+      },
+      "authoredSoftBudgetFraction": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1
+      },
+      "elevatedGuidanceBudgetFraction": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1
+      },
       "useSessionSummarySearchExperiment": {
         "type": "boolean"
       },
       "embeddingRuntimePath": {
         "type": "string"
       },
+      "onnxDevice": {
+        "type": "string",
+        "enum": [
+          "auto",
+          "cpu",
+          "cuda",
+          "coreml",
+          "directml",
+          "openvino"
+        ],
+        "description": "Optional ONNX execution provider override passed to libravdbd. Use cpu to bypass CoreML/MPS on Intel Macs."
+      },
       "embeddingBackend": {
         "type": "string",
         "enum": [
@@ -150,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.21",
+  "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": {