ts-workflow-engine-lite 2.1.0

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

@@ -0,0 +1,75 @@
+export * from "./MetricsAggregator.js";
+interface MetricValue {
+    value: number;
+    labels: Record<string, string>;
+    timestamp: number;
+}
+declare class Counter {
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: string[];
+    private values;
+    constructor(name: string, help: string, labelNames?: string[]);
+    inc(labels?: Record<string, string>, value?: number): void;
+    get(labels?: Record<string, string>): number;
+    getAll(): MetricValue[];
+    private labelsToKey;
+    toPrometheus(): string;
+}
+declare class Gauge {
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: string[];
+    private values;
+    constructor(name: string, help: string, labelNames?: string[]);
+    set(labels: Record<string, string>, value: number): void;
+    inc(labels?: Record<string, string>, value?: number): void;
+    dec(labels?: Record<string, string>, value?: number): void;
+    get(labels?: Record<string, string>): number;
+    private labelsToKey;
+    toPrometheus(): string;
+}
+declare class Histogram {
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: string[];
+    private values;
+    private readonly buckets;
+    constructor(name: string, help: string, labelNames?: string[], buckets?: number[]);
+    observe(labels: Record<string, string>, value: number): void;
+    private labelsToKey;
+    toPrometheus(): string;
+}
+export declare const workflowDuration: Histogram;
+export declare const nodeExecutions: Counter;
+export declare const nodeRetries: Counter;
+export declare const nodeDuration: Histogram;
+export declare const activeInstances: Gauge;
+export declare const eventsWaiting: Gauge;
+export declare const totalInstances: Counter;
+export declare const eventProcessed: Counter;
+export declare const apiRequests: Counter;
+export declare const apiLatency: Histogram;
+export declare const llmCacheEvents: Counter;
+export declare const llmTokens: Counter;
+export declare const llmCostUsd: Counter;
+export declare const memoryUsage: Gauge;
+export declare const eventLoopLag: Gauge;
+export declare const webhookDeliveryCleanupRuns: Counter;
+export declare const webhookDeliveryCleanupRemoved: Counter;
+export declare const webhookDeliveryCleanupDuration: Histogram;
+export declare const webhookDeliveryCleanupLastRun: Gauge;
+export declare const webhookDeliveryCleanupLastSuccess: Gauge;
+export declare function collectSystemMetrics(): void;
+export declare function getMetrics(): string;
+export declare function recordWorkflowStart(workflowId: string, status?: string): void;
+export declare function recordWorkflowComplete(workflowId: string, status: "completed" | "failed", durationSeconds: number): void;
+export declare function recordNodeExecution(workflowId: string, nodeId: string, nodeType: string, status: "success" | "failed", durationSeconds?: number): void;
+export declare function recordNodeRetry(workflowId: string, nodeId: string): void;
+export declare function recordEventWaitStart(workflowId: string): void;
+export declare function recordEventWaitEnd(workflowId: string): void;
+export declare function recordEventProcessed(eventType: string, status: "success" | "failed"): void;
+export declare function recordApiRequest(method: string, path: string, status: number, durationSeconds: number): void;
+export declare function recordLlmCacheEvent(provider: string, model: string, result: "hit" | "miss"): void;
+export declare function recordLlmUsage(provider: string, model: string, inputTokens: number, outputTokens: number, costUsd: number): void;
+export declare function recordWebhookDeliveryCleanup(result: "success" | "failed" | "skipped", mode: "all_nodes" | "leader_only", durationSeconds: number, removedCount?: number): void;

package/dist/src/metrics/index.js

@@ -0,0 +1,293 @@
+export * from "./MetricsAggregator.js";
+const MAX_SERIES_PER_METRIC = 1000;
+const OVERFLOW_LABEL = "overflow";
+function overflowLabels(labelNames) {
+    const collapsed = {};
+    for (const name of labelNames) {
+        collapsed[name] = OVERFLOW_LABEL;
+    }
+    return collapsed;
+}
+class Counter {
+    name;
+    help;
+    labelNames;
+    values = new Map();
+    constructor(name, help, labelNames = []) {
+        this.name = name;
+        this.help = help;
+        this.labelNames = labelNames;
+    }
+    inc(labels = {}, value = 1) {
+        let key = this.labelsToKey(labels);
+        let effectiveLabels = labels;
+        if (!this.values.has(key) && this.values.size >= MAX_SERIES_PER_METRIC) {
+            effectiveLabels = overflowLabels(this.labelNames);
+            key = this.labelsToKey(effectiveLabels);
+        }
+        const existing = this.values.get(key);
+        if (existing) {
+            existing.value += value;
+            existing.timestamp = Date.now();
+        }
+        else {
+            this.values.set(key, {
+                value,
+                labels: effectiveLabels,
+                timestamp: Date.now(),
+            });
+        }
+    }
+    get(labels = {}) {
+        const key = this.labelsToKey(labels);
+        return this.values.get(key)?.value || 0;
+    }
+    getAll() {
+        return Array.from(this.values.values());
+    }
+    labelsToKey(labels) {
+        return this.labelNames
+            .map((name) => `${name}=${labels[name] || ""}`)
+            .join(",");
+    }
+    toPrometheus() {
+        const lines = [];
+        lines.push(`# HELP ${this.name} ${this.help}`);
+        lines.push(`# TYPE ${this.name} counter`);
+        for (const value of this.values.values()) {
+            const labelStr = Object.entries(value.labels)
+                .map(([k, v]) => `${k}="${v}"`)
+                .join(",");
+            lines.push(`${this.name}${labelStr ? `{${labelStr}}` : ""} ${value.value}`);
+        }
+        return lines.join("\n");
+    }
+}
+class Gauge {
+    name;
+    help;
+    labelNames;
+    values = new Map();
+    constructor(name, help, labelNames = []) {
+        this.name = name;
+        this.help = help;
+        this.labelNames = labelNames;
+    }
+    set(labels, value) {
+        const key = this.labelsToKey(labels);
+        this.values.set(key, { value, labels, timestamp: Date.now() });
+    }
+    inc(labels = {}, value = 1) {
+        const key = this.labelsToKey(labels);
+        const existing = this.values.get(key);
+        if (existing) {
+            existing.value += value;
+            existing.timestamp = Date.now();
+        }
+        else {
+            this.values.set(key, { value, labels, timestamp: Date.now() });
+        }
+    }
+    dec(labels = {}, value = 1) {
+        this.inc(labels, -value);
+    }
+    get(labels = {}) {
+        const key = this.labelsToKey(labels);
+        return this.values.get(key)?.value || 0;
+    }
+    labelsToKey(labels) {
+        return this.labelNames
+            .map((name) => `${name}=${labels[name] || ""}`)
+            .join(",");
+    }
+    toPrometheus() {
+        const lines = [];
+        lines.push(`# HELP ${this.name} ${this.help}`);
+        lines.push(`# TYPE ${this.name} gauge`);
+        for (const value of this.values.values()) {
+            const labelStr = Object.entries(value.labels)
+                .map(([k, v]) => `${k}="${v}"`)
+                .join(",");
+            lines.push(`${this.name}${labelStr ? `{${labelStr}}` : ""} ${value.value}`);
+        }
+        return lines.join("\n");
+    }
+}
+class Histogram {
+    name;
+    help;
+    labelNames;
+    values = new Map();
+    buckets;
+    constructor(name, help, labelNames = [], buckets = [0.1, 0.5, 1, 5, 10, 30, 60]) {
+        this.name = name;
+        this.help = help;
+        this.labelNames = labelNames;
+        this.buckets = [...buckets, Number.POSITIVE_INFINITY].sort((a, b) => a - b);
+    }
+    observe(labels, value) {
+        let key = this.labelsToKey(labels);
+        let effectiveLabels = labels;
+        if (!this.values.has(key) && this.values.size >= MAX_SERIES_PER_METRIC) {
+            effectiveLabels = overflowLabels(this.labelNames);
+            key = this.labelsToKey(effectiveLabels);
+        }
+        let existing = this.values.get(key);
+        if (!existing) {
+            existing = {
+                buckets: this.buckets.map((le) => ({ le, count: 0 })),
+                sum: 0,
+                count: 0,
+                labels: effectiveLabels,
+            };
+            this.values.set(key, existing);
+        }
+        existing.sum += value;
+        existing.count++;
+        for (const bucket of existing.buckets) {
+            if (value <= bucket.le) {
+                bucket.count++;
+            }
+        }
+    }
+    labelsToKey(labels) {
+        return this.labelNames
+            .map((name) => `${name}=${labels[name] || ""}`)
+            .join(",");
+    }
+    toPrometheus() {
+        const lines = [];
+        lines.push(`# HELP ${this.name} ${this.help}`);
+        lines.push(`# TYPE ${this.name} histogram`);
+        for (const value of this.values.values()) {
+            const labelStr = Object.entries(value.labels)
+                .map(([k, v]) => `${k}="${v}"`)
+                .join(",");
+            const labelPrefix = labelStr ? `${labelStr},` : "";
+            for (const bucket of value.buckets) {
+                const le = bucket.le === Number.POSITIVE_INFINITY
+                    ? "+Inf"
+                    : bucket.le.toString();
+                lines.push(`${this.name}_bucket{${labelPrefix}le="${le}"} ${bucket.count}`);
+            }
+            lines.push(`${this.name}_sum{${labelStr}} ${value.sum}`);
+            lines.push(`${this.name}_count{${labelStr}} ${value.count}`);
+        }
+        return lines.join("\n");
+    }
+}
+export const workflowDuration = new Histogram("workflow_duration_seconds", "Workflow execution duration in seconds", ["workflow_id", "status"], [0.1, 0.5, 1, 5, 10, 30, 60, 120, 300]);
+export const nodeExecutions = new Counter("workflow_node_executions_total", "Total number of node executions", ["workflow_id", "node_id", "node_type", "status"]);
+export const nodeRetries = new Counter("workflow_node_retries_total", "Total number of node retries", ["workflow_id", "node_id"]);
+export const nodeDuration = new Histogram("workflow_node_duration_seconds", "Node execution duration in seconds", ["workflow_id", "node_id", "node_type"], [0.01, 0.05, 0.1, 0.5, 1, 5, 10, 30, 60]);
+export const activeInstances = new Gauge("workflow_active_instances", "Number of currently active workflow instances", ["workflow_id", "status"]);
+export const eventsWaiting = new Gauge("workflow_events_waiting", "Number of events currently being waited for", ["workflow_id"]);
+export const totalInstances = new Counter("workflow_instances_total", "Total number of workflow instances created", ["workflow_id", "status"]);
+export const eventProcessed = new Counter("workflow_events_processed_total", "Total number of events processed", ["event_type", "status"]);
+export const apiRequests = new Counter("workflow_api_requests_total", "Total number of API requests", ["method", "path", "status"]);
+export const apiLatency = new Histogram("workflow_api_latency_seconds", "API request latency in seconds", ["method", "path"], [0.01, 0.05, 0.1, 0.5, 1, 5]);
+export const llmCacheEvents = new Counter("llm_cache_events_total", "Total number of LLM cache lookups by result", ["provider", "model", "result"]);
+export const llmTokens = new Counter("llm_tokens_total", "Total number of LLM tokens consumed", ["provider", "model", "type"]);
+export const llmCostUsd = new Counter("llm_cost_usd_total", "Total LLM cost in USD", ["provider", "model"]);
+export const memoryUsage = new Gauge("nodejs_memory_usage_bytes", "Node.js memory usage", ["type"]);
+export const eventLoopLag = new Gauge("nodejs_eventloop_lag_seconds", "Node.js event loop lag");
+export const webhookDeliveryCleanupRuns = new Counter("webhook_delivery_cleanup_runs_total", "Total number of webhook delivery cleanup runs", ["result", "mode"]);
+export const webhookDeliveryCleanupRemoved = new Counter("webhook_delivery_cleanup_removed_total", "Total number of webhook delivery records removed by cleanup", ["mode"]);
+export const webhookDeliveryCleanupDuration = new Histogram("webhook_delivery_cleanup_duration_seconds", "Webhook delivery cleanup duration in seconds", ["result", "mode"], [0.001, 0.01, 0.05, 0.1, 0.5, 1, 5, 10]);
+export const webhookDeliveryCleanupLastRun = new Gauge("webhook_delivery_cleanup_last_run_timestamp_seconds", "Unix timestamp of the most recent webhook delivery cleanup run", ["result", "mode"]);
+export const webhookDeliveryCleanupLastSuccess = new Gauge("webhook_delivery_cleanup_last_success_timestamp_seconds", "Unix timestamp of the most recent successful webhook delivery cleanup run", ["mode"]);
+export function collectSystemMetrics() {
+    const mem = process.memoryUsage();
+    memoryUsage.set({ type: "heapTotal" }, mem.heapTotal);
+    memoryUsage.set({ type: "heapUsed" }, mem.heapUsed);
+    memoryUsage.set({ type: "rss" }, mem.rss);
+    memoryUsage.set({ type: "external" }, mem.external);
+}
+export function getMetrics() {
+    collectSystemMetrics();
+    const metrics = [
+        workflowDuration,
+        nodeExecutions,
+        nodeRetries,
+        nodeDuration,
+        activeInstances,
+        eventsWaiting,
+        totalInstances,
+        eventProcessed,
+        apiRequests,
+        apiLatency,
+        llmCacheEvents,
+        llmTokens,
+        llmCostUsd,
+        memoryUsage,
+        eventLoopLag,
+        webhookDeliveryCleanupRuns,
+        webhookDeliveryCleanupRemoved,
+        webhookDeliveryCleanupDuration,
+        webhookDeliveryCleanupLastRun,
+        webhookDeliveryCleanupLastSuccess,
+    ];
+    return metrics.map((m) => m.toPrometheus()).join("\n\n");
+}
+export function recordWorkflowStart(workflowId, status = "running") {
+    activeInstances.inc({ workflow_id: workflowId, status });
+    totalInstances.inc({ workflow_id: workflowId, status: "started" });
+}
+export function recordWorkflowComplete(workflowId, status, durationSeconds) {
+    activeInstances.dec({ workflow_id: workflowId, status: "running" });
+    totalInstances.inc({ workflow_id: workflowId, status });
+    workflowDuration.observe({ workflow_id: workflowId, status }, durationSeconds);
+}
+export function recordNodeExecution(workflowId, nodeId, nodeType, status, durationSeconds) {
+    nodeExecutions.inc({
+        workflow_id: workflowId,
+        node_id: nodeId,
+        node_type: nodeType,
+        status,
+    });
+    if (durationSeconds !== undefined) {
+        nodeDuration.observe({ workflow_id: workflowId, node_id: nodeId, node_type: nodeType }, durationSeconds);
+    }
+}
+export function recordNodeRetry(workflowId, nodeId) {
+    nodeRetries.inc({ workflow_id: workflowId, node_id: nodeId });
+}
+export function recordEventWaitStart(workflowId) {
+    eventsWaiting.inc({ workflow_id: workflowId });
+}
+export function recordEventWaitEnd(workflowId) {
+    eventsWaiting.dec({ workflow_id: workflowId });
+}
+export function recordEventProcessed(eventType, status) {
+    eventProcessed.inc({ event_type: eventType, status });
+}
+export function recordApiRequest(method, path, status, durationSeconds) {
+    apiRequests.inc({ method, path, status: status.toString() });
+    apiLatency.observe({ method, path }, durationSeconds);
+}
+export function recordLlmCacheEvent(provider, model, result) {
+    llmCacheEvents.inc({ provider, model, result });
+}
+export function recordLlmUsage(provider, model, inputTokens, outputTokens, costUsd) {
+    if (inputTokens > 0) {
+        llmTokens.inc({ provider, model, type: "input" }, inputTokens);
+    }
+    if (outputTokens > 0) {
+        llmTokens.inc({ provider, model, type: "output" }, outputTokens);
+    }
+    if (costUsd > 0) {
+        llmCostUsd.inc({ provider, model }, costUsd);
+    }
+}
+export function recordWebhookDeliveryCleanup(result, mode, durationSeconds, removedCount = 0) {
+    webhookDeliveryCleanupRuns.inc({ result, mode });
+    webhookDeliveryCleanupDuration.observe({ result, mode }, durationSeconds);
+    webhookDeliveryCleanupLastRun.set({ result, mode }, Date.now() / 1000);
+    if (removedCount > 0) {
+        webhookDeliveryCleanupRemoved.inc({ mode }, removedCount);
+    }
+    if (result === "success") {
+        webhookDeliveryCleanupLastSuccess.set({ mode }, Date.now() / 1000);
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/src/model/Instance.d.ts

@@ -0,0 +1,38 @@
+export type InstanceStatus = "pending" | "running" | "completed" | "failed" | "rollback" | "paused" | "cancelled";
+export interface WorkflowInstance {
+    instanceId: string;
+    workflowId: string;
+    workflowVersion?: string;
+    currentNodes: string[];
+    status: InstanceStatus;
+    context: Record<string, any>;
+    history: ExecutionLog[];
+    createdAt: Date;
+    updatedAt: Date;
+    retries?: Record<string, number>;
+    maxRetriesReached?: boolean;
+    traceId?: string;
+    parentInstanceId?: string;
+    triggeredBy?: "api" | "event" | "cron" | "subworkflow";
+    state?: {
+        nodes?: Record<string, {
+            output?: unknown;
+            deadline?: number;
+        }>;
+    };
+    searchAttributes?: Record<string, string | number | boolean>;
+    continuedFromInstanceId?: string;
+    version?: number;
+    tenantId?: string;
+}
+export interface ExecutionLog {
+    nodeId: string;
+    timestamp: Date;
+    status: "started" | "success" | "failed" | "rollback" | "skipped";
+    error?: string;
+    data?: Record<string, unknown> | unknown;
+    duration?: number;
+    stack?: string;
+}
+export declare function getMaxInstanceHistory(): number;
+export declare function appendHistory(instance: WorkflowInstance, entry: ExecutionLog): void;

package/dist/src/model/Instance.js

@@ -0,0 +1,12 @@
+import { parseEnvInt } from "../utils/env.js";
+export function getMaxInstanceHistory() {
+    return parseEnvInt(process.env.MAX_INSTANCE_HISTORY, 1000, { min: 1 });
+}
+export function appendHistory(instance, entry) {
+    instance.history.push(entry);
+    const max = getMaxInstanceHistory();
+    if (instance.history.length > max) {
+        instance.history.splice(0, instance.history.length - max);
+    }
+}
+//# sourceMappingURL=Instance.js.map

package/dist/src/model/Instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Instance.js","sourceRoot":"","sources":["../../../src/model/Instance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAwE3C,MAAM,UAAU,qBAAqB;IACnC,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;AACzE,CAAC;AAOD,MAAM,UAAU,aAAa,CAC3B,QAA0B,EAC1B,KAAmB;IAEnB,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE7B,MAAM,GAAG,GAAG,qBAAqB,EAAE,CAAC;IACpC,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAClC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/src/model/RetryPolicy.d.ts

@@ -0,0 +1,11 @@
+export interface RetryPolicy {
+    initialInterval?: number;
+    backoffCoefficient?: number;
+    maximumInterval?: number;
+    maximumAttempts?: number;
+    nonRetryableErrors?: string[];
+}
+export declare const DEFAULT_RETRY_POLICY: Required<RetryPolicy>;
+export declare function calculateRetryDelay(attempt: number, policy: RetryPolicy): number;
+export declare function isRetryableError(error: Error, policy: RetryPolicy): boolean;
+export declare function shouldRetry(attempt: number, policy: RetryPolicy): boolean;

package/dist/src/model/RetryPolicy.js

@@ -0,0 +1,30 @@
+export const DEFAULT_RETRY_POLICY = {
+    initialInterval: 1000,
+    backoffCoefficient: 2.0,
+    maximumInterval: 100000,
+    maximumAttempts: 0,
+    nonRetryableErrors: [],
+};
+export function calculateRetryDelay(attempt, policy) {
+    const initialInterval = policy.initialInterval ?? DEFAULT_RETRY_POLICY.initialInterval;
+    const backoffCoefficient = policy.backoffCoefficient ?? DEFAULT_RETRY_POLICY.backoffCoefficient;
+    const maximumInterval = policy.maximumInterval ?? DEFAULT_RETRY_POLICY.maximumInterval;
+    const delay = initialInterval * backoffCoefficient ** attempt;
+    return Math.min(delay, maximumInterval);
+}
+export function isRetryableError(error, policy) {
+    const nonRetryableErrors = policy.nonRetryableErrors ?? [];
+    if (nonRetryableErrors.length === 0) {
+        return true;
+    }
+    const errorType = error.constructor.name;
+    return !nonRetryableErrors.some((nonRetryable) => errorType === nonRetryable || error.message.includes(nonRetryable));
+}
+export function shouldRetry(attempt, policy) {
+    const maximumAttempts = policy.maximumAttempts ?? DEFAULT_RETRY_POLICY.maximumAttempts;
+    if (maximumAttempts === 0) {
+        return true;
+    }
+    return attempt < maximumAttempts;
+}
+//# sourceMappingURL=RetryPolicy.js.map

package/dist/src/model/RetryPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryPolicy.js","sourceRoot":"","sources":["../../../src/model/RetryPolicy.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD,eAAe,EAAE,IAAI;IACrB,kBAAkB,EAAE,GAAG;IACvB,eAAe,EAAE,MAAM;IACvB,eAAe,EAAE,CAAC;IAClB,kBAAkB,EAAE,EAAE;CACvB,CAAC;AAEF,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,MAAmB;IAEnB,MAAM,eAAe,GACnB,MAAM,CAAC,eAAe,IAAI,oBAAoB,CAAC,eAAe,CAAC;IACjE,MAAM,kBAAkB,GACtB,MAAM,CAAC,kBAAkB,IAAI,oBAAoB,CAAC,kBAAkB,CAAC;IACvE,MAAM,eAAe,GACnB,MAAM,CAAC,eAAe,IAAI,oBAAoB,CAAC,eAAe,CAAC;IAEjE,MAAM,KAAK,GAAG,eAAe,GAAG,kBAAkB,IAAI,OAAO,CAAC;IAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAY,EAAE,MAAmB;IAChE,MAAM,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,IAAI,EAAE,CAAC;IAC3D,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;IACzC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAC7B,CAAC,YAAY,EAAE,EAAE,CACf,SAAS,KAAK,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CACrE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,MAAmB;IAC9D,MAAM,eAAe,GACnB,MAAM,CAAC,eAAe,IAAI,oBAAoB,CAAC,eAAe,CAAC;IACjE,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,GAAG,eAAe,CAAC;AACnC,CAAC"}

package/dist/src/model/Schedule.d.ts

@@ -0,0 +1,34 @@
+export type OverlapPolicy = "skip" | "buffer_one" | "buffer_all" | "cancel_other" | "terminate_other" | "allow_all";
+export interface TimeWindow {
+    start: string;
+    end: string;
+}
+export interface ScheduleSpec {
+    interval?: string;
+    startTime?: Date;
+    endTime?: Date;
+    jitter?: number;
+    timezone?: string;
+    timeWindow?: TimeWindow;
+}
+export interface SchedulePolicy {
+    overlap?: OverlapPolicy;
+    catchupWindow?: number;
+    pauseOnFailure?: boolean;
+    maxActions?: number;
+}
+export interface Schedule {
+    id: string;
+    workflowId: string;
+    spec: ScheduleSpec;
+    policy?: SchedulePolicy;
+    paused?: boolean;
+    notes?: string;
+    lastActionTime?: Date;
+    lastCompletionResult?: any;
+    lastFailure?: any;
+}
+export declare const DEFAULT_SCHEDULE_POLICY: Required<SchedulePolicy>;
+export declare function shouldRunAction(policy: SchedulePolicy, runningCount: number): boolean;
+export declare function calculateJitter(jitter: number): number;
+export declare function isInTimeWindow(spec: ScheduleSpec, now?: Date): boolean;

package/dist/src/model/Schedule.js

@@ -0,0 +1,50 @@
+export const DEFAULT_SCHEDULE_POLICY = {
+    overlap: "skip",
+    catchupWindow: 86400000,
+    pauseOnFailure: false,
+    maxActions: 0,
+};
+export function shouldRunAction(policy, runningCount) {
+    const effectivePolicy = { ...DEFAULT_SCHEDULE_POLICY, ...policy };
+    const { overlap, maxActions } = effectivePolicy;
+    if (maxActions > 0 && runningCount >= maxActions) {
+        return false;
+    }
+    switch (overlap) {
+        case "skip":
+            return runningCount === 0;
+        case "buffer_one":
+        case "buffer_all":
+        case "cancel_other":
+        case "terminate_other":
+            return true;
+        case "allow_all":
+            return true;
+        default:
+            return runningCount === 0;
+    }
+}
+export function calculateJitter(jitter) {
+    return Math.floor(Math.random() * jitter);
+}
+export function isInTimeWindow(spec, now = new Date()) {
+    if (spec.startTime && now < spec.startTime) {
+        return false;
+    }
+    if (spec.endTime && now > spec.endTime) {
+        return false;
+    }
+    if (spec.timeWindow) {
+        const { start, end } = spec.timeWindow;
+        const [startHour, startMin] = start.split(":").map(Number);
+        const [endHour, endMin] = end.split(":").map(Number);
+        const nowMinutes = now.getHours() * 60 + now.getMinutes();
+        const startMinutes = startHour * 60 + startMin;
+        const endMinutes = endHour * 60 + endMin;
+        if (nowMinutes < startMinutes || nowMinutes > endMinutes) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=Schedule.js.map

package/dist/src/model/Schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schedule.js","sourceRoot":"","sources":["../../../src/model/Schedule.ts"],"names":[],"mappings":"AAkDA,MAAM,CAAC,MAAM,uBAAuB,GAA6B;IAC/D,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,cAAc,EAAE,KAAK;IACrB,UAAU,EAAE,CAAC;CACd,CAAC;AAEF,MAAM,UAAU,eAAe,CAC7B,MAAsB,EACtB,YAAoB;IAEpB,MAAM,eAAe,GAAG,EAAE,GAAG,uBAAuB,EAAE,GAAG,MAAM,EAAE,CAAC;IAClE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,eAAe,CAAC;IAEhD,IAAI,UAAU,GAAG,CAAC,IAAI,YAAY,IAAI,UAAU,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,YAAY,KAAK,CAAC,CAAC;QAC5B,KAAK,YAAY,CAAC;QAClB,KAAK,YAAY,CAAC;QAClB,KAAK,cAAc,CAAC;QACpB,KAAK,iBAAiB;YACpB,OAAO,IAAI,CAAC;QACd,KAAK,WAAW;YACd,OAAO,IAAI,CAAC;QACd;YACE,OAAO,YAAY,KAAK,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAkB,EAClB,MAAY,IAAI,IAAI,EAAE;IAEtB,IAAI,IAAI,CAAC,SAAS,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QACvC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAC1D,MAAM,YAAY,GAAG,SAAS,GAAG,EAAE,GAAG,QAAQ,CAAC;QAC/C,MAAM,UAAU,GAAG,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC;QACzC,IAAI,UAAU,GAAG,YAAY,IAAI,UAAU,GAAG,UAAU,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/model/Workflow.d.ts

@@ -0,0 +1,73 @@
+export type TaskType = "action" | "wait" | "event" | "rollback" | "subworkflow" | "http" | "sql" | "queue" | "condition" | "router" | "loop" | "approval" | "notification" | "join" | "transform";
+import type { WorkflowInstance } from "./Instance.js";
+import type { RetryPolicy } from "./RetryPolicy.js";
+export type WorkflowActionFn = (instance: WorkflowInstance) => Promise<unknown>;
+export interface ActionNodeConfig {
+    action?: string;
+}
+export interface TaskNode {
+    id: string;
+    type: TaskType;
+    action?: WorkflowActionFn;
+    timeout?: number;
+    next?: string[];
+    onEvent?: string;
+    rollbackTo?: string;
+    failureNext?: string[];
+    maxRetries?: number;
+    retryPolicy?: RetryPolicy;
+    heartbeat?: {
+        interval?: number;
+        timeout?: number;
+        onHeartbeat?: (details: unknown) => void;
+    };
+    conditionalNext?: Array<{
+        condition: string;
+        target: string;
+    }>;
+    defaultNext?: string;
+    subworkflowId?: string;
+    subworkflowInput?: Record<string, string>;
+    waitForCompletion?: boolean;
+    output?: unknown;
+    config?: Record<string, unknown>;
+    taskQueue?: string;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+export interface WorkflowDefinition {
+    id: string;
+    name: string;
+    version?: string;
+    description?: string;
+    nodes: Record<string, TaskNode>;
+    startNode: string;
+    cron?: string;
+    triggerEvents?: string[];
+    metadata?: Record<string, unknown>;
+    createdAt?: Date;
+    updatedAt?: Date;
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+}
+export interface ApprovalNodeConfig {
+    eventType?: string;
+    prompt?: string;
+    approvedTarget?: string;
+    rejectedTarget?: string;
+    timeoutMs?: number;
+    requireInstanceIdMatch?: boolean;
+}
+export interface NotificationNodeConfig {
+    channel: "slack" | "feishu" | "dingtalk" | "email" | "webhook" | string;
+    target: string;
+    template: string;
+    subject?: string;
+    severity?: "info" | "warning" | "critical";
+    data?: Record<string, unknown>;
+}
+export interface WaitNodeConfig {
+    durationMs?: number;
+    until?: string;
+    durable?: boolean;
+}