@petepetrash/circuit 0.1.0

package/dist/runtime/executors/fanout.d.ts

@@ -0,0 +1,8 @@
+import type { StepOutcome } from '../domain/step.js';
+import type { FanoutStep } from '../manifest/executable-flow.js';
+import type { RunContext } from '../run/run-context.js';
+import type { RelayConnector } from './relay.js';
+import { type StepExecutionResult } from './result.js';
+export declare function executeFanoutResult(step: FanoutStep, context: RunContext, relayConnector?: RelayConnector): Promise<StepExecutionResult>;
+export declare function executeFanout(step: FanoutStep, context: RunContext, relayConnector?: RelayConnector): Promise<StepOutcome>;
+//# sourceMappingURL=fanout.d.ts.map

package/dist/runtime/executors/fanout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout.d.ts","sourceRoot":"","sources":["../../../src/runtime/executors/fanout.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAWrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EACL,KAAK,mBAAmB,EAIzB,MAAM,aAAa,CAAC;AA2XrB,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,UAAU,EACnB,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAM9B;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,UAAU,EACnB,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,WAAW,CAAC,CAEtB"}

package/dist/runtime/executors/fanout.js

@@ -0,0 +1,312 @@
+import { rm } from 'node:fs/promises';
+import { join as joinPath } from 'node:path';
+import { connectorCapabilities } from '../../connectors/resolver.js';
+import { evaluateFanoutJoinPolicy } from '../../policy/fanout-join-policy.js';
+import { FanoutFailurePolicy } from '../../schemas/step.js';
+import { controlPlaneRoot } from '../../shared/control-plane-paths.js';
+import { buildFanoutAggregate } from '../../shared/fanout-aggregate-report.js';
+import { branchNeedsWorktree, executeRelayFanoutBranch, executeSubRunFanoutBranch, planRelayFanoutBranchGuidanceDecision, } from '../fanout/branch-execution.js';
+import { expandFanoutBranches } from '../fanout/branch-expansion.js';
+import { removeOwnerLock, writeOwnerLock } from '../fanout/run-owner-lock.js';
+import { gitWorktreeRunner } from '../fanout/worktree.js';
+import { stepExecutionFailedFrom, stepExecutionOutcome, unwrapStepExecutionResult, } from './result.js';
+function aggregateRef(step) {
+    const aggregate = step.writes?.aggregate;
+    if (aggregate !== undefined)
+        return aggregate;
+    throw new Error(`fanout step '${step.id}' is missing writes.aggregate`);
+}
+function branchesDir(step) {
+    const branchesDirRef = step.writes?.branches_dir;
+    if (branchesDirRef !== undefined)
+        return branchesDirRef.path;
+    throw new Error(`fanout step '${step.id}' is missing writes.branches_dir`);
+}
+function joinPolicy(step) {
+    const policy = step.check.join?.policy;
+    if (policy === 'pick-winner' ||
+        policy === 'disjoint-merge' ||
+        policy === 'aggregate-only' ||
+        policy === 'aggregate-survivors') {
+        return policy;
+    }
+    throw new Error(`fanout step '${step.id}' has unsupported join policy`);
+}
+function admitOrder(step) {
+    const admit = step.check.verdicts?.admit;
+    return Array.isArray(admit)
+        ? admit.filter((entry) => typeof entry === 'string')
+        : [];
+}
+const WRITABLE_RELAY_SERIALIZATION_REASON = 'Writable relay fanout branches are serialized because relay branches share the parent checkout and no branch-local relay write root is provisioned.';
+function concurrencyLimit(step) {
+    const concurrency = step.concurrency;
+    if (concurrency?.kind === 'unbounded')
+        return 'unbounded';
+    if (concurrency?.kind === 'bounded' && typeof concurrency.max === 'number') {
+        return concurrency.max;
+    }
+    return 4;
+}
+function branchUsesWritableConnector(step, branch, context, relayConnector, branchDirRoot) {
+    if (branch.kind !== 'relay')
+        return false;
+    try {
+        const decision = planRelayFanoutBranchGuidanceDecision({
+            step,
+            context,
+            branch,
+            ...(relayConnector === undefined ? {} : { relayConnector }),
+            branchDirRel: `${branchDirRoot}/${branch.branch_id}`,
+        });
+        return connectorCapabilities(decision.relayExecution.connector).filesystem !== 'read-only';
+    }
+    catch {
+        return false;
+    }
+}
+function fanoutExecutionPolicy(step, branches, context, relayConnector, branchDirRoot) {
+    const configuredConcurrency = concurrencyLimit(step);
+    const writableRelayBranchesSerialized = branches.some((branch) => branchUsesWritableConnector(step, branch, context, relayConnector, branchDirRoot));
+    if (writableRelayBranchesSerialized) {
+        return {
+            configuredConcurrency,
+            effectiveConcurrency: 1,
+            writableRelayBranchesSerialized,
+            serializationReason: WRITABLE_RELAY_SERIALIZATION_REASON,
+        };
+    }
+    return {
+        configuredConcurrency,
+        effectiveConcurrency: configuredConcurrency,
+        writableRelayBranchesSerialized,
+    };
+}
+function outcomesInBranchOrder(outcomes, branchIds) {
+    const byId = new Map(outcomes.map((outcome) => [outcome.branch_id, outcome]));
+    return branchIds.flatMap((branchId) => {
+        const outcome = byId.get(branchId);
+        return outcome === undefined ? [] : [outcome];
+    });
+}
+async function runWithConcurrency(items, limit, worker) {
+    const abortSignal = { value: false };
+    if (limit === 'unbounded') {
+        await Promise.all(items.map((item) => worker(item, abortSignal)));
+        return;
+    }
+    let cursor = 0;
+    const workers = [];
+    for (let i = 0; i < Math.min(limit, items.length); i += 1) {
+        workers.push((async () => {
+            while (!abortSignal.value) {
+                const index = cursor;
+                cursor += 1;
+                const item = items[index];
+                if (item === undefined)
+                    return;
+                await worker(item, abortSignal);
+            }
+        })());
+    }
+    await Promise.all(workers);
+}
+async function executeFanoutInternal(step, context, relayConnector) {
+    const attempt = context.activeStepAttempt ?? 1;
+    const branchDirRoot = branchesDir(step);
+    const aggregate = aggregateRef(step);
+    // Iteration-scoped branch directories. When a fanout is the head/body of an
+    // until-loop it re-runs once per wave, but every branch writes to a fixed
+    // `${branchDirRoot}/${branch_id}` path with no wave component. A branch that
+    // existed on an earlier wave but not this one leaves a stale directory
+    // behind. The join verdict is built from this wave's in-memory outcomes and
+    // is unaffected, but the run-history extractor walks the branch dir on disk
+    // (src/app/history/extract.ts) and would ingest the stale branch as if it
+    // were part of this wave. Clear the branch dir root before the first branch
+    // of every wave after the first. activeSliceIndex is set by the graph-runner
+    // only on loop-body steps (see graph-runner.ts, loopBodyIndex); it is absent
+    // on single-pass fanouts, so this is a strict no-op for every non-looped
+    // fanout (explore/prototype/explainer tournaments).
+    if ((context.activeSliceIndex ?? 0) > 0) {
+        await rm(context.files.resolve(branchDirRoot), { recursive: true, force: true });
+    }
+    const branches = await expandFanoutBranches(step, context.files, context);
+    if (branches.length === 0) {
+        throw new Error(`fanout step '${step.id}': branch resolution produced zero branches`);
+    }
+    const policy = joinPolicy(step);
+    if (policy === 'disjoint-merge' && branches.some((branch) => branch.kind !== 'sub-run')) {
+        throw new Error(`fanout step '${step.id}': disjoint-merge is only supported for sub-run branches with worktrees`);
+    }
+    const branchIds = branches.map((branch) => branch.branch_id);
+    const executionPolicy = fanoutExecutionPolicy(step, branches, context, relayConnector, branchDirRoot);
+    await context.trace.append({
+        run_id: context.runId,
+        kind: 'fanout.started',
+        step_id: step.id,
+        attempt,
+        branch_ids: branchIds,
+        on_child_failure: FanoutFailurePolicy.parse(step.onChildFailure ?? 'abort-all'),
+        ...(executionPolicy.writableRelayBranchesSerialized
+            ? {
+                execution_policy: {
+                    configured_concurrency: executionPolicy.configuredConcurrency,
+                    effective_concurrency: executionPolicy.effectiveConcurrency,
+                    writable_relay_branches_serialized: true,
+                    reason: executionPolicy.serializationReason,
+                },
+            }
+            : {}),
+    });
+    const worktreeRunner = context.worktreeRunner ?? gitWorktreeRunner;
+    const provisioned = [];
+    const outcomes = [];
+    const onChildFailure = step.onChildFailure ?? 'abort-all';
+    let branchFiles;
+    let branchFilesError;
+    // Announce liveness before provisioning any worktree. While this step holds
+    // worktrees the owner lock records our pid so a concurrent reaper (or a
+    // startup reclaim after a crash) keeps them instead of force-removing live
+    // work. It is removed in the `finally` below; a SIGKILL skips that `finally`,
+    // leaving a stale (dead-pid) lock the reaper then treats as reclaimable.
+    const worktreesRoot = context.projectRoot === undefined
+        ? undefined
+        : joinPath(controlPlaneRoot(context.projectRoot), 'worktrees');
+    const willProvisionWorktree = worktreesRoot !== undefined &&
+        branches.some((branch) => branch.kind !== 'relay' && branchNeedsWorktree(branch));
+    if (worktreesRoot !== undefined && willProvisionWorktree) {
+        writeOwnerLock(worktreesRoot, context.runId, context.now().toISOString());
+    }
+    try {
+        await runWithConcurrency(branches, executionPolicy.effectiveConcurrency, async (branch, abortSignal) => {
+            if (abortSignal.value)
+                return;
+            const branchDirRel = `${branchDirRoot}/${branch.branch_id}`;
+            const branchDirAbs = context.files.resolve(branchDirRel);
+            let outcome;
+            if (branch.kind === 'relay') {
+                outcome = await executeRelayFanoutBranch(step, context, branch, relayConnector, branchDirRel, branchDirAbs);
+            }
+            else {
+                if (context.projectRoot === undefined) {
+                    throw new Error(`fanout step '${step.id}': projectRoot is required to anchor per-branch worktrees`);
+                }
+                const worktreePath = joinPath(controlPlaneRoot(context.projectRoot), 'worktrees', context.runId, step.id, branch.branch_id);
+                if (branchNeedsWorktree(branch))
+                    provisioned.push(worktreePath);
+                outcome = await executeSubRunFanoutBranch(step, context, branch, worktreeRunner, branchDirRel, worktreePath);
+            }
+            outcomes.push(outcome);
+            if (!outcome.admitted && onChildFailure === 'abort-all') {
+                abortSignal.value = true;
+            }
+        });
+        if (policy === 'disjoint-merge' && outcomes.every((outcome) => outcome.admitted)) {
+            try {
+                const collected = await Promise.all(outcomes.map(async (outcome) => {
+                    const files = worktreeRunner.changedFiles
+                        ? await Promise.resolve(worktreeRunner.changedFiles(outcome.worktree_path, 'HEAD'))
+                        : [];
+                    return [outcome.branch_id, files];
+                }));
+                branchFiles = new Map(collected);
+            }
+            catch (error) {
+                branchFilesError = error.message;
+            }
+        }
+    }
+    finally {
+        for (const worktreePath of provisioned) {
+            try {
+                // Remove against the same project root the worktree was provisioned
+                // under (see the add call in branch-execution), so cleanup targets the
+                // right repo even when the engine's process cwd is elsewhere.
+                await Promise.resolve(worktreeRunner.remove(worktreePath, context.projectRoot));
+            }
+            catch {
+                // Cleanup is best-effort here, matching the v1 runtime. A leftover
+                // worktree is operator-visible but should not hide the primary failure.
+            }
+        }
+        // Release the liveness lock now that this step's worktrees are gone. On a
+        // clean run this pairs with the write above; a crash skips it, which is the
+        // intended signal for the reaper.
+        if (worktreesRoot !== undefined && willProvisionWorktree) {
+            removeOwnerLock(worktreesRoot, context.runId);
+        }
+    }
+    const orderedOutcomes = outcomesInBranchOrder(outcomes, branchIds);
+    const joinResult = evaluateFanoutJoinPolicy({
+        policy,
+        stepId: step.id,
+        admitOrder: admitOrder(step),
+        outcomes: orderedOutcomes.map((outcome) => ({
+            branch_id: outcome.branch_id,
+            child_outcome: outcome.child_outcome,
+            verdict: outcome.verdict,
+            admitted: outcome.admitted,
+            ...(outcome.result_body === undefined ? {} : { result_body: outcome.result_body }),
+            ...(outcome.failure_reason === undefined ? {} : { failure_reason: outcome.failure_reason }),
+        })),
+        ...(branchFiles === undefined ? {} : { branchFiles }),
+        ...(branchFilesError === undefined ? {} : { branchFilesError }),
+    });
+    await context.files.writeJson(aggregate, buildFanoutAggregate(policy, orderedOutcomes, joinResult.winnerBranchId, step.rubric));
+    await context.trace.append({
+        run_id: context.runId,
+        kind: 'step.report_written',
+        step_id: step.id,
+        attempt,
+        report_path: aggregate.path,
+        report_schema: aggregate.schema ?? 'fanout-aggregate@v1',
+    });
+    const branchesCompleted = orderedOutcomes.filter((outcome) => outcome.child_outcome === 'complete').length;
+    await context.trace.append({
+        run_id: context.runId,
+        kind: 'fanout.joined',
+        step_id: step.id,
+        attempt,
+        policy,
+        ...(joinResult.winnerBranchId === undefined
+            ? {}
+            : { selected_branch_id: joinResult.winnerBranchId }),
+        aggregate_path: aggregate.path,
+        branches_completed: branchesCompleted,
+        branches_failed: orderedOutcomes.length - branchesCompleted,
+    });
+    if (joinResult.joinedSuccessfully) {
+        await context.trace.append({
+            run_id: context.runId,
+            kind: 'check.evaluated',
+            step_id: step.id,
+            attempt,
+            check_kind: 'fanout_aggregate',
+            outcome: 'pass',
+        });
+        return { route: 'pass', details: { aggregate: aggregate.path } };
+    }
+    const reason = joinResult.failureReason ?? `fanout step '${step.id}': join policy '${policy}' did not pass`;
+    await context.trace.append({
+        run_id: context.runId,
+        kind: 'check.evaluated',
+        step_id: step.id,
+        attempt,
+        check_kind: 'fanout_aggregate',
+        outcome: 'fail',
+        reason,
+    });
+    throw new Error(reason);
+}
+export async function executeFanoutResult(step, context, relayConnector) {
+    try {
+        return stepExecutionOutcome(await executeFanoutInternal(step, context, relayConnector));
+    }
+    catch (error) {
+        return stepExecutionFailedFrom(error);
+    }
+}
+export async function executeFanout(step, context, relayConnector) {
+    return unwrapStepExecutionResult(await executeFanoutResult(step, context, relayConnector));
+}
+//# sourceMappingURL=fanout.js.map

package/dist/runtime/executors/fanout.js.map

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

package/dist/runtime/executors/index.d.ts

@@ -0,0 +1,11 @@
+import type { StepKind, StepOutcome } from '../domain/step.js';
+import type { ExecutableStep } from '../manifest/executable-flow.js';
+import type { RunContext } from '../run/run-context.js';
+import { type RelayConnector } from './relay.js';
+export type StepExecutor = (step: ExecutableStep, context: RunContext) => Promise<StepOutcome>;
+export type ExecutorRegistry = Readonly<Record<StepKind, StepExecutor>>;
+export interface DefaultExecutorOptions {
+    readonly relayConnector?: RelayConnector;
+}
+export declare function createDefaultExecutors(options?: DefaultExecutorOptions): ExecutorRegistry;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/executors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/executors/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,OAAO,EAAE,KAAK,cAAc,EAAgB,MAAM,YAAY,CAAC;AAI/D,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE/F,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAuBD,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,sBAA2B,GAAG,gBAAgB,CAY7F"}

package/dist/runtime/executors/index.js

@@ -0,0 +1,32 @@
+import { executeCheckpoint } from './checkpoint.js';
+import { executeCompose } from './compose.js';
+import { executeFanout } from './fanout.js';
+import { executeRelay } from './relay.js';
+import { executeSubRun } from './sub-run.js';
+import { executeVerification } from './verification.js';
+function unsupportedStep(step) {
+    throw new Error(`step kind '${step.kind}' is not implemented in runtime baseline`);
+}
+// Wraps a kind-specific executor in the registry-facing `StepExecutor` shape:
+// guard the incoming step's kind (so the inner executor receives the narrowed
+// step type) and delegate. Centralizing the guard means each registry entry is
+// a single typed binding rather than a hand-written `if (step.kind !== ...)`.
+function bindExecutor(kind, execute) {
+    return async (step, context) => {
+        if (step.kind !== kind)
+            return unsupportedStep(step);
+        return execute(step, context);
+    };
+}
+export function createDefaultExecutors(options = {}) {
+    const relayConnector = options.relayConnector;
+    return {
+        compose: bindExecutor('compose', (step, context) => executeCompose(step, context)),
+        relay: bindExecutor('relay', (step, context) => executeRelay(step, context, relayConnector)),
+        verification: bindExecutor('verification', (step, context) => executeVerification(step, context)),
+        checkpoint: bindExecutor('checkpoint', (step, context) => executeCheckpoint(step, context)),
+        'sub-run': bindExecutor('sub-run', (step, context) => executeSubRun(step, context)),
+        fanout: bindExecutor('fanout', (step, context) => executeFanout(step, context, relayConnector)),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/executors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/executors/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAuB,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAaxD,SAAS,eAAe,CAAC,IAAoB;IAC3C,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,IAAI,0CAA0C,CAAC,CAAC;AACrF,CAAC;AAED,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,SAAS,YAAY,CACnB,IAAO,EACP,OAA2E;IAE3E,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QAC7B,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,IAAqB,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkC,EAAE;IACzE,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC9C,OAAO;QACL,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAClF,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QAC5F,YAAY,EAAE,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAC3D,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CACnC;QACD,UAAU,EAAE,YAAY,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3F,SAAS,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnF,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;KAChG,CAAC;AACJ,CAAC"}

package/dist/runtime/executors/relay.d.ts

@@ -0,0 +1,73 @@
+import { type ResolvedConnector } from '../../schemas/connector.js';
+import type { RelayResult } from '../../shared/connector-relay.js';
+import { type AcceptanceCriteriaEvaluationResult } from '../acceptance-criteria.js';
+import type { StepOutcome } from '../domain/step.js';
+import type { RelayStep } from '../manifest/executable-flow.js';
+import { type CheckEvaluation, type RelayStep as CompiledRelayStepV1 } from '../run/relay-support.js';
+import type { RunContext } from '../run/run-context.js';
+import { type StepExecutionResult } from './result.js';
+export interface RelayRequest {
+    readonly runId: string;
+    readonly stepId: string;
+    readonly role: string;
+    readonly prompt: string;
+    readonly connector?: string;
+}
+export interface RelayConnector {
+    readonly connectorName?: string;
+    readonly connector?: ResolvedConnector;
+    relay(request: RelayRequest): Promise<unknown>;
+}
+export declare function createStubRelayConnector(response?: unknown): RelayConnector;
+export declare function relayWithResolvedConnector(connector: ResolvedConnector, input: {
+    readonly prompt: string;
+    readonly timeoutMs?: number;
+    readonly idleTimeoutMs?: number;
+    readonly cwd?: string;
+    readonly resolvedSelection?: unknown;
+    readonly responseSchema?: Record<string, unknown>;
+    readonly toolAllowList?: readonly string[];
+}): Promise<RelayResult>;
+export interface ProductionRelayAttemptValidationInput {
+    readonly flow: RunContext['packageIndex']['flow'];
+    readonly context: RunContext;
+    readonly step: RelayStep;
+    readonly compiledStep: CompiledRelayStepV1;
+    readonly relayResult: RelayResult;
+    readonly checkEvaluation: Extract<CheckEvaluation, {
+        kind: 'pass';
+    }>;
+}
+export interface ProductionRelayAttemptValidationResult {
+    readonly evaluation: CheckEvaluation;
+    readonly failureKind?: 'schema' | 'acceptance';
+    readonly acceptance?: AcceptanceCriteriaEvaluationResult;
+    readonly parsedBody?: unknown;
+}
+export type ProductionRelayAttemptResult = {
+    readonly kind: 'connector_failed';
+    readonly reason: string;
+    readonly duration_ms: number;
+} | {
+    readonly kind: 'completed';
+    readonly evaluation: CheckEvaluation;
+    readonly relay_completed_verdict: string;
+    readonly duration_ms: number;
+    readonly result_path: string;
+    readonly parsed_body?: unknown;
+    readonly report_path?: string;
+    readonly acceptance_failure?: Extract<AcceptanceCriteriaEvaluationResult, {
+        readonly kind: 'fail';
+    }>;
+};
+export declare function executeProductionRelayAttempt(input: {
+    readonly step: RelayStep;
+    readonly compiledStep: CompiledRelayStepV1;
+    readonly context: RunContext;
+    readonly formatConnectorFailureReason?: (stepId: string, error: unknown) => string;
+    readonly validateAcceptedResult?: (input: ProductionRelayAttemptValidationInput) => ProductionRelayAttemptValidationResult;
+    readonly branchGoal?: string;
+}): Promise<ProductionRelayAttemptResult>;
+export declare function executeRelayResult(step: RelayStep, context: RunContext, connector?: RelayConnector): Promise<StepExecutionResult>;
+export declare function executeRelay(step: RelayStep, context: RunContext, connector?: RelayConnector): Promise<StepOutcome>;
+//# sourceMappingURL=relay.d.ts.map

package/dist/runtime/executors/relay.d.ts.map

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