@joshuaswarren/openclaw-engram 8.0.1 → 8.0.2

package/dist/index.js

@@ -366,7 +366,9 @@ function parseConfig(raw) {
     traceWeaverEnabled: cfg.traceWeaverEnabled === true,
     traceWeaverLookbackDays: typeof cfg.traceWeaverLookbackDays === "number" ? cfg.traceWeaverLookbackDays : 7,
     traceWeaverOverlapThreshold: typeof cfg.traceWeaverOverlapThreshold === "number" ? cfg.traceWeaverOverlapThreshold : 0.4,
-    boxRecallDays: typeof cfg.boxRecallDays === "number" ? cfg.boxRecallDays : 3
+    boxRecallDays: typeof cfg.boxRecallDays === "number" ? cfg.boxRecallDays : 3,
+    // v8.0 Phase 2B: Episode/Note dual store (HiMem)
+    episodeNoteModeEnabled: cfg.episodeNoteModeEnabled === true
   };
 }
 
@@ -4141,6 +4143,7 @@ function serializeFrontmatter(fm) {
   if (fm.artifactType) lines.push(`artifactType: ${fm.artifactType}`);
   if (fm.sourceMemoryId) lines.push(`sourceMemoryId: ${fm.sourceMemoryId}`);
   if (fm.sourceTurnId) lines.push(`sourceTurnId: ${fm.sourceTurnId}`);
+  if (fm.memoryKind) lines.push(`memoryKind: ${fm.memoryKind}`);
   lines.push("---");
   return lines.join("\n");
 }
@@ -4229,7 +4232,9 @@ function parseFrontmatter(raw) {
       intentEntityTypes: intentEntityTypes && intentEntityTypes.length > 0 ? intentEntityTypes : void 0,
       artifactType: fm.artifactType || void 0,
       sourceMemoryId: fm.sourceMemoryId || void 0,
-      sourceTurnId: fm.sourceTurnId || void 0
+      sourceTurnId: fm.sourceTurnId || void 0,
+      // v8.0 Phase 2B: HiMem episode/note classification
+      memoryKind: fm.memoryKind || void 0
     },
     content
   };
@@ -4585,7 +4590,8 @@ var StorageManager = class _StorageManager {
       intentEntityTypes: options.intentEntityTypes,
       artifactType: options.artifactType,
       sourceMemoryId: options.sourceMemoryId,
-      sourceTurnId: options.sourceTurnId
+      sourceTurnId: options.sourceTurnId,
+      memoryKind: options.memoryKind
     };
     const sanitized = sanitizeMemoryContent(content);
     if (!sanitized.clean) {
@@ -5588,7 +5594,8 @@ ${memory.content}
       chunkTotal,
       intentGoal: options.intentGoal,
       intentActionType: options.intentActionType,
-      intentEntityTypes: options.intentEntityTypes
+      intentEntityTypes: options.intentEntityTypes,
+      memoryKind: options.memoryKind
     };
     const sanitized = sanitizeMemoryContent(content);
     if (!sanitized.clean) {
@@ -8283,6 +8290,94 @@ var BoxBuilder = class {
   }
 };
 
+// src/himem.ts
+var NOTE_SIGNALS = [
+  /\bprefer(?:red|s|ring)?\b/i,
+  /\bwant(?:ed|s|ing)?\b/i,
+  /\bneed(?:ed|s|ing)?\b/i,
+  /\balways\b/i,
+  /\bnever\b/i,
+  /\bmust\b/i,
+  /\bshould\b/i,
+  /\bgoals?\b/i,
+  /\bdecid(?:ed|es|e|ing)\b/i,
+  /\bpolic(?:y|ies)\b/i,
+  /\brequir(?:ed|es?|ements?|ing)\b/i,
+  /\bconstraints?\b/i,
+  /\bstandards?\b/i,
+  /\bconventions?\b/i
+];
+var TEMPORAL_SIGNALS = [
+  /\byesterday\b/i,
+  /\btoday\b/i,
+  /\blast\s+(?:week|month|year|Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday)\b/i,
+  /\bon\s+(?:Monday|Tuesday|Wednesday|Thursday|Friday|Saturday|Sunday)\b/i,
+  /\b(?:recently|earlier|this morning|this afternoon)\b/i
+];
+var VERB_EPISODE_SIGNALS = [
+  /\bdeployed\b/i,
+  /\bpushed\b/i,
+  /\bfixed\b/i,
+  /\bmerged\b/i,
+  /\breported\b/i,
+  /\bmentioned\b/i,
+  /\bsaid\b/i,
+  /\bhappened\b/i,
+  /\bfailed\b/i,
+  /\bcompleted\b/i,
+  /\bshipped\b/i
+];
+var NOTE_CATEGORIES = /* @__PURE__ */ new Set([
+  "preference",
+  "constraint",
+  "goal",
+  "habit",
+  "policy",
+  "standard",
+  "belief",
+  "decision",
+  "principle",
+  // durable operating rules emitted by extraction
+  "commitment",
+  // deadlines/promises — stable obligations
+  "relationship",
+  // durable facts about people/entities
+  "skill",
+  // capabilities — stable knowledge
+  "correction",
+  // user corrections — durable override of prior belief
+  "entity"
+  // stable facts about people, projects, tools, etc.
+]);
+var EPISODE_CATEGORIES = /* @__PURE__ */ new Set(["event", "action", "observation", "issue", "bug", "incident", "moment"]);
+var NOTE_TAGS = /* @__PURE__ */ new Set(["preference", "constraint", "goal", "habit", "policy", "belief"]);
+var EPISODE_TAGS = /* @__PURE__ */ new Set(["bug", "fix", "deploy", "incident", "release", "merge", "event"]);
+function classifyMemoryKind(content, tags, category) {
+  const lowerContent = content.toLowerCase();
+  const lowerCategory = category.toLowerCase();
+  for (const re of TEMPORAL_SIGNALS) {
+    if (re.test(lowerContent)) return "episode";
+  }
+  if (NOTE_CATEGORIES.has(lowerCategory)) return "note";
+  if (EPISODE_CATEGORIES.has(lowerCategory)) return "episode";
+  let tagMatchesNote = false;
+  let tagMatchesEpisode = false;
+  for (const tag of tags) {
+    const lowerTag = tag.toLowerCase();
+    if (NOTE_TAGS.has(lowerTag)) tagMatchesNote = true;
+    if (EPISODE_TAGS.has(lowerTag)) tagMatchesEpisode = true;
+  }
+  if (tagMatchesNote) return "note";
+  if (tagMatchesEpisode) return "episode";
+  for (const re of VERB_EPISODE_SIGNALS) {
+    if (re.test(lowerContent)) return "episode";
+  }
+  for (const re of NOTE_SIGNALS) {
+    if (re.test(lowerContent)) return "note";
+  }
+  return "episode";
+}
+
 // src/conversation-index/chunker.ts
 function chunkTranscriptEntries(sessionKey, entries, opts) {
   const maxChars = Math.max(500, opts.maxChars);
@@ -10099,6 +10194,7 @@ _Context: ${topQuestion.context}_`);
       if (this.config.chunkingEnabled) {
         const chunkResult = chunkContent(fact.content, chunkingConfig);
         if (chunkResult.chunked && chunkResult.chunks.length > 1) {
+          const memoryKind2 = this.config.episodeNoteModeEnabled ? classifyMemoryKind(fact.content, fact.tags ?? [], fact.category) : void 0;
           const parentId = await storage.writeMemory(fact.category, fact.content, {
             confidence: fact.confidence,
             tags: [...fact.tags, "chunked"],
@@ -10107,7 +10203,8 @@ _Context: ${topQuestion.context}_`);
             importance,
             intentGoal: inferredIntent?.goal,
             intentActionType: inferredIntent?.actionType,
-            intentEntityTypes: inferredIntent?.entityTypes
+            intentEntityTypes: inferredIntent?.entityTypes,
+            memoryKind: memoryKind2
           });
           for (const chunk of chunkResult.chunks) {
             const chunkImportance = scoreImportance(chunk.content, fact.category, fact.tags);
@@ -10125,7 +10222,8 @@ _Context: ${topQuestion.context}_`);
                 importance: chunkImportance,
                 intentGoal: inferredIntent?.goal,
                 intentActionType: inferredIntent?.actionType,
-                intentEntityTypes: inferredIntent?.entityTypes
+                intentEntityTypes: inferredIntent?.entityTypes,
+                memoryKind: memoryKind2
               }
             );
           }
@@ -10172,6 +10270,7 @@ _Context: ${topQuestion.context}_`);
           links.push(...suggestedLinks);
         }
       }
+      const memoryKind = this.config.episodeNoteModeEnabled ? classifyMemoryKind(fact.content, fact.tags ?? [], fact.category) : void 0;
       const memoryId = await storage.writeMemory(fact.category, fact.content, {
         confidence: fact.confidence,
         tags: fact.tags,
@@ -10182,7 +10281,8 @@ _Context: ${topQuestion.context}_`);
         links: links.length > 0 ? links : void 0,
         intentGoal: inferredIntent?.goal,
         intentActionType: inferredIntent?.actionType,
-        intentEntityTypes: inferredIntent?.entityTypes
+        intentEntityTypes: inferredIntent?.entityTypes,
+        memoryKind
       });
       persistedIds.push(memoryId);
       await this.indexPersistedMemory(storage, memoryId);