ts-workflow-engine-lite 2.1.0

package/dist/src/notification/channels/SmsChannel.js

@@ -0,0 +1,37 @@
+import { Logger } from "../../utils/Logger.js";
+export class SmsChannel {
+    name = "sms";
+    transport;
+    defaultSignName;
+    constructor(options) {
+        this.transport = options.transport;
+        this.defaultSignName = options.signName;
+    }
+    async send(message) {
+        try {
+            const signName = message.data?.signName ?? this.defaultSignName;
+            const result = await this.transport.send({
+                to: message.target,
+                content: message.body,
+                signName,
+            });
+            return {
+                ok: true,
+                channel: this.name,
+                detail: { messageId: result.messageId, to: message.target },
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            Logger.warn("system", "notification", "sms send failed", {
+                error: msg,
+                to: message.target,
+            });
+            return { ok: false, channel: this.name, error: msg };
+        }
+    }
+    async validate() {
+        return Boolean(this.transport);
+    }
+}
+//# sourceMappingURL=SmsChannel.js.map

package/dist/src/notification/channels/SmsChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SmsChannel.js","sourceRoot":"","sources":["../../../../src/notification/channels/SmsChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAuC5C,MAAM,OAAO,UAAU;IACrB,IAAI,GAAG,KAAK,CAAC;IACI,SAAS,CAAe;IACxB,eAAe,CAAU;IAE1C,YAAY,OAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA4B;QACrC,IAAI,CAAC;YACH,MAAM,QAAQ,GACX,OAAO,CAAC,IAAI,EAAE,QAA+B,IAAI,IAAI,CAAC,eAAe,CAAC;YAEzE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBACvC,EAAE,EAAE,OAAO,CAAC,MAAM;gBAClB,OAAO,EAAE,OAAO,CAAC,IAAI;gBACrB,QAAQ;aACT,CAAC,CAAC;YAEH,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,IAAI,CAAC,IAAI;gBAClB,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE;aAC5D,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,iBAAiB,EAAE;gBACvD,KAAK,EAAE,GAAG;gBACV,EAAE,EAAE,OAAO,CAAC,MAAM;aACnB,CAAC,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/src/notification/channels/WebhookChannel.d.ts

@@ -0,0 +1,17 @@
+import type { NotificationChannel, NotificationMessage, NotificationResult } from "../NotificationChannel.js";
+export interface WebhookChannelOptions {
+    webhookUrl?: string;
+    fetchImpl?: typeof fetch;
+    headers?: Record<string, string>;
+}
+export declare class WebhookChannel implements NotificationChannel {
+    name: string;
+    protected readonly webhookUrl?: string;
+    protected readonly fetchImpl: typeof fetch;
+    protected readonly headers: Record<string, string>;
+    constructor(options?: WebhookChannelOptions);
+    protected buildPayload(message: NotificationMessage): unknown;
+    protected resolveUrl(message: NotificationMessage): string;
+    send(message: NotificationMessage): Promise<NotificationResult>;
+    validate(): Promise<boolean>;
+}

package/dist/src/notification/channels/WebhookChannel.js

@@ -0,0 +1,61 @@
+import { Logger } from "../../utils/Logger.js";
+export class WebhookChannel {
+    name = "webhook";
+    webhookUrl;
+    fetchImpl;
+    headers;
+    constructor(options = {}) {
+        this.webhookUrl = options.webhookUrl;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+        this.headers = options.headers ?? {};
+    }
+    buildPayload(message) {
+        return {
+            subject: message.subject,
+            body: message.body,
+            severity: message.severity ?? "info",
+            target: message.target,
+            data: message.data,
+        };
+    }
+    resolveUrl(message) {
+        const url = this.webhookUrl ?? message.target;
+        if (!url) {
+            throw new Error(`${this.name} channel requires a webhook URL`);
+        }
+        return url;
+    }
+    async send(message) {
+        try {
+            const url = this.resolveUrl(message);
+            const response = await this.fetchImpl(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", ...this.headers },
+                body: JSON.stringify(this.buildPayload(message)),
+            });
+            if (!response.ok) {
+                const error = `Webhook responded with status ${response.status}`;
+                Logger.warn("system", "notification", `${this.name} send failed`, {
+                    status: response.status,
+                });
+                return { ok: false, channel: this.name, error };
+            }
+            return {
+                ok: true,
+                channel: this.name,
+                detail: { status: response.status },
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            Logger.warn("system", "notification", `${this.name} send failed`, {
+                error: msg,
+            });
+            return { ok: false, channel: this.name, error: msg };
+        }
+    }
+    async validate() {
+        return this.webhookUrl !== undefined;
+    }
+}
+//# sourceMappingURL=WebhookChannel.js.map

package/dist/src/notification/channels/WebhookChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookChannel.js","sourceRoot":"","sources":["../../../../src/notification/channels/WebhookChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAkB5C,MAAM,OAAO,cAAc;IACzB,IAAI,GAAG,SAAS,CAAC;IACE,UAAU,CAAU;IACpB,SAAS,CAAe;IACxB,OAAO,CAAyB;IAEnD,YAAY,UAAiC,EAAE;QAC7C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,CAAC;IAES,YAAY,CAAC,OAA4B;QACjD,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;YACpC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC;IACJ,CAAC;IAES,UAAU,CAAC,OAA4B;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;QAC9C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,iCAAiC,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA4B;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;gBACzC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE;gBAChE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;aACjD,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,iCAAiC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACjE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,IAAI,cAAc,EAAE;oBAChE,MAAM,EAAE,QAAQ,CAAC,MAAM;iBACxB,CAAC,CAAC;gBACH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YAClD,CAAC;YAED,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,IAAI,CAAC,IAAI;gBAClB,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC,IAAI,cAAc,EAAE;gBAChE,KAAK,EAAE,GAAG;aACX,CAAC,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC;IACvC,CAAC;CACF"}

package/dist/src/notification/index.d.ts

@@ -0,0 +1,24 @@
+import { type EmailTransport } from "./channels/EmailChannel.js";
+import { type SmsTransport } from "./channels/SmsChannel.js";
+import { type NotificationManager } from "./NotificationManager.js";
+export * from "./channels/DingtalkChannel.js";
+export * from "./channels/EmailChannel.js";
+export * from "./channels/FeishuChannel.js";
+export * from "./channels/SlackChannel.js";
+export * from "./channels/SmsChannel.js";
+export * from "./channels/WebhookChannel.js";
+export * from "./NotificationChannel.js";
+export * from "./NotificationManager.js";
+export interface NotificationSetupOptions {
+    manager?: NotificationManager;
+    fetchImpl?: typeof fetch;
+    email?: {
+        transport: EmailTransport;
+        from: string;
+    };
+    sms?: {
+        transport: SmsTransport;
+        signName?: string;
+    };
+}
+export declare function setupNotificationChannelsFromEnv(options?: NotificationSetupOptions): NotificationManager;

package/dist/src/notification/index.js

@@ -0,0 +1,61 @@
+import { DingtalkChannel } from "./channels/DingtalkChannel.js";
+import { EmailChannel, } from "./channels/EmailChannel.js";
+import { FeishuChannel } from "./channels/FeishuChannel.js";
+import { SlackChannel } from "./channels/SlackChannel.js";
+import { SmsChannel, } from "./channels/SmsChannel.js";
+import { WebhookChannel, } from "./channels/WebhookChannel.js";
+import { notificationManager, } from "./NotificationManager.js";
+export * from "./channels/DingtalkChannel.js";
+export * from "./channels/EmailChannel.js";
+export * from "./channels/FeishuChannel.js";
+export * from "./channels/SlackChannel.js";
+export * from "./channels/SmsChannel.js";
+export * from "./channels/WebhookChannel.js";
+export * from "./NotificationChannel.js";
+export * from "./NotificationManager.js";
+function registerIfMissing(manager, name, factory) {
+    if (!manager.getChannel(name)) {
+        manager.registerChannel(factory());
+    }
+}
+export function setupNotificationChannelsFromEnv(options = {}) {
+    const manager = options.manager ?? notificationManager;
+    const webhookOptions = {
+        fetchImpl: options.fetchImpl,
+    };
+    if (process.env.SLACK_WEBHOOK_URL) {
+        registerIfMissing(manager, "slack", () => new SlackChannel({
+            ...webhookOptions,
+            webhookUrl: process.env.SLACK_WEBHOOK_URL,
+        }));
+    }
+    if (process.env.FEISHU_WEBHOOK_URL) {
+        registerIfMissing(manager, "feishu", () => new FeishuChannel({
+            ...webhookOptions,
+            webhookUrl: process.env.FEISHU_WEBHOOK_URL,
+        }));
+    }
+    if (process.env.DINGTALK_WEBHOOK_URL) {
+        registerIfMissing(manager, "dingtalk", () => new DingtalkChannel({
+            ...webhookOptions,
+            webhookUrl: process.env.DINGTALK_WEBHOOK_URL,
+        }));
+    }
+    registerIfMissing(manager, "webhook", () => new WebhookChannel(webhookOptions));
+    if (options.email && !manager.getChannel("email")) {
+        const emailOptions = {
+            transport: options.email.transport,
+            from: options.email.from,
+        };
+        manager.registerChannel(new EmailChannel(emailOptions));
+    }
+    if (options.sms && !manager.getChannel("sms")) {
+        const smsOptions = {
+            transport: options.sms.transport,
+            signName: options.sms.signName,
+        };
+        manager.registerChannel(new SmsChannel(smsOptions));
+    }
+    return manager;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/notification/index.js.map

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

package/dist/src/scheduler/CronScheduler.d.ts

@@ -0,0 +1,20 @@
+import { type ScheduledTask } from "node-cron";
+import type { StorageProvider } from "../storage/StorageProvider.js";
+export interface CronStartableEngine {
+    start(workflowId: string, context?: Record<string, any>): Promise<string>;
+}
+export declare class CronScheduler {
+    static jobs: Record<string, ScheduledTask>;
+    private instanceJobs;
+    private leaseStore;
+    private readonly leaseHolderId;
+    constructor(_storage?: StorageProvider, holderId?: string);
+    private shouldRunCronTick;
+    static schedule(workflowId: string, cronExpression: string, engine: CronStartableEngine): void;
+    static stop(workflowId: string): void;
+    static stopAll(): void;
+    stopAll(): void;
+    scheduleJob(workflowId: string, cronExpression: string, engine: CronStartableEngine): void;
+    stopJob(workflowId: string): void;
+    getActiveJobs(): string[];
+}

package/dist/src/scheduler/CronScheduler.js

@@ -0,0 +1,82 @@
+import { schedule } from "node-cron";
+import { createLeaseStore } from "../utils/LeaseStore.js";
+import { Logger } from "../utils/Logger.js";
+export class CronScheduler {
+    static jobs = {};
+    instanceJobs = {};
+    leaseStore;
+    leaseHolderId;
+    constructor(_storage, holderId) {
+        this.leaseStore = createLeaseStore();
+        this.leaseHolderId = holderId ?? `cron-${process.pid}-${Date.now()}`;
+    }
+    async shouldRunCronTick(workflowId) {
+        const bucket = Math.floor(Date.now() / 1000);
+        const key = `workflow:lease:cron:${workflowId}:${bucket}`;
+        const ttlMs = 10000;
+        return this.leaseStore.acquire(key, this.leaseHolderId, ttlMs);
+    }
+    static schedule(workflowId, cronExpression, engine) {
+        const task = schedule(cronExpression, () => {
+            Logger.info("system", "cron", `Triggering workflow: ${workflowId}`);
+            engine.start(workflowId).catch((err) => {
+                Logger.error("system", "cron", `Failed to start workflow ${workflowId}`, err instanceof Error ? err.stack : String(err));
+            });
+        });
+        CronScheduler.jobs[workflowId] = task;
+        Logger.debug("system", "cron", `Scheduled workflow ${workflowId} with cron: ${cronExpression}`);
+    }
+    static stop(workflowId) {
+        if (CronScheduler.jobs[workflowId]) {
+            CronScheduler.jobs[workflowId].stop();
+            delete CronScheduler.jobs[workflowId];
+            Logger.debug("system", "cron", `Stopped cron job for workflow ${workflowId}`);
+        }
+    }
+    static stopAll() {
+        const jobIds = Object.keys(CronScheduler.jobs);
+        for (const workflowId of jobIds) {
+            CronScheduler.stop(workflowId);
+        }
+        Logger.info("system", "cron", `Stopped ${jobIds.length} cron jobs`);
+    }
+    stopAll() {
+        const jobIds = Object.keys(this.instanceJobs);
+        for (const workflowId of jobIds) {
+            this.stopJob(workflowId);
+        }
+        CronScheduler.stopAll();
+        Logger.info("system", "cron", "Stopped all cron jobs");
+    }
+    scheduleJob(workflowId, cronExpression, engine) {
+        this.stopJob(workflowId);
+        const task = schedule(cronExpression, () => {
+            void this.shouldRunCronTick(workflowId).then((shouldRun) => {
+                if (!shouldRun) {
+                    Logger.debug("system", "cron", `Cron tick skipped due to lock: ${workflowId}`);
+                    return;
+                }
+                Logger.info("system", "cron", `Triggering workflow: ${workflowId}`);
+                engine.start(workflowId).catch((err) => {
+                    Logger.error("system", "cron", `Failed to start workflow ${workflowId}`, err instanceof Error ? err.stack : String(err));
+                });
+            });
+        });
+        this.instanceJobs[workflowId] = task;
+        Logger.debug("system", "cron", `Scheduled workflow ${workflowId} with cron: ${cronExpression}`);
+    }
+    stopJob(workflowId) {
+        if (this.instanceJobs[workflowId]) {
+            this.instanceJobs[workflowId].stop();
+            delete this.instanceJobs[workflowId];
+            Logger.debug("system", "cron", `Stopped cron job for workflow ${workflowId}`);
+        }
+    }
+    getActiveJobs() {
+        return [
+            ...Object.keys(this.instanceJobs),
+            ...Object.keys(CronScheduler.jobs),
+        ];
+    }
+}
+//# sourceMappingURL=CronScheduler.js.map

package/dist/src/scheduler/CronScheduler.js.map

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

package/dist/src/scheduler/EnhancedCronScheduler.d.ts

@@ -0,0 +1,27 @@
+import { type Schedule, type SchedulePolicy, type ScheduleSpec } from "../model/Schedule.js";
+import type { StorageProvider } from "../storage/StorageProvider.js";
+export interface EnhancedCronStartableEngine {
+    start(workflowId: string, context?: Record<string, any>): Promise<string>;
+}
+export declare class EnhancedCronScheduler {
+    private schedules;
+    private runningActions;
+    private instanceJobs;
+    private lastCompletionResults;
+    private lastFailures;
+    constructor(_storage?: StorageProvider);
+    createSchedule(scheduleId: string, workflowId: string, spec: ScheduleSpec, policy?: SchedulePolicy): Schedule;
+    startSchedule(scheduleId: string, engine: EnhancedCronStartableEngine): Promise<void>;
+    private executeScheduleAction;
+    pauseSchedule(scheduleId: string, notes?: string): void;
+    resumeSchedule(scheduleId: string, notes?: string): void;
+    backfill(scheduleId: string, startTime: Date, endTime: Date, engine: EnhancedCronStartableEngine): Promise<void>;
+    recordCompletion(workflowId: string, result: unknown): void;
+    recordFailure(workflowId: string, failure: unknown): void;
+    completeAction(workflowId: string, instanceId: string): void;
+    getSchedule(scheduleId: string): Schedule | undefined;
+    listSchedules(): Schedule[];
+    deleteSchedule(scheduleId: string): void;
+    stopSchedule(scheduleId: string): void;
+    stopAll(): void;
+}

package/dist/src/scheduler/EnhancedCronScheduler.js

@@ -0,0 +1,177 @@
+import { schedule as nodeCronSchedule } from "node-cron";
+import { calculateJitter, DEFAULT_SCHEDULE_POLICY, isInTimeWindow, shouldRunAction, } from "../model/Schedule.js";
+import { createLeaseStore } from "../utils/LeaseStore.js";
+import { Logger } from "../utils/Logger.js";
+export class EnhancedCronScheduler {
+    schedules = new Map();
+    runningActions = new Map();
+    instanceJobs = {};
+    lastCompletionResults = new Map();
+    lastFailures = new Map();
+    constructor(_storage) {
+        createLeaseStore();
+    }
+    createSchedule(scheduleId, workflowId, spec, policy) {
+        const schedule = {
+            id: scheduleId,
+            workflowId,
+            spec,
+            policy,
+            paused: false,
+        };
+        this.schedules.set(scheduleId, schedule);
+        Logger.info("system", "scheduler", `Schedule created: ${scheduleId}`);
+        return schedule;
+    }
+    async startSchedule(scheduleId, engine) {
+        const schedule = this.schedules.get(scheduleId);
+        if (!schedule) {
+            throw new Error(`Schedule not found: ${scheduleId}`);
+        }
+        if (schedule.spec.interval) {
+            const task = nodeCronSchedule(schedule.spec.interval, async () => {
+                await this.executeScheduleAction(schedule, engine);
+            });
+            this.instanceJobs[scheduleId] = task;
+        }
+    }
+    async executeScheduleAction(scheduleItem, engine) {
+        if (scheduleItem.paused) {
+            Logger.debug("system", "scheduler", `Action skipped: schedule is paused: ${scheduleItem.id}`);
+            return;
+        }
+        const effectivePolicy = {
+            overlap: "skip",
+            catchupWindow: 86400000,
+            ...scheduleItem.policy,
+        };
+        const runningCount = this.runningActions.get(scheduleItem.workflowId)?.length ?? 0;
+        if (!shouldRunAction(effectivePolicy, runningCount)) {
+            Logger.debug("system", "scheduler", `Action skipped due to overlap policy: ${scheduleItem.id}`);
+            return;
+        }
+        if (runningCount > 0 &&
+            (effectivePolicy.overlap === "cancel_other" ||
+                effectivePolicy.overlap === "terminate_other")) {
+            const displaced = this.runningActions.get(scheduleItem.workflowId) ?? [];
+            Logger.info("system", "scheduler", `Overlap policy '${effectivePolicy.overlap}': displacing ${displaced.length} running action(s) for ${scheduleItem.id}`, { instanceIds: displaced.map((r) => r.instanceId) });
+            this.runningActions.set(scheduleItem.workflowId, []);
+        }
+        if (!isInTimeWindow(scheduleItem.spec)) {
+            Logger.debug("system", "scheduler", `Action skipped: outside time window: ${scheduleItem.id}`);
+            return;
+        }
+        let delay = 0;
+        if (scheduleItem.spec.jitter) {
+            delay = calculateJitter(scheduleItem.spec.jitter);
+            Logger.debug("system", "scheduler", `Jitter applied: ${delay}ms for ${scheduleItem.id}`);
+        }
+        setTimeout(async () => {
+            const instanceId = await engine.start(scheduleItem.workflowId, {
+                _scheduleId: scheduleItem.id,
+                _lastCompletionResult: this.lastCompletionResults.get(scheduleItem.workflowId),
+                _lastFailure: this.lastFailures.get(scheduleItem.workflowId),
+            });
+            const running = {
+                workflowId: scheduleItem.workflowId,
+                instanceId,
+                startTime: new Date(),
+            };
+            const existing = this.runningActions.get(scheduleItem.workflowId) ?? [];
+            if (effectivePolicy.overlap === "buffer_all") {
+                existing.push(running);
+                this.runningActions.set(scheduleItem.workflowId, existing);
+            }
+            else {
+                this.runningActions.set(scheduleItem.workflowId, [running]);
+            }
+            scheduleItem.lastActionTime = new Date();
+        }, delay);
+    }
+    pauseSchedule(scheduleId, notes) {
+        const schedule = this.schedules.get(scheduleId);
+        if (schedule) {
+            schedule.paused = true;
+            schedule.notes = notes;
+            Logger.info("system", "scheduler", `Schedule paused: ${scheduleId}`);
+        }
+    }
+    resumeSchedule(scheduleId, notes) {
+        const schedule = this.schedules.get(scheduleId);
+        if (schedule) {
+            schedule.paused = false;
+            schedule.notes = notes;
+            Logger.info("system", "scheduler", `Schedule resumed: ${scheduleId}`);
+        }
+    }
+    async backfill(scheduleId, startTime, endTime, engine) {
+        const scheduleItem = this.schedules.get(scheduleId);
+        if (!scheduleItem) {
+            throw new Error(`Schedule not found: ${scheduleId}`);
+        }
+        const catchupWindow = scheduleItem.policy?.catchupWindow ??
+            DEFAULT_SCHEDULE_POLICY.catchupWindow;
+        const now = Date.now();
+        const windowStart = new Date(Math.max(startTime.getTime(), now - catchupWindow));
+        if (windowStart > endTime) {
+            Logger.warn("system", "scheduler", `Backfill skipped: entire range [${startTime.toISOString()}, ${endTime.toISOString()}] is outside catchupWindow (${catchupWindow}ms) for ${scheduleId}`);
+            return;
+        }
+        Logger.info("system", "scheduler", `Backfilling schedule ${scheduleId} from ${windowStart.toISOString()} to ${endTime.toISOString()}`);
+        for (let t = windowStart.getTime(); t <= endTime.getTime(); t += 60000) {
+            if (isInTimeWindow({ ...scheduleItem.spec, startTime: new Date(t) })) {
+                await this.executeScheduleAction(scheduleItem, engine);
+            }
+        }
+    }
+    recordCompletion(workflowId, result) {
+        this.lastCompletionResults.set(workflowId, result);
+        const scheduleItem = Array.from(this.schedules.values()).find((s) => s.workflowId === workflowId);
+        if (scheduleItem) {
+            scheduleItem.lastCompletionResult = result;
+        }
+    }
+    recordFailure(workflowId, failure) {
+        this.lastFailures.set(workflowId, failure);
+        const scheduleItem = Array.from(this.schedules.values()).find((s) => s.workflowId === workflowId);
+        if (scheduleItem) {
+            scheduleItem.lastFailure = failure;
+            if (scheduleItem.policy?.pauseOnFailure) {
+                this.pauseSchedule(scheduleItem.id, `Paused due to failure: ${failure?.message}`);
+            }
+        }
+    }
+    completeAction(workflowId, instanceId) {
+        const running = this.runningActions.get(workflowId);
+        if (running) {
+            const index = running.findIndex((r) => r.instanceId === instanceId);
+            if (index >= 0) {
+                running.splice(index, 1);
+            }
+        }
+    }
+    getSchedule(scheduleId) {
+        return this.schedules.get(scheduleId);
+    }
+    listSchedules() {
+        return Array.from(this.schedules.values());
+    }
+    deleteSchedule(scheduleId) {
+        this.stopSchedule(scheduleId);
+        this.schedules.delete(scheduleId);
+        Logger.info("system", "scheduler", `Schedule deleted: ${scheduleId}`);
+    }
+    stopSchedule(scheduleId) {
+        if (this.instanceJobs[scheduleId]) {
+            this.instanceJobs[scheduleId].stop();
+            delete this.instanceJobs[scheduleId];
+        }
+    }
+    stopAll() {
+        for (const jobId of Object.keys(this.instanceJobs)) {
+            this.stopSchedule(jobId);
+        }
+        Logger.info("system", "scheduler", "All schedules stopped");
+    }
+}
+//# sourceMappingURL=EnhancedCronScheduler.js.map

package/dist/src/scheduler/EnhancedCronScheduler.js.map

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

package/dist/src/storage/ArchiveManager.d.ts

@@ -0,0 +1,21 @@
+import type { StorageProvider } from "./StorageProvider.js";
+export declare class ArchiveManager {
+    private archiveDir;
+    private storage?;
+    private lastEnsuredDate;
+    private tempCounter;
+    private unsubscribe;
+    private cleanupTimer?;
+    private readonly retentionDays;
+    private readonly cleanupIntervalMs;
+    constructor(storage?: StorageProvider, archiveDir?: string, options?: {
+        retentionDays?: number;
+        cleanupIntervalMs?: number;
+    });
+    initialize(): void;
+    destroy(): void;
+    private handleTerminalState;
+    cleanupExpiredArchives(now?: number): Promise<number>;
+    private ensureDailyDir;
+    private writeAtomic;
+}