@xopcai/xopc 0.0.24 → 0.0.26

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

@@ -0,0 +1,86 @@
+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;
+	return Math.max(0, Math.min(1, value));
+}
+function toPositiveInt(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 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;
+}
+/**
+* Resolve the full three-phase dreaming config from the app Config.
+*
+* 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 = 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 } : {},
+		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 { getPhaseCron, isPhaseEnabled, resolveDreamingConfig };
+
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +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_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

@@ -0,0 +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_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 { 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,21 @@
+import { type DreamingStoreEntry } from './short-term-store.js';
+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;
+    config?: Partial<DreamingDeepConfig>;
+    now?: Date;
+}): Promise<{
+    ok: boolean;
+    reason: string;
+    candidates: number;
+    applied: number;
+    memoryPath: string;
+}>;

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

@@ -0,0 +1,271 @@
+import { createLogger } from "../../../utils/logger/index.js";
+import { init_logger } from "../../../utils/logger.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";
+//#region src/agent/memory/dreaming/deep-promotion.ts
+init_logger();
+const log = createLogger("Dreaming:Deep");
+function markerForPromotion(key, hash) {
+	return `<!-- xopc-memory-promotion key="${key}" hash="${hash}" -->`;
+}
+async function rehydrateSnippet(params) {
+	const lines = await readFileLines(path.join(params.workspaceDir, params.candidate.path));
+	if (!lines) return null;
+	const startLine = Math.max(1, Math.floor(params.candidate.startLine));
+	const endLine = Math.max(startLine, Math.floor(params.candidate.endLine));
+	const snippet = sliceRange(lines, startLine, endLine);
+	if (!snippet) return null;
+	return {
+		snippet,
+		startLine,
+		endLine
+	};
+}
+function buildDeepLastRun(base) {
+	const durationMs = Math.max(0, Date.now() - base.t0);
+	return {
+		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 runDreamingDeepPromotion(params) {
+	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);
+	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();
+		const empty = emptyDeepPhaseSkipped();
+		await writeDreamingDeepLastRun({
+			workspaceDir: params.workspaceDir,
+			lastRun: buildDeepLastRun({
+				runId,
+				startedAt,
+				finishedAt,
+				t0,
+				ok: true,
+				reason: earlyExitReason,
+				config: cfg,
+				memoryPath,
+				deep: {
+					candidatesRanked: 0,
+					applied: 0,
+					skipped: empty
+				}
+			})
+		}).catch(() => void 0);
+		return {
+			ok: true,
+			reason: earlyExitReason,
+			candidates: 0,
+			applied: 0,
+			memoryPath
+		};
+	}
+	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;
+				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, score, recencyDecay } = computeCandidateScore(e, nowMs, cfg.recencyHalfLifeDays);
+				return {
+					...e,
+					avgScore,
+					score,
+					recencyDecay
+				};
+			}).sort(compareCandidatesByScore).slice(0, cfg.limit);
+			if (ranked.length === 0) return {
+				ok: true,
+				reason: "no eligible candidates",
+				candidates: 0,
+				applied: 0,
+				memoryPath,
+				skipped: emptyDeepPhaseSkipped()
+			};
+			const existing = await fs.readFile(memoryPath, "utf-8").catch((err) => {
+				if (err?.code === "ENOENT") return "";
+				throw err;
+			});
+			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;
+				}
+				const rehydrated = await rehydrateSnippet({
+					workspaceDir: params.workspaceDir,
+					candidate
+				});
+				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;
+				}
+				appliedCandidates.push({
+					key: candidate.key,
+					hash,
+					snippet: rehydrated.snippet,
+					path: candidate.path,
+					startLine: rehydrated.startLine,
+					endLine: rehydrated.endLine,
+					score: candidate.score,
+					recallCount: candidate.recallCount,
+					avgScore: candidate.avgScore
+				});
+			}
+			if (appliedCandidates.length === 0) {
+				await saveDreamingStore({
+					workspaceDir: params.workspaceDir,
+					store
+				});
+				return {
+					ok: true,
+					reason: "candidates were stale or already applied",
+					candidates: ranked.length,
+					applied: 0,
+					memoryPath,
+					skipped
+				};
+			}
+			const day = isoDay(now);
+			const header = existing.trim().length > 0 ? "" : "# Long-Term Memory\n\n";
+			const sectionLines = [
+				"",
+				`## Promoted From Short-Term Memory (${day})`,
+				""
+			];
+			for (const c of appliedCandidates) {
+				const src = `${c.path}:${c.startLine}-${c.endLine}`;
+				sectionLines.push(markerForPromotion(c.key, c.hash));
+				sectionLines.push(`- ${c.snippet} [score=${c.score.toFixed(3)} recalls=${c.recallCount} avg=${c.avgScore.toFixed(3)} source=${src}]`);
+			}
+			sectionLines.push("");
+			const next = `${header}${existing.endsWith("\n") || existing.length === 0 ? existing : `${existing}\n`}${sectionLines.join("\n")}`;
+			await fs.writeFile(memoryPath, next, "utf-8");
+			const nowIso = now.toISOString();
+			for (const c of appliedCandidates) {
+				const entry = store.entries[c.key];
+				if (entry) {
+					entry.promotedAt = nowIso;
+					entry.snippet = c.snippet;
+					entry.startLine = c.startLine;
+					entry.endLine = c.endLine;
+				}
+			}
+			store.updatedAt = nowIso;
+			await saveDreamingStore({
+				workspaceDir: params.workspaceDir,
+				store
+			});
+			log.info({
+				workspaceDir: params.workspaceDir,
+				candidates: ranked.length,
+				applied: appliedCandidates.length
+			}, "Dreaming deep promotion complete");
+			return {
+				ok: true,
+				reason: "applied promotions",
+				candidates: ranked.length,
+				applied: appliedCandidates.length,
+				memoryPath,
+				skipped
+			};
+		});
+		const finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+		const empty = emptyDeepPhaseSkipped();
+		const resultSkipped = "skipped" in result ? result.skipped : empty;
+		await writeDreamingDeepLastRun({
+			workspaceDir: params.workspaceDir,
+			lastRun: buildDeepLastRun({
+				runId,
+				startedAt,
+				finishedAt,
+				t0,
+				ok: result.ok,
+				reason: result.reason,
+				config: cfg,
+				memoryPath: result.memoryPath,
+				deep: {
+					candidatesRanked: result.candidates,
+					applied: result.applied,
+					skipped: resultSkipped
+				}
+			})
+		}).catch(() => void 0);
+		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);
+		const z = emptyDeepPhaseSkipped();
+		await writeDreamingDeepLastRun({
+			workspaceDir: params.workspaceDir,
+			lastRun: buildDeepLastRun({
+				runId,
+				startedAt,
+				finishedAt,
+				t0,
+				ok: false,
+				reason: "error",
+				config: cfg,
+				memoryPath,
+				errorMessage: em,
+				deep: {
+					candidatesRanked: 0,
+					applied: 0,
+					skipped: z
+				}
+			})
+		}).catch(() => void 0);
+		throw err;
+	}
+}
+//#endregion
+export { runDreamingDeepPromotion };
+
+//# sourceMappingURL=deep-promotion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deep-promotion.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/deep-promotion.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { MEMORY_MD_FILENAME } from './constants.js';\nimport {\n  loadDreamingStore,\n  saveDreamingStore,\n  withDreamingPromotionLock,\n  type DreamingStoreEntry,\n} from './short-term-store.js';\nimport {\n  DREAMING_LAST_RUN_FORMAT_VERSION,\n  emptyDeepPhaseSkipped,\n  writeDreamingDeepLastRun,\n  type DreamingDeepLastRun,\n  type DreamingDeepPhaseSkipped,\n} from './last-run.js';\nimport type { DreamingDeepConfig } from './config.js';\nimport {\n  clamp01,\n  compareCandidatesByScore,\n  computeCandidateScore,\n  extractPromotionMarkers,\n  isContaminatedSnippet,\n  isExpiredEntry,\n  isoDay,\n  readFileLines,\n  resolveDeepDefaults,\n  sliceRange,\n  snippetHash,\n} from './utils.js';\n\nconst log = createLogger('Dreaming:Deep');\n\nexport type { DreamingDeepConfig } from './config.js';\n\nexport type DreamingPromotionCandidate = DreamingStoreEntry & {\n  avgScore: number;\n  /** Time-decay-adjusted final score used for ranking. */\n  score: number;\n  /** Raw recency decay multiplier (0–1). */\n  recencyDecay: number;\n};\n\n\nfunction markerForPromotion(key: string, hash: string): string {\n  // Quote values to allow spaces/colons in key.\n  return `<!-- xopc-memory-promotion key=\"${key}\" hash=\"${hash}\" -->`;\n}\n\n\nasync function rehydrateSnippet(params: {\n  workspaceDir: string;\n  candidate: DreamingPromotionCandidate;\n}): Promise<{ snippet: string; startLine: number; endLine: number } | null> {\n  const fullPath = path.join(params.workspaceDir, params.candidate.path);\n  const lines = await readFileLines(fullPath);\n  if (!lines) return null;\n\n  const startLine = Math.max(1, Math.floor(params.candidate.startLine));\n  const endLine = Math.max(startLine, Math.floor(params.candidate.endLine));\n  const snippet = sliceRange(lines, startLine, endLine);\n  if (!snippet) return null;\n  return { snippet, startLine, endLine };\n}\n\n\nfunction buildDeepLastRun(base: {\n  runId: string;\n  startedAt: string;\n  finishedAt: string;\n  t0: number;\n  ok: boolean;\n  reason: string;\n  config: DreamingDeepConfig;\n  memoryPath: string;\n  errorMessage?: string;\n  deep: DreamingDeepLastRun['deep'];\n}): DreamingDeepLastRun {\n  const durationMs = Math.max(0, Date.now() - base.t0);\n  return {\n    version: DREAMING_LAST_RUN_FORMAT_VERSION,\n    phase: 'deep',\n    runId: base.runId,\n    startedAt: base.startedAt,\n    finishedAt: base.finishedAt,\n    durationMs,\n    ok: base.ok,\n    reason: base.reason,\n    config: base.config,\n    memoryPath: base.memoryPath,\n    ...(base.errorMessage ? { errorMessage: base.errorMessage } : {}),\n    deep: base.deep,\n  };\n}\n\nexport async function runDreamingDeepPromotion(params: {\n  workspaceDir: string;\n  config?: Partial<DreamingDeepConfig>;\n  now?: Date;\n}): Promise<{\n  ok: boolean;\n  reason: string;\n  candidates: number;\n  applied: number;\n  memoryPath: string;\n}> {\n  const cfg = resolveDeepDefaults(params.config);\n  const now = params.now ?? new Date();\n  const startedAt = now.toISOString();\n  const runId = `${startedAt}:${process.pid}:${Math.random().toString(16).slice(2)}`;\n  const memoryPath = path.join(params.workspaceDir, MEMORY_MD_FILENAME);\n  const t0 = Date.now();\n\n  // Early exit for disabled or zero-limit configurations.\n  const earlyExitReason = !cfg.enabled ? 'dreaming disabled' : cfg.limit === 0 ? 'dreaming limit=0' : null;\n  if (earlyExitReason) {\n    const finishedAt = new Date().toISOString();\n    const empty = emptyDeepPhaseSkipped();\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: true,\n        reason: earlyExitReason,\n        config: cfg,\n        memoryPath,\n        deep: { candidatesRanked: 0, applied: 0, skipped: empty },\n      }),\n    }).catch(() => undefined);\n    return { ok: true, reason: earlyExitReason, candidates: 0, applied: 0, memoryPath };\n  }\n\n  try {\n    const result = await withDreamingPromotionLock(params.workspaceDir, async () => {\n      const { store } = await loadDreamingStore({ workspaceDir: params.workspaceDir });\n\n      const nowMs = now.getTime();\n\n      const all = Object.values(store.entries ?? {}).filter((e): e is DreamingStoreEntry => {\n        if (!e || typeof e !== 'object') return false;\n        if (e.promotedAt) return false;\n        if (!e.path || !e.path.startsWith('memory/')) return false;\n        if (e.recallCount < cfg.minRecallCount) return false;\n        // Require minimum unique queries to avoid single-query inflation.\n        if ((e.queryHashes?.length ?? 0) < cfg.minUniqueQueries) return false;\n        // Expire entries older than maxAgeDays since last recall.\n        if (isExpiredEntry(e.lastRecalledAt, nowMs, cfg.maxAgeDays)) return false;\n        const avg = e.recallCount > 0 ? e.totalScore / e.recallCount : 0;\n        return clamp01(avg) >= cfg.minScore;\n      });\n\n      const ranked: DreamingPromotionCandidate[] = all\n        .map((e) => {\n          const { avgScore, score, recencyDecay } = computeCandidateScore(e, nowMs, cfg.recencyHalfLifeDays);\n          return { ...e, avgScore, score, recencyDecay };\n        })\n        .sort(compareCandidatesByScore)\n        .slice(0, cfg.limit);\n\n      if (ranked.length === 0) {\n        const z = emptyDeepPhaseSkipped();\n        return { ok: true, reason: 'no eligible candidates', candidates: 0, applied: 0, memoryPath, skipped: z };\n      }\n\n      const existing = await fs.readFile(memoryPath, 'utf-8').catch((err: unknown) => {\n        if ((err as NodeJS.ErrnoException | undefined)?.code === 'ENOENT') return '';\n        throw err;\n      });\n      const existingMarkers = extractPromotionMarkers(existing);\n\n      const appliedCandidates: Array<{\n        key: string;\n        hash: string;\n        snippet: string;\n        path: string;\n        startLine: number;\n        endLine: number;\n        score: number;\n        recallCount: number;\n        avgScore: number;\n      }> = [];\n\n      const skipped: DreamingDeepPhaseSkipped = emptyDeepPhaseSkipped();\n      for (const candidate of ranked) {\n        if (existingMarkers.keys.has(candidate.key)) {\n          skipped.alreadyPromotedKey += 1;\n          // Treat as already applied; mark promotedAt for idempotency and keep going.\n          const entry = store.entries[candidate.key];\n          if (entry && !entry.promotedAt) {\n            entry.promotedAt = now.toISOString();\n          }\n          continue;\n        }\n        const rehydrated = await rehydrateSnippet({ workspaceDir: params.workspaceDir, candidate });\n        if (!rehydrated) {\n          skipped.rehydrateFailed += 1;\n          continue;\n        }\n        if (isContaminatedSnippet(rehydrated.snippet)) {\n          skipped.contaminated += 1;\n          continue;\n        }\n        const hash = snippetHash(rehydrated.snippet);\n        if (existingMarkers.hashes.has(hash)) {\n          skipped.hashDuplicate += 1;\n          // Already promoted (possibly from a different key/line range). Mark promoted for idempotency.\n          const entry = store.entries[candidate.key];\n          if (entry && !entry.promotedAt) {\n            entry.promotedAt = now.toISOString();\n          }\n          continue;\n        }\n        appliedCandidates.push({\n          key: candidate.key,\n        hash,\n          snippet: rehydrated.snippet,\n          path: candidate.path,\n          startLine: rehydrated.startLine,\n          endLine: rehydrated.endLine,\n          score: candidate.score,\n          recallCount: candidate.recallCount,\n          avgScore: candidate.avgScore,\n        });\n      }\n\n      if (appliedCandidates.length === 0) {\n        await saveDreamingStore({ workspaceDir: params.workspaceDir, store });\n        return {\n          ok: true,\n          reason: 'candidates were stale or already applied',\n          candidates: ranked.length,\n          applied: 0,\n          memoryPath,\n          skipped,\n        };\n      }\n\n      const day = isoDay(now);\n      const header = existing.trim().length > 0 ? '' : '# Long-Term Memory\\n\\n';\n      const sectionLines: string[] = ['', `## Promoted From Short-Term Memory (${day})`, ''];\n      for (const c of appliedCandidates) {\n        const src = `${c.path}:${c.startLine}-${c.endLine}`;\n        sectionLines.push(markerForPromotion(c.key, c.hash));\n        sectionLines.push(\n          `- ${c.snippet} [score=${c.score.toFixed(3)} recalls=${c.recallCount} avg=${c.avgScore.toFixed(3)} source=${src}]`,\n        );\n      }\n      sectionLines.push('');\n\n      const next = `${header}${existing.endsWith('\\n') || existing.length === 0 ? existing : `${existing}\\n`}${sectionLines.join('\\n')}`;\n      await fs.writeFile(memoryPath, next, 'utf-8');\n\n      const nowIso = now.toISOString();\n      for (const c of appliedCandidates) {\n        const entry = store.entries[c.key];\n        if (entry) {\n          entry.promotedAt = nowIso;\n          entry.snippet = c.snippet;\n          entry.startLine = c.startLine;\n          entry.endLine = c.endLine;\n        }\n      }\n      store.updatedAt = nowIso;\n      await saveDreamingStore({ workspaceDir: params.workspaceDir, store });\n\n      log.info(\n        { workspaceDir: params.workspaceDir, candidates: ranked.length, applied: appliedCandidates.length },\n        'Dreaming deep promotion complete',\n      );\n\n      return {\n        ok: true,\n        reason: 'applied promotions',\n        candidates: ranked.length,\n        applied: appliedCandidates.length,\n        memoryPath,\n        skipped,\n      };\n    });\n\n    const finishedAt = new Date().toISOString();\n    const empty = emptyDeepPhaseSkipped();\n    const resultSkipped = 'skipped' in result ? result.skipped : empty;\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: result.ok,\n        reason: result.reason,\n        config: cfg,\n        memoryPath: result.memoryPath,\n        deep: {\n          candidatesRanked: result.candidates,\n          applied: result.applied,\n          skipped: resultSkipped,\n        },\n      }),\n    }).catch(() => undefined);\n\n    return {\n      ok: result.ok,\n      reason: result.reason,\n      candidates: result.candidates,\n      applied: result.applied,\n      memoryPath: result.memoryPath,\n    };\n  } catch (err) {\n    const finishedAt = new Date().toISOString();\n    const em = err instanceof Error ? err.message : String(err);\n    const z = emptyDeepPhaseSkipped();\n    await writeDreamingDeepLastRun({\n      workspaceDir: params.workspaceDir,\n      lastRun: buildDeepLastRun({\n        runId,\n        startedAt,\n        finishedAt,\n        t0,\n        ok: false,\n        reason: 'error',\n        config: cfg,\n        memoryPath,\n        errorMessage: em,\n        deep: { candidatesRanked: 0, applied: 0, skipped: z },\n      }),\n    }).catch(() => undefined);\n    throw err;\n  }\n}\n\n"],"mappings":"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"}

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

@@ -0,0 +1,36 @@
+import { type DreamingPhaseId } from './constants.js';
+export type DreamingEventBase = {
+    timestamp: string;
+    phase: DreamingPhaseId;
+    ok: boolean;
+    reason: string;
+    durationMs: number;
+};
+export type DreamingLightEvent = DreamingEventBase & {
+    phase: 'light';
+    scannedEntries: number;
+    newSignals: number;
+    deduped: number;
+};
+export type DreamingDeepEvent = DreamingEventBase & {
+    phase: 'deep';
+    candidates: number;
+    applied: number;
+};
+export type DreamingRemEvent = DreamingEventBase & {
+    phase: 'rem';
+    patternsDiscovered: number;
+    entriesAnalyzed: number;
+};
+export type DreamingEvent = DreamingLightEvent | DreamingDeepEvent | DreamingRemEvent;
+/**
+ * Append a single event line to `memory/.dreams/events.jsonl`.
+ * Creates the directory and file if they don't exist.
+ * Failures are silently ignored so audit logging never blocks execution.
+ */
+export declare function appendDreamingEvent(workspaceDir: string, event: DreamingEvent): Promise<void>;
+/**
+ * Read the most recent N events from the events log.
+ * Returns newest-first. If the file doesn't exist, returns an empty array.
+ */
+export declare function readDreamingEvents(workspaceDir: string, limit?: number): Promise<DreamingEvent[]>;

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

@@ -0,0 +1,44 @@
+import { DREAMING_DIR_RELATIVE, DREAMING_EVENTS_LOG_RELATIVE } from "./constants.js";
+import path from "node:path";
+import fs from "node:fs/promises";
+//#region src/agent/memory/dreaming/events.ts
+/**
+* Append a single event line to `memory/.dreams/events.jsonl`.
+* Creates the directory and file if they don't exist.
+* Failures are silently ignored so audit logging never blocks execution.
+*/
+async function appendDreamingEvent(workspaceDir, event) {
+	try {
+		const dirPath = path.join(workspaceDir, DREAMING_DIR_RELATIVE);
+		await fs.mkdir(dirPath, { recursive: true });
+		const filePath = path.join(workspaceDir, DREAMING_EVENTS_LOG_RELATIVE);
+		const line = JSON.stringify(event) + "\n";
+		await fs.appendFile(filePath, line, "utf-8");
+	} catch {}
+}
+/**
+* Read the most recent N events from the events log.
+* Returns newest-first. If the file doesn't exist, returns an empty array.
+*/
+async function readDreamingEvents(workspaceDir, limit = 50) {
+	const filePath = path.join(workspaceDir, DREAMING_EVENTS_LOG_RELATIVE);
+	let raw;
+	try {
+		raw = await fs.readFile(filePath, "utf-8");
+	} catch (err) {
+		if (err?.code === "ENOENT") return [];
+		throw err;
+	}
+	const tail = raw.split("\n").map((line) => line.trim()).filter(Boolean).slice(-Math.abs(limit));
+	const events = [];
+	for (const line of tail) try {
+		const parsed = JSON.parse(line);
+		if (parsed && typeof parsed === "object" && parsed.timestamp && parsed.phase) events.push(parsed);
+	} catch {}
+	events.reverse();
+	return events;
+}
+//#endregion
+export { appendDreamingEvent, readDreamingEvents };
+
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../../../../../src/agent/memory/dreaming/events.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { DREAMING_DIR_RELATIVE, DREAMING_EVENTS_LOG_RELATIVE, type DreamingPhaseId } from './constants.js';\n\n// ── Event types ────────────────────────────────────────────────────────\n\nexport type DreamingEventBase = {\n  timestamp: string;\n  phase: DreamingPhaseId;\n  ok: boolean;\n  reason: string;\n  durationMs: number;\n};\n\nexport type DreamingLightEvent = DreamingEventBase & {\n  phase: 'light';\n  scannedEntries: number;\n  newSignals: number;\n  deduped: number;\n};\n\nexport type DreamingDeepEvent = DreamingEventBase & {\n  phase: 'deep';\n  candidates: number;\n  applied: number;\n};\n\nexport type DreamingRemEvent = DreamingEventBase & {\n  phase: 'rem';\n  patternsDiscovered: number;\n  entriesAnalyzed: number;\n};\n\nexport type DreamingEvent = DreamingLightEvent | DreamingDeepEvent | DreamingRemEvent;\n\n// ── Write ──────────────────────────────────────────────────────────────\n\n/**\n * Append a single event line to `memory/.dreams/events.jsonl`.\n * Creates the directory and file if they don't exist.\n * Failures are silently ignored so audit logging never blocks execution.\n */\nexport async function appendDreamingEvent(workspaceDir: string, event: DreamingEvent): Promise<void> {\n  try {\n    const dirPath = path.join(workspaceDir, DREAMING_DIR_RELATIVE);\n    await fs.mkdir(dirPath, { recursive: true });\n    const filePath = path.join(workspaceDir, DREAMING_EVENTS_LOG_RELATIVE);\n    const line = JSON.stringify(event) + '\\n';\n    await fs.appendFile(filePath, line, 'utf-8');\n  } catch {\n    // Audit logging must not block or throw.\n  }\n}\n\n// ── Read ───────────────────────────────────────────────────────────────\n\n/**\n * Read the most recent N events from the events log.\n * Returns newest-first. If the file doesn't exist, returns an empty array.\n */\nexport async function readDreamingEvents(\n  workspaceDir: string,\n  limit = 50,\n): Promise<DreamingEvent[]> {\n  const filePath = path.join(workspaceDir, DREAMING_EVENTS_LOG_RELATIVE);\n  let raw: string;\n  try {\n    raw = await fs.readFile(filePath, 'utf-8');\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException | undefined)?.code;\n    if (code === 'ENOENT') return [];\n    throw err;\n  }\n\n  const lines = raw\n    .split('\\n')\n    .map((line) => line.trim())\n    .filter(Boolean);\n\n  // Take the last `limit` lines (newest entries are at the end).\n  const tail = lines.slice(-Math.abs(limit));\n\n  const events: DreamingEvent[] = [];\n  for (const line of tail) {\n    try {\n      const parsed = JSON.parse(line) as DreamingEvent;\n      if (parsed && typeof parsed === 'object' && parsed.timestamp && parsed.phase) {\n        events.push(parsed);\n      }\n    } catch {\n      // Skip malformed lines.\n    }\n  }\n\n  // Return newest first.\n  events.reverse();\n  return events;\n}\n"],"mappings":";;;;;;;;;AA2CA,eAAsB,oBAAoB,cAAsB,OAAqC;AACnG,KAAI;EACF,MAAM,UAAU,KAAK,KAAK,cAAc,sBAAsB;AAC9D,QAAM,GAAG,MAAM,SAAS,EAAE,WAAW,MAAM,CAAC;EAC5C,MAAM,WAAW,KAAK,KAAK,cAAc,6BAA6B;EACtE,MAAM,OAAO,KAAK,UAAU,MAAM,GAAG;AACrC,QAAM,GAAG,WAAW,UAAU,MAAM,QAAQ;SACtC;;;;;;AAWV,eAAsB,mBACpB,cACA,QAAQ,IACkB;CAC1B,MAAM,WAAW,KAAK,KAAK,cAAc,6BAA6B;CACtE,IAAI;AACJ,KAAI;AACF,QAAM,MAAM,GAAG,SAAS,UAAU,QAAQ;UACnC,KAAK;AAEZ,MADc,KAA2C,SAC5C,SAAU,QAAO,EAAE;AAChC,QAAM;;CASR,MAAM,OANQ,IACX,MAAM,KAAK,CACX,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,OAAO,QAGQ,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC;CAE1C,MAAM,SAA0B,EAAE;AAClC,MAAK,MAAM,QAAQ,KACjB,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,MAAI,UAAU,OAAO,WAAW,YAAY,OAAO,aAAa,OAAO,MACrE,QAAO,KAAK,OAAO;SAEf;AAMV,QAAO,SAAS;AAChB,QAAO"}