@defai.digital/workflow-engine 13.0.3

package/dist/loader.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Workflow Loader
+ *
+ * Loads workflow definitions from YAML/JSON files.
+ * Similar to AgentLoader but for workflow files.
+ *
+ * Invariants:
+ * - INV-WF-LDR-001: All loaded workflows must pass schema validation
+ * - INV-WF-LDR-002: File extensions must match configured extensions
+ * - INV-WF-LDR-003: Workflow IDs must be unique across all loaded files
+ */
+import { type Workflow } from '@defai.digital/contracts';
+/**
+ * Workflow loader configuration
+ */
+export interface WorkflowLoaderConfig {
+    /**
+     * Directory containing workflow files
+     */
+    workflowsDir: string;
+    /**
+     * File extensions to load (default: ['.yaml', '.yml', '.json'])
+     */
+    extensions?: string[];
+    /**
+     * Watch for file changes (default: false)
+     */
+    watch?: boolean;
+}
+/**
+ * Workflow loader interface
+ */
+export interface WorkflowLoader {
+    /**
+     * Load a workflow by ID
+     */
+    load(workflowId: string): Promise<Workflow | undefined>;
+    /**
+     * Load all workflows from the directory
+     */
+    loadAll(): Promise<Workflow[]>;
+    /**
+     * Check if a workflow exists
+     */
+    exists(workflowId: string): Promise<boolean>;
+    /**
+     * Reload all workflows
+     */
+    reload(): Promise<void>;
+    /**
+     * Get workflow count
+     */
+    count(): number;
+}
+/**
+ * Workflow info for listing (lightweight representation)
+ */
+export interface WorkflowInfo {
+    id: string;
+    name: string;
+    version: string;
+    description: string | undefined;
+    stepCount: number;
+    status: 'active' | 'inactive' | 'draft';
+    filePath: string;
+}
+/**
+ * Loads workflow definitions from the file system
+ */
+export declare class FileSystemWorkflowLoader implements WorkflowLoader {
+    private readonly config;
+    private cache;
+    private filePathMap;
+    private loaded;
+    constructor(config: WorkflowLoaderConfig);
+    /**
+     * Load a workflow by ID
+     */
+    load(workflowId: string): Promise<Workflow | undefined>;
+    /**
+     * Load all workflows from the directory
+     */
+    loadAll(): Promise<Workflow[]>;
+    /**
+     * Check if a workflow exists
+     */
+    exists(workflowId: string): Promise<boolean>;
+    /**
+     * Reload all workflows
+     */
+    reload(): Promise<void>;
+    /**
+     * Get workflow count
+     */
+    count(): number;
+    /**
+     * Get all workflow infos (lightweight listing)
+     */
+    listAll(): Promise<WorkflowInfo[]>;
+    /**
+     * Get file path for a workflow
+     */
+    getFilePath(workflowId: string): string | undefined;
+    /**
+     * Load a single workflow from a file
+     */
+    private loadFile;
+    /**
+     * Infer workflow status from metadata
+     */
+    private inferStatus;
+}
+/**
+ * Creates a file system workflow loader
+ */
+export declare function createWorkflowLoader(config: WorkflowLoaderConfig): FileSystemWorkflowLoader;
+/**
+ * Default workflow directories to search
+ */
+export declare const DEFAULT_WORKFLOW_DIRS: string[];
+/**
+ * Finds the first existing workflow directory
+ */
+export declare function findWorkflowDir(basePath: string): string | undefined;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAMzE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IAExD;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE/B;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7C;;OAEG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;OAEG;IACH,KAAK,IAAI,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD;;GAEG;AACH,qBAAa,wBAAyB,YAAW,cAAc;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,oBAAoB;IAQxC;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAO7D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkDpC;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOlD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAsBxC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAInD;;OAEG;YACW,QAAQ;IA6BtB;;OAEG;IACH,OAAO,CAAC,WAAW;CAapB;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG,wBAAwB,CAE3F;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAIjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQpE"}

package/dist/loader.js

@@ -0,0 +1,213 @@
+/**
+ * Workflow Loader
+ *
+ * Loads workflow definitions from YAML/JSON files.
+ * Similar to AgentLoader but for workflow files.
+ *
+ * Invariants:
+ * - INV-WF-LDR-001: All loaded workflows must pass schema validation
+ * - INV-WF-LDR-002: File extensions must match configured extensions
+ * - INV-WF-LDR-003: Workflow IDs must be unique across all loaded files
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { WorkflowSchema } from '@defai.digital/contracts';
+// ============================================================================
+// Constants
+// ============================================================================
+const DEFAULT_EXTENSIONS = ['.yaml', '.yml', '.json'];
+// ============================================================================
+// File System Workflow Loader
+// ============================================================================
+/**
+ * Loads workflow definitions from the file system
+ */
+export class FileSystemWorkflowLoader {
+    config;
+    cache = new Map();
+    filePathMap = new Map();
+    loaded = false;
+    constructor(config) {
+        this.config = {
+            workflowsDir: config.workflowsDir,
+            extensions: config.extensions ?? DEFAULT_EXTENSIONS,
+            watch: config.watch ?? false,
+        };
+    }
+    /**
+     * Load a workflow by ID
+     */
+    async load(workflowId) {
+        if (!this.loaded) {
+            await this.loadAll();
+        }
+        return this.cache.get(workflowId);
+    }
+    /**
+     * Load all workflows from the directory
+     */
+    async loadAll() {
+        this.cache.clear();
+        this.filePathMap.clear();
+        const dirPath = this.config.workflowsDir;
+        // Check if directory exists
+        if (!fs.existsSync(dirPath)) {
+            this.loaded = true;
+            return [];
+        }
+        const files = fs.readdirSync(dirPath);
+        const workflows = [];
+        for (const file of files) {
+            const ext = path.extname(file).toLowerCase();
+            if (!this.config.extensions.includes(ext)) {
+                continue;
+            }
+            const filePath = path.join(dirPath, file);
+            // Skip directories
+            const stat = fs.statSync(filePath);
+            if (stat.isDirectory()) {
+                continue;
+            }
+            const workflow = await this.loadFile(filePath);
+            if (workflow) {
+                // INV-WF-LDR-003: Check for duplicate workflow IDs
+                if (this.cache.has(workflow.workflowId)) {
+                    console.warn(`Duplicate workflow ID "${workflow.workflowId}" found in ${file}, skipping`);
+                    continue;
+                }
+                this.cache.set(workflow.workflowId, workflow);
+                this.filePathMap.set(workflow.workflowId, filePath);
+                workflows.push(workflow);
+            }
+        }
+        this.loaded = true;
+        return workflows;
+    }
+    /**
+     * Check if a workflow exists
+     */
+    async exists(workflowId) {
+        if (!this.loaded) {
+            await this.loadAll();
+        }
+        return this.cache.has(workflowId);
+    }
+    /**
+     * Reload all workflows
+     */
+    async reload() {
+        this.loaded = false;
+        await this.loadAll();
+    }
+    /**
+     * Get workflow count
+     */
+    count() {
+        return this.cache.size;
+    }
+    /**
+     * Get all workflow infos (lightweight listing)
+     */
+    async listAll() {
+        if (!this.loaded) {
+            await this.loadAll();
+        }
+        const infos = [];
+        for (const [workflowId, workflow] of this.cache) {
+            infos.push({
+                id: workflowId,
+                name: workflow.name ?? workflowId,
+                version: workflow.version,
+                description: workflow.description,
+                stepCount: workflow.steps.length,
+                status: this.inferStatus(workflow),
+                filePath: this.filePathMap.get(workflowId) ?? '',
+            });
+        }
+        return infos;
+    }
+    /**
+     * Get file path for a workflow
+     */
+    getFilePath(workflowId) {
+        return this.filePathMap.get(workflowId);
+    }
+    /**
+     * Load a single workflow from a file
+     */
+    async loadFile(filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const ext = path.extname(filePath).toLowerCase();
+            let data;
+            if (ext === '.json') {
+                data = JSON.parse(content);
+            }
+            else {
+                data = parseYaml(content);
+            }
+            // INV-WF-LDR-001: Validate against schema
+            const result = WorkflowSchema.safeParse(data);
+            if (!result.success) {
+                const errors = result.error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ');
+                console.warn(`Invalid workflow in ${filePath}: ${errors}`);
+                return undefined;
+            }
+            return result.data;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            console.warn(`Failed to load workflow from ${filePath}: ${message}`);
+            return undefined;
+        }
+    }
+    /**
+     * Infer workflow status from metadata
+     */
+    inferStatus(workflow) {
+        // Check metadata for explicit status
+        const metadata = workflow.metadata;
+        if (metadata?.status === 'inactive')
+            return 'inactive';
+        if (metadata?.status === 'draft')
+            return 'draft';
+        // Check if name contains draft indicator
+        if (workflow.name?.toLowerCase().includes('draft'))
+            return 'draft';
+        if (workflow.name?.toLowerCase().includes('wip'))
+            return 'draft';
+        // Default to active
+        return 'active';
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Creates a file system workflow loader
+ */
+export function createWorkflowLoader(config) {
+    return new FileSystemWorkflowLoader(config);
+}
+/**
+ * Default workflow directories to search
+ */
+export const DEFAULT_WORKFLOW_DIRS = [
+    'examples/workflows',
+    'workflows',
+    '.automatosx/workflows',
+];
+/**
+ * Finds the first existing workflow directory
+ */
+export function findWorkflowDir(basePath) {
+    for (const dir of DEFAULT_WORKFLOW_DIRS) {
+        const fullPath = path.join(basePath, dir);
+        if (fs.existsSync(fullPath)) {
+            return fullPath;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/retry.d.ts

@@ -0,0 +1,21 @@
+import { type RetryPolicy, DEFAULT_RETRY_POLICY } from '@defai.digital/contracts';
+import type { StepError } from './types.js';
+export { DEFAULT_RETRY_POLICY };
+/**
+ * Merges a partial retry policy with defaults
+ */
+export declare function mergeRetryPolicy(policy?: RetryPolicy): Required<RetryPolicy>;
+/**
+ * Determines if an error should trigger a retry
+ * INV-WF-002: Retries are scoped to the current step only
+ */
+export declare function shouldRetry(error: StepError, policy: Required<RetryPolicy>, currentAttempt: number): boolean;
+/**
+ * Calculates the backoff delay for a retry attempt
+ */
+export declare function calculateBackoff(policy: Required<RetryPolicy>, attempt: number): number;
+/**
+ * Sleeps for a specified duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAChB,oBAAoB,EAErB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,QAAQ,CAAC,WAAW,CAAC,CAcvB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC7B,cAAc,EAAE,MAAM,GACrB,OAAO,CAuBT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC7B,OAAO,EAAE,MAAM,GACd,MAAM,CAIR;AAkCD;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/retry.js

@@ -0,0 +1,82 @@
+import { DEFAULT_RETRY_POLICY, DEFAULT_BACKOFF_CAP_MS, } from '@defai.digital/contracts';
+// Re-export for backwards compatibility
+export { DEFAULT_RETRY_POLICY };
+/**
+ * Merges a partial retry policy with defaults
+ */
+export function mergeRetryPolicy(policy) {
+    if (policy === undefined) {
+        return DEFAULT_RETRY_POLICY;
+    }
+    // Cast to partial to allow null coalescing
+    // Runtime objects may be incomplete even if TypeScript says otherwise
+    const partial = policy;
+    return {
+        maxAttempts: partial.maxAttempts ?? DEFAULT_RETRY_POLICY.maxAttempts,
+        backoffMs: partial.backoffMs ?? DEFAULT_RETRY_POLICY.backoffMs,
+        backoffMultiplier: partial.backoffMultiplier ?? DEFAULT_RETRY_POLICY.backoffMultiplier,
+        retryOn: partial.retryOn ?? DEFAULT_RETRY_POLICY.retryOn,
+    };
+}
+/**
+ * Determines if an error should trigger a retry
+ * INV-WF-002: Retries are scoped to the current step only
+ */
+export function shouldRetry(error, policy, currentAttempt) {
+    // Check if we have attempts remaining
+    if (currentAttempt >= policy.maxAttempts) {
+        return false;
+    }
+    // Check if the error is retryable
+    if (!error.retryable) {
+        return false;
+    }
+    // Check if the error code matches retry conditions
+    const errorType = mapErrorCodeToRetryType(error.code);
+    if (errorType === null) {
+        return false;
+    }
+    // If retryOn is not defined, allow retry for any retryable error
+    if (policy.retryOn === undefined) {
+        return true;
+    }
+    return policy.retryOn.includes(errorType);
+}
+/**
+ * Calculates the backoff delay for a retry attempt
+ */
+export function calculateBackoff(policy, attempt) {
+    // Exponential backoff: baseDelay * multiplier^(attempt-1)
+    const delay = policy.backoffMs * Math.pow(policy.backoffMultiplier, attempt - 1);
+    return Math.min(delay, DEFAULT_BACKOFF_CAP_MS); // Cap at contract-defined max
+}
+/**
+ * Maps error codes to retry types
+ */
+function mapErrorCodeToRetryType(code) {
+    const codeUpper = code.toUpperCase();
+    if (codeUpper.includes('TIMEOUT')) {
+        return 'timeout';
+    }
+    if (codeUpper.includes('RATE_LIMIT') || codeUpper.includes('RATE_LIMITED')) {
+        return 'rate_limit';
+    }
+    if (codeUpper.includes('SERVER_ERROR') ||
+        codeUpper.includes('INTERNAL_ERROR') ||
+        codeUpper.startsWith('5')) {
+        return 'server_error';
+    }
+    if (codeUpper.includes('NETWORK') ||
+        codeUpper.includes('CONNECTION') ||
+        codeUpper.includes('ECONNREFUSED')) {
+        return 'network_error';
+    }
+    return null;
+}
+/**
+ * Sleeps for a specified duration
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,38 @@
+import type { WorkflowResult, WorkflowRunnerConfig } from './types.js';
+/**
+ * Workflow runner that executes workflows following contract invariants
+ *
+ * Invariants enforced:
+ * - INV-WF-001: Step execution order matches definition exactly
+ * - INV-WF-002: Retries are scoped to the current step only
+ * - INV-WF-003: Schema strictness (via validation)
+ * - INV-WF-004: Step ID uniqueness (via validation)
+ * - INV-WF-005: Immutable definition (via freezing)
+ */
+export declare class WorkflowRunner {
+    private readonly config;
+    constructor(config?: WorkflowRunnerConfig);
+    /**
+     * Executes a workflow
+     * INV-WF-001: Steps are executed in definition order
+     */
+    run(workflowData: unknown, input?: unknown): Promise<WorkflowResult>;
+    /**
+     * Executes a single step with retry logic
+     * INV-WF-002: Retries are scoped to current step only
+     */
+    private executeStepWithRetry;
+    /**
+     * Executes a step with optional timeout
+     */
+    private executeStepWithTimeout;
+    /**
+     * Creates an error result
+     */
+    private createErrorResult;
+}
+/**
+ * Creates a workflow runner with the given configuration
+ */
+export declare function createWorkflowRunner(config?: WorkflowRunnerConfig): WorkflowRunner;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EAKrB,MAAM,YAAY,CAAC;AAqBpB;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,MAAM,GAAE,oBAAyB;IAc7C;;;OAGG;IACG,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IA6E1E;;;OAGG;YACW,oBAAoB;IAsElC;;OAEG;YACW,sBAAsB;IAsCpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAqB1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,oBAAoB,GAC5B,cAAc,CAEhB"}