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

package/src/errors/ExecutionError.mjs

@@ -1,4 +1,76 @@
 import ArazzoRunnerError from "./ArazzoRunnerError.mjs";
-/** @public */
-class ExecutionError extends ArazzoRunnerError {}
+/**
+ * Carries a `reason`, one of the class's static reason fields.
+ *
+ * Every static on this class is a reason: {@link ExecutionErrorReason} is
+ * derived from the class's own statics, so a non-reason static would join the
+ * union.
+ * @public
+ */
+class ExecutionError extends ArazzoRunnerError {
+  /** The run was cancelled through its `AbortSignal`; the signal's reason is the `cause`. */
+  static Aborted = 'aborted';
+  /** A step or a `goto`/`retry` action declares more than one mutually exclusive target. */
+  static AmbiguousTarget = 'ambiguous-target';
+  /** The `dependsOn` edges alone form a cycle between workflows. */
+  static DependsOnCycle = 'dependsOn-cycle';
+  /** A `goto` action declares neither a `stepId` nor a `workflowId`. */
+  static GotoTargetMissing = 'goto-target-missing';
+  /** A `goto` action's `stepId` names no step in the workflow. */
+  static GotoTargetNotFound = 'goto-target-not-found';
+  /** An `operationId` or `operationPath` is not a valid operation reference. */
+  static InvalidOperationReference = 'invalid-operation-reference';
+  /** A `workflowId` is not a valid `$sourceDescriptions.{name}.{workflowId}` expression. */
+  static InvalidWorkflowReference = 'invalid-workflow-reference';
+  /** A workflow's `dependsOn` is not a list or holds a non-string entry. */
+  static MalformedDependsOn = 'malformed-dependsOn';
+  /** A workflow's `steps` is not a list or holds an entry that is not a Step Object. */
+  static MalformedSteps = 'malformed-steps';
+  /** A step run as an operation declares neither an `operationId` nor an `operationPath`. */
+  static MissingOperation = 'missing-operation';
+  /** An operation reference locates no operation in its OpenAPI source description. */
+  static OperationNotFound = 'operation-not-found';
+  /** A `retry` action references a step or workflow, but no run reference was given to run it. */
+  static RetryReferenceUnsupported = 'retry-reference-unsupported';
+  /** A `retry` action's `stepId` names no step in the workflow. */
+  static RetryTargetNotFound = 'retry-target-not-found';
+  /** A workflow reference names a source description that is not an Arazzo document. */
+  static SourceDescriptionNotArazzo = 'source-description-not-arazzo';
+  /** A reference names a source description the Arazzo document does not define. */
+  static SourceDescriptionNotFound = 'source-description-not-found';
+  /** An operation reference names a source description that is not an OpenAPI document. */
+  static SourceDescriptionNotOpenAPI = 'source-description-not-openapi';
+  /** A workflow exceeded its budget of step attempts. */
+  static StepBudget = 'step-budget';
+  /** An action declares a `type` other than `end`, `goto` or `retry`. */
+  static UnknownActionType = 'unknown-action-type';
+  /** `execute` received an option it does not know. */
+  static UnknownExecuteOption = 'unknown-execute-option';
+  /** A step produced a transition the workflow executor does not recognize. */
+  static UnknownTransitionKind = 'unknown-transition-kind';
+  /** A sub-workflow call (alone or together with `dependsOn`) forms a cycle between workflows. */
+  static WorkflowCycle = 'workflow-cycle';
+  /** Workflows nest deeper than the configured limit. */
+  static WorkflowDepth = 'workflow-depth';
+  /** A workflow reference names a workflow the Arazzo document does not define. */
+  static WorkflowNotFound = 'workflow-not-found';
+  /** A step that targets a workflow was handed to the step executor, which runs operations only. */
+  static WorkflowStep = 'workflow-step';
+
+  /**
+   * The chain of workflowIds the error concerns — the loop A → B → A for a
+   * cycle, or the call chain in progress when a budget ran out.
+   */
+
+  constructor(message, options) {
+    super(message, options);
+  }
+}
+
+/**
+ * One of the reasons an {@link ExecutionError} carries: an `ExecutionError`
+ * static such as `ExecutionError.OperationNotFound`.
+ * @public
+ */
+
 export default ExecutionError;

package/src/errors/ResolverError.cjs

@@ -6,6 +6,57 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _ArazzoRunnerError = _interopRequireDefault(require("./ArazzoRunnerError.cjs"));
-/** @public */
-class ResolverError extends _ArazzoRunnerError.default {}
+/**
+ * Carries a `reason`, one of the class's static reason fields.
+ *
+ * Every static on this class is a reason: {@link ResolverErrorReason} is
+ * derived from the class's own statics, so a non-reason static would join the
+ * union.
+ * @public
+ */
+class ResolverError extends _ArazzoRunnerError.default {
+  /** A parameter cannot be delivered unambiguously at its location. */
+  static AmbiguousDelivery = 'ambiguous-delivery';
+  /** An output or a request body payload holds a value that is not a valid runtime expression. */
+  static InvalidExpression = 'invalid-expression';
+  /** A parameter's location (`in`) is not one of the known locations. */
+  static InvalidLocation = 'invalid-location';
+  /** An `onSuccess`/`onFailure` list holds an entry that is not a Success/Failure Action Object. */
+  static MalformedActionEntry = 'malformed-action-entry';
+  /** A step's `onSuccess` or `onFailure` is present but is not a list. */
+  static MalformedActions = 'malformed-actions';
+  /** A step's `successCriteria` or an action's `criteria` is present but is not a list. */
+  static MalformedCriteria = 'malformed-criteria';
+  /** A criteria list holds an entry that is not a Criterion Object. */
+  static MalformedCriterion = 'malformed-criterion';
+  /** A parameter's location (`in`) is not a string. */
+  static MalformedLocation = 'malformed-location';
+  /** A step's or workflow's `outputs` is present but is not a map. */
+  static MalformedOutputs = 'malformed-outputs';
+  /** `parameters` is present but is not a list. */
+  static MalformedParameters = 'malformed-parameters';
+  /** `requestBody.replacements` is present but is not a list. */
+  static MalformedReplacements = 'malformed-replacements';
+  /** `requestBody` is present but is not a map. */
+  static MalformedRequestBody = 'malformed-request-body';
+  /** A parameter of a step that targets an operation declares no location (`in`). */
+  static MissingLocation = 'missing-location';
+  /** A parameter has a missing or non-string `name`. */
+  static MissingName = 'missing-name';
+  /** A runtime expression in the request body did not resolve. */
+  static UnresolvedExpression = 'unresolved-expression';
+  /** A `requestBody` replacement target does not resolve in the payload. */
+  static UnresolvedTarget = 'unresolved-target';
+  /** A `requestBody` replacement target is not a JSON Pointer. */
+  static UnsupportedTarget = 'unsupported-target';
+  constructor(message, options) {
+    super(message, options);
+  }
+}
+
+/**
+ * One of the reasons a {@link ResolverError} carries: a `ResolverError`
+ * static such as `ResolverError.MalformedParameters`.
+ * @public
+ */
 var _default = exports.default = ResolverError;

package/src/errors/ResolverError.mjs

@@ -1,4 +1,56 @@
 import ArazzoRunnerError from "./ArazzoRunnerError.mjs";
-/** @public */
-class ResolverError extends ArazzoRunnerError {}
+/**
+ * Carries a `reason`, one of the class's static reason fields.
+ *
+ * Every static on this class is a reason: {@link ResolverErrorReason} is
+ * derived from the class's own statics, so a non-reason static would join the
+ * union.
+ * @public
+ */
+class ResolverError extends ArazzoRunnerError {
+  /** A parameter cannot be delivered unambiguously at its location. */
+  static AmbiguousDelivery = 'ambiguous-delivery';
+  /** An output or a request body payload holds a value that is not a valid runtime expression. */
+  static InvalidExpression = 'invalid-expression';
+  /** A parameter's location (`in`) is not one of the known locations. */
+  static InvalidLocation = 'invalid-location';
+  /** An `onSuccess`/`onFailure` list holds an entry that is not a Success/Failure Action Object. */
+  static MalformedActionEntry = 'malformed-action-entry';
+  /** A step's `onSuccess` or `onFailure` is present but is not a list. */
+  static MalformedActions = 'malformed-actions';
+  /** A step's `successCriteria` or an action's `criteria` is present but is not a list. */
+  static MalformedCriteria = 'malformed-criteria';
+  /** A criteria list holds an entry that is not a Criterion Object. */
+  static MalformedCriterion = 'malformed-criterion';
+  /** A parameter's location (`in`) is not a string. */
+  static MalformedLocation = 'malformed-location';
+  /** A step's or workflow's `outputs` is present but is not a map. */
+  static MalformedOutputs = 'malformed-outputs';
+  /** `parameters` is present but is not a list. */
+  static MalformedParameters = 'malformed-parameters';
+  /** `requestBody.replacements` is present but is not a list. */
+  static MalformedReplacements = 'malformed-replacements';
+  /** `requestBody` is present but is not a map. */
+  static MalformedRequestBody = 'malformed-request-body';
+  /** A parameter of a step that targets an operation declares no location (`in`). */
+  static MissingLocation = 'missing-location';
+  /** A parameter has a missing or non-string `name`. */
+  static MissingName = 'missing-name';
+  /** A runtime expression in the request body did not resolve. */
+  static UnresolvedExpression = 'unresolved-expression';
+  /** A `requestBody` replacement target does not resolve in the payload. */
+  static UnresolvedTarget = 'unresolved-target';
+  /** A `requestBody` replacement target is not a JSON Pointer. */
+  static UnsupportedTarget = 'unsupported-target';
+  constructor(message, options) {
+    super(message, options);
+  }
+}
+
+/**
+ * One of the reasons a {@link ResolverError} carries: a `ResolverError`
+ * static such as `ResolverError.MalformedParameters`.
+ * @public
+ */
+
 export default ResolverError;

package/src/errors/RuntimeExpressionError.cjs

@@ -6,6 +6,36 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _ArazzoRunnerError = _interopRequireDefault(require("./ArazzoRunnerError.cjs"));
-/** @public */
-class RuntimeExpressionError extends _ArazzoRunnerError.default {}
+/**
+ * Carries a `reason`, one of the class's static reason fields.
+ *
+ * Every static on this class is a reason: {@link RuntimeExpressionErrorReason}
+ * is derived from the class's own statics, so a non-reason static would join
+ * the union.
+ * @public
+ */
+class RuntimeExpressionError extends _ArazzoRunnerError.default {
+  /** The expression is not a valid runtime expression. */
+  static InvalidExpression = 'invalid-expression';
+  /** The runtime expression parser failed on the expression. */
+  static ParseError = 'parse-error';
+  /**
+   * The expression reads HTTP data (`$statusCode`, `$url`, `$method`, `$request`,
+   * `$response`) in a step that calls a workflow and so made no HTTP call.
+   */
+  static UnavailableExpression = 'unavailable-expression';
+  /** The expression could not be resolved against the evaluation context. */
+  static UnresolvedReference = 'unresolved-reference';
+  /** The parsed expression contains a node the evaluator does not support. */
+  static UnsupportedNode = 'unsupported-node';
+  constructor(message, options) {
+    super(message, options);
+  }
+}
+
+/**
+ * One of the reasons a {@link RuntimeExpressionError} carries: a
+ * `RuntimeExpressionError` static such as `RuntimeExpressionError.ParseError`.
+ * @public
+ */
 var _default = exports.default = RuntimeExpressionError;

package/src/errors/RuntimeExpressionError.mjs

@@ -1,4 +1,35 @@
 import ArazzoRunnerError from "./ArazzoRunnerError.mjs";
-/** @public */
-class RuntimeExpressionError extends ArazzoRunnerError {}
+/**
+ * Carries a `reason`, one of the class's static reason fields.
+ *
+ * Every static on this class is a reason: {@link RuntimeExpressionErrorReason}
+ * is derived from the class's own statics, so a non-reason static would join
+ * the union.
+ * @public
+ */
+class RuntimeExpressionError extends ArazzoRunnerError {
+  /** The expression is not a valid runtime expression. */
+  static InvalidExpression = 'invalid-expression';
+  /** The runtime expression parser failed on the expression. */
+  static ParseError = 'parse-error';
+  /**
+   * The expression reads HTTP data (`$statusCode`, `$url`, `$method`, `$request`,
+   * `$response`) in a step that calls a workflow and so made no HTTP call.
+   */
+  static UnavailableExpression = 'unavailable-expression';
+  /** The expression could not be resolved against the evaluation context. */
+  static UnresolvedReference = 'unresolved-reference';
+  /** The parsed expression contains a node the evaluator does not support. */
+  static UnsupportedNode = 'unsupported-node';
+  constructor(message, options) {
+    super(message, options);
+  }
+}
+
+/**
+ * One of the reasons a {@link RuntimeExpressionError} carries: a
+ * `RuntimeExpressionError` static such as `RuntimeExpressionError.ParseError`.
+ * @public
+ */
+
 export default RuntimeExpressionError;

package/src/executor/ArazzoWorkflowLocatorNormalizer.cjs

@@ -75,7 +75,7 @@ class ArazzoWorkflowLocatorNormalizer extends _SourceDescriptionsLocatorNormaliz
       throw new _ExecutionError.default(`workflow reference "${reference}" in workflow "${context.workflowId}" names workflow "${locator.workflowId}", which the Arazzo document at "${locator.document.uri}" does not define`, {
         workflowId: context.workflowId,
         stepId: context.stepId,
-        reason: 'workflow-not-found'
+        reason: _ExecutionError.default.WorkflowNotFound
       });
     }
     return locator;
@@ -104,7 +104,7 @@ class ArazzoWorkflowLocatorNormalizer extends _SourceDescriptionsLocatorNormaliz
       throw new _ExecutionError.default(`workflow reference "${reference}" in workflow "${workflowId}" is not a $sourceDescriptions.{name}.{workflowId} expression`, {
         workflowId,
         stepId,
-        reason: 'invalid-workflow-reference'
+        reason: _ExecutionError.default.InvalidWorkflowReference
       });
     }
     return {
@@ -138,7 +138,7 @@ class ArazzoWorkflowLocatorNormalizer extends _SourceDescriptionsLocatorNormaliz
       throw new _ExecutionError.default(`workflow reference "${parsed.reference}" in workflow "${workflowId}" names source description "${parsed.sourceName}", which the Arazzo document at "${document.uri}" does not define`, {
         workflowId,
         stepId,
-        reason: 'source-description-not-found'
+        reason: _ExecutionError.default.SourceDescriptionNotFound
       });
     }
     const source = await this.registry.acquire(uri);
@@ -146,7 +146,7 @@ class ArazzoWorkflowLocatorNormalizer extends _SourceDescriptionsLocatorNormaliz
       throw new _ExecutionError.default(`workflow reference "${parsed.reference}" in workflow "${workflowId}" names source description "${parsed.sourceName}" at "${uri}", which is not an Arazzo document`, {
         workflowId,
         stepId,
-        reason: 'source-description-not-arazzo'
+        reason: _ExecutionError.default.SourceDescriptionNotArazzo
       });
     }
     return {

package/src/executor/ArazzoWorkflowLocatorNormalizer.mjs

@@ -65,7 +65,7 @@ class ArazzoWorkflowLocatorNormalizer extends SourceDescriptionsLocatorNormalize
       throw new ExecutionError(`workflow reference "${reference}" in workflow "${context.workflowId}" names workflow "${locator.workflowId}", which the Arazzo document at "${locator.document.uri}" does not define`, {
         workflowId: context.workflowId,
         stepId: context.stepId,
-        reason: 'workflow-not-found'
+        reason: ExecutionError.WorkflowNotFound
       });
     }
     return locator;
@@ -94,7 +94,7 @@ class ArazzoWorkflowLocatorNormalizer extends SourceDescriptionsLocatorNormalize
       throw new ExecutionError(`workflow reference "${reference}" in workflow "${workflowId}" is not a $sourceDescriptions.{name}.{workflowId} expression`, {
         workflowId,
         stepId,
-        reason: 'invalid-workflow-reference'
+        reason: ExecutionError.InvalidWorkflowReference
       });
     }
     return {
@@ -128,7 +128,7 @@ class ArazzoWorkflowLocatorNormalizer extends SourceDescriptionsLocatorNormalize
       throw new ExecutionError(`workflow reference "${parsed.reference}" in workflow "${workflowId}" names source description "${parsed.sourceName}", which the Arazzo document at "${document.uri}" does not define`, {
         workflowId,
         stepId,
-        reason: 'source-description-not-found'
+        reason: ExecutionError.SourceDescriptionNotFound
       });
     }
     const source = await this.registry.acquire(uri);
@@ -136,7 +136,7 @@ class ArazzoWorkflowLocatorNormalizer extends SourceDescriptionsLocatorNormalize
       throw new ExecutionError(`workflow reference "${parsed.reference}" in workflow "${workflowId}" names source description "${parsed.sourceName}" at "${uri}", which is not an Arazzo document`, {
         workflowId,
         stepId,
-        reason: 'source-description-not-arazzo'
+        reason: ExecutionError.SourceDescriptionNotArazzo
       });
     }
     return {

package/src/executor/OpenAPIOperationLocatorNormalizer.cjs

@@ -94,7 +94,7 @@ class OpenAPIOperationLocatorNormalizer extends _SourceDescriptionsLocatorNormal
       if (parsed !== undefined && document.resolveSourceDescriptionURI(parsed.sourceName) === undefined) {
         throw new _ExecutionError.default(`operationPath "${operationPath}" names source description "${parsed.sourceName}", which the Arazzo document at "${document.uri}" does not define`, {
           ...scope,
-          reason: 'source-description-not-found'
+          reason: _ExecutionError.default.SourceDescriptionNotFound
         });
       }
     }
@@ -108,21 +108,21 @@ class OpenAPIOperationLocatorNormalizer extends _SourceDescriptionsLocatorNormal
     if (documentURI === '') {
       throw new _ExecutionError.default(`operationPath "${operationPath}" does not resolve to a source description URL`, {
         ...scope,
-        reason: 'invalid-operation-reference'
+        reason: _ExecutionError.default.InvalidOperationReference
       });
     }
     const jsonPointer = _jsonPointer.URIFragmentIdentifier.fromURIReference(uriReference);
     if (!(0, _jsonPointer.testJSONPointer)(jsonPointer)) {
       throw new _ExecutionError.default(`operationPath "${operationPath}" has an invalid JSON Pointer`, {
         ...scope,
-        reason: 'invalid-operation-reference'
+        reason: _ExecutionError.default.InvalidOperationReference
       });
     }
     const source = await this.registry.acquire(documentURI);
     if (!_OpenAPIDocument.default.is(source)) {
       throw new _ExecutionError.default(`operationPath "${operationPath}" references "${documentURI}", which is not an OpenAPI document`, {
         ...scope,
-        reason: 'source-description-not-openapi'
+        reason: _ExecutionError.default.SourceDescriptionNotOpenAPI
       });
     }
 
@@ -134,7 +134,7 @@ class OpenAPIOperationLocatorNormalizer extends _SourceDescriptionsLocatorNormal
       throw new _ExecutionError.default(`operationPath "${operationPath}" does not locate an operation in the OpenAPI document at "${source.uri}"`, {
         cause: error,
         ...scope,
-        reason: 'operation-not-found'
+        reason: _ExecutionError.default.OperationNotFound
       });
     }
     return {
@@ -147,7 +147,7 @@ class OpenAPIOperationLocatorNormalizer extends _SourceDescriptionsLocatorNormal
     if (parsed === undefined) {
       throw new _ExecutionError.default(`operationId "${expression}" is not a $sourceDescriptions.{name}.{operationId} expression`, {
         ...scope,
-        reason: 'invalid-operation-reference'
+        reason: _ExecutionError.default.InvalidOperationReference
       });
     }
     const {
@@ -159,7 +159,7 @@ class OpenAPIOperationLocatorNormalizer extends _SourceDescriptionsLocatorNormal
     if (jsonPointer === undefined) {
       throw new _ExecutionError.default(`Operation "${operationId}" not found in source description "${sourceName}" at "${openapiDocument.uri}"`, {
         ...scope,
-        reason: 'operation-not-found'
+        reason: _ExecutionError.default.OperationNotFound
       });
     }
     return {
@@ -188,7 +188,7 @@ class OpenAPIOperationLocatorNormalizer extends _SourceDescriptionsLocatorNormal
       if (jsonPointer === undefined) {
         throw new _ExecutionError.default(`Operation "${operationId}" not found in source description at "${source.uri}"`, {
           ...scope,
-          reason: 'operation-not-found'
+          reason: _ExecutionError.default.OperationNotFound
         });
       }
       return {
@@ -201,7 +201,7 @@ class OpenAPIOperationLocatorNormalizer extends _SourceDescriptionsLocatorNormal
     // is simply no OpenAPI document for the operation to be in.
     throw new _ExecutionError.default(`Operation "${operationId}" not found: the Arazzo document at "${document.uri}" has no OpenAPI source description`, {
       ...scope,
-      reason: 'operation-not-found'
+      reason: _ExecutionError.default.OperationNotFound
     });
   }
 
@@ -213,14 +213,14 @@ class OpenAPIOperationLocatorNormalizer extends _SourceDescriptionsLocatorNormal
     if (uri === undefined) {
       throw new _ExecutionError.default(`Source description "${sourceName}" not found in the Arazzo document at "${document.uri}"`, {
         ...scope,
-        reason: 'source-description-not-found'
+        reason: _ExecutionError.default.SourceDescriptionNotFound
       });
     }
     const source = await this.registry.acquire(uri);
     if (!_OpenAPIDocument.default.is(source)) {
       throw new _ExecutionError.default(`Source description "${sourceName}" at "${uri}" is not an OpenAPI document`, {
         ...scope,
-        reason: 'source-description-not-openapi'
+        reason: _ExecutionError.default.SourceDescriptionNotOpenAPI
       });
     }
     return source;

package/src/executor/OpenAPIOperationLocatorNormalizer.mjs

@@ -86,7 +86,7 @@ class OpenAPIOperationLocatorNormalizer extends SourceDescriptionsLocatorNormali
       if (parsed !== undefined && document.resolveSourceDescriptionURI(parsed.sourceName) === undefined) {
         throw new ExecutionError(`operationPath "${operationPath}" names source description "${parsed.sourceName}", which the Arazzo document at "${document.uri}" does not define`, {
           ...scope,
-          reason: 'source-description-not-found'
+          reason: ExecutionError.SourceDescriptionNotFound
         });
       }
     }
@@ -100,21 +100,21 @@ class OpenAPIOperationLocatorNormalizer extends SourceDescriptionsLocatorNormali
     if (documentURI === '') {
       throw new ExecutionError(`operationPath "${operationPath}" does not resolve to a source description URL`, {
         ...scope,
-        reason: 'invalid-operation-reference'
+        reason: ExecutionError.InvalidOperationReference
       });
     }
     const jsonPointer = URIFragmentIdentifier.fromURIReference(uriReference);
     if (!testJSONPointer(jsonPointer)) {
       throw new ExecutionError(`operationPath "${operationPath}" has an invalid JSON Pointer`, {
         ...scope,
-        reason: 'invalid-operation-reference'
+        reason: ExecutionError.InvalidOperationReference
       });
     }
     const source = await this.registry.acquire(documentURI);
     if (!OpenAPIDocument.is(source)) {
       throw new ExecutionError(`operationPath "${operationPath}" references "${documentURI}", which is not an OpenAPI document`, {
         ...scope,
-        reason: 'source-description-not-openapi'
+        reason: ExecutionError.SourceDescriptionNotOpenAPI
       });
     }
 
@@ -126,7 +126,7 @@ class OpenAPIOperationLocatorNormalizer extends SourceDescriptionsLocatorNormali
       throw new ExecutionError(`operationPath "${operationPath}" does not locate an operation in the OpenAPI document at "${source.uri}"`, {
         cause: error,
         ...scope,
-        reason: 'operation-not-found'
+        reason: ExecutionError.OperationNotFound
       });
     }
     return {
@@ -139,7 +139,7 @@ class OpenAPIOperationLocatorNormalizer extends SourceDescriptionsLocatorNormali
     if (parsed === undefined) {
       throw new ExecutionError(`operationId "${expression}" is not a $sourceDescriptions.{name}.{operationId} expression`, {
         ...scope,
-        reason: 'invalid-operation-reference'
+        reason: ExecutionError.InvalidOperationReference
       });
     }
     const {
@@ -151,7 +151,7 @@ class OpenAPIOperationLocatorNormalizer extends SourceDescriptionsLocatorNormali
     if (jsonPointer === undefined) {
       throw new ExecutionError(`Operation "${operationId}" not found in source description "${sourceName}" at "${openapiDocument.uri}"`, {
         ...scope,
-        reason: 'operation-not-found'
+        reason: ExecutionError.OperationNotFound
       });
     }
     return {
@@ -180,7 +180,7 @@ class OpenAPIOperationLocatorNormalizer extends SourceDescriptionsLocatorNormali
       if (jsonPointer === undefined) {
         throw new ExecutionError(`Operation "${operationId}" not found in source description at "${source.uri}"`, {
           ...scope,
-          reason: 'operation-not-found'
+          reason: ExecutionError.OperationNotFound
         });
       }
       return {
@@ -193,7 +193,7 @@ class OpenAPIOperationLocatorNormalizer extends SourceDescriptionsLocatorNormali
     // is simply no OpenAPI document for the operation to be in.
     throw new ExecutionError(`Operation "${operationId}" not found: the Arazzo document at "${document.uri}" has no OpenAPI source description`, {
       ...scope,
-      reason: 'operation-not-found'
+      reason: ExecutionError.OperationNotFound
     });
   }
 
@@ -205,14 +205,14 @@ class OpenAPIOperationLocatorNormalizer extends SourceDescriptionsLocatorNormali
     if (uri === undefined) {
       throw new ExecutionError(`Source description "${sourceName}" not found in the Arazzo document at "${document.uri}"`, {
         ...scope,
-        reason: 'source-description-not-found'
+        reason: ExecutionError.SourceDescriptionNotFound
       });
     }
     const source = await this.registry.acquire(uri);
     if (!OpenAPIDocument.is(source)) {
       throw new ExecutionError(`Source description "${sourceName}" at "${uri}" is not an OpenAPI document`, {
         ...scope,
-        reason: 'source-description-not-openapi'
+        reason: ExecutionError.SourceDescriptionNotOpenAPI
       });
     }
     return source;

package/src/executor/StepExecutor.cjs

@@ -130,7 +130,7 @@ class StepExecutor {
    * take precedence over it.
    *
    * A `signal` in that bag is honored here and not only at the transport: an
-   * already-aborted signal throws `reason: 'aborted'` instead of issuing a
+   * already-aborted signal throws with reason `ExecutionError.Aborted` instead of issuing a
    * request nobody is waiting for, whose wire-level cancellation would surface
    * as a transport {@link ClientError} — a request that failed on its own terms
    * — rather than as the withdrawal it is.
@@ -154,13 +154,13 @@ class StepExecutor {
     if (declaredTargets.length > 1) {
       throw new _ExecutionError.default(`Step "${stepId}" declares more than one of ${STEP_TARGET_FIELDS.join(', ')} (mutually exclusive)`, {
         ...scope,
-        reason: 'ambiguous-target'
+        reason: _ExecutionError.default.AmbiguousTarget
       });
     }
     if ((0, _apidomDatamodel.isStringElement)(step.workflowId)) {
       throw new _ExecutionError.default(`Step "${stepId}" targets a workflowId; use the workflow executor`, {
         ...scope,
-        reason: 'workflow-step'
+        reason: _ExecutionError.default.WorkflowStep
       });
     }
     this.assertSuccessCriteria(step, workflowId);
@@ -254,7 +254,7 @@ class StepExecutor {
     }
     throw new _ExecutionError.default(`Step "${scope.stepId}" has no operationId or operationPath`, {
       ...scope,
-      reason: 'missing-operation'
+      reason: _ExecutionError.default.MissingOperation
     });
   }
 
@@ -285,13 +285,13 @@ class StepExecutor {
     if (!(0, _apidomDatamodel.isArrayElement)(criteria)) {
       throw new _ResolverError.default("A step's `successCriteria` is present but is not a list", {
         ...scope,
-        reason: 'malformed-criteria'
+        reason: _ResolverError.default.MalformedCriteria
       });
     }
     if (![...criteria].every(_apidomNsArazzo.isCriterionElement)) {
       throw new _ResolverError.default("A step's `successCriteria` contains an entry that is not a Criterion Object", {
         ...scope,
-        reason: 'malformed-criterion'
+        reason: _ResolverError.default.MalformedCriterion
       });
     }
   }
@@ -394,7 +394,7 @@ class StepExecutor {
       // a step that calls a workflow made no HTTP call, so a condition on one
       // fails like any unevaluable condition; the diagnostic keeps the
       // authoring mistake visible.
-      if (error instanceof _RuntimeExpressionError.default && error.reason === 'unavailable-expression') {
+      if (error instanceof _RuntimeExpressionError.default && error.reason === _RuntimeExpressionError.default.UnavailableExpression) {
         return {
           condition,
           met: false,

package/src/executor/StepExecutor.mjs

@@ -123,7 +123,7 @@ class StepExecutor {
    * take precedence over it.
    *
    * A `signal` in that bag is honored here and not only at the transport: an
-   * already-aborted signal throws `reason: 'aborted'` instead of issuing a
+   * already-aborted signal throws with reason `ExecutionError.Aborted` instead of issuing a
    * request nobody is waiting for, whose wire-level cancellation would surface
    * as a transport {@link ClientError} — a request that failed on its own terms
    * — rather than as the withdrawal it is.
@@ -147,13 +147,13 @@ class StepExecutor {
     if (declaredTargets.length > 1) {
       throw new ExecutionError(`Step "${stepId}" declares more than one of ${STEP_TARGET_FIELDS.join(', ')} (mutually exclusive)`, {
         ...scope,
-        reason: 'ambiguous-target'
+        reason: ExecutionError.AmbiguousTarget
       });
     }
     if (isStringElement(step.workflowId)) {
       throw new ExecutionError(`Step "${stepId}" targets a workflowId; use the workflow executor`, {
         ...scope,
-        reason: 'workflow-step'
+        reason: ExecutionError.WorkflowStep
       });
     }
     this.assertSuccessCriteria(step, workflowId);
@@ -247,7 +247,7 @@ class StepExecutor {
     }
     throw new ExecutionError(`Step "${scope.stepId}" has no operationId or operationPath`, {
       ...scope,
-      reason: 'missing-operation'
+      reason: ExecutionError.MissingOperation
     });
   }
 
@@ -278,13 +278,13 @@ class StepExecutor {
     if (!isArrayElement(criteria)) {
       throw new ResolverError("A step's `successCriteria` is present but is not a list", {
         ...scope,
-        reason: 'malformed-criteria'
+        reason: ResolverError.MalformedCriteria
       });
     }
     if (![...criteria].every(isCriterionElement)) {
       throw new ResolverError("A step's `successCriteria` contains an entry that is not a Criterion Object", {
         ...scope,
-        reason: 'malformed-criterion'
+        reason: ResolverError.MalformedCriterion
       });
     }
   }
@@ -387,7 +387,7 @@ class StepExecutor {
       // a step that calls a workflow made no HTTP call, so a condition on one
       // fails like any unevaluable condition; the diagnostic keeps the
       // authoring mistake visible.
-      if (error instanceof RuntimeExpressionError && error.reason === 'unavailable-expression') {
+      if (error instanceof RuntimeExpressionError && error.reason === RuntimeExpressionError.UnavailableExpression) {
         return {
           condition,
           met: false,