openclaw-cortex-memory 0.1.0-Alpha.3 → 0.1.0-Alpha.5

package/dist/index.js

@@ -46,10 +46,13 @@ const net = __importStar(require("net"));
 const ts_engine_1 = require("./src/engine/ts_engine");
 const read_store_1 = require("./src/store/read_store");
 const write_store_1 = require("./src/store/write_store");
+const archive_store_1 = require("./src/store/archive_store");
+const vector_store_1 = require("./src/store/vector_store");
 const session_sync_1 = require("./src/sync/session_sync");
 const session_end_1 = require("./src/session/session_end");
 const rule_store_1 = require("./src/rules/rule_store");
 const reflector_1 = require("./src/reflect/reflector");
+const three_stage_deduplicator_1 = require("./src/dedup/three_stage_deduplicator");
 const ERROR_CODES = {
     CONNECTION_REFUSED: {
         code: "E001",
@@ -89,6 +92,40 @@ const MAX_OPENCLAW_VERSION = "2027.0.0";
 const defaultConfig = {
     autoSync: true,
     autoReflect: false,
+    autoReflectIntervalMinutes: 30,
+    readFusion: {
+        enabled: true,
+        maxCandidates: 10,
+        authoritative: true,
+    },
+    memoryDecay: {
+        enabled: true,
+        minFloor: 0.15,
+        defaultHalfLifeDays: 90,
+        antiDecay: {
+            enabled: true,
+            maxBoost: 1.6,
+            hitWeight: 0.08,
+            recentWindowDays: 30,
+        },
+        halfLifeByEventType: {
+            issue: 30,
+            fix: 30,
+            action_item: 30,
+            blocker: 30,
+            plan: 60,
+            milestone: 60,
+            follow_up: 60,
+            decision: 120,
+            insight: 120,
+            retrospective: 120,
+            preference: 240,
+            constraint: 240,
+            requirement: 240,
+            dependency: 240,
+            assumption: 240,
+        },
+    },
     enabled: true,
     fallbackToBuiltin: true,
     engineMode: "ts",
@@ -192,11 +229,33 @@ function resolveEngine() {
         projectRoot,
         dbPath: config.dbPath,
         logger,
+        embedding: config.embedding,
+        reranker: config.reranker,
+        llm: config.llm,
+        fusion: config.readFusion,
+        memoryDecay: config.memoryDecay,
     });
     const writeStore = (0, write_store_1.createWriteStore)({
         projectRoot,
         dbPath: config.dbPath,
         logger,
+        embedding: config.embedding,
+    });
+    const vectorStore = (0, vector_store_1.createVectorStore)({
+        memoryRoot,
+        logger,
+    });
+    const deduplicator = (0, three_stage_deduplicator_1.createThreeStageDeduplicator)({
+        memoryRoot,
+        logger,
+    });
+    const archiveStore = (0, archive_store_1.createArchiveStore)({
+        projectRoot,
+        memoryRoot,
+        logger,
+        embedding: config.embedding,
+        deduplicator,
+        vectorStore,
     });
     const sessionSync = (0, session_sync_1.createSessionSync)({
         projectRoot,
@@ -209,6 +268,9 @@ function resolveEngine() {
         dbPath: config.dbPath,
         logger,
         syncMemory: sessionSync.syncMemory,
+        syncDailySummaries: sessionSync.syncDailySummaries,
+        archiveStore,
+        llm: config.llm,
     });
     const ruleStore = (0, rule_store_1.createRuleStore)({
         projectRoot,
@@ -220,14 +282,17 @@ function resolveEngine() {
         dbPath: config.dbPath,
         logger,
         ruleStore,
+        llm: config.llm,
     });
     memoryEngine = (0, ts_engine_1.createTsEngine)({
         readStore,
         writeStore,
+        archiveStore,
         sessionSync,
         sessionEnd,
         reflector,
         memoryRoot,
+        projectRoot,
         getCachedAutoSearch: getSessionCachedAutoSearch,
         resolveSessionId: (context, payload) => resolveSessionId(context, payload),
         normalizeIncomingMessage,
@@ -285,6 +350,15 @@ function sanitizeForLogging(obj) {
     }
     return sanitized;
 }
+function logLifecycle(event, details = {}) {
+    const payload = sanitizeForLogging({
+        event,
+        plugin: PLUGIN_ID,
+        ts: new Date().toISOString(),
+        ...details,
+    });
+    logger.info(`[Lifecycle] ${JSON.stringify(payload)}`);
+}
 function asRecord(value) {
     if (typeof value === "object" && value !== null) {
         return value;
@@ -443,13 +517,19 @@ function findProjectRoot() {
     throw new Error("Cannot find project root directory");
 }
 function findOpenClawConfig() {
+    const explicitConfigPath = process.env.OPENCLAW_CONFIG_PATH || "";
+    const stateDir = process.env.OPENCLAW_STATE_DIR || "";
+    const basePath = process.env.OPENCLAW_BASE_PATH || "";
+    const homePath = process.env.USERPROFILE || process.env.HOME || "";
     const possiblePaths = [
+        explicitConfigPath,
+        stateDir ? path.join(stateDir, "openclaw.json") : "",
+        basePath ? path.join(basePath, "openclaw.json") : "",
         path.join(process.cwd(), "openclaw.json"),
-        path.join(process.env.USERPROFILE || process.env.HOME || "", ".openclaw", "openclaw.json"),
-        path.join(process.env.OPENCLAW_BASE_PATH || "", "openclaw.json"),
+        homePath ? path.join(homePath, ".openclaw", "openclaw.json") : "",
     ];
     for (const p of possiblePaths) {
-        if (fs.existsSync(p)) {
+        if (p && fs.existsSync(p)) {
             return p;
         }
     }
@@ -504,6 +584,8 @@ function startAutoReflectScheduler() {
     if (!config?.autoReflect || autoReflectInterval) {
         return;
     }
+    const intervalMinutes = Math.max(5, Math.floor(config.autoReflectIntervalMinutes ?? 30));
+    const intervalMs = intervalMinutes * 60 * 1000;
     autoReflectInterval = setInterval(() => {
         if (!isEnabled) {
             return;
@@ -520,7 +602,7 @@ function startAutoReflectScheduler() {
         if (marker === lastAutoReflectArchiveMarker) {
             return;
         }
-        if (now - lastAutoReflectRunAt < 5 * 60 * 1000) {
+        if (now - lastAutoReflectRunAt < intervalMs) {
             return;
         }
         resolveEngine().reflectMemory({}, schedulerContext)
@@ -535,7 +617,7 @@ function startAutoReflectScheduler() {
             }
         })
             .catch(error => logger.warn(`Auto-reflect failed: ${String(error)}`));
-    }, 5 * 60 * 1000);
+    }, intervalMs);
 }
 function stopAutoReflectScheduler() {
     if (autoReflectInterval) {
@@ -563,6 +645,41 @@ function validateConfig(cfg) {
     if (!cfg.reranker?.apiKey || !cfg.reranker?.baseURL) {
         errors.push("reranker.apiKey and reranker.baseURL are required. Please configure third-party reranker endpoint credentials.");
     }
+    if (typeof cfg.autoReflectIntervalMinutes === "number" && (!Number.isFinite(cfg.autoReflectIntervalMinutes) || cfg.autoReflectIntervalMinutes < 5)) {
+        errors.push("autoReflectIntervalMinutes must be a number >= 5.");
+    }
+    if (cfg.readFusion && typeof cfg.readFusion.maxCandidates === "number" && (!Number.isFinite(cfg.readFusion.maxCandidates) || cfg.readFusion.maxCandidates < 2)) {
+        errors.push("readFusion.maxCandidates must be a number >= 2.");
+    }
+    if (cfg.memoryDecay) {
+        if (typeof cfg.memoryDecay.minFloor === "number" && (!Number.isFinite(cfg.memoryDecay.minFloor) || cfg.memoryDecay.minFloor < 0 || cfg.memoryDecay.minFloor > 1)) {
+            errors.push("memoryDecay.minFloor must be within [0,1].");
+        }
+        if (typeof cfg.memoryDecay.defaultHalfLifeDays === "number" && (!Number.isFinite(cfg.memoryDecay.defaultHalfLifeDays) || cfg.memoryDecay.defaultHalfLifeDays <= 0)) {
+            errors.push("memoryDecay.defaultHalfLifeDays must be > 0.");
+        }
+        const mapping = cfg.memoryDecay.halfLifeByEventType;
+        if (mapping && typeof mapping === "object") {
+            for (const [key, value] of Object.entries(mapping)) {
+                if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+                    errors.push(`memoryDecay.halfLifeByEventType.${key} must be > 0.`);
+                    break;
+                }
+            }
+        }
+        const anti = cfg.memoryDecay.antiDecay;
+        if (anti) {
+            if (typeof anti.maxBoost === "number" && (!Number.isFinite(anti.maxBoost) || anti.maxBoost < 1)) {
+                errors.push("memoryDecay.antiDecay.maxBoost must be >= 1.");
+            }
+            if (typeof anti.hitWeight === "number" && (!Number.isFinite(anti.hitWeight) || anti.hitWeight < 0)) {
+                errors.push("memoryDecay.antiDecay.hitWeight must be >= 0.");
+            }
+            if (typeof anti.recentWindowDays === "number" && (!Number.isFinite(anti.recentWindowDays) || anti.recentWindowDays <= 0)) {
+                errors.push("memoryDecay.antiDecay.recentWindowDays must be > 0.");
+            }
+        }
+    }
     return errors;
 }
 function getApiHostAndPort() {
@@ -1393,13 +1510,15 @@ async function onTimerPythonHandler(payload, _context) {
     }
 }
 async function onMessageHandler(payload, context) {
-    if (isInternalSession(context.sessionId)) {
+    const sessionId = resolveSessionId(context, payload);
+    if (isInternalSession(sessionId)) {
         return;
     }
     await runWithTimeout(resolveEngine().onMessage(payload, context), HOOK_GUARD_TIMEOUT_MS, "onMessage hook");
 }
 async function onSessionEndHandler(payload, context) {
-    if (isInternalSession(context.sessionId)) {
+    const sessionId = resolveSessionId(context, payload);
+    if (isInternalSession(sessionId)) {
         return;
     }
     await runWithTimeout(resolveEngine().onSessionEnd(payload, context), HOOK_GUARD_TIMEOUT_MS, "onSessionEnd hook");
@@ -1700,6 +1819,7 @@ async function enable() {
         return;
     }
     logger.info("Enabling Cortex Memory plugin...");
+    logLifecycle("enable_start");
     try {
         unregisterFallbackTools();
         if (shouldUsePythonRuntime()) {
@@ -1711,10 +1831,12 @@ async function enable() {
         registerHooks();
         startAutoReflectScheduler();
         logger.info("Cortex Memory plugin enabled successfully");
+        logLifecycle("enable_success", { registeredTools: registeredTools.length, registeredHooks: registeredHooks.length });
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         logger.error(`Failed to enable Cortex Memory plugin: ${message}`);
+        logLifecycle("enable_failed", { error: message });
         throw error;
     }
 }
@@ -1724,6 +1846,7 @@ async function disable() {
         return;
     }
     logger.info("Disabling Cortex Memory plugin...");
+    logLifecycle("disable_start");
     unregisterHooks();
     unregisterTools();
     unregisterFallbackTools();
@@ -1736,8 +1859,10 @@ async function disable() {
     if (config?.fallbackToBuiltin && builtinMemory) {
         logger.info("Falling back to OpenClaw builtin memory system");
         registerFallbackTools();
+        logLifecycle("fallback_enabled", { fallbackTools: registeredFallbackTools.length });
     }
     logger.info("Cortex Memory plugin disabled successfully");
+    logLifecycle("disable_success", { fallbackEnabled: registeredFallbackTools.length > 0 });
 }
 function registerFallbackTools() {
     if (!api || !builtinMemory)
@@ -1805,6 +1930,7 @@ function getStatus() {
 }
 async function unregister() {
     logger.info("Unregistering Cortex Memory plugin...");
+    logLifecycle("unregister_start");
     stopConfigWatcher();
     stopAutoReflectScheduler();
     unregisterHooks();
@@ -1831,6 +1957,7 @@ async function unregister() {
     stopAutoReflectScheduler();
     configPath = null;
     logger.info("Cortex Memory plugin unregistered successfully");
+    logLifecycle("unregister_success");
 }
 function register(pluginApi, userConfig) {
     if (isInitializing || isRegistered) {
@@ -1866,6 +1993,24 @@ function register(pluginApi, userConfig) {
         dbPath: effectiveConfig.dbPath,
         autoSync: effectiveConfig.autoSync ?? defaultConfig.autoSync,
         autoReflect: effectiveConfig.autoReflect ?? defaultConfig.autoReflect,
+        autoReflectIntervalMinutes: effectiveConfig.autoReflectIntervalMinutes ?? defaultConfig.autoReflectIntervalMinutes,
+        readFusion: {
+            enabled: effectiveConfig.readFusion?.enabled ?? defaultConfig.readFusion?.enabled,
+            maxCandidates: effectiveConfig.readFusion?.maxCandidates ?? defaultConfig.readFusion?.maxCandidates,
+            authoritative: effectiveConfig.readFusion?.authoritative ?? defaultConfig.readFusion?.authoritative,
+        },
+        memoryDecay: {
+            enabled: effectiveConfig.memoryDecay?.enabled ?? defaultConfig.memoryDecay?.enabled,
+            minFloor: effectiveConfig.memoryDecay?.minFloor ?? defaultConfig.memoryDecay?.minFloor,
+            defaultHalfLifeDays: effectiveConfig.memoryDecay?.defaultHalfLifeDays ?? defaultConfig.memoryDecay?.defaultHalfLifeDays,
+            halfLifeByEventType: effectiveConfig.memoryDecay?.halfLifeByEventType ?? defaultConfig.memoryDecay?.halfLifeByEventType,
+            antiDecay: {
+                enabled: effectiveConfig.memoryDecay?.antiDecay?.enabled ?? defaultConfig.memoryDecay?.antiDecay?.enabled,
+                maxBoost: effectiveConfig.memoryDecay?.antiDecay?.maxBoost ?? defaultConfig.memoryDecay?.antiDecay?.maxBoost,
+                hitWeight: effectiveConfig.memoryDecay?.antiDecay?.hitWeight ?? defaultConfig.memoryDecay?.antiDecay?.hitWeight,
+                recentWindowDays: effectiveConfig.memoryDecay?.antiDecay?.recentWindowDays ?? defaultConfig.memoryDecay?.antiDecay?.recentWindowDays,
+            },
+        },
         enabled: effectiveConfig.enabled ?? defaultConfig.enabled,
         fallbackToBuiltin: effectiveConfig.fallbackToBuiltin ?? defaultConfig.fallbackToBuiltin,
         apiUrl: effectiveConfig.apiUrl ?? "http://127.0.0.1:8765",
@@ -1903,6 +2048,11 @@ function register(pluginApi, userConfig) {
     isRegistered = true;
     logger.info("Cortex Memory plugin registered successfully");
     logger.info(`Cortex Memory engine mode: ${resolveEngine().mode}`);
+    logLifecycle("register_success", {
+        engineMode: config.engineMode,
+        enabled: isEnabled,
+        hasBuiltinFallback: Boolean(builtinMemory),
+    });
     if (isEnabled) {
         registerTools();
         registerHooks();
@@ -1916,11 +2066,13 @@ function register(pluginApi, userConfig) {
                 logger.info("Falling back to builtin memory");
                 isEnabled = false;
                 registerFallbackTools();
+                logLifecycle("fallback_after_init_error", { fallbackTools: registeredFallbackTools.length, error: message });
             }
         });
     }
     else if (config?.fallbackToBuiltin && builtinMemory) {
         registerFallbackTools();
+        logLifecycle("fallback_registered_on_start", { fallbackTools: registeredFallbackTools.length });
     }
 }
 async function initializeAsync() {