@joshuaswarren/openclaw-engram 9.0.105 → 9.0.107

package/README.md

@@ -207,6 +207,7 @@ Start with zero config. Enable features as your needs grow:
 | **+ Capture control** | `implicit`, `explicit`, or `hybrid` capture modes for memory write policy |
 | **+ Memory OS** | Memory boxes, graph reasoning, compounding, shared context, identity continuity |
 | **+ LCM** | Lossless Context Management — never lose conversation context to compaction |
+| **+ Parallel retrieval** | Three specialized agents (DirectFact, Contextual, Temporal) run in parallel — same latency, broader coverage |
 | **+ Advanced** | Trust zones, causal trajectories, harmonic retrieval, evaluation harness, poisoning defense |
 
 Use a preset to jump to a recommended level: `conservative`, `balanced`, `research-max`, or `local-llm-heavy`.
@@ -298,6 +299,41 @@ Enable it in your `openclaw.json`:
 
 See the [LCM Guide](docs/guides/lossless-context-management.md) for architecture details, configuration options, and how it complements native compaction.
 
+### Parallel Specialized Retrieval (opt-in)
+
+Engram's default retrieval runs a single hybrid search pass. Parallel Specialized Retrieval (inspired by [Supermemory's ASMR technique](https://blog.supermemory.ai/we-broke-the-frontier-in-agent-memory-introducing-99-sota-memory-system/)) runs three specialized agents in parallel so total latency equals `max(agents)` not `sum(agents)`.
+
+| Agent | What It Does | Cost |
+|-------|-------------|------|
+| **DirectFact** | Scans entity filenames for keyword overlap with the query | File I/O only, <5ms |
+| **Contextual** | Existing hybrid BM25+vector search (unchanged) | Same as current |
+| **Temporal** | Reads the temporal date index, returns recent memories with recency decay scoring | File I/O + math, <10ms |
+
+**Zero additional LLM cost.** The DirectFact and Temporal agents reuse existing indexes with no new embeddings or inference. The Contextual agent is the same hybrid search already running.
+
+Results from all three agents are merged by path, deduplicated, and weighted (`direct=1.0×, temporal=0.85×, contextual=0.7×`) before returning the top N results. Any agent error degrades gracefully without blocking the others.
+
+Enable it in your `openclaw.json`:
+
+```jsonc
+{
+  "plugins": {
+    "entries": {
+      "openclaw-engram": {
+        "config": {
+          "parallelRetrievalEnabled": true
+          // Optional tuning:
+          // "parallelMaxResultsPerAgent": 20,
+          // "parallelAgentWeights": { "direct": 1.0, "contextual": 0.7, "temporal": 0.85 }
+        }
+      }
+    }
+  }
+}
+```
+
+Set `parallelMaxResultsPerAgent: 0` to disable an individual agent's results without disabling the feature entirely.
+
 ### Advanced (opt-in)
 
 - **Objective-State Recall** — Surfaces file/process/tool state snapshots alongside semantic memory

package/dist/access-cli.js

@@ -3,10 +3,10 @@ import {
   EngramAccessService,
   Orchestrator,
   parseConfig
-} from "./chunk-6ZL6J6ZZ.js";
-import "./chunk-LTELW5MZ.js";
+} from "./chunk-TVZ2RTQZ.js";
+import "./chunk-4E3TGUFK.js";
 import "./chunk-WSXU2GHQ.js";
-import "./chunk-H7LMMCVZ.js";
+import "./chunk-GCQN37AR.js";
 import "./chunk-BNBG2XP6.js";
 import "./chunk-AFMNQR7H.js";
 import "./chunk-V2E2ORE5.js";

package/dist/{chunk-LTELW5MZ.js → chunk-4E3TGUFK.js}

@@ -4,7 +4,7 @@ import {
   parseContinuityImprovementLoops,
   parseContinuityIncident,
   sanitizeMemoryContent
-} from "./chunk-H7LMMCVZ.js";
+} from "./chunk-GCQN37AR.js";
 import {
   log
 } from "./chunk-SSIIJJKA.js";
@@ -1837,4 +1837,4 @@ export {
   defaultTierMigrationCycleBudget,
   CompoundingEngine
 };
-//# sourceMappingURL=chunk-LTELW5MZ.js.map
+//# sourceMappingURL=chunk-4E3TGUFK.js.map

package/dist/{chunk-H7LMMCVZ.js → chunk-GCQN37AR.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-SSIIJJKA.js";
 
 // src/storage.ts
-import { access, readdir, readFile as readFile2, writeFile as writeFile2, mkdir as mkdir2, unlink, rename, appendFile } from "fs/promises";
+import { access, readdir, readFile as readFile2, stat as stat2, writeFile as writeFile2, mkdir as mkdir2, unlink, rename, appendFile } from "fs/promises";
 import { appendFileSync, mkdirSync, statSync } from "fs";
 import { createHash } from "crypto";
 import path4 from "path";
@@ -2186,15 +2186,38 @@ ${sanitized.text}
     try {
       const raw = await readFile2(filePath, "utf-8");
       const parsed = parseFrontmatter2(raw);
-      if (!parsed) return null;
-      return {
-        path: filePath,
-        frontmatter: normalizeFrontmatterForPath(
-          parsed.frontmatter,
-          toMemoryPathRel(this.baseDir, filePath)
-        ),
-        content: parsed.content
-      };
+      if (parsed) {
+        return {
+          path: filePath,
+          frontmatter: normalizeFrontmatterForPath(
+            parsed.frontmatter,
+            toMemoryPathRel(this.baseDir, filePath)
+          ),
+          content: parsed.content
+        };
+      }
+      const normalizedPath = filePath.split(path4.sep).join("/");
+      if (normalizedPath.includes("/entities/") && filePath.endsWith(".md")) {
+        const entity = parseEntityFile(raw);
+        if (!entity.name) return null;
+        const nameWithoutExt = path4.basename(filePath, ".md");
+        const fileMtime = entity.updated || await stat2(filePath).then((s) => s.mtime.toISOString()).catch(() => (/* @__PURE__ */ new Date(0)).toISOString());
+        return {
+          path: filePath,
+          frontmatter: {
+            id: nameWithoutExt,
+            category: "entity",
+            created: fileMtime,
+            updated: fileMtime,
+            source: "entity_extraction",
+            confidence: 0.9,
+            confidenceTier: confidenceTier(0.9),
+            tags: entity.type ? [entity.type] : []
+          },
+          content: raw
+        };
+      }
+      return null;
     } catch {
       return null;
     }
@@ -3888,4 +3911,4 @@ export {
   serializeEntityFile,
   StorageManager
 };
-//# sourceMappingURL=chunk-H7LMMCVZ.js.map
+//# sourceMappingURL=chunk-GCQN37AR.js.map