@xdarkicex/openclaw-memory-libravdb 1.3.13 → 1.3.17

package/src/sidecar.ts

@@ -263,6 +263,10 @@ export function resolveConfiguredEndpoint(cfg: PluginConfig): string {
   return value;
 }
 
+export function daemonProvisioningHint(): string {
+  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 defaultEndpoint(platform = process.platform, homeDir = os.homedir()): string {
   if (platform === "win32") {
     return "tcp:127.0.0.1:37421";
@@ -357,6 +361,9 @@ export function buildSidecarEnv(cfg: PluginConfig): Record<string, string> {
   if (typeof cfg.gatingCentroidK === "number" && cfg.gatingCentroidK > 0) {
     env.LIBRAVDB_GATING_CENTROID_K = String(cfg.gatingCentroidK);
   }
+  if (typeof cfg.lifecycleJournalMaxEntries === "number" && cfg.lifecycleJournalMaxEntries > 0) {
+    env.LIBRAVDB_LIFECYCLE_JOURNAL_MAX_ENTRIES = String(cfg.lifecycleJournalMaxEntries);
+  }
 
   return env;
 }
@@ -392,7 +399,7 @@ function formatConnectionError(endpoint: string, error: Error): Error {
     : "";
   if (code === "ENOENT" || code === "ECONNREFUSED") {
     return new Error(
-      `LibraVDB daemon unavailable at ${describeEndpoint(endpoint)}. Install and start libravdbd, or set sidecarPath to a running daemon endpoint.`,
+      `LibraVDB daemon unavailable at ${describeEndpoint(endpoint)}. ${daemonProvisioningHint()} Or set sidecarPath to a running daemon endpoint.`,
     );
   }
   return error;
@@ -410,3 +417,40 @@ function isConfiguredEndpoint(value?: string): boolean {
 }
 
 export { PlaceholderSocket };
+
+export async function probeSidecarEndpoint(cfg: PluginConfig): Promise<string | null> {
+  const endpoint = resolveConfiguredEndpoint(cfg);
+  try {
+    await new Promise<void>((resolve, reject) => {
+      if (isTcpEndpoint(endpoint)) {
+        const address = endpoint.slice("tcp:".length);
+        const separator = address.lastIndexOf(":");
+        if (separator <= 0) {
+          reject(new Error("invalid tcp endpoint"));
+          return;
+        }
+        const host = address.slice(0, separator);
+        const port = Number(address.slice(separator + 1));
+        const socket = net.connect({ host, port }, () => {
+          socket.destroy();
+          resolve();
+        });
+        socket.setTimeout(500);
+        socket.on("error", reject);
+        socket.on("timeout", reject);
+      } else {
+        const socketPath = endpoint.replace(/^unix:/, "");
+        const socket = net.connect(socketPath, () => {
+          socket.destroy();
+          resolve();
+        });
+        socket.setTimeout(500);
+        socket.on("error", reject);
+        socket.on("timeout", reject);
+      }
+    });
+    return endpoint;
+  } catch {
+    return null;
+  }
+}

package/src/types.ts

@@ -1,6 +1,8 @@
 export interface PluginConfig {
   dbPath?: string;
   sidecarPath?: string;
+  useSessionRecallProjection?: boolean;
+  useSessionSummarySearchExperiment?: boolean;
   embeddingRuntimePath?: string;
   embeddingBackend?: "bundled" | "onnx-local" | "custom-local";
   embeddingProfile?: string;
@@ -32,6 +34,7 @@ export interface PluginConfig {
   };
   gatingTechNorm?: number;
   gatingCentroidK?: number;
+  lifecycleJournalMaxEntries?: number;
   compactionQualityWeight?: number;
   recencyLambdaSession?: number;
   recencyLambdaUser?: number;
@@ -39,6 +42,7 @@ export interface PluginConfig {
   tokenBudgetFraction?: number;
   authoredHardBudgetFraction?: number;
   authoredSoftBudgetFraction?: number;
+  elevatedGuidanceBudgetFraction?: number;
   section7StartupTokenBudgetTokens?: number;
   continuityMinTurns?: number;
   continuityTailBudgetTokens?: number;
@@ -54,6 +58,13 @@ export interface PluginConfig {
   section7AuthorityRecencyWeight?: number;
   section7AuthorityFrequencyWeight?: number;
   section7AuthorityAuthoredWeight?: number;
+  summaryExpansionConfidenceThreshold?: number;
+  summaryExpansionDepth?: number;
+  summaryExpansionTokenBudget?: number;
+  summaryExpansionPenaltyFactor?: number;
+  recoveryFloorScore?: number;
+  recoveryMinTopK?: number;
+  recoveryMinConfidenceMean?: number;
   ollamaUrl?: string;
   compactModel?: string;
   rpcTimeoutMs?: number;
@@ -94,6 +105,7 @@ export interface SearchResult {
     source_doc?: string;
     node_kind?: string;
     ordinal?: number;
+    position?: number;
     tier?: number;
     authored?: boolean;
     authority?: number;
@@ -104,6 +116,15 @@ export interface SearchResult {
     continuity_tail?: boolean;
     continuity_base?: boolean;
     continuity_bundle_id?: string;
+    elevated_guidance?: boolean;
+    source_turn_id?: string;
+    source_turn_ts?: number;
+    provenance_class?: string;
+    stability_weight?: number;
+    expanded_from_summary?: boolean;
+    parent_summary_id?: string;
+    expansion_depth?: number;
+    cascade_tier?: number;
     [key: string]: unknown;
   };
   finalScore?: number;
@@ -170,6 +191,13 @@ export interface ContextAssembleArgs {
   tokenBudget: number;
 }
 
+export interface ContextAssembleResult {
+  messages: MemoryMessage[];
+  estimatedTokens: number;
+  systemPromptAddition: string;
+  _profile?: string[];
+}
+
 export interface ContextCompactArgs {
   sessionId: string;
   force?: boolean;