bunqueue 2.6.116 → 2.7.0

package/README.md

@@ -481,6 +481,85 @@ process.on('SIGINT', async () => {
 
 ---
 
+## Workflow Engine
+
+Orchestrate multi-step business processes with branching, saga compensation, and human-in-the-loop signals. Built on top of bunqueue — no new infrastructure.
+
+```typescript
+import { Workflow, Engine } from 'bunqueue/workflow';
+
+const orderFlow = new Workflow('order-pipeline')
+  .step('validate', async (ctx) => {
+    const { orderId, amount } = ctx.input as { orderId: string; amount: number };
+    if (amount <= 0) throw new Error('Invalid amount');
+    return { orderId };
+  })
+  .step('reserve-stock', async () => {
+    await inventory.reserve();
+    return { reserved: true };
+  }, {
+    compensate: async () => await inventory.release(), // Auto-rollback on failure
+  })
+  .step('charge', async () => {
+    return { txId: await payments.charge() };
+  }, {
+    compensate: async () => await payments.refund(),
+  })
+  .step('confirm', async (ctx) => {
+    const { txId } = ctx.steps['charge'] as { txId: string };
+    return { emailSent: true, txId };
+  });
+
+const engine = new Engine({ embedded: true });
+engine.register(orderFlow);
+await engine.start('order-pipeline', { orderId: 'ORD-1', amount: 99.99 });
+```
+
+**Features:**
+
+- **Saga pattern** — Compensation handlers run in reverse when a step fails
+- **Branching** — Route to different paths based on runtime conditions
+- **Human-in-the-loop** — `waitFor('event')` pauses execution, `engine.signal()` resumes it
+- **Step timeouts** — Prevent steps from running indefinitely
+- **Context passing** — Each step accesses input and all previous step results
+- **SQLite persistence** — Execution state survives restarts
+
+**vs Competitors:**
+
+| | **bunqueue** | **Temporal** | **Inngest** | **AWS Step Functions** |
+|---|---|---|---|---|
+| **Infrastructure** | None (embedded) | PostgreSQL + 7 services | Cloud-only | AWS-native |
+| **Saga compensation** | Built-in | Manual | Manual | Manual |
+| **Human-in-the-loop** | `.waitFor()` | Signals API | `step.waitForEvent()` | Callback tasks |
+| **Self-hosted** | Zero-config | Complex | No | No |
+| **Pricing** | Free (MIT) | Free / Cloud $$ | Per-execution | Per-transition |
+
+```typescript
+// Branching
+const flow = new Workflow('tiered')
+  .step('classify', async (ctx) => ({ tier: ctx.input.amount > 1000 ? 'vip' : 'basic' }))
+  .branch((ctx) => ctx.steps['classify'].tier)
+  .path('vip', (w) => w.step('vip-handler', async () => ({ discount: 20 })))
+  .path('basic', (w) => w.step('basic-handler', async () => ({ discount: 0 })))
+  .step('done', async () => ({ processed: true }));
+
+// Human-in-the-loop
+const approvalFlow = new Workflow('expense')
+  .step('submit', async (ctx) => ({ amount: ctx.input.amount }))
+  .waitFor('manager-approval')
+  .step('reimburse', async (ctx) => {
+    const decision = ctx.signals['manager-approval'] as { approved: boolean };
+    return { status: decision.approved ? 'paid' : 'rejected' };
+  });
+
+// Signal a waiting workflow
+await engine.signal(run.id, 'manager-approval', { approved: true });
+```
+
+[Workflow Engine docs →](https://bunqueue.dev/guide/workflow/)
+
+---
+
 <p align="center">
   <strong>bunqueue Dashboard</strong><br/>
   <sub>A visual interface for managing queues, jobs, workers and monitoring in real time. Currently in beta.</sub>
@@ -728,6 +807,7 @@ docker compose --profile monitoring up -d
 **[Read the full documentation →](https://bunqueue.dev/)**
 
 - [Quick Start](https://bunqueue.dev/guide/quickstart/)
+- [Workflow Engine](https://bunqueue.dev/guide/workflow/)
 - [MCP Server (AI Agents)](https://bunqueue.dev/guide/mcp/)
 - [Simple Mode](https://bunqueue.dev/guide/simple-mode/)
 - [Queue API](https://bunqueue.dev/guide/queue/)

package/dist/client/workflow/engine.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Engine - Public facade for the workflow engine
+ * Manages lifecycle of internal Queue, Worker, and Store.
+ */
+import type { Workflow } from './workflow';
+import type { EngineOptions, RunHandle, Execution, ExecutionState } from './types';
+export declare class Engine {
+    private readonly queue;
+    private readonly worker;
+    private readonly store;
+    private readonly executor;
+    constructor(opts?: EngineOptions);
+    /** Register a workflow definition */
+    register(workflow: Workflow): this;
+    /** Start a new workflow execution */
+    start(workflowName: string, input?: unknown): Promise<RunHandle>;
+    /** Get execution state by ID */
+    getExecution(id: string): Execution | null;
+    /** List executions with optional filters */
+    listExecutions(workflowName?: string, state?: ExecutionState): Execution[];
+    /** Send a signal to a waiting execution */
+    signal(executionId: string, event: string, payload?: unknown): Promise<void>;
+    /** Shut down the engine */
+    close(force?: boolean): Promise<void>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/client/workflow/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/client/workflow/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAe,MAAM,SAAS,CAAC;AAIhG,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;gBAEhC,IAAI,GAAE,aAAkB;IA2BpC,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAKlC,qCAAqC;IAC/B,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAItE,gCAAgC;IAChC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI1C,4CAA4C;IAC5C,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,GAAG,SAAS,EAAE;IAI1E,2CAA2C;IACrC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,2BAA2B;IACrB,KAAK,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAK1C"}

package/dist/client/workflow/engine.js

@@ -0,0 +1,62 @@
+/**
+ * Engine - Public facade for the workflow engine
+ * Manages lifecycle of internal Queue, Worker, and Store.
+ */
+import { Queue } from '../queue/queue';
+import { Worker } from '../worker/worker';
+import { WorkflowStore } from './store';
+import { WorkflowExecutor } from './executor';
+const DEFAULT_QUEUE_NAME = '__wf:steps';
+export class Engine {
+    queue;
+    worker;
+    store;
+    executor;
+    constructor(opts = {}) {
+        const queueName = opts.queueName ?? DEFAULT_QUEUE_NAME;
+        this.queue = new Queue(queueName, {
+            connection: opts.connection,
+            embedded: opts.embedded,
+            dataPath: opts.dataPath,
+        });
+        this.store = new WorkflowStore(opts.dataPath);
+        this.executor = new WorkflowExecutor(this.store, this.queue);
+        this.worker = new Worker(queueName, async (job) => {
+            const data = job.data;
+            return this.executor.processStep(data);
+        }, {
+            connection: opts.connection,
+            embedded: opts.embedded,
+            dataPath: opts.dataPath,
+            concurrency: opts.concurrency ?? 5,
+        });
+    }
+    /** Register a workflow definition */
+    register(workflow) {
+        this.executor.register(workflow);
+        return this;
+    }
+    /** Start a new workflow execution */
+    async start(workflowName, input) {
+        return this.executor.start(workflowName, input);
+    }
+    /** Get execution state by ID */
+    getExecution(id) {
+        return this.executor.getExecution(id);
+    }
+    /** List executions with optional filters */
+    listExecutions(workflowName, state) {
+        return this.executor.listExecutions(workflowName, state);
+    }
+    /** Send a signal to a waiting execution */
+    async signal(executionId, event, payload) {
+        return this.executor.signal(executionId, event, payload);
+    }
+    /** Shut down the engine */
+    async close(force = false) {
+        await this.worker.close(force);
+        this.queue.close();
+        this.store.close();
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/client/workflow/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/client/workflow/engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAExC,MAAM,OAAO,MAAM;IACA,KAAK,CAAQ;IACb,MAAM,CAAS;IACf,KAAK,CAAgB;IACrB,QAAQ,CAAmB;IAE5C,YAAY,OAAsB,EAAE;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,kBAAkB,CAAC;QAEvD,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE;YAChC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAE7D,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CACtB,SAAS,EACT,KAAK,EAAE,GAAG,EAAE,EAAE;YACZ,MAAM,IAAI,GAAG,GAAG,CAAC,IAA8B,CAAC;YAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC,EACD;YACE,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC;SACnC,CACF,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,QAAQ,CAAC,QAAkB;QACzB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qCAAqC;IACrC,KAAK,CAAC,KAAK,CAAC,YAAoB,EAAE,KAAe;QAC/C,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,gCAAgC;IAChC,YAAY,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,4CAA4C;IAC5C,cAAc,CAAC,YAAqB,EAAE,KAAsB;QAC1D,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,2CAA2C;IAC3C,KAAK,CAAC,MAAM,CAAC,WAAmB,EAAE,KAAa,EAAE,OAAiB;QAChE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK;QACvB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/client/workflow/executor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * WorkflowExecutor - Core execution logic
+ * Processes steps as bunqueue jobs, handles transitions, branching, compensation.
+ */
+import type { Queue } from '../queue/queue';
+import type { Workflow } from './workflow';
+import type { WorkflowStore } from './store';
+import type { Execution, StepJobData, RunHandle } from './types';
+export declare class WorkflowExecutor {
+    private readonly store;
+    private readonly queue;
+    private readonly workflows;
+    constructor(store: WorkflowStore, queue: Queue);
+    register(workflow: Workflow): void;
+    start(workflowName: string, input: unknown): Promise<RunHandle>;
+    /** Process a step job — this is the Worker processor function */
+    processStep(data: StepJobData): Promise<unknown>;
+    signal(executionId: string, event: string, payload: unknown): Promise<void>;
+    getExecution(id: string): Execution | null;
+    listExecutions(workflowName?: string, state?: Execution['state']): Execution[];
+    private executeNode;
+    private executeStep;
+    private executeBranch;
+    private executeWaitFor;
+    private advanceToNext;
+    private enqueueNode;
+    private runCompensation;
+    private findStepDef;
+    private buildContext;
+    private runWithTimeout;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/client/workflow/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/client/workflow/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,SAAS,EAIV,MAAM,SAAS,CAAC;AASjB,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;gBAGtC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,KAAK;IAG/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAS5B,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;IAuBrE,iEAAiE;IAC3D,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BhD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI1C,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,SAAS,EAAE;YAMhE,WAAW;YAeX,WAAW;YAiCX,aAAa;YA2Bb,cAAc;YAkBd,aAAa;YASb,WAAW;YASX,eAAe;IA0B7B,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,cAAc;CAmBvB"}

package/dist/client/workflow/executor.js

@@ -0,0 +1,247 @@
+/**
+ * WorkflowExecutor - Core execution logic
+ * Processes steps as bunqueue jobs, handles transitions, branching, compensation.
+ */
+/** Thrown when a step needs to wait for a signal */
+class WaitForSignalError extends Error {
+    event;
+    constructor(event) {
+        super(`Waiting for signal: ${event}`);
+        this.event = event;
+    }
+}
+export class WorkflowExecutor {
+    store;
+    queue;
+    workflows = new Map();
+    constructor(store, queue) {
+        this.store = store;
+        this.queue = queue;
+    }
+    register(workflow) {
+        const names = workflow.getStepNames();
+        const dupes = names.filter((n, i) => names.indexOf(n) !== i);
+        if (dupes.length > 0) {
+            throw new Error(`Duplicate step names in "${workflow.name}": ${dupes.join(', ')}`);
+        }
+        this.workflows.set(workflow.name, workflow);
+    }
+    async start(workflowName, input) {
+        const wf = this.workflows.get(workflowName);
+        if (!wf)
+            throw new Error(`Workflow "${workflowName}" not registered`);
+        if (wf.nodes.length === 0)
+            throw new Error(`Workflow "${workflowName}" has no steps`);
+        const now = Date.now();
+        const exec = {
+            id: `wf_${now}_${Math.random().toString(36).slice(2, 10)}`,
+            workflowName,
+            state: 'running',
+            input,
+            steps: {},
+            currentNodeIndex: 0,
+            signals: {},
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.store.save(exec);
+        await this.enqueueNode(exec);
+        return { id: exec.id, workflowName };
+    }
+    /** Process a step job — this is the Worker processor function */
+    async processStep(data) {
+        const exec = this.store.get(data.executionId);
+        if (exec?.state !== 'running')
+            return null;
+        const wf = this.workflows.get(exec.workflowName);
+        if (!wf)
+            throw new Error(`Workflow "${exec.workflowName}" not registered`);
+        const node = wf.nodes[data.nodeIndex];
+        if (!node) {
+            exec.state = 'completed';
+            this.store.update(exec);
+            return null;
+        }
+        try {
+            await this.executeNode(exec, node, data.nodeIndex, wf);
+        }
+        catch (err) {
+            if (err instanceof WaitForSignalError)
+                return null;
+            exec.state = 'failed';
+            this.store.update(exec);
+            await this.runCompensation(exec, wf);
+            throw err;
+        }
+        return null;
+    }
+    async signal(executionId, event, payload) {
+        const exec = this.store.get(executionId);
+        if (!exec)
+            throw new Error(`Execution "${executionId}" not found`);
+        exec.signals[event] = payload;
+        exec.state = 'running';
+        this.store.update(exec);
+        await this.enqueueNode(exec);
+    }
+    getExecution(id) {
+        return this.store.get(id);
+    }
+    listExecutions(workflowName, state) {
+        return this.store.list(workflowName, state);
+    }
+    // ============ Internal ============
+    async executeNode(exec, node, nodeIndex, wf) {
+        if (node.type === 'step') {
+            await this.executeStep(exec, node.def, nodeIndex, wf);
+        }
+        else if (node.type === 'branch') {
+            await this.executeBranch(exec, node, nodeIndex, wf);
+        }
+        else {
+            await this.executeWaitFor(exec, node, nodeIndex);
+        }
+    }
+    async executeStep(exec, def, nodeIndex, wf) {
+        const ctx = this.buildContext(exec);
+        exec.steps[def.name] = { status: 'running', startedAt: Date.now() };
+        this.store.update(exec);
+        try {
+            const result = await this.runWithTimeout(def.handler(ctx), def.timeout);
+            exec.steps[def.name] = {
+                status: 'completed',
+                result,
+                startedAt: exec.steps[def.name].startedAt,
+                completedAt: Date.now(),
+            };
+            exec.currentNodeIndex = nodeIndex + 1;
+            this.store.update(exec);
+            await this.advanceToNext(exec, wf);
+        }
+        catch (err) {
+            exec.steps[def.name] = {
+                status: 'failed',
+                error: String(err),
+                startedAt: exec.steps[def.name].startedAt,
+                completedAt: Date.now(),
+            };
+            this.store.update(exec);
+            throw err;
+        }
+    }
+    async executeBranch(exec, node, nodeIndex, wf) {
+        const ctx = this.buildContext(exec);
+        const pathName = node.def.condition(ctx);
+        const pathSteps = node.def.paths.get(pathName);
+        if (!pathSteps || pathSteps.length === 0) {
+            exec.currentNodeIndex = nodeIndex + 1;
+            this.store.update(exec);
+            await this.advanceToNext(exec, wf);
+            return;
+        }
+        // Execute branch steps inline
+        for (const step of pathSteps) {
+            await this.executeStep(exec, step, nodeIndex, wf);
+        }
+        exec.currentNodeIndex = nodeIndex + 1;
+        this.store.update(exec);
+        await this.advanceToNext(exec, wf);
+    }
+    async executeWaitFor(exec, node, nodeIndex) {
+        if (exec.signals[node.event] !== undefined) {
+            exec.currentNodeIndex = nodeIndex + 1;
+            this.store.update(exec);
+            await this.enqueueNode(exec);
+            return;
+        }
+        // Not yet received — pause execution
+        exec.state = 'waiting';
+        this.store.update(exec);
+        throw new WaitForSignalError(node.event);
+    }
+    async advanceToNext(exec, wf) {
+        if (exec.currentNodeIndex >= wf.nodes.length) {
+            exec.state = 'completed';
+            this.store.update(exec);
+            return;
+        }
+        await this.enqueueNode(exec);
+    }
+    async enqueueNode(exec) {
+        const jobData = {
+            executionId: exec.id,
+            workflowName: exec.workflowName,
+            nodeIndex: exec.currentNodeIndex,
+        };
+        await this.queue.add('wf:step', jobData);
+    }
+    async runCompensation(exec, wf) {
+        const completedSteps = Object.entries(exec.steps)
+            .filter(([, s]) => s.status === 'completed')
+            .reverse();
+        if (completedSteps.length === 0)
+            return;
+        exec.state = 'compensating';
+        this.store.update(exec);
+        const ctx = this.buildContext(exec);
+        for (const [name] of completedSteps) {
+            const def = this.findStepDef(wf, name);
+            if (def?.compensate) {
+                try {
+                    await def.compensate(ctx);
+                }
+                catch {
+                    // Compensation errors are logged but don't stop the chain
+                }
+            }
+        }
+        exec.state = 'failed';
+        this.store.update(exec);
+    }
+    findStepDef(wf, name) {
+        for (const node of wf.nodes) {
+            if (node.type === 'step' && node.def.name === name)
+                return node.def;
+            if (node.type === 'branch') {
+                for (const steps of node.def.paths.values()) {
+                    const found = steps.find((s) => s.name === name);
+                    if (found)
+                        return found;
+                }
+            }
+        }
+        return null;
+    }
+    buildContext(exec) {
+        const stepResults = {};
+        for (const [name, record] of Object.entries(exec.steps)) {
+            if (record.status === 'completed')
+                stepResults[name] = record.result;
+        }
+        return {
+            input: exec.input,
+            steps: stepResults,
+            signals: exec.signals,
+            executionId: exec.id,
+        };
+    }
+    runWithTimeout(promise, timeoutMs) {
+        if (!(promise instanceof Promise))
+            return Promise.resolve(promise);
+        if (timeoutMs <= 0)
+            return promise;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Step timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            promise.then((v) => {
+                clearTimeout(timer);
+                resolve(v);
+            }, (e) => {
+                clearTimeout(timer);
+                reject(e instanceof Error ? e : new Error(String(e)));
+            });
+        });
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/client/workflow/executor.js.map

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

package/dist/client/workflow/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * bunqueue Workflow Engine
+ *
+ * Lightweight workflow orchestration built on top of bunqueue.
+ *
+ * @example
+ * ```typescript
+ * import { Workflow, Engine } from 'bunqueue/workflow';
+ *
+ * const flow = new Workflow('onboarding')
+ *   .step('create', async (ctx) => { ... })
+ *   .step('notify', async (ctx) => { ... });
+ *
+ * const engine = new Engine({ embedded: true });
+ * engine.register(flow);
+ * const run = await engine.start('onboarding', { email: 'user@test.com' });
+ * ```
+ */
+export { Workflow } from './workflow';
+export { Engine } from './engine';
+export type { StepContext, StepHandler, CompensateHandler, StepOptions, Execution, ExecutionState, StepState, StepRecord, EngineOptions, RunHandle, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/workflow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,cAAc,EACd,SAAS,EACT,UAAU,EACV,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/client/workflow/index.js

@@ -0,0 +1,21 @@
+/**
+ * bunqueue Workflow Engine
+ *
+ * Lightweight workflow orchestration built on top of bunqueue.
+ *
+ * @example
+ * ```typescript
+ * import { Workflow, Engine } from 'bunqueue/workflow';
+ *
+ * const flow = new Workflow('onboarding')
+ *   .step('create', async (ctx) => { ... })
+ *   .step('notify', async (ctx) => { ... });
+ *
+ * const engine = new Engine({ embedded: true });
+ * engine.register(flow);
+ * const run = await engine.start('onboarding', { email: 'user@test.com' });
+ * ```
+ */
+export { Workflow } from './workflow';
+export { Engine } from './engine';
+//# sourceMappingURL=index.js.map

package/dist/client/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/workflow/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/client/workflow/store.d.ts

@@ -0,0 +1,16 @@
+/**
+ * WorkflowStore - SQLite persistence for workflow executions
+ */
+import type { Execution, ExecutionState } from './types';
+export declare class WorkflowStore {
+    private readonly db;
+    private readonly stmts;
+    constructor(dbPath?: string);
+    save(exec: Execution): void;
+    get(id: string): Execution | null;
+    update(exec: Execution): void;
+    list(workflowName?: string, state?: ExecutionState): Execution[];
+    close(): void;
+    private rowToExecution;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/client/workflow/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/client/workflow/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAc,MAAM,SAAS,CAAC;AA+BrE,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAQpB;gBAEU,MAAM,CAAC,EAAE,MAAM;IAgC3B,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAe3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAKjC,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAa7B,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,GAAG,SAAS,EAAE;IAchE,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,cAAc;CAgBvB"}

package/dist/client/workflow/store.js

@@ -0,0 +1,105 @@
+/**
+ * WorkflowStore - SQLite persistence for workflow executions
+ */
+import { Database } from 'bun:sqlite';
+import { Packr, Unpackr } from 'msgpackr';
+const packr = new Packr({ structuredClone: true });
+const unpackr = new Unpackr({ structuredClone: true });
+function pack(data) {
+    return packr.pack(data);
+}
+function unpack(buf) {
+    if (!buf)
+        return null;
+    return unpackr.unpack(buf);
+}
+const CREATE_TABLE = `
+CREATE TABLE IF NOT EXISTS workflow_executions (
+  id TEXT PRIMARY KEY,
+  workflow_name TEXT NOT NULL,
+  state TEXT NOT NULL DEFAULT 'running',
+  input BLOB,
+  steps BLOB,
+  current_node_index INTEGER NOT NULL DEFAULT 0,
+  resolved_steps BLOB,
+  signals BLOB,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+)`;
+const CREATE_IDX_NAME = `CREATE INDEX IF NOT EXISTS idx_wf_name ON workflow_executions(workflow_name)`;
+const CREATE_IDX_STATE = `CREATE INDEX IF NOT EXISTS idx_wf_state ON workflow_executions(state)`;
+export class WorkflowStore {
+    db;
+    stmts;
+    constructor(dbPath) {
+        this.db = new Database(dbPath ?? ':memory:', { create: true });
+        this.db.run('PRAGMA journal_mode = WAL');
+        this.db.run(CREATE_TABLE);
+        this.db.run(CREATE_IDX_NAME);
+        this.db.run(CREATE_IDX_STATE);
+        this.stmts = {
+            upsert: this.db.prepare(`
+        INSERT OR REPLACE INTO workflow_executions
+        (id, workflow_name, state, input, steps, current_node_index, resolved_steps, signals, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `),
+            get: this.db.prepare(`SELECT * FROM workflow_executions WHERE id = ?`),
+            updateState: this.db.prepare(`
+        UPDATE workflow_executions
+        SET state = ?, steps = ?, current_node_index = ?, resolved_steps = ?, signals = ?, updated_at = ?
+        WHERE id = ?
+      `),
+            list: this.db.prepare(`SELECT * FROM workflow_executions ORDER BY created_at DESC LIMIT 100`),
+            listByName: this.db.prepare(`SELECT * FROM workflow_executions WHERE workflow_name = ? ORDER BY created_at DESC LIMIT 100`),
+            listByState: this.db.prepare(`SELECT * FROM workflow_executions WHERE state = ? ORDER BY created_at DESC LIMIT 100`),
+            listByBoth: this.db.prepare(`SELECT * FROM workflow_executions WHERE workflow_name = ? AND state = ? ORDER BY created_at DESC LIMIT 100`),
+        };
+    }
+    save(exec) {
+        this.stmts.upsert.run(exec.id, exec.workflowName, exec.state, pack(exec.input), pack(exec.steps), exec.currentNodeIndex, exec.resolvedSteps ? pack(exec.resolvedSteps) : null, pack(exec.signals), exec.createdAt, exec.updatedAt);
+    }
+    get(id) {
+        const row = this.stmts.get.get(id);
+        return row ? this.rowToExecution(row) : null;
+    }
+    update(exec) {
+        exec.updatedAt = Date.now();
+        this.stmts.updateState.run(exec.state, pack(exec.steps), exec.currentNodeIndex, exec.resolvedSteps ? pack(exec.resolvedSteps) : null, pack(exec.signals), exec.updatedAt, exec.id);
+    }
+    list(workflowName, state) {
+        let rows;
+        if (workflowName && state) {
+            rows = this.stmts.listByBoth.all(workflowName, state);
+        }
+        else if (workflowName) {
+            rows = this.stmts.listByName.all(workflowName);
+        }
+        else if (state) {
+            rows = this.stmts.listByState.all(state);
+        }
+        else {
+            rows = this.stmts.list.all();
+        }
+        return rows.map((r) => this.rowToExecution(r));
+    }
+    close() {
+        this.db.close();
+    }
+    rowToExecution(row) {
+        return {
+            id: row.id,
+            workflowName: row.workflow_name,
+            state: row.state,
+            input: unpack(row.input),
+            steps: unpack(row.steps) ?? {},
+            currentNodeIndex: row.current_node_index,
+            resolvedSteps: row.resolved_steps
+                ? unpack(row.resolved_steps)
+                : undefined,
+            signals: unpack(row.signals) ?? {},
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/client/workflow/store.js.map

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

package/dist/client/workflow/types.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Workflow Engine Types
+ */
+import type { ConnectionOptions } from '../types';
+/** Context passed to step handlers */
+export interface StepContext<TInput = unknown> {
+    /** Original workflow input */
+    readonly input: TInput;
+    /** Results from completed steps (step name → result) */
+    readonly steps: Readonly<Record<string, unknown>>;
+    /** Signals received via engine.signal() */
+    readonly signals: Readonly<Record<string, unknown>>;
+    /** Current execution ID */
+    readonly executionId: string;
+}
+/** Step handler function */
+export type StepHandler<TInput = unknown, TResult = unknown> = (ctx: StepContext<TInput>) => Promise<TResult> | TResult;
+/** Compensate handler (rollback on failure) */
+export type CompensateHandler<TInput = unknown> = (ctx: StepContext<TInput>) => Promise<void> | void;
+/** Options for a single step */
+export interface StepOptions<TInput = unknown> {
+    retry?: number;
+    timeout?: number;
+    compensate?: CompensateHandler<TInput>;
+}
+/** Internal step definition */
+export interface StepDefinition {
+    name: string;
+    handler: StepHandler;
+    compensate?: CompensateHandler;
+    retry: number;
+    timeout: number;
+}
+/** Branch condition function */
+export type BranchCondition = (ctx: StepContext) => string;
+/** Internal branch definition */
+export interface BranchDefinition {
+    condition: BranchCondition;
+    paths: Map<string, StepDefinition[]>;
+}
+/** Workflow node (discriminated union) */
+export type WorkflowNode = {
+    type: 'step';
+    def: StepDefinition;
+} | {
+    type: 'branch';
+    def: BranchDefinition;
+} | {
+    type: 'waitFor';
+    event: string;
+    timeout?: number;
+};
+/** Execution state */
+export type ExecutionState = 'running' | 'waiting' | 'completed' | 'failed' | 'compensating';
+/** Step execution state */
+export type StepState = 'pending' | 'running' | 'completed' | 'failed';
+/** Record of a step's execution */
+export interface StepRecord {
+    status: StepState;
+    result?: unknown;
+    error?: string;
+    startedAt?: number;
+    completedAt?: number;
+}
+/** Full execution state */
+export interface Execution {
+    id: string;
+    workflowName: string;
+    state: ExecutionState;
+    input: unknown;
+    steps: Record<string, StepRecord>;
+    currentNodeIndex: number;
+    /** Flattened step list for branch resolution */
+    resolvedSteps?: string[];
+    signals: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+}
+/** Engine configuration */
+export interface EngineOptions {
+    embedded?: boolean;
+    dataPath?: string;
+    connection?: ConnectionOptions;
+    /** Internal queue name (default: __wf:steps) */
+    queueName?: string;
+    /** Worker concurrency (default: 5) */
+    concurrency?: number;
+}
+/** Handle returned from engine.start() */
+export interface RunHandle {
+    id: string;
+    workflowName: string;
+}
+/** Internal job data for step execution */
+export interface StepJobData {
+    executionId: string;
+    workflowName: string;
+    nodeIndex: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/workflow/types.d.ts.map

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

package/dist/client/workflow/types.js

@@ -0,0 +1,5 @@
+/**
+ * Workflow Engine Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/workflow/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/workflow/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/client/workflow/workflow.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Workflow - DSL builder for defining workflow step graphs
+ * Pure data structure, no side effects.
+ */
+import type { WorkflowNode, StepHandler, StepOptions, BranchCondition } from './types';
+export declare class Workflow<TInput = unknown> {
+    readonly name: string;
+    readonly nodes: WorkflowNode[];
+    constructor(name: string);
+    /** Add a step to the workflow */
+    step(name: string, handler: StepHandler<TInput>, options?: StepOptions<TInput>): this;
+    /** Add a branch point — call .path() after this to define paths */
+    branch(condition: BranchCondition): this;
+    /** Define a branch path (must follow a .branch() call) */
+    path(name: string, builder: (w: Workflow<TInput>) => Workflow<TInput>): this;
+    /** Wait for an external signal before continuing */
+    waitFor(event: string, options?: {
+        timeout?: number;
+    }): this;
+    /** Get flat list of step names for validation */
+    getStepNames(): string[];
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/client/workflow/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/client/workflow/workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EAEX,WAAW,EAEX,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,qBAAa,QAAQ,CAAC,MAAM,GAAG,OAAO;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAM;gBAExB,IAAI,EAAE,MAAM;IAIxB,iCAAiC;IACjC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAcrF,mEAAmE;IACnE,MAAM,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAQxC,0DAA0D;IAC1D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAc5E,oDAAoD;IACpD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAS5D,iDAAiD;IACjD,YAAY,IAAI,MAAM,EAAE;CAazB"}

package/dist/client/workflow/workflow.js

@@ -0,0 +1,73 @@
+/**
+ * Workflow - DSL builder for defining workflow step graphs
+ * Pure data structure, no side effects.
+ */
+export class Workflow {
+    name;
+    nodes = [];
+    constructor(name) {
+        this.name = name;
+    }
+    /** Add a step to the workflow */
+    step(name, handler, options) {
+        this.nodes.push({
+            type: 'step',
+            def: {
+                name,
+                handler: handler,
+                compensate: options?.compensate,
+                retry: options?.retry ?? 3,
+                timeout: options?.timeout ?? 30_000,
+            },
+        });
+        return this;
+    }
+    /** Add a branch point — call .path() after this to define paths */
+    branch(condition) {
+        this.nodes.push({
+            type: 'branch',
+            def: { condition, paths: new Map() },
+        });
+        return this;
+    }
+    /** Define a branch path (must follow a .branch() call) */
+    path(name, builder) {
+        const lastNode = this.nodes[this.nodes.length - 1];
+        if (lastNode?.type !== 'branch') {
+            throw new Error('path() must follow a branch() call');
+        }
+        const sub = new Workflow(`${this.name}:${name}`);
+        builder(sub);
+        const steps = sub.nodes
+            .filter((n) => n.type === 'step')
+            .map((n) => n.def);
+        lastNode.def.paths.set(name, steps);
+        return this;
+    }
+    /** Wait for an external signal before continuing */
+    waitFor(event, options) {
+        this.nodes.push({
+            type: 'waitFor',
+            event,
+            timeout: options?.timeout,
+        });
+        return this;
+    }
+    /** Get flat list of step names for validation */
+    getStepNames() {
+        const names = [];
+        for (const node of this.nodes) {
+            if (node.type === 'step') {
+                names.push(node.def.name);
+            }
+            else if (node.type === 'branch') {
+                for (const steps of node.def.paths.values()) {
+                    for (const s of steps)
+                        names.push(s.name);
+                }
+            }
+        }
+        return names;
+    }
+}
+//# sourceMappingURL=workflow.js.map

package/dist/client/workflow/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../src/client/workflow/workflow.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,OAAO,QAAQ;IACV,IAAI,CAAS;IACb,KAAK,GAAmB,EAAE,CAAC;IAEpC,YAAY,IAAY;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,iCAAiC;IACjC,IAAI,CAAC,IAAY,EAAE,OAA4B,EAAE,OAA6B;QAC5E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,MAAM;YACZ,GAAG,EAAE;gBACH,IAAI;gBACJ,OAAO,EAAE,OAAsB;gBAC/B,UAAU,EAAE,OAAO,EAAE,UAA2C;gBAChE,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;gBAC1B,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,MAAM;aACpC;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mEAAmE;IACnE,MAAM,CAAC,SAA0B;QAC/B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,QAAQ;YACd,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE;SACrC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0DAA0D;IAC1D,IAAI,CAAC,IAAY,EAAE,OAAkD;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAA6B,CAAC;QAC/E,IAAI,QAAQ,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAS,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,CAAC;QACb,MAAM,KAAK,GAAqB,GAAG,CAAC,KAAK;aACtC,MAAM,CAAC,CAAC,CAAC,EAA8C,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAC5E,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACrB,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oDAAoD;IACpD,OAAO,CAAC,KAAa,EAAE,OAA8B;QACnD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,SAAS;YACf,KAAK;YACL,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iDAAiD;IACjD,YAAY;QACV,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAClC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC5C,KAAK,MAAM,CAAC,IAAI,KAAK;wBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunqueue",
-  "version": "2.6.116",
+  "version": "2.7.0",
   "description": "High-performance job queue for Bun & AI agents. SQLite persistence, cron scheduling, priorities, retries, DLQ, webhooks, native MCP server. Zero external dependencies.",
   "type": "module",
   "main": "dist/main.js",
@@ -25,6 +25,10 @@
     "./mcp": {
       "types": "./dist/mcp/index.d.ts",
       "import": "./dist/mcp/index.js"
+    },
+    "./workflow": {
+      "types": "./dist/client/workflow/index.d.ts",
+      "import": "./dist/client/workflow/index.js"
     }
   },
   "files": [