@bastani/atomic 0.9.12 → 0.9.13-alpha.1

package/dist/builtin/subagents/src/runs/background/async-execution-chain.ts

@@ -1,543 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { getEnvValue } from "@bastani/atomic";
-import { buildSkillInjection, normalizeSkillInput, resolveSkillsWithFallback } from "../../agents/skills.ts";
-import {
-	getSubagentCodexFastModeSettings,
-	resolveSubagentCodexFastModeScope,
-	resolveSubagentModelFastModeMetadata,
-} from "../../shared/fast-mode.ts";
-import { resolveEffectiveThinking } from "../../shared/model-info.ts";
-import {
-	buildChainInstructions,
-	isDynamicParallelStep,
-	isParallelStep,
-	type ResolvedStepBehavior,
-	resolveStepBehavior,
-	type SequentialStep,
-	type StepOverrides,
-	suppressProgressForReadOnlyTask,
-	writeInitialProgressFile,
-} from "../../shared/settings.ts";
-import {
-	ASYNC_DIR,
-	RESULTS_DIR,
-	resolveChildMaxSubagentDepth,
-	SUBAGENT_ASYNC_STARTED_EVENT,
-} from "../../shared/types.ts";
-import { workflowSessionEnv } from "../../shared/types-depth.ts";
-import { resolveChildCwd } from "../../shared/utils.ts";
-import { ChainOutputValidationError, validateChainOutputBindings } from "../shared/chain-outputs.ts";
-import { resolveChildIntercomGroup, sharedAutoGroupForSet } from "../shared/intercom-group.ts";
-import { filterSpawnableModelCandidates } from "../shared/model-candidate-filter.ts";
-import { buildModelCandidates, resolveModelCandidate } from "../shared/model-fallback.ts";
-import {
-	NESTED_RUNS_DIR,
-	nestedResultsPath,
-	resolveInheritedNestedRouteFromEnv,
-	resolveNestedParentAddressFromEnv,
-	writeNestedEvent,
-} from "../shared/nested-events.ts";
-import type { RunnerStep } from "../shared/parallel-utils.ts";
-import { applyThinkingSuffix, SUBAGENT_INTERCOM_SESSION_NAME_ENV } from "../shared/pi-args.ts";
-import {
-	injectSingleOutputInstruction,
-	resolveSingleOutputPath,
-	validateFileOnlyOutputMode,
-} from "../shared/single-output.ts";
-import { createStructuredOutputRuntime } from "../shared/structured-output.ts";
-import { buildWorkflowGraphSnapshot } from "../shared/workflow-graph.ts";
-import { resolveExpectedWorktreeAgentCwd } from "../shared/worktree.ts";
-import {
-	AsyncStartValidationError,
-	spawnRunner as defaultSpawnRunner,
-	formatAsyncStartError,
-	formatAsyncStartedMessage,
-	piPackageRoot,
-	UNAVAILABLE_SUBAGENT_SKILL_ERROR,
-	UnavailableSubagentSkillError,
-} from "./async-execution-common.ts";
-import type { AsyncChainParams, AsyncExecutionResult, AsyncSpawnResult } from "./async-execution-types.ts";
-
-/**
- * Execute a chain asynchronously
- */
-export function executeAsyncChain(id: string, params: AsyncChainParams): AsyncExecutionResult {
-	const {
-		chain,
-		agents,
-		ctx,
-		cwd,
-		maxOutput,
-		artifactsDir,
-		artifactConfig,
-		shareEnabled,
-		sessionRoot,
-		sessionFilesByFlatIndex,
-		maxSubagentDepth,
-		workflowStageSubagentGuard,
-		worktreeSetupHook,
-		worktreeSetupHookTimeoutMs,
-		controlConfig,
-		controlIntercomTarget,
-		childIntercomTarget,
-		supervisorAuthorizations,
-		dynamicSupervisorAuthorizations,
-		nestedRoute,
-		spawnRunner = defaultSpawnRunner,
-	} = params;
-	const resultMode = params.resultMode ?? "chain";
-	const chainSkills = params.chainSkills ?? [];
-	const availableModels = params.availableModels;
-	const knownModelProviders = params.knownModelProviders;
-	const fastModeScope = resolveSubagentCodexFastModeScope(workflowStageSubagentGuard);
-	const runnerCwd = resolveChildCwd(ctx.cwd, cwd);
-	const firstStep = chain[0];
-	const originalTask =
-		params.task ??
-		(firstStep
-			? isParallelStep(firstStep)
-				? firstStep.parallel[0]?.task
-				: isDynamicParallelStep(firstStep)
-					? firstStep.parallel.task
-					: (firstStep as SequentialStep).task
-			: undefined);
-	try {
-		validateChainOutputBindings(chain, { maxItems: params.dynamicFanoutMaxItems });
-	} catch (error) {
-		if (error instanceof ChainOutputValidationError) return formatAsyncStartError(resultMode, error.message);
-		throw error;
-	}
-	const workflowGraph = buildWorkflowGraphSnapshot({ runId: id, mode: resultMode, steps: chain });
-
-	for (const s of chain) {
-		const stepAgents = isParallelStep(s)
-			? s.parallel.map((t) => t.agent)
-			: isDynamicParallelStep(s)
-				? [s.parallel.agent]
-				: [(s as SequentialStep).agent];
-		for (const agentName of stepAgents) {
-			if (!agents.find((x) => x.name === agentName)) {
-				return {
-					content: [{ type: "text", text: `Unknown agent: ${agentName}` }],
-					isError: true,
-					details: { mode: resultMode, results: [] },
-				};
-			}
-		}
-	}
-
-	const inheritedNestedRoute = resolveInheritedNestedRouteFromEnv();
-	const nestedAddress = inheritedNestedRoute ? resolveNestedParentAddressFromEnv() : undefined;
-	const asyncDir = inheritedNestedRoute
-		? path.join(NESTED_RUNS_DIR, inheritedNestedRoute.rootRunId, id)
-		: path.join(ASYNC_DIR, id);
-	try {
-		fs.mkdirSync(asyncDir, { recursive: true });
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		return {
-			content: [{ type: "text", text: `Failed to create async run directory '${asyncDir}': ${message}` }],
-			isError: true,
-			details: { mode: resultMode, results: [] },
-		};
-	}
-
-	let progressInstructionCreated = false;
-	const buildStepOverrides = (s: SequentialStep): StepOverrides => {
-		const stepSkillInput = normalizeSkillInput(s.skill);
-		return {
-			...(s.output !== undefined ? { output: s.output } : {}),
-			...(s.outputMode !== undefined ? { outputMode: s.outputMode } : {}),
-			...(s.reads !== undefined ? { reads: s.reads } : {}),
-			...(s.progress !== undefined ? { progress: s.progress } : {}),
-			...(stepSkillInput !== undefined ? { skills: stepSkillInput } : {}),
-			...(s.model ? { model: s.model } : {}),
-		};
-	};
-	const buildSeqStep = (
-		s: SequentialStep,
-		sessionFile?: string,
-		behaviorCwd?: string,
-		progressPrecreated = false,
-		resolvedBehavior?: ResolvedStepBehavior,
-		setGroup?: string | true,
-		sharedAutoGroup?: string,
-	) => {
-		const a = agents.find((x) => x.name === s.agent)!;
-		const stepCwd = resolveChildCwd(runnerCwd, s.cwd);
-		const instructionCwd = behaviorCwd ?? stepCwd;
-		const behavior = suppressProgressForReadOnlyTask(
-			resolvedBehavior ?? resolveStepBehavior(a, buildStepOverrides(s), chainSkills),
-			s.task,
-			originalTask,
-		);
-		const skillNames = behavior.skills === false ? [] : behavior.skills;
-		const { resolved: resolvedSkills, missing: missingSkills } = resolveSkillsWithFallback(
-			skillNames,
-			stepCwd,
-			ctx.cwd,
-		);
-		if (missingSkills.includes("subagent")) throw new UnavailableSubagentSkillError(UNAVAILABLE_SUBAGENT_SKILL_ERROR);
-
-		let systemPrompt = a.systemPrompt?.trim() ?? "";
-		if (resolvedSkills.length > 0) {
-			const injection = buildSkillInjection(resolvedSkills);
-			systemPrompt = systemPrompt ? `${systemPrompt}\n\n${injection}` : injection;
-		}
-
-		const readInstructions = buildChainInstructions(
-			{ ...behavior, output: false, progress: false },
-			instructionCwd,
-			false,
-		);
-		const isFirstProgressAgent = behavior.progress && !progressPrecreated && !progressInstructionCreated;
-		if (behavior.progress) progressInstructionCreated = true;
-		const progressInstructions = buildChainInstructions(
-			{ ...behavior, output: false, reads: false },
-			runnerCwd,
-			isFirstProgressAgent,
-		);
-		const outputPath = resolveSingleOutputPath(behavior.output, ctx.cwd, instructionCwd);
-		const validationError = validateFileOnlyOutputMode(behavior.outputMode, outputPath, `Async step (${s.agent})`);
-		if (validationError) throw new AsyncStartValidationError(validationError);
-		let taskTemplate = s.task ?? "{previous}";
-		taskTemplate = taskTemplate.replace(/\{task\}/g, originalTask ?? "");
-		taskTemplate = taskTemplate.replace(/\{chain_dir\}/g, runnerCwd);
-		const task = injectSingleOutputInstruction(
-			`${readInstructions.prefix}${taskTemplate}${progressInstructions.suffix}`,
-			outputPath,
-		);
-
-		const primaryModel = resolveModelCandidate(behavior.model ?? a.model, availableModels, ctx.currentModelProvider);
-		const model = applyThinkingSuffix(primaryModel, a.thinking);
-		const rawModelCandidates = buildModelCandidates(
-			behavior.model ?? a.model,
-			a.fallbackModels,
-			availableModels,
-			ctx.currentModelProvider,
-			ctx.currentModel,
-			a.fallbackThinkingLevels,
-		)
-			.map((candidate) => applyThinkingSuffix(candidate, a.thinking))
-			.filter((candidate): candidate is string => typeof candidate === "string");
-		const filteredCandidates = filterSpawnableModelCandidates({
-			candidates: rawModelCandidates,
-			availableModels,
-			knownModelProviders,
-			currentModel: applyThinkingSuffix(ctx.currentModel, a.thinking),
-		});
-		const modelCandidates = filteredCandidates.candidates;
-		const fastModeSettings = getSubagentCodexFastModeSettings(stepCwd);
-		return {
-			agent: s.agent,
-			task,
-			phase: s.phase,
-			label: s.label,
-			outputName: s.as,
-			structured: Boolean(s.outputSchema),
-			intercomGroup: resolveChildIntercomGroup(
-				s.group ?? setGroup ?? params.group,
-				ctx.intercomGroup,
-				sharedAutoGroup,
-			),
-			cwd: stepCwd,
-			model,
-			thinking: resolveEffectiveThinking(model, a.thinking),
-			...resolveSubagentModelFastModeMetadata({
-				model,
-				modelCandidates,
-				cwd: stepCwd,
-				settings: fastModeSettings,
-				scope: fastModeScope,
-			}),
-			modelCandidates,
-			modelAttempts: filteredCandidates.skippedAttempts,
-			codexFastModeSettings: fastModeSettings,
-			codexFastModeScope: fastModeScope,
-			tools: a.tools,
-			extensions: a.extensions,
-			mcpDirectTools: a.mcpDirectTools,
-			systemPrompt,
-			systemPromptMode: a.systemPromptMode,
-			inheritProjectContext: a.inheritProjectContext,
-			inheritSkills: a.inheritSkills,
-			skills: resolvedSkills.map((r) => r.name),
-			outputPath,
-			outputMode: behavior.outputMode,
-			sessionFile,
-			maxSubagentDepth: resolveChildMaxSubagentDepth(maxSubagentDepth, a.maxSubagentDepth),
-			workflowStageSubagentGuard,
-			...(s.outputSchema ? { structuredOutputSchema: s.outputSchema } : {}),
-			...(s.outputSchema
-				? {
-						structuredOutput: createStructuredOutputRuntime(
-							s.outputSchema,
-							path.join(asyncDir, "structured-output"),
-						),
-					}
-				: {}),
-		};
-	};
-
-	let flatStepIndex = 0;
-	const nextSessionFile = (): string | undefined => {
-		const sessionFile = sessionFilesByFlatIndex?.[flatStepIndex];
-		flatStepIndex++;
-		return sessionFile;
-	};
-
-	let steps: RunnerStep[];
-	try {
-		steps = chain.map((s, stepIndex) => {
-			if (isParallelStep(s)) {
-				const setGroup = s.group ?? params.group;
-				const sharedAutoGroup = sharedAutoGroupForSet(setGroup, s.parallel);
-				const parallelBehaviors = s.parallel.map((task) => {
-					const agent = agents.find((candidate) => candidate.name === task.agent)!;
-					return suppressProgressForReadOnlyTask(
-						resolveStepBehavior(agent, buildStepOverrides(task), chainSkills),
-						task.task,
-						originalTask,
-					);
-				});
-				const progressPrecreated = parallelBehaviors.some((behavior) => behavior.progress);
-				if (progressPrecreated) {
-					if (!s.worktree) writeInitialProgressFile(runnerCwd);
-					progressInstructionCreated = true;
-				}
-				return {
-					parallel: s.parallel.map((t, taskIndex) => {
-						let behaviorCwd: string | undefined;
-						if (s.worktree) {
-							try {
-								behaviorCwd = resolveExpectedWorktreeAgentCwd(runnerCwd, `${id}-s${stepIndex}`, taskIndex);
-							} catch {
-								behaviorCwd = undefined;
-							}
-						}
-						return buildSeqStep(
-							t,
-							nextSessionFile(),
-							behaviorCwd,
-							progressPrecreated,
-							parallelBehaviors[taskIndex],
-							setGroup,
-							sharedAutoGroup,
-						);
-					}),
-					concurrency: s.concurrency,
-					failFast: s.failFast,
-					worktree: s.worktree,
-				};
-			}
-			if (isDynamicParallelStep(s)) {
-				const setGroup = s.group ?? params.group;
-				const sharedAutoGroup = sharedAutoGroupForSet(setGroup, [s.parallel]);
-				const agent = agents.find((candidate) => candidate.name === s.parallel.agent)!;
-				const behavior = suppressProgressForReadOnlyTask(
-					resolveStepBehavior(agent, buildStepOverrides(s.parallel), chainSkills),
-					s.parallel.task,
-					originalTask,
-				);
-				const progressPrecreated = behavior.progress;
-				if (progressPrecreated) {
-					writeInitialProgressFile(runnerCwd);
-					progressInstructionCreated = true;
-				}
-				return {
-					expand: s.expand,
-					parallel: buildSeqStep(
-						s.parallel as SequentialStep,
-						undefined,
-						undefined,
-						progressPrecreated,
-						behavior,
-						setGroup,
-						sharedAutoGroup,
-					),
-					collect: s.collect,
-					concurrency: s.concurrency,
-					failFast: s.failFast,
-					phase: s.phase,
-					label: s.label,
-				};
-			}
-			return buildSeqStep(s as SequentialStep, nextSessionFile());
-		});
-	} catch (error) {
-		if (error instanceof UnavailableSubagentSkillError || error instanceof AsyncStartValidationError)
-			return formatAsyncStartError(resultMode, error.message);
-		throw error;
-	}
-	let childTargetIndex = 0;
-	const childIntercomTargets = childIntercomTarget
-		? steps.flatMap((step) => {
-				if ("parallel" in step) {
-					if (!Array.isArray(step.parallel)) {
-						childTargetIndex++;
-						return [undefined];
-					}
-					return step.parallel.map((task) => childIntercomTarget(task.agent, childTargetIndex++));
-				}
-				return [childIntercomTarget(step.agent, childTargetIndex++)];
-			})
-		: undefined;
-
-	let spawnResult: AsyncSpawnResult = {};
-	try {
-		spawnResult = spawnRunner(
-			{
-				id,
-				steps,
-				resultPath: inheritedNestedRoute
-					? nestedResultsPath(inheritedNestedRoute.rootRunId, id)
-					: path.join(RESULTS_DIR, `${id}.json`),
-				cwd: runnerCwd,
-				placeholder: "{previous}",
-				maxOutput,
-				artifactsDir: artifactConfig.enabled ? artifactsDir : undefined,
-				artifactConfig,
-				share: shareEnabled,
-				sessionDir: sessionRoot ? path.join(sessionRoot, `async-${id}`) : undefined,
-				asyncDir,
-				sessionId: ctx.currentSessionId,
-				piPackageRoot,
-				piArgv1: process.argv[1],
-				worktreeSetupHook,
-				worktreeSetupHookTimeoutMs,
-				controlConfig,
-				controlIntercomTarget,
-				childIntercomTargets,
-				supervisorAuthorizations,
-				dynamicSupervisorAuthorizations,
-				resultMode,
-				dynamicFanoutMaxItems: params.dynamicFanoutMaxItems,
-				workflowGraph,
-				nestedRoute: nestedRoute ?? inheritedNestedRoute,
-				workflowStageSubagentGuard,
-				nestedSelf:
-					inheritedNestedRoute && nestedAddress
-						? {
-								parentRunId: nestedAddress.parentRunId,
-								parentStepIndex: nestedAddress.parentStepIndex,
-								depth: nestedAddress.depth,
-								path: nestedAddress.path,
-							}
-						: undefined,
-			},
-			id,
-			runnerCwd,
-			workflowSessionEnv(ctx.workflowSessionMetadata),
-		);
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		return formatAsyncStartError(resultMode, `Failed to start async ${resultMode} '${id}': ${message}`);
-	}
-
-	if (spawnResult.error) {
-		return formatAsyncStartError(resultMode, `Failed to start async ${resultMode} '${id}': ${spawnResult.error}`);
-	}
-
-	if (spawnResult.pid) {
-		const firstStep = chain[0];
-		const firstAgents = isParallelStep(firstStep)
-			? firstStep.parallel.map((t) => t.agent)
-			: isDynamicParallelStep(firstStep)
-				? [firstStep.parallel.agent]
-				: [(firstStep as SequentialStep).agent];
-		const parallelGroups: Array<{ start: number; count: number; stepIndex: number }> = [];
-		const flatAgents: string[] = [];
-		let flatStepStart = 0;
-		for (let stepIndex = 0; stepIndex < chain.length; stepIndex++) {
-			const step = chain[stepIndex]!;
-			if (isParallelStep(step)) {
-				parallelGroups.push({ start: flatStepStart, count: step.parallel.length, stepIndex });
-				flatAgents.push(...step.parallel.map((task) => task.agent));
-				flatStepStart += step.parallel.length;
-			} else if (isDynamicParallelStep(step)) {
-				parallelGroups.push({ start: flatStepStart, count: 1, stepIndex });
-				flatAgents.push(step.parallel.agent);
-				flatStepStart++;
-			} else {
-				flatAgents.push((step as SequentialStep).agent);
-				flatStepStart++;
-			}
-		}
-		if (inheritedNestedRoute && nestedAddress) {
-			const now = Date.now();
-			try {
-				writeNestedEvent(inheritedNestedRoute, {
-					type: "subagent.nested.started",
-					ts: now,
-					parentRunId: nestedAddress.parentRunId,
-					parentStepIndex: nestedAddress.parentStepIndex,
-					child: {
-						id,
-						parentRunId: nestedAddress.parentRunId,
-						parentStepIndex: nestedAddress.parentStepIndex,
-						depth: nestedAddress.depth,
-						path: nestedAddress.path,
-						asyncDir,
-						pid: spawnResult.pid,
-						ownerIntercomTarget: getEnvValue(SUBAGENT_INTERCOM_SESSION_NAME_ENV),
-						leafIntercomTarget: childIntercomTargets?.[0],
-						intercomTarget: childIntercomTargets?.[0],
-						ownerState: "live",
-						mode: resultMode,
-						state: "running",
-						agent: firstAgents[0],
-						agents: flatAgents,
-						chainStepCount: chain.length,
-						parallelGroups,
-						startedAt: now,
-						lastUpdate: now,
-					},
-				});
-			} catch (error) {
-				console.error("Failed to emit nested async start event:", error);
-			}
-		}
-		ctx.pi.events.emit(SUBAGENT_ASYNC_STARTED_EVENT, {
-			id,
-			pid: spawnResult.pid,
-			sessionId: ctx.currentSessionId,
-			mode: resultMode,
-			agent: firstAgents[0],
-			agents: flatAgents,
-			task: isParallelStep(firstStep)
-				? firstStep.parallel[0]?.task?.slice(0, 50)
-				: isDynamicParallelStep(firstStep)
-					? firstStep.parallel.task?.slice(0, 50)
-					: (firstStep as SequentialStep).task?.slice(0, 50),
-			chain: chain.map((s) =>
-				isParallelStep(s)
-					? `[${s.parallel.map((t) => t.agent).join("+")}]`
-					: isDynamicParallelStep(s)
-						? `expand:${s.parallel.agent}`
-						: (s as SequentialStep).agent,
-			),
-			chainStepCount: chain.length,
-			parallelGroups,
-			workflowGraph,
-			cwd: runnerCwd,
-			asyncDir,
-			nestedRoute,
-		});
-	}
-
-	const chainDesc = chain
-		.map((s) =>
-			isParallelStep(s)
-				? `[${s.parallel.map((t) => t.agent).join("+")}]`
-				: isDynamicParallelStep(s)
-					? `expand:${s.parallel.agent}`
-					: (s as SequentialStep).agent,
-		)
-		.join(" -> ");
-
-	return {
-		content: [{ type: "text", text: formatAsyncStartedMessage(`Async ${resultMode}: ${chainDesc} [${id}]`) }],
-		details: { mode: resultMode, runId: id, results: [], asyncId: id, asyncDir, workflowGraph },
-	};
-}

package/dist/builtin/subagents/src/runs/background/async-execution-common.ts

@@ -1,140 +0,0 @@
-import { spawn } from "node:child_process";
-import * as fs from "node:fs";
-import { createRequire } from "node:module";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import { APP_NAME } from "@bastani/atomic";
-import { getAsyncConfigPath, type SubagentRunMode, TEMP_ROOT_DIR } from "../../shared/types.ts";
-import { formatPiSpawnError, resolvePiPackageRoot, validatePiSpawnCwd } from "../shared/pi-spawn.ts";
-import { buildSubagentSpawnEnv } from "../shared/spawn-env.ts";
-import type { AsyncExecutionResult, AsyncSpawnResult } from "./async-execution-types.ts";
-
-const require = createRequire(import.meta.url);
-export const piPackageRoot = resolvePiPackageRoot();
-
-function resolveJitiCliFromPackageJson(packageJsonPath: string): string | undefined {
-	if (!fs.existsSync(packageJsonPath)) return undefined;
-	const packageRoot = path.dirname(packageJsonPath);
-	const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8")) as {
-		bin?: string | Record<string, string>;
-	};
-	const binField = pkg.bin;
-	const binPath = typeof binField === "string" ? binField : (binField?.jiti ?? Object.values(binField ?? {})[0]);
-	const candidates = [binPath, "lib/jiti-cli.mjs"].filter((candidate): candidate is string => Boolean(candidate));
-	for (const candidate of candidates) {
-		const cliPath = path.resolve(packageRoot, candidate);
-		if (fs.existsSync(cliPath)) return cliPath;
-	}
-	return undefined;
-}
-
-function resolveJitiCliPath(): string | undefined {
-	const candidates: Array<() => string | undefined> = [
-		() => require.resolve("jiti/package.json"),
-		() =>
-			piPackageRoot
-				? createRequire(path.join(piPackageRoot, "package.json")).resolve("jiti/package.json")
-				: undefined,
-		() => {
-			if (!process.argv[1]) return undefined;
-			const piEntry = fs.realpathSync(process.argv[1]);
-			return createRequire(piEntry).resolve("jiti/package.json");
-		},
-		() => (piPackageRoot ? path.join(piPackageRoot, "node_modules", "jiti", "package.json") : undefined),
-	];
-	for (const candidate of candidates) {
-		try {
-			const packageJsonPath = candidate();
-			if (!packageJsonPath) continue;
-			const cliPath = resolveJitiCliFromPackageJson(packageJsonPath);
-			if (cliPath) return cliPath;
-		} catch {
-			// Candidate not available in this install, continue probing.
-		}
-	}
-	return undefined;
-}
-
-const jitiCliPath = resolveJitiCliPath();
-
-export function formatAsyncStartedMessage(headline: string): string {
-	return [
-		`Launched: ${headline}`,
-		"Completion pending; Pi will deliver the result when the detached run finishes.",
-		"",
-		"The async run is detached. Do not run sleep timers or polling loops just to wait for it.",
-		"If you have independent work, continue that work. If you have nothing else to do until the async result arrives, end your turn now.",
-		'Use subagent({ action: "status", id: "..." }) when you need the current status/result, or to inspect a blocked/stale run. Do not poll just to wait.',
-	].join("\n");
-}
-
-/**
- * Check if jiti is available for async execution
- */
-export function isAsyncAvailable(): boolean {
-	return jitiCliPath !== undefined;
-}
-
-/**
- * Spawn the async runner process
- */
-export function writeAsyncRunnerConfig(cfg: object, suffix: string): string {
-	fs.mkdirSync(TEMP_ROOT_DIR, { recursive: true });
-	const cfgPath = getAsyncConfigPath(suffix);
-	fs.writeFileSync(cfgPath, JSON.stringify(cfg), { mode: 0o600 });
-	return cfgPath;
-}
-
-export function spawnRunner(cfg: object, suffix: string, cwd: string, env?: Record<string, string>): AsyncSpawnResult {
-	const cwdValidation = validatePiSpawnCwd(cwd);
-	if (!cwdValidation.ok) return { error: cwdValidation.error };
-
-	if (!jitiCliPath) {
-		return {
-			error: "upstream jiti for TypeScript execution could not be found; ensure package dependencies are installed",
-		};
-	}
-
-	const cfgPath = writeAsyncRunnerConfig(cfg, suffix);
-	const runner = path.join(path.dirname(fileURLToPath(import.meta.url)), "subagent-runner.ts");
-
-	const spawnSpec = { command: process.execPath, args: [jitiCliPath, runner, cfgPath] };
-	let proc: ReturnType<typeof spawn>;
-	try {
-		proc = spawn(spawnSpec.command, spawnSpec.args, {
-			cwd,
-			env: buildSubagentSpawnEnv(process.env, env),
-			detached: true,
-			stdio: "ignore",
-			windowsHide: true,
-		});
-	} catch (error) {
-		const spawnError = error instanceof Error ? error : new Error(String(error));
-		return { error: formatPiSpawnError(spawnError, spawnSpec, cwd) };
-	}
-	proc.on("error", (error) => {
-		console.error(`[${APP_NAME}-subagents] async spawn failed: ${formatPiSpawnError(error, spawnSpec, cwd)}`);
-	});
-	if (typeof proc.pid !== "number") {
-		const noPidError = Object.assign(
-			new Error(`spawn ${spawnSpec.command} failed before assigning a pid`),
-			fs.existsSync(spawnSpec.command) ? {} : { code: "ENOENT" },
-		);
-		return { error: formatPiSpawnError(noPidError, spawnSpec, cwd) };
-	}
-	proc.unref();
-	return { pid: proc.pid };
-}
-
-export function formatAsyncStartError(mode: SubagentRunMode, message: string): AsyncExecutionResult {
-	return {
-		content: [{ type: "text", text: message }],
-		isError: true,
-		details: { mode, results: [] },
-	};
-}
-
-export const UNAVAILABLE_SUBAGENT_SKILL_ERROR = "Skills not found: subagent";
-
-export class UnavailableSubagentSkillError extends Error {}
-export class AsyncStartValidationError extends Error {}