@mnemoai/core 1.1.0 → 1.1.1

package/{src/self-improvement-files.ts → dist/src/self-improvement-files.js}

@@ -1,30 +1,24 @@
-// SPDX-License-Identifier: LicenseRef-Mnemo-Pro
 import { appendFile, mkdir, readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-
-export const DEFAULT_LEARNINGS_TEMPLATE = `# Learnings
+const DEFAULT_LEARNINGS_TEMPLATE = `# Learnings
 
 Append structured entries:
 - LRN-YYYYMMDD-XXX for corrections / best practices / knowledge gaps
 - Include summary, details, suggested action, metadata, and status`;
-
-export const DEFAULT_ERRORS_TEMPLATE = `# Errors
+const DEFAULT_ERRORS_TEMPLATE = `# Errors
 
 Append structured entries:
 - ERR-YYYYMMDD-XXX for command/tool/integration failures
 - Include symptom, context, probable cause, and prevention`;
-
-const fileWriteQueues = new Map<string, Promise<void>>();
-
-async function withFileWriteQueue<T>(filePath: string, action: () => Promise<T>): Promise<T> {
+const fileWriteQueues = /* @__PURE__ */ new Map();
+async function withFileWriteQueue(filePath, action) {
   const previous = fileWriteQueues.get(filePath) ?? Promise.resolve();
-  let release: (() => void) | undefined;
-  const lock = new Promise<void>((resolve) => {
+  let release;
+  const lock = new Promise((resolve) => {
     release = resolve;
   });
   const next = previous.then(() => lock);
   fileWriteQueues.set(filePath, next);
-
   await previous;
   try {
     return await action();
@@ -35,12 +29,10 @@ async function withFileWriteQueue<T>(filePath: string, action: () => Promise<T>)
     }
   }
 }
-
-function todayYmd(): string {
-  return new Date().toISOString().slice(0, 10).replace(/-/g, "");
+function todayYmd() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10).replace(/-/g, "");
 }
-
-async function nextLearningId(filePath: string, prefix: "LRN" | "ERR"): Promise<string> {
+async function nextLearningId(filePath, prefix) {
   const date = todayYmd();
   let count = 0;
   try {
@@ -48,46 +40,25 @@ async function nextLearningId(filePath: string, prefix: "LRN" | "ERR"): Promise<
     const matches = content.match(new RegExp(`\\[${prefix}-${date}-\\d{3}\\]`, "g"));
     count = matches?.length ?? 0;
   } catch {
-    // ignore
   }
   return `${prefix}-${date}-${String(count + 1).padStart(3, "0")}`;
 }
-
-export async function ensureSelfImprovementLearningFiles(baseDir: string): Promise<void> {
+async function ensureSelfImprovementLearningFiles(baseDir) {
   const learningsDir = join(baseDir, ".learnings");
   await mkdir(learningsDir, { recursive: true });
-
-  const ensureFile = async (filePath: string, content: string) => {
+  const ensureFile = async (filePath, content) => {
     try {
       const existing = await readFile(filePath, "utf-8");
       if (existing.trim().length > 0) return;
     } catch {
-      // write default below
     }
-    await writeFile(filePath, `${content.trim()}\n`, "utf-8");
+    await writeFile(filePath, `${content.trim()}
+`, "utf-8");
   };
-
   await ensureFile(join(learningsDir, "LEARNINGS.md"), DEFAULT_LEARNINGS_TEMPLATE);
   await ensureFile(join(learningsDir, "ERRORS.md"), DEFAULT_ERRORS_TEMPLATE);
 }
-
-export interface AppendSelfImprovementEntryParams {
-  baseDir: string;
-  type: "learning" | "error";
-  summary: string;
-  details?: string;
-  suggestedAction?: string;
-  category?: string;
-  area?: string;
-  priority?: string;
-  status?: string;
-  source?: string;
-}
-
-export async function appendSelfImprovementEntry(params: AppendSelfImprovementEntryParams): Promise<{
-  id: string;
-  filePath: string;
-}> {
+async function appendSelfImprovementEntry(params) {
   const {
     baseDir,
     type,
@@ -98,18 +69,16 @@ export async function appendSelfImprovementEntry(params: AppendSelfImprovementEn
     area = "config",
     priority = "medium",
     status = "pending",
-    source = "mnemo/self_improvement_log",
+    source = "mnemo/self_improvement_log"
   } = params;
-
   await ensureSelfImprovementLearningFiles(baseDir);
   const learningsDir = join(baseDir, ".learnings");
   const fileName = type === "learning" ? "LEARNINGS.md" : "ERRORS.md";
   const filePath = join(learningsDir, fileName);
   const idPrefix = type === "learning" ? "LRN" : "ERR";
-
   const id = await withFileWriteQueue(filePath, async () => {
     const entryId = await nextLearningId(filePath, idPrefix);
-    const nowIso = new Date().toISOString();
+    const nowIso = (/* @__PURE__ */ new Date()).toISOString();
     const titleSuffix = type === "learning" ? ` ${category}` : "";
     const entry = [
       `## [${entryId}]${titleSuffix}`,
@@ -131,13 +100,19 @@ export async function appendSelfImprovementEntry(params: AppendSelfImprovementEn
       "### Metadata",
       `- Source: ${source}`,
       "---",
-      "",
+      ""
     ].join("\n");
     const prev = await readFile(filePath, "utf-8").catch(() => "");
     const separator = prev.trimEnd().length > 0 ? "\n\n" : "";
     await appendFile(filePath, `${separator}${entry}`, "utf-8");
     return entryId;
   });
-
   return { id, filePath };
 }
+export {
+  DEFAULT_ERRORS_TEMPLATE,
+  DEFAULT_LEARNINGS_TEMPLATE,
+  appendSelfImprovementEntry,
+  ensureSelfImprovementLearningFiles
+};
+//# sourceMappingURL=self-improvement-files.js.map

package/dist/src/self-improvement-files.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/self-improvement-files.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\nimport { appendFile, mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\nexport const DEFAULT_LEARNINGS_TEMPLATE = `# Learnings\n\nAppend structured entries:\n- LRN-YYYYMMDD-XXX for corrections / best practices / knowledge gaps\n- Include summary, details, suggested action, metadata, and status`;\n\nexport const DEFAULT_ERRORS_TEMPLATE = `# Errors\n\nAppend structured entries:\n- ERR-YYYYMMDD-XXX for command/tool/integration failures\n- Include symptom, context, probable cause, and prevention`;\n\nconst fileWriteQueues = new Map<string, Promise<void>>();\n\nasync function withFileWriteQueue<T>(filePath: string, action: () => Promise<T>): Promise<T> {\n  const previous = fileWriteQueues.get(filePath) ?? Promise.resolve();\n  let release: (() => void) | undefined;\n  const lock = new Promise<void>((resolve) => {\n    release = resolve;\n  });\n  const next = previous.then(() => lock);\n  fileWriteQueues.set(filePath, next);\n\n  await previous;\n  try {\n    return await action();\n  } finally {\n    release?.();\n    if (fileWriteQueues.get(filePath) === next) {\n      fileWriteQueues.delete(filePath);\n    }\n  }\n}\n\nfunction todayYmd(): string {\n  return new Date().toISOString().slice(0, 10).replace(/-/g, \"\");\n}\n\nasync function nextLearningId(filePath: string, prefix: \"LRN\" | \"ERR\"): Promise<string> {\n  const date = todayYmd();\n  let count = 0;\n  try {\n    const content = await readFile(filePath, \"utf-8\");\n    const matches = content.match(new RegExp(`\\\\[${prefix}-${date}-\\\\d{3}\\\\]`, \"g\"));\n    count = matches?.length ?? 0;\n  } catch {\n    // ignore\n  }\n  return `${prefix}-${date}-${String(count + 1).padStart(3, \"0\")}`;\n}\n\nexport async function ensureSelfImprovementLearningFiles(baseDir: string): Promise<void> {\n  const learningsDir = join(baseDir, \".learnings\");\n  await mkdir(learningsDir, { recursive: true });\n\n  const ensureFile = async (filePath: string, content: string) => {\n    try {\n      const existing = await readFile(filePath, \"utf-8\");\n      if (existing.trim().length > 0) return;\n    } catch {\n      // write default below\n    }\n    await writeFile(filePath, `${content.trim()}\\n`, \"utf-8\");\n  };\n\n  await ensureFile(join(learningsDir, \"LEARNINGS.md\"), DEFAULT_LEARNINGS_TEMPLATE);\n  await ensureFile(join(learningsDir, \"ERRORS.md\"), DEFAULT_ERRORS_TEMPLATE);\n}\n\nexport interface AppendSelfImprovementEntryParams {\n  baseDir: string;\n  type: \"learning\" | \"error\";\n  summary: string;\n  details?: string;\n  suggestedAction?: string;\n  category?: string;\n  area?: string;\n  priority?: string;\n  status?: string;\n  source?: string;\n}\n\nexport async function appendSelfImprovementEntry(params: AppendSelfImprovementEntryParams): Promise<{\n  id: string;\n  filePath: string;\n}> {\n  const {\n    baseDir,\n    type,\n    summary,\n    details = \"\",\n    suggestedAction = \"\",\n    category = \"best_practice\",\n    area = \"config\",\n    priority = \"medium\",\n    status = \"pending\",\n    source = \"mnemo/self_improvement_log\",\n  } = params;\n\n  await ensureSelfImprovementLearningFiles(baseDir);\n  const learningsDir = join(baseDir, \".learnings\");\n  const fileName = type === \"learning\" ? \"LEARNINGS.md\" : \"ERRORS.md\";\n  const filePath = join(learningsDir, fileName);\n  const idPrefix = type === \"learning\" ? \"LRN\" : \"ERR\";\n\n  const id = await withFileWriteQueue(filePath, async () => {\n    const entryId = await nextLearningId(filePath, idPrefix);\n    const nowIso = new Date().toISOString();\n    const titleSuffix = type === \"learning\" ? ` ${category}` : \"\";\n    const entry = [\n      `## [${entryId}]${titleSuffix}`,\n      \"\",\n      `**Logged**: ${nowIso}`,\n      `**Priority**: ${priority}`,\n      `**Status**: ${status}`,\n      `**Area**: ${area}`,\n      \"\",\n      \"### Summary\",\n      summary.trim(),\n      \"\",\n      \"### Details\",\n      details.trim() || \"-\",\n      \"\",\n      \"### Suggested Action\",\n      suggestedAction.trim() || \"-\",\n      \"\",\n      \"### Metadata\",\n      `- Source: ${source}`,\n      \"---\",\n      \"\",\n    ].join(\"\\n\");\n    const prev = await readFile(filePath, \"utf-8\").catch(() => \"\");\n    const separator = prev.trimEnd().length > 0 ? \"\\n\\n\" : \"\";\n    await appendFile(filePath, `${separator}${entry}`, \"utf-8\");\n    return entryId;\n  });\n\n  return { id, filePath };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/semantic-gate.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Semantic Noise Gate
+ *
+ * Pre-filters memory candidates by checking their embedding similarity against
+ * domain-relevant anchor texts. Fragments that are too far from any anchor are
+ * rejected as noise before reaching the dedup or store pipeline.
+ */
+import type { Embedder } from "./embedder.js";
+export declare class SemanticGate {
+    private readonly embedder;
+    private anchorEmbeddings;
+    private initPromise;
+    private readonly threshold;
+    constructor(embedder: Embedder, threshold?: number);
+    private ensureInitialized;
+    private computeAnchors;
+    /**
+     * Check whether a memory vector passes the semantic gate.
+     * Returns true if the memory is relevant enough to persist.
+     */
+    shouldPass(vector: number[], text: string): Promise<boolean>;
+    private logFiltered;
+}
+//# sourceMappingURL=semantic-gate.d.ts.map

package/dist/src/semantic-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-gate.d.ts","sourceRoot":"","sources":["../../src/semantic-gate.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAuC9C,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,gBAAgB,CAA2B;IACnD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAGhB,QAAQ,EAAE,QAAQ,EACnC,SAAS,SAAO;YAKJ,iBAAiB;YAWjB,cAAc;IAS5B;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YA2BpD,WAAW;CAS1B"}

package/dist/src/semantic-gate.js

@@ -0,0 +1,86 @@
+import { appendFile, mkdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+const ANCHOR_TEXTS = [
+  "\u6295\u8D44\u51B3\u7B56 \u4F30\u503C\u5206\u6790 \u6301\u4ED3\u7BA1\u7406 \u5C3D\u804C\u8C03\u67E5",
+  "\u4E2A\u4EBA\u504F\u597D \u65E5\u5E38\u4E60\u60EF \u4EBA\u9645\u5173\u7CFB \u751F\u6D3B\u65B9\u5F0F",
+  "\u6280\u672F\u67B6\u6784 \u7CFB\u7EDF\u8BBE\u8BA1 \u4EE3\u7801\u5B9E\u73B0 \u5DE5\u7A0B\u4F18\u5316"
+];
+function cosineSimilarity(a, b) {
+  if (a.length !== b.length || a.length === 0) return 0;
+  let dot = 0;
+  let normA = 0;
+  let normB = 0;
+  for (let i = 0; i < a.length; i++) {
+    dot += a[i] * b[i];
+    normA += a[i] * a[i];
+    normB += b[i] * b[i];
+  }
+  const denom = Math.sqrt(normA) * Math.sqrt(normB);
+  return denom === 0 ? 0 : dot / denom;
+}
+const FILTER_LOG_PATH = join(homedir(), ".openclaw", "memory", "store-filtered.log");
+class SemanticGate {
+  constructor(embedder, threshold = 0.2) {
+    this.embedder = embedder;
+    this.threshold = threshold;
+  }
+  anchorEmbeddings = null;
+  initPromise = null;
+  threshold;
+  async ensureInitialized() {
+    if (this.anchorEmbeddings) return;
+    if (this.initPromise) return this.initPromise;
+    this.initPromise = this.computeAnchors().catch((err) => {
+      this.initPromise = null;
+      throw err;
+    });
+    return this.initPromise;
+  }
+  async computeAnchors() {
+    const embeddings = [];
+    for (const text of ANCHOR_TEXTS) {
+      const vec = await this.embedder.embed(text);
+      embeddings.push(vec);
+    }
+    this.anchorEmbeddings = embeddings;
+  }
+  /**
+   * Check whether a memory vector passes the semantic gate.
+   * Returns true if the memory is relevant enough to persist.
+   */
+  async shouldPass(vector, text) {
+    try {
+      await this.ensureInitialized();
+    } catch {
+      return true;
+    }
+    if (!this.anchorEmbeddings || this.anchorEmbeddings.length === 0) {
+      return true;
+    }
+    let maxSim = 0;
+    for (const anchor of this.anchorEmbeddings) {
+      const sim = cosineSimilarity(vector, anchor);
+      if (sim > maxSim) maxSim = sim;
+    }
+    if (maxSim < this.threshold) {
+      this.logFiltered(text, maxSim).catch(() => {
+      });
+      return false;
+    }
+    return true;
+  }
+  async logFiltered(text, maxSim) {
+    try {
+      await mkdir(dirname(FILTER_LOG_PATH), { recursive: true });
+      const line = `${(/* @__PURE__ */ new Date()).toISOString()} maxSim=${maxSim.toFixed(4)} text=${text.slice(0, 200).replace(/\n/g, " ")}
+`;
+      await appendFile(FILTER_LOG_PATH, line, "utf8");
+    } catch {
+    }
+  }
+}
+export {
+  SemanticGate
+};
+//# sourceMappingURL=semantic-gate.js.map

package/dist/src/semantic-gate.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/semantic-gate.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * Semantic Noise Gate\n *\n * Pre-filters memory candidates by checking their embedding similarity against\n * domain-relevant anchor texts. Fragments that are too far from any anchor are\n * rejected as noise before reaching the dedup or store pipeline.\n */\n\nimport type { Embedder } from \"./embedder.js\";\nimport { appendFile, mkdir } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join, dirname } from \"node:path\";\n\n// ============================================================================\n// Anchor Texts\n// ============================================================================\n\nconst ANCHOR_TEXTS = [\n  \"\u6295\u8D44\u51B3\u7B56 \u4F30\u503C\u5206\u6790 \u6301\u4ED3\u7BA1\u7406 \u5C3D\u804C\u8C03\u67E5\",\n  \"\u4E2A\u4EBA\u504F\u597D \u65E5\u5E38\u4E60\u60EF \u4EBA\u9645\u5173\u7CFB \u751F\u6D3B\u65B9\u5F0F\",\n  \"\u6280\u672F\u67B6\u6784 \u7CFB\u7EDF\u8BBE\u8BA1 \u4EE3\u7801\u5B9E\u73B0 \u5DE5\u7A0B\u4F18\u5316\",\n] as const;\n\n// ============================================================================\n// Cosine Similarity\n// ============================================================================\n\nfunction cosineSimilarity(a: number[], b: number[]): number {\n  if (a.length !== b.length || a.length === 0) return 0;\n  let dot = 0;\n  let normA = 0;\n  let normB = 0;\n  for (let i = 0; i < a.length; i++) {\n    dot += a[i] * b[i];\n    normA += a[i] * a[i];\n    normB += b[i] * b[i];\n  }\n  const denom = Math.sqrt(normA) * Math.sqrt(normB);\n  return denom === 0 ? 0 : dot / denom;\n}\n\n// ============================================================================\n// Semantic Gate\n// ============================================================================\n\nconst FILTER_LOG_PATH = join(homedir(), \".openclaw\", \"memory\", \"store-filtered.log\");\n\nexport class SemanticGate {\n  private anchorEmbeddings: number[][] | null = null;\n  private initPromise: Promise<void> | null = null;\n  private readonly threshold: number;\n\n  constructor(\n    private readonly embedder: Embedder,\n    threshold = 0.20,\n  ) {\n    this.threshold = threshold;\n  }\n\n  private async ensureInitialized(): Promise<void> {\n    if (this.anchorEmbeddings) return;\n    if (this.initPromise) return this.initPromise;\n\n    this.initPromise = this.computeAnchors().catch((err) => {\n      this.initPromise = null;\n      throw err;\n    });\n    return this.initPromise;\n  }\n\n  private async computeAnchors(): Promise<void> {\n    const embeddings: number[][] = [];\n    for (const text of ANCHOR_TEXTS) {\n      const vec = await this.embedder.embed(text);\n      embeddings.push(vec);\n    }\n    this.anchorEmbeddings = embeddings;\n  }\n\n  /**\n   * Check whether a memory vector passes the semantic gate.\n   * Returns true if the memory is relevant enough to persist.\n   */\n  async shouldPass(vector: number[], text: string): Promise<boolean> {\n    try {\n      await this.ensureInitialized();\n    } catch {\n      // If anchor computation fails, pass everything through\n      return true;\n    }\n\n    if (!this.anchorEmbeddings || this.anchorEmbeddings.length === 0) {\n      return true;\n    }\n\n    let maxSim = 0;\n    for (const anchor of this.anchorEmbeddings) {\n      const sim = cosineSimilarity(vector, anchor);\n      if (sim > maxSim) maxSim = sim;\n    }\n\n    if (maxSim < this.threshold) {\n      // Log filtered content\n      this.logFiltered(text, maxSim).catch(() => {});\n      return false;\n    }\n\n    return true;\n  }\n\n  private async logFiltered(text: string, maxSim: number): Promise<void> {\n    try {\n      await mkdir(dirname(FILTER_LOG_PATH), { recursive: true });\n      const line = `${new Date().toISOString()} maxSim=${maxSim.toFixed(4)} text=${text.slice(0, 200).replace(/\\n/g, \" \")}\\n`;\n      await appendFile(FILTER_LOG_PATH, line, \"utf8\");\n    } catch {\n      // Non-critical\n    }\n  }\n}\n"],
+  "mappings": "AAUA,SAAS,YAAY,aAAa;AAClC,SAAS,eAAe;AACxB,SAAS,MAAM,eAAe;AAM9B,MAAM,eAAe;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AACF;AAMA,SAAS,iBAAiB,GAAa,GAAqB;AAC1D,MAAI,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAG,QAAO;AACpD,MAAI,MAAM;AACV,MAAI,QAAQ;AACZ,MAAI,QAAQ;AACZ,WAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK;AACjC,WAAO,EAAE,CAAC,IAAI,EAAE,CAAC;AACjB,aAAS,EAAE,CAAC,IAAI,EAAE,CAAC;AACnB,aAAS,EAAE,CAAC,IAAI,EAAE,CAAC;AAAA,EACrB;AACA,QAAM,QAAQ,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK;AAChD,SAAO,UAAU,IAAI,IAAI,MAAM;AACjC;AAMA,MAAM,kBAAkB,KAAK,QAAQ,GAAG,aAAa,UAAU,oBAAoB;AAE5E,MAAM,aAAa;AAAA,EAKxB,YACmB,UACjB,YAAY,KACZ;AAFiB;AAGjB,SAAK,YAAY;AAAA,EACnB;AAAA,EATQ,mBAAsC;AAAA,EACtC,cAAoC;AAAA,EAC3B;AAAA,EASjB,MAAc,oBAAmC;AAC/C,QAAI,KAAK,iBAAkB;AAC3B,QAAI,KAAK,YAAa,QAAO,KAAK;AAElC,SAAK,cAAc,KAAK,eAAe,EAAE,MAAM,CAAC,QAAQ;AACtD,WAAK,cAAc;AACnB,YAAM;AAAA,IACR,CAAC;AACD,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAc,iBAAgC;AAC5C,UAAM,aAAyB,CAAC;AAChC,eAAW,QAAQ,cAAc;AAC/B,YAAM,MAAM,MAAM,KAAK,SAAS,MAAM,IAAI;AAC1C,iBAAW,KAAK,GAAG;AAAA,IACrB;AACA,SAAK,mBAAmB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,WAAW,QAAkB,MAAgC;AACjE,QAAI;AACF,YAAM,KAAK,kBAAkB;AAAA,IAC/B,QAAQ;AAEN,aAAO;AAAA,IACT;AAEA,QAAI,CAAC,KAAK,oBAAoB,KAAK,iBAAiB,WAAW,GAAG;AAChE,aAAO;AAAA,IACT;AAEA,QAAI,SAAS;AACb,eAAW,UAAU,KAAK,kBAAkB;AAC1C,YAAM,MAAM,iBAAiB,QAAQ,MAAM;AAC3C,UAAI,MAAM,OAAQ,UAAS;AAAA,IAC7B;AAEA,QAAI,SAAS,KAAK,WAAW;AAE3B,WAAK,YAAY,MAAM,MAAM,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAC7C,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,YAAY,MAAc,QAA+B;AACrE,QAAI;AACF,YAAM,MAAM,QAAQ,eAAe,GAAG,EAAE,WAAW,KAAK,CAAC;AACzD,YAAM,OAAO,IAAG,oBAAI,KAAK,GAAE,YAAY,CAAC,WAAW,OAAO,QAAQ,CAAC,CAAC,SAAS,KAAK,MAAM,GAAG,GAAG,EAAE,QAAQ,OAAO,GAAG,CAAC;AAAA;AACnH,YAAM,WAAW,iBAAiB,MAAM,MAAM;AAAA,IAChD,QAAQ;AAAA,IAER;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/session-recovery.d.ts

@@ -0,0 +1,9 @@
+export declare function stripResetSuffix(fileName: string): string;
+export declare function resolveReflectionSessionSearchDirs(params: {
+    context: Record<string, unknown>;
+    cfg: unknown;
+    workspaceDir: string;
+    currentSessionFile?: string;
+    sourceAgentId?: string;
+}): string[];
+//# sourceMappingURL=session-recovery.d.ts.map

package/dist/src/session-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-recovery.d.ts","sourceRoot":"","sources":["../../src/session-recovery.ts"],"names":[],"mappings":"AASA,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAuCD,wBAAgB,kCAAkC,CAAC,MAAM,EAAE;IACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,GAAG,EAAE,OAAO,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,EAAE,CAgFX"}

package/{src/session-recovery.ts → dist/src/session-recovery.js}

@@ -1,46 +1,39 @@
-// SPDX-License-Identifier: LicenseRef-Mnemo-Pro
 import { dirname, join } from "node:path";
-
-function asNonEmptyString(value: unknown): string | undefined {
-  if (typeof value !== "string") return undefined;
+function asNonEmptyString(value) {
+  if (typeof value !== "string") return void 0;
   const trimmed = value.trim();
-  return trimmed.length ? trimmed : undefined;
+  return trimmed.length ? trimmed : void 0;
 }
-
-export function stripResetSuffix(fileName: string): string {
+function stripResetSuffix(fileName) {
   const resetIndex = fileName.indexOf(".reset.");
   return resetIndex === -1 ? fileName : fileName.slice(0, resetIndex);
 }
-
-function deriveOpenClawHomeFromWorkspacePath(workspacePath: string): string | undefined {
+function deriveOpenClawHomeFromWorkspacePath(workspacePath) {
   const normalized = workspacePath.trim().replace(/[\\/]+$/, "");
-  if (!normalized) return undefined;
+  if (!normalized) return void 0;
   const matched = normalized.match(/^(.*?)[\\/]workspace(?:[\\/].*)?$/);
-  if (!matched || !matched[1]) return undefined;
+  if (!matched || !matched[1]) return void 0;
   const home = matched[1].trim();
-  return home.length ? home : undefined;
+  return home.length ? home : void 0;
 }
-
-function deriveOpenClawHomeFromSessionFilePath(sessionFilePath: string): string | undefined {
+function deriveOpenClawHomeFromSessionFilePath(sessionFilePath) {
   const normalized = sessionFilePath.trim();
-  if (!normalized) return undefined;
+  if (!normalized) return void 0;
   const matched = normalized.match(/^(.*?)[\\/]agents[\\/][^\\/]+[\\/]sessions(?:[\\/][^\\/]+)?$/);
-  if (!matched || !matched[1]) return undefined;
+  if (!matched || !matched[1]) return void 0;
   const home = matched[1].trim();
-  return home.length ? home : undefined;
+  return home.length ? home : void 0;
 }
-
-function listConfiguredAgentIds(cfg: unknown): string[] {
+function listConfiguredAgentIds(cfg) {
   try {
-    const root = cfg as Record<string, unknown>;
-    const agents = root.agents as Record<string, unknown> | undefined;
-    const list = agents?.list as unknown;
+    const root = cfg;
+    const agents = root.agents;
+    const list = agents?.list;
     if (!Array.isArray(list)) return [];
-
-    const ids: string[] = [];
+    const ids = [];
     for (const item of list) {
       if (!item || typeof item !== "object") continue;
-      const id = asNonEmptyString((item as Record<string, unknown>).id);
+      const id = asNonEmptyString(item.id);
       if (id) ids.push(id);
     }
     return ids;
@@ -48,37 +41,28 @@ function listConfiguredAgentIds(cfg: unknown): string[] {
     return [];
   }
 }
-
-export function resolveReflectionSessionSearchDirs(params: {
-  context: Record<string, unknown>;
-  cfg: unknown;
-  workspaceDir: string;
-  currentSessionFile?: string;
-  sourceAgentId?: string;
-}): string[] {
-  const out: string[] = [];
-  const seen = new Set<string>();
-  const addDir = (value: string | undefined) => {
+function resolveReflectionSessionSearchDirs(params) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  const addDir = (value) => {
     const dir = asNonEmptyString(value);
     if (!dir || seen.has(dir)) return;
     seen.add(dir);
     out.push(dir);
   };
-  const addHome = (homes: string[], value: string | undefined) => {
+  const addHome = (homes, value) => {
     const home = asNonEmptyString(value);
     if (!home || homes.includes(home)) return;
     homes.push(home);
   };
-  const addAgentId = (agentIds: string[], value: string | undefined) => {
+  const addAgentId = (agentIds2, value) => {
     const agentId = asNonEmptyString(value);
-    if (!agentId || agentId.includes("/") || agentId.includes("\\") || agentIds.includes(agentId)) return;
-    agentIds.push(agentId);
+    if (!agentId || agentId.includes("/") || agentId.includes("\\") || agentIds2.includes(agentId)) return;
+    agentIds2.push(agentId);
   };
-
-  const previousSessionEntry = (params.context.previousSessionEntry || {}) as Record<string, unknown>;
-  const sessionEntry = (params.context.sessionEntry || {}) as Record<string, unknown>;
+  const previousSessionEntry = params.context.previousSessionEntry || {};
+  const sessionEntry = params.context.sessionEntry || {};
   const sessionEntries = [previousSessionEntry, sessionEntry];
-
   if (params.currentSessionFile) addDir(dirname(params.currentSessionFile));
   for (const entry of sessionEntries) {
     const file = asNonEmptyString(entry.sessionFile);
@@ -87,8 +71,7 @@ export function resolveReflectionSessionSearchDirs(params: {
     addDir(asNonEmptyString(entry.sessionDir));
   }
   addDir(join(params.workspaceDir, "sessions"));
-
-  const openclawHomes: string[] = [];
+  const openclawHomes = [];
   addHome(openclawHomes, asNonEmptyString(process.env.OPENCLAW_HOME));
   addHome(openclawHomes, deriveOpenClawHomeFromWorkspacePath(params.workspaceDir));
   if (params.currentSessionFile) {
@@ -99,25 +82,22 @@ export function resolveReflectionSessionSearchDirs(params: {
     if (entryFile) addHome(openclawHomes, deriveOpenClawHomeFromSessionFilePath(entryFile));
   }
   try {
-    const root = params.cfg as Record<string, unknown>;
-    const agents = root.agents as Record<string, unknown> | undefined;
-    const defaults = agents?.defaults as Record<string, unknown> | undefined;
+    const root = params.cfg;
+    const agents = root.agents;
+    const defaults = agents?.defaults;
     const defaultWorkspace = asNonEmptyString(defaults?.workspace);
     if (defaultWorkspace) addHome(openclawHomes, deriveOpenClawHomeFromWorkspacePath(defaultWorkspace));
-
-    const list = agents?.list as unknown;
+    const list = agents?.list;
     if (Array.isArray(list)) {
       for (const item of list) {
         if (!item || typeof item !== "object") continue;
-        const workspace = asNonEmptyString((item as Record<string, unknown>).workspace);
+        const workspace = asNonEmptyString(item.workspace);
         if (workspace) addHome(openclawHomes, deriveOpenClawHomeFromWorkspacePath(workspace));
       }
     }
   } catch {
-    // ignore
   }
-
-  const agentIds: string[] = [];
+  const agentIds = [];
   addAgentId(agentIds, params.sourceAgentId);
   addAgentId(agentIds, asNonEmptyString(params.context.agentId));
   for (const entry of sessionEntries) {
@@ -127,12 +107,15 @@ export function resolveReflectionSessionSearchDirs(params: {
     addAgentId(agentIds, configuredId);
   }
   addAgentId(agentIds, "main");
-
   for (const home of openclawHomes) {
     for (const agentId of agentIds) {
       addDir(join(home, "agents", agentId, "sessions"));
     }
   }
-
   return out;
 }
+export {
+  resolveReflectionSessionSearchDirs,
+  stripResetSuffix
+};
+//# sourceMappingURL=session-recovery.js.map

package/dist/src/session-recovery.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/session-recovery.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\nimport { dirname, join } from \"node:path\";\n\nfunction asNonEmptyString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const trimmed = value.trim();\n  return trimmed.length ? trimmed : undefined;\n}\n\nexport function stripResetSuffix(fileName: string): string {\n  const resetIndex = fileName.indexOf(\".reset.\");\n  return resetIndex === -1 ? fileName : fileName.slice(0, resetIndex);\n}\n\nfunction deriveOpenClawHomeFromWorkspacePath(workspacePath: string): string | undefined {\n  const normalized = workspacePath.trim().replace(/[\\\\/]+$/, \"\");\n  if (!normalized) return undefined;\n  const matched = normalized.match(/^(.*?)[\\\\/]workspace(?:[\\\\/].*)?$/);\n  if (!matched || !matched[1]) return undefined;\n  const home = matched[1].trim();\n  return home.length ? home : undefined;\n}\n\nfunction deriveOpenClawHomeFromSessionFilePath(sessionFilePath: string): string | undefined {\n  const normalized = sessionFilePath.trim();\n  if (!normalized) return undefined;\n  const matched = normalized.match(/^(.*?)[\\\\/]agents[\\\\/][^\\\\/]+[\\\\/]sessions(?:[\\\\/][^\\\\/]+)?$/);\n  if (!matched || !matched[1]) return undefined;\n  const home = matched[1].trim();\n  return home.length ? home : undefined;\n}\n\nfunction listConfiguredAgentIds(cfg: unknown): string[] {\n  try {\n    const root = cfg as Record<string, unknown>;\n    const agents = root.agents as Record<string, unknown> | undefined;\n    const list = agents?.list as unknown;\n    if (!Array.isArray(list)) return [];\n\n    const ids: string[] = [];\n    for (const item of list) {\n      if (!item || typeof item !== \"object\") continue;\n      const id = asNonEmptyString((item as Record<string, unknown>).id);\n      if (id) ids.push(id);\n    }\n    return ids;\n  } catch {\n    return [];\n  }\n}\n\nexport function resolveReflectionSessionSearchDirs(params: {\n  context: Record<string, unknown>;\n  cfg: unknown;\n  workspaceDir: string;\n  currentSessionFile?: string;\n  sourceAgentId?: string;\n}): string[] {\n  const out: string[] = [];\n  const seen = new Set<string>();\n  const addDir = (value: string | undefined) => {\n    const dir = asNonEmptyString(value);\n    if (!dir || seen.has(dir)) return;\n    seen.add(dir);\n    out.push(dir);\n  };\n  const addHome = (homes: string[], value: string | undefined) => {\n    const home = asNonEmptyString(value);\n    if (!home || homes.includes(home)) return;\n    homes.push(home);\n  };\n  const addAgentId = (agentIds: string[], value: string | undefined) => {\n    const agentId = asNonEmptyString(value);\n    if (!agentId || agentId.includes(\"/\") || agentId.includes(\"\\\\\") || agentIds.includes(agentId)) return;\n    agentIds.push(agentId);\n  };\n\n  const previousSessionEntry = (params.context.previousSessionEntry || {}) as Record<string, unknown>;\n  const sessionEntry = (params.context.sessionEntry || {}) as Record<string, unknown>;\n  const sessionEntries = [previousSessionEntry, sessionEntry];\n\n  if (params.currentSessionFile) addDir(dirname(params.currentSessionFile));\n  for (const entry of sessionEntries) {\n    const file = asNonEmptyString(entry.sessionFile);\n    if (file) addDir(dirname(file));\n    addDir(asNonEmptyString(entry.sessionsDir));\n    addDir(asNonEmptyString(entry.sessionDir));\n  }\n  addDir(join(params.workspaceDir, \"sessions\"));\n\n  const openclawHomes: string[] = [];\n  addHome(openclawHomes, asNonEmptyString(process.env.OPENCLAW_HOME));\n  addHome(openclawHomes, deriveOpenClawHomeFromWorkspacePath(params.workspaceDir));\n  if (params.currentSessionFile) {\n    addHome(openclawHomes, deriveOpenClawHomeFromSessionFilePath(params.currentSessionFile));\n  }\n  for (const entry of sessionEntries) {\n    const entryFile = asNonEmptyString(entry.sessionFile);\n    if (entryFile) addHome(openclawHomes, deriveOpenClawHomeFromSessionFilePath(entryFile));\n  }\n  try {\n    const root = params.cfg as Record<string, unknown>;\n    const agents = root.agents as Record<string, unknown> | undefined;\n    const defaults = agents?.defaults as Record<string, unknown> | undefined;\n    const defaultWorkspace = asNonEmptyString(defaults?.workspace);\n    if (defaultWorkspace) addHome(openclawHomes, deriveOpenClawHomeFromWorkspacePath(defaultWorkspace));\n\n    const list = agents?.list as unknown;\n    if (Array.isArray(list)) {\n      for (const item of list) {\n        if (!item || typeof item !== \"object\") continue;\n        const workspace = asNonEmptyString((item as Record<string, unknown>).workspace);\n        if (workspace) addHome(openclawHomes, deriveOpenClawHomeFromWorkspacePath(workspace));\n      }\n    }\n  } catch {\n    // ignore\n  }\n\n  const agentIds: string[] = [];\n  addAgentId(agentIds, params.sourceAgentId);\n  addAgentId(agentIds, asNonEmptyString(params.context.agentId));\n  for (const entry of sessionEntries) {\n    addAgentId(agentIds, asNonEmptyString(entry.agentId));\n  }\n  for (const configuredId of listConfiguredAgentIds(params.cfg)) {\n    addAgentId(agentIds, configuredId);\n  }\n  addAgentId(agentIds, \"main\");\n\n  for (const home of openclawHomes) {\n    for (const agentId of agentIds) {\n      addDir(join(home, \"agents\", agentId, \"sessions\"));\n    }\n  }\n\n  return out;\n}\n"],
+  "mappings": "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",
+  "names": ["agentIds"]
+}

package/dist/src/smart-extractor.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Smart Memory Extractor — LLM-powered extraction pipeline
+ * Replaces regex-triggered capture with intelligent 6-category extraction.
+ *
+ * Pipeline: conversation → LLM extract → candidates → dedup → persist
+ *
+ */
+import type { MemoryStore } from "./store.js";
+import type { Embedder } from "./embedder.js";
+import type { LlmClient } from "./llm-client.js";
+import { type ExtractionStats } from "./memory-categories.js";
+import type { NoisePrototypeBank } from "./noise-prototypes.js";
+export interface SmartExtractorConfig {
+    /** User identifier for extraction prompt. */
+    user?: string;
+    /** Minimum conversation messages before extraction triggers. */
+    extractMinMessages?: number;
+    /** Maximum characters of conversation text to process. */
+    extractMaxChars?: number;
+    /** Default scope for new memories. */
+    defaultScope?: string;
+    /** Logger function. */
+    log?: (msg: string) => void;
+    /** Debug logger function. */
+    debugLog?: (msg: string) => void;
+    /** Optional embedding-based noise prototype bank for language-agnostic noise filtering. */
+    noiseBank?: NoisePrototypeBank;
+}
+export interface ExtractPersistOptions {
+    /** Target scope for newly created memories. */
+    scope?: string;
+    /** Scopes visible to the current agent for dedup/merge. */
+    scopeFilter?: string[];
+}
+export declare class SmartExtractor {
+    private store;
+    private embedder;
+    private llm;
+    private config;
+    private log;
+    private debugLog;
+    constructor(store: MemoryStore, embedder: Embedder, llm: LlmClient, config?: SmartExtractorConfig);
+    /**
+     * Extract memories from a conversation text and persist them.
+     * Returns extraction statistics.
+     */
+    extractAndPersist(conversationText: string, sessionKey?: string, options?: ExtractPersistOptions): Promise<ExtractionStats>;
+    /**
+     * Filter out texts that match noise prototypes by embedding similarity.
+     * Long texts (>300 chars) are passed through without checking.
+     * Only active when noiseBank is configured and initialized.
+     */
+    filterNoiseByEmbedding(texts: string[]): Promise<string[]>;
+    /**
+     * Feed back conversation text to the noise prototype bank.
+     * Called when LLM extraction returns zero candidates (strongest noise signal).
+     */
+    private learnAsNoise;
+    /**
+     * Call LLM to extract candidate memories from conversation text.
+     */
+    private extractCandidates;
+    /**
+     * Process a single candidate memory: dedup → merge/create → store
+     */
+    private processCandidate;
+    /**
+     * Two-stage dedup: vector similarity search → LLM decision.
+     */
+    private deduplicate;
+    private llmDedupDecision;
+    /**
+     * Profile always-merge: read existing profile, merge with LLM, upsert.
+     */
+    private handleProfileMerge;
+    /**
+     * Merge a candidate into an existing memory using LLM.
+     */
+    private handleMerge;
+    /**
+     * Handle SUPPORT: update support stats on existing memory for a specific context.
+     */
+    private handleSupport;
+    /**
+     * Handle CONTEXTUALIZE: create a new entry that adds situational nuance,
+     * linked to the original via a relation in metadata.
+     */
+    private handleContextualize;
+    /**
+     * Handle CONTRADICT: create contradicting entry + record contradiction evidence
+     * on the original memory's support stats.
+     */
+    private handleContradict;
+    /**
+     * Store a candidate memory as a new entry with L0/L1/L2 metadata.
+     */
+    private storeCandidate;
+    /**
+     * Map 6-category to existing 5-category store type for backward compatibility.
+     */
+    private mapToStoreCategory;
+    /**
+     * Get default importance score by category.
+     */
+    private getDefaultImportance;
+}
+//# sourceMappingURL=smart-extractor.d.ts.map

package/dist/src/smart-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-extractor.d.ts","sourceRoot":"","sources":["../../src/smart-extractor.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAOjD,OAAO,EAIL,KAAK,eAAe,EAMrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAmChE,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,2FAA2F;IAC3F,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,cAAc;IAKvB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,MAAM;IAPhB,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,QAAQ,CAAwB;gBAG9B,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,SAAS,EACd,MAAM,GAAE,oBAAyB;IAU3C;;;OAGG;IACG,iBAAiB,CACrB,gBAAgB,EAAE,MAAM,EACxB,UAAU,GAAE,MAAkB,EAC9B,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,eAAe,CAAC;IA8C3B;;;;OAIG;IACG,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiChE;;;OAGG;YACW,YAAY;IAoB1B;;OAEG;YACW,iBAAiB;IAyF/B;;OAEG;YACW,gBAAgB;IAqG9B;;OAEG;YACW,WAAW;YAqBX,gBAAgB;IA0E9B;;OAEG;YACW,kBAAkB;IAuChC;;OAEG;YACW,WAAW;IA4GzB;;OAEG;YACW,aAAa;IA0B3B;;;OAGG;YACW,mBAAmB;IAsCjC;;;OAGG;YACW,gBAAgB;IAyF9B;;OAEG;YACW,cAAc;IA0C5B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAkB7B"}