@xopcai/xopc 0.0.25 → 0.0.27

package/dist/src/agent/memory/dreaming/config.js

@@ -1,3 +1,4 @@
+import { DEFAULT_DEEP_CRON, DEFAULT_LIGHT_CRON, DEFAULT_REM_CRON } from "./constants.js";
 //#region src/agent/memory/dreaming/config.ts
 function clampScore(value, fallback) {
 	if (!Number.isFinite(value)) return fallback;
@@ -9,36 +10,77 @@ function toPositiveInt(value, fallback) {
 	const floored = Math.floor(num);
 	return floored > 0 ? floored : fallback;
 }
+function toNonNegInt(value, fallback) {
+	const num = typeof value === "string" ? Number(value) : Number(value);
+	if (!Number.isFinite(num)) return fallback;
+	const floored = Math.floor(num);
+	return floored >= 0 ? floored : fallback;
+}
+function trimmedStringOr(value, fallback) {
+	return typeof value === "string" && value.trim() ? value.trim() : fallback;
+}
+function optionalTrimmedString(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
 /**
-* Dreaming config resolver.
+* Resolve the full three-phase dreaming config from the app Config.
 *
-* NOTE: This reads config through `any` so it can ship before the full schema lands.
-* Expected shape:
-* `agents.defaults.memory.dreaming.{ enabled, frequency, timezone, phases.deep.{minScore,minRecallCount,limit} }`
+* Reads through `any` so it can ship independently of the schema evolution.
+* Expected shape: `agents.defaults.memory.dreaming.{ enabled, frequency, timezone, phases.{light,deep,rem}.* }`
 */
 function resolveDreamingConfig(cfg) {
 	const dreaming = cfg?.agents?.defaults?.memory?.dreaming;
 	const enabled = dreaming?.enabled === true;
-	const frequency = typeof dreaming?.frequency === "string" && dreaming.frequency.trim() ? dreaming.frequency.trim() : "0 3 * * *";
-	const timezone = typeof dreaming?.timezone === "string" && dreaming.timezone.trim() ? dreaming.timezone.trim() : void 0;
-	const deep = dreaming?.phases?.deep ?? dreaming?.deep ?? {};
-	const deepEnabled = deep?.enabled !== false;
-	const minScore = clampScore(Number(deep?.minScore), .8);
-	const minRecallCount = toPositiveInt(deep?.minRecallCount, 3);
-	const limit = toPositiveInt(deep?.limit, 10);
+	const frequency = trimmedStringOr(dreaming?.frequency, DEFAULT_DEEP_CRON);
+	const timezone = optionalTrimmedString(dreaming?.timezone);
+	const lightRaw = dreaming?.phases?.light ?? {};
+	const light = {
+		enabled: enabled && lightRaw?.enabled !== false,
+		cron: trimmedStringOr(lightRaw?.cron, DEFAULT_LIGHT_CRON),
+		lookbackDays: toPositiveInt(lightRaw?.lookbackDays, 2),
+		limit: toNonNegInt(lightRaw?.limit, 100),
+		dedupeSimilarity: clampScore(Number(lightRaw?.dedupeSimilarity), .9)
+	};
+	const deepRaw = dreaming?.phases?.deep ?? {};
+	const deep = {
+		enabled: enabled && deepRaw?.enabled !== false,
+		cron: trimmedStringOr(deepRaw?.cron, frequency),
+		minScore: clampScore(Number(deepRaw?.minScore), .8),
+		minRecallCount: toPositiveInt(deepRaw?.minRecallCount, 3),
+		minUniqueQueries: toPositiveInt(deepRaw?.minUniqueQueries, 3),
+		limit: toNonNegInt(deepRaw?.limit, 10),
+		recencyHalfLifeDays: toPositiveInt(deepRaw?.recencyHalfLifeDays, 14),
+		maxAgeDays: toPositiveInt(deepRaw?.maxAgeDays, 30)
+	};
+	const remRaw = dreaming?.phases?.rem ?? {};
+	const rem = {
+		enabled: enabled && remRaw?.enabled !== false,
+		cron: trimmedStringOr(remRaw?.cron, DEFAULT_REM_CRON),
+		lookbackDays: toPositiveInt(remRaw?.lookbackDays, 7),
+		limit: toNonNegInt(remRaw?.limit, 10),
+		minPatternStrength: clampScore(Number(remRaw?.minPatternStrength), .75)
+	};
 	return {
 		enabled,
 		frequency,
 		...timezone ? { timezone } : {},
-		deep: {
-			enabled: enabled && deepEnabled,
-			minScore,
-			minRecallCount,
-			limit
-		}
+		phases: {
+			light,
+			deep,
+			rem
+		},
+		deep
 	};
 }
+/** Get the cron expression for a specific phase from resolved config. */
+function getPhaseCron(config, phase) {
+	return config.phases[phase].cron;
+}
+/** Check if a specific phase is enabled (global + phase-level). */
+function isPhaseEnabled(config, phase) {
+	return config.enabled && config.phases[phase].enabled;
+}
 //#endregion
-export { resolveDreamingConfig };
+export { getPhaseCron, isPhaseEnabled, resolveDreamingConfig };
 
 //# sourceMappingURL=config.js.map

package/dist/src/agent/memory/dreaming/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":["anyCfg"],"sources":["../../../../../src/agent/memory/dreaming/config.ts"],"sourcesContent":["import type { Config } from '../../../config/schema.js';\n\nexport type DreamingResolvedConfig = {\n  enabled: boolean;\n  frequency: string;\n  timezone?: string;\n  deep: {\n    enabled: boolean;\n    minScore: number;\n    minRecallCount: number;\n    limit: number;\n  };\n};\n\nfunction clampScore(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction toPositiveInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored > 0 ? floored : fallback;\n}\n\n/**\n * Dreaming config resolver.\n *\n * NOTE: This reads config through `any` so it can ship before the full schema lands.\n * Expected shape:\n * `agents.defaults.memory.dreaming.{ enabled, frequency, timezone, phases.deep.{minScore,minRecallCount,limit} }`\n */\nexport function resolveDreamingConfig(cfg: Config | undefined): DreamingResolvedConfig {\n  const anyCfg = cfg as any;\n  const dreaming = anyCfg?.agents?.defaults?.memory?.dreaming;\n  const enabled = dreaming?.enabled === true;\n\n  const frequency =\n    typeof dreaming?.frequency === 'string' && dreaming.frequency.trim()\n      ? dreaming.frequency.trim()\n      : '0 3 * * *';\n  const timezone =\n    typeof dreaming?.timezone === 'string' && dreaming.timezone.trim()\n      ? dreaming.timezone.trim()\n      : undefined;\n\n  const deep = dreaming?.phases?.deep ?? dreaming?.deep ?? {};\n  const deepEnabled = deep?.enabled !== false;\n  const minScore = clampScore(Number(deep?.minScore), 0.8);\n  const minRecallCount = toPositiveInt(deep?.minRecallCount, 3);\n  const limit = toPositiveInt(deep?.limit, 10);\n\n  return {\n    enabled,\n    frequency,\n    ...(timezone ? { timezone } : {}),\n    deep: {\n      enabled: enabled && deepEnabled,\n      minScore,\n      minRecallCount,\n      limit,\n    },\n  };\n}\n\n"],"mappings":";AAcA,SAAS,WAAW,OAAe,UAA0B;AAC3D,KAAI,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;AACpC,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;;AAGxC,SAAS,cAAc,OAAgB,UAA0B;CAC/D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,UAAU,IAAI,UAAU;;;;;;;;;AAUjC,SAAgB,sBAAsB,KAAiD;CAErF,MAAM,WAAWA,KAAQ,QAAQ,UAAU,QAAQ;CACnD,MAAM,UAAU,UAAU,YAAY;CAEtC,MAAM,YACJ,OAAO,UAAU,cAAc,YAAY,SAAS,UAAU,MAAM,GAChE,SAAS,UAAU,MAAM,GACzB;CACN,MAAM,WACJ,OAAO,UAAU,aAAa,YAAY,SAAS,SAAS,MAAM,GAC9D,SAAS,SAAS,MAAM,GACxB,KAAA;CAEN,MAAM,OAAO,UAAU,QAAQ,QAAQ,UAAU,QAAQ,EAAE;CAC3D,MAAM,cAAc,MAAM,YAAY;CACtC,MAAM,WAAW,WAAW,OAAO,MAAM,SAAS,EAAE,GAAI;CACxD,MAAM,iBAAiB,cAAc,MAAM,gBAAgB,EAAE;CAC7D,MAAM,QAAQ,cAAc,MAAM,OAAO,GAAG;AAE5C,QAAO;EACL;EACA;EACA,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;EAChC,MAAM;GACJ,SAAS,WAAW;GACpB;GACA;GACA;GACD;EACF"}
+{"version":3,"file":"config.js","names":["anyCfg"],"sources":["../../../../../src/agent/memory/dreaming/config.ts"],"sourcesContent":["import type { Config } from '../../../config/schema.js';\nimport {\n  DEFAULT_DEEP_CRON,\n  DEFAULT_LIGHT_CRON,\n  DEFAULT_MAX_AGE_DAYS,\n  DEFAULT_RECENCY_HALF_LIFE_DAYS,\n  DEFAULT_REM_CRON,\n  type DreamingPhaseId,\n} from './constants.js';\n\n// ── Phase config types ─────────────────────────────────────────────────\n\nexport type DreamingLightConfig = {\n  enabled: boolean;\n  cron: string;\n  lookbackDays: number;\n  limit: number;\n  dedupeSimilarity: number;\n};\n\nexport type DreamingDeepConfig = {\n  enabled: boolean;\n  cron: string;\n  minScore: number;\n  minRecallCount: number;\n  minUniqueQueries: number;\n  limit: number;\n  recencyHalfLifeDays: number;\n  maxAgeDays: number;\n};\n\nexport type DreamingRemConfig = {\n  enabled: boolean;\n  cron: string;\n  lookbackDays: number;\n  limit: number;\n  minPatternStrength: number;\n};\n\nexport type DreamingResolvedConfig = {\n  enabled: boolean;\n  frequency: string;\n  timezone?: string;\n  phases: {\n    light: DreamingLightConfig;\n    deep: DreamingDeepConfig;\n    rem: DreamingRemConfig;\n  };\n  deep: DreamingDeepConfig;\n};\n\n// ── Helpers ────────────────────────────────────────────────────────────\n\nfunction clampScore(value: number, fallback: number): number {\n  if (!Number.isFinite(value)) return fallback;\n  return Math.max(0, Math.min(1, value));\n}\n\nfunction toPositiveInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored > 0 ? floored : fallback;\n}\n\nfunction toNonNegInt(value: unknown, fallback: number): number {\n  const num = typeof value === 'string' ? Number(value) : Number(value);\n  if (!Number.isFinite(num)) return fallback;\n  const floored = Math.floor(num);\n  return floored >= 0 ? floored : fallback;\n}\n\nfunction trimmedStringOr(value: unknown, fallback: string): string {\n  return typeof value === 'string' && value.trim() ? value.trim() : fallback;\n}\n\nfunction optionalTrimmedString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value.trim() : undefined;\n}\n\n// ── Resolver ───────────────────────────────────────────────────────────\n\n/**\n * Resolve the full three-phase dreaming config from the app Config.\n *\n * Reads through `any` so it can ship independently of the schema evolution.\n * Expected shape: `agents.defaults.memory.dreaming.{ enabled, frequency, timezone, phases.{light,deep,rem}.* }`\n */\nexport function resolveDreamingConfig(cfg: Config | undefined): DreamingResolvedConfig {\n  const anyCfg = cfg as any;\n  const dreaming = anyCfg?.agents?.defaults?.memory?.dreaming;\n  const enabled = dreaming?.enabled === true;\n\n  const frequency = trimmedStringOr(dreaming?.frequency, DEFAULT_DEEP_CRON);\n  const timezone = optionalTrimmedString(dreaming?.timezone);\n\n  // ── Light phase ────────────────────────────────────────────────────\n  const lightRaw = dreaming?.phases?.light ?? {};\n  const light: DreamingLightConfig = {\n    enabled: enabled && lightRaw?.enabled !== false,\n    cron: trimmedStringOr(lightRaw?.cron, DEFAULT_LIGHT_CRON),\n    lookbackDays: toPositiveInt(lightRaw?.lookbackDays, 2),\n    limit: toNonNegInt(lightRaw?.limit, 100),\n    dedupeSimilarity: clampScore(Number(lightRaw?.dedupeSimilarity), 0.9),\n  };\n\n  // ── Deep phase ─────────────────────────────────────────────────────\n  const deepRaw = dreaming?.phases?.deep ?? {};\n  const deep: DreamingDeepConfig = {\n    enabled: enabled && deepRaw?.enabled !== false,\n    cron: trimmedStringOr(deepRaw?.cron, frequency),\n    minScore: clampScore(Number(deepRaw?.minScore), 0.8),\n    minRecallCount: toPositiveInt(deepRaw?.minRecallCount, 3),\n    minUniqueQueries: toPositiveInt(deepRaw?.minUniqueQueries, 3),\n    limit: toNonNegInt(deepRaw?.limit, 10),\n    recencyHalfLifeDays: toPositiveInt(deepRaw?.recencyHalfLifeDays, DEFAULT_RECENCY_HALF_LIFE_DAYS),\n    maxAgeDays: toPositiveInt(deepRaw?.maxAgeDays, DEFAULT_MAX_AGE_DAYS),\n  };\n\n  // ── REM phase ──────────────────────────────────────────────────────\n  const remRaw = dreaming?.phases?.rem ?? {};\n  const rem: DreamingRemConfig = {\n    enabled: enabled && remRaw?.enabled !== false,\n    cron: trimmedStringOr(remRaw?.cron, DEFAULT_REM_CRON),\n    lookbackDays: toPositiveInt(remRaw?.lookbackDays, 7),\n    limit: toNonNegInt(remRaw?.limit, 10),\n    minPatternStrength: clampScore(Number(remRaw?.minPatternStrength), 0.75),\n  };\n\n  return {\n    enabled,\n    frequency,\n    ...(timezone ? { timezone } : {}),\n    phases: { light, deep, rem },\n    deep,\n  };\n}\n\n/** Get the cron expression for a specific phase from resolved config. */\nexport function getPhaseCron(config: DreamingResolvedConfig, phase: DreamingPhaseId): string {\n  return config.phases[phase].cron;\n}\n\n/** Check if a specific phase is enabled (global + phase-level). */\nexport function isPhaseEnabled(config: DreamingResolvedConfig, phase: DreamingPhaseId): boolean {\n  return config.enabled && config.phases[phase].enabled;\n}\n\n"],"mappings":";;AAqDA,SAAS,WAAW,OAAe,UAA0B;AAC3D,KAAI,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;AACpC,QAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,MAAM,CAAC;;AAGxC,SAAS,cAAc,OAAgB,UAA0B;CAC/D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,UAAU,IAAI,UAAU;;AAGjC,SAAS,YAAY,OAAgB,UAA0B;CAC7D,MAAM,MAAM,OAAO,UAAU,WAAW,OAAO,MAAM,GAAG,OAAO,MAAM;AACrE,KAAI,CAAC,OAAO,SAAS,IAAI,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,MAAM,IAAI;AAC/B,QAAO,WAAW,IAAI,UAAU;;AAGlC,SAAS,gBAAgB,OAAgB,UAA0B;AACjE,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG;;AAGpE,SAAS,sBAAsB,OAAoC;AACjE,QAAO,OAAO,UAAU,YAAY,MAAM,MAAM,GAAG,MAAM,MAAM,GAAG,KAAA;;;;;;;;AAWpE,SAAgB,sBAAsB,KAAiD;CAErF,MAAM,WAAWA,KAAQ,QAAQ,UAAU,QAAQ;CACnD,MAAM,UAAU,UAAU,YAAY;CAEtC,MAAM,YAAY,gBAAgB,UAAU,WAAW,kBAAkB;CACzE,MAAM,WAAW,sBAAsB,UAAU,SAAS;CAG1D,MAAM,WAAW,UAAU,QAAQ,SAAS,EAAE;CAC9C,MAAM,QAA6B;EACjC,SAAS,WAAW,UAAU,YAAY;EAC1C,MAAM,gBAAgB,UAAU,MAAM,mBAAmB;EACzD,cAAc,cAAc,UAAU,cAAc,EAAE;EACtD,OAAO,YAAY,UAAU,OAAO,IAAI;EACxC,kBAAkB,WAAW,OAAO,UAAU,iBAAiB,EAAE,GAAI;EACtE;CAGD,MAAM,UAAU,UAAU,QAAQ,QAAQ,EAAE;CAC5C,MAAM,OAA2B;EAC/B,SAAS,WAAW,SAAS,YAAY;EACzC,MAAM,gBAAgB,SAAS,MAAM,UAAU;EAC/C,UAAU,WAAW,OAAO,SAAS,SAAS,EAAE,GAAI;EACpD,gBAAgB,cAAc,SAAS,gBAAgB,EAAE;EACzD,kBAAkB,cAAc,SAAS,kBAAkB,EAAE;EAC7D,OAAO,YAAY,SAAS,OAAO,GAAG;EACtC,qBAAqB,cAAc,SAAS,qBAAA,GAAoD;EAChG,YAAY,cAAc,SAAS,YAAA,GAAiC;EACrE;CAGD,MAAM,SAAS,UAAU,QAAQ,OAAO,EAAE;CAC1C,MAAM,MAAyB;EAC7B,SAAS,WAAW,QAAQ,YAAY;EACxC,MAAM,gBAAgB,QAAQ,MAAM,iBAAiB;EACrD,cAAc,cAAc,QAAQ,cAAc,EAAE;EACpD,OAAO,YAAY,QAAQ,OAAO,GAAG;EACrC,oBAAoB,WAAW,OAAO,QAAQ,mBAAmB,EAAE,IAAK;EACzE;AAED,QAAO;EACL;EACA;EACA,GAAI,WAAW,EAAE,UAAU,GAAG,EAAE;EAChC,QAAQ;GAAE;GAAO;GAAM;GAAK;EAC5B;EACD;;;AAIH,SAAgB,aAAa,QAAgC,OAAgC;AAC3F,QAAO,OAAO,OAAO,OAAO;;;AAI9B,SAAgB,eAAe,QAAgC,OAAiC;AAC9F,QAAO,OAAO,WAAW,OAAO,OAAO,OAAO"}

package/dist/src/agent/memory/dreaming/constants.d.ts

@@ -1,8 +1,29 @@
+export type DreamingPhaseId = 'light' | 'deep' | 'rem';
+export declare const DREAMING_PHASES: readonly DreamingPhaseId[];
 export declare const DREAMING_SWEEP_TOKEN = "__xopc_memory_dreaming_sweep__";
-export declare const DREAMING_CRON_NAME = "Memory Dreaming - Deep Promotion";
+export declare const DREAMING_LIGHT_SWEEP_TOKEN = "__xopc_memory_dreaming_light_sweep__";
+export declare const DREAMING_REM_SWEEP_TOKEN = "__xopc_memory_dreaming_rem_sweep__";
 export declare const DREAMING_CRON_TAG = "[managed-by=xopc.memory.dreaming]";
+export declare const DREAMING_CRON_NAME = "Memory Dreaming - Deep Promotion";
+export declare const DREAMING_LIGHT_CRON_NAME = "Memory Dreaming - Light Sweep";
+export declare const DREAMING_REM_CRON_NAME = "Memory Dreaming - REM Patterns";
+export declare const DEFAULT_DEEP_CRON = "0 3 * * *";
+export declare const DEFAULT_LIGHT_CRON = "0 */6 * * *";
+export declare const DEFAULT_REM_CRON = "0 5 * * 0";
+export declare const DEFAULT_RECENCY_HALF_LIFE_DAYS = 14;
+export declare const DEFAULT_MAX_AGE_DAYS = 30;
+/** Milliseconds in one day (used for time-decay calculations). */
+export declare const MS_PER_DAY = 86400000;
+/** Weight applied to recall-count reinforcement (logarithmic boost). */
+export declare const REINFORCEMENT_WEIGHT = 0.12;
+/** Weight applied to signal-diversity bonus. */
+export declare const DIVERSITY_WEIGHT = 0.08;
+/** Number of signal dimensions used for diversity calculation. */
+export declare const DIVERSITY_DIMENSION_COUNT = 4;
 export declare const DREAMING_DIR_RELATIVE: string;
 export declare const SHORT_TERM_RECALL_STORE_RELATIVE: string;
 export declare const SHORT_TERM_PROMOTION_LOCK_RELATIVE: string;
 export declare const DREAMING_LAST_RUN_RELATIVE: string;
+export declare const DREAMING_EVENTS_LOG_RELATIVE: string;
 export declare const MEMORY_MD_FILENAME = "MEMORY.md";
+export declare const DREAMS_MD_FILENAME = "DREAMS.md";

package/dist/src/agent/memory/dreaming/constants.js

@@ -1,14 +1,38 @@
 import path from "node:path";
 //#region src/agent/memory/dreaming/constants.ts
+const DREAMING_PHASES = [
+	"light",
+	"deep",
+	"rem"
+];
 const DREAMING_SWEEP_TOKEN = "__xopc_memory_dreaming_sweep__";
-const DREAMING_CRON_NAME = "Memory Dreaming - Deep Promotion";
+const DREAMING_LIGHT_SWEEP_TOKEN = "__xopc_memory_dreaming_light_sweep__";
+const DREAMING_REM_SWEEP_TOKEN = "__xopc_memory_dreaming_rem_sweep__";
 const DREAMING_CRON_TAG = "[managed-by=xopc.memory.dreaming]";
+const DREAMING_CRON_NAME = "Memory Dreaming - Deep Promotion";
+const DREAMING_LIGHT_CRON_NAME = "Memory Dreaming - Light Sweep";
+const DREAMING_REM_CRON_NAME = "Memory Dreaming - REM Patterns";
+const DEFAULT_DEEP_CRON = "0 3 * * *";
+const DEFAULT_LIGHT_CRON = "0 */6 * * *";
+const DEFAULT_REM_CRON = "0 5 * * 0";
+const DEFAULT_RECENCY_HALF_LIFE_DAYS = 14;
+const DEFAULT_MAX_AGE_DAYS = 30;
+/** Milliseconds in one day (used for time-decay calculations). */
+const MS_PER_DAY = 864e5;
+/** Weight applied to recall-count reinforcement (logarithmic boost). */
+const REINFORCEMENT_WEIGHT = .12;
+/** Weight applied to signal-diversity bonus. */
+const DIVERSITY_WEIGHT = .08;
+/** Number of signal dimensions used for diversity calculation. */
+const DIVERSITY_DIMENSION_COUNT = 4;
 const DREAMING_DIR_RELATIVE = path.join("memory", ".dreams");
 const SHORT_TERM_RECALL_STORE_RELATIVE = path.join(DREAMING_DIR_RELATIVE, "short-term-recall.json");
 const SHORT_TERM_PROMOTION_LOCK_RELATIVE = path.join(DREAMING_DIR_RELATIVE, "short-term-promotion.lock");
 const DREAMING_LAST_RUN_RELATIVE = path.join(DREAMING_DIR_RELATIVE, "last-run.json");
+const DREAMING_EVENTS_LOG_RELATIVE = path.join(DREAMING_DIR_RELATIVE, "events.jsonl");
 const MEMORY_MD_FILENAME = "MEMORY.md";
+const DREAMS_MD_FILENAME = "DREAMS.md";
 //#endregion
-export { DREAMING_CRON_NAME, DREAMING_CRON_TAG, DREAMING_DIR_RELATIVE, DREAMING_LAST_RUN_RELATIVE, DREAMING_SWEEP_TOKEN, MEMORY_MD_FILENAME, SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE };
+export { DEFAULT_DEEP_CRON, DEFAULT_LIGHT_CRON, DEFAULT_MAX_AGE_DAYS, DEFAULT_RECENCY_HALF_LIFE_DAYS, DEFAULT_REM_CRON, DIVERSITY_DIMENSION_COUNT, DIVERSITY_WEIGHT, DREAMING_CRON_NAME, DREAMING_CRON_TAG, DREAMING_DIR_RELATIVE, DREAMING_EVENTS_LOG_RELATIVE, DREAMING_LAST_RUN_RELATIVE, DREAMING_LIGHT_CRON_NAME, DREAMING_LIGHT_SWEEP_TOKEN, DREAMING_PHASES, DREAMING_REM_CRON_NAME, DREAMING_REM_SWEEP_TOKEN, DREAMING_SWEEP_TOKEN, DREAMS_MD_FILENAME, MEMORY_MD_FILENAME, MS_PER_DAY, REINFORCEMENT_WEIGHT, SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE };
 
 //# sourceMappingURL=constants.js.map

package/dist/src/agent/memory/dreaming/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/constants.ts"],"sourcesContent":["import path from 'node:path';\n\nexport const DREAMING_SWEEP_TOKEN = '__xopc_memory_dreaming_sweep__';\n\nexport const DREAMING_CRON_NAME = 'Memory Dreaming - Deep Promotion';\nexport const DREAMING_CRON_TAG = '[managed-by=xopc.memory.dreaming]';\n\nexport const DREAMING_DIR_RELATIVE = path.join('memory', '.dreams');\nexport const SHORT_TERM_RECALL_STORE_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'short-term-recall.json');\nexport const SHORT_TERM_PROMOTION_LOCK_RELATIVE = path.join(\n  DREAMING_DIR_RELATIVE,\n  'short-term-promotion.lock',\n);\nexport const DREAMING_LAST_RUN_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'last-run.json');\n\nexport const MEMORY_MD_FILENAME = 'MEMORY.md';\n\n"],"mappings":";;AAEA,MAAa,uBAAuB;AAEpC,MAAa,qBAAqB;AAClC,MAAa,oBAAoB;AAEjC,MAAa,wBAAwB,KAAK,KAAK,UAAU,UAAU;AACnE,MAAa,mCAAmC,KAAK,KAAK,uBAAuB,yBAAyB;AAC1G,MAAa,qCAAqC,KAAK,KACrD,uBACA,4BACD;AACD,MAAa,6BAA6B,KAAK,KAAK,uBAAuB,gBAAgB;AAE3F,MAAa,qBAAqB"}
+{"version":3,"file":"constants.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/constants.ts"],"sourcesContent":["import path from 'node:path';\n\n// ── Phase identifiers ──────────────────────────────────────────────────\n\nexport type DreamingPhaseId = 'light' | 'deep' | 'rem';\n\nexport const DREAMING_PHASES: readonly DreamingPhaseId[] = ['light', 'deep', 'rem'] as const;\n\n// ── Sweep tokens (used in cron payloads to trigger each phase) ─────────\n\nexport const DREAMING_SWEEP_TOKEN = '__xopc_memory_dreaming_sweep__';\nexport const DREAMING_LIGHT_SWEEP_TOKEN = '__xopc_memory_dreaming_light_sweep__';\nexport const DREAMING_REM_SWEEP_TOKEN = '__xopc_memory_dreaming_rem_sweep__';\n\n// ── Cron job metadata ──────────────────────────────────────────────────\n\nexport const DREAMING_CRON_TAG = '[managed-by=xopc.memory.dreaming]';\n\nexport const DREAMING_CRON_NAME = 'Memory Dreaming - Deep Promotion';\nexport const DREAMING_LIGHT_CRON_NAME = 'Memory Dreaming - Light Sweep';\nexport const DREAMING_REM_CRON_NAME = 'Memory Dreaming - REM Patterns';\n\n// ── Default cron schedules ─────────────────────────────────────────────\n\nexport const DEFAULT_DEEP_CRON = '0 3 * * *';\nexport const DEFAULT_LIGHT_CRON = '0 */6 * * *';\nexport const DEFAULT_REM_CRON = '0 5 * * 0';\n\n// ── Time-decay defaults ────────────────────────────────────────────────\n\nexport const DEFAULT_RECENCY_HALF_LIFE_DAYS = 14;\nexport const DEFAULT_MAX_AGE_DAYS = 30;\n\n// ── Scoring weights ────────────────────────────────────────────────────\n\n/** Milliseconds in one day (used for time-decay calculations). */\nexport const MS_PER_DAY = 86_400_000;\n\n/** Weight applied to recall-count reinforcement (logarithmic boost). */\nexport const REINFORCEMENT_WEIGHT = 0.12;\n\n/** Weight applied to signal-diversity bonus. */\nexport const DIVERSITY_WEIGHT = 0.08;\n\n/** Number of signal dimensions used for diversity calculation. */\nexport const DIVERSITY_DIMENSION_COUNT = 4;\n\n// ── File paths ─────────────────────────────────────────────────────────\n\nexport const DREAMING_DIR_RELATIVE = path.join('memory', '.dreams');\nexport const SHORT_TERM_RECALL_STORE_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'short-term-recall.json');\nexport const SHORT_TERM_PROMOTION_LOCK_RELATIVE = path.join(\n  DREAMING_DIR_RELATIVE,\n  'short-term-promotion.lock',\n);\nexport const DREAMING_LAST_RUN_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'last-run.json');\nexport const DREAMING_EVENTS_LOG_RELATIVE = path.join(DREAMING_DIR_RELATIVE, 'events.jsonl');\n\nexport const MEMORY_MD_FILENAME = 'MEMORY.md';\nexport const DREAMS_MD_FILENAME = 'DREAMS.md';\n\n"],"mappings":";;AAMA,MAAa,kBAA8C;CAAC;CAAS;CAAQ;CAAM;AAInF,MAAa,uBAAuB;AACpC,MAAa,6BAA6B;AAC1C,MAAa,2BAA2B;AAIxC,MAAa,oBAAoB;AAEjC,MAAa,qBAAqB;AAClC,MAAa,2BAA2B;AACxC,MAAa,yBAAyB;AAItC,MAAa,oBAAoB;AACjC,MAAa,qBAAqB;AAClC,MAAa,mBAAmB;AAIhC,MAAa,iCAAiC;AAC9C,MAAa,uBAAuB;;AAKpC,MAAa,aAAa;;AAG1B,MAAa,uBAAuB;;AAGpC,MAAa,mBAAmB;;AAGhC,MAAa,4BAA4B;AAIzC,MAAa,wBAAwB,KAAK,KAAK,UAAU,UAAU;AACnE,MAAa,mCAAmC,KAAK,KAAK,uBAAuB,yBAAyB;AAC1G,MAAa,qCAAqC,KAAK,KACrD,uBACA,4BACD;AACD,MAAa,6BAA6B,KAAK,KAAK,uBAAuB,gBAAgB;AAC3F,MAAa,+BAA+B,KAAK,KAAK,uBAAuB,eAAe;AAE5F,MAAa,qBAAqB;AAClC,MAAa,qBAAqB"}

package/dist/src/agent/memory/dreaming/deep-promotion.d.ts

@@ -1,13 +1,12 @@
 import { type DreamingStoreEntry } from './short-term-store.js';
-export type DreamingDeepConfig = {
-    enabled: boolean;
-    minScore: number;
-    minRecallCount: number;
-    limit: number;
-};
+import type { DreamingDeepConfig } from './config.js';
+export type { DreamingDeepConfig } from './config.js';
 export type DreamingPromotionCandidate = DreamingStoreEntry & {
     avgScore: number;
+    /** Time-decay-adjusted final score used for ranking. */
     score: number;
+    /** Raw recency decay multiplier (0–1). */
+    recencyDecay: number;
 };
 export declare function runDreamingDeepPromotion(params: {
     workspaceDir: string;

package/dist/src/agent/memory/dreaming/deep-promotion.js

@@ -1,92 +1,17 @@
 import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
-import { DREAMING_LAST_RUN_RELATIVE, MEMORY_MD_FILENAME } from "./constants.js";
+import { MEMORY_MD_FILENAME } from "./constants.js";
+import { clamp01, compareCandidatesByScore, computeCandidateScore, extractPromotionMarkers, isContaminatedSnippet, isExpiredEntry, isoDay, readFileLines, resolveDeepDefaults, sliceRange, snippetHash } from "./utils.js";
 import { loadDreamingStore, saveDreamingStore, withDreamingPromotionLock } from "./short-term-store.js";
+import { emptyDeepPhaseSkipped, writeDreamingDeepLastRun } from "./last-run.js";
 import path from "node:path";
 import fs from "node:fs/promises";
-import { createHash } from "node:crypto";
 //#region src/agent/memory/dreaming/deep-promotion.ts
 init_logger();
 const log = createLogger("Dreaming:Deep");
-function clampScore(value) {
-	if (!Number.isFinite(value)) return 0;
-	return Math.max(0, Math.min(1, value));
-}
-function formatIsoDay(now) {
-	return now.toISOString().slice(0, 10);
-}
-function compareCandidates(a, b) {
-	if (b.score !== a.score) return b.score - a.score;
-	if (b.recallCount !== a.recallCount) return b.recallCount - a.recallCount;
-	const aMs = Date.parse(a.lastRecalledAt);
-	const bMs = Date.parse(b.lastRecalledAt);
-	if (Number.isFinite(aMs) || Number.isFinite(bMs)) {
-		if (bMs !== aMs) return bMs - aMs;
-	}
-	return a.path.localeCompare(b.path);
-}
-function normalizeSnippetForHash(snippet) {
-	return snippet.trim().replace(/\s+/g, " ").replace(/[“”]/g, "\"").replace(/[‘’]/g, "'").toLowerCase().slice(0, 512);
-}
-function snippetHash(snippet) {
-	const normalized = normalizeSnippetForHash(snippet);
-	return createHash("sha1").update(normalized).digest("hex").slice(0, 12);
-}
 function markerForPromotion(key, hash) {
 	return `<!-- xopc-memory-promotion key="${key}" hash="${hash}" -->`;
 }
-function extractPromotionMarkers(memoryText) {
-	const keys = /* @__PURE__ */ new Set();
-	const hashes = /* @__PURE__ */ new Set();
-	for (const match of memoryText.matchAll(/<!--\s*xopc-memory-promotion\b([\s\S]*?)-->/gi)) {
-		const body = match[1] ?? "";
-		const k = body.match(/\bkey\s*=\s*"([^"]+)"/i)?.[1]?.trim();
-		const h = body.match(/\bhash\s*=\s*"([^"]+)"/i)?.[1]?.trim();
-		if (k) keys.add(k);
-		if (h) hashes.add(h);
-	}
-	for (const match of memoryText.matchAll(/<!--\s*xopc-memory-promotion:([^\n]+?)\s*-->/gi)) {
-		const key = match[1]?.trim();
-		if (key) keys.add(key);
-	}
-	return {
-		keys,
-		hashes
-	};
-}
-function isContaminatedSnippet(snippet) {
-	const s = snippet.trim();
-	if (!s) return true;
-	const lower = s.toLowerCase();
-	if ([
-		/\b(system|assistant|tool)\s*:/i,
-		/<\s*(system|assistant|tool)\b/i,
-		/<!--\s*xopc-memory-promotion\b/i,
-		/tool_call_id|toolcallid|function_call|arguments\s*:\s*\{/i,
-		/"tool"\s*:\s*|\btool_name\b|\btool\b\s*results?/i,
-		/you are (an|a)\s+(ai|assistant)|follow these instructions/i,
-		/begin\s+(system prompt|instructions)|end\s+(system prompt|instructions)/i,
-		/```/i,
-		/\b__xopc_/i
-	].some((p) => p.test(s))) return true;
-	if ((s.match(/[{}[\]]/g) ?? []).length >= 12) return true;
-	if ((lower.match(/https?:\/\//g) ?? []).length >= 3) return true;
-	return false;
-}
-async function readFileLines(fullPath) {
-	try {
-		return (await fs.readFile(fullPath, "utf-8")).split(/\r?\n/);
-	} catch (err) {
-		if (err?.code === "ENOENT") return null;
-		throw err;
-	}
-}
-function sliceRange(lines, startLine, endLine) {
-	const startIdx = Math.max(0, startLine - 1);
-	const endIdx = Math.min(lines.length, endLine);
-	if (startIdx >= endIdx) return "";
-	return lines.slice(startIdx, endIdx).map((l) => l.trim()).filter(Boolean).join(" ").replace(/\s+/g, " ").trim().slice(0, 360);
-}
 async function rehydrateSnippet(params) {
 	const lines = await readFileLines(path.join(params.workspaceDir, params.candidate.path));
 	if (!lines) return null;
@@ -100,76 +25,55 @@ async function rehydrateSnippet(params) {
 		endLine
 	};
 }
-function resolveDefaultConfig(overrides) {
-	const enabled = overrides?.enabled === true;
-	const minScore = typeof overrides?.minScore === "number" ? overrides.minScore : .8;
-	const minRecallCount = typeof overrides?.minRecallCount === "number" ? overrides.minRecallCount : 3;
-	const limit = typeof overrides?.limit === "number" ? overrides.limit : 10;
+function buildDeepLastRun(base) {
+	const durationMs = Math.max(0, Date.now() - base.t0);
 	return {
-		enabled,
-		minScore: clampScore(minScore),
-		minRecallCount: Math.max(1, Math.floor(minRecallCount)),
-		limit: Math.max(0, Math.floor(limit))
+		version: 2,
+		phase: "deep",
+		runId: base.runId,
+		startedAt: base.startedAt,
+		finishedAt: base.finishedAt,
+		durationMs,
+		ok: base.ok,
+		reason: base.reason,
+		config: base.config,
+		memoryPath: base.memoryPath,
+		...base.errorMessage ? { errorMessage: base.errorMessage } : {},
+		deep: base.deep
 	};
 }
-async function writeLastRun(params) {
-	const fullPath = path.join(params.workspaceDir, DREAMING_LAST_RUN_RELATIVE);
-	await fs.mkdir(path.dirname(fullPath), { recursive: true });
-	const tmp = `${fullPath}.${process.pid}.${Date.now()}.tmp`;
-	await fs.writeFile(tmp, `${JSON.stringify(params.lastRun, null, 2)}\n`, "utf-8");
-	await fs.rename(tmp, fullPath);
-}
 async function runDreamingDeepPromotion(params) {
-	const cfg = resolveDefaultConfig(params.config);
+	const cfg = resolveDeepDefaults(params.config);
 	const now = params.now ?? /* @__PURE__ */ new Date();
 	const startedAt = now.toISOString();
 	const runId = `${startedAt}:${process.pid}:${Math.random().toString(16).slice(2)}`;
 	const memoryPath = path.join(params.workspaceDir, MEMORY_MD_FILENAME);
-	if (!cfg.enabled) {
-		const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
-		await writeLastRun({
-			workspaceDir: params.workspaceDir,
-			lastRun: {
-				version: 1,
-				runId,
-				startedAt,
-				finishedAt,
-				ok: true,
-				reason: "dreaming mvp disabled",
-				config: cfg,
-				candidates: 0,
-				applied: 0,
-				memoryPath
-			}
-		}).catch(() => void 0);
-		return {
-			ok: true,
-			reason: "dreaming mvp disabled",
-			candidates: 0,
-			applied: 0,
-			memoryPath
-		};
-	}
-	if (cfg.limit === 0) {
+	const t0 = Date.now();
+	const earlyExitReason = !cfg.enabled ? "dreaming disabled" : cfg.limit === 0 ? "dreaming limit=0" : null;
+	if (earlyExitReason) {
 		const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
-		await writeLastRun({
+		const empty = emptyDeepPhaseSkipped();
+		await writeDreamingDeepLastRun({
 			workspaceDir: params.workspaceDir,
-			lastRun: {
-				version: 1,
+			lastRun: buildDeepLastRun({
 				runId,
 				startedAt,
 				finishedAt,
+				t0,
 				ok: true,
-				reason: "dreaming mvp limit=0",
+				reason: earlyExitReason,
 				config: cfg,
-				candidates: 0,
-				applied: 0,
-				memoryPath
-			}
+				memoryPath,
+				deep: {
+					candidatesRanked: 0,
+					applied: 0,
+					skipped: empty
+				}
+			})
 		}).catch(() => void 0);
 		return {
 			ok: true,
-			reason: "dreaming mvp limit=0",
+			reason: earlyExitReason,
 			candidates: 0,
 			applied: 0,
 			memoryPath
@@ -178,27 +82,31 @@ async function runDreamingDeepPromotion(params) {
 	try {
 		const result = await withDreamingPromotionLock(params.workspaceDir, async () => {
 			const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });
+			const nowMs = now.getTime();
 			const ranked = Object.values(store.entries ?? {}).filter((e) => {
 				if (!e || typeof e !== "object") return false;
 				if (e.promotedAt) return false;
 				if (!e.path || !e.path.startsWith("memory/")) return false;
 				if (e.recallCount < cfg.minRecallCount) return false;
-				return clampScore(e.recallCount > 0 ? e.totalScore / e.recallCount : 0) >= cfg.minScore;
+				if ((e.queryHashes?.length ?? 0) < cfg.minUniqueQueries) return false;
+				if (isExpiredEntry(e.lastRecalledAt, nowMs, cfg.maxAgeDays)) return false;
+				return clamp01(e.recallCount > 0 ? e.totalScore / e.recallCount : 0) >= cfg.minScore;
 			}).map((e) => {
-				const avgScore = e.recallCount > 0 ? clampScore(e.totalScore / e.recallCount) : 0;
-				const score = clampScore(avgScore + clampScore(Math.log1p(e.recallCount) / Math.log1p(10)) * .12);
+				const { avgScore, score, recencyDecay } = computeCandidateScore(e, nowMs, cfg.recencyHalfLifeDays);
 				return {
 					...e,
 					avgScore,
-					score
+					score,
+					recencyDecay
 				};
-			}).sort(compareCandidates).slice(0, cfg.limit);
+			}).sort(compareCandidatesByScore).slice(0, cfg.limit);
 			if (ranked.length === 0) return {
 				ok: true,
 				reason: "no eligible candidates",
 				candidates: 0,
 				applied: 0,
-				memoryPath
+				memoryPath,
+				skipped: emptyDeepPhaseSkipped()
 			};
 			const existing = await fs.readFile(memoryPath, "utf-8").catch((err) => {
 				if (err?.code === "ENOENT") return "";
@@ -206,8 +114,10 @@ async function runDreamingDeepPromotion(params) {
 			});
 			const existingMarkers = extractPromotionMarkers(existing);
 			const appliedCandidates = [];
+			const skipped = emptyDeepPhaseSkipped();
 			for (const candidate of ranked) {
 				if (existingMarkers.keys.has(candidate.key)) {
+					skipped.alreadyPromotedKey += 1;
 					const entry = store.entries[candidate.key];
 					if (entry && !entry.promotedAt) entry.promotedAt = now.toISOString();
 					continue;
@@ -216,10 +126,17 @@ async function runDreamingDeepPromotion(params) {
 					workspaceDir: params.workspaceDir,
 					candidate
 				});
-				if (!rehydrated) continue;
-				if (isContaminatedSnippet(rehydrated.snippet)) continue;
+				if (!rehydrated) {
+					skipped.rehydrateFailed += 1;
+					continue;
+				}
+				if (isContaminatedSnippet(rehydrated.snippet)) {
+					skipped.contaminated += 1;
+					continue;
+				}
 				const hash = snippetHash(rehydrated.snippet);
 				if (existingMarkers.hashes.has(hash)) {
+					skipped.hashDuplicate += 1;
 					const entry = store.entries[candidate.key];
 					if (entry && !entry.promotedAt) entry.promotedAt = now.toISOString();
 					continue;
@@ -246,10 +163,11 @@ async function runDreamingDeepPromotion(params) {
 					reason: "candidates were stale or already applied",
 					candidates: ranked.length,
 					applied: 0,
-					memoryPath
+					memoryPath,
+					skipped
 				};
 			}
-			const day = formatIsoDay(now);
+			const day = isoDay(now);
 			const header = existing.trim().length > 0 ? "" : "# Long-Term Memory\n\n";
 			const sectionLines = [
 				"",
@@ -289,44 +207,60 @@ async function runDreamingDeepPromotion(params) {
 				reason: "applied promotions",
 				candidates: ranked.length,
 				applied: appliedCandidates.length,
-				memoryPath
+				memoryPath,
+				skipped
 			};
 		});
 		const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
-		await writeLastRun({
+		const empty = emptyDeepPhaseSkipped();
+		const resultSkipped = "skipped" in result ? result.skipped : empty;
+		await writeDreamingDeepLastRun({
 			workspaceDir: params.workspaceDir,
-			lastRun: {
-				version: 1,
+			lastRun: buildDeepLastRun({
 				runId,
 				startedAt,
 				finishedAt,
+				t0,
 				ok: result.ok,
 				reason: result.reason,
 				config: cfg,
-				candidates: result.candidates,
-				applied: result.applied,
-				memoryPath: result.memoryPath
-			}
+				memoryPath: result.memoryPath,
+				deep: {
+					candidatesRanked: result.candidates,
+					applied: result.applied,
+					skipped: resultSkipped
+				}
+			})
 		}).catch(() => void 0);
-		return result;
+		return {
+			ok: result.ok,
+			reason: result.reason,
+			candidates: result.candidates,
+			applied: result.applied,
+			memoryPath: result.memoryPath
+		};
 	} catch (err) {
 		const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
 		const em = err instanceof Error ? err.message : String(err);
-		await writeLastRun({
+		const z = emptyDeepPhaseSkipped();
+		await writeDreamingDeepLastRun({
 			workspaceDir: params.workspaceDir,
-			lastRun: {
-				version: 1,
+			lastRun: buildDeepLastRun({
 				runId,
 				startedAt,
 				finishedAt,
+				t0,
 				ok: false,
 				reason: "error",
 				config: cfg,
-				candidates: 0,
-				applied: 0,
 				memoryPath,
-				errorMessage: em
-			}
+				errorMessage: em,
+				deep: {
+					candidatesRanked: 0,
+					applied: 0,
+					skipped: z
+				}
+			})
 		}).catch(() => void 0);
 		throw err;
 	}