@orbytautomation/engine 0.1.0

package/dist/automation/TimeoutManager.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Timeout Manager
+ *
+ * Manages execution timeouts for operations and steps.
+ * Provides timeout enforcement, parsing, and cleanup handling.
+ *
+ * @module automation
+ */
+/**
+ * Timeout error
+ */
+export declare class TimeoutError extends Error {
+    readonly timeoutMs: number;
+    readonly operation?: string | undefined;
+    constructor(message: string, timeoutMs: number, operation?: string | undefined);
+}
+/**
+ * Timeout configuration
+ */
+export interface TimeoutConfig {
+    /** Timeout duration in milliseconds */
+    timeoutMs: number;
+    /** Operation name for error messages */
+    operation?: string;
+    /** Cleanup function to run on timeout */
+    onTimeout?: () => Promise<void> | void;
+    /** Whether to run cleanup before throwing (default: true) */
+    cleanupBeforeThrow?: boolean;
+}
+/**
+ * Timeout result
+ */
+export interface TimeoutResult<T> {
+    /** Operation result (undefined if timed out) */
+    result?: T;
+    /** Whether operation timed out */
+    timedOut: boolean;
+    /** Actual duration in milliseconds */
+    durationMs: number;
+    /** Timeout error if timed out */
+    error?: TimeoutError;
+}
+/**
+ * Timeout manager for execution control
+ */
+export declare class TimeoutManager {
+    /**
+     * Execute operation with timeout
+     *
+     * @param operation - Async operation to execute
+     * @param config - Timeout configuration
+     * @returns Operation result
+     * @throws TimeoutError if operation times out
+     */
+    static execute<T>(operation: () => Promise<T>, config: TimeoutConfig): Promise<T>;
+    /**
+     * Execute operation with timeout (non-throwing version)
+     * Returns result object indicating success or timeout
+     *
+     * @param operation - Async operation to execute
+     * @param config - Timeout configuration
+     * @returns Timeout result
+     */
+    static executeWithResult<T>(operation: () => Promise<T>, config: TimeoutConfig): Promise<TimeoutResult<T>>;
+    /**
+     * Parse timeout string to milliseconds
+     *
+     * Supported formats:
+     * - "30s" -> 30000ms
+     * - "5m" -> 300000ms
+     * - "2h" -> 7200000ms
+     * - "1000" -> 1000ms (raw number)
+     *
+     * @param timeoutStr - Timeout string
+     * @returns Timeout in milliseconds
+     * @throws Error if format is invalid
+     */
+    static parseTimeout(timeoutStr: string): number;
+    /**
+     * Format milliseconds to human-readable string
+     *
+     * @param ms - Milliseconds
+     * @returns Formatted string (e.g., "30s", "5m")
+     */
+    static formatTimeout(ms: number): string;
+    /**
+     * Create timeout config from timeout string
+     *
+     * @param timeoutStr - Timeout string (e.g., "30s")
+     * @param operation - Operation name
+     * @param onTimeout - Cleanup function
+     * @returns Timeout configuration
+     */
+    static createConfig(timeoutStr: string, operation?: string, onTimeout?: () => Promise<void> | void): TimeoutConfig;
+    /**
+     * Create abort controller with timeout
+     * Useful for cancellable operations
+     *
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns Abort controller that aborts after timeout
+     */
+    static createAbortController(timeoutMs: number): AbortController;
+    /**
+     * Check if error is a timeout error
+     *
+     * @param error - Error to check
+     * @returns True if timeout error
+     */
+    static isTimeoutError(error: unknown): error is TimeoutError;
+    /**
+     * Validate timeout value
+     *
+     * @param timeoutMs - Timeout in milliseconds
+     * @param min - Minimum allowed timeout
+     * @param max - Maximum allowed timeout
+     * @throws Error if timeout is invalid
+     */
+    static validateTimeout(timeoutMs: number, min?: number, max?: number): void;
+}
+/**
+ * Predefined timeout configurations
+ */
+export declare const TimeoutConfigs: {
+    /** 10 second timeout */
+    readonly short: {
+        readonly timeoutMs: 10000;
+    };
+    /** 30 second timeout */
+    readonly standard: {
+        readonly timeoutMs: 30000;
+    };
+    /** 5 minute timeout */
+    readonly long: {
+        readonly timeoutMs: 300000;
+    };
+    /** 30 minute timeout */
+    readonly veryLong: {
+        readonly timeoutMs: 1800000;
+    };
+    /** No timeout (24 hours) */
+    readonly none: {
+        readonly timeoutMs: 86400000;
+    };
+};
+//# sourceMappingURL=TimeoutManager.d.ts.map

package/dist/automation/TimeoutManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeoutManager.d.ts","sourceRoot":"","sources":["../../src/automation/TimeoutManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGnB,SAAS,EAAE,MAAM;aACjB,SAAS,CAAC,EAAE,MAAM;gBAFlC,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,YAAA;CAKrC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEvC,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,gDAAgD;IAChD,MAAM,CAAC,EAAE,CAAC,CAAC;IAEX,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAElB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IAEnB,iCAAiC;IACjC,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;;;;OAOG;WACU,OAAO,CAAC,CAAC,EACpB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,CAAC,CAAC;IAwDb;;;;;;;OAOG;WACU,iBAAiB,CAAC,CAAC,EAC9B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAwB5B;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAiC/C;;;;;OAKG;IACH,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAaxC;;;;;;;OAOG;IACH,MAAM,CAAC,YAAY,CACjB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACrC,aAAa;IAQhB;;;;;;OAMG;IACH,MAAM,CAAC,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe;IAehE;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY;IAI5D;;;;;;;OAOG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAI,EAAE,GAAG,SAAW,GAAG,IAAI;CAQzE;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB,wBAAwB;;;;IAGxB,wBAAwB;;;;IAGxB,uBAAuB;;;;IAGvB,wBAAwB;;;;IAGxB,4BAA4B;;;;CAEpB,CAAC"}

package/dist/automation/TimeoutManager.js

@@ -0,0 +1,241 @@
+/**
+ * Timeout Manager
+ *
+ * Manages execution timeouts for operations and steps.
+ * Provides timeout enforcement, parsing, and cleanup handling.
+ *
+ * @module automation
+ */
+/**
+ * Timeout error
+ */
+export class TimeoutError extends Error {
+    timeoutMs;
+    operation;
+    constructor(message, timeoutMs, operation) {
+        super(message);
+        this.timeoutMs = timeoutMs;
+        this.operation = operation;
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Timeout manager for execution control
+ */
+export class TimeoutManager {
+    /**
+     * Execute operation with timeout
+     *
+     * @param operation - Async operation to execute
+     * @param config - Timeout configuration
+     * @returns Operation result
+     * @throws TimeoutError if operation times out
+     */
+    static async execute(operation, config) {
+        const startTime = Date.now();
+        const timeoutPromise = new Promise((_, reject) => {
+            const timeout = setTimeout(async () => {
+                const elapsedMs = Date.now() - startTime;
+                const error = new TimeoutError(config.operation
+                    ? `Operation "${config.operation}" timed out after ${config.timeoutMs}ms (elapsed: ${elapsedMs}ms)`
+                    : `Operation timed out after ${config.timeoutMs}ms (elapsed: ${elapsedMs}ms)`, config.timeoutMs, config.operation);
+                // Add timing metadata to error
+                error.timing = {
+                    timeoutMs: config.timeoutMs,
+                    elapsedMs,
+                    startTime,
+                };
+                // Run cleanup if configured
+                if (config.onTimeout && (config.cleanupBeforeThrow ?? true)) {
+                    try {
+                        await config.onTimeout();
+                    }
+                    catch (cleanupError) {
+                        console.error('Timeout cleanup failed:', cleanupError);
+                    }
+                }
+                reject(error);
+            }, config.timeoutMs);
+            // Ensure timeout is cleared if operation completes
+            timeout.unref?.();
+        });
+        try {
+            const result = await Promise.race([operation(), timeoutPromise]);
+            // Add successful execution time for monitoring
+            const executionTime = Date.now() - startTime;
+            if (result && typeof result === 'object' && result !== null) {
+                result.__executionTime = executionTime;
+            }
+            return result;
+        }
+        catch (error) {
+            // If it's our timeout error, re-throw
+            if (error instanceof TimeoutError) {
+                throw error;
+            }
+            // Otherwise, it's an error from the operation
+            throw error;
+        }
+    }
+    /**
+     * Execute operation with timeout (non-throwing version)
+     * Returns result object indicating success or timeout
+     *
+     * @param operation - Async operation to execute
+     * @param config - Timeout configuration
+     * @returns Timeout result
+     */
+    static async executeWithResult(operation, config) {
+        const startTime = Date.now();
+        try {
+            const result = await this.execute(operation, config);
+            return {
+                result,
+                timedOut: false,
+                durationMs: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            if (error instanceof TimeoutError) {
+                return {
+                    timedOut: true,
+                    durationMs: Date.now() - startTime,
+                    error,
+                };
+            }
+            // Re-throw non-timeout errors
+            throw error;
+        }
+    }
+    /**
+     * Parse timeout string to milliseconds
+     *
+     * Supported formats:
+     * - "30s" -> 30000ms
+     * - "5m" -> 300000ms
+     * - "2h" -> 7200000ms
+     * - "1000" -> 1000ms (raw number)
+     *
+     * @param timeoutStr - Timeout string
+     * @returns Timeout in milliseconds
+     * @throws Error if format is invalid
+     */
+    static parseTimeout(timeoutStr) {
+        const trimmed = timeoutStr.trim();
+        // Raw number (milliseconds)
+        if (/^\d+$/.test(trimmed)) {
+            return parseInt(trimmed, 10);
+        }
+        // Parse with unit
+        const match = /^(\d+(?:\.\d+)?)(ms|s|m|h)$/.exec(trimmed);
+        if (!match) {
+            throw new Error(`Invalid timeout format: "${timeoutStr}". Expected: "30s", "5m", "2h", or raw ms`);
+        }
+        const value = parseFloat(match[1]);
+        const unit = match[2];
+        switch (unit) {
+            case 'ms':
+                return value;
+            case 's':
+                return value * 1000;
+            case 'm':
+                return value * 60 * 1000;
+            case 'h':
+                return value * 60 * 60 * 1000;
+            default:
+                throw new Error(`Unknown time unit: ${unit}`);
+        }
+    }
+    /**
+     * Format milliseconds to human-readable string
+     *
+     * @param ms - Milliseconds
+     * @returns Formatted string (e.g., "30s", "5m")
+     */
+    static formatTimeout(ms) {
+        if (ms < 1000) {
+            return `${ms}ms`;
+        }
+        if (ms < 60000) {
+            return `${(ms / 1000).toFixed(1)}s`;
+        }
+        if (ms < 3600000) {
+            return `${(ms / 60000).toFixed(1)}m`;
+        }
+        return `${(ms / 3600000).toFixed(1)}h`;
+    }
+    /**
+     * Create timeout config from timeout string
+     *
+     * @param timeoutStr - Timeout string (e.g., "30s")
+     * @param operation - Operation name
+     * @param onTimeout - Cleanup function
+     * @returns Timeout configuration
+     */
+    static createConfig(timeoutStr, operation, onTimeout) {
+        return {
+            timeoutMs: this.parseTimeout(timeoutStr),
+            operation,
+            onTimeout,
+        };
+    }
+    /**
+     * Create abort controller with timeout
+     * Useful for cancellable operations
+     *
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns Abort controller that aborts after timeout
+     */
+    static createAbortController(timeoutMs) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => {
+            controller.abort();
+        }, timeoutMs);
+        // Clean up timeout if signal is aborted manually
+        controller.signal.addEventListener('abort', () => {
+            clearTimeout(timeout);
+        }, { once: true });
+        return controller;
+    }
+    /**
+     * Check if error is a timeout error
+     *
+     * @param error - Error to check
+     * @returns True if timeout error
+     */
+    static isTimeoutError(error) {
+        return error instanceof TimeoutError;
+    }
+    /**
+     * Validate timeout value
+     *
+     * @param timeoutMs - Timeout in milliseconds
+     * @param min - Minimum allowed timeout
+     * @param max - Maximum allowed timeout
+     * @throws Error if timeout is invalid
+     */
+    static validateTimeout(timeoutMs, min = 0, max = Infinity) {
+        if (timeoutMs < min) {
+            throw new Error(`Timeout must be >= ${min}ms, got: ${timeoutMs}ms`);
+        }
+        if (timeoutMs > max) {
+            throw new Error(`Timeout must be <= ${max}ms, got: ${timeoutMs}ms`);
+        }
+    }
+}
+/**
+ * Predefined timeout configurations
+ */
+export const TimeoutConfigs = {
+    /** 10 second timeout */
+    short: { timeoutMs: 10000 },
+    /** 30 second timeout */
+    standard: { timeoutMs: 30000 },
+    /** 5 minute timeout */
+    long: { timeoutMs: 300000 },
+    /** 30 minute timeout */
+    veryLong: { timeoutMs: 1800000 },
+    /** No timeout (24 hours) */
+    none: { timeoutMs: 86400000 },
+};
+//# sourceMappingURL=TimeoutManager.js.map

package/dist/automation/TimeoutManager.js.map

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

package/dist/automation/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Automation Layer
+ *
+ * Provides retry policies, backoff strategies, failure handling,
+ * and timeout management for reliable workflow execution.
+ *
+ * This is PHASE 2 of the Orbyt execution roadmap.
+ *
+ * @module automation
+ */
+export * from './BackoffStrategy.js';
+export * from './FailureStrategy.js';
+export * from './RetryPolicy.js';
+export * from './TimeoutManager.js';
+export * from './runtime/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/automation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/automation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/automation/index.js

@@ -0,0 +1,16 @@
+/**
+ * Automation Layer
+ *
+ * Provides retry policies, backoff strategies, failure handling,
+ * and timeout management for reliable workflow execution.
+ *
+ * This is PHASE 2 of the Orbyt execution roadmap.
+ *
+ * @module automation
+ */
+export * from './BackoffStrategy.js';
+export * from './FailureStrategy.js';
+export * from './RetryPolicy.js';
+export * from './TimeoutManager.js';
+export * from './runtime/index.js';
+//# sourceMappingURL=index.js.map

package/dist/automation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/automation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/automation/runtime/BackoffTimer.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Backoff Timer
+ *
+ * Runtime utility for implementing delays between retry attempts.
+ * Works with BackoffStrategy to execute actual wait operations.
+ *
+ * @module automation/runtime
+ */
+import { BackoffStrategy } from '../BackoffStrategy.js';
+/**
+ * Backoff timer for retry delays
+ */
+export declare class BackoffTimer {
+    /**
+     * Wait for delay calculated by backoff strategy
+     *
+     * @param strategy - Backoff strategy
+     * @param attempt - Current attempt number (1-indexed)
+     * @returns Promise that resolves after delay
+     */
+    static wait(strategy: BackoffStrategy, attempt: number): Promise<number>;
+    /**
+     * Sleep for specified milliseconds
+     *
+     * @param ms - Milliseconds to sleep
+     * @returns Promise that resolves after delay
+     */
+    static sleep(ms: number): Promise<void>;
+    /**
+     * Wait with cancellation support
+     *
+     * @param strategy - Backoff strategy
+     * @param attempt - Current attempt number
+     * @param signal - Abort signal for cancellation
+     * @returns Promise that resolves after delay or rejects if cancelled
+     */
+    static waitCancellable(strategy: BackoffStrategy, attempt: number, signal?: AbortSignal): Promise<number>;
+    /**
+     * Calculate total wait time for multiple attempts
+     *
+     * @param strategy - Backoff strategy
+     * @param attempts - Number of attempts
+     * @returns Total wait time in milliseconds
+     */
+    static calculateTotalWaitTime(strategy: BackoffStrategy, attempts: number): number;
+    /**
+     * Format delay for logging
+     *
+     * @param delayMs - Delay in milliseconds
+     * @returns Formatted string
+     */
+    static formatDelay(delayMs: number): string;
+    /**
+     * Wait with progress callback
+     * Useful for UI updates or logging
+     *
+     * @param strategy - Backoff strategy
+     * @param attempt - Current attempt number
+     * @param onProgress - Progress callback (current ms, total ms)
+     * @param progressIntervalMs - Interval for progress updates (default: 1000ms)
+     * @returns Promise that resolves after delay
+     */
+    static waitWithProgress(strategy: BackoffStrategy, attempt: number, onProgress: (elapsedMs: number, totalMs: number) => void, progressIntervalMs?: number): Promise<number>;
+    /**
+     * Execute function after backoff delay
+     *
+     * @param strategy - Backoff strategy
+     * @param attempt - Current attempt number
+     * @param fn - Function to execute after delay
+     * @returns Result of function execution
+     */
+    static waitAndExecute<T>(strategy: BackoffStrategy, attempt: number, fn: () => T | Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=BackoffTimer.d.ts.map

package/dist/automation/runtime/BackoffTimer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackoffTimer.d.ts","sourceRoot":"","sources":["../../../src/automation/runtime/BackoffTimer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;OAMG;WACU,IAAI,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW9E;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC;;;;;;;OAOG;WACU,eAAe,CAC1B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC;IAgClB;;;;;;OAMG;IACH,MAAM,CAAC,sBAAsB,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIlF;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAU3C;;;;;;;;;OASG;WACU,gBAAgB,CAC3B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,EACxD,kBAAkB,SAAO,GACxB,OAAO,CAAC,MAAM,CAAC;IA2BlB;;;;;;;OAOG;WACU,cAAc,CAAC,CAAC,EAC3B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC;CAId"}

package/dist/automation/runtime/BackoffTimer.js

@@ -0,0 +1,139 @@
+/**
+ * Backoff Timer
+ *
+ * Runtime utility for implementing delays between retry attempts.
+ * Works with BackoffStrategy to execute actual wait operations.
+ *
+ * @module automation/runtime
+ */
+/**
+ * Backoff timer for retry delays
+ */
+export class BackoffTimer {
+    /**
+     * Wait for delay calculated by backoff strategy
+     *
+     * @param strategy - Backoff strategy
+     * @param attempt - Current attempt number (1-indexed)
+     * @returns Promise that resolves after delay
+     */
+    static async wait(strategy, attempt) {
+        const delayMs = strategy.calculateDelay(attempt);
+        if (delayMs === 0) {
+            return 0;
+        }
+        await this.sleep(delayMs);
+        return delayMs;
+    }
+    /**
+     * Sleep for specified milliseconds
+     *
+     * @param ms - Milliseconds to sleep
+     * @returns Promise that resolves after delay
+     */
+    static sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Wait with cancellation support
+     *
+     * @param strategy - Backoff strategy
+     * @param attempt - Current attempt number
+     * @param signal - Abort signal for cancellation
+     * @returns Promise that resolves after delay or rejects if cancelled
+     */
+    static async waitCancellable(strategy, attempt, signal) {
+        const delayMs = strategy.calculateDelay(attempt);
+        if (delayMs === 0) {
+            return 0;
+        }
+        // Check if already aborted
+        if (signal?.aborted) {
+            throw new Error('Backoff cancelled');
+        }
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                cleanup();
+                resolve(delayMs);
+            }, delayMs);
+            const onAbort = () => {
+                cleanup();
+                reject(new Error('Backoff cancelled'));
+            };
+            const cleanup = () => {
+                clearTimeout(timeout);
+                signal?.removeEventListener('abort', onAbort);
+            };
+            signal?.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+    /**
+     * Calculate total wait time for multiple attempts
+     *
+     * @param strategy - Backoff strategy
+     * @param attempts - Number of attempts
+     * @returns Total wait time in milliseconds
+     */
+    static calculateTotalWaitTime(strategy, attempts) {
+        return strategy.getTotalDelay(attempts);
+    }
+    /**
+     * Format delay for logging
+     *
+     * @param delayMs - Delay in milliseconds
+     * @returns Formatted string
+     */
+    static formatDelay(delayMs) {
+        if (delayMs < 1000) {
+            return `${delayMs}ms`;
+        }
+        if (delayMs < 60000) {
+            return `${(delayMs / 1000).toFixed(1)}s`;
+        }
+        return `${(delayMs / 60000).toFixed(1)}m`;
+    }
+    /**
+     * Wait with progress callback
+     * Useful for UI updates or logging
+     *
+     * @param strategy - Backoff strategy
+     * @param attempt - Current attempt number
+     * @param onProgress - Progress callback (current ms, total ms)
+     * @param progressIntervalMs - Interval for progress updates (default: 1000ms)
+     * @returns Promise that resolves after delay
+     */
+    static async waitWithProgress(strategy, attempt, onProgress, progressIntervalMs = 1000) {
+        const totalMs = strategy.calculateDelay(attempt);
+        if (totalMs === 0) {
+            return 0;
+        }
+        const startTime = Date.now();
+        return new Promise(resolve => {
+            const progressInterval = setInterval(() => {
+                const elapsed = Date.now() - startTime;
+                onProgress(Math.min(elapsed, totalMs), totalMs);
+                if (elapsed >= totalMs) {
+                    clearInterval(progressInterval);
+                }
+            }, progressIntervalMs);
+            setTimeout(() => {
+                clearInterval(progressInterval);
+                onProgress(totalMs, totalMs);
+                resolve(totalMs);
+            }, totalMs);
+        });
+    }
+    /**
+     * Execute function after backoff delay
+     *
+     * @param strategy - Backoff strategy
+     * @param attempt - Current attempt number
+     * @param fn - Function to execute after delay
+     * @returns Result of function execution
+     */
+    static async waitAndExecute(strategy, attempt, fn) {
+        await this.wait(strategy, attempt);
+        return fn();
+    }
+}
+//# sourceMappingURL=BackoffTimer.js.map

package/dist/automation/runtime/BackoffTimer.js.map

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