@yefengr/remote-pi 0.7.0

package/dist/config.js.map

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

package/dist/daemon/client.d.ts

@@ -0,0 +1,20 @@
+import { type ControlReplyFor, type ControlRequest } from "./control_protocol.js";
+export declare class SupervisorOfflineError extends Error {
+    readonly sockPath: string;
+    constructor(sockPath: string);
+}
+/**
+ * Sends a single request and returns the typed reply data.
+ *
+ * Throws:
+ *   - `SupervisorOfflineError` when the supervisor isn't reachable.
+ *   - `Error` from `parseReply` when the reply line is malformed.
+ *   - The supervisor's own error string when `ok: false`.
+ */
+export declare function callSupervisor<Op extends ControlRequest["op"]>(req: Extract<ControlRequest, {
+    op: Op;
+}>): Promise<ControlReplyFor<Op>>;
+/** Returns true when the supervisor is reachable. Used by `/remote-pi
+ *  daemons` to decide whether to query runtime state or fall back to
+ *  registry-only listing. */
+export declare function supervisorOnline(): Promise<boolean>;

package/dist/daemon/client.js

@@ -0,0 +1,131 @@
+import { existsSync } from "node:fs";
+import { createConnection } from "node:net";
+import { encodeRequest, parseReply, } from "./control_protocol.js";
+import { getSupervisorSockPath } from "./supervisor.js";
+import { usesNamedPipe } from "../session/ipc.js";
+/**
+ * Tiny client for the `remote-pi` CLI to call the supervisor over the
+ * `~/.pi/remote/supervisor.sock` UDS.
+ *
+ * Each call opens a fresh connection, sends one request line, reads one
+ * reply line, closes. No connection pooling — the CLI is short-lived,
+ * latency is dominated by the socket round-trip (<1ms).
+ *
+ * `SupervisorOfflineError` is the common error: thrown when the socket
+ * file is missing OR the connect fails (no listener). The CLI handler
+ * formats it as a friendly "Run `remote-pi install` first" message.
+ */
+const CONNECT_TIMEOUT_MS = 1000;
+const REPLY_TIMEOUT_MS = 5000;
+export class SupervisorOfflineError extends Error {
+    sockPath;
+    constructor(sockPath) {
+        super(`Supervisor is not running. UDS not responding at ${sockPath}.\n` +
+            "Run `remote-pi install` to set it up, or start it manually with `pi-supervisord`.");
+        this.sockPath = sockPath;
+        this.name = "SupervisorOfflineError";
+    }
+}
+/**
+ * Sends a single request and returns the typed reply data.
+ *
+ * Throws:
+ *   - `SupervisorOfflineError` when the supervisor isn't reachable.
+ *   - `Error` from `parseReply` when the reply line is malformed.
+ *   - The supervisor's own error string when `ok: false`.
+ */
+export async function callSupervisor(req) {
+    const sockPath = getSupervisorSockPath();
+    // POSIX fast-fail on a missing socket file. Windows pipes have no file —
+    // skip the check and let `_connect` fail fast if the pipe isn't there.
+    if (!usesNamedPipe() && !existsSync(sockPath))
+        throw new SupervisorOfflineError(sockPath);
+    const sock = await _connect(sockPath);
+    try {
+        sock.write(encodeRequest(req));
+        const line = await _readLine(sock);
+        const reply = parseReply(line);
+        if (!reply.ok)
+            throw new Error(reply.error);
+        return reply.data;
+    }
+    finally {
+        sock.destroy();
+    }
+}
+/** Returns true when the supervisor is reachable. Used by `/remote-pi
+ *  daemons` to decide whether to query runtime state or fall back to
+ *  registry-only listing. */
+export async function supervisorOnline() {
+    const sockPath = getSupervisorSockPath();
+    if (!usesNamedPipe() && !existsSync(sockPath))
+        return false;
+    try {
+        const sock = await _connect(sockPath);
+        sock.destroy();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── internals ───────────────────────────────────────────────────────────────
+function _connect(sockPath) {
+    return new Promise((resolve, reject) => {
+        const sock = createConnection({ path: sockPath });
+        let settled = false;
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            sock.destroy();
+            reject(new SupervisorOfflineError(sockPath));
+        }, CONNECT_TIMEOUT_MS);
+        sock.once("connect", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            sock.setEncoding("utf8");
+            resolve(sock);
+        });
+        sock.once("error", () => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            reject(new SupervisorOfflineError(sockPath));
+        });
+    });
+}
+function _readLine(sock) {
+    return new Promise((resolve, reject) => {
+        let buf = "";
+        const timer = setTimeout(() => {
+            reject(new Error("supervisor reply timeout"));
+            sock.destroy();
+        }, REPLY_TIMEOUT_MS);
+        sock.on("data", (chunk) => {
+            buf += chunk;
+            const nl = buf.indexOf("\n");
+            if (nl >= 0) {
+                clearTimeout(timer);
+                resolve(buf.slice(0, nl));
+            }
+        });
+        sock.on("end", () => {
+            clearTimeout(timer);
+            const nl = buf.indexOf("\n");
+            if (nl >= 0)
+                return resolve(buf.slice(0, nl));
+            if (buf.length > 0)
+                return resolve(buf);
+            reject(new Error("supervisor closed connection without replying"));
+        });
+        sock.on("error", (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/daemon/client.js.map

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

package/dist/daemon/control_protocol.d.ts

@@ -0,0 +1,176 @@
+/**
+ * CLI ↔ supervisor IPC contract for `~/.pi/remote/supervisor.sock`.
+ *
+ * Framing: one JSON object per line, newline-terminated. The CLI sends a
+ * single `ControlRequest`, the supervisor sends a single `ControlReply`,
+ * both close the connection. No multiplexing, no streaming — each command
+ * is a short round-trip.
+ *
+ * Plan/26 W2. The Pi RPC protocol (`pi --mode rpc`) used by the daemon
+ * children themselves is a separate contract — see
+ * `node_modules/@earendil-works/pi-coding-agent/dist/modes/rpc/rpc-types.d.ts`.
+ * This file is strictly the supervisor's own control plane.
+ */
+import type { CronJob } from "./cron_registry.js";
+import type { CronLogEntry } from "./cron_log.js";
+/** Per-daemon runtime state observable through the supervisor. */
+export type DaemonState = "running" | "stopped" | "starting" | "crashed";
+export interface DaemonInfo {
+    id: string;
+    cwd: string;
+    name: string;
+    state: DaemonState;
+    pid?: number;
+    uptime_s?: number;
+    restart_count?: number;
+}
+/** Requests sent CLI → supervisor. */
+export type ControlRequest = {
+    op: "list";
+} | {
+    op: "status";
+} | {
+    op: "start_all";
+} | {
+    op: "start";
+    id: string;
+} | {
+    op: "stop_all";
+} | {
+    op: "stop";
+    id: string;
+} | {
+    op: "restart_all";
+} | {
+    op: "restart";
+    id: string;
+} | {
+    op: "send";
+    id: string;
+    text: string;
+} | {
+    op: "register";
+    cwd: string;
+} | {
+    op: "unregister";
+    id: string;
+} | {
+    op: "cron_add";
+    daemon_id: string;
+    schedule: string;
+    prompt: string;
+    tz?: string;
+    skip_if_busy?: boolean;
+    wake?: boolean;
+    catchup?: boolean;
+} | {
+    op: "cron_list";
+} | {
+    op: "cron_remove";
+    job_id: string;
+} | {
+    op: "cron_enable";
+    job_id: string;
+    enabled: boolean;
+} | {
+    op: "cron_run";
+    job_id: string;
+} | {
+    op: "cron_log";
+    job_id?: string;
+    tail?: number;
+};
+/** Replies sent supervisor → CLI. Tagged by `ok` boolean. */
+export type ControlReply<T = unknown> = {
+    ok: true;
+    data?: T;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Response shapes per op. Keep in sync with the supervisor handlers in
+ * `daemon/supervisor.ts`. Used for typed client calls.
+ */
+export interface ControlReplyShapes {
+    list: {
+        daemons: DaemonInfo[];
+    };
+    status: {
+        daemons: DaemonInfo[];
+    };
+    start_all: {
+        started: string[];
+        already_running: string[];
+    };
+    start: {
+        id: string;
+        state: DaemonState;
+        started: boolean;
+    };
+    stop_all: {
+        stopped: string[];
+        already_stopped: string[];
+    };
+    stop: {
+        id: string;
+        state: DaemonState;
+        stopped: boolean;
+    };
+    restart_all: {
+        restarted: string[];
+    };
+    restart: {
+        id: string;
+        state: DaemonState;
+        restarted: boolean;
+    };
+    send: {
+        id: string;
+        delivered: boolean;
+    };
+    register: {
+        id: string;
+        cwd: string;
+    };
+    unregister: {
+        removed: boolean;
+        cwd?: string;
+    };
+    cron_add: {
+        job: CronJobView;
+    };
+    cron_list: {
+        jobs: CronJobView[];
+    };
+    cron_remove: {
+        removed: boolean;
+    };
+    cron_enable: {
+        job_id: string;
+        enabled: boolean;
+        updated: boolean;
+    };
+    cron_run: {
+        job_id: string;
+        result: string;
+    };
+    cron_log: {
+        entries: CronLogEntry[];
+    };
+}
+/** A cron job plus its computed `next_run` (ISO), for `cron list`. */
+export type CronJobView = CronJob & {
+    next_run?: string | null;
+};
+/** Convenience for typed `Client.request<...>("op")` calls. */
+export type ControlReplyFor<Op extends ControlRequest["op"]> = Op extends keyof ControlReplyShapes ? ControlReplyShapes[Op] : never;
+export declare function encodeRequest(req: ControlRequest): string;
+export declare function encodeReply<T>(reply: ControlReply<T>): string;
+/**
+ * Parses a single JSON line into a request. Throws on malformed input —
+ * the supervisor catches and replies `{ok:false, error}` so the client
+ * gets a clean error rather than an unframed disconnect.
+ */
+export declare function parseRequest(line: string): ControlRequest;
+export declare function parseReply(line: string): ControlReply<unknown>;

package/dist/daemon/control_protocol.js

@@ -0,0 +1,63 @@
+/**
+ * CLI ↔ supervisor IPC contract for `~/.pi/remote/supervisor.sock`.
+ *
+ * Framing: one JSON object per line, newline-terminated. The CLI sends a
+ * single `ControlRequest`, the supervisor sends a single `ControlReply`,
+ * both close the connection. No multiplexing, no streaming — each command
+ * is a short round-trip.
+ *
+ * Plan/26 W2. The Pi RPC protocol (`pi --mode rpc`) used by the daemon
+ * children themselves is a separate contract — see
+ * `node_modules/@earendil-works/pi-coding-agent/dist/modes/rpc/rpc-types.d.ts`.
+ * This file is strictly the supervisor's own control plane.
+ */
+// ── Serialization helpers ────────────────────────────────────────────────────
+const TRAILING_NEWLINE = "\n";
+export function encodeRequest(req) {
+    return JSON.stringify(req) + TRAILING_NEWLINE;
+}
+export function encodeReply(reply) {
+    return JSON.stringify(reply) + TRAILING_NEWLINE;
+}
+/**
+ * Parses a single JSON line into a request. Throws on malformed input —
+ * the supervisor catches and replies `{ok:false, error}` so the client
+ * gets a clean error rather than an unframed disconnect.
+ */
+export function parseRequest(line) {
+    let obj;
+    try {
+        obj = JSON.parse(line);
+    }
+    catch (e) {
+        throw new Error(`malformed control request: ${e.message}`);
+    }
+    if (!obj || typeof obj !== "object") {
+        throw new Error("control request must be a JSON object");
+    }
+    const op = obj.op;
+    if (typeof op !== "string") {
+        throw new Error("control request missing string `op` field");
+    }
+    // We don't validate every field shape here — supervisor handlers do it
+    // per-op since the error messages are more specific that way.
+    return obj;
+}
+export function parseReply(line) {
+    let obj;
+    try {
+        obj = JSON.parse(line);
+    }
+    catch (e) {
+        throw new Error(`malformed control reply: ${e.message}`);
+    }
+    if (!obj || typeof obj !== "object") {
+        throw new Error("control reply must be a JSON object");
+    }
+    const ok = obj.ok;
+    if (typeof ok !== "boolean") {
+        throw new Error("control reply missing boolean `ok` field");
+    }
+    return obj;
+}
+//# sourceMappingURL=control_protocol.js.map

package/dist/daemon/control_protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control_protocol.js","sourceRoot":"","sources":["../../src/daemon/control_protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4EH,gFAAgF;AAEhF,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,UAAU,aAAa,CAAC,GAAmB;IAC/C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,KAAsB;IACnD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,8BAA+B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IACpF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,uEAAuE;IACvE,8DAA8D;IAC9D,OAAO,GAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,4BAA6B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IAClF,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,EAAE,GAAI,GAAwB,CAAC,EAAE,CAAC;IACxC,IAAI,OAAO,EAAE,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAA4B,CAAC;AACtC,CAAC"}

package/dist/daemon/cron_log.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Append-only audit trail for cron fires at `~/.pi/remote/cron.jsonl`.
+ *
+ * One JSON line per scheduler decision — **every fire AND every skip** — so an
+ * operator can see exactly what ran and what didn't (the agent's output goes
+ * fire-and-forget to the relay/mesh, so the dispatch itself needs its own
+ * trail). Plan/39 decision E.
+ */
+/** Outcome of a single `fireJob` decision. */
+export type CronResult = "delivered" | "deliver_failed" | "woke_and_delivered" | "skipped_busy" | "skipped_down" | "skipped_disabled";
+export interface CronLogEntry {
+    /** epoch ms */
+    ts: number;
+    job_id: string;
+    daemon_id: string;
+    schedule: string;
+    /** true when a prompt was actually sent (delivered / woke_and_delivered). */
+    fired: boolean;
+    result: CronResult;
+    /** First chars of the prompt, for at-a-glance log reading. */
+    prompt_preview: string;
+}
+/** Test/diag-only: the on-disk path. */
+export declare function cronLogPath(): string;
+/** Maps a result to whether a prompt was actually delivered. */
+export declare function firedFor(result: CronResult): boolean;
+/**
+ * Appends one entry. Best-effort: creates the parent dir + file when absent;
+ * never throws into the scheduler (a logging failure must not abort a fire).
+ */
+export declare function appendCronLog(entry: {
+    job_id: string;
+    daemon_id: string;
+    schedule: string;
+    result: CronResult;
+    prompt: string;
+}): void;
+/**
+ * Reads the log, newest-last. Optional `jobId` filter and `tail` (last N).
+ * Missing file → []. Malformed lines are skipped.
+ */
+export declare function readCronLog(opts?: {
+    jobId?: string;
+    tail?: number;
+}): CronLogEntry[];

package/dist/daemon/cron_log.js

@@ -0,0 +1,72 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const PREVIEW_LEN = 80;
+function logPath() {
+    const root = process.env["REMOTE_PI_HOME"] || homedir();
+    return join(root, ".pi", "remote", "cron.jsonl");
+}
+/** Test/diag-only: the on-disk path. */
+export function cronLogPath() {
+    return logPath();
+}
+/** Maps a result to whether a prompt was actually delivered. */
+export function firedFor(result) {
+    return result === "delivered" || result === "woke_and_delivered";
+}
+/**
+ * Appends one entry. Best-effort: creates the parent dir + file when absent;
+ * never throws into the scheduler (a logging failure must not abort a fire).
+ */
+export function appendCronLog(entry) {
+    const line = JSON.stringify({
+        ts: Date.now(),
+        job_id: entry.job_id,
+        daemon_id: entry.daemon_id,
+        schedule: entry.schedule,
+        fired: firedFor(entry.result),
+        result: entry.result,
+        prompt_preview: entry.prompt.slice(0, PREVIEW_LEN),
+    }) + "\n";
+    try {
+        mkdirSync(dirname(logPath()), { recursive: true });
+        appendFileSync(logPath(), line, "utf8");
+    }
+    catch {
+        /* audit is best-effort — don't break the scheduler on a write error */
+    }
+}
+/**
+ * Reads the log, newest-last. Optional `jobId` filter and `tail` (last N).
+ * Missing file → []. Malformed lines are skipped.
+ */
+export function readCronLog(opts = {}) {
+    if (!existsSync(logPath()))
+        return [];
+    let raw;
+    try {
+        raw = readFileSync(logPath(), "utf8");
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    for (const line of raw.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            const e = JSON.parse(line);
+            if (opts.jobId && e.job_id !== opts.jobId)
+                continue;
+            entries.push(e);
+        }
+        catch {
+            /* skip malformed */
+        }
+    }
+    if (opts.tail !== undefined && opts.tail >= 0 && entries.length > opts.tail) {
+        return entries.slice(entries.length - opts.tail);
+    }
+    return entries;
+}
+//# sourceMappingURL=cron_log.js.map

package/dist/daemon/cron_log.js.map

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

package/dist/daemon/cron_registry.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Cron registry: scheduled prompts for daemons, persisted at
+ * `~/.pi/remote/cron.json`. Mirrors `registry.ts` (`daemons.json`) — tolerant
+ * load (missing/corrupt → empty), atomic-ish full-file save.
+ *
+ * Each job targets a daemon by its `daemon_id` (the 8-hex id from
+ * `daemonIdForCwd`) and fires `prompt` on `schedule` (a cron expression, run
+ * by croner in the supervisor). The scheduler engine + `fireJob` live in
+ * `supervisor.ts`; this module only owns persistence + schedule validation.
+ *
+ * Plan/39. Decisions B (croner), C (min-interval 60s), E (audit via cron_log).
+ */
+/** Minimum allowed interval between two consecutive runs of a schedule. */
+export declare const MIN_INTERVAL_MS = 60000;
+/** A scheduled prompt. */
+export interface CronJob {
+    /** `j_<hex>` — random, stable across restarts. */
+    id: string;
+    /** Target daemon id (`daemonIdForCwd`). */
+    daemon_id: string;
+    /** Cron expression (croner syntax; optional 6th seconds field supported). */
+    schedule: string;
+    /** IANA timezone for the schedule (e.g. "America/Sao_Paulo"). */
+    tz?: string;
+    /** Prompt text injected into the daemon when the job fires. */
+    prompt: string;
+    enabled: boolean;
+    /** Skip the fire when the daemon is mid-turn (default true). */
+    skip_if_busy: boolean;
+    /** Start the daemon if it's down, then fire (default false). */
+    wake: boolean;
+    /** On supervisor start, run once if the previous scheduled run was missed
+     *  while it was down (default false; at most 1×). */
+    catchup: boolean;
+    created_at: string;
+    last_run?: string;
+    /** Last fire result — see cron_log `result` values. Shortcut for `cron list`. */
+    last_status?: string;
+}
+export interface CronRegistry {
+    jobs: CronJob[];
+}
+/** Test/diag-only: the on-disk path. */
+export declare function cronRegistryPath(): string;
+/** Reads the registry; returns empty on missing/corrupt file. */
+export declare function loadCronRegistry(): CronRegistry;
+export declare function saveCronRegistry(reg: CronRegistry): void;
+export declare function listJobs(): CronJob[];
+export declare function getJob(id: string): CronJob | undefined;
+/** Fields a caller supplies when creating a job. Flags default sensibly. */
+export interface NewJobInput {
+    daemon_id: string;
+    schedule: string;
+    prompt: string;
+    tz?: string;
+    skip_if_busy?: boolean;
+    wake?: boolean;
+    catchup?: boolean;
+}
+/** Adds a job with a fresh `j_<hex>` id. Pure persistence — call
+ *  `validateSchedule` first at the op/CLI boundary. */
+export declare function addJob(input: NewJobInput): CronJob;
+export declare function removeJob(id: string): boolean;
+export declare function setJobEnabled(id: string, enabled: boolean): boolean;
+/** Records the outcome of a fire on the job (the `cron list` shortcut). */
+export declare function recordRun(id: string, at: string, status: string): void;
+export interface ScheduleValidation {
+    ok: boolean;
+    error?: string;
+    /** Interval (ms) between the next two runs, when computable. */
+    intervalMs?: number;
+}
+/**
+ * Validates a cron expression via croner and enforces the ≥60s min-interval
+ * (decision C — guards against pileup + token burn). Returns `ok:false` with a
+ * user-facing message on a bad expression or a too-frequent schedule.
+ */
+export declare function validateSchedule(schedule: string, tz?: string): ScheduleValidation;
+/** Returns the next scheduled run for a job, or null. Used by `cron list`. */
+export declare function nextRunFor(job: CronJob): Date | null;