@joshuaswarren/openclaw-engram 9.7.14 → 9.8.0

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-engram",
   "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": "@joshuaswarren/openclaw-engram",
-  "version": "9.7.14",
+  "version": "9.8.0",
   "description": "Deprecated compatibility shim for Engram installs. Re-exports @remnic/plugin-openclaw and forwards engram-access to @remnic/core.",
   "type": "module",
   "main": "dist/index.js",
@@ -51,8 +51,8 @@
     }
   },
   "dependencies": {
-    "@remnic/plugin-openclaw": "^9.7.14",
-    "@remnic/core": "^9.7.14"
+    "@remnic/plugin-openclaw": "^9.8.0",
+    "@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"