@usearazzo/runner 1.0.1-alpha.26 → 1.0.1-alpha.27

package/src/resolver/WorkflowParameterResolver.cjs

@@ -12,7 +12,8 @@ var _ResolverError = _interopRequireDefault(require("../errors/ResolverError.cjs
 var _StepParameterResolver = _interopRequireDefault(require("./StepParameterResolver.cjs"));
 /**
  * Resolves the `parameters` of a step targeting a `workflowId` into the
- * sub-workflow's inputs.
+ * sub-workflow's inputs — or those of a `goto` / `retry` action naming a
+ * `workflowId` into its target's.
  *
  * Values follow the family-wide literal-vs-expression rule of
  * {@link ArazzoValueResolver}. Keys are bare parameter names: per the

package/src/resolver/WorkflowParameterResolver.mjs

@@ -5,7 +5,8 @@ import ResolverError from "../errors/ResolverError.mjs";
 import StepParameterResolver from "./StepParameterResolver.mjs";
 /**
  * Resolves the `parameters` of a step targeting a `workflowId` into the
- * sub-workflow's inputs.
+ * sub-workflow's inputs — or those of a `goto` / `retry` action naming a
+ * `workflowId` into its target's.
  *
  * Values follow the family-wide literal-vs-expression rule of
  * {@link ArazzoValueResolver}. Keys are bare parameter names: per the

package/src/state/WorkflowExecutionState.cjs

@@ -37,7 +37,9 @@ class WorkflowExecutionState {
 
   /**
    * Records the resolved outputs of a completed step, read via
-   * `$steps.{stepId}.outputs.{name}`.
+   * `$steps.{stepId}.outputs.{name}`. Every run records, so a step run again
+   * (a `goto` back, a retry) or a later step sharing its `stepId` replaces
+   * the earlier outputs, even with none.
    */
   setStepOutputs(stepId, outputs) {
     this.#steps.set(stepId, outputs);

package/src/state/WorkflowExecutionState.mjs

@@ -31,7 +31,9 @@ class WorkflowExecutionState {
 
   /**
    * Records the resolved outputs of a completed step, read via
-   * `$steps.{stepId}.outputs.{name}`.
+   * `$steps.{stepId}.outputs.{name}`. Every run records, so a step run again
+   * (a `goto` back, a retry) or a later step sharing its `stepId` replaces
+   * the earlier outputs, even with none.
    */
   setStepOutputs(stepId, outputs) {
     this.#steps.set(stepId, outputs);

package/types/runner.d.ts

@@ -3,6 +3,7 @@ import { ApiDOMReferenceOptions } from '@speclynx/apidom-reference/configuration
 import { ApiDOMStructuredError } from '@speclynx/apidom-error';
 import { CriterionElement } from '@speclynx/apidom-ns-arazzo-1';
 import { FailureActionElement } from '@speclynx/apidom-ns-arazzo-1';
+import { FailureActionParametersElement } from '@speclynx/apidom-ns-arazzo-1';
 import { JSONPointer } from '@speclynx/apidom-json-pointer';
 import { OperationElement } from '@speclynx/apidom-ns-openapi-2';
 import { OperationElement as OperationElement_2 } from '@speclynx/apidom-ns-openapi-3-0';
@@ -20,6 +21,7 @@ import { StepOnSuccessElement } from '@speclynx/apidom-ns-arazzo-1';
 import type { StepOutputsElement } from '@speclynx/apidom-ns-arazzo-1';
 import { StepParametersElement } from '@speclynx/apidom-ns-arazzo-1';
 import { SuccessActionElement } from '@speclynx/apidom-ns-arazzo-1';
+import { SuccessActionParametersElement } from '@speclynx/apidom-ns-arazzo-1';
 import { toYAML } from '@speclynx/apidom-core';
 import { WorkflowElement } from '@speclynx/apidom-ns-arazzo-1';
 import type { WorkflowOutputsElement } from '@speclynx/apidom-ns-arazzo-1';
@@ -1716,6 +1718,13 @@ export declare interface ResolvedRequestBody {
  * @public
  */
 export declare class ResolverError extends ArazzoRunnerError {
+    /**
+     * A parameter of a Success / Failure Action declares an `in` inline, which
+     * the Arazzo Specification forbids; one inherited from a
+     * `$components.parameters` Reusable Object maps by name instead. Thrown
+     * before the workflow's first request.
+     */
+    static readonly ActionParameterLocation: "action-parameter-location";
     /** A parameter cannot be delivered unambiguously at its location. */
     static readonly AmbiguousDelivery: "ambiguous-delivery";
     /** An output or a request body payload holds a value that is not a valid runtime expression. */
@@ -2169,6 +2178,18 @@ export declare interface StepExecutionResult {
      * in list order.
      */
     readonly actionCriteria: readonly CriterionEvaluationRecord[];
+    /**
+     * The runtime-expression context the step's actions are taken in: the
+     * context its action `criteria` were evaluated against, with
+     * `$steps.{stepId}.outputs` holding the outputs this attempt just resolved.
+     *
+     * An action's `parameters` resolve against it, so a `goto` or `retry` naming
+     * a `workflowId` passes values read from this step's response, request and
+     * fresh outputs. The overlay matters because run state is written only once
+     * a step's retry chain settles, so mid-chain it may still hold an earlier
+     * run's outputs.
+     */
+    readonly actionContext: RuntimeExpressionContext;
 }
 
 /**
@@ -2279,6 +2300,17 @@ export declare class StepExecutor {
      * {@link StepExecutor.execute}.
      */
     selectActions(step: StepElement, successful: boolean, context: RuntimeExpressionContext, workflowId?: string): Pick<StepExecutionResult, 'matchedActions' | 'actionCriteria'>;
+    /**
+     * The context a step's actions are taken in — see
+     * {@link StepExecutionResult.actionContext}: `context` with
+     * `$steps.{stepId}.outputs` replaced by the outputs the attempt just
+     * resolved, as a fresh object, so run state is never written.
+     *
+     * Public for the same reason as {@link StepExecutor.selectActions}: the
+     * workflow executor builds this context for a step targeting a
+     * `workflowId`, which never reaches {@link StepExecutor.execute}.
+     */
+    actionContext(context: RuntimeExpressionContext, stepId: string, outputs: Record<string, unknown>): RuntimeExpressionContext;
 }
 
 /**
@@ -2588,7 +2620,9 @@ export declare class WorkflowExecutionState {
     constructor(options?: WorkflowExecutionStateOptions);
     /**
      * Records the resolved outputs of a completed step, read via
-     * `$steps.{stepId}.outputs.{name}`.
+     * `$steps.{stepId}.outputs.{name}`. Every run records, so a step run again
+     * (a `goto` back, a retry) or a later step sharing its `stepId` replaces
+     * the earlier outputs, even with none.
      */
     setStepOutputs(stepId: string, outputs: Record<string, unknown>): void;
     /**
@@ -2769,7 +2803,8 @@ export declare type WorkflowId = string;
 
 /**
  * Resolves the `parameters` of a step targeting a `workflowId` into the
- * sub-workflow's inputs.
+ * sub-workflow's inputs — or those of a `goto` / `retry` action naming a
+ * `workflowId` into its target's.
  *
  * Values follow the family-wide literal-vs-expression rule of
  * {@link ArazzoValueResolver}. Keys are bare parameter names: per the
@@ -2792,7 +2827,7 @@ export declare class WorkflowParameterResolver extends StepParameterResolver {
      *
      * `scope` names the step in a thrown {@link ResolverError}.
      */
-    resolve(parameters: StepParametersElement | undefined, resolve: RuntimeExpressionResolver, scope: StepScope): Record<string, unknown>;
+    resolve(parameters: StepParametersElement | SuccessActionParametersElement | FailureActionParametersElement | undefined, resolve: RuntimeExpressionResolver, scope: StepScope): Record<string, unknown>;
 }
 
 /**