@schnick371/devsteps-shared 1.1.0-next.3 → 2.0.0-next.1

package/dist/runtime/workflow-v2-continuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-continuation.js","sourceRoot":"","sources":["../../src/runtime/workflow-v2-continuation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GAGtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAW5D,sFAAsF;AACtF,MAAM,UAAU,6BAA6B,CAC3C,OAAyC,EACzC,GAAe;IAEf,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,OAAO;YACL,YAAY,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE;YACjC,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;SAC7B,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,kBAAkB,CAC1B,eAAe,EACf,iDAAiD,CAClD,CAAC;IACJ,CAAC;IACD,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,IAAI,wBAAwB,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/F,OAAO;YACL,YAAY,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,uBAAuB,EAAE;YACzE,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjE,OAAO,EAAE,YAAY,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC;AACxD,CAAC"}

package/dist/runtime/workflow-v2-dispatch.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Dispatch of compiled workflow runs.
+ * The next dispatch is a pure function of the manifest and the run snapshot, so a host can ask
+ * again at any time and receives the same step, arguments, and digest until a receipt lands.
+ */
+import { type WorkflowExecutionManifest } from '../core/workflow-compiler.js';
+import type { WorkflowRouteVerdict, WorkflowScriptContract, WorkflowSideEffect, WorkflowStep } from '../schemas/workflow-definition-v2.js';
+import type { ProcessRun } from './index.js';
+import { type WorkflowPredicateResult } from './predicates.js';
+import { type HumanDispatchContract } from './workflow-v2-human.js';
+import { type StepDisplayText } from './workflow-v2-step-text.js';
+export type WorkflowRunDispatch = Readonly<{
+    run_id: string;
+    run_version: number;
+    step_id: string;
+    kind: WorkflowStep['kind'];
+    attempt: number;
+    host_tool_name: string | null;
+    arguments: Readonly<Record<string, unknown>>;
+    side_effect: WorkflowSideEffect;
+    timeout_seconds: number;
+    expected_results: readonly Readonly<{
+        id: string;
+        kind: string;
+        target?: string;
+    }>[];
+    idempotency_key?: string;
+    script?: WorkflowScriptContract;
+    human?: HumanDispatchContract;
+    /** The resolved step-level why, stop, instruction and expected_observation; outside the digest. */
+    display?: StepDisplayText;
+    /** Results of the human step's `prevalidate` predicates, shown to the operator. */
+    prevalidation?: readonly WorkflowPredicateResult[];
+    browser_procedure?: WorkflowStep['browser'];
+    dispatch_digest: string;
+    /** What the step expects back; outside the digest, which covers only the dispatch core. */
+    reply: string;
+}>;
+export type WorkflowRunDispatchState = Readonly<{
+    status: 'dispatch';
+    step: WorkflowStep;
+    dispatch: WorkflowRunDispatch;
+}> | Readonly<{
+    status: 'awaiting-finalize';
+    pending_verdict: WorkflowRouteVerdict;
+}> | Readonly<{
+    status: 'terminal';
+    verdict: WorkflowRouteVerdict | null;
+}>;
+export declare function stepOf(manifest: WorkflowExecutionManifest, stepId: string): WorkflowStep;
+/** Build the dispatch for the step at the run cursor. */
+export declare function buildRunDispatch(manifest: WorkflowExecutionManifest, run: ProcessRun, step: WorkflowStep): WorkflowRunDispatch;
+/** What the run expects next: a step to execute, a finalize call, or nothing. */
+export declare function computeRunDispatch(manifest: WorkflowExecutionManifest, run: ProcessRun): WorkflowRunDispatchState;
+//# sourceMappingURL=workflow-v2-dispatch.d.ts.map

package/dist/runtime/workflow-v2-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-dispatch.d.ts","sourceRoot":"","sources":["../../src/runtime/workflow-v2-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,yBAAyB,EAAkB,MAAM,8BAA8B,CAAC;AAE9F,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,EACb,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAsC,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEnG,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,4BAA4B,CAAC;AAGnF,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7C,WAAW,EAAE,kBAAkB,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,SAAS,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,mGAAmG;IACnG,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,mFAAmF;IACnF,aAAa,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACnD,iBAAiB,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAChC,QAAQ,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC,GACnF,QAAQ,CAAC;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,eAAe,EAAE,oBAAoB,CAAA;CAAE,CAAC,GAChF,QAAQ,CAAC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC;AAE3E,wBAAgB,MAAM,CAAC,QAAQ,EAAE,yBAAyB,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAMxF;AAoDD,yDAAyD;AACzD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,yBAAyB,EACnC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,YAAY,GACjB,mBAAmB,CAgDrB;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,yBAAyB,EACnC,GAAG,EAAE,UAAU,GACd,wBAAwB,CAO1B"}

package/dist/runtime/workflow-v2-dispatch.js

@@ -0,0 +1,125 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Dispatch of compiled workflow runs.
+ * The next dispatch is a pure function of the manifest and the run snapshot, so a host can ask
+ * again at any time and receives the same step, arguments, and digest until a receipt lands.
+ */
+import { workflowDigest } from '../core/workflow-compiler.js';
+import { HUMAN_TRANSPORT_TOOL } from '../core/workflow-host-profiles.js';
+import { evaluateWorkflowPredicateInContext } from './predicates.js';
+import { renderWorkflowTemplate, WorkflowDispatchError } from './workflow-template.js';
+import { humanDispatchContract, humanTransportArguments, } from './workflow-v2-human.js';
+import { replyRules } from './workflow-v2-reply.js';
+import { stepDisplayText } from './workflow-v2-step-text.js';
+import { AWAITING_FINALIZE, WorkflowRunV2Error } from './workflow-v2-types.js';
+export function stepOf(manifest, stepId) {
+    const step = manifest.definition.steps.find((candidate) => candidate.id === stepId);
+    if (!step) {
+        throw new WorkflowRunV2Error('PROTOCOL_ERROR', `Run cursor names an unknown step: ${stepId}`);
+    }
+    return step;
+}
+function templateValues(run) {
+    return { variables: run.variables ?? {}, outputs: run.outputs ?? {} };
+}
+function render(value, run) {
+    const { variables, outputs } = templateValues(run);
+    try {
+        return renderWorkflowTemplate(value, variables, outputs);
+    }
+    catch (error) {
+        if (error instanceof WorkflowDispatchError) {
+            throw new WorkflowRunV2Error('MISSING_TEMPLATE', error.message);
+        }
+        throw error;
+    }
+}
+/** The script contract with its working directory rendered like the arguments (BUG-201). */
+function renderScript(script, run) {
+    if (script.working_directory === undefined)
+        return script;
+    const rendered = render(script.working_directory, run);
+    return {
+        ...script,
+        working_directory: typeof rendered === 'string' ? rendered : JSON.stringify(rendered),
+    };
+}
+function assertDependencies(step, run) {
+    if (step.kind === 'cleanup')
+        return;
+    const outputs = run.outputs ?? {};
+    const missing = step.depends_on.filter((dependency) => !(dependency in outputs));
+    if (missing.length > 0) {
+        throw new WorkflowRunV2Error('PROTOCOL_ERROR', `Step ${step.id} was routed to before its dependencies ran: ${missing.join(', ')}`);
+    }
+}
+function prevalidate(manifest, run, predicateIds) {
+    const context = { variables: run.variables ?? {}, outputs: run.outputs ?? {} };
+    return predicateIds.flatMap((id) => {
+        const predicate = manifest.definition.predicates.find((candidate) => candidate.id === id);
+        return predicate ? [evaluateWorkflowPredicateInContext(predicate, context)] : [];
+    });
+}
+/** Build the dispatch for the step at the run cursor. */
+export function buildRunDispatch(manifest, run, step) {
+    assertDependencies(step, run);
+    const attempt = (run.step_attempts?.[step.id] ?? 0) + 1;
+    const human = humanDispatchContract(manifest, step, (text) => render(text, run));
+    const hostToolName = human
+        ? HUMAN_TRANSPORT_TOOL[human.transport]
+        : (step.binding?.host_tool_name ?? null);
+    const args = human
+        ? humanTransportArguments(step.id, human)
+        : render(step.arguments_template, run);
+    const display = stepDisplayText(step, (text) => render(text, run));
+    const predicates = new Map(manifest.definition.predicates.map((entry) => [entry.id, entry]));
+    const dispatchCore = {
+        run_id: run.run_id,
+        step_id: step.id,
+        attempt,
+        host_tool_name: hostToolName,
+        arguments: args,
+    };
+    return {
+        run_id: run.run_id,
+        run_version: run.version,
+        step_id: step.id,
+        kind: step.kind,
+        attempt,
+        host_tool_name: hostToolName,
+        arguments: args,
+        side_effect: step.side_effect,
+        timeout_seconds: step.timeout_seconds,
+        expected_results: step.expected_results.map((id) => {
+            const target = predicates.get(id)?.parameters.target;
+            return {
+                id,
+                kind: predicates.get(id)?.kind ?? 'unknown',
+                ...(typeof target === 'string' ? { target } : {}),
+            };
+        }),
+        ...(step.idempotency_key ? { idempotency_key: render(step.idempotency_key, run) } : {}),
+        ...(step.script ? { script: renderScript(step.script, run) } : {}),
+        ...(human ? { human } : {}),
+        ...(display ? { display } : {}),
+        ...(step.human && step.human.prevalidate.length > 0
+            ? { prevalidation: prevalidate(manifest, run, step.human.prevalidate) }
+            : {}),
+        ...(step.browser ? { browser_procedure: render(step.browser, run) } : {}),
+        dispatch_digest: workflowDigest(dispatchCore),
+        reply: replyRules({ kind: step.kind, host_tool_name: hostToolName }),
+    };
+}
+/** What the run expects next: a step to execute, a finalize call, or nothing. */
+export function computeRunDispatch(manifest, run) {
+    if (run.terminal)
+        return { status: 'terminal', verdict: run.verdict ?? null };
+    if (run.state === AWAITING_FINALIZE) {
+        return { status: 'awaiting-finalize', pending_verdict: run.pending_verdict ?? 'INCONCLUSIVE' };
+    }
+    const step = stepOf(manifest, run.state);
+    return { status: 'dispatch', step, dispatch: buildRunDispatch(manifest, run, step) };
+}
+//# sourceMappingURL=workflow-v2-dispatch.js.map

package/dist/runtime/workflow-v2-dispatch.js.map

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

package/dist/runtime/workflow-v2-engine.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Persistence side of compiled workflow runs: dispatch and record under the run lock.
+ * Every accepted submission is committed atomically with its version bump; a retried submission
+ * returns the committed run instead of recording twice.
+ */
+import type { ProcessEvent, ProcessRun } from './index.js';
+import { type StepApplication } from './workflow-v2-receipt.js';
+import { type WorkflowV2DispatchResult, type WorkflowV2RunContext } from './workflow-v2-run.js';
+import { type ParsedSubmission, type WorkflowV2Submission } from './workflow-v2-submission.js';
+export * from './workflow-v2-submission.js';
+export type WorkflowV2RecordResult = Readonly<{
+    run: ProcessRun;
+    replayed: boolean;
+    next: WorkflowV2DispatchResult;
+}>;
+/** Build the application of a submission at the current cursor, without persisting it. */
+export declare function applySubmission(context: WorkflowV2RunContext, run: ProcessRun, submission: ParsedSubmission, input: WorkflowV2Submission, digest: string): StepApplication;
+/** Commit the runtime-decided steps at the cursor until the host has to act again. */
+export declare function advanceRuntimeSteps(context: WorkflowV2RunContext, run: ProcessRun, occurredAt: string): Promise<{
+    run: ProcessRun;
+    events: ProcessEvent[];
+}>;
+export declare function dispatchWorkflowRunV2(context: WorkflowV2RunContext, runId: string, occurredAt?: string): Promise<WorkflowV2DispatchResult>;
+export declare function recordWorkflowRunV2(context: WorkflowV2RunContext, runId: string, input: WorkflowV2Submission): Promise<WorkflowV2RecordResult>;
+//# sourceMappingURL=workflow-v2-engine.d.ts.map

package/dist/runtime/workflow-v2-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-engine.d.ts","sourceRoot":"","sources":["../../src/runtime/workflow-v2-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM3D,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAKL,KAAK,gBAAgB,EAErB,KAAK,oBAAoB,EAC1B,MAAM,6BAA6B,CAAC;AAGrC,cAAc,6BAA6B,CAAC;AAI5C,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,GAAG,EAAE,UAAU,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,wBAAwB,CAAC;CAChC,CAAC,CAAC;AAEH,0FAA0F;AAC1F,wBAAgB,eAAe,CAC7B,OAAO,EAAE,oBAAoB,EAC7B,GAAG,EAAE,UAAU,EACf,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,MAAM,GACb,eAAe,CAyBjB;AAiFD,sFAAsF;AACtF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,oBAAoB,EAC7B,GAAG,EAAE,UAAU,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CActD;AA6BD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,MAAM,EACb,UAAU,SAA2B,GACpC,OAAO,CAAC,wBAAwB,CAAC,CAYnC;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAoDjC"}

package/dist/runtime/workflow-v2-engine.js

@@ -0,0 +1,166 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Persistence side of compiled workflow runs: dispatch and record under the run lock.
+ * Every accepted submission is committed atomically with its version bump; a retried submission
+ * returns the committed run instead of recording twice.
+ */
+import { OPERATOR_HOST_TOOL } from '../core/workflow-host-profiles.js';
+import { computeRunDispatch } from './workflow-v2-dispatch.js';
+import { applyHumanResponse } from './workflow-v2-human-response.js';
+import { WORKFLOW_NOTE_SHAPE } from './workflow-v2-notes.js';
+import { applyWorkflowObservation } from './workflow-v2-observation.js';
+import { addressEvent, assertPartyMayRecord, confirmedByOperator } from './workflow-v2-parties.js';
+import { applyStepReceipt, requestDigest, } from './workflow-v2-receipt.js';
+import { withReplyHint } from './workflow-v2-reply.js';
+import { assertCurrentManifest, describeDispatchState, isWorkflowV2Run, } from './workflow-v2-run.js';
+import { nextRuntimeApplication } from './workflow-v2-runtime-steps.js';
+import { applyStepSkip } from './workflow-v2-skip.js';
+import { assertExpectedVersion, assertSubmissionActor, findReplay, occurredAtOf, parseSubmission, } from './workflow-v2-submission.js';
+import { WorkflowRunV2Error } from './workflow-v2-types.js';
+export * from './workflow-v2-submission.js';
+const MAX_RUNTIME_STEPS = 100;
+/** Build the application of a submission at the current cursor, without persisting it. */
+export function applySubmission(context, run, submission, input, digest) {
+    const state = computeRunDispatch(context.manifest, run);
+    if (state.status !== 'dispatch') {
+        throw new WorkflowRunV2Error('PROTOCOL_ERROR', state.status === 'awaiting-finalize'
+            ? `Run ${run.run_id} awaits workflow_run_finalize with verdict ${state.pending_verdict}; no step is dispatched`
+            : `Run ${run.run_id} is terminal`);
+    }
+    if (input.event !== undefined && input.event !== state.step.id) {
+        throw new WorkflowRunV2Error('PROTOCOL_ERROR', `event ${input.event} does not name the dispatched step ${state.step.id}; for v2 runs event is the step id or omitted`);
+    }
+    assertPartyMayRecord(run, state.step, input.actor);
+    const application = applyToStep(context, run, state, submission, {
+        actor: input.actor,
+        actorName: input.actorName,
+        occurredAt: occurredAtOf(input),
+        idempotencyKey: input.idempotencyKey,
+        requestDigest: digest,
+    });
+    return addressed(context, run, state.step, application);
+}
+/**
+ * The application with the record of who acted: an operator who discharges a step the agent
+ * held confirmed it (DEC-023), and the event is addressed to whoever acts next (DEC-022).
+ */
+function addressed(context, before, step, application) {
+    const confirmed = confirmedByOperator(before, step, application.event.actor);
+    const event = confirmed
+        ? {
+            ...application.event,
+            payload: { ...application.event.payload, confirmed_by_operator: true },
+        }
+        : application.event;
+    return { ...application, event: addressEvent(context.manifest, application.run, event) };
+}
+function applyToStep(context, run, state, submission, applicationInput) {
+    if (submission.kind === 'receipt') {
+        return applyStepReceipt(context.manifest, run, state.dispatch, state.step, submission.content, applicationInput);
+    }
+    if (submission.kind === 'observation') {
+        return applyWorkflowObservation(context.manifest, run, state.dispatch, state.step, submission.content, applicationInput);
+    }
+    if (submission.kind === 'skip') {
+        return applyStepSkip(context.manifest, run, state.dispatch, state.step, submission.content, applicationInput);
+    }
+    if (submission.kind === 'human') {
+        return applyHumanResponse(context.manifest, run, state.dispatch, state.step, submission.content, applicationInput);
+    }
+    const owed = state.step.kind === 'human'
+        ? 'human_response'
+        : state.dispatch.host_tool_name === OPERATOR_HOST_TOOL
+            ? 'observation'
+            : 'receipt';
+    throw new WorkflowRunV2Error('INPUT_INVALID', `Step ${state.step.id} (${state.step.kind}) needs a ${owed}`);
+}
+/** Commit the runtime-decided steps at the cursor until the host has to act again. */
+export async function advanceRuntimeSteps(context, run, occurredAt) {
+    let current = run;
+    const events = [];
+    for (let count = 0; count < MAX_RUNTIME_STEPS; count += 1) {
+        const application = nextRuntimeApplication(context.manifest, current, occurredAt);
+        if (!application)
+            return { run: current, events };
+        const event = addressEvent(context.manifest, application.run, application.event);
+        events.push(event);
+        current = await context.store.commitTransition(application.run, event, current.version);
+    }
+    throw new WorkflowRunV2Error('PROTOCOL_ERROR', `Run ${run.run_id} routed through ${MAX_RUNTIME_STEPS} runtime steps without reaching a host step; check the routes for a loop`);
+}
+/** Summaries of the steps the runtime decided itself, so the host sees why the cursor moved. */
+function withRuntimeDecisions(result, events) {
+    if (events.length === 0)
+        return result;
+    return {
+        ...result,
+        runtime_decisions: events.map((event) => ({
+            step_id: event.type,
+            runtime: String(event.payload.runtime),
+            outcome: String(event.payload.outcome),
+            ...(typeof event.payload.summary === 'string' ? { summary: event.payload.summary } : {}),
+            to_state: event.to_state,
+        })),
+    };
+}
+async function loadV2Run(context, runId) {
+    await context.store.recoverPendingTransition(runId);
+    const run = await context.store.load(runId);
+    if (!isWorkflowV2Run(run)) {
+        throw new WorkflowRunV2Error('PROTOCOL_ERROR', `Run ${runId} belongs to a v1 definition`);
+    }
+    return run;
+}
+export async function dispatchWorkflowRunV2(context, runId, occurredAt = new Date().toISOString()) {
+    return context.store.withLock(runId, async () => {
+        const loaded = await loadV2Run(context, runId);
+        if (!loaded.terminal)
+            assertCurrentManifest(context, loaded);
+        const { run, events } = loaded.terminal
+            ? { run: loaded, events: [] }
+            : await advanceRuntimeSteps(context, loaded, occurredAt);
+        return withRuntimeDecisions(describeDispatchState(run, computeRunDispatch(context.manifest, run)), events);
+    });
+}
+export async function recordWorkflowRunV2(context, runId, input) {
+    assertSubmissionActor(input);
+    return context.store.withLock(runId, async () => {
+        const run = await loadV2Run(context, runId);
+        const submission = parseSubmission(input);
+        if (submission.kind === 'none') {
+            const error = new WorkflowRunV2Error('INPUT_INVALID', 'A v2 run records a receipt (tool, script, artifact, cleanup steps), a human_response (human steps), an observation (steps bound to the operator role), a skip (optional steps) or a note object (a step note)');
+            // A note sent as flat fields lands here; the hint names the object it belongs in.
+            error.hint = WORKFLOW_NOTE_SHAPE;
+            throw error;
+        }
+        const digest = requestDigest(submission.kind, submission.content);
+        if (findReplay(await context.store.readEvents(runId), submission, digest, input.idempotencyKey)) {
+            return {
+                run,
+                replayed: true,
+                next: describeDispatchState(run, computeRunDispatch(context.manifest, run)),
+            };
+        }
+        if (run.terminal) {
+            throw new WorkflowRunV2Error('RUN_TERMINAL', `Run ${runId} is terminal (verdict ${run.verdict})`);
+        }
+        assertExpectedVersion(run, input.expectedVersion);
+        assertCurrentManifest(context, run);
+        const current = computeRunDispatch(context.manifest, run);
+        let application;
+        try {
+            application = applySubmission(context, run, submission, input, digest);
+        }
+        catch (error) {
+            throw withReplyHint(error, current.status === 'dispatch' ? current.dispatch : undefined);
+        }
+        await context.store.writeEvidenceFiles(runId, application.evidenceFiles);
+        const committed = await context.store.commitTransition(application.run, application.event, run.version);
+        const advanced = await advanceRuntimeSteps(context, committed, occurredAtOf(input));
+        const next = withRuntimeDecisions(describeDispatchState(advanced.run, computeRunDispatch(context.manifest, advanced.run)), advanced.events);
+        return { run: advanced.run, replayed: false, next };
+    });
+}
+//# sourceMappingURL=workflow-v2-engine.js.map

package/dist/runtime/workflow-v2-engine.js.map

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

package/dist/runtime/workflow-v2-failure-route.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * A failed operator report leaves the guide waiting for a tester's route decision. Existing
+ * events derive this hold; the runtime cursor, cleanup and verdict semantics stay intact.
+ * Only an exact check note or a real reroute releases it.
+ * @see BUG-226 DEC-076
+ */
+import type { ProcessEvent, ProcessRun } from './index.js';
+import { type WorkflowStepNote } from './workflow-v2-notes.js';
+import type { WorkflowV2RunContext } from './workflow-v2-run.js';
+import { type WorkflowRunEventInput } from './workflow-v2-run-events.js';
+export type WorkflowFailureRouteHold = Readonly<{
+    runId: string;
+    stepId: string;
+    sequence: number;
+    target: string;
+}>;
+/** The exact existing check-note shape agents and the guide use to confirm this route. */
+export declare function failureRouteConfirmationNote(hold: WorkflowFailureRouteHold): WorkflowStepNote;
+/** An on.fail step target needs the same decision as terminal FAIL followed by owed cleanup. */
+export declare function workflowFailureRouteHold(run: ProcessRun, events: readonly ProcessEvent[]): WorkflowFailureRouteHold | undefined;
+/** A stale operator submission meets the same hold that removed its buttons. */
+export declare function assertFailureRouteResolved(run: ProcessRun, events: readonly ProcessEvent[]): void;
+/** Commit an explicit tester decision under the same lock as every other run event. */
+export declare function confirmWorkflowFailureRoute(context: WorkflowV2RunContext, runId: string, expected: WorkflowFailureRouteHold, input: WorkflowRunEventInput): Promise<ProcessRun>;
+//# sourceMappingURL=workflow-v2-failure-route.d.ts.map

package/dist/runtime/workflow-v2-failure-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-failure-route.d.ts","sourceRoot":"","sources":["../../src/runtime/workflow-v2-failure-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAA0B,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGjG,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAoBH,0FAA0F;AAC1F,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,wBAAwB,GAAG,gBAAgB,CAM7F;AAyBD,gGAAgG;AAChG,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,wBAAwB,GAAG,SAAS,CAuBtC;AAED,gFAAgF;AAChF,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAQjG;AAED,uFAAuF;AACvF,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,wBAAwB,EAClC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,UAAU,CAAC,CAoBrB"}

package/dist/runtime/workflow-v2-failure-route.js

@@ -0,0 +1,101 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * A failed operator report leaves the guide waiting for a tester's route decision. Existing
+ * events derive this hold; the runtime cursor, cleanup and verdict semantics stay intact.
+ * Only an exact check note or a real reroute releases it.
+ * @see BUG-226 DEC-076
+ */
+import { applyStepNote } from './workflow-v2-notes.js';
+import { commitWorkflowRunEvent } from './workflow-v2-run-events.js';
+import { WorkflowRunV2Error } from './workflow-v2-types.js';
+function record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function failedOperatorRoute(event) {
+    const route = record(event.payload.route);
+    return (event.actor === 'human' &&
+        !event.type.startsWith('run.') &&
+        typeof event.payload.step_id === 'string' &&
+        route?.slot === 'fail' &&
+        route.via !== 'answer' &&
+        (route.kind === 'step' || route.kind === 'verdict'));
+}
+/** The exact existing check-note shape agents and the guide use to confirm this route. */
+export function failureRouteConfirmationNote(hold) {
+    return {
+        step_id: hold.stepId,
+        kind: 'check',
+        text: `Failure route confirmed: run ${hold.runId}; source ${hold.stepId}; failure event ${hold.sequence}; target ${hold.target}.`,
+    };
+}
+function confirmsRoute(event, hold) {
+    // A confirmed route stays confirmed when cleanup advances to its next step. The note itself
+    // pins the exact cursor where the tester made the decision, rather than today's cursor.
+    const note = failureRouteConfirmationNote({ ...hold, target: event.from_state });
+    return (event.type === 'run.note' &&
+        (event.actor === 'agent' || event.actor === 'human') &&
+        event.payload.step_id === note.step_id &&
+        event.payload.kind === note.kind &&
+        event.payload.text === note.text);
+}
+function reroutesFailure(event, failed) {
+    if (event.type !== 'run.revise')
+        return false;
+    const cursor = record(event.payload.cursor);
+    const moved = cursor?.from === failed.to_state && cursor.to !== cursor.from;
+    const pendingChanged = 'pending_verdict' in event.payload &&
+        event.payload.pending_verdict !== failed.payload.pending_verdict;
+    return moved || pendingChanged;
+}
+/** An on.fail step target needs the same decision as terminal FAIL followed by owed cleanup. */
+export function workflowFailureRouteHold(run, events) {
+    if (run.terminal)
+        return undefined;
+    const ordered = [...events].sort((left, right) => left.sequence - right.sequence);
+    const failed = ordered.filter(failedOperatorRoute).at(-1);
+    if (!failed)
+        return undefined;
+    const later = ordered.filter((event) => event.sequence > failed.sequence);
+    const hold = {
+        runId: run.run_id,
+        stepId: String(failed.payload.step_id),
+        sequence: failed.sequence,
+        target: run.state,
+    };
+    // A new record of the source after correction supersedes its earlier failure.
+    const replaced = later.some((event) => !event.type.startsWith('run.') && event.payload.step_id === hold.stepId);
+    if (replaced ||
+        later.some((event) => reroutesFailure(event, failed)) ||
+        later.some((event) => confirmsRoute(event, hold)))
+        return undefined;
+    return hold;
+}
+/** A stale operator submission meets the same hold that removed its buttons. */
+export function assertFailureRouteResolved(run, events) {
+    const hold = workflowFailureRouteHold(run, events);
+    if (!hold)
+        return;
+    throw new WorkflowRunV2Error('POLICY_DENIED', `Waiting for the tester's decision on the failure route from step ${hold.stepId}.`, { failure_route: hold, confirmation_note: failureRouteConfirmationNote(hold) });
+}
+/** Commit an explicit tester decision under the same lock as every other run event. */
+export async function confirmWorkflowFailureRoute(context, runId, expected, input) {
+    return commitWorkflowRunEvent(context, runId, (run, events) => {
+        const hold = workflowFailureRouteHold(run, events);
+        if (!hold ||
+            hold.runId !== expected.runId ||
+            hold.stepId !== expected.stepId ||
+            hold.sequence !== expected.sequence ||
+            hold.target !== expected.target) {
+            throw new WorkflowRunV2Error('PROTOCOL_ERROR', 'The failure route changed; review its current target before confirming it.');
+        }
+        if (input.actor !== 'agent' && input.actor !== 'human') {
+            throw new WorkflowRunV2Error('POLICY_DENIED', 'A tester must confirm the failure route.');
+        }
+        return applyStepNote(context, run, events, failureRouteConfirmationNote(hold), input);
+    });
+}
+//# sourceMappingURL=workflow-v2-failure-route.js.map

package/dist/runtime/workflow-v2-failure-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-failure-route.js","sourceRoot":"","sources":["../../src/runtime/workflow-v2-failure-route.ts"],"names":[],"mappings":"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"}

package/dist/runtime/workflow-v2-fields.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Declared fields of v2 steps (STORY-450): the values the operator fills in when reporting or
+ * answering a step, validated against the step's contract before anything is recorded, and kept
+ * as structured evidence with digests. A refusal names the field by its label. Fields add
+ * observation; the route still comes from the report's status or the answer's mapping.
+ * @see STORY-450
+ */
+import type { WorkflowStep, WorkflowStepField } from '../schemas/workflow-definition-v2.js';
+import { type EvidenceFile, type RunEvidence } from './evidence.js';
+export type WorkflowFieldValue = string | number | boolean;
+export type WorkflowFieldValues = Readonly<Record<string, WorkflowFieldValue>>;
+export type RecordedWorkflowField = Readonly<{
+    id: string;
+    label: string;
+    kind: WorkflowStepField['kind'];
+    value: string | number | boolean;
+}>;
+/**
+ * The step's fields with their values, in declared order. A required field must be filled when
+ * the step is reported done or answered positively; a value for an undeclared field, a value of
+ * the wrong kind and a secret-shaped value are refused.
+ */
+export declare function validateStepFields(step: WorkflowStep, values: WorkflowFieldValues | undefined, positive: boolean): RecordedWorkflowField[];
+/** The values as a step output reads them: `outputs.<step>.fields.<id>`. */
+export declare function fieldOutput(recorded: readonly RecordedWorkflowField[]): {
+    fields?: Record<string, string | number | boolean>;
+};
+/** One evidence entry with a digest per field; a long value is written out as a file. */
+export declare function fieldEvidence(stepId: string, recorded: readonly RecordedWorkflowField[], at: Readonly<{
+    attempt: number;
+    sequence: number;
+    capturedAt: string;
+}>): {
+    entries: RunEvidence[];
+    files: EvidenceFile[];
+};
+//# sourceMappingURL=workflow-v2-fields.d.ts.map

package/dist/runtime/workflow-v2-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-fields.d.ts","sourceRoot":"","sources":["../../src/runtime/workflow-v2-fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC5F,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAIrF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAE/E,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAClC,CAAC,CAAC;AAoDH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,OAAO,GAChB,qBAAqB,EAAE,CA6BzB;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,GAAG;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACpD,CAGA;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,qBAAqB,EAAE,EAC1C,EAAE,EAAE,QAAQ,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GACtE;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE,CAiBnD"}