@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/background/async-execution.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Async execution logic for subagent tool
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { AgentConfig } from "../../agents/agents.ts";
+import { type ChainStep } from "../../shared/settings.ts";
+import type { RunnerStep } from "../shared/parallel-utils.ts";
+import { type AvailableModelInfo, type ParentModel } from "../shared/model-fallback.ts";
+import type { ModelScopeConfig } from "../shared/model-scope.ts";
+import { buildWorkflowGraphSnapshot } from "../shared/workflow-graph.ts";
+import { type AcceptanceInput, type ArtifactConfig, type Details, type MaxOutputConfig, type NestedRouteInfo, type ResolvedControlConfig, type ResolvedTurnBudget, type ResolvedToolBudget, type SubagentRunMode } from "../../shared/types.ts";
+import type { ImportedAsyncRoot } from "./chain-root-attachment.ts";
+import type { SessionLeaseRequest } from "../shared/session-lease.ts";
+interface AsyncExecutionContext {
+    pi: ExtensionAPI;
+    cwd: string;
+    currentSessionId: string;
+    /** Parent session id used by permission-system ask forwarding. */
+    parentSessionId?: string;
+    currentModelProvider?: string;
+    currentModel?: ParentModel;
+    /** Optional model-scope enforcement resolved from subagent settings. */
+    modelScope?: ModelScopeConfig;
+}
+interface AsyncChainParams {
+    chain: ChainStep[];
+    task?: string;
+    /** Raw caller-facing goal used only by the started event. */
+    goal?: string;
+    attachRoot?: ImportedAsyncRoot & {
+        agent: string;
+        outputName?: string;
+        label?: string;
+    };
+    resultMode?: Exclude<SubagentRunMode, "single">;
+    agents: AgentConfig[];
+    ctx: AsyncExecutionContext;
+    availableModels?: AvailableModelInfo[];
+    cwd?: string;
+    maxOutput?: MaxOutputConfig;
+    artifactsDir?: string;
+    artifactConfig: ArtifactConfig;
+    shareEnabled: boolean;
+    sessionRoot?: string;
+    chainSkills?: string[];
+    sessionFilesByFlatIndex?: (string | undefined)[];
+    thinkingOverridesByFlatIndex?: (AgentConfig["thinking"] | undefined)[];
+    progressDir?: string;
+    dynamicFanoutMaxItems?: number;
+    maxSubagentDepth: number;
+    waitToolEnabled?: boolean;
+    worktreeSetupHook?: string;
+    worktreeSetupHookTimeoutMs?: number;
+    worktreeBaseDir?: string;
+    controlConfig?: ResolvedControlConfig;
+    controlIntercomTarget?: string;
+    childIntercomTarget?: (agent: string, index: number) => string | undefined;
+    nestedRoute?: NestedRouteInfo;
+    acceptance?: AcceptanceInput;
+    timeoutMs?: number;
+    turnBudget?: ResolvedTurnBudget;
+    toolBudget?: ResolvedToolBudget;
+    configToolBudget?: ResolvedToolBudget;
+    /** Global cap on simultaneously-running subagent tasks within the async run. */
+    globalConcurrencyLimit?: number;
+}
+interface AsyncSingleParams {
+    agent: string;
+    task?: string;
+    /** Raw caller-facing goal used only by the started event. */
+    goal?: string;
+    agentConfig: AgentConfig;
+    ctx: AsyncExecutionContext;
+    cwd?: string;
+    maxOutput?: MaxOutputConfig;
+    artifactsDir?: string;
+    artifactConfig: ArtifactConfig;
+    shareEnabled: boolean;
+    sessionRoot?: string;
+    sessionDir?: string;
+    sessionFile?: string;
+    revivalLease?: SessionLeaseRequest;
+    skills?: string[];
+    output?: string | boolean;
+    outputMode?: "inline" | "file-only";
+    outputBaseDir?: string;
+    modelOverride?: string;
+    thinkingOverride?: AgentConfig["thinking"];
+    availableModels?: AvailableModelInfo[];
+    maxSubagentDepth: number;
+    waitToolEnabled?: boolean;
+    worktreeSetupHook?: string;
+    worktreeSetupHookTimeoutMs?: number;
+    worktreeBaseDir?: string;
+    controlConfig?: ResolvedControlConfig;
+    controlIntercomTarget?: string;
+    childIntercomTarget?: (agent: string, index: number) => string | undefined;
+    nestedRoute?: NestedRouteInfo;
+    acceptance?: AcceptanceInput;
+    timeoutMs?: number;
+    absoluteDeadlineAt?: number;
+    turnBudget?: ResolvedTurnBudget;
+    toolBudget?: ResolvedToolBudget;
+    configToolBudget?: ResolvedToolBudget;
+}
+interface AsyncExecutionResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details: Details;
+    isError?: boolean;
+}
+export interface AsyncRunnerStepBuildParams {
+    chain: ChainStep[];
+    task?: string;
+    attachRoot?: ImportedAsyncRoot & {
+        agent: string;
+        outputName?: string;
+        label?: string;
+    };
+    resultMode?: SubagentRunMode;
+    agents: AgentConfig[];
+    ctx: AsyncExecutionContext;
+    availableModels?: AvailableModelInfo[];
+    cwd?: string;
+    chainSkills?: string[];
+    sessionFilesByFlatIndex?: (string | undefined)[];
+    thinkingOverridesByFlatIndex?: (AgentConfig["thinking"] | undefined)[];
+    progressDir?: string;
+    dynamicFanoutMaxItems?: number;
+    maxSubagentDepth: number;
+    waitToolEnabled?: boolean;
+    worktreeBaseDir?: string;
+    asyncDir: string;
+    outputBaseDir?: string;
+    validateOutputBindings?: boolean;
+    toolBudget?: ResolvedToolBudget;
+    configToolBudget?: ResolvedToolBudget;
+}
+export type AsyncRunnerStepBuildResult = {
+    steps: RunnerStep[];
+    runnerCwd: string;
+    workflowGraph: ReturnType<typeof buildWorkflowGraphSnapshot>;
+    eventChain: ChainStep[];
+    originalTask?: string;
+} | {
+    error: string;
+};
+export declare function formatAsyncStartedMessage(headline: string): string;
+/**
+ * Check if jiti is available for async execution
+ */
+export declare function isAsyncAvailable(): boolean;
+export declare function resolveAsyncRunnerLogPaths(cfg: object): {
+    stdoutPath: string;
+    stderrPath: string;
+} | undefined;
+export declare function buildAsyncRunnerSteps(id: string, params: AsyncRunnerStepBuildParams): AsyncRunnerStepBuildResult;
+/**
+ * Execute a chain asynchronously
+ */
+export declare function executeAsyncChain(id: string, params: AsyncChainParams): AsyncExecutionResult;
+/**
+ * Execute a single agent asynchronously
+ */
+export declare function executeAsyncSingle(id: string, params: AsyncSingleParams): AsyncExecutionResult;
+export {};
+//# sourceMappingURL=async-execution.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/async-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-execution.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/async-execution.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * Async execution logic for subagent tool\n */\n\nimport { spawn } from \"node:child_process\";\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createRequire } from \"node:module\";\nimport type { ExtensionAPI } from \"@earendil-works/pi-coding-agent\";\nimport type { AgentConfig } from \"../../agents/agents.ts\";\nimport { writePrivateAtomicJson } from \"../../shared/atomic-json.ts\";\nimport { applyThinkingSuffix } from \"../shared/pi-args.ts\";\nimport { injectOutputPathSystemPrompt, injectSingleOutputInstruction, normalizeSingleOutputOverride, resolveSingleOutputPath, validateFileOnlyOutputMode } from \"../shared/single-output.ts\";\nimport { buildChainInstructions, isDynamicParallelStep, isParallelStep, resolveStepBehavior, suppressProgressForReadOnlyTask, writeInitialProgressFile, type ChainStep, type ResolvedStepBehavior, type SequentialStep, type StepOverrides } from \"../../shared/settings.ts\";\nimport type { RunnerStep } from \"../shared/parallel-utils.ts\";\nimport { resolvePiPackageRoot } from \"../shared/pi-spawn.ts\";\nimport { buildSkillInjection, normalizeSkillInput, resolveSkillsWithFallback } from \"../../agents/skills.ts\";\nimport { buildAgentMemoryInjection } from \"../../agents/agent-memory.ts\";\nimport { PI_CODING_AGENT_PACKAGE_ROOT_ENV, resolveChildCwd } from \"../../shared/utils.ts\";\nimport { buildModelCandidates, resolveEffectiveSubagentModel, resolveModelCandidate, resolveSubagentModelOverride, type AvailableModelInfo, type ParentModel } from \"../shared/model-fallback.ts\";\nimport type { ModelScopeConfig } from \"../shared/model-scope.ts\";\nimport { resolveEffectiveThinking } from \"../../shared/model-info.ts\";\nimport { resolveExpectedWorktreeAgentCwd } from \"../shared/worktree.ts\";\nimport { buildWorkflowGraphSnapshot } from \"../shared/workflow-graph.ts\";\nimport { ChainOutputValidationError, validateChainOutputBindings } from \"../shared/chain-outputs.ts\";\nimport { createStructuredOutputRuntime } from \"../shared/structured-output.ts\";\nimport { resolveEffectiveAcceptance } from \"../shared/acceptance.ts\";\nimport {\n\ttype AcceptanceInput,\n\ttype ArtifactConfig,\n\ttype Details,\n\ttype MaxOutputConfig,\n\ttype NestedRouteInfo,\n\ttype ResolvedControlConfig,\n\ttype ResolvedTurnBudget,\n\ttype ResolvedToolBudget,\n\ttype SubagentRunMode,\n\ttype SteeringRecoveryDescriptor,\n\tASYNC_DIR,\n\tRESULTS_DIR,\n\tSUBAGENT_ASYNC_STARTED_EVENT,\n\tSUBAGENT_LIFECYCLE_ARTIFACT_VERSION,\n\tTEMP_ROOT_DIR,\n\tgetAsyncConfigPath,\n\tresolveChildMaxSubagentDepth,\n} from \"../../shared/types.ts\";\nimport { nestedResultsPath, resolveInheritedNestedRouteFromEnv, resolveNestedParentAddressFromEnv, writeNestedEvent } from \"../shared/nested-events.ts\";\nimport { initialTurnBudgetState } from \"../shared/turn-budget.ts\";\nimport { validateToolBudgetConfig } from \"../shared/tool-budget.ts\";\nimport type { ImportedAsyncRoot } from \"./chain-root-attachment.ts\";\nimport type { SessionLeaseRequest } from \"../shared/session-lease.ts\";\n\nconst require = createRequire(import.meta.url);\nconst piPackageRoot = resolvePiPackageRoot();\n\nfunction resolveJitiCliFromPackageJson(packageJsonPath: string): string | undefined {\n\tif (!fs.existsSync(packageJsonPath)) return undefined;\n\tconst packageRoot = path.dirname(packageJsonPath);\n\tconst pkg = JSON.parse(fs.readFileSync(packageJsonPath, \"utf-8\")) as {\n\t\tbin?: string | Record<string, string>;\n\t};\n\tconst binField = pkg.bin;\n\tconst binPath = typeof binField === \"string\"\n\t\t? binField\n\t\t: binField?.jiti ?? Object.values(binField ?? {})[0];\n\tconst candidates = [binPath, \"lib/jiti-cli.mjs\"].filter((candidate): candidate is string => Boolean(candidate));\n\tfor (const candidate of candidates) {\n\t\tconst cliPath = path.resolve(packageRoot, candidate);\n\t\tif (fs.existsSync(cliPath)) return cliPath;\n\t}\n\treturn undefined;\n}\n\nfunction resolveJitiCliPath(): string | undefined {\n\tconst candidates: Array<() => string | undefined> = [\n\t\t() => require.resolve(\"jiti/package.json\"),\n\t\t() => piPackageRoot\n\t\t\t? createRequire(path.join(piPackageRoot, \"package.json\")).resolve(\"jiti/package.json\")\n\t\t\t: undefined,\n\t\t() => {\n\t\t\tif (!process.argv[1]) return undefined;\n\t\t\tconst piEntry = fs.realpathSync(process.argv[1]);\n\t\t\treturn createRequire(piEntry).resolve(\"jiti/package.json\");\n\t\t},\n\t\t() => piPackageRoot ? path.join(piPackageRoot, \"node_modules\", \"jiti\", \"package.json\") : undefined,\n\t];\n\tfor (const candidate of candidates) {\n\t\ttry {\n\t\t\tconst packageJsonPath = candidate();\n\t\t\tif (!packageJsonPath) continue;\n\t\t\tconst cliPath = resolveJitiCliFromPackageJson(packageJsonPath);\n\t\t\tif (cliPath) return cliPath;\n\t\t} catch {\n\t\t\t// Candidate not available in this install, continue probing.\n\t\t}\n\t}\n\treturn undefined;\n}\n\nconst jitiCliPath = resolveJitiCliPath();\n\ninterface AsyncExecutionContext {\n\tpi: ExtensionAPI;\n\tcwd: string;\n\tcurrentSessionId: string;\n\t/** Parent session id used by permission-system ask forwarding. */\n\tparentSessionId?: string;\n\tcurrentModelProvider?: string;\n\tcurrentModel?: ParentModel;\n\t/** Optional model-scope enforcement resolved from subagent settings. */\n\tmodelScope?: ModelScopeConfig;\n}\n\ninterface AsyncChainParams {\n\tchain: ChainStep[];\n\ttask?: string;\n\t/** Raw caller-facing goal used only by the started event. */\n\tgoal?: string;\n\tattachRoot?: ImportedAsyncRoot & { agent: string; outputName?: string; label?: string };\n\tresultMode?: Exclude<SubagentRunMode, \"single\">;\n\tagents: AgentConfig[];\n\tctx: AsyncExecutionContext;\n\tavailableModels?: AvailableModelInfo[];\n\tcwd?: string;\n\tmaxOutput?: MaxOutputConfig;\n\tartifactsDir?: string;\n\tartifactConfig: ArtifactConfig;\n\tshareEnabled: boolean;\n\tsessionRoot?: string;\n\tchainSkills?: string[];\n\tsessionFilesByFlatIndex?: (string | undefined)[];\n\tthinkingOverridesByFlatIndex?: (AgentConfig[\"thinking\"] | undefined)[];\n\tprogressDir?: string;\n\tdynamicFanoutMaxItems?: number;\n\tmaxSubagentDepth: number;\n\twaitToolEnabled?: boolean;\n\tworktreeSetupHook?: string;\n\tworktreeSetupHookTimeoutMs?: number;\n\tworktreeBaseDir?: string;\n\tcontrolConfig?: ResolvedControlConfig;\n\tcontrolIntercomTarget?: string;\n\tchildIntercomTarget?: (agent: string, index: number) => string | undefined;\n\tnestedRoute?: NestedRouteInfo;\n\tacceptance?: AcceptanceInput;\n\ttimeoutMs?: number;\n\tturnBudget?: ResolvedTurnBudget;\n\ttoolBudget?: ResolvedToolBudget;\n\tconfigToolBudget?: ResolvedToolBudget;\n\t/** Global cap on simultaneously-running subagent tasks within the async run. */\n\tglobalConcurrencyLimit?: number;\n}\n\ninterface AsyncSingleParams {\n\tagent: string;\n\ttask?: string;\n\t/** Raw caller-facing goal used only by the started event. */\n\tgoal?: string;\n\tagentConfig: AgentConfig;\n\tctx: AsyncExecutionContext;\n\tcwd?: string;\n\tmaxOutput?: MaxOutputConfig;\n\tartifactsDir?: string;\n\tartifactConfig: ArtifactConfig;\n\tshareEnabled: boolean;\n\tsessionRoot?: string;\n\tsessionDir?: string;\n\tsessionFile?: string;\n\trevivalLease?: SessionLeaseRequest;\n\tskills?: string[];\n\toutput?: string | boolean;\n\toutputMode?: \"inline\" | \"file-only\";\n\toutputBaseDir?: string;\n\tmodelOverride?: string;\n\tthinkingOverride?: AgentConfig[\"thinking\"];\n\tavailableModels?: AvailableModelInfo[];\n\tmaxSubagentDepth: number;\n\twaitToolEnabled?: boolean;\n\tworktreeSetupHook?: string;\n\tworktreeSetupHookTimeoutMs?: number;\n\tworktreeBaseDir?: string;\n\tcontrolConfig?: ResolvedControlConfig;\n\tcontrolIntercomTarget?: string;\n\tchildIntercomTarget?: (agent: string, index: number) => string | undefined;\n\tnestedRoute?: NestedRouteInfo;\n\tacceptance?: AcceptanceInput;\n\ttimeoutMs?: number;\n\tabsoluteDeadlineAt?: number;\n\tturnBudget?: ResolvedTurnBudget;\n\ttoolBudget?: ResolvedToolBudget;\n\tconfigToolBudget?: ResolvedToolBudget;\n}\n\ninterface AsyncExecutionResult {\n\tcontent: Array<{ type: \"text\"; text: string }>;\n\tdetails: Details;\n\tisError?: boolean;\n}\n\nexport interface AsyncRunnerStepBuildParams {\n\tchain: ChainStep[];\n\ttask?: string;\n\tattachRoot?: ImportedAsyncRoot & { agent: string; outputName?: string; label?: string };\n\tresultMode?: SubagentRunMode;\n\tagents: AgentConfig[];\n\tctx: AsyncExecutionContext;\n\tavailableModels?: AvailableModelInfo[];\n\tcwd?: string;\n\tchainSkills?: string[];\n\tsessionFilesByFlatIndex?: (string | undefined)[];\n\tthinkingOverridesByFlatIndex?: (AgentConfig[\"thinking\"] | undefined)[];\n\tprogressDir?: string;\n\tdynamicFanoutMaxItems?: number;\n\tmaxSubagentDepth: number;\n\twaitToolEnabled?: boolean;\n\tworktreeBaseDir?: string;\n\tasyncDir: string;\n\toutputBaseDir?: string;\n\tvalidateOutputBindings?: boolean;\n\ttoolBudget?: ResolvedToolBudget;\n\tconfigToolBudget?: ResolvedToolBudget;\n}\n\nexport type AsyncRunnerStepBuildResult =\n\t| {\n\t\tsteps: RunnerStep[];\n\t\trunnerCwd: string;\n\t\tworkflowGraph: ReturnType<typeof buildWorkflowGraphSnapshot>;\n\t\teventChain: ChainStep[];\n\t\toriginalTask?: string;\n\t}\n\t| { error: string };\n\nexport function formatAsyncStartedMessage(headline: string): string {\n\treturn [\n\t\theadline,\n\t\t\"\",\n\t\t\"The async run is detached. Do not run sleep timers or polling loops just to wait for it.\",\n\t\t\"If you have independent work, continue that work. When you have nothing left to do until the async result arrives, call subagent_wait() — it blocks until the run finishes and delivers the completion here. Only if you are certain you will get another turn (an interactive session where the user will prompt you again) can you instead stop and let Pi wake you; inside a skill that must run to completion, or in a non-interactive run, there is no next turn, so use subagent_wait().\",\n\t\t\"Use subagent({ action: \\\"status\\\", id: \\\"...\\\" }) when you need a one-shot status/result or to inspect a blocked/stale run. To block until completion, prefer subagent_wait(). Do not poll in a loop just to wait.\",\n\t].join(\"\\n\");\n}\n\n/**\n * Check if jiti is available for async execution\n */\nexport function isAsyncAvailable(): boolean {\n\treturn jitiCliPath !== undefined;\n}\n\nfunction isNodeExecutableName(execPath: string): boolean {\n\tconst basename = path.basename(execPath).toLowerCase();\n\treturn basename === \"node\" || basename === \"node.exe\" || basename === \"nodejs\" || basename === \"nodejs.exe\";\n}\n\nfunction canUseCurrentNodeExecutable(execPath: string): boolean {\n\ttry {\n\t\tfs.accessSync(execPath, process.platform === \"win32\" ? fs.constants.F_OK : fs.constants.X_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction resolveAsyncRunnerNodeCommand(): string {\n\tif (isNodeExecutableName(process.execPath) && canUseCurrentNodeExecutable(process.execPath)) {\n\t\treturn process.execPath;\n\t}\n\treturn process.platform === \"win32\" ? \"node.exe\" : \"node\";\n}\n\nexport function resolveAsyncRunnerLogPaths(cfg: object): { stdoutPath: string; stderrPath: string } | undefined {\n\tconst asyncDir = typeof (cfg as { asyncDir?: unknown }).asyncDir === \"string\"\n\t\t? (cfg as { asyncDir: string }).asyncDir\n\t\t: undefined;\n\tif (!asyncDir) return undefined;\n\treturn {\n\t\tstdoutPath: path.join(asyncDir, \"runner.stdout.log\"),\n\t\tstderrPath: path.join(asyncDir, \"runner.stderr.log\"),\n\t};\n}\n\nfunction closeFd(fd: number | undefined): void {\n\tif (fd === undefined) return;\n\ttry {\n\t\tfs.closeSync(fd);\n\t} catch {\n\t\t// Best-effort cleanup; child process already owns its duplicated stdio fd.\n\t}\n}\n\n/**\n * Spawn the async runner process\n */\nconst RUNNER_STARTUP_TIMEOUT_MS = 10_000;\nconst RUNNER_STARTUP_WAIT_BUFFER = typeof SharedArrayBuffer !== \"undefined\" ? new SharedArrayBuffer(4) : undefined;\nconst RUNNER_STARTUP_WAIT_VIEW = RUNNER_STARTUP_WAIT_BUFFER ? new Int32Array(RUNNER_STARTUP_WAIT_BUFFER) : undefined;\n\ntype RunnerStartupState = \"ready\" | \"acknowledged\";\n\ntype RunnerStartupWaitResult =\n\t| { ok: true; token: string }\n\t| { ok: false; error: string };\n\nfunction waitForStartupInterval(delayMs = 20): void {\n\tif (RUNNER_STARTUP_WAIT_VIEW) {\n\t\tAtomics.wait(RUNNER_STARTUP_WAIT_VIEW, 0, 0, delayMs);\n\t\treturn;\n\t}\n\tconst waitUntil = Date.now() + delayMs;\n\twhile (Date.now() < waitUntil) {\n\t\t// Startup handshakes are synchronous so resume rejects before reporting a run as started.\n\t}\n}\n\nfunction readRunnerStartup(startupPath: string, expectedState: RunnerStartupState, expectedToken?: string): RunnerStartupWaitResult | undefined {\n\tif (!fs.existsSync(startupPath)) return undefined;\n\ttry {\n\t\tconst payload = JSON.parse(fs.readFileSync(startupPath, \"utf-8\")) as { state?: unknown; token?: unknown; error?: unknown };\n\t\tif (payload.state === \"error\" && typeof payload.error === \"string\") return { ok: false, error: payload.error };\n\t\tif (payload.state !== expectedState) return undefined;\n\t\tif (typeof payload.token !== \"string\" || (expectedToken !== undefined && payload.token !== expectedToken)) {\n\t\t\treturn { ok: false, error: `Async runner wrote an invalid ${expectedState} startup handshake: ${startupPath}` };\n\t\t}\n\t\treturn { ok: true, token: payload.token };\n\t} catch (error) {\n\t\treturn { ok: false, error: `Failed to read async runner startup handshake '${startupPath}': ${error instanceof Error ? error.message : String(error)}` };\n\t}\n}\n\nfunction waitForRunnerStartup(startupPath: string, expectedState: RunnerStartupState, timeoutMs: number, expectedToken?: string): RunnerStartupWaitResult {\n\tconst deadline = Date.now() + timeoutMs;\n\tfor (;;) {\n\t\tconst result = readRunnerStartup(startupPath, expectedState, expectedToken);\n\t\tif (result) return result;\n\t\tif (Date.now() >= deadline) break;\n\t\twaitForStartupInterval(Math.min(20, Math.max(1, deadline - Date.now())));\n\t}\n\tconst finalResult = readRunnerStartup(startupPath, expectedState, expectedToken);\n\tif (finalResult) return finalResult;\n\treturn { ok: false, error: `Timed out after ${timeoutMs}ms waiting for the async runner startup state '${expectedState}'.` };\n}\n\nfunction writeRunnerStartupControl(filePath: string, payload: { action: \"ack\" | \"proceed\"; token: string }): void {\n\tconst tempPath = `${filePath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;\n\ttry {\n\t\tfs.writeFileSync(tempPath, JSON.stringify(payload), { encoding: \"utf-8\", mode: 0o600 });\n\t\tfs.renameSync(tempPath, filePath);\n\t} catch (error) {\n\t\ttry {\n\t\t\tfs.rmSync(tempPath, { force: true });\n\t\t} catch {\n\t\t\t// Preserve the startup-control write error.\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nfunction runnerIsAlive(pid: number): boolean {\n\ttry {\n\t\tprocess.kill(pid, 0);\n\t\treturn true;\n\t} catch (error) {\n\t\treturn (error as NodeJS.ErrnoException).code === \"EPERM\";\n\t}\n}\n\nfunction terminateRunnerBeforeProceed(pid: number): void {\n\tfor (const signal of [\"SIGTERM\", \"SIGKILL\"] as const) {\n\t\tif (!runnerIsAlive(pid)) return;\n\t\ttry {\n\t\t\tprocess.kill(pid, signal);\n\t\t} catch {\n\t\t\tif (!runnerIsAlive(pid)) return;\n\t\t}\n\t\tconst deadline = Date.now() + 1000;\n\t\twhile (runnerIsAlive(pid) && Date.now() < deadline) waitForStartupInterval();\n\t}\n}\n\nfunction spawnRunner(cfg: object, suffix: string, cwd: string): { pid?: number; error?: string } {\n\tif (!jitiCliPath) {\n\t\treturn { error: \"upstream jiti for TypeScript execution could not be found; ensure package dependencies are installed\" };\n\t}\n\n\ttry {\n\t\tconst cwdStats = fs.statSync(cwd);\n\t\tif (!cwdStats.isDirectory()) {\n\t\t\treturn { error: `cwd is not a directory: ${cwd}` };\n\t\t}\n\t} catch {\n\t\treturn { error: `cwd does not exist: ${cwd}` };\n\t}\n\n\tfs.mkdirSync(TEMP_ROOT_DIR, { recursive: true });\n\tconst cfgPath = getAsyncConfigPath(suffix);\n\tfs.writeFileSync(cfgPath, JSON.stringify(cfg));\n\t// lunr: bake-in ships compiled .js only; use the .ts when present (upstream dev), else the .js sibling.\n\tconst runnerTsPath = path.join(path.dirname(fileURLToPath(import.meta.url)), \"subagent-runner.ts\");\n\tconst runner = fs.existsSync(runnerTsPath) ? runnerTsPath : runnerTsPath.replace(/\\.ts$/, \".js\");\n\tconst nodeCommand = resolveAsyncRunnerNodeCommand();\n\tconst startupPath = typeof (cfg as { revivalLease?: unknown; asyncDir?: unknown }).revivalLease === \"object\"\n\t\t&& typeof (cfg as { asyncDir?: unknown }).asyncDir === \"string\"\n\t\t? path.join((cfg as { asyncDir: string }).asyncDir, \"runner-startup.json\")\n\t\t: undefined;\n\tconst startupAckPath = startupPath ? path.join(path.dirname(startupPath), \"runner-startup-ack.json\") : undefined;\n\tconst startupProceedPath = startupPath ? path.join(path.dirname(startupPath), \"runner-startup-proceed.json\") : undefined;\n\tif (startupPath) fs.rmSync(startupPath, { force: true });\n\tif (startupAckPath) fs.rmSync(startupAckPath, { force: true });\n\tif (startupProceedPath) fs.rmSync(startupProceedPath, { force: true });\n\n\tconst logPaths = resolveAsyncRunnerLogPaths(cfg);\n\tlet stdoutFd: number | undefined;\n\tlet stderrFd: number | undefined;\n\ttry {\n\t\tif (logPaths) {\n\t\t\tfs.mkdirSync(path.dirname(logPaths.stdoutPath), { recursive: true });\n\t\t\tstdoutFd = fs.openSync(logPaths.stdoutPath, \"a\");\n\t\t\tstderrFd = fs.openSync(logPaths.stderrPath, \"a\");\n\t\t}\n\t\tconst proc = spawn(nodeCommand, [jitiCliPath, runner, cfgPath], {\n\t\t\tcwd,\n\t\t\tdetached: true,\n\t\t\tstdio: [\"ignore\", stdoutFd ?? \"ignore\", stderrFd ?? \"ignore\"],\n\t\t\twindowsHide: true,\n\t\t\tenv: {\n\t\t\t\t...process.env,\n\t\t\t\t...(piPackageRoot ? { [PI_CODING_AGENT_PACKAGE_ROOT_ENV]: piPackageRoot } : {}),\n\t\t\t},\n\t\t});\n\t\tcloseFd(stdoutFd);\n\t\tcloseFd(stderrFd);\n\t\tproc.on(\"error\", (error) => {\n\t\t\tconsole.error(`[pi-subagents] async spawn failed: ${error.message}`);\n\t\t});\n\t\tif (typeof proc.pid !== \"number\") {\n\t\t\treturn { error: `async runner did not produce a pid for cwd: ${cwd}` };\n\t\t}\n\t\tproc.unref();\n\t\tif (startupPath && startupAckPath && startupProceedPath) {\n\t\t\tconst ready = waitForRunnerStartup(startupPath, \"ready\", RUNNER_STARTUP_TIMEOUT_MS);\n\t\t\tif (!ready.ok) {\n\t\t\t\tterminateRunnerBeforeProceed(proc.pid);\n\t\t\t\treturn { error: ready.error };\n\t\t\t}\n\t\t\ttry {\n\t\t\t\twriteRunnerStartupControl(startupAckPath, { action: \"ack\", token: ready.token });\n\t\t\t} catch (error) {\n\t\t\t\tterminateRunnerBeforeProceed(proc.pid);\n\t\t\t\treturn { error: `Failed to acknowledge async runner startup: ${error instanceof Error ? error.message : String(error)}` };\n\t\t\t}\n\t\t\tconst acknowledged = waitForRunnerStartup(startupPath, \"acknowledged\", RUNNER_STARTUP_TIMEOUT_MS, ready.token);\n\t\t\tif (!acknowledged.ok) {\n\t\t\t\tterminateRunnerBeforeProceed(proc.pid);\n\t\t\t\treturn { error: acknowledged.error };\n\t\t\t}\n\t\t\ttry {\n\t\t\t\twriteRunnerStartupControl(startupProceedPath, { action: \"proceed\", token: ready.token });\n\t\t\t} catch (error) {\n\t\t\t\tterminateRunnerBeforeProceed(proc.pid);\n\t\t\t\treturn { error: `Failed to authorize async runner startup: ${error instanceof Error ? error.message : String(error)}` };\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tfs.rmSync(startupPath, { force: true });\n\t\t\t} catch {\n\t\t\t\t// Proceed is the commit point; handshake cleanup cannot turn a running revival into a start error.\n\t\t\t}\n\t\t}\n\t\treturn { pid: proc.pid };\n\t} catch (error) {\n\t\tcloseFd(stdoutFd);\n\t\tcloseFd(stderrFd);\n\t\treturn { error: error instanceof Error ? error.message : String(error) };\n\t}\n}\n\nfunction formatAsyncStartError(mode: SubagentRunMode, message: string): AsyncExecutionResult {\n\treturn {\n\t\tcontent: [{ type: \"text\", text: message }],\n\t\tisError: true,\n\t\tdetails: { mode, results: [] },\n\t};\n}\n\nconst UNAVAILABLE_SUBAGENT_SKILL_ERROR = \"Skills not found: pi-subagents\";\n\nclass UnavailableSubagentSkillError extends Error {}\nclass AsyncStartValidationError extends Error {}\n\nexport function buildAsyncRunnerSteps(id: string, params: AsyncRunnerStepBuildParams): AsyncRunnerStepBuildResult {\n\tconst {\n\t\tchain,\n\t\tagents,\n\t\tctx,\n\t\tcwd,\n\t\tsessionFilesByFlatIndex,\n\t\tthinkingOverridesByFlatIndex,\n\t\tmaxSubagentDepth,\n\t\tworktreeBaseDir,\n\t\tasyncDir,\n\t} = params;\n\tconst outputBaseDir = params.outputBaseDir;\n\tconst resultMode = params.resultMode ?? \"chain\";\n\tconst chainSkills = params.chainSkills ?? [];\n\tconst availableModels = params.availableModels;\n\tconst runnerCwd = resolveChildCwd(ctx.cwd, cwd);\n\tconst progressDir = params.progressDir ?? runnerCwd;\n\tconst graphChain: ChainStep[] = params.attachRoot\n\t\t? [{\n\t\t\t\tagent: params.attachRoot.agent,\n\t\t\t\ttask: `Attach async root ${params.attachRoot.runId}`,\n\t\t\t\tlabel: params.attachRoot.label ?? `Attached root ${params.attachRoot.runId}`,\n\t\t\t\t...(params.attachRoot.outputName ? { as: params.attachRoot.outputName } : {}),\n\t\t\t}, ...chain]\n\t\t: chain;\n\tconst firstStep = chain[0];\n\tconst originalTask = params.task ?? (firstStep\n\t\t? (isParallelStep(firstStep)\n\t\t\t? firstStep.parallel[0]?.task\n\t\t\t: isDynamicParallelStep(firstStep)\n\t\t\t\t? firstStep.parallel.task\n\t\t\t\t: (firstStep as SequentialStep).task)\n\t\t: undefined);\n\ttry {\n\t\tif (params.validateOutputBindings !== false) {\n\t\t\tvalidateChainOutputBindings(chain, { maxItems: params.dynamicFanoutMaxItems });\n\t\t}\n\t} catch (error) {\n\t\tif (error instanceof ChainOutputValidationError) return { error: error.message };\n\t\tthrow error;\n\t}\n\tconst workflowGraph = buildWorkflowGraphSnapshot({ runId: id, mode: resultMode, steps: graphChain });\n\n\tfor (const s of chain) {\n\t\tconst stepAgents = isParallelStep(s)\n\t\t\t? s.parallel.map((t) => t.agent)\n\t\t\t: isDynamicParallelStep(s)\n\t\t\t\t? [s.parallel.agent]\n\t\t\t\t: [(s as SequentialStep).agent];\n\t\tfor (const agentName of stepAgents) {\n\t\t\tif (!agents.find((x) => x.name === agentName)) {\n\t\t\t\treturn { error: `Unknown agent: ${agentName}` };\n\t\t\t}\n\t\t}\n\t}\n\n\tlet progressInstructionCreated = false;\n\tconst buildStepOverrides = (s: SequentialStep): StepOverrides => {\n\t\tconst stepSkillInput = normalizeSkillInput(s.skill);\n\t\treturn {\n\t\t\t...(s.output !== undefined ? { output: s.output } : {}),\n\t\t\t...(s.outputMode !== undefined ? { outputMode: s.outputMode } : {}),\n\t\t\t...(s.reads !== undefined ? { reads: s.reads } : {}),\n\t\t\t...(s.progress !== undefined ? { progress: s.progress } : {}),\n\t\t\t...(stepSkillInput !== undefined ? { skills: stepSkillInput } : {}),\n\t\t\t...(s.model !== undefined ? { model: s.model } : {}),\n\t\t};\n\t};\n\tconst buildSeqStep = (s: SequentialStep, sessionFile?: string, behaviorCwd?: string, progressPrecreated = false, resolvedBehavior?: ResolvedStepBehavior, flatIndex?: number, parallelOutputNamespace?: { stepIndex: number; taskIndex?: number }) => {\n\t\tconst a = agents.find((x) => x.name === s.agent)!;\n\t\tconst toolBudgetInput = s.toolBudget ?? params.toolBudget ?? a.toolBudget ?? params.configToolBudget;\n\t\tconst resolvedToolBudget = validateToolBudgetConfig(toolBudgetInput, s.toolBudget ? \"toolBudget\" : a.toolBudget ? \"agent.toolBudget\" : \"config.toolBudget\");\n\t\tif (resolvedToolBudget.error) throw new AsyncStartValidationError(resolvedToolBudget.error);\n\t\tconst stepCwd = resolveChildCwd(runnerCwd, s.cwd);\n\t\tconst instructionCwd = behaviorCwd ?? stepCwd;\n\t\tlet behavior = suppressProgressForReadOnlyTask(resolvedBehavior ?? resolveStepBehavior(a, buildStepOverrides(s), chainSkills), s.task, originalTask);\n\t\tconst inheritedRelativeParallelOutput = parallelOutputNamespace && s.output === undefined && typeof behavior.output === \"string\" && !path.isAbsolute(behavior.output);\n\t\tif (inheritedRelativeParallelOutput && parallelOutputNamespace.taskIndex !== undefined) {\n\t\t\tbehavior = {\n\t\t\t\t...behavior,\n\t\t\t\toutput: path.join(`parallel-${parallelOutputNamespace.stepIndex}`, `${parallelOutputNamespace.taskIndex}-${s.agent}`, behavior.output),\n\t\t\t};\n\t\t}\n\t\tconst namespaceOutputPath = Boolean(inheritedRelativeParallelOutput && parallelOutputNamespace.taskIndex === undefined);\n\t\tconst skillNames = behavior.skills === false ? [] : behavior.skills;\n\t\tconst { resolved: resolvedSkills, missing: missingSkills } = resolveSkillsWithFallback(\n\t\t\tskillNames,\n\t\t\tstepCwd,\n\t\t\tctx.cwd,\n\t\t\ta.skillPath,\n\t\t\ta.filePath ? path.dirname(a.filePath) : stepCwd,\n\t\t);\n\t\tif (missingSkills.includes(\"pi-subagents\")) throw new UnavailableSubagentSkillError(UNAVAILABLE_SUBAGENT_SKILL_ERROR);\n\n\t\tlet systemPrompt = a.systemPrompt?.trim() ?? \"\";\n\t\tif (resolvedSkills.length > 0) {\n\t\t\tconst injection = buildSkillInjection(resolvedSkills);\n\t\t\tsystemPrompt = systemPrompt ? `${systemPrompt}\\n\\n${injection}` : injection;\n\t\t}\n\t\tconst memoryInjection = buildAgentMemoryInjection(a, stepCwd);\n\t\tif (memoryInjection) {\n\t\t\tsystemPrompt = systemPrompt ? `${systemPrompt}\\n\\n${memoryInjection}` : memoryInjection;\n\t\t}\n\n\t\tconst readInstructions = buildChainInstructions({ ...behavior, output: false, progress: false }, instructionCwd, false);\n\t\tconst isFirstProgressAgent = behavior.progress && !progressPrecreated && !progressInstructionCreated;\n\t\tif (behavior.progress) progressInstructionCreated = true;\n\t\tconst progressInstructions = buildChainInstructions({ ...behavior, output: false, reads: false }, progressDir, isFirstProgressAgent);\n\t\tconst outputPath = resolveSingleOutputPath(behavior.output, ctx.cwd, instructionCwd, outputBaseDir);\n\t\tif (!namespaceOutputPath) systemPrompt = injectOutputPathSystemPrompt(systemPrompt, outputPath, a);\n\t\tconst validationError = validateFileOnlyOutputMode(behavior.outputMode, outputPath, `Async step (${s.agent})`);\n\t\tif (validationError) throw new AsyncStartValidationError(validationError);\n\t\tlet taskTemplate = s.task ?? \"{previous}\";\n\t\ttaskTemplate = taskTemplate.replace(/\\{task\\}/g, originalTask ?? \"\");\n\t\ttaskTemplate = taskTemplate.replace(/\\{chain_dir\\}/g, runnerCwd);\n\t\tconst taskText = `${readInstructions.prefix}${taskTemplate}${progressInstructions.suffix}`;\n\t\tconst task = namespaceOutputPath ? taskText : injectSingleOutputInstruction(taskText, outputPath, a);\n\n\t\tconst primaryModel = resolveEffectiveSubagentModel(\n\t\t\ts.model,\n\t\t\ta.model,\n\t\t\tctx.currentModel,\n\t\t\tavailableModels,\n\t\t\tctx.currentModelProvider,\n\t\t\t{ scope: ctx.modelScope },\n\t\t);\n\t\tconst thinkingOverride = flatIndex === undefined ? undefined : thinkingOverridesByFlatIndex?.[flatIndex];\n\t\tconst effectiveThinking = thinkingOverride ?? a.thinking;\n\t\tconst model = applyThinkingSuffix(primaryModel, effectiveThinking, thinkingOverride !== undefined);\n\t\treturn {\n\t\t\tparentSessionId: ctx.parentSessionId ?? ctx.currentSessionId,\n\t\t\tagent: s.agent,\n\t\t\ttask,\n\t\t\tphase: s.phase,\n\t\t\tlabel: s.label,\n\t\t\toutputName: s.as,\n\t\t\tstructured: Boolean(s.outputSchema),\n\t\t\tcwd: stepCwd,\n\t\t\tmodel,\n\t\t\tthinking: resolveEffectiveThinking(model, effectiveThinking),\n\t\t\tmodelCandidates: buildModelCandidates(primaryModel, a.fallbackModels, availableModels, ctx.currentModelProvider, { scope: ctx.modelScope }).map((candidate) =>\n\t\t\t\tapplyThinkingSuffix(candidate, effectiveThinking, thinkingOverride !== undefined),\n\t\t\t),\n\t\t\ttools: a.tools,\n\t\t\textensions: a.extensions,\n\t\t\tsubagentOnlyExtensions: a.subagentOnlyExtensions,\n\t\t\tmcpDirectTools: a.mcpDirectTools,\n\t\t\tcompletionGuard: a.completionGuard,\n\t\t\tsystemPrompt,\n\t\t\tsystemPromptMode: a.systemPromptMode,\n\t\t\tinheritProjectContext: a.inheritProjectContext,\n\t\t\tinheritSkills: a.inheritSkills,\n\t\t\tskills: resolvedSkills.map((r) => r.name),\n\t\t\toutputPath,\n\t\t\t...(namespaceOutputPath ? { namespaceOutputPath: true } : {}),\n\t\t\toutputMode: behavior.outputMode,\n\t\t\tsessionFile,\n\t\t\tmaxSubagentDepth: resolveChildMaxSubagentDepth(maxSubagentDepth, a.maxSubagentDepth),\n\t\t\twaitToolEnabled: params.waitToolEnabled,\n\t\t\teffectiveAcceptance: resolveEffectiveAcceptance({\n\t\t\t\texplicit: s.acceptance,\n\t\t\t\tagentName: s.agent,\n\t\t\t\tacceptanceRole: a.acceptanceRole,\n\t\t\t\ttask,\n\t\t\t\tmode: resultMode,\n\t\t\t\tasync: true,\n\t\t\t\tdynamic: false,\n\t\t\t}),\n\t\t\tacceptanceInput: s.acceptance,\n\t\t\tacceptanceRole: a.acceptanceRole,\n\t\t\t...(s.outputSchema ? { structuredOutputSchema: s.outputSchema } : {}),\n\t\t\t...(s.outputSchema ? { structuredOutput: createStructuredOutputRuntime(s.outputSchema, path.join(asyncDir, \"structured-output\")) } : {}),\n\t\t\t...(resolvedToolBudget.budget ? { toolBudget: resolvedToolBudget.budget } : {}),\n\t\t};\n\t};\n\n\tlet flatStepIndex = 0;\n\tconst nextFlatStep = (): { index: number; sessionFile?: string; thinkingOverride?: AgentConfig[\"thinking\"] } => {\n\t\tconst index = flatStepIndex;\n\t\tconst sessionFile = sessionFilesByFlatIndex?.[flatStepIndex];\n\t\tconst thinkingOverride = thinkingOverridesByFlatIndex?.[flatStepIndex];\n\t\tflatStepIndex++;\n\t\treturn {\n\t\t\tindex,\n\t\t\t...(sessionFile ? { sessionFile } : {}),\n\t\t\t...(thinkingOverride ? { thinkingOverride } : {}),\n\t\t};\n\t};\n\n\ttry {\n\t\tconst builtSteps = chain.map((s, stepIndex) => {\n\t\t\tif (isParallelStep(s)) {\n\t\t\t\tconst parallelBehaviors = s.parallel.map((task) => {\n\t\t\t\t\tconst agent = agents.find((candidate) => candidate.name === task.agent)!;\n\t\t\t\t\treturn suppressProgressForReadOnlyTask(resolveStepBehavior(agent, buildStepOverrides(task), chainSkills), task.task, originalTask);\n\t\t\t\t});\n\t\t\t\tconst progressPrecreated = parallelBehaviors.some((behavior) => behavior.progress);\n\t\t\t\tif (progressPrecreated) {\n\t\t\t\t\tif (!s.worktree || params.progressDir) writeInitialProgressFile(progressDir);\n\t\t\t\t\tprogressInstructionCreated = true;\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tparallel: s.parallel.map((t, taskIndex) => {\n\t\t\t\t\t\tlet behaviorCwd: string | undefined;\n\t\t\t\t\t\tif (s.worktree) {\n\t\t\t\t\t\t\ttry {\n\t\t\t\t\t\t\t\tbehaviorCwd = resolveExpectedWorktreeAgentCwd(runnerCwd, `${id}-s${stepIndex}`, taskIndex, worktreeBaseDir);\n\t\t\t\t\t\t\t} catch {\n\t\t\t\t\t\t\t\tbehaviorCwd = undefined;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst staticStep = nextFlatStep();\n\t\t\t\t\t\treturn buildSeqStep(t, staticStep.sessionFile, behaviorCwd, progressPrecreated, parallelBehaviors[taskIndex], staticStep.index, { stepIndex, taskIndex });\n\t\t\t\t\t}),\n\t\t\t\t\tconcurrency: s.concurrency,\n\t\t\t\t\tfailFast: s.failFast,\n\t\t\t\t\tworktree: s.worktree,\n\t\t\t\t};\n\t\t\t}\n\t\t\tif (isDynamicParallelStep(s)) {\n\t\t\t\tconst agent = agents.find((candidate) => candidate.name === s.parallel.agent)!;\n\t\t\t\tconst behavior = suppressProgressForReadOnlyTask(resolveStepBehavior(agent, buildStepOverrides(s.parallel), chainSkills), s.parallel.task, originalTask);\n\t\t\t\tconst progressPrecreated = behavior.progress;\n\t\t\t\tif (progressPrecreated) {\n\t\t\t\t\twriteInitialProgressFile(progressDir);\n\t\t\t\t\tprogressInstructionCreated = true;\n\t\t\t\t}\n\t\t\t\tconst maxItems = s.expand.maxItems ?? params.dynamicFanoutMaxItems ?? 0;\n\t\t\t\tconst dynamicFlatSteps = Array.from({ length: maxItems }, () => nextFlatStep());\n\t\t\t\tconst parallel = buildSeqStep(s.parallel as SequentialStep, undefined, undefined, progressPrecreated, behavior, undefined, { stepIndex });\n\t\t\t\treturn {\n\t\t\t\t\texpand: s.expand,\n\t\t\t\t\tparallel,\n\t\t\t\t\tcollect: s.collect,\n\t\t\t\t\tconcurrency: s.concurrency,\n\t\t\t\t\tfailFast: s.failFast,\n\t\t\t\t\tphase: s.phase,\n\t\t\t\t\tlabel: s.label,\n\t\t\t\t\tsessionFiles: dynamicFlatSteps.map((step) => step.sessionFile),\n\t\t\t\t\tthinkingOverrides: dynamicFlatSteps.map((step) => step.thinkingOverride),\n\t\t\t\t\teffectiveAcceptance: resolveEffectiveAcceptance({\n\t\t\t\t\t\texplicit: s.acceptance,\n\t\t\t\t\t\tagentName: s.parallel.agent,\n\t\t\t\t\t\tacceptanceRole: agent.acceptanceRole,\n\t\t\t\t\t\ttask: parallel.task,\n\t\t\t\t\t\tmode: resultMode,\n\t\t\t\t\t\tasync: true,\n\t\t\t\t\t\tdynamicGroup: true,\n\t\t\t\t\t}),\n\t\t\t\t\tacceptanceInput: s.acceptance,\n\t\t\t\t\tacceptanceRole: agent.acceptanceRole,\n\t\t\t\t};\n\t\t\t}\n\t\t\tconst staticStep = nextFlatStep();\n\t\t\treturn buildSeqStep(s as SequentialStep, staticStep.sessionFile, undefined, false, undefined, staticStep.index);\n\t\t});\n\t\tconst steps = params.attachRoot\n\t\t\t? [{\n\t\t\t\t\tagent: params.attachRoot.agent,\n\t\t\t\t\ttask: \"\",\n\t\t\t\t\tlabel: params.attachRoot.label ?? `Attached root ${params.attachRoot.runId}`,\n\t\t\t\t\toutputName: params.attachRoot.outputName,\n\t\t\t\t\timportAsyncRoot: {\n\t\t\t\t\t\trunId: params.attachRoot.runId,\n\t\t\t\t\t\tasyncDir: params.attachRoot.asyncDir,\n\t\t\t\t\t\tresultPath: params.attachRoot.resultPath,\n\t\t\t\t\t\tindex: params.attachRoot.index,\n\t\t\t\t\t},\n\t\t\t\t\tinheritProjectContext: false,\n\t\t\t\t\tinheritSkills: false,\n\t\t\t\t}, ...builtSteps]\n\t\t\t: builtSteps;\n\t\tfor (const step of steps) {\n\t\t\tif (!(\"parallel\" in step) || !Array.isArray(step.parallel)) continue;\n\t\t\tconst seen = new Map<string, { index: number; agent: string }>();\n\t\t\tfor (let index = 0; index < step.parallel.length; index++) {\n\t\t\t\tconst task = step.parallel[index]!;\n\t\t\t\tif (!task.outputPath) continue;\n\t\t\t\tconst previous = seen.get(task.outputPath);\n\t\t\t\tif (previous) {\n\t\t\t\t\tthrow new AsyncStartValidationError(`Parallel tasks ${previous.index + 1} (${previous.agent}) and ${index + 1} (${task.agent}) resolve output to the same path: ${task.outputPath}. Use distinct output paths.`);\n\t\t\t\t}\n\t\t\t\tseen.set(task.outputPath, { index, agent: task.agent });\n\t\t\t}\n\t\t}\n\t\treturn { steps, runnerCwd, workflowGraph, eventChain: graphChain, ...(originalTask !== undefined ? { originalTask } : {}) };\n\t} catch (error) {\n\t\tif (error instanceof UnavailableSubagentSkillError || error instanceof AsyncStartValidationError) return { error: error.message };\n\t\tthrow error;\n\t}\n}\n\n/**\n * Execute a chain asynchronously\n */\nexport function executeAsyncChain(\n\tid: string,\n\tparams: AsyncChainParams,\n): AsyncExecutionResult {\n\tconst {\n\t\tchain,\n\t\tagents,\n\t\tctx,\n\t\tcwd,\n\t\tmaxOutput,\n\t\tartifactsDir,\n\t\tartifactConfig,\n\t\tshareEnabled,\n\t\tsessionRoot,\n\t\tsessionFilesByFlatIndex,\n\t\tthinkingOverridesByFlatIndex,\n\t\tmaxSubagentDepth,\n\t\tworktreeSetupHook,\n\t\tworktreeSetupHookTimeoutMs,\n\t\tworktreeBaseDir,\n\t\tcontrolConfig,\n\t\tcontrolIntercomTarget,\n\t\tchildIntercomTarget,\n\t\tnestedRoute,\n\t} = params;\n\tconst resultMode = params.resultMode ?? \"chain\";\n\tconst inheritedNestedRoute = resolveInheritedNestedRouteFromEnv();\n\tconst nestedAddress = inheritedNestedRoute ? resolveNestedParentAddressFromEnv() : undefined;\n\tconst asyncDir = inheritedNestedRoute\n\t\t? path.join(TEMP_ROOT_DIR, \"nested-subagent-runs\", inheritedNestedRoute.rootRunId, id)\n\t\t: path.join(ASYNC_DIR, id);\n\ttry {\n\t\tfs.mkdirSync(asyncDir, { recursive: true });\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Failed to create async run directory '${asyncDir}': ${message}` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: resultMode, results: [] },\n\t\t};\n\t}\n\n\tconst built = buildAsyncRunnerSteps(id, {\n\t\tchain,\n\t\ttask: params.task,\n\t\tattachRoot: params.attachRoot,\n\t\tresultMode,\n\t\tagents,\n\t\tctx,\n\t\tavailableModels: params.availableModels,\n\t\tcwd,\n\t\tchainSkills: params.chainSkills,\n\t\tsessionFilesByFlatIndex,\n\t\tthinkingOverridesByFlatIndex,\n\t\tprogressDir: params.progressDir ?? (artifactsDir ? path.join(artifactsDir, \"progress\", id) : resultMode === \"parallel\" ? path.join(asyncDir, \"progress\") : undefined),\n\t\toutputBaseDir: artifactsDir ? path.join(artifactsDir, \"outputs\", id) : undefined,\n\t\tdynamicFanoutMaxItems: params.dynamicFanoutMaxItems,\n\t\tmaxSubagentDepth,\n\t\twaitToolEnabled: params.waitToolEnabled,\n\t\tworktreeBaseDir,\n\t\tasyncDir,\n\t\ttoolBudget: params.toolBudget,\n\t\tconfigToolBudget: params.configToolBudget,\n\t});\n\tif (\"error\" in built) {\n\t\ttry {\n\t\t\tfs.rmSync(asyncDir, { recursive: true, force: true });\n\t\t} catch {\n\t\t\t// Best-effort cleanup for validation failures before the runner is spawned.\n\t\t}\n\t\treturn formatAsyncStartError(resultMode, built.error);\n\t}\n\tconst { steps, runnerCwd, workflowGraph, eventChain } = built;\n\tconst deadlineAt = params.timeoutMs !== undefined ? Date.now() + params.timeoutMs : undefined;\n\tconst initialTurnBudget = params.turnBudget ? initialTurnBudgetState(params.turnBudget) : undefined;\n\tlet childTargetIndex = 0;\n\tconst childIntercomTargets = childIntercomTarget ? steps.flatMap((step) => {\n\t\tif (!(\"parallel\" in step) && step.importAsyncRoot) {\n\t\t\tchildTargetIndex++;\n\t\t\treturn [undefined];\n\t\t}\n\t\tif (\"parallel\" in step) {\n\t\t\tif (!Array.isArray(step.parallel)) {\n\t\t\t\tchildTargetIndex++;\n\t\t\t\treturn [undefined];\n\t\t\t}\n\t\t\treturn step.parallel.map((task) => childIntercomTarget(task.agent, childTargetIndex++));\n\t\t}\n\t\treturn [childIntercomTarget(step.agent, childTargetIndex++)];\n\t}) : undefined;\n\n\tlet spawnResult: { pid?: number; error?: string } = {};\n\ttry {\n\t\tspawnResult = spawnRunner(\n\t\t\t{\n\t\t\t\tid,\n\t\t\t\tsteps,\n\t\t\t\tresultPath: inheritedNestedRoute ? nestedResultsPath(inheritedNestedRoute.rootRunId, id) : path.join(RESULTS_DIR, `${id}.json`),\n\t\t\t\tcwd: runnerCwd,\n\t\t\t\tplaceholder: \"{previous}\",\n\t\t\t\tmaxOutput,\n\t\t\t\tartifactsDir: artifactConfig.enabled ? artifactsDir : undefined,\n\t\t\t\tartifactConfig,\n\t\t\t\tshare: shareEnabled,\n\t\t\t\tsessionDir: sessionRoot ? path.join(sessionRoot, `async-${id}`) : undefined,\n\t\t\t\tasyncDir,\n\t\t\t\tsessionId: ctx.currentSessionId,\n\t\t\t\tpiPackageRoot,\n\t\t\t\tpiArgv1: process.argv[1],\n\t\t\t\tworktreeSetupHook,\n\t\t\t\tworktreeSetupHookTimeoutMs,\n\t\t\t\tworktreeBaseDir,\n\t\t\t\tcontrolConfig,\n\t\t\t\tturnBudget: params.turnBudget,\n\t\t\t\ttoolBudget: params.toolBudget,\n\t\t\t\tcontrolIntercomTarget,\n\t\t\t\tchildIntercomTargets,\n\t\t\t\tresultMode,\n\t\t\t\tdynamicFanoutMaxItems: params.dynamicFanoutMaxItems,\n\t\t\t\ttimeoutMs: params.timeoutMs,\n\t\t\t\tdeadlineAt,\n\t\t\t\tglobalConcurrencyLimit: params.globalConcurrencyLimit,\n\t\t\t\tworkflowGraph,\n\t\t\t\tnestedRoute: nestedRoute ?? inheritedNestedRoute,\n\t\t\t\tnestedSelf: inheritedNestedRoute && nestedAddress ? {\n\t\t\t\t\tparentRunId: nestedAddress.parentRunId,\n\t\t\t\t\tparentStepIndex: nestedAddress.parentStepIndex,\n\t\t\t\t\tdepth: nestedAddress.depth,\n\t\t\t\t\tpath: nestedAddress.path,\n\t\t\t\t} : undefined,\n\t\t\t},\n\t\t\tid,\n\t\t\trunnerCwd,\n\t\t);\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\treturn formatAsyncStartError(resultMode, `Failed to start async ${resultMode} '${id}': ${message}`);\n\t}\n\n\tif (spawnResult.error) {\n\t\treturn formatAsyncStartError(resultMode, `Failed to start async ${resultMode} '${id}': ${spawnResult.error}`);\n\t}\n\n\tif (spawnResult.pid) {\n\t\tconst eventFirstStep = eventChain[0];\n\t\tconst firstAgents = isParallelStep(eventFirstStep)\n\t\t\t? eventFirstStep.parallel.map((t) => t.agent)\n\t\t\t: isDynamicParallelStep(eventFirstStep)\n\t\t\t\t? [eventFirstStep.parallel.agent]\n\t\t\t: [(eventFirstStep as SequentialStep).agent];\n\t\tconst firstTask = isParallelStep(eventFirstStep)\n\t\t\t? eventFirstStep.parallel[0]?.task\n\t\t\t: isDynamicParallelStep(eventFirstStep)\n\t\t\t\t? eventFirstStep.parallel.task\n\t\t\t\t: (eventFirstStep as SequentialStep).task;\n\t\tconst workflowGoal = params.goal ?? (params.task?.trim() || firstTask);\n\t\tconst parallelGroups: Array<{ start: number; count: number; stepIndex: number }> = [];\n\t\tconst flatAgents: string[] = [];\n\t\tlet flatStepStart = 0;\n\t\tfor (let stepIndex = 0; stepIndex < eventChain.length; stepIndex++) {\n\t\t\tconst step = eventChain[stepIndex]!;\n\t\t\tif (isParallelStep(step)) {\n\t\t\t\tparallelGroups.push({ start: flatStepStart, count: step.parallel.length, stepIndex });\n\t\t\t\tflatAgents.push(...step.parallel.map((task) => task.agent));\n\t\t\t\tflatStepStart += step.parallel.length;\n\t\t\t} else if (isDynamicParallelStep(step)) {\n\t\t\t\tparallelGroups.push({ start: flatStepStart, count: 1, stepIndex });\n\t\t\t\tflatAgents.push(step.parallel.agent);\n\t\t\t\tflatStepStart++;\n\t\t\t} else {\n\t\t\t\tflatAgents.push((step as SequentialStep).agent);\n\t\t\t\tflatStepStart++;\n\t\t\t}\n\t\t}\n\t\tif (inheritedNestedRoute && nestedAddress) {\n\t\t\tconst now = Date.now();\n\t\t\ttry {\n\t\t\t\twriteNestedEvent(inheritedNestedRoute, {\n\t\t\t\t\ttype: \"subagent.nested.started\",\n\t\t\t\t\tts: now,\n\t\t\t\t\tparentRunId: nestedAddress.parentRunId,\n\t\t\t\t\tparentStepIndex: nestedAddress.parentStepIndex,\n\t\t\t\t\tchild: {\n\t\t\t\t\t\tid,\n\t\t\t\t\t\tparentRunId: nestedAddress.parentRunId,\n\t\t\t\t\t\tparentStepIndex: nestedAddress.parentStepIndex,\n\t\t\t\t\t\tdepth: nestedAddress.depth,\n\t\t\t\t\t\tpath: nestedAddress.path,\n\t\t\t\t\t\tasyncDir,\n\t\t\t\t\t\tpid: spawnResult.pid,\n\t\t\t\t\t\townerIntercomTarget: process.env.PI_SUBAGENT_INTERCOM_SESSION_NAME,\n\t\t\t\t\t\tleafIntercomTarget: childIntercomTargets?.[0],\n\t\t\t\t\t\tintercomTarget: childIntercomTargets?.[0],\n\t\t\t\t\t\townerState: \"live\",\n\t\t\t\t\t\tmode: resultMode,\n\t\t\t\t\t\tstate: \"running\",\n\t\t\t\t\t\tagent: firstAgents[0],\n\t\t\t\t\t\tagents: flatAgents,\n\t\t\t\t\t\tchainStepCount: eventChain.length,\n\t\t\t\t\t\tparallelGroups,\n\t\t\t\t\t\t...(params.timeoutMs !== undefined ? { timeoutMs: params.timeoutMs, deadlineAt } : {}),\n\t\t\t\t\t\t...(initialTurnBudget ? { turnBudget: initialTurnBudget } : {}),\n\t\t\t\t\t\tstartedAt: now,\n\t\t\t\t\t\tlastUpdate: now,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(\"Failed to emit nested async start event:\", error);\n\t\t\t}\n\t\t}\n\t\tctx.pi.events.emit(SUBAGENT_ASYNC_STARTED_EVENT, {\n\t\t\tlifecycleArtifactVersion: SUBAGENT_LIFECYCLE_ARTIFACT_VERSION,\n\t\t\tid,\n\t\t\tpid: spawnResult.pid,\n\t\t\tsessionId: ctx.currentSessionId,\n\t\t\tmode: resultMode,\n\t\t\tagent: firstAgents[0],\n\t\t\tagents: flatAgents,\n\t\t\ttask: firstTask?.slice(0, 50),\n\t\t\tgoal: workflowGoal?.slice(0, 120),\n\t\t\tchain: eventChain.map((s) =>\n\t\t\t\tisParallelStep(s) ? `[${s.parallel.map((t) => t.agent).join(\"+\")}]` : isDynamicParallelStep(s) ? `expand:${s.parallel.agent}` : (s as SequentialStep).agent,\n\t\t\t),\n\t\t\tchainStepCount: eventChain.length,\n\t\t\tparallelGroups,\n\t\t\tworkflowGraph,\n\t\t\tcwd: runnerCwd,\n\t\t\tasyncDir,\n\t\t\t...(params.timeoutMs !== undefined ? { timeoutMs: params.timeoutMs, deadlineAt } : {}),\n\t\t\t...(initialTurnBudget ? { turnBudget: initialTurnBudget } : {}),\n\t\t\tnestedRoute,\n\t\t});\n\t}\n\n\tconst chainDesc = chain\n\t\t.map((s) =>\n\t\t\tisParallelStep(s) ? `[${s.parallel.map((t) => t.agent).join(\"+\")}]` : isDynamicParallelStep(s) ? `expand:${s.parallel.agent}` : (s as SequentialStep).agent,\n\t\t)\n\t\t.join(\" -> \");\n\n\treturn {\n\t\tcontent: [{ type: \"text\", text: formatAsyncStartedMessage(`Async ${resultMode}: ${chainDesc} [${id}]`) }],\n\t\tdetails: { mode: resultMode, runId: id, results: [], asyncId: id, asyncDir, workflowGraph, ...(params.timeoutMs !== undefined ? { timeoutMs: params.timeoutMs, deadlineAt } : {}), ...(params.turnBudget ? { turnBudget: params.turnBudget } : {}), ...(params.toolBudget ? { toolBudget: params.toolBudget } : {}) },\n\t};\n}\n\n/**\n * Execute a single agent asynchronously\n */\nexport function executeAsyncSingle(\n\tid: string,\n\tparams: AsyncSingleParams,\n): AsyncExecutionResult {\n\tconst {\n\t\tagent,\n\t\tagentConfig,\n\t\tctx,\n\t\tcwd,\n\t\tmaxOutput,\n\t\tartifactsDir,\n\t\tartifactConfig,\n\t\tshareEnabled,\n\t\tsessionRoot,\n\t\tsessionFile,\n\t\tmaxSubagentDepth,\n\t\tworktreeSetupHook,\n\t\tworktreeSetupHookTimeoutMs,\n\t\tworktreeBaseDir,\n\t\tcontrolConfig,\n\t\tcontrolIntercomTarget,\n\t\tchildIntercomTarget,\n\t\tnestedRoute,\n\t} = params;\n\tconst task = params.task ?? \"\";\n\tconst runnerCwd = resolveChildCwd(ctx.cwd, cwd);\n\tconst skillNames = params.skills ?? agentConfig.skills ?? [];\n\tconst availableModels = params.availableModels;\n\tconst { resolved: resolvedSkills, missing: missingSkills } = resolveSkillsWithFallback(\n\t\tskillNames,\n\t\trunnerCwd,\n\t\tctx.cwd,\n\t\tagentConfig.skillPath,\n\t\tagentConfig.filePath ? path.dirname(agentConfig.filePath) : runnerCwd,\n\t);\n\tif (missingSkills.includes(\"pi-subagents\")) return formatAsyncStartError(\"single\", UNAVAILABLE_SUBAGENT_SKILL_ERROR);\n\tlet systemPrompt = agentConfig.systemPrompt?.trim() ?? \"\";\n\tif (resolvedSkills.length > 0) {\n\t\tconst injection = buildSkillInjection(resolvedSkills);\n\t\tsystemPrompt = systemPrompt ? `${systemPrompt}\\n\\n${injection}` : injection;\n\t}\n\tconst memoryInjection = buildAgentMemoryInjection(agentConfig, runnerCwd);\n\tif (memoryInjection) {\n\t\tsystemPrompt = systemPrompt ? `${systemPrompt}\\n\\n${memoryInjection}` : memoryInjection;\n\t}\n\n\tconst inheritedNestedRoute = resolveInheritedNestedRouteFromEnv();\n\tconst nestedAddress = inheritedNestedRoute ? resolveNestedParentAddressFromEnv() : undefined;\n\tconst asyncDir = inheritedNestedRoute\n\t\t? path.join(TEMP_ROOT_DIR, \"nested-subagent-runs\", inheritedNestedRoute.rootRunId, id)\n\t\t: path.join(ASYNC_DIR, id);\n\ttry {\n\t\tfs.mkdirSync(asyncDir, { recursive: true });\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Failed to create async run directory '${asyncDir}': ${message}` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"single\" as const, results: [] },\n\t\t};\n\t}\n\n\tconst effectiveOutput = normalizeSingleOutputOverride(params.output, agentConfig.output);\n\tconst outputPath = resolveSingleOutputPath(effectiveOutput, ctx.cwd, runnerCwd, params.outputBaseDir ?? (artifactsDir ? path.join(artifactsDir, \"outputs\", id) : undefined));\n\tsystemPrompt = injectOutputPathSystemPrompt(systemPrompt, outputPath, agentConfig);\n\tconst outputMode = params.outputMode ?? \"inline\";\n\tconst validationError = validateFileOnlyOutputMode(outputMode, outputPath, `Async single run (${agent})`);\n\tif (validationError) return formatAsyncStartError(\"single\", validationError);\n\tconst taskWithOutputInstruction = injectSingleOutputInstruction(task, outputPath, agentConfig);\n\tconst primaryModel = resolveSubagentModelOverride(\n\t\tparams.modelOverride ?? agentConfig.model,\n\t\tctx.currentModel,\n\t\tavailableModels,\n\t\tctx.currentModelProvider,\n\t);\n\tconst effectiveThinking = params.thinkingOverride ?? agentConfig.thinking;\n\tconst model = applyThinkingSuffix(primaryModel, effectiveThinking, params.thinkingOverride !== undefined);\n\tconst toolBudgetInput = params.toolBudget ?? agentConfig.toolBudget ?? params.configToolBudget;\n\tconst resolvedToolBudget = validateToolBudgetConfig(toolBudgetInput, params.toolBudget ? \"toolBudget\" : agentConfig.toolBudget ? \"agent.toolBudget\" : \"config.toolBudget\");\n\tif (resolvedToolBudget.error) return formatAsyncStartError(\"single\", resolvedToolBudget.error);\n\tconst deadlineAt = params.absoluteDeadlineAt ?? (params.timeoutMs !== undefined ? Date.now() + params.timeoutMs : undefined);\n\tconst timeoutMs = params.absoluteDeadlineAt !== undefined && deadlineAt !== undefined\n\t\t? deadlineAt - Date.now()\n\t\t: params.timeoutMs;\n\tif (timeoutMs !== undefined && timeoutMs <= 0) return formatAsyncStartError(\"single\", \"The source run's absolute deadline expired before recovery could launch.\");\n\tconst initialTurnBudget = params.turnBudget ? initialTurnBudgetState(params.turnBudget) : undefined;\n\tconst resolvedSessionDir = params.sessionDir ?? (sessionRoot ? path.join(sessionRoot, `async-${id}`) : undefined);\n\tconst resolvedAcceptance = resolveEffectiveAcceptance({\n\t\texplicit: params.acceptance,\n\t\tagentName: agent,\n\t\tacceptanceRole: agentConfig.acceptanceRole,\n\t\ttask,\n\t\tmode: \"single\",\n\t\tasync: true,\n\t});\n\tconst recoveryDescriptor: SteeringRecoveryDescriptor = {\n\t\tversion: 1,\n\t\tsourceRunId: id,\n\t\tagent,\n\t\t...(sessionFile ? { sessionFile } : {}),\n\t\tcwd: runnerCwd,\n\t\t...(model ? { model } : {}),\n\t\t...(agentConfig.fallbackModels ? { fallbackModels: [...agentConfig.fallbackModels] } : {}),\n\t\t...(effectiveThinking ? { thinking: resolveEffectiveThinking(model, effectiveThinking) } : {}),\n\t\t...(agentConfig.tools ? { tools: [...agentConfig.tools] } : {}),\n\t\t...(agentConfig.extensions ? { extensions: [...agentConfig.extensions] } : {}),\n\t\t...(agentConfig.subagentOnlyExtensions ? { subagentOnlyExtensions: [...agentConfig.subagentOnlyExtensions] } : {}),\n\t\t...(agentConfig.mcpDirectTools ? { mcpDirectTools: [...agentConfig.mcpDirectTools] } : {}),\n\t\t...(agentConfig.systemPrompt ? { systemPrompt: agentConfig.systemPrompt } : {}),\n\t\tsystemPromptMode: agentConfig.systemPromptMode,\n\t\tinheritProjectContext: agentConfig.inheritProjectContext,\n\t\tinheritSkills: agentConfig.inheritSkills,\n\t\t...(resolvedSkills.length ? { skills: resolvedSkills.map((skill) => skill.name) } : {}),\n\t\t...(agentConfig.skillPath ? { skillPath: [...agentConfig.skillPath] } : {}),\n\t\t...(agentConfig.filePath ? { agentFilePath: agentConfig.filePath } : {}),\n\t\t...(agentConfig.completionGuard !== undefined ? { completionGuard: agentConfig.completionGuard } : {}),\n\t\t...(agentConfig.memory ? { memory: { ...agentConfig.memory } } : {}),\n\t\t...(outputPath ? { outputPath } : {}),\n\t\toutputMode,\n\t\t...(resolvedAcceptance ? { acceptance: resolvedAcceptance } : {}),\n\t\t...(controlConfig ? { controlConfig } : {}),\n\t\t...(deadlineAt !== undefined ? { absoluteDeadlineAt: deadlineAt } : {}),\n\t\t...(params.turnBudget ? { initialTurnBudget: params.turnBudget } : {}),\n\t\t...(resolvedToolBudget.budget ? { initialToolBudget: resolvedToolBudget.budget } : {}),\n\t\tmaxSubagentDepth: resolveChildMaxSubagentDepth(maxSubagentDepth, agentConfig.maxSubagentDepth),\n\t\t...(maxOutput ? { maxOutput } : {}),\n\t\tshare: shareEnabled,\n\t\t...(resolvedSessionDir ? { sessionDir: resolvedSessionDir } : {}),\n\t\t...(artifactsDir ? { artifactsDir } : {}),\n\t\tartifactConfig,\n\t};\n\ttry {\n\t\twritePrivateAtomicJson(path.join(asyncDir, \"recovery-descriptor.json\"), recoveryDescriptor);\n\t} catch (error) {\n\t\treturn formatAsyncStartError(\"single\", `Failed to persist async recovery descriptor for '${id}': ${error instanceof Error ? error.message : String(error)}`);\n\t}\n\tlet spawnResult: { pid?: number; error?: string } = {};\n\ttry {\n\t\tspawnResult = spawnRunner(\n\t\t\t{\n\t\t\t\tid,\n\t\t\t\tsteps: [\n\t\t\t\t\t{\n\t\t\t\t\t\tparentSessionId: ctx.parentSessionId ?? ctx.currentSessionId,\n\t\t\t\t\t\tagent,\n\t\t\t\t\t\ttask: taskWithOutputInstruction,\n\t\t\t\t\t\tcwd: runnerCwd,\n\t\t\t\t\t\tmodel,\n\t\t\t\t\t\tthinking: resolveEffectiveThinking(model, effectiveThinking),\n\t\t\t\t\t\tmodelCandidates: buildModelCandidates(primaryModel, agentConfig.fallbackModels, availableModels, ctx.currentModelProvider, { scope: ctx.modelScope }).map((candidate) =>\n\t\t\t\t\t\t\tapplyThinkingSuffix(candidate, effectiveThinking, params.thinkingOverride !== undefined),\n\t\t\t\t\t\t),\n\t\t\t\t\t\ttools: agentConfig.tools,\n\t\t\t\t\t\textensions: agentConfig.extensions,\n\t\t\t\t\t\tsubagentOnlyExtensions: agentConfig.subagentOnlyExtensions,\n\t\t\t\t\t\tmcpDirectTools: agentConfig.mcpDirectTools,\n\t\t\t\t\t\tcompletionGuard: agentConfig.completionGuard,\n\t\t\t\t\t\tsystemPrompt,\n\t\t\t\t\t\tsystemPromptMode: agentConfig.systemPromptMode,\n\t\t\t\t\t\tinheritProjectContext: agentConfig.inheritProjectContext,\n\t\t\t\t\t\tinheritSkills: agentConfig.inheritSkills,\n\t\t\t\t\t\tskills: resolvedSkills.map((r) => r.name),\n\t\t\t\t\t\toutputPath,\n\t\t\t\t\t\toutputMode,\n\t\t\t\t\t\tsessionFile,\n\t\t\t\t\t\tmaxSubagentDepth: resolveChildMaxSubagentDepth(maxSubagentDepth, agentConfig.maxSubagentDepth),\n\t\t\t\t\t\twaitToolEnabled: params.waitToolEnabled,\n\t\t\t\t\t\teffectiveAcceptance: resolvedAcceptance,\n\t\t\t\t\t\t...(resolvedToolBudget.budget ? { toolBudget: resolvedToolBudget.budget } : {}),\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t\tresultPath: inheritedNestedRoute ? nestedResultsPath(inheritedNestedRoute.rootRunId, id) : path.join(RESULTS_DIR, `${id}.json`),\n\t\t\t\tcwd: runnerCwd,\n\t\t\t\tplaceholder: \"{previous}\",\n\t\t\t\tmaxOutput,\n\t\t\t\tartifactsDir: artifactConfig.enabled ? artifactsDir : undefined,\n\t\t\t\tartifactConfig,\n\t\t\t\tshare: shareEnabled,\n\t\t\t\tsessionDir: resolvedSessionDir,\n\t\t\t\tasyncDir,\n\t\t\t\tsessionId: ctx.currentSessionId,\n\t\t\t\tpiPackageRoot,\n\t\t\t\tpiArgv1: process.argv[1],\n\t\t\t\tworktreeSetupHook,\n\t\t\t\tworktreeSetupHookTimeoutMs,\n\t\t\t\tworktreeBaseDir,\n\t\t\t\tcontrolConfig,\n\t\t\t\ttimeoutMs,\n\t\t\t\tdeadlineAt,\n\t\t\t\tturnBudget: params.turnBudget,\n\t\t\t\ttoolBudget: params.toolBudget,\n\t\t\t\tcontrolIntercomTarget,\n\t\t\t\tchildIntercomTargets: childIntercomTarget ? [childIntercomTarget(agent, 0)] : undefined,\n\t\t\t\tresultMode: \"single\",\n\t\t\t\t...(params.revivalLease ? { revivalLease: params.revivalLease } : {}),\n\t\t\t\tnestedRoute: nestedRoute ?? inheritedNestedRoute,\n\t\t\t\tnestedSelf: inheritedNestedRoute && nestedAddress ? {\n\t\t\t\t\tparentRunId: nestedAddress.parentRunId,\n\t\t\t\t\tparentStepIndex: nestedAddress.parentStepIndex,\n\t\t\t\t\tdepth: nestedAddress.depth,\n\t\t\t\t\tpath: nestedAddress.path,\n\t\t\t\t} : undefined,\n\t\t\t},\n\t\t\tid,\n\t\t\trunnerCwd,\n\t\t);\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\treturn formatAsyncStartError(\"single\", `Failed to start async run '${id}': ${message}`);\n\t}\n\n\tif (spawnResult.error) {\n\t\treturn formatAsyncStartError(\"single\", `Failed to start async run '${id}': ${spawnResult.error}`);\n\t}\n\n\tif (spawnResult.pid) {\n\t\tif (inheritedNestedRoute && nestedAddress) {\n\t\t\tconst now = Date.now();\n\t\t\ttry {\n\t\t\t\twriteNestedEvent(inheritedNestedRoute, {\n\t\t\t\t\ttype: \"subagent.nested.started\",\n\t\t\t\t\tts: now,\n\t\t\t\t\tparentRunId: nestedAddress.parentRunId,\n\t\t\t\t\tparentStepIndex: nestedAddress.parentStepIndex,\n\t\t\t\t\tchild: {\n\t\t\t\t\t\tid,\n\t\t\t\t\t\tparentRunId: nestedAddress.parentRunId,\n\t\t\t\t\t\tparentStepIndex: nestedAddress.parentStepIndex,\n\t\t\t\t\t\tdepth: nestedAddress.depth,\n\t\t\t\t\t\tpath: nestedAddress.path,\n\t\t\t\t\t\tasyncDir,\n\t\t\t\t\t\tpid: spawnResult.pid,\n\t\t\t\t\t\townerIntercomTarget: process.env.PI_SUBAGENT_INTERCOM_SESSION_NAME,\n\t\t\t\t\t\tleafIntercomTarget: childIntercomTarget?.(agent, 0),\n\t\t\t\t\t\tintercomTarget: childIntercomTarget?.(agent, 0),\n\t\t\t\t\t\townerState: \"live\",\n\t\t\t\t\t\tmode: \"single\",\n\t\t\t\t\t\tstate: \"running\",\n\t\t\t\t\t\tagent,\n\t\t\t\t\t\tagents: [agent],\n\t\t\t\t\t\tchainStepCount: 1,\n\t\t\t\t\t\t...(timeoutMs !== undefined ? { timeoutMs, deadlineAt } : {}),\n\t\t\t\t\t\t...(initialTurnBudget ? { turnBudget: initialTurnBudget } : {}),\n\t\t\t\t\t\tstartedAt: now,\n\t\t\t\t\t\tlastUpdate: now,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tconsole.error(\"Failed to emit nested async start event:\", error);\n\t\t\t}\n\t\t}\n\t\tctx.pi.events.emit(SUBAGENT_ASYNC_STARTED_EVENT, {\n\t\t\tlifecycleArtifactVersion: SUBAGENT_LIFECYCLE_ARTIFACT_VERSION,\n\t\t\tid,\n\t\t\tpid: spawnResult.pid,\n\t\t\tsessionId: ctx.currentSessionId,\n\t\t\tmode: \"single\",\n\t\t\tagent,\n\t\t\ttask: task?.slice(0, 50),\n\t\t\tgoal: (params.goal ?? task).slice(0, 120),\n\t\t\tcwd: runnerCwd,\n\t\t\tasyncDir,\n\t\t\t...(timeoutMs !== undefined ? { timeoutMs, deadlineAt } : {}),\n\t\t\t...(initialTurnBudget ? { turnBudget: initialTurnBudget } : {}),\n\t\t\tnestedRoute,\n\t\t});\n\t}\n\n\treturn {\n\t\tcontent: [{ type: \"text\", text: formatAsyncStartedMessage(`Async: ${agent} [${id}]`) }],\n\t\tdetails: { mode: \"single\", runId: id, results: [], asyncId: id, asyncDir, ...(timeoutMs !== undefined ? { timeoutMs, deadlineAt } : {}), ...(params.turnBudget ? { turnBudget: params.turnBudget } : {}), ...(params.toolBudget ? { toolBudget: params.toolBudget } : {}) },\n\t};\n}\n"]}