@damian87/omp 0.5.0 → 0.6.0

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":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9G,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,SAAS,QAAQ,CAAC,QAAgB;IAChC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAa,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,EAAU,CAAC;IACf,IAAI,CAAC;QACH,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAChD,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,aAAa,CACX,QAAQ,EACR,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAqB,CAAC,CACrG,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,6EAA6E;QAC7E,2DAA2D;QAC3D,OAAO,EAAE,GAAG,EAAE;YACZ,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,KAAK,KAAK,EAAE,CAAC;gBACxC,IAAI,CAAC;oBACH,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACvB,CAAC;gBAAC,MAAM,CAAC;oBACP,uBAAuB;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yEAAyE;QACzE,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;IACzD,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAAgB;IAC5D,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAa,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,4BAA4B;IAC3C,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,QAAgB;IACtE,IAAI,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;AACH,CAAC"}

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>;

package/dist/src/schedule/runner.js

@@ -0,0 +1,151 @@
+import { spawn } from "node:child_process";
+import { existsSync, mkdirSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveCopilotBin } from "../copilot/launch.js";
+import { appendRunResult, readJob, writeJob } from "./job-store.js";
+import { acquireLock, forceReleaseStaleLock, isLockStale } from "./lock.js";
+import { jobFilePath, jobLockPath, resultsFilePath, runLogDir } from "./paths.js";
+import { DEFAULT_TIMEOUT_MS } from "./types.js";
+function isExpired(job) {
+    if (job.maxRuns !== undefined && job.runCount >= job.maxRuns)
+        return true;
+    if (job.expiresAt && Date.now() > Date.parse(job.expiresAt))
+        return true;
+    return false;
+}
+function timestampSlug() {
+    return new Date().toISOString().replace(/[:.]/g, "-");
+}
+/** Keep only the newest `keep` per-run logs in a job's log dir (timestamp slugs sort chronologically). */
+function rotateLogs(logDir, keep = 50) {
+    if (!existsSync(logDir))
+        return;
+    const files = readdirSync(logDir)
+        .filter((f) => f.endsWith(".log"))
+        .sort();
+    for (const f of files.slice(0, Math.max(0, files.length - keep))) {
+        try {
+            unlinkSync(join(logDir, f));
+        }
+        catch {
+            // best effort
+        }
+    }
+}
+/** Execute one scheduled run (expiry check, overlap lock, timeout, log capture, result append). */
+export async function runScheduledJob(job, paths, opts = {}) {
+    const timeoutMs = job.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const jobPath = jobFilePath(paths.jobsDir, job.id);
+    const resultsPath = resultsFilePath(paths.resultsDir, job.id);
+    const persist = (status, result, incrementRun) => {
+        appendRunResult(resultsPath, result);
+        const current = readJob(jobPath) ?? job;
+        writeJob(jobPath, {
+            ...current,
+            runCount: incrementRun ? current.runCount + 1 : current.runCount,
+            lastRunAt: result.ts,
+            lastStatus: status,
+            lastSummary: result.summary,
+            lastLogPath: result.logPath,
+            active: status === "expired" ? false : current.active,
+        });
+    };
+    // 1. Expiry / max-runs check BEFORE any spawn.
+    if (isExpired(job)) {
+        const result = {
+            ts: new Date().toISOString(),
+            exitCode: 0,
+            status: "expired",
+            summary: "job expired (TTL or max-runs reached); deactivated",
+            logPath: "",
+            durationMs: 0,
+        };
+        persist("expired", result, false);
+        opts.onExpire?.(job);
+        return result;
+    }
+    // 2. Overlap lock.
+    const lockPath = jobLockPath(paths.jobsDir, job.id);
+    forceReleaseStaleLock(lockPath, timeoutMs);
+    let lock = acquireLock(lockPath);
+    if (!lock.acquired) {
+        if (isLockStale(lockPath, timeoutMs)) {
+            forceReleaseStaleLock(lockPath, timeoutMs);
+            lock = acquireLock(lockPath);
+        }
+    }
+    if (!lock.acquired) {
+        const result = {
+            ts: new Date().toISOString(),
+            exitCode: -1,
+            status: "locked",
+            summary: "previous run still in progress; skipped",
+            logPath: "",
+            durationMs: 0,
+        };
+        appendRunResult(resultsPath, result);
+        return result;
+    }
+    // 3. Spawn the agent and capture output.
+    const startedAt = Date.now();
+    const logDir = runLogDir(paths.logsDir, job.id);
+    mkdirSync(logDir, { recursive: true });
+    const logPath = join(logDir, `${timestampSlug()}.log`);
+    try {
+        const bin = resolveCopilotBin(job.bin);
+        const args = [];
+        if (job.model)
+            args.push("--model", job.model);
+        args.push("-p", job.prompt);
+        if (job.allowAllTools)
+            args.push("--allow-all-tools");
+        const result = await new Promise((resolveFn) => {
+            const child = spawn(bin, args, { stdio: ["ignore", "pipe", "pipe"], cwd: job.cwd });
+            let stdout = "";
+            let stderr = "";
+            let timedOut = false;
+            let settled = false;
+            let killTimer;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                child.kill("SIGTERM");
+                // Escalate to SIGKILL if the child ignores SIGTERM, so a run can't hang forever.
+                killTimer = setTimeout(() => child.kill("SIGKILL"), 5000);
+            }, timeoutMs);
+            child.stdout?.on("data", (d) => {
+                stdout += d.toString();
+            });
+            child.stderr?.on("data", (d) => {
+                stderr += d.toString();
+            });
+            const finish = (exitCode) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                if (killTimer)
+                    clearTimeout(killTimer);
+                writeFileSync(logPath, `$ ${bin} ${args.join(" ")}\n\n[stdout]\n${stdout}\n[stderr]\n${stderr}\n`, "utf8");
+                rotateLogs(logDir);
+                const status = timedOut ? "timeout" : exitCode === 0 ? "ok" : "error";
+                const summarySource = (stdout.trim() || stderr.trim()).replace(/\s+/g, " ");
+                resolveFn({
+                    ts: new Date().toISOString(),
+                    exitCode,
+                    status,
+                    summary: summarySource.slice(0, 200) || `exit ${exitCode}`,
+                    logPath,
+                    durationMs: Date.now() - startedAt,
+                });
+            };
+            child.on("error", () => finish(127));
+            child.on("close", (code) => finish(typeof code === "number" ? code : timedOut ? 124 : 1));
+        });
+        persist(result.status, result, true);
+        return result;
+    }
+    finally {
+        lock.release();
+    }
+}
+//# sourceMappingURL=runner.js.map

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

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

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

@@ -0,0 +1,60 @@
+/** Default per-run timeout for a scheduled agent process (5 minutes). */
+export declare const DEFAULT_TIMEOUT_MS = 300000;
+/** Default time-to-live for a scheduled job (3 days), matching Claude Code's expiry. */
+export declare const DEFAULT_TTL_HOURS = 72;
+/** Which OS scheduler owns the time trigger for a job. */
+export type OsBackend = "launchd" | "systemd" | "crontab";
+/** Terminal status of a single scheduled run. */
+export type ScheduleRunStatus = "ok" | "error" | "timeout" | "locked" | "expired";
+/**
+ * Persisted scheduled job (`.omp/state/schedule/jobs/<id>.json`).
+ * The portable source of truth; the OS-scheduler entry merely mirrors the trigger.
+ */
+export interface ScheduleJob {
+    id: string;
+    /** 5-field cron expression, interpreted in local time. */
+    cron: string;
+    prompt: string;
+    /** Agent CLI to spawn. Resolved via resolveCopilotBin. */
+    bin: string;
+    model?: string;
+    cwd: string;
+    timeoutMs: number;
+    /** When true, the agent is spawned with `--allow-all-tools` (unattended full access). */
+    allowAllTools: boolean;
+    createdAt: string;
+    /** ISO timestamp after which the job auto-deactivates. */
+    expiresAt?: string;
+    maxRuns?: number;
+    runCount: number;
+    /** OS backend that owns this job's trigger (set at install time). */
+    backend: OsBackend;
+    ompBinPath: string;
+    lastRunAt?: string;
+    lastStatus?: ScheduleRunStatus;
+    lastSummary?: string;
+    lastLogPath?: string;
+    active: boolean;
+}
+/** One line in `results/<id>.jsonl`. "Seen" state lives in the cursor, not here. */
+export interface ScheduleRunResult {
+    ts: string;
+    exitCode: number;
+    status: ScheduleRunStatus;
+    summary: string;
+    logPath: string;
+    durationMs: number;
+}
+export interface ScheduleAddOptions {
+    id: string;
+    cron: string;
+    prompt: string;
+    bin?: string;
+    model?: string;
+    cwd?: string;
+    timeoutMs?: number;
+    maxRuns?: number;
+    ttlHours?: number;
+    allowAllTools?: boolean;
+    dryRun?: boolean;
+}

package/dist/src/schedule/types.js

@@ -0,0 +1,5 @@
+/** Default per-run timeout for a scheduled agent process (5 minutes). */
+export const DEFAULT_TIMEOUT_MS = 300_000;
+/** Default time-to-live for a scheduled job (3 days), matching Claude Code's expiry. */
+export const DEFAULT_TTL_HOURS = 72;
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/schedule/types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAE1C,wFAAwF;AACxF,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC"}