@mnemoai/core 1.1.0 → 1.1.2

package/dist/src/reflection-store.js

@@ -0,0 +1,407 @@
+import {
+  extractReflectionSliceItems,
+  extractReflectionSlices,
+  sanitizeReflectionSliceLines
+} from "./reflection-slices.js";
+import { parseReflectionMetadata } from "./reflection-metadata.js";
+import { buildReflectionEventPayload, createReflectionEventId } from "./reflection-event-store.js";
+import {
+  buildReflectionItemPayloads,
+  getReflectionItemDecayDefaults,
+  REFLECTION_DERIVED_DECAY_K,
+  REFLECTION_DERIVED_DECAY_MIDPOINT_DAYS,
+  REFLECTION_INVARIANT_DECAY_K,
+  REFLECTION_INVARIANT_DECAY_MIDPOINT_DAYS
+} from "./reflection-item-store.js";
+import { getReflectionMappedDecayDefaults } from "./reflection-mapped-metadata.js";
+import { computeReflectionScore, normalizeReflectionLineForAggregation } from "./reflection-ranking.js";
+const REFLECTION_DERIVE_LOGISTIC_MIDPOINT_DAYS = 3;
+const REFLECTION_DERIVE_LOGISTIC_K = 1.2;
+const REFLECTION_DERIVE_FALLBACK_BASE_WEIGHT = 0.35;
+const DEFAULT_REFLECTION_DERIVED_MAX_AGE_MS = 14 * 24 * 60 * 60 * 1e3;
+const DEFAULT_REFLECTION_MAPPED_MAX_AGE_MS = 60 * 24 * 60 * 60 * 1e3;
+function buildReflectionStorePayloads(params) {
+  const slices = extractReflectionSlices(params.reflectionText);
+  const eventId = params.eventId || createReflectionEventId({
+    runAt: params.runAt,
+    sessionKey: params.sessionKey,
+    sessionId: params.sessionId,
+    agentId: params.agentId,
+    command: params.command
+  });
+  const payloads = [
+    buildReflectionEventPayload({
+      eventId,
+      scope: params.scope,
+      sessionKey: params.sessionKey,
+      sessionId: params.sessionId,
+      agentId: params.agentId,
+      command: params.command,
+      toolErrorSignals: params.toolErrorSignals,
+      runAt: params.runAt,
+      usedFallback: params.usedFallback,
+      sourceReflectionPath: params.sourceReflectionPath
+    })
+  ];
+  const itemPayloads = buildReflectionItemPayloads({
+    items: extractReflectionSliceItems(params.reflectionText),
+    eventId,
+    agentId: params.agentId,
+    sessionKey: params.sessionKey,
+    sessionId: params.sessionId,
+    runAt: params.runAt,
+    usedFallback: params.usedFallback,
+    toolErrorSignals: params.toolErrorSignals,
+    sourceReflectionPath: params.sourceReflectionPath
+  });
+  payloads.push(...itemPayloads);
+  if (params.writeLegacyCombined !== false && (slices.invariants.length > 0 || slices.derived.length > 0)) {
+    payloads.push(buildLegacyCombinedPayload({
+      slices,
+      scope: params.scope,
+      sessionKey: params.sessionKey,
+      sessionId: params.sessionId,
+      agentId: params.agentId,
+      command: params.command,
+      toolErrorSignals: params.toolErrorSignals,
+      runAt: params.runAt,
+      usedFallback: params.usedFallback,
+      sourceReflectionPath: params.sourceReflectionPath
+    }));
+  }
+  return { eventId, slices, payloads };
+}
+function buildLegacyCombinedPayload(params) {
+  const dateYmd = new Date(params.runAt).toISOString().split("T")[0];
+  const deriveQuality = computeDerivedLineQuality(params.slices.derived.length);
+  const deriveBaseWeight = params.usedFallback ? REFLECTION_DERIVE_FALLBACK_BASE_WEIGHT : 1;
+  return {
+    kind: "combined-legacy",
+    text: [
+      `reflection \xB7 ${params.scope} \xB7 ${dateYmd}`,
+      `Session Reflection (${new Date(params.runAt).toISOString()})`,
+      `Session Key: ${params.sessionKey}`,
+      `Session ID: ${params.sessionId}`,
+      "",
+      "Invariants:",
+      ...params.slices.invariants.length > 0 ? params.slices.invariants.map((x) => `- ${x}`) : ["- (none captured)"],
+      "",
+      "Derived:",
+      ...params.slices.derived.length > 0 ? params.slices.derived.map((x) => `- ${x}`) : ["- (none captured)"]
+    ].join("\n"),
+    metadata: {
+      type: "memory-reflection",
+      stage: "reflect-store",
+      reflectionVersion: 3,
+      sessionKey: params.sessionKey,
+      sessionId: params.sessionId,
+      agentId: params.agentId,
+      command: params.command,
+      storedAt: params.runAt,
+      invariants: params.slices.invariants,
+      derived: params.slices.derived,
+      usedFallback: params.usedFallback,
+      errorSignals: params.toolErrorSignals.map((s) => s.signatureHash),
+      decayModel: "logistic",
+      decayMidpointDays: REFLECTION_DERIVE_LOGISTIC_MIDPOINT_DAYS,
+      decayK: REFLECTION_DERIVE_LOGISTIC_K,
+      deriveBaseWeight,
+      deriveQuality,
+      deriveSource: params.usedFallback ? "fallback" : "normal",
+      ...params.sourceReflectionPath ? { sourceReflectionPath: params.sourceReflectionPath } : {}
+    }
+  };
+}
+async function storeReflectionToLanceDB(params) {
+  const { eventId, slices, payloads } = buildReflectionStorePayloads(params);
+  const storedKinds = [];
+  const dedupeThreshold = Number.isFinite(params.dedupeThreshold) ? Number(params.dedupeThreshold) : 0.97;
+  for (const payload of payloads) {
+    const vector = await params.embedPassage(payload.text);
+    if (payload.kind === "combined-legacy") {
+      const existing = await params.vectorSearch(vector, 1, 0.1, [params.scope]);
+      if (existing.length > 0 && existing[0].score > dedupeThreshold) {
+        continue;
+      }
+    }
+    await params.store({
+      text: payload.text,
+      vector,
+      category: "reflection",
+      scope: params.scope,
+      importance: resolveReflectionImportance(payload.kind),
+      metadata: JSON.stringify(payload.metadata)
+    });
+    storedKinds.push(payload.kind);
+  }
+  return { stored: storedKinds.length > 0, eventId, slices, storedKinds };
+}
+function resolveReflectionImportance(kind) {
+  if (kind === "event") return 0.55;
+  if (kind === "item-invariant") return 0.82;
+  if (kind === "item-derived") return 0.78;
+  return 0.75;
+}
+function loadAgentReflectionSlicesFromEntries(params) {
+  const now = Number.isFinite(params.now) ? Number(params.now) : Date.now();
+  const deriveMaxAgeMs = Number.isFinite(params.deriveMaxAgeMs) ? Math.max(0, Number(params.deriveMaxAgeMs)) : DEFAULT_REFLECTION_DERIVED_MAX_AGE_MS;
+  const invariantMaxAgeMs = Number.isFinite(params.invariantMaxAgeMs) ? Math.max(0, Number(params.invariantMaxAgeMs)) : void 0;
+  const reflectionRows = params.entries.map((entry) => ({ entry, metadata: parseReflectionMetadata(entry.metadata) })).filter(({ metadata }) => isReflectionMetadataType(metadata.type) && isOwnedByAgent(metadata, params.agentId)).sort((a, b) => b.entry.timestamp - a.entry.timestamp).slice(0, 160);
+  const itemRows = reflectionRows.filter(({ metadata }) => metadata.type === "memory-reflection-item");
+  const legacyRows = reflectionRows.filter(({ metadata }) => metadata.type === "memory-reflection");
+  const invariantCandidates = buildInvariantCandidates(itemRows, legacyRows);
+  const derivedCandidates = buildDerivedCandidates(itemRows, legacyRows);
+  const invariants = rankReflectionLines(invariantCandidates, {
+    now,
+    maxAgeMs: invariantMaxAgeMs,
+    limit: 8
+  });
+  const derived = rankReflectionLines(derivedCandidates, {
+    now,
+    maxAgeMs: deriveMaxAgeMs,
+    limit: 10
+  });
+  return { invariants, derived };
+}
+function buildInvariantCandidates(itemRows, legacyRows) {
+  const itemCandidates = itemRows.filter(({ metadata }) => metadata.itemKind === "invariant").flatMap(({ entry, metadata }) => {
+    const lines = sanitizeReflectionSliceLines([entry.text]);
+    if (lines.length === 0) return [];
+    const defaults = getReflectionItemDecayDefaults("invariant");
+    const timestamp = metadataTimestamp(metadata, entry.timestamp);
+    return lines.map((line) => ({
+      line,
+      timestamp,
+      midpointDays: readPositiveNumber(metadata.decayMidpointDays, defaults.midpointDays),
+      k: readPositiveNumber(metadata.decayK, defaults.k),
+      baseWeight: readPositiveNumber(metadata.baseWeight, defaults.baseWeight),
+      quality: readClampedNumber(metadata.quality, defaults.quality, 0.2, 1),
+      usedFallback: metadata.usedFallback === true
+    }));
+  });
+  if (itemCandidates.length > 0) return itemCandidates;
+  return legacyRows.flatMap(({ entry, metadata }) => {
+    const defaults = getReflectionItemDecayDefaults("invariant");
+    const timestamp = metadataTimestamp(metadata, entry.timestamp);
+    const lines = sanitizeReflectionSliceLines(toStringArray(metadata.invariants));
+    return lines.map((line) => ({
+      line,
+      timestamp,
+      midpointDays: defaults.midpointDays,
+      k: defaults.k,
+      baseWeight: defaults.baseWeight,
+      quality: defaults.quality,
+      usedFallback: metadata.usedFallback === true
+    }));
+  });
+}
+function buildDerivedCandidates(itemRows, legacyRows) {
+  const itemCandidates = itemRows.filter(({ metadata }) => metadata.itemKind === "derived").flatMap(({ entry, metadata }) => {
+    const lines = sanitizeReflectionSliceLines([entry.text]);
+    if (lines.length === 0) return [];
+    const defaults = getReflectionItemDecayDefaults("derived");
+    const timestamp = metadataTimestamp(metadata, entry.timestamp);
+    return lines.map((line) => ({
+      line,
+      timestamp,
+      midpointDays: readPositiveNumber(metadata.decayMidpointDays, defaults.midpointDays),
+      k: readPositiveNumber(metadata.decayK, defaults.k),
+      baseWeight: readPositiveNumber(metadata.baseWeight, defaults.baseWeight),
+      quality: readClampedNumber(metadata.quality, defaults.quality, 0.2, 1),
+      usedFallback: metadata.usedFallback === true
+    }));
+  });
+  if (itemCandidates.length > 0) return itemCandidates;
+  return legacyRows.flatMap(({ entry, metadata }) => {
+    const timestamp = metadataTimestamp(metadata, entry.timestamp);
+    const lines = sanitizeReflectionSliceLines(toStringArray(metadata.derived));
+    if (lines.length === 0) return [];
+    const defaults = {
+      midpointDays: REFLECTION_DERIVE_LOGISTIC_MIDPOINT_DAYS,
+      k: REFLECTION_DERIVE_LOGISTIC_K,
+      baseWeight: resolveLegacyDeriveBaseWeight(metadata),
+      quality: computeDerivedLineQuality(lines.length)
+    };
+    return lines.map((line) => ({
+      line,
+      timestamp,
+      midpointDays: readPositiveNumber(metadata.decayMidpointDays, defaults.midpointDays),
+      k: readPositiveNumber(metadata.decayK, defaults.k),
+      baseWeight: readPositiveNumber(metadata.deriveBaseWeight, defaults.baseWeight),
+      quality: readClampedNumber(metadata.deriveQuality, defaults.quality, 0.2, 1),
+      usedFallback: metadata.usedFallback === true
+    }));
+  });
+}
+function rankReflectionLines(candidates, options) {
+  const lineScores = /* @__PURE__ */ new Map();
+  for (const candidate of candidates) {
+    const timestamp = Number.isFinite(candidate.timestamp) ? candidate.timestamp : options.now;
+    if (Number.isFinite(options.maxAgeMs) && options.maxAgeMs >= 0 && options.now - timestamp > options.maxAgeMs) {
+      continue;
+    }
+    const ageDays = Math.max(0, (options.now - timestamp) / 864e5);
+    const score = computeReflectionScore({
+      ageDays,
+      midpointDays: candidate.midpointDays,
+      k: candidate.k,
+      baseWeight: candidate.baseWeight,
+      quality: candidate.quality,
+      usedFallback: candidate.usedFallback
+    });
+    if (!Number.isFinite(score) || score <= 0) continue;
+    const key = normalizeReflectionLineForAggregation(candidate.line);
+    if (!key) continue;
+    const current = lineScores.get(key);
+    if (!current) {
+      lineScores.set(key, { line: candidate.line, score, latestTs: timestamp });
+      continue;
+    }
+    current.score += score;
+    if (timestamp > current.latestTs) {
+      current.latestTs = timestamp;
+      current.line = candidate.line;
+    }
+  }
+  return [...lineScores.values()].sort((a, b) => {
+    if (b.score !== a.score) return b.score - a.score;
+    if (b.latestTs !== a.latestTs) return b.latestTs - a.latestTs;
+    return a.line.localeCompare(b.line);
+  }).slice(0, options.limit).map((item) => item.line);
+}
+function isReflectionMetadataType(type) {
+  return type === "memory-reflection-item" || type === "memory-reflection";
+}
+function isOwnedByAgent(metadata, agentId) {
+  const owner = typeof metadata.agentId === "string" ? metadata.agentId.trim() : "";
+  if (!owner) return true;
+  return owner === agentId || owner === "main";
+}
+function toStringArray(value) {
+  if (!Array.isArray(value)) return [];
+  return value.map((item) => String(item).trim()).filter(Boolean);
+}
+function metadataTimestamp(metadata, fallbackTs) {
+  const storedAt = Number(metadata.storedAt);
+  if (Number.isFinite(storedAt) && storedAt > 0) return storedAt;
+  return Number.isFinite(fallbackTs) ? fallbackTs : Date.now();
+}
+function readPositiveNumber(value, fallback) {
+  const num = Number(value);
+  if (!Number.isFinite(num) || num <= 0) return fallback;
+  return num;
+}
+function readClampedNumber(value, fallback, min, max) {
+  const num = Number(value);
+  const resolved = Number.isFinite(num) ? num : fallback;
+  return Math.max(min, Math.min(max, resolved));
+}
+function computeDerivedLineQuality(nonPlaceholderLineCount) {
+  const n = Number.isFinite(nonPlaceholderLineCount) ? Math.max(0, Math.floor(nonPlaceholderLineCount)) : 0;
+  if (n <= 0) return 0.2;
+  return Math.min(1, 0.55 + Math.min(6, n) * 0.075);
+}
+function resolveLegacyDeriveBaseWeight(metadata) {
+  const explicit = Number(metadata.deriveBaseWeight);
+  if (Number.isFinite(explicit) && explicit > 0) {
+    return Math.max(0.1, Math.min(1.2, explicit));
+  }
+  if (metadata.usedFallback === true) {
+    return REFLECTION_DERIVE_FALLBACK_BASE_WEIGHT;
+  }
+  return 1;
+}
+function loadReflectionMappedRowsFromEntries(params) {
+  const now = Number.isFinite(params.now) ? Number(params.now) : Date.now();
+  const maxAgeMs = Number.isFinite(params.maxAgeMs) ? Math.max(0, Number(params.maxAgeMs)) : DEFAULT_REFLECTION_MAPPED_MAX_AGE_MS;
+  const maxPerKind = Number.isFinite(params.maxPerKind) ? Math.max(1, Math.floor(Number(params.maxPerKind))) : 10;
+  const weighted = params.entries.map((entry) => ({ entry, metadata: parseReflectionMetadata(entry.metadata) })).filter(({ metadata }) => metadata.type === "memory-reflection-mapped" && isOwnedByAgent(metadata, params.agentId)).flatMap(({ entry, metadata }) => {
+    const mappedKind = parseMappedKind(metadata.mappedKind);
+    if (!mappedKind) return [];
+    const lines = sanitizeReflectionSliceLines([entry.text]);
+    if (lines.length === 0) return [];
+    const defaults = getReflectionMappedDecayDefaults(mappedKind);
+    const timestamp = metadataTimestamp(metadata, entry.timestamp);
+    return lines.map((line) => ({
+      text: line,
+      mappedKind,
+      timestamp,
+      midpointDays: readPositiveNumber(metadata.decayMidpointDays, defaults.midpointDays),
+      k: readPositiveNumber(metadata.decayK, defaults.k),
+      baseWeight: readPositiveNumber(metadata.baseWeight, defaults.baseWeight),
+      quality: readClampedNumber(metadata.quality, defaults.quality, 0.2, 1),
+      usedFallback: metadata.usedFallback === true
+    }));
+  });
+  const grouped = /* @__PURE__ */ new Map();
+  for (const item of weighted) {
+    if (now - item.timestamp > maxAgeMs) continue;
+    const ageDays = Math.max(0, (now - item.timestamp) / 864e5);
+    const score = computeReflectionScore({
+      ageDays,
+      midpointDays: item.midpointDays,
+      k: item.k,
+      baseWeight: item.baseWeight,
+      quality: item.quality,
+      usedFallback: item.usedFallback
+    });
+    if (!Number.isFinite(score) || score <= 0) continue;
+    const normalized = normalizeReflectionLineForAggregation(item.text);
+    if (!normalized) continue;
+    const key = `${item.mappedKind}::${normalized}`;
+    const current = grouped.get(key);
+    if (!current) {
+      grouped.set(key, { text: item.text, score, latestTs: item.timestamp, kind: item.mappedKind });
+      continue;
+    }
+    current.score += score;
+    if (item.timestamp > current.latestTs) {
+      current.latestTs = item.timestamp;
+      current.text = item.text;
+    }
+  }
+  const sortedByKind = (kind) => [...grouped.values()].filter((row) => row.kind === kind).sort((a, b) => {
+    if (b.score !== a.score) return b.score - a.score;
+    if (b.latestTs !== a.latestTs) return b.latestTs - a.latestTs;
+    return a.text.localeCompare(b.text);
+  }).slice(0, maxPerKind).map((row) => row.text);
+  return {
+    userModel: sortedByKind("user-model"),
+    agentModel: sortedByKind("agent-model"),
+    lesson: sortedByKind("lesson"),
+    decision: sortedByKind("decision")
+  };
+}
+function parseMappedKind(value) {
+  if (value === "user-model" || value === "agent-model" || value === "lesson" || value === "decision") {
+    return value;
+  }
+  return null;
+}
+function getReflectionDerivedDecayDefaults() {
+  return {
+    midpointDays: REFLECTION_DERIVED_DECAY_MIDPOINT_DAYS,
+    k: REFLECTION_DERIVED_DECAY_K
+  };
+}
+function getReflectionInvariantDecayDefaults() {
+  return {
+    midpointDays: REFLECTION_INVARIANT_DECAY_MIDPOINT_DAYS,
+    k: REFLECTION_INVARIANT_DECAY_K
+  };
+}
+export {
+  DEFAULT_REFLECTION_DERIVED_MAX_AGE_MS,
+  DEFAULT_REFLECTION_MAPPED_MAX_AGE_MS,
+  REFLECTION_DERIVE_FALLBACK_BASE_WEIGHT,
+  REFLECTION_DERIVE_LOGISTIC_K,
+  REFLECTION_DERIVE_LOGISTIC_MIDPOINT_DAYS,
+  buildReflectionStorePayloads,
+  computeDerivedLineQuality,
+  getReflectionDerivedDecayDefaults,
+  getReflectionInvariantDecayDefaults,
+  loadAgentReflectionSlicesFromEntries,
+  loadReflectionMappedRowsFromEntries,
+  storeReflectionToLanceDB
+};
+//# sourceMappingURL=reflection-store.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/reflection-store.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: LicenseRef-Mnemo-Pro\nimport type { MemoryEntry, MemorySearchResult } from \"./store.js\";\nimport {\n  extractReflectionSliceItems,\n  extractReflectionSlices,\n  sanitizeReflectionSliceLines,\n  type ReflectionSlices,\n} from \"./reflection-slices.js\";\nimport { parseReflectionMetadata } from \"./reflection-metadata.js\";\nimport { buildReflectionEventPayload, createReflectionEventId } from \"./reflection-event-store.js\";\nimport {\n  buildReflectionItemPayloads,\n  getReflectionItemDecayDefaults,\n  REFLECTION_DERIVED_DECAY_K,\n  REFLECTION_DERIVED_DECAY_MIDPOINT_DAYS,\n  REFLECTION_INVARIANT_DECAY_K,\n  REFLECTION_INVARIANT_DECAY_MIDPOINT_DAYS,\n} from \"./reflection-item-store.js\";\nimport { getReflectionMappedDecayDefaults, type ReflectionMappedKind } from \"./reflection-mapped-metadata.js\";\nimport { computeReflectionScore, normalizeReflectionLineForAggregation } from \"./reflection-ranking.js\";\n\nexport const REFLECTION_DERIVE_LOGISTIC_MIDPOINT_DAYS = 3;\nexport const REFLECTION_DERIVE_LOGISTIC_K = 1.2;\nexport const REFLECTION_DERIVE_FALLBACK_BASE_WEIGHT = 0.35;\n\nexport const DEFAULT_REFLECTION_DERIVED_MAX_AGE_MS = 14 * 24 * 60 * 60 * 1000;\nexport const DEFAULT_REFLECTION_MAPPED_MAX_AGE_MS = 60 * 24 * 60 * 60 * 1000;\n\ntype ReflectionStoreKind = \"event\" | \"item-invariant\" | \"item-derived\" | \"combined-legacy\";\n\ntype ReflectionErrorSignalLike = {\n  signatureHash: string;\n};\n\ninterface ReflectionStorePayload {\n  text: string;\n  metadata: Record<string, unknown>;\n  kind: ReflectionStoreKind;\n}\n\ninterface BuildReflectionStorePayloadsParams {\n  reflectionText: string;\n  sessionKey: string;\n  sessionId: string;\n  agentId: string;\n  command: string;\n  scope: string;\n  toolErrorSignals: ReflectionErrorSignalLike[];\n  runAt: number;\n  usedFallback: boolean;\n  eventId?: string;\n  sourceReflectionPath?: string;\n  writeLegacyCombined?: boolean;\n}\n\nexport function buildReflectionStorePayloads(params: BuildReflectionStorePayloadsParams): {\n  eventId: string;\n  slices: ReflectionSlices;\n  payloads: ReflectionStorePayload[];\n} {\n  const slices = extractReflectionSlices(params.reflectionText);\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 payloads: ReflectionStorePayload[] = [\n    buildReflectionEventPayload({\n      eventId,\n      scope: params.scope,\n      sessionKey: params.sessionKey,\n      sessionId: params.sessionId,\n      agentId: params.agentId,\n      command: params.command,\n      toolErrorSignals: params.toolErrorSignals,\n      runAt: params.runAt,\n      usedFallback: params.usedFallback,\n      sourceReflectionPath: params.sourceReflectionPath,\n    }),\n  ];\n\n  const itemPayloads = buildReflectionItemPayloads({\n    items: extractReflectionSliceItems(params.reflectionText),\n    eventId,\n    agentId: params.agentId,\n    sessionKey: params.sessionKey,\n    sessionId: params.sessionId,\n    runAt: params.runAt,\n    usedFallback: params.usedFallback,\n    toolErrorSignals: params.toolErrorSignals,\n    sourceReflectionPath: params.sourceReflectionPath,\n  });\n  payloads.push(...itemPayloads);\n\n  if (params.writeLegacyCombined !== false && (slices.invariants.length > 0 || slices.derived.length > 0)) {\n    payloads.push(buildLegacyCombinedPayload({\n      slices,\n      scope: params.scope,\n      sessionKey: params.sessionKey,\n      sessionId: params.sessionId,\n      agentId: params.agentId,\n      command: params.command,\n      toolErrorSignals: params.toolErrorSignals,\n      runAt: params.runAt,\n      usedFallback: params.usedFallback,\n      sourceReflectionPath: params.sourceReflectionPath,\n    }));\n  }\n\n  return { eventId, slices, payloads };\n}\n\nfunction buildLegacyCombinedPayload(params: {\n  slices: ReflectionSlices;\n  sessionKey: string;\n  sessionId: string;\n  agentId: string;\n  command: string;\n  scope: string;\n  toolErrorSignals: ReflectionErrorSignalLike[];\n  runAt: number;\n  usedFallback: boolean;\n  sourceReflectionPath?: string;\n}): ReflectionStorePayload {\n  const dateYmd = new Date(params.runAt).toISOString().split(\"T\")[0];\n  const deriveQuality = computeDerivedLineQuality(params.slices.derived.length);\n  const deriveBaseWeight = params.usedFallback ? REFLECTION_DERIVE_FALLBACK_BASE_WEIGHT : 1;\n\n  return {\n    kind: \"combined-legacy\",\n    text: [\n      `reflection \u00B7 ${params.scope} \u00B7 ${dateYmd}`,\n      `Session Reflection (${new Date(params.runAt).toISOString()})`,\n      `Session Key: ${params.sessionKey}`,\n      `Session ID: ${params.sessionId}`,\n      \"\",\n      \"Invariants:\",\n      ...(params.slices.invariants.length > 0 ? params.slices.invariants.map((x) => `- ${x}`) : [\"- (none captured)\"]),\n      \"\",\n      \"Derived:\",\n      ...(params.slices.derived.length > 0 ? params.slices.derived.map((x) => `- ${x}`) : [\"- (none captured)\"]),\n    ].join(\"\\n\"),\n    metadata: {\n      type: \"memory-reflection\",\n      stage: \"reflect-store\",\n      reflectionVersion: 3,\n      sessionKey: params.sessionKey,\n      sessionId: params.sessionId,\n      agentId: params.agentId,\n      command: params.command,\n      storedAt: params.runAt,\n      invariants: params.slices.invariants,\n      derived: params.slices.derived,\n      usedFallback: params.usedFallback,\n      errorSignals: params.toolErrorSignals.map((s) => s.signatureHash),\n      decayModel: \"logistic\",\n      decayMidpointDays: REFLECTION_DERIVE_LOGISTIC_MIDPOINT_DAYS,\n      decayK: REFLECTION_DERIVE_LOGISTIC_K,\n      deriveBaseWeight,\n      deriveQuality,\n      deriveSource: params.usedFallback ? \"fallback\" : \"normal\",\n      ...(params.sourceReflectionPath ? { sourceReflectionPath: params.sourceReflectionPath } : {}),\n    },\n  };\n}\n\ninterface ReflectionStoreDeps {\n  embedPassage: (text: string) => Promise<number[]>;\n  vectorSearch: (\n    vector: number[],\n    limit?: number,\n    minScore?: number,\n    scopeFilter?: string[]\n  ) => Promise<MemorySearchResult[]>;\n  store: (entry: Omit<MemoryEntry, \"id\" | \"timestamp\">) => Promise<MemoryEntry>;\n}\n\ninterface StoreReflectionToLanceDBParams extends BuildReflectionStorePayloadsParams, ReflectionStoreDeps {\n  dedupeThreshold?: number;\n}\n\nexport async function storeReflectionToLanceDB(params: StoreReflectionToLanceDBParams): Promise<{\n  stored: boolean;\n  eventId: string;\n  slices: ReflectionSlices;\n  storedKinds: ReflectionStoreKind[];\n}> {\n  const { eventId, slices, payloads } = buildReflectionStorePayloads(params);\n  const storedKinds: ReflectionStoreKind[] = [];\n  const dedupeThreshold = Number.isFinite(params.dedupeThreshold) ? Number(params.dedupeThreshold) : 0.97;\n\n  for (const payload of payloads) {\n    const vector = await params.embedPassage(payload.text);\n\n    if (payload.kind === \"combined-legacy\") {\n      const existing = await params.vectorSearch(vector, 1, 0.1, [params.scope]);\n      if (existing.length > 0 && existing[0].score > dedupeThreshold) {\n        continue;\n      }\n    }\n\n    await params.store({\n      text: payload.text,\n      vector,\n      category: \"reflection\",\n      scope: params.scope,\n      importance: resolveReflectionImportance(payload.kind),\n      metadata: JSON.stringify(payload.metadata),\n    });\n    storedKinds.push(payload.kind);\n  }\n\n  return { stored: storedKinds.length > 0, eventId, slices, storedKinds };\n}\n\nfunction resolveReflectionImportance(kind: ReflectionStoreKind): number {\n  if (kind === \"event\") return 0.55;\n  if (kind === \"item-invariant\") return 0.82;\n  if (kind === \"item-derived\") return 0.78;\n  return 0.75;\n}\n\nexport interface LoadReflectionSlicesParams {\n  entries: MemoryEntry[];\n  agentId: string;\n  now?: number;\n  deriveMaxAgeMs?: number;\n  invariantMaxAgeMs?: number;\n}\n\nexport function loadAgentReflectionSlicesFromEntries(params: LoadReflectionSlicesParams): {\n  invariants: string[];\n  derived: string[];\n} {\n  const now = Number.isFinite(params.now) ? Number(params.now) : Date.now();\n  const deriveMaxAgeMs = Number.isFinite(params.deriveMaxAgeMs)\n    ? Math.max(0, Number(params.deriveMaxAgeMs))\n    : DEFAULT_REFLECTION_DERIVED_MAX_AGE_MS;\n  const invariantMaxAgeMs = Number.isFinite(params.invariantMaxAgeMs)\n    ? Math.max(0, Number(params.invariantMaxAgeMs))\n    : undefined;\n\n  const reflectionRows = params.entries\n    .map((entry) => ({ entry, metadata: parseReflectionMetadata(entry.metadata) }))\n    .filter(({ metadata }) => isReflectionMetadataType(metadata.type) && isOwnedByAgent(metadata, params.agentId))\n    .sort((a, b) => b.entry.timestamp - a.entry.timestamp)\n    .slice(0, 160);\n\n  const itemRows = reflectionRows.filter(({ metadata }) => metadata.type === \"memory-reflection-item\");\n  const legacyRows = reflectionRows.filter(({ metadata }) => metadata.type === \"memory-reflection\");\n\n  const invariantCandidates = buildInvariantCandidates(itemRows, legacyRows);\n  const derivedCandidates = buildDerivedCandidates(itemRows, legacyRows);\n\n  const invariants = rankReflectionLines(invariantCandidates, {\n    now,\n    maxAgeMs: invariantMaxAgeMs,\n    limit: 8,\n  });\n\n  const derived = rankReflectionLines(derivedCandidates, {\n    now,\n    maxAgeMs: deriveMaxAgeMs,\n    limit: 10,\n  });\n\n  return { invariants, derived };\n}\n\ntype WeightedLineCandidate = {\n  line: string;\n  timestamp: number;\n  midpointDays: number;\n  k: number;\n  baseWeight: number;\n  quality: number;\n  usedFallback: boolean;\n};\n\nfunction buildInvariantCandidates(\n  itemRows: Array<{ entry: MemoryEntry; metadata: Record<string, unknown> }>,\n  legacyRows: Array<{ entry: MemoryEntry; metadata: Record<string, unknown> }>\n): WeightedLineCandidate[] {\n  const itemCandidates = itemRows\n    .filter(({ metadata }) => metadata.itemKind === \"invariant\")\n    .flatMap(({ entry, metadata }) => {\n      const lines = sanitizeReflectionSliceLines([entry.text]);\n      if (lines.length === 0) return [];\n\n      const defaults = getReflectionItemDecayDefaults(\"invariant\");\n      const timestamp = metadataTimestamp(metadata, entry.timestamp);\n      return lines.map((line) => ({\n        line,\n        timestamp,\n        midpointDays: readPositiveNumber(metadata.decayMidpointDays, defaults.midpointDays),\n        k: readPositiveNumber(metadata.decayK, defaults.k),\n        baseWeight: readPositiveNumber(metadata.baseWeight, defaults.baseWeight),\n        quality: readClampedNumber(metadata.quality, defaults.quality, 0.2, 1),\n        usedFallback: metadata.usedFallback === true,\n      }));\n    });\n\n  if (itemCandidates.length > 0) return itemCandidates;\n\n  return legacyRows.flatMap(({ entry, metadata }) => {\n    const defaults = getReflectionItemDecayDefaults(\"invariant\");\n    const timestamp = metadataTimestamp(metadata, entry.timestamp);\n    const lines = sanitizeReflectionSliceLines(toStringArray(metadata.invariants));\n    return lines.map((line) => ({\n      line,\n      timestamp,\n      midpointDays: defaults.midpointDays,\n      k: defaults.k,\n      baseWeight: defaults.baseWeight,\n      quality: defaults.quality,\n      usedFallback: metadata.usedFallback === true,\n    }));\n  });\n}\n\nfunction buildDerivedCandidates(\n  itemRows: Array<{ entry: MemoryEntry; metadata: Record<string, unknown> }>,\n  legacyRows: Array<{ entry: MemoryEntry; metadata: Record<string, unknown> }>\n): WeightedLineCandidate[] {\n  const itemCandidates = itemRows\n    .filter(({ metadata }) => metadata.itemKind === \"derived\")\n    .flatMap(({ entry, metadata }) => {\n      const lines = sanitizeReflectionSliceLines([entry.text]);\n      if (lines.length === 0) return [];\n\n      const defaults = getReflectionItemDecayDefaults(\"derived\");\n      const timestamp = metadataTimestamp(metadata, entry.timestamp);\n      return lines.map((line) => ({\n        line,\n        timestamp,\n        midpointDays: readPositiveNumber(metadata.decayMidpointDays, defaults.midpointDays),\n        k: readPositiveNumber(metadata.decayK, defaults.k),\n        baseWeight: readPositiveNumber(metadata.baseWeight, defaults.baseWeight),\n        quality: readClampedNumber(metadata.quality, defaults.quality, 0.2, 1),\n        usedFallback: metadata.usedFallback === true,\n      }));\n    });\n\n  if (itemCandidates.length > 0) return itemCandidates;\n\n  return legacyRows.flatMap(({ entry, metadata }) => {\n    const timestamp = metadataTimestamp(metadata, entry.timestamp);\n    const lines = sanitizeReflectionSliceLines(toStringArray(metadata.derived));\n    if (lines.length === 0) return [];\n\n    const defaults = {\n      midpointDays: REFLECTION_DERIVE_LOGISTIC_MIDPOINT_DAYS,\n      k: REFLECTION_DERIVE_LOGISTIC_K,\n      baseWeight: resolveLegacyDeriveBaseWeight(metadata),\n      quality: computeDerivedLineQuality(lines.length),\n    };\n\n    return lines.map((line) => ({\n      line,\n      timestamp,\n      midpointDays: readPositiveNumber(metadata.decayMidpointDays, defaults.midpointDays),\n      k: readPositiveNumber(metadata.decayK, defaults.k),\n      baseWeight: readPositiveNumber(metadata.deriveBaseWeight, defaults.baseWeight),\n      quality: readClampedNumber(metadata.deriveQuality, defaults.quality, 0.2, 1),\n      usedFallback: metadata.usedFallback === true,\n    }));\n  });\n}\n\nfunction rankReflectionLines(\n  candidates: WeightedLineCandidate[],\n  options: { now: number; maxAgeMs?: number; limit: number }\n): string[] {\n  type WeightedLine = { line: string; score: number; latestTs: number };\n  const lineScores = new Map<string, WeightedLine>();\n\n  for (const candidate of candidates) {\n    const timestamp = Number.isFinite(candidate.timestamp) ? candidate.timestamp : options.now;\n    if (Number.isFinite(options.maxAgeMs) && options.maxAgeMs! >= 0 && options.now - timestamp > options.maxAgeMs!) {\n      continue;\n    }\n\n    const ageDays = Math.max(0, (options.now - timestamp) / 86_400_000);\n    const score = computeReflectionScore({\n      ageDays,\n      midpointDays: candidate.midpointDays,\n      k: candidate.k,\n      baseWeight: candidate.baseWeight,\n      quality: candidate.quality,\n      usedFallback: candidate.usedFallback,\n    });\n    if (!Number.isFinite(score) || score <= 0) continue;\n\n    const key = normalizeReflectionLineForAggregation(candidate.line);\n    if (!key) continue;\n\n    const current = lineScores.get(key);\n    if (!current) {\n      lineScores.set(key, { line: candidate.line, score, latestTs: timestamp });\n      continue;\n    }\n\n    current.score += score;\n    if (timestamp > current.latestTs) {\n      current.latestTs = timestamp;\n      current.line = candidate.line;\n    }\n  }\n\n  return [...lineScores.values()]\n    .sort((a, b) => {\n      if (b.score !== a.score) return b.score - a.score;\n      if (b.latestTs !== a.latestTs) return b.latestTs - a.latestTs;\n      return a.line.localeCompare(b.line);\n    })\n    .slice(0, options.limit)\n    .map((item) => item.line);\n}\n\nfunction isReflectionMetadataType(type: unknown): boolean {\n  return type === \"memory-reflection-item\" || type === \"memory-reflection\";\n}\n\nfunction isOwnedByAgent(metadata: Record<string, unknown>, agentId: string): boolean {\n  const owner = typeof metadata.agentId === \"string\" ? metadata.agentId.trim() : \"\";\n  if (!owner) return true;\n  return owner === agentId || owner === \"main\";\n}\n\nfunction toStringArray(value: unknown): string[] {\n  if (!Array.isArray(value)) return [];\n  return value\n    .map((item) => String(item).trim())\n    .filter(Boolean);\n}\n\nfunction metadataTimestamp(metadata: Record<string, unknown>, fallbackTs: number): number {\n  const storedAt = Number(metadata.storedAt);\n  if (Number.isFinite(storedAt) && storedAt > 0) return storedAt;\n  return Number.isFinite(fallbackTs) ? fallbackTs : Date.now();\n}\n\nfunction readPositiveNumber(value: unknown, fallback: number): number {\n  const num = Number(value);\n  if (!Number.isFinite(num) || num <= 0) return fallback;\n  return num;\n}\n\nfunction readClampedNumber(value: unknown, fallback: number, min: number, max: number): number {\n  const num = Number(value);\n  const resolved = Number.isFinite(num) ? num : fallback;\n  return Math.max(min, Math.min(max, resolved));\n}\n\nexport function computeDerivedLineQuality(nonPlaceholderLineCount: number): number {\n  const n = Number.isFinite(nonPlaceholderLineCount) ? Math.max(0, Math.floor(nonPlaceholderLineCount)) : 0;\n  if (n <= 0) return 0.2;\n  return Math.min(1, 0.55 + Math.min(6, n) * 0.075);\n}\n\nfunction resolveLegacyDeriveBaseWeight(metadata: Record<string, unknown>): number {\n  const explicit = Number(metadata.deriveBaseWeight);\n  if (Number.isFinite(explicit) && explicit > 0) {\n    return Math.max(0.1, Math.min(1.2, explicit));\n  }\n  if (metadata.usedFallback === true) {\n    return REFLECTION_DERIVE_FALLBACK_BASE_WEIGHT;\n  }\n  return 1;\n}\n\nexport interface LoadReflectionMappedRowsParams {\n  entries: MemoryEntry[];\n  agentId: string;\n  now?: number;\n  maxAgeMs?: number;\n  maxPerKind?: number;\n}\n\nexport interface ReflectionMappedSlices {\n  userModel: string[];\n  agentModel: string[];\n  lesson: string[];\n  decision: string[];\n}\n\nexport function loadReflectionMappedRowsFromEntries(params: LoadReflectionMappedRowsParams): ReflectionMappedSlices {\n  const now = Number.isFinite(params.now) ? Number(params.now) : Date.now();\n  const maxAgeMs = Number.isFinite(params.maxAgeMs)\n    ? Math.max(0, Number(params.maxAgeMs))\n    : DEFAULT_REFLECTION_MAPPED_MAX_AGE_MS;\n  const maxPerKind = Number.isFinite(params.maxPerKind) ? Math.max(1, Math.floor(Number(params.maxPerKind))) : 10;\n\n  type WeightedMapped = {\n    text: string;\n    mappedKind: ReflectionMappedKind;\n    timestamp: number;\n    midpointDays: number;\n    k: number;\n    baseWeight: number;\n    quality: number;\n    usedFallback: boolean;\n  };\n\n  const weighted: WeightedMapped[] = params.entries\n    .map((entry) => ({ entry, metadata: parseReflectionMetadata(entry.metadata) }))\n    .filter(({ metadata }) => metadata.type === \"memory-reflection-mapped\" && isOwnedByAgent(metadata, params.agentId))\n    .flatMap(({ entry, metadata }) => {\n      const mappedKind = parseMappedKind(metadata.mappedKind);\n      if (!mappedKind) return [];\n\n      const lines = sanitizeReflectionSliceLines([entry.text]);\n      if (lines.length === 0) return [];\n\n      const defaults = getReflectionMappedDecayDefaults(mappedKind);\n      const timestamp = metadataTimestamp(metadata, entry.timestamp);\n\n      return lines.map((line) => ({\n        text: line,\n        mappedKind,\n        timestamp,\n        midpointDays: readPositiveNumber(metadata.decayMidpointDays, defaults.midpointDays),\n        k: readPositiveNumber(metadata.decayK, defaults.k),\n        baseWeight: readPositiveNumber(metadata.baseWeight, defaults.baseWeight),\n        quality: readClampedNumber(metadata.quality, defaults.quality, 0.2, 1),\n        usedFallback: metadata.usedFallback === true,\n      }));\n    });\n\n  const grouped = new Map<string, { text: string; score: number; latestTs: number; kind: ReflectionMappedKind }>();\n\n  for (const item of weighted) {\n    if (now - item.timestamp > maxAgeMs) continue;\n    const ageDays = Math.max(0, (now - item.timestamp) / 86_400_000);\n    const score = computeReflectionScore({\n      ageDays,\n      midpointDays: item.midpointDays,\n      k: item.k,\n      baseWeight: item.baseWeight,\n      quality: item.quality,\n      usedFallback: item.usedFallback,\n    });\n    if (!Number.isFinite(score) || score <= 0) continue;\n\n    const normalized = normalizeReflectionLineForAggregation(item.text);\n    if (!normalized) continue;\n\n    const key = `${item.mappedKind}::${normalized}`;\n    const current = grouped.get(key);\n    if (!current) {\n      grouped.set(key, { text: item.text, score, latestTs: item.timestamp, kind: item.mappedKind });\n      continue;\n    }\n\n    current.score += score;\n    if (item.timestamp > current.latestTs) {\n      current.latestTs = item.timestamp;\n      current.text = item.text;\n    }\n  }\n\n  const sortedByKind = (kind: ReflectionMappedKind) => [...grouped.values()]\n    .filter((row) => row.kind === kind)\n    .sort((a, b) => {\n      if (b.score !== a.score) return b.score - a.score;\n      if (b.latestTs !== a.latestTs) return b.latestTs - a.latestTs;\n      return a.text.localeCompare(b.text);\n    })\n    .slice(0, maxPerKind)\n    .map((row) => row.text);\n\n  return {\n    userModel: sortedByKind(\"user-model\"),\n    agentModel: sortedByKind(\"agent-model\"),\n    lesson: sortedByKind(\"lesson\"),\n    decision: sortedByKind(\"decision\"),\n  };\n}\n\nfunction parseMappedKind(value: unknown): ReflectionMappedKind | null {\n  if (value === \"user-model\" || value === \"agent-model\" || value === \"lesson\" || value === \"decision\") {\n    return value;\n  }\n  return null;\n}\n\nexport function getReflectionDerivedDecayDefaults(): { midpointDays: number; k: number } {\n  return {\n    midpointDays: REFLECTION_DERIVED_DECAY_MIDPOINT_DAYS,\n    k: REFLECTION_DERIVED_DECAY_K,\n  };\n}\n\nexport function getReflectionInvariantDecayDefaults(): { midpointDays: number; k: number } {\n  return {\n    midpointDays: REFLECTION_INVARIANT_DECAY_MIDPOINT_DAYS,\n    k: REFLECTION_INVARIANT_DECAY_K,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/resonance-state.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Adaptive Resonance Threshold
+ *
+ * Maintains a sliding window of recent auto-recall top-1 cosine scores
+ * to compute an adaptive resonance gate threshold (P25 of the window).
+ * Persisted to ~/.openclaw/memory/resonance-state.json.
+ */
+/**
+ * Get the adaptive resonance threshold.
+ * - Cold start (< 20 samples): returns default 0.45
+ * - Otherwise: P25 of sliding window, clamped to [0.30, 0.60]
+ */
+export declare function getAdaptiveThreshold(): number;
+/**
+ * Record a top-1 cosine score from an auto-recall probe.
+ * Appends to the sliding window and persists.
+ */
+export declare function recordResonanceScore(score: number): void;
+//# sourceMappingURL=resonance-state.d.ts.map

package/dist/src/resonance-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resonance-state.d.ts","sourceRoot":"","sources":["../../src/resonance-state.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AA4CH;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAY7C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAUxD"}

package/{src/resonance-state.ts → dist/src/resonance-state.js}

@@ -1,85 +1,56 @@
-// SPDX-License-Identifier: MIT
-/**
- * Adaptive Resonance Threshold
- *
- * Maintains a sliding window of recent auto-recall top-1 cosine scores
- * to compute an adaptive resonance gate threshold (P25 of the window).
- * Persisted to ~/.openclaw/memory/resonance-state.json.
- */
-
 import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { join, dirname } from "node:path";
-
 const STATE_PATH = join(homedir(), ".openclaw", "memory", "resonance-state.json");
 const WINDOW_SIZE = 100;
 const COLD_START_MIN = 20;
 const DEFAULT_THRESHOLD = 0.45;
-const THRESHOLD_FLOOR = 0.30;
-const THRESHOLD_CEILING = 0.60;
-
-interface ResonanceStateData {
-  scores: number[];
-}
-
-let cached: ResonanceStateData | null = null;
-
-function loadState(): ResonanceStateData {
+const THRESHOLD_FLOOR = 0.3;
+const THRESHOLD_CEILING = 0.6;
+let cached = null;
+function loadState() {
   if (cached) return cached;
   try {
     const raw = readFileSync(STATE_PATH, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed && Array.isArray(parsed.scores)) {
-      cached = { scores: parsed.scores.filter((s: unknown) => typeof s === "number" && Number.isFinite(s as number)).slice(-WINDOW_SIZE) };
+      cached = { scores: parsed.scores.filter((s) => typeof s === "number" && Number.isFinite(s)).slice(-WINDOW_SIZE) };
       return cached;
     }
   } catch {
-    // file doesn't exist or is corrupted — start fresh
   }
   cached = { scores: [] };
   return cached;
 }
-
-function saveState(state: ResonanceStateData): void {
+function saveState(state) {
   try {
     mkdirSync(dirname(STATE_PATH), { recursive: true });
     writeFileSync(STATE_PATH, JSON.stringify(state), "utf8");
   } catch {
-    // best-effort persistence
   }
 }
-
-/**
- * Get the adaptive resonance threshold.
- * - Cold start (< 20 samples): returns default 0.45
- * - Otherwise: P25 of sliding window, clamped to [0.30, 0.60]
- */
-export function getAdaptiveThreshold(): number {
+function getAdaptiveThreshold() {
   const state = loadState();
   if (state.scores.length < COLD_START_MIN) {
     return DEFAULT_THRESHOLD;
   }
-
-  // Compute P25 (25th percentile)
   const sorted = [...state.scores].sort((a, b) => a - b);
   const idx = Math.floor(sorted.length * 0.25);
   const p25 = sorted[idx];
-
   return Math.min(THRESHOLD_CEILING, Math.max(THRESHOLD_FLOOR, p25));
 }
-
-/**
- * Record a top-1 cosine score from an auto-recall probe.
- * Appends to the sliding window and persists.
- */
-export function recordResonanceScore(score: number): void {
+function recordResonanceScore(score) {
   if (!Number.isFinite(score)) return;
   const state = loadState();
   state.scores.push(score);
-  // Trim to window size
   if (state.scores.length > WINDOW_SIZE) {
     state.scores = state.scores.slice(-WINDOW_SIZE);
   }
   cached = state;
   saveState(state);
 }
+export {
+  getAdaptiveThreshold,
+  recordResonanceScore
+};
+//# sourceMappingURL=resonance-state.js.map

package/dist/src/resonance-state.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/resonance-state.ts"],
+  "sourcesContent": ["// SPDX-License-Identifier: MIT\n/**\n * Adaptive Resonance Threshold\n *\n * Maintains a sliding window of recent auto-recall top-1 cosine scores\n * to compute an adaptive resonance gate threshold (P25 of the window).\n * Persisted to ~/.openclaw/memory/resonance-state.json.\n */\n\nimport { readFileSync, writeFileSync, mkdirSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join, dirname } from \"node:path\";\n\nconst STATE_PATH = join(homedir(), \".openclaw\", \"memory\", \"resonance-state.json\");\nconst WINDOW_SIZE = 100;\nconst COLD_START_MIN = 20;\nconst DEFAULT_THRESHOLD = 0.45;\nconst THRESHOLD_FLOOR = 0.30;\nconst THRESHOLD_CEILING = 0.60;\n\ninterface ResonanceStateData {\n  scores: number[];\n}\n\nlet cached: ResonanceStateData | null = null;\n\nfunction loadState(): ResonanceStateData {\n  if (cached) return cached;\n  try {\n    const raw = readFileSync(STATE_PATH, \"utf8\");\n    const parsed = JSON.parse(raw);\n    if (parsed && Array.isArray(parsed.scores)) {\n      cached = { scores: parsed.scores.filter((s: unknown) => typeof s === \"number\" && Number.isFinite(s as number)).slice(-WINDOW_SIZE) };\n      return cached;\n    }\n  } catch {\n    // file doesn't exist or is corrupted \u2014 start fresh\n  }\n  cached = { scores: [] };\n  return cached;\n}\n\nfunction saveState(state: ResonanceStateData): void {\n  try {\n    mkdirSync(dirname(STATE_PATH), { recursive: true });\n    writeFileSync(STATE_PATH, JSON.stringify(state), \"utf8\");\n  } catch {\n    // best-effort persistence\n  }\n}\n\n/**\n * Get the adaptive resonance threshold.\n * - Cold start (< 20 samples): returns default 0.45\n * - Otherwise: P25 of sliding window, clamped to [0.30, 0.60]\n */\nexport function getAdaptiveThreshold(): number {\n  const state = loadState();\n  if (state.scores.length < COLD_START_MIN) {\n    return DEFAULT_THRESHOLD;\n  }\n\n  // Compute P25 (25th percentile)\n  const sorted = [...state.scores].sort((a, b) => a - b);\n  const idx = Math.floor(sorted.length * 0.25);\n  const p25 = sorted[idx];\n\n  return Math.min(THRESHOLD_CEILING, Math.max(THRESHOLD_FLOOR, p25));\n}\n\n/**\n * Record a top-1 cosine score from an auto-recall probe.\n * Appends to the sliding window and persists.\n */\nexport function recordResonanceScore(score: number): void {\n  if (!Number.isFinite(score)) return;\n  const state = loadState();\n  state.scores.push(score);\n  // Trim to window size\n  if (state.scores.length > WINDOW_SIZE) {\n    state.scores = state.scores.slice(-WINDOW_SIZE);\n  }\n  cached = state;\n  saveState(state);\n}\n"],
+  "mappings": "AASA,SAAS,cAAc,eAAe,iBAAiB;AACvD,SAAS,eAAe;AACxB,SAAS,MAAM,eAAe;AAE9B,MAAM,aAAa,KAAK,QAAQ,GAAG,aAAa,UAAU,sBAAsB;AAChF,MAAM,cAAc;AACpB,MAAM,iBAAiB;AACvB,MAAM,oBAAoB;AAC1B,MAAM,kBAAkB;AACxB,MAAM,oBAAoB;AAM1B,IAAI,SAAoC;AAExC,SAAS,YAAgC;AACvC,MAAI,OAAQ,QAAO;AACnB,MAAI;AACF,UAAM,MAAM,aAAa,YAAY,MAAM;AAC3C,UAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,QAAI,UAAU,MAAM,QAAQ,OAAO,MAAM,GAAG;AAC1C,eAAS,EAAE,QAAQ,OAAO,OAAO,OAAO,CAAC,MAAe,OAAO,MAAM,YAAY,OAAO,SAAS,CAAW,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE;AACnI,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AAAA,EAER;AACA,WAAS,EAAE,QAAQ,CAAC,EAAE;AACtB,SAAO;AACT;AAEA,SAAS,UAAU,OAAiC;AAClD,MAAI;AACF,cAAU,QAAQ,UAAU,GAAG,EAAE,WAAW,KAAK,CAAC;AAClD,kBAAc,YAAY,KAAK,UAAU,KAAK,GAAG,MAAM;AAAA,EACzD,QAAQ;AAAA,EAER;AACF;AAOO,SAAS,uBAA+B;AAC7C,QAAM,QAAQ,UAAU;AACxB,MAAI,MAAM,OAAO,SAAS,gBAAgB;AACxC,WAAO;AAAA,EACT;AAGA,QAAM,SAAS,CAAC,GAAG,MAAM,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AACrD,QAAM,MAAM,KAAK,MAAM,OAAO,SAAS,IAAI;AAC3C,QAAM,MAAM,OAAO,GAAG;AAEtB,SAAO,KAAK,IAAI,mBAAmB,KAAK,IAAI,iBAAiB,GAAG,CAAC;AACnE;AAMO,SAAS,qBAAqB,OAAqB;AACxD,MAAI,CAAC,OAAO,SAAS,KAAK,EAAG;AAC7B,QAAM,QAAQ,UAAU;AACxB,QAAM,OAAO,KAAK,KAAK;AAEvB,MAAI,MAAM,OAAO,SAAS,aAAa;AACrC,UAAM,SAAS,MAAM,OAAO,MAAM,CAAC,WAAW;AAAA,EAChD;AACA,WAAS;AACT,YAAU,KAAK;AACjB;",
+  "names": []
+}