@rk0429/agentic-relay 20.1.0 → 21.0.0

package/dist/application/routine-daemon-service.js

@@ -0,0 +1,176 @@
+import { execFile } from "node:child_process";
+import { readFile, rm } from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+import { ValidationError } from "../core/errors.js";
+import { isProcessAlive } from "./housekeeping.js";
+import { DEFAULT_ROUTINE_POLL_INTERVAL_MS, } from "./routine-scheduler.js";
+import { writeJsonAtomic, isMissingFileError } from "../infrastructure/store/file-utils.js";
+const execFileAsync = promisify(execFile);
+export class RoutineDaemonService {
+    deps;
+    now;
+    ownerPid;
+    pollIntervalMs;
+    signalTarget;
+    getProcessStatus;
+    stopping = false;
+    sleepController = new AbortController();
+    currentExecution;
+    constructor(deps, options = {}) {
+        this.deps = deps;
+        this.now = options.now ?? (() => new Date());
+        this.ownerPid = options.ownerPid ?? process.pid;
+        this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_ROUTINE_POLL_INTERVAL_MS;
+        this.signalTarget = deps.signalTarget ?? process;
+        this.getProcessStatus = deps.getProcessStatus ?? defaultGetProcessStatus;
+    }
+    async start() {
+        await this.deps.store.ensureLayout();
+        await this.acquirePidFile();
+        const onSignal = () => {
+            this.stopping = true;
+            this.sleepController.abort();
+        };
+        this.signalTarget.on("SIGTERM", onSignal);
+        this.signalTarget.on("SIGINT", onSignal);
+        try {
+            await this.cleanupStaleLeases();
+            let snapshot = await this.deps.catalogService.rescan();
+            snapshot = await this.runTick(snapshot);
+            while (!this.stopping) {
+                await sleep(this.pollIntervalMs, this.sleepController.signal).catch(() => undefined);
+                if (this.stopping) {
+                    break;
+                }
+                snapshot = await this.runTick(snapshot);
+            }
+            if (this.currentExecution) {
+                await this.currentExecution;
+            }
+        }
+        finally {
+            this.signalTarget.off("SIGTERM", onSignal);
+            this.signalTarget.off("SIGINT", onSignal);
+            await this.releasePidFile();
+        }
+    }
+    async runTick(snapshot) {
+        const states = await this.deps.stateRepo.list();
+        const tick = this.deps.scheduler.tick(snapshot.catalog, new Map(states.map((entry) => [entry.name.value, entry.state])));
+        let nextSnapshot = snapshot;
+        if (tick.shouldRescan) {
+            nextSnapshot = await this.deps.catalogService.rescan();
+        }
+        for (const decision of tick.decisions) {
+            if (this.stopping) {
+                break;
+            }
+            this.currentExecution = this.deps.runService.dispatch((nextSnapshot.catalog.get(decision.definition.name.value) ??
+                snapshot.catalog.get(decision.definition.name.value)), {
+                source: decision.source,
+                firingTimes: decision.firingTimes,
+                scheduledTime: decision.firingTimes[0],
+                skippedSchedules: decision.skippedSchedules,
+                skippedCount: decision.skippedCount,
+                triggerTime: tick.now,
+            });
+            await this.currentExecution;
+            this.currentExecution = undefined;
+        }
+        return nextSnapshot;
+    }
+    async cleanupStaleLeases() {
+        const leases = await this.deps.leaseRepo.list();
+        for (const entry of leases) {
+            if (this.deps.leaseRepo.isStale(entry.lease, this.now())) {
+                await this.deps.leaseRepo.release(entry.name);
+            }
+        }
+    }
+    async acquirePidFile() {
+        const targetPath = this.pidFilePath();
+        const existing = await this.readPidFile();
+        if (existing) {
+            const status = await this.getProcessStatus(existing.pid);
+            if (status.alive &&
+                (!status.startedAt || Date.parse(status.startedAt) <= Date.parse(existing.startedAt))) {
+                throw new ValidationError("Routine daemon is already running.", {
+                    recoveryHint: "Stop the existing daemon before starting a new one.",
+                });
+            }
+            await rm(targetPath, { force: true });
+        }
+        await writeJsonAtomic(targetPath, {
+            pid: this.ownerPid,
+            startedAt: this.now().toISOString(),
+        });
+    }
+    async releasePidFile() {
+        await rm(this.pidFilePath(), { force: true });
+    }
+    async readPidFile() {
+        try {
+            const raw = await readFile(this.pidFilePath(), "utf8");
+            const parsed = JSON.parse(raw);
+            if (!parsed ||
+                typeof parsed.pid !== "number" ||
+                !Number.isInteger(parsed.pid) ||
+                parsed.pid <= 0 ||
+                typeof parsed.startedAt !== "string" ||
+                Number.isNaN(Date.parse(parsed.startedAt))) {
+                throw new ValidationError("Invalid routine daemon PID file.", {
+                    recoveryHint: "Delete the corrupted PID file and restart the daemon.",
+                });
+            }
+            return {
+                pid: parsed.pid,
+                startedAt: parsed.startedAt,
+            };
+        }
+        catch (error) {
+            if (isMissingFileError(error)) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    pidFilePath() {
+        return path.join(this.deps.store.routinesDir(), "daemon.pid.json");
+    }
+}
+async function defaultGetProcessStatus(pid) {
+    if (!isProcessAlive(pid)) {
+        return { alive: false };
+    }
+    try {
+        const { stdout } = await execFileAsync("ps", ["-o", "lstart=", "-p", String(pid)]);
+        const startedAt = stdout.trim();
+        const parsed = new Date(startedAt);
+        return {
+            alive: true,
+            startedAt: Number.isNaN(parsed.getTime()) ? null : parsed.toISOString(),
+        };
+    }
+    catch {
+        return { alive: true };
+    }
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            cleanup();
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timeout);
+            cleanup();
+            reject(new Error("aborted"));
+        };
+        const cleanup = () => {
+            signal?.removeEventListener("abort", onAbort);
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=routine-daemon-service.js.map

package/dist/application/routine-daemon-service.js.map

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

package/dist/application/routine-event-log-sink.d.ts

@@ -0,0 +1,42 @@
+import type { RoutineExecutionState } from "../domain/routine-execution-state.js";
+import { RoutineName } from "../domain/routine-name.js";
+import { RelayStore } from "../infrastructure/store/relay-store.js";
+export type RoutineSkipReason = "concurrent_execution" | "missed_policy_skip";
+interface RoutineLogEnvelope {
+    routineName: RoutineName | string;
+    ownerPid: number;
+    routineRunId?: string | null;
+}
+export declare class RoutineEventLogSink {
+    private readonly store;
+    constructor(store: RelayStore);
+    logTriggered(opts: RoutineLogEnvelope & {
+        scheduledTime: Date;
+        triggerTime: Date;
+        isCatchUp: boolean;
+        skippedCount?: number;
+        occurredAt?: Date;
+    }): Promise<void>;
+    logCompleted(opts: RoutineLogEnvelope & {
+        duration: number;
+        occurredAt?: Date;
+    }): Promise<void>;
+    logFailed(opts: RoutineLogEnvelope & {
+        duration: number;
+        errorCode: string;
+        errorMessage: string;
+        workflowExecutionId?: string | null;
+        occurredAt?: Date;
+    }): Promise<void>;
+    logSkipped(opts: RoutineLogEnvelope & {
+        reason: RoutineSkipReason;
+        scheduledTime: Date;
+        occurredAt?: Date;
+    }): Promise<void>;
+    logStateUpdated(opts: RoutineLogEnvelope & {
+        state: RoutineExecutionState;
+        occurredAt?: Date;
+    }): Promise<void>;
+    private appendRoutineLog;
+}
+export {};

package/dist/application/routine-event-log-sink.js

@@ -0,0 +1,82 @@
+import { RoutineName } from "../domain/routine-name.js";
+export class RoutineEventLogSink {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    async logTriggered(opts) {
+        await this.appendRoutineLog("routine_triggered", "running", opts, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            scheduled_time: opts.scheduledTime.toISOString(),
+            trigger_time: opts.triggerTime.toISOString(),
+            is_catch_up: opts.isCatchUp,
+        }, opts.occurredAt);
+        if (!opts.isCatchUp) {
+            return;
+        }
+        await this.appendRoutineLog("routine_catch_up", "running", opts, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            scheduled_time: opts.scheduledTime.toISOString(),
+            trigger_time: opts.triggerTime.toISOString(),
+            skipped_count: opts.skippedCount ?? 0,
+        }, opts.occurredAt);
+    }
+    async logCompleted(opts) {
+        await this.appendRoutineLog("routine_completed", "success", opts, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            duration: opts.duration,
+        }, opts.occurredAt);
+    }
+    async logFailed(opts) {
+        await this.appendRoutineLog("routine_failed", "error", opts, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            duration: opts.duration,
+            error_code: opts.errorCode,
+            error_message: opts.errorMessage,
+            workflow_execution_id: opts.workflowExecutionId ?? null,
+        }, opts.occurredAt);
+    }
+    async logSkipped(opts) {
+        await this.appendRoutineLog("routine_skipped", "success", { ...opts, routineRunId: null }, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            reason: opts.reason,
+            scheduled_time: opts.scheduledTime.toISOString(),
+        }, opts.occurredAt);
+    }
+    async logStateUpdated(opts) {
+        await this.appendRoutineLog("routine_state_updated", "success", opts, {
+            routine_name: toRoutineNameValue(opts.routineName),
+            state: serializeRoutineState(opts.state),
+        }, opts.occurredAt);
+    }
+    async appendRoutineLog(eventType, status, envelope, payload, occurredAt = new Date()) {
+        const routineName = toRoutineNameValue(envelope.routineName);
+        const routineRunId = envelope.routineRunId ?? null;
+        await this.store.appendLog({
+            timestamp: occurredAt.toISOString(),
+            session_id: routineRunId ?? routineName,
+            event_type: eventType,
+            status,
+            details: {
+                routine: {
+                    routine_name: routineName,
+                    owner_pid: envelope.ownerPid,
+                    routine_run_id: routineRunId,
+                    ...payload,
+                },
+            },
+        });
+    }
+}
+function serializeRoutineState(state) {
+    return {
+        last_executed_at: state.lastExecutedAt?.toISOString() ?? null,
+        last_scheduled_at: state.lastScheduledAt?.toISOString() ?? null,
+        next_scheduled_at: state.nextScheduledAt?.toISOString() ?? null,
+        last_status: state.lastStatus,
+    };
+}
+function toRoutineNameValue(value) {
+    return value instanceof RoutineName ? value.value : value;
+}
+//# sourceMappingURL=routine-event-log-sink.js.map

package/dist/application/routine-event-log-sink.js.map

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

package/dist/application/routine-run-service.d.ts

@@ -0,0 +1,56 @@
+import type { LoopExecutionResult, ResumeLoopOptions, WorkflowExecutionService } from "./workflow-execution-service.js";
+import { RoutineEventLogSink } from "./routine-event-log-sink.js";
+import type { RoutineCatalogEntry } from "./routine-catalog-service.js";
+import { RoutineExecutionLeaseRepository } from "../infrastructure/store/routine-execution-lease-repository.js";
+import { RoutineRuntimeProjectionRepository } from "../infrastructure/store/routine-runtime-projection-repository.js";
+import { RoutineStateRepository } from "../infrastructure/store/routine-state-repository.js";
+export interface RoutineRunServiceDeps {
+    workflowExecutionService: Pick<WorkflowExecutionService, "startLoop" | "resumeLoop">;
+    leaseRepo: RoutineExecutionLeaseRepository;
+    runtimeRepo: RoutineRuntimeProjectionRepository;
+    stateRepo: RoutineStateRepository;
+    eventLog: RoutineEventLogSink;
+}
+export type RoutineDispatchSource = "scheduled" | "manual" | "catch_up" | "skip";
+export interface RoutineDispatchOptions {
+    source: RoutineDispatchSource;
+    firingTimes?: Date[];
+    scheduledTime?: Date;
+    triggerTime?: Date;
+    skippedSchedules?: Date[];
+    vars?: Record<string, string>;
+    cwd?: string;
+    signal?: AbortSignal;
+    skippedCount?: number;
+}
+export interface RoutineDispatchRunResult {
+    status: "completed" | "failed" | "skipped";
+    scheduledTime: string;
+    triggerTime?: string;
+    routineRunId?: string;
+    workflowExecutionId?: string;
+}
+export interface RoutineDispatchResult {
+    status: "completed" | "failed" | "skipped";
+    runs: RoutineDispatchRunResult[];
+}
+export interface RoutineRunServiceOptions {
+    now?: () => Date;
+    ownerPid?: number;
+    heartbeatIntervalMs?: number;
+}
+export declare class RoutineRunService {
+    private readonly deps;
+    private readonly now;
+    private readonly ownerPid;
+    private readonly heartbeatIntervalMs;
+    constructor(deps: RoutineRunServiceDeps, options?: RoutineRunServiceOptions);
+    dispatch(entry: RoutineCatalogEntry, options: RoutineDispatchOptions): Promise<RoutineDispatchResult>;
+    dispatchResume(entry: RoutineCatalogEntry, options: Omit<ResumeLoopOptions, "workflowPath" | "routineRunId">): Promise<LoopExecutionResult>;
+    dispatchSingle(entry: RoutineCatalogEntry, options: Omit<RoutineDispatchOptions, "firingTimes"> & {
+        scheduledTime: Date;
+        triggerTime: Date;
+    }): Promise<RoutineDispatchRunResult>;
+    private handleSkip;
+    private persistState;
+}