@ebowwa/workflows 0.1.0

package/dist/runner.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Workflow Runner - Execution Engine
+ *
+ * Orchestrates workflow execution with job scheduling,
+ * step execution, and event emission for real-time updates.
+ */
+import { EventEmitter } from 'node:events';
+import type { Workflow, WorkflowRun, Trigger } from './types.js';
+export interface RunnerOptions {
+    /** Default workspace directory */
+    workspace?: string;
+    /** Default environment variables */
+    env?: Record<string, string>;
+    /** Maximum concurrent jobs */
+    maxConcurrentJobs?: number;
+}
+export interface RunOptions {
+    /** Trigger that initiated this run */
+    trigger?: Trigger;
+    /** Environment variables for this run */
+    env?: Record<string, string>;
+    /** Workspace override */
+    workspace?: string;
+    /** Pre-generated run ID (optional) */
+    runId?: string;
+}
+/**
+ * Workflow Runner - executes workflows with process isolation
+ */
+export declare class WorkflowRunner extends EventEmitter {
+    private sandbox;
+    private workspace;
+    private env;
+    private maxConcurrentJobs;
+    private activeRuns;
+    constructor(options?: RunnerOptions);
+    /**
+     * Run a workflow
+     */
+    runWorkflow(workflow: Workflow, options?: RunOptions): Promise<WorkflowRun>;
+    private executeJobs;
+    private executeJob;
+    /**
+     * Cancel a running workflow
+     */
+    cancelRun(runId: string): boolean;
+    /**
+     * Check if a run is active
+     */
+    isRunActive(runId: string): boolean;
+    /**
+     * Get all active run IDs
+     */
+    getActiveRuns(): string[];
+    private emitEvent;
+    private emitLog;
+}
+/**
+ * Create a workflow runner
+ */
+export declare function createRunner(options?: RunnerOptions): 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":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EAGX,OAAO,EAMR,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,8BAA8B;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,UAAU,CAA6C;gBAEnD,OAAO,GAAE,aAAkB;IAYvC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,WAAW,CAAC;YA2EvE,WAAW;YA6BX,UAAU;IA8FxB;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IASjC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,OAAO;CAGhB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAEpE"}

package/dist/sandbox.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Process-level isolation for step execution
+ *
+ * Provides secure execution of workflow steps with process isolation,
+ * timeout handling, retry logic, and real-time log streaming.
+ */
+import type { ChildProcess } from 'node:child_process';
+import type { Step, StepContext, StepResult, LogEntry } from './types.js';
+export interface SandboxOptions {
+    /** Default timeout for steps (ms) */
+    defaultTimeout?: number;
+    /** Default retry count */
+    defaultRetry?: number;
+    /** Log callback for real-time streaming */
+    onLog?: (entry: LogEntry) => void;
+}
+export interface ActiveProcess {
+    pid: number;
+    jobId: string;
+    stepId: string;
+    process: ChildProcess;
+    cancelled: boolean;
+}
+/**
+ * Process Sandbox for isolated step execution
+ */
+export declare class ProcessSandbox {
+    private activeProcesses;
+    private defaultTimeout;
+    private defaultRetry;
+    private onLog?;
+    constructor(options?: SandboxOptions);
+    /**
+     * Execute a step in an isolated process
+     */
+    executeStep(step: Step, context: StepContext): Promise<StepResult>;
+    private executeStepOnce;
+    /**
+     * Cancel a running step
+     */
+    cancelStep(runId: string, jobId: string, stepId: string): boolean;
+    /**
+     * Cancel all steps for a run
+     */
+    cancelRun(runId: string): number;
+    /**
+     * Get all active processes
+     */
+    getActiveProcesses(): ActiveProcess[];
+    private killProcess;
+    private emitLog;
+}
+/**
+ * Evaluate a condition expression
+ * Supports simple expressions like "success()", "failure()", "always()"
+ * and basic comparisons
+ */
+export declare function evaluateCondition(condition: string | undefined, context: {
+    previousSteps: {
+        succeeded: boolean;
+    }[];
+}): boolean;
+/**
+ * Create a sandbox instance with log streaming
+ */
+export declare function createSandbox(onLog?: (entry: LogEntry) => void): ProcessSandbox;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../src/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAC,CAA4B;gBAE9B,OAAO,GAAE,cAAmB;IAMxC;;OAEG;IACG,WAAW,CACf,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;YAmCR,eAAe;IAiI7B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAajE;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAchC;;OAEG;IACH,kBAAkB,IAAI,aAAa,EAAE;IAIrC,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,OAAO;CAKhB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE;IAAE,aAAa,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CAAE,GACnD,OAAO,CAaT;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,cAAc,CAE/E"}

package/dist/scheduler.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Job Scheduler with dependency resolution
+ *
+ * Handles job ordering, parallel execution where possible,
+ * and dependency graph management.
+ */
+import type { Job } from './types.js';
+export interface JobNode {
+    id: string;
+    job: Job;
+    dependencies: string[];
+    dependents: string[];
+}
+export interface ExecutionPlan {
+    /** Jobs that can run in parallel, grouped by level */
+    levels: string[][];
+    /** Total number of jobs */
+    total: number;
+    /** Whether the graph has cycles */
+    hasCycles: boolean;
+}
+/**
+ * Build a dependency graph from jobs
+ */
+export declare function buildDependencyGraph(jobs: Record<string, Job>): Map<string, JobNode>;
+/**
+ * Create an execution plan from jobs
+ * Groups jobs by dependency level for parallel execution
+ */
+export declare function createExecutionPlan(jobs: Record<string, Job>): ExecutionPlan;
+/**
+ * Get jobs that are ready to run (all dependencies satisfied)
+ */
+export declare function getReadyJobs(graph: Map<string, JobNode>, completed: Set<string>, running: Set<string>, failed: Set<string>): string[];
+/**
+ * Job Scheduler class
+ */
+export declare class JobScheduler {
+    private graph;
+    private completed;
+    private running;
+    private failed;
+    private skipped;
+    constructor(jobs: Record<string, Job>);
+    /**
+     * Get the execution plan
+     */
+    getPlan(): ExecutionPlan;
+    /**
+     * Get jobs ready to run
+     */
+    getReadyJobs(): string[];
+    /**
+     * Mark a job as started
+     */
+    startJob(jobId: string): void;
+    /**
+     * Mark a job as completed
+     */
+    completeJob(jobId: string, success: boolean): void;
+    /**
+     * Skip a job (due to failed dependencies)
+     */
+    skipJob(jobId: string): void;
+    /**
+     * Check if all jobs are done
+     */
+    isComplete(): boolean;
+    /**
+     * Get status summary
+     */
+    getStatus(): {
+        total: number;
+        completed: number;
+        running: number;
+        failed: number;
+        skipped: number;
+        pending: number;
+    };
+    /**
+     * Get job by ID
+     */
+    getJob(jobId: string): Job | undefined;
+    /**
+     * Get all job IDs
+     */
+    getJobIds(): string[];
+    /**
+     * Check for cycles in the dependency graph
+     */
+    hasCycles(): boolean;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAuC,MAAM,YAAY,CAAC;AAE3E,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,GAAG,CAAC;IACT,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBpF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,aAAa,CA+E5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAClB,MAAM,EAAE,CAyBV;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAqB;gBAExB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAIrC;;OAEG;IACH,OAAO,IAAI,aAAa;IAQxB;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAUlD;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,UAAU,IAAI,OAAO;IAMrB;;OAEG;IACH,SAAS,IAAI;QACX,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB;IAcD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAItC;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB"}