@duckmind/dm-darwin-x64 0.43.4 → 0.48.5

package/extensions/dm-subagents/src/runs/background/async-status.ts

@@ -1,395 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { formatDuration, formatModelThinking, formatTokens, shortenPath } from "../../shared/formatters.ts";
-import { formatActivityLabel, formatParallelOutcome } from "../../shared/status-format.ts";
-import { type ActivityState, type AsyncJobStep, type AsyncParallelGroupStatus, type AsyncStatus, type CostSummary, type NestedRunSummary, type SubagentRunMode, type TokenUsage, type TurnBudgetState } from "../../shared/types.ts";
-import { readStatus } from "../../shared/utils.ts";
-import { attachRootChildrenToSteps, buildNestedRouteIndex, type NestedRoute, projectNestedEvents } from "../shared/nested-events.ts";
-import { formatNestedRunStatusLines } from "../shared/nested-render.ts";
-import { flatToLogicalStepIndex, normalizeParallelGroups } from "./parallel-groups.ts";
-import { reconcileAsyncRun, reconcileNestedAsyncDescendants } from "./stale-run-reconciler.ts";
-
-interface AsyncRunStepSummary {
-	index: number;
-	agent: string;
-	label?: string;
-	phase?: string;
-	outputName?: string;
-	structured?: boolean;
-	status: AsyncJobStep["status"];
-	activityState?: ActivityState;
-	lastActivityAt?: number;
-	currentTool?: string;
-	currentToolArgs?: string;
-	currentToolStartedAt?: number;
-	currentPath?: string;
-	recentTools?: Array<{ tool: string; args: string; endMs: number }>;
-	recentOutput?: string[];
-	turnCount?: number;
-	toolCount?: number;
-	steerCount?: number;
-	lastSteerAt?: number;
-	durationMs?: number;
-	tokens?: TokenUsage;
-	totalCost?: CostSummary;
-	skills?: string[];
-	model?: string;
-	thinking?: string;
-	attemptedModels?: string[];
-	error?: string;
-	timedOut?: boolean;
-	turnBudget?: TurnBudgetState;
-	turnBudgetExceeded?: boolean;
-	wrapUpRequested?: boolean;
-	children?: NestedRunSummary[];
-}
-
-export interface AsyncRunSummary {
-	id: string;
-	asyncDir: string;
-	sessionId?: string;
-	state: "queued" | "running" | "complete" | "failed" | "paused";
-	error?: string;
-	activityState?: ActivityState;
-	lastActivityAt?: number;
-	currentTool?: string;
-	currentToolStartedAt?: number;
-	currentPath?: string;
-	turnCount?: number;
-	toolCount?: number;
-	steerCount?: number;
-	lastSteerAt?: number;
-	mode: SubagentRunMode;
-	cwd?: string;
-	startedAt: number;
-	lastUpdate?: number;
-	endedAt?: number;
-	timeoutMs?: number;
-	deadlineAt?: number;
-	timedOut?: boolean;
-	turnBudget?: TurnBudgetState;
-	turnBudgetExceeded?: boolean;
-	wrapUpRequested?: boolean;
-	currentStep?: number;
-	chainStepCount?: number;
-	pendingAppends?: number;
-	parallelGroups?: AsyncParallelGroupStatus[];
-	steps: AsyncRunStepSummary[];
-	sessionDir?: string;
-	outputFile?: string;
-	totalTokens?: TokenUsage;
-	totalCost?: CostSummary;
-	sessionFile?: string;
-	nestedChildren?: NestedRunSummary[];
-	nestedWarnings?: string[];
-}
-
-interface AsyncRunListOptions {
-	states?: Array<AsyncRunSummary["state"]>;
-	sessionId?: string;
-	limit?: number;
-	resultsDir?: string;
-	kill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;
-	now?: () => number;
-	reconcile?: boolean;
-}
-
-function getErrorMessage(error: unknown): string {
-	return error instanceof Error ? error.message : String(error);
-}
-
-function isNotFoundError(error: unknown): boolean {
-	return typeof error === "object"
-		&& error !== null
-		&& "code" in error
-		&& (error as NodeJS.ErrnoException).code === "ENOENT";
-}
-
-function isAsyncRunDir(root: string, entry: string): boolean {
-	const entryPath = path.join(root, entry);
-	try {
-		return fs.statSync(entryPath).isDirectory();
-	} catch (error) {
-		if (isNotFoundError(error)) return false;
-		throw new Error(`Failed to inspect async run path '${entryPath}': ${getErrorMessage(error)}`, {
-			cause: error instanceof Error ? error : undefined,
-		});
-	}
-}
-
-function outputFileMtime(outputFile: string | undefined): number | undefined {
-	if (!outputFile) return undefined;
-	try {
-		return fs.statSync(outputFile).mtimeMs;
-	} catch (error) {
-		if (isNotFoundError(error)) return undefined;
-		throw new Error(`Failed to inspect async output file '${outputFile}': ${getErrorMessage(error)}`, {
-			cause: error instanceof Error ? error : undefined,
-		});
-	}
-}
-
-function deriveAsyncActivityState(asyncDir: string, status: AsyncStatus): { activityState?: ActivityState; lastActivityAt?: number } {
-	if (status.state !== "running") return { activityState: status.activityState, lastActivityAt: status.lastActivityAt };
-	const outputPath = status.outputFile ? (path.isAbsolute(status.outputFile) ? status.outputFile : path.join(asyncDir, status.outputFile)) : undefined;
-	const currentStep = typeof status.currentStep === "number" ? status.steps?.[status.currentStep] : undefined;
-	return {
-		activityState: status.activityState,
-		lastActivityAt: status.lastActivityAt ?? outputFileMtime(outputPath) ?? currentStep?.lastActivityAt ?? currentStep?.startedAt ?? status.startedAt,
-	};
-}
-
-function statusToSummary(asyncDir: string, status: AsyncStatus & { cwd?: string }, nestedWarnings: string[] = [], nestedRoute?: NestedRoute): AsyncRunSummary {
-	if (status.sessionId !== undefined && typeof status.sessionId !== "string") {
-		throw new Error(`Invalid async status '${path.join(asyncDir, "status.json")}': sessionId must be a string.`);
-	}
-	const { activityState, lastActivityAt } = deriveAsyncActivityState(asyncDir, status);
-	const steps = status.steps ?? [];
-	const chainStepCount = status.chainStepCount ?? steps.length;
-	const parallelGroups = normalizeParallelGroups(status.parallelGroups, steps.length, chainStepCount);
-	let nestedChildren: NestedRunSummary[] = [];
-	if (nestedWarnings.length === 0 && nestedRoute) {
-		try {
-			// The route is resolved by the caller via buildNestedRouteIndex, so this
-			// avoids a fresh scan of the nested-events directory per run.
-			nestedChildren = projectNestedEvents(nestedRoute)?.children ?? [];
-		} catch (error) {
-			nestedWarnings.push(`Nested status unavailable: ${getErrorMessage(error)}`);
-		}
-	}
-	const summarizedSteps = steps.map((step, index) => {
-		const stepActivityState = step.activityState;
-		const stepLastActivityAt = step.lastActivityAt;
-		return {
-			index,
-			agent: step.agent,
-			...(step.label ? { label: step.label } : {}),
-			...(step.phase ? { phase: step.phase } : {}),
-			...(step.outputName ? { outputName: step.outputName } : {}),
-			...(step.structured ? { structured: step.structured } : {}),
-			status: step.status,
-			...(stepActivityState ? { activityState: stepActivityState } : {}),
-			...(stepLastActivityAt ? { lastActivityAt: stepLastActivityAt } : {}),
-			...(step.currentTool ? { currentTool: step.currentTool } : {}),
-			...(step.currentToolArgs ? { currentToolArgs: step.currentToolArgs } : {}),
-			...(step.currentToolStartedAt ? { currentToolStartedAt: step.currentToolStartedAt } : {}),
-			...(step.currentPath ? { currentPath: step.currentPath } : {}),
-			...(step.recentTools ? { recentTools: step.recentTools.map((tool) => ({ ...tool })) } : {}),
-			...(step.recentOutput ? { recentOutput: [...step.recentOutput] } : {}),
-			...(step.turnCount !== undefined ? { turnCount: step.turnCount } : {}),
-			...(step.toolCount !== undefined ? { toolCount: step.toolCount } : {}),
-			...(step.steerCount !== undefined ? { steerCount: step.steerCount } : {}),
-			...(step.lastSteerAt !== undefined ? { lastSteerAt: step.lastSteerAt } : {}),
-			...(step.durationMs !== undefined ? { durationMs: step.durationMs } : {}),
-			...(step.tokens ? { tokens: step.tokens } : {}),
-			...(step.totalCost ? { totalCost: step.totalCost } : {}),
-			...(step.skills ? { skills: step.skills } : {}),
-			...(step.model ? { model: step.model } : {}),
-			...(step.thinking ? { thinking: step.thinking } : {}),
-			...(step.attemptedModels ? { attemptedModels: step.attemptedModels } : {}),
-			...(step.error ? { error: step.error } : {}),
-			...(step.timedOut !== undefined ? { timedOut: step.timedOut } : {}),
-			...(step.turnBudget ? { turnBudget: step.turnBudget } : {}),
-			...(step.turnBudgetExceeded !== undefined ? { turnBudgetExceeded: step.turnBudgetExceeded } : {}),
-			...(step.wrapUpRequested !== undefined ? { wrapUpRequested: step.wrapUpRequested } : {}),
-			...(step.children?.length ? { children: step.children } : {}),
-		};
-	});
-	attachRootChildrenToSteps(status.runId || path.basename(asyncDir), summarizedSteps, nestedChildren);
-	return {
-		id: status.runId || path.basename(asyncDir),
-		asyncDir,
-		...(status.sessionId ? { sessionId: status.sessionId } : {}),
-		state: status.state,
-		...(status.error ? { error: status.error } : {}),
-		activityState,
-		lastActivityAt,
-		currentTool: status.currentTool,
-		currentToolStartedAt: status.currentToolStartedAt,
-		currentPath: status.currentPath,
-		turnCount: status.turnCount,
-		toolCount: status.toolCount,
-		steerCount: status.steerCount,
-		lastSteerAt: status.lastSteerAt,
-		mode: status.mode,
-		cwd: status.cwd,
-		startedAt: status.startedAt,
-		lastUpdate: status.lastUpdate,
-		endedAt: status.endedAt,
-		...(status.timeoutMs !== undefined ? { timeoutMs: status.timeoutMs } : {}),
-		...(status.deadlineAt !== undefined ? { deadlineAt: status.deadlineAt } : {}),
-		...(status.timedOut !== undefined ? { timedOut: status.timedOut } : {}),
-		...(status.turnBudget ? { turnBudget: status.turnBudget } : {}),
-		...(status.turnBudgetExceeded !== undefined ? { turnBudgetExceeded: status.turnBudgetExceeded } : {}),
-		...(status.wrapUpRequested !== undefined ? { wrapUpRequested: status.wrapUpRequested } : {}),
-		currentStep: status.currentStep,
-		...(status.chainStepCount !== undefined ? { chainStepCount: status.chainStepCount } : {}),
-		...(status.pendingAppends !== undefined ? { pendingAppends: status.pendingAppends } : {}),
-		...(parallelGroups.length ? { parallelGroups } : {}),
-		steps: summarizedSteps,
-		...(nestedChildren.length ? { nestedChildren } : {}),
-		...(nestedWarnings.length ? { nestedWarnings } : {}),
-		...(status.sessionDir ? { sessionDir: status.sessionDir } : {}),
-		...(status.outputFile ? { outputFile: status.outputFile } : {}),
-		...(status.totalTokens ? { totalTokens: status.totalTokens } : {}),
-		...(status.totalCost ? { totalCost: status.totalCost } : {}),
-		...(status.sessionFile ? { sessionFile: status.sessionFile } : {}),
-	};
-}
-
-function sortRuns(runs: AsyncRunSummary[]): AsyncRunSummary[] {
-	const rank = (state: AsyncRunSummary["state"]): number => {
-		switch (state) {
-			case "running": return 0;
-			case "queued": return 1;
-			case "failed": return 2;
-			case "paused": return 2;
-			case "complete": return 3;
-		}
-	};
-	return [...runs].sort((a, b) => {
-		const byState = rank(a.state) - rank(b.state);
-		if (byState !== 0) return byState;
-		const aTime = a.lastUpdate ?? a.endedAt ?? a.startedAt;
-		const bTime = b.lastUpdate ?? b.endedAt ?? b.startedAt;
-		return bTime - aTime;
-	});
-}
-
-export function listAsyncRuns(asyncDirRoot: string, options: AsyncRunListOptions = {}): AsyncRunSummary[] {
-	let entries: string[];
-	try {
-		entries = fs.readdirSync(asyncDirRoot).filter((entry) => isAsyncRunDir(asyncDirRoot, entry));
-	} catch (error) {
-		if (isNotFoundError(error)) return [];
-		throw new Error(`Failed to list async runs in '${asyncDirRoot}': ${getErrorMessage(error)}`, {
-			cause: error instanceof Error ? error : undefined,
-		});
-	}
-
-	const allowedStates = options.states ? new Set(options.states) : undefined;
-	const runs: AsyncRunSummary[] = [];
-	// Route resolution for every run shares a single index built from the
-	// nested-events directory, so the per-run lookup is O(1) instead of scanning
-	// the directory once per run. The index is built lazily on first use, so
-	// load-time restoration (which only wants queued/running runs) skips it
-	// entirely when no active runs match.
-	let nestedRouteIndex: Map<string, NestedRoute> | undefined;
-	const resolveNestedRoute = (rootRunId: string): NestedRoute | undefined => {
-		if (!nestedRouteIndex) nestedRouteIndex = buildNestedRouteIndex();
-		return nestedRouteIndex.get(rootRunId);
-	};
-	for (const entry of entries) {
-		const asyncDir = path.join(asyncDirRoot, entry);
-		const reconciliation = options.reconcile === false
-			? undefined
-			: reconcileAsyncRun(asyncDir, { resultsDir: options.resultsDir, kill: options.kill, now: options.now });
-		const status = (reconciliation?.status ?? readStatus(asyncDir)) as (AsyncStatus & { cwd?: string }) | null;
-		if (!status) continue;
-		// Filter before the nested-route lookup: the lookup builds an index over
-		// the nested-events directory, so deferring it for filtered-out runs keeps
-		// restoration at load from scanning that directory when no active runs
-		// match.
-		if (allowedStates && !allowedStates.has(status.state)) continue;
-		if (options.sessionId && status.sessionId !== options.sessionId) continue;
-		const nestedWarnings: string[] = [];
-		let nestedRoute: NestedRoute | undefined;
-		try {
-			nestedRoute = resolveNestedRoute(status.runId || path.basename(asyncDir));
-			if (nestedRoute) reconcileNestedAsyncDescendants(nestedRoute, { resultsDir: options.resultsDir, kill: options.kill, now: options.now });
-		} catch (error) {
-			nestedWarnings.push(`Nested status unavailable: ${getErrorMessage(error)}`);
-		}
-		const summary = statusToSummary(asyncDir, status, nestedWarnings, nestedRoute);
-		runs.push(summary);
-	}
-
-	const sorted = sortRuns(runs);
-	return options.limit !== undefined ? sorted.slice(0, options.limit) : sorted;
-}
-
-function formatActivityFacts(input: { activityState?: ActivityState; lastActivityAt?: number; currentTool?: string; currentToolStartedAt?: number; currentPath?: string; turnCount?: number; toolCount?: number; steerCount?: number; lastSteerAt?: number; turnBudget?: TurnBudgetState; turnBudgetExceeded?: boolean; wrapUpRequested?: boolean }): string | undefined {
-	const facts: string[] = [];
-	if (input.currentTool && input.currentToolStartedAt !== undefined) facts.push(`tool ${input.currentTool} ${formatDuration(Math.max(0, Date.now() - input.currentToolStartedAt))}`);
-	else if (input.currentTool) facts.push(`tool ${input.currentTool}`);
-	if (input.currentPath) facts.push(shortenPath(input.currentPath));
-	if (input.turnCount !== undefined) facts.push(`${input.turnCount} turns`);
-	if (input.turnBudgetExceeded && input.turnBudget) facts.push(`turn budget exceeded ${input.turnBudget.turnCount}/${input.turnBudget.maxTurns}+${input.turnBudget.graceTurns}`);
-	else if (input.wrapUpRequested && input.turnBudget) facts.push(`wrap-up requested ${input.turnBudget.turnCount}/${input.turnBudget.maxTurns}`);
-	else if (input.turnBudget) facts.push(`turn budget ${input.turnBudget.turnCount}/${input.turnBudget.maxTurns}+${input.turnBudget.graceTurns}`);
-	if (input.toolCount !== undefined) facts.push(`${input.toolCount} tools`);
-	if (input.steerCount !== undefined) facts.push(`${input.steerCount} steers`);
-	if (typeof input.lastSteerAt === "number" && Number.isFinite(input.lastSteerAt)) facts.push(`last steer ${new Date(input.lastSteerAt).toISOString()}`);
-	const activity = formatActivityLabel(input.lastActivityAt, input.activityState);
-	return activity || facts.length ? [activity, ...facts].filter(Boolean).join(" | ") : undefined;
-}
-
-function formatStepLine(step: AsyncRunStepSummary): string {
-	const display = step.label ? `${step.label} (${step.agent})` : step.agent;
-	const phase = step.phase ? `[${step.phase}] ` : "";
-	const parts = [`${step.index + 1}. ${phase}${display}`, step.status];
-	const activity = formatActivityFacts(step);
-	if (activity) parts.push(activity);
-	const modelThinking = formatModelThinking(step.model, step.thinking);
-	if (modelThinking) parts.push(modelThinking);
-	if (step.durationMs !== undefined) parts.push(formatDuration(step.durationMs));
-	if (step.tokens) parts.push(`${formatTokens(step.tokens.total)} tok`);
-	return parts.join(" | ");
-}
-
-export function formatAsyncRunOutputPath(run: Pick<AsyncRunSummary, "asyncDir" | "outputFile">): string | undefined {
-	if (!run.outputFile) return undefined;
-	return path.isAbsolute(run.outputFile) ? run.outputFile : path.join(run.asyncDir, run.outputFile);
-}
-
-export function formatAsyncRunProgressLabel(run: Pick<AsyncRunSummary, "mode" | "state" | "currentStep" | "chainStepCount" | "parallelGroups" | "steps">): string {
-	const stepCount = run.steps.length || 1;
-	const chainStepCount = run.chainStepCount ?? stepCount;
-	const groups = normalizeParallelGroups(run.parallelGroups, run.steps.length, chainStepCount);
-	const activeGroup = run.currentStep !== undefined
-		? groups.find((group) => run.currentStep! >= group.start && run.currentStep! < group.start + group.count)
-		: undefined;
-	if (activeGroup) {
-		const groupSteps = run.steps.slice(activeGroup.start, activeGroup.start + activeGroup.count);
-		const groupLabel = formatParallelOutcome(groupSteps, activeGroup.count, { showRunning: run.state === "running" });
-		if (run.mode === "parallel") return groupLabel;
-		return `step ${activeGroup.stepIndex + 1}/${chainStepCount} · parallel group: ${groupLabel}`;
-	}
-	if (run.mode === "parallel") return formatParallelOutcome(run.steps, stepCount, { showRunning: run.state === "running" });
-	if (run.mode === "chain" && run.currentStep !== undefined && groups.length > 0) {
-		const logicalStep = flatToLogicalStepIndex(run.currentStep, chainStepCount, groups);
-		return `step ${logicalStep + 1}/${chainStepCount}`;
-	}
-	return run.currentStep !== undefined ? `step ${run.currentStep + 1}/${stepCount}` : `steps ${stepCount}`;
-}
-
-function formatRunHeader(run: AsyncRunSummary): string {
-	const stepLabel = formatAsyncRunProgressLabel(run);
-	const cwd = run.cwd ? shortenPath(run.cwd) : shortenPath(run.asyncDir);
-	const activity = formatActivityFacts(run);
-	const pending = run.pendingAppends ? ` | ${run.pendingAppends} pending append${run.pendingAppends === 1 ? "" : "s"}` : "";
-	return `${run.id} | ${run.state}${activity ? ` | ${activity}` : ""} | ${run.mode} | ${stepLabel}${pending} | ${cwd}`;
-}
-
-export function formatAsyncRunList(runs: AsyncRunSummary[], heading = "Active async runs"): string {
-	if (runs.length === 0) return `No ${heading.toLowerCase()}.`;
-
-	const lines = [`${heading}: ${runs.length}`, ""];
-	for (const run of runs) {
-		lines.push(`- ${formatRunHeader(run)}`);
-		for (const step of run.steps) {
-			lines.push(`  ${formatStepLine(step)}`);
-			lines.push(...formatNestedRunStatusLines(step.children, { indent: "    ", maxLines: 12 }));
-		}
-		const attached = new Set(run.steps.flatMap((step) => step.children?.map((child) => child.id) ?? []));
-		const unattached = run.nestedChildren?.filter((child) => !attached.has(child.id)) ?? [];
-		lines.push(...formatNestedRunStatusLines(unattached, { indent: "  ", maxLines: 12 }));
-		if (run.error) lines.push(`  Error: ${run.error}`);
-		for (const warning of run.nestedWarnings ?? []) lines.push(`  Warning: ${warning}`);
-		const outputPath = formatAsyncRunOutputPath(run);
-		if (outputPath) lines.push(`  output: ${shortenPath(outputPath)}`);
-		if (run.sessionFile) lines.push(`  session: ${shortenPath(run.sessionFile)}`);
-		lines.push("");
-	}
-	return lines.join("\n").trimEnd();
-}

package/extensions/dm-subagents/src/runs/background/chain-append.ts

@@ -1,282 +0,0 @@
-import { randomUUID } from "node:crypto";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { writeAtomicJson } from "../../shared/atomic-json.ts";
-import { appendJsonl } from "../../shared/artifacts.ts";
-import type { AsyncParallelGroupStatus, AsyncStatus, WorkflowGraphNode, WorkflowGraphSnapshot } from "../../shared/types.ts";
-import { readStatus } from "../../shared/utils.ts";
-import type { DynamicRunnerGroup, ParallelStepGroup, RunnerStep, RunnerSubagentStep } from "../shared/parallel-utils.ts";
-import { isDynamicRunnerGroup, isParallelGroup } from "../shared/parallel-utils.ts";
-
-const APPEND_REQUESTS_DIR = "append-requests";
-
-export interface ChainAppendRequest {
-	id: string;
-	createdAt: number;
-	steps: RunnerStep[];
-}
-
-export interface ChainAppendResult {
-	request: ChainAppendRequest;
-	pendingCount: number;
-}
-
-type StatusStep = NonNullable<AsyncStatus["steps"]>[number];
-
-function appendDir(asyncDir: string): string {
-	return path.join(asyncDir, APPEND_REQUESTS_DIR);
-}
-
-function appendRequestPath(asyncDir: string, request: ChainAppendRequest): string {
-	return path.join(appendDir(asyncDir), `${request.createdAt}-${request.id}.json`);
-}
-
-function listAppendRequestFiles(asyncDir: string): string[] {
-	const dir = appendDir(asyncDir);
-	try {
-		return fs.readdirSync(dir)
-			.filter((entry) => entry.endsWith(".json"))
-			.map((entry) => path.join(dir, entry))
-			.sort();
-	} catch (error) {
-		if ((error as NodeJS.ErrnoException).code === "ENOENT") return [];
-		throw error;
-	}
-}
-
-export function countPendingChainAppendRequests(asyncDir: string): number {
-	return listAppendRequestFiles(asyncDir).length;
-}
-
-export function runnerStepOutputNames(steps: RunnerStep[]): string[] {
-	const names: string[] = [];
-	for (const step of steps) {
-		if (isParallelGroup(step)) {
-			names.push(...step.parallel.map((task) => task.outputName).filter((name): name is string => Boolean(name)));
-		} else if (isDynamicRunnerGroup(step)) {
-			if (step.collect.as) names.push(step.collect.as);
-		} else if (step.outputName) {
-			names.push(step.outputName);
-		}
-	}
-	return names;
-}
-
-export function enqueueChainAppendRequest(input: {
-	asyncDir: string;
-	runId: string;
-	steps: RunnerStep[];
-	now?: number;
-}): ChainAppendResult {
-	const status = readStatus(input.asyncDir);
-	if (!status) throw new Error(`No async run status found for '${input.runId}'.`);
-	if (status.runId !== input.runId) throw new Error(`Async run id mismatch: expected '${input.runId}', found '${status.runId}'.`);
-	if (status.mode !== "chain") throw new Error(`Run '${input.runId}' is ${status.mode}; only active chain runs accept appended steps.`);
-	if (status.state !== "running") throw new Error(`Run '${input.runId}' is ${status.state}; only running chain runs accept appended steps.`);
-	const stillInProgress = (status.steps ?? []).some((step) => step.status === "running" || step.status === "pending") || (status.pendingAppends ?? 0) > 0;
-	if (!stillInProgress) throw new Error(`Run '${input.runId}' has no running or pending chain steps left; append-step must target an in-progress chain.`);
-	if (input.steps.length === 0) throw new Error("append-step requires one chain step.");
-
-	const request: ChainAppendRequest = {
-		id: randomUUID(),
-		createdAt: input.now ?? Date.now(),
-		steps: input.steps,
-	};
-	fs.mkdirSync(appendDir(input.asyncDir), { recursive: true });
-	writeAtomicJson(appendRequestPath(input.asyncDir, request), request);
-	const pendingCount = countPendingChainAppendRequests(input.asyncDir);
-	const statusPath = path.join(input.asyncDir, "status.json");
-	const updatedStatus = { ...status, pendingAppends: pendingCount, lastUpdate: request.createdAt };
-	writeAtomicJson(statusPath, updatedStatus);
-	appendJsonl(path.join(input.asyncDir, "events.jsonl"), JSON.stringify({
-		type: "subagent.chain.append.requested",
-		ts: request.createdAt,
-		runId: input.runId,
-		requestId: request.id,
-		stepCount: input.steps.length,
-		pendingAppends: pendingCount,
-	}));
-	return { request, pendingCount };
-}
-
-function readAppendRequest(filePath: string): ChainAppendRequest | undefined {
-	const raw = JSON.parse(fs.readFileSync(filePath, "utf-8")) as Partial<ChainAppendRequest>;
-	if (!raw.id || typeof raw.id !== "string") return undefined;
-	if (!Number.isFinite(raw.createdAt)) return undefined;
-	if (!Array.isArray(raw.steps) || raw.steps.length === 0) return undefined;
-	return { id: raw.id, createdAt: raw.createdAt, steps: raw.steps as RunnerStep[] };
-}
-
-export function readPendingChainAppendRequests(asyncDir: string): ChainAppendRequest[] {
-	return listAppendRequestFiles(asyncDir)
-		.map((filePath) => readAppendRequest(filePath))
-		.filter((request): request is ChainAppendRequest => Boolean(request))
-		.sort((left, right) => left.createdAt - right.createdAt || left.id.localeCompare(right.id));
-}
-
-export function consumeChainAppendRequests(asyncDir: string): ChainAppendRequest[] {
-	const requests: ChainAppendRequest[] = [];
-	for (const filePath of listAppendRequestFiles(asyncDir)) {
-		const request = readAppendRequest(filePath);
-		try {
-			fs.unlinkSync(filePath);
-		} catch {
-			// The runner should not execute a consumed request twice.
-		}
-		if (request) requests.push(request);
-	}
-	return requests.sort((left, right) => left.createdAt - right.createdAt || left.id.localeCompare(right.id));
-}
-
-function statusStepForTask(task: RunnerSubagentStep): StatusStep {
-	return {
-		agent: task.agent,
-		phase: task.phase,
-		label: task.label,
-		outputName: task.outputName,
-		structured: task.structured,
-		status: "pending",
-		...(task.sessionFile ? { sessionFile: task.sessionFile } : {}),
-		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: [],
-	};
-}
-
-function statusStepsForRunnerStep(step: RunnerStep): StatusStep[] {
-	if (isParallelGroup(step)) return step.parallel.map(statusStepForTask);
-	if (isDynamicRunnerGroup(step)) {
-		return [{
-			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",
-			recentTools: [],
-			recentOutput: [],
-		}];
-	}
-	return [statusStepForTask(step)];
-}
-
-function pushPhase(graph: WorkflowGraphSnapshot, phase: string | undefined, nodeId: string): void {
-	if (!phase) return;
-	let group = graph.phases.find((candidate) => candidate.title === phase);
-	if (!group) {
-		group = { title: phase, nodeIds: [] };
-		graph.phases.push(group);
-	}
-	group.nodeIds.push(nodeId);
-}
-
-function graphNodeForSequential(step: RunnerSubagentStep, stepIndex: number, flatIndex: number): WorkflowGraphNode {
-	return {
-		id: `step-${stepIndex}`,
-		kind: "step",
-		agent: step.agent,
-		phase: step.phase,
-		label: step.label?.trim() || step.agent || `Step ${stepIndex + 1}`,
-		status: "pending",
-		flatIndex,
-		stepIndex,
-		outputName: step.outputName,
-		structured: step.structured,
-	};
-}
-
-function graphNodeForParallel(step: ParallelStepGroup, stepIndex: number, flatIndex: number, graph: WorkflowGraphSnapshot): WorkflowGraphNode {
-	const children = step.parallel.map((task, taskIndex) => {
-		const childId = `step-${stepIndex}-agent-${taskIndex}`;
-		pushPhase(graph, task.phase, childId);
-		return {
-			id: childId,
-			kind: "agent" as const,
-			agent: task.agent,
-			phase: task.phase,
-			label: task.label?.trim() || task.agent || `Agent ${taskIndex + 1}`,
-			status: "pending" as const,
-			flatIndex: flatIndex + taskIndex,
-			stepIndex,
-			outputName: task.outputName,
-			structured: task.structured,
-		};
-	});
-	return {
-		id: `step-${stepIndex}`,
-		kind: "parallel-group",
-		label: step.parallel.length === 1 ? "Parallel task" : `Parallel group (${step.parallel.length})`,
-		status: "pending",
-		stepIndex,
-		children,
-	};
-}
-
-function graphNodeForDynamic(step: DynamicRunnerGroup, stepIndex: number): WorkflowGraphNode {
-	return {
-		id: `step-${stepIndex}`,
-		kind: "dynamic-parallel-group",
-		label: step.label?.trim() || step.parallel.label?.trim() || `Dynamic fanout (${step.collect.as})`,
-		status: "pending",
-		stepIndex,
-		outputName: step.collect.as,
-		structured: Boolean(step.collect.outputSchema),
-		dynamic: {
-			sourceOutput: step.expand.from.output,
-			sourcePath: step.expand.from.path,
-			itemName: step.expand.item ?? "item",
-			maxItems: step.expand.maxItems,
-			collectAs: step.collect.as,
-		},
-		children: [],
-	};
-}
-
-function appendWorkflowNode(graph: WorkflowGraphSnapshot | undefined, step: RunnerStep, stepIndex: number, flatIndex: number): void {
-	if (!graph) return;
-	if (isParallelGroup(step)) {
-		graph.nodes.push(graphNodeForParallel(step, stepIndex, flatIndex, graph));
-		return;
-	}
-	if (isDynamicRunnerGroup(step)) {
-		graph.nodes.push(graphNodeForDynamic(step, stepIndex));
-		return;
-	}
-	const node = graphNodeForSequential(step, stepIndex, flatIndex);
-	graph.nodes.push(node);
-	pushPhase(graph, step.phase, node.id);
-}
-
-export function appendRunnerStepsToStatus(input: {
-	status: AsyncStatus;
-	steps: RunnerStep[];
-	now?: number;
-	pendingAppends?: number;
-}): { addedChainSteps: number; addedFlatSteps: number } {
-	let addedChainSteps = 0;
-	let addedFlatSteps = 0;
-	for (const step of input.steps) {
-		const stepIndex = input.status.chainStepCount ?? input.status.steps?.length ?? 0;
-		const flatIndex = input.status.steps?.length ?? 0;
-		const statusSteps = statusStepsForRunnerStep(step);
-		input.status.steps ??= [];
-		input.status.steps.push(...statusSteps);
-		if (isParallelGroup(step)) {
-			input.status.parallelGroups ??= [];
-			input.status.parallelGroups.push({ start: flatIndex, count: step.parallel.length, stepIndex });
-		} else if (isDynamicRunnerGroup(step)) {
-			input.status.parallelGroups ??= [];
-			input.status.parallelGroups.push({ start: flatIndex, count: 1, stepIndex });
-		}
-		appendWorkflowNode(input.status.workflowGraph, step, stepIndex, flatIndex);
-		input.status.chainStepCount = stepIndex + 1;
-		addedChainSteps++;
-		addedFlatSteps += statusSteps.length;
-	}
-	input.status.pendingAppends = input.pendingAppends ?? 0;
-	input.status.lastUpdate = input.now ?? Date.now();
-	return { addedChainSteps, addedFlatSteps };
-}