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

package/dist/runtime/workflow-v2-party-state.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * What each party of a v2 run needs to know next: the run's mode, who carries out the current
+ * step, which problems and questions are still open, and — while the run waits on the operator —
+ * how an agent waits for it without being told (DEC-022). The wait recipe travels in band with
+ * every answer, so no tool text has to carry it.
+ * @see STORY-463
+ */
+import type { WorkflowExecutionManifest } from '../core/workflow-compiler.js';
+import type { ProcessEvent, ProcessRun } from './index.js';
+import { type WorkflowV2StepNoteView } from './workflow-v2-notes.js';
+import type { WorkflowParty, WorkflowRunMode } from './workflow-v2-types.js';
+/** The text a waiting agent matches in the run's event log. */
+export declare const AGENT_WAKE_MATCH = "\"notify\":\"agent\"";
+/** How often the poll recipe looks, and how long it waits before it returns empty-handed. */
+export declare const AGENT_POLL_INTERVAL_SECONDS = 5;
+export declare const AGENT_POLL_TIMEOUT_SECONDS = 540;
+/**
+ * A wait for hosts without a streaming monitor (BUG-189): one command that reads only the lines
+ * after `after_line` every `interval_seconds` and returns as soon as one is addressed to the agent
+ * and the writer is done (exit 0), or after `timeout_seconds` (exit 1). A pipe from `tail -F`
+ * would return only at its timeout, because tail lives on until it writes again.
+ */
+export type WorkflowV2Poll = Readonly<{
+    interval_seconds: number;
+    timeout_seconds: number;
+    /** Lines of the event log when the answer was given; only later lines can wake the agent. */
+    after_line: number;
+    sh: string;
+    powershell: string;
+}>;
+/** The wait as one tool call: workflow_run_get with these arguments (BUG-210). */
+export type WorkflowV2WaitCall = Readonly<{
+    tool: 'workflow_run_get';
+    wait_seconds: number;
+    after_version: number;
+}>;
+export type WorkflowV2Wait = Readonly<{
+    /** Who the run waits on: the operator for a step or for the verdict. */
+    for: 'operator';
+    call?: WorkflowV2WaitCall;
+    events_file: string;
+    match: string;
+    how: string;
+    poll: WorkflowV2Poll;
+}>;
+export type WorkflowV2PartyState = Readonly<{
+    mode: WorkflowRunMode;
+    /** Who carries out the current step; absent once no step is current. */
+    current_assignee?: WorkflowParty;
+    assignments: Readonly<Record<string, WorkflowParty>>;
+    open_notes: readonly WorkflowV2StepNoteView[];
+    wait?: WorkflowV2Wait;
+}>;
+/** The poll commands for an event log; `timing` exists for tests, answers use the defaults. */
+export declare function agentPoll(eventsFile: string, afterLine: number, timing?: {
+    interval: number;
+    timeout: number;
+}): WorkflowV2Poll;
+/**
+ * The recipe for an agent that waits on the operator. First the wait as one tool call, which
+ * returns with the operator's events (BUG-210); then, for a host that cuts long tool calls, a
+ * watch on the run's own event log for the next line addressed to the agent, read through the
+ * tools once the writer is done. No wait opens run.json, because on Windows an open reader can
+ * make the writer's rename fail.
+ */
+export declare function agentWaitRecipe(eventsFile: string, afterLine?: number, afterVersion?: number): WorkflowV2Wait;
+/**
+ * `eventLines` is the event log's physical line count (`RunStore.eventLineCount`); without it the
+ * events are counted, which is the same for a log no repair touched.
+ */
+export declare function workflowV2PartyState(manifest: WorkflowExecutionManifest, run: ProcessRun, events: readonly ProcessEvent[], eventsFile: string, eventLines?: number): WorkflowV2PartyState;
+//# sourceMappingURL=workflow-v2-party-state.d.ts.map

package/dist/runtime/workflow-v2-party-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-party-state.d.ts","sourceRoot":"","sources":["../../src/runtime/workflow-v2-party-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,KAAK,sBAAsB,EAAuB,MAAM,wBAAwB,CAAC;AAE1F,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG7E,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,yBAAqB,CAAC;AAEnD,6FAA6F;AAC7F,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,6FAA6F;IAC7F,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH,kFAAkF;AAClF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,IAAI,EAAE,kBAAkB,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,wEAAwE;IACxE,GAAG,EAAE,UAAU,CAAC;IAChB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,eAAe,CAAC;IACtB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,aAAa,CAAC;IACjC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACrD,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC9C,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB,CAAC,CAAC;AAKH,+FAA+F;AAC/F,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM;;;CAAiF,GACtF,cAAc,CAuBhB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,SAAS,SAAI,EACb,YAAY,CAAC,EAAE,MAAM,GACpB,cAAc,CA4BhB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,yBAAyB,EACnC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,SAAgB,GACzB,oBAAoB,CAetB"}

package/dist/runtime/workflow-v2-party-state.js

@@ -0,0 +1,98 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * What each party of a v2 run needs to know next: the run's mode, who carries out the current
+ * step, which problems and questions are still open, and — while the run waits on the operator —
+ * how an agent waits for it without being told (DEC-022). The wait recipe travels in band with
+ * every answer, so no tool text has to carry it.
+ * @see STORY-463
+ */
+import { workflowV2StepNotes } from './workflow-v2-notes.js';
+import { awaitedParty, workflowRunMode } from './workflow-v2-parties.js';
+import { AGENT_WAIT_MAX_SECONDS } from './workflow-v2-wait.js';
+/** The text a waiting agent matches in the run's event log. */
+export const AGENT_WAKE_MATCH = '"notify":"agent"';
+/** How often the poll recipe looks, and how long it waits before it returns empty-handed. */
+export const AGENT_POLL_INTERVAL_SECONDS = 5;
+export const AGENT_POLL_TIMEOUT_SECONDS = 540;
+const shQuote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
+const psQuote = (value) => `'${value.replaceAll("'", "''")}'`;
+/** The poll commands for an event log; `timing` exists for tests, answers use the defaults. */
+export function agentPoll(eventsFile, afterLine, timing = { interval: AGENT_POLL_INTERVAL_SECONDS, timeout: AGENT_POLL_TIMEOUT_SECONDS }) {
+    const directory = eventsFile.replace(/[\\/][^\\/]+$/, '');
+    const rounds = Math.ceil(timing.timeout / timing.interval);
+    const sh = `f=${shQuote(eventsFile)}; d=${shQuote(directory)}; i=0; while [ $i -lt ${rounds} ]; do ` +
+        `if tail -n +${afterLine + 1} "$f" | grep -qF '${AGENT_WAKE_MATCH}' && ` +
+        `[ ! -e "$d/run.lock" ] && [ ! -e "$d/pending-transition.json" ]; then break; fi; ` +
+        `sleep ${timing.interval}; i=$((i+1)); done; [ $i -lt ${rounds} ]`;
+    const powershell = `$f=${psQuote(eventsFile)}; $d=${psQuote(directory)}; $hit=$false; ` +
+        `for ($i=0; $i -lt ${rounds}; $i++) { ` +
+        `if ((Get-Content -LiteralPath $f | Select-Object -Skip ${afterLine} | ` +
+        `Select-String -SimpleMatch '${AGENT_WAKE_MATCH}' -Quiet) -and ` +
+        `-not (Test-Path -LiteralPath "$d/run.lock") -and ` +
+        `-not (Test-Path -LiteralPath "$d/pending-transition.json")) { $hit=$true; break }; ` +
+        `Start-Sleep -Seconds ${timing.interval} }; if (-not $hit) { exit 1 }`;
+    return {
+        interval_seconds: timing.interval,
+        timeout_seconds: timing.timeout,
+        after_line: afterLine,
+        sh,
+        powershell,
+    };
+}
+/**
+ * The recipe for an agent that waits on the operator. First the wait as one tool call, which
+ * returns with the operator's events (BUG-210); then, for a host that cuts long tool calls, a
+ * watch on the run's own event log for the next line addressed to the agent, read through the
+ * tools once the writer is done. No wait opens run.json, because on Windows an open reader can
+ * make the writer's rename fail.
+ */
+export function agentWaitRecipe(eventsFile, afterLine = 0, afterVersion) {
+    const directory = eventsFile.replace(/[\\/][^\\/]+$/, '');
+    const timeout = AGENT_POLL_TIMEOUT_SECONDS;
+    const call = afterVersion === undefined
+        ? undefined
+        : {
+            tool: 'workflow_run_get',
+            wait_seconds: AGENT_WAIT_MAX_SECONDS,
+            after_version: afterVersion,
+        };
+    const first = call
+        ? `The run waits on the operator. Call workflow_run_get with wait_seconds ${call.wait_seconds} and after_version ${call.after_version} (wait.call): it answers woke: true with the events as soon as the operator reports, answers or writes a note, else woke: false; then call it again with the run.version it answered. Claude Code runs a long call in the background and resumes you when it returns. Without a long tool call: `
+        : 'The run waits on the operator. ';
+    return {
+        for: 'operator',
+        ...(call ? { call } : {}),
+        events_file: eventsFile,
+        match: AGENT_WAKE_MATCH,
+        how: `${first}Claude Code: Monitor with tail -n0 -F "${eventsFile}" | grep --line-buffered '${AGENT_WAKE_MATCH}'. ` +
+            `When a line arrives and neither "${directory}/run.lock" nor "${directory}/pending-transition.json" exists, call workflow_dispatch_get (or workflow_run_get for open_notes). ` +
+            `A host without a monitor runs poll.sh or poll.powershell as one shell command from the workspace root, with a tool timeout above ${timeout} s: ` +
+            `it looks every ${AGENT_POLL_INTERVAL_SECONDS} s and ends with exit 0 once such a line has arrived and the writer is done, or with exit 1 after ${timeout} s; then call workflow_run_get and wait again with its new poll. ` +
+            // BUG-224: a Done or an answer can carry the operator's own words; they are no note.
+            "A report or answer of the operator can carry their words (operator_said in the wait call, executor_report.observation or human_answer in the line): compare them with the step's expected observation, and answer a deviation, a remark or a question with workflow_run_record note before you go on.",
+        poll: agentPoll(eventsFile, afterLine),
+    };
+}
+/**
+ * `eventLines` is the event log's physical line count (`RunStore.eventLineCount`); without it the
+ * events are counted, which is the same for a log no repair touched.
+ */
+export function workflowV2PartyState(manifest, run, events, eventsFile, eventLines = events.length) {
+    const mode = workflowRunMode(run);
+    const awaited = awaitedParty(manifest, run);
+    const open = workflowV2StepNotes(events).filter((note) => note.open);
+    const waitsOnOperator = awaited === 'operator' || (awaited === 'finalize' && mode !== 'agent');
+    return {
+        mode,
+        ...(awaited === 'operator' || awaited === 'agent' ? { current_assignee: awaited } : {}),
+        assignments: run.assignments ?? {},
+        open_notes: open,
+        // Open notes from the operator are the agent's to answer first; then it waits.
+        ...(waitsOnOperator && !open.some((note) => note.actor !== 'agent')
+            ? { wait: agentWaitRecipe(eventsFile, eventLines, run.version) }
+            : {}),
+    };
+}
+//# sourceMappingURL=workflow-v2-party-state.js.map

package/dist/runtime/workflow-v2-party-state.js.map

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

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

@@ -0,0 +1,54 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Step receipts of compiled workflow runs.
+ * Verifies a host receipt against the dispatch, maps it into step outputs, judges the declared
+ * predicates, routes, and builds the event. Nothing here touches the filesystem.
+ */
+import { type WorkflowExecutionManifest } from '../core/workflow-compiler.js';
+import type { WorkflowStep } from '../schemas/workflow-definition-v2.js';
+import { type EvidenceFile } from './evidence.js';
+import type { ProcessEvent, ProcessRun, RuntimeActor } from './index.js';
+import { type WorkflowPredicateResult } from './predicates.js';
+import type { WorkflowRunDispatch } from './workflow-v2-dispatch.js';
+import { type WorkflowRoute } from './workflow-v2-routing.js';
+import { type WorkflowStepOutput, type WorkflowStepReceipt } from './workflow-v2-types.js';
+export declare const CAPTURE_PREVIEW_LIMIT = 2000;
+export type StepApplicationInput = Readonly<{
+    actor: RuntimeActor;
+    /** The actor's name, carried onto the event so the record says who discharged the step. */
+    actorName?: string;
+    occurredAt: string;
+    idempotencyKey?: string;
+    requestDigest: string;
+}>;
+export type StepApplication = Readonly<{
+    run: ProcessRun;
+    event: ProcessEvent;
+    route: WorkflowRoute;
+    /** Redacted captures above the preview limit, written under the run directory before commit. */
+    evidenceFiles: readonly EvidenceFile[];
+}>;
+export declare function capturePreview(text: string, limit?: number): string;
+/** Digest of what a caller submitted, over redacted content, used to recognise a retried request. */
+export declare function requestDigest(kind: string, content: unknown): string;
+export declare function verifyReceiptAgainstDispatch(dispatch: WorkflowRunDispatch, receipt: WorkflowStepReceipt): void;
+/** How much of stdout the extracts read, and how long one value may be (BUG-216). */
+export declare const EXTRACT_INPUT_LIMIT = 262144;
+export declare const EXTRACT_VALUE_LIMIT = 2000;
+/**
+ * The script's declared extracts read from stdout (BUG-216): group 1 of each multiline pattern,
+ * else its whole match, trimmed and bounded; a pattern that matches nothing is named in
+ * `missing`. CRLF lines are read as LF, so `$` ends a Windows line too; only the first
+ * `EXTRACT_INPUT_LIMIT` characters are searched, which bounds an authored pattern's cost.
+ */
+export declare function extractValues(step: WorkflowStep, stdout: string | undefined): {
+    declared: boolean;
+    values: Record<string, string>;
+    missing: string[];
+};
+export declare function evaluateStepPredicates(manifest: WorkflowExecutionManifest, step: WorkflowStep, run: ProcessRun, stepOutput: WorkflowStepOutput | undefined, receipt?: unknown, predicateIds?: readonly string[]): WorkflowPredicateResult[];
+/** Apply a verified tool, script, artifact, or cleanup receipt to the run. */
+export declare function applyStepReceipt(manifest: WorkflowExecutionManifest, run: ProcessRun, dispatch: WorkflowRunDispatch, step: WorkflowStep, receipt: WorkflowStepReceipt, input: StepApplicationInput): StepApplication;
+//# sourceMappingURL=workflow-v2-receipt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-receipt.d.ts","sourceRoot":"","sources":["../../src/runtime/workflow-v2-receipt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,yBAAyB,EAAkB,MAAM,8BAA8B,CAAC;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,EAEL,KAAK,YAAY,EAGlB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,KAAK,EAAE,YAAY,CAAC;IACpB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,aAAa,CAAC;IACrB,gGAAgG;IAChG,aAAa,EAAE,SAAS,YAAY,EAAE,CAAC;CACxC,CAAC,CAAC;AAuCH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAwB,GAAG,MAAM,CAMlF;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAEpE;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE,mBAAmB,GAC3B,IAAI,CA2BN;AAWD,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAC3C,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS;;;;EAW3E;AAmDD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,yBAAyB,EACnC,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,UAAU,EACf,UAAU,EAAE,kBAAkB,GAAG,SAAS,EAC1C,OAAO,CAAC,EAAE,OAAO,EACjB,YAAY,GAAE,SAAS,MAAM,EAA0B,GACtD,uBAAuB,EAAE,CAU3B;AAqDD,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,yBAAyB,EACnC,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,mBAAmB,EAC7B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,oBAAoB,GAC1B,eAAe,CA2DjB"}

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

@@ -0,0 +1,252 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Step receipts of compiled workflow runs.
+ * Verifies a host receipt against the dispatch, maps it into step outputs, judges the declared
+ * predicates, routes, and builds the event. Nothing here touches the filesystem.
+ */
+import { workflowDigest } from '../core/workflow-compiler.js';
+import { stableJson } from './dispatcher.js';
+import { captureEvidence, normalizeEvidence, } from './evidence.js';
+import { evaluateSemanticJudgment, evaluateWorkflowPredicateInContext, } from './predicates.js';
+import { redactText, redactValue } from './redaction.js';
+import { advanceWorkflowCursor, resolveWorkflowRoute, } from './workflow-v2-routing.js';
+import { workflowV2Event } from './workflow-v2-run.js';
+import { WorkflowRunV2Error, } from './workflow-v2-types.js';
+export const CAPTURE_PREVIEW_LIMIT = 2000;
+function receiptEvidence(step, dispatch, receipt, sequence, capturedAt) {
+    const evidence = [];
+    const files = [];
+    const captured = {
+        stdout: receipt.captures.stdout,
+        stderr: receipt.captures.stderr,
+        response: receipt.captures.response === undefined
+            ? undefined
+            : JSON.stringify(receipt.captures.response),
+    };
+    for (const [type, text] of Object.entries(captured)) {
+        if (text === undefined)
+            continue;
+        const { entry, file } = captureEvidence({
+            stepId: step.id,
+            attempt: dispatch.attempt,
+            sequence,
+            type: type,
+            text,
+            capturedAt,
+        });
+        evidence.push(entry);
+        if (file)
+            files.push(file);
+    }
+    const prefix = `${step.id}-${dispatch.attempt}`;
+    return {
+        evidence: [...evidence, ...normalizeEvidence(receipt.artifacts, prefix, capturedAt)],
+        files,
+    };
+}
+export function capturePreview(text, limit = CAPTURE_PREVIEW_LIMIT) {
+    const redacted = redactText(text);
+    if (redacted.length <= limit)
+        return redacted;
+    const head = Math.ceil(limit / 2);
+    const tail = Math.floor(limit / 2);
+    return `${redacted.slice(0, head)}... [${redacted.length - head - tail} chars omitted] ...${redacted.slice(-tail)}`;
+}
+/** Digest of what a caller submitted, over redacted content, used to recognise a retried request. */
+export function requestDigest(kind, content) {
+    return workflowDigest({ kind, content: redactValue(content) });
+}
+export function verifyReceiptAgainstDispatch(dispatch, receipt) {
+    if (receipt.step_id !== dispatch.step_id) {
+        throw new WorkflowRunV2Error('PROTOCOL_ERROR', `Receipt is for step ${receipt.step_id} but the run dispatched ${dispatch.step_id}`);
+    }
+    if (dispatch.kind === 'human') {
+        throw new WorkflowRunV2Error('PROTOCOL_ERROR', `Step ${dispatch.step_id} is a human step; record it with human_response, not receipt`);
+    }
+    const mutated = [];
+    if (receipt.dispatch_digest !== dispatch.dispatch_digest)
+        mutated.push('dispatch_digest');
+    if (receipt.host_tool_name !== dispatch.host_tool_name)
+        mutated.push('host_tool_name');
+    if (stableJson(receipt.arguments) !== stableJson(dispatch.arguments))
+        mutated.push('arguments');
+    if (dispatch.idempotency_key && receipt.idempotency_key !== dispatch.idempotency_key) {
+        mutated.push('idempotency_key');
+    }
+    if (mutated.length > 0) {
+        throw new WorkflowRunV2Error('PARAMETER_MUTATION', `Receipt for step ${dispatch.step_id} differs from the dispatch in ${mutated.join(', ')}; execute exactly the dispatched tool with the dispatched arguments and echo dispatch_digest`, { mismatched: mutated });
+    }
+}
+function parseJsonCapture(step, stdout) {
+    if (!step.script?.expect_json)
+        return {};
+    try {
+        return { json: JSON.parse(stdout ?? '') };
+    }
+    catch {
+        return { error_code: 'ARTIFACT_INVALID' };
+    }
+}
+/** How much of stdout the extracts read, and how long one value may be (BUG-216). */
+export const EXTRACT_INPUT_LIMIT = 262_144;
+export const EXTRACT_VALUE_LIMIT = 2_000;
+/**
+ * The script's declared extracts read from stdout (BUG-216): group 1 of each multiline pattern,
+ * else its whole match, trimmed and bounded; a pattern that matches nothing is named in
+ * `missing`. CRLF lines are read as LF, so `$` ends a Windows line too; only the first
+ * `EXTRACT_INPUT_LIMIT` characters are searched, which bounds an authored pattern's cost.
+ */
+export function extractValues(step, stdout) {
+    const declared = Object.entries(step.script?.extract ?? {});
+    const values = {};
+    const missing = [];
+    const text = stdout?.slice(0, EXTRACT_INPUT_LIMIT).replace(/\r\n/g, '\n');
+    for (const [name, pattern] of declared) {
+        const match = text === undefined ? null : new RegExp(pattern, 'm').exec(text);
+        if (match)
+            values[name] = (match[1] ?? match[0]).trim().slice(0, EXTRACT_VALUE_LIMIT);
+        else
+            missing.push(name);
+    }
+    return { declared: declared.length > 0, values, missing };
+}
+function outputOf(step, receipt, attempt) {
+    const parsed = parseJsonCapture(step, receipt.captures.stdout);
+    const extracted = extractValues(step, receipt.captures.stdout);
+    // Only a run that succeeded owes its values; a failed one already says why.
+    const missingText = extracted.missing.length > 0 && receipt.status === 'succeeded' && !receipt.error_code
+        ? `No match in stdout for extract ${extracted.missing.map((name) => `${name} (${step.script?.extract?.[name]})`).join(', ')}`
+        : undefined;
+    const errorCode = receipt.error_code ?? parsed.error_code;
+    const full = {
+        attempt,
+        status: receipt.status,
+        ...(receipt.exit_code !== undefined ? { exit_code: receipt.exit_code } : {}),
+        ...(errorCode ? { error_code: errorCode } : {}),
+        ...(receipt.captures.stdout !== undefined ? { stdout: receipt.captures.stdout } : {}),
+        ...(receipt.captures.stderr !== undefined ? { stderr: receipt.captures.stderr } : {}),
+        ...(receipt.captures.response !== undefined ? { response: receipt.captures.response } : {}),
+        ...('json' in parsed ? { json: parsed.json } : {}),
+        ...(extracted.declared ? { values: extracted.values } : {}),
+        ...(missingText ? { error_text: missingText } : {}),
+        ...(receipt.artifacts.length > 0 ? { artifacts: receipt.artifacts } : {}),
+    };
+    const stored = {
+        ...redactValue(full),
+        ...(full.stdout !== undefined ? { stdout: capturePreview(full.stdout) } : {}),
+        ...(full.stderr !== undefined ? { stderr: capturePreview(full.stderr) } : {}),
+    };
+    return { full, stored };
+}
+function slotOf(step, output, predicates, receipt) {
+    if (output.error_code || output.status === 'blocked' || output.status === 'inconclusive') {
+        return 'error';
+    }
+    if (output.status === 'failed')
+        return 'fail';
+    // BUG-216: a declared extract that found nothing fails the step; error_text names it.
+    const extracts = Object.keys(step.script?.extract ?? {});
+    if (extracts.some((name) => !Object.hasOwn(output.values ?? {}, name)))
+        return 'fail';
+    if (predicates.some((result) => result.verdict !== 'PASS'))
+        return 'fail';
+    if (step.expected_results.length === 0 && (output.exit_code ?? 0) !== 0)
+        return 'fail';
+    if (receipt.judgment)
+        return receipt.judgment.verdict === 'PASS' ? 'pass' : 'fail';
+    return 'pass';
+}
+export function evaluateStepPredicates(manifest, step, run, stepOutput, receipt, predicateIds = step.expected_results) {
+    const outputs = stepOutput ? { ...(run.outputs ?? {}), [step.id]: stepOutput } : run.outputs;
+    const context = { variables: run.variables ?? {}, outputs: outputs ?? {}, receipt };
+    return predicateIds.map((id) => {
+        const predicate = manifest.definition.predicates.find((candidate) => candidate.id === id);
+        if (!predicate) {
+            return { predicate_id: id, verdict: 'FAIL', detail: 'predicate is not declared' };
+        }
+        return evaluateWorkflowPredicateInContext(predicate, context, stepOutput?.status);
+    });
+}
+function outcomeOf(slot, status) {
+    if (slot === 'pass')
+        return 'recorded';
+    if (slot === 'fail')
+        return 'failed';
+    return status === 'inconclusive' ? 'inconclusive' : 'blocked';
+}
+function receiptPayload(step, dispatch, receipt, input, outcome) {
+    const { full, stored, predicates, route, nextRun } = outcome;
+    const slot = route.slot;
+    return {
+        protocol: 'workflow-v2',
+        step_id: step.id,
+        kind: step.kind,
+        attempt: dispatch.attempt,
+        host_tool_name: dispatch.host_tool_name,
+        arguments: dispatch.arguments,
+        side_effect: step.side_effect,
+        dispatch_digest: dispatch.dispatch_digest,
+        request_digest: input.requestDigest,
+        status: receipt.status,
+        outcome: outcomeOf(slot, receipt.status),
+        ...(full.exit_code !== undefined ? { exit_code: full.exit_code } : {}),
+        ...(full.error_code ? { error_code: full.error_code } : {}),
+        predicates,
+        route,
+        pending_verdict: nextRun.pending_verdict ?? null,
+        ...(stored.stdout !== undefined ? { stdout_preview: stored.stdout } : {}),
+        ...(stored.stderr !== undefined ? { stderr_preview: stored.stderr } : {}),
+        ...(stored.response !== undefined ? { response: stored.response } : {}),
+        artifacts: receipt.artifacts,
+        ...(dispatch.idempotency_key ? { step_idempotency_key: dispatch.idempotency_key } : {}),
+        ...(receipt.judgment ? { judgment: receipt.judgment } : {}),
+        ...(receipt.started_at ? { started_at: receipt.started_at } : {}),
+        ...(receipt.finished_at ? { finished_at: receipt.finished_at } : {}),
+    };
+}
+/** Apply a verified tool, script, artifact, or cleanup receipt to the run. */
+export function applyStepReceipt(manifest, run, dispatch, step, receipt, input) {
+    verifyReceiptAgainstDispatch(dispatch, receipt);
+    const { full, stored } = outputOf(step, receipt, dispatch.attempt);
+    if (receipt.judgment && step.semantic_judgment) {
+        const judged = evaluateSemanticJudgment(step.semantic_judgment, receipt.judgment);
+        if (judged.verdict === 'INCONCLUSIVE')
+            full.error_code = 'SEMANTIC_INCONCLUSIVE';
+        stored.error_code = full.error_code;
+    }
+    const predicates = evaluateStepPredicates(manifest, step, run, full, receipt);
+    const slot = slotOf(step, full, predicates, receipt);
+    const route = resolveWorkflowRoute(manifest.definition, step, slot, dispatch.attempt, full.error_code, run.step_attempts ?? {});
+    const advanced = advanceWorkflowCursor(manifest.definition, run, step, { ...stored, slot }, route);
+    const nextRun = {
+        ...advanced,
+        version: run.version + 1,
+        updated_at: input.occurredAt,
+    };
+    const payload = receiptPayload(step, dispatch, receipt, input, {
+        full,
+        stored,
+        predicates,
+        route,
+        nextRun,
+    });
+    const { evidence, files } = receiptEvidence(step, dispatch, receipt, run.version, input.occurredAt);
+    payload.evidence = evidence;
+    return {
+        run: nextRun,
+        event: workflowV2Event(run, {
+            type: step.id,
+            actor: input.actor,
+            actorName: input.actorName,
+            toState: nextRun.state,
+            payload: redactValue(payload),
+            idempotencyKey: input.idempotencyKey,
+            occurredAt: input.occurredAt,
+        }),
+        route,
+        evidenceFiles: files,
+    };
+}
+//# sourceMappingURL=workflow-v2-receipt.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * What a v2 step expects back (TASK-968, SPIKE-074). Several rules govern meaning, not shape:
+ * a wrong but valid receipt status is accepted and judged wrongly. So the rules for the
+ * dispatched step travel with the dispatch as `reply`, before the step is reported, and the same
+ * text returns as `hint` when a report is refused for the wrong step or a changed dispatch.
+ * One constant per channel; no example values a model could copy.
+ */
+export type WorkflowReplyChannel = 'receipt' | 'human_response' | 'observation';
+export declare const WORKFLOW_REPLY_RULES: Readonly<Record<WorkflowReplyChannel, string>>;
+/** The channel a dispatched step is reported through. */
+export declare function replyChannel(dispatch: Readonly<{
+    kind: string;
+    host_tool_name: string | null;
+}>): WorkflowReplyChannel;
+export declare function replyRules(dispatch: Readonly<{
+    kind: string;
+    host_tool_name: string | null;
+}>): string;
+/**
+ * Attach the reply rules of the current dispatch to a refusal for the wrong step or a changed
+ * dispatch; any other error passes unchanged.
+ */
+export declare function withReplyHint(error: unknown, dispatch: Readonly<{
+    kind: string;
+    host_tool_name: string | null;
+}> | undefined): unknown;
+//# sourceMappingURL=workflow-v2-reply.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-reply.d.ts","sourceRoot":"","sources":["../../src/runtime/workflow-v2-reply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAEhF,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAqB/E,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAClE,oBAAoB,CAGtB;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAClE,MAAM,CAER;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GAAG,SAAS,GAC9E,OAAO,CAKT"}

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

@@ -0,0 +1,52 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * What a v2 step expects back (TASK-968, SPIKE-074). Several rules govern meaning, not shape:
+ * a wrong but valid receipt status is accepted and judged wrongly. So the rules for the
+ * dispatched step travel with the dispatch as `reply`, before the step is reported, and the same
+ * text returns as `hint` when a report is refused for the wrong step or a changed dispatch.
+ * One constant per channel; no example values a model could copy.
+ */
+import { OPERATOR_HOST_TOOL } from '../core/workflow-host-profiles.js';
+import { WorkflowRunV2Error } from './workflow-v2-types.js';
+export const WORKFLOW_REPLY_RULES = {
+    receipt: 'Reply with receipt: echo step_id, dispatch_digest, host_tool_name, arguments (unchanged; ' +
+        'secret references stay references) and idempotency_key from this dispatch, and set status: ' +
+        'succeeded = the tool ran, whatever its exit code (the expected_results judge it); failed = ' +
+        'the tool reported a failure; blocked = it could not run; inconclusive. exit_code and ' +
+        'captures (stdout, stderr, response) feed outputs.<step> and the predicates; with ' +
+        'script.expect_json, stdout must be JSON (else ARTIFACT_INVALID). error_code selects ' +
+        'error_routes and retries. Secret-shaped text is redacted; captures above 2000 characters ' +
+        'are stored as evidence files.',
+    human_response: 'Reply with human_response: echo step_id and dispatch_digest; option is one of human.options ' +
+        '(matched case- and whitespace-insensitively); freeform only when human.allow_freeform, ' +
+        'mapped through response_mapping.freeform; observation and evidence (notes or artifact ' +
+        'references) as given. A FAIL answer to a non-approval step needs evidence; a declined ' +
+        'required step is HUMAN_DECLINED.',
+    observation: 'Reply with observation: echo step_id and dispatch_digest; observation is the report of what ' +
+        'was done by hand, status succeeded, failed, blocked or inconclusive, error_text any ' +
+        'verbatim error, plus error_code and artifacts when there are any. The report reaches ' +
+        'outputs.<step>.observation for later predicates.',
+};
+/** The channel a dispatched step is reported through. */
+export function replyChannel(dispatch) {
+    if (dispatch.kind === 'human')
+        return 'human_response';
+    return dispatch.host_tool_name === OPERATOR_HOST_TOOL ? 'observation' : 'receipt';
+}
+export function replyRules(dispatch) {
+    return WORKFLOW_REPLY_RULES[replyChannel(dispatch)];
+}
+const HINTED_CODES = new Set(['PROTOCOL_ERROR', 'PARAMETER_MUTATION']);
+/**
+ * Attach the reply rules of the current dispatch to a refusal for the wrong step or a changed
+ * dispatch; any other error passes unchanged.
+ */
+export function withReplyHint(error, dispatch) {
+    if (error instanceof WorkflowRunV2Error && dispatch && HINTED_CODES.has(error.code)) {
+        error.hint = replyRules(dispatch);
+    }
+    return error;
+}
+//# sourceMappingURL=workflow-v2-reply.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-v2-reply.js","sourceRoot":"","sources":["../../src/runtime/workflow-v2-reply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAI5D,MAAM,CAAC,MAAM,oBAAoB,GAAmD;IAClF,OAAO,EACL,2FAA2F;QAC3F,6FAA6F;QAC7F,6FAA6F;QAC7F,uFAAuF;QACvF,mFAAmF;QACnF,sFAAsF;QACtF,2FAA2F;QAC3F,+BAA+B;IACjC,cAAc,EACZ,8FAA8F;QAC9F,yFAAyF;QACzF,wFAAwF;QACxF,wFAAwF;QACxF,kCAAkC;IACpC,WAAW,EACT,8FAA8F;QAC9F,sFAAsF;QACtF,uFAAuF;QACvF,kDAAkD;CACrD,CAAC;AAEF,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAC1B,QAAmE;IAEnE,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,gBAAgB,CAAC;IACvD,OAAO,QAAQ,CAAC,cAAc,KAAK,kBAAkB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,QAAmE;IAEnE,OAAO,oBAAoB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAEvE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAc,EACd,QAA+E;IAE/E,IAAI,KAAK,YAAY,kBAAkB,IAAI,QAAQ,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpF,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}