@xdarkicex/openclaw-memory-libravdb 1.5.5 → 1.6.1

package/dist/cli.js

@@ -156,9 +156,9 @@ async function runStatus(runtime, cfg, logger, opts = {}) {
         }
     }
     try {
-        const rpc = await runtime.getRpc();
-        const status = await rpc.call("status", {});
-        const deep = opts.deep ? await runDeepStatusProbe(rpc, cfg) : undefined;
+        const client = await runtime.getClient();
+        const status = await client.status({});
+        const deep = opts.deep ? await runDeepStatusProbe(client, cfg) : undefined;
         if (opts.json) {
             console.log(JSON.stringify({ status, ...(deep ? { deep } : {}) }, null, 2));
             if (deep && !deep.ok) {
@@ -208,7 +208,7 @@ async function runStatus(runtime, cfg, logger, opts = {}) {
     }
 }
 const AUTHORED_STATUS_COLLECTIONS = ["authored:hard", "authored:soft", "authored:variant"];
-async function runDeepStatusProbe(rpc, cfg) {
+async function runDeepStatusProbe(client, cfg) {
     // Resolve userId without triggering auto-derive file writes.
     // status --deep should be read-only; if no userId is configured and no
     // identity file exists, fall back to "default" rather than creating one.
@@ -233,7 +233,7 @@ async function runDeepStatusProbe(rpc, cfg) {
     const allCollections = [...AUTHORED_STATUS_COLLECTIONS, ...durableCollections];
     for (const collection of allCollections) {
         try {
-            const result = await rpc.call("search_text", {
+            const result = await client.searchText({
                 collection,
                 text: "memory",
                 k: 1,
@@ -280,13 +280,11 @@ async function runIndex(runtime, cfg, opts, logger, params = {}) {
         .map((c) => c.trim())
         .filter((c) => c.length > 0);
     try {
-        const rpc = await runtime.getRpc();
-        const result = await rpc.call("rebuild_index", {
+        const client = await runtime.getClient();
+        const result = await client.rebuildIndex({
             namespace: namespace ?? "",
             ...(collections?.length ? { collections } : {}),
-        }, {
-            timeoutMs: resolveIndexRebuildTimeoutMs(cfg),
-        });
+        }, { timeoutMs: resolveIndexRebuildTimeoutMs(cfg) });
         if (!params.quiet) {
             console.log(`Collections processed: ${result.collectionsProcessed ?? 0}`);
             console.log(`Records reindexed:     ${result.recordsReindexed ?? 0}`);
@@ -332,7 +330,7 @@ async function runSearch(runtime, cfg, queryArg, opts, logger) {
         return;
     }
     try {
-        const bridge = buildMemoryRuntimeBridge(runtime.getRpc, cfg);
+        const bridge = buildMemoryRuntimeBridge(runtime.getClient, cfg);
         const { manager } = await bridge.getMemorySearchManager({
             agentId: opts?.agent,
         });
@@ -379,8 +377,8 @@ async function runFlush(runtime, opts, logger) {
         }
     }
     try {
-        const rpc = await runtime.getRpc();
-        await rpc.call("flush_namespace", scope.params);
+        const client = await runtime.getClient();
+        await client.flushNamespace(scope.params);
         console.log(`Deleted durable memory namespace ${scope.displayName}.`);
     }
     catch (error) {
@@ -396,8 +394,8 @@ async function runExport(runtime, opts, logger) {
         return;
     }
     try {
-        const rpc = await runtime.getRpc();
-        const result = await rpc.call("export_memory", scope.params);
+        const client = await runtime.getClient();
+        const result = await client.exportMemory(scope.params);
         for (const record of result.records ?? []) {
             stdout.write(`${JSON.stringify(record)}\n`);
         }
@@ -418,13 +416,13 @@ async function runJournal(runtime, opts, logger) {
         return;
     }
     try {
-        const rpc = await runtime.getRpc();
-        const result = await rpc.call("list_lifecycle_journal", {
+        const client = await runtime.getClient();
+        const result = await client.listLifecycleJournal({
             sessionId: opts?.sessionId?.trim() || undefined,
             limit,
         });
-        for (const record of result.results ?? []) {
-            stdout.write(`${JSON.stringify(record)}\n`);
+        for (const entry of result.entries) {
+            stdout.write(`${entry}\n`);
         }
     }
     catch (error) {
@@ -441,8 +439,8 @@ async function runDreamPromote(runtime, opts, logger) {
         return;
     }
     try {
-        const rpc = await runtime.getRpc();
-        const result = await promoteDreamDiaryFile(rpc, { userId, diaryPath: dreamFile });
+        const client = await runtime.getClient();
+        const result = await promoteDreamDiaryFile(client, { userId, diaryPath: dreamFile });
         console.log(`Promoted ${result.promoted ?? 0} dream entr${(result.promoted ?? 0) === 1 ? "y" : "ies"}; rejected ${result.rejected ?? 0}.`);
     }
     catch (error) {

package/dist/context-engine.d.ts

@@ -61,7 +61,7 @@ export declare function buildContextEngineFactory(runtime: PluginRuntime, cfg: P
         sessionId: string;
         sessionKey?: string;
         userId?: string;
-    }): Promise<any>;
+    }): Promise<import("@xdarkicex/libravdb-contracts").BootstrapSessionKernelResponse>;
     ingest(args: {
         sessionId: string;
         sessionKey?: string;
@@ -72,7 +72,7 @@ export declare function buildContextEngineFactory(runtime: PluginRuntime, cfg: P
             id?: string;
         };
         isHeartbeat?: boolean;
-    }): Promise<any>;
+    }): Promise<import("@xdarkicex/libravdb-contracts").IngestMessageKernelResponse>;
     assemble(args: {
         sessionId: string;
         sessionKey?: string;
@@ -98,6 +98,6 @@ export declare function buildContextEngineFactory(runtime: PluginRuntime, cfg: P
         isHeartbeat?: boolean;
         tokenBudget?: number;
         runtimeContext?: Record<string, unknown>;
-    }): Promise<any>;
+    }): Promise<import("@xdarkicex/libravdb-contracts").AfterTurnKernelResponse>;
 };
 export {};

package/dist/context-engine.js

@@ -420,16 +420,6 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
         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,
@@ -483,9 +473,9 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
         const missingTokens = tokens.filter((token) => !existingBlocks.some((block) => isExactRecallFact(block, token)));
         if (missingTokens.length === 0)
             return assembled;
-        let rpc;
+        let client;
         try {
-            rpc = await runtime.getRpc();
+            client = await runtime.getClient();
         }
         catch (error) {
             logger.warn?.(`LibraVDB exact recall skipped sessionId=${args.sessionId}: ` +
@@ -495,7 +485,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
         const injectedFacts = [];
         for (const token of missingTokens) {
             try {
-                const result = await rpc.call("search_text_collections", {
+                const result = await client.searchTextCollections({
                     collections: [resolveUserCollection(args.userId), "global"],
                     text: token,
                     k: Math.max(EXACT_RECALL_SEARCH_K, cfg.topK ?? 0),
@@ -559,30 +549,11 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 : {}),
         };
     }
-    function isGrpcAuthConfigured() {
-        const secret = process.env.LIBRAVDB_AUTH_SECRET?.trim();
-        const secretFile = process.env.LIBRAVDB_AUTH_SECRET_FILE?.trim();
-        return (typeof secret === "string" && secret.length > 0) || (typeof secretFile === "string" && secretFile.length > 0);
-    }
-    function buildGrpcAuthInitializationError(error) {
-        const code = typeof error?.code === "number" ||
-            typeof error?.code === "string"
-            ? ` code=${String(error.code)}`
-            : "";
-        return new Error(`LibraVDB gRPC auth initialization failed${code}; ` +
-            `check LIBRAVDB_AUTH_SECRET and daemon auth configuration`);
-    }
     async function runCompaction(args) {
         const request = buildCompactSessionRequest(args);
-        const kernel = await getKernelOrNull("compact");
         try {
-            if (kernel) {
-                return normalizeCompactResult(await kernel.compactSession(request), {
-                    tokensBefore: args.currentTokenCount,
-                });
-            }
-            const rpc = await runtime.getRpc();
-            return normalizeCompactResult(await rpc.call("compact_session", request), {
+            const client = await runtime.getClient();
+            return normalizeCompactResult(await client.compactSession(request), {
                 tokensBefore: args.currentTokenCount,
             });
         }
@@ -648,30 +619,10 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
             });
             logger.info?.(`LibraVDB bootstrap sessionId=${sessionId} userId=${userId} ` +
                 `sessionKey=${args.sessionKey ?? "(none)"}`);
-            const kernel = await getKernelOrNull("bootstrap");
-            if (kernel) {
-                try {
-                    await kernel.initializeSession({
-                        clientId: "openclaw-ts-wrapper",
-                        clientCapabilities: [{ name: "grpc", version: "1.0" }]
-                    });
-                }
-                catch (error) {
-                    if (isGrpcAuthConfigured()) {
-                        throw buildGrpcAuthInitializationError(error);
-                    }
-                    // Proceed when the kernel does not require auth and the init call is unavailable.
-                }
-                return await kernel.bootstrapSession({
-                    sessionId,
-                    sessionKey: args.sessionKey,
-                    userId,
-                });
-            }
-            const rpc = await runtime.getRpc();
-            return await rpc.call("bootstrap_session_kernel", {
-                ...args,
+            const client = await runtime.getClient();
+            return await client.bootstrapSessionKernel({
                 sessionId,
+                sessionKey: args.sessionKey,
                 userId,
             });
         },
@@ -686,22 +637,13 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 `role=${message.role} heartbeat=${args.isHeartbeat ?? false} ` +
                 `contentLen=${message.content.length}`);
             try {
-                const kernel = await getKernelOrNull("ingest");
-                if (kernel) {
-                    return await kernel.ingestMessage({
-                        sessionId,
-                        sessionKey: args.sessionKey,
-                        userId,
-                        message,
-                        isHeartbeat: args.isHeartbeat,
-                    });
-                }
-                const rpc = await runtime.getRpc();
-                return await rpc.call("ingest_message_kernel", {
-                    ...args,
+                const client = await runtime.getClient();
+                return await client.ingestMessageKernel({
                     sessionId,
+                    sessionKey: args.sessionKey,
                     userId,
                     message,
+                    isHeartbeat: args.isHeartbeat,
                 });
             }
             catch (error) {
@@ -761,42 +703,17 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                     return buildBudgetFallbackContext(args.messages, args.tokenBudget);
                 }
             }
-            const kernel = await getKernelOrNull("assemble");
-            if (kernel) {
-                try {
-                    const assembled = normalizeAssembleResult(await kernel.assembleContext({
-                        sessionId,
-                        sessionKey: args.sessionKey,
-                        userId,
-                        queryText: args.prompt ?? "",
-                        visibleMessages: messages,
-                        tokenBudget: args.tokenBudget,
-                        config: buildAssemblyConfig(args.tokenBudget),
-                        emitDebug: true,
-                    }));
-                    return enforceTokenBudgetInvariant(await augmentWithExactRecall(assembled, {
-                        queryText: args.prompt ?? messages[messages.length - 1]?.content ?? "",
-                        userId,
-                        sessionId,
-                        tokenBudget: args.tokenBudget,
-                    }), args.tokenBudget);
-                }
-                catch (error) {
-                    logger.warn?.(`LibraVDB assemble kernel failed, using budget-clamped fallback context: ${error instanceof Error ? error.message : String(error)}`);
-                    return buildBudgetFallbackContext(args.messages, args.tokenBudget);
-                }
-            }
-            const rpc = await runtime.getRpc();
             try {
-                const resp = await rpc.call("assemble_context_internal", {
+                const client = await runtime.getClient();
+                const resp = await client.assembleContextInternal({
                     sessionId,
                     sessionKey: args.sessionKey,
                     userId,
+                    prompt: args.prompt ?? "",
                     messages,
                     tokenBudget: args.tokenBudget,
-                    prompt: args.prompt,
-                    emitDebug: true,
                     config: buildAssemblyConfig(args.tokenBudget),
+                    emitDebug: true,
                 });
                 const assembled = normalizeAssembleResult(resp);
                 const enforced = enforceTokenBudgetInvariant(await augmentWithExactRecall(assembled, {
@@ -814,7 +731,7 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 return enforced;
             }
             catch (error) {
-                logger.warn?.(`LibraVDB assemble sidecar failed, using budget-clamped fallback context: ${error instanceof Error ? error.message : String(error)}`);
+                logger.warn?.(`LibraVDB assemble failed, using budget-clamped fallback context: ${error instanceof Error ? error.message : String(error)}`);
                 return buildBudgetFallbackContext(args.messages, args.tokenBudget);
             }
         },
@@ -835,32 +752,11 @@ export function buildContextEngineFactory(runtime, cfg, logger = console) {
                 `prePromptMessageCount=${args.prePromptMessageCount ?? "unknown"} ` +
                 `heartbeat=${args.isHeartbeat ?? false}`);
             try {
-                const kernel = await getKernelOrNull("afterTurn");
+                const client = await runtime.getClient();
                 const currentTokenCount = normalizeCurrentTokenCount(typeof args.runtimeContext?.currentTokenCount === "number"
                     ? args.runtimeContext.currentTokenCount
                     : undefined);
-                if (kernel) {
-                    const result = await kernel.afterTurn({
-                        sessionId,
-                        sessionKey: args.sessionKey,
-                        userId,
-                        messages,
-                        isHeartbeat: args.isHeartbeat,
-                    });
-                    await performAfterTurnPredictiveCompaction({
-                        sessionId,
-                        messages,
-                        tokenBudget: args.tokenBudget,
-                        currentTokenCount,
-                    });
-                    const predictions = result.predictions;
-                    if (Array.isArray(predictions) && predictions.length > 0) {
-                        predictiveContextCache.set(sessionId, predictions);
-                    }
-                    return result;
-                }
-                const rpc = await runtime.getRpc();
-                const result = await rpc.call("after_turn_kernel", {
+                const result = await client.afterTurnKernel({
                     sessionId,
                     sessionKey: args.sessionKey,
                     userId,

package/dist/dream-promotion.d.ts

@@ -1,11 +1,9 @@
 import type { LoggerLike, PluginConfig } from "./types.js";
+import type { LibravDBClient } from "./libravdb-client.js";
 type Disposable = {
     close(): void;
 };
-interface RpcLike {
-    call<T>(method: string, params: unknown): Promise<T>;
-}
-type RpcGetterLike = () => Promise<RpcLike>;
+type ClientGetterLike = () => Promise<LibravDBClient>;
 interface FsWatcherLike extends Disposable {
     on(event: "error", handler: (error: Error) => void): void;
 }
@@ -34,8 +32,8 @@ interface DreamPromotionResult {
     promoted?: number;
     rejected?: number;
 }
-export declare function createDreamPromotionHandle(cfg: PluginConfig, getRpc: RpcGetterLike, logger?: LoggerLike, fsApi?: FsApi): DreamPromotionHandle;
-export declare function promoteDreamDiaryFile(rpc: RpcLike, opts: {
+export declare function createDreamPromotionHandle(cfg: PluginConfig, getClient: ClientGetterLike, logger?: LoggerLike, fsApi?: FsApi): DreamPromotionHandle;
+export declare function promoteDreamDiaryFile(client: LibravDBClient, opts: {
     userId: string;
     diaryPath: string;
     text?: string;

package/dist/dream-promotion.js

@@ -10,7 +10,7 @@ const DEFAULT_MIN_RECALL_COUNT = 2;
 const DEFAULT_MIN_UNIQUE_QUERIES = 2;
 const DREAM_PROMOTION_VERSION = 1;
 const DREAM_SOURCE_KIND = "dream";
-export function createDreamPromotionHandle(cfg, getRpc, logger = console, fsApi = createRealFsApi()) {
+export function createDreamPromotionHandle(cfg, getClient, logger = console, fsApi = createRealFsApi()) {
     const userId = cfg.dreamPromotionUserId?.trim() ?? "";
     if (cfg.dreamPromotionEnabled !== true || !userId) {
         return {
@@ -110,24 +110,28 @@ export function createDreamPromotionHandle(cfg, getRpc, logger = console, fsApi
             };
             return;
         }
-        const rpc = await getRpc();
-        const params = {
+        const client = await getClient();
+        await client.promoteDreamEntries({
             userId,
             sourceDoc: diaryPath,
             sourceRoot: path.dirname(diaryPath),
             sourcePath: path.basename(diaryPath),
             sourceKind: DREAM_SOURCE_KIND,
             fileHash,
-            sourceSize: stat.size,
-            sourceMtimeMs: stat.mtimeMs,
+            sourceSize: BigInt(stat.size),
+            sourceMtimeMs: BigInt(Math.trunc(stat.mtimeMs)),
             ingestVersion: DREAM_PROMOTION_VERSION,
             hashBackend: getHashBackendName(),
             entries: candidates.map((candidate) => ({
-                ...candidate,
+                text: candidate.text,
+                score: candidate.score,
+                recallCount: candidate.recallCount,
+                uniqueQueries: candidate.uniqueQueries,
+                section: candidate.section,
+                line: candidate.line,
                 sourceLine: candidate.line,
             })),
-        };
-        await rpc.call("promote_dream_entries", params);
+        });
         lastFileState = {
             size: stat.size,
             mtimeMs: stat.mtimeMs,
@@ -177,7 +181,7 @@ export function createDreamPromotionHandle(cfg, getRpc, logger = console, fsApi
         }
     }
 }
-export async function promoteDreamDiaryFile(rpc, opts) {
+export async function promoteDreamDiaryFile(client, opts) {
     const diaryPath = normalizeDiaryPath(opts.diaryPath);
     if (!diaryPath) {
         throw new Error("dream diary path is required");
@@ -199,19 +203,24 @@ export async function promoteDreamDiaryFile(rpc, opts) {
         sourceMtimeMs = sourceMtimeMs ?? stat.mtimeMs;
     }
     const candidates = parseDreamPromotionCandidates(text);
-    return await rpc.call("promote_dream_entries", {
+    return await client.promoteDreamEntries({
         userId,
         sourceDoc: diaryPath,
         sourceRoot: path.dirname(diaryPath),
         sourcePath: path.basename(diaryPath),
         sourceKind: DREAM_SOURCE_KIND,
         fileHash: fileHash ?? "",
-        sourceSize: sourceSize ?? 0,
-        sourceMtimeMs: sourceMtimeMs ?? 0,
+        sourceSize: BigInt(sourceSize ?? 0),
+        sourceMtimeMs: BigInt(Math.trunc(sourceMtimeMs ?? 0)),
         ingestVersion: DREAM_PROMOTION_VERSION,
         hashBackend: getHashBackendName(),
         entries: candidates.map((candidate) => ({
-            ...candidate,
+            text: candidate.text,
+            score: candidate.score,
+            recallCount: candidate.recallCount,
+            uniqueQueries: candidate.uniqueQueries,
+            section: candidate.section,
+            line: candidate.line,
             sourceLine: candidate.line,
         })),
     });