@damian87/omp 0.4.1 → 0.6.0

package/dist/src/schedule/installers/launchd.js

@@ -0,0 +1,125 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export function launchdLabel(id) {
+    return `com.omp.schedule.${id}`;
+}
+export function launchdPlistPath(id) {
+    return join(homedir(), "Library", "LaunchAgents", `${launchdLabel(id)}.plist`);
+}
+const STEP_EVERY_MIN = /^\*\/(\d+)$/;
+/**
+ * Translate a simple 5-field cron to a launchd schedule. Returns null for
+ * patterns launchd's StartCalendarInterval cannot cleanly express (lists,
+ * ranges, multi-step) — the caller then falls back to crontab.
+ */
+export function cronToLaunchdInterval(cron) {
+    const parts = cron.trim().split(/\s+/);
+    if (parts.length !== 5)
+        return null;
+    const [min, hour, dom, mon, dow] = parts;
+    // every N minutes: */N * * * *
+    const minStep = STEP_EVERY_MIN.exec(min);
+    if (minStep && hour === "*" && dom === "*" && mon === "*" && dow === "*") {
+        return { startInterval: Number(minStep[1]) * 60 };
+    }
+    // every N hours: 0 */N * * *
+    const hourStep = STEP_EVERY_MIN.exec(hour);
+    if (min === "0" && hourStep && dom === "*" && mon === "*" && dow === "*") {
+        return { startInterval: Number(hourStep[1]) * 3600 };
+    }
+    const isNum = (s) => /^\d+$/.test(s);
+    // daily at H:M — minute & hour numeric, date/dow wild
+    if (isNum(min) && isNum(hour) && dom === "*" && mon === "*" && dow === "*") {
+        return { startCalendarInterval: { Minute: Number(min), Hour: Number(hour) } };
+    }
+    // weekly at H:M on a single weekday
+    if (isNum(min) && isNum(hour) && dom === "*" && mon === "*" && isNum(dow)) {
+        return { startCalendarInterval: { Minute: Number(min), Hour: Number(hour), Weekday: Number(dow) } };
+    }
+    return null;
+}
+function xmlEscape(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+function calendarXml(cal) {
+    const entries = Object.entries(cal)
+        .filter(([, v]) => v !== undefined)
+        .map(([k, v]) => `      <key>${k}</key>\n      <integer>${v}</integer>`)
+        .join("\n");
+    return `  <key>StartCalendarInterval</key>\n  <dict>\n${entries}\n  </dict>`;
+}
+/** Generate the LaunchAgent plist XML. Deliberately omits KeepAlive (timer jobs must not auto-restart). */
+export function generatePlist(job, sched, logsDir, stateRoot) {
+    const label = launchdLabel(job.id);
+    const outLog = join(logsDir, job.id, `${job.id}.launchd.out.log`);
+    const errLog = join(logsDir, job.id, `${job.id}.launchd.err.log`);
+    const scheduleXml = sched.startInterval !== undefined
+        ? `  <key>StartInterval</key>\n  <integer>${sched.startInterval}</integer>`
+        : calendarXml(sched.startCalendarInterval ?? {});
+    // run from stateRoot and pass --root so state resolves correctly; the agent
+    // subprocess cwd (job.cwd) is set by the runner, not by WorkingDirectory.
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${xmlEscape(label)}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${xmlEscape(job.ompBinPath)}</string>
+    <string>schedule</string>
+    <string>run</string>
+    <string>--id</string>
+    <string>${xmlEscape(job.id)}</string>
+    <string>--root</string>
+    <string>${xmlEscape(stateRoot)}</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${xmlEscape(stateRoot)}</string>
+${scheduleXml}
+  <key>StandardOutPath</key>
+  <string>${xmlEscape(outLog)}</string>
+  <key>StandardErrorPath</key>
+  <string>${xmlEscape(errLog)}</string>
+</dict>
+</plist>
+`;
+}
+function gui() {
+    return `gui/${process.getuid?.() ?? 0}`;
+}
+export function installLaunchd(job, sched, logsDir, stateRoot) {
+    const plistPath = launchdPlistPath(job.id);
+    mkdirSync(dirname(plistPath), { recursive: true });
+    mkdirSync(join(logsDir, job.id), { recursive: true });
+    writeFileSync(plistPath, generatePlist(job, sched, logsDir, stateRoot), "utf8");
+    try {
+        execFileSync("launchctl", ["bootout", `${gui()}/${launchdLabel(job.id)}`], { stdio: "ignore" });
+    }
+    catch {
+        // not loaded yet — fine
+    }
+    execFileSync("launchctl", ["bootstrap", gui(), plistPath], { stdio: "ignore" });
+}
+export function uninstallLaunchd(id) {
+    try {
+        execFileSync("launchctl", ["bootout", `${gui()}/${launchdLabel(id)}`], { stdio: "ignore" });
+    }
+    catch {
+        // already gone
+    }
+    const plistPath = launchdPlistPath(id);
+    if (existsSync(plistPath))
+        unlinkSync(plistPath);
+}
+export function statusLaunchd(id) {
+    return existsSync(launchdPlistPath(id));
+}
+//# sourceMappingURL=launchd.js.map

package/dist/src/schedule/installers/launchd.js.map

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

package/dist/src/schedule/installers/systemd.d.ts

@@ -0,0 +1,15 @@
+import type { ScheduleJob } from "../types.js";
+export declare function unitBaseName(id: string): string;
+export declare function servicePath(id: string): string;
+export declare function timerPath(id: string): string;
+/**
+ * Translate a 5-field cron to a systemd OnCalendar expression. Covers the
+ * common patterns (every-N-min, every-N-hours, daily/weekly at H:M including
+ * day-of-week); approximates the rest with a best-effort date-time mapping.
+ */
+export declare function cronToSystemdCalendar(cron: string): string;
+export declare function generateService(job: ScheduleJob, stateRoot: string): string;
+export declare function generateTimer(job: ScheduleJob): string;
+export declare function installSystemd(job: ScheduleJob, stateRoot: string): void;
+export declare function uninstallSystemd(id: string): void;
+export declare function statusSystemd(id: string): boolean;

package/dist/src/schedule/installers/systemd.js

@@ -0,0 +1,136 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function unitBaseName(id) {
+    return `omp-schedule-${id}`;
+}
+function userUnitDir() {
+    return join(homedir(), ".config", "systemd", "user");
+}
+export function servicePath(id) {
+    return join(userUnitDir(), `${unitBaseName(id)}.service`);
+}
+export function timerPath(id) {
+    return join(userUnitDir(), `${unitBaseName(id)}.timer`);
+}
+const STEP_EVERY = /^\*\/(\d+)$/;
+const DAY_NAMES = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+function dayName(n) {
+    const v = Number(n);
+    if (!Number.isInteger(v))
+        return undefined;
+    return DAY_NAMES[v % 7]; // cron allows 0 and 7 for Sunday
+}
+/** Translate a cron day-of-week field to a systemd day prefix (empty when wild/unparseable). */
+function dowToSystemd(dow) {
+    if (dow === "*")
+        return "";
+    if (/^\d+$/.test(dow))
+        return dayName(dow) ?? "";
+    const range = /^(\d+)-(\d+)$/.exec(dow);
+    if (range) {
+        const a = dayName(range[1]);
+        const b = dayName(range[2]);
+        return a && b ? `${a}..${b}` : "";
+    }
+    if (dow.includes(",")) {
+        const names = dow.split(",").map((d) => dayName(d.trim()));
+        if (names.every(Boolean))
+            return names.join(",");
+    }
+    return "";
+}
+/**
+ * Translate a 5-field cron to a systemd OnCalendar expression. Covers the
+ * common patterns (every-N-min, every-N-hours, daily/weekly at H:M including
+ * day-of-week); approximates the rest with a best-effort date-time mapping.
+ */
+export function cronToSystemdCalendar(cron) {
+    const parts = cron.trim().split(/\s+/);
+    if (parts.length !== 5)
+        return cron;
+    const [min, hour, dom, mon, dow] = parts;
+    const minStep = STEP_EVERY.exec(min);
+    if (minStep && hour === "*" && dom === "*" && mon === "*" && dow === "*") {
+        return `*:0/${minStep[1]}`; // every N minutes
+    }
+    const hourStep = STEP_EVERY.exec(hour);
+    if (min === "0" && hourStep && dom === "*" && mon === "*" && dow === "*") {
+        return `0/${hourStep[1]}:00`; // every N hours
+    }
+    const pad = (s) => (/^\d+$/.test(s) ? s.padStart(2, "0") : "*");
+    const time = `${pad(hour)}:${pad(min)}:00`;
+    const dayPrefix = dowToSystemd(dow);
+    const prefix = dayPrefix ? `${dayPrefix} ` : "";
+    if (dom === "*" && mon === "*") {
+        return `${prefix}*-*-* ${time}`;
+    }
+    // best effort with date components
+    return `${prefix}*-${pad(mon)}-${pad(dom)} ${time}`;
+}
+/** Double-quote a value for a systemd unit (handles spaces; escapes backslash and quote). */
+function sdq(s) {
+    return `"${s.replace(/(["\\])/g, "\\$1")}"`;
+}
+export function generateService(job, stateRoot) {
+    // Run from stateRoot with --root so state resolves independent of agent cwd.
+    return `[Unit]
+Description=omp scheduled job ${job.id}
+
+[Service]
+Type=oneshot
+ExecStart=${sdq(job.ompBinPath)} schedule run --id ${job.id} --root ${sdq(stateRoot)}
+WorkingDirectory=${sdq(stateRoot)}
+`;
+}
+export function generateTimer(job) {
+    return `[Unit]
+Description=Timer for omp scheduled job ${job.id}
+
+[Timer]
+OnCalendar=${cronToSystemdCalendar(job.cron)}
+Persistent=true
+
+[Install]
+WantedBy=timers.target
+`;
+}
+export function installSystemd(job, stateRoot) {
+    mkdirSync(userUnitDir(), { recursive: true });
+    writeFileSync(servicePath(job.id), generateService(job, stateRoot), "utf8");
+    writeFileSync(timerPath(job.id), generateTimer(job), "utf8");
+    execFileSync("systemctl", ["--user", "daemon-reload"], { stdio: "ignore" });
+    execFileSync("systemctl", ["--user", "enable", "--now", `${unitBaseName(job.id)}.timer`], { stdio: "ignore" });
+}
+export function uninstallSystemd(id) {
+    try {
+        execFileSync("systemctl", ["--user", "disable", "--now", `${unitBaseName(id)}.timer`], { stdio: "ignore" });
+    }
+    catch {
+        // already disabled
+    }
+    for (const p of [servicePath(id), timerPath(id)]) {
+        if (existsSync(p))
+            unlinkSync(p);
+    }
+    try {
+        execFileSync("systemctl", ["--user", "daemon-reload"], { stdio: "ignore" });
+    }
+    catch {
+        // best effort
+    }
+}
+export function statusSystemd(id) {
+    try {
+        const out = execFileSync("systemctl", ["--user", "is-active", `${unitBaseName(id)}.timer`], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return out.trim() === "active";
+    }
+    catch {
+        return existsSync(timerPath(id));
+    }
+}
+//# sourceMappingURL=systemd.js.map

package/dist/src/schedule/installers/systemd.js.map

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

package/dist/src/schedule/job-store.d.ts

@@ -0,0 +1,21 @@
+import type { ScheduleJob, ScheduleRunResult } from "./types.js";
+/** Atomic write (tmp + rename), mirroring task-store.writeTask. */
+export declare function writeJob(jobPath: string, job: ScheduleJob): void;
+export declare function readJob(jobPath: string): ScheduleJob | undefined;
+export declare function listJobs(jobsDir: string): ScheduleJob[];
+export declare function deleteJob(jobPath: string): void;
+/** Append a result line. Append-only — never read-modify-write (race-free under concurrent runs). */
+export declare function appendRunResult(resultsPath: string, result: ScheduleRunResult): void;
+/** Atomic write of the byte-offset cursor (tmp + rename). */
+export declare function advanceCursor(cursorPath: string, bytes: number): void;
+export interface ResultsScan {
+    results: ScheduleRunResult[];
+    newCursor: number;
+    cursor: number;
+}
+/**
+ * Read result lines from the stored byte offset to EOF, parsing only complete
+ * lines. Mirrors outbox.scanFromCursor. `maxBytes` bounds the read so a hook
+ * with a tight time budget never scans an unbounded file.
+ */
+export declare function readResultsFrom(resultsPath: string, cursorPath: string, maxBytes?: number): ResultsScan;

package/dist/src/schedule/job-store.js

@@ -0,0 +1,102 @@
+import { appendFileSync, closeSync, existsSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+/** Atomic write (tmp + rename), mirroring task-store.writeTask. */
+export function writeJob(jobPath, job) {
+    mkdirSync(dirname(jobPath), { recursive: true });
+    const tmp = `${jobPath}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, JSON.stringify(job, null, 2), "utf8");
+    renameSync(tmp, jobPath);
+}
+export function readJob(jobPath) {
+    if (!existsSync(jobPath))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(jobPath, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function listJobs(jobsDir) {
+    if (!existsSync(jobsDir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(jobsDir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith(".json"))
+            continue;
+        const job = readJob(join(jobsDir, entry.name));
+        if (job)
+            out.push(job);
+    }
+    return out.sort((a, b) => a.id.localeCompare(b.id));
+}
+export function deleteJob(jobPath) {
+    if (existsSync(jobPath))
+        unlinkSync(jobPath);
+}
+/** Append a result line. Append-only — never read-modify-write (race-free under concurrent runs). */
+export function appendRunResult(resultsPath, result) {
+    mkdirSync(dirname(resultsPath), { recursive: true });
+    appendFileSync(resultsPath, `${JSON.stringify(result)}\n`, "utf8");
+}
+function readCursorBytes(cursorPath) {
+    if (!existsSync(cursorPath))
+        return 0;
+    try {
+        const data = JSON.parse(readFileSync(cursorPath, "utf8"));
+        return Number(data.bytesRead) || 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/** Atomic write of the byte-offset cursor (tmp + rename). */
+export function advanceCursor(cursorPath, bytes) {
+    mkdirSync(dirname(cursorPath), { recursive: true });
+    const tmp = `${cursorPath}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, JSON.stringify({ bytesRead: bytes }), "utf8");
+    renameSync(tmp, cursorPath);
+}
+/**
+ * Read result lines from the stored byte offset to EOF, parsing only complete
+ * lines. Mirrors outbox.scanFromCursor. `maxBytes` bounds the read so a hook
+ * with a tight time budget never scans an unbounded file.
+ */
+export function readResultsFrom(resultsPath, cursorPath, maxBytes = 16_384) {
+    let cursor = readCursorBytes(cursorPath);
+    if (!existsSync(resultsPath))
+        return { results: [], newCursor: cursor, cursor };
+    const stats = statSync(resultsPath);
+    if (cursor > stats.size)
+        cursor = 0; // file truncated/rotated → re-read from start
+    if (cursor >= stats.size)
+        return { results: [], newCursor: cursor, cursor };
+    const remaining = Math.min(stats.size - cursor, maxBytes);
+    const fd = openSync(resultsPath, "r");
+    const buf = Buffer.alloc(remaining);
+    try {
+        readSync(fd, buf, 0, remaining, cursor);
+    }
+    finally {
+        closeSync(fd);
+    }
+    const text = buf.toString("utf8");
+    const lastNewline = text.lastIndexOf("\n");
+    if (lastNewline === -1)
+        return { results: [], newCursor: cursor, cursor };
+    const consumed = text.slice(0, lastNewline + 1);
+    const newCursor = cursor + Buffer.byteLength(consumed, "utf8");
+    const results = [];
+    for (const line of consumed.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            results.push(JSON.parse(line));
+        }
+        catch {
+            // ignore unparseable line; cursor still advances past it
+        }
+    }
+    return { results, newCursor, cursor };
+}
+//# sourceMappingURL=job-store.js.map

package/dist/src/schedule/job-store.js.map

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

package/dist/src/schedule/lock.d.ts

@@ -0,0 +1,9 @@
+export interface LockHandle {
+    acquired: boolean;
+    release: () => void;
+}
+/** Acquire an exclusive lock via `openSync(..., 'wx')` (mirrors task-store). */
+export declare function acquireLock(lockPath: string): LockHandle;
+/** A lock is stale if its owner PID is dead or it is older than 2× maxAgeMs. */
+export declare function isLockStale(lockPath: string, maxAgeMs: number): boolean;
+export declare function forceReleaseStaleLock(lockPath: string, maxAgeMs: number): void;

package/dist/src/schedule/lock.js

@@ -0,0 +1,83 @@
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { dirname } from "node:path";
+function readLock(lockPath) {
+    try {
+        return JSON.parse(readFileSync(lockPath, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Acquire an exclusive lock via `openSync(..., 'wx')` (mirrors task-store). */
+export function acquireLock(lockPath) {
+    mkdirSync(dirname(lockPath), { recursive: true });
+    let fd;
+    try {
+        fd = openSync(lockPath, "wx");
+    }
+    catch {
+        return { acquired: false, release: () => { } };
+    }
+    const token = randomUUID();
+    try {
+        writeFileSync(lockPath, JSON.stringify({ pid: process.pid, acquiredAt: new Date().toISOString(), token }));
+    }
+    finally {
+        closeSync(fd);
+    }
+    return {
+        acquired: true,
+        // Only delete the lock if it is still OURS — a stale-steal may have replaced
+        // it with a newer holder's lock, which we must not unlink.
+        release: () => {
+            if (readLock(lockPath)?.token === token) {
+                try {
+                    unlinkSync(lockPath);
+                }
+                catch {
+                    // ignore: already gone
+                }
+            }
+        },
+    };
+}
+function pidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // ESRCH => no such process (dead). EPERM => exists but not ours (alive).
+        return err.code === "EPERM";
+    }
+}
+/** A lock is stale if its owner PID is dead or it is older than 2× maxAgeMs. */
+export function isLockStale(lockPath, maxAgeMs) {
+    if (!existsSync(lockPath))
+        return false;
+    let data;
+    try {
+        data = JSON.parse(readFileSync(lockPath, "utf8"));
+    }
+    catch {
+        return true; // unparseable lock is stale
+    }
+    if (!pidAlive(data.pid))
+        return true;
+    const age = Date.now() - Date.parse(data.acquiredAt);
+    return Number.isFinite(age) && age > 2 * maxAgeMs;
+}
+export function forceReleaseStaleLock(lockPath, maxAgeMs) {
+    if (isLockStale(lockPath, maxAgeMs)) {
+        try {
+            unlinkSync(lockPath);
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/src/schedule/lock.js.map

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

package/dist/src/schedule/paths.d.ts

@@ -0,0 +1,15 @@
+export interface SchedulePaths {
+    cwd: string;
+    scheduleRoot: string;
+    jobsDir: string;
+    logsDir: string;
+    resultsDir: string;
+}
+export declare function resolveSchedulePaths(cwd: string): SchedulePaths;
+export declare function jobFilePath(jobsDir: string, id: string): string;
+export declare function jobLockPath(jobsDir: string, id: string): string;
+export declare function runLogDir(logsDir: string, id: string): string;
+export declare function resultsFilePath(resultsDir: string, id: string): string;
+/** Byte-offset cursor for "seen" results (mirrors team outbox `.offset`). */
+export declare function resultsCursorPath(resultsDir: string, id: string): string;
+export declare function ensureScheduleDirs(paths: SchedulePaths): void;

package/dist/src/schedule/paths.js

@@ -0,0 +1,36 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { join, resolve } from "node:path";
+export function resolveSchedulePaths(cwd) {
+    const root = resolve(cwd);
+    const scheduleRoot = join(root, ".omp", "state", "schedule");
+    return {
+        cwd: root,
+        scheduleRoot,
+        jobsDir: join(scheduleRoot, "jobs"),
+        logsDir: join(scheduleRoot, "logs"),
+        resultsDir: join(scheduleRoot, "results"),
+    };
+}
+export function jobFilePath(jobsDir, id) {
+    return join(jobsDir, `${id}.json`);
+}
+export function jobLockPath(jobsDir, id) {
+    return join(jobsDir, `${id}.lock`);
+}
+export function runLogDir(logsDir, id) {
+    return join(logsDir, id);
+}
+export function resultsFilePath(resultsDir, id) {
+    return join(resultsDir, `${id}.jsonl`);
+}
+/** Byte-offset cursor for "seen" results (mirrors team outbox `.offset`). */
+export function resultsCursorPath(resultsDir, id) {
+    return join(resultsDir, `${id}.offset`);
+}
+export function ensureScheduleDirs(paths) {
+    for (const dir of [paths.scheduleRoot, paths.jobsDir, paths.logsDir, paths.resultsDir]) {
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/schedule/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/schedule/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAU1C,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7D,OAAO;QACL,GAAG,EAAE,IAAI;QACT,YAAY;QACZ,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;QACnC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;QACnC,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,EAAU;IACrD,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,EAAU;IACrD,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,EAAU;IACnD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,EAAU;IAC5D,OAAO,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,EAAU;IAC9D,OAAO,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACrD,KAAK,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QACvF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/src/schedule/runner.d.ts

@@ -0,0 +1,8 @@
+import { type SchedulePaths } from "./paths.js";
+import { type ScheduleJob, type ScheduleRunResult } from "./types.js";
+export interface RunOptions {
+    /** Called when a job has expired (TTL passed or maxRuns reached) so the caller can uninstall the OS entry. */
+    onExpire?: (job: ScheduleJob) => void;
+}
+/** Execute one scheduled run (expiry check, overlap lock, timeout, log capture, result append). */
+export declare function runScheduledJob(job: ScheduleJob, paths: SchedulePaths, opts?: RunOptions): Promise<ScheduleRunResult>;