@mnemoai/core 1.1.0 → 1.1.2

package/dist/src/noise-filter.js

@@ -0,0 +1,62 @@
+const DENIAL_PATTERNS = [
+  /i don'?t have (any )?(information|data|memory|record)/i,
+  /i'?m not sure about/i,
+  /i don'?t recall/i,
+  /i don'?t remember/i,
+  /it looks like i don'?t/i,
+  /i wasn'?t able to find/i,
+  /no (relevant )?memories found/i,
+  /i don'?t have access to/i
+];
+const META_QUESTION_PATTERNS = [
+  /\bdo you (remember|recall|know about)\b/i,
+  /\bcan you (remember|recall)\b/i,
+  /\bdid i (tell|mention|say|share)\b/i,
+  /\bhave i (told|mentioned|said)\b/i,
+  /\bwhat did i (tell|say|mention)\b/i,
+  /如果你知道.+只回复/i,
+  /如果不知道.+只回复\s*none/i,
+  /只回复精确代号/i,
+  /只回复\s*none/i,
+  // Chinese recall / meta-question patterns
+  /你还?记得/,
+  /记不记得/,
+  /还记得.*吗/,
+  /你[知晓]道.+吗/,
+  /我(?:之前|上次|以前)(?:说|提|讲).*(?:吗|呢|？|\?)/
+];
+const BOILERPLATE_PATTERNS = [
+  /^(hi|hello|hey|good morning|good evening|greetings)/i,
+  /^fresh session/i,
+  /^new session/i,
+  /^HEARTBEAT/i
+];
+const DIAGNOSTIC_ARTIFACT_PATTERNS = [
+  /\bquery\s*->\s*(none|no explicit solution|unknown|not found)\b/i,
+  /\buser asked for\b.*\b(none|no explicit solution|unknown|not found)\b/i,
+  /\bno explicit solution\b/i
+];
+const DEFAULT_OPTIONS = {
+  filterDenials: true,
+  filterMetaQuestions: true,
+  filterBoilerplate: true
+};
+function isNoise(text, options = {}) {
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  const trimmed = text.trim();
+  if (trimmed.length < 5) return true;
+  if (opts.filterDenials && DENIAL_PATTERNS.some((p) => p.test(trimmed))) return true;
+  if (opts.filterMetaQuestions && META_QUESTION_PATTERNS.some((p) => p.test(trimmed))) return true;
+  if (opts.filterBoilerplate && BOILERPLATE_PATTERNS.some((p) => p.test(trimmed))) return true;
+  if (DIAGNOSTIC_ARTIFACT_PATTERNS.some((p) => p.test(trimmed))) return true;
+  return false;
+}
+function filterNoise(items, getText, options) {
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  return items.filter((item) => !isNoise(getText(item), opts));
+}
+export {
+  filterNoise,
+  isNoise
+};
+//# sourceMappingURL=noise-filter.js.map

package/dist/src/noise-filter.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/noise-filter.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * Noise Filter\n * Filters out low-quality memories (meta-questions, agent denials, session boilerplate)\n * Inspired by openclaw-plugin-continuity's noise filtering approach.\n */\n\n// Agent-side denial patterns\nconst DENIAL_PATTERNS = [\n  /i don'?t have (any )?(information|data|memory|record)/i,\n  /i'?m not sure about/i,\n  /i don'?t recall/i,\n  /i don'?t remember/i,\n  /it looks like i don'?t/i,\n  /i wasn'?t able to find/i,\n  /no (relevant )?memories found/i,\n  /i don'?t have access to/i,\n];\n\n// User-side meta-question patterns (about memory itself, not content)\nconst META_QUESTION_PATTERNS = [\n  /\\bdo you (remember|recall|know about)\\b/i,\n  /\\bcan you (remember|recall)\\b/i,\n  /\\bdid i (tell|mention|say|share)\\b/i,\n  /\\bhave i (told|mentioned|said)\\b/i,\n  /\\bwhat did i (tell|say|mention)\\b/i,\n  /\u5982\u679C\u4F60\u77E5\u9053.+\u53EA\u56DE\u590D/i,\n  /\u5982\u679C\u4E0D\u77E5\u9053.+\u53EA\u56DE\u590D\\s*none/i,\n  /\u53EA\u56DE\u590D\u7CBE\u786E\u4EE3\u53F7/i,\n  /\u53EA\u56DE\u590D\\s*none/i,\n  // Chinese recall / meta-question patterns\n  /\u4F60\u8FD8?\u8BB0\u5F97/,\n  /\u8BB0\u4E0D\u8BB0\u5F97/,\n  /\u8FD8\u8BB0\u5F97.*\u5417/,\n  /\u4F60[\u77E5\u6653]\u9053.+\u5417/,\n  /\u6211(?:\u4E4B\u524D|\u4E0A\u6B21|\u4EE5\u524D)(?:\u8BF4|\u63D0|\u8BB2).*(?:\u5417|\u5462|\uFF1F|\\?)/,\n];\n\n// Session boilerplate\nconst BOILERPLATE_PATTERNS = [\n  /^(hi|hello|hey|good morning|good evening|greetings)/i,\n  /^fresh session/i,\n  /^new session/i,\n  /^HEARTBEAT/i,\n];\n\n// Extractor artifacts from validation prompts / synthetic summaries\nconst DIAGNOSTIC_ARTIFACT_PATTERNS = [\n  /\\bquery\\s*->\\s*(none|no explicit solution|unknown|not found)\\b/i,\n  /\\buser asked for\\b.*\\b(none|no explicit solution|unknown|not found)\\b/i,\n  /\\bno explicit solution\\b/i,\n];\n\nexport interface NoiseFilterOptions {\n  /** Filter agent denial responses (default: true) */\n  filterDenials?: boolean;\n  /** Filter meta-questions about memory (default: true) */\n  filterMetaQuestions?: boolean;\n  /** Filter session boilerplate (default: true) */\n  filterBoilerplate?: boolean;\n}\n\nconst DEFAULT_OPTIONS: Required<NoiseFilterOptions> = {\n  filterDenials: true,\n  filterMetaQuestions: true,\n  filterBoilerplate: true,\n};\n\n/**\n * Check if a memory text is noise that should be filtered out.\n * Returns true if the text is noise.\n */\nexport function isNoise(text: string, options: NoiseFilterOptions = {}): boolean {\n  const opts = { ...DEFAULT_OPTIONS, ...options };\n  const trimmed = text.trim();\n\n  if (trimmed.length < 5) return true;\n\n  if (opts.filterDenials && DENIAL_PATTERNS.some(p => p.test(trimmed))) return true;\n  if (opts.filterMetaQuestions && META_QUESTION_PATTERNS.some(p => p.test(trimmed))) return true;\n  if (opts.filterBoilerplate && BOILERPLATE_PATTERNS.some(p => p.test(trimmed))) return true;\n  if (DIAGNOSTIC_ARTIFACT_PATTERNS.some(p => p.test(trimmed))) return true;\n\n  return false;\n}\n\n/**\n * Filter an array of items, removing noise entries.\n */\nexport function filterNoise<T>(\n  items: T[],\n  getText: (item: T) => string,\n  options?: NoiseFilterOptions\n): T[] {\n  const opts = { ...DEFAULT_OPTIONS, ...options };\n  return items.filter(item => !isNoise(getText(item), opts));\n}\n"],
+  "mappings": "AAQA,MAAM,kBAAkB;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,MAAM,yBAAyB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,MAAM,uBAAuB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGA,MAAM,+BAA+B;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AACF;AAWA,MAAM,kBAAgD;AAAA,EACpD,eAAe;AAAA,EACf,qBAAqB;AAAA,EACrB,mBAAmB;AACrB;AAMO,SAAS,QAAQ,MAAc,UAA8B,CAAC,GAAY;AAC/E,QAAM,OAAO,EAAE,GAAG,iBAAiB,GAAG,QAAQ;AAC9C,QAAM,UAAU,KAAK,KAAK;AAE1B,MAAI,QAAQ,SAAS,EAAG,QAAO;AAE/B,MAAI,KAAK,iBAAiB,gBAAgB,KAAK,OAAK,EAAE,KAAK,OAAO,CAAC,EAAG,QAAO;AAC7E,MAAI,KAAK,uBAAuB,uBAAuB,KAAK,OAAK,EAAE,KAAK,OAAO,CAAC,EAAG,QAAO;AAC1F,MAAI,KAAK,qBAAqB,qBAAqB,KAAK,OAAK,EAAE,KAAK,OAAO,CAAC,EAAG,QAAO;AACtF,MAAI,6BAA6B,KAAK,OAAK,EAAE,KAAK,OAAO,CAAC,EAAG,QAAO;AAEpE,SAAO;AACT;AAKO,SAAS,YACd,OACA,SACA,SACK;AACL,QAAM,OAAO,EAAE,GAAG,iBAAiB,GAAG,QAAQ;AAC9C,SAAO,MAAM,OAAO,UAAQ,CAAC,QAAQ,QAAQ,IAAI,GAAG,IAAI,CAAC;AAC3D;",
+  "names": []
+}

package/dist/src/noise-prototypes.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Embedding-based Noise Prototype Bank
+ *
+ * Language-agnostic noise detection: maintains a bank of noise prototype
+ * embeddings (recall queries, agent denials, greetings). Input texts are
+ * compared via cosine similarity — no regex maintenance required.
+ *
+ * The bank starts with ~15 built-in multilingual prototypes and grows
+ * automatically when the LLM extraction returns zero memories (feedback loop).
+ */
+import type { Embedder } from "./embedder.js";
+export declare class NoisePrototypeBank {
+    private vectors;
+    private builtinCount;
+    private _initialized;
+    private debugLog;
+    constructor(debugLog?: (msg: string) => void);
+    /** Whether the bank has been initialized with prototype embeddings. */
+    get initialized(): boolean;
+    /** Total number of prototypes (built-in + learned). */
+    get size(): number;
+    /**
+     * Embed all built-in noise prototypes and cache their vectors.
+     * Call once at plugin startup. Safe to call multiple times (no-op after first).
+     */
+    init(embedder: Embedder): Promise<void>;
+    /**
+     * Check if a text vector matches any noise prototype.
+     * Returns true if cosine similarity >= threshold with any prototype.
+     */
+    isNoise(textVector: number[], threshold?: number): boolean;
+    /**
+     * LLM feedback: add a text vector to the learned noise bank.
+     * Called when LLM extraction returns zero memories (strong noise signal).
+     * Deduplicates against existing prototypes (>= 0.95 similarity = skip).
+     * Evicts oldest learned prototype when bank exceeds MAX_LEARNED_PROTOTYPES.
+     */
+    learn(textVector: number[]): void;
+}
+//# sourceMappingURL=noise-prototypes.d.ts.map

package/dist/src/noise-prototypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise-prototypes.d.ts","sourceRoot":"","sources":["../../src/noise-prototypes.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAqC9C,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAwB;gBAE5B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAI5C,uEAAuE;IACvE,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,uDAAuD;IACvD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACG,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC7C;;;OAGG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,SAAS,SAAoB,GAAG,OAAO;IAQrE;;;;;OAKG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI;CAmBpC"}

package/dist/src/noise-prototypes.js

@@ -0,0 +1,116 @@
+const BUILTIN_NOISE_TEXTS = [
+  // Recall queries
+  "Do you remember what I told you?",
+  "Can you recall my preferences?",
+  "What did I say about that?",
+  "\u4F60\u8FD8\u8BB0\u5F97\u6211\u559C\u6B22\u4EC0\u4E48\u5417",
+  "\u4F60\u77E5\u9053\u6211\u4E4B\u524D\u8BF4\u8FC7\u4EC0\u4E48\u5417",
+  "\u8A18\u5F97\u6211\u4E0A\u6B21\u63D0\u5230\u7684\u55CE",
+  "\u6211\u4E4B\u524D\u8DDF\u4F60\u8BF4\u8FC7\u5417",
+  // Agent denials
+  "I don't have any information about that",
+  "I don't recall any previous conversation",
+  "\u6211\u6CA1\u6709\u76F8\u5173\u7684\u8BB0\u5FC6",
+  // Greetings / boilerplate
+  "Hello, how are you doing today?",
+  "Hi there, what's up",
+  "\u65B0\u7684\u4E00\u5929\u5F00\u59CB\u4E86"
+];
+const DEFAULT_THRESHOLD = 0.82;
+const MAX_LEARNED_PROTOTYPES = 200;
+const DEDUP_THRESHOLD = 0.95;
+class NoisePrototypeBank {
+  vectors = [];
+  builtinCount = 0;
+  _initialized = false;
+  debugLog;
+  constructor(debugLog) {
+    this.debugLog = debugLog ?? (() => {
+    });
+  }
+  /** Whether the bank has been initialized with prototype embeddings. */
+  get initialized() {
+    return this._initialized;
+  }
+  /** Total number of prototypes (built-in + learned). */
+  get size() {
+    return this.vectors.length;
+  }
+  /**
+   * Embed all built-in noise prototypes and cache their vectors.
+   * Call once at plugin startup. Safe to call multiple times (no-op after first).
+   */
+  async init(embedder) {
+    if (this._initialized) return;
+    for (const text of BUILTIN_NOISE_TEXTS) {
+      try {
+        const v = await embedder.embed(text);
+        if (v && v.length > 0) this.vectors.push(v);
+      } catch {
+      }
+    }
+    this.builtinCount = this.vectors.length;
+    this._initialized = true;
+    if (this.vectors.length >= 2) {
+      const sim = cosine(this.vectors[0], this.vectors[1]);
+      if (sim > 0.98) {
+        this.debugLog(
+          `noise-prototype-bank: degenerate embeddings detected (pairwise cosine=${sim.toFixed(4)}), disabling noise filter`
+        );
+        this._initialized = false;
+        this.vectors = [];
+        return;
+      }
+    }
+    this.debugLog(
+      `noise-prototype-bank: initialized with ${this.builtinCount} built-in prototypes`
+    );
+  }
+  /**
+   * Check if a text vector matches any noise prototype.
+   * Returns true if cosine similarity >= threshold with any prototype.
+   */
+  isNoise(textVector, threshold = DEFAULT_THRESHOLD) {
+    if (!this._initialized || this.vectors.length === 0) return false;
+    for (const proto of this.vectors) {
+      if (cosine(proto, textVector) >= threshold) return true;
+    }
+    return false;
+  }
+  /**
+   * LLM feedback: add a text vector to the learned noise bank.
+   * Called when LLM extraction returns zero memories (strong noise signal).
+   * Deduplicates against existing prototypes (>= 0.95 similarity = skip).
+   * Evicts oldest learned prototype when bank exceeds MAX_LEARNED_PROTOTYPES.
+   */
+  learn(textVector) {
+    if (!this._initialized) return;
+    for (const proto of this.vectors) {
+      if (cosine(proto, textVector) >= DEDUP_THRESHOLD) return;
+    }
+    this.vectors.push(textVector);
+    if (this.vectors.length > this.builtinCount + MAX_LEARNED_PROTOTYPES) {
+      this.vectors.splice(this.builtinCount, 1);
+    }
+    this.debugLog(
+      `noise-prototype-bank: learned new noise prototype (total: ${this.vectors.length})`
+    );
+  }
+}
+function cosine(a, b) {
+  if (a.length !== b.length) return 0;
+  let dot = 0;
+  let na = 0;
+  let nb = 0;
+  for (let i = 0; i < a.length; i++) {
+    dot += a[i] * b[i];
+    na += a[i] * a[i];
+    nb += b[i] * b[i];
+  }
+  const denom = Math.sqrt(na) * Math.sqrt(nb);
+  return denom === 0 ? 0 : dot / denom;
+}
+export {
+  NoisePrototypeBank
+};
+//# sourceMappingURL=noise-prototypes.js.map

package/dist/src/noise-prototypes.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/noise-prototypes.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * Embedding-based Noise Prototype Bank\n *\n * Language-agnostic noise detection: maintains a bank of noise prototype\n * embeddings (recall queries, agent denials, greetings). Input texts are\n * compared via cosine similarity \u2014 no regex maintenance required.\n *\n * The bank starts with ~15 built-in multilingual prototypes and grows\n * automatically when the LLM extraction returns zero memories (feedback loop).\n */\n\nimport type { Embedder } from \"./embedder.js\";\n\n// ============================================================================\n// Built-in noise prototypes (multilingual)\n// ============================================================================\n\nconst BUILTIN_NOISE_TEXTS: readonly string[] = [\n    // Recall queries\n    \"Do you remember what I told you?\",\n    \"Can you recall my preferences?\",\n    \"What did I say about that?\",\n    \"\u4F60\u8FD8\u8BB0\u5F97\u6211\u559C\u6B22\u4EC0\u4E48\u5417\",\n    \"\u4F60\u77E5\u9053\u6211\u4E4B\u524D\u8BF4\u8FC7\u4EC0\u4E48\u5417\",\n    \"\u8A18\u5F97\u6211\u4E0A\u6B21\u63D0\u5230\u7684\u55CE\",\n    \"\u6211\u4E4B\u524D\u8DDF\u4F60\u8BF4\u8FC7\u5417\",\n    // Agent denials\n    \"I don't have any information about that\",\n    \"I don't recall any previous conversation\",\n    \"\u6211\u6CA1\u6709\u76F8\u5173\u7684\u8BB0\u5FC6\",\n    // Greetings / boilerplate\n    \"Hello, how are you doing today?\",\n    \"Hi there, what's up\",\n    \"\u65B0\u7684\u4E00\u5929\u5F00\u59CB\u4E86\",\n];\n\n// ============================================================================\n// Constants\n// ============================================================================\n\nconst DEFAULT_THRESHOLD = 0.82;\nconst MAX_LEARNED_PROTOTYPES = 200;\nconst DEDUP_THRESHOLD = 0.95;\n\n// ============================================================================\n// NoisePrototypeBank\n// ============================================================================\n\nexport class NoisePrototypeBank {\n    private vectors: number[][] = [];\n    private builtinCount = 0;\n    private _initialized = false;\n    private debugLog: (msg: string) => void;\n\n    constructor(debugLog?: (msg: string) => void) {\n        this.debugLog = debugLog ?? (() => { });\n    }\n\n    /** Whether the bank has been initialized with prototype embeddings. */\n    get initialized(): boolean {\n        return this._initialized;\n    }\n\n    /** Total number of prototypes (built-in + learned). */\n    get size(): number {\n        return this.vectors.length;\n    }\n\n    /**\n     * Embed all built-in noise prototypes and cache their vectors.\n     * Call once at plugin startup. Safe to call multiple times (no-op after first).\n     */\n    async init(embedder: Embedder): Promise<void> {\n        if (this._initialized) return;\n\n        for (const text of BUILTIN_NOISE_TEXTS) {\n            try {\n                const v = await embedder.embed(text);\n                if (v && v.length > 0) this.vectors.push(v);\n            } catch {\n                // Skip failed embeddings \u2014 bank will work with whatever succeeds\n            }\n        }\n        this.builtinCount = this.vectors.length;\n        this._initialized = true;\n\n        // Degeneracy check: if all prototype vectors are nearly identical, the\n        // embedding model does not produce discriminative outputs (e.g. a\n        // deterministic mock that ignores text).  In that case the noise bank\n        // would flag every input as noise, so we disable ourselves.\n        if (this.vectors.length >= 2) {\n            const sim = cosine(this.vectors[0], this.vectors[1]);\n            if (sim > 0.98) {\n                this.debugLog(\n                    `noise-prototype-bank: degenerate embeddings detected (pairwise cosine=${sim.toFixed(4)}), disabling noise filter`,\n                );\n                this._initialized = false;\n                this.vectors = [];\n                return;\n            }\n        }\n\n        this.debugLog(\n            `noise-prototype-bank: initialized with ${this.builtinCount} built-in prototypes`,\n        );\n    }\n\n    /**\n     * Check if a text vector matches any noise prototype.\n     * Returns true if cosine similarity >= threshold with any prototype.\n     */\n    isNoise(textVector: number[], threshold = DEFAULT_THRESHOLD): boolean {\n        if (!this._initialized || this.vectors.length === 0) return false;\n        for (const proto of this.vectors) {\n            if (cosine(proto, textVector) >= threshold) return true;\n        }\n        return false;\n    }\n\n    /**\n     * LLM feedback: add a text vector to the learned noise bank.\n     * Called when LLM extraction returns zero memories (strong noise signal).\n     * Deduplicates against existing prototypes (>= 0.95 similarity = skip).\n     * Evicts oldest learned prototype when bank exceeds MAX_LEARNED_PROTOTYPES.\n     */\n    learn(textVector: number[]): void {\n        if (!this._initialized) return;\n\n        // Deduplicate: too similar to an existing prototype \u2192 skip\n        for (const proto of this.vectors) {\n            if (cosine(proto, textVector) >= DEDUP_THRESHOLD) return;\n        }\n\n        this.vectors.push(textVector);\n\n        // Evict oldest learned prototype if over limit (preserve built-in prototypes)\n        if (this.vectors.length > this.builtinCount + MAX_LEARNED_PROTOTYPES) {\n            this.vectors.splice(this.builtinCount, 1);\n        }\n\n        this.debugLog(\n            `noise-prototype-bank: learned new noise prototype (total: ${this.vectors.length})`,\n        );\n    }\n}\n\n// ============================================================================\n// Cosine Similarity\n// ============================================================================\n\nfunction cosine(a: number[], b: number[]): number {\n    if (a.length !== b.length) return 0;\n    let dot = 0;\n    let na = 0;\n    let nb = 0;\n    for (let i = 0; i < a.length; i++) {\n        dot += a[i] * b[i];\n        na += a[i] * a[i];\n        nb += b[i] * b[i];\n    }\n    const denom = Math.sqrt(na) * Math.sqrt(nb);\n    return denom === 0 ? 0 : dot / denom;\n}\n"],
+  "mappings": "AAkBA,MAAM,sBAAyC;AAAA;AAAA,EAE3C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AACJ;AAMA,MAAM,oBAAoB;AAC1B,MAAM,yBAAyB;AAC/B,MAAM,kBAAkB;AAMjB,MAAM,mBAAmB;AAAA,EACpB,UAAsB,CAAC;AAAA,EACvB,eAAe;AAAA,EACf,eAAe;AAAA,EACf;AAAA,EAER,YAAY,UAAkC;AAC1C,SAAK,WAAW,aAAa,MAAM;AAAA,IAAE;AAAA,EACzC;AAAA;AAAA,EAGA,IAAI,cAAuB;AACvB,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA,EAGA,IAAI,OAAe;AACf,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,KAAK,UAAmC;AAC1C,QAAI,KAAK,aAAc;AAEvB,eAAW,QAAQ,qBAAqB;AACpC,UAAI;AACA,cAAM,IAAI,MAAM,SAAS,MAAM,IAAI;AACnC,YAAI,KAAK,EAAE,SAAS,EAAG,MAAK,QAAQ,KAAK,CAAC;AAAA,MAC9C,QAAQ;AAAA,MAER;AAAA,IACJ;AACA,SAAK,eAAe,KAAK,QAAQ;AACjC,SAAK,eAAe;AAMpB,QAAI,KAAK,QAAQ,UAAU,GAAG;AAC1B,YAAM,MAAM,OAAO,KAAK,QAAQ,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;AACnD,UAAI,MAAM,MAAM;AACZ,aAAK;AAAA,UACD,yEAAyE,IAAI,QAAQ,CAAC,CAAC;AAAA,QAC3F;AACA,aAAK,eAAe;AACpB,aAAK,UAAU,CAAC;AAChB;AAAA,MACJ;AAAA,IACJ;AAEA,SAAK;AAAA,MACD,0CAA0C,KAAK,YAAY;AAAA,IAC/D;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,QAAQ,YAAsB,YAAY,mBAA4B;AAClE,QAAI,CAAC,KAAK,gBAAgB,KAAK,QAAQ,WAAW,EAAG,QAAO;AAC5D,eAAW,SAAS,KAAK,SAAS;AAC9B,UAAI,OAAO,OAAO,UAAU,KAAK,UAAW,QAAO;AAAA,IACvD;AACA,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,YAA4B;AAC9B,QAAI,CAAC,KAAK,aAAc;AAGxB,eAAW,SAAS,KAAK,SAAS;AAC9B,UAAI,OAAO,OAAO,UAAU,KAAK,gBAAiB;AAAA,IACtD;AAEA,SAAK,QAAQ,KAAK,UAAU;AAG5B,QAAI,KAAK,QAAQ,SAAS,KAAK,eAAe,wBAAwB;AAClE,WAAK,QAAQ,OAAO,KAAK,cAAc,CAAC;AAAA,IAC5C;AAEA,SAAK;AAAA,MACD,6DAA6D,KAAK,QAAQ,MAAM;AAAA,IACpF;AAAA,EACJ;AACJ;AAMA,SAAS,OAAO,GAAa,GAAqB;AAC9C,MAAI,EAAE,WAAW,EAAE,OAAQ,QAAO;AAClC,MAAI,MAAM;AACV,MAAI,KAAK;AACT,MAAI,KAAK;AACT,WAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK;AAC/B,WAAO,EAAE,CAAC,IAAI,EAAE,CAAC;AACjB,UAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAChB,UAAM,EAAE,CAAC,IAAI,EAAE,CAAC;AAAA,EACpB;AACA,QAAM,QAAQ,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,EAAE;AAC1C,SAAO,UAAU,IAAI,IAAI,MAAM;AACnC;",
+  "names": []
+}

package/dist/src/observability.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Observability — aggregated stats from query-tracking.jsonl
+ */
+export interface QueryStats {
+    totalQueries: number;
+    avgLatencyMs: number;
+    resonancePassRate: number;
+    avgHitCount: number;
+    queryTypeDistribution: Record<string, number>;
+    hourlyTrend: {
+        hour: string;
+        count: number;
+    }[];
+}
+export declare function getStats(maxRecords?: number): Promise<QueryStats>;
+//# sourceMappingURL=observability.d.ts.map

package/dist/src/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../src/observability.ts"],"names":[],"mappings":"AACA;;GAEG;AAIH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChD;AAED,wBAAsB,QAAQ,CAAC,UAAU,SAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAgErE"}

package/dist/src/observability.js

@@ -0,0 +1,53 @@
+import { getRecentQueries } from "./query-tracker.js";
+async function getStats(maxRecords = 1e3) {
+  const records = await getRecentQueries(maxRecords);
+  if (records.length === 0) {
+    return {
+      totalQueries: 0,
+      avgLatencyMs: 0,
+      resonancePassRate: 0,
+      avgHitCount: 0,
+      queryTypeDistribution: {},
+      hourlyTrend: []
+    };
+  }
+  const totalQueries = records.length;
+  const avgLatencyMs = Math.round(
+    records.reduce((sum, r) => sum + r.latency_ms, 0) / totalQueries
+  );
+  const resonancePassRate = +(records.filter((r) => r.resonancePass).length / totalQueries).toFixed(3);
+  const avgHitCount = +(records.reduce((sum, r) => sum + r.hitCount, 0) / totalQueries).toFixed(2);
+  const queryTypeDistribution = {};
+  for (const r of records) {
+    queryTypeDistribution[r.queryType] = (queryTypeDistribution[r.queryType] || 0) + 1;
+  }
+  const now = Date.now();
+  const cutoff = now - 24 * 60 * 60 * 1e3;
+  const hourBuckets = /* @__PURE__ */ new Map();
+  for (let i = 0; i < 24; i++) {
+    const d = new Date(now - i * 60 * 60 * 1e3);
+    const key = d.toISOString().slice(0, 13);
+    hourBuckets.set(key, 0);
+  }
+  for (const r of records) {
+    const ts = new Date(r.timestamp).getTime();
+    if (ts < cutoff) continue;
+    const key = r.timestamp.slice(0, 13);
+    if (hourBuckets.has(key)) {
+      hourBuckets.set(key, hourBuckets.get(key) + 1);
+    }
+  }
+  const hourlyTrend = Array.from(hourBuckets.entries()).map(([hour, count]) => ({ hour, count })).sort((a, b) => a.hour.localeCompare(b.hour));
+  return {
+    totalQueries,
+    avgLatencyMs,
+    resonancePassRate,
+    avgHitCount,
+    queryTypeDistribution,
+    hourlyTrend
+  };
+}
+export {
+  getStats
+};
+//# sourceMappingURL=observability.js.map

package/dist/src/observability.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/observability.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\n/**\n * Observability \u2014 aggregated stats from query-tracking.jsonl\n */\n\nimport { getRecentQueries, type QueryRecord } from \"./query-tracker.js\";\n\nexport interface QueryStats {\n  totalQueries: number;\n  avgLatencyMs: number;\n  resonancePassRate: number;\n  avgHitCount: number;\n  queryTypeDistribution: Record<string, number>;\n  hourlyTrend: { hour: string; count: number }[];\n}\n\nexport async function getStats(maxRecords = 1000): Promise<QueryStats> {\n  const records = await getRecentQueries(maxRecords);\n\n  if (records.length === 0) {\n    return {\n      totalQueries: 0,\n      avgLatencyMs: 0,\n      resonancePassRate: 0,\n      avgHitCount: 0,\n      queryTypeDistribution: {},\n      hourlyTrend: [],\n    };\n  }\n\n  const totalQueries = records.length;\n  const avgLatencyMs = Math.round(\n    records.reduce((sum, r) => sum + r.latency_ms, 0) / totalQueries\n  );\n  const resonancePassRate = +(\n    records.filter((r) => r.resonancePass).length / totalQueries\n  ).toFixed(3);\n  const avgHitCount = +(\n    records.reduce((sum, r) => sum + r.hitCount, 0) / totalQueries\n  ).toFixed(2);\n\n  // Query type distribution\n  const queryTypeDistribution: Record<string, number> = {};\n  for (const r of records) {\n    queryTypeDistribution[r.queryType] =\n      (queryTypeDistribution[r.queryType] || 0) + 1;\n  }\n\n  // Hourly trend \u2014 last 24h bucketed by hour\n  const now = Date.now();\n  const cutoff = now - 24 * 60 * 60 * 1000;\n  const hourBuckets = new Map<string, number>();\n\n  for (let i = 0; i < 24; i++) {\n    const d = new Date(now - i * 60 * 60 * 1000);\n    const key = d.toISOString().slice(0, 13); // \"YYYY-MM-DDTHH\"\n    hourBuckets.set(key, 0);\n  }\n\n  for (const r of records) {\n    const ts = new Date(r.timestamp).getTime();\n    if (ts < cutoff) continue;\n    const key = r.timestamp.slice(0, 13);\n    if (hourBuckets.has(key)) {\n      hourBuckets.set(key, hourBuckets.get(key)! + 1);\n    }\n  }\n\n  const hourlyTrend = Array.from(hourBuckets.entries())\n    .map(([hour, count]) => ({ hour, count }))\n    .sort((a, b) => a.hour.localeCompare(b.hour));\n\n  return {\n    totalQueries,\n    avgLatencyMs,\n    resonancePassRate,\n    avgHitCount,\n    queryTypeDistribution,\n    hourlyTrend,\n  };\n}\n"],
+  "mappings": "AAKA,SAAS,wBAA0C;AAWnD,eAAsB,SAAS,aAAa,KAA2B;AACrE,QAAM,UAAU,MAAM,iBAAiB,UAAU;AAEjD,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,MACL,cAAc;AAAA,MACd,cAAc;AAAA,MACd,mBAAmB;AAAA,MACnB,aAAa;AAAA,MACb,uBAAuB,CAAC;AAAA,MACxB,aAAa,CAAC;AAAA,IAChB;AAAA,EACF;AAEA,QAAM,eAAe,QAAQ;AAC7B,QAAM,eAAe,KAAK;AAAA,IACxB,QAAQ,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,YAAY,CAAC,IAAI;AAAA,EACtD;AACA,QAAM,oBAAoB,EACxB,QAAQ,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,cAChD,QAAQ,CAAC;AACX,QAAM,cAAc,EAClB,QAAQ,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,UAAU,CAAC,IAAI,cAClD,QAAQ,CAAC;AAGX,QAAM,wBAAgD,CAAC;AACvD,aAAW,KAAK,SAAS;AACvB,0BAAsB,EAAE,SAAS,KAC9B,sBAAsB,EAAE,SAAS,KAAK,KAAK;AAAA,EAChD;AAGA,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,SAAS,MAAM,KAAK,KAAK,KAAK;AACpC,QAAM,cAAc,oBAAI,IAAoB;AAE5C,WAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,UAAM,IAAI,IAAI,KAAK,MAAM,IAAI,KAAK,KAAK,GAAI;AAC3C,UAAM,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE;AACvC,gBAAY,IAAI,KAAK,CAAC;AAAA,EACxB;AAEA,aAAW,KAAK,SAAS;AACvB,UAAM,KAAK,IAAI,KAAK,EAAE,SAAS,EAAE,QAAQ;AACzC,QAAI,KAAK,OAAQ;AACjB,UAAM,MAAM,EAAE,UAAU,MAAM,GAAG,EAAE;AACnC,QAAI,YAAY,IAAI,GAAG,GAAG;AACxB,kBAAY,IAAI,KAAK,YAAY,IAAI,GAAG,IAAK,CAAC;AAAA,IAChD;AAAA,EACF;AAEA,QAAM,cAAc,MAAM,KAAK,YAAY,QAAQ,CAAC,EACjD,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,EAAE,MAAM,MAAM,EAAE,EACxC,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,CAAC;AAE9C,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/query-tracker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Query Tracker
+ *
+ * Lightweight, append-only JSONL tracker for every recall query.
+ * Fire-and-forget writes — never blocks the recall path.
+ * Persisted to ~/.openclaw/memory/query-tracking.jsonl.
+ */
+export interface QueryRecord {
+    timestamp: string;
+    query: string;
+    source: "auto" | "manual" | "cli";
+    hitCount: number;
+    topScore: number;
+    latency_ms: number;
+    queryType: "single" | "multi-hop" | "gated-out";
+    resonancePass: boolean;
+}
+/**
+ * Record a query to the tracking log (fire-and-forget).
+ * Errors are silently swallowed to avoid impacting recall latency.
+ */
+export declare function recordQuery(data: QueryRecord): void;
+/**
+ * Read the most recent N query records from the tracking log.
+ */
+export declare function getRecentQueries(n?: number): Promise<QueryRecord[]>;
+//# sourceMappingURL=query-tracker.d.ts.map

package/dist/src/query-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-tracker.d.ts","sourceRoot":"","sources":["../../src/query-tracker.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAQH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IAChD,aAAa,EAAE,OAAO,CAAC;CACxB;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAUnD;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,GAAE,MAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAS9E"}

package/dist/src/query-tracker.js

@@ -0,0 +1,32 @@
+import { appendFile, readFile, mkdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+const TRACKING_PATH = join(homedir(), ".openclaw", "memory", "query-tracking.jsonl");
+let dirEnsured = false;
+function recordQuery(data) {
+  const line = JSON.stringify(data) + "\n";
+  const doWrite = async () => {
+    if (!dirEnsured) {
+      await mkdir(dirname(TRACKING_PATH), { recursive: true });
+      dirEnsured = true;
+    }
+    await appendFile(TRACKING_PATH, line, "utf8");
+  };
+  doWrite().catch(() => {
+  });
+}
+async function getRecentQueries(n = 100) {
+  try {
+    const raw = await readFile(TRACKING_PATH, "utf8");
+    const lines = raw.trim().split("\n").filter(Boolean);
+    const recent = lines.slice(-n);
+    return recent.map((line) => JSON.parse(line));
+  } catch {
+    return [];
+  }
+}
+export {
+  getRecentQueries,
+  recordQuery
+};
+//# sourceMappingURL=query-tracker.js.map

package/dist/src/query-tracker.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/query-tracker.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\n/**\n * Query Tracker\n *\n * Lightweight, append-only JSONL tracker for every recall query.\n * Fire-and-forget writes \u2014 never blocks the recall path.\n * Persisted to ~/.openclaw/memory/query-tracking.jsonl.\n */\n\nimport { appendFile, readFile, mkdir } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join, dirname } from \"node:path\";\n\nconst TRACKING_PATH = join(homedir(), \".openclaw\", \"memory\", \"query-tracking.jsonl\");\n\nexport interface QueryRecord {\n  timestamp: string;\n  query: string;\n  source: \"auto\" | \"manual\" | \"cli\";\n  hitCount: number;\n  topScore: number;\n  latency_ms: number;\n  queryType: \"single\" | \"multi-hop\" | \"gated-out\";\n  resonancePass: boolean;\n}\n\nlet dirEnsured = false;\n\n/**\n * Record a query to the tracking log (fire-and-forget).\n * Errors are silently swallowed to avoid impacting recall latency.\n */\nexport function recordQuery(data: QueryRecord): void {\n  const line = JSON.stringify(data) + \"\\n\";\n  const doWrite = async () => {\n    if (!dirEnsured) {\n      await mkdir(dirname(TRACKING_PATH), { recursive: true });\n      dirEnsured = true;\n    }\n    await appendFile(TRACKING_PATH, line, \"utf8\");\n  };\n  doWrite().catch(() => {});\n}\n\n/**\n * Read the most recent N query records from the tracking log.\n */\nexport async function getRecentQueries(n: number = 100): Promise<QueryRecord[]> {\n  try {\n    const raw = await readFile(TRACKING_PATH, \"utf8\");\n    const lines = raw.trim().split(\"\\n\").filter(Boolean);\n    const recent = lines.slice(-n);\n    return recent.map((line) => JSON.parse(line) as QueryRecord);\n  } catch {\n    return [];\n  }\n}\n"],
+  "mappings": "AASA,SAAS,YAAY,UAAU,aAAa;AAC5C,SAAS,eAAe;AACxB,SAAS,MAAM,eAAe;AAE9B,MAAM,gBAAgB,KAAK,QAAQ,GAAG,aAAa,UAAU,sBAAsB;AAanF,IAAI,aAAa;AAMV,SAAS,YAAY,MAAyB;AACnD,QAAM,OAAO,KAAK,UAAU,IAAI,IAAI;AACpC,QAAM,UAAU,YAAY;AAC1B,QAAI,CAAC,YAAY;AACf,YAAM,MAAM,QAAQ,aAAa,GAAG,EAAE,WAAW,KAAK,CAAC;AACvD,mBAAa;AAAA,IACf;AACA,UAAM,WAAW,eAAe,MAAM,MAAM;AAAA,EAC9C;AACA,UAAQ,EAAE,MAAM,MAAM;AAAA,EAAC,CAAC;AAC1B;AAKA,eAAsB,iBAAiB,IAAY,KAA6B;AAC9E,MAAI;AACF,UAAM,MAAM,MAAM,SAAS,eAAe,MAAM;AAChD,UAAM,QAAQ,IAAI,KAAK,EAAE,MAAM,IAAI,EAAE,OAAO,OAAO;AACnD,UAAM,SAAS,MAAM,MAAM,CAAC,CAAC;AAC7B,WAAO,OAAO,IAAI,CAAC,SAAS,KAAK,MAAM,IAAI,CAAgB;AAAA,EAC7D,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;",
+  "names": []
+}

package/dist/src/reflection-event-store.d.ts

@@ -0,0 +1,44 @@
+export declare const REFLECTION_SCHEMA_VERSION = 4;
+export type ReflectionErrorSignalLike = {
+    signatureHash: string;
+};
+export interface ReflectionEventMetadata {
+    type: "memory-reflection-event";
+    reflectionVersion: 4;
+    stage: "reflect-store";
+    eventId: string;
+    sessionKey: string;
+    sessionId: string;
+    agentId: string;
+    command: string;
+    storedAt: number;
+    usedFallback: boolean;
+    errorSignals: string[];
+    sourceReflectionPath?: string;
+}
+export interface ReflectionEventPayload {
+    kind: "event";
+    text: string;
+    metadata: ReflectionEventMetadata;
+}
+export interface BuildReflectionEventPayloadParams {
+    eventId?: string;
+    scope: string;
+    sessionKey: string;
+    sessionId: string;
+    agentId: string;
+    command: string;
+    toolErrorSignals: ReflectionErrorSignalLike[];
+    runAt: number;
+    usedFallback: boolean;
+    sourceReflectionPath?: string;
+}
+export declare function createReflectionEventId(params: {
+    runAt: number;
+    sessionKey: string;
+    sessionId: string;
+    agentId: string;
+    command: string;
+}): string;
+export declare function buildReflectionEventPayload(params: BuildReflectionEventPayloadParams): ReflectionEventPayload;
+//# sourceMappingURL=reflection-event-store.d.ts.map

package/dist/src/reflection-event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-event-store.d.ts","sourceRoot":"","sources":["../../src/reflection-event-store.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,yBAAyB,CAAC;IAChC,iBAAiB,EAAE,CAAC,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,uBAAuB,CAAC;CACnC;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,yBAAyB,EAAE,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAQT;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,iCAAiC,GAAG,sBAAsB,CAsC7G"}

package/dist/src/reflection-event-store.js

@@ -0,0 +1,50 @@
+import { createHash } from "node:crypto";
+const REFLECTION_SCHEMA_VERSION = 4;
+function createReflectionEventId(params) {
+  const safeRunAt = Number.isFinite(params.runAt) ? Math.max(0, Math.floor(params.runAt)) : Date.now();
+  const datePart = new Date(safeRunAt).toISOString().replace(/[-:.TZ]/g, "").slice(0, 14);
+  const digest = createHash("sha1").update(`${safeRunAt}|${params.sessionKey}|${params.sessionId}|${params.agentId}|${params.command}`).digest("hex").slice(0, 8);
+  return `refl-${datePart}-${digest}`;
+}
+function buildReflectionEventPayload(params) {
+  const eventId = params.eventId || createReflectionEventId({
+    runAt: params.runAt,
+    sessionKey: params.sessionKey,
+    sessionId: params.sessionId,
+    agentId: params.agentId,
+    command: params.command
+  });
+  const metadata = {
+    type: "memory-reflection-event",
+    reflectionVersion: REFLECTION_SCHEMA_VERSION,
+    stage: "reflect-store",
+    eventId,
+    sessionKey: params.sessionKey,
+    sessionId: params.sessionId,
+    agentId: params.agentId,
+    command: params.command,
+    storedAt: params.runAt,
+    usedFallback: params.usedFallback,
+    errorSignals: params.toolErrorSignals.map((signal) => signal.signatureHash),
+    ...params.sourceReflectionPath ? { sourceReflectionPath: params.sourceReflectionPath } : {}
+  };
+  const text = [
+    `reflection-event \xB7 ${params.scope}`,
+    `eventId=${eventId}`,
+    `session=${params.sessionId}`,
+    `agent=${params.agentId}`,
+    `command=${params.command}`,
+    `usedFallback=${params.usedFallback ? "true" : "false"}`
+  ].join("\n");
+  return {
+    kind: "event",
+    text,
+    metadata
+  };
+}
+export {
+  REFLECTION_SCHEMA_VERSION,
+  buildReflectionEventPayload,
+  createReflectionEventId
+};
+//# sourceMappingURL=reflection-event-store.js.map

package/dist/src/reflection-event-store.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/reflection-event-store.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\nimport { createHash } from \"node:crypto\";\n\nexport const REFLECTION_SCHEMA_VERSION = 4;\n\nexport type ReflectionErrorSignalLike = {\n  signatureHash: string;\n};\n\nexport interface ReflectionEventMetadata {\n  type: \"memory-reflection-event\";\n  reflectionVersion: 4;\n  stage: \"reflect-store\";\n  eventId: string;\n  sessionKey: string;\n  sessionId: string;\n  agentId: string;\n  command: string;\n  storedAt: number;\n  usedFallback: boolean;\n  errorSignals: string[];\n  sourceReflectionPath?: string;\n}\n\nexport interface ReflectionEventPayload {\n  kind: \"event\";\n  text: string;\n  metadata: ReflectionEventMetadata;\n}\n\nexport interface BuildReflectionEventPayloadParams {\n  eventId?: string;\n  scope: string;\n  sessionKey: string;\n  sessionId: string;\n  agentId: string;\n  command: string;\n  toolErrorSignals: ReflectionErrorSignalLike[];\n  runAt: number;\n  usedFallback: boolean;\n  sourceReflectionPath?: string;\n}\n\nexport function createReflectionEventId(params: {\n  runAt: number;\n  sessionKey: string;\n  sessionId: string;\n  agentId: string;\n  command: string;\n}): string {\n  const safeRunAt = Number.isFinite(params.runAt) ? Math.max(0, Math.floor(params.runAt)) : Date.now();\n  const datePart = new Date(safeRunAt).toISOString().replace(/[-:.TZ]/g, \"\").slice(0, 14);\n  const digest = createHash(\"sha1\")\n    .update(`${safeRunAt}|${params.sessionKey}|${params.sessionId}|${params.agentId}|${params.command}`)\n    .digest(\"hex\")\n    .slice(0, 8);\n  return `refl-${datePart}-${digest}`;\n}\n\nexport function buildReflectionEventPayload(params: BuildReflectionEventPayloadParams): ReflectionEventPayload {\n  const eventId = params.eventId || createReflectionEventId({\n    runAt: params.runAt,\n    sessionKey: params.sessionKey,\n    sessionId: params.sessionId,\n    agentId: params.agentId,\n    command: params.command,\n  });\n\n  const metadata: ReflectionEventMetadata = {\n    type: \"memory-reflection-event\",\n    reflectionVersion: REFLECTION_SCHEMA_VERSION,\n    stage: \"reflect-store\",\n    eventId,\n    sessionKey: params.sessionKey,\n    sessionId: params.sessionId,\n    agentId: params.agentId,\n    command: params.command,\n    storedAt: params.runAt,\n    usedFallback: params.usedFallback,\n    errorSignals: params.toolErrorSignals.map((signal) => signal.signatureHash),\n    ...(params.sourceReflectionPath ? { sourceReflectionPath: params.sourceReflectionPath } : {}),\n  };\n\n  const text = [\n    `reflection-event \u00B7 ${params.scope}`,\n    `eventId=${eventId}`,\n    `session=${params.sessionId}`,\n    `agent=${params.agentId}`,\n    `command=${params.command}`,\n    `usedFallback=${params.usedFallback ? \"true\" : \"false\"}`,\n  ].join(\"\\n\");\n\n  return {\n    kind: \"event\",\n    text,\n    metadata,\n  };\n}\n"],
+  "mappings": "AACA,SAAS,kBAAkB;AAEpB,MAAM,4BAA4B;AAwClC,SAAS,wBAAwB,QAM7B;AACT,QAAM,YAAY,OAAO,SAAS,OAAO,KAAK,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI;AACnG,QAAM,WAAW,IAAI,KAAK,SAAS,EAAE,YAAY,EAAE,QAAQ,YAAY,EAAE,EAAE,MAAM,GAAG,EAAE;AACtF,QAAM,SAAS,WAAW,MAAM,EAC7B,OAAO,GAAG,SAAS,IAAI,OAAO,UAAU,IAAI,OAAO,SAAS,IAAI,OAAO,OAAO,IAAI,OAAO,OAAO,EAAE,EAClG,OAAO,KAAK,EACZ,MAAM,GAAG,CAAC;AACb,SAAO,QAAQ,QAAQ,IAAI,MAAM;AACnC;AAEO,SAAS,4BAA4B,QAAmE;AAC7G,QAAM,UAAU,OAAO,WAAW,wBAAwB;AAAA,IACxD,OAAO,OAAO;AAAA,IACd,YAAY,OAAO;AAAA,IACnB,WAAW,OAAO;AAAA,IAClB,SAAS,OAAO;AAAA,IAChB,SAAS,OAAO;AAAA,EAClB,CAAC;AAED,QAAM,WAAoC;AAAA,IACxC,MAAM;AAAA,IACN,mBAAmB;AAAA,IACnB,OAAO;AAAA,IACP;AAAA,IACA,YAAY,OAAO;AAAA,IACnB,WAAW,OAAO;AAAA,IAClB,SAAS,OAAO;AAAA,IAChB,SAAS,OAAO;AAAA,IAChB,UAAU,OAAO;AAAA,IACjB,cAAc,OAAO;AAAA,IACrB,cAAc,OAAO,iBAAiB,IAAI,CAAC,WAAW,OAAO,aAAa;AAAA,IAC1E,GAAI,OAAO,uBAAuB,EAAE,sBAAsB,OAAO,qBAAqB,IAAI,CAAC;AAAA,EAC7F;AAEA,QAAM,OAAO;AAAA,IACX,yBAAsB,OAAO,KAAK;AAAA,IAClC,WAAW,OAAO;AAAA,IAClB,WAAW,OAAO,SAAS;AAAA,IAC3B,SAAS,OAAO,OAAO;AAAA,IACvB,WAAW,OAAO,OAAO;AAAA,IACzB,gBAAgB,OAAO,eAAe,SAAS,OAAO;AAAA,EACxD,EAAE,KAAK,IAAI;AAEX,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/src/reflection-item-store.d.ts

@@ -0,0 +1,58 @@
+import type { ReflectionSliceItem } from "./reflection-slices.js";
+export type ReflectionItemKind = "invariant" | "derived";
+export interface ReflectionItemMetadata {
+    type: "memory-reflection-item";
+    reflectionVersion: 4;
+    stage: "reflect-store";
+    eventId: string;
+    itemKind: ReflectionItemKind;
+    section: "Invariants" | "Derived";
+    ordinal: number;
+    groupSize: number;
+    agentId: string;
+    sessionKey: string;
+    sessionId: string;
+    storedAt: number;
+    usedFallback: boolean;
+    errorSignals: string[];
+    decayModel: "logistic";
+    decayMidpointDays: number;
+    decayK: number;
+    baseWeight: number;
+    quality: number;
+    sourceReflectionPath?: string;
+}
+export interface ReflectionItemPayload {
+    kind: "item-invariant" | "item-derived";
+    text: string;
+    metadata: ReflectionItemMetadata;
+}
+export interface BuildReflectionItemPayloadsParams {
+    items: ReflectionSliceItem[];
+    eventId: string;
+    agentId: string;
+    sessionKey: string;
+    sessionId: string;
+    runAt: number;
+    usedFallback: boolean;
+    toolErrorSignals: Array<{
+        signatureHash: string;
+    }>;
+    sourceReflectionPath?: string;
+}
+export declare const REFLECTION_INVARIANT_DECAY_MIDPOINT_DAYS = 45;
+export declare const REFLECTION_INVARIANT_DECAY_K = 0.22;
+export declare const REFLECTION_INVARIANT_BASE_WEIGHT = 1.1;
+export declare const REFLECTION_INVARIANT_QUALITY = 1;
+export declare const REFLECTION_DERIVED_DECAY_MIDPOINT_DAYS = 7;
+export declare const REFLECTION_DERIVED_DECAY_K = 0.65;
+export declare const REFLECTION_DERIVED_BASE_WEIGHT = 1;
+export declare const REFLECTION_DERIVED_QUALITY = 0.95;
+export declare function getReflectionItemDecayDefaults(itemKind: ReflectionItemKind): {
+    midpointDays: number;
+    k: number;
+    baseWeight: number;
+    quality: number;
+};
+export declare function buildReflectionItemPayloads(params: BuildReflectionItemPayloadsParams): ReflectionItemPayload[];
+//# sourceMappingURL=reflection-item-store.d.ts.map

package/dist/src/reflection-item-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection-item-store.d.ts","sourceRoot":"","sources":["../../src/reflection-item-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,iBAAiB,EAAE,CAAC,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,GAAG,cAAc,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED,MAAM,WAAW,iCAAiC;IAChD,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,KAAK,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,wCAAwC,KAAK,CAAC;AAC3D,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,eAAO,MAAM,sCAAsC,IAAI,CAAC;AACxD,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,kBAAkB,GAAG;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAgBA;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,iCAAiC,GAAG,qBAAqB,EAAE,CAgC9G"}