@usearazzo/runner 1.0.1-alpha.22 → 1.0.1-alpha.24

package/src/executor/StepTransitionInterpreter.mjs

@@ -96,7 +96,7 @@ class StepTransitionInterpreter {
         throw new ExecutionError(`goto action on step "${stepId}" in workflow "${workflowId}" declares both a stepId and a workflowId (mutually exclusive)`, {
           stepId,
           workflowId,
-          reason: 'ambiguous-target'
+          reason: ExecutionError.AmbiguousTarget
         });
       }
       if (hasStepId) {
@@ -114,13 +114,13 @@ class StepTransitionInterpreter {
       throw new ExecutionError(`goto action on step "${stepId}" in workflow "${workflowId}" has neither stepId nor workflowId`, {
         stepId,
         workflowId,
-        reason: 'goto-target-missing'
+        reason: ExecutionError.GotoTargetMissing
       });
     }
     throw new ExecutionError(`action on step "${stepId}" in workflow "${workflowId}" has unsupported type "${type}"`, {
       stepId,
       workflowId,
-      reason: 'unknown-action-type'
+      reason: ExecutionError.UnknownActionType
     });
   }
 

package/src/executor/WorkflowCallStack.cjs

@@ -89,7 +89,7 @@ class WorkflowCallStack {
       // detects both, so a loop crossing the two mechanisms cannot slip between
       // them.
       const closingEdges = [...this.#calls.slice(repeated + 1).map(call => call.via), via];
-      const reason = closingEdges.every(edge => edge === 'dependsOn') ? 'dependsOn-cycle' : 'workflow-cycle';
+      const reason = closingEdges.every(edge => edge === 'dependsOn') ? _ExecutionError.default.DependsOnCycle : _ExecutionError.default.WorkflowCycle;
       throw new _ExecutionError.default(`workflow "${workflowId}" is already in progress; its call chain forms a cycle (${path.join(' -> ')})`, {
         workflowId,
         reason,
@@ -99,7 +99,7 @@ class WorkflowCallStack {
     if (this.#calls.length >= this.#maxDepth) {
       throw new _ExecutionError.default(`workflow "${workflowId}" nests deeper than the limit of ${this.#maxDepth} workflows`, {
         workflowId,
-        reason: 'workflow-depth',
+        reason: _ExecutionError.default.WorkflowDepth,
         path: [...this.path, this.#display(workflowId, documentURI)]
       });
     }

package/src/executor/WorkflowCallStack.mjs

@@ -79,7 +79,7 @@ class WorkflowCallStack {
       // detects both, so a loop crossing the two mechanisms cannot slip between
       // them.
       const closingEdges = [...this.#calls.slice(repeated + 1).map(call => call.via), via];
-      const reason = closingEdges.every(edge => edge === 'dependsOn') ? 'dependsOn-cycle' : 'workflow-cycle';
+      const reason = closingEdges.every(edge => edge === 'dependsOn') ? ExecutionError.DependsOnCycle : ExecutionError.WorkflowCycle;
       throw new ExecutionError(`workflow "${workflowId}" is already in progress; its call chain forms a cycle (${path.join(' -> ')})`, {
         workflowId,
         reason,
@@ -89,7 +89,7 @@ class WorkflowCallStack {
     if (this.#calls.length >= this.#maxDepth) {
       throw new ExecutionError(`workflow "${workflowId}" nests deeper than the limit of ${this.#maxDepth} workflows`, {
         workflowId,
-        reason: 'workflow-depth',
+        reason: ExecutionError.WorkflowDepth,
         path: [...this.path, this.#display(workflowId, documentURI)]
       });
     }

package/src/executor/WorkflowExecutor.cjs

@@ -245,7 +245,7 @@ class WorkflowExecutor {
     const unknown = Object.keys(options).filter(key => !WorkflowExecutor.#EXECUTE_OPTION_KEYS.has(key));
     if (unknown.length === 0) return;
     throw new _ExecutionError.default(`execute received unknown option(s) ${unknown.join(', ')}; it takes (workflowId, { inputs, executeOptions, dependencyInputs, runDependencies, signal }) — workflow inputs go under "inputs"`, {
-      reason: 'unknown-execute-option'
+      reason: _ExecutionError.default.UnknownExecuteOption
     });
   }
 
@@ -378,7 +378,7 @@ class WorkflowExecutor {
           break;
         case 'goto':
           index = this.#interpreter.indexOfStep(steps, transition.stepId, workflowId, {
-            reason: 'goto-target-not-found',
+            reason: _ExecutionError.default.GotoTargetNotFound,
             label: 'goto target'
           });
           break;
@@ -425,7 +425,7 @@ class WorkflowExecutor {
             throw new _ExecutionError.default(`step "${stepId}" in workflow "${workflowId}" produced an unrecognized transition ${JSON.stringify(unreachable)}`, {
               workflowId,
               stepId,
-              reason: 'unknown-transition-kind'
+              reason: _ExecutionError.default.UnknownTransitionKind
             });
           }
       }
@@ -513,7 +513,7 @@ class WorkflowExecutor {
     throw new _ExecutionError.default(`workflow "${invocation.workflowId}" exceeded its budget of ${this.#maxSteps} step attempts (a goto loop, excessive retries, or runaway sub-workflow calls)`, {
       workflowId: invocation.workflowId,
       stepId,
-      reason: 'step-budget',
+      reason: _ExecutionError.default.StepBudget,
       path: invocation.callStack.path
     });
   }
@@ -618,7 +618,7 @@ class WorkflowExecutor {
         throw new _ExecutionError.default(`retry action on step "${stepId}" in workflow "${workflowId}" declares both a stepId and a workflowId (mutually exclusive)`, {
           stepId,
           workflowId,
-          reason: 'ambiguous-target'
+          reason: _ExecutionError.default.AmbiguousTarget
         });
       }
       if (hasWorkflowId) {
@@ -642,7 +642,7 @@ class WorkflowExecutor {
       }
       const refStepId = (0, _apidomCore.toValue)(action.stepId);
       const refIndex = this.#interpreter.indexOfStep(steps, refStepId, workflowId, {
-        reason: 'retry-target-not-found',
+        reason: _ExecutionError.default.RetryTargetNotFound,
         label: 'retry reference'
       });
       const refStep = steps[refIndex];
@@ -761,14 +761,14 @@ class WorkflowExecutor {
     if (!(0, _apidomDatamodel.isArrayElement)(dependsOn)) {
       throw new _ExecutionError.default(`workflow "${workflowId}" has a non-list "dependsOn"`, {
         workflowId,
-        reason: 'malformed-dependsOn'
+        reason: _ExecutionError.default.MalformedDependsOn
       });
     }
     const references = [...dependsOn].map((entry, index) => {
       if (!(0, _apidomDatamodel.isStringElement)(entry)) {
         throw new _ExecutionError.default(`workflow "${workflowId}" has a non-string entry at dependsOn[${index}]`, {
           workflowId,
-          reason: 'malformed-dependsOn'
+          reason: _ExecutionError.default.MalformedDependsOn
         });
       }
       return (0, _apidomCore.toValue)(entry);
@@ -810,10 +810,11 @@ class WorkflowExecutor {
       callStack
     } = invocation;
     if (!(0, _apidomDatamodel.isStringElement)(step.workflowId)) {
-      return () => this.#stepExecutor.forDocument(document).execute(step, state, scope.executeOptions);
+      return () => this.#stepExecutor.forDocument(document).execute(step, state, scope.executeOptions, workflowId);
     }
     const reference = this.#subWorkflowReference(step, stepId, workflowId);
     const stepScope = {
+      workflowId,
       stepId
     };
     // the reference resolves to the same locator on every attempt, so it is
@@ -891,12 +892,12 @@ class WorkflowExecutor {
       // evaluated by the parent document's step executor — only the sub-run
       // itself switched documents.
       const stepExecutor = this.#stepExecutor.forDocument(document);
-      const successCriteria = stepExecutor.evaluateCriteria(step, context);
+      const successCriteria = stepExecutor.evaluateCriteria(step, context, workflowId);
       const successful = !this.#settledFailed(result) && successCriteria.every(criterion => criterion.met);
       const {
         matchedActions,
         actionCriteria
-      } = stepExecutor.selectActions(step, successful, context);
+      } = stepExecutor.selectActions(step, successful, context, workflowId);
       return {
         stepId,
         successful,
@@ -952,7 +953,7 @@ class WorkflowExecutor {
       throw new _ExecutionError.default(`step "${stepId}" in workflow "${workflowId}" declares a workflowId alongside ${conflicting.join(', ')} (mutually exclusive)`, {
         stepId,
         workflowId,
-        reason: 'ambiguous-target'
+        reason: _ExecutionError.default.AmbiguousTarget
       });
     }
     return (0, _apidomCore.toValue)(step.workflowId);
@@ -998,7 +999,7 @@ class WorkflowExecutor {
     if (!document.workflowIndex.has(workflowId)) {
       throw new _ExecutionError.default(`workflow "${workflowId}" not found in Arazzo document at "${document.uri}"`, {
         workflowId,
-        reason: 'workflow-not-found'
+        reason: _ExecutionError.default.WorkflowNotFound
       });
     }
     const workflow = await this.#normalizer.normalize(this.#extractor.extract(document, workflowId), document);
@@ -1029,14 +1030,14 @@ class WorkflowExecutor {
     if (!(0, _apidomDatamodel.isArrayElement)(steps)) {
       throw new _ExecutionError.default(`workflow "${workflowId}" has a non-list "steps"`, {
         workflowId,
-        reason: 'malformed-steps'
+        reason: _ExecutionError.default.MalformedSteps
       });
     }
     return [...steps].map((step, index) => {
       if (!(0, _apidomNsArazzo.isStepElement)(step)) {
         throw new _ExecutionError.default(`workflow "${workflowId}" has a non-step entry at steps[${index}]`, {
           workflowId,
-          reason: 'malformed-steps'
+          reason: _ExecutionError.default.MalformedSteps
         });
       }
       return step;
@@ -1059,7 +1060,7 @@ class WorkflowExecutor {
     throw new _ResolverError.default('`outputs` is present but is not a map', {
       workflowId,
       target: 'outputs',
-      reason: 'malformed-outputs'
+      reason: _ResolverError.default.MalformedOutputs
     });
   }
 

package/src/executor/WorkflowExecutor.mjs

@@ -231,7 +231,7 @@ class WorkflowExecutor {
     const unknown = Object.keys(options).filter(key => !WorkflowExecutor.#EXECUTE_OPTION_KEYS.has(key));
     if (unknown.length === 0) return;
     throw new ExecutionError(`execute received unknown option(s) ${unknown.join(', ')}; it takes (workflowId, { inputs, executeOptions, dependencyInputs, runDependencies, signal }) — workflow inputs go under "inputs"`, {
-      reason: 'unknown-execute-option'
+      reason: ExecutionError.UnknownExecuteOption
     });
   }
 
@@ -364,7 +364,7 @@ class WorkflowExecutor {
           break;
         case 'goto':
           index = this.#interpreter.indexOfStep(steps, transition.stepId, workflowId, {
-            reason: 'goto-target-not-found',
+            reason: ExecutionError.GotoTargetNotFound,
             label: 'goto target'
           });
           break;
@@ -411,7 +411,7 @@ class WorkflowExecutor {
             throw new ExecutionError(`step "${stepId}" in workflow "${workflowId}" produced an unrecognized transition ${JSON.stringify(unreachable)}`, {
               workflowId,
               stepId,
-              reason: 'unknown-transition-kind'
+              reason: ExecutionError.UnknownTransitionKind
             });
           }
       }
@@ -499,7 +499,7 @@ class WorkflowExecutor {
     throw new ExecutionError(`workflow "${invocation.workflowId}" exceeded its budget of ${this.#maxSteps} step attempts (a goto loop, excessive retries, or runaway sub-workflow calls)`, {
       workflowId: invocation.workflowId,
       stepId,
-      reason: 'step-budget',
+      reason: ExecutionError.StepBudget,
       path: invocation.callStack.path
     });
   }
@@ -604,7 +604,7 @@ class WorkflowExecutor {
         throw new ExecutionError(`retry action on step "${stepId}" in workflow "${workflowId}" declares both a stepId and a workflowId (mutually exclusive)`, {
           stepId,
           workflowId,
-          reason: 'ambiguous-target'
+          reason: ExecutionError.AmbiguousTarget
         });
       }
       if (hasWorkflowId) {
@@ -628,7 +628,7 @@ class WorkflowExecutor {
       }
       const refStepId = toValue(action.stepId);
       const refIndex = this.#interpreter.indexOfStep(steps, refStepId, workflowId, {
-        reason: 'retry-target-not-found',
+        reason: ExecutionError.RetryTargetNotFound,
         label: 'retry reference'
       });
       const refStep = steps[refIndex];
@@ -747,14 +747,14 @@ class WorkflowExecutor {
     if (!isArrayElement(dependsOn)) {
       throw new ExecutionError(`workflow "${workflowId}" has a non-list "dependsOn"`, {
         workflowId,
-        reason: 'malformed-dependsOn'
+        reason: ExecutionError.MalformedDependsOn
       });
     }
     const references = [...dependsOn].map((entry, index) => {
       if (!isStringElement(entry)) {
         throw new ExecutionError(`workflow "${workflowId}" has a non-string entry at dependsOn[${index}]`, {
           workflowId,
-          reason: 'malformed-dependsOn'
+          reason: ExecutionError.MalformedDependsOn
         });
       }
       return toValue(entry);
@@ -796,10 +796,11 @@ class WorkflowExecutor {
       callStack
     } = invocation;
     if (!isStringElement(step.workflowId)) {
-      return () => this.#stepExecutor.forDocument(document).execute(step, state, scope.executeOptions);
+      return () => this.#stepExecutor.forDocument(document).execute(step, state, scope.executeOptions, workflowId);
     }
     const reference = this.#subWorkflowReference(step, stepId, workflowId);
     const stepScope = {
+      workflowId,
       stepId
     };
     // the reference resolves to the same locator on every attempt, so it is
@@ -877,12 +878,12 @@ class WorkflowExecutor {
       // evaluated by the parent document's step executor — only the sub-run
       // itself switched documents.
       const stepExecutor = this.#stepExecutor.forDocument(document);
-      const successCriteria = stepExecutor.evaluateCriteria(step, context);
+      const successCriteria = stepExecutor.evaluateCriteria(step, context, workflowId);
       const successful = !this.#settledFailed(result) && successCriteria.every(criterion => criterion.met);
       const {
         matchedActions,
         actionCriteria
-      } = stepExecutor.selectActions(step, successful, context);
+      } = stepExecutor.selectActions(step, successful, context, workflowId);
       return {
         stepId,
         successful,
@@ -938,7 +939,7 @@ class WorkflowExecutor {
       throw new ExecutionError(`step "${stepId}" in workflow "${workflowId}" declares a workflowId alongside ${conflicting.join(', ')} (mutually exclusive)`, {
         stepId,
         workflowId,
-        reason: 'ambiguous-target'
+        reason: ExecutionError.AmbiguousTarget
       });
     }
     return toValue(step.workflowId);
@@ -984,7 +985,7 @@ class WorkflowExecutor {
     if (!document.workflowIndex.has(workflowId)) {
       throw new ExecutionError(`workflow "${workflowId}" not found in Arazzo document at "${document.uri}"`, {
         workflowId,
-        reason: 'workflow-not-found'
+        reason: ExecutionError.WorkflowNotFound
       });
     }
     const workflow = await this.#normalizer.normalize(this.#extractor.extract(document, workflowId), document);
@@ -1015,14 +1016,14 @@ class WorkflowExecutor {
     if (!isArrayElement(steps)) {
       throw new ExecutionError(`workflow "${workflowId}" has a non-list "steps"`, {
         workflowId,
-        reason: 'malformed-steps'
+        reason: ExecutionError.MalformedSteps
       });
     }
     return [...steps].map((step, index) => {
       if (!isStepElement(step)) {
         throw new ExecutionError(`workflow "${workflowId}" has a non-step entry at steps[${index}]`, {
           workflowId,
-          reason: 'malformed-steps'
+          reason: ExecutionError.MalformedSteps
         });
       }
       return step;
@@ -1045,7 +1046,7 @@ class WorkflowExecutor {
     throw new ResolverError('`outputs` is present but is not a map', {
       workflowId,
       target: 'outputs',
-      reason: 'malformed-outputs'
+      reason: ResolverError.MalformedOutputs
     });
   }
 

package/src/executor/abort.cjs

@@ -39,8 +39,8 @@ const readAbortSignal = options => {
 };
 
 /**
- * Throws `reason: 'aborted'` when the caller has cancelled the run, and does
- * nothing otherwise.
+ * Throws with reason `ExecutionError.Aborted` when the caller has cancelled
+ * the run, and does nothing otherwise.
  *
  * Cancellation throws rather than resolving as a `failed` result because it is
  * not a workflow outcome: nothing was judged by `successCriteria`, no failure
@@ -62,7 +62,7 @@ const throwIfAborted = (signal, context) => {
   throw new _ExecutionError.default(`run aborted before ${where}`, {
     workflowId,
     stepId,
-    reason: 'aborted',
+    reason: _ExecutionError.default.Aborted,
     path: callStack?.path,
     cause: signal.reason
   });

package/src/executor/abort.mjs

@@ -31,8 +31,8 @@ export const readAbortSignal = options => {
 };
 
 /**
- * Throws `reason: 'aborted'` when the caller has cancelled the run, and does
- * nothing otherwise.
+ * Throws with reason `ExecutionError.Aborted` when the caller has cancelled
+ * the run, and does nothing otherwise.
  *
  * Cancellation throws rather than resolving as a `failed` result because it is
  * not a workflow outcome: nothing was judged by `successCriteria`, no failure
@@ -53,7 +53,7 @@ export const throwIfAborted = (signal, context) => {
   throw new ExecutionError(`run aborted before ${where}`, {
     workflowId,
     stepId,
-    reason: 'aborted',
+    reason: ExecutionError.Aborted,
     path: callStack?.path,
     cause: signal.reason
   });

package/src/expression/RuntimeExpressionEvaluator.cjs

@@ -96,7 +96,7 @@ class RuntimeExpressionEvaluator {
     if (value === undefined && this.#strict) {
       throw new _RuntimeExpressionError.default(`Runtime expression "${expression}" could not be resolved against the context`, {
         expression,
-        reason: 'unresolved-reference'
+        reason: _RuntimeExpressionError.default.UnresolvedReference
       });
     }
     return value;
@@ -142,13 +142,13 @@ class RuntimeExpressionEvaluator {
       throw new _RuntimeExpressionError.default(`Failed to parse runtime expression "${expression}"`, {
         cause: error,
         expression,
-        reason: 'parse-error'
+        reason: _RuntimeExpressionError.default.ParseError
       });
     }
     if (!result.result.success || result.tree === undefined) {
       throw new _RuntimeExpressionError.default(`Invalid runtime expression "${expression}"`, {
         expression,
-        reason: 'invalid-expression'
+        reason: _RuntimeExpressionError.default.InvalidExpression
       });
     }
     return result.tree;
@@ -166,7 +166,7 @@ class RuntimeExpressionEvaluator {
     if (calledWorkflow === undefined || !HTTP_EXCHANGE_NODES.has(node.type)) return;
     throw new _RuntimeExpressionError.default(`Runtime expression "${expression}" is not available: step "${calledWorkflow.stepId}" calls workflow "${calledWorkflow.workflowId}", not an operation, so it has no HTTP request or response`, {
       expression,
-      reason: 'unavailable-expression'
+      reason: _RuntimeExpressionError.default.UnavailableExpression
     });
   }
 
@@ -203,7 +203,7 @@ class RuntimeExpressionEvaluator {
       default:
         throw new _RuntimeExpressionError.default(`Unsupported runtime expression node "${node.type}"`, {
           expression,
-          reason: 'unsupported-node'
+          reason: _RuntimeExpressionError.default.UnsupportedNode
         });
     }
   }

package/src/expression/RuntimeExpressionEvaluator.mjs

@@ -87,7 +87,7 @@ class RuntimeExpressionEvaluator {
     if (value === undefined && this.#strict) {
       throw new RuntimeExpressionError(`Runtime expression "${expression}" could not be resolved against the context`, {
         expression,
-        reason: 'unresolved-reference'
+        reason: RuntimeExpressionError.UnresolvedReference
       });
     }
     return value;
@@ -133,13 +133,13 @@ class RuntimeExpressionEvaluator {
       throw new RuntimeExpressionError(`Failed to parse runtime expression "${expression}"`, {
         cause: error,
         expression,
-        reason: 'parse-error'
+        reason: RuntimeExpressionError.ParseError
       });
     }
     if (!result.result.success || result.tree === undefined) {
       throw new RuntimeExpressionError(`Invalid runtime expression "${expression}"`, {
         expression,
-        reason: 'invalid-expression'
+        reason: RuntimeExpressionError.InvalidExpression
       });
     }
     return result.tree;
@@ -157,7 +157,7 @@ class RuntimeExpressionEvaluator {
     if (calledWorkflow === undefined || !HTTP_EXCHANGE_NODES.has(node.type)) return;
     throw new RuntimeExpressionError(`Runtime expression "${expression}" is not available: step "${calledWorkflow.stepId}" calls workflow "${calledWorkflow.workflowId}", not an operation, so it has no HTTP request or response`, {
       expression,
-      reason: 'unavailable-expression'
+      reason: RuntimeExpressionError.UnavailableExpression
     });
   }
 
@@ -194,7 +194,7 @@ class RuntimeExpressionEvaluator {
       default:
         throw new RuntimeExpressionError(`Unsupported runtime expression node "${node.type}"`, {
           expression,
-          reason: 'unsupported-node'
+          reason: RuntimeExpressionError.UnsupportedNode
         });
     }
   }

package/src/index.cjs

@@ -113,12 +113,6 @@ Object.defineProperty(exports, "CriterionError", {
     return _CriterionError.default;
   }
 });
-Object.defineProperty(exports, "CriterionErrorReason", {
-  enumerable: true,
-  get: function () {
-    return _CriterionErrorReason.default;
-  }
-});
 Object.defineProperty(exports, "CriterionEvaluationError", {
   enumerable: true,
   get: function () {
@@ -417,7 +411,6 @@ var _SimpleCriterionEvaluator = _interopRequireDefault(require("./criterion/Simp
 var _RegexCriterionEvaluator = _interopRequireDefault(require("./criterion/RegexCriterionEvaluator.cjs"));
 var _JSONPathCriterionEvaluator = _interopRequireDefault(require("./criterion/JSONPathCriterionEvaluator.cjs"));
 var _XPathCriterionEvaluator = _interopRequireDefault(require("./criterion/XPathCriterionEvaluator.cjs"));
-var _CriterionErrorReason = _interopRequireDefault(require("./criterion/CriterionErrorReason.cjs"));
 var _WorkflowExecutionState = _interopRequireDefault(require("./state/WorkflowExecutionState.cjs"));
 var _ArazzoValueResolver = _interopRequireDefault(require("./resolver/ArazzoValueResolver.cjs"));
 var _StepParameterResolver = _interopRequireDefault(require("./resolver/StepParameterResolver.cjs"));

package/src/index.mjs

@@ -43,7 +43,6 @@ export { default as SimpleCriterionEvaluator } from "./criterion/SimpleCriterion
 export { default as RegexCriterionEvaluator } from "./criterion/RegexCriterionEvaluator.mjs";
 export { default as JSONPathCriterionEvaluator } from "./criterion/JSONPathCriterionEvaluator.mjs";
 export { default as XPathCriterionEvaluator } from "./criterion/XPathCriterionEvaluator.mjs";
-export { default as CriterionErrorReason } from "./criterion/CriterionErrorReason.mjs";
 /* Execution State */
 export { default as WorkflowExecutionState } from "./state/WorkflowExecutionState.mjs";
 /* Resolvers */

package/src/resolver/OpenAPIOperationParameterResolver.cjs

@@ -70,7 +70,7 @@ class OpenAPIOperationParameterResolver extends _StepParameterResolver.default {
       throw new _ResolverError.default('`parameters` is present but is not a list', {
         ...scope,
         target: 'parameters',
-        reason: 'malformed-parameters'
+        reason: _ResolverError.default.MalformedParameters
       });
     }
     for (const parameter of parameters) {
@@ -82,7 +82,7 @@ class OpenAPIOperationParameterResolver extends _StepParameterResolver.default {
       if (identity === undefined) {
         throw new _ResolverError.default('Parameter has a missing or non-string name', {
           ...scope,
-          reason: 'missing-name'
+          reason: _ResolverError.default.MissingName
         });
       }
       const {
@@ -93,21 +93,21 @@ class OpenAPIOperationParameterResolver extends _StepParameterResolver.default {
         throw new _ResolverError.default(`Parameter "${name}" declares no location ("in"), which a step targeting an operation requires`, {
           ...scope,
           target: name,
-          reason: 'missing-location'
+          reason: _ResolverError.default.MissingLocation
         });
       }
       if (location === null) {
         throw new _ResolverError.default(`Parameter "${name}" has a non-string location ("in")`, {
           ...scope,
           target: name,
-          reason: 'malformed-location'
+          reason: _ResolverError.default.MalformedLocation
         });
       }
       if (!identity.hasDefinedLocation) {
         throw new _ResolverError.default(`Parameter "${name}" has location "${location}", which is not one of ` + `${_ParameterIdentity.default.LOCATIONS.join(', ')}`, {
           ...scope,
           target: name,
-          reason: 'invalid-location'
+          reason: _ResolverError.default.InvalidLocation
         });
       }
       const {
@@ -121,7 +121,7 @@ class OpenAPIOperationParameterResolver extends _StepParameterResolver.default {
         throw new _ResolverError.default(`Parameter "${name}" (in: ${location}) ${why} and cannot be delivered unambiguously`, {
           ...scope,
           target: name,
-          reason: 'ambiguous-delivery'
+          reason: _ResolverError.default.AmbiguousDelivery
         });
       }
       delivery.set(key, this.resolveValue(parameter.value, resolve));

package/src/resolver/OpenAPIOperationParameterResolver.mjs

@@ -63,7 +63,7 @@ class OpenAPIOperationParameterResolver extends StepParameterResolver {
       throw new ResolverError('`parameters` is present but is not a list', {
         ...scope,
         target: 'parameters',
-        reason: 'malformed-parameters'
+        reason: ResolverError.MalformedParameters
       });
     }
     for (const parameter of parameters) {
@@ -75,7 +75,7 @@ class OpenAPIOperationParameterResolver extends StepParameterResolver {
       if (identity === undefined) {
         throw new ResolverError('Parameter has a missing or non-string name', {
           ...scope,
-          reason: 'missing-name'
+          reason: ResolverError.MissingName
         });
       }
       const {
@@ -86,21 +86,21 @@ class OpenAPIOperationParameterResolver extends StepParameterResolver {
         throw new ResolverError(`Parameter "${name}" declares no location ("in"), which a step targeting an operation requires`, {
           ...scope,
           target: name,
-          reason: 'missing-location'
+          reason: ResolverError.MissingLocation
         });
       }
       if (location === null) {
         throw new ResolverError(`Parameter "${name}" has a non-string location ("in")`, {
           ...scope,
           target: name,
-          reason: 'malformed-location'
+          reason: ResolverError.MalformedLocation
         });
       }
       if (!identity.hasDefinedLocation) {
         throw new ResolverError(`Parameter "${name}" has location "${location}", which is not one of ` + `${ParameterIdentity.LOCATIONS.join(', ')}`, {
           ...scope,
           target: name,
-          reason: 'invalid-location'
+          reason: ResolverError.InvalidLocation
         });
       }
       const {
@@ -114,7 +114,7 @@ class OpenAPIOperationParameterResolver extends StepParameterResolver {
         throw new ResolverError(`Parameter "${name}" (in: ${location}) ${why} and cannot be delivered unambiguously`, {
           ...scope,
           target: name,
-          reason: 'ambiguous-delivery'
+          reason: ResolverError.AmbiguousDelivery
         });
       }
       delivery.set(key, this.resolveValue(parameter.value, resolve));

package/src/resolver/OutputResolver.cjs

@@ -30,7 +30,7 @@ class OutputResolver extends _ArazzoValueResolver.default {
    *
    * `scope` names the step or workflow the outputs belong to, for a thrown
    * {@link ResolverError}. An output value that is not a valid runtime
-   * expression throws with `reason: 'invalid-expression'`.
+   * expression throws with reason `ResolverError.InvalidExpression`.
    */
   resolve(outputs, resolve, scope) {
     const result = {};
@@ -41,7 +41,7 @@ class OutputResolver extends _ArazzoValueResolver.default {
       throw new _ResolverError.default('`outputs` is present but is not a map', {
         ...scope,
         target: 'outputs',
-        reason: 'malformed-outputs'
+        reason: _ResolverError.default.MalformedOutputs
       });
     }
     outputs.forEach((value, key) => {
@@ -51,7 +51,7 @@ class OutputResolver extends _ArazzoValueResolver.default {
         throw new _ResolverError.default(`Output "${name}" is not a valid runtime expression`, {
           ...scope,
           target: 'outputs',
-          reason: 'invalid-expression'
+          reason: _ResolverError.default.InvalidExpression
         });
       }
       // defined rather than assigned: a name like `__proto__` hits the

package/src/resolver/OutputResolver.mjs

@@ -23,7 +23,7 @@ class OutputResolver extends ArazzoValueResolver {
    *
    * `scope` names the step or workflow the outputs belong to, for a thrown
    * {@link ResolverError}. An output value that is not a valid runtime
-   * expression throws with `reason: 'invalid-expression'`.
+   * expression throws with reason `ResolverError.InvalidExpression`.
    */
   resolve(outputs, resolve, scope) {
     const result = {};
@@ -34,7 +34,7 @@ class OutputResolver extends ArazzoValueResolver {
       throw new ResolverError('`outputs` is present but is not a map', {
         ...scope,
         target: 'outputs',
-        reason: 'malformed-outputs'
+        reason: ResolverError.MalformedOutputs
       });
     }
     outputs.forEach((value, key) => {
@@ -44,7 +44,7 @@ class OutputResolver extends ArazzoValueResolver {
         throw new ResolverError(`Output "${name}" is not a valid runtime expression`, {
           ...scope,
           target: 'outputs',
-          reason: 'invalid-expression'
+          reason: ResolverError.InvalidExpression
         });
       }
       // defined rather than assigned: a name like `__proto__` hits the