@ashx-j/lunr-dev 0.2.13-dev.1.1

package/dist/builtin-extensions/pi-subagents/src/runs/background/subagent-runner.js

@@ -0,0 +1,3534 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+// @ts-nocheck
+import { spawn, spawnSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { pathToFileURL } from "node:url";
+import { writeAtomicJson } from "../../shared/atomic-json.js";
+import { createChildTranscriptWriter } from "../../shared/child-transcript.js";
+import { closeSteerInbox, consumeInterruptRequest, consumeSteerRequests, deliverInterruptRequest, deliverStopRequest, deliverTimeoutRequest, enqueueStepSteer, steerAcksDir, steerCapabilityPath, stepSteerInboxDir, watchAsyncControlInbox } from "./control-channel.js";
+import { appendJsonl as appendRawJsonl, getArtifactPaths } from "../../shared/artifacts.js";
+import { PI_CODING_AGENT_PACKAGE, getPiSpawnCommand, resolveInstalledPiPackageRoot } from "../shared/pi-spawn.js";
+import { captureSingleOutputSnapshot, extractChildWrittenOutput, finalizeSingleOutput, formatSavedOutputReference, injectOutputPathSystemPrompt, injectSingleOutputInstruction, resolveSingleOutput } from "../shared/single-output.js";
+import { DEFAULT_MAX_OUTPUT, SUBAGENT_LIFECYCLE_ARTIFACT_VERSION, truncateOutput, getSubagentDepthEnv, } from "../../shared/types.js";
+import { DEFAULT_CONTROL_CONFIG, buildControlEvent, deriveActivityState, claimControlNotification, formatControlIntercomMessage, formatControlNoticeMessage, } from "../shared/subagent-control.js";
+import { isDynamicRunnerGroup, isParallelGroup, flattenSteps, mapConcurrent, aggregateParallelOutputs, MAX_PARALLEL_CONCURRENCY, DEFAULT_GLOBAL_CONCURRENCY_LIMIT, Semaphore, } from "../shared/parallel-utils.js";
+import { applyThinkingSuffix, buildPiArgs, cleanupTempDir } from "../shared/pi-args.js";
+import { snapshotParentPermissionMode } from "../../../../../core/subagent-permission-inherit.js";
+import { resolveChildExcludeTools } from "../shared/child-tools.js";
+import { outputEntryFromAsyncResult, resolveOutputReferences } from "../shared/chain-outputs.js";
+import { createStructuredOutputRuntime, readStructuredOutput } from "../shared/structured-output.js";
+import { readChildToolDiagnosticError } from "../shared/tool-availability.js";
+import { collectDynamicResults, DynamicFanoutError, materializeDynamicParallelStep, validateDynamicCollection } from "../shared/dynamic-fanout.js";
+import { nestedSummaryFromAsyncStatus, projectNestedEvents, resolveNestedAsyncDir, writeNestedEvent } from "../shared/nested-events.js";
+import { formatModelAttemptNote, isRetryableModelFailure } from "../shared/model-fallback.js";
+import { createSteeringStatus, recordSteeringRequest, steeringStatus, terminalSteeringNoticeState, updateSteeringTarget } from "./steering.js";
+import { attachPostExitStdioGuard, trySignalChild } from "../../shared/post-exit-stdio-guard.js";
+import { detectSubagentError, extractTextFromContent, extractToolArgsPreview, getFinalOutput, readStatus } from "../../shared/utils.js";
+import { evaluateCompletionMutationGuard } from "../shared/completion-guard.js";
+import { createMutatingFailureState, didMutatingToolFail, isMutatingTool, nextLongRunningTrigger, recordMutatingFailure, resetMutatingFailureState, resolveCurrentPath, shouldEscalateMutatingFailures, summarizeRecentMutatingFailures, } from "../shared/long-running-guard.js";
+import { parseSessionTokens } from "../../shared/session-tokens.js";
+import { cleanupWorktrees, createWorktrees, diffWorktrees, findWorktreeTaskCwdConflict, formatWorktreeDiffSummary, formatWorktreeTaskCwdConflict, } from "../shared/worktree.js";
+import { resolveEffectiveThinking } from "../../shared/model-info.js";
+import { writeInitialProgressFile } from "../../shared/settings.js";
+import { resolveSubagentIntercomTarget } from "../../intercom/intercom-bridge.js";
+import { acceptanceFailureMessage, aggregateAcceptanceReport, buildSkippedAcceptanceLedger, evaluateAcceptance, formatAcceptancePrompt, resolveEffectiveAcceptance, stripAcceptanceReport } from "../shared/acceptance.js";
+import { waitForImportedAsyncRoot } from "./chain-root-attachment.js";
+import { appendRunnerStepsToStatus, consumeChainAppendRequests, countPendingChainAppendRequests } from "./chain-append.js";
+import { appendTurnBudgetSystemPrompt, formatTurnBudgetOutput, initialTurnBudgetState, shouldAbortForTurnBudget, turnBudgetExceededMessage, turnBudgetSoftNote, turnBudgetState } from "../shared/turn-budget.js";
+import { initialToolBudgetState, toolBudgetState } from "../shared/tool-budget.js";
+import { resolveWatchdogConfig } from "../../watchdog/settings.js";
+import { createBoundedByteTail, createBoundedLineReader, formatProtocolOutputLimit, MAX_CHILD_STDERR_BYTES, projectChildLifecycle } from "../shared/child-protocol.js";
+import { acquireSessionLease } from "../shared/session-lease.js";
+import { CHILD_WATCHDOG_CONFIG_ENV, acceptChildWatchdogEvent, childWatchdogIsActive, decodeChildWatchdogConfig, isChildWatchdogStatusEvent, resolveChildWatchdogConfig, } from "../../watchdog/child-status.js";
+const ASYNC_INTERRUPT_SIGNAL = process.platform === "win32" ? "SIGBREAK" : "SIGUSR2";
+const DEFAULT_MAX_ASYNC_EVENTS_BYTES = 50 * 1024 * 1024;
+const ASYNC_EVENTS_MAX_BYTES_ENV = "PI_SUBAGENT_ASYNC_EVENTS_MAX_BYTES";
+const TRUNCATED_EVENT_TYPE = "subagent.events.truncated";
+const TRUNCATION_MARKER_RESERVE_BYTES = 512;
+const asyncEventLogStates = new Map();
+function maxAsyncEventsBytes() {
+    const raw = process.env[ASYNC_EVENTS_MAX_BYTES_ENV];
+    if (!raw)
+        return DEFAULT_MAX_ASYNC_EVENTS_BYTES;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        return DEFAULT_MAX_ASYNC_EVENTS_BYTES;
+    return Math.floor(parsed);
+}
+function eventLogState(filePath) {
+    let state = asyncEventLogStates.get(filePath);
+    if (state)
+        return state;
+    let bytes = 0;
+    try {
+        bytes = fs.statSync(filePath).size;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT") {
+            // Diagnostic event accounting is best-effort; writes below are also safe.
+        }
+    }
+    state = { bytes, diagnosticsTruncated: false };
+    asyncEventLogStates.set(filePath, state);
+    return state;
+}
+function appendJsonl(filePath, line) {
+    try {
+        appendRawJsonl(filePath, line);
+        const state = asyncEventLogStates.get(filePath);
+        if (state)
+            state.bytes += Buffer.byteLength(`${line}\n`, "utf-8");
+    }
+    catch {
+        // Async event logging is diagnostic and must not fail the run.
+    }
+}
+function appendDiagnosticJsonl(filePath, line, droppedEventType) {
+    if (!line.trim())
+        return;
+    const state = eventLogState(filePath);
+    if (state.diagnosticsTruncated)
+        return;
+    const maxBytes = maxAsyncEventsBytes();
+    const chunkBytes = Buffer.byteLength(`${line}\n`, "utf-8");
+    const diagnosticBudget = Math.max(0, maxBytes - TRUNCATION_MARKER_RESERVE_BYTES);
+    if (state.bytes + chunkBytes <= diagnosticBudget) {
+        appendJsonl(filePath, line);
+        return;
+    }
+    const marker = JSON.stringify({
+        type: TRUNCATED_EVENT_TYPE,
+        ts: Date.now(),
+        maxBytes,
+        droppedEventType,
+    });
+    if (state.bytes + Buffer.byteLength(`${marker}\n`, "utf-8") <= maxBytes) {
+        appendJsonl(filePath, marker);
+    }
+    state.diagnosticsTruncated = true;
+}
+function shouldPersistChildEvent(event) {
+    return event.type !== "message_update";
+}
+function findLatestSessionFile(sessionDir) {
+    try {
+        const files = fs
+            .readdirSync(sessionDir)
+            .filter((f) => f.endsWith(".jsonl"))
+            .map((f) => path.join(sessionDir, f));
+        if (files.length === 0)
+            return null;
+        files.sort((a, b) => fs.statSync(b).mtimeMs - fs.statSync(a).mtimeMs);
+        return files[0] ?? null;
+    }
+    catch {
+        // Session lookup is optional metadata.
+        return null;
+    }
+}
+function emptyUsage() {
+    return { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: 0 };
+}
+function tokenUsageFromAttempts(attempts) {
+    if (!attempts || attempts.length === 0)
+        return null;
+    let input = 0;
+    let output = 0;
+    for (const attempt of attempts) {
+        input += attempt.usage?.input ?? 0;
+        output += attempt.usage?.output ?? 0;
+    }
+    const total = input + output;
+    return total > 0 ? { input, output, total } : null;
+}
+function costSummaryFromAttempts(attempts) {
+    if (!attempts || attempts.length === 0)
+        return undefined;
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let costUsd = 0;
+    for (const attempt of attempts) {
+        inputTokens += attempt.usage?.input ?? 0;
+        outputTokens += attempt.usage?.output ?? 0;
+        costUsd += attempt.usage?.cost ?? 0;
+    }
+    return inputTokens > 0 || outputTokens > 0 || costUsd > 0
+        ? { inputTokens, outputTokens, costUsd }
+        : undefined;
+}
+function appendRecentStepOutput(step, lines) {
+    const nonEmpty = lines.filter((line) => line.trim());
+    if (nonEmpty.length === 0)
+        return;
+    step.recentOutput ??= [];
+    step.recentOutput.push(...nonEmpty);
+    if (step.recentOutput.length > 50) {
+        step.recentOutput.splice(0, step.recentOutput.length - 50);
+    }
+}
+function isTerminalAssistantStop(message) {
+    const stopReason = message.stopReason;
+    const hasToolCall = Array.isArray(message.content)
+        && message.content.some((part) => part.type === "toolCall");
+    return stopReason === "stop" && !hasToolCall;
+}
+function resetStepLiveDetail(step) {
+    step.currentTool = undefined;
+    step.currentToolArgs = undefined;
+    step.currentToolStartedAt = undefined;
+    step.currentPath = undefined;
+    step.recentTools = [];
+    step.recentOutput = [];
+}
+function runPiStreaming(args, cwd, outputFile, env, piPackageRoot, piArgv1, maxSubagentDepth, childEventContext, registerInterrupt, onChildEvent, transcriptWriter, registerTimeout, timeoutMessage, registerStop, stopMessage, registerTurnBudgetAbort, onWriterProcess) {
+    return new Promise((resolve) => {
+        onWriterProcess?.({ state: "spawning" });
+        const outputStream = fs.createWriteStream(outputFile, { flags: "w" });
+        const spawnEnv = { ...process.env, ...(env ?? {}), ...getSubagentDepthEnv(maxSubagentDepth) };
+        const spawnSpec = getPiSpawnCommand(args, {
+            ...(piPackageRoot ? { piPackageRoot } : {}),
+            ...(piArgv1 ? { argv1: piArgv1 } : {}),
+        });
+        const child = spawn(spawnSpec.command, spawnSpec.args, {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: spawnEnv,
+            windowsHide: true,
+        });
+        const stderrTail = createBoundedByteTail();
+        const rawStdoutTail = createBoundedByteTail();
+        const messages = [];
+        const usage = emptyUsage();
+        let model;
+        let writerRegistrationError;
+        if (typeof child.pid === "number") {
+            try {
+                onWriterProcess?.({ state: "running", pid: child.pid });
+            }
+            catch (writerError) {
+                writerRegistrationError = `Failed to record revived Pi writer ownership: ${writerError instanceof Error ? writerError.message : String(writerError)}`;
+                trySignalChild(child, "SIGKILL");
+            }
+        }
+        let error = writerRegistrationError;
+        let assistantError;
+        let interrupted = false;
+        let timedOut = false;
+        let stopped = false;
+        let turnBudgetExceeded = false;
+        let turnBudgetMessage;
+        let turnBudget;
+        let observedMutationAttempt = false;
+        const childWatchdogConfig = decodeChildWatchdogConfig(env?.[CHILD_WATCHDOG_CONFIG_ENV]);
+        let childWatchdogState;
+        let applyChildLifecycle = (_action) => { };
+        const updateChildWatchdogState = (snapshot) => {
+            childWatchdogState = snapshot;
+        };
+        const writeOutputLine = (line) => {
+            if (!line.trim())
+                return;
+            outputStream.write(`${line}\n`);
+        };
+        const writeOutputText = (text) => {
+            for (const line of text.split("\n")) {
+                writeOutputLine(line);
+            }
+        };
+        const appendChildEvent = (event) => {
+            if (!childEventContext)
+                return;
+            if (!shouldPersistChildEvent(event))
+                return;
+            appendDiagnosticJsonl(childEventContext.eventsPath, JSON.stringify({
+                ...event,
+                subagentSource: "child",
+                subagentRunId: childEventContext.runId,
+                subagentStepIndex: childEventContext.stepIndex,
+                subagentAgent: childEventContext.agent,
+                observedAt: Date.now(),
+            }), typeof event.type === "string" ? event.type : undefined);
+        };
+        const appendChildLine = (type, line) => {
+            appendChildEvent({ type, line });
+            if (type === "subagent.child.stdout")
+                transcriptWriter?.writeStdoutLine(line);
+            else
+                transcriptWriter?.writeStderrLine(line);
+        };
+        const processStdoutLine = (line) => {
+            if (!line.trim())
+                return;
+            let event;
+            try {
+                event = JSON.parse(line);
+            }
+            catch {
+                rawStdoutTail.push(`${line}\n`);
+                writeOutputLine(line);
+                appendChildLine("subagent.child.stdout", line);
+                return;
+            }
+            appendChildEvent(event);
+            transcriptWriter?.writeChildEvent(event);
+            if (event.type === "agent_settled")
+                agentSettledReceived = true;
+            applyChildLifecycle(projectChildLifecycle(event));
+            if (isChildWatchdogStatusEvent(event)) {
+                if (!childWatchdogConfig)
+                    return;
+                const next = acceptChildWatchdogEvent({
+                    current: childWatchdogState,
+                    event,
+                    runId: childEventContext?.runId,
+                    agent: childEventContext?.agent,
+                    childIndex: childEventContext?.stepIndex,
+                });
+                if (!next)
+                    return;
+                updateChildWatchdogState(next);
+                onChildEvent?.(event);
+                if (childWatchdogIsActive(next)) {
+                    if (finalDrainTimer) {
+                        clearTimeout(finalDrainTimer);
+                        finalDrainTimer = undefined;
+                    }
+                    if (finalHardKillTimer) {
+                        clearTimeout(finalHardKillTimer);
+                        finalHardKillTimer = undefined;
+                    }
+                    armWatchdogTail();
+                }
+                else {
+                    clearWatchdogTailTimer();
+                    if (cleanTerminalAssistantStopReceived || agentSettledReceived)
+                        startFinalDrain();
+                }
+                return;
+            }
+            onChildEvent?.(event);
+            if (event.type === "tool_execution_start" && event.toolName) {
+                observedMutationAttempt = observedMutationAttempt || isMutatingTool(event.toolName, event.args);
+                const toolArgs = extractToolArgsPreview(event.args ?? {});
+                writeOutputLine(toolArgs ? `${event.toolName}: ${toolArgs}` : event.toolName);
+                return;
+            }
+            if ((event.type === "message_end" || event.type === "tool_result_end") && event.message) {
+                messages.push(event.message);
+                const text = extractTextFromContent(event.message.content);
+                if (text)
+                    writeOutputText(text);
+                if (event.type !== "message_end" || event.message.role !== "assistant")
+                    return;
+                if (event.message.model)
+                    model = event.message.model;
+                if (event.message.errorMessage)
+                    assistantError = event.message.errorMessage;
+                const eventUsage = event.message.usage;
+                if (eventUsage) {
+                    usage.turns++;
+                    usage.input += eventUsage.input ?? eventUsage.inputTokens ?? 0;
+                    usage.output += eventUsage.output ?? eventUsage.outputTokens ?? 0;
+                    usage.cacheRead += eventUsage.cacheRead ?? 0;
+                    usage.cacheWrite += eventUsage.cacheWrite ?? 0;
+                    usage.cost += eventUsage.cost?.total ?? 0;
+                }
+                if (isTerminalAssistantStop(event.message)) {
+                    if (!event.message.errorMessage && extractTextFromContent(event.message.content).trim())
+                        assistantError = undefined;
+                    cleanTerminalAssistantStopReceived ||= !event.message.errorMessage;
+                    applyChildLifecycle(projectChildLifecycle(event, true));
+                }
+            }
+        };
+        // Guard both cases that can leave the parent waiting on `close` forever:
+        // a lingering stdio holder after `exit`, or a child that never exits.
+        const FINAL_STOP_GRACE_MS = 1000;
+        const HARD_KILL_MS = 3000;
+        const TIMEOUT_HARD_KILL_MS = 3000;
+        let childExited = false;
+        let forcedTerminationSignal = false;
+        let cleanTerminalAssistantStopReceived = false;
+        let agentSettledReceived = false;
+        let finalDrainTimer;
+        let finalHardKillTimer;
+        let watchdogTailTimer;
+        let timeoutHardKillTimer;
+        let turnBudgetTerminationTimer;
+        let turnBudgetHardKillTimer;
+        let protocolHardKillTimer;
+        let protocolError;
+        let settled = false;
+        applyChildLifecycle = (action) => {
+            if (action === "cancel-drain") {
+                if (finalDrainTimer) {
+                    clearTimeout(finalDrainTimer);
+                    finalDrainTimer = undefined;
+                }
+                if (finalHardKillTimer) {
+                    clearTimeout(finalHardKillTimer);
+                    finalHardKillTimer = undefined;
+                }
+                clearWatchdogTailTimer();
+                return;
+            }
+            if (action === "start-drain")
+                startFinalDrain();
+        };
+        const failProtocol = (limit) => {
+            if (protocolError)
+                return;
+            protocolError = limit;
+            error = formatProtocolOutputLimit(limit);
+            if (!childExited) {
+                trySignalChild(child, "SIGTERM");
+                protocolHardKillTimer = setTimeout(() => {
+                    if (!settled)
+                        trySignalChild(child, "SIGKILL");
+                }, 3000);
+                protocolHardKillTimer.unref?.();
+            }
+        };
+        const stdoutReader = createBoundedLineReader({ onLine: processStdoutLine, onLimit: failProtocol });
+        const stderrReader = createBoundedLineReader({
+            stream: "stderr",
+            maxPendingLineBytes: MAX_CHILD_STDERR_BYTES,
+            onLine: (line) => appendChildLine("subagent.child.stderr", line),
+            onLimit: (limit) => appendChildLine("subagent.child.stderr", formatProtocolOutputLimit(limit)),
+        });
+        const clearStdioGuard = attachPostExitStdioGuard(child, { idleMs: 2000, hardMs: 8000 });
+        child.stdout.on("data", (chunk) => stdoutReader.push(chunk));
+        child.stderr.on("data", (chunk) => {
+            stderrTail.push(chunk);
+            stderrReader.push(chunk);
+            outputStream.write(chunk);
+        });
+        registerInterrupt?.(() => {
+            if (settled || timedOut || stopped)
+                return;
+            interrupted = true;
+            if (!error)
+                error = "Interrupted. Waiting for explicit next action.";
+            trySignalChild(child, "SIGINT");
+            setTimeout(() => {
+                if (!settled && !timedOut && !stopped)
+                    trySignalChild(child, "SIGTERM");
+            }, 1000).unref?.();
+        });
+        registerTimeout?.(() => {
+            if (settled || timedOut || stopped)
+                return;
+            timedOut = true;
+            interrupted = false;
+            error = timeoutMessage ?? "Subagent timed out.";
+            trySignalChild(child, "SIGTERM");
+            timeoutHardKillTimer = setTimeout(() => {
+                if (!settled)
+                    trySignalChild(child, "SIGKILL");
+            }, TIMEOUT_HARD_KILL_MS);
+            timeoutHardKillTimer.unref?.();
+        });
+        registerStop?.(() => {
+            if (settled || timedOut || stopped)
+                return;
+            stopped = true;
+            interrupted = false;
+            error = stopMessage ?? "Subagent stopped by user.";
+            trySignalChild(child, "SIGTERM");
+            timeoutHardKillTimer = setTimeout(() => {
+                if (!settled)
+                    trySignalChild(child, "SIGKILL");
+            }, TIMEOUT_HARD_KILL_MS);
+            timeoutHardKillTimer.unref?.();
+        });
+        registerTurnBudgetAbort?.((message, state) => {
+            if (settled || timedOut || stopped || turnBudgetExceeded)
+                return;
+            turnBudgetExceeded = true;
+            turnBudgetMessage = message;
+            turnBudget = state;
+            interrupted = false;
+            error = message;
+            trySignalChild(child, "SIGINT");
+            turnBudgetTerminationTimer = setTimeout(() => {
+                if (!settled && !timedOut && !stopped)
+                    trySignalChild(child, "SIGTERM");
+            }, 1000);
+            turnBudgetTerminationTimer.unref?.();
+            turnBudgetHardKillTimer = setTimeout(() => {
+                if (!settled && !timedOut && !stopped)
+                    trySignalChild(child, "SIGKILL");
+            }, 4000);
+            turnBudgetHardKillTimer.unref?.();
+        });
+        const clearDrainTimers = () => {
+            if (finalDrainTimer) {
+                clearTimeout(finalDrainTimer);
+                finalDrainTimer = undefined;
+            }
+            if (finalHardKillTimer) {
+                clearTimeout(finalHardKillTimer);
+                finalHardKillTimer = undefined;
+            }
+            clearWatchdogTailTimer();
+            if (timeoutHardKillTimer) {
+                clearTimeout(timeoutHardKillTimer);
+                timeoutHardKillTimer = undefined;
+            }
+            if (turnBudgetTerminationTimer) {
+                clearTimeout(turnBudgetTerminationTimer);
+                turnBudgetTerminationTimer = undefined;
+            }
+            if (turnBudgetHardKillTimer) {
+                clearTimeout(turnBudgetHardKillTimer);
+                turnBudgetHardKillTimer = undefined;
+            }
+            if (protocolHardKillTimer) {
+                clearTimeout(protocolHardKillTimer);
+                protocolHardKillTimer = undefined;
+            }
+        };
+        function startFinalDrain() {
+            if (childWatchdogIsActive(childWatchdogState)) {
+                armWatchdogTail();
+                return;
+            }
+            if (childExited || finalDrainTimer || settled)
+                return;
+            finalDrainTimer = setTimeout(() => {
+                if (settled)
+                    return;
+                const termSent = trySignalChild(child, "SIGTERM");
+                if (!termSent)
+                    return;
+                forcedTerminationSignal = true;
+                if (!cleanTerminalAssistantStopReceived && !agentSettledReceived && !error && !assistantError) {
+                    error = `Subagent process did not exit within ${FINAL_STOP_GRACE_MS}ms after its terminal event. Forcing termination.`;
+                }
+                finalHardKillTimer = setTimeout(() => {
+                    if (settled)
+                        return;
+                    forcedTerminationSignal = trySignalChild(child, "SIGKILL") || forcedTerminationSignal;
+                }, HARD_KILL_MS);
+                finalHardKillTimer.unref?.();
+            }, FINAL_STOP_GRACE_MS);
+            finalDrainTimer.unref?.();
+        }
+        function clearWatchdogTailTimer() {
+            if (watchdogTailTimer) {
+                clearTimeout(watchdogTailTimer);
+                watchdogTailTimer = undefined;
+            }
+        }
+        function armWatchdogTail() {
+            if ((!cleanTerminalAssistantStopReceived && !agentSettledReceived) || watchdogTailTimer || settled)
+                return;
+            watchdogTailTimer = setTimeout(() => {
+                watchdogTailTimer = undefined;
+                updateChildWatchdogState({
+                    phase: "stale",
+                    seq: (childWatchdogState?.seq ?? 0) + 1,
+                    lastUpdate: Date.now(),
+                    followUpPending: false,
+                    reason: "child watchdog tail timeout",
+                    timedOut: true,
+                });
+                startFinalDrain();
+            }, childWatchdogConfig?.watchdogTailTimeoutMs ?? 120_000);
+            watchdogTailTimer.unref?.();
+        }
+        child.on("exit", () => {
+            childExited = true;
+            clearDrainTimers();
+        });
+        child.on("close", (exitCode, signal) => {
+            settled = true;
+            try {
+                onWriterProcess?.({ state: "none" });
+            }
+            catch {
+                // The runner still owns and releases the lease during finalization.
+            }
+            registerInterrupt?.(undefined);
+            registerTimeout?.(undefined);
+            registerStop?.(undefined);
+            registerTurnBudgetAbort?.(undefined);
+            clearDrainTimers();
+            clearStdioGuard();
+            stdoutReader.end();
+            stderrReader.end();
+            outputStream.end();
+            const stderr = stderrTail.text();
+            const finalOutput = getFinalOutput(messages) || rawStdoutTail.text().trim();
+            const finalError = error ?? assistantError;
+            const forcedDrainAfterFinalSuccess = forcedTerminationSignal && (cleanTerminalAssistantStopReceived || agentSettledReceived) && !finalError;
+            resolve({
+                stderr,
+                exitCode: timedOut || stopped ? 1 : turnBudgetExceeded ? 1 : interrupted || forcedDrainAfterFinalSuccess ? 0 : forcedTerminationSignal || signal ? (exitCode ?? 1) : exitCode,
+                messages,
+                usage,
+                model,
+                error: stopped ? (stopMessage ?? "Subagent stopped by user.") : timedOut ? (timeoutMessage ?? "Subagent timed out.") : turnBudgetExceeded ? turnBudgetMessage : interrupted || forcedDrainAfterFinalSuccess ? undefined : finalError,
+                protocolError,
+                finalOutput: (timedOut || stopped) && !finalOutput.trim() ? (stopped ? stopMessage ?? "Subagent stopped by user." : timeoutMessage ?? "Subagent timed out.") : finalOutput,
+                interrupted,
+                timedOut,
+                stopped,
+                turnBudget,
+                turnBudgetExceeded,
+                wrapUpRequested: turnBudget?.outcome === "wrap-up-requested" || turnBudgetExceeded || undefined,
+                observedMutationAttempt,
+                watchdog: childWatchdogState,
+            });
+        });
+        child.on("error", (spawnError) => {
+            settled = true;
+            try {
+                onWriterProcess?.({ state: "none" });
+            }
+            catch {
+                // The runner still owns and releases the lease during finalization.
+            }
+            registerInterrupt?.(undefined);
+            registerTimeout?.(undefined);
+            registerStop?.(undefined);
+            registerTurnBudgetAbort?.(undefined);
+            clearDrainTimers();
+            clearStdioGuard();
+            stdoutReader.end();
+            stderrReader.end();
+            outputStream.end();
+            const stderr = stderrTail.text();
+            const finalOutput = getFinalOutput(messages) || rawStdoutTail.text().trim();
+            const spawnErrorMessage = spawnError instanceof Error ? spawnError.message : String(spawnError);
+            resolve({ stderr, exitCode: 1, messages, usage, model, error: stopped ? (stopMessage ?? "Subagent stopped by user.") : timedOut ? (timeoutMessage ?? "Subagent timed out.") : turnBudgetExceeded ? turnBudgetMessage : error ?? assistantError ?? spawnErrorMessage, protocolError, finalOutput: (timedOut || stopped) && !finalOutput.trim() ? (stopped ? stopMessage ?? "Subagent stopped by user." : timeoutMessage ?? "Subagent timed out.") : finalOutput, timedOut, stopped, turnBudget, turnBudgetExceeded, wrapUpRequested: turnBudget?.outcome === "wrap-up-requested" || turnBudgetExceeded || undefined, observedMutationAttempt, watchdog: childWatchdogState });
+        });
+    });
+}
+function resolvePiPackageRootFallback() {
+    const root = resolveInstalledPiPackageRoot();
+    if (root)
+        return root;
+    throw new Error(`Could not resolve ${PI_CODING_AGENT_PACKAGE} package root`);
+}
+async function exportSessionHtml(sessionFile, outputDir, piPackageRoot) {
+    const pkgRoot = piPackageRoot ?? resolvePiPackageRootFallback();
+    const exportModulePath = path.join(pkgRoot, "dist", "core", "export-html", "index.js");
+    const moduleUrl = pathToFileURL(exportModulePath).href;
+    const mod = await import(__rewriteRelativeImportExtension(moduleUrl));
+    const exportFromFile = mod
+        .exportFromFile;
+    if (typeof exportFromFile !== "function") {
+        throw new Error("exportFromFile not available");
+    }
+    const outputPath = path.join(outputDir, `${path.basename(sessionFile, ".jsonl")}.html`);
+    return exportFromFile(sessionFile, { outputPath });
+}
+function createShareLink(htmlPath) {
+    try {
+        const auth = spawnSync("gh", ["auth", "status"], { encoding: "utf-8" });
+        if (auth.status !== 0) {
+            return { error: "GitHub CLI is not logged in. Run 'gh auth login' first." };
+        }
+    }
+    catch {
+        return { error: "GitHub CLI (gh) is not installed." };
+    }
+    try {
+        const result = spawnSync("gh", ["gist", "create", htmlPath], { encoding: "utf-8" });
+        if (result.status !== 0) {
+            const err = (result.stderr || "").trim() || "Failed to create gist.";
+            return { error: err };
+        }
+        const gistUrl = (result.stdout || "").trim();
+        const gistId = gistUrl.split("/").pop();
+        if (!gistId)
+            return { error: "Failed to parse gist ID." };
+        const shareUrl = `https://shittycodingagent.ai/session/?${gistId}`;
+        return { shareUrl, gistUrl };
+    }
+    catch (err) {
+        return { error: String(err) };
+    }
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${(ms / 1000).toFixed(1)}s`;
+    const minutes = Math.floor(ms / 60000);
+    const seconds = Math.floor((ms % 60000) / 1000);
+    return `${minutes}m${seconds}s`;
+}
+function writeRunLog(logPath, input) {
+    const lines = [];
+    lines.push(`# Subagent run ${input.id}`);
+    lines.push("");
+    lines.push(`- **Mode:** ${input.mode}`);
+    lines.push(`- **CWD:** ${input.cwd}`);
+    lines.push(`- **Started:** ${new Date(input.startedAt).toISOString()}`);
+    lines.push(`- **Ended:** ${new Date(input.endedAt).toISOString()}`);
+    lines.push(`- **Duration:** ${formatDuration(input.endedAt - input.startedAt)}`);
+    if (input.sessionFile)
+        lines.push(`- **Session:** ${input.sessionFile}`);
+    if (input.shareUrl)
+        lines.push(`- **Share:** ${input.shareUrl}`);
+    if (input.shareError)
+        lines.push(`- **Share error:** ${input.shareError}`);
+    if (input.artifactsDir)
+        lines.push(`- **Artifacts:** ${input.artifactsDir}`);
+    lines.push("");
+    lines.push("## Steps");
+    lines.push("| Step | Agent | Status | Duration |");
+    lines.push("| --- | --- | --- | --- |");
+    input.steps.forEach((step, i) => {
+        const duration = step.durationMs !== undefined ? formatDuration(step.durationMs) : "-";
+        lines.push(`| ${i + 1} | ${step.agent} | ${step.status} | ${duration} |`);
+    });
+    lines.push("");
+    lines.push("## Summary");
+    if (input.truncated) {
+        lines.push("_Output truncated_");
+        lines.push("");
+    }
+    lines.push(input.summary.trim() || "(no output)");
+    lines.push("");
+    fs.writeFileSync(logPath, lines.join("\n"), "utf-8");
+}
+/** Run a single pi agent step, returning output and metadata */
+async function runSingleStep(step, ctx) {
+    if (step.importAsyncRoot) {
+        let importTimedOut = false;
+        let importStopped = false;
+        ctx.registerTimeout?.(() => {
+            importTimedOut = true;
+            let pid;
+            try {
+                pid = readStatus(step.importAsyncRoot.asyncDir)?.pid;
+            }
+            catch {
+                pid = undefined;
+            }
+            try {
+                deliverTimeoutRequest({ asyncDir: step.importAsyncRoot.asyncDir, pid, source: "ancestor-timeout" });
+            }
+            catch {
+                // The parent runner's own timeout result is authoritative for the attached step.
+            }
+        });
+        ctx.registerStop?.(() => {
+            importStopped = true;
+            let pid;
+            try {
+                pid = readStatus(step.importAsyncRoot.asyncDir)?.pid;
+            }
+            catch {
+                pid = undefined;
+            }
+            try {
+                deliverStopRequest({ asyncDir: step.importAsyncRoot.asyncDir, pid, source: "ancestor-stop" });
+            }
+            catch {
+                // The parent runner's own stopped result is authoritative for the attached step.
+            }
+        });
+        try {
+            const imported = await waitForImportedAsyncRoot(step.importAsyncRoot, {
+                shouldAbort: () => importTimedOut || importStopped || ctx.timeoutSignal?.aborted === true || ctx.stopSignal?.aborted === true || ctx.skipAcceptance?.() === true,
+                timeoutMessage: importStopped || ctx.stopSignal?.aborted === true ? ctx.stopMessage : ctx.timeoutMessage,
+            });
+            try {
+                fs.writeFileSync(ctx.outputFile, imported.output, "utf-8");
+            }
+            catch {
+                // Output files are observability only for imported roots.
+            }
+            const stopped = importStopped || imported.stopped === true || ctx.stopSignal?.aborted === true;
+            const timedOut = !stopped && (importTimedOut || imported.timedOut === true || ctx.timeoutSignal?.aborted === true || ctx.skipAcceptance?.() === true);
+            const message = stopped ? ctx.stopMessage ?? "Subagent stopped by user." : ctx.timeoutMessage ?? "Subagent timed out.";
+            return {
+                agent: imported.agent,
+                output: timedOut || stopped ? message : imported.output,
+                exitCode: timedOut || stopped ? 1 : imported.exitCode,
+                error: timedOut || stopped ? message : imported.error,
+                timedOut: timedOut ? true : undefined,
+                stopped: stopped ? true : undefined,
+                sessionFile: imported.sessionFile,
+                intercomTarget: imported.intercomTarget,
+                model: imported.model,
+                attemptedModels: imported.attemptedModels,
+                modelAttempts: imported.modelAttempts,
+                totalCost: imported.totalCost,
+                structuredOutput: timedOut || stopped ? undefined : imported.structuredOutput,
+                structuredOutputPath: timedOut || stopped ? undefined : imported.structuredOutputPath,
+                structuredOutputSchemaPath: timedOut || stopped ? undefined : imported.structuredOutputSchemaPath,
+                acceptance: timedOut || stopped ? undefined : imported.acceptance,
+            };
+        }
+        finally {
+            ctx.registerTimeout?.(undefined);
+            ctx.registerStop?.(undefined);
+        }
+    }
+    const effectiveStructuredOutput = step.structuredOutput ?? (step.structuredOutputSchema
+        ? createStructuredOutputRuntime(step.structuredOutputSchema, path.join(path.dirname(ctx.outputFile), "structured-output"))
+        : undefined);
+    const placeholderRegex = new RegExp(ctx.placeholder.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "g");
+    let task = step.task.replace(placeholderRegex, () => ctx.previousOutput);
+    if (ctx.outputs)
+        task = resolveOutputReferences(task, ctx.outputs);
+    const taskForCompletionGuard = task;
+    if (step.effectiveAcceptance) {
+        const acceptancePrompt = formatAcceptancePrompt(step.effectiveAcceptance);
+        if (acceptancePrompt)
+            task = `${task}\n${acceptancePrompt}`;
+    }
+    const sessionEnabled = Boolean(step.sessionFile) || ctx.sessionEnabled;
+    const sessionDir = step.sessionFile ? undefined : ctx.sessionDir;
+    let artifactPaths;
+    let transcriptWriter;
+    if (ctx.artifactsDir && ctx.artifactConfig?.enabled !== false) {
+        const index = ctx.flatStepCount > 1 ? ctx.flatIndex : undefined;
+        artifactPaths = getArtifactPaths(ctx.artifactsDir, ctx.id, step.agent, index);
+        fs.mkdirSync(ctx.artifactsDir, { recursive: true });
+        if (ctx.artifactConfig?.includeInput !== false) {
+            fs.writeFileSync(artifactPaths.inputPath, `# Task for ${step.agent}\n\n${task}`, "utf-8");
+        }
+        if (ctx.artifactConfig?.includeTranscript !== false) {
+            transcriptWriter = createChildTranscriptWriter({
+                transcriptPath: artifactPaths.transcriptPath,
+                source: "async",
+                runId: ctx.id,
+                agent: step.agent,
+                childIndex: ctx.flatIndex,
+                cwd: step.cwd ?? ctx.cwd,
+            });
+        }
+    }
+    transcriptWriter?.writeInitialUserMessage(task);
+    const candidates = step.modelCandidates && step.modelCandidates.length > 0
+        ? step.modelCandidates
+        : step.model
+            ? [step.model]
+            : [undefined];
+    const attemptedModels = [];
+    const modelAttempts = [];
+    const attemptNotes = [];
+    const eventsPath = path.join(path.dirname(ctx.outputFile), "events.jsonl");
+    let finalResult;
+    let finalOutputSnapshot;
+    let completionGuardTriggeredFinal = false;
+    let turnBudget = ctx.turnBudget ? initialTurnBudgetState(ctx.turnBudget) : undefined;
+    let toolBudget = step.toolBudget ? initialToolBudgetState(step.toolBudget) : undefined;
+    let toolBudgetBlocked = false;
+    for (let index = 0; index < candidates.length; index++) {
+        if (ctx.timeoutSignal?.aborted || ctx.skipAcceptance?.())
+            break;
+        const candidate = candidates[index];
+        ctx.onAttemptStart?.({ model: candidate, thinking: resolveEffectiveThinking(candidate, step.thinking) });
+        const outputSnapshot = captureSingleOutputSnapshot(step.outputPath);
+        if (effectiveStructuredOutput) {
+            try {
+                if (fs.existsSync(effectiveStructuredOutput.outputPath))
+                    fs.unlinkSync(effectiveStructuredOutput.outputPath);
+            }
+            catch {
+                // Missing/stale structured-output files are handled after the child exits.
+            }
+        }
+        const watchdogConfig = resolveWatchdogConfig(step.cwd ?? ctx.cwd);
+        const childWatchdog = watchdogConfig.ok
+            ? resolveChildWatchdogConfig({
+                config: watchdogConfig.config,
+                agent: step.agent,
+                runId: ctx.id,
+                childIndex: ctx.flatIndex,
+            })
+            : undefined;
+        const parentPermissionMode = step.parentPermissionMode ?? snapshotParentPermissionMode(step.parentSessionId);
+        const childPermission = step.permissions === "read-only" || parentPermissionMode === "plan" ? "read-only" : "full";
+        const excludeTools = resolveChildExcludeTools({
+            permissions: childPermission,
+            fanoutAuthorized: Array.isArray(step.tools) && step.tools.includes("subagent"),
+        });
+        const { args, env, tempDir, toolDiagnosticPath } = buildPiArgs({
+            parentSessionId: step.parentSessionId,
+            baseArgs: ["--mode", "json", "-p"],
+            task,
+            sessionEnabled,
+            sessionDir,
+            sessionFile: step.sessionFile,
+            model: candidate,
+            inheritProjectContext: true,
+            inheritSkills: false,
+            requireReadTool: Boolean(step.skills?.length),
+            excludeTools,
+            childPermission,
+            childId: step.childId ?? step.agent,
+            childDescription: step.description ?? step.agent,
+            systemPrompt: appendTurnBudgetSystemPrompt(step.systemPrompt && !step.systemPrompt.includes("You are `") ? step.systemPrompt : "", ctx.turnBudget) || undefined,
+            systemPromptMode: "append",
+            cwd: step.cwd ?? ctx.cwd,
+            promptFileStem: step.childId ?? step.agent,
+            intercomSessionName: ctx.childIntercomTarget,
+            orchestratorIntercomTarget: ctx.orchestratorIntercomTarget,
+            runId: ctx.id,
+            childAgentName: step.childId ?? step.agent,
+            childIndex: ctx.flatIndex,
+            parentEventSink: ctx.nestedRoute?.eventSink,
+            parentControlInbox: ctx.nestedRoute?.controlInbox,
+            parentRootRunId: ctx.nestedRoute?.rootRunId,
+            parentCapabilityToken: ctx.nestedRoute?.capabilityToken,
+            steerInboxDir: ctx.steerInboxDir,
+            steerCapabilityPath: ctx.steerCapabilityPath,
+            steerAckDir: ctx.steerAckDir,
+            structuredOutput: effectiveStructuredOutput,
+            toolBudget: step.toolBudget,
+            childWatchdog,
+            waitToolEnabled: step.waitToolEnabled,
+            parentPermissionMode,
+        });
+        const run = await runPiStreaming(args, step.cwd ?? ctx.cwd, ctx.outputFile, env, ctx.piPackageRoot, ctx.piArgv1, step.maxSubagentDepth, { eventsPath, runId: ctx.id, stepIndex: ctx.flatIndex, agent: step.agent }, ctx.registerInterrupt, ctx.onChildEvent, transcriptWriter, ctx.registerTimeout, ctx.timeoutMessage, ctx.registerStop, ctx.stopMessage, ctx.registerTurnBudgetAbort, ctx.onWriterProcess);
+        if (run.turnBudget)
+            turnBudget = run.turnBudget;
+        else if (ctx.turnBudget) {
+            const assistantMessages = run.messages.filter((message) => message.role === "assistant");
+            const turnCount = assistantMessages.length;
+            const lastAssistantMessage = assistantMessages.at(-1);
+            if (turnCount > 0 && turnCount < ctx.turnBudget.maxTurns) {
+                turnBudget = { ...ctx.turnBudget, outcome: "within-budget", turnCount };
+            }
+            else if (turnCount >= ctx.turnBudget.maxTurns) {
+                turnBudget = turnBudgetState(ctx.turnBudget, turnCount, shouldAbortForTurnBudget(ctx.turnBudget, turnCount, lastAssistantMessage ? isTerminalAssistantStop(lastAssistantMessage) : false));
+            }
+        }
+        const toolAvailabilityError = run.exitCode === 0 && !run.error
+            ? readChildToolDiagnosticError(toolDiagnosticPath)
+            : undefined;
+        cleanupTempDir(tempDir);
+        const hiddenError = run.exitCode === 0 && !run.error && !toolAvailabilityError ? detectSubagentError(run.messages) : null;
+        const missingStructuredOutput = effectiveStructuredOutput
+            ? !fs.existsSync(effectiveStructuredOutput.outputPath)
+            : false;
+        const emptyOutputError = run.exitCode === 0 && !run.error && !toolAvailabilityError && !hiddenError?.hasError && !run.finalOutput.trim() && (!effectiveStructuredOutput || missingStructuredOutput)
+            ? "Subagent produced no output (possible model cold-start or empty response)."
+            : undefined;
+        let structuredOutput;
+        let structuredError;
+        if (effectiveStructuredOutput && run.exitCode === 0 && !run.error && !toolAvailabilityError && !hiddenError?.hasError && !emptyOutputError) {
+            const structured = readStructuredOutput({
+                schema: effectiveStructuredOutput.schema,
+                schemaPath: effectiveStructuredOutput.schemaPath,
+                outputPath: effectiveStructuredOutput.outputPath,
+            });
+            if (structured.error)
+                structuredError = structured.error;
+            else
+                structuredOutput = structured.value;
+        }
+        const completionGuard = run.exitCode === 0 && !run.error && !toolAvailabilityError && !hiddenError?.hasError && !emptyOutputError && step.completionGuard !== false
+            ? evaluateCompletionMutationGuard({
+                agent: step.agent,
+                task: taskForCompletionGuard,
+                messages: run.messages,
+                tools: step.tools,
+                mcpDirectTools: step.mcpDirectTools,
+            })
+            : undefined;
+        const completionGuardTriggered = completionGuard?.triggered === true && !run.observedMutationAttempt;
+        const completionGuardError = completionGuardTriggered
+            ? "Subagent completed without making edits for an implementation task.\nIt appears to have returned planning or scratchpad output instead of applying changes."
+            : undefined;
+        const effectiveExitCode = toolAvailabilityError || completionGuardTriggered || structuredError
+            ? 1
+            : hiddenError?.hasError
+                ? (hiddenError.exitCode ?? 1)
+                : emptyOutputError
+                    ? 1
+                    : run.error && run.exitCode === 0
+                        ? 1
+                        : run.exitCode;
+        const error = toolAvailabilityError
+            ?? completionGuardError
+            ?? structuredError
+            ?? (hiddenError?.hasError
+                ? hiddenError.details
+                    ? `${hiddenError.errorType} failed (exit ${effectiveExitCode}): ${hiddenError.details}`
+                    : `${hiddenError.errorType} failed with exit code ${effectiveExitCode}`
+                : emptyOutputError ?? (run.error || (run.exitCode !== 0 && run.stderr.trim() ? run.stderr.trim() : undefined)));
+        const attempt = {
+            model: candidate ?? run.model ?? step.model ?? "default",
+            success: effectiveExitCode === 0 && !error,
+            exitCode: effectiveExitCode,
+            error,
+            usage: run.usage,
+        };
+        modelAttempts.push(attempt);
+        if (candidate)
+            attemptedModels.push(candidate);
+        completionGuardTriggeredFinal = completionGuardTriggered;
+        finalOutputSnapshot = outputSnapshot;
+        if (step.toolBudget) {
+            const toolMessages = run.messages.filter((message) => message.role === "toolResult");
+            const blockedMessage = toolMessages.find((message) => extractTextFromContent(message.content).includes("Tool budget hard limit reached"));
+            toolBudgetBlocked = Boolean(blockedMessage);
+            toolBudget = toolBudgetState(step.toolBudget, toolMessages.length, blockedMessage ? blockedMessage.toolName : undefined);
+        }
+        finalResult = { ...run, exitCode: effectiveExitCode, model: candidate ?? run.model, error, structuredOutput };
+        if (run.turnBudgetExceeded)
+            break;
+        if (run.stopped || run.timedOut || ctx.timeoutSignal?.aborted || ctx.stopSignal?.aborted || ctx.skipAcceptance?.())
+            break;
+        if (attempt.success || completionGuardTriggered)
+            break;
+        if (!isRetryableModelFailure(error) || index === candidates.length - 1)
+            break;
+        attemptNotes.push(formatModelAttemptNote(attempt, candidates[index + 1]));
+    }
+    const rawOutput = finalResult?.finalOutput ?? "";
+    const outputForPersistence = stripAcceptanceReport(rawOutput);
+    const resolvedOutput = step.outputPath && finalResult?.exitCode === 0
+        ? resolveSingleOutput(step.outputPath, outputForPersistence, finalOutputSnapshot)
+        : { fullOutput: outputForPersistence };
+    const output = stripAcceptanceReport(resolvedOutput.fullOutput);
+    const outputReference = resolvedOutput.savedPath ? formatSavedOutputReference(resolvedOutput.savedPath, output) : undefined;
+    let outputForSummary = output;
+    if (attemptNotes.length > 0) {
+        outputForSummary = `${attemptNotes.join("\n")}\n\n${outputForSummary}`.trim();
+    }
+    if (finalResult?.stopped && !outputForSummary.trim()) {
+        outputForSummary = ctx.stopMessage ?? "Subagent stopped by user.";
+    }
+    else if (!finalResult?.timedOut && !finalResult?.stopped && finalResult?.turnBudgetExceeded && turnBudget) {
+        outputForSummary = formatTurnBudgetOutput(turnBudgetExceededMessage(turnBudget, turnBudget.turnCount), outputForSummary);
+    }
+    else if (!finalResult?.timedOut && !finalResult?.stopped && turnBudget?.outcome === "wrap-up-requested") {
+        const note = turnBudgetSoftNote(turnBudget, turnBudget.wrapUpRequestedAtTurn ?? turnBudget.turnCount);
+        outputForSummary = outputForSummary.trim() ? `${note}\n\n${outputForSummary}` : note;
+    }
+    const outputForAcceptance = rawOutput;
+    const childWrittenOutput = step.outputPath
+        ? extractChildWrittenOutput(finalResult?.messages, step.outputPath, step.cwd ?? ctx.cwd)
+        : undefined;
+    const finalizedOutput = finalizeSingleOutput({
+        fullOutput: outputForSummary,
+        outputPath: step.outputPath,
+        outputMode: step.outputMode,
+        exitCode: finalResult?.exitCode ?? 1,
+        savedPath: resolvedOutput.savedPath,
+        outputReference,
+        saveError: resolvedOutput.saveError,
+    });
+    outputForSummary = finalizedOutput.displayOutput;
+    const acceptance = step.effectiveAcceptance && !finalResult?.stopped && !finalResult?.turnBudgetExceeded && !ctx.timeoutSignal?.aborted && !ctx.stopSignal?.aborted && !ctx.skipAcceptance?.()
+        ? await evaluateAcceptance({
+            acceptance: step.effectiveAcceptance,
+            output: outputForAcceptance,
+            fileOutput: childWrittenOutput !== undefined && step.outputPath
+                ? { content: childWrittenOutput, path: step.outputPath, authoritative: step.outputMode === "file-only" }
+                : undefined,
+            cwd: step.cwd ?? ctx.cwd,
+            signal: combinedAbortSignal([ctx.timeoutSignal, ctx.stopSignal]),
+            abortMessage: ctx.stopSignal?.aborted ? ctx.stopMessage ?? "Subagent stopped by user." : ctx.timeoutMessage ?? "Subagent timed out.",
+        })
+        : undefined;
+    const stoppedAfterAcceptance = finalResult?.stopped === true || ctx.stopSignal?.aborted === true;
+    const timedOutAfterAcceptance = !stoppedAfterAcceptance && (finalResult?.timedOut === true || ctx.timeoutSignal?.aborted === true);
+    const turnBudgetExceeded = finalResult?.turnBudgetExceeded === true;
+    const effectiveAcceptance = step.effectiveAcceptance
+        ? stoppedAfterAcceptance
+            ? buildSkippedAcceptanceLedger(step.effectiveAcceptance, { id: "stopped", message: "Acceptance was not evaluated because the subagent was stopped." })
+            : timedOutAfterAcceptance
+                ? buildSkippedAcceptanceLedger(step.effectiveAcceptance, { id: "timeout", message: "Acceptance was not evaluated because the subagent timed out." })
+                : turnBudgetExceeded
+                    ? buildSkippedAcceptanceLedger(step.effectiveAcceptance, { id: "turn-budget", message: "Acceptance was not evaluated because the subagent exceeded its turn budget." })
+                    : acceptance
+        : undefined;
+    const acceptanceFailure = effectiveAcceptance ? acceptanceFailureMessage(effectiveAcceptance) : undefined;
+    const acceptanceCanFailRun = acceptanceFailure && effectiveAcceptance?.explicit && (finalResult?.exitCode ?? 1) === 0 && !finalResult?.interrupted && !timedOutAfterAcceptance && !stoppedAfterAcceptance && !turnBudgetExceeded;
+    const effectiveFinalExitCode = timedOutAfterAcceptance || stoppedAfterAcceptance || turnBudgetExceeded ? 1 : acceptanceCanFailRun ? 1 : finalResult?.exitCode ?? 1;
+    const effectiveFinalError = stoppedAfterAcceptance
+        ? ctx.stopMessage ?? "Subagent stopped by user."
+        : timedOutAfterAcceptance
+            ? ctx.timeoutMessage ?? "Subagent timed out."
+            : turnBudgetExceeded
+                ? finalResult?.error ?? (turnBudget ? turnBudgetExceededMessage(turnBudget, turnBudget.turnCount) : "Subagent exceeded turn budget.")
+                : acceptanceCanFailRun
+                    ? (finalResult?.error ? `${finalResult.error}\n${acceptanceFailure}` : acceptanceFailure)
+                    : finalResult?.error;
+    if (artifactPaths && ctx.artifactConfig?.enabled !== false) {
+        if (ctx.artifactConfig?.includeOutput !== false) {
+            fs.writeFileSync(artifactPaths.outputPath, output, "utf-8");
+        }
+        if (ctx.artifactConfig?.includeMetadata !== false) {
+            fs.writeFileSync(artifactPaths.metadataPath, JSON.stringify({
+                runId: ctx.id,
+                agent: step.agent,
+                task,
+                exitCode: effectiveFinalExitCode,
+                model: finalResult?.model,
+                attemptedModels: attemptedModels.length > 0 ? attemptedModels : undefined,
+                modelAttempts,
+                error: effectiveFinalError,
+                acceptance: effectiveAcceptance,
+                ...(transcriptWriter ? { transcriptPath: artifactPaths.transcriptPath } : {}),
+                transcriptError: transcriptWriter?.getError(),
+                skills: step.skills,
+                timestamp: Date.now(),
+            }, null, 2), "utf-8");
+        }
+    }
+    return {
+        childId: step.childId,
+        description: step.description,
+        permissions: step.permissions,
+        agent: step.agent,
+        output: outputForSummary,
+        exitCode: effectiveFinalExitCode,
+        error: effectiveFinalError,
+        protocolError: finalResult?.protocolError,
+        sessionFile: step.sessionFile,
+        intercomTarget: ctx.childIntercomTarget,
+        model: finalResult?.model,
+        attemptedModels: attemptedModels.length > 0 ? attemptedModels : undefined,
+        modelAttempts,
+        totalCost: costSummaryFromAttempts(modelAttempts),
+        artifactPaths,
+        transcriptPath: transcriptWriter ? artifactPaths?.transcriptPath : undefined,
+        transcriptError: transcriptWriter?.getError(),
+        interrupted: timedOutAfterAcceptance || stoppedAfterAcceptance || turnBudgetExceeded ? false : finalResult?.interrupted,
+        timedOut: timedOutAfterAcceptance ? true : finalResult?.timedOut,
+        stopped: stoppedAfterAcceptance ? true : finalResult?.stopped,
+        turnBudget,
+        turnBudgetExceeded: turnBudgetExceeded || undefined,
+        wrapUpRequested: finalResult?.wrapUpRequested || turnBudget?.outcome === "wrap-up-requested" || turnBudgetExceeded || undefined,
+        toolBudget,
+        toolBudgetBlocked: toolBudgetBlocked || undefined,
+        completionGuardTriggered: completionGuardTriggeredFinal,
+        structuredOutput: timedOutAfterAcceptance || stoppedAfterAcceptance || turnBudgetExceeded ? undefined : finalResult?.structuredOutput,
+        structuredOutputPath: timedOutAfterAcceptance || stoppedAfterAcceptance || turnBudgetExceeded ? undefined : effectiveStructuredOutput?.outputPath,
+        structuredOutputSchemaPath: timedOutAfterAcceptance || stoppedAfterAcceptance || turnBudgetExceeded ? undefined : effectiveStructuredOutput?.schemaPath,
+        acceptance: effectiveAcceptance,
+        watchdog: finalResult?.watchdog,
+    };
+}
+function markParallelGroupSetupFailure(input) {
+    for (let taskIndex = 0; taskIndex < input.group.parallel.length; taskIndex++) {
+        const flatTaskIndex = input.groupStartFlatIndex + taskIndex;
+        input.statusPayload.steps[flatTaskIndex].status = "failed";
+        input.statusPayload.steps[flatTaskIndex].startedAt = input.failedAt;
+        input.statusPayload.steps[flatTaskIndex].endedAt = input.failedAt;
+        input.statusPayload.steps[flatTaskIndex].durationMs = 0;
+        input.statusPayload.steps[flatTaskIndex].exitCode = 1;
+        input.results.push({ agent: input.group.parallel[taskIndex].agent, output: input.setupError, success: false, exitCode: 1, sessionFile: input.group.parallel[taskIndex].sessionFile });
+    }
+    input.statusPayload.currentStep = input.groupStartFlatIndex;
+    input.statusPayload.lastUpdate = input.failedAt;
+    input.statusPayload.outputFile = path.join(input.asyncDir, `output-${input.groupStartFlatIndex}.log`);
+    writeAtomicJson(input.statusPath, input.statusPayload);
+    appendJsonl(input.eventsPath, JSON.stringify({
+        type: "subagent.parallel.completed",
+        ts: input.failedAt,
+        runId: input.runId,
+        stepIndex: input.stepIndex,
+        success: false,
+    }));
+}
+function markParallelGroupRunning(input) {
+    for (let taskIndex = 0; taskIndex < input.group.parallel.length; taskIndex++) {
+        const flatTaskIndex = input.groupStartFlatIndex + taskIndex;
+        input.statusPayload.steps[flatTaskIndex].status = "pending";
+        input.statusPayload.steps[flatTaskIndex].startedAt = undefined;
+        input.statusPayload.steps[flatTaskIndex].endedAt = undefined;
+        input.statusPayload.steps[flatTaskIndex].durationMs = undefined;
+        input.statusPayload.steps[flatTaskIndex].lastActivityAt = undefined;
+        input.statusPayload.steps[flatTaskIndex].activityState = undefined;
+        input.statusPayload.steps[flatTaskIndex].error = undefined;
+    }
+    input.statusPayload.currentStep = input.groupStartFlatIndex;
+    input.statusPayload.activityState = undefined;
+    input.statusPayload.lastActivityAt = input.groupStartTime;
+    input.statusPayload.lastUpdate = input.groupStartTime;
+    input.statusPayload.outputFile = path.join(input.asyncDir, `output-${input.groupStartFlatIndex}.log`);
+    writeAtomicJson(input.statusPath, input.statusPayload);
+    appendJsonl(input.eventsPath, JSON.stringify({
+        type: "subagent.parallel.started",
+        ts: input.groupStartTime,
+        runId: input.runId,
+        stepIndex: input.stepIndex,
+        agents: input.group.parallel.map((task) => task.agent),
+        count: input.group.parallel.length,
+    }));
+}
+function prepareParallelTaskRun(task, cwd, worktreeSetup, taskIndex) {
+    if (!worktreeSetup)
+        return { taskForRun: task, taskCwd: cwd };
+    return {
+        taskForRun: { ...task, cwd: undefined },
+        taskCwd: worktreeSetup.worktrees[taskIndex].agentCwd,
+    };
+}
+function appendParallelWorktreeSummary(previousOutput, worktreeSetup, asyncDir, stepIndex, group) {
+    if (!worktreeSetup)
+        return previousOutput;
+    const diffsDir = path.join(asyncDir, "worktree-diffs", `step-${stepIndex}`);
+    const diffs = diffWorktrees(worktreeSetup, group.parallel.map((task) => task.agent), diffsDir);
+    const diffSummary = formatWorktreeDiffSummary(diffs);
+    if (!diffSummary)
+        return previousOutput;
+    return `${previousOutput}\n\n${diffSummary}`;
+}
+function ensureParallelProgressFile(cwd, group) {
+    const progressPath = path.join(cwd, "progress.md");
+    if (!group.parallel.some((task) => task.task.includes(`Update progress at: ${progressPath}`)))
+        return;
+    writeInitialProgressFile(cwd);
+}
+function resolveAsyncStepTranscriptPath(input) {
+    if (!input.artifactsDir || input.artifactConfig?.enabled === false || input.artifactConfig?.includeTranscript === false)
+        return undefined;
+    return getArtifactPaths(input.artifactsDir, input.runId, input.agent, input.flatStepCount > 1 ? input.flatIndex : undefined).transcriptPath;
+}
+function combinedAbortSignal(signals) {
+    const activeSignals = signals.filter((signal) => Boolean(signal));
+    if (activeSignals.length === 0)
+        return undefined;
+    if (activeSignals.length === 1)
+        return activeSignals[0];
+    const controller = new AbortController();
+    const abort = () => controller.abort();
+    for (const signal of activeSignals) {
+        if (signal.aborted) {
+            abort();
+            break;
+        }
+        signal.addEventListener("abort", abort, { once: true });
+    }
+    return controller.signal;
+}
+async function runSubagent(config, onWriterProcess) {
+    const { id, steps, resultPath, cwd, placeholder, taskIndex, totalTasks, maxOutput, artifactsDir, artifactConfig } = config;
+    const globalSemaphore = new Semaphore(config.globalConcurrencyLimit ?? DEFAULT_GLOBAL_CONCURRENCY_LIMIT);
+    let previousOutput = "";
+    const outputs = {};
+    const results = [];
+    const overallStartTime = Date.now();
+    const shareEnabled = config.share === true;
+    const asyncDir = config.asyncDir;
+    const statusPath = path.join(asyncDir, "status.json");
+    const eventsPath = path.join(asyncDir, "events.jsonl");
+    const logPath = path.join(asyncDir, `subagent-log-${id}.md`);
+    const controlConfig = config.controlConfig ?? DEFAULT_CONTROL_CONFIG;
+    const activeChildInterrupts = new Map();
+    const activeChildTimeouts = new Map();
+    const activeChildStops = new Map();
+    const activeChildTurnBudgetAborts = new Map();
+    const pendingStepSteers = [];
+    const steeringCapabilities = new Map();
+    let interrupted = false;
+    let currentActivityState;
+    let activityTimer;
+    let timeoutTimer;
+    let timedOut = false;
+    let stopped = false;
+    let turnBudgetExceeded = false;
+    const timeoutMessage = config.timeoutMs !== undefined ? `Subagent timed out after ${config.timeoutMs}ms.` : undefined;
+    const stopMessage = "Subagent stopped by user.";
+    const timeoutAbortController = new AbortController();
+    const stopAbortController = new AbortController();
+    let previousCumulativeTokens = { input: 0, output: 0, total: 0 };
+    let latestSessionFile;
+    const flatSteps = flattenSteps(steps);
+    const initialFlatStepCount = flatSteps.length;
+    const parallelGroups = [];
+    const initialStatusSteps = [];
+    let flatStepCount = 0;
+    for (let stepIndex = 0; stepIndex < steps.length; stepIndex++) {
+        const step = steps[stepIndex];
+        if (isParallelGroup(step)) {
+            parallelGroups.push({ start: flatStepCount, count: step.parallel.length, stepIndex });
+            for (const task of step.parallel) {
+                const taskFlatIndex = flatStepCount;
+                const transcriptPath = resolveAsyncStepTranscriptPath({ artifactsDir, artifactConfig, runId: id, agent: task.agent, flatIndex: taskFlatIndex, flatStepCount: initialFlatStepCount });
+                initialStatusSteps.push({
+                    childId: task.childId,
+                    description: task.description,
+                    permissions: task.permissions,
+                    agent: task.agent,
+                    phase: task.phase,
+                    label: task.label,
+                    outputName: task.outputName,
+                    structured: task.structured,
+                    status: "pending",
+                    ...(task.toolBudget ? { toolBudget: initialToolBudgetState(task.toolBudget) } : {}),
+                    ...(task.sessionFile ? { sessionFile: task.sessionFile } : {}),
+                    ...(transcriptPath ? { transcriptPath } : {}),
+                    skills: task.skills,
+                    model: task.model,
+                    thinking: task.thinking,
+                    attemptedModels: task.modelCandidates && task.modelCandidates.length > 0 ? task.modelCandidates : task.model ? [task.model] : undefined,
+                    recentTools: [],
+                    recentOutput: [],
+                });
+                flatStepCount++;
+            }
+        }
+        else if (isDynamicRunnerGroup(step)) {
+            parallelGroups.push({ start: flatStepCount, count: 1, stepIndex });
+            initialStatusSteps.push({
+                agent: `expand:${step.parallel.agent}`,
+                phase: step.phase ?? step.parallel.phase,
+                label: step.label ?? step.parallel.label ?? `Dynamic fanout (${step.collect.as})`,
+                outputName: step.collect.as,
+                structured: Boolean(step.collect.outputSchema),
+                status: "pending",
+                ...(step.parallel.toolBudget ? { toolBudget: initialToolBudgetState(step.parallel.toolBudget) } : {}),
+                recentTools: [],
+                recentOutput: [],
+            });
+            flatStepCount++;
+        }
+        else {
+            const stepFlatIndex = flatStepCount;
+            const transcriptPath = resolveAsyncStepTranscriptPath({ artifactsDir, artifactConfig, runId: id, agent: step.agent, flatIndex: stepFlatIndex, flatStepCount: initialFlatStepCount });
+            initialStatusSteps.push({
+                childId: step.childId,
+                description: step.description,
+                permissions: step.permissions,
+                agent: step.agent,
+                phase: step.phase,
+                label: step.label,
+                outputName: step.outputName,
+                structured: step.structured,
+                status: "pending",
+                ...(step.toolBudget ? { toolBudget: initialToolBudgetState(step.toolBudget) } : {}),
+                ...(step.sessionFile ? { sessionFile: step.sessionFile } : {}),
+                ...(transcriptPath ? { transcriptPath } : {}),
+                skills: step.skills,
+                model: step.model,
+                thinking: step.thinking,
+                attemptedModels: step.modelCandidates && step.modelCandidates.length > 0 ? step.modelCandidates : step.model ? [step.model] : undefined,
+                recentTools: [],
+                recentOutput: [],
+            });
+            flatStepCount++;
+        }
+    }
+    const sessionEnabled = Boolean(config.sessionDir)
+        || shareEnabled
+        || flatSteps.some((step) => Boolean(step.sessionFile));
+    const statusPayload = {
+        lifecycleArtifactVersion: SUBAGENT_LIFECYCLE_ARTIFACT_VERSION,
+        runId: id,
+        ...(config.sessionId ? { sessionId: config.sessionId } : {}),
+        mode: config.resultMode ?? (flatSteps.length > 1 ? "chain" : "single"),
+        ...(config.nestedRoute ? { isNested: true } : {}),
+        state: "running",
+        steering: createSteeringStatus(),
+        lastActivityAt: overallStartTime,
+        startedAt: overallStartTime,
+        lastUpdate: overallStartTime,
+        ...(config.timeoutMs !== undefined ? { timeoutMs: config.timeoutMs } : {}),
+        ...(config.deadlineAt !== undefined ? { deadlineAt: config.deadlineAt } : {}),
+        ...(config.turnBudget ? { turnBudget: initialTurnBudgetState(config.turnBudget) } : {}),
+        ...(config.toolBudget ? { toolBudget: initialToolBudgetState(config.toolBudget) } : {}),
+        pid: process.pid,
+        cwd,
+        currentStep: 0,
+        chainStepCount: steps.length,
+        parallelGroups,
+        workflowGraph: config.workflowGraph,
+        steps: initialStatusSteps,
+        artifactsDir,
+        sessionDir: config.sessionDir,
+        outputFile: path.join(asyncDir, "output-0.log"),
+    };
+    fs.mkdirSync(asyncDir, { recursive: true });
+    writeAtomicJson(statusPath, statusPayload);
+    const emitNestedSelfEvent = (type) => {
+        if (!config.nestedRoute || !config.nestedSelf)
+            return;
+        try {
+            writeNestedEvent(config.nestedRoute, {
+                type,
+                ts: Date.now(),
+                parentRunId: config.nestedSelf.parentRunId,
+                parentStepIndex: config.nestedSelf.parentStepIndex,
+                child: nestedSummaryFromAsyncStatus(statusPayload, asyncDir, {
+                    id,
+                    parentRunId: config.nestedSelf.parentRunId,
+                    parentStepIndex: config.nestedSelf.parentStepIndex,
+                    depth: config.nestedSelf.depth,
+                    path: config.nestedSelf.path,
+                    mode: statusPayload.mode,
+                    ts: Date.now(),
+                }),
+            });
+        }
+        catch (error) {
+            console.error("Failed to emit nested async status event:", error);
+        }
+    };
+    const refreshWorkflowGraph = () => {
+        if (!config.workflowGraph)
+            return;
+        const graph = structuredClone(statusPayload.workflowGraph ?? config.workflowGraph);
+        const normalize = (status) => {
+            if (status === "complete" || status === "completed")
+                return "completed";
+            if (status === "running" || status === "failed" || status === "paused" || status === "stopped" || status === "pending")
+                return status;
+            return "pending";
+        };
+        const updateNode = (node) => {
+            if (node.flatIndex !== undefined) {
+                const step = statusPayload.steps[node.flatIndex];
+                if (step) {
+                    node.status = normalize(step.status);
+                    node.error = step.error;
+                    node.acceptanceStatus = step.acceptance?.status;
+                }
+                if (statusPayload.currentStep === node.flatIndex)
+                    graph.currentNodeId = node.id;
+            }
+            for (const child of node.children ?? [])
+                updateNode(child);
+            if (node.children?.length) {
+                if (node.children.every((child) => child.status === "completed"))
+                    node.status = "completed";
+                else if (node.children.some((child) => child.status === "running"))
+                    node.status = "running";
+                else if (node.children.some((child) => child.status === "stopped"))
+                    node.status = "stopped";
+                else if (node.children.some((child) => child.status === "failed"))
+                    node.status = "failed";
+                else if (node.children.some((child) => child.status === "paused"))
+                    node.status = "paused";
+            }
+            if (node.error && node.status !== "stopped")
+                node.status = "failed";
+        };
+        for (const node of graph.nodes)
+            updateNode(node);
+        statusPayload.workflowGraph = graph;
+    };
+    const writeStatusPayload = () => {
+        refreshWorkflowGraph();
+        writeAtomicJson(statusPath, statusPayload);
+        emitNestedSelfEvent(statusPayload.state === "running" || statusPayload.state === "queued" ? "subagent.nested.updated" : "subagent.nested.completed");
+    };
+    const registerStepInterrupt = (flatIndex, interrupt) => {
+        if (!interrupt) {
+            activeChildInterrupts.delete(flatIndex);
+            return;
+        }
+        activeChildInterrupts.set(flatIndex, interrupt);
+        if (interrupted)
+            interrupt();
+    };
+    const registerStepTimeout = (flatIndex, interrupt) => {
+        if (!interrupt) {
+            activeChildTimeouts.delete(flatIndex);
+            return;
+        }
+        activeChildTimeouts.set(flatIndex, interrupt);
+        if (timedOut)
+            interrupt();
+    };
+    const registerStepStop = (flatIndex, stop) => {
+        if (!stop) {
+            activeChildStops.delete(flatIndex);
+            return;
+        }
+        activeChildStops.set(flatIndex, stop);
+        if (stopped)
+            stop();
+    };
+    const registerStepTurnBudgetAbort = (flatIndex, abort) => {
+        if (!abort) {
+            activeChildTurnBudgetAborts.delete(flatIndex);
+            return;
+        }
+        activeChildTurnBudgetAborts.set(flatIndex, abort);
+    };
+    const interruptActiveChildren = () => {
+        for (const interrupt of [...activeChildInterrupts.values()])
+            interrupt();
+    };
+    const timeoutActiveChildren = () => {
+        for (const interrupt of [...activeChildTimeouts.values()])
+            interrupt();
+    };
+    const stopActiveChildren = () => {
+        for (const stop of [...activeChildStops.values()])
+            stop();
+    };
+    const nestedRuns = function* (children) {
+        for (const child of children ?? []) {
+            yield child;
+            yield* nestedRuns(child.children);
+            yield* nestedRuns(child.steps?.flatMap((step) => step.children ?? []));
+        }
+    };
+    const interruptNestedAsyncDescendants = () => {
+        if (!config.nestedRoute)
+            return;
+        let registry;
+        try {
+            registry = projectNestedEvents(config.nestedRoute);
+        }
+        catch (error) {
+            appendJsonl(eventsPath, JSON.stringify({
+                type: "subagent.nested.interrupt_failed",
+                ts: Date.now(),
+                runId: id,
+                message: error instanceof Error ? error.message : String(error),
+            }));
+            return;
+        }
+        for (const run of nestedRuns(registry.children)) {
+            if (run.state !== "running" && run.state !== "queued")
+                continue;
+            const nestedAsyncDir = run.asyncDir ?? resolveNestedAsyncDir(config.nestedRoute.rootRunId, run);
+            if (!nestedAsyncDir)
+                continue;
+            try {
+                deliverInterruptRequest({ asyncDir: nestedAsyncDir, pid: run.pid, source: "ancestor-interrupt" });
+            }
+            catch (error) {
+                appendJsonl(eventsPath, JSON.stringify({
+                    type: "subagent.nested.interrupt_failed",
+                    ts: Date.now(),
+                    runId: id,
+                    targetRunId: run.id,
+                    message: error instanceof Error ? error.message : String(error),
+                }));
+            }
+        }
+    };
+    const stopNestedAsyncDescendants = () => {
+        if (!config.nestedRoute)
+            return;
+        let registry;
+        try {
+            registry = projectNestedEvents(config.nestedRoute);
+        }
+        catch (error) {
+            appendJsonl(eventsPath, JSON.stringify({
+                type: "subagent.nested.stop_failed",
+                ts: Date.now(),
+                runId: id,
+                message: error instanceof Error ? error.message : String(error),
+            }));
+            return;
+        }
+        for (const run of nestedRuns(registry.children)) {
+            if (run.state !== "running" && run.state !== "queued")
+                continue;
+            const nestedAsyncDir = run.asyncDir ?? resolveNestedAsyncDir(config.nestedRoute.rootRunId, run);
+            if (!nestedAsyncDir)
+                continue;
+            try {
+                deliverStopRequest({ asyncDir: nestedAsyncDir, pid: run.pid, source: "ancestor-stop" });
+            }
+            catch (error) {
+                appendJsonl(eventsPath, JSON.stringify({
+                    type: "subagent.nested.stop_failed",
+                    ts: Date.now(),
+                    runId: id,
+                    targetRunId: run.id,
+                    message: error instanceof Error ? error.message : String(error),
+                }));
+            }
+        }
+    };
+    const timeoutNestedAsyncDescendants = () => {
+        if (!config.nestedRoute)
+            return;
+        let registry;
+        try {
+            registry = projectNestedEvents(config.nestedRoute);
+        }
+        catch (error) {
+            appendJsonl(eventsPath, JSON.stringify({
+                type: "subagent.nested.timeout_failed",
+                ts: Date.now(),
+                runId: id,
+                message: error instanceof Error ? error.message : String(error),
+            }));
+            return;
+        }
+        for (const run of nestedRuns(registry.children)) {
+            if (run.state !== "running" && run.state !== "queued")
+                continue;
+            const nestedAsyncDir = run.asyncDir ?? resolveNestedAsyncDir(config.nestedRoute.rootRunId, run);
+            if (!nestedAsyncDir)
+                continue;
+            try {
+                deliverTimeoutRequest({ asyncDir: nestedAsyncDir, pid: run.pid, source: "ancestor-timeout" });
+            }
+            catch (error) {
+                appendJsonl(eventsPath, JSON.stringify({
+                    type: "subagent.nested.timeout_failed",
+                    ts: Date.now(),
+                    runId: id,
+                    targetRunId: run.id,
+                    message: error instanceof Error ? error.message : String(error),
+                }));
+            }
+        }
+    };
+    const pausedStepResult = (agent) => ({
+        agent,
+        output: "Paused after interrupt. Waiting for explicit next action.",
+        exitCode: 0,
+        interrupted: true,
+    });
+    const timedOutStepResult = (agent) => ({
+        agent,
+        output: timeoutMessage ?? "Subagent timed out.",
+        error: timeoutMessage ?? "Subagent timed out.",
+        exitCode: 1,
+        timedOut: true,
+    });
+    const stoppedStepResult = (agent) => ({
+        agent,
+        output: stopMessage,
+        error: stopMessage,
+        exitCode: 1,
+        stopped: true,
+    });
+    const consumePendingAppendRequests = () => {
+        if (statusPayload.mode !== "chain" || statusPayload.state !== "running")
+            return;
+        const requests = consumeChainAppendRequests(asyncDir);
+        if (requests.length === 0) {
+            const pendingAppends = countPendingChainAppendRequests(asyncDir);
+            if ((statusPayload.pendingAppends ?? 0) !== pendingAppends) {
+                statusPayload.pendingAppends = pendingAppends;
+                statusPayload.lastUpdate = Date.now();
+                writeStatusPayload();
+            }
+            return;
+        }
+        const appendedSteps = requests.flatMap((request) => request.steps);
+        steps.push(...appendedSteps);
+        const now = Date.now();
+        const pendingAppends = countPendingChainAppendRequests(asyncDir);
+        const added = appendRunnerStepsToStatus({
+            status: statusPayload,
+            steps: appendedSteps,
+            now,
+            pendingAppends,
+        });
+        mutatingFailureStates.push(...Array.from({ length: added.addedFlatSteps }, () => createMutatingFailureState()));
+        pendingToolResults.push(...Array.from({ length: added.addedFlatSteps }, () => undefined));
+        if (config.childIntercomTargets) {
+            config.childIntercomTargets = statusPayload.steps.map((statusStep, index) => resolveSubagentIntercomTarget(id, statusStep.childId ?? statusStep.agent, index));
+        }
+        writeStatusPayload();
+        for (const request of requests) {
+            appendJsonl(eventsPath, JSON.stringify({
+                type: "subagent.chain.append.accepted",
+                ts: now,
+                runId: id,
+                requestId: request.id,
+                stepCount: request.steps.length,
+                pendingAppends,
+            }));
+        }
+    };
+    const markDynamicGraphGroup = (stepIndex, status, error, acceptance) => {
+        const groupNode = statusPayload.workflowGraph?.nodes.find((node) => node.id === `step-${stepIndex}`);
+        if (!groupNode)
+            return;
+        groupNode.status = status;
+        groupNode.error = error;
+        groupNode.acceptanceStatus = acceptance?.status ?? groupNode.acceptanceStatus;
+    };
+    const stepOutputActivityAt = (index) => {
+        const step = statusPayload.steps[index];
+        let lastActivityAt = step?.lastActivityAt ?? step?.startedAt ?? overallStartTime;
+        const outputPath = path.join(asyncDir, `output-${index}.log`);
+        try {
+            lastActivityAt = Math.max(lastActivityAt, fs.statSync(outputPath).mtimeMs);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                console.error(`Failed to inspect async output file '${outputPath}':`, error);
+            }
+        }
+        return lastActivityAt;
+    };
+    const emittedControlEventKeys = new Set();
+    const activeLongRunningSteps = new Set();
+    const mutatingFailureStates = initialStatusSteps.map(() => createMutatingFailureState());
+    const pendingToolResults = initialStatusSteps.map(() => undefined);
+    const mutatingFailureWindowMs = 5 * 60_000;
+    const appendControlEvent = (event) => {
+        if (!controlConfig.enabled)
+            return;
+        const childIntercomTarget = config.childIntercomTargets?.[event.index ?? statusPayload.currentStep];
+        const channels = event.type === "active_long_running"
+            ? controlConfig.notifyChannels.filter((channel) => channel !== "intercom")
+            : controlConfig.notifyChannels;
+        if (channels.length === 0 || !claimControlNotification(controlConfig, event, emittedControlEventKeys, childIntercomTarget))
+            return;
+        appendJsonl(eventsPath, JSON.stringify({
+            type: "subagent.control",
+            event,
+            channels,
+            childIntercomTarget,
+            noticeText: formatControlNoticeMessage(event, childIntercomTarget),
+            ...(config.controlIntercomTarget && channels.includes("intercom") ? {
+                intercom: {
+                    to: config.controlIntercomTarget,
+                    message: formatControlIntercomMessage(event, childIntercomTarget),
+                },
+            } : {}),
+        }));
+    };
+    const syncTopLevelCurrentTool = () => {
+        const activeStep = statusPayload.steps
+            .filter((step) => step.status === "running" && typeof step.currentTool === "string" && step.currentTool.length > 0)
+            .sort((left, right) => (right.currentToolStartedAt ?? 0) - (left.currentToolStartedAt ?? 0))[0];
+        statusPayload.currentTool = activeStep?.currentTool;
+        statusPayload.currentToolStartedAt = activeStep?.currentToolStartedAt;
+        statusPayload.currentPath = activeStep?.currentPath;
+    };
+    const maybeEmitActiveLongRunning = (flatIndex, now) => {
+        if (!controlConfig.enabled || activeLongRunningSteps.has(flatIndex))
+            return false;
+        const step = statusPayload.steps[flatIndex];
+        if (!step || step.status !== "running" || step.activityState === "needs_attention")
+            return false;
+        const reason = nextLongRunningTrigger(controlConfig, {
+            startedAt: step.startedAt ?? overallStartTime,
+            now,
+            turns: step.turnCount ?? 0,
+            tokens: step.tokens?.total ?? 0,
+        });
+        if (!reason)
+            return false;
+        activeLongRunningSteps.add(flatIndex);
+        const previous = step.activityState;
+        step.activityState = "active_long_running";
+        statusPayload.activityState = statusPayload.activityState === "needs_attention" ? "needs_attention" : "active_long_running";
+        const event = buildControlEvent({
+            type: "active_long_running",
+            from: previous,
+            to: "active_long_running",
+            runId: id,
+            agent: step.agent,
+            index: flatIndex,
+            ts: now,
+            message: `${step.agent} is still active but long-running`,
+            reason,
+            turns: step.turnCount,
+            tokens: step.tokens?.total,
+            toolCount: step.toolCount,
+            currentTool: step.currentTool,
+            currentToolDurationMs: step.currentToolStartedAt ? Math.max(0, now - step.currentToolStartedAt) : undefined,
+            currentPath: step.currentPath,
+            elapsedMs: now - (step.startedAt ?? overallStartTime),
+        });
+        appendControlEvent(event);
+        return true;
+    };
+    const steeringMarkerPath = (requestId) => path.join(asyncDir, "control", "steer-recovery", `${Buffer.from(requestId).toString("base64url")}.json`);
+    const markSteeringAttention = (index) => {
+        const step = statusPayload.steps[index];
+        if (step)
+            step.activityState = "needs_attention";
+        statusPayload.activityState = "needs_attention";
+    };
+    const emitSteeringEvent = (type, request, index, extra = {}) => {
+        appendJsonl(eventsPath, JSON.stringify({ type, ts: Date.now(), runId: id, requestId: request.id, ...(index !== undefined ? { index } : {}), ...extra }));
+    };
+    const emitSteeringNotice = (requestId, state, message) => {
+        appendJsonl(eventsPath, JSON.stringify({ type: "subagent.steering.notice", ts: Date.now(), runId: id, requestId, state, message, ...(config.sessionId ? { currentSessionId: config.sessionId } : {}) }));
+    };
+    const recordSteeringLifecycle = (request, targets) => {
+        const lifecycle = steeringStatus(statusPayload);
+        recordSteeringRequest(lifecycle, { id: request.id, requestedAt: request.ts, source: request.source, message: request.message, targets });
+        for (const target of targets) {
+            const step = statusPayload.steps[target.index];
+            if (!step)
+                continue;
+            step.steering ??= createSteeringStatus();
+            recordSteeringRequest(step.steering, { id: request.id, requestedAt: request.ts, source: request.source, message: request.message, targets: [target] });
+        }
+    };
+    const updateSteeringLifecycleTarget = (requestId, index, state, now, fields = {}) => {
+        const updated = updateSteeringTarget(steeringStatus(statusPayload), requestId, index, state, now, fields);
+        const step = statusPayload.steps[index];
+        if (step?.steering)
+            updateSteeringTarget(step.steering, requestId, index, state, now, fields);
+        return updated;
+    };
+    const emitTerminalSteeringNotice = (requestId, failureMessage) => {
+        const state = terminalSteeringNoticeState(steeringStatus(statusPayload), requestId);
+        if (state === "partial")
+            emitSteeringNotice(requestId, "partial", `Steering partially delivered for run ${id}.`);
+        else if (state === "failed")
+            emitSteeringNotice(requestId, "failed", failureMessage);
+    };
+    const deliverSteerRequest = (request) => {
+        if (statusPayload.state !== "running") {
+            const reason = `run became ${statusPayload.state} before steering request was consumed`;
+            const indexes = request.targetIndex !== undefined
+                ? [request.targetIndex]
+                : request.targetIndexes?.length
+                    ? request.targetIndexes
+                    : statusPayload.steps.map((_, index) => index);
+            const targets = indexes.map((index) => ({ index, state: "failed", reason }));
+            recordSteeringLifecycle(request, targets);
+            emitSteeringEvent("subagent.steer.requested", request, undefined, { targets });
+            for (const target of targets)
+                emitSteeringEvent("subagent.steer.failed", request, target.index, { reason });
+            emitTerminalSteeringNotice(request.id, `Steering failed for run ${id}: ${reason}.`);
+            statusPayload.lastUpdate = Date.now();
+            writeStatusPayload();
+            return;
+        }
+        const runningIndexes = statusPayload.steps
+            .map((step, index) => ({ step, index }))
+            .filter(({ step }) => step.status === "running")
+            .map(({ index }) => index);
+        const targets = request.targetIndex !== undefined
+            ? [request.targetIndex]
+            : request.targetIndexes?.length
+                ? request.targetIndexes
+                : runningIndexes.length > 0
+                    ? runningIndexes
+                    : statusPayload.mode === "single" && statusPayload.steps[0]?.status === "pending"
+                        ? [0]
+                        : [];
+        const now = Date.now();
+        const targetStates = targets.map((index) => {
+            const step = statusPayload.steps[index];
+            if (!step)
+                return { index, state: "failed", reason: "child index out of range" };
+            if (step.status === "pending")
+                return { index, state: "scheduled" };
+            if (step.status !== "running")
+                return { index, state: "failed", reason: `child is ${step.status}` };
+            if (steeringCapabilities.get(index)?.supported === false)
+                return { index, state: "failed", reason: "child Pi session does not support steering" };
+            return { index, state: "routed" };
+        });
+        recordSteeringLifecycle(request, targetStates);
+        emitSteeringEvent("subagent.steer.requested", request, undefined, { targets: targetStates });
+        for (const target of targetStates) {
+            if (target.state === "routed") {
+                try {
+                    enqueueStepSteer(asyncDir, target.index, request);
+                    updateSteeringLifecycleTarget(request.id, target.index, "routed", now);
+                    emitSteeringEvent("subagent.steer.routed", request, target.index);
+                }
+                catch (error) {
+                    markSteeringAttention(target.index);
+                    updateSteeringLifecycleTarget(request.id, target.index, "failed", now, { reason: error instanceof Error ? error.message : String(error) });
+                    emitSteeringEvent("subagent.steer.failed", request, target.index, { reason: error instanceof Error ? error.message : String(error) });
+                }
+            }
+            else if (target.state === "failed") {
+                markSteeringAttention(target.index);
+                emitSteeringEvent("subagent.steer.failed", request, target.index, { reason: target.reason });
+            }
+            else {
+                emitSteeringEvent("subagent.steer.scheduled", request, target.index);
+            }
+        }
+        emitTerminalSteeringNotice(request.id, `Steering failed for run ${id}: no requested child remained steerable.`);
+        statusPayload.lastUpdate = now;
+        writeStatusPayload();
+    };
+    const consumeSteerAck = (ack) => {
+        const lifecycle = steeringStatus(statusPayload);
+        const request = lifecycle.recent.find((candidate) => candidate.id === ack.requestId);
+        if (!request || !request.targets.some((target) => target.index === ack.index))
+            return;
+        const late = fs.existsSync(steeringMarkerPath(ack.requestId));
+        const now = Date.now();
+        if (ack.state === "delivered") {
+            updateSteeringLifecycleTarget(ack.requestId, ack.index, late ? "late" : "delivered", now, { reason: late ? "acknowledged after recovery commit" : undefined });
+            emitSteeringEvent("subagent.steer.delivered", { type: "steer", id: ack.requestId, ts: now, message: ack.message }, ack.index, { late, message: ack.message });
+        }
+        else {
+            markSteeringAttention(ack.index);
+            updateSteeringLifecycleTarget(ack.requestId, ack.index, "failed", now, { reason: ack.message });
+            emitSteeringEvent("subagent.steer.failed", { type: "steer", id: ack.requestId, ts: now, message: ack.message }, ack.index, { reason: ack.message });
+        }
+        emitTerminalSteeringNotice(ack.requestId, `Steering failed for run ${id}: ${ack.message}`);
+        statusPayload.lastUpdate = now;
+        writeStatusPayload();
+    };
+    const flushPendingStepSteers = (flatIndex) => {
+        const remaining = [];
+        for (const request of pendingStepSteers.splice(0)) {
+            if (request.targetIndex === undefined)
+                deliverSteerRequest({ ...request, targetIndex: flatIndex });
+            else if (request.targetIndex === flatIndex)
+                deliverSteerRequest(request);
+            else
+                remaining.push(request);
+        }
+        pendingStepSteers.push(...remaining);
+    };
+    const updateStepModel = (flatIndex, model, thinking, now = Date.now()) => {
+        const step = statusPayload.steps[flatIndex];
+        if (!step)
+            return;
+        step.model = model;
+        step.thinking = thinking;
+        statusPayload.lastUpdate = now;
+        writeStatusPayload();
+    };
+    const updateStepTurnBudget = (flatIndex, turnCount, now, terminalAssistantStop) => {
+        const budget = config.turnBudget;
+        const step = statusPayload.steps[flatIndex];
+        if (!budget || !step || timedOut || stopped || turnBudgetExceeded || step.turnBudgetExceeded)
+            return;
+        if (turnCount < budget.maxTurns) {
+            const state = { ...budget, outcome: "within-budget", turnCount };
+            step.turnBudget = state;
+            statusPayload.turnBudget = state;
+            return;
+        }
+        const state = turnBudgetState(budget, turnCount, false);
+        step.turnBudget = state;
+        statusPayload.turnBudget = state;
+        if (!step.wrapUpRequested) {
+            step.wrapUpRequested = true;
+            statusPayload.wrapUpRequested = true;
+            appendRecentStepOutput(step, [turnBudgetSoftNote(budget, turnCount)]);
+        }
+        if (!shouldAbortForTurnBudget(budget, turnCount, terminalAssistantStop))
+            return;
+        const exceededState = turnBudgetState(budget, turnCount, true);
+        const message = turnBudgetExceededMessage(budget, turnCount);
+        step.turnBudget = exceededState;
+        step.turnBudgetExceeded = true;
+        step.wrapUpRequested = true;
+        step.error = message;
+        turnBudgetExceeded = true;
+        statusPayload.turnBudget = exceededState;
+        statusPayload.turnBudgetExceeded = true;
+        statusPayload.wrapUpRequested = true;
+        statusPayload.error = message;
+        statusPayload.lastUpdate = now;
+        appendJsonl(eventsPath, JSON.stringify({ type: "subagent.step.turn_budget_exceeded", ts: now, runId: id, stepIndex: flatIndex, agent: step.agent, turnCount, maxTurns: budget.maxTurns, graceTurns: budget.graceTurns, message }));
+        activeChildTurnBudgetAborts.get(flatIndex)?.(message, exceededState);
+    };
+    const updateStepFromChildEvent = (flatIndex, event) => {
+        const step = statusPayload.steps[flatIndex];
+        if (!step)
+            return;
+        const now = Date.now();
+        statusPayload.currentStep = flatIndex;
+        if (isChildWatchdogStatusEvent(event)) {
+            const next = acceptChildWatchdogEvent({
+                current: step.watchdog,
+                event,
+                runId: id,
+                agent: step.agent,
+                childIndex: flatIndex,
+            });
+            if (!next)
+                return;
+            step.watchdog = next;
+            step.lastActivityAt = now;
+            statusPayload.lastActivityAt = now;
+            statusPayload.lastUpdate = now;
+            writeStatusPayload();
+            return;
+        }
+        if (event.type === "tool_execution_start" && event.toolName) {
+            const mutates = isMutatingTool(event.toolName, event.args);
+            const currentPath = resolveCurrentPath(event.toolName, event.args);
+            step.toolCount = (step.toolCount ?? 0) + 1;
+            const configuredToolBudget = flatSteps[flatIndex]?.toolBudget;
+            if (configuredToolBudget) {
+                step.toolBudget = toolBudgetState(configuredToolBudget, step.toolCount);
+                statusPayload.toolBudget = step.toolBudget;
+            }
+            step.currentTool = event.toolName;
+            step.currentToolArgs = extractToolArgsPreview(event.args ?? {});
+            step.currentToolStartedAt = now;
+            step.currentPath = currentPath;
+            pendingToolResults[flatIndex] = { tool: event.toolName, path: currentPath, mutates, startedAt: now };
+            statusPayload.toolCount = (statusPayload.toolCount ?? 0) + 1;
+            syncTopLevelCurrentTool();
+        }
+        else if (event.type === "tool_execution_end") {
+            if (step.currentTool) {
+                step.recentTools ??= [];
+                step.recentTools.push({ tool: step.currentTool, args: step.currentToolArgs || "", endMs: now });
+            }
+            step.currentTool = undefined;
+            step.currentToolArgs = undefined;
+            step.currentToolStartedAt = undefined;
+            step.currentPath = undefined;
+            syncTopLevelCurrentTool();
+        }
+        else if (event.type === "tool_result_end" && event.message) {
+            const toolSnapshot = pendingToolResults[flatIndex];
+            pendingToolResults[flatIndex] = undefined;
+            const resultText = extractTextFromContent(event.message.content);
+            if (toolSnapshot && resultText.includes("Tool budget hard limit reached")) {
+                const configuredToolBudget = flatSteps[flatIndex]?.toolBudget;
+                if (configuredToolBudget) {
+                    step.toolBudget = toolBudgetState(configuredToolBudget, step.toolCount ?? 0, toolSnapshot.tool);
+                    step.toolBudgetBlocked = true;
+                    statusPayload.toolBudget = step.toolBudget;
+                    statusPayload.toolBudgetBlocked = true;
+                }
+            }
+            appendRecentStepOutput(step, resultText.split("\n").slice(-10));
+            if (toolSnapshot?.mutates && didMutatingToolFail(resultText)) {
+                const state = mutatingFailureStates[flatIndex];
+                recordMutatingFailure(state, {
+                    tool: toolSnapshot.tool,
+                    path: toolSnapshot.path,
+                    error: resultText.split("\n").find((line) => line.trim())?.trim().slice(0, 180) ?? "mutating tool failed",
+                    ts: now,
+                }, mutatingFailureWindowMs);
+                if (controlConfig.enabled && shouldEscalateMutatingFailures(state, controlConfig.failedToolAttemptsBeforeAttention) && step.activityState !== "needs_attention") {
+                    const previous = step.activityState;
+                    step.activityState = "needs_attention";
+                    statusPayload.activityState = "needs_attention";
+                    appendControlEvent(buildControlEvent({
+                        type: "needs_attention",
+                        from: previous,
+                        to: "needs_attention",
+                        runId: id,
+                        agent: step.agent,
+                        index: flatIndex,
+                        ts: now,
+                        message: `${step.agent} needs attention after repeated mutating tool failures`,
+                        reason: "tool_failures",
+                        turns: step.turnCount,
+                        tokens: step.tokens?.total,
+                        toolCount: step.toolCount,
+                        currentTool: toolSnapshot.tool,
+                        currentToolDurationMs: toolSnapshot.startedAt ? Math.max(0, now - toolSnapshot.startedAt) : undefined,
+                        currentPath: toolSnapshot.path,
+                        recentFailureSummary: summarizeRecentMutatingFailures(state),
+                    }));
+                }
+            }
+            else if (toolSnapshot?.mutates) {
+                resetMutatingFailureState(mutatingFailureStates[flatIndex]);
+            }
+        }
+        else if (event.type === "message_end" && event.message?.role === "assistant") {
+            appendRecentStepOutput(step, stripAcceptanceReport(extractTextFromContent(event.message.content)).split("\n").slice(-10));
+            step.turnCount = (step.turnCount ?? 0) + 1;
+            const usage = event.message.usage;
+            if (usage) {
+                const input = usage.input ?? usage.inputTokens ?? 0;
+                const output = usage.output ?? usage.outputTokens ?? 0;
+                const previousInput = step.tokens?.input ?? 0;
+                const previousOutput = step.tokens?.output ?? 0;
+                step.tokens = { input: previousInput + input, output: previousOutput + output, total: previousInput + previousOutput + input + output };
+                const totalInput = statusPayload.totalTokens?.input ?? 0;
+                const totalOutput = statusPayload.totalTokens?.output ?? 0;
+                statusPayload.totalTokens = { input: totalInput + input, output: totalOutput + output, total: totalInput + totalOutput + input + output };
+            }
+            statusPayload.turnCount = Math.max(statusPayload.turnCount ?? 0, step.turnCount);
+            updateStepTurnBudget(flatIndex, step.turnCount, now, isTerminalAssistantStop(event.message));
+        }
+        syncTopLevelCurrentTool();
+        step.lastActivityAt = now;
+        statusPayload.lastActivityAt = now;
+        statusPayload.lastUpdate = now;
+        maybeEmitActiveLongRunning(flatIndex, now);
+        writeStatusPayload();
+    };
+    const updateRunnerActivityState = (now) => {
+        if (!controlConfig.enabled)
+            return false;
+        let changed = false;
+        let runLastActivityAt = statusPayload.lastActivityAt ?? overallStartTime;
+        for (let index = 0; index < statusPayload.steps.length; index++) {
+            const step = statusPayload.steps[index];
+            if (step.status !== "running")
+                continue;
+            const lastActivityAt = stepOutputActivityAt(index);
+            runLastActivityAt = Math.max(runLastActivityAt, lastActivityAt);
+            if (step.lastActivityAt !== lastActivityAt) {
+                step.lastActivityAt = lastActivityAt;
+                changed = true;
+            }
+            const idleState = deriveActivityState({
+                config: controlConfig,
+                startedAt: step.startedAt ?? overallStartTime,
+                lastActivityAt,
+                now,
+            });
+            if (idleState === "needs_attention") {
+                const previous = step.activityState;
+                step.activityState = "needs_attention";
+                if (previous !== "needs_attention") {
+                    appendControlEvent(buildControlEvent({
+                        from: previous,
+                        to: "needs_attention",
+                        runId: id,
+                        agent: step.agent,
+                        index,
+                        ts: now,
+                        lastActivityAt,
+                    }));
+                    changed = true;
+                }
+            }
+            else if (maybeEmitActiveLongRunning(index, now)) {
+                changed = true;
+            }
+        }
+        if (statusPayload.lastActivityAt !== runLastActivityAt) {
+            statusPayload.lastActivityAt = runLastActivityAt;
+            changed = true;
+        }
+        const nextRunState = statusPayload.steps.some((step) => step.activityState === "needs_attention")
+            ? "needs_attention"
+            : statusPayload.steps.some((step) => step.activityState === "active_long_running")
+                ? "active_long_running"
+                : undefined;
+        if (nextRunState !== currentActivityState) {
+            currentActivityState = nextRunState;
+            statusPayload.activityState = nextRunState;
+            changed = true;
+        }
+        statusPayload.lastUpdate = now;
+        if (changed)
+            writeStatusPayload();
+        return changed;
+    };
+    if (controlConfig.enabled) {
+        activityTimer = setInterval(() => {
+            if (statusPayload.state !== "running")
+                return;
+            const now = Date.now();
+            updateRunnerActivityState(now);
+        }, 1000);
+        activityTimer.unref?.();
+    }
+    const interruptRunner = () => {
+        consumeInterruptRequest(asyncDir);
+        if (interrupted || statusPayload.state !== "running")
+            return;
+        interrupted = true;
+        const now = Date.now();
+        statusPayload.state = "paused";
+        currentActivityState = undefined;
+        statusPayload.activityState = undefined;
+        statusPayload.lastUpdate = now;
+        for (const step of statusPayload.steps) {
+            if (step.status === "running") {
+                step.status = "paused";
+                step.activityState = undefined;
+                step.endedAt = now;
+                step.durationMs = step.startedAt ? now - step.startedAt : undefined;
+                step.lastActivityAt = now;
+            }
+        }
+        writeStatusPayload();
+        appendJsonl(eventsPath, JSON.stringify({
+            type: "subagent.run.paused",
+            ts: now,
+            runId: id,
+        }));
+        interruptNestedAsyncDescendants();
+        interruptActiveChildren();
+    };
+    const stopRunner = () => {
+        if (stopped || timedOut || interrupted || statusPayload.state !== "running")
+            return;
+        stopped = true;
+        const now = Date.now();
+        statusPayload.state = "stopped";
+        statusPayload.stopped = true;
+        statusPayload.error = stopMessage;
+        currentActivityState = undefined;
+        statusPayload.activityState = undefined;
+        statusPayload.lastUpdate = now;
+        for (const step of statusPayload.steps) {
+            if (step.status !== "running" && step.status !== "pending")
+                continue;
+            step.status = "stopped";
+            step.error = stopMessage;
+            step.exitCode = 1;
+            step.stopped = true;
+            step.activityState = undefined;
+            step.endedAt = now;
+            step.durationMs = step.startedAt ? now - step.startedAt : 0;
+            step.lastActivityAt = now;
+        }
+        writeStatusPayload();
+        appendJsonl(eventsPath, JSON.stringify({
+            type: "subagent.run.stopped",
+            ts: now,
+            runId: id,
+            message: stopMessage,
+        }));
+        stopAbortController.abort();
+        stopNestedAsyncDescendants();
+        stopActiveChildren();
+    };
+    const timeoutRunner = () => {
+        if (timedOut || stopped || interrupted || statusPayload.state !== "running")
+            return;
+        timedOut = true;
+        const now = Date.now();
+        const message = timeoutMessage ?? "Subagent timed out.";
+        statusPayload.state = "failed";
+        statusPayload.timedOut = true;
+        statusPayload.error = message;
+        currentActivityState = undefined;
+        statusPayload.activityState = undefined;
+        statusPayload.lastUpdate = now;
+        for (const step of statusPayload.steps) {
+            if (step.status !== "running" && step.status !== "pending")
+                continue;
+            step.status = "failed";
+            step.error = message;
+            step.exitCode = 1;
+            step.timedOut = true;
+            step.activityState = undefined;
+            step.endedAt = now;
+            step.durationMs = step.startedAt ? now - step.startedAt : 0;
+            step.lastActivityAt = now;
+        }
+        writeStatusPayload();
+        appendJsonl(eventsPath, JSON.stringify({
+            type: "subagent.run.timed_out",
+            ts: now,
+            runId: id,
+            timeoutMs: config.timeoutMs,
+            deadlineAt: config.deadlineAt,
+            message,
+        }));
+        timeoutAbortController.abort();
+        timeoutNestedAsyncDescendants();
+        timeoutActiveChildren();
+    };
+    process.on(ASYNC_INTERRUPT_SIGNAL, interruptRunner);
+    // Portable control inbox: the parent drops control request files here when
+    // it cannot deliver OS signals (e.g. ENOSYS on Windows) or when steering a
+    // live child. Interrupts still route into the same graceful interruptRunner().
+    const disposeControlInbox = watchAsyncControlInbox(asyncDir, {
+        onInterrupt: interruptRunner,
+        onTimeout: timeoutRunner,
+        onStop: stopRunner,
+        onSteer: (request) => {
+            const targetStep = request.targetIndex !== undefined ? statusPayload.steps[request.targetIndex] : undefined;
+            if (targetStep?.status === "pending") {
+                deliverSteerRequest(request);
+                pendingStepSteers.push(request);
+            }
+            else if (request.targetIndexes !== undefined || request.targetIndex !== undefined || statusPayload.steps.some((step) => step.status === "running")) {
+                deliverSteerRequest(request);
+            }
+            else {
+                deliverSteerRequest(request);
+                pendingStepSteers.push(request);
+            }
+        },
+        onSteerCapability: (capability) => {
+            steeringCapabilities.set(capability.index, capability);
+            if (!capability.supported) {
+                const now = Date.now();
+                const lifecycle = steeringStatus(statusPayload);
+                for (const request of lifecycle.recent) {
+                    if (!request.targets.some((target) => target.index === capability.index && (target.state === "routed" || target.state === "scheduled")))
+                        continue;
+                    markSteeringAttention(capability.index);
+                    updateSteeringLifecycleTarget(request.id, capability.index, "failed", now, { reason: "child Pi session does not support steering" });
+                    emitSteeringEvent("subagent.steer.failed", { type: "steer", id: request.id, ts: request.requestedAt, message: "child Pi session does not support steering" }, capability.index, { reason: "child Pi session does not support steering" });
+                    emitTerminalSteeringNotice(request.id, `Steering failed for run ${id}: child ${capability.index} does not support steering.`);
+                }
+                statusPayload.lastUpdate = now;
+                writeStatusPayload();
+            }
+        },
+        onSteerAck: consumeSteerAck,
+    });
+    if (config.deadlineAt !== undefined) {
+        const remainingMs = Math.max(0, config.deadlineAt - Date.now());
+        timeoutTimer = setTimeout(timeoutRunner, remainingMs);
+        timeoutTimer.unref?.();
+    }
+    appendJsonl(eventsPath, JSON.stringify({
+        type: "subagent.run.started",
+        lifecycleArtifactVersion: SUBAGENT_LIFECYCLE_ARTIFACT_VERSION,
+        ts: overallStartTime,
+        runId: id,
+        mode: statusPayload.mode,
+        cwd,
+        pid: process.pid,
+    }));
+    let flatIndex = 0;
+    let stepCursor = 0;
+    while (true) {
+        if (interrupted || timedOut || stopped || turnBudgetExceeded)
+            break;
+        consumePendingAppendRequests();
+        if (stepCursor >= steps.length)
+            break;
+        const stepIndex = stepCursor++;
+        const step = steps[stepIndex];
+        if (isDynamicRunnerGroup(step)) {
+            const groupStartFlatIndex = flatIndex;
+            let materialized;
+            try {
+                materialized = materializeDynamicParallelStep(step, outputs, stepIndex, { maxItems: config.dynamicFanoutMaxItems, allowRunnerFields: true });
+                if (materialized.parallel.length > 1 && step.parallel.outputPath && !step.parallel.namespaceOutputPath) {
+                    throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} materialized ${materialized.parallel.length} items that resolve output to the same path: ${step.parallel.outputPath}. Remove the explicit output path or use an inherited relative agent output so each item can be isolated.`);
+                }
+                if (materialized.collectedOnEmpty)
+                    validateDynamicCollection(step.collect.outputSchema, materialized.collectedOnEmpty);
+            }
+            catch (error) {
+                const now = Date.now();
+                const message = error instanceof DynamicFanoutError ? error.message : error instanceof Error ? error.message : String(error);
+                statusPayload.state = "failed";
+                statusPayload.error = message;
+                statusPayload.currentStep = flatIndex;
+                const placeholder = statusPayload.steps[groupStartFlatIndex];
+                if (placeholder) {
+                    placeholder.status = "failed";
+                    placeholder.error = message;
+                    placeholder.startedAt = now;
+                    placeholder.endedAt = now;
+                    placeholder.durationMs = 0;
+                    placeholder.exitCode = 1;
+                }
+                statusPayload.lastUpdate = now;
+                markDynamicGraphGroup(stepIndex, "failed", message);
+                writeStatusPayload();
+                results.push({ agent: step.parallel.agent, output: message, error: message, success: false, exitCode: 1 });
+                break;
+            }
+            const effectiveDynamicGroupAcceptance = resolveEffectiveAcceptance({
+                explicit: step.acceptanceInput,
+                agentName: step.parallel.agent,
+                acceptanceRole: step.acceptanceRole,
+                task: materialized.parallel.map((task) => task.task ?? step.parallel.task).join("\n") || step.parallel.task,
+                mode: config.mode,
+                async: true,
+                dynamicGroup: true,
+            });
+            if (materialized.parallel.length === 0) {
+                const now = Date.now();
+                const collection = materialized.collectedOnEmpty ?? [];
+                outputs[step.collect.as] = {
+                    text: JSON.stringify(collection),
+                    structured: collection,
+                    agent: step.parallel.agent,
+                    stepIndex,
+                };
+                statusPayload.outputs = outputs;
+                const placeholder = statusPayload.steps[groupStartFlatIndex];
+                if (placeholder) {
+                    placeholder.status = "complete";
+                    placeholder.startedAt = now;
+                    placeholder.endedAt = now;
+                    placeholder.durationMs = 0;
+                }
+                previousOutput = "Dynamic fanout produced 0 results.";
+                const groupAcceptance = effectiveDynamicGroupAcceptance.explicit && !timedOut && !stopped
+                    ? await evaluateAcceptance({
+                        acceptance: effectiveDynamicGroupAcceptance,
+                        output: "",
+                        report: aggregateAcceptanceReport({
+                            results: [],
+                            notes: "Dynamic fanout produced 0 results.",
+                        }),
+                        cwd,
+                        signal: combinedAbortSignal([timeoutAbortController.signal, stopAbortController.signal]),
+                        abortMessage: stopAbortController.signal.aborted ? stopMessage : timeoutMessage ?? "Subagent timed out.",
+                    })
+                    : undefined;
+                const groupStopped = stopped || stopAbortController.signal.aborted;
+                const groupTimedOut = !groupStopped && (timedOut || timeoutAbortController.signal.aborted);
+                const effectiveGroupAcceptance = groupTimedOut || groupStopped ? undefined : groupAcceptance;
+                if (placeholder && effectiveGroupAcceptance)
+                    placeholder.acceptance = effectiveGroupAcceptance;
+                const groupAcceptanceFailure = effectiveGroupAcceptance ? acceptanceFailureMessage(effectiveGroupAcceptance) : undefined;
+                if (groupTimedOut || groupStopped || groupAcceptanceFailure) {
+                    const errorMessage = groupStopped ? stopMessage : groupTimedOut ? timeoutMessage ?? "Subagent timed out." : groupAcceptanceFailure;
+                    statusPayload.state = groupStopped ? "stopped" : "failed";
+                    statusPayload.error = errorMessage;
+                    statusPayload.stopped = groupStopped ? true : statusPayload.stopped;
+                    if (placeholder) {
+                        placeholder.status = groupStopped ? "stopped" : "failed";
+                        placeholder.error = errorMessage;
+                        placeholder.exitCode = 1;
+                        placeholder.timedOut = groupTimedOut ? true : undefined;
+                        placeholder.stopped = groupStopped ? true : undefined;
+                    }
+                    markDynamicGraphGroup(stepIndex, groupStopped ? "stopped" : "failed", errorMessage, effectiveGroupAcceptance);
+                    statusPayload.lastUpdate = Date.now();
+                    writeStatusPayload();
+                    results.push({ agent: step.parallel.agent, output: errorMessage, error: errorMessage, success: false, exitCode: 1, timedOut: groupTimedOut ? true : undefined, stopped: groupStopped ? true : undefined, acceptance: effectiveGroupAcceptance });
+                    break;
+                }
+                flatIndex++;
+                statusPayload.lastUpdate = now;
+                markDynamicGraphGroup(stepIndex, "completed", undefined, effectiveGroupAcceptance);
+                writeStatusPayload();
+                continue;
+            }
+            const dynamicSteps = materialized.parallel.map((task, itemIndex) => {
+                const thinkingOverride = step.thinkingOverrides?.[itemIndex];
+                const model = thinkingOverride ? applyThinkingSuffix(step.parallel.model, thinkingOverride, true) : step.parallel.model;
+                const thinking = thinkingOverride ? resolveEffectiveThinking(model, thinkingOverride) : undefined;
+                const outputPath = step.parallel.namespaceOutputPath && step.parallel.outputPath
+                    ? path.join(path.dirname(step.parallel.outputPath), `dynamic-${stepIndex}`, `${itemIndex}-${step.parallel.agent}`, path.basename(step.parallel.outputPath))
+                    : step.parallel.outputPath;
+                const taskText = task.task ?? step.parallel.task;
+                const materializedTask = step.parallel.namespaceOutputPath ? injectSingleOutputInstruction(taskText, outputPath, step.parallel) : taskText;
+                return {
+                    ...step.parallel,
+                    task: materializedTask,
+                    effectiveAcceptance: resolveEffectiveAcceptance({
+                        explicit: step.parallel.acceptanceInput,
+                        agentName: step.parallel.agent,
+                        acceptanceRole: step.parallel.acceptanceRole,
+                        task: materializedTask,
+                        mode: config.mode,
+                        async: true,
+                        dynamic: step.parallel.acceptanceInput === undefined,
+                    }),
+                    systemPrompt: step.parallel.namespaceOutputPath ? injectOutputPathSystemPrompt(step.parallel.systemPrompt ?? "", outputPath, step.parallel) : step.parallel.systemPrompt,
+                    outputPath,
+                    label: task.label ?? step.parallel.label,
+                    ...(step.sessionFiles?.[itemIndex] ? { sessionFile: step.sessionFiles[itemIndex] } : {}),
+                    ...(thinkingOverride ? {
+                        ...(model ? { model } : {}),
+                        ...(thinking ? { thinking } : {}),
+                        ...(step.parallel.modelCandidates ? { modelCandidates: step.parallel.modelCandidates.map((candidate) => applyThinkingSuffix(candidate, thinkingOverride, true)) } : {}),
+                    } : {}),
+                    structuredOutput: undefined,
+                    structuredOutputSchema: step.parallel.structuredOutputSchema ?? step.parallel.structuredOutput?.schema,
+                };
+            });
+            const dynamicFlatStepCount = Math.max(statusPayload.steps.length - 1 + dynamicSteps.length, 1);
+            const dynamicStatusSteps = dynamicSteps.map((task, itemIndex) => {
+                const transcriptPath = resolveAsyncStepTranscriptPath({ artifactsDir, artifactConfig, runId: id, agent: task.agent, flatIndex: groupStartFlatIndex + itemIndex, flatStepCount: dynamicFlatStepCount });
+                return {
+                    agent: task.agent,
+                    phase: task.phase ?? step.phase,
+                    label: task.label,
+                    outputName: undefined,
+                    structured: Boolean(task.structuredOutputSchema),
+                    status: "pending",
+                    ...(task.sessionFile ? { sessionFile: task.sessionFile } : {}),
+                    ...(transcriptPath ? { transcriptPath } : {}),
+                    skills: task.skills,
+                    model: task.model,
+                    thinking: task.thinking,
+                    attemptedModels: task.modelCandidates && task.modelCandidates.length > 0 ? task.modelCandidates : task.model ? [task.model] : undefined,
+                    recentTools: [],
+                    recentOutput: [],
+                };
+            });
+            statusPayload.steps.splice(groupStartFlatIndex, 1, ...dynamicStatusSteps);
+            if (config.childIntercomTargets) {
+                config.childIntercomTargets = statusPayload.steps.map((statusStep, index) => resolveSubagentIntercomTarget(id, statusStep.childId ?? statusStep.agent, index));
+            }
+            mutatingFailureStates.splice(groupStartFlatIndex, 1, ...dynamicStatusSteps.map(() => createMutatingFailureState()));
+            pendingToolResults.splice(groupStartFlatIndex, 1, ...dynamicStatusSteps.map(() => undefined));
+            const materializedDelta = dynamicStatusSteps.length - 1;
+            for (const group of statusPayload.parallelGroups) {
+                if (group.stepIndex === stepIndex) {
+                    group.start = groupStartFlatIndex;
+                    group.count = dynamicStatusSteps.length;
+                }
+                else if (group.start > groupStartFlatIndex) {
+                    group.start += materializedDelta;
+                }
+            }
+            if (statusPayload.workflowGraph) {
+                const shiftFlatIndexes = (nodes) => {
+                    for (const node of nodes) {
+                        if (node.stepIndex !== undefined && node.stepIndex > stepIndex && node.flatIndex !== undefined && node.flatIndex >= groupStartFlatIndex) {
+                            node.flatIndex += dynamicStatusSteps.length;
+                        }
+                        if (node.children)
+                            shiftFlatIndexes(node.children);
+                    }
+                };
+                shiftFlatIndexes(statusPayload.workflowGraph.nodes);
+                const groupNode = statusPayload.workflowGraph.nodes.find((node) => node.id === `step-${stepIndex}`);
+                if (groupNode) {
+                    groupNode.children = materialized.items.map((item, itemIndex) => ({
+                        id: `step-${stepIndex}-item-${item.idKey}`,
+                        kind: "agent",
+                        agent: step.parallel.agent,
+                        phase: dynamicSteps[itemIndex]?.phase ?? step.phase,
+                        label: dynamicSteps[itemIndex]?.label?.trim() || `${step.parallel.agent} ${item.key}`,
+                        status: "pending",
+                        flatIndex: groupStartFlatIndex + itemIndex,
+                        stepIndex,
+                        itemKey: item.key,
+                        structured: Boolean(dynamicSteps[itemIndex]?.structuredOutputSchema),
+                    }));
+                }
+            }
+            writeStatusPayload();
+            const concurrency = step.concurrency ?? MAX_PARALLEL_CONCURRENCY;
+            const failFast = step.failFast ?? false;
+            let aborted = false;
+            const parallelResults = await mapConcurrent(dynamicSteps, concurrency, async (task, taskIdx) => {
+                const fi = groupStartFlatIndex + taskIdx;
+                if (timedOut)
+                    return timedOutStepResult(task.agent);
+                if (stopped)
+                    return stoppedStepResult(task.agent);
+                if (interrupted)
+                    return pausedStepResult(task.agent);
+                if (aborted && failFast) {
+                    const skippedAt = Date.now();
+                    statusPayload.steps[fi].status = "failed";
+                    statusPayload.steps[fi].error = "Skipped due to fail-fast";
+                    statusPayload.steps[fi].startedAt = skippedAt;
+                    statusPayload.steps[fi].endedAt = skippedAt;
+                    statusPayload.steps[fi].durationMs = 0;
+                    statusPayload.steps[fi].exitCode = -1;
+                    statusPayload.lastUpdate = skippedAt;
+                    writeStatusPayload();
+                    return { agent: task.agent, output: "(skipped — fail-fast)", exitCode: -1, skipped: true };
+                }
+                const taskStartTime = Date.now();
+                statusPayload.currentStep = fi;
+                statusPayload.steps[fi].status = "running";
+                statusPayload.steps[fi].error = undefined;
+                statusPayload.steps[fi].activityState = undefined;
+                resetStepLiveDetail(statusPayload.steps[fi]);
+                statusPayload.steps[fi].startedAt = taskStartTime;
+                statusPayload.steps[fi].lastActivityAt = taskStartTime;
+                statusPayload.outputFile = path.join(asyncDir, `output-${fi}.log`);
+                statusPayload.lastActivityAt = taskStartTime;
+                statusPayload.lastUpdate = taskStartTime;
+                writeStatusPayload();
+                appendJsonl(eventsPath, JSON.stringify({ type: "subagent.step.started", ts: taskStartTime, runId: id, stepIndex: fi, agent: task.agent }));
+                flushPendingStepSteers(fi);
+                const singleResult = await runSingleStep(task, {
+                    previousOutput, placeholder, cwd, sessionEnabled,
+                    outputs,
+                    sessionDir: config.sessionDir ? path.join(config.sessionDir, `dynamic-${stepIndex}-${taskIdx}`) : undefined,
+                    artifactsDir, artifactConfig, id,
+                    flatIndex: fi, flatStepCount: Math.max(statusPayload.steps.length, 1),
+                    outputFile: path.join(asyncDir, `output-${fi}.log`),
+                    steerInboxDir: stepSteerInboxDir(asyncDir, fi),
+                    steerCapabilityPath: steerCapabilityPath(asyncDir, fi),
+                    steerAckDir: steerAcksDir(asyncDir, fi),
+                    piPackageRoot: config.piPackageRoot,
+                    piArgv1: config.piArgv1,
+                    childIntercomTarget: config.childIntercomTargets?.[fi],
+                    orchestratorIntercomTarget: config.controlIntercomTarget,
+                    nestedRoute: config.nestedRoute,
+                    registerInterrupt: (interrupt) => registerStepInterrupt(fi, interrupt),
+                    registerTimeout: (interrupt) => registerStepTimeout(fi, interrupt),
+                    registerStop: (stop) => registerStepStop(fi, stop),
+                    registerTurnBudgetAbort: (abort) => registerStepTurnBudgetAbort(fi, abort),
+                    timeoutSignal: timeoutAbortController.signal,
+                    stopSignal: stopAbortController.signal,
+                    timeoutMessage,
+                    stopMessage,
+                    turnBudget: config.turnBudget,
+                    onAttemptStart: (attempt) => updateStepModel(fi, attempt.model, attempt.thinking),
+                    onChildEvent: (event) => updateStepFromChildEvent(fi, event),
+                    onWriterProcess,
+                    skipAcceptance: () => timedOut || stopped,
+                });
+                const taskEndTime = Date.now();
+                const childInterrupted = singleResult.interrupted === true;
+                const childStopped = singleResult.stopped === true;
+                statusPayload.steps[fi].status = stopped || childStopped ? "stopped" : timedOut ? "failed" : childInterrupted ? "paused" : singleResult.exitCode === 0 ? "complete" : "failed";
+                statusPayload.steps[fi].endedAt = taskEndTime;
+                statusPayload.steps[fi].durationMs = taskEndTime - taskStartTime;
+                statusPayload.steps[fi].exitCode = stopped || childStopped ? 1 : timedOut ? 1 : childInterrupted ? 0 : singleResult.exitCode;
+                statusPayload.steps[fi].timedOut = timedOut || singleResult.timedOut ? true : undefined;
+                statusPayload.steps[fi].stopped = stopped || childStopped ? true : undefined;
+                statusPayload.steps[fi].turnBudget = singleResult.turnBudget;
+                statusPayload.steps[fi].turnBudgetExceeded = singleResult.turnBudgetExceeded;
+                statusPayload.steps[fi].wrapUpRequested = singleResult.wrapUpRequested;
+                statusPayload.steps[fi].toolBudget = singleResult.toolBudget;
+                statusPayload.steps[fi].toolBudgetBlocked = singleResult.toolBudgetBlocked;
+                if (singleResult.toolBudget)
+                    statusPayload.toolBudget = singleResult.toolBudget;
+                if (singleResult.toolBudgetBlocked)
+                    statusPayload.toolBudgetBlocked = true;
+                if (singleResult.turnBudget)
+                    statusPayload.turnBudget = singleResult.turnBudget;
+                if (singleResult.turnBudgetExceeded)
+                    statusPayload.turnBudgetExceeded = true;
+                if (singleResult.wrapUpRequested)
+                    statusPayload.wrapUpRequested = true;
+                statusPayload.steps[fi].model = singleResult.model;
+                statusPayload.steps[fi].thinking = resolveEffectiveThinking(singleResult.model, statusPayload.steps[fi].thinking);
+                statusPayload.steps[fi].attemptedModels = singleResult.attemptedModels;
+                statusPayload.steps[fi].modelAttempts = singleResult.modelAttempts;
+                statusPayload.steps[fi].totalCost = singleResult.totalCost;
+                statusPayload.steps[fi].error = stopped || childStopped ? stopMessage : timedOut ? (timeoutMessage ?? "Subagent timed out.") : singleResult.error;
+                statusPayload.steps[fi].transcriptPath = singleResult.transcriptPath ?? statusPayload.steps[fi].transcriptPath;
+                statusPayload.steps[fi].transcriptError = singleResult.transcriptError;
+                statusPayload.steps[fi].structuredOutput = singleResult.structuredOutput;
+                statusPayload.steps[fi].structuredOutputPath = singleResult.structuredOutputPath;
+                statusPayload.steps[fi].structuredOutputSchemaPath = singleResult.structuredOutputSchemaPath;
+                statusPayload.steps[fi].acceptance = singleResult.acceptance;
+                statusPayload.steps[fi].watchdog = singleResult.watchdog;
+                statusPayload.lastUpdate = taskEndTime;
+                writeStatusPayload();
+                appendJsonl(eventsPath, JSON.stringify({
+                    type: stopped || childStopped ? "subagent.step.stopped" : timedOut ? "subagent.step.failed" : childInterrupted ? "subagent.step.paused" : singleResult.exitCode === 0 ? "subagent.step.completed" : "subagent.step.failed",
+                    ts: taskEndTime, runId: id, stepIndex: fi, agent: task.agent,
+                    exitCode: stopped || childStopped ? 1 : timedOut ? 1 : childInterrupted ? 0 : singleResult.exitCode, durationMs: taskEndTime - taskStartTime,
+                }));
+                if (singleResult.exitCode !== 0 && failFast)
+                    aborted = true;
+                return stopped || childStopped ? { ...singleResult, output: stopMessage, error: stopMessage, exitCode: 1, interrupted: false, timedOut: false, stopped: true, skipped: false } : timedOut ? { ...singleResult, output: timeoutMessage ?? "Subagent timed out.", error: timeoutMessage ?? "Subagent timed out.", exitCode: 1, interrupted: false, timedOut: true, skipped: false } : { ...singleResult, skipped: false };
+            }, globalSemaphore);
+            flatIndex += dynamicSteps.length;
+            for (const pr of parallelResults) {
+                results.push({
+                    agent: pr.agent,
+                    output: pr.output,
+                    error: pr.error,
+                    protocolError: pr.protocolError,
+                    success: pr.stopped !== true && pr.interrupted !== true && pr.exitCode === 0,
+                    exitCode: pr.interrupted === true ? 0 : pr.exitCode,
+                    skipped: pr.skipped,
+                    interrupted: pr.interrupted,
+                    timedOut: pr.timedOut,
+                    stopped: pr.stopped,
+                    turnBudget: pr.turnBudget,
+                    turnBudgetExceeded: pr.turnBudgetExceeded,
+                    wrapUpRequested: pr.wrapUpRequested,
+                    toolBudget: pr.toolBudget,
+                    toolBudgetBlocked: pr.toolBudgetBlocked,
+                    sessionFile: pr.sessionFile,
+                    intercomTarget: pr.intercomTarget,
+                    model: pr.model,
+                    attemptedModels: pr.attemptedModels,
+                    modelAttempts: pr.modelAttempts,
+                    totalCost: pr.totalCost,
+                    artifactPaths: pr.artifactPaths,
+                    transcriptPath: pr.transcriptPath,
+                    transcriptError: pr.transcriptError,
+                    structuredOutput: pr.structuredOutput,
+                    structuredOutputPath: pr.structuredOutputPath,
+                    structuredOutputSchemaPath: pr.structuredOutputSchemaPath,
+                    acceptance: pr.acceptance,
+                    watchdog: pr.watchdog,
+                });
+            }
+            const collection = collectDynamicResults(step, materialized.items, parallelResults);
+            const failures = parallelResults.filter((result) => result.exitCode !== 0 && result.exitCode !== -1);
+            if (failures.length === 0) {
+                try {
+                    validateDynamicCollection(step.collect.outputSchema, collection);
+                    outputs[step.collect.as] = {
+                        text: JSON.stringify(collection),
+                        structured: collection,
+                        agent: step.parallel.agent,
+                        stepIndex,
+                    };
+                    statusPayload.outputs = outputs;
+                    const groupAcceptance = !timedOut && !stopped
+                        ? await evaluateAcceptance({
+                            acceptance: effectiveDynamicGroupAcceptance,
+                            output: "",
+                            report: aggregateAcceptanceReport({
+                                results: parallelResults,
+                                notes: `Dynamic fanout collected ${collection.length} result(s) into ${step.collect.as}.`,
+                            }),
+                            cwd,
+                            signal: combinedAbortSignal([timeoutAbortController.signal, stopAbortController.signal]),
+                            abortMessage: stopAbortController.signal.aborted ? stopMessage : timeoutMessage ?? "Subagent timed out.",
+                        })
+                        : undefined;
+                    const groupStopped = stopped || stopAbortController.signal.aborted;
+                    const groupTimedOut = !groupStopped && (timedOut || timeoutAbortController.signal.aborted);
+                    const effectiveGroupAcceptance = groupTimedOut || groupStopped ? undefined : groupAcceptance;
+                    const groupAcceptanceFailure = effectiveDynamicGroupAcceptance.explicit && effectiveGroupAcceptance ? acceptanceFailureMessage(effectiveGroupAcceptance) : undefined;
+                    const groupError = groupStopped ? stopMessage : groupTimedOut ? timeoutMessage ?? "Subagent timed out." : groupAcceptanceFailure;
+                    markDynamicGraphGroup(stepIndex, groupError ? groupStopped ? "stopped" : "failed" : "completed", groupError, effectiveGroupAcceptance);
+                    if (groupError) {
+                        results.push({
+                            agent: step.parallel.agent,
+                            output: groupError,
+                            error: groupError,
+                            success: false,
+                            exitCode: 1,
+                            timedOut: groupTimedOut ? true : undefined,
+                            stopped: groupStopped ? true : undefined,
+                            structuredOutput: collection,
+                            acceptance: effectiveGroupAcceptance,
+                        });
+                        statusPayload.error = groupError;
+                        statusPayload.stopped = groupStopped ? true : statusPayload.stopped;
+                    }
+                }
+                catch (error) {
+                    const message = error instanceof DynamicFanoutError ? error.message : error instanceof Error ? error.message : String(error);
+                    results.push({ agent: step.parallel.agent, output: message, error: message, success: false, exitCode: 1, structuredOutput: collection });
+                    statusPayload.error = message;
+                    markDynamicGraphGroup(stepIndex, "failed", message);
+                }
+            }
+            previousOutput = aggregateParallelOutputs(parallelResults.map((r, i) => ({
+                agent: r.agent,
+                taskIndex: i,
+                output: r.output,
+                exitCode: r.exitCode,
+                error: r.error,
+            })), (i, agent) => `=== Dynamic Item ${i + 1} (${agent}, key ${materialized.items[i]?.key ?? i}) ===`);
+            appendJsonl(eventsPath, JSON.stringify({
+                type: "subagent.dynamic.completed",
+                ts: Date.now(),
+                runId: id,
+                stepIndex,
+                success: failures.length === 0,
+            }));
+            if (failures.length > 0)
+                markDynamicGraphGroup(stepIndex, "failed", failures[0]?.error ?? "Dynamic fanout child failed.");
+            statusPayload.lastUpdate = Date.now();
+            writeStatusPayload();
+            if (failures.length > 0 || statusPayload.error)
+                break;
+            continue;
+        }
+        if (isParallelGroup(step)) {
+            const group = step;
+            const concurrency = group.concurrency ?? MAX_PARALLEL_CONCURRENCY;
+            const failFast = group.failFast ?? false;
+            const groupStartFlatIndex = flatIndex;
+            let aborted = false;
+            let worktreeSetup;
+            if (group.worktree) {
+                const worktreeTaskCwdConflict = findWorktreeTaskCwdConflict(group.parallel, cwd);
+                if (worktreeTaskCwdConflict) {
+                    const failedAt = Date.now();
+                    markParallelGroupSetupFailure({
+                        statusPayload,
+                        results,
+                        group,
+                        groupStartFlatIndex,
+                        setupError: formatWorktreeTaskCwdConflict(worktreeTaskCwdConflict, cwd),
+                        failedAt,
+                        statusPath,
+                        eventsPath,
+                        asyncDir,
+                        runId: id,
+                        stepIndex,
+                    });
+                    flatIndex += group.parallel.length;
+                    break;
+                }
+                try {
+                    worktreeSetup = createWorktrees(cwd, `${id}-s${stepIndex}`, group.parallel.length, {
+                        agents: group.parallel.map((task) => task.agent),
+                        setupHook: config.worktreeSetupHook
+                            ? { hookPath: config.worktreeSetupHook, timeoutMs: config.worktreeSetupHookTimeoutMs }
+                            : undefined,
+                        baseDir: config.worktreeBaseDir,
+                    });
+                }
+                catch (error) {
+                    const setupError = error instanceof Error ? error.message : String(error);
+                    const failedAt = Date.now();
+                    markParallelGroupSetupFailure({
+                        statusPayload,
+                        results,
+                        group,
+                        groupStartFlatIndex,
+                        setupError,
+                        failedAt,
+                        statusPath,
+                        eventsPath,
+                        asyncDir,
+                        runId: id,
+                        stepIndex,
+                    });
+                    flatIndex += group.parallel.length;
+                    break;
+                }
+            }
+            try {
+                if (group.worktree)
+                    ensureParallelProgressFile(cwd, group);
+                const groupStartTime = Date.now();
+                markParallelGroupRunning({
+                    statusPayload,
+                    group,
+                    groupStartFlatIndex,
+                    groupStartTime,
+                    statusPath,
+                    eventsPath,
+                    asyncDir,
+                    runId: id,
+                    stepIndex,
+                });
+                const parallelResults = await mapConcurrent(group.parallel, concurrency, async (task, taskIdx) => {
+                    const fi = groupStartFlatIndex + taskIdx;
+                    if (timedOut)
+                        return timedOutStepResult(task.agent);
+                    if (stopped)
+                        return stoppedStepResult(task.agent);
+                    if (interrupted)
+                        return pausedStepResult(task.agent);
+                    if (aborted && failFast) {
+                        const skippedAt = Date.now();
+                        statusPayload.steps[fi].status = "failed";
+                        statusPayload.steps[fi].error = "Skipped due to fail-fast";
+                        statusPayload.steps[fi].startedAt = skippedAt;
+                        statusPayload.steps[fi].endedAt = skippedAt;
+                        statusPayload.steps[fi].durationMs = 0;
+                        statusPayload.steps[fi].exitCode = -1;
+                        statusPayload.steps[fi].activityState = undefined;
+                        statusPayload.lastUpdate = skippedAt;
+                        writeStatusPayload();
+                        appendJsonl(eventsPath, JSON.stringify({
+                            type: "subagent.step.failed", ts: skippedAt, runId: id, stepIndex: fi, agent: task.agent, exitCode: -1, durationMs: 0,
+                        }));
+                        return { agent: task.agent, output: "(skipped — fail-fast)", exitCode: -1, skipped: true };
+                    }
+                    const taskStartTime = Date.now();
+                    statusPayload.currentStep = fi;
+                    statusPayload.steps[fi].status = "running";
+                    statusPayload.steps[fi].error = undefined;
+                    statusPayload.steps[fi].activityState = undefined;
+                    resetStepLiveDetail(statusPayload.steps[fi]);
+                    statusPayload.steps[fi].startedAt = taskStartTime;
+                    statusPayload.steps[fi].endedAt = undefined;
+                    statusPayload.steps[fi].durationMs = undefined;
+                    statusPayload.steps[fi].lastActivityAt = taskStartTime;
+                    statusPayload.outputFile = path.join(asyncDir, `output-${fi}.log`);
+                    statusPayload.lastActivityAt = taskStartTime;
+                    statusPayload.lastUpdate = taskStartTime;
+                    writeStatusPayload();
+                    appendJsonl(eventsPath, JSON.stringify({
+                        type: "subagent.step.started", ts: taskStartTime, runId: id, stepIndex: fi, agent: task.agent,
+                    }));
+                    const taskSessionDir = config.sessionDir
+                        ? path.join(config.sessionDir, `parallel-${taskIdx}`)
+                        : undefined;
+                    const { taskForRun, taskCwd } = prepareParallelTaskRun(task, cwd, worktreeSetup, taskIdx);
+                    flushPendingStepSteers(fi);
+                    const singleResult = await runSingleStep(taskForRun, {
+                        previousOutput, placeholder, cwd: taskCwd, sessionEnabled,
+                        outputs,
+                        sessionDir: taskSessionDir,
+                        artifactsDir, artifactConfig, id,
+                        flatIndex: fi, flatStepCount: Math.max(statusPayload.steps.length, 1),
+                        outputFile: path.join(asyncDir, `output-${fi}.log`),
+                        steerInboxDir: stepSteerInboxDir(asyncDir, fi),
+                        steerCapabilityPath: steerCapabilityPath(asyncDir, fi),
+                        steerAckDir: steerAcksDir(asyncDir, fi),
+                        piPackageRoot: config.piPackageRoot,
+                        piArgv1: config.piArgv1,
+                        childIntercomTarget: config.childIntercomTargets?.[fi],
+                        orchestratorIntercomTarget: config.controlIntercomTarget,
+                        nestedRoute: config.nestedRoute,
+                        registerInterrupt: (interrupt) => registerStepInterrupt(fi, interrupt),
+                        registerTimeout: (interrupt) => registerStepTimeout(fi, interrupt),
+                        registerStop: (stop) => registerStepStop(fi, stop),
+                        registerTurnBudgetAbort: (abort) => registerStepTurnBudgetAbort(fi, abort),
+                        timeoutSignal: timeoutAbortController.signal,
+                        stopSignal: stopAbortController.signal,
+                        timeoutMessage,
+                        stopMessage,
+                        turnBudget: config.turnBudget,
+                        onAttemptStart: (attempt) => updateStepModel(fi, attempt.model, attempt.thinking),
+                        onChildEvent: (event) => updateStepFromChildEvent(fi, event),
+                        onWriterProcess,
+                        skipAcceptance: () => timedOut || stopped,
+                    });
+                    if (task.sessionFile) {
+                        latestSessionFile = task.sessionFile;
+                    }
+                    const taskEndTime = Date.now();
+                    const taskDuration = taskEndTime - taskStartTime;
+                    const childInterrupted = singleResult.interrupted === true;
+                    const childStopped = singleResult.stopped === true;
+                    statusPayload.steps[fi].status = stopped || childStopped ? "stopped" : timedOut ? "failed" : childInterrupted ? "paused" : singleResult.exitCode === 0 ? "complete" : "failed";
+                    statusPayload.steps[fi].endedAt = taskEndTime;
+                    statusPayload.steps[fi].durationMs = taskDuration;
+                    statusPayload.steps[fi].exitCode = stopped || childStopped ? 1 : timedOut ? 1 : childInterrupted ? 0 : singleResult.exitCode;
+                    statusPayload.steps[fi].timedOut = timedOut || singleResult.timedOut ? true : undefined;
+                    statusPayload.steps[fi].stopped = stopped || childStopped ? true : undefined;
+                    statusPayload.steps[fi].turnBudget = singleResult.turnBudget;
+                    statusPayload.steps[fi].turnBudgetExceeded = singleResult.turnBudgetExceeded;
+                    statusPayload.steps[fi].wrapUpRequested = singleResult.wrapUpRequested;
+                    statusPayload.steps[fi].toolBudget = singleResult.toolBudget;
+                    statusPayload.steps[fi].toolBudgetBlocked = singleResult.toolBudgetBlocked;
+                    if (singleResult.toolBudget)
+                        statusPayload.toolBudget = singleResult.toolBudget;
+                    if (singleResult.toolBudgetBlocked)
+                        statusPayload.toolBudgetBlocked = true;
+                    if (singleResult.turnBudget)
+                        statusPayload.turnBudget = singleResult.turnBudget;
+                    if (singleResult.turnBudgetExceeded)
+                        statusPayload.turnBudgetExceeded = true;
+                    if (singleResult.wrapUpRequested)
+                        statusPayload.wrapUpRequested = true;
+                    statusPayload.steps[fi].model = singleResult.model;
+                    statusPayload.steps[fi].thinking = resolveEffectiveThinking(singleResult.model, statusPayload.steps[fi].thinking);
+                    statusPayload.steps[fi].attemptedModels = singleResult.attemptedModels;
+                    statusPayload.steps[fi].modelAttempts = singleResult.modelAttempts;
+                    statusPayload.steps[fi].totalCost = singleResult.totalCost;
+                    statusPayload.steps[fi].error = stopped || childStopped ? stopMessage : timedOut ? (timeoutMessage ?? "Subagent timed out.") : singleResult.error;
+                    statusPayload.steps[fi].transcriptPath = singleResult.transcriptPath ?? statusPayload.steps[fi].transcriptPath;
+                    statusPayload.steps[fi].transcriptError = singleResult.transcriptError;
+                    statusPayload.steps[fi].structuredOutput = singleResult.structuredOutput;
+                    statusPayload.steps[fi].structuredOutputPath = singleResult.structuredOutputPath;
+                    statusPayload.steps[fi].structuredOutputSchemaPath = singleResult.structuredOutputSchemaPath;
+                    statusPayload.steps[fi].acceptance = singleResult.acceptance;
+                    statusPayload.steps[fi].watchdog = singleResult.watchdog;
+                    statusPayload.lastUpdate = taskEndTime;
+                    writeStatusPayload();
+                    appendJsonl(eventsPath, JSON.stringify({
+                        type: stopped || childStopped ? "subagent.step.stopped" : timedOut ? "subagent.step.failed" : childInterrupted ? "subagent.step.paused" : singleResult.exitCode === 0 ? "subagent.step.completed" : "subagent.step.failed",
+                        ts: taskEndTime, runId: id, stepIndex: fi, agent: task.agent,
+                        exitCode: stopped || childStopped ? 1 : timedOut ? 1 : childInterrupted ? 0 : singleResult.exitCode, durationMs: taskDuration,
+                    }));
+                    if (singleResult.completionGuardTriggered) {
+                        const event = buildControlEvent({
+                            from: statusPayload.steps[fi].activityState,
+                            to: "needs_attention",
+                            runId: id,
+                            agent: task.agent,
+                            index: fi,
+                            ts: taskEndTime,
+                            message: `${task.agent} completed without making edits for an implementation task`,
+                            reason: "completion_guard",
+                        });
+                        appendControlEvent(event);
+                    }
+                    if (singleResult.exitCode !== 0 && failFast)
+                        aborted = true;
+                    return stopped || childStopped ? { ...singleResult, output: stopMessage, error: stopMessage, exitCode: 1, interrupted: false, timedOut: false, stopped: true, skipped: false } : timedOut ? { ...singleResult, output: timeoutMessage ?? "Subagent timed out.", error: timeoutMessage ?? "Subagent timed out.", exitCode: 1, interrupted: false, timedOut: true, skipped: false } : { ...singleResult, skipped: false };
+                }, globalSemaphore);
+                flatIndex += group.parallel.length;
+                for (let t = 0; t < group.parallel.length; t++) {
+                    const fi = groupStartFlatIndex + t;
+                    const sessionTokens = config.sessionDir
+                        ? parseSessionTokens(path.join(config.sessionDir, `parallel-${t}`))
+                        : null;
+                    const taskTokens = sessionTokens ?? tokenUsageFromAttempts(parallelResults[t]?.modelAttempts);
+                    if (!taskTokens)
+                        continue;
+                    statusPayload.steps[fi].tokens = taskTokens;
+                    previousCumulativeTokens = {
+                        input: previousCumulativeTokens.input + taskTokens.input,
+                        output: previousCumulativeTokens.output + taskTokens.output,
+                        total: previousCumulativeTokens.total + taskTokens.total,
+                    };
+                }
+                statusPayload.totalTokens = { ...previousCumulativeTokens };
+                statusPayload.lastUpdate = Date.now();
+                writeStatusPayload();
+                for (const pr of parallelResults) {
+                    results.push({
+                        agent: pr.agent,
+                        output: pr.output,
+                        error: pr.error,
+                        protocolError: pr.protocolError,
+                        success: pr.stopped !== true && pr.interrupted !== true && pr.exitCode === 0,
+                        exitCode: pr.interrupted === true ? 0 : pr.exitCode,
+                        skipped: pr.skipped,
+                        interrupted: pr.interrupted,
+                        timedOut: pr.timedOut,
+                        stopped: pr.stopped,
+                        turnBudget: pr.turnBudget,
+                        turnBudgetExceeded: pr.turnBudgetExceeded,
+                        wrapUpRequested: pr.wrapUpRequested,
+                        toolBudget: pr.toolBudget,
+                        toolBudgetBlocked: pr.toolBudgetBlocked,
+                        sessionFile: pr.sessionFile,
+                        intercomTarget: pr.intercomTarget,
+                        model: pr.model,
+                        attemptedModels: pr.attemptedModels,
+                        modelAttempts: pr.modelAttempts,
+                        totalCost: pr.totalCost,
+                        artifactPaths: pr.artifactPaths,
+                        transcriptPath: pr.transcriptPath,
+                        transcriptError: pr.transcriptError,
+                        structuredOutput: pr.structuredOutput,
+                        structuredOutputPath: pr.structuredOutputPath,
+                        structuredOutputSchemaPath: pr.structuredOutputSchemaPath,
+                        acceptance: pr.acceptance,
+                        watchdog: pr.watchdog,
+                    });
+                }
+                for (let t = 0; t < group.parallel.length; t++) {
+                    const outputName = group.parallel[t]?.outputName;
+                    if (outputName)
+                        outputs[outputName] = outputEntryFromAsyncResult({
+                            agent: parallelResults[t].agent,
+                            output: parallelResults[t].output,
+                            structuredOutput: parallelResults[t].structuredOutput,
+                        }, stepIndex);
+                }
+                statusPayload.outputs = outputs;
+                previousOutput = aggregateParallelOutputs(parallelResults.map((r) => ({
+                    agent: r.agent,
+                    output: r.output,
+                    exitCode: r.exitCode,
+                    error: r.error,
+                    model: r.model,
+                    attemptedModels: r.attemptedModels,
+                })));
+                previousOutput = appendParallelWorktreeSummary(previousOutput, worktreeSetup, asyncDir, stepIndex, group);
+                appendJsonl(eventsPath, JSON.stringify({
+                    type: "subagent.parallel.completed",
+                    ts: Date.now(),
+                    runId: id,
+                    stepIndex,
+                    success: parallelResults.every((r) => r.exitCode === 0 || r.exitCode === -1),
+                }));
+                if (parallelResults.some((r) => r.exitCode !== 0 && r.exitCode !== -1)) {
+                    break;
+                }
+            }
+            finally {
+                if (worktreeSetup)
+                    cleanupWorktrees(worktreeSetup);
+            }
+        }
+        else {
+            const seqStep = step;
+            const stepStartTime = Date.now();
+            statusPayload.currentStep = flatIndex;
+            statusPayload.steps[flatIndex].status = "running";
+            statusPayload.steps[flatIndex].activityState = undefined;
+            statusPayload.activityState = undefined;
+            resetStepLiveDetail(statusPayload.steps[flatIndex]);
+            statusPayload.steps[flatIndex].skills = seqStep.skills;
+            statusPayload.steps[flatIndex].startedAt = stepStartTime;
+            statusPayload.steps[flatIndex].lastActivityAt = stepStartTime;
+            statusPayload.lastActivityAt = stepStartTime;
+            statusPayload.lastUpdate = stepStartTime;
+            statusPayload.outputFile = path.join(asyncDir, `output-${flatIndex}.log`);
+            writeStatusPayload();
+            appendJsonl(eventsPath, JSON.stringify({
+                type: "subagent.step.started",
+                ts: stepStartTime,
+                runId: id,
+                stepIndex: flatIndex,
+                agent: seqStep.agent,
+            }));
+            flushPendingStepSteers(flatIndex);
+            const singleResult = await runSingleStep(seqStep, {
+                previousOutput, placeholder, cwd, sessionEnabled,
+                outputs: statusPayload.mode === "single" ? undefined : outputs,
+                sessionDir: config.sessionDir,
+                artifactsDir, artifactConfig, id,
+                flatIndex, flatStepCount: Math.max(statusPayload.steps.length, 1),
+                outputFile: path.join(asyncDir, `output-${flatIndex}.log`),
+                steerInboxDir: stepSteerInboxDir(asyncDir, flatIndex),
+                steerCapabilityPath: steerCapabilityPath(asyncDir, flatIndex),
+                steerAckDir: steerAcksDir(asyncDir, flatIndex),
+                piPackageRoot: config.piPackageRoot,
+                piArgv1: config.piArgv1,
+                childIntercomTarget: config.childIntercomTargets?.[flatIndex],
+                orchestratorIntercomTarget: config.controlIntercomTarget,
+                nestedRoute: config.nestedRoute,
+                registerInterrupt: (interrupt) => registerStepInterrupt(flatIndex, interrupt),
+                registerTimeout: (interrupt) => registerStepTimeout(flatIndex, interrupt),
+                registerStop: (stop) => registerStepStop(flatIndex, stop),
+                registerTurnBudgetAbort: (abort) => registerStepTurnBudgetAbort(flatIndex, abort),
+                timeoutSignal: timeoutAbortController.signal,
+                stopSignal: stopAbortController.signal,
+                timeoutMessage,
+                stopMessage,
+                turnBudget: config.turnBudget,
+                onAttemptStart: (attempt) => updateStepModel(flatIndex, attempt.model, attempt.thinking),
+                onChildEvent: (event) => updateStepFromChildEvent(flatIndex, event),
+                onWriterProcess,
+                skipAcceptance: () => timedOut || stopped,
+            });
+            if (seqStep.sessionFile) {
+                latestSessionFile = seqStep.sessionFile;
+            }
+            previousOutput = singleResult.output;
+            const childStopped = singleResult.stopped === true;
+            results.push({
+                agent: singleResult.agent,
+                output: stopped || childStopped ? stopMessage : timedOut ? (timeoutMessage ?? "Subagent timed out.") : singleResult.output,
+                error: stopped || childStopped ? stopMessage : timedOut ? (timeoutMessage ?? "Subagent timed out.") : singleResult.error,
+                protocolError: singleResult.protocolError,
+                success: !stopped && !childStopped && !timedOut && singleResult.interrupted !== true && singleResult.exitCode === 0,
+                exitCode: stopped || childStopped ? 1 : timedOut ? 1 : singleResult.interrupted === true ? 0 : singleResult.exitCode,
+                sessionFile: singleResult.sessionFile,
+                intercomTarget: singleResult.intercomTarget,
+                model: singleResult.model,
+                attemptedModels: singleResult.attemptedModels,
+                modelAttempts: singleResult.modelAttempts,
+                totalCost: singleResult.totalCost,
+                artifactPaths: singleResult.artifactPaths,
+                transcriptPath: singleResult.transcriptPath,
+                transcriptError: singleResult.transcriptError,
+                structuredOutput: singleResult.structuredOutput,
+                structuredOutputPath: singleResult.structuredOutputPath,
+                structuredOutputSchemaPath: singleResult.structuredOutputSchemaPath,
+                acceptance: singleResult.acceptance,
+                watchdog: singleResult.watchdog,
+                interrupted: singleResult.interrupted,
+                timedOut: timedOut || singleResult.timedOut ? true : undefined,
+                stopped: stopped || childStopped ? true : undefined,
+                turnBudget: singleResult.turnBudget,
+                turnBudgetExceeded: singleResult.turnBudgetExceeded,
+                wrapUpRequested: singleResult.wrapUpRequested,
+                toolBudget: singleResult.toolBudget,
+                toolBudgetBlocked: singleResult.toolBudgetBlocked,
+            });
+            if (seqStep.outputName) {
+                outputs[seqStep.outputName] = outputEntryFromAsyncResult({
+                    agent: singleResult.agent,
+                    output: singleResult.output,
+                    structuredOutput: singleResult.structuredOutput,
+                }, stepIndex);
+            }
+            statusPayload.outputs = outputs;
+            const cumulativeTokens = config.sessionDir ? parseSessionTokens(config.sessionDir) : null;
+            let stepTokens = cumulativeTokens
+                ? {
+                    input: cumulativeTokens.input - previousCumulativeTokens.input,
+                    output: cumulativeTokens.output - previousCumulativeTokens.output,
+                    total: cumulativeTokens.total - previousCumulativeTokens.total,
+                }
+                : null;
+            if (cumulativeTokens) {
+                previousCumulativeTokens = cumulativeTokens;
+            }
+            else {
+                stepTokens = tokenUsageFromAttempts(singleResult.modelAttempts);
+                if (stepTokens) {
+                    previousCumulativeTokens = {
+                        input: previousCumulativeTokens.input + stepTokens.input,
+                        output: previousCumulativeTokens.output + stepTokens.output,
+                        total: previousCumulativeTokens.total + stepTokens.total,
+                    };
+                }
+            }
+            const stepEndTime = Date.now();
+            const childInterrupted = singleResult.interrupted === true;
+            statusPayload.steps[flatIndex].status = stopped || childStopped ? "stopped" : timedOut ? "failed" : childInterrupted ? "paused" : singleResult.exitCode === 0 ? "complete" : "failed";
+            statusPayload.steps[flatIndex].endedAt = stepEndTime;
+            statusPayload.steps[flatIndex].durationMs = stepEndTime - stepStartTime;
+            statusPayload.steps[flatIndex].exitCode = stopped || childStopped ? 1 : timedOut ? 1 : childInterrupted ? 0 : singleResult.exitCode;
+            statusPayload.steps[flatIndex].timedOut = timedOut || singleResult.timedOut ? true : undefined;
+            statusPayload.steps[flatIndex].stopped = stopped || childStopped ? true : undefined;
+            statusPayload.steps[flatIndex].turnBudget = singleResult.turnBudget;
+            statusPayload.steps[flatIndex].turnBudgetExceeded = singleResult.turnBudgetExceeded;
+            statusPayload.steps[flatIndex].wrapUpRequested = singleResult.wrapUpRequested;
+            statusPayload.steps[flatIndex].toolBudget = singleResult.toolBudget;
+            statusPayload.steps[flatIndex].toolBudgetBlocked = singleResult.toolBudgetBlocked;
+            if (singleResult.toolBudget)
+                statusPayload.toolBudget = singleResult.toolBudget;
+            if (singleResult.toolBudgetBlocked)
+                statusPayload.toolBudgetBlocked = true;
+            if (singleResult.turnBudget)
+                statusPayload.turnBudget = singleResult.turnBudget;
+            if (singleResult.turnBudgetExceeded)
+                statusPayload.turnBudgetExceeded = true;
+            if (singleResult.wrapUpRequested)
+                statusPayload.wrapUpRequested = true;
+            statusPayload.steps[flatIndex].model = singleResult.model;
+            statusPayload.steps[flatIndex].thinking = resolveEffectiveThinking(singleResult.model, statusPayload.steps[flatIndex].thinking);
+            statusPayload.steps[flatIndex].attemptedModels = singleResult.attemptedModels;
+            statusPayload.steps[flatIndex].modelAttempts = singleResult.modelAttempts;
+            statusPayload.steps[flatIndex].totalCost = singleResult.totalCost;
+            statusPayload.steps[flatIndex].error = stopped || childStopped ? stopMessage : timedOut ? (timeoutMessage ?? "Subagent timed out.") : singleResult.error;
+            statusPayload.steps[flatIndex].transcriptPath = singleResult.transcriptPath ?? statusPayload.steps[flatIndex].transcriptPath;
+            statusPayload.steps[flatIndex].transcriptError = singleResult.transcriptError;
+            statusPayload.steps[flatIndex].structuredOutput = singleResult.structuredOutput;
+            statusPayload.steps[flatIndex].structuredOutputPath = singleResult.structuredOutputPath;
+            statusPayload.steps[flatIndex].structuredOutputSchemaPath = singleResult.structuredOutputSchemaPath;
+            statusPayload.steps[flatIndex].acceptance = singleResult.acceptance;
+            statusPayload.steps[flatIndex].watchdog = singleResult.watchdog;
+            if (stepTokens) {
+                statusPayload.steps[flatIndex].tokens = stepTokens;
+                statusPayload.totalTokens = { ...previousCumulativeTokens };
+            }
+            statusPayload.lastUpdate = stepEndTime;
+            writeStatusPayload();
+            appendJsonl(eventsPath, JSON.stringify({
+                type: stopped || childStopped ? "subagent.step.stopped" : timedOut ? "subagent.step.failed" : childInterrupted ? "subagent.step.paused" : singleResult.exitCode === 0 ? "subagent.step.completed" : "subagent.step.failed",
+                ts: stepEndTime,
+                runId: id,
+                stepIndex: flatIndex,
+                agent: seqStep.agent,
+                exitCode: stopped || childStopped ? 1 : timedOut ? 1 : childInterrupted ? 0 : singleResult.exitCode,
+                durationMs: stepEndTime - stepStartTime,
+                tokens: stepTokens,
+            }));
+            if (singleResult.completionGuardTriggered) {
+                const event = buildControlEvent({
+                    from: statusPayload.steps[flatIndex].activityState,
+                    to: "needs_attention",
+                    runId: id,
+                    agent: seqStep.agent,
+                    index: flatIndex,
+                    ts: stepEndTime,
+                    message: `${seqStep.agent} completed without making edits for an implementation task`,
+                    reason: "completion_guard",
+                });
+                appendControlEvent(event);
+            }
+            flatIndex++;
+            if (singleResult.exitCode !== 0) {
+                break;
+            }
+        }
+    }
+    let summary = results.map((r) => `${r.agent}:\n${r.output}`).join("\n\n");
+    let truncated = false;
+    if (maxOutput) {
+        const config = { ...DEFAULT_MAX_OUTPUT, ...maxOutput };
+        const lastArtifactPath = results[results.length - 1]?.artifactPaths?.outputPath;
+        const truncResult = truncateOutput(summary, config, lastArtifactPath);
+        if (truncResult.truncated) {
+            summary = truncResult.text;
+            truncated = true;
+        }
+    }
+    const resultMode = config.resultMode ?? statusPayload.mode;
+    const totalCost = results.reduce((sum, result) => ({
+        inputTokens: sum.inputTokens + (result.totalCost?.inputTokens ?? 0),
+        outputTokens: sum.outputTokens + (result.totalCost?.outputTokens ?? 0),
+        costUsd: sum.costUsd + (result.totalCost?.costUsd ?? 0),
+    }), { inputTokens: 0, outputTokens: 0, costUsd: 0 });
+    const finalTotalCost = totalCost.inputTokens > 0 || totalCost.outputTokens > 0 || totalCost.costUsd > 0 ? totalCost : undefined;
+    const finalFlatAgents = statusPayload.steps.map((step) => step.agent);
+    const agentName = finalFlatAgents.length === 1
+        ? finalFlatAgents[0]
+        : resultMode === "parallel"
+            ? `parallel:${finalFlatAgents.join("+")}`
+            : `chain:${finalFlatAgents.join("->")}`;
+    let sessionFile;
+    let shareUrl;
+    let gistUrl;
+    let shareError;
+    if (shareEnabled) {
+        sessionFile = config.sessionDir
+            ? (findLatestSessionFile(config.sessionDir) ?? undefined)
+            : undefined;
+        if (!sessionFile && latestSessionFile) {
+            sessionFile = latestSessionFile;
+        }
+        if (sessionFile) {
+            try {
+                const exportDir = config.sessionDir ?? path.dirname(sessionFile);
+                const htmlPath = await exportSessionHtml(sessionFile, exportDir, config.piPackageRoot);
+                const share = createShareLink(htmlPath);
+                if ("error" in share)
+                    shareError = share.error;
+                else {
+                    shareUrl = share.shareUrl;
+                    gistUrl = share.gistUrl;
+                }
+            }
+            catch (err) {
+                shareError = String(err);
+            }
+        }
+        else {
+            shareError = "Session file not found.";
+        }
+    }
+    if (activityTimer) {
+        clearInterval(activityTimer);
+        activityTimer = undefined;
+    }
+    if (timeoutTimer) {
+        clearTimeout(timeoutTimer);
+        timeoutTimer = undefined;
+    }
+    statusPayload.state = stopped ? "stopped" : timedOut || turnBudgetExceeded ? "failed" : interrupted ? "paused" : results.every((r) => r.success) ? "complete" : "failed";
+    closeSteerInbox(asyncDir, statusPayload.state);
+    disposeControlInbox();
+    for (const request of consumeSteerRequests(asyncDir))
+        deliverSteerRequest(request);
+    const effectiveSessionFile = sessionFile ?? latestSessionFile;
+    const steeringLifecycle = steeringStatus(statusPayload);
+    for (const request of steeringLifecycle.recent) {
+        let changed = false;
+        for (const target of request.targets) {
+            if (target.state !== "scheduled" && target.state !== "routed")
+                continue;
+            changed = true;
+            updateSteeringLifecycleTarget(request.id, target.index, "failed", Date.now(), { reason: "child terminated before steering delivery" });
+            markSteeringAttention(target.index);
+            emitSteeringEvent("subagent.steer.failed", { type: "steer", id: request.id, ts: request.requestedAt, message: "child terminated before steering delivery" }, target.index, { reason: "child terminated before steering delivery" });
+        }
+        if (changed)
+            emitTerminalSteeringNotice(request.id, `Steering failed for run ${id}: child terminated before delivery.`);
+    }
+    const runEndedAt = Date.now();
+    statusPayload.activityState = undefined;
+    if (stopped) {
+        statusPayload.stopped = true;
+        statusPayload.error = stopMessage;
+    }
+    if (timedOut) {
+        statusPayload.timedOut = true;
+        statusPayload.error = timeoutMessage ?? "Subagent timed out.";
+    }
+    if (turnBudgetExceeded && !statusPayload.error) {
+        const budget = statusPayload.turnBudget;
+        statusPayload.error = budget ? turnBudgetExceededMessage(budget, budget.turnCount) : "Subagent exceeded turn budget.";
+    }
+    statusPayload.endedAt = runEndedAt;
+    statusPayload.lastUpdate = runEndedAt;
+    statusPayload.sessionFile = effectiveSessionFile;
+    statusPayload.totalCost = finalTotalCost;
+    statusPayload.shareUrl = shareUrl;
+    statusPayload.gistUrl = gistUrl;
+    statusPayload.shareError = shareError;
+    if (statusPayload.state === "failed" && !statusPayload.error) {
+        const failedStep = statusPayload.steps.find((s) => s.status === "failed");
+        if (failedStep?.agent) {
+            statusPayload.error = `Step failed: ${failedStep.agent}`;
+        }
+    }
+    writeStatusPayload();
+    appendJsonl(eventsPath, JSON.stringify({
+        type: "subagent.run.completed",
+        lifecycleArtifactVersion: SUBAGENT_LIFECYCLE_ARTIFACT_VERSION,
+        ts: runEndedAt,
+        runId: id,
+        status: statusPayload.state,
+        durationMs: runEndedAt - overallStartTime,
+        totalTokens: statusPayload.totalTokens,
+        totalCost: finalTotalCost,
+    }));
+    writeRunLog(logPath, {
+        id,
+        mode: statusPayload.mode,
+        cwd,
+        startedAt: overallStartTime,
+        endedAt: runEndedAt,
+        steps: statusPayload.steps.map((step) => ({
+            agent: step.agent,
+            status: step.status,
+            durationMs: step.durationMs,
+        })),
+        summary,
+        truncated,
+        artifactsDir,
+        sessionFile: effectiveSessionFile,
+        shareUrl,
+        shareError,
+    });
+    try {
+        writeAtomicJson(resultPath, {
+            lifecycleArtifactVersion: SUBAGENT_LIFECYCLE_ARTIFACT_VERSION,
+            id,
+            agent: agentName,
+            mode: resultMode,
+            success: !stopped && !timedOut && !turnBudgetExceeded && !interrupted && results.every((r) => r.success),
+            state: stopped ? "stopped" : timedOut || turnBudgetExceeded ? "failed" : interrupted ? "paused" : results.every((r) => r.success) ? "complete" : "failed",
+            summary: stopped ? stopMessage : timedOut ? (timeoutMessage ?? "Subagent timed out.") : turnBudgetExceeded ? (statusPayload.error ?? "Subagent exceeded turn budget.") : interrupted ? "Paused after interrupt. Waiting for explicit next action." : summary,
+            ...(config.timeoutMs !== undefined ? { timeoutMs: config.timeoutMs } : {}),
+            ...(config.deadlineAt !== undefined ? { deadlineAt: config.deadlineAt } : {}),
+            ...(statusPayload.turnBudget ? { turnBudget: statusPayload.turnBudget } : {}),
+            ...(statusPayload.turnBudgetExceeded ? { turnBudgetExceeded: true } : {}),
+            ...(statusPayload.wrapUpRequested ? { wrapUpRequested: true } : {}),
+            ...(statusPayload.toolBudget ? { toolBudget: statusPayload.toolBudget } : {}),
+            ...(statusPayload.toolBudgetBlocked ? { toolBudgetBlocked: true } : {}),
+            ...(stopped ? { stopped: true, error: stopMessage } : timedOut ? { timedOut: true, error: timeoutMessage ?? "Subagent timed out." } : turnBudgetExceeded ? { error: statusPayload.error ?? "Subagent exceeded turn budget." } : {}),
+            results: results.map((r) => ({
+                childId: r.childId,
+                description: r.description,
+                permissions: r.permissions,
+                agent: r.agent,
+                output: r.output,
+                error: r.error,
+                protocolError: r.protocolError,
+                success: r.success,
+                skipped: r.skipped || undefined,
+                interrupted: r.interrupted || undefined,
+                timedOut: r.timedOut || undefined,
+                stopped: r.stopped || undefined,
+                turnBudget: r.turnBudget,
+                turnBudgetExceeded: r.turnBudgetExceeded || undefined,
+                wrapUpRequested: r.wrapUpRequested || undefined,
+                toolBudget: r.toolBudget,
+                toolBudgetBlocked: r.toolBudgetBlocked || undefined,
+                sessionFile: r.sessionFile,
+                intercomTarget: r.intercomTarget,
+                model: r.model,
+                attemptedModels: r.attemptedModels,
+                modelAttempts: r.modelAttempts,
+                totalCost: r.totalCost,
+                artifactPaths: r.artifactPaths,
+                truncated: r.truncated,
+                transcriptPath: r.transcriptPath,
+                transcriptError: r.transcriptError,
+                structuredOutput: r.structuredOutput,
+                structuredOutputPath: r.structuredOutputPath,
+                structuredOutputSchemaPath: r.structuredOutputSchemaPath,
+                acceptance: r.acceptance,
+                watchdog: r.watchdog,
+            })),
+            outputs,
+            workflowGraph: statusPayload.workflowGraph,
+            exitCode: stopped || timedOut || turnBudgetExceeded ? 1 : interrupted || results.every((r) => r.success) ? 0 : 1,
+            timestamp: runEndedAt,
+            durationMs: runEndedAt - overallStartTime,
+            totalTokens: statusPayload.totalTokens,
+            totalCost: finalTotalCost,
+            truncated,
+            artifactsDir,
+            cwd,
+            asyncDir,
+            sessionId: config.sessionId,
+            sessionFile: effectiveSessionFile,
+            intercomTarget: config.controlIntercomTarget,
+            shareUrl,
+            gistUrl,
+            shareError,
+            ...(taskIndex !== undefined && { taskIndex }),
+            ...(totalTasks !== undefined && { totalTasks }),
+        });
+    }
+    catch (err) {
+        console.error(`Failed to write result file ${resultPath}:`, err);
+    }
+}
+async function waitForStartupControl(controlPath, token, action, timeoutMs = 30_000) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() <= deadline) {
+        if (fs.existsSync(controlPath)) {
+            let payload;
+            try {
+                payload = JSON.parse(fs.readFileSync(controlPath, "utf-8"));
+            }
+            catch (error) {
+                throw new Error(`Failed to read runner startup control '${controlPath}': ${error instanceof Error ? error.message : String(error)}`);
+            }
+            if (payload.token !== token)
+                throw new Error("Runner startup control token does not match the acquired session lease.");
+            if (payload.action === action)
+                return;
+            if (payload.action !== "ack" && payload.action !== "proceed")
+                throw new Error("Runner startup control action is invalid.");
+        }
+        await new Promise((resolve) => setTimeout(resolve, 20));
+    }
+    throw new Error(`Timed out after ${timeoutMs}ms waiting for runner startup control '${action}'.`);
+}
+async function runConfiguredSubagent(config) {
+    let lease;
+    let startupCommitted = config.revivalLease === undefined;
+    const startupPath = path.join(config.asyncDir, "runner-startup.json");
+    const startupAckPath = path.join(config.asyncDir, "runner-startup-ack.json");
+    const startupProceedPath = path.join(config.asyncDir, "runner-startup-proceed.json");
+    const releaseOnExit = () => {
+        try {
+            lease?.release();
+        }
+        catch {
+            // Exit cleanup is best effort; a dead-owner lease is reclaimed on the next revival.
+        }
+    };
+    process.once("exit", releaseOnExit);
+    try {
+        if (config.revivalLease) {
+            lease = acquireSessionLease(config.revivalLease);
+            writeAtomicJson(startupPath, { state: "ready", token: lease.owner.token, pid: process.pid, owner: lease.owner });
+            await waitForStartupControl(startupAckPath, lease.owner.token, "ack");
+            writeAtomicJson(startupPath, { state: "acknowledged", token: lease.owner.token, pid: process.pid });
+            await waitForStartupControl(startupProceedPath, lease.owner.token, "proceed");
+            startupCommitted = true;
+            for (const controlPath of [startupAckPath, startupProceedPath]) {
+                try {
+                    fs.rmSync(controlPath, { force: true });
+                }
+                catch {
+                    // Startup control cleanup is best effort after the parent commits the run.
+                }
+            }
+        }
+        await runSubagent(config, lease ? (writer) => lease.updateWriter(writer) : undefined);
+    }
+    catch (error) {
+        if (config.revivalLease && !startupCommitted) {
+            try {
+                writeAtomicJson(startupPath, { state: "error", pid: process.pid, error: error instanceof Error ? error.message : String(error) });
+            }
+            catch {
+                // The parent will time out and terminate this runner if the handshake cannot be written.
+            }
+        }
+        throw error;
+    }
+    finally {
+        process.off("exit", releaseOnExit);
+        if (lease) {
+            try {
+                lease.release();
+            }
+            catch (error) {
+                console.error("Failed to release session revival lease:", error);
+            }
+        }
+    }
+}
+function startConfiguredSubagent(config) {
+    runConfiguredSubagent(config).catch((runErr) => {
+        console.error("Subagent runner error:", runErr);
+        process.exit(1);
+    });
+}
+const configArg = process.argv[2];
+if (configArg) {
+    try {
+        const configJson = fs.readFileSync(configArg, "utf-8");
+        const config = JSON.parse(configJson);
+        try {
+            fs.unlinkSync(configArg);
+        }
+        catch {
+            // Temp config cleanup is best effort.
+        }
+        startConfiguredSubagent(config);
+    }
+    catch (err) {
+        console.error("Subagent runner error:", err);
+        process.exit(1);
+    }
+}
+else {
+    let input = "";
+    process.stdin.setEncoding("utf-8");
+    process.stdin.on("data", (chunk) => {
+        input += chunk;
+    });
+    process.stdin.on("end", () => {
+        try {
+            const config = JSON.parse(input);
+            startConfiguredSubagent(config);
+        }
+        catch (err) {
+            console.error("Subagent runner error:", err);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=subagent-runner.js.map