@poolzin/pool-bot 2026.2.0 → 2026.2.2

package/dist/cron/service/store.js

@@ -1,19 +1,245 @@
+import fs from "node:fs";
+import { parseAbsoluteTimeMs } from "../parse.js";
 import { migrateLegacyCronPayload } from "../payload-migration.js";
 import { loadCronStore, saveCronStore } from "../store.js";
+import { recomputeNextRuns } from "./jobs.js";
 import { inferLegacyName, normalizeOptionalText } from "./normalize.js";
-const storeCache = new Map();
-export async function ensureLoaded(state) {
-    if (state.store)
-        return;
-    const cached = storeCache.get(state.deps.storePath);
-    if (cached) {
-        state.store = cached;
+function hasLegacyDeliveryHints(payload) {
+    if (typeof payload.deliver === "boolean") {
+        return true;
+    }
+    if (typeof payload.bestEffortDeliver === "boolean") {
+        return true;
+    }
+    if (typeof payload.to === "string" && payload.to.trim()) {
+        return true;
+    }
+    return false;
+}
+function buildDeliveryFromLegacyPayload(payload) {
+    const deliver = payload.deliver;
+    const mode = deliver === false ? "none" : "announce";
+    const channelRaw = typeof payload.channel === "string" ? payload.channel.trim().toLowerCase() : "";
+    const toRaw = typeof payload.to === "string" ? payload.to.trim() : "";
+    const next = { mode };
+    if (channelRaw) {
+        next.channel = channelRaw;
+    }
+    if (toRaw) {
+        next.to = toRaw;
+    }
+    if (typeof payload.bestEffortDeliver === "boolean") {
+        next.bestEffort = payload.bestEffortDeliver;
+    }
+    return next;
+}
+function buildDeliveryPatchFromLegacyPayload(payload) {
+    const deliver = payload.deliver;
+    const channelRaw = typeof payload.channel === "string" ? payload.channel.trim().toLowerCase() : "";
+    const toRaw = typeof payload.to === "string" ? payload.to.trim() : "";
+    const next = {};
+    let hasPatch = false;
+    if (deliver === false) {
+        next.mode = "none";
+        hasPatch = true;
+    }
+    else if (deliver === true || toRaw) {
+        next.mode = "announce";
+        hasPatch = true;
+    }
+    if (channelRaw) {
+        next.channel = channelRaw;
+        hasPatch = true;
+    }
+    if (toRaw) {
+        next.to = toRaw;
+        hasPatch = true;
+    }
+    if (typeof payload.bestEffortDeliver === "boolean") {
+        next.bestEffort = payload.bestEffortDeliver;
+        hasPatch = true;
+    }
+    return hasPatch ? next : null;
+}
+function mergeLegacyDeliveryInto(delivery, payload) {
+    const patch = buildDeliveryPatchFromLegacyPayload(payload);
+    if (!patch) {
+        return { delivery, mutated: false };
+    }
+    const next = { ...delivery };
+    let mutated = false;
+    if ("mode" in patch && patch.mode !== next.mode) {
+        next.mode = patch.mode;
+        mutated = true;
+    }
+    if ("channel" in patch && patch.channel !== next.channel) {
+        next.channel = patch.channel;
+        mutated = true;
+    }
+    if ("to" in patch && patch.to !== next.to) {
+        next.to = patch.to;
+        mutated = true;
+    }
+    if ("bestEffort" in patch && patch.bestEffort !== next.bestEffort) {
+        next.bestEffort = patch.bestEffort;
+        mutated = true;
+    }
+    return { delivery: next, mutated };
+}
+function stripLegacyDeliveryFields(payload) {
+    if ("deliver" in payload) {
+        delete payload.deliver;
+    }
+    if ("channel" in payload) {
+        delete payload.channel;
+    }
+    if ("to" in payload) {
+        delete payload.to;
+    }
+    if ("bestEffortDeliver" in payload) {
+        delete payload.bestEffortDeliver;
+    }
+}
+function normalizePayloadKind(payload) {
+    const raw = typeof payload.kind === "string" ? payload.kind.trim().toLowerCase() : "";
+    if (raw === "agentturn") {
+        payload.kind = "agentTurn";
+        return true;
+    }
+    if (raw === "systemevent") {
+        payload.kind = "systemEvent";
+        return true;
+    }
+    return false;
+}
+function inferPayloadIfMissing(raw) {
+    const message = typeof raw.message === "string" ? raw.message.trim() : "";
+    const text = typeof raw.text === "string" ? raw.text.trim() : "";
+    if (message) {
+        raw.payload = { kind: "agentTurn", message };
+        return true;
+    }
+    if (text) {
+        raw.payload = { kind: "systemEvent", text };
+        return true;
+    }
+    return false;
+}
+function copyTopLevelAgentTurnFields(raw, payload) {
+    let mutated = false;
+    const copyTrimmedString = (field) => {
+        const existing = payload[field];
+        if (typeof existing === "string" && existing.trim()) {
+            return;
+        }
+        const value = raw[field];
+        if (typeof value === "string" && value.trim()) {
+            payload[field] = value.trim();
+            mutated = true;
+        }
+    };
+    copyTrimmedString("model");
+    copyTrimmedString("thinking");
+    if (typeof payload.timeoutSeconds !== "number" &&
+        typeof raw.timeoutSeconds === "number" &&
+        Number.isFinite(raw.timeoutSeconds)) {
+        payload.timeoutSeconds = Math.max(1, Math.floor(raw.timeoutSeconds));
+        mutated = true;
+    }
+    if (typeof payload.allowUnsafeExternalContent !== "boolean" &&
+        typeof raw.allowUnsafeExternalContent === "boolean") {
+        payload.allowUnsafeExternalContent = raw.allowUnsafeExternalContent;
+        mutated = true;
+    }
+    if (typeof payload.deliver !== "boolean" && typeof raw.deliver === "boolean") {
+        payload.deliver = raw.deliver;
+        mutated = true;
+    }
+    if (typeof payload.channel !== "string" &&
+        typeof raw.channel === "string" &&
+        raw.channel.trim()) {
+        payload.channel = raw.channel.trim();
+        mutated = true;
+    }
+    if (typeof payload.to !== "string" && typeof raw.to === "string" && raw.to.trim()) {
+        payload.to = raw.to.trim();
+        mutated = true;
+    }
+    if (typeof payload.bestEffortDeliver !== "boolean" &&
+        typeof raw.bestEffortDeliver === "boolean") {
+        payload.bestEffortDeliver = raw.bestEffortDeliver;
+        mutated = true;
+    }
+    if (typeof payload.provider !== "string" &&
+        typeof raw.provider === "string" &&
+        raw.provider.trim()) {
+        payload.provider = raw.provider.trim();
+        mutated = true;
+    }
+    return mutated;
+}
+function stripLegacyTopLevelFields(raw) {
+    if ("model" in raw) {
+        delete raw.model;
+    }
+    if ("thinking" in raw) {
+        delete raw.thinking;
+    }
+    if ("timeoutSeconds" in raw) {
+        delete raw.timeoutSeconds;
+    }
+    if ("allowUnsafeExternalContent" in raw) {
+        delete raw.allowUnsafeExternalContent;
+    }
+    if ("message" in raw) {
+        delete raw.message;
+    }
+    if ("text" in raw) {
+        delete raw.text;
+    }
+    if ("deliver" in raw) {
+        delete raw.deliver;
+    }
+    if ("channel" in raw) {
+        delete raw.channel;
+    }
+    if ("to" in raw) {
+        delete raw.to;
+    }
+    if ("bestEffortDeliver" in raw) {
+        delete raw.bestEffortDeliver;
+    }
+    if ("provider" in raw) {
+        delete raw.provider;
+    }
+}
+async function getFileMtimeMs(path) {
+    try {
+        const stats = await fs.promises.stat(path);
+        return stats.mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+export async function ensureLoaded(state, opts) {
+    // Fast path: store is already in memory. Other callers (add, list, run, …)
+    // trust the in-memory copy to avoid a stat syscall on every operation.
+    if (state.store && !opts?.forceReload) {
         return;
     }
+    // Force reload always re-reads the file to avoid missing cross-service
+    // edits on filesystems with coarse mtime resolution.
+    const fileMtimeMs = await getFileMtimeMs(state.deps.storePath);
     const loaded = await loadCronStore(state.deps.storePath);
     const jobs = (loaded.jobs ?? []);
     let mutated = false;
     for (const raw of jobs) {
+        const state = raw.state;
+        if (!state || typeof state !== "object" || Array.isArray(state)) {
+            raw.state = {};
+            mutated = true;
+        }
         const nameRaw = raw.name;
         if (typeof nameRaw !== "string" || nameRaw.trim().length === 0) {
             raw.name = inferLegacyName({
@@ -30,28 +256,174 @@ export async function ensureLoaded(state) {
             raw.description = desc;
             mutated = true;
         }
+        if (typeof raw.enabled !== "boolean") {
+            raw.enabled = true;
+            mutated = true;
+        }
         const payload = raw.payload;
-        if (payload && typeof payload === "object" && !Array.isArray(payload)) {
-            if (migrateLegacyCronPayload(payload)) {
+        if ((!payload || typeof payload !== "object" || Array.isArray(payload)) &&
+            inferPayloadIfMissing(raw)) {
+            mutated = true;
+        }
+        const payloadRecord = raw.payload && typeof raw.payload === "object" && !Array.isArray(raw.payload)
+            ? raw.payload
+            : null;
+        if (payloadRecord) {
+            if (normalizePayloadKind(payloadRecord)) {
+                mutated = true;
+            }
+            if (!payloadRecord.kind) {
+                if (typeof payloadRecord.message === "string" && payloadRecord.message.trim()) {
+                    payloadRecord.kind = "agentTurn";
+                    mutated = true;
+                }
+                else if (typeof payloadRecord.text === "string" && payloadRecord.text.trim()) {
+                    payloadRecord.kind = "systemEvent";
+                    mutated = true;
+                }
+            }
+            if (payloadRecord.kind === "agentTurn") {
+                if (copyTopLevelAgentTurnFields(raw, payloadRecord)) {
+                    mutated = true;
+                }
+            }
+        }
+        const hadLegacyTopLevelFields = "model" in raw ||
+            "thinking" in raw ||
+            "timeoutSeconds" in raw ||
+            "allowUnsafeExternalContent" in raw ||
+            "message" in raw ||
+            "text" in raw ||
+            "deliver" in raw ||
+            "channel" in raw ||
+            "to" in raw ||
+            "bestEffortDeliver" in raw ||
+            "provider" in raw;
+        if (hadLegacyTopLevelFields) {
+            stripLegacyTopLevelFields(raw);
+            mutated = true;
+        }
+        if (payloadRecord) {
+            if (migrateLegacyCronPayload(payloadRecord)) {
+                mutated = true;
+            }
+        }
+        const schedule = raw.schedule;
+        if (schedule && typeof schedule === "object" && !Array.isArray(schedule)) {
+            const sched = schedule;
+            const kind = typeof sched.kind === "string" ? sched.kind.trim().toLowerCase() : "";
+            if (!kind && ("at" in sched || "atMs" in sched)) {
+                sched.kind = "at";
+                mutated = true;
+            }
+            const atRaw = typeof sched.at === "string" ? sched.at.trim() : "";
+            const atMsRaw = sched.atMs;
+            const parsedAtMs = typeof atMsRaw === "number"
+                ? atMsRaw
+                : typeof atMsRaw === "string"
+                    ? parseAbsoluteTimeMs(atMsRaw)
+                    : atRaw
+                        ? parseAbsoluteTimeMs(atRaw)
+                        : null;
+            if (parsedAtMs !== null) {
+                sched.at = new Date(parsedAtMs).toISOString();
+                if ("atMs" in sched) {
+                    delete sched.atMs;
+                }
+                mutated = true;
+            }
+            const everyMsRaw = sched.everyMs;
+            const everyMs = typeof everyMsRaw === "number" && Number.isFinite(everyMsRaw)
+                ? Math.floor(everyMsRaw)
+                : null;
+            if ((kind === "every" || sched.kind === "every") && everyMs !== null) {
+                const anchorRaw = sched.anchorMs;
+                const normalizedAnchor = typeof anchorRaw === "number" && Number.isFinite(anchorRaw)
+                    ? Math.max(0, Math.floor(anchorRaw))
+                    : typeof raw.createdAtMs === "number" && Number.isFinite(raw.createdAtMs)
+                        ? Math.max(0, Math.floor(raw.createdAtMs))
+                        : typeof raw.updatedAtMs === "number" && Number.isFinite(raw.updatedAtMs)
+                            ? Math.max(0, Math.floor(raw.updatedAtMs))
+                            : null;
+                if (normalizedAnchor !== null && anchorRaw !== normalizedAnchor) {
+                    sched.anchorMs = normalizedAnchor;
+                    mutated = true;
+                }
+            }
+        }
+        const delivery = raw.delivery;
+        if (delivery && typeof delivery === "object" && !Array.isArray(delivery)) {
+            const modeRaw = delivery.mode;
+            if (typeof modeRaw === "string") {
+                const lowered = modeRaw.trim().toLowerCase();
+                if (lowered === "deliver") {
+                    delivery.mode = "announce";
+                    mutated = true;
+                }
+            }
+            else if (modeRaw === undefined || modeRaw === null) {
+                // Explicitly persist the default so existing jobs don't silently
+                // change behaviour when the runtime default shifts.
+                delivery.mode = "announce";
+                mutated = true;
+            }
+        }
+        const isolation = raw.isolation;
+        if (isolation && typeof isolation === "object" && !Array.isArray(isolation)) {
+            delete raw.isolation;
+            mutated = true;
+        }
+        const payloadKind = payloadRecord && typeof payloadRecord.kind === "string" ? payloadRecord.kind : "";
+        const sessionTarget = typeof raw.sessionTarget === "string" ? raw.sessionTarget.trim().toLowerCase() : "";
+        const isIsolatedAgentTurn = sessionTarget === "isolated" || (sessionTarget === "" && payloadKind === "agentTurn");
+        const hasDelivery = delivery && typeof delivery === "object" && !Array.isArray(delivery);
+        const hasLegacyDelivery = payloadRecord ? hasLegacyDeliveryHints(payloadRecord) : false;
+        if (isIsolatedAgentTurn && payloadKind === "agentTurn") {
+            if (!hasDelivery) {
+                raw.delivery =
+                    payloadRecord && hasLegacyDelivery
+                        ? buildDeliveryFromLegacyPayload(payloadRecord)
+                        : { mode: "announce" };
+                mutated = true;
+            }
+            if (payloadRecord && hasLegacyDelivery) {
+                if (hasDelivery) {
+                    const merged = mergeLegacyDeliveryInto(delivery, payloadRecord);
+                    if (merged.mutated) {
+                        raw.delivery = merged.delivery;
+                        mutated = true;
+                    }
+                }
+                stripLegacyDeliveryFields(payloadRecord);
                 mutated = true;
             }
         }
     }
     state.store = { version: 1, jobs: jobs };
-    storeCache.set(state.deps.storePath, state.store);
-    if (mutated)
+    state.storeLoadedAtMs = state.deps.nowMs();
+    state.storeFileMtimeMs = fileMtimeMs;
+    if (!opts?.skipRecompute) {
+        recomputeNextRuns(state);
+    }
+    if (mutated) {
         await persist(state);
+    }
 }
 export function warnIfDisabled(state, action) {
-    if (state.deps.cronEnabled)
+    if (state.deps.cronEnabled) {
         return;
-    if (state.warnedDisabled)
+    }
+    if (state.warnedDisabled) {
         return;
+    }
     state.warnedDisabled = true;
     state.deps.log.warn({ enabled: false, action, storePath: state.deps.storePath }, "cron: scheduler disabled; jobs will not run automatically");
 }
 export async function persist(state) {
-    if (!state.store)
+    if (!state.store) {
         return;
+    }
     await saveCronStore(state.deps.storePath, state.store);
+    // Update file mtime after save to prevent immediate reload
+    state.storeFileMtimeMs = await getFileMtimeMs(state.deps.storePath);
 }