@a5c-ai/genty-runtime 5.1.1-staging.0c6199708314

package/dist/daemon/lifecycle.js

@@ -0,0 +1,320 @@
+"use strict";
+/**
+ * GAP-REMOTE-001: Daemon Lifecycle — start/stop/status management.
+ *
+ * In foreground mode, the daemon runs in the current process (for dev/debug).
+ * In background mode, it spawns a detached child process.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startDaemon = startDaemon;
+exports.stopDaemon = stopDaemon;
+exports.getDaemonStatus = getDaemonStatus;
+exports.watchDaemon = watchDaemon;
+const node_fs_1 = require("node:fs");
+const node_child_process_1 = require("node:child_process");
+const path = __importStar(require("node:path"));
+const apiResult_1 = require("../apiResult");
+const loop_1 = require("./loop");
+const daemonLog_1 = require("./daemonLog");
+const DEFAULT_GRACE_PERIOD_MS = 10_000;
+const DEFAULT_WATCHDOG_POLL_MS = 5_000;
+// ── Atomic write helper ─────────────────────────────────────────────────────
+async function atomicWrite(filePath, content) {
+    const dir = path.dirname(filePath);
+    await node_fs_1.promises.mkdir(dir, { recursive: true });
+    const tmpPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    await node_fs_1.promises.writeFile(tmpPath, content, "utf-8");
+    await node_fs_1.promises.rename(tmpPath, filePath);
+}
+// ── PID checking ────────────────────────────────────────────────────────────
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readPidFile(daemonDir) {
+    try {
+        const content = await node_fs_1.promises.readFile(path.join(daemonDir, "daemon.pid"), "utf-8");
+        const pid = parseInt(content.trim(), 10);
+        return isNaN(pid) ? null : pid;
+    }
+    catch {
+        return null;
+    }
+}
+async function readDaemonMetadata(daemonDir) {
+    try {
+        const content = await node_fs_1.promises.readFile(path.join(daemonDir, "daemon.json"), "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+async function cleanupDaemonFiles(daemonDir) {
+    await node_fs_1.promises.unlink(path.join(daemonDir, "daemon.pid")).catch(() => { });
+    await node_fs_1.promises.unlink(path.join(daemonDir, "daemon.json")).catch(() => { });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ── startDaemon ─────────────────────────────────────────────────────────────
+async function startDaemon(options) {
+    try {
+        const { daemonDir, workspace, foreground = false, config } = options;
+        // Check for existing daemon
+        const existingPid = await readPidFile(daemonDir);
+        if (existingPid !== null) {
+            if (isProcessAlive(existingPid)) {
+                return (0, apiResult_1.fail)("DAEMON_RUNNING", `Daemon already running with PID ${existingPid}`);
+            }
+            // Stale PID — clean up both files
+            await cleanupDaemonFiles(daemonDir);
+        }
+        await node_fs_1.promises.mkdir(daemonDir, { recursive: true });
+        let pid;
+        const startedAt = new Date().toISOString();
+        const maxConcurrentRuns = config?.maxConcurrentRuns ?? 4;
+        if (foreground) {
+            pid = process.pid;
+        }
+        else {
+            // Spawn detached child process running daemon:run
+            const child = (0, node_child_process_1.spawn)(process.execPath, [process.argv[1], "daemon:run", "--daemon-dir", daemonDir], {
+                detached: true,
+                stdio: "ignore",
+                cwd: workspace,
+            });
+            child.unref();
+            if (child.pid == null) {
+                return (0, apiResult_1.fail)("SPAWN_FAILED", "Failed to spawn daemon process — no PID returned");
+            }
+            pid = child.pid;
+        }
+        // Write PID file atomically
+        await atomicWrite(path.join(daemonDir, "daemon.pid"), String(pid));
+        // Write daemon.json metadata atomically
+        const metadata = {
+            workspace,
+            startedAt,
+            triggers: config?.triggers ?? [],
+            maxConcurrentRuns,
+            pid,
+        };
+        await atomicWrite(path.join(daemonDir, "daemon.json"), JSON.stringify(metadata, null, 2));
+        // Log daemon start
+        await (0, daemonLog_1.appendDaemonLog)(daemonDir, {
+            timestamp: startedAt,
+            event: "DAEMON_STARTED",
+            data: { pid, workspace, foreground },
+        });
+        return (0, apiResult_1.ok)({
+            pid,
+            daemonDir,
+            startedAt,
+        });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, apiResult_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+// ── stopDaemon ──────────────────────────────────────────────────────────────
+async function stopDaemon(options) {
+    try {
+        const { daemonDir, gracePeriodMs = DEFAULT_GRACE_PERIOD_MS } = options;
+        const pid = await readPidFile(daemonDir);
+        if (pid === null) {
+            return (0, apiResult_1.fail)("DAEMON_NOT_RUNNING", "No daemon PID file found");
+        }
+        const stoppedAt = new Date().toISOString();
+        if (!isProcessAlive(pid)) {
+            // PID exists but process is dead — clean up stale files
+            await cleanupDaemonFiles(daemonDir);
+            return (0, apiResult_1.ok)({ pid, stoppedAt });
+        }
+        // For foreground mode (same process), just clean up files
+        if (pid === process.pid) {
+            await cleanupDaemonFiles(daemonDir);
+            await (0, daemonLog_1.appendDaemonLog)(daemonDir, {
+                timestamp: stoppedAt,
+                event: "DAEMON_STOPPED",
+                data: { pid, reason: "foreground-stop" },
+            }).catch(() => { });
+            return (0, apiResult_1.ok)({ pid, stoppedAt });
+        }
+        // Send SIGTERM first
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch {
+            // Process may have exited between check and kill
+            await cleanupDaemonFiles(daemonDir);
+            return (0, apiResult_1.ok)({ pid, stoppedAt });
+        }
+        // Wait for graceful shutdown with polling
+        const pollInterval = 100;
+        const maxPolls = Math.ceil(gracePeriodMs / pollInterval);
+        for (let i = 0; i < maxPolls; i++) {
+            await sleep(pollInterval);
+            if (!isProcessAlive(pid)) {
+                await cleanupDaemonFiles(daemonDir);
+                await (0, daemonLog_1.appendDaemonLog)(daemonDir, {
+                    timestamp: new Date().toISOString(),
+                    event: "DAEMON_STOPPED",
+                    data: { pid, reason: "sigterm" },
+                }).catch(() => { });
+                return (0, apiResult_1.ok)({ pid, stoppedAt: new Date().toISOString() });
+            }
+        }
+        // Escalate to SIGKILL after grace period
+        try {
+            process.kill(pid, "SIGKILL");
+        }
+        catch {
+            // Already exited
+        }
+        await cleanupDaemonFiles(daemonDir);
+        await (0, daemonLog_1.appendDaemonLog)(daemonDir, {
+            timestamp: new Date().toISOString(),
+            event: "DAEMON_KILLED",
+            data: { pid, reason: "sigkill-after-grace-period", gracePeriodMs },
+        }).catch(() => { });
+        return (0, apiResult_1.ok)({ pid, stoppedAt: new Date().toISOString() });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, apiResult_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+// ── getDaemonStatus ─────────────────────────────────────────────────────────
+async function getDaemonStatus(options) {
+    try {
+        const { daemonDir } = options;
+        const pid = await readPidFile(daemonDir);
+        if (pid === null) {
+            return (0, apiResult_1.ok)({ running: false });
+        }
+        if (!isProcessAlive(pid)) {
+            // Stale PID — clean up
+            await node_fs_1.promises.unlink(path.join(daemonDir, "daemon.pid")).catch(() => { });
+            return (0, apiResult_1.ok)({ running: false });
+        }
+        const metadata = await readDaemonMetadata(daemonDir);
+        const startedAt = metadata?.startedAt;
+        const uptime = startedAt
+            ? Math.floor((Date.now() - new Date(startedAt).getTime()) / 1000)
+            : 0;
+        const loopStatus = await (0, loop_1.readDaemonLoopStatus)(daemonDir);
+        return (0, apiResult_1.ok)({
+            running: true,
+            pid,
+            uptime,
+            startedAt,
+            activeTriggers: metadata?.triggers?.length ?? 0,
+            pendingRuns: loopStatus?.pendingRuns ?? 0,
+            deadLetterRuns: loopStatus?.deadLetterRuns ?? 0,
+        });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, apiResult_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+async function watchDaemon(options) {
+    try {
+        const { daemonDir, pollIntervalMs = DEFAULT_WATCHDOG_POLL_MS, maxRestarts = Number.POSITIVE_INFINITY, signal, } = options;
+        let restarts = 0;
+        while (!signal?.aborted) {
+            const metadata = await readDaemonMetadata(daemonDir);
+            if (!metadata) {
+                return (0, apiResult_1.fail)("DAEMON_NOT_CONFIGURED", "No daemon metadata found for watchdog restart");
+            }
+            const pid = await readPidFile(daemonDir);
+            if (pid === null || !isProcessAlive(pid)) {
+                if (restarts >= maxRestarts) {
+                    return (0, apiResult_1.fail)("WATCHDOG_RESTART_LIMIT", `Daemon restart limit reached: ${maxRestarts}`);
+                }
+                await (0, daemonLog_1.appendDaemonLog)(daemonDir, {
+                    timestamp: new Date().toISOString(),
+                    event: "DAEMON_WATCHDOG_RESTART",
+                    data: { previousPid: pid, restarts },
+                }).catch(() => { });
+                const result = await startDaemon({
+                    daemonDir,
+                    workspace: metadata.workspace,
+                    foreground: false,
+                    config: {
+                        workspace: metadata.workspace,
+                        triggers: metadata.triggers,
+                        maxConcurrentRuns: metadata.maxConcurrentRuns,
+                    },
+                });
+                if (!result.ok) {
+                    return (0, apiResult_1.fail)(result.error.code, result.error.message);
+                }
+                restarts += 1;
+            }
+            await sleepOrAbort(pollIntervalMs, signal);
+        }
+        return (0, apiResult_1.ok)({ restarts, stoppedAt: new Date().toISOString() });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return (0, apiResult_1.fail)("INTERNAL_ERROR", msg);
+    }
+}
+async function sleepOrAbort(ms, signal) {
+    if (!signal) {
+        await sleep(ms);
+        return;
+    }
+    await new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve();
+            return;
+        }
+        const timeout = setTimeout(resolve, ms);
+        signal.addEventListener("abort", () => {
+            clearTimeout(timeout);
+            resolve();
+        }, { once: true });
+    });
+}

package/dist/daemon/loop.d.ts

@@ -0,0 +1,27 @@
+/**
+ * GAP-REMOTE-001: Daemon Loop — main event loop with concurrent run pool.
+ */
+import type { DaemonConfig, TriggerCallback } from "./types";
+import type { DurableTriggerQueueOptions } from "./durableQueue";
+export interface DaemonLoopOptions {
+    onTrigger?: TriggerCallback;
+    signal?: AbortSignal;
+    logDir?: string;
+    queue?: DurableTriggerQueueOptions;
+}
+export interface DaemonLoopStatus {
+    activeRuns: number;
+    pendingRuns: number;
+    deadLetterRuns?: number;
+    rejectedTriggers?: number;
+    duplicateTriggers?: number;
+    rateLimitedTriggers?: number;
+    updatedAt: string;
+}
+export declare function runDaemonLoop(config: DaemonConfig, options?: DaemonLoopOptions): Promise<void>;
+/**
+ * Read the daemon loop's runtime status from its status file.
+ * Returns null if the file doesn't exist or is unreadable.
+ */
+export declare function readDaemonLoopStatus(daemonDir: string): Promise<DaemonLoopStatus | null>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/daemon/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/daemon/loop.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACV,YAAY,EAGZ,eAAe,EAEhB,MAAM,SAAS,CAAC;AAYjB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,0BAA0B,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAwPf;AAsHD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAQ9F"}