@xdarkicex/openclaw-memory-libravdb 1.4.35 → 1.4.37

package/HOOK.md

@@ -1,14 +1,103 @@
 ---
 name: libravdb-memory
-description: Compatibility metadata for OpenClaw production installation.
+description: LibraVDB Memory plugin hook and capability metadata.
 ---
 
-# LibraVDB Memory Hook Metadata
+# LibraVDB Memory — Hook & Capability Reference
 
-This package ships a native OpenClaw plugin with a compiled JavaScript runtime
-under `dist/`.
+## Lifecycle Hooks
 
-`HOOK.md` is included so OpenClaw installation flows that validate hook-pack
-metadata do not reject the published package for missing compatibility files.
-It does not bootstrap the daemon or change the plugin's connect-only install
-model.
+### `before_reset`
+
+Fires when a session is reset via `/reset` or programmatic reset.
+
+- **Emitter:** OpenClaw core
+- **Behavior:** Sends a `session_lifecycle_hint` to the sidecar with hook type
+  `before_reset`, including session id, agent id, reason, message count, and
+  workspace directory.
+- **Side effects:** Sidecar may persist hint for journaling or eviction
+  heuristics. Non-blocking.
+
+### `session_end`
+
+Fires when a session ends (user disconnects, session expires, or agent
+completes).
+
+- **Emitter:** OpenClaw core
+- **Behavior:** Sends a `session_lifecycle_hint` with hook type `session_end`,
+  including session id, agent id, message count, duration, transcript archival
+  status, and next session id when applicable.
+- **Side effects:** Sidecar may flush session-scoped indexes or journal the
+  event. Non-blocking.
+
+### `gateway_stop`
+
+Fires during gateway shutdown.
+
+- **Emitter:** OpenClaw core
+- **Behavior:** Flushes pending writes to the sidecar, then shuts down the
+  sidecar process and closes the gRPC kernel client (if configured).
+- **Side effects:** Destructive — after this hook runs, the sidecar connection
+  is closed.
+- **Configuration:** None required.
+
+## Memory Capability
+
+Registered via `registerMemoryCapability("libravdb-memory", { ... })`.
+
+### `promptBuilder`
+
+Returns a static memory header block injected into the system prompt. Actual
+retrieval and ranking happen in the context engine during `assemble()`.
+
+### `runtime`
+
+Exposes `getMemorySearchManager()` for programmatic memory search. Delegates to
+the sidecar over RPC. Supports session-scoped, user-scoped, and global
+collection search with hybrid scoring.
+
+## Context Engine
+
+Registered via `registerContextEngine("libravdb-memory", factory)`.
+`ownsCompaction: true` — compaction is managed by the plugin, not the host.
+
+### `bootstrap(args)`
+
+Initializes a session in the vector store. Called once per session. Resolves
+the durable user identity from config, auto-derived identity file, or session
+key.
+
+### `ingest(args)`
+
+Writes a conversational message into the vector store. Called after each
+assistant turn and for heartbeat messages.
+
+### `assemble(args)`
+
+Retrieves and assembles context for the next model call. Runs predictive
+compaction when the session exceeds the configured token threshold. Augments
+results with exact-match durable memory recall for fact-lookup queries.
+
+### `compact(args)`
+
+Runs compaction on demand. Supports force compaction and target-size-driven
+compaction. Uses the kernel (gRPC) path when available, falling back to
+sidecar RPC.
+
+### `afterTurn(args)`
+
+Post-turn hook for side effects: incremental indexing, compaction trigger
+evaluation, and lifecycle journaling. Called after every agent turn including
+heartbeat turns.
+
+## CLI
+
+### `memory`
+
+Root command registered via `registerCli` with lazy descriptors.
+
+Subcommands: `status`, `index`, `search`, `flush`, `export`, `journal`,
+`dream-promote`.
+
+CLI registration guards on `plugins.slots.memory === "libravdb-memory"`.
+Lightweight modes register CLI structure only (no runtime, no action handlers).

package/dist/index.js

@@ -39655,10 +39655,19 @@ function register(api) {
   });
   api.on("before_reset", createBeforeResetHook(runtime, api.logger ?? console));
   api.on("session_end", createSessionEndHook(runtime, api.logger ?? console));
+  api.on("agent_end", async (event) => {
+    const e = asRecord(event) ?? {};
+    logger.info?.(
+      `LibraVDB agent_end success=${e.success ?? "unknown"} durationMs=${e.durationMs ?? "?"} error=${typeof e.error === "string" ? e.error : "none"}`
+    );
+  });
   api.on("gateway_stop", async () => {
     await runtime.shutdown();
   });
 }
+function asRecord(value) {
+  return typeof value === "object" && value !== null ? value : null;
+}
 var index_default = definePluginEntry({
   id: MEMORY_ID,
   name: "LibraVDB Memory",

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xdarkicex/openclaw-memory-libravdb",
-  "version": "1.4.35",
+  "version": "1.4.37",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,10 +31,16 @@
   },
   "openclaw": {
     "extensions": [
-      "./dist/index.js"
+      "./dist/index.js",
+      "./dist/cli-metadata.js"
     ],
     "compat": {
-      "pluginApi": ">=2026.3.22"
+      "pluginApi": ">=2026.3.22",
+      "minGatewayVersion": ">=2026.3.22"
+    },
+    "build": {
+      "openclawVersion": "2026.4.11",
+      "pluginSdkVersion": "2026.4.11"
     },
     "install": {
       "minHostVersion": ">=2026.3.22"