@geohar/un-bien 0.7.0 → 0.9.0

package/dist/bin/supervisord.js

@@ -1,86 +0,0 @@
-#!/usr/bin/env node
-/**
- * `pi-supervisord` — long-running daemon supervisor.
- *
- * Entry point of the `pi-supervisord` binary (plan/26 W2). Run by
- * systemd/launchd in production, or directly during dev:
- *
- *   pnpm build
- *   node dist/bin/supervisord.js
- *
- * Once running, it:
- *   - Reads `~/.pi/un-bien/daemons.json`
- *   - Spawns `pi --mode rpc -e <un-bien/dist/index.js>` per entry
- *   - Listens on `~/.pi/un-bien/supervisor.sock` for CLI control requests
- *   - Restarts crashed children with exponential backoff
- *
- * Exits cleanly on SIGTERM/SIGINT (used by `unbien uninstall`).
- */
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-import { Supervisor, SupervisorAlreadyRunningError, } from "../daemon/supervisor.js";
-const HELP_TEXT = `pi-supervisord — Remote Pi daemon supervisor
-
-Usage: pi-supervisord
-
-Runs the long-lived supervisor: reads ~/.pi/un-bien/daemons.json, spawns one
-\`pi --mode rpc\` child per entry, and listens on ~/.pi/un-bien/supervisor.sock
-for control requests from the \`un-bien\` CLI.
-
-This binary takes NO arguments — it is normally launched by systemd/launchd
-(via \`unbien install\`), not by hand. Manage the fleet with:
-  unbien daemon start | stop | restart | status
-  unbien daemons
-
-Options:
-  -h, --help      Show this help and exit
-  -v, --version   Print version and exit
-`;
-async function main() {
-    // Guard: any stray argument used to fall through and start a FULL
-    // supervisor (a `pi-supervisord --help` once ran for days). Handle the
-    // conventional flags explicitly and reject unknown args instead of
-    // silently spawning the daemon fleet.
-    const args = process.argv.slice(2);
-    if (args.includes("-h") || args.includes("--help")) {
-        process.stdout.write(HELP_TEXT);
-        return;
-    }
-    if (args.includes("-v") || args.includes("--version")) {
-        process.stdout.write("pi-supervisord (un-bien)\n");
-        return;
-    }
-    if (args.length > 0) {
-        process.stderr.write(`pi-supervisord: unexpected argument(s): ${args.join(" ")}\n` +
-            "This binary takes no arguments. Run `pi-supervisord --help`.\n");
-        process.exit(2);
-    }
-    // The supervisor needs to point each spawned Pi at the extension
-    // entry it's bundled with. We're at `dist/bin/supervisord.js` after
-    // build; the extension is the sibling `dist/index.js`.
-    const here = fileURLToPath(import.meta.url);
-    const distRoot = dirname(dirname(here)); // dist/bin → dist
-    const extensionPath = join(distRoot, "index.js");
-    const supervisor = new Supervisor({ extensionPath });
-    await supervisor.start();
-    process.stderr.write(`[pi-supervisord] up — UDS: ~/.pi/un-bien/supervisor.sock, extension: ${extensionPath}\n`);
-    const shutdown = async (signal) => {
-        process.stderr.write(`[pi-supervisord] received ${signal}, shutting down\n`);
-        await supervisor.stop();
-        process.exit(0);
-    };
-    process.on("SIGTERM", () => void shutdown("SIGTERM"));
-    process.on("SIGINT", () => void shutdown("SIGINT"));
-}
-main().catch((err) => {
-    // "Already running" is a normal, expected condition (systemd/launchd may
-    // race a manual start, or the user double-launches) — not a crash. Report
-    // it calmly and exit 0 so service managers don't flag a failure loop.
-    if (err instanceof SupervisorAlreadyRunningError) {
-        process.stderr.write(`[pi-supervisord] ${err.message}\n`);
-        process.exit(0);
-    }
-    process.stderr.write(`[pi-supervisord] fatal: ${String(err)}\n`);
-    process.exit(1);
-});
-//# sourceMappingURL=supervisord.js.map

package/dist/bin/supervisord.js.map

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

package/dist/daemon/client.d.ts

@@ -1,20 +0,0 @@
-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 `/unbien
- *  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

@@ -1,131 +0,0 @@
-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 `un-bien` CLI to call the supervisor over the
- * `~/.pi/un-bien/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 `unbien 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 `unbien 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 `/unbien
- *  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

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

package/dist/daemon/control_protocol.d.ts

@@ -1,176 +0,0 @@
-/**
- * CLI ↔ supervisor IPC contract for `~/.pi/un-bien/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

@@ -1,63 +0,0 @@
-/**
- * CLI ↔ supervisor IPC contract for `~/.pi/un-bien/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

@@ -1 +0,0 @@
-{"version":3,"file":"control_protocol.js","sourceRoot":"","sources":["../../src/daemon/control_protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoFH,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;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,8BAA+B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,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;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4BAA6B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,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

@@ -1,45 +0,0 @@
-/**
- * Append-only audit trail for cron fires at `~/.pi/un-bien/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

@@ -1,71 +0,0 @@
-import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { unbienStateHome } from "../paths.js";
-const PREVIEW_LEN = 80;
-function logPath() {
-    return join(unbienStateHome(), "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

@@ -1 +0,0 @@
-{"version":3,"file":"cron_log.js","sourceRoot":"","sources":["../../src/daemon/cron_log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAiC9C,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,SAAS,OAAO;IACd,OAAO,IAAI,CAAC,eAAe,EAAE,EAAE,YAAY,CAAC,CAAC;AAC/C,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,QAAQ,CAAC,MAAkB;IACzC,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,oBAAoB,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAM7B;IACC,MAAM,IAAI,GACR,IAAI,CAAC,SAAS,CAAC;QACb,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC;KAC5B,CAAC,GAAG,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,cAAc,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,OAA0C,EAAE;IAE5C,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;YAC3C,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK;gBAAE,SAAS;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5E,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}