@xdarkicex/openclaw-memory-libravdb 1.5.5 → 1.6.1

package/dist/memory-runtime.js

@@ -1,17 +1,15 @@
 import { resolveDurableNamespace, resolveUserCollection } from "./memory-scopes.js";
 import { resolveIdentity } from "./identity.js";
 import { detectDreamQuerySignal, resolveDreamCollection } from "./dream-routing.js";
-export function buildMemoryRuntimeBridge(getRpc, cfg) {
+export function buildMemoryRuntimeBridge(getClient, cfg) {
     return {
         async getMemorySearchManager(params = {}) {
-            const status = await readStatus(getRpc, params.purpose);
+            const status = await readStatus(getClient, params.purpose);
             return {
-                manager: createMemorySearchManager(getRpc, cfg, params, status),
+                manager: createMemorySearchManager(getClient, cfg, params, status),
             };
         },
         resolveMemoryBackendConfig() {
-            // We keep retrieval inside the plugin-side sidecar rather than delegating to
-            // OpenClaw's external QMD path.
             return { backend: "builtin" };
         },
         async closeAllMemorySearchManagers() {
@@ -19,10 +17,10 @@ export function buildMemoryRuntimeBridge(getRpc, cfg) {
         },
     };
 }
-function createMemorySearchManager(getRpc, cfg, defaults, initialStatus) {
+function createMemorySearchManager(getClient, cfg, defaults, initialStatus) {
     let cachedStatus = initialStatus;
     let cachedIdentityUserId = null;
-    const returnedSearchPaths = new Set();
+    const returnedSearchPaths = new Map();
     function getResolvedUserId(sessionKey) {
         if (cachedIdentityUserId !== null)
             return cachedIdentityUserId;
@@ -65,14 +63,14 @@ function createMemorySearchManager(getRpc, cfg, defaults, initialStatus) {
             });
             const k = normalizePositiveInteger(params.k, params.limit, params.maxResults, params.topK, cfg.topK, 8);
             const minScore = normalizeNumber(params.minScore);
-            const rpc = await getRpc();
+            const client = await getClient();
             const result = dreamQuery.active && cfg.crossSessionRecall !== false
-                ? await rpc.call("search_text", {
+                ? await client.searchText({
                     collection: resolveDreamCollection(userId),
                     text: queryText,
                     k,
                 })
-                : await searchResolvedCollections(rpc, cfg, userId, sessionId, queryText, k);
+                : await searchResolvedCollections(client, cfg, userId, sessionId, queryText, k);
             const filteredResults = minScore === undefined
                 ? result.results
                 : result.results.filter((item) => item.score >= minScore);
@@ -83,32 +81,34 @@ function createMemorySearchManager(getRpc, cfg, defaults, initialStatus) {
             if (legacyCall) {
                 return { results: legacyResults };
             }
-            const memoryResults = filteredResults.map(toMemorySearchResult);
-            for (const item of memoryResults) {
-                returnedSearchPaths.add(item.path);
-            }
+            const memoryResults = filteredResults.map((item) => {
+                const meta = parseMetadataJson(item);
+                const collection = typeof meta.collection === "string" ? meta.collection : "memory";
+                const relPath = encodeSearchResultPath(collection, item.id);
+                returnedSearchPaths.set(relPath, item.text);
+                return toMemorySearchResult(item);
+            });
             return memoryResults;
         },
         async readFile(params) {
-            if (!returnedSearchPaths.has(params.relPath)) {
+            const cachedText = returnedSearchPaths.get(params.relPath);
+            if (cachedText === undefined) {
                 throw new Error("LibraVDB memory path was not returned by this search manager");
             }
-            const located = await loadSearchResultText(getRpc, params.relPath);
             const fromLine = Math.max(1, params.from ?? 1);
             const lineCount = Math.max(1, params.lines ?? 200);
-            const lines = located.text.split("\n");
+            const lines = cachedText.split("\n");
             const text = lines.slice(fromLine - 1, fromLine - 1 + lineCount).join("\n");
             return {
                 text,
-                path: located.path,
+                path: params.relPath,
             };
         },
         async ingest() {
-            // The plugin already owns per-turn ingest through the context engine.
             return { ingested: false, delegatedToContextEngine: true };
         },
         async sync(_params) {
-            cachedStatus = await readStatus(getRpc, defaults.purpose);
+            cachedStatus = await readStatus(getClient, defaults.purpose);
             return { synced: true, delegatedToContextEngine: true };
         },
         status() {
@@ -126,22 +126,22 @@ function createMemorySearchManager(getRpc, cfg, defaults, initialStatus) {
             return cachedStatus.ok ?? false;
         },
         async close() {
-            // The sidecar connection is shared by the plugin runtime.
+            // The client connection is shared by the plugin runtime.
         },
     };
 }
-async function searchResolvedCollections(rpc, cfg, userId, sessionId, queryText, k) {
+async function searchResolvedCollections(client, 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", {
+        ? await client.searchText({
             collection: collections[0],
             text: queryText,
             k,
         })
-        : await rpc.call("search_text_collections", {
+        : await client.searchTextCollections({
             collections,
             text: queryText,
             k,
@@ -180,8 +180,20 @@ function firstString(...values) {
     }
     return undefined;
 }
+function parseMetadataJson(item) {
+    if (item.metadataJson && item.metadataJson.length > 0) {
+        try {
+            return JSON.parse(new TextDecoder().decode(item.metadataJson));
+        }
+        catch (e) {
+            // ignore
+        }
+    }
+    return {};
+}
 function toMemorySearchResult(item) {
-    const collection = typeof item.metadata.collection === "string" ? item.metadata.collection : "memory";
+    const meta = parseMetadataJson(item);
+    const collection = typeof meta.collection === "string" ? meta.collection : "memory";
     return {
         path: encodeSearchResultPath(collection, item.id),
         startLine: 1,
@@ -192,36 +204,13 @@ function toMemorySearchResult(item) {
         citation: `${collection}:${item.id}`,
     };
 }
-async function loadSearchResultText(getRpc, relPath) {
-    const { collection, id } = decodeSearchResultPath(relPath);
-    const rpc = await getRpc();
-    const result = await rpc.call("list_collection", { collection });
-    const item = result.results.find((entry) => entry.id === id);
-    if (!item) {
-        throw new Error(`LibraVDB memory path not found: ${relPath}`);
-    }
-    return {
-        path: relPath,
-        text: item.text,
-    };
-}
 function encodeSearchResultPath(collection, id) {
     return `${encodeURIComponent(collection)}::${encodeURIComponent(id)}`;
 }
-function decodeSearchResultPath(relPath) {
-    const separator = relPath.indexOf("::");
-    if (separator <= 0) {
-        throw new Error(`Unsupported LibraVDB memory path: ${relPath}`);
-    }
-    return {
-        collection: decodeURIComponent(relPath.slice(0, separator)),
-        id: decodeURIComponent(relPath.slice(separator + 2)),
-    };
-}
-async function readStatus(getRpc, purpose) {
+async function readStatus(getClient, purpose) {
     try {
-        const rpc = await getRpc();
-        const status = await rpc.call("status", {});
+        const client = await getClient();
+        const status = await client.status({});
         return {
             ...status,
             backend: "builtin",

package/dist/plugin-runtime.d.ts

@@ -1,7 +1,6 @@
-import { RpcClient } from "./rpc.js";
-import { GrpcKernelClient } from "./grpc-client.js";
+import { LibravDBClient } from "./libravdb-client.js";
 import type { LoggerLike, PluginConfig } from "./types.js";
-export type RpcGetter = () => Promise<RpcClient>;
+export type ClientGetter = () => Promise<LibravDBClient>;
 export declare const DEFAULT_RPC_TIMEOUT_MS = 30000;
 export declare const STARTUP_HEALTH_TIMEOUT_MS = 2000;
 export declare const VALID_TLS_MODES: readonly ["auto", "tls", "insecure"];
@@ -23,12 +22,11 @@ export interface LifecycleHint {
 }
 export type RuntimeShutdownTask = () => Promise<void> | void;
 export interface PluginRuntime {
-    getRpc: RpcGetter;
-    getKernel(): Promise<GrpcKernelClient | null>;
+    getClient: ClientGetter;
     emitLifecycleHint(hint: LifecycleHint): Promise<void>;
     onShutdown(task: RuntimeShutdownTask): void;
     shutdown(): Promise<void>;
 }
+export declare function daemonProvisioningHint(): string;
 export declare function createPluginRuntime(cfg: PluginConfig, logger?: LoggerLike): PluginRuntime;
-export declare function validateGrpcKernelConfig(cfg: PluginConfig, logger: LoggerLike): void;
 export declare function enrichStartupError(error: unknown, healthMessage?: string): Error;

package/dist/plugin-runtime.js

@@ -1,8 +1,5 @@
-import { RpcClient } from "./rpc.js";
-import { GrpcKernelClient } from "./grpc-client.js";
-import { daemonProvisioningHint, startSidecar } from "./sidecar.js";
+import { LibravDBClient } from "./libravdb-client.js";
 import { formatError } from "./format-error.js";
-import { readFileSync } from "node:fs";
 export const DEFAULT_RPC_TIMEOUT_MS = 30000;
 export const STARTUP_HEALTH_TIMEOUT_MS = 2000;
 export const VALID_TLS_MODES = ["auto", "tls", "insecure"];
@@ -10,6 +7,9 @@ const isTlsModeValid = (m) => VALID_TLS_MODES.includes(m);
 export function resolveStartupHealthTimeoutMs(cfg) {
     return Math.max(STARTUP_HEALTH_TIMEOUT_MS, cfg.rpcTimeoutMs ?? DEFAULT_RPC_TIMEOUT_MS);
 }
+export function daemonProvisioningHint() {
+    return "If you installed the npm package, install and start libravdbd separately; the package does not provision the daemon binary, ONNX Runtime, or model assets.";
+}
 export function createPluginRuntime(cfg, logger = console) {
     let started = null;
     let stopped = false;
@@ -20,62 +20,35 @@ export function createPluginRuntime(cfg, logger = console) {
             throw new Error("LibraVDB plugin runtime has been shut down");
         }
         if (!started) {
+            let client;
             started = (async () => {
-                validateGrpcKernelConfig(cfg, logger);
-                const sidecar = await startSidecar(cfg, logger);
-                const rpc = new RpcClient(sidecar.socket, {
+                validateTlsConfig(cfg, logger);
+                client = new LibravDBClient({
+                    endpoint: cfg.grpcEndpoint || cfg.sidecarPath,
                     timeoutMs: cfg.rpcTimeoutMs ?? DEFAULT_RPC_TIMEOUT_MS,
+                    tlsCaPath: cfg.grpcEndpointTlsCa,
+                    tlsMode: cfg.grpcEndpointTlsMode,
+                    tlsClientCertPath: cfg.grpcEndpointTlsClientCert,
+                    tlsClientKeyPath: cfg.grpcEndpointTlsClientKey,
                 });
-                const health = await rpc.call("health", {}, {
-                    timeoutMs: resolveStartupHealthTimeoutMs(cfg),
-                });
-                if (!health.ok) {
-                    try {
-                        await sidecar.shutdown();
-                    }
-                    catch {
-                        // Ignore cleanup failure on startup rejection.
-                    }
-                    throw enrichStartupError("LibraVDB daemon failed health check", health.message);
-                }
-                let kernel = null;
-                if (cfg.grpcEndpoint) {
-                    const secret = loadSecretFromEnv();
-                    try {
-                        kernel = new GrpcKernelClient({
-                            endpoint: cfg.grpcEndpoint,
-                            secret,
-                            timeoutMs: cfg.rpcTimeoutMs ?? DEFAULT_RPC_TIMEOUT_MS,
-                            tlsCaPath: cfg.grpcEndpointTlsCa,
-                            tlsMode: cfg.grpcEndpointTlsMode,
-                            tlsClientCertPath: cfg.grpcEndpointTlsClientCert,
-                            tlsClientKeyPath: cfg.grpcEndpointTlsClientKey,
-                        });
-                    }
-                    catch (error) {
-                        // Only gRPC init errors land here — config validation already threw above
-                        logger.warn?.(`LibraVDB: failed to initialize gRPC kernel client: ${formatError(error)}`);
-                    }
-                }
-                return { rpc, sidecar, kernel };
+                await client.bootstrapHandshake();
+                return client;
             })().catch((error) => {
                 started = null;
+                client?.close();
                 throw enrichStartupError(error);
             });
         }
         return await started;
     };
     return {
-        async getRpc() {
-            return (await ensureStarted()).rpc;
-        },
-        async getKernel() {
-            return (await ensureStarted()).kernel;
+        async getClient() {
+            return await ensureStarted();
         },
         async emitLifecycleHint(hint) {
             try {
-                const active = await ensureStarted();
-                await active.rpc.call("session_lifecycle_hint", hint);
+                const client = await ensureStarted();
+                await client.sessionLifecycleHint(hint);
             }
             catch (error) {
                 logger.warn?.(`LibraVDB lifecycle hint dropped: ${formatError(error)}`);
@@ -104,24 +77,27 @@ export function createPluginRuntime(cfg, logger = console) {
             if (!started) {
                 return;
             }
-            const active = started;
+            const client = started;
             started = null;
-            const { rpc, sidecar, kernel } = await active;
             try {
-                if (kernel)
-                    kernel.close();
-                await rpc.call("flush", {});
+                const resolved = await client;
+                try {
+                    await resolved.flush({});
+                }
+                catch (error) {
+                    logger.warn?.(`LibraVDB flush failed during shutdown: ${formatError(error)}`);
+                }
+                finally {
+                    resolved.close();
+                }
             }
-            finally {
-                await sidecar.shutdown();
+            catch {
+                // startup may have failed before client resolution; nothing to flush or close
             }
         },
     };
 }
-export function validateGrpcKernelConfig(cfg, logger) {
-    if (!cfg.grpcEndpoint) {
-        return;
-    }
+function validateTlsConfig(cfg, logger) {
     if (cfg.grpcEndpointTlsMode !== undefined &&
         !isTlsModeValid(cfg.grpcEndpointTlsMode)) {
         throw new Error(`LibraVDB: invalid grpcEndpointTlsMode "${cfg.grpcEndpointTlsMode}" — ` +
@@ -145,21 +121,6 @@ export function validateGrpcKernelConfig(cfg, logger) {
         }
     }
 }
-function loadSecretFromEnv() {
-    const secret = process.env.LIBRAVDB_AUTH_SECRET;
-    if (secret)
-        return secret;
-    const path = process.env.LIBRAVDB_AUTH_SECRET_FILE;
-    if (path) {
-        try {
-            return readFileSync(path, "utf8").trim();
-        }
-        catch {
-            return undefined;
-        }
-    }
-    return undefined;
-}
 export function enrichStartupError(error, healthMessage) {
     const rawMessage = error instanceof Error ? error.message : String(error);
     const message = rawMessage.trim() || "LibraVDB daemon startup failed";

package/dist/types.d.ts

@@ -1,5 +1,6 @@
 export interface PluginConfig {
     dbPath?: string;
+    /** Legacy fallback alias for grpcEndpoint. */
     sidecarPath?: string;
     /** Stable identity for cross-session durable memory. When set, all sessions
      *  share memories under user:{userId}. When unset, the plugin auto-derives
@@ -89,7 +90,6 @@ export interface PluginConfig {
     ollamaUrl?: string;
     compactModel?: string;
     rpcTimeoutMs?: number;
-    maxRetries?: number;
     logLevel?: "debug" | "info" | "warn" | "error";
     grpcEndpoint?: string;
     grpcEndpointTlsCa?: string;
@@ -146,31 +146,11 @@ export interface SearchResult {
     };
     finalScore?: number;
 }
-export interface SidecarSocket {
-    setEncoding(encoding: string): void;
-    on(event: "data", handler: (chunk: Buffer) => void): void;
-    on(event: "close", handler: () => void): void;
-    on(event: "error", handler: (error: Error) => void): void;
-    once(event: "connect", handler: () => void): void;
-    once(event: "error", handler: (error: Error) => void): void;
-    off(event: "connect", handler: () => void): void;
-    off(event: "error", handler: (error: Error) => void): void;
-    write(chunk: Buffer | string): void;
-    destroy(err?: Error): void;
-}
 export interface LoggerLike {
     error(message: string): void;
     info?(message: string): void;
     warn?(message: string): void;
 }
-export interface SidecarHandle {
-    socket: SidecarSocket;
-    isDegraded(): boolean;
-    shutdown(): Promise<void>;
-}
-export interface RpcCallOptions {
-    timeoutMs: number;
-}
 export interface PredictedContext {
     id: string;
     text: string;

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.5.5",
+  "version": "1.6.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -51,12 +51,11 @@
     "check": "tsc --noEmit && pnpm run test:ts",
     "test:inspect": "pnpm run plugin:ci",
     "test:ts": "pnpm run test:inspect && tsc -p tsconfig.tests.json && node --test .ts-build/test/unit/*.test.js",
-    "test:integration": "pnpm run test:inspect && 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",
+    "test:integration": "pnpm run test:inspect && 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",
     "benchmark:session_search_mid": "tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 node --test --test-name-pattern=\"real sidecar mid-sized session search benchmark\" .ts-build/test/integration/host-flow.test.js",
     "gate:assemble_optimization": "tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 OPENCLAW_ENFORCE_ASSEMBLE_EVIDENCE_GATE=1 node --test --test-name-pattern=\"real sidecar mid-sized session search benchmark\" .ts-build/test/integration/host-flow.test.js",
     "probe:session_recall": "tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 node --test --test-name-pattern=\"real sidecar mid-sized session search benchmark\" .ts-build/test/integration/host-flow.test.js",
     "probe:session_recall_threshold": "tsc -p tsconfig.tests.json && OPENCLAW_PROFILE_ASSEMBLE=1 node --test --test-name-pattern=\"real sidecar session_recall index threshold probe\" .ts-build/test/integration/host-flow.test.js",
-    "benchmark:longmemeval": "tsc -p tsconfig.tests.json && node --test .ts-build/test/integration/longmemeval-benchmark.test.js",
     "benchmark:longmemeval:score": "node scripts/longmemeval-score.mjs",
     "benchmark:longmemeval:diagnose": "node scripts/longmemeval-diagnose.mjs",
     "plugin:check": "plugin-inspector inspect --no-openclaw",
@@ -70,12 +69,16 @@
     "@grpc/proto-loader": "^0.8.0",
     "@openclaw/plugin-inspector": "0.3.7",
     "@types/node": "^20.11.0",
-    "@xdarkicex/libravdb-contracts": "^0.0.7",
     "esbuild": "^0.27.0",
     "openclaw": "2026.4.11",
     "typescript": "^6.0.3"
   },
   "peerDependencies": {
     "openclaw": ">=2026.3.22"
+  },
+  "dependencies": {
+    "@connectrpc/connect": "^1.7.0",
+    "@connectrpc/connect-node": "^1.7.0",
+    "@xdarkicex/libravdb-contracts": "^0.3.0"
   }
 }

package/dist/grpc-client.d.ts

@@ -1,44 +0,0 @@
-import * as grpc from "@grpc/grpc-js";
-export interface GrpcClientOptions {
-    endpoint: string;
-    secret?: string;
-    timeoutMs?: number;
-    tlsCaPath?: string;
-    tlsMode?: "auto" | "tls" | "insecure";
-    tlsClientCertPath?: string;
-    tlsClientKeyPath?: string;
-}
-export declare function resolveGrpcTarget(endpoint: string): string;
-/**
- * Selects gRPC credential mode based on endpoint address class.
- *
- * - Unix socket endpoints → plaintext (local-only transport)
- * - Loopback addresses (localhost, 127.0.0.1, ::1) → plaintext
- * - All other TCP and DNS targets → TLS
- *
- * resolveGrpcCredentials uses this classification to return the
- * appropriate grpc.ChannelCredentials. Pass tlsCaPath to load a
- * custom CA certificate PEM file for self-signed or private CA
- * deployments. Omit tlsCaPath for publicly trusted certificates
- * (Let's Encrypt, cert-manager) — the system CA pool is used.
- */
-export declare function resolveGrpcCredentialMode(endpoint: string, tlsMode?: "auto" | "tls" | "insecure"): "insecure" | "tls";
-export declare function resolveGrpcCredentials(endpoint: string, tlsCaPath?: string, tlsMode?: "auto" | "tls" | "insecure", tlsClientCertPath?: string, tlsClientKeyPath?: string): grpc.ChannelCredentials;
-export declare class GrpcKernelClient {
-    private client;
-    private readonly secret;
-    private readonly timeoutMs;
-    private nonceHex;
-    constructor(options: GrpcClientOptions);
-    private getMetadata;
-    private call;
-    initializeSession(req: any): Promise<any>;
-    assembleContext(req: any): Promise<any>;
-    rankCandidates(req: any): Promise<any>;
-    ingestMessage(req: any): Promise<any>;
-    afterTurn(req: any): Promise<any>;
-    bootstrapSession(req: any): Promise<any>;
-    compactSession(req: any): Promise<any>;
-    getStatus(req?: any): Promise<any>;
-    close(): void;
-}