veryfront 0.1.49 → 0.1.50

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":"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"}

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

@@ -6,6 +6,7 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { logger as baseLogger } from "../../utils/index.js";
 import { ensureError } from "../../errors/veryfront-error.js";
+import { INVALID_ARGUMENT, ORCHESTRATION_ERROR, RESOURCE_NOT_FOUND, TIMEOUT_ERROR, } from "../../errors/index.js";
 import { generateId, parseDuration } from "../types.js";
 import { hasLockSupport } from "../backends/types.js";
 import { getCurrentRequestContext } from "../../platform/adapters/fs/veryfront/multi-project-adapter.js";
@@ -13,6 +14,8 @@ import { DAGExecutor } from "./dag-executor.js";
 import { CheckpointManager } from "./checkpoint-manager.js";
 import { runWithWorkflowTenant, StepExecutor } from "./step-executor.js";
 const logger = baseLogger.component("workflow-executor");
+/** Default polling interval for waiting on workflow result */
+const DEFAULT_RESULT_POLL_INTERVAL_MS = 1_000;
 /**
  * Workflow Executor class
  *
@@ -27,12 +30,13 @@ export class WorkflowExecutor {
     stepExecutor;
     checkpointManager;
     dagExecutor;
+    // deno-lint-ignore no-explicit-any -- type-erased registry: register() accepts WorkflowDefinition<TInput, TOutput> with arbitrary type params
     workflows = new Map();
     blobResolver;
     /** Default lock duration: 30 seconds */
-    static DEFAULT_LOCK_DURATION = 30000;
+    static DEFAULT_LOCK_DURATION = 30_000;
     /** Heartbeat interval for long-running workflow liveness tracking */
-    static HEARTBEAT_INTERVAL_MS = 10000;
+    static HEARTBEAT_INTERVAL_MS = 10_000;
     constructor(config) {
         this.config = {
             maxConcurrency: 10,
@@ -82,6 +86,7 @@ export class WorkflowExecutor {
     /**
      * Get a registered workflow
      */
+    // deno-lint-ignore no-explicit-any -- type-erased registry lookup
     getWorkflow(id) {
         return this.workflows.get(id);
     }
@@ -90,8 +95,9 @@ export class WorkflowExecutor {
      */
     async start(workflowId, input, options) {
         const workflow = this.workflows.get(workflowId);
-        if (!workflow)
-            throw new Error(`Workflow not found: ${workflowId}`);
+        if (!workflow) {
+            throw RESOURCE_NOT_FOUND.create({ detail: `Workflow not found: ${workflowId}` });
+        }
         workflow.inputSchema?.parse(input);
         // Capture current tenant context for multi-tenant job execution.
         // When a workflow is started from an API route, the request context
@@ -133,19 +139,24 @@ export class WorkflowExecutor {
     async resume(runId, fromCheckpoint) {
         const run = await this.config.backend.getRun(runId);
         if (!run)
-            throw new Error(`Run not found: ${runId}`);
+            throw RESOURCE_NOT_FOUND.create({ detail: `Run not found: ${runId}` });
         if (run.status !== "waiting" && run.status !== "pending") {
-            throw new Error(`Cannot resume workflow run "${runId}": current status is "${run.status}". ` +
-                `Only runs in "waiting" or "pending" status can be resumed.`);
+            throw ORCHESTRATION_ERROR.create({
+                detail: `Cannot resume workflow run "${runId}": current status is "${run.status}". ` +
+                    `Only runs in "waiting" or "pending" status can be resumed.`,
+            });
         }
         const workflow = this.workflows.get(run.workflowId);
-        if (!workflow)
-            throw new Error(`Workflow not found: ${run.workflowId}`);
+        if (!workflow) {
+            throw RESOURCE_NOT_FOUND.create({ detail: `Workflow not found: ${run.workflowId}` });
+        }
         const nodes = this.resolveNodes(workflow, run.context);
         const resumeInfo = await this.checkpointManager.prepareResume(runId, nodes, fromCheckpoint);
         if (fromCheckpoint && !resumeInfo) {
-            throw new Error(`Checkpoint "${fromCheckpoint}" not found for run "${runId}". ` +
-                `Cannot resume from non-existent checkpoint.`);
+            throw RESOURCE_NOT_FOUND.create({
+                detail: `Checkpoint "${fromCheckpoint}" not found for run "${runId}". ` +
+                    `Cannot resume from non-existent checkpoint.`,
+            });
         }
         if (resumeInfo) {
             await this.config.backend.updateRun(runId, {
@@ -165,10 +176,11 @@ export class WorkflowExecutor {
     async executeAsync(runId, startFromNode) {
         const run = await this.config.backend.getRun(runId);
         if (!run)
-            throw new Error(`Run not found: ${runId}`);
+            throw RESOURCE_NOT_FOUND.create({ detail: `Run not found: ${runId}` });
         const workflow = this.workflows.get(run.workflowId);
-        if (!workflow)
-            throw new Error(`Workflow not found: ${run.workflowId}`);
+        if (!workflow) {
+            throw RESOURCE_NOT_FOUND.create({ detail: `Workflow not found: ${run.workflowId}` });
+        }
         const useLocking = this.config.enableLocking !== false && hasLockSupport(this.config.backend);
         const lockDuration = this.config.lockDuration ?? WorkflowExecutor.DEFAULT_LOCK_DURATION;
         let heartbeatInterval;
@@ -176,8 +188,10 @@ export class WorkflowExecutor {
         if (useLocking) {
             const acquired = await this.config.backend.acquireLock(runId, lockDuration);
             if (!acquired) {
-                throw new Error(`Cannot execute workflow run "${runId}": another worker is already executing it. ` +
-                    `This can happen when multiple workers try to execute the same run concurrently.`);
+                throw ORCHESTRATION_ERROR.create({
+                    detail: `Cannot execute workflow run "${runId}": another worker is already executing it. ` +
+                        `This can happen when multiple workers try to execute the same run concurrently.`,
+                });
             }
             logger.debug("Acquired lock for run", { runId });
         }
@@ -235,7 +249,7 @@ export class WorkflowExecutor {
                 this.config.onWaiting?.(pausedRun, result.waitingNode);
                 return;
             }
-            const error = new Error(result.error || "Unknown error");
+            const error = ORCHESTRATION_ERROR.create({ detail: result.error || "Unknown error" });
             await this.failRun(runId, error, result.context, result.nodeStates);
             await workflow.onError?.(error, result.context);
             this.config.onError?.(run, error);
@@ -275,29 +289,43 @@ export class WorkflowExecutor {
      */
     validateNodes(nodes, workflowId) {
         if (!Array.isArray(nodes)) {
-            throw new Error(`Workflow "${workflowId}" steps must resolve to an array`);
+            throw INVALID_ARGUMENT.create({
+                detail: `Workflow "${workflowId}" steps must resolve to an array`,
+            });
         }
         if (nodes.length === 0) {
-            throw new Error(`Workflow "${workflowId}" must have at least one step`);
+            throw INVALID_ARGUMENT.create({
+                detail: `Workflow "${workflowId}" must have at least one step`,
+            });
         }
         const seenIds = new Set();
         for (let i = 0; i < nodes.length; i++) {
             const node = nodes[i];
             if (!node) {
-                throw new Error(`Workflow "${workflowId}" has undefined node at index ${i}`);
+                throw INVALID_ARGUMENT.create({
+                    detail: `Workflow "${workflowId}" has undefined node at index ${i}`,
+                });
             }
             if (!node.id || typeof node.id !== "string") {
-                throw new Error(`Workflow "${workflowId}" node at index ${i} has invalid ID`);
+                throw INVALID_ARGUMENT.create({
+                    detail: `Workflow "${workflowId}" node at index ${i} has invalid ID`,
+                });
             }
             if (seenIds.has(node.id)) {
-                throw new Error(`Workflow "${workflowId}" has duplicate node ID: "${node.id}"`);
+                throw INVALID_ARGUMENT.create({
+                    detail: `Workflow "${workflowId}" has duplicate node ID: "${node.id}"`,
+                });
             }
             seenIds.add(node.id);
             if (!node.config || typeof node.config !== "object") {
-                throw new Error(`Workflow "${workflowId}" node "${node.id}" has invalid config`);
+                throw INVALID_ARGUMENT.create({
+                    detail: `Workflow "${workflowId}" node "${node.id}" has invalid config`,
+                });
             }
             if (!node.config.type) {
-                throw new Error(`Workflow "${workflowId}" node "${node.id}" config missing type`);
+                throw INVALID_ARGUMENT.create({
+                    detail: `Workflow "${workflowId}" node "${node.id}" config missing type`,
+                });
             }
         }
     }
@@ -314,7 +342,7 @@ export class WorkflowExecutor {
         let timeoutId;
         const timeoutPromise = new Promise((_, reject) => {
             timeoutId = dntShim.setTimeout(() => {
-                reject(new Error(`Workflow timed out after ${timeoutMs}ms`));
+                reject(TIMEOUT_ERROR.create({ detail: `Workflow timed out after ${timeoutMs}ms` }));
             }, timeoutMs);
         });
         try {
@@ -386,17 +414,20 @@ export class WorkflowExecutor {
     /**
      * Wait for workflow result
      */
-    async waitForResult(runId, pollInterval = 1000) {
+    async waitForResult(runId, pollInterval = DEFAULT_RESULT_POLL_INTERVAL_MS) {
         while (true) {
             const run = await this.config.backend.getRun(runId);
             if (!run)
-                throw new Error(`Run not found: ${runId}`);
+                throw RESOURCE_NOT_FOUND.create({ detail: `Run not found: ${runId}` });
             if (run.status === "completed")
                 return run.output;
-            if (run.status === "failed")
-                throw new Error(run.error?.message || "Workflow failed");
-            if (run.status === "cancelled")
-                throw new Error("Workflow was cancelled");
+            if (run.status === "failed") {
+                throw ORCHESTRATION_ERROR.create({ detail: run.error?.message || "Workflow failed" });
+            }
+            if (run.status === "cancelled") {
+                throw ORCHESTRATION_ERROR.create({ detail: "Workflow was cancelled" });
+            }
+            // no cleanup needed: one-shot
             await new Promise((resolve) => dntShim.setTimeout(resolve, pollInterval));
         }
     }
@@ -406,10 +437,12 @@ export class WorkflowExecutor {
     async cancel(runId) {
         const run = await this.config.backend.getRun(runId);
         if (!run)
-            throw new Error(`Run not found: ${runId}`);
+            throw RESOURCE_NOT_FOUND.create({ detail: `Run not found: ${runId}` });
         if (run.status === "completed" || run.status === "failed") {
-            throw new Error(`Cannot cancel workflow run "${runId}": run has already ${run.status}. ` +
-                `Only active runs (pending, running, waiting) can be cancelled.`);
+            throw ORCHESTRATION_ERROR.create({
+                detail: `Cannot cancel workflow run "${runId}": run has already ${run.status}. ` +
+                    `Only active runs (pending, running, waiting) can be cancelled.`,
+            });
         }
         await this.config.backend.updateRun(runId, {
             status: "cancelled",

package/esm/src/workflow/react/use-approval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-approval.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/react/use-approval.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,cAAc,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAmH1E"}
+{"version":3,"file":"use-approval.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/react/use-approval.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,cAAc,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAyH1E"}

package/esm/src/workflow/react/use-approval.js

@@ -1,5 +1,6 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { useCallback, useEffect, useState } from "react";
+import { REQUEST_ERROR } from "../../errors/index.js";
 /**
  * Handle workflow approval interactions.
  */
@@ -19,7 +20,10 @@ export function useApproval(options) {
             try {
                 const response = await dntShim.fetch(`${apiBase}/runs/${runId}/approvals/${approvalId}`);
                 if (!response.ok) {
-                    throw new Error(`Failed to fetch approval: ${response.status}`);
+                    throw REQUEST_ERROR.create({
+                        detail: `Failed to fetch approval: ${response.status}`,
+                        status: response.status,
+                    });
                 }
                 const data = await response.json();
                 setApproval(data);
@@ -48,7 +52,10 @@ export function useApproval(options) {
                 body: JSON.stringify(decision),
             });
             if (!response.ok) {
-                throw new Error(`Failed to submit decision: ${response.status}`);
+                throw REQUEST_ERROR.create({
+                    detail: `Failed to submit decision: ${response.status}`,
+                    status: response.status,
+                });
             }
             setApproval((prev) => {
                 if (!prev)

package/esm/src/workflow/react/use-workflow-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-workflow-list.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/react/use-workflow-list.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAC3C,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,KAAK,IAAI,CAAC;IAC7D,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,qBAAqB,CA6I3F"}
+{"version":3,"file":"use-workflow-list.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/react/use-workflow-list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK1E,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAAC;IAC3C,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,KAAK,IAAI,CAAC;IAC7D,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,qBAAqB,CAkJ3F"}

package/esm/src/workflow/react/use-workflow-list.js

@@ -1,10 +1,13 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { useCallback, useEffect, useState } from "react";
+import { REQUEST_ERROR } from "../../errors/index.js";
+/** Default interval for auto-refreshing the workflow list */
+const DEFAULT_REFRESH_INTERVAL_MS = 5_000;
 /**
  * List and filter workflow runs.
  */
 export function useWorkflowList(options = {}) {
-    const { workflowId, status, createdAfter, createdBefore, pageSize = 20, apiBase = "/api/workflows", autoRefresh = false, refreshInterval = 5000, } = options;
+    const { workflowId, status, createdAfter, createdBefore, pageSize = 20, apiBase = "/api/workflows", autoRefresh = false, refreshInterval = DEFAULT_REFRESH_INTERVAL_MS, } = options;
     const [runs, setRuns] = useState([]);
     const [totalCount, setTotalCount] = useState();
     const [isLoading, setIsLoading] = useState(true);
@@ -45,8 +48,12 @@ export function useWorkflowList(options = {}) {
         try {
             const queryString = buildQueryString(filter, append ? cursor : undefined);
             const response = await dntShim.fetch(`${apiBase}/runs?${queryString}`);
-            if (!response.ok)
-                throw new Error(`Failed to fetch runs: ${response.status}`);
+            if (!response.ok) {
+                throw REQUEST_ERROR.create({
+                    detail: `Failed to fetch runs: ${response.status}`,
+                    status: response.status,
+                });
+            }
             const data = await response
                 .json();
             const fetchedRuns = data.runs ?? data;

package/esm/src/workflow/react/use-workflow-start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-workflow-start.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/react/use-workflow-start.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB,CAAC,MAAM,GAAG,OAAO;IACtD,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,GAAG,OAAO,EAC/C,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CAAC,MAAM,CAAC,CAqDhC"}
+{"version":3,"file":"use-workflow-start.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/react/use-workflow-start.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB,CAAC,MAAM,GAAG,OAAO;IACtD,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,GAAG,OAAO,EAC/C,OAAO,EAAE,uBAAuB,GAC/B,sBAAsB,CAAC,MAAM,CAAC,CAsDhC"}

package/esm/src/workflow/react/use-workflow-start.js

@@ -1,5 +1,6 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { useCallback, useState } from "react";
+import { REQUEST_ERROR } from "../../errors/index.js";
 export function useWorkflowStart(options) {
     const { workflowId, apiBase = "/api/workflows", onStart, onError } = options;
     const [isStarting, setIsStarting] = useState(false);
@@ -16,7 +17,10 @@ export function useWorkflowStart(options) {
             });
             if (!response.ok) {
                 const errorData = (await response.json().catch(() => ({})));
-                throw new Error(errorData.message ?? `Failed to start workflow: ${response.status}`);
+                throw REQUEST_ERROR.create({
+                    detail: errorData.message ?? `Failed to start workflow: ${response.status}`,
+                    status: response.status,
+                });
             }
             const data = (await response.json());
             const runId = data.runId ?? data.id ?? "";

package/esm/src/workflow/react/use-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-workflow.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/react/use-workflow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,KAAK,IAAI,CAAC;IAClF,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;IACpD,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA6J1E"}
+{"version":3,"file":"use-workflow.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/react/use-workflow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,cAAc,EACf,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,KAAK,IAAI,CAAC;IAClF,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;IACpD,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAsK1E"}

package/esm/src/workflow/react/use-workflow.js

@@ -1,7 +1,10 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { useCallback, useEffect, useRef, useState } from "react";
+import { ORCHESTRATION_ERROR, REQUEST_ERROR } from "../../errors/index.js";
+/** Default polling interval for workflow status updates */
+const DEFAULT_POLL_INTERVAL_MS = 2_000;
 export function useWorkflow(options) {
-    const { runId, apiBase = "/api/workflows", pollInterval = 2000, autoRefresh = true, onStatusChange, onComplete, onError, onApprovalRequired, } = options;
+    const { runId, apiBase = "/api/workflows", pollInterval = DEFAULT_POLL_INTERVAL_MS, autoRefresh = true, onStatusChange, onComplete, onError, onApprovalRequired, } = options;
     const [run, setRun] = useState(null);
     const [isLoading, setIsLoading] = useState(true);
     const [error, setError] = useState(null);
@@ -23,7 +26,10 @@ export function useWorkflow(options) {
                 signal: abortControllerRef.current?.signal,
             });
             if (!response.ok) {
-                throw new Error(`Failed to fetch workflow: ${response.status}`);
+                throw REQUEST_ERROR.create({
+                    detail: `Failed to fetch workflow: ${response.status}`,
+                    status: response.status,
+                });
             }
             const workflowRun = (await response.json());
             const previousStatus = previousStatusRef.current;
@@ -35,7 +41,7 @@ export function useWorkflow(options) {
                 onComplete?.(workflowRun);
             }
             else if (workflowRun.status === "failed") {
-                onError?.(new Error("Workflow failed"), workflowRun);
+                onError?.(ORCHESTRATION_ERROR.create({ detail: "Workflow failed" }), workflowRun);
             }
             for (const approval of workflowRun.pendingApprovals ?? []) {
                 if (approval.status !== "pending")
@@ -67,7 +73,10 @@ export function useWorkflow(options) {
         try {
             const response = await dntShim.fetch(`${apiBase}/runs/${runId}/cancel`, { method: "POST" });
             if (!response.ok) {
-                throw new Error(`Failed to cancel workflow: ${response.status}`);
+                throw REQUEST_ERROR.create({
+                    detail: `Failed to cancel workflow: ${response.status}`,
+                    status: response.status,
+                });
             }
             await refresh();
         }
@@ -83,7 +92,10 @@ export function useWorkflow(options) {
         try {
             const response = await dntShim.fetch(`${apiBase}/runs/${runId}/retry`, { method: "POST" });
             if (!response.ok) {
-                throw new Error(`Failed to retry workflow: ${response.status}`);
+                throw REQUEST_ERROR.create({
+                    detail: `Failed to retry workflow: ${response.status}`,
+                    status: response.status,
+                });
             }
             await refresh();
         }

package/esm/src/workflow/registry.js

@@ -98,8 +98,8 @@ function extractMetadata(definition) {
         try {
             inputSchemaJson = zodToJsonSchema(definition.inputSchema);
         }
-        catch {
-            // Ignore conversion errors
+        catch (_) {
+            /* expected: zod-to-json-schema conversion may not support all types */
         }
     }
     return {

package/esm/src/workflow/runtime/approval-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approval-manager.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/runtime/approval-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIzE,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,WAAW,KACb,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,4CAA4C;IAC5C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,8EAA8E;AAC9E,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,eAAe,CAAC,CAAyC;IACjE,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,qBAAqB;IAazC,wCAAwC;IAClC,cAAc,CAClB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC;IA2C3B,iCAAiC;IAC3B,WAAW,CACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IASlC,0CAA0C;IAC1C,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9D,mCAAmC;IAC7B,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC;IAqFhB,OAAO,CAAC,cAAc;IActB,kCAAkC;IAClC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F,iCAAiC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F,kDAAkD;IAClD,cAAc,CAAC,MAAM,CAAC,EAAE;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;IAYhE,uCAAuC;IACjC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5C,OAAO,CAAC,sBAAsB;IAQ9B,gCAAgC;IAChC,IAAI,IAAI,IAAI;CAUb"}
+{"version":3,"file":"approval-manager.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/runtime/approval-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,eAAe,EACf,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAQzE,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,WAAW,KACb,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,4CAA4C;IAC5C,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,8EAA8E;AAC9E,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,eAAe,CAAC,CAAyC;IACjE,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,qBAAqB;IAazC,wCAAwC;IAClC,cAAc,CAClB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC;IA2C3B,iCAAiC;IAC3B,WAAW,CACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IASlC,0CAA0C;IAC1C,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAI9D,mCAAmC;IAC7B,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC;IAqFhB,OAAO,CAAC,cAAc;IActB,kCAAkC;IAClC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F,iCAAiC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5F,kDAAkD;IAClD,cAAc,CAAC,MAAM,CAAC,EAAE;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;IAYhE,uCAAuC;IACjC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5C,OAAO,CAAC,sBAAsB;IAQ9B,gCAAgC;IAChC,IAAI,IAAI,IAAI;CAUb"}

package/esm/src/workflow/runtime/approval-manager.js

@@ -1,7 +1,10 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { logger as baseLogger } from "../../utils/index.js";
 import { generateId, parseDuration } from "../types.js";
+import { INVALID_ARGUMENT, PERMISSION_DENIED, RESOURCE_NOT_FOUND } from "../../errors/index.js";
 const logger = baseLogger.component("approval-manager");
+/** Default interval for checking expired approvals */
+const DEFAULT_EXPIRATION_CHECK_INTERVAL_MS = 60_000;
 /** Manages pending approvals, processing decisions, and resuming workflows */
 export class ApprovalManager {
     config;
@@ -9,7 +12,7 @@ export class ApprovalManager {
     destroyed = false;
     constructor(config) {
         this.config = {
-            expirationCheckInterval: 60000,
+            expirationCheckInterval: DEFAULT_EXPIRATION_CHECK_INTERVAL_MS,
             debug: false,
             ...config,
         };
@@ -76,22 +79,22 @@ export class ApprovalManager {
         });
         const approval = await this.getApproval(runId, approvalId);
         if (!approval) {
-            throw new Error(`Approval not found: ${approvalId}`);
+            throw RESOURCE_NOT_FOUND.create({ detail: `Approval not found: ${approvalId}` });
         }
         if (approval.status !== "pending") {
-            throw new Error(`Approval already processed: ${approval.status}`);
+            throw INVALID_ARGUMENT.create({ detail: `Approval already processed: ${approval.status}` });
         }
         if (approval.expiresAt && new Date() > approval.expiresAt) {
-            throw new Error("Approval has expired");
+            throw INVALID_ARGUMENT.create({ detail: "Approval has expired" });
         }
         const approvers = approval.approvers;
         if (approvers?.length && !approvers.includes(decision.approver)) {
-            throw new Error("Not authorized to approve this request");
+            throw PERMISSION_DENIED.create({ detail: "Not authorized to approve this request" });
         }
         await this.config.backend.updateApproval(runId, approvalId, decision);
         const run = await this.config.backend.getRun(runId);
         if (!run) {
-            throw new Error(`Run not found: ${runId}`);
+            throw RESOURCE_NOT_FOUND.create({ detail: `Run not found: ${runId}` });
         }
         const decidedAt = new Date();
         const decisionContext = {

package/esm/src/workflow/types.d.ts

@@ -4,7 +4,6 @@ import type { Tool } from "../tool/index.js";
 import type { BlobRef, BlobStorage } from "./blob/types.js";
 export type { ApprovalDecision, ApprovalStatus, BackoffStrategy, LoopExecutionContext, NodeState, NodeStatus, ParallelStrategy, PendingApproval, RetryConfig, RunFilter, WaitType, WorkflowError, WorkflowJob, WorkflowNodeType, WorkflowStatus, } from "./schemas/index.js";
 import type { LoopExecutionContext, NodeState, ParallelStrategy, PendingApproval, RetryConfig, WaitType, WorkflowError, WorkflowStatus } from "./schemas/index.js";
-export type DurationString = string;
 /**
  * Workflow context - accumulates node outputs during execution
  */

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

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