anantham-v2 2.0.0-alpha.1

package/dist/workflow/dag-engine.d.ts

@@ -0,0 +1,31 @@
+import { type WorkflowDefinition, type WorkflowDAG } from "../domain/workflow.js";
+export interface DAGValidationResult {
+    valid: boolean;
+    errors: string[];
+    dag?: WorkflowDAG;
+}
+/**
+ * Deterministic Workflow DAG Engine & Cycle Detector.
+ * Computes topological execution plans, detects circular dependencies,
+ * and partitions execution into parallel wave levels.
+ * PRD Part 2 Section 116.
+ */
+export declare class DAGEngine {
+    /**
+     * Build a complete WorkflowDAG from a WorkflowDefinition.
+     */
+    buildDAG(workflow: WorkflowDefinition): WorkflowDAG;
+    /**
+     * Validate DAG structural integrity, dependency existence, and cycle absence.
+     */
+    validateDAG(workflow: WorkflowDefinition): DAGValidationResult;
+    /**
+     * Returns all transitive upstream prerequisites for a given node.
+     */
+    getUpstreamPrerequisites(nodeId: string, dag: WorkflowDAG): string[];
+    /**
+     * Returns all transitive downstream dependents of a given node.
+     */
+    getDownstreamDependents(nodeId: string, dag: WorkflowDAG): string[];
+}
+//# sourceMappingURL=dag-engine.d.ts.map

package/dist/workflow/dag-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-engine.d.ts","sourceRoot":"","sources":["../../src/workflow/dag-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAGjB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,WAAW,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB;;OAEG;IACI,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,WAAW;IAqF1D;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,mBAAmB;IAwCrE;;OAEG;IACI,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE;IAkB3E;;OAEG;IACI,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE;CAiB3E"}

package/dist/workflow/dag-engine.js

@@ -0,0 +1,156 @@
+import { WorkflowDAGSchema, } from "../domain/workflow.js";
+/**
+ * Deterministic Workflow DAG Engine & Cycle Detector.
+ * Computes topological execution plans, detects circular dependencies,
+ * and partitions execution into parallel wave levels.
+ * PRD Part 2 Section 116.
+ */
+export class DAGEngine {
+    /**
+     * Build a complete WorkflowDAG from a WorkflowDefinition.
+     */
+    buildDAG(workflow) {
+        const nodeMap = new Map();
+        const nodeIds = [];
+        // 1. Collect all node IDs
+        for (const node of workflow.tasks) {
+            nodeMap.set(node.id, node);
+            nodeIds.push(node.id);
+        }
+        const adjacencyList = {};
+        const reverseAdjacency = {};
+        const inDegree = {};
+        for (const id of nodeIds) {
+            adjacencyList[id] = [];
+            reverseAdjacency[id] = [];
+            inDegree[id] = 0;
+        }
+        // 2. Build Adjacency & Reverse Adjacency
+        for (const node of workflow.tasks) {
+            const deps = node.dependsOn || [];
+            for (const depId of deps) {
+                if (nodeMap.has(depId)) {
+                    adjacencyList[depId].push(node.id);
+                    reverseAdjacency[node.id].push(depId);
+                    inDegree[node.id] = (inDegree[node.id] || 0) + 1;
+                }
+            }
+        }
+        // 3. Kahn's Algorithm for Cycle Detection & Topological Level Partitioning
+        const inDegreeCopy = { ...inDegree };
+        const queue = [];
+        const levels = [];
+        // Find initial zero in-degree nodes
+        for (const id of nodeIds) {
+            if (inDegreeCopy[id] === 0) {
+                queue.push(id);
+            }
+        }
+        let processedCount = 0;
+        let currentWave = [...queue];
+        while (currentWave.length > 0) {
+            levels.push([...currentWave]);
+            const nextWave = [];
+            for (const nodeId of currentWave) {
+                processedCount++;
+                const neighbors = adjacencyList[nodeId] || [];
+                for (const neighbor of neighbors) {
+                    inDegreeCopy[neighbor]--;
+                    if (inDegreeCopy[neighbor] === 0) {
+                        nextWave.push(neighbor);
+                    }
+                }
+            }
+            currentWave = nextWave;
+        }
+        const hasCycles = processedCount < nodeIds.length;
+        let cycleNodes;
+        if (hasCycles) {
+            // Find all nodes that still have in-degree > 0
+            cycleNodes = nodeIds.filter((id) => (inDegreeCopy[id] || 0) > 0);
+        }
+        return WorkflowDAGSchema.parse({
+            workflowId: workflow.id,
+            nodeIds,
+            adjacencyList,
+            reverseAdjacency,
+            inDegree,
+            levels: hasCycles ? [] : levels,
+            hasCycles,
+            cycleNodes,
+        });
+    }
+    /**
+     * Validate DAG structural integrity, dependency existence, and cycle absence.
+     */
+    validateDAG(workflow) {
+        const errors = [];
+        const nodeIds = new Set();
+        // 1. Check duplicate IDs
+        for (const node of workflow.tasks) {
+            if (nodeIds.has(node.id)) {
+                errors.push(`Duplicate task/node ID "${node.id}" found in workflow.`);
+            }
+            nodeIds.add(node.id);
+        }
+        // 2. Check dependency existence and self-dependencies
+        for (const node of workflow.tasks) {
+            for (const depId of node.dependsOn || []) {
+                if (depId === node.id) {
+                    errors.push(`Node "${node.id}" has a self-dependency.`);
+                }
+                else if (!nodeIds.has(depId)) {
+                    errors.push(`Node "${node.id}" depends on unknown node "${depId}".`);
+                }
+            }
+        }
+        if (errors.length > 0) {
+            return { valid: false, errors };
+        }
+        // 3. Build DAG and check cycles
+        const dag = this.buildDAG(workflow);
+        if (dag.hasCycles) {
+            const cycleList = dag.cycleNodes ? dag.cycleNodes.join(", ") : "unknown";
+            errors.push(`Deadlock cycle detected in workflow DAG involving nodes: [${cycleList}].`);
+            return { valid: false, errors, dag };
+        }
+        return { valid: true, errors: [], dag };
+    }
+    /**
+     * Returns all transitive upstream prerequisites for a given node.
+     */
+    getUpstreamPrerequisites(nodeId, dag) {
+        const prerequisites = new Set();
+        const stack = [...(dag.reverseAdjacency[nodeId] || [])];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            if (!prerequisites.has(current)) {
+                prerequisites.add(current);
+                const parents = dag.reverseAdjacency[current] || [];
+                for (const p of parents) {
+                    stack.push(p);
+                }
+            }
+        }
+        return Array.from(prerequisites);
+    }
+    /**
+     * Returns all transitive downstream dependents of a given node.
+     */
+    getDownstreamDependents(nodeId, dag) {
+        const dependents = new Set();
+        const stack = [...(dag.adjacencyList[nodeId] || [])];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            if (!dependents.has(current)) {
+                dependents.add(current);
+                const children = dag.adjacencyList[current] || [];
+                for (const c of children) {
+                    stack.push(c);
+                }
+            }
+        }
+        return Array.from(dependents);
+    }
+}
+//# sourceMappingURL=dag-engine.js.map

package/dist/workflow/dag-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dag-engine.js","sourceRoot":"","sources":["../../src/workflow/dag-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAQ/B;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IACpB;;OAEG;IACI,QAAQ,CAAC,QAA4B;QAC1C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;QAChD,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,0BAA0B;QAC1B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,aAAa,GAA6B,EAAE,CAAC;QACnD,MAAM,gBAAgB,GAA6B,EAAE,CAAC;QACtD,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAE5C,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACzB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;YACvB,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;YAC1B,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;QAED,yCAAyC;QACzC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;YAClC,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;gBACzB,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBACvB,aAAa,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACpC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;QACH,CAAC;QAED,2EAA2E;QAC3E,MAAM,YAAY,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QACrC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAe,EAAE,CAAC;QAE9B,oCAAoC;QACpC,KAAK,MAAM,EAAE,IAAI,OAAO,EAAE,CAAC;YACzB,IAAI,YAAY,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAED,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QAE7B,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;YAC9B,MAAM,QAAQ,GAAa,EAAE,CAAC;YAE9B,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;gBACjC,cAAc,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC9C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;oBACjC,YAAY,CAAC,QAAQ,CAAE,EAAE,CAAC;oBAC1B,IAAI,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBACjC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC1B,CAAC;gBACH,CAAC;YACH,CAAC;YAED,WAAW,GAAG,QAAQ,CAAC;QACzB,CAAC;QAED,MAAM,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;QAClD,IAAI,UAAgC,CAAC;QAErC,IAAI,SAAS,EAAE,CAAC;YACd,+CAA+C;YAC/C,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,iBAAiB,CAAC,KAAK,CAAC;YAC7B,UAAU,EAAE,QAAQ,CAAC,EAAE;YACvB,OAAO;YACP,aAAa;YACb,gBAAgB;YAChB,QAAQ;YACR,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM;YAC/B,SAAS;YACT,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAA4B;QAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAElC,yBAAyB;QACzB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,CAAC,2BAA2B,IAAI,CAAC,EAAE,sBAAsB,CAAC,CAAC;YACxE,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;QAED,sDAAsD;QACtD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;gBACzC,IAAI,KAAK,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;oBACtB,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;gBAC1D,CAAC;qBAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC/B,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,8BAA8B,KAAK,IAAI,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAClC,CAAC;QAED,gCAAgC;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAClB,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACzE,MAAM,CAAC,IAAI,CACT,6DAA6D,SAAS,IAAI,CAC3E,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACvC,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;IAC1C,CAAC;IAED;;OAEG;IACI,wBAAwB,CAAC,MAAc,EAAE,GAAgB;QAC9D,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QACxC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAExD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;YAC7B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACpD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACxB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACI,uBAAuB,CAAC,MAAc,EAAE,GAAgB;QAC7D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAErD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;YAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7B,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACxB,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAClD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBACzB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/workflow/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Anantham V2 — Workflow Subsystem
+ * PRD Part 2 Foundation / P7.1
+ */
+export * from "./workflow-dsl.js";
+export * from "./dag-engine.js";
+export * from "./condition-evaluator.js";
+export * from "./workflow-validator.js";
+export * from "./workflow-registry.js";
+export * from "./workflow-budget-tracker.js";
+export * from "./workflow-retry-handler.js";
+export * from "./workflow-executor.js";
+export * from "./workflow-engine.js";
+export * from "./workflow-recovery-reconciler.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mCAAmC,CAAC"}

package/dist/workflow/index.js

@@ -0,0 +1,15 @@
+/**
+ * Anantham V2 — Workflow Subsystem
+ * PRD Part 2 Foundation / P7.1
+ */
+export * from "./workflow-dsl.js";
+export * from "./dag-engine.js";
+export * from "./condition-evaluator.js";
+export * from "./workflow-validator.js";
+export * from "./workflow-registry.js";
+export * from "./workflow-budget-tracker.js";
+export * from "./workflow-retry-handler.js";
+export * from "./workflow-executor.js";
+export * from "./workflow-engine.js";
+export * from "./workflow-recovery-reconciler.js";
+//# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mCAAmC,CAAC"}

package/dist/workflow/workflow-budget-tracker.d.ts

@@ -0,0 +1,41 @@
+import { type WorkflowBudget, type WorkflowBudgetConsumption, type WorkflowConcurrency } from "../domain/workflow.js";
+export interface BudgetCheckResult {
+    allowed: boolean;
+    reason?: string;
+}
+/**
+ * Hierarchical Workflow Budget & Concurrency Tracker.
+ * PRD Part 2 Section 118 & 161.
+ * Effective Limit = min(workflow limit, agent limit, team limit, global runtime limit).
+ */
+export declare class WorkflowBudgetTracker {
+    private readonly budget?;
+    private readonly concurrency?;
+    constructor(budget?: WorkflowBudget | undefined, concurrency?: WorkflowConcurrency | undefined);
+    /**
+     * Check whether a proposed token consumption is within limits.
+     */
+    checkTokenBudget(current: WorkflowBudgetConsumption, additionalTokens: number): BudgetCheckResult;
+    /**
+     * Check whether execution duration is within limits.
+     */
+    checkDurationBudget(startTimeIso: string): BudgetCheckResult;
+    /**
+     * Check whether cost budget is within limits.
+     */
+    checkCostBudget(current: WorkflowBudgetConsumption, additionalCostUsd: number): BudgetCheckResult;
+    /**
+     * Check active parallel concurrency bounds.
+     */
+    checkConcurrency(activeTasksCount: number): BudgetCheckResult;
+    /**
+     * Records newly consumed tokens, cost, duration, and tool calls.
+     */
+    recordConsumption(current: WorkflowBudgetConsumption, delta: {
+        tokens?: number;
+        costUsd?: number;
+        durationMs?: number;
+        toolCalls?: number;
+    }): WorkflowBudgetConsumption;
+}
+//# sourceMappingURL=workflow-budget-tracker.d.ts.map

package/dist/workflow/workflow-budget-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-budget-tracker.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-budget-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBADZ,MAAM,CAAC,EAAE,cAAc,YAAA,EACvB,WAAW,CAAC,EAAE,mBAAmB,YAAA;IAGpD;;OAEG;IACI,gBAAgB,CAAC,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,GAAG,iBAAiB;IAYxG;;OAEG;IACI,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB;IAYnE;;OAEG;IACI,eAAe,CAAC,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,GAAG,iBAAiB;IAYxG;;OAEG;IACI,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,iBAAiB;IAWpE;;OAEG;IACI,iBAAiB,CACtB,OAAO,EAAE,yBAAyB,EAClC,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACpF,yBAAyB;CAQ7B"}

package/dist/workflow/workflow-budget-tracker.js

@@ -0,0 +1,83 @@
+/**
+ * Hierarchical Workflow Budget & Concurrency Tracker.
+ * PRD Part 2 Section 118 & 161.
+ * Effective Limit = min(workflow limit, agent limit, team limit, global runtime limit).
+ */
+export class WorkflowBudgetTracker {
+    budget;
+    concurrency;
+    constructor(budget, concurrency) {
+        this.budget = budget;
+        this.concurrency = concurrency;
+    }
+    /**
+     * Check whether a proposed token consumption is within limits.
+     */
+    checkTokenBudget(current, additionalTokens) {
+        if (!this.budget?.maxTokens)
+            return { allowed: true };
+        const projected = current.tokens + additionalTokens;
+        if (projected > this.budget.maxTokens) {
+            return {
+                allowed: false,
+                reason: `Token budget exceeded: projected ${projected} tokens exceeds maximum limit of ${this.budget.maxTokens}.`,
+            };
+        }
+        return { allowed: true };
+    }
+    /**
+     * Check whether execution duration is within limits.
+     */
+    checkDurationBudget(startTimeIso) {
+        if (!this.budget?.maxDurationMs)
+            return { allowed: true };
+        const elapsed = Date.now() - new Date(startTimeIso).getTime();
+        if (elapsed > this.budget.maxDurationMs) {
+            return {
+                allowed: false,
+                reason: `Workflow duration exceeded: elapsed ${elapsed}ms exceeds maximum allowed ${this.budget.maxDurationMs}ms.`,
+            };
+        }
+        return { allowed: true };
+    }
+    /**
+     * Check whether cost budget is within limits.
+     */
+    checkCostBudget(current, additionalCostUsd) {
+        if (!this.budget?.maxCostUsd)
+            return { allowed: true };
+        const projected = current.costUsd + additionalCostUsd;
+        if (projected > this.budget.maxCostUsd) {
+            return {
+                allowed: false,
+                reason: `Cost budget exceeded: projected $${projected.toFixed(4)} exceeds maximum limit of $${this.budget.maxCostUsd.toFixed(4)}.`,
+            };
+        }
+        return { allowed: true };
+    }
+    /**
+     * Check active parallel concurrency bounds.
+     */
+    checkConcurrency(activeTasksCount) {
+        const maxTasks = this.concurrency?.maxParallelTasks ?? 8;
+        if (activeTasksCount >= maxTasks) {
+            return {
+                allowed: false,
+                reason: `Parallel concurrency limit reached: ${activeTasksCount} active tasks (max: ${maxTasks}).`,
+            };
+        }
+        return { allowed: true };
+    }
+    /**
+     * Records newly consumed tokens, cost, duration, and tool calls.
+     */
+    recordConsumption(current, delta) {
+        return {
+            tokens: current.tokens + (delta.tokens || 0),
+            costUsd: current.costUsd + (delta.costUsd || 0),
+            durationMs: current.durationMs + (delta.durationMs || 0),
+            toolCalls: current.toolCalls + (delta.toolCalls || 0),
+        };
+    }
+}
+//# sourceMappingURL=workflow-budget-tracker.js.map

package/dist/workflow/workflow-budget-tracker.js.map

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

package/dist/workflow/workflow-dsl.d.ts

@@ -0,0 +1,74 @@
+import { type WorkflowDefinition, type WorkflowTaskNode, type WorkflowParallelNode, type WorkflowForeachNode, type WorkflowVerifyNode, type WorkflowApproveNode, type WorkflowCondition, type WorkflowNode, type WorkflowScope } from "../domain/workflow.js";
+export interface DefineWorkflowInput {
+    id?: string;
+    projectId?: string;
+    name: string;
+    version?: string;
+    scope?: WorkflowScope;
+    description?: string;
+    concurrency?: {
+        maxAgents?: number;
+        maxParallelTasks?: number;
+    };
+    budget?: {
+        maxTokens?: number;
+        maxCostUsd?: number;
+        maxDurationMs?: number;
+    };
+    tasks: WorkflowNode[];
+    verify?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Fluent builder for creating type-safe workflow definitions.
+ * PRD Part 2 Section 109 & 110.
+ */
+export declare function defineWorkflow(input: DefineWorkflowInput): WorkflowDefinition;
+/**
+ * Fluent builder for single task node.
+ */
+export declare function task(id: string, options: {
+    agentId: string;
+    title?: string;
+    description?: string;
+    modelProfile?: string;
+    dependsOn?: string[];
+    condition?: WorkflowCondition;
+    timeoutMs?: number;
+    maxRetries?: number;
+    budgetTokens?: number;
+    inputs?: Record<string, unknown>;
+    outputs?: string[];
+    requiredCapabilities?: string[];
+    targetFiles?: string[];
+    readOnlyFiles?: string[];
+}): WorkflowTaskNode;
+/**
+ * Fluent builder for parallel tasks node.
+ */
+export declare function parallel(id: string, tasks: WorkflowTaskNode[], options?: {
+    maxConcurrency?: number;
+    dependsOn?: string[];
+}): WorkflowParallelNode;
+/**
+ * Fluent builder for foreach iteration node.
+ */
+export declare function foreach(id: string, collection: string, iteratorVariable: string, taskNode: WorkflowTaskNode, options?: {
+    maxConcurrency?: number;
+    dependsOn?: string[];
+}): WorkflowForeachNode;
+/**
+ * Fluent builder for automated verification node.
+ */
+export declare function verify(id: string, assertions: string[], options?: {
+    dependsOn?: string[];
+}): WorkflowVerifyNode;
+/**
+ * Fluent builder for human-in-the-loop approval gate node.
+ */
+export declare function approve(id: string, message: string, options?: {
+    requiredRole?: string;
+    timeoutMs?: number;
+    dependsOn?: string[];
+}): WorkflowApproveNode;
+//# sourceMappingURL=workflow-dsl.d.ts.map

package/dist/workflow/workflow-dsl.d.ts.map

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

package/dist/workflow/workflow-dsl.js

@@ -0,0 +1,103 @@
+import { randomUUID } from "node:crypto";
+import { WorkflowDefinitionSchema, WorkflowTaskNodeSchema, WorkflowParallelNodeSchema, WorkflowForeachNodeSchema, WorkflowVerifyNodeSchema, WorkflowApproveNodeSchema, } from "../domain/workflow.js";
+/**
+ * Fluent builder for creating type-safe workflow definitions.
+ * PRD Part 2 Section 109 & 110.
+ */
+export function defineWorkflow(input) {
+    const now = new Date().toISOString();
+    const raw = {
+        id: input.id || randomUUID(),
+        projectId: input.projectId,
+        name: input.name,
+        version: input.version || "1.0.0",
+        scope: input.scope || "project",
+        description: input.description,
+        status: "ACTIVE",
+        concurrency: {
+            maxAgents: input.concurrency?.maxAgents ?? 4,
+            maxParallelTasks: input.concurrency?.maxParallelTasks ?? 8,
+        },
+        budget: input.budget,
+        tasks: input.tasks,
+        verify: input.verify ?? [],
+        metadata: input.metadata ?? {},
+        createdAt: now,
+        updatedAt: now,
+    };
+    return WorkflowDefinitionSchema.parse(raw);
+}
+/**
+ * Fluent builder for single task node.
+ */
+export function task(id, options) {
+    return WorkflowTaskNodeSchema.parse({
+        kind: "task",
+        id,
+        agentId: options.agentId,
+        title: options.title,
+        description: options.description,
+        modelProfile: options.modelProfile,
+        dependsOn: options.dependsOn ?? [],
+        condition: options.condition,
+        timeoutMs: options.timeoutMs,
+        maxRetries: options.maxRetries ?? 3,
+        budgetTokens: options.budgetTokens,
+        inputs: options.inputs ?? {},
+        outputs: options.outputs ?? [],
+        requiredCapabilities: options.requiredCapabilities ?? [],
+        targetFiles: options.targetFiles ?? [],
+        readOnlyFiles: options.readOnlyFiles ?? [],
+    });
+}
+/**
+ * Fluent builder for parallel tasks node.
+ */
+export function parallel(id, tasks, options) {
+    return WorkflowParallelNodeSchema.parse({
+        kind: "parallel",
+        id,
+        tasks,
+        maxConcurrency: options?.maxConcurrency,
+        dependsOn: options?.dependsOn ?? [],
+    });
+}
+/**
+ * Fluent builder for foreach iteration node.
+ */
+export function foreach(id, collection, iteratorVariable, taskNode, options) {
+    return WorkflowForeachNodeSchema.parse({
+        kind: "foreach",
+        id,
+        collection,
+        iteratorVariable,
+        task: taskNode,
+        maxConcurrency: options?.maxConcurrency,
+        dependsOn: options?.dependsOn ?? [],
+    });
+}
+/**
+ * Fluent builder for automated verification node.
+ */
+export function verify(id, assertions, options) {
+    return WorkflowVerifyNodeSchema.parse({
+        kind: "verify",
+        id,
+        assertions,
+        dependsOn: options?.dependsOn ?? [],
+    });
+}
+/**
+ * Fluent builder for human-in-the-loop approval gate node.
+ */
+export function approve(id, message, options) {
+    return WorkflowApproveNodeSchema.parse({
+        kind: "approve",
+        id,
+        message,
+        requiredRole: options?.requiredRole,
+        timeoutMs: options?.timeoutMs,
+        dependsOn: options?.dependsOn ?? [],
+    });
+}
+//# sourceMappingURL=workflow-dsl.js.map

package/dist/workflow/workflow-dsl.js.map

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

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

@@ -0,0 +1,63 @@
+import { type WorkflowDefinition, type WorkflowRun } from "../domain/workflow.js";
+import { EventStore } from "../event-state/event-store.js";
+import { WorkflowRepository } from "../persistence/repositories/workflow-repository.js";
+import { WorkflowRegistry } from "./workflow-registry.js";
+import { type TaskDispatcherFn } from "./workflow-executor.js";
+export interface StartWorkflowOptions {
+    projectId?: string;
+    environmentContext?: {
+        pluginVersions?: Record<string, string>;
+        skillVersions?: Record<string, string>;
+        agentVersions?: Record<string, string>;
+        modelProfile?: string;
+    };
+    taskDispatcher?: TaskDispatcherFn;
+}
+export interface ApprovalInput {
+    decision: "APPROVED" | "REJECTED";
+    approverId?: string;
+    notes?: string;
+}
+/**
+ * Top-Level Workflow Orchestration Engine.
+ * Manages the full lifecycle of workflows and active runs:
+ * start, pause, resume, cancel, approval gates, and crash recovery.
+ * PRD Part 2 Section 109–135.
+ */
+export declare class WorkflowEngine {
+    private readonly workflowRepo;
+    private readonly registry;
+    private readonly executor;
+    private readonly eventStore?;
+    constructor(options: {
+        workflowRepo: WorkflowRepository;
+        registry: WorkflowRegistry;
+        eventStore?: EventStore;
+        taskDispatcher?: TaskDispatcherFn;
+    });
+    /**
+     * Start and execute a new workflow run.
+     */
+    startWorkflow(workflowOrName: WorkflowDefinition | string, sessionId: string, options?: StartWorkflowOptions): Promise<WorkflowRun>;
+    /**
+     * Pause an active workflow run.
+     */
+    pauseWorkflow(runId: string, reason?: string): Promise<WorkflowRun>;
+    /**
+     * Resume a paused workflow run.
+     */
+    resumeWorkflow(runId: string): Promise<WorkflowRun>;
+    /**
+     * Cancel an active workflow run.
+     */
+    cancelWorkflow(runId: string, reason?: string): Promise<WorkflowRun>;
+    /**
+     * Authoritative external human approval resolution for a waiting gate.
+     */
+    approveGate(runId: string, nodeId: string, approval: ApprovalInput): Promise<WorkflowRun>;
+    /**
+     * Get the current live state of a workflow run.
+     */
+    getRunStatus(runId: string): WorkflowRun | null;
+}
+//# sourceMappingURL=workflow-engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-engine.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-engine.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEjF,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,cAAc,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAa;gBAE7B,OAAO,EAAE;QACnB,YAAY,EAAE,kBAAkB,CAAC;QACjC,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,cAAc,CAAC,EAAE,gBAAgB,CAAC;KACnC;IAWD;;OAEG;IACU,aAAa,CACxB,cAAc,EAAE,kBAAkB,GAAG,MAAM,EAC3C,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,WAAW,CAAC;IA6BvB;;OAEG;IACU,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAoC3F;;OAEG;IACU,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAyChE;;OAEG;IACU,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;IAuD9F;;OAEG;IACU,WAAW,CACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC;IAsEvB;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;CAGvD"}