@cogitator-ai/workflows 0.1.0

package/dist/executor.js

@@ -0,0 +1,207 @@
+/**
+ * WorkflowExecutor - Main execution engine for workflows
+ */
+import { nanoid } from 'nanoid';
+import { WorkflowScheduler } from './scheduler';
+import { InMemoryCheckpointStore, createCheckpointId } from './checkpoint';
+const DEFAULT_MAX_CONCURRENCY = 4;
+const DEFAULT_MAX_ITERATIONS = 100;
+export class WorkflowExecutor {
+    cogitator;
+    checkpointStore;
+    scheduler;
+    constructor(cogitator, checkpointStore) {
+        this.cogitator = cogitator;
+        this.checkpointStore = checkpointStore ?? new InMemoryCheckpointStore();
+        this.scheduler = new WorkflowScheduler();
+    }
+    /**
+     * Execute a workflow
+     */
+    async execute(workflow, input, options) {
+        const workflowId = `wf_${nanoid(12)}`;
+        const startTime = Date.now();
+        const maxConcurrency = options?.maxConcurrency ?? DEFAULT_MAX_CONCURRENCY;
+        const maxIterations = options?.maxIterations ?? DEFAULT_MAX_ITERATIONS;
+        const shouldCheckpoint = options?.checkpoint ?? false;
+        let state = { ...workflow.initialState, ...input };
+        const nodeResults = new Map();
+        const completedNodes = new Set();
+        let iterations = 0;
+        let checkpointId;
+        let error;
+        const graph = this.scheduler.buildDependencyGraph(workflow);
+        let currentNodes = [workflow.entryPoint];
+        try {
+            while (currentNodes.length > 0 && iterations < maxIterations) {
+                iterations++;
+                const nodesToRun = currentNodes.filter((n) => {
+                    return workflow.nodes.has(n);
+                });
+                if (nodesToRun.length === 0)
+                    break;
+                const tasks = nodesToRun.map((nodeName) => async () => {
+                    const node = workflow.nodes.get(nodeName);
+                    if (!node) {
+                        throw new Error(`Node '${nodeName}' not found`);
+                    }
+                    options?.onNodeStart?.(nodeName);
+                    const nodeStart = Date.now();
+                    const ctx = {
+                        state: { ...state },
+                        nodeId: nodeName,
+                        workflowId,
+                        step: iterations,
+                    };
+                    const deps = graph.dependencies.get(nodeName);
+                    if (deps && deps.size > 0) {
+                        const inputs = [];
+                        for (const dep of deps) {
+                            const depResult = nodeResults.get(dep);
+                            if (depResult) {
+                                inputs.push(depResult.output);
+                            }
+                        }
+                        ctx.input = inputs.length === 1 ? inputs[0] : inputs;
+                    }
+                    ctx.cogitator =
+                        this.cogitator;
+                    const result = await node.fn(ctx);
+                    const duration = Date.now() - nodeStart;
+                    options?.onNodeComplete?.(nodeName, result.output, duration);
+                    return { nodeName, result, duration };
+                });
+                const results = await this.scheduler.runParallel(tasks, maxConcurrency);
+                const nextNodes = [];
+                for (const { nodeName, result, duration } of results) {
+                    if (result.state) {
+                        state = { ...state, ...result.state };
+                    }
+                    nodeResults.set(nodeName, {
+                        output: result.output,
+                        duration,
+                    });
+                    completedNodes.add(nodeName);
+                    if (result.next) {
+                        const next = Array.isArray(result.next)
+                            ? result.next
+                            : [result.next];
+                        nextNodes.push(...next);
+                    }
+                    else {
+                        const edgeNext = this.scheduler.getNextNodes(workflow, nodeName, state);
+                        nextNodes.push(...edgeNext);
+                    }
+                }
+                if (shouldCheckpoint) {
+                    checkpointId = createCheckpointId();
+                    await this.checkpointStore.save({
+                        id: checkpointId,
+                        workflowId,
+                        workflowName: workflow.name,
+                        state,
+                        completedNodes: Array.from(completedNodes),
+                        nodeResults: Object.fromEntries(Array.from(nodeResults.entries()).map(([k, v]) => [k, v.output])),
+                        timestamp: Date.now(),
+                    });
+                }
+                currentNodes = [...new Set(nextNodes)];
+            }
+            if (iterations >= maxIterations) {
+                error = new Error(`Workflow exceeded max iterations (${maxIterations.toString()})`);
+            }
+        }
+        catch (e) {
+            error = e instanceof Error ? e : new Error(String(e));
+            options?.onNodeError?.(currentNodes[0] ?? 'unknown', error);
+        }
+        return {
+            workflowId,
+            workflowName: workflow.name,
+            state,
+            nodeResults,
+            duration: Date.now() - startTime,
+            checkpointId,
+            error,
+        };
+    }
+    /**
+     * Resume a workflow from a checkpoint
+     */
+    async resume(workflow, checkpointId, options) {
+        const checkpoint = await this.checkpointStore.load(checkpointId);
+        if (!checkpoint) {
+            throw new Error(`Checkpoint '${checkpointId}' not found`);
+        }
+        if (checkpoint.workflowName !== workflow.name) {
+            throw new Error(`Checkpoint workflow '${checkpoint.workflowName}' does not match '${workflow.name}'`);
+        }
+        const allNodes = new Set(workflow.nodes.keys());
+        const completed = new Set(checkpoint.completedNodes);
+        const pending = [...allNodes].filter((n) => !completed.has(n));
+        if (pending.length === 0) {
+            return {
+                workflowId: checkpoint.workflowId,
+                workflowName: workflow.name,
+                state: checkpoint.state,
+                nodeResults: new Map(Object.entries(checkpoint.nodeResults).map(([k, v]) => [
+                    k,
+                    { output: v, duration: 0 },
+                ])),
+                duration: 0,
+                checkpointId,
+            };
+        }
+        return this.execute(workflow, checkpoint.state, {
+            ...options,
+        });
+    }
+    /**
+     * Stream workflow execution events
+     */
+    async *stream(workflow, input, options) {
+        const events = [];
+        let resolveNext = null;
+        const pushEvent = (event) => {
+            events.push(event);
+            resolveNext?.();
+        };
+        const resultPromise = this.execute(workflow, input, {
+            ...options,
+            onNodeStart: (node) => {
+                pushEvent({ type: 'node:start', node, timestamp: Date.now() });
+            },
+            onNodeComplete: (node, output, duration) => {
+                pushEvent({ type: 'node:complete', node, output, duration });
+            },
+            onNodeError: (node, error) => {
+                pushEvent({ type: 'node:error', node, error });
+            },
+        });
+        while (true) {
+            if (events.length > 0) {
+                yield events.shift();
+            }
+            else {
+                const raceResult = await Promise.race([
+                    resultPromise.then((r) => ({ type: 'done', result: r })),
+                    new Promise((resolve) => {
+                        resolveNext = () => resolve({ type: 'event' });
+                    }),
+                ]);
+                if (raceResult.type === 'done') {
+                    while (events.length > 0) {
+                        yield events.shift();
+                    }
+                    yield {
+                        type: 'workflow:complete',
+                        state: raceResult.result.state,
+                        duration: raceResult.result.duration,
+                    };
+                    break;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,MAAM,OAAO,gBAAgB;IACnB,SAAS,CAAY;IACrB,eAAe,CAAkB;IACjC,SAAS,CAAoB;IAErC,YAAY,SAAoB,EAAE,eAAiC;QACjE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,eAAe,IAAI,IAAI,uBAAuB,EAAE,CAAC;QACxE,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,QAAqB,EACrB,KAAkB,EAClB,OAAgC;QAEhC,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,uBAAuB,CAAC;QAC1E,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,sBAAsB,CAAC;QACvE,MAAM,gBAAgB,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;QAEtD,IAAI,KAAK,GAAM,EAAE,GAAG,QAAQ,CAAC,YAAY,EAAE,GAAG,KAAK,EAAO,CAAC;QAC3D,MAAM,WAAW,GAAG,IAAI,GAAG,EAAiD,CAAC;QAC7E,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;QACzC,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,YAAgC,CAAC;QACrC,IAAI,KAAwB,CAAC;QAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAE5D,IAAI,YAAY,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAEzC,IAAI,CAAC;YACH,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,GAAG,aAAa,EAAE,CAAC;gBAC7D,UAAU,EAAE,CAAC;gBAEb,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;oBAC3C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC/B,CAAC,CAAC,CAAC;gBAEH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM;gBAEnC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE;oBACpD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;wBACV,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,aAAa,CAAC,CAAC;oBAClD,CAAC;oBAED,OAAO,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC;oBAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAE7B,MAAM,GAAG,GAAmB;wBAC1B,KAAK,EAAE,EAAE,GAAG,KAAK,EAAE;wBACnB,MAAM,EAAE,QAAQ;wBAChB,UAAU;wBACV,IAAI,EAAE,UAAU;qBACjB,CAAC;oBAEF,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAC9C,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;wBAC1B,MAAM,MAAM,GAAc,EAAE,CAAC;wBAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;4BACvB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;4BACvC,IAAI,SAAS,EAAE,CAAC;gCACd,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;4BAChC,CAAC;wBACH,CAAC;wBACD,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;oBACvD,CAAC;oBAEA,GAAiD,CAAC,SAAS;wBAC1D,IAAI,CAAC,SAAS,CAAC;oBAEjB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;oBAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBAExC,OAAO,EAAE,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;oBAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;gBACxC,CAAC,CAAC,CAAC;gBAEH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAC9C,KAAK,EACL,cAAc,CACf,CAAC;gBAEF,MAAM,SAAS,GAAa,EAAE,CAAC;gBAE/B,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,OAAO,EAAE,CAAC;oBACrD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjB,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,EAAO,CAAC;oBAC7C,CAAC;oBAED,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE;wBACxB,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,QAAQ;qBACT,CAAC,CAAC;oBAEH,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAE7B,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;wBAChB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;4BACrC,CAAC,CAAC,MAAM,CAAC,IAAI;4BACb,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;wBAClB,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;oBAC1B,CAAC;yBAAM,CAAC;wBACN,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAC1C,QAAQ,EACR,QAAQ,EACR,KAAK,CACN,CAAC;wBACF,SAAS,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;oBAC9B,CAAC;gBACH,CAAC;gBAED,IAAI,gBAAgB,EAAE,CAAC;oBACrB,YAAY,GAAG,kBAAkB,EAAE,CAAC;oBACpC,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;wBAC9B,EAAE,EAAE,YAAY;wBAChB,UAAU;wBACV,YAAY,EAAE,QAAQ,CAAC,IAAI;wBAC3B,KAAK;wBACL,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC;wBAC1C,WAAW,EAAE,MAAM,CAAC,WAAW,CAC7B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CACjE;wBACD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;qBACtB,CAAC,CAAC;gBACL,CAAC;gBAED,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;YACzC,CAAC;YAED,IAAI,UAAU,IAAI,aAAa,EAAE,CAAC;gBAChC,KAAK,GAAG,IAAI,KAAK,CACf,qCAAqC,aAAa,CAAC,QAAQ,EAAE,GAAG,CACjE,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,KAAK,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,OAAO,EAAE,WAAW,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,KAAK,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO;YACL,UAAU;YACV,YAAY,EAAE,QAAQ,CAAC,IAAI;YAC3B,KAAK;YACL,WAAW;YACX,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAChC,YAAY;YACZ,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,QAAqB,EACrB,YAAoB,EACpB,OAAgC;QAEhC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEjE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,eAAe,YAAY,aAAa,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,UAAU,CAAC,YAAY,KAAK,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,wBAAwB,UAAU,CAAC,YAAY,qBAAqB,QAAQ,CAAC,IAAI,GAAG,CACrF,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,UAAU,EAAE,UAAU,CAAC,UAAU;gBACjC,YAAY,EAAE,QAAQ,CAAC,IAAI;gBAC3B,KAAK,EAAE,UAAU,CAAC,KAAU;gBAC5B,WAAW,EAAE,IAAI,GAAG,CAClB,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;oBACrD,CAAC;oBACD,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE;iBAC3B,CAAC,CACH;gBACD,QAAQ,EAAE,CAAC;gBACX,YAAY;aACb,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,KAAmB,EAAE;YAC5D,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,CAAC,MAAM,CACX,QAAqB,EACrB,KAAkB,EAClB,OAAwF;QAExF,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,IAAI,WAAW,GAAwB,IAAI,CAAC;QAE5C,MAAM,SAAS,GAAG,CAAC,KAAoB,EAAE,EAAE;YACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnB,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE;YAClD,GAAG,OAAO;YACV,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;gBACpB,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;gBACzC,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBAC3B,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACjD,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,IAAI,EAAE,CAAC;YACZ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,MAAM,CAAC,KAAK,EAAG,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBACpC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;oBACjE,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,EAAE;wBACzC,WAAW,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;oBACjD,CAAC,CAAC;iBACH,CAAC,CAAC;gBAEH,IAAI,UAAU,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC/B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACzB,MAAM,MAAM,CAAC,KAAK,EAAG,CAAC;oBACxB,CAAC;oBAED,MAAM;wBACJ,IAAI,EAAE,mBAAmB;wBACzB,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK;wBAC9B,QAAQ,EAAE,UAAU,CAAC,MAAM,CAAC,QAAQ;qBACrC,CAAC;oBAEF,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/human/approval-store.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Approval Store implementations
+ *
+ * Features:
+ * - In-memory store for development/testing
+ * - File-based store for persistence
+ * - Response callbacks for async notifications
+ * - TTL-based cleanup
+ */
+import type { ApprovalStore, ApprovalRequest, ApprovalResponse } from '@cogitator-ai/types';
+/**
+ * In-memory approval store for development and testing
+ */
+export declare class InMemoryApprovalStore implements ApprovalStore {
+    private requests;
+    private responses;
+    private callbacks;
+    private ttl;
+    private cleanupInterval?;
+    constructor(options?: {
+        ttl?: number;
+        cleanupInterval?: number;
+    });
+    createRequest(request: ApprovalRequest): Promise<void>;
+    getRequest(id: string): Promise<ApprovalRequest | null>;
+    getPendingRequests(workflowId?: string): Promise<ApprovalRequest[]>;
+    getPendingForAssignee(assignee: string): Promise<ApprovalRequest[]>;
+    submitResponse(response: ApprovalResponse): Promise<void>;
+    getResponse(requestId: string): Promise<ApprovalResponse | null>;
+    deleteRequest(id: string): Promise<void>;
+    onResponse(requestId: string, callback: (response: ApprovalResponse) => void): () => void;
+    /**
+     * Clean up expired requests
+     */
+    private cleanup;
+    /**
+     * Stop cleanup interval
+     */
+    dispose(): void;
+    /**
+     * Get all requests (for debugging)
+     */
+    getAllRequests(): ApprovalRequest[];
+    /**
+     * Get all responses (for debugging)
+     */
+    getAllResponses(): ApprovalResponse[];
+    /**
+     * Clear all data
+     */
+    clear(): void;
+}
+/**
+ * File-based approval store for persistence across restarts
+ */
+export declare class FileApprovalStore implements ApprovalStore {
+    private readonly directory;
+    private callbacks;
+    private watchInterval?;
+    private lastResponseCheck;
+    constructor(options: {
+        directory: string;
+        pollInterval?: number;
+    });
+    private getRequestPath;
+    private getResponsePath;
+    createRequest(request: ApprovalRequest): Promise<void>;
+    getRequest(id: string): Promise<ApprovalRequest | null>;
+    getPendingRequests(workflowId?: string): Promise<ApprovalRequest[]>;
+    getPendingForAssignee(assignee: string): Promise<ApprovalRequest[]>;
+    submitResponse(response: ApprovalResponse): Promise<void>;
+    getResponse(requestId: string): Promise<ApprovalResponse | null>;
+    deleteRequest(id: string): Promise<void>;
+    onResponse(requestId: string, callback: (response: ApprovalResponse) => void): () => void;
+    /**
+     * Check for new responses (called by poll interval)
+     */
+    private checkForResponses;
+    /**
+     * Stop polling
+     */
+    dispose(): void;
+    /**
+     * Clean up expired requests
+     */
+    cleanup(maxAge: number): Promise<number>;
+}
+/**
+ * Create an approval store that delegates responses
+ * to another store (e.g., for delegation handling)
+ */
+export declare function withDelegation(store: ApprovalStore, options?: {
+    onDelegation?: (request: ApprovalRequest, from: string, to: string) => Promise<void>;
+}): ApprovalStore;
+//# sourceMappingURL=approval-store.d.ts.map

package/dist/human/approval-store.d.ts.map

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