@joshuaswarren/openclaw-engram 9.1.5 → 9.1.7

package/README.md

@@ -266,6 +266,8 @@ These capabilities can be enabled progressively:
 - **Shared Context** — Cross-agent memory sharing for multi-agent setups
 - **Identity Continuity** — Consistent agent personality across sessions
 - **Hot/Cold Tiering** — Automatic migration of aging memories to cold storage
+- **Memory Cache** — Process-level singleton cache for `readAllMemories()` — turns 15s disk scans into <100ms cache hits, shared across all sessions
+- **Semantic Consolidation** — Finds clusters of semantically similar memories, synthesizes canonical versions via LLM, archives originals to reduce bloat
 - **Native Knowledge** — Search curated markdown (workspace docs, Obsidian vaults) without extracting into memory
 - **Behavior Loop Tuning** — Runtime self-tuning of extraction and recall parameters
 
@@ -334,6 +336,45 @@ Enable it in your `openclaw.json`:
 
 Set `parallelMaxResultsPerAgent: 0` to disable an individual agent's results without disabling the feature entirely.
 
+### Semantic Consolidation (opt-in)
+
+Over time, memory stores accumulate redundant facts — the same information extracted multiple times across sessions, expressed slightly differently. Semantic consolidation finds clusters of similar memories using token overlap, synthesizes a single canonical version via LLM, and archives the originals. This reduces storage bloat, speeds up recall, and improves memory quality.
+
+- **Conservative by default** — Only merges when 80%+ token overlap is detected across 3+ memories
+- **LLM synthesis** — Uses your configured model to combine unique information from all cluster members
+- **Safe archival** — Originals are archived (not deleted) with full provenance tracking
+- **Configurable** — Adjust threshold, cluster size, excluded categories, model, and schedule
+- **Excluded categories** — Corrections and commitments are never consolidated (configurable)
+
+Enable it in your `openclaw.json`:
+
+```jsonc
+{
+  "plugins": {
+    "entries": {
+      "openclaw-engram": {
+        "config": {
+          "semanticConsolidationEnabled": true
+          // Optional tuning:
+          // "semanticConsolidationThreshold": 0.8,    // 0.8=conservative, 0.6=aggressive
+          // "semanticConsolidationModel": "fast",      // "auto", "fast", or specific model
+          // "semanticConsolidationIntervalHours": 168, // weekly (default)
+          // "semanticConsolidationMaxPerRun": 100
+        }
+      }
+    }
+  }
+}
+```
+
+Run manually from the CLI:
+
+```bash
+openclaw engram semantic-consolidate --dry-run    # Preview what would be merged
+openclaw engram semantic-consolidate --verbose     # Run with detailed output
+openclaw engram semantic-consolidate --threshold 0.6  # Override threshold
+```
+
 ### Advanced (opt-in)
 
 - **Objective-State Recall** — Surfaces file/process/tool state snapshots alongside semantic memory
@@ -417,6 +458,11 @@ openclaw engram review-disposition <id> --status rejected  # Operator review
 openclaw engram benchmark recall   # Benchmark status and validation
 openclaw engram benchmark-ci-gate  # CI gate for regressions
 
+# Memory maintenance
+openclaw engram consolidate                  # Run standard consolidation
+openclaw engram semantic-consolidate         # Run semantic dedup consolidation
+openclaw engram semantic-consolidate --dry-run  # Preview without changes
+
 # Access layer
 openclaw engram access http-serve --token "$TOKEN"  # Start HTTP API
 openclaw engram access mcp-serve   # Start stdio MCP server
@@ -441,6 +487,9 @@ All settings live in `openclaw.json` under `plugins.entries.openclaw-engram.conf
 | `memoryDir` | `~/.openclaw/workspace/memory/local` | Memory storage root |
 | `memoryOsPreset` | unset | Quick config: `conservative`, `balanced`, `research-max`, `local-llm-heavy` |
 | `lcmEnabled` | `false` | Enable Lossless Context Management (proactive session archive + summary DAG) |
+| `semanticConsolidationEnabled` | `false` | Enable periodic semantic dedup of similar memories |
+| `semanticConsolidationThreshold` | `0.8` | Token overlap threshold (0.8=conservative, 0.6=aggressive) |
+| `semanticConsolidationModel` | `"auto"` | LLM for synthesis: `"auto"`, `"fast"`, or specific model |
 
 **[See the full config reference for all 60+ settings](docs/config-reference.md)** including search backend configuration, namespace policies, Memory OS features, governance, evaluation harness, trust zones, causal trajectories, and more.
 

package/dist/access-cli.js

@@ -3,13 +3,13 @@ import {
   EngramAccessService,
   Orchestrator,
   parseConfig
-} from "./chunk-HPTDE747.js";
-import "./chunk-BIVUV2GJ.js";
+} from "./chunk-Z6PKTPAF.js";
+import "./chunk-UO4TIAAW.js";
 import "./chunk-IMMYYNXG.js";
-import "./chunk-QX3ELIKM.js";
+import "./chunk-YKWJUR3I.js";
 import "./chunk-6KX4XLQJ.js";
+import "./chunk-XCAYYSI7.js";
 import "./chunk-MKM2BCQH.js";
-import "./chunk-V2E2ORE5.js";
 import "./chunk-DEIBZP3O.js";
 import "./chunk-SSIIJJKA.js";
 

package/dist/{calibration-LBE4XTN4.js → calibration-QBVYTFTQ.js}

@@ -1,7 +1,7 @@
 // openclaw-engram: Local-first memory plugin
 import {
   FallbackLlmClient
-} from "./chunk-V2E2ORE5.js";
+} from "./chunk-XCAYYSI7.js";
 import {
   listJsonFiles
 } from "./chunk-DEIBZP3O.js";
@@ -233,4 +233,4 @@ export {
   runCalibrationIfEnabled,
   synthesizeCalibrationRules
 };
-//# sourceMappingURL=calibration-LBE4XTN4.js.map
+//# sourceMappingURL=calibration-QBVYTFTQ.js.map

package/dist/{causal-consolidation-5VSMA2L5.js → causal-consolidation-T7EEYKPA.js}

@@ -1,4 +1,7 @@
 // openclaw-engram: Local-first memory plugin
+import {
+  FallbackLlmClient
+} from "./chunk-XCAYYSI7.js";
 import {
   readChainIndex,
   resolveChainsDir
@@ -6,9 +9,6 @@ import {
 import {
   isRecord
 } from "./chunk-MKM2BCQH.js";
-import {
-  FallbackLlmClient
-} from "./chunk-V2E2ORE5.js";
 import {
   listJsonFiles,
   readJsonFile
@@ -203,4 +203,4 @@ export {
   deriveCausalPromotionCandidates,
   synthesizeCausalPreferencesViaLlm
 };
-//# sourceMappingURL=causal-consolidation-5VSMA2L5.js.map
+//# sourceMappingURL=causal-consolidation-T7EEYKPA.js.map

package/dist/{chunk-BIVUV2GJ.js → chunk-UO4TIAAW.js}

@@ -4,7 +4,7 @@ import {
   parseContinuityImprovementLoops,
   parseContinuityIncident,
   sanitizeMemoryContent
-} from "./chunk-QX3ELIKM.js";
+} from "./chunk-YKWJUR3I.js";
 import {
   log
 } from "./chunk-SSIIJJKA.js";
@@ -830,7 +830,7 @@ var CompoundingEngine = class {
     let promotionCandidates = this.config.compoundingSemanticEnabled ? this.derivePromotionCandidates(outcomeSummary, mistakes.registry, rubrics) : [];
     if (this.config.cmcConsolidationEnabled) {
       try {
-        const { deriveCausalPromotionCandidates } = await import("./causal-consolidation-5VSMA2L5.js");
+        const { deriveCausalPromotionCandidates } = await import("./causal-consolidation-T7EEYKPA.js");
         const causalCandidates = await deriveCausalPromotionCandidates({
           memoryDir: this.config.memoryDir,
           causalTrajectoryStoreDir: this.config.causalTrajectoryStoreDir,
@@ -850,7 +850,7 @@ var CompoundingEngine = class {
     }
     if (this.config.calibrationEnabled) {
       try {
-        const { runCalibrationConsolidation } = await import("./calibration-LBE4XTN4.js");
+        const { runCalibrationConsolidation } = await import("./calibration-QBVYTFTQ.js");
         const calRules = await runCalibrationConsolidation({
           memoryDir: this.config.memoryDir,
           gatewayConfig: this.config.gatewayConfig
@@ -1837,4 +1837,4 @@ export {
   defaultTierMigrationCycleBudget,
   CompoundingEngine
 };
-//# sourceMappingURL=chunk-BIVUV2GJ.js.map
+//# sourceMappingURL=chunk-UO4TIAAW.js.map

package/dist/{chunk-V2E2ORE5.js → chunk-XCAYYSI7.js}

@@ -362,4 +362,4 @@ export {
   buildChatCompletionTokenLimit,
   FallbackLlmClient
 };
-//# sourceMappingURL=chunk-V2E2ORE5.js.map
+//# sourceMappingURL=chunk-XCAYYSI7.js.map

package/dist/{chunk-QX3ELIKM.js → chunk-YKWJUR3I.js}

@@ -4007,4 +4007,4 @@ export {
   serializeEntityFile,
   StorageManager
 };
-//# sourceMappingURL=chunk-QX3ELIKM.js.map
+//# sourceMappingURL=chunk-YKWJUR3I.js.map