@joshuaswarren/openclaw-engram 9.0.8 → 9.0.10

package/dist/index.js

@@ -74,7 +74,8 @@ var VALID_MEMORY_CATEGORIES = /* @__PURE__ */ new Set([
   "principle",
   "commitment",
   "moment",
-  "skill"
+  "skill",
+  "rule"
 ]);
 var DEFAULT_BEHAVIOR_LOOP_PROTECTED_PARAMS = [
   "maxMemoryTokens",
@@ -472,6 +473,7 @@ function parseConfig(raw) {
     delinearizeEnabled: cfg.delinearizeEnabled !== false,
     recallConfidenceGateEnabled: cfg.recallConfidenceGateEnabled === true,
     recallConfidenceGateThreshold: typeof cfg.recallConfidenceGateThreshold === "number" ? Math.max(0, Math.min(1, cfg.recallConfidenceGateThreshold)) : 0.12,
+    causalRuleExtractionEnabled: cfg.causalRuleExtractionEnabled === true,
     graphLateralInhibitionEnabled: cfg.graphLateralInhibitionEnabled !== false,
     graphLateralInhibitionBeta: typeof cfg.graphLateralInhibitionBeta === "number" ? Math.max(0, Math.min(1, cfg.graphLateralInhibitionBeta)) : 0.15,
     graphLateralInhibitionTopM: typeof cfg.graphLateralInhibitionTopM === "number" ? Math.max(0, Math.round(cfg.graphLateralInhibitionTopM)) : 7,
@@ -1904,7 +1906,7 @@ function parseMemoryActionEligibilityContext(value) {
   };
 }
 var ExtractedFactSchema = z.object({
-  category: z.enum(["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill"]),
+  category: z.enum(["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule"]),
   content: z.string().describe("The memory content \u2014 a clear, standalone statement"),
   confidence: z.number().min(0).max(1).describe("How confident are you this is correct (0-1)"),
   tags: z.array(z.string()).describe("Relevant tags for categorization"),
@@ -2936,12 +2938,13 @@ Memory categories:
 - principle: Durable rules, values, or operating beliefs (e.g., "never use Chat Completions API")
 - commitment: Promises, obligations, or deadlines (e.g., "deploy by Friday", "call accountant Monday")
 - moment: Emotionally significant events or milestones (e.g., "first successful deployment of engram")
-- skill: Capabilities the user or agent has demonstrated (e.g., "user is proficient with Kubernetes")
+- skill: Capabilities the user or agent has demonstrated (e.g., "user is proficient with Kubernetes")${this.config.causalRuleExtractionEnabled ? `
+- rule: Causal rules discovered through experience (format: "IF <condition> THEN <action/outcome>", e.g., "IF Shopify API returns 401 THEN the admin token is missing read_products scope")` : ""}
 
 Rules:
 - Only extract genuinely NEW information worth remembering across sessions
 - Skip transient task details (file paths being edited, current errors, etc.)
-- Priority: corrections > principles > preferences > commitments > decisions > relationships > entities > moments > skills > facts
+- Priority: corrections > principles${this.config.causalRuleExtractionEnabled ? " > rules" : ""} > preferences > commitments > decisions > relationships > entities > moments > skills > facts
 - Corrections (user saying "actually, don't do X" or "I prefer Y") get highest confidence
 - Each fact should be a standalone, self-contained statement
 - Entity references should use normalized names (lowercase, hyphenated: "jane-doe", "acme-corp")
@@ -3034,7 +3037,8 @@ Actions:
 
 Also:
 - Suggest profile updates based on patterns across memories
-- Identify entity updates for entity tracking`
+- Identify entity updates for entity tracking${this.config.causalRuleExtractionEnabled ? `
+- When merging or updating memories, look for IF\u2192THEN causal patterns. If a memory describes "X failed/succeeded because Y" or "doing X led to Y", rewrite its content to make the causal rule explicit in the form "IF <condition> THEN <action/outcome>".` : ""}`
         },
         {
           role: "user",
@@ -3080,7 +3084,8 @@ Actions:
 
 Also:
 - Suggest profile updates based on patterns across memories
-- Identify entity updates for entity tracking
+- Identify entity updates for entity tracking${this.config.causalRuleExtractionEnabled ? `
+- When merging or updating memories, look for IF\u2192THEN causal patterns. If a memory describes "X failed/succeeded because Y" or "doing X led to Y", rewrite its content to make the causal rule explicit in the form "IF <condition> THEN <action/outcome>".` : ""}
 
 Current behavioral profile:
 ${currentProfile || "(empty)"}
@@ -3198,7 +3203,8 @@ Actions:
 
 Also:
 - Suggest profile updates based on patterns across memories
-- Identify entity updates for entity tracking
+- Identify entity updates for entity tracking${this.config.causalRuleExtractionEnabled ? `
+- When merging or updating memories, look for IF\u2192THEN causal patterns. If a memory describes "X failed/succeeded because Y" or "doing X led to Y", rewrite its content to make the causal rule explicit in the form "IF <condition> THEN <action/outcome>".` : ""}
 
 Current behavioral profile:
 ${currentProfile || "(empty)"}
@@ -3927,6 +3933,8 @@ var CATEGORY_BOOSTS = {
   // Corrections are always important
   principle: 0.12,
   // Durable rules/values
+  rule: 0.11,
+  // Causal IF→THEN rules
   preference: 0.1,
   // User preferences matter
   commitment: 0.1,
@@ -12528,6 +12536,9 @@ function serializeBoxFrontmatter(fm) {
   ];
   if (fm.sessionKey) lines.push(`sessionKey: ${fm.sessionKey}`);
   if (fm.traceId) lines.push(`traceId: ${fm.traceId}`);
+  if (fm.goal) lines.push(`goal: ${fm.goal.replace(/[\r\n]+/g, " ")}`);
+  if (fm.toolsUsed?.length) lines.push(`toolsUsed: [${fm.toolsUsed.map((t) => `"${t}"`).join(", ")}]`);
+  if (fm.outcome) lines.push(`outcome: ${fm.outcome}`);
   lines.push("---");
   return lines.join("\n");
 }
@@ -12547,6 +12558,7 @@ function parseBoxFrontmatter(raw) {
     if (!m) return [];
     return m[1].split(",").map((s) => s.trim().replace(/^"|"$/g, "")).filter(Boolean);
   };
+  const outcome = fm.outcome;
   return {
     id: fm.id ?? "",
     memoryKind: "box",
@@ -12556,7 +12568,10 @@ function parseBoxFrontmatter(raw) {
     sessionKey: fm.sessionKey,
     topics: parseArray(fm.topics),
     memoryIds: parseArray(fm.memoryIds),
-    traceId: fm.traceId
+    traceId: fm.traceId,
+    goal: fm.goal || void 0,
+    toolsUsed: fm.toolsUsed ? parseArray(fm.toolsUsed) : void 0,
+    outcome: outcome && ["success", "failure", "partial", "unknown"].includes(outcome) ? outcome : void 0
   };
 }
 var BoxBuilder = class {
@@ -12642,6 +12657,10 @@ var BoxBuilder = class {
         const topicSet = /* @__PURE__ */ new Set([...this.openBox.topics, ...newTopics]);
         this.openBox.topics = [...topicSet];
         this.openBox.memoryIds.push(...event.memoryIds);
+        if (event.toolsUsed?.length) {
+          const toolSet = /* @__PURE__ */ new Set([...this.openBox.toolsUsed ?? [], ...event.toolsUsed]);
+          this.openBox.toolsUsed = [...toolSet];
+        }
         await this.sealCurrent("max_memories");
       } else if (topicShifted) {
         await this.sealCurrent("topic_shift");
@@ -12656,6 +12675,10 @@ var BoxBuilder = class {
         const topicSet = /* @__PURE__ */ new Set([...this.openBox.topics, ...newTopics]);
         this.openBox.topics = [...topicSet];
         this.openBox.lastActivityAt = now.toISOString();
+        if (event.toolsUsed?.length) {
+          const toolSet = /* @__PURE__ */ new Set([...this.openBox.toolsUsed ?? [], ...event.toolsUsed]);
+          this.openBox.toolsUsed = [...toolSet];
+        }
         await this.saveOpenBox();
       }
     } else {
@@ -12673,7 +12696,9 @@ var BoxBuilder = class {
       createdAt: ts,
       lastActivityAt: ts,
       topics: event.topics.filter(Boolean),
-      memoryIds: [...event.memoryIds]
+      memoryIds: [...event.memoryIds],
+      goal: event.goal,
+      toolsUsed: event.toolsUsed?.length ? [...event.toolsUsed] : void 0
     };
   }
   /**
@@ -12705,7 +12730,10 @@ var BoxBuilder = class {
       sealReason: reason,
       topics: box.topics,
       memoryIds: box.memoryIds,
-      traceId
+      traceId,
+      goal: box.goal,
+      toolsUsed: box.toolsUsed?.length ? box.toolsUsed : void 0,
+      outcome: "unknown"
     };
     const content = `${serializeBoxFrontmatter(fm)}
 
@@ -15462,7 +15490,8 @@ var DEFAULT_CATEGORIES = [
   "principle",
   "commitment",
   "moment",
-  "skill"
+  "skill",
+  "rule"
 ];
 function normalizeNamespace(namespace) {
   return namespace.trim();
@@ -18378,10 +18407,13 @@ _Context: ${topQuestion.context}_`
     await clearBuffer();
     if (this.config.memoryBoxesEnabled && persistedIds.length > 0) {
       const extractionTopics = deriveTopicsFromExtraction(result);
+      const firstUserTurn = turns.find((t) => t.role === "user");
+      const boxGoal = firstUserTurn?.content?.slice(0, 100)?.trim() || void 0;
       await this.boxBuilderFor(storage).onExtraction({
         topics: extractionTopics,
         memoryIds: persistedIds,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        goal: boxGoal
       }).catch((err) => log.warn("[boxes] onExtraction failed (non-fatal)", err));
     }
     if (this.config.threadingEnabled && threadIdForExtraction && persistedIds.length > 0) {
@@ -21991,8 +22023,8 @@ Best for:
         ),
         category: Type.Optional(
           Type.String({
-            description: 'Category: "fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill" (default: "fact")',
-            enum: ["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill"]
+            description: 'Category: "fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule" (default: "fact")',
+            enum: ["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule"]
           })
         ),
         tags: Type.Optional(