@joshuaswarren/openclaw-engram 9.3.3 → 9.3.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Joshua Warren
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/engram-access.js

@@ -1,7 +1,16 @@
 #!/usr/bin/env node
 
+// The shim is the legacy alias — identify ourselves as "openclaw-engram" so
+// runCli's resolveRemnicPluginEntry targets plugins.entries["openclaw-engram"]
+// before falling through to the canonical "openclaw-remnic" entry.  This
+// prevents `engram-access` from silently reading/writing the wrong memory
+// store during migration when both blocks exist with no plugins.slots.memory
+// override (#403).  The id is hardcoded (not imported from @remnic/core)
+// because the shim *is* the legacy alias — the string is its identity.
 import("../dist/access-cli.js")
-  .then(({ runCli }) => runCli(process.argv.slice(2)))
+  .then(({ runCli }) =>
+    runCli(process.argv.slice(2), { preferredId: "openclaw-engram" }),
+  )
   .catch((error) => {
     const message = error instanceof Error ? error.message : "unknown load error";
     console.error(`access-cli failed to load dist/access-cli.js: ${message}`);

package/dist/index.js

@@ -1,6 +1,11 @@
 // src/index.ts
 export * from "@remnic/plugin-openclaw";
-import { default as default2 } from "@remnic/plugin-openclaw";
+import remnicPluginDefinition from "@remnic/plugin-openclaw";
+var shimPluginDefinition = {
+  ...remnicPluginDefinition,
+  id: "openclaw-engram"
+};
+var index_default = shimPluginDefinition;
 export {
-  default2 as default
+  index_default as default
 };

package/openclaw.plugin.json

@@ -1,6 +1,15 @@
 {
   "id": "openclaw-engram",
   "kind": "memory",
+  "description": "Local semantic memory for OpenClaw. Requires plugins.slots.memory set to this plugin id for hooks to fire.",
+  "supports": {
+    "memorySlot": true,
+    "dreamingSlot": true,
+    "activeMemory": true,
+    "heartbeat": true,
+    "commandsList": true,
+    "beforeReset": true
+  },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -165,6 +174,612 @@
         "type": "string",
         "description": "Override memory storage directory"
       },
+      "entitySchemas": {
+        "type": "object",
+        "description": "Optional per-entity-type structured section schema overrides.",
+        "additionalProperties": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "sections": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                  "key": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "aliases": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                },
+                "anyOf": [
+                  {
+                    "required": [
+                      "key"
+                    ]
+                  },
+                  {
+                    "required": [
+                      "title"
+                    ]
+                  }
+                ]
+              }
+            }
+          },
+          "required": [
+            "sections"
+          ]
+        }
+      },
+      "dreaming": {
+        "type": "object",
+        "additionalProperties": false,
+        "default": {},
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false
+          },
+          "journalPath": {
+            "type": "string",
+            "default": "DREAMS.md"
+          },
+          "maxEntries": {
+            "anyOf": [
+              {
+                "type": "integer",
+                "const": 0
+              },
+              {
+                "type": "integer",
+                "minimum": 10,
+                "maximum": 10000
+              }
+            ],
+            "default": 500
+          },
+          "injectRecentCount": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 20,
+            "default": 3
+          },
+          "minIntervalMinutes": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 120
+          },
+          "narrativeModel": {
+            "type": "string",
+            "default": ""
+          },
+          "narrativePromptStyle": {
+            "type": "string",
+            "enum": [
+              "reflective",
+              "diary",
+              "analytical"
+            ],
+            "default": "reflective"
+          },
+          "watchFile": {
+            "type": "boolean",
+            "default": true
+          }
+        }
+      },
+      "heartbeat": {
+        "type": "object",
+        "additionalProperties": false,
+        "default": {},
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false
+          },
+          "journalPath": {
+            "type": "string",
+            "default": "HEARTBEAT.md"
+          },
+          "maxPreviousRuns": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 20,
+            "default": 5
+          },
+          "watchFile": {
+            "type": "boolean",
+            "default": true
+          },
+          "detectionMode": {
+            "type": "string",
+            "enum": [
+              "runtime-signal",
+              "heuristic",
+              "auto"
+            ],
+            "default": "auto"
+          },
+          "gateExtractionDuringHeartbeat": {
+            "type": "boolean",
+            "default": true
+          }
+        }
+      },
+      "procedural": {
+        "type": "object",
+        "additionalProperties": false,
+        "default": {},
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "Master gate for procedural memory: extraction, recall boost, and mining (issue #519)."
+          },
+          "minOccurrences": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 1000,
+            "default": 3,
+            "description": "Minimum clustered trajectory occurrences before emitting a candidate procedure (0 disables mining)."
+          },
+          "successFloor": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "default": 0.7,
+            "description": "Minimum success-rate floor (from trajectory outcomes) for miner promotion."
+          },
+          "autoPromoteOccurrences": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 10000,
+            "default": 8,
+            "description": "When auto-promotion is enabled, minimum occurrence count to move pending_review procedures to active (0 disables auto-promotion by count)."
+          },
+          "autoPromoteEnabled": {
+            "type": "boolean",
+            "default": false,
+            "description": "When true, miner may auto-promote trusted procedures to active after autoPromoteOccurrences."
+          },
+          "lookbackDays": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 3650,
+            "default": 30,
+            "description": "Trajectory lookback window for procedural mining."
+          },
+          "recallMaxProcedures": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 10,
+            "default": 3,
+            "description": "Maximum procedure memories to inject on task-initiation recall."
+          },
+          "proceduralMiningCronAutoRegister": {
+            "type": "boolean",
+            "default": false,
+            "description": "When true, installer may register the nightly procedural mining cron job."
+          }
+        }
+      },
+      "slotBehavior": {
+        "type": "object",
+        "additionalProperties": false,
+        "default": {},
+        "properties": {
+          "requireExclusiveMemorySlot": {
+            "type": "boolean",
+            "default": true
+          },
+          "onSlotMismatch": {
+            "type": "string",
+            "enum": [
+              "error",
+              "warn",
+              "silent"
+            ],
+            "default": "error"
+          }
+        }
+      },
+      "beforeResetTimeoutMs": {
+        "type": "integer",
+        "minimum": 100,
+        "maximum": 30000,
+        "default": 2000,
+        "description": "Maximum time to wait for a reset-triggered flush before returning control to OpenClaw."
+      },
+      "flushOnResetEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Flush buffered turns through extraction when OpenClaw resets a session."
+      },
+      "commandsListEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Advertise Remnic slash-command descriptors through the commands.list runtime surface."
+      },
+      "openclawToolsEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Register the OpenClaw memory.search and memory.get tool adapters."
+      },
+      "openclawToolSnippetMaxChars": {
+        "type": "integer",
+        "minimum": 80,
+        "maximum": 4000,
+        "default": 600,
+        "description": "Maximum snippet size returned by the OpenClaw memory tool adapters."
+      },
+      "sessionTogglesEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable per-session recall toggle state for OpenClaw runtime surfaces."
+      },
+      "verboseRecallVisibility": {
+        "type": "boolean",
+        "default": true,
+        "description": "Allow verbose recall headers to surface runtime recall diagnostics in prompts."
+      },
+      "recallTranscriptsEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Write JSONL recall audit transcripts for runtime-surface injections."
+      },
+      "recallTranscriptRetentionDays": {
+        "type": "integer",
+        "minimum": 1,
+        "maximum": 365,
+        "default": 30,
+        "description": "Days of runtime recall audit transcripts to retain before pruning."
+      },
+      "respectBundledActiveMemoryToggle": {
+        "type": "boolean",
+        "default": true,
+        "description": "Honor the bundled active-memory session toggle file when resolving Remnic recall toggles."
+      },
+      "activeRecallEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable the OpenClaw active-recall prompt surface."
+      },
+      "activeRecallAgents": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Optional allowlist of OpenClaw agent ids that may use active recall."
+      },
+      "activeRecallAllowedChatTypes": {
+        "type": "array",
+        "items": {
+          "type": "string",
+          "enum": [
+            "direct",
+            "group",
+            "channel"
+          ]
+        },
+        "default": [
+          "direct",
+          "group",
+          "channel"
+        ],
+        "description": "OpenClaw chat types eligible for active recall."
+      },
+      "activeRecallQueryMode": {
+        "type": "string",
+        "enum": [
+          "recent",
+          "message",
+          "full"
+        ],
+        "default": "recent",
+        "description": "How much recent OpenClaw conversation context is fed into the active-recall query builder."
+      },
+      "activeRecallPromptStyle": {
+        "type": "string",
+        "enum": [
+          "balanced",
+          "strict",
+          "contextual",
+          "recall-heavy",
+          "precision-heavy",
+          "preference-only"
+        ],
+        "default": "balanced",
+        "description": "Prompt assembly style for the active-recall surface."
+      },
+      "activeRecallPromptOverride": {
+        "type": "string",
+        "description": "Optional full prompt override for the active-recall surface."
+      },
+      "activeRecallPromptAppend": {
+        "type": "string",
+        "description": "Optional prompt suffix appended to the active-recall system prompt."
+      },
+      "activeRecallMaxSummaryChars": {
+        "type": "integer",
+        "minimum": 40,
+        "maximum": 1000,
+        "default": 220,
+        "description": "Maximum summary size produced by the active-recall surface."
+      },
+      "activeRecallRecentUserTurns": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 4,
+        "default": 2,
+        "description": "How many recent user turns to include in the active-recall query context."
+      },
+      "activeRecallRecentAssistantTurns": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 3,
+        "default": 1,
+        "description": "How many recent assistant turns to include in the active-recall query context."
+      },
+      "activeRecallRecentUserChars": {
+        "type": "integer",
+        "minimum": 40,
+        "maximum": 1000,
+        "default": 600,
+        "description": "Per-user-turn character cap for active-recall context assembly."
+      },
+      "activeRecallRecentAssistantChars": {
+        "type": "integer",
+        "minimum": 40,
+        "maximum": 1000,
+        "default": 400,
+        "description": "Per-assistant-turn character cap for active-recall context assembly."
+      },
+      "activeRecallThinking": {
+        "type": "string",
+        "enum": [
+          "off",
+          "minimal",
+          "low",
+          "medium",
+          "high",
+          "xhigh",
+          "adaptive"
+        ],
+        "default": "low",
+        "description": "Reasoning effort used by the active-recall engine."
+      },
+      "activeRecallTimeoutMs": {
+        "type": "integer",
+        "minimum": 250,
+        "default": 15000,
+        "description": "Timeout for an active-recall run."
+      },
+      "activeRecallCacheTtlMs": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 120000,
+        "default": 15000,
+        "description": "Cache TTL for active-recall summaries; 0 disables the cache."
+      },
+      "activeRecallModel": {
+        "type": "string",
+        "description": "Optional model override for active recall."
+      },
+      "activeRecallModelFallbackPolicy": {
+        "type": "string",
+        "enum": [
+          "default-remote",
+          "resolved-only"
+        ],
+        "default": "default-remote",
+        "description": "How active recall falls back when an explicit model cannot be resolved."
+      },
+      "activeRecallPersistTranscripts": {
+        "type": "boolean",
+        "default": false,
+        "description": "Persist full active-recall request and response transcripts."
+      },
+      "activeRecallTranscriptDir": {
+        "type": "string",
+        "default": "active-recall",
+        "description": "Memory-relative directory for active-recall transcripts."
+      },
+      "activeRecallEntityGraphDepth": {
+        "type": "integer",
+        "minimum": 0,
+        "maximum": 3,
+        "default": 1,
+        "description": "Entity-graph traversal depth used by active recall."
+      },
+      "activeRecallIncludeCausalTrajectories": {
+        "type": "boolean",
+        "default": false,
+        "description": "Include causal trajectory recall evidence in active-recall summaries."
+      },
+      "activeRecallIncludeDaySummary": {
+        "type": "boolean",
+        "default": false,
+        "description": "Include the latest day summary in active-recall context."
+      },
+      "activeRecallAttachRecallExplain": {
+        "type": "boolean",
+        "default": false,
+        "description": "Attach recall explain output to active-recall diagnostics."
+      },
+      "activeRecallAllowChainedActiveMemory": {
+        "type": "boolean",
+        "default": false,
+        "description": "Allow active recall to chain into the bundled active-memory surface."
+      },
+      "codex": {
+        "type": "object",
+        "additionalProperties": false,
+        "default": {},
+        "properties": {
+          "installExtension": {
+            "type": "boolean",
+            "default": true,
+            "description": "Install the Remnic Codex memory extension during Codex connector setup."
+          },
+          "codexHome": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "default": null,
+            "description": "Optional Codex home directory override used for connector install and materialization."
+          }
+        }
+      },
+      "codexMaterializeMemories": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable Codex native memory materialization into the Codex memories directory."
+      },
+      "codexMaterializeNamespace": {
+        "type": "string",
+        "default": "auto",
+        "description": "Namespace to materialize for Codex. \"auto\" derives the namespace from the active connector context."
+      },
+      "codexMaterializeMaxSummaryTokens": {
+        "type": "number",
+        "minimum": 0,
+        "default": 4500,
+        "description": "Whitespace-token cap for Codex memory summary materialization."
+      },
+      "codexMaterializeRolloutRetentionDays": {
+        "type": "number",
+        "minimum": 0,
+        "default": 30,
+        "description": "Retention window in days for Codex rollout materialization artifacts."
+      },
+      "codexMaterializeOnConsolidation": {
+        "type": "boolean",
+        "default": true,
+        "description": "Run Codex memory materialization after semantic or causal consolidation completes."
+      },
+      "codexMaterializeOnSessionEnd": {
+        "type": "boolean",
+        "default": true,
+        "description": "Run Codex memory materialization from the Codex session-end hook."
+      },
+      "codexMarketplaceEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable Codex marketplace integration for plugin discovery and installation."
+      },
+      "versioningEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable page-level versioning with sidecar snapshots."
+      },
+      "versioningMaxPerPage": {
+        "type": "integer",
+        "default": 50,
+        "minimum": 0,
+        "description": "Maximum number of version snapshots per page. Set to 0 to disable pruning."
+      },
+      "versioningSidecarDir": {
+        "type": "string",
+        "default": ".versions",
+        "description": "Name of the sidecar directory inside memoryDir for version snapshots."
+      },
+      "taxonomyEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable the MECE taxonomy knowledge directory for categorizing memories."
+      },
+      "taxonomyAutoGenResolver": {
+        "type": "boolean",
+        "default": true,
+        "description": "Auto-regenerate RESOLVER.md when the taxonomy changes."
+      },
+      "citationsEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable oai-mem-citation blocks in recall responses for Codex citation parity."
+      },
+      "citationsAutoDetect": {
+        "type": "boolean",
+        "default": true,
+        "description": "Auto-enable citations when the Codex adapter is detected."
+      },
+      "memoryExtensionsEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Whether third-party memory extensions are discovered and injected into consolidation prompts."
+      },
+      "memoryExtensionsRoot": {
+        "type": "string",
+        "default": "",
+        "description": "Root directory for memory extensions. Empty string derives from memoryDir (go up to Remnic home and append memory_extensions)."
+      },
+      "binaryLifecycleEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable binary file lifecycle management. When true, binary files in the memory directory are mirrored, redirected, and cleaned."
+      },
+      "binaryLifecycleGracePeriodDays": {
+        "type": "number",
+        "default": 7,
+        "minimum": 0,
+        "description": "Days to wait before cleaning local copies of mirrored binary files."
+      },
+      "binaryLifecycleBackendType": {
+        "type": "string",
+        "enum": [
+          "none",
+          "filesystem",
+          "s3"
+        ],
+        "default": "none",
+        "description": "Storage backend for binary lifecycle mirror stage."
+      },
+      "binaryLifecycleBackendPath": {
+        "type": "string",
+        "default": "",
+        "description": "Base path for the filesystem storage backend."
+      },
+      "codexCompat": {
+        "type": "object",
+        "additionalProperties": false,
+        "default": {},
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": false
+          },
+          "threadIdBufferKeying": {
+            "type": "boolean",
+            "default": true
+          },
+          "compactionFlushMode": {
+            "type": "string",
+            "enum": [
+              "signal",
+              "heuristic",
+              "auto"
+            ],
+            "default": "auto"
+          },
+          "fingerprintDedup": {
+            "type": "boolean",
+            "default": true
+          }
+        }
+      },
       "debug": {
         "type": "boolean",
         "default": false,
@@ -685,7 +1300,7 @@
       "recallPlannerShadowMode": {
         "type": "boolean",
         "default": false,
-        "description": "Run recall planner in shadow mode \u2014 evaluate but do not apply results."
+        "description": "Run recall planner in shadow mode — evaluate but do not apply results."
       },
       "recallPlannerTelemetryEnabled": {
         "type": "boolean",
@@ -741,7 +1356,8 @@
             "principle",
             "commitment",
             "moment",
-            "skill"
+            "skill",
+            "procedure"
           ]
         },
         "default": [
@@ -760,7 +1376,7 @@
       "boxTopicShiftThreshold": {
         "type": "number",
         "default": 0.35,
-        "description": "Jaccard overlap threshold below which a topic shift seals the current box (0\u20131)."
+        "description": "Jaccard overlap threshold below which a topic shift seals the current box (0–1)."
       },
       "boxTimeGapMs": {
         "type": "number",
@@ -785,7 +1401,7 @@
       "traceWeaverOverlapThreshold": {
         "type": "number",
         "default": 0.4,
-        "description": "Minimum Jaccard topic overlap to assign the same traceId (0\u20131)."
+        "description": "Minimum Jaccard topic overlap to assign the same traceId (0–1)."
       },
       "boxRecallDays": {
         "type": "number",
@@ -885,7 +1501,7 @@
       "graphRecallShadowEnabled": {
         "type": "boolean",
         "default": false,
-        "description": "Run graph recall in shadow mode \u2014 evaluate but do not inject results."
+        "description": "Run graph recall in shadow mode — evaluate but do not inject results."
       },
       "graphRecallSnapshotEnabled": {
         "type": "boolean",
@@ -1239,6 +1855,53 @@
         "default": 2,
         "description": "Number of sentences to overlap between chunks"
       },
+      "semanticChunkingEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable semantic chunking with embedding-based topic boundary detection (requires embedding provider)"
+      },
+      "semanticChunkingConfig": {
+        "type": "object",
+        "default": {},
+        "description": "Optional overrides for the semantic chunking algorithm",
+        "properties": {
+          "targetTokens": {
+            "type": "number",
+            "default": 200,
+            "description": "Target tokens per chunk"
+          },
+          "minTokens": {
+            "type": "number",
+            "default": 100,
+            "description": "Minimum tokens for a segment before merging with neighbor"
+          },
+          "maxTokens": {
+            "type": "number",
+            "default": 400,
+            "description": "Maximum tokens for a segment before recursive splitting"
+          },
+          "smoothingWindowSize": {
+            "type": "number",
+            "default": 3,
+            "description": "Window size for the moving-average smoothing filter (auto-rounded to odd)"
+          },
+          "boundaryThresholdStdDevs": {
+            "type": "number",
+            "default": 1,
+            "description": "Standard deviations below mean for boundary detection"
+          },
+          "embeddingBatchSize": {
+            "type": "number",
+            "default": 32,
+            "description": "Batch size for embedding requests"
+          },
+          "fallbackToRecursive": {
+            "type": "boolean",
+            "default": true,
+            "description": "Fall back to recursive chunking when embeddings are unavailable"
+          }
+        }
+      },
       "contradictionDetectionEnabled": {
         "type": "boolean",
         "default": false,
@@ -1259,6 +1922,56 @@
         "default": true,
         "description": "Automatically supersede contradicted memories"
       },
+      "temporalSupersessionEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Mark older facts superseded when a new fact writes a conflicting value for the same entityRef + structuredAttribute key (issue #375)"
+      },
+      "temporalSupersessionIncludeInRecall": {
+        "type": "boolean",
+        "default": false,
+        "description": "If true, include temporally-superseded facts in recall results (for audit/history). Default: exclude."
+      },
+      "recallDirectAnswerEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "When true, recall checks whether a single validated high-trust memory can answer the query before QMD runs (issue #518). Default off until bench validation."
+      },
+      "recallDirectAnswerTokenOverlapFloor": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.55,
+        "description": "Minimum query↔memory token-overlap ratio for direct-answer eligibility. Set to 0 to disable the gate."
+      },
+      "recallDirectAnswerImportanceFloor": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.7,
+        "description": "Minimum calibrated importance score for direct-answer eligibility. Set to 0 to disable the gate."
+      },
+      "recallDirectAnswerAmbiguityMargin": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1,
+        "default": 0.15,
+        "description": "If the second-best candidate scores within this ratio of the top, direct-answer defers to hybrid."
+      },
+      "recallDirectAnswerEligibleTaxonomyBuckets": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "default": [
+          "decisions",
+          "principles",
+          "conventions",
+          "runbooks",
+          "entities"
+        ],
+        "description": "Taxonomy category IDs eligible for direct-answer routing."
+      },
       "memoryLinkingEnabled": {
         "type": "boolean",
         "default": false,
@@ -1403,7 +2116,10 @@
       },
       "modelSource": {
         "type": "string",
-        "enum": ["plugin", "gateway"],
+        "enum": [
+          "plugin",
+          "gateway"
+        ],
         "default": "plugin",
         "description": "LLM source: 'plugin' uses Engram's own openai/localLlm config; 'gateway' delegates to a gateway agent's model chain (agents.list[])."
       },
@@ -1483,7 +2199,7 @@
       "traceRecallContent": {
         "type": "boolean",
         "default": false,
-        "description": "If true, include the full recalled memory text in RecallTraceEvent.recalledContent emitted to __openclawEngramTrace subscribers (e.g. Langfuse). Disabled by default \u2014 only enable when you want external trace collectors to capture injected memory context."
+        "description": "If true, include the full recalled memory text in RecallTraceEvent.recalledContent emitted to __openclawEngramTrace subscribers (e.g. Langfuse). Disabled by default — only enable when you want external trace collectors to capture injected memory context."
       },
       "profilingEnabled": {
         "type": "boolean",
@@ -1515,6 +2231,49 @@
         "default": 40,
         "description": "Minimum combined user/assistant characters required before extraction runs."
       },
+      "extractionMinImportanceLevel": {
+        "type": "string",
+        "enum": [
+          "trivial",
+          "low",
+          "normal",
+          "high",
+          "critical"
+        ],
+        "default": "low",
+        "description": "Minimum locally-scored importance level required to persist an extracted fact. Facts below this level are dropped before write and counted toward the importance_gated metric. Default \"low\" drops only trivial turn-level chatter (greetings, single-word replies); raise to \"normal\" or higher for a stricter gate."
+      },
+      "extractionJudgeEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable the LLM-as-judge fact-worthiness gate. When enabled, extracted facts are evaluated for durability before being persisted. Off by default (opt-in)."
+      },
+      "extractionJudgeModel": {
+        "type": "string",
+        "default": "",
+        "description": "Model override for the extraction judge LLM. Empty string uses the configured local model."
+      },
+      "extractionJudgeBatchSize": {
+        "type": "number",
+        "default": 20,
+        "minimum": 1,
+        "description": "Maximum number of candidate facts sent to the judge LLM in a single batch call."
+      },
+      "extractionJudgeShadow": {
+        "type": "boolean",
+        "default": false,
+        "description": "Shadow mode for the extraction judge. When true, judge verdicts are logged but all facts are still persisted regardless of the verdict."
+      },
+      "inlineSourceAttributionEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable inline source attribution markers on persisted facts for downstream provenance tracking."
+      },
+      "inlineSourceAttributionFormat": {
+        "type": "string",
+        "default": "[Source: agent={agent}, session={sessionId}, ts={ts}]",
+        "description": "Template used when inline source attribution is enabled."
+      },
       "extractionMinUserTurns": {
         "type": "number",
         "default": 1,
@@ -1894,8 +2653,14 @@
       },
       "semanticConsolidationExcludeCategories": {
         "type": "array",
-        "items": { "type": "string" },
-        "default": ["correction", "commitment"],
+        "items": {
+          "type": "string"
+        },
+        "default": [
+          "correction",
+          "commitment",
+          "procedure"
+        ],
         "description": "Memory categories excluded from semantic consolidation."
       },
       "semanticConsolidationIntervalHours": {
@@ -2260,6 +3025,24 @@
         "default": true,
         "description": "Enable content-hash deduplication to prevent storing semantically identical facts."
       },
+      "semanticDedupEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Issue #373 — enable write-time semantic similarity guard that skips near-duplicate facts by comparing embeddings to existing memories. Fails open when the embedding backend is unavailable."
+      },
+      "semanticDedupThreshold": {
+        "type": "number",
+        "default": 0.92,
+        "minimum": 0,
+        "maximum": 1,
+        "description": "Cosine similarity threshold in [0, 1]. Candidate facts whose nearest neighbor scores at or above this value are treated as duplicates and skipped."
+      },
+      "semanticDedupCandidates": {
+        "type": "number",
+        "default": 5,
+        "minimum": 0,
+        "description": "Number of nearest-neighbor candidates to inspect during the write-time semantic dedup check. Set to 0 to disable the embedding lookup entirely (equivalent to semanticDedupEnabled=false)."
+      },
       "factArchivalEnabled": {
         "type": "boolean",
         "default": false,
@@ -2289,7 +3072,8 @@
           "commitment",
           "preference",
           "decision",
-          "principle"
+          "principle",
+          "procedure"
         ],
         "description": "Categories that protect a fact from archival regardless of other criteria."
       },
@@ -2327,7 +3111,8 @@
           "decision",
           "principle",
           "commitment",
-          "preference"
+          "preference",
+          "procedure"
         ],
         "description": "Categories that lifecycle policy will not auto-archive."
       },
@@ -2615,6 +3400,20 @@
         "default": true,
         "description": "Generate LLM summaries for entities during consolidation"
       },
+      "entitySynthesisMaxTokens": {
+        "anyOf": [
+          {
+            "type": "integer",
+            "const": 0
+          },
+          {
+            "type": "integer",
+            "minimum": 10
+          }
+        ],
+        "default": 500,
+        "description": "Max tokens used when refreshing an entity synthesis from its timeline."
+      },
       "recallBudgetChars": {
         "type": "number",
         "description": "Hard character cap for total recall injection. Defaults to maxMemoryTokens * 4."
@@ -2634,6 +3433,24 @@
         "default": 25000,
         "description": "Default deadline in ms recorded for enrichment recall sections."
       },
+      "recallMmrEnabled": {
+        "type": "boolean",
+        "default": true,
+        "description": "Apply Maximal Marginal Relevance to the final recall selection per-section so one redundant cluster cannot dominate the injected context."
+      },
+      "recallMmrLambda": {
+        "type": "number",
+        "default": 0.7,
+        "minimum": 0,
+        "maximum": 1,
+        "description": "MMR lambda parameter. 1.0 = pure relevance, 0.0 = pure diversity. Default 0.7 tilts toward relevance with meaningful diversity."
+      },
+      "recallMmrTopN": {
+        "type": "number",
+        "default": 40,
+        "minimum": 0,
+        "description": "Number of top candidates per section to run MMR over. Candidates past this remain in original order."
+      },
       "recallPipeline": {
         "type": "array",
         "description": "Ordered recall sections with per-section budgets and feature knobs.",
@@ -2860,7 +3677,7 @@
       "parallelAgentWeights": {
         "type": "object",
         "default": {
-          "direct": 1.0,
+          "direct": 1,
           "contextual": 0.7,
           "temporal": 0.85
         },
@@ -2870,6 +3687,83 @@
         "type": "number",
         "default": 20,
         "description": "Maximum results fetched per agent before merge."
+      },
+      "briefing": {
+        "type": "object",
+        "additionalProperties": false,
+        "default": {
+          "enabled": true,
+          "defaultWindow": "yesterday",
+          "defaultFormat": "markdown",
+          "maxFollowups": 5,
+          "calendarSource": null,
+          "saveByDefault": false,
+          "saveDir": null,
+          "llmFollowups": true
+        },
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "default": true
+          },
+          "defaultWindow": {
+            "type": "string",
+            "default": "yesterday"
+          },
+          "defaultFormat": {
+            "type": "string",
+            "enum": [
+              "markdown",
+              "json"
+            ],
+            "default": "markdown"
+          },
+          "maxFollowups": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 10,
+            "default": 5
+          },
+          "calendarSource": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "default": null
+          },
+          "saveByDefault": {
+            "type": "boolean",
+            "default": false
+          },
+          "saveDir": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "default": null
+          },
+          "llmFollowups": {
+            "type": "boolean",
+            "default": true
+          }
+        },
+        "description": "Daily Context Briefing (#370). Knobs: enabled, defaultWindow ('yesterday', '3d', '1w', '24h', ...), defaultFormat (markdown|json), maxFollowups (0-10), calendarSource (path to ICS/JSON file, null = off), saveByDefault, saveDir (null = $REMNIC_HOME/briefings/), llmFollowups (disable to skip Responses API calls)."
+      },
+      "enrichmentEnabled": {
+        "type": "boolean",
+        "default": false,
+        "description": "Enable the external enrichment pipeline (#365). When true, entities can be enriched via registered providers."
+      },
+      "enrichmentAutoOnCreate": {
+        "type": "boolean",
+        "default": false,
+        "description": "Automatically enrich newly created entities when the enrichment pipeline is enabled."
+      },
+      "enrichmentMaxCandidatesPerEntity": {
+        "type": "integer",
+        "default": 20,
+        "minimum": 0,
+        "description": "Maximum enrichment candidates accepted per entity per run. Set to 0 to accept none."
       }
     }
   },
@@ -3128,6 +4022,15 @@
       "advanced": true,
       "placeholder": "2"
     },
+    "semanticChunkingEnabled": {
+      "label": "Semantic Chunking",
+      "help": "Use embedding-based topic detection for more coherent chunks (requires chunking enabled)"
+    },
+    "semanticChunkingConfig": {
+      "label": "Semantic Chunking Config",
+      "advanced": true,
+      "help": "Override defaults for semantic chunking algorithm parameters"
+    },
     "contradictionDetectionEnabled": {
       "label": "Contradiction Detection",
       "help": "Detect and resolve conflicting memories using LLM verification"
@@ -3146,6 +4049,39 @@
       "label": "Auto-Resolve Contradictions",
       "help": "Automatically supersede old memories when contradiction is confirmed"
     },
+    "temporalSupersessionEnabled": {
+      "label": "Temporal Supersession",
+      "help": "Mark older facts superseded when a newer fact writes a conflicting value for the same entityRef + structured attribute (issue #375)"
+    },
+    "temporalSupersessionIncludeInRecall": {
+      "label": "Include Superseded Facts In Recall",
+      "advanced": true,
+      "help": "If enabled, superseded facts still surface in recall (audit/history mode)."
+    },
+    "recallDirectAnswerEnabled": {
+      "label": "Direct-Answer Retrieval Tier",
+      "help": "Route validated high-trust queries to a fast direct-answer path before QMD (issue #518)."
+    },
+    "recallDirectAnswerTokenOverlapFloor": {
+      "label": "Direct-Answer Token Overlap Floor",
+      "advanced": true,
+      "placeholder": "0.55"
+    },
+    "recallDirectAnswerImportanceFloor": {
+      "label": "Direct-Answer Importance Floor",
+      "advanced": true,
+      "placeholder": "0.7"
+    },
+    "recallDirectAnswerAmbiguityMargin": {
+      "label": "Direct-Answer Ambiguity Margin",
+      "advanced": true,
+      "placeholder": "0.15"
+    },
+    "recallDirectAnswerEligibleTaxonomyBuckets": {
+      "label": "Direct-Answer Eligible Taxonomy Buckets",
+      "advanced": true,
+      "help": "Taxonomy category IDs eligible for direct-answer routing."
+    },
     "memoryLinkingEnabled": {
       "label": "Memory Linking",
       "help": "Build knowledge graph by linking related memories"
@@ -3567,6 +4503,20 @@
       "label": "Fact Deduplication",
       "help": "Prevent storing semantically identical facts using content hashing"
     },
+    "semanticDedupEnabled": {
+      "label": "Semantic Dedup (write-time)",
+      "help": "Skip near-duplicate facts at write time by comparing embeddings to existing memories (issue #373)."
+    },
+    "semanticDedupThreshold": {
+      "label": "Semantic Dedup Threshold",
+      "advanced": true,
+      "placeholder": "0.92"
+    },
+    "semanticDedupCandidates": {
+      "label": "Semantic Dedup Candidates",
+      "advanced": true,
+      "placeholder": "5"
+    },
     "factArchivalEnabled": {
       "label": "Fact Archival",
       "help": "Automatically archive old, low-importance, rarely-accessed facts during consolidation"
@@ -3765,6 +4715,12 @@
       "label": "Entity Summaries",
       "help": "Generate LLM summaries for entities during consolidation"
     },
+    "entitySynthesisMaxTokens": {
+      "label": "Entity Synthesis Max Tokens",
+      "advanced": true,
+      "placeholder": "500",
+      "help": "Max tokens used when refreshing an entity synthesis from its timeline."
+    },
     "recallBudgetChars": {
       "label": "Recall Budget (Chars)",
       "advanced": true,
@@ -3774,6 +4730,23 @@
       "label": "Recall Pipeline",
       "advanced": true,
       "help": "Ordered section configuration for recall assembly and per-section limits"
+    },
+    "recallMmrEnabled": {
+      "label": "Recall MMR (Diversity)",
+      "advanced": true,
+      "help": "Apply Maximal Marginal Relevance per-section so duplicate clusters cannot dominate the recall budget"
+    },
+    "recallMmrLambda": {
+      "label": "MMR Lambda",
+      "advanced": true,
+      "placeholder": "0.7",
+      "help": "1.0 = pure relevance, 0.0 = pure diversity. Default 0.7."
+    },
+    "recallMmrTopN": {
+      "label": "MMR Top-N",
+      "advanced": true,
+      "placeholder": "40",
+      "help": "Number of top candidates per section over which MMR is applied"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshuaswarren/openclaw-engram",
-  "version": "9.3.3",
+  "version": "9.3.5",
   "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",
@@ -30,16 +30,9 @@
       "./dist/index.js"
     ]
   },
-  "scripts": {
-    "build": "node ./scripts/sync-openclaw-plugin.mjs && tsup --config tsup.config.ts",
-    "check-types": "tsc --noEmit",
-    "postinstall": "node ./scripts/postinstall-banner.mjs",
-    "prepack": "npm run build",
-    "prepublishOnly": "npm run build"
-  },
   "dependencies": {
-    "@remnic/core": "workspace:^",
-    "@remnic/plugin-openclaw": "workspace:^"
+    "@remnic/plugin-openclaw": "^1.0.6",
+    "@remnic/core": "^1.0.3"
   },
   "peerDependencies": {
     "openclaw": ">=2026.4.8"
@@ -61,5 +54,10 @@
     "memory",
     "compatibility",
     "shim"
-  ]
-}
+  ],
+  "scripts": {
+    "build": "node ./scripts/sync-openclaw-plugin.mjs && tsup --config tsup.config.ts",
+    "check-types": "tsc --noEmit",
+    "postinstall": "node ./scripts/postinstall-banner.mjs"
+  }
+}