@xdarkicex/openclaw-memory-libravdb 1.3.19 → 1.3.20

package/README.md

@@ -131,7 +131,7 @@ If your daemon runs elsewhere, set an explicit `sidecarPath`, for example:
 
 ```text
 OpenClaw host
-  -> memoryPromptSection (durable user/global recall)
+  -> memoryPromptSection (static capability header)
   -> memory runtime bridge (built-in memory_search)
   -> context engine (bootstrap / ingest / assemble / compact)
   -> plugin runtime

package/docs/architecture.md

@@ -10,7 +10,7 @@ repository as of the current `main` branch.
 flowchart LR
   Host["OpenClaw host process\n(TypeScript plugin shell)"]
   CE["Context engine factory\nbootstrap / ingest / assemble / compact"]
-  MPS["memoryPromptSection\nuser+global recall"]
+  MPS["memoryPromptSection\nstatic header"]
   Runtime["Plugin runtime\nlazy daemon connect + RPC client"]
   Sidecar["Go daemon process"]
   RPC["JSON-RPC over newline-delimited frames\nUnix socket or TCP loopback on Windows"]
@@ -28,7 +28,6 @@ flowchart LR
   Host --> CE
   Host --> MPS
   CE --> Runtime
-  MPS --> Runtime
   Runtime --> RPC
   RPC --> Sidecar
   Sidecar --> Embed
@@ -80,17 +79,12 @@ Important constraints from the current implementation:
 
 Implemented in [`src/memory-provider.ts`](../src/memory-provider.ts).
 
-Before the main assembly path runs, the plugin builds a lightweight recall
-section:
+Before the main assembly path runs, the plugin returns a lightweight static
+header fragment that tells the host persistent memory is active.
 
-1. search `user:<userId>`
-2. search `global`
-3. hybrid-rank the combined hits
-4. fit them to a fixed prompt budget of `800` estimated tokens
-5. return a textual header fragment for the host prompt
-
-This path does not search session memory. Its job is durable context recall, not
-active-turn recall.
+This path is intentionally synchronous and does not perform RPC retrieval.
+Durable recall now happens entirely inside `assemble`, which keeps embedded
+prompt construction compatible with OpenClaw's synchronous memory prompt hook.
 
 ### 2.3 `assemble`
 
@@ -107,7 +101,7 @@ For the current query text (last message content), the host:
 
 Current implementation details that matter:
 
-- user/global hits may be reused from the earlier prompt-section cache
+- user/global hits are cached within `assemble` and reused on repeated queries
 - `assemble` falls back to the unmodified message list on RPC failure
 - `assemble` does not mutate the original `messages` array in place; it returns
   a new array
@@ -146,7 +140,7 @@ from the original spec phrasing.
 |---|---|---|
 | Daemon unavailable on first RPC use | `getRpc()` rejects when first connect or health check fails | That hook fails or falls back, but plugin registration itself does not crash eagerly |
 | Daemon connection closes mid-session | `SidecarSupervisor` retries with exponential backoff until retry budget is exhausted, then enters degraded mode | Memory becomes unavailable until the daemon is reachable again |
-| `memoryPromptSection` RPC failure | individual searches are caught and replaced with empty result sets | Prompt section becomes empty rather than crashing the run |
+| `memoryPromptSection` failure | returns a static header with no RPC dependency | Prompt section stays available and does not block the run |
 | `assemble` RPC failure | returns original messages, original token count, and empty `systemPromptAddition` | That turn gets no recall augmentation |
 | `ingest` gating or durable insert failure | session write already happened; durable promotion is skipped | Session memory survives, durable memory may miss that turn |
 | Compaction summarizer unavailable | extractive summarizer remains required; optional abstractive path is skipped | Compaction still runs extractively when extractive is healthy |

package/docs/implementation.md

@@ -18,8 +18,8 @@ Why:
   - `ingest`
   - `assemble`
   - `compact`
-- the lightweight memory prompt section remains useful as a separate early
-  durable-recall pass
+- the lightweight memory prompt section remains useful as a synchronous
+  capability/header hook while durable recall stays in `assemble`
 
 This is why the code registers both `registerContextEngine("libravdb-memory", …)`
 and `registerMemoryPromptSection(...)` instead of relying on only one hook.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.3.19",
+  "version": "1.3.20",
   "type": "module",
   "publishConfig": {
     "access": "public"

package/src/memory-provider.ts

@@ -1,87 +1,25 @@
+import type { MemoryPromptSectionBuilder } from "openclaw/plugin-sdk/plugin-entry";
 import type { PluginConfig, RecallCache, SearchResult } from "./types.js";
 import type { RpcGetter } from "./plugin-runtime.js";
-import { scoreCandidates } from "./scoring.js";
-import { fitPromptBudget } from "./tokens.js";
-import { buildMemoryHeader } from "./recall-utils.js";
 
-const MEMORY_PROMPT_BUDGET = 800;
+const MEMORY_PROMPT_HEADER = [
+  "## Memory",
+  "LibraVDB persistent memory is configured. Recalled memories may appear",
+  "in context via the context-engine assembler when available and relevant.",
+  "",
+] as const;
 
 export function buildMemoryPromptSection(
-  getRpc: RpcGetter,
-  cfg: PluginConfig,
-  recallCache: RecallCache<SearchResult>,
-): (params: {
-  availableTools: Set<string>;
-  citationsMode?: string;
-  messages?: Array<{ role: string; content: string }>;
-  userId?: string;
-}) => Promise<string[]> {
-  return async function memoryPromptSection(params: {
-    availableTools: Set<string>;
-    citationsMode?: string;
-    messages?: Array<{ role: string; content: string }>;
-    userId?: string;
-  }): Promise<string[]> {
-    const queryText = params.messages?.at(-1)?.content ?? "";
-    const userId = params.userId ?? "default";
-
-    if (!queryText) {
-      return [
-        "## Memory",
-        "LibraVDB persistent memory is active. Recalled memories will appear",
-        "in context via the context-engine assembler when relevant.",
-        "",
-      ];
-    }
-
-    const rpc = await getRpc();
-
-    const [userHitsResult, globalHitsResult] = await Promise.all([
-      rpc.call<{ results: SearchResult[] }>("search_text", {
-        collection: `user:${userId}`,
-        text: queryText,
-        k: Math.ceil((cfg.topK ?? 8) / 2),
-      }),
-      rpc.call<{ results: SearchResult[] }>("search_text", {
-        collection: "global",
-        text: queryText,
-        k: Math.ceil((cfg.topK ?? 8) / 4),
-      }),
-    ]);
-
-    const userHits = userHitsResult.results;
-    const globalHits = globalHitsResult.results;
-
-    recallCache.put({
-      userId,
-      queryText,
-      durableVariantHits: [],
-      userHits,
-      globalHits,
-    });
-
-    const ranked = scoreCandidates([...userHits, ...globalHits], {
-      alpha: cfg.alpha,
-      beta: cfg.beta,
-      gamma: cfg.gamma,
-      sessionId: "",
-      userId,
-    });
-
-    const selected = fitPromptBudget(ranked, MEMORY_PROMPT_BUDGET);
-    const recallHeader = buildMemoryHeader(selected);
-
-    const lines: string[] = [
-      "## Memory",
-      "LibraVDB persistent memory is active. Recalled memories will appear",
-      "in context via the context-engine assembler when relevant.",
-    ];
-
-    if (recallHeader) {
-      lines.push(...recallHeader.split("\n"));
-    }
-
-    lines.push("");
-    return lines;
+  _getRpc: RpcGetter,
+  _cfg: PluginConfig,
+  _recallCache: RecallCache<SearchResult>,
+): MemoryPromptSectionBuilder {
+  return function memoryPromptSection({
+    availableTools: _availableTools,
+    citationsMode: _citationsMode,
+  }): string[] {
+    // OpenClaw builds the memory prompt section synchronously for embedded runs.
+    // Actual retrieval and ranking happen in the context engine during assemble().
+    return [...MEMORY_PROMPT_HEADER];
   };
-}
+}

package/src/openclaw-plugin-sdk.d.ts

@@ -1,4 +1,9 @@
 declare module "openclaw/plugin-sdk/plugin-entry" {
+  export type MemoryPromptSectionBuilder = (params: {
+    availableTools: Set<string>;
+    citationsMode?: string;
+  }) => string[];
+
   interface OpenClawCliCommand {
     commands?: OpenClawCliCommand[];
     command(name: string): OpenClawCliCommand;
@@ -18,7 +23,7 @@ declare module "openclaw/plugin-sdk/plugin-entry" {
       warn?(message: string): void;
     };
     registerContextEngine(id: string, factory: () => unknown): void;
-    registerMemoryPromptSection(builder: unknown): void;
+    registerMemoryPromptSection(builder: MemoryPromptSectionBuilder): void;
     registerMemoryFlushPlan?(resolver: unknown): void;
     registerMemoryRuntime?(runtime: unknown): void;
     registerMemoryEmbeddingProvider?(provider: unknown): void;