@xopcai/xopc 0.0.180 → 0.0.187

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

@@ -1,16 +1,16 @@
 import type { Config } from '../../../config/schema.js';
-import { type MemoryWriteCheckResult } from '../../../agent-runtime/memory-runtime.js';
+import type { DreamingMode } from '../../../storage/sqlite/index.js';
+import type { DreamingSchedule, DreamingSettings } from '../../../user-context/config.js';
 import { type DreamingPhaseId } from './constants.js';
 export type DreamingLightConfig = {
     enabled: boolean;
-    cron: string;
+    schedule: DreamingSchedule;
     lookbackDays: number;
     limit: number;
-    dedupeSimilarity: number;
 };
 export type DreamingDeepConfig = {
     enabled: boolean;
-    cron: string;
+    schedule: DreamingSchedule;
     minScore: number;
     minRecallCount: number;
     minUniqueQueries: number;
@@ -20,26 +20,29 @@ export type DreamingDeepConfig = {
 };
 export type DreamingRemConfig = {
     enabled: boolean;
-    cron: string;
+    schedule: DreamingSchedule;
     lookbackDays: number;
     limit: number;
     minPatternStrength: number;
 };
 export type DreamingResolvedConfig = {
+    requestedMode: DreamingMode;
+    mode: DreamingMode;
     enabled: boolean;
-    promotionWritePolicy: MemoryWriteCheckResult;
-    frequency: string;
-    timezone?: string;
+    writeDisposition: 'none' | 'candidate' | 'active';
+    automaticReady: boolean;
+    downgradeReason?: 'memory_policy' | 'quality_gate';
+    timezone: string;
     phases: {
         light: DreamingLightConfig;
         deep: DreamingDeepConfig;
         rem: DreamingRemConfig;
     };
-    deep: DreamingDeepConfig;
 };
-/** Resolve the full three-phase dreaming config from an agent manifest. */
-export declare function resolveDreamingConfig(cfg: Config | undefined, requestedAgentId?: string | null): DreamingResolvedConfig;
-/** Get the cron expression for a specific phase from resolved config. */
-export declare function getPhaseCron(config: DreamingResolvedConfig, phase: DreamingPhaseId): string;
+export declare function resolveDreamingSettings(cfg: Config | undefined): DreamingSettings;
+/** Resolve the full three-phase dreaming config and its effective write authority. */
+export declare function resolveDreamingConfig(cfg: Config | undefined, options?: {
+    automaticReady?: boolean;
+}): DreamingResolvedConfig;
 /** Check if a specific phase is enabled (global + phase-level). */
 export declare function isPhaseEnabled(config: DreamingResolvedConfig, phase: DreamingPhaseId): boolean;

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

@@ -1,5 +1,5 @@
-import { buildMemoryRuntime } from "../../../agent-runtime/memory-runtime.js";
-import { DEFAULT_DEEP_CRON, DEFAULT_LIGHT_CRON, DEFAULT_REM_CRON } from "./constants.js";
+import "./constants.js";
+import { DEFAULT_DREAMING_SCHEDULES, resolveDreamingTimezone } from "./schedule.js";
 //#region src/agent/memory/dreaming/config.ts
 function clampScore(value, fallback) {
 	if (!Number.isFinite(value)) return fallback;
@@ -17,40 +17,49 @@ function toNonNegInt(value, 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 an agent manifest. */
-function resolveDreamingConfig(cfg, requestedAgentId) {
+function resolveDreamingSettings(cfg) {
 	const dreaming = cfg?.userContext.dreaming;
-	const enabled = dreaming?.enabled === true && cfg?.userContext.enabled === true && cfg.userContext.memory.mode !== "off";
-	const promotionWritePolicy = cfg ? buildMemoryRuntime(cfg.userContext).checkWrite({
-		target: "curated",
-		content: "Dreaming automatic memory promotion",
-		source: "dreaming",
-		confidence: 1,
-		sensitive: false
-	}) : {
-		decision: "deny",
-		reason: "user context configuration is unavailable"
+	return {
+		mode: dreaming?.mode ?? "off",
+		timezone: resolveDreamingTimezone(dreaming?.timezone),
+		phases: {
+			light: {
+				enabled: dreaming?.phases?.light?.enabled !== false,
+				schedule: dreaming?.phases?.light?.schedule ?? DEFAULT_DREAMING_SCHEDULES.light
+			},
+			deep: {
+				enabled: dreaming?.phases?.deep?.enabled !== false,
+				schedule: dreaming?.phases?.deep?.schedule ?? DEFAULT_DREAMING_SCHEDULES.deep
+			},
+			rem: {
+				enabled: dreaming?.phases?.rem?.enabled !== false,
+				schedule: dreaming?.phases?.rem?.schedule ?? DEFAULT_DREAMING_SCHEDULES.rem
+			}
+		}
 	};
-	const frequency = trimmedStringOr(dreaming?.frequency, DEFAULT_DEEP_CRON);
-	const timezone = optionalTrimmedString(dreaming?.timezone);
+}
+/** Resolve the full three-phase dreaming config and its effective write authority. */
+function resolveDreamingConfig(cfg, options = {}) {
+	const dreaming = cfg?.userContext.dreaming;
+	const settings = resolveDreamingSettings(cfg);
+	const requestedMode = settings.mode;
+	const memoryMode = cfg?.userContext.memory.mode ?? "off";
+	const automaticReady = options.automaticReady === true;
+	const mode = cfg?.userContext.enabled !== true || memoryMode === "off" ? "off" : memoryMode === "readOnly" ? requestedMode === "off" ? "off" : "observe" : memoryMode === "confirmWrite" && requestedMode === "automatic" ? "review" : requestedMode === "automatic" && !automaticReady ? "review" : requestedMode;
+	const enabled = mode !== "off";
+	const writeDisposition = mode === "automatic" ? "active" : mode === "review" ? "candidate" : "none";
+	const timezone = settings.timezone;
 	const lightRaw = dreaming?.phases?.light ?? {};
 	const light = {
-		enabled: enabled && lightRaw?.enabled !== false,
-		cron: trimmedStringOr(lightRaw?.cron, DEFAULT_LIGHT_CRON),
+		enabled: enabled && settings.phases.light.enabled,
+		schedule: settings.phases.light.schedule,
 		lookbackDays: toPositiveInt(lightRaw?.lookbackDays, 2),
-		limit: toNonNegInt(lightRaw?.limit, 100),
-		dedupeSimilarity: clampScore(Number(lightRaw?.dedupeSimilarity), .9)
+		limit: toNonNegInt(lightRaw?.limit, 100)
 	};
 	const deepRaw = dreaming?.phases?.deep ?? {};
 	const deep = {
-		enabled: enabled && deepRaw?.enabled !== false && promotionWritePolicy.decision === "allow",
-		cron: trimmedStringOr(deepRaw?.cron, frequency),
+		enabled: enabled && settings.phases.deep.enabled,
+		schedule: settings.phases.deep.schedule,
 		minScore: clampScore(Number(deepRaw?.minScore), .8),
 		minRecallCount: toPositiveInt(deepRaw?.minRecallCount, 3),
 		minUniqueQueries: toPositiveInt(deepRaw?.minUniqueQueries, 3),
@@ -60,32 +69,30 @@ function resolveDreamingConfig(cfg, requestedAgentId) {
 	};
 	const remRaw = dreaming?.phases?.rem ?? {};
 	const rem = {
-		enabled: enabled && remRaw?.enabled !== false,
-		cron: trimmedStringOr(remRaw?.cron, DEFAULT_REM_CRON),
+		enabled: enabled && settings.phases.rem.enabled,
+		schedule: settings.phases.rem.schedule,
 		lookbackDays: toPositiveInt(remRaw?.lookbackDays, 7),
 		limit: toNonNegInt(remRaw?.limit, 10),
 		minPatternStrength: clampScore(Number(remRaw?.minPatternStrength), .75)
 	};
 	return {
+		requestedMode,
+		mode,
 		enabled,
-		promotionWritePolicy,
-		frequency,
-		...timezone ? { timezone } : {},
+		writeDisposition,
+		automaticReady,
+		...requestedMode === "automatic" && mode !== "automatic" ? { downgradeReason: memoryMode === "confirmWrite" || memoryMode === "readOnly" ? "memory_policy" : "quality_gate" } : {},
+		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 };
+export { isPhaseEnabled, resolveDreamingConfig, resolveDreamingSettings };

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

@@ -1,29 +1,12 @@
 export type DreamingPhaseId = 'light' | 'deep' | 'rem';
+export declare const DREAMING_ALGORITHM_VERSION = "structured-v1";
 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 DREAMING_AUTOMATION_TAG = "[managed-by=xopc.memory.dreaming]";
+export declare const DREAMING_DEEP_AUTOMATION_NAME = "Memory Dreaming - Deep Promotion";
+export declare const DREAMING_LIGHT_AUTOMATION_NAME = "Memory Dreaming - Light Sweep";
+export declare const DREAMING_REM_AUTOMATION_NAME = "Memory Dreaming - REM Patterns";
 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 = ".dreams";
-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,5 +1,5 @@
-import path from "node:path";
 //#region src/agent/memory/dreaming/constants.ts
+const DREAMING_ALGORITHM_VERSION = "structured-v1";
 const DREAMING_PHASES = [
 	"light",
 	"deep",
@@ -8,29 +8,11 @@ const DREAMING_PHASES = [
 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 DREAMING_AUTOMATION_TAG = "[managed-by=xopc.memory.dreaming]";
+const DREAMING_DEEP_AUTOMATION_NAME = "Memory Dreaming - Deep Promotion";
+const DREAMING_LIGHT_AUTOMATION_NAME = "Memory Dreaming - Light Sweep";
+const DREAMING_REM_AUTOMATION_NAME = "Memory Dreaming - REM Patterns";
 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 = ".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 };
+export { DEFAULT_MAX_AGE_DAYS, DEFAULT_RECENCY_HALF_LIFE_DAYS, DREAMING_ALGORITHM_VERSION, DREAMING_AUTOMATION_TAG, DREAMING_DEEP_AUTOMATION_NAME, DREAMING_LIGHT_AUTOMATION_NAME, DREAMING_LIGHT_SWEEP_TOKEN, DREAMING_PHASES, DREAMING_REM_AUTOMATION_NAME, DREAMING_REM_SWEEP_TOKEN, DREAMING_SWEEP_TOKEN };

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

@@ -1,21 +1,14 @@
-import { type DreamingStoreEntry } from './short-term-store.js';
+import { type DreamingActiveMode } from '../../../storage/sqlite/index.js';
 import type { DreamingDeepConfig } from './config.js';
-import type { MemoryManager } from '../manager.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;
-};
+/** Consolidate useful candidates from structured recall and injection signals. */
 export declare function runDreamingDeepPromotion(params: {
     agentId: string;
+    runId: string;
+    mode: DreamingActiveMode;
     workspaceDir: string;
-    dreamingRoot: string;
     config?: Partial<DreamingDeepConfig>;
     sensitiveWritePolicy?: 'deny' | 'confirm' | 'allow';
-    memoryManager?: MemoryManager;
     now?: Date;
 }): Promise<{
     ok: boolean;