veryfront 0.1.49 → 0.1.51

package/esm/src/workflow/dsl/loop.js

@@ -1,19 +1,28 @@
 import { validateNodeId } from "./validation.js";
+import { INVALID_ARGUMENT } from "../../errors/index.js";
+/** Default maximum number of loop iterations */
+const DEFAULT_MAX_ITERATIONS = 10;
+/** Absolute upper bound on loop iterations to prevent runaway loops */
+const MAX_ITERATIONS_LIMIT = 100;
 export function loop(id, options) {
     validateNodeId(id);
     if (typeof options.while !== "function") {
-        throw new Error(`Loop "${id}" must have a 'while' condition function`);
+        throw INVALID_ARGUMENT.create({
+            detail: `Loop "${id}" must have a 'while' condition function`,
+        });
     }
     if (!options.steps) {
-        throw new Error(`Loop "${id}" must have 'steps' configured`);
+        throw INVALID_ARGUMENT.create({ detail: `Loop "${id}" must have 'steps' configured` });
     }
-    const maxIterations = options.maxIterations ?? 10;
+    const maxIterations = options.maxIterations ?? DEFAULT_MAX_ITERATIONS;
     if (maxIterations < 1) {
-        throw new Error(`Loop "${id}" maxIterations must be at least 1`);
+        throw INVALID_ARGUMENT.create({ detail: `Loop "${id}" maxIterations must be at least 1` });
     }
-    if (maxIterations > 100) {
-        throw new Error(`Loop "${id}" maxIterations cannot exceed 100 (got ${maxIterations}). ` +
-            `For higher limits, consider restructuring your workflow.`);
+    if (maxIterations > MAX_ITERATIONS_LIMIT) {
+        throw INVALID_ARGUMENT.create({
+            detail: `Loop "${id}" maxIterations cannot exceed ${MAX_ITERATIONS_LIMIT} (got ${maxIterations}). ` +
+                `For higher limits, consider restructuring your workflow.`,
+        });
     }
     return {
         id,

package/esm/src/workflow/dsl/map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IACpE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAClF,SAAS,EAAE,YAAY,GAAG,kBAAkB,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,YAAY,CAkBjE"}
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,YAAY,EACb,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,UAAW,SAAQ,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IACpE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAClF,SAAS,EAAE,YAAY,GAAG,kBAAkB,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,YAAY,CAwBjE"}

package/esm/src/workflow/dsl/map.js

@@ -1,10 +1,15 @@
 import { validateNodeId } from "./validation.js";
+import { INVALID_ARGUMENT } from "../../errors/index.js";
 export function map(id, options) {
     validateNodeId(id);
-    if (!options.items)
-        throw new Error(`Map node "${id}" must have 'items' configured`);
-    if (!options.processor)
-        throw new Error(`Map node "${id}" must have a 'processor' configured`);
+    if (!options.items) {
+        throw INVALID_ARGUMENT.create({ detail: `Map node "${id}" must have 'items' configured` });
+    }
+    if (!options.processor) {
+        throw INVALID_ARGUMENT.create({
+            detail: `Map node "${id}" must have a 'processor' configured`,
+        });
+    }
     const config = {
         type: "map",
         items: options.items,

package/esm/src/workflow/dsl/parallel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/parallel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,WAAW,EACX,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IACzE,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CACtB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,GAAE,eAAoB,GAC5B,YAAY,CA8Bd"}
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/parallel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,WAAW,EACX,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IACzE,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC;IACzC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CACtB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,GAAE,eAAoB,GAC5B,YAAY,CAgCd"}

package/esm/src/workflow/dsl/parallel.js

@@ -1,14 +1,19 @@
 import { validateNodeId } from "./validation.js";
+import { INVALID_ARGUMENT } from "../../errors/index.js";
 /** Create a parallel node for concurrent execution of multiple steps. */
 export function parallel(id, nodes, options = {}) {
     validateNodeId(id);
     if (nodes.length === 0) {
-        throw new Error(`Parallel node "${id}" must have at least one child node`);
+        throw INVALID_ARGUMENT.create({
+            detail: `Parallel node "${id}" must have at least one child node`,
+        });
     }
     const prefix = `${id}/`;
     const prefixedNodes = nodes.map((node, index) => {
         if (typeof node.id !== "string" || node.id.length === 0) {
-            throw new Error(`Child node at index ${index} in parallel "${id}" has invalid ID`);
+            throw INVALID_ARGUMENT.create({
+                detail: `Child node at index ${index} in parallel "${id}" has invalid ID`,
+            });
         }
         const childId = node.id.startsWith(prefix) ? node.id : `${prefix}${node.id}`;
         return { ...node, id: childId };

package/esm/src/workflow/dsl/step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EAEX,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IACrE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC;IACnF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,YAAY,CA0BnE;AAED,wBAAgB,SAAS,CACvB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GAAG,KAAK,EACrB,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,GAC5C,YAAY,CAEd;AAED,wBAAgB,QAAQ,CACtB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,GAC5C,YAAY,CAEd"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EAEX,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IACrE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC;IACnF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,YAAY,CA4BnE;AAED,wBAAgB,SAAS,CACvB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GAAG,KAAK,EACrB,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,GAC5C,YAAY,CAEd;AAED,wBAAgB,QAAQ,CACtB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,GAC5C,YAAY,CAEd"}

package/esm/src/workflow/dsl/step.js

@@ -1,13 +1,16 @@
 import { validateNodeId } from "./validation.js";
+import { INVALID_ARGUMENT } from "../../errors/index.js";
 export function step(id, options) {
     validateNodeId(id);
     const hasAgent = options.agent != null;
     const hasTool = options.tool != null;
     if (!hasAgent && !hasTool) {
-        throw new Error(`Step "${id}" must specify either 'agent' or 'tool'`);
+        throw INVALID_ARGUMENT.create({ detail: `Step "${id}" must specify either 'agent' or 'tool'` });
     }
     if (hasAgent && hasTool) {
-        throw new Error(`Step "${id}" cannot specify both 'agent' and 'tool'`);
+        throw INVALID_ARGUMENT.create({
+            detail: `Step "${id}" cannot specify both 'agent' and 'tool'`,
+        });
     }
     const config = {
         type: "step",

package/esm/src/workflow/dsl/sub-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sub-workflow.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/sub-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,eAAe,EACf,kBAAkB,EAClB,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC;IAC1D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CACvC;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,YAAY,CAmBjF"}
+{"version":3,"file":"sub-workflow.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/sub-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,eAAe,EACf,kBAAkB,EAClB,YAAY,EACb,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC;IAC1D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CACvC;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,YAAY,CAqBjF"}

package/esm/src/workflow/dsl/sub-workflow.js

@@ -1,9 +1,12 @@
 import { validateNodeId } from "./validation.js";
+import { INVALID_ARGUMENT } from "../../errors/index.js";
 /** Create a sub-workflow node for nested execution. */
 export function subWorkflow(id, options) {
     validateNodeId(id);
     if (!options.workflow) {
-        throw new Error(`SubWorkflow node "${id}" must have a 'workflow' configured`);
+        throw INVALID_ARGUMENT.create({
+            detail: `SubWorkflow node "${id}" must have a 'workflow' configured`,
+        });
     }
     const config = {
         type: "subWorkflow",

package/esm/src/workflow/dsl/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/validation.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAI/C"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/validation.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAI/C"}

package/esm/src/workflow/dsl/validation.js

@@ -1,6 +1,7 @@
+import { INVALID_ARGUMENT } from "../../errors/index.js";
 /** Validate that a node ID is a non-empty string */
 export function validateNodeId(id) {
     if (!id.trim()) {
-        throw new Error("Node ID must be a non-empty string");
+        throw INVALID_ARGUMENT.create({ detail: "Node ID must be a non-empty string" });
     }
 }

package/esm/src/workflow/dsl/wait.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/wait.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG9F,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,YAAY,CAiB9F;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAmBnF;AAED,wCAAwC;AACxC,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAazE"}
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/wait.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI9F,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,YAAY,CAiB9F;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAmBnF;AAED,wCAAwC;AACxC,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAazE"}

package/esm/src/workflow/dsl/wait.js

@@ -1,4 +1,5 @@
 import { validateNodeId } from "./validation.js";
+import { INVALID_ARGUMENT } from "../../errors/index.js";
 /** Create a wait-for-approval node. Pauses until human approves/rejects. */
 export function waitForApproval(id, options = {}) {
     validateNodeId(id);
@@ -21,7 +22,7 @@ export function waitForApproval(id, options = {}) {
 export function waitForEvent(id, options) {
     validateNodeId(id);
     if (!options.eventName) {
-        throw new Error(`waitForEvent "${id}" must specify an eventName`);
+        throw INVALID_ARGUMENT.create({ detail: `waitForEvent "${id}" must specify an eventName` });
     }
     return {
         id,

package/esm/src/workflow/dsl/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/workflow.ts"],"names":[],"mappings":"AAAA;;;;4BAI4B;AAE5B,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,eAAe,EAEf,YAAY,EACb,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,EACD,YAAY,EAAE,GACd,CAAC,CAAC,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,UAAU,CAAC,EAAE,CACX,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,eAAe,KACrB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,QAAQ,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC1D,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CA6B3B;AAED,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CASjE;AAED,KAAK,YAAY,GAAG,YAAY,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE/E,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,YAAY,EAAE,CAwBvE;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,YAAY,EAClB,GAAG,YAAY,EAAE,MAAM,EAAE,GACxB,YAAY,CAKd"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/dsl/workflow.ts"],"names":[],"mappings":"AAAA;;;;4BAI4B;AAE5B,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,QAAQ,EACR,eAAe,EAEf,YAAY,EACb,MAAM,aAAa,CAAC;AAIrB,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,EACD,YAAY,EAAE,GACd,CAAC,CAAC,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,UAAU,CAAC,EAAE,CACX,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,eAAe,KACrB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,QAAQ,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC1D,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,GACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CA+B3B;AAED,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CASjE;AAED,KAAK,YAAY,GAAG,YAAY,GAAG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE/E,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,YAAY,EAAE,CAwBvE;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,YAAY,EAClB,GAAG,YAAY,EAAE,MAAM,EAAE,GACxB,YAAY,CAKd"}

package/esm/src/workflow/dsl/workflow.js

@@ -4,11 +4,13 @@
  * Main factory function for creating durable workflows
  **************************/
 import { workflowRegistry } from "../registry.js";
+import { INVALID_ARGUMENT } from "../../errors/index.js";
 export function workflow(options) {
     if (!options.id)
-        throw new Error("Workflow must have an 'id'");
-    if (!options.steps)
-        throw new Error(`Workflow "${options.id}" must have 'steps'`);
+        throw INVALID_ARGUMENT.create({ detail: "Workflow must have an 'id'" });
+    if (!options.steps) {
+        throw INVALID_ARGUMENT.create({ detail: `Workflow "${options.id}" must have 'steps'` });
+    }
     const definition = {
         id: options.id,
         description: options.description,
@@ -50,7 +52,7 @@ export function dag(nodes) {
         const baseNode = isWithDeps ? value.node : value;
         const nodeId = baseNode.id || id;
         if (seenIds.has(nodeId)) {
-            throw new Error(`Duplicate node ID detected in dag: "${nodeId}"`);
+            throw INVALID_ARGUMENT.create({ detail: `Duplicate node ID detected in dag: "${nodeId}"` });
         }
         seenIds.add(nodeId);
         result.push(isWithDeps

package/esm/src/workflow/executor/dag/graph.d.ts

@@ -1,12 +1,12 @@
 import type { NodeState, WorkflowNode } from "../../types.js";
-export interface DAGGraph {
+interface DAGGraph {
     adjList: Map<string, string[]>;
     inDegree: Map<string, number>;
     nodeMap: Map<string, WorkflowNode>;
 }
-export declare function hasAnyDependents(nodes: WorkflowNode[], nodeId: string): boolean;
 export declare function buildGraph(nodes: WorkflowNode[]): DAGGraph;
 export declare function getReadyNodes(inDegree: Map<string, number>, nodeStates: Record<string, NodeState>): string[];
 export declare function hasCycle(nodes: WorkflowNode[], adjList: Map<string, string[]>): boolean;
 export declare function updateInDegreesForCompletedNodes(nodeStates: Record<string, NodeState>, adjList: Map<string, string[]>, inDegree: Map<string, number>): void;
+export {};
 //# sourceMappingURL=graph.d.ts.map

package/esm/src/workflow/executor/dag/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/executor/dag/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9D,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACpC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,QAAQ,CAkD1D;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,MAAM,EAAE,CAWV;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC7B,OAAO,CAyBT;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACrC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,IAAI,CASN"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/executor/dag/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9D,UAAU,QAAQ;IAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACpC;AAMD,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,QAAQ,CAoD1D;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GACpC,MAAM,EAAE,CAWV;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC7B,OAAO,CAyBT;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACrC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,IAAI,CASN"}

package/esm/src/workflow/executor/dag/graph.js

@@ -1,4 +1,5 @@
-export function hasAnyDependents(nodes, nodeId) {
+import { INVALID_ARGUMENT } from "../../../errors/index.js";
+function hasAnyDependents(nodes, nodeId) {
     return nodes.some((n) => n.dependsOn?.includes(nodeId));
 }
 export function buildGraph(nodes) {
@@ -14,7 +15,9 @@ export function buildGraph(nodes) {
         for (const dep of node.dependsOn ?? []) {
             const dependents = adjList.get(dep);
             if (!dependents) {
-                throw new Error(`Node "${node.id}" depends on unknown node "${dep}"`);
+                throw INVALID_ARGUMENT.create({
+                    detail: `Node "${node.id}" depends on unknown node "${dep}"`,
+                });
             }
             dependents.push(node.id);
             inDegree.set(node.id, (inDegree.get(node.id) ?? 0) + 1);

package/esm/src/workflow/executor/dag/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/executor/dag/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAYV,YAAY,EAEZ,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE7F,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAIpB,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,EAAE,iBAAiB;IAQ/B,OAAO,CACX,KAAK,EAAE,YAAY,EAAE,EACrB,GAAG,EAAE,WAAW,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,CAAC;YAsGhB,WAAW;YA6CX,eAAe;YA0Bf,mBAAmB;YA0CnB,cAAc;YAmGd,iBAAiB;YA6DjB,eAAe;YA8Bf,sBAAsB;YA8DtB,eAAe;YA6If,UAAU;CAoBzB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/executor/dag/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAYV,YAAY,EAEZ,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAIxB,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE7F,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAIpB,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,EAAE,iBAAiB;IAQ/B,OAAO,CACX,KAAK,EAAE,YAAY,EAAE,EACrB,GAAG,EAAE,WAAW,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,kBAAkB,CAAC;YAsGhB,WAAW;YA8CX,eAAe;YA0Bf,mBAAmB;YA0CnB,cAAc;YAmGd,iBAAiB;YA6DjB,eAAe;YA8Bf,sBAAsB;YA+DtB,eAAe;YA6If,UAAU;CAoBzB"}

package/esm/src/workflow/executor/dag/index.js

@@ -6,6 +6,7 @@
  * @module ai/workflow/executor/dag
  */
 import { generateId, parseDuration } from "../../types.js";
+import { INVALID_ARGUMENT, NOT_SUPPORTED } from "../../../errors/index.js";
 import { deriveNodeStatus, shouldCheckpoint, sleep } from "./utils.js";
 import { buildGraph, getReadyNodes, hasCycle, updateInDegreesForCompletedNodes } from "./graph.js";
 export class DAGExecutor {
@@ -127,8 +128,10 @@ export class DAGExecutor {
             case "loop":
                 return this.executeLoopNode(node, config, context, nodeStates);
             default:
-                throw new Error(`Unknown node type "${config.type}" for node "${node.id}". ` +
-                    "Valid types are: step, parallel, map, branch, wait, subWorkflow, loop");
+                throw INVALID_ARGUMENT.create({
+                    detail: `Unknown node type "${config.type}" for node "${node.id}". ` +
+                        "Valid types are: step, parallel, map, branch, wait, subWorkflow, loop",
+                });
         }
     }
     async executeStepNode(node, context) {
@@ -185,7 +188,7 @@ export class DAGExecutor {
         const startTime = Date.now();
         const items = typeof config.items === "function" ? await config.items(context) : config.items;
         if (!Array.isArray(items)) {
-            throw new Error(`Map node "${node.id}" items must be an array`);
+            throw INVALID_ARGUMENT.create({ detail: `Map node "${node.id}" items must be an array` });
         }
         if (items.length === 0) {
             const state = {
@@ -330,7 +333,9 @@ export class DAGExecutor {
     async executeSubWorkflowNode(node, config, context) {
         const startTime = Date.now();
         if (typeof config.workflow === "string") {
-            throw new Error("Resolving workflow by ID is not yet supported in this execution context. Pass the WorkflowDefinition object.");
+            throw NOT_SUPPORTED.create({
+                detail: "Resolving workflow by ID is not yet supported in this execution context. Pass the WorkflowDefinition object.",
+            });
         }
         const workflowDef = config.workflow;
         const input = typeof config.input === "function"

package/esm/src/workflow/executor/dag/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/executor/dag/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/D,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAIjF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE5D;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/executor/dag/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/D,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,CAIjF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE5D;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/C"}

package/esm/src/workflow/executor/dag/utils.js

@@ -10,5 +10,6 @@ export function shouldCheckpoint(node) {
     return node.config.checkpoint ?? false;
 }
 export function sleep(ms) {
+    // no cleanup needed: one-shot
     return new Promise((resolve) => dntShim.setTimeout(resolve, ms));
 }

package/esm/src/workflow/executor/step-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step-executor.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/executor/step-executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,KAAK,EACV,qBAAqB,EACrB,SAAS,EAGT,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AASpD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,qBAAqB,GAAG,SAAS,CAErE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,MAAM,EAAE,qBAAqB,GAAG,SAAS,EACzC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAGZ;AAWD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IACnC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3D,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,GAAE,kBAAuB;IAIrC,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAkEhF,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,KAAK;YAIC,YAAY;YASZ,kBAAkB;YAoBlB,WAAW;YAUX,YAAY;YAkBZ,WAAW;IASzB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAIT,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAMhF,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAI7C,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS;IAI9E,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,GAAG,SAAS;IAU7E,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;CAG9C"}
+{"version":3,"file":"step-executor.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/executor/step-executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAiB,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAUhD,OAAO,KAAK,EACV,qBAAqB,EACrB,SAAS,EAGT,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AASpD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,qBAAqB,GAAG,SAAS,CAErE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,MAAM,EAAE,qBAAqB,GAAG,SAAS,EACzC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAGZ;AAiBD,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IACnC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3D,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,GAAE,kBAAuB;IAIrC,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAmEhF,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,KAAK;YAKC,YAAY;YASZ,kBAAkB;YAoBlB,WAAW;YAUX,YAAY;YAkBZ,WAAW;IASzB,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,OAAO;IAIT,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAMhF,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAI7C,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS;IAI9E,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,GAAG,SAAS;IAU7E,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;CAG9C"}

package/esm/src/workflow/executor/step-executor.js

@@ -1,6 +1,7 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { ensureError } from "../../errors/veryfront-error.js";
+import { AGENT_NOT_FOUND, INITIALIZATION_ERROR, INVALID_ARGUMENT, ORCHESTRATION_ERROR, RESOURCE_NOT_FOUND, TIMEOUT_ERROR, } from "../../errors/index.js";
 import { parseDuration } from "../types.js";
 /**
  * AsyncLocalStorage for workflow tenant context.
@@ -27,13 +28,17 @@ export function runWithWorkflowTenant(tenant, fn) {
         return fn();
     return workflowTenantStorage.run(tenant, fn);
 }
+/** Default initial delay before first retry attempt */
+const DEFAULT_RETRY_INITIAL_DELAY_MS = 1_000;
+/** Default maximum delay between retry attempts */
+const DEFAULT_RETRY_MAX_DELAY_MS = 30_000;
 const DEFAULT_RETRY = {
     maxAttempts: 1,
     backoff: "exponential",
-    initialDelay: 1000,
-    maxDelay: 30000,
+    initialDelay: DEFAULT_RETRY_INITIAL_DELAY_MS,
+    maxDelay: DEFAULT_RETRY_MAX_DELAY_MS,
 };
-const DEFAULT_STEP_TIMEOUT_MS = 5 * 60 * 1000;
+const DEFAULT_STEP_TIMEOUT_MS = 5 * 60 * 1_000;
 export class StepExecutor {
     config;
     constructor(config = {}) {
@@ -43,8 +48,10 @@ export class StepExecutor {
         const startTime = Date.now();
         const config = node.config;
         if (config.type !== "step") {
-            throw new Error(`StepExecutor can only execute 'step' nodes, but node "${node.id}" has type '${config.type}'. ` +
-                `This is likely a bug in the DAG executor routing.`);
+            throw ORCHESTRATION_ERROR.create({
+                detail: `StepExecutor can only execute 'step' nodes, but node "${node.id}" has type '${config.type}'. ` +
+                    `This is likely a bug in the DAG executor routing.`,
+            });
         }
         const retryConfig = { ...DEFAULT_RETRY, ...config.retry };
         const maxAttempts = retryConfig.maxAttempts ?? 1;
@@ -103,8 +110,8 @@ export class StepExecutor {
         return retryablePatterns.some((pattern) => pattern.test(error.message));
     }
     calculateRetryDelay(attempt, config) {
-        const initialDelay = config.initialDelay ?? 1000;
-        const maxDelay = config.maxDelay ?? 30000;
+        const initialDelay = config.initialDelay ?? DEFAULT_RETRY_INITIAL_DELAY_MS;
+        const maxDelay = config.maxDelay ?? DEFAULT_RETRY_MAX_DELAY_MS;
         let baseDelay = initialDelay;
         if (config.backoff === "exponential")
             baseDelay = initialDelay * Math.pow(2, attempt - 1);
@@ -114,6 +121,7 @@ export class StepExecutor {
         return Math.floor(Math.min(baseDelay + jitter, maxDelay));
     }
     sleep(ms) {
+        // no cleanup needed: one-shot
         return new Promise((resolve) => dntShim.setTimeout(resolve, ms));
     }
     async resolveInput(input, context) {
@@ -127,7 +135,7 @@ export class StepExecutor {
         let timeoutId;
         const timeoutPromise = new Promise((_, reject) => {
             timeoutId = dntShim.setTimeout(() => {
-                reject(new Error(`Step "${nodeId}" timed out after ${timeout}ms`));
+                reject(TIMEOUT_ERROR.create({ detail: `Step "${nodeId}" timed out after ${timeout}ms` }));
             }, timeout);
         });
         try {
@@ -143,7 +151,7 @@ export class StepExecutor {
             return this.executeAgent(config.agent, input, context);
         if (config.tool)
             return this.executeTool(config.tool, input);
-        throw new Error("Step must have either 'agent' or 'tool' specified");
+        throw INVALID_ARGUMENT.create({ detail: "Step must have either 'agent' or 'tool' specified" });
     }
     async executeAgent(agent, input, context) {
         const resolvedAgent = typeof agent === "string" ? this.getAgent(agent) : agent;
@@ -172,7 +180,9 @@ export class StepExecutor {
     resolveFromRegistry(id, registry, type) {
         const label = type.charAt(0).toUpperCase() + type.slice(1);
         if (!registry) {
-            throw new Error(`${label} registry not configured. Cannot resolve ${type} "${id}"`);
+            throw INITIALIZATION_ERROR.create({
+                detail: `${label} registry not configured. Cannot resolve ${type} "${id}"`,
+            });
         }
         const item = registry.get(id);
         if (item)
@@ -181,7 +191,10 @@ export class StepExecutor {
         const suggestion = available.length > 0
             ? this.formatAvailableItems(available)
             : ` No ${type}s are registered.`;
-        throw new Error(`${label} not found: "${id}".${suggestion}`);
+        const detail = `${label} not found: "${id}".${suggestion}`;
+        throw (type === "agent"
+            ? AGENT_NOT_FOUND.create({ detail })
+            : RESOURCE_NOT_FOUND.create({ detail }));
     }
     getAgent(id) {
         return this.resolveFromRegistry(id, this.config.agentRegistry, "agent");

package/esm/src/workflow/executor/workflow-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-executor.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/executor/workflow-executor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-executor.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/executor/workflow-executor.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAKV,kBAAkB,EAElB,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5E,OAAO,EAAuC,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,kCAAkC;IAClC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,kCAAkC;IAClC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oCAAoC;IACpC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IACrC,uCAAuC;IACvC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACnD,wCAAwC;IACxC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO;IAC/C,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/B,yCAAyC;IACzC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,0BAA0B;IAC1B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,WAAW,CAAc;IAEjC,OAAO,CAAC,SAAS,CAAmD;IACpE,OAAO,CAAC,YAAY,CAAC,CAAe;IAEpC,wCAAwC;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAU;IACvD,qEAAqE;IACrE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAU;gBAE3C,MAAM,EAAE,sBAAsB;IAkD1C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9E;;OAEG;IAEH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS;IAIjE;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,OAAO,EACzB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IA+CnC;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCnE;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuHxE;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmDrB;;;;;OAKG;YACW,kBAAkB;IAmBhC;;OAEG;YACW,WAAW;IAkBzB;;OAEG;YACW,OAAO;IAkBrB;;OAEG;YACW,QAAQ;IActB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;YACW,aAAa;IAqB3B;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAIrD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;QAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAO3B"}