@remnic/plugin-openclaw 9.7.14 → 9.8.0

package/dist/index.js

@@ -24,7 +24,7 @@ import * as day_summary_star from "@remnic/core/day-summary";
 // ../../src/index.ts
 import OpenAI from "openai";
 import { createRequire } from "module";
-import { createHash as createHash3 } from "crypto";
+import { createHash as createHash4 } from "crypto";
 
 // ../../src/config.ts
 var config_exports = {};
@@ -43,7 +43,7 @@ import { detectSdkCapabilities } from "@remnic/core/sdk-compat";
 import { Orchestrator, sanitizeSessionKeyForFilename, defaultWorkspaceDir } from "@remnic/core/orchestrator";
 
 // ../../src/tools.ts
-import { createHash } from "crypto";
+import { createHash as createHash2 } from "crypto";
 import { Type } from "@sinclair/typebox";
 
 // ../../src/temporal-index.ts
@@ -74,6 +74,102 @@ import * as temporal_index_star from "@remnic/core/temporal-index";
 // ../../src/explicit-capture.ts
 import { hasInlineExplicitCaptureMarkup, parseInlineExplicitCaptureNotes, persistExplicitCapture, queueExplicitCaptureForReview, shouldProcessInlineExplicitCapture, shouldSkipImplicitExtraction, stripInlineExplicitCaptureNotes, validateExplicitCaptureInput } from "@remnic/core/explicit-capture";
 
+// ../../src/tools.ts
+import { composeSalvagedEnvelope as composeSalvagedEnvelope2 } from "@remnic/core/salvage-envelope";
+
+// ../../src/memory-promote.ts
+import { createHash } from "crypto";
+import { composeSalvagedEnvelope } from "@remnic/core/salvage-envelope";
+import { STRUCTURED_ATTRIBUTE_LIMITS, TAG_LIMITS } from "@remnic/core/write-envelope";
+import { stripAttributesSuffix } from "@remnic/core/storage";
+import { displayErrorDetail } from "@remnic/core/runtime/better-sqlite";
+import { isSafeRouteNamespace } from "@remnic/core/routing/engine";
+function buildPromotionOrigin(srcNamespace, memoryId) {
+  const memoryIdHash = createHash("sha256").update(memoryId).digest("hex");
+  const fullTag = `promotedFrom:${srcNamespace}:${memoryId}`;
+  return {
+    tag: fullTag.length <= TAG_LIMITS.maxTagLength ? fullTag : `promotedFromHash:${memoryIdHash}`,
+    structuredAttributes: {
+      promotedFromNamespace: srcNamespace,
+      promotedFromMemoryIdHash: memoryIdHash,
+      ...memoryId.length <= STRUCTURED_ATTRIBUTE_LIMITS.maxValueLength ? { promotedFromMemoryId: memoryId } : {}
+    }
+  };
+}
+async function executeMemoryPromote(orchestrator, params) {
+  const { memoryId, fromNamespace, toNamespace, note } = params;
+  if (typeof memoryId !== "string" || memoryId.length === 0) {
+    return `Invalid memoryId: ${JSON.stringify(memoryId)} \u2014 expected a non-empty memory ID.`;
+  }
+  for (const [name, value] of [
+    ["fromNamespace", fromNamespace],
+    ["toNamespace", toNamespace]
+  ]) {
+    if (value !== void 0 && value !== null && (typeof value !== "string" || !isSafeRouteNamespace(value))) {
+      return `Invalid ${name}: ${JSON.stringify(value)} \u2014 expected a path-safe namespace name.`;
+    }
+  }
+  const srcNs = fromNamespace ?? orchestrator.config.defaultNamespace;
+  const dstNs = toNamespace ?? orchestrator.config.sharedNamespace;
+  const src = await orchestrator.getStorage(srcNs);
+  const mem = await src.getMemoryById(memoryId);
+  if (!mem) {
+    return `Memory not found in ${srcNs}: ${memoryId}`;
+  }
+  const dst = await orchestrator.getStorage(dstNs);
+  const promotionOrigin = buildPromotionOrigin(srcNs, memoryId);
+  const promoteEnvelope = composeSalvagedEnvelope(
+    "promote",
+    {
+      content: mem.frontmatter.structuredAttributes ? stripAttributesSuffix(mem.content) : mem.content,
+      category: mem.frontmatter.category,
+      confidence: mem.frontmatter.confidence,
+      tags: (() => {
+        const promotionTags = [
+          "promoted",
+          promotionOrigin.tag,
+          ...note ? [`note:${note}`] : []
+        ];
+        const sourceTags = mem.frontmatter.tags ?? [];
+        return Array.from(/* @__PURE__ */ new Set([...promotionTags, ...sourceTags])).slice(
+          0,
+          TAG_LIMITS.maxTags
+        );
+      })(),
+      structuredAttributes: promotionOrigin.structuredAttributes,
+      entityRef: mem.frontmatter.entityRef
+    },
+    { source: "promote" }
+  );
+  const { id: newId, tombstoneBlocked } = await dst.writeSealedMemory(
+    promoteEnvelope,
+    {
+      importance: mem.frontmatter.importance,
+      supersedes: mem.frontmatter.supersedes,
+      links: mem.frontmatter.links
+    }
+  );
+  if (tombstoneBlocked) {
+    return `Promotion of ${srcNs}:${memoryId} \u2192 ${dstNs}:${newId} is queued for review (tombstone-blocked): no active promoted copy was created.`;
+  }
+  try {
+    if (orchestrator.config.queryAwareIndexingEnabled && await indexesExistAsync(orchestrator.config.memoryDir)) {
+      const promoted = await dst.getMemoryById(newId).catch(() => null);
+      if (promoted?.path && promoted.frontmatter?.created) {
+        await indexMemoryAsync(
+          orchestrator.config.memoryDir,
+          promoted.path,
+          promoted.frontmatter.created,
+          promoted.frontmatter.tags ?? []
+        );
+      }
+    }
+  } catch (err) {
+    return `Promoted ${srcNs}:${memoryId} \u2192 ${dstNs}:${newId} (index refresh failed \u2014 recall picks it up on the next maintenance pass: ${displayErrorDetail(err)})`;
+  }
+  return `Promoted ${srcNs}:${memoryId} \u2192 ${dstNs}:${newId}`;
+}
+
 // ../../src/tools.ts
 import { WorkStorage } from "@remnic/core/work/storage";
 import { exportWorkBoardMarkdown, exportWorkBoardSnapshot, importWorkBoardSnapshot } from "@remnic/core/work/board";
@@ -310,7 +406,7 @@ function registerTools(api, orchestrator) {
   const actionTypeSet = new Set(actionTypes);
   function promptHashForTelemetry(input) {
     if (typeof input !== "string" || input.trim().length === 0) return void 0;
-    return createHash("sha256").update(input).digest("hex").slice(0, 16);
+    return createHash2("sha256").update(input).digest("hex").slice(0, 16);
   }
   function normalizeMemoryCategory(value, fallback) {
     const normalized = asNonEmptyString(value);
@@ -1503,9 +1599,13 @@ NOTE: You did not provide sessionKey; under concurrency this may not match your
         let queuedForReview = false;
         switch (action) {
           case "store_episode": {
-            const { id: createdId, tombstoneBlocked } = await storage.writeMemory(normalizedCategory ?? "fact", contentValue, {
+            const episodeEnvelope = composeSalvagedEnvelope2(
+              "memory-action",
+              { content: contentValue, category: normalizedCategory ?? "fact" },
+              { source: "memory_action_apply" }
+            );
+            const { id: createdId, tombstoneBlocked } = await storage.writeSealedMemory(episodeEnvelope, {
               actor: "tool.memory_action_apply",
-              source: "memory_action_apply",
               memoryKind: "episode"
             });
             outputMemoryIds.push(createdId);
@@ -1518,9 +1618,13 @@ NOTE: You did not provide sessionKey; under concurrency this may not match your
             break;
           }
           case "store_note": {
-            const { id: createdId, tombstoneBlocked } = await storage.writeMemory(normalizedCategory ?? "fact", contentValue, {
-              actor: "tool.memory_action_apply",
-              source: "memory_action_apply"
+            const noteEnvelope = composeSalvagedEnvelope2(
+              "memory-action",
+              { content: contentValue, category: normalizedCategory ?? "fact" },
+              { source: "memory_action_apply" }
+            );
+            const { id: createdId, tombstoneBlocked } = await storage.writeSealedMemory(noteEnvelope, {
+              actor: "tool.memory_action_apply"
             });
             outputMemoryIds.push(createdId);
             if (tombstoneBlocked) {
@@ -1572,9 +1676,13 @@ NOTE: You did not provide sessionKey; under concurrency this may not match your
             break;
           }
           case "summarize_node": {
-            const { id: createdId, tombstoneBlocked } = await storage.writeMemory(normalizedCategory ?? "fact", contentValue, {
+            const summaryEnvelope = composeSalvagedEnvelope2(
+              "memory-action",
+              { content: contentValue, category: normalizedCategory ?? "fact" },
+              { source: "memory_action_apply" }
+            );
+            const { id: createdId, tombstoneBlocked } = await storage.writeSealedMemory(summaryEnvelope, {
               actor: "tool.memory_action_apply",
-              source: "memory_action_apply",
               sourceMemoryId: memoryIdValue
             });
             outputMemoryIds.push(createdId);
@@ -1922,36 +2030,11 @@ Best for:
             "Namespaces are disabled. Enable `namespacesEnabled: true` to use memory promotion."
           );
         }
-        const { memoryId, fromNamespace, toNamespace, note } = params;
-        const srcNs = fromNamespace && fromNamespace.length > 0 ? fromNamespace : orchestrator.config.defaultNamespace;
-        const dstNs = toNamespace && toNamespace.length > 0 ? toNamespace : orchestrator.config.sharedNamespace;
-        const src = await orchestrator.getStorage(srcNs);
-        const mem = await src.getMemoryById(memoryId);
-        if (!mem) {
-          return toolResult(`Memory not found in ${srcNs}: ${memoryId}`);
-        }
-        const dst = await orchestrator.getStorage(dstNs);
-        const { id: newId, tombstoneBlocked } = await dst.writeMemory(mem.frontmatter.category, mem.content, {
-          confidence: mem.frontmatter.confidence,
-          tags: Array.from(/* @__PURE__ */ new Set([...mem.frontmatter.tags ?? [], "promoted", `promotedFrom:${srcNs}:${memoryId}`, ...note ? [`note:${note}`] : []])),
-          entityRef: mem.frontmatter.entityRef,
-          source: "promote",
-          importance: mem.frontmatter.importance,
-          supersedes: mem.frontmatter.supersedes,
-          links: mem.frontmatter.links
-        });
-        if (tombstoneBlocked) {
-          return toolResult(
-            `Promotion of ${srcNs}:${memoryId} \u2192 ${dstNs}:${newId} is queued for review (tombstone-blocked): no active promoted copy was created.`
-          );
-        }
-        if (orchestrator.config.queryAwareIndexingEnabled && await indexesExistAsync(orchestrator.config.memoryDir)) {
-          const promoted = await dst.getMemoryById(newId).catch(() => null);
-          if (promoted?.path && promoted.frontmatter?.created) {
-            await indexMemoryAsync(orchestrator.config.memoryDir, promoted.path, promoted.frontmatter.created, promoted.frontmatter.tags ?? []);
-          }
-        }
-        return toolResult(`Promoted ${srcNs}:${memoryId} \u2192 ${dstNs}:${newId}`);
+        const message = await executeMemoryPromote(
+          orchestrator,
+          params
+        );
+        return toolResult(message);
       }
     },
     { name: "memory_promote" }
@@ -2989,7 +3072,7 @@ import { createOpikExporter, OpikExporter } from "@remnic/core/opik-exporter";
 
 // ../../src/index.ts
 import { readEnvVar, resolveHomeDir } from "@remnic/core/runtime/env";
-import { displayErrorDetail } from "@remnic/core/runtime/better-sqlite";
+import { displayErrorDetail as displayErrorDetail2 } from "@remnic/core/runtime/better-sqlite";
 
 // ../../src/migrate/from-engram.ts
 import { migrateFromEngram, rollbackFromEngramMigration } from "@remnic/core/migrate/from-engram";
@@ -3275,6 +3358,7 @@ function buildMemorySearchTool(orchestrator, options = {}) {
 }
 
 // src/runtime-surfaces.ts
+import { composeSalvagedEnvelope as composeSalvagedEnvelope3 } from "@remnic/core/salvage-envelope";
 import { gatewayTaskChainOptions } from "@remnic/core/fallback-llm";
 function resolveDreamNarrativeRoute(config, directClientAvailable) {
   if (config.modelSource === "gateway") {
@@ -3484,13 +3568,14 @@ async function syncDreamSurfaceEntries(params) {
     };
     const existing = findSurfaceMemoryByAttribute(memories, DREAM_ENTRY_ID_KEY, entry.id);
     if (!existing) {
-      const { id: memoryId } = await storage.writeMemory("moment", content, {
-        confidence: 0.85,
-        tags,
-        source: "dreams.md",
-        memoryKind: "dream",
-        structuredAttributes
-      });
+      const { id: memoryId } = await storage.writeSealedMemory(
+        composeSalvagedEnvelope3(
+          "dreams-surface",
+          { content, category: "moment", confidence: 0.85, tags, structuredAttributes },
+          { source: "dreams.md" }
+        ),
+        { memoryKind: "dream" }
+      );
       memories.push(
         makeSurfaceMemorySnapshot({
           id: memoryId,
@@ -3543,13 +3628,14 @@ async function syncHeartbeatSurfaceEntries(params) {
     };
     const existing = findSurfaceMemoryByAttribute(memories, HEARTBEAT_ENTRY_ID_KEY, entry.id) ?? findUniqueSurfaceMemoryBySlug(memories, HEARTBEAT_SURFACE_TYPE, entry.slug);
     if (!existing) {
-      const { id: memoryId } = await storage.writeMemory("principle", content, {
-        confidence: 0.95,
-        tags,
-        source: "heartbeat.md",
-        memoryKind: "procedural",
-        structuredAttributes
-      });
+      const { id: memoryId } = await storage.writeSealedMemory(
+        composeSalvagedEnvelope3(
+          "heartbeat-surface",
+          { content, category: "principle", confidence: 0.95, tags, structuredAttributes },
+          { source: "heartbeat.md" }
+        ),
+        { memoryKind: "procedural" }
+      );
       memories.push(
         makeSurfaceMemorySnapshot({
           id: memoryId,
@@ -4051,7 +4137,7 @@ function validateSlotSelection(ctx) {
 
 // ../../src/openclaw-flush-plan-lifecycle.ts
 import path2 from "path";
-import { createHash as createHash2, randomUUID } from "crypto";
+import { createHash as createHash3, randomUUID } from "crypto";
 import * as fsReadModule0 from "fs/promises";
 const lstat2 = fsReadModule0.lstat;
 const mkdir = fsReadModule0.mkdir;
@@ -4111,7 +4197,7 @@ function isPathInsideOrEqual(parentPath, childPath) {
   return relative === "" || !relative.startsWith("..") && !path2.isAbsolute(relative);
 }
 function hashContent(content) {
-  return createHash2("sha256").update(content, "utf8").digest("hex");
+  return createHash3("sha256").update(content, "utf8").digest("hex");
 }
 function utf8PrefixByByteLength(content, byteLength) {
   const buffer = Buffer.from(content, "utf8");
@@ -5986,7 +6072,7 @@ function stableOpenClawConfigSignature(value, seen = /* @__PURE__ */ new WeakSet
   return JSON.stringify(String(value));
 }
 function openClawHostEmbeddingConfigSignature(cfg, apiConfig, workspaceDir) {
-  return `sha256:${createHash3("sha256").update(JSON.stringify({
+  return `sha256:${createHash4("sha256").update(JSON.stringify({
     enabled: cfg.hostEmbeddingProviderEnabled !== false,
     memoryDir: cfg.memoryDir,
     providerId: cfg.hostEmbeddingProviderId ?? "",
@@ -6346,7 +6432,7 @@ var pluginDefinition = {
           );
         }
       } catch (error) {
-        const detail = displayErrorDetail(error) || "unknown error";
+        const detail = displayErrorDetail2(error) || "unknown error";
         logger_exports.log.warn(`OpenClaw flush-plan processing failed: ${detail}`);
       }
     }
@@ -6540,6 +6626,7 @@ Keep the reflection grounded in the evidence below.
         queryMode: cfg.activeRecallQueryMode,
         promptStyle: cfg.activeRecallPromptStyle,
         customInstruction: cfg.activeRecallCustomInstruction,
+        promptReplacement: cfg.activeRecallPromptReplacement,
         promptAppend: cfg.activeRecallPromptAppend,
         maxSummaryChars: cfg.activeRecallMaxSummaryChars,
         recentUserTurns: cfg.activeRecallRecentUserTurns,
@@ -6635,7 +6722,7 @@ Keep the reflection grounded in the evidence below.
         }
       }, buildInlineExplicitCaptureDedupeKey2 = function(messageKey, note) {
         if (!messageKey) return null;
-        return `${messageKey}:inline-memory-note:${createHash3("sha256").update(JSON.stringify(note)).digest("hex")}`;
+        return `${messageKey}:inline-memory-note:${createHash4("sha256").update(JSON.stringify(note)).digest("hex")}`;
       }, resolveStoredCodexThreadId2 = function(sessionKey) {
         const threadId = codexThreadBySession.get(sessionKey);
         return typeof threadId === "string" && threadId.length > 0 ? threadId : null;
@@ -9056,7 +9143,7 @@ function buildOpenClawInboundContentFingerprint(content, message, event, ctx, se
     normalizeThreadId(message.threadId) ?? normalizeThreadId(event.threadId) ?? normalizeThreadId(ctx.threadId) ?? "",
     512
   );
-  const contentHash = createHash3("sha256").update(normalizedContent).digest("hex");
+  const contentHash = createHash4("sha256").update(normalizedContent).digest("hex");
   return [
     sessionPart,
     "content",
@@ -9070,7 +9157,7 @@ function buildOpenClawSparseInboundContentFingerprint(content, sessionKey) {
   const normalizedContent = content.trim();
   if (!normalizedContent) return null;
   const sessionPart = truncateMetadataValue(sessionKey || "default", 512);
-  const contentHash = createHash3("sha256").update(normalizedContent).digest("hex");
+  const contentHash = createHash4("sha256").update(normalizedContent).digest("hex");
   return `${sessionPart}\0sparse-content\0${contentHash}`;
 }
 function withReplyExtractionHint(content, metadata) {

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-remnic",
   "name": "Remnic OpenClaw Plugin",
-  "version": "9.7.14",
+  "version": "9.8.0",
   "kind": "memory",
   "description": "Local semantic memory for OpenClaw with bundled Remnic core runtime. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
   "setup": {
@@ -225,6 +225,14 @@
         "type": "string",
         "description": "Optional additional guidance for the active-recall builder."
       },
+      "activeRecallPromptOverride": {
+        "type": "string",
+        "description": "Legacy optional custom instruction for the active-recall builder."
+      },
+      "activeRecallPromptReplacement": {
+        "type": "string",
+        "description": "Optional complete replacement prompt for the active-recall builder."
+      },
       "activeRecallPromptStyle": {
         "type": "string",
         "enum": [
@@ -585,6 +593,13 @@
         "default": 5,
         "description": "Max turns before forced extraction"
       },
+      "bufferSaveDebounceMs": {
+        "type": "integer",
+        "default": 3000,
+        "minimum": 0,
+        "maximum": 2147483647,
+        "description": "Debounce window (ms) for persisting the smart buffer to state/buffer.json. Steady-state buffering coalesces the whole-state write onto a trailing-edge timer instead of rewriting every turn; extraction trigger/clear and shutdown force an immediate flush. 0 restores save-every-turn. Capped at 2147483647 (Node's 32-bit setTimeout limit)."
+      },
       "bufferSurpriseK": {
         "type": "number",
         "default": 5,
@@ -1496,6 +1511,68 @@
         "default": "off",
         "description": "Passive correction capture (#1581) — detects corrections expressed in conversation during extraction and routes them to the Correction Contract (#1580). \"off\" disables detection (default, rule 48); \"queue\" plans corrections for human review in the review list; \"auto\" applies immediately when all safety guards pass (confidence floor, blast-radius cap, allowed action/classification), otherwise falls back to queue. Invalid values are rejected (rule 51)."
       },
+      "correction": {
+        "type": "object",
+        "description": "Memory-correction contract (issue #1580) — nested form; nested keys win over the flat legacy correction* keys.",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "description": "Enable the correction contract (plan/apply). Default true."
+          },
+          "applyRequiresConfirm": {
+            "type": "boolean",
+            "description": "Require confirm: true on memory_correct_apply. Default true."
+          },
+          "maxAffected": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Maximum memories one correction plan may touch. Default 10."
+          },
+          "planTtlHours": {
+            "type": "number",
+            "minimum": 1,
+            "description": "Hours a planned correction stays applicable. Default 24."
+          }
+        }
+      },
+      "correctionCapture": {
+        "type": "object",
+        "description": "Implicit correction capture (nested form; nested keys win over the flat legacy correctionCapture* keys).",
+        "properties": {
+          "mode": {
+            "type": "string",
+            "enum": [
+              "off",
+              "queue",
+              "auto"
+            ],
+            "description": "Implicit capture mode. Default off."
+          },
+          "confidenceFloor": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Minimum detector confidence to act on. Default 0.85."
+          },
+          "autoApplyMaxAffected": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "Auto-apply ceiling on affected memories. Default 2."
+          }
+        }
+      },
+      "openclawHostEmbeddingProviderEnabled": {
+        "type": "boolean",
+        "description": "Legacy alias for hostEmbeddingProviderEnabled (OpenClaw host embedding provider). Default true."
+      },
+      "openclawHostEmbeddingProviderId": {
+        "type": "string",
+        "description": "Legacy alias for hostEmbeddingProviderId."
+      },
+      "openclawHostEmbeddingProviderModel": {
+        "type": "string",
+        "description": "Legacy alias for hostEmbeddingProviderModel."
+      },
       "correctionEnabled": {
         "type": "boolean",
         "default": true,
@@ -2382,6 +2459,11 @@
         "default": false,
         "description": "In full mode, compute graph assist for comparison telemetry and snapshots but keep recall output baseline-identical."
       },
+      "graphEdgeCacheIncrementalEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Push single-writer graph-edge appends into the warm edge cache in place (size-revalidated for cross-process coherence) instead of nulling and re-reading the edge file on every write (issue #1904). Set false to restore the pre-#1904 null-on-every-write behavior."
+      },
       "graphEdgeDecayCadenceMs": {
         "type": "number",
         "default": 604800000,
@@ -3158,6 +3240,18 @@
         "default": "",
         "description": "Root directory for memory extensions. Empty string derives from memoryDir (go up to Remnic home and append memory_extensions)."
       },
+      "memoryLifecycleLedgerCompactBytes": {
+        "type": "integer",
+        "default": 67108864,
+        "minimum": 0,
+        "description": "Auto-compact state/memory-lifecycle-ledger.jsonl when it exceeds this many bytes, triggered off the debounced maintenance path (issue #1910). Set 0 to disable. Default 64MB."
+      },
+      "memoryLifecycleLedgerCompactMinIntervalMs": {
+        "type": "integer",
+        "default": 21600000,
+        "minimum": 60000,
+        "description": "Minimum interval between auto-compactions of the lifecycle ledger (issue #1910). Default 6 hours."
+      },
       "memoryLinkingEnabled": {
         "type": "boolean",
         "default": false,
@@ -3766,6 +3860,11 @@
         "default": 900,
         "description": "Token budget for each proactive extraction sub-call (0 disables the proactive second pass)."
       },
+      "proactiveExtractionSkipWhenLocalLlmBusy": {
+        "type": "boolean",
+        "default": true,
+        "description": "Skip the optional proactive extraction second pass when the local LLM background lane is already busy, instead of queueing behind an in-flight extraction and losing its shorter deadline (issue #2011). Set false to always attempt the second pass."
+      },
       "proactiveExtractionTimeoutMs": {
         "type": "number",
         "default": 2500,
@@ -4010,6 +4109,12 @@
         "default": true,
         "description": "Enable debounced background QMD maintenance instead of immediate updates on extraction."
       },
+      "qmdEmbeddingBacklogThreshold": {
+        "type": "integer",
+        "minimum": 0,
+        "default": 1000,
+        "description": "Pending-embedding count above which QMD health reports degraded. Set to 0 to disable backlog degradation."
+      },
       "qmdMaxResults": {
         "type": "number",
         "default": 8,
@@ -4192,6 +4297,13 @@
         "type": "number",
         "description": "Hard character cap for total recall context. Defaults to maxMemoryTokens * 4."
       },
+      "recallProfileMaxRatio": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.3,
+        "description": "Maximum fraction of the total recall budget available to the behavioral profile. Set to 1 to disable the share cap."
+      },
       "recallConfidenceGateEnabled": {
         "type": "boolean",
         "default": false,
@@ -4324,6 +4436,25 @@
         "default": 5,
         "description": "Issue #1582 — number of recent per-session recall snapshots searched when resolving a `[m:xxxx]` handle to a memory id. Older-than-N snapshots are not searched; a miss is tagged rather than widening the window."
       },
+      "recallImpressionsRotateBytes": {
+        "type": "integer",
+        "default": 33554432,
+        "minimum": 0,
+        "description": "Rotate state/recall_impressions.jsonl to .1..N when it exceeds this many bytes (issue #1910). Set 0 to disable. Default 32MB."
+      },
+      "recallImpressionsRotateKeep": {
+        "type": "integer",
+        "default": 5,
+        "minimum": 1,
+        "maximum": 1000,
+        "description": "Number of rotated recall-impression archives to keep (.1 .. .N) (issue #1910). Default 5. Max 1000: each retained slot costs one rename under the held impressions lock per rotation, so a larger value is rejected at config-parse time before it can stall recall recording."
+      },
+      "recallMaxConcurrentPerPrincipal": {
+        "type": "integer",
+        "minimum": 0,
+        "default": 4,
+        "description": "Maximum concurrent recalls executed per principal (issue #1906). Recalls beyond this cap queue FIFO; an aborted waiter leaves the queue immediately. 0 = unlimited (no cap). Replaces the former width-1 budget-lock serialization; budget accounting stays correct because peek/record are synchronous. Set 1 to restore exact serialization."
+      },
       "recallMemoryHandles": {
         "type": "boolean",
         "default": false,
@@ -4334,6 +4465,11 @@
         "default": true,
         "description": "When true, recall multiplies candidate scores by the Memory Worth factor (mw_success / mw_fail counters, see issue #560). Memories with a history of failed sessions sink; neutral/uninstrumented memories are untouched. PR 5 bench: +0.60 precision@5 vs baseline on all 50 seeded cases. Operators can opt out with false."
       },
+      "recallTrustStageCorpusFallbackEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "When true (default), the Memory-Worth/TrustScore recall rerank stage probes a per-namespace corpus counter/signal map for candidates whose frontmatter was NOT already loaded on the hot path (cold-tier / embedding-fallback / archive rows). The map is version-keyed (invalidated on corpus mutation) and age-bounded for trust signals, so it hits in steady state without the old 30s-TTL permanent-miss. Set false to disable the corpus fallback entirely (only preloaded-candidate + direct-read paths run) — max performance when every candidate is hot, at the cost of neutral treatment for cold candidates."
+      },
       "hotMemoriesCacheEnabled": {
         "type": "boolean",
         "default": true,
@@ -4428,6 +4564,26 @@
             },
             "forceGeneric": {
               "type": "boolean"
+            },
+            "maxHints": {
+              "type": "number",
+              "description": "Per-section cap on injected hint lines."
+            },
+            "maxSupportingFacts": {
+              "type": "number",
+              "description": "Per-section cap on supporting facts."
+            },
+            "maxRelatedEntities": {
+              "type": "number",
+              "description": "Per-section cap on related entities."
+            },
+            "recentTurns": {
+              "type": "number",
+              "description": "Per-section recent-turn scan window."
+            },
+            "maxRubrics": {
+              "type": "number",
+              "description": "Per-section cap on injected rubrics."
             }
           },
           "required": [
@@ -4495,6 +4651,11 @@
         "default": false,
         "description": "Boost stored reasoning_trace memories in recall results when the incoming query reads like a problem-solving ask (e.g. 'how do I...', 'step by step', 'walk me through...'). Default false - opt in after benchmarking (issue #564)."
       },
+      "recallSingleFlightEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "When true (default), identical concurrent recalls for the same principal share a single in-flight execution (single-flight coalescing, issue #1906); each caller still receives its own cloned response and records its own budget event. Set false to restore per-request execution."
+      },
       "recallTranscriptRetentionDays": {
         "type": "integer",
         "minimum": 1,
@@ -4636,6 +4797,11 @@
         "default": "state/routing-rules.json",
         "description": "Relative path under memoryDir for persisted routing rules."
       },
+      "scopedCacheInvalidationEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Evict only the cache layers a given memory write can affect so a plain fact create no longer nukes the QMD result caches or the version-keyed entity cache (issue #1904). Set false to restore the pre-#1904 full-clear-on-every-write behavior."
+      },
       "scopeProfiles": {
         "type": "object",
         "default": {},
@@ -6868,6 +7034,11 @@
       "advanced": true,
       "placeholder": "2500"
     },
+    "proactiveExtractionSkipWhenLocalLlmBusy": {
+      "label": "Skip Proactive When Local LLM Busy",
+      "advanced": true,
+      "help": "Skip the optional proactive extraction pass when the local LLM background lane is saturated, rather than queueing behind an in-flight extraction (issue #2011, default on)"
+    },
     "proactiveExtractionMaxTokens": {
       "label": "Proactive Extraction Max Tokens",
       "advanced": true,
@@ -6987,6 +7158,12 @@
       "advanced": true,
       "placeholder": "8000"
     },
+    "recallProfileMaxRatio": {
+      "label": "Recall Profile Budget Share",
+      "advanced": true,
+      "placeholder": "0.3",
+      "help": "Maximum fraction of the total recall budget available to the behavioral profile. Set to 1 to disable the share cap."
+    },
     "recallPipeline": {
       "label": "Recall Pipeline",
       "advanced": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/plugin-openclaw",
-  "version": "9.7.14",
+  "version": "9.8.0",
   "description": "OpenClaw adapter for Remnic memory with bundled @remnic/core runtime",
   "type": "module",
   "main": "dist/index.js",
@@ -72,7 +72,7 @@
   "dependencies": {
     "@sinclair/typebox": "^0.34.0",
     "openai": "^6.0.0",
-    "@remnic/core": "^9.7.14"
+    "@remnic/core": "^9.8.0"
   },
   "peerDependencies": {
     "openclaw": ">=2026.4.1 || 2026.4.7-1 || 2026.4.9-beta.1 || 2026.4.11-beta.1 || 2026.4.12-beta.1 || 2026.4.14-beta.1 || 2026.4.15-beta.1 || 2026.4.15-beta.2 || 2026.4.19-beta.1 || 2026.4.19-beta.2 || 2026.4.20-beta.1 || 2026.4.20-beta.2 || 2026.4.22-beta.1 || 2026.4.23-beta.1 || 2026.4.23-beta.2 || 2026.4.23-beta.3 || 2026.4.23-beta.4 || 2026.4.23-beta.5 || 2026.4.23-beta.6 || 2026.4.24-beta.1 || 2026.4.24-beta.2 || 2026.4.24-beta.3 || 2026.4.24-beta.4 || 2026.4.24-beta.5 || 2026.4.24-beta.6 || 2026.4.25-beta.1 || 2026.4.25-beta.2 || 2026.4.25-beta.3 || 2026.4.25-beta.4 || 2026.4.25-beta.5 || 2026.4.25-beta.6 || 2026.4.25-beta.7 || 2026.4.25-beta.8 || 2026.4.25-beta.9 || 2026.4.25-beta.10 || 2026.4.25-beta.11 || 2026.4.26-beta.1 || 2026.4.27-beta.1 || 2026.4.29-beta.1 || 2026.4.29-beta.2 || 2026.4.29-beta.3 || 2026.4.29-beta.4 || 2026.4.30-beta.1 || 2026.5.2-beta.1 || 2026.5.2-beta.2 || 2026.5.2-beta.3 || 2026.5.3-beta.1 || 2026.5.3-beta.2 || 2026.5.3-beta.3 || 2026.5.3-beta.4 || 2026.5.3-1 || 2026.5.4-beta.1 || 2026.5.4-beta.2 || 2026.5.4-beta.3 || 2026.5.5-beta.1 || 2026.5.5-beta.2 || 2026.5.6-beta.1 || 2026.5.7-beta.1 || 2026.5.9-beta.1 || 2026.5.10-beta.1 || 2026.5.10-beta.2 || 2026.5.10-beta.3 || 2026.5.10-beta.4 || 2026.5.10-beta.5 || 2026.5.10-beta.6 || 2026.5.12-beta.1 || 2026.5.12-beta.2 || 2026.5.12-beta.3 || 2026.5.12-beta.4 || 2026.5.12-beta.5 || 2026.5.12-beta.6 || 2026.5.12-beta.7 || 2026.5.12-beta.8 || 2026.5.14-beta.1 || 2026.5.14-beta.2 || 2026.5.16-beta.1 || 2026.5.16-beta.2 || 2026.5.16-beta.3 || 2026.5.16-beta.4 || 2026.5.16-beta.5 || 2026.5.16-beta.6 || 2026.5.16-beta.7 || 2026.5.18-beta.1 || 2026.5.19-alpha.1 || 2026.5.19-beta.1 || 2026.5.19-beta.2 || 2026.5.20-beta.1 || 2026.5.20-beta.2 || 2026.5.21-alpha.1 || 2026.5.21-beta.1 || 2026.5.22-beta.1 || 2026.5.23-alpha.1 || 2026.5.24-alpha.1 || 2026.5.24-beta.1 || 2026.5.24-beta.2 || 2026.5.25-alpha.1 || 2026.5.25-alpha.2 || 2026.5.25-beta.1 || 2026.5.26-beta.1 || 2026.5.26-beta.2 || 2026.5.27-alpha.1 || 2026.5.27-beta.1 || 2026.5.28-alpha.1 || 2026.5.28-beta.1 || 2026.5.28-beta.2 || 2026.5.28-beta.3 || 2026.5.28-beta.4 || 2026.5.29-alpha.1 || 2026.5.30-beta.1 || 2026.5.30-beta.2 || 2026.5.31-alpha.1 || 2026.5.31-beta.1 || 2026.5.31-beta.2 || 2026.5.31-beta.3 || 2026.5.31-beta.4 || 2026.6.1-alpha.1 || 2026.6.1-alpha.2 || 2026.6.1-alpha.3 || 2026.6.1-beta.1 || 2026.6.1-beta.2 || 2026.6.1-beta.3 || 2026.6.2-alpha.1 || 2026.6.2-alpha.2 || 2026.6.2-beta.1 || 2026.6.3-alpha.1 || 2026.6.4-alpha.1 || 2026.6.5-alpha.1 || 2026.6.5-alpha.2 || 2026.6.5-beta.1 || 2026.6.5-beta.2 || 2026.6.5-beta.3 || 2026.6.5-beta.5 || 2026.6.5-beta.6 || 2026.6.6-alpha.1 || 2026.6.6-beta.2 || 2026.6.6 || 2026.6.7-beta.1 || 2026.6.8-beta.1 || 2026.6.8-beta.2 || 2026.6.9-beta.1 || 2026.6.10-beta.1 || 2026.6.10-beta.2 || 2026.6.11-beta.1"
@@ -82,7 +82,7 @@
     "acorn": "^8.16.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "@remnic/core": "^9.7.14"
+    "@remnic/core": "^9.8.0"
   },
   "license": "MIT",
   "repository": {