@xrkseek/harness 0.3.11 → 0.4.0-rc.2

package/node_modules/@xrkseek/server-cron/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/server-cron/dist/schedule.d.ts

@@ -0,0 +1,9 @@
+import { type CronSchedule } from "./types.js";
+/** Validate schedule shape; throw CronError on bad input. */
+export declare function assertSchedule(schedule: CronSchedule): void;
+/**
+ * Compute next UTC fire time after `from` (exclusive for every/cron; at is absolute).
+ */
+export declare function nextRunAt(schedule: CronSchedule, from?: Date): string | null;
+export declare function isDue(nextRunAtIso: string | null | undefined, now?: Date): boolean;
+//# sourceMappingURL=schedule.d.ts.map

package/node_modules/@xrkseek/server-cron/dist/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../src/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAoE7E,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAsB3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,YAAY,EACtB,IAAI,GAAE,IAAiB,GACtB,MAAM,GAAG,IAAI,CAsBf;AAED,wBAAgB,KAAK,CACnB,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACvC,GAAG,GAAE,IAAiB,GACrB,OAAO,CAIT"}

package/node_modules/@xrkseek/server-cron/dist/schedule.js

@@ -0,0 +1,108 @@
+import { CronError, MIN_EVERY_SECONDS } from "./types.js";
+function parseCronField(field, min, max) {
+    const trimmed = field.trim();
+    if (trimmed === "*")
+        return "any";
+    const out = new Set();
+    for (const part of trimmed.split(",")) {
+        const stepMatch = /^(\*|\d+)-?(\d+)?\/(\d+)$/.exec(part);
+        if (stepMatch) {
+            const start = stepMatch[1] === "*" ? min : Number(stepMatch[1]);
+            const end = stepMatch[2] !== undefined ? Number(stepMatch[2]) : max;
+            const step = Number(stepMatch[3]);
+            if (!Number.isFinite(step) || step < 1) {
+                throw new CronError(`invalid cron step: ${part}`, "CRON_SCHEDULE");
+            }
+            for (let i = start; i <= end; i += step) {
+                if (i >= min && i <= max)
+                    out.add(i);
+            }
+            continue;
+        }
+        const range = /^(\d+)-(\d+)$/.exec(part);
+        if (range) {
+            const a = Number(range[1]);
+            const b = Number(range[2]);
+            for (let i = a; i <= b; i++) {
+                if (i >= min && i <= max)
+                    out.add(i);
+            }
+            continue;
+        }
+        const n = Number(part);
+        if (!Number.isFinite(n) || n < min || n > max) {
+            throw new CronError(`invalid cron field value: ${part}`, "CRON_SCHEDULE");
+        }
+        out.add(n);
+    }
+    return out;
+}
+function matchesCronExpr(expr, date) {
+    const parts = expr.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        throw new CronError("cron expr must have 5 fields (min hour dom mon dow)", "CRON_SCHEDULE");
+    }
+    const minute = parseCronField(parts[0], 0, 59);
+    const hour = parseCronField(parts[1], 0, 23);
+    const dom = parseCronField(parts[2], 1, 31);
+    const month = parseCronField(parts[3], 1, 12);
+    const dow = parseCronField(parts[4], 0, 6);
+    const ok = (set, value) => (set === "any" ? true : set.has(value));
+    return (ok(minute, date.getUTCMinutes()) &&
+        ok(hour, date.getUTCHours()) &&
+        ok(dom, date.getUTCDate()) &&
+        ok(month, date.getUTCMonth() + 1) &&
+        ok(dow, date.getUTCDay()));
+}
+/** Validate schedule shape; throw CronError on bad input. */
+export function assertSchedule(schedule) {
+    if (schedule.kind === "every") {
+        if (!Number.isFinite(schedule.everySeconds) ||
+            schedule.everySeconds < MIN_EVERY_SECONDS) {
+            throw new CronError(`everySeconds must be >= ${MIN_EVERY_SECONDS}`, "CRON_SCHEDULE");
+        }
+        return;
+    }
+    if (schedule.kind === "at") {
+        const t = Date.parse(schedule.at);
+        if (!Number.isFinite(t)) {
+            throw new CronError(`invalid at timestamp: ${schedule.at}`, "CRON_SCHEDULE");
+        }
+        return;
+    }
+    // cron
+    matchesCronExpr(schedule.expr, new Date());
+}
+/**
+ * Compute next UTC fire time after `from` (exclusive for every/cron; at is absolute).
+ */
+export function nextRunAt(schedule, from = new Date()) {
+    assertSchedule(schedule);
+    if (schedule.kind === "at") {
+        const t = Date.parse(schedule.at);
+        return t > from.getTime() ? new Date(t).toISOString() : null;
+    }
+    if (schedule.kind === "every") {
+        const next = new Date(from.getTime() + schedule.everySeconds * 1000);
+        return next.toISOString();
+    }
+    // Scan forward up to 366 days of minutes for the next cron match.
+    const cursor = new Date(from.getTime());
+    cursor.setUTCSeconds(0, 0);
+    cursor.setUTCMinutes(cursor.getUTCMinutes() + 1);
+    const limit = from.getTime() + 366 * 24 * 60 * 60 * 1000;
+    while (cursor.getTime() <= limit) {
+        if (matchesCronExpr(schedule.expr, cursor)) {
+            return cursor.toISOString();
+        }
+        cursor.setUTCMinutes(cursor.getUTCMinutes() + 1);
+    }
+    return null;
+}
+export function isDue(nextRunAtIso, now = new Date()) {
+    if (!nextRunAtIso)
+        return false;
+    const t = Date.parse(nextRunAtIso);
+    return Number.isFinite(t) && t <= now.getTime();
+}
+//# sourceMappingURL=schedule.js.map

package/node_modules/@xrkseek/server-cron/dist/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../src/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAqB,MAAM,YAAY,CAAC;AAE7E,SAAS,cAAc,CACrB,KAAa,EACb,GAAW,EACX,GAAW;IAEX,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YAChE,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACpE,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,SAAS,CAAC,sBAAsB,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC;YACrE,CAAC;YACD,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;gBACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG;oBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG;oBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;YAC9C,MAAM,IAAI,SAAS,CAAC,6BAA6B,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC;QAC5E,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACb,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,IAAU;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CACjB,qDAAqD,EACrD,eAAe,CAChB,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,CACT,GAAgC,EAChC,KAAa,EACJ,EAAE,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,OAAO,CACL,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QAChC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACjC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAC1B,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,QAAsB;IACnD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;YACvC,QAAQ,CAAC,YAAY,GAAG,iBAAiB,EACzC,CAAC;YACD,MAAM,IAAI,SAAS,CACjB,2BAA2B,iBAAiB,EAAE,EAC9C,eAAe,CAChB,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC,yBAAyB,QAAQ,CAAC,EAAE,EAAE,EAAE,eAAe,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO;IACT,CAAC;IACD,OAAO;IACP,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,QAAsB,EACtB,OAAa,IAAI,IAAI,EAAE;IAEvB,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzB,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IACD,kEAAkE;IAClE,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACzD,OAAO,MAAM,CAAC,OAAO,EAAE,IAAI,KAAK,EAAE,CAAC;QACjC,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;YAC3C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,KAAK,CACnB,YAAuC,EACvC,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/node_modules/@xrkseek/server-cron/dist/scheduler.d.ts

@@ -0,0 +1,29 @@
+import { formatCronOutput } from "./runner.js";
+import { type CronAgentRunner, type CronDeliverer, type CronJob, type CronRunResult, type CronScriptRunner } from "./types.js";
+import type { CronJobStore } from "./store.js";
+export interface CronScheduler {
+    readonly store: CronJobStore;
+    start(): void;
+    stop(): void;
+    /** Run one tick (due jobs). Returns number of jobs started. */
+    tick(): Promise<number>;
+    /** Fire one job now (does not require due). */
+    runNow(id: string, signal?: AbortSignal): Promise<CronRunResult>;
+}
+export interface CreateCronSchedulerOptions {
+    readonly store: CronJobStore;
+    readonly runScript: CronScriptRunner;
+    readonly runAgent?: CronAgentRunner;
+    readonly deliver?: CronDeliverer;
+    readonly tickMs?: number;
+    readonly now?: () => Date;
+    readonly maxParallel?: number;
+    readonly onError?: (err: unknown, job?: CronJob) => void;
+}
+/**
+ * In-process Host cron ticker (Hermes-style). Dispatches agent turns and scripts,
+ * then delivers results via webhook/file.
+ */
+export declare function createCronScheduler(options: CreateCronSchedulerOptions): CronScheduler;
+export { formatCronOutput };
+//# sourceMappingURL=scheduler.d.ts.map

package/node_modules/@xrkseek/server-cron/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,+DAA+D;IAC/D,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,aAAa,CA4Jf;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/node_modules/@xrkseek/server-cron/dist/scheduler.js

@@ -0,0 +1,152 @@
+import { isDue, nextRunAt } from "./schedule.js";
+import { formatCronOutput } from "./runner.js";
+import { DEFAULT_TICK_MS, } from "./types.js";
+/**
+ * In-process Host cron ticker (Hermes-style). Dispatches agent turns and scripts,
+ * then delivers results via webhook/file.
+ */
+export function createCronScheduler(options) {
+    const tickMs = options.tickMs ?? DEFAULT_TICK_MS;
+    const maxParallel = options.maxParallel ?? 2;
+    const now = options.now ?? (() => new Date());
+    let timer;
+    let ticking = false;
+    const running = new Set();
+    const execute = async (job, signal) => {
+        if (job.run.kind === "script") {
+            return options.runScript(job, signal);
+        }
+        if (!options.runAgent) {
+            return {
+                ok: false,
+                output: "",
+                error: "agent cron runner is not configured on this Host (script jobs still work)",
+            };
+        }
+        return options.runAgent(job, signal);
+    };
+    const finish = async (job, result, signal) => {
+        const stamp = now().toISOString();
+        const scheduleNext = job.schedule.kind === "at"
+            ? null
+            : nextRunAt(job.schedule, now());
+        options.store.update(job.id, {
+            lastRunAt: stamp,
+            lastStatus: result.ok ? "ok" : "error",
+            ...(result.error ? { lastError: result.error } : { lastError: "" }),
+            lastOutputChars: result.output.length,
+            nextRunAt: scheduleNext,
+            ...(job.schedule.kind === "at" ? { enabled: false } : {}),
+        });
+        if (options.deliver && job.delivery.kind !== "none") {
+            try {
+                await options.deliver(job, result, signal);
+            }
+            catch (err) {
+                options.onError?.(err, job);
+            }
+        }
+    };
+    const runNow = async (id, signal) => {
+        const job = options.store.get(id);
+        if (!job) {
+            return { ok: false, output: "", error: `cron job not found: ${id}` };
+        }
+        if (running.has(id)) {
+            return { ok: false, output: "", error: "job already running" };
+        }
+        running.add(id);
+        try {
+            const result = await execute(job, signal);
+            await finish(job, result, signal);
+            return result;
+        }
+        finally {
+            running.delete(id);
+        }
+    };
+    const tick = async () => {
+        if (ticking)
+            return 0;
+        ticking = true;
+        try {
+            options.store.reload();
+            const due = options.store
+                .list()
+                .filter((j) => j.enabled &&
+                !running.has(j.id) &&
+                isDue(j.nextRunAt, now()))
+                .slice(0, Math.max(1, maxParallel - running.size));
+            await Promise.all(due.map(async (job) => {
+                running.add(job.id);
+                try {
+                    // Claim: advance next_run before execute (Hermes tick order).
+                    if (job.schedule.kind !== "at") {
+                        options.store.update(job.id, {
+                            nextRunAt: nextRunAt(job.schedule, now()),
+                        });
+                    }
+                    else {
+                        options.store.update(job.id, { nextRunAt: null, enabled: false });
+                    }
+                    const result = await execute(job);
+                    const stamp = now().toISOString();
+                    options.store.update(job.id, {
+                        lastRunAt: stamp,
+                        lastStatus: result.ok ? "ok" : "error",
+                        ...(result.error
+                            ? { lastError: result.error }
+                            : { lastError: "" }),
+                        lastOutputChars: result.output.length,
+                    });
+                    if (options.deliver && job.delivery.kind !== "none") {
+                        try {
+                            await options.deliver(job, result);
+                        }
+                        catch (err) {
+                            options.onError?.(err, job);
+                        }
+                    }
+                }
+                catch (err) {
+                    options.onError?.(err, job);
+                    options.store.update(job.id, {
+                        lastRunAt: now().toISOString(),
+                        lastStatus: "error",
+                        lastError: err instanceof Error ? err.message : String(err),
+                    });
+                }
+                finally {
+                    running.delete(job.id);
+                }
+            }));
+            return due.length;
+        }
+        finally {
+            ticking = false;
+        }
+    };
+    return {
+        store: options.store,
+        start() {
+            if (timer)
+                return;
+            timer = setInterval(() => {
+                void tick().catch((err) => options.onError?.(err));
+            }, tickMs);
+            if (typeof timer === "object" && "unref" in timer) {
+                timer.unref();
+            }
+        },
+        stop() {
+            if (timer) {
+                clearInterval(timer);
+                timer = undefined;
+            }
+        },
+        tick,
+        runNow,
+    };
+}
+export { formatCronOutput };
+//# sourceMappingURL=scheduler.js.map

package/node_modules/@xrkseek/server-cron/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/server-cron/dist/store.d.ts

@@ -0,0 +1,26 @@
+import { type CronDelivery, type CronJob, type CronJobCreateInput, type CronSchedule } from "./types.js";
+export interface CronJobStore {
+    list(): readonly CronJob[];
+    get(id: string): CronJob | undefined;
+    create(input: CronJobCreateInput): CronJob;
+    update(id: string, patch: Partial<{
+        name: string;
+        enabled: boolean;
+        schedule: CronSchedule;
+        run: CronJob["run"];
+        delivery: CronDelivery;
+        nextRunAt: string | null;
+        lastRunAt: string;
+        lastStatus: CronJob["lastStatus"];
+        lastError: string;
+        lastOutputChars: number;
+    }>): CronJob;
+    remove(id: string): boolean;
+    reload(): void;
+}
+export declare function createCronJobStore(options: {
+    readonly filePath: string;
+    readonly now?: () => Date;
+}): CronJobStore;
+export declare function defaultCronJobsPath(productHome: string): string;
+//# sourceMappingURL=store.d.ts.map

package/node_modules/@xrkseek/server-cron/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,SAAS,OAAO,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACrC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC;IAC3C,MAAM,CACJ,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,YAAY,CAAC;QACvB,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACpB,QAAQ,EAAE,YAAY,CAAC;QACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC,GACD,OAAO,CAAC;IACX,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,MAAM,IAAI,IAAI,CAAC;CAChB;AAmBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,GAAG,YAAY,CA+Gf;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/node_modules/@xrkseek/server-cron/dist/store.js

@@ -0,0 +1,127 @@
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { nextRunAt } from "./schedule.js";
+import { CronError, } from "./types.js";
+import { assertSchedule } from "./schedule.js";
+function defaultDelivery() {
+    return { kind: "none" };
+}
+function atomicWrite(filePath, text) {
+    const dir = path.dirname(filePath);
+    mkdirSync(dir, { recursive: true });
+    const tmp = `${filePath}.${process.pid}.${randomUUID().slice(0, 8)}.tmp`;
+    writeFileSync(tmp, text, "utf8");
+    renameSync(tmp, filePath);
+}
+export function createCronJobStore(options) {
+    const now = options.now ?? (() => new Date());
+    let jobs = [];
+    const persist = () => {
+        const body = { version: 1, jobs };
+        atomicWrite(options.filePath, `${JSON.stringify(body, null, 2)}\n`);
+    };
+    const reload = () => {
+        try {
+            const raw = readFileSync(options.filePath, "utf8");
+            const parsed = JSON.parse(raw);
+            if (parsed?.version !== 1 || !Array.isArray(parsed.jobs)) {
+                jobs = [];
+                return;
+            }
+            jobs = parsed.jobs.map((j) => ({ ...j }));
+        }
+        catch (err) {
+            const code = err && typeof err === "object" && "code" in err
+                ? String(err.code)
+                : "";
+            if (code === "ENOENT") {
+                jobs = [];
+                return;
+            }
+            throw new CronError(`failed to load cron jobs: ${err instanceof Error ? err.message : String(err)}`, "CRON_STORE");
+        }
+    };
+    reload();
+    return {
+        list() {
+            return jobs.map((j) => ({ ...j }));
+        },
+        get(id) {
+            const hit = jobs.find((j) => j.id === id);
+            return hit ? { ...hit } : undefined;
+        },
+        create(input) {
+            assertSchedule(input.schedule);
+            if (input.run.kind === "agent" && !input.run.prompt.trim()) {
+                throw new CronError("agent prompt must be non-empty", "CRON_ARGS");
+            }
+            if (input.run.kind === "script" && !input.run.command.trim()) {
+                throw new CronError("script command must be non-empty", "CRON_ARGS");
+            }
+            const stamp = now().toISOString();
+            const job = {
+                id: `cron_${randomUUID().replace(/-/g, "").slice(0, 12)}`,
+                ...(input.name?.trim() ? { name: input.name.trim() } : {}),
+                enabled: input.enabled !== false,
+                schedule: input.schedule,
+                run: input.run,
+                delivery: input.delivery ?? defaultDelivery(),
+                createdAt: stamp,
+                updatedAt: stamp,
+                nextRunAt: nextRunAt(input.schedule, now()),
+            };
+            jobs = [...jobs, job];
+            persist();
+            return { ...job };
+        },
+        update(id, patch) {
+            const idx = jobs.findIndex((j) => j.id === id);
+            if (idx < 0) {
+                throw new CronError(`cron job not found: ${id}`, "CRON_NOT_FOUND");
+            }
+            const prev = jobs[idx];
+            if (patch.schedule)
+                assertSchedule(patch.schedule);
+            const schedule = patch.schedule ?? prev.schedule;
+            const next = {
+                ...prev,
+                ...(patch.name !== undefined ? { name: patch.name } : {}),
+                ...(patch.enabled !== undefined ? { enabled: patch.enabled } : {}),
+                ...(patch.schedule !== undefined ? { schedule: patch.schedule } : {}),
+                ...(patch.run !== undefined ? { run: patch.run } : {}),
+                ...(patch.delivery !== undefined ? { delivery: patch.delivery } : {}),
+                ...(patch.nextRunAt !== undefined
+                    ? { nextRunAt: patch.nextRunAt }
+                    : patch.schedule !== undefined
+                        ? { nextRunAt: nextRunAt(schedule, now()) }
+                        : {}),
+                ...(patch.lastRunAt !== undefined ? { lastRunAt: patch.lastRunAt } : {}),
+                ...(patch.lastStatus !== undefined
+                    ? { lastStatus: patch.lastStatus }
+                    : {}),
+                ...(patch.lastError !== undefined ? { lastError: patch.lastError } : {}),
+                ...(patch.lastOutputChars !== undefined
+                    ? { lastOutputChars: patch.lastOutputChars }
+                    : {}),
+                updatedAt: now().toISOString(),
+            };
+            jobs = jobs.map((j, i) => (i === idx ? next : j));
+            persist();
+            return { ...next };
+        },
+        remove(id) {
+            const before = jobs.length;
+            jobs = jobs.filter((j) => j.id !== id);
+            if (jobs.length === before)
+                return false;
+            persist();
+            return true;
+        },
+        reload,
+    };
+}
+export function defaultCronJobsPath(productHome) {
+    return path.join(productHome, "cron", "jobs.json");
+}
+//# sourceMappingURL=store.js.map

package/node_modules/@xrkseek/server-cron/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/server-cron/dist/tools.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "@xrkseek/core-tools";
+import type { CronScheduler } from "./scheduler.js";
+export declare const CRON_PROMPT_TEXT: string;
+/**
+ * Model-facing `cronjob` tool (Hermes-style action discriminator).
+ */
+export declare function createCronTools(scheduler: CronScheduler): ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/node_modules/@xrkseek/server-cron/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AA8EpD,eAAO,MAAM,gBAAgB,QAGwE,CAAC;AAEtG;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,aAAa,GAAG,cAAc,EAAE,CAuH1E"}