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

package/dist/runtime/dispatcher.js

@@ -0,0 +1,178 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Deterministic workflow dispatcher.
+ * Selects only authored steps and never discovers or substitutes tools at runtime.
+ */
+import { HUMAN_TRANSPORT_TOOL } from '../core/workflow-host-profiles.js';
+import { evaluateWorkflowPredicate } from './predicates.js';
+import { renderWorkflowTemplate, WorkflowDispatchError } from './workflow-template.js';
+import { humanDispatchContract, humanTransportArguments } from './workflow-v2-human.js';
+import { pendingCleanupSteps, resolveWorkflowRoute } from './workflow-v2-routing.js';
+import { stepDisplayText } from './workflow-v2-step-text.js';
+export { renderWorkflowTemplate, WorkflowDispatchError } from './workflow-template.js';
+const renderValue = renderWorkflowTemplate;
+function isReady(step, completedStepIds) {
+    return step.depends_on.every((dependency) => completedStepIds.has(dependency));
+}
+/** Follow the routes from the first step; undefined when an outcome on the way is unknown. */
+function routedStep(manifest, input) {
+    const { definition } = manifest;
+    const byId = new Map(definition.steps.map((step) => [step.id, step]));
+    const outputs = (input.outputs ?? {});
+    let current = definition.steps[0];
+    // A loop through completed steps would never end: the hop limit turns it into "not routed".
+    for (let hops = 0; current && hops <= definition.steps.length * 4; hops += 1) {
+        if (!input.completed_step_ids.has(current.id)) {
+            // A step the run could not dispatch yet means the outcomes passed are incomplete.
+            return isReady(current, input.completed_step_ids) ? { step: current } : undefined;
+        }
+        const output = outputs[current.id];
+        if (!output?.slot)
+            return undefined;
+        // The step's attempts are spent in a preview: a retry route never applies. An answer mapped to
+        // CANCELLED stops the run whatever `on.fail` names, as the runtime's answerRoute does.
+        const route = output.verdict === 'CANCELLED'
+            ? undefined
+            : resolveWorkflowRoute(definition, current, output.slot, current.retry.max_attempts, output.error_code);
+        if (route?.kind === 'step') {
+            current = byId.get(route.target);
+            continue;
+        }
+        // A verdict ends the routes; cleanup the run owes comes before finalize.
+        const cleanup = pendingCleanupSteps(definition, {
+            outputs: outputs,
+            completed_step_ids: Array.from(input.completed_step_ids),
+        });
+        return { step: cleanup[0] };
+    }
+    return undefined;
+}
+/** Template text filled where the caller's values allow it; the authored text otherwise. */
+function previewText(text, input) {
+    try {
+        const rendered = renderValue(text, input.variables ?? {}, input.outputs ?? {});
+        return typeof rendered === 'string' ? rendered : text;
+    }
+    catch {
+        return text;
+    }
+}
+function stepDispatch(manifest, step, input) {
+    const variables = input.variables ?? {};
+    const outputs = input.outputs ?? {};
+    const human = humanDispatchContract(manifest, step, (text) => previewText(text, input));
+    const display = stepDisplayText(step, (text) => previewText(text, input));
+    if (human) {
+        // The transport the compiler resolved for the host profile, as a run would dispatch it.
+        return {
+            step_id: step.id,
+            kind: step.kind,
+            host_tool_name: HUMAN_TRANSPORT_TOOL[human.transport],
+            arguments: humanTransportArguments(step.id, human),
+            timeout_seconds: step.timeout_seconds,
+            expected_results: step.expected_results,
+            ...(display ? { display } : {}),
+        };
+    }
+    if (!step.binding) {
+        throw new WorkflowDispatchError('MISSING_BINDING', `Step has no compiled binding: ${step.id}`);
+    }
+    const browserProcedure = step.browser
+        ? {
+            ...step.browser,
+            actions: step.browser.actions.map((action) => ({
+                ...action,
+                parameters: renderValue(action.parameters, variables, outputs),
+            })),
+        }
+        : undefined;
+    return {
+        step_id: step.id,
+        kind: step.kind,
+        host_tool_name: step.binding.host_tool_name,
+        arguments: renderValue(step.arguments_template, variables, outputs),
+        timeout_seconds: step.timeout_seconds,
+        expected_results: step.expected_results,
+        browser_procedure: browserProcedure,
+        ...(display ? { display } : {}),
+    };
+}
+/** The step a dry run offers, and whether the routes or definition order chose it. */
+export function previewWorkflowDispatch(manifest, input) {
+    const routed = routedStep(manifest, input);
+    const step = routed
+        ? routed.step
+        : manifest.definition.steps.find((candidate) => !input.completed_step_ids.has(candidate.id) &&
+            isReady(candidate, input.completed_step_ids));
+    return {
+        ...(step ? { dispatch: stepDispatch(manifest, step, input) } : {}),
+        preview: routed ? 'routed' : 'not-routed',
+    };
+}
+export function nextWorkflowDispatch(manifest, input) {
+    return previewWorkflowDispatch(manifest, input).dispatch;
+}
+export function stableJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(',')}]`;
+    if (value && typeof value === 'object') {
+        return `{${Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, nested]) => `${JSON.stringify(key)}:${stableJson(nested)}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+export function verifyWorkflowReceipt(dispatch, receipt) {
+    if (!receipt) {
+        return { valid: false, provenance: 'reduced' };
+    }
+    if (receipt.step_id !== dispatch.step_id ||
+        receipt.host_tool_name !== dispatch.host_tool_name ||
+        stableJson(receipt.arguments) !== stableJson(dispatch.arguments)) {
+        throw new WorkflowDispatchError('PARAMETER_MUTATION', `Receipt does not match dispatch for step: ${dispatch.step_id}`);
+    }
+    const expectedArtifacts = dispatch.browser_procedure?.artifacts ?? [];
+    const receivedArtifacts = receipt.artifacts ?? [];
+    if (expectedArtifacts.some((artifact) => !receivedArtifacts.some((evidence) => evidence.type === artifact &&
+        evidence.path.length > 0 &&
+        !evidence.path.startsWith('/') &&
+        !evidence.path.split('/').includes('..') &&
+        /^sha256:[a-f0-9]{64}$/i.test(evidence.digest)))) {
+        return { valid: false, provenance: 'reduced', status: receipt.status };
+    }
+    if (dispatch.browser_procedure &&
+        (!receipt.browser_steps ||
+            receipt.browser_steps.length === 0 ||
+            receipt.browser_steps.some((step) => step.status === 'failed'))) {
+        return { valid: false, provenance: 'reduced', status: receipt.status };
+    }
+    return { valid: true, provenance: 'complete', status: receipt.status };
+}
+export function evaluateWorkflowDispatchReceipt(manifest, dispatch, receipt, subjects = {}) {
+    const verification = verifyWorkflowReceipt(dispatch, receipt);
+    const step = manifest.definition.steps.find((candidate) => candidate.id === dispatch.step_id);
+    if (!step)
+        throw new WorkflowDispatchError('MISSING_BINDING', `Unknown dispatched step: ${dispatch.step_id}`);
+    const predicates = step.expected_results.map((id) => {
+        const predicate = manifest.definition.predicates.find((candidate) => candidate.id === id);
+        if (!predicate)
+            throw new WorkflowDispatchError('MISSING_BINDING', `Missing compiled predicate: ${id}`);
+        return evaluateWorkflowPredicate(predicate, subjects[id] ?? receipt?.status);
+    });
+    const failed = predicates.some((result) => result.verdict !== 'PASS');
+    const route = !receipt || receipt.status === 'blocked' || receipt.status === 'inconclusive'
+        ? step.on.error
+        : receipt.status === 'failed' || failed
+            ? step.on.fail
+            : step.on.pass;
+    const browserDisposition = receipt?.browser_issue
+        ? receipt.browser_issue === 'unexpected-dialog'
+            ? dispatch.browser_procedure?.dialog_route
+            : dispatch.browser_procedure?.selector_drift_route
+        : undefined;
+    return { verification, predicates, route, browser_disposition: browserDisposition };
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/runtime/dispatcher.js.map

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

package/dist/runtime/event-log.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Runtime event log
+ * Appends sanitized process events and checks persisted events against the run snapshot.
+ * The log is append-only evidence; the run snapshot remains the current state.
+ */
+import { ProcessEvent, type ProcessRun, type RuntimeActor } from './index.js';
+export { type CanonicalRunReport, type ProcessReport, ProcessReportCapabilityError, type ProcessReportEntry, type ProcessReportFormat, type ProcessReportOptions, projectCanonicalRunReport, projectStructuredProcessReport, type RunVerdict, type TerminalOutcomeDeclaration, terminalOutcomesOf, } from './process-report.js';
+export { renderCanonicalRunReport, renderProcessReport, } from './process-report-render.js';
+export type ProcessRecoveryCheck = Readonly<{
+    consistent: boolean;
+    event_count: number;
+    last_state: string;
+    snapshot_version: number;
+}>;
+export type ProcessReplayResult = Readonly<{
+    consistent: boolean;
+    state: string;
+    version: number;
+    event_ids: readonly string[];
+}>;
+export declare function sanitizeProcessEvent(event: ProcessEvent): ProcessEvent;
+/** BUG-132: a line the schema rejects makes the whole run unreadable, so nothing invalid is written. */
+export declare class ProcessEventLogError extends Error {
+    readonly code: 'RUN_EVENT_REJECTED' | 'RUN_EVENT_INVALID';
+    readonly path: string;
+    readonly line?: number | undefined;
+    constructor(code: 'RUN_EVENT_REJECTED' | 'RUN_EVENT_INVALID', message: string, path: string, line?: number | undefined);
+}
+export type ProcessEventRepair = Readonly<{
+    line: number;
+    run_id: string;
+    sequence?: number;
+    step_id?: string;
+    field: 'actor';
+    read_as: RuntimeActor;
+    message: string;
+}>;
+export type ProcessEventLog = Readonly<{
+    events: ProcessEvent[];
+    repairs: readonly ProcessEventRepair[];
+}>;
+/**
+ * Check an event before anything is written: the caller's types do not survive an MCP boundary,
+ * and a persisted event that the schema rejects makes the whole run unreadable (BUG-132).
+ */
+export declare function validateProcessEvent(event: ProcessEvent, path: string): ProcessEvent;
+export declare function appendProcessEvent(path: string, event: ProcessEvent): Promise<void>;
+/**
+ * Read the persisted events and report what had to be recovered.
+ * A missing actor is read as "system" instead of making the whole run unreadable; any other
+ * invalid field raises an error that names the run, the line, and the step.
+ */
+export declare function readProcessEventLog(path: string): Promise<ProcessEventLog>;
+export declare function readProcessEvents(path: string): Promise<ProcessEvent[]>;
+export declare function checkProcessRunRecovery(run: ProcessRun, events: readonly ProcessEvent[]): ProcessRecoveryCheck;
+/**
+ * Reconstructs the observable state from journal events without persistence or execution.
+ * Replay is deliberately a pure projection: side effects remain owned by dispatch adapters.
+ */
+export declare function replayProcessRun(run: ProcessRun, events: readonly ProcessEvent[]): ProcessReplayResult;
+export declare function projectProcessReport(events: readonly ProcessEvent[]): string;
+//# sourceMappingURL=event-log.d.ts.map

package/dist/runtime/event-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.d.ts","sourceRoot":"","sources":["../../src/runtime/event-log.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9E,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,4BAA4B,EAC5B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,8BAA8B,EAC9B,KAAK,UAAU,EACf,KAAK,0BAA0B,EAC/B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B,CAAC,CAAC;AAKH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAKtE;AAED,wGAAwG;AACxG,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,IAAI,EAAE,oBAAoB,GAAG,mBAAmB;aAEhD,IAAI,EAAE,MAAM;aACZ,IAAI,CAAC,EAAE,MAAM;IAJ/B,YACkB,IAAI,EAAE,oBAAoB,GAAG,mBAAmB,EAChE,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,YAAA,EAI9B;CACF;AAYD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACxC,CAAC,CAAC;AAsBH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAUpF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzF;AA6CD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAoBhF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAE7E;AAED,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,oBAAoB,CA0BtB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,UAAU,EACf,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,mBAAmB,CAuBrB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAO5E"}

package/dist/runtime/event-log.js

@@ -0,0 +1,189 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Runtime event log
+ * Appends sanitized process events and checks persisted events against the run snapshot.
+ * The log is append-only evidence; the run snapshot remains the current state.
+ */
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { basename, dirname } from 'node:path';
+import { ProcessEvent } from './index.js';
+import { redactValue } from './redaction.js';
+export { ProcessReportCapabilityError, projectCanonicalRunReport, projectStructuredProcessReport, terminalOutcomesOf, } from './process-report.js';
+// The report projection moved to process-report.ts; these names stay importable from here.
+export { renderCanonicalRunReport, renderProcessReport, } from './process-report-render.js';
+/** TASK-816: events, reports, and v2 runs share one redaction rule set. */
+const sanitizeValue = redactValue;
+export function sanitizeProcessEvent(event) {
+    return {
+        ...event,
+        payload: sanitizeValue(event.payload),
+    };
+}
+/** BUG-132: a line the schema rejects makes the whole run unreadable, so nothing invalid is written. */
+export class ProcessEventLogError extends Error {
+    code;
+    path;
+    line;
+    constructor(code, message, path, line) {
+        super(`${code}: ${message}`);
+        this.code = code;
+        this.path = path;
+        this.line = line;
+        this.name = 'ProcessEventLogError';
+    }
+}
+/** The one field a read recovers; every other invalid field keeps the line unreadable. */
+const REPAIRED_ACTOR = 'system';
+/** Name an event by what it still carries, so a diagnostic points at exactly one event. */
+function locateEvent(raw, path, line) {
+    const record = (typeof raw === 'object' && raw !== null ? raw : {});
+    return {
+        ...(line === undefined ? {} : { line }),
+        run_id: typeof record.run_id === 'string' ? record.run_id : basename(dirname(path)),
+        ...(typeof record.sequence === 'number' ? { sequence: record.sequence } : {}),
+        ...(typeof record.type === 'string' ? { step_id: record.type } : {}),
+    };
+}
+function describeEvent(location) {
+    return [
+        ...(location.line === undefined ? [] : [`line ${location.line}`]),
+        `run ${location.run_id}`,
+        ...(location.sequence === undefined ? [] : [`sequence ${location.sequence}`]),
+        ...(location.step_id === undefined ? [] : [`step "${location.step_id}"`]),
+    ].join(', ');
+}
+/**
+ * Check an event before anything is written: the caller's types do not survive an MCP boundary,
+ * and a persisted event that the schema rejects makes the whole run unreadable (BUG-132).
+ */
+export function validateProcessEvent(event, path) {
+    const validated = ProcessEvent.safeParse(sanitizeProcessEvent(event));
+    if (!validated.success) {
+        throw new ProcessEventLogError('RUN_EVENT_REJECTED', `an event of ${describeEvent(locateEvent(event, path))} does not satisfy the event schema and was not written: ${validated.error.message}`, path);
+    }
+    return validated.data;
+}
+export async function appendProcessEvent(path, event) {
+    const validated = validateProcessEvent(event, path);
+    await mkdir(dirname(path), { recursive: true });
+    await appendFile(path, `${JSON.stringify(validated)}\n`, 'utf8');
+}
+function invalidLine(path, location, cause) {
+    return new ProcessEventLogError('RUN_EVENT_INVALID', `${path} (${describeEvent(location)}) does not satisfy the event schema: ${cause}. List what a repair can recover with: devsteps workflow repair <definition-item-id> ${location.run_id}`, path, location.line);
+}
+function readEventLine(path, line, text) {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (error) {
+        const cause = error instanceof Error ? error.message : String(error);
+        throw invalidLine(path, locateEvent(undefined, path, line), `it is not valid JSON (${cause})`);
+    }
+    const parsed = ProcessEvent.safeParse(raw);
+    if (parsed.success)
+        return { event: parsed.data };
+    const location = locateEvent(raw, path, line);
+    const onlyActor = parsed.error.issues.every((issue) => issue.path[0] === 'actor');
+    const repaired = onlyActor
+        ? ProcessEvent.safeParse({ ...raw, actor: REPAIRED_ACTOR })
+        : undefined;
+    if (!repaired?.success)
+        throw invalidLine(path, location, parsed.error.message);
+    return {
+        event: repaired.data,
+        repair: {
+            ...location,
+            line,
+            field: 'actor',
+            read_as: REPAIRED_ACTOR,
+            message: `${describeEvent(location)} carries no valid actor and was read as "${REPAIRED_ACTOR}"`,
+        },
+    };
+}
+/**
+ * Read the persisted events and report what had to be recovered.
+ * A missing actor is read as "system" instead of making the whole run unreadable; any other
+ * invalid field raises an error that names the run, the line, and the step.
+ */
+export async function readProcessEventLog(path) {
+    let content;
+    try {
+        content = await readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return { events: [], repairs: [] };
+        }
+        throw error;
+    }
+    const events = [];
+    const repairs = [];
+    for (const [index, text] of content.split('\n').entries()) {
+        if (text.length === 0)
+            continue;
+        const { event, repair } = readEventLine(path, index + 1, text);
+        events.push(event);
+        if (repair)
+            repairs.push(repair);
+    }
+    return { events, repairs };
+}
+export async function readProcessEvents(path) {
+    return (await readProcessEventLog(path)).events;
+}
+export function checkProcessRunRecovery(run, events) {
+    let state = events.length > 0 ? events[0].from_state : run.state;
+    let consistent = true;
+    for (const [index, event] of events.entries()) {
+        const expectedSequence = index + 1;
+        if (event.run_id !== run.run_id ||
+            event.sequence !== expectedSequence ||
+            event.from_state !== state) {
+            consistent = false;
+        }
+        state = event.to_state;
+    }
+    if (events.length > 0 && (state !== run.state || run.version !== events.length + 1)) {
+        consistent = false;
+    }
+    return {
+        consistent,
+        event_count: events.length,
+        last_state: state,
+        snapshot_version: run.version,
+    };
+}
+/**
+ * Reconstructs the observable state from journal events without persistence or execution.
+ * Replay is deliberately a pure projection: side effects remain owned by dispatch adapters.
+ */
+export function replayProcessRun(run, events) {
+    const first = events[0];
+    let state = first?.from_state ?? run.state;
+    let consistent = true;
+    for (const [index, event] of events.entries()) {
+        if (event.run_id !== run.run_id || event.sequence !== index + 1 || event.from_state !== state) {
+            consistent = false;
+        }
+        state = event.to_state;
+    }
+    const version = events.length + 1;
+    if (run.version !== version || (events.length > 0 && run.state !== state)) {
+        consistent = false;
+    }
+    return {
+        consistent,
+        state,
+        version,
+        event_ids: events.map((event) => event.event_id),
+    };
+}
+export function projectProcessReport(events) {
+    return events
+        .map((event) => `${event.sequence}. ${event.from_state} -> ${event.to_state} (${event.type}, ${event.actor})`)
+        .join('\n');
+}
+//# sourceMappingURL=event-log.js.map

package/dist/runtime/event-log.js.map

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

package/dist/runtime/evidence.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Structured run evidence.
+ * Every capture, artifact, and note becomes an entry with a digest; captures above the preview
+ * limit are stored as redacted files under the run's `evidence/` directory and referenced by path.
+ */
+import { z } from 'zod';
+export declare const RunEvidenceType: z.ZodEnum<{
+    field: "field";
+    file: "file";
+    note: "note";
+    observation: "observation";
+    response: "response";
+    screenshot: "screenshot";
+    stderr: "stderr";
+    stdout: "stdout";
+    trace: "trace";
+}>;
+export type RunEvidenceType = z.infer<typeof RunEvidenceType>;
+export declare const RunEvidence: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        field: "field";
+        file: "file";
+        note: "note";
+        observation: "observation";
+        response: "response";
+        screenshot: "screenshot";
+        stderr: "stderr";
+        stdout: "stdout";
+        trace: "trace";
+    }>;
+    path: z.ZodOptional<z.ZodString>;
+    digest: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    summary: z.ZodOptional<z.ZodString>;
+    captured_at: z.ZodString;
+    redacted: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export type RunEvidence = z.infer<typeof RunEvidence>;
+export declare const EVIDENCE_PREVIEW_LIMIT = 2000;
+export type EvidenceFile = Readonly<{
+    path: string;
+    content: string;
+}>;
+export declare function evidenceDigest(content: string): string;
+/**
+ * Turn one capture into an evidence entry. Text above the preview limit is written to
+ * `evidence/<sequence>-<step>-<type>.txt`; the digest always covers the redacted full text.
+ */
+export declare function captureEvidence(input: Readonly<{
+    stepId: string;
+    attempt: number;
+    sequence: number;
+    type: 'stdout' | 'stderr' | 'response' | 'observation' | 'note' | 'field';
+    /** Distinguishes several captures of one type on one step, such as two declared fields. */
+    suffix?: string;
+    text: string;
+    capturedAt: string;
+}>): {
+    entry: RunEvidence;
+    file?: EvidenceFile;
+};
+/** Normalize free-text notes and artifact references into evidence entries. */
+export declare function normalizeEvidence(entries: ReadonlyArray<string | Readonly<{
+    type: string;
+    path: string;
+    digest?: string;
+}>>, idPrefix: string, capturedAt: string): RunEvidence[];
+//# sourceMappingURL=evidence.d.ts.map

package/dist/runtime/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/runtime/evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe;;;;;;;;;;EAU1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;iBAStB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEvE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAOD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1E,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,GACD;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,YAAY,CAAA;CAAE,CAe7C;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,CAAC,MAAM,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EAC1F,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,WAAW,EAAE,CAmBf"}

package/dist/runtime/evidence.js

@@ -0,0 +1,80 @@
+/**
+ * Copyright © 2026 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Structured run evidence.
+ * Every capture, artifact, and note becomes an entry with a digest; captures above the preview
+ * limit are stored as redacted files under the run's `evidence/` directory and referenced by path.
+ */
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { redactText } from './redaction.js';
+export const RunEvidenceType = z.enum([
+    'stdout',
+    'stderr',
+    'response',
+    'observation',
+    'file',
+    'screenshot',
+    'trace',
+    'note',
+    'field',
+]);
+export const RunEvidence = z.object({
+    id: z.string().min(1).max(200),
+    type: RunEvidenceType,
+    path: z.string().min(1).max(500).optional(),
+    digest: z.string().min(1).max(200).optional(),
+    size: z.number().int().min(0).optional(),
+    summary: z.string().max(2000).optional(),
+    captured_at: z.string().datetime(),
+    redacted: z.literal(true),
+});
+export const EVIDENCE_PREVIEW_LIMIT = 2000;
+export function evidenceDigest(content) {
+    return `sha256:${createHash('sha256').update(content, 'utf8').digest('hex')}`;
+}
+function evidenceType(type) {
+    const parsed = RunEvidenceType.safeParse(type);
+    return parsed.success ? parsed.data : 'file';
+}
+/**
+ * Turn one capture into an evidence entry. Text above the preview limit is written to
+ * `evidence/<sequence>-<step>-<type>.txt`; the digest always covers the redacted full text.
+ */
+export function captureEvidence(input) {
+    const redacted = redactText(input.text);
+    const large = redacted.length > EVIDENCE_PREVIEW_LIMIT;
+    const name = input.suffix ? `${input.type}-${input.suffix}` : input.type;
+    const path = large ? `evidence/${input.sequence}-${input.stepId}-${name}.txt` : undefined;
+    const entry = {
+        id: `${input.stepId}-${input.attempt}-${name}`,
+        type: input.type,
+        ...(path ? { path } : {}),
+        digest: evidenceDigest(redacted),
+        size: Buffer.byteLength(redacted, 'utf8'),
+        captured_at: input.capturedAt,
+        redacted: true,
+    };
+    return path ? { entry, file: { path, content: redacted } } : { entry };
+}
+/** Normalize free-text notes and artifact references into evidence entries. */
+export function normalizeEvidence(entries, idPrefix, capturedAt) {
+    return entries.map((entry, index) => typeof entry === 'string'
+        ? {
+            id: `${idPrefix}-note-${index + 1}`,
+            type: 'note',
+            summary: redactText(entry),
+            captured_at: capturedAt,
+            redacted: true,
+        }
+        : {
+            id: `${idPrefix}-${evidenceType(entry.type)}-${index + 1}`,
+            type: evidenceType(entry.type),
+            path: redactText(entry.path),
+            ...(entry.digest ? { digest: entry.digest } : {}),
+            captured_at: capturedAt,
+            redacted: true,
+        });
+}
+//# sourceMappingURL=evidence.js.map

package/dist/runtime/evidence.js.map

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