@damian87/omp 0.5.0 → 0.6.0

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

@@ -0,0 +1,20 @@
+import type { OsBackend, ScheduleJob } from "./types.js";
+export interface DetectOptions {
+    platform?: NodeJS.Platform;
+    hasSystemctl?: boolean;
+}
+/** Pick the native backend for this host. Inputs are injectable for testing. */
+export declare function detectOsBackend(opts?: DetectOptions): OsBackend;
+export interface InstallResult {
+    backend: OsBackend;
+    installed: boolean;
+}
+/**
+ * Install the OS-scheduler entry for a job. On launchd, a cron expression that
+ * StartCalendarInterval cannot express falls back to crontab — the chosen
+ * backend is returned so the caller can persist it on the job.
+ */
+export declare function installJob(job: ScheduleJob, logsDir: string, stateRoot: string, opts?: DetectOptions): InstallResult;
+/** Uninstall by the job's recorded backend. Idempotent — never throws if absent. */
+export declare function uninstallJob(id: string, backend: OsBackend): void;
+export declare function getInstalledStatus(id: string, backend: OsBackend): boolean;

package/dist/src/schedule/installer.js

@@ -0,0 +1,76 @@
+import { execFileSync } from "node:child_process";
+import { cronToLaunchdInterval, installLaunchd, statusLaunchd, uninstallLaunchd } from "./installers/launchd.js";
+import { installCrontab, statusCrontab, uninstallCrontab } from "./installers/crontab.js";
+import { installSystemd, statusSystemd, uninstallSystemd } from "./installers/systemd.js";
+function systemctlAvailable() {
+    try {
+        execFileSync("systemctl", ["--user", "--version"], { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Pick the native backend for this host. Inputs are injectable for testing. */
+export function detectOsBackend(opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    if (platform === "darwin")
+        return "launchd";
+    const hasSystemctl = opts.hasSystemctl ?? systemctlAvailable();
+    if (hasSystemctl)
+        return "systemd";
+    return "crontab";
+}
+/**
+ * Install the OS-scheduler entry for a job. On launchd, a cron expression that
+ * StartCalendarInterval cannot express falls back to crontab — the chosen
+ * backend is returned so the caller can persist it on the job.
+ */
+export function installJob(job, logsDir, stateRoot, opts = {}) {
+    const backend = detectOsBackend(opts);
+    // Replace semantics: clear any prior entry for this id first.
+    uninstallJob(job.id, backend);
+    if (backend === "launchd") {
+        const sched = cronToLaunchdInterval(job.cron);
+        if (sched === null) {
+            // launchd can't express this cron — fall back to crontab.
+            installCrontab(job, logsDir, stateRoot);
+            return { backend: "crontab", installed: true };
+        }
+        installLaunchd(job, sched, logsDir, stateRoot);
+        return { backend: "launchd", installed: true };
+    }
+    if (backend === "systemd") {
+        installSystemd(job, stateRoot);
+        return { backend: "systemd", installed: true };
+    }
+    installCrontab(job, logsDir, stateRoot);
+    return { backend: "crontab", installed: true };
+}
+/** Uninstall by the job's recorded backend. Idempotent — never throws if absent. */
+export function uninstallJob(id, backend) {
+    try {
+        if (backend === "launchd")
+            uninstallLaunchd(id);
+        else if (backend === "systemd")
+            uninstallSystemd(id);
+        else
+            uninstallCrontab(id);
+    }
+    catch {
+        // best effort — entry may already be gone
+    }
+}
+export function getInstalledStatus(id, backend) {
+    try {
+        if (backend === "launchd")
+            return statusLaunchd(id);
+        if (backend === "systemd")
+            return statusSystemd(id);
+        return statusCrontab(id);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=installer.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { ScheduleJob } from "../types.js";
+export declare const BLOCK_BEGIN = "# BEGIN omp-schedule";
+export declare const BLOCK_END = "# END omp-schedule";
+/** The crontab command line for a job (without the id marker). */
+export declare function crontabEntryLine(job: ScheduleJob, logsDir: string, stateRoot: string): string;
+/** Parse the managed block of an existing crontab into an ordered id→line map. */
+export declare function parseManagedBlock(existing: string): Map<string, string>;
+/** Pure: add or replace the entry for `id` in the managed block. */
+export declare function applyCrontabBlock(existing: string, id: string, entryLine: string): string;
+/** Pure: remove the entry for `id`; drops the block markers when it empties. */
+export declare function removeCrontabEntry(existing: string, id: string): string;
+export declare function hasCrontabEntry(existing: string, id: string): boolean;
+export declare function readCrontab(): string;
+export declare function writeCrontab(content: string): void;
+export declare function installCrontab(job: ScheduleJob, logsDir: string, stateRoot: string): string;
+export declare function uninstallCrontab(id: string): void;
+export declare function statusCrontab(id: string): boolean;

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

@@ -0,0 +1,112 @@
+import { execSync } from "node:child_process";
+import { join } from "node:path";
+export const BLOCK_BEGIN = "# BEGIN omp-schedule";
+export const BLOCK_END = "# END omp-schedule";
+const ID_PREFIX = "# omp:";
+/** Single-quote a value for safe shell interpolation. */
+function shq(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+/** The crontab command line for a job (without the id marker). */
+export function crontabEntryLine(job, logsDir, stateRoot) {
+    const logFile = join(logsDir, job.id, `${job.id}.cron.log`);
+    // `omp schedule run` resolves state from --root (independent of the agent cwd).
+    return `${job.cron} ${shq(job.ompBinPath)} schedule run --id ${job.id} --root ${shq(stateRoot)} >> ${shq(logFile)} 2>&1`;
+}
+/** Parse the managed block of an existing crontab into an ordered id→line map. */
+export function parseManagedBlock(existing) {
+    const out = new Map();
+    const lines = existing.split("\n");
+    let inBlock = false;
+    let currentId;
+    for (const line of lines) {
+        if (line.trim() === BLOCK_BEGIN) {
+            inBlock = true;
+            continue;
+        }
+        if (line.trim() === BLOCK_END) {
+            inBlock = false;
+            continue;
+        }
+        if (!inBlock)
+            continue;
+        if (line.startsWith(ID_PREFIX)) {
+            currentId = line.slice(ID_PREFIX.length).trim();
+            continue;
+        }
+        if (currentId && line.trim()) {
+            out.set(currentId, line);
+            currentId = undefined;
+        }
+    }
+    return out;
+}
+/** Strip the managed block, returning everything outside it (trimmed). */
+function stripManagedBlock(existing) {
+    const lines = existing.split("\n");
+    const kept = [];
+    let inBlock = false;
+    for (const line of lines) {
+        if (line.trim() === BLOCK_BEGIN) {
+            inBlock = true;
+            continue;
+        }
+        if (line.trim() === BLOCK_END) {
+            inBlock = false;
+            continue;
+        }
+        if (!inBlock)
+            kept.push(line);
+    }
+    return kept.join("\n").trim();
+}
+/** Render a fresh crontab from outside-block content + the managed entries. */
+function render(outside, entries) {
+    if (entries.size === 0) {
+        return outside ? `${outside}\n` : "";
+    }
+    const block = [BLOCK_BEGIN];
+    for (const [id, line] of entries) {
+        block.push(`${ID_PREFIX}${id}`, line);
+    }
+    block.push(BLOCK_END);
+    return `${outside ? `${outside}\n\n` : ""}${block.join("\n")}\n`;
+}
+/** Pure: add or replace the entry for `id` in the managed block. */
+export function applyCrontabBlock(existing, id, entryLine) {
+    const entries = parseManagedBlock(existing);
+    entries.set(id, entryLine);
+    return render(stripManagedBlock(existing), entries);
+}
+/** Pure: remove the entry for `id`; drops the block markers when it empties. */
+export function removeCrontabEntry(existing, id) {
+    const entries = parseManagedBlock(existing);
+    entries.delete(id);
+    return render(stripManagedBlock(existing), entries);
+}
+export function hasCrontabEntry(existing, id) {
+    return parseManagedBlock(existing).has(id);
+}
+export function readCrontab() {
+    try {
+        return execSync("crontab -l 2>/dev/null", { encoding: "utf8" });
+    }
+    catch {
+        return ""; // no crontab yet
+    }
+}
+export function writeCrontab(content) {
+    execSync("crontab -", { input: content });
+}
+export function installCrontab(job, logsDir, stateRoot) {
+    const next = applyCrontabBlock(readCrontab(), job.id, crontabEntryLine(job, logsDir, stateRoot));
+    writeCrontab(next);
+    return "crontab";
+}
+export function uninstallCrontab(id) {
+    writeCrontab(removeCrontabEntry(readCrontab(), id));
+}
+export function statusCrontab(id) {
+    return hasCrontabEntry(readCrontab(), id);
+}
+//# sourceMappingURL=crontab.js.map

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

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

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

@@ -0,0 +1,22 @@
+import type { ScheduleJob } from "../types.js";
+export declare function launchdLabel(id: string): string;
+export declare function launchdPlistPath(id: string): string;
+export interface LaunchdSchedule {
+    startInterval?: number;
+    startCalendarInterval?: {
+        Minute?: number;
+        Hour?: number;
+        Weekday?: number;
+    };
+}
+/**
+ * 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 declare function cronToLaunchdInterval(cron: string): LaunchdSchedule | null;
+/** Generate the LaunchAgent plist XML. Deliberately omits KeepAlive (timer jobs must not auto-restart). */
+export declare function generatePlist(job: ScheduleJob, sched: LaunchdSchedule, logsDir: string, stateRoot: string): string;
+export declare function installLaunchd(job: ScheduleJob, sched: LaunchdSchedule, logsDir: string, stateRoot: string): void;
+export declare function uninstallLaunchd(id: string): void;
+export declare function statusLaunchd(id: string): boolean;

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;