@rk0429/agentic-relay 20.1.1 → 21.0.0

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

@@ -1,22 +1,26 @@
 import { RelayStore } from "../infrastructure/store/relay-store.js";
+export interface LoopRoutineContext {
+    routineRunId?: string;
+}
 export declare class LoopEventLogSink {
     private readonly store;
     constructor(store: RelayStore);
-    logLoopStarted(executionId: string, workflowName: string, maxIterations: number): Promise<void>;
-    logIterationStarted(executionId: string, iteration: number): Promise<void>;
+    logLoopStarted(executionId: string, workflowName: string, maxIterations: number, routine?: LoopRoutineContext): Promise<void>;
+    logIterationStarted(executionId: string, iteration: number, routine?: LoopRoutineContext): Promise<void>;
     logStepStarted(executionId: string, stepId: string, iteration: number, opts?: {
         backend?: string;
         role?: string;
+        routineRunId?: string;
     }): Promise<void>;
-    logStepCompleted(executionId: string, stepId: string, iteration: number, relaySessionId: string, fullResponsePath: string, duration: number): Promise<void>;
-    logStepFailed(executionId: string, stepId: string, iteration: number, error: string, duration: number): Promise<void>;
-    logStepSkipped(executionId: string, stepId: string, iteration: number, reason: string): Promise<void>;
-    logExitConditionEvaluated(executionId: string, verdict: string, iteration: number): Promise<void>;
-    logExitConditionFailed(executionId: string, iteration: number, checkpoint: unknown, error: string): Promise<void>;
+    logStepCompleted(executionId: string, stepId: string, iteration: number, relaySessionId: string | undefined, fullResponsePath: string | undefined, duration: number, routine?: LoopRoutineContext): Promise<void>;
+    logStepFailed(executionId: string, stepId: string, iteration: number, error: string, duration: number, routine?: LoopRoutineContext): Promise<void>;
+    logStepSkipped(executionId: string, stepId: string, iteration: number, reason: string, routine?: LoopRoutineContext): Promise<void>;
+    logExitConditionEvaluated(executionId: string, verdict: string, iteration: number, routine?: LoopRoutineContext): Promise<void>;
+    logExitConditionFailed(executionId: string, iteration: number, checkpoint: unknown, error: string, routine?: LoopRoutineContext): Promise<void>;
     logLoopInterrupted(executionId: string, iteration: number, stateFilePath: string, opts?: {
         nextStepId?: string;
         pendingExitCondition?: unknown;
-    }): Promise<void>;
-    logLoopCompleted(executionId: string, completionReason: string, totalIterations: number, totalDuration: number): Promise<void>;
+    }, routine?: LoopRoutineContext): Promise<void>;
+    logLoopCompleted(executionId: string, completionReason: string, totalIterations: number, totalDuration: number, routine?: LoopRoutineContext): Promise<void>;
     private appendLoopLog;
 }

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

@@ -4,16 +4,16 @@ export class LoopEventLogSink {
     constructor(store) {
         this.store = store;
     }
-    async logLoopStarted(executionId, workflowName, maxIterations) {
+    async logLoopStarted(executionId, workflowName, maxIterations, routine) {
         await this.appendLoopLog(executionId, "loop_started", "running", {
             workflow_name: workflowName,
             max_iterations: maxIterations,
-        });
+        }, undefined, routine);
     }
-    async logIterationStarted(executionId, iteration) {
+    async logIterationStarted(executionId, iteration, routine) {
         await this.appendLoopLog(executionId, "iteration_started", "running", {
             iteration,
-        });
+        }, undefined, routine);
     }
     async logStepStarted(executionId, stepId, iteration, opts) {
         await this.appendLoopLog(executionId, "step_started", "running", {
@@ -21,46 +21,46 @@ export class LoopEventLogSink {
             iteration,
             ...(opts?.backend ? { backend: opts.backend } : {}),
             ...(opts?.role ? { role: opts.role } : {}),
-        }, normalizeBackend(opts?.backend));
+        }, normalizeBackend(opts?.backend), { routineRunId: opts?.routineRunId });
     }
-    async logStepCompleted(executionId, stepId, iteration, relaySessionId, fullResponsePath, duration) {
+    async logStepCompleted(executionId, stepId, iteration, relaySessionId, fullResponsePath, duration, routine) {
         await this.appendLoopLog(executionId, "step_completed", "success", {
             step_id: stepId,
             iteration,
-            relay_session_id: relaySessionId,
-            full_response_path: fullResponsePath,
+            ...(relaySessionId ? { relay_session_id: relaySessionId } : {}),
+            ...(fullResponsePath ? { full_response_path: fullResponsePath } : {}),
             duration,
-        });
+        }, undefined, routine);
     }
-    async logStepFailed(executionId, stepId, iteration, error, duration) {
+    async logStepFailed(executionId, stepId, iteration, error, duration, routine) {
         await this.appendLoopLog(executionId, "step_failed", "error", {
             step_id: stepId,
             iteration,
             error,
             duration,
-        });
+        }, undefined, routine);
     }
-    async logStepSkipped(executionId, stepId, iteration, reason) {
+    async logStepSkipped(executionId, stepId, iteration, reason, routine) {
         await this.appendLoopLog(executionId, "step_skipped", "success", {
             step_id: stepId,
             iteration,
             reason,
-        });
+        }, undefined, routine);
     }
-    async logExitConditionEvaluated(executionId, verdict, iteration) {
+    async logExitConditionEvaluated(executionId, verdict, iteration, routine) {
         await this.appendLoopLog(executionId, "exit_condition_evaluated", "success", {
             verdict,
             iteration,
-        });
+        }, undefined, routine);
     }
-    async logExitConditionFailed(executionId, iteration, checkpoint, error) {
+    async logExitConditionFailed(executionId, iteration, checkpoint, error, routine) {
         await this.appendLoopLog(executionId, "exit_condition_failed", "error", {
             iteration,
             checkpoint,
             error,
-        });
+        }, undefined, routine);
     }
-    async logLoopInterrupted(executionId, iteration, stateFilePath, opts) {
+    async logLoopInterrupted(executionId, iteration, stateFilePath, opts, routine) {
         await this.appendLoopLog(executionId, "loop_interrupted", "error", {
             iteration,
             state_file_path: stateFilePath,
@@ -68,16 +68,16 @@ export class LoopEventLogSink {
             ...(opts?.pendingExitCondition !== undefined
                 ? { pending_exit_condition: opts.pendingExitCondition }
                 : {}),
-        });
+        }, undefined, routine);
     }
-    async logLoopCompleted(executionId, completionReason, totalIterations, totalDuration) {
+    async logLoopCompleted(executionId, completionReason, totalIterations, totalDuration, routine) {
         await this.appendLoopLog(executionId, "loop_completed", "success", {
             completion_reason: completionReason,
             total_iterations: totalIterations,
             total_duration: totalDuration,
-        });
+        }, undefined, routine);
     }
-    async appendLoopLog(executionId, eventType, status, loopDetails, backend) {
+    async appendLoopLog(executionId, eventType, status, loopDetails, backend, routine) {
         await this.store.appendLog({
             timestamp: new Date().toISOString(),
             session_id: executionId,
@@ -86,6 +86,13 @@ export class LoopEventLogSink {
             status,
             details: {
                 loop: loopDetails,
+                ...(routine?.routineRunId
+                    ? {
+                        routine: {
+                            routine_run_id: routine.routineRunId,
+                        },
+                    }
+                    : {}),
             },
         });
     }

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

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

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

@@ -0,0 +1,36 @@
+import type { RoutineDefinition } from "../domain/routine-definition.js";
+import { type RoutineLoadResult } from "../domain/routine-loader.js";
+import type { WorkflowCapabilitySummary, WorkflowFileRepository, WorkflowLoadResult } from "../domain/workflow-loader.js";
+export interface RoutineCatalogEntry {
+    definition: RoutineDefinition;
+    yamlPath: string;
+    capabilitySummary: WorkflowCapabilitySummary;
+    workflowLoadResult?: WorkflowLoadResult;
+}
+export interface RoutineCatalogIssue {
+    kind: "invalid_config" | "duplicate_name";
+    yamlPath: string;
+    routineName?: string;
+    error: string;
+    duplicateOf?: string;
+}
+export interface RoutineCatalogSnapshot {
+    catalog: Map<string, RoutineCatalogEntry>;
+    invalid: RoutineCatalogIssue[];
+}
+export interface RoutineCatalogServiceDeps {
+    configDir: string;
+    workflowRepo: WorkflowFileRepository;
+    loader?: (yamlPath: string, repo: WorkflowFileRepository, vars?: Record<string, string>) => Promise<RoutineLoadResult>;
+}
+export declare class RoutineCatalogService {
+    private readonly deps;
+    private readonly loader;
+    private snapshot;
+    constructor(deps: RoutineCatalogServiceDeps);
+    scan(vars?: Record<string, string>): Promise<RoutineCatalogSnapshot>;
+    rescan(vars?: Record<string, string>): Promise<RoutineCatalogSnapshot>;
+    getSnapshot(): RoutineCatalogSnapshot;
+    getCatalog(): Map<string, RoutineCatalogEntry>;
+    private listYamlFiles;
+}

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

@@ -0,0 +1,90 @@
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+import { ValidationError } from "../core/errors.js";
+import { loadRoutine } from "../domain/routine-loader.js";
+import { isMissingFileError } from "../infrastructure/store/file-utils.js";
+export class RoutineCatalogService {
+    deps;
+    loader;
+    snapshot = {
+        catalog: new Map(),
+        invalid: [],
+    };
+    constructor(deps) {
+        this.deps = deps;
+        this.loader = deps.loader ?? loadRoutine;
+    }
+    async scan(vars = {}) {
+        const catalog = new Map();
+        const invalid = [];
+        const yamlPaths = await this.listYamlFiles();
+        for (const yamlPath of yamlPaths) {
+            try {
+                const loaded = await this.loader(yamlPath, this.deps.workflowRepo, vars);
+                const routineName = loaded.routineDefinition.name.value;
+                if (catalog.has(routineName)) {
+                    invalid.push({
+                        kind: "duplicate_name",
+                        yamlPath,
+                        routineName,
+                        duplicateOf: catalog.get(routineName).yamlPath,
+                        error: `Duplicate routine name "${routineName}" detected.`,
+                    });
+                    continue;
+                }
+                catalog.set(routineName, {
+                    definition: loaded.routineDefinition,
+                    yamlPath,
+                    capabilitySummary: loaded.capabilitySummary,
+                    workflowLoadResult: loaded.workflowLoadResult,
+                });
+            }
+            catch (error) {
+                invalid.push({
+                    kind: "invalid_config",
+                    yamlPath,
+                    error: formatError(error),
+                });
+            }
+        }
+        this.snapshot = { catalog, invalid };
+        return this.snapshot;
+    }
+    async rescan(vars = {}) {
+        return this.scan(vars);
+    }
+    getSnapshot() {
+        return this.snapshot;
+    }
+    getCatalog() {
+        return this.snapshot.catalog;
+    }
+    async listYamlFiles() {
+        try {
+            const entries = await readdir(this.deps.configDir, { withFileTypes: true });
+            return entries
+                .filter((entry) => entry.isFile() && /\.(ya?ml)$/i.test(entry.name))
+                .map((entry) => path.resolve(this.deps.configDir, entry.name))
+                .sort((left, right) => left.localeCompare(right));
+        }
+        catch (error) {
+            if (error instanceof ValidationError) {
+                throw error;
+            }
+            if (isMissingFileError(error)) {
+                return [];
+            }
+            throw error;
+        }
+    }
+}
+function formatError(error) {
+    if (error instanceof ValidationError) {
+        return error.message;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=routine-catalog-service.js.map

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

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

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

@@ -0,0 +1,48 @@
+import type { RoutineCatalogService } from "./routine-catalog-service.js";
+import { type RoutineScheduler } from "./routine-scheduler.js";
+import type { RoutineRunService } from "./routine-run-service.js";
+import { RelayStore } from "../infrastructure/store/relay-store.js";
+import { RoutineExecutionLeaseRepository } from "../infrastructure/store/routine-execution-lease-repository.js";
+import { RoutineStateRepository } from "../infrastructure/store/routine-state-repository.js";
+export interface RoutineDaemonSignalTarget {
+    on(event: "SIGTERM" | "SIGINT", listener: () => void): void;
+    off(event: "SIGTERM" | "SIGINT", listener: () => void): void;
+}
+export interface ProcessStatus {
+    alive: boolean;
+    startedAt?: string | null;
+}
+export interface RoutineDaemonServiceDeps {
+    store: RelayStore;
+    catalogService: Pick<RoutineCatalogService, "rescan" | "getCatalog">;
+    scheduler: Pick<RoutineScheduler, "tick">;
+    runService: Pick<RoutineRunService, "dispatch">;
+    stateRepo: RoutineStateRepository;
+    leaseRepo: RoutineExecutionLeaseRepository;
+    signalTarget?: RoutineDaemonSignalTarget;
+    getProcessStatus?: (pid: number) => Promise<ProcessStatus>;
+}
+export interface RoutineDaemonServiceOptions {
+    now?: () => Date;
+    ownerPid?: number;
+    pollIntervalMs?: number;
+}
+export declare class RoutineDaemonService {
+    private readonly deps;
+    private readonly now;
+    private readonly ownerPid;
+    private readonly pollIntervalMs;
+    private readonly signalTarget;
+    private readonly getProcessStatus;
+    private stopping;
+    private readonly sleepController;
+    private currentExecution?;
+    constructor(deps: RoutineDaemonServiceDeps, options?: RoutineDaemonServiceOptions);
+    start(): Promise<void>;
+    private runTick;
+    private cleanupStaleLeases;
+    private acquirePidFile;
+    private releasePidFile;
+    private readPidFile;
+    private pidFilePath;
+}

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