@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/background/result-watcher.js

@@ -0,0 +1,247 @@
+// @ts-nocheck
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { buildCompletionKey, markSeenWithTtl } from "./completion-dedupe.js";
+import { createFileCoalescer } from "../../shared/file-coalescer.js";
+import { SUBAGENT_ASYNC_COMPLETE_EVENT, } from "../../shared/types.js";
+import { attachNestedChildrenToResultChildren, buildSubagentResultIntercomPayload, compactNestedResultChildren, deliverSubagentResultIntercomEvent, resolveSubagentResultStatus, } from "../../intercom/result-intercom.js";
+import { projectNestedRegistryForRoot, sanitizeSummary } from "../shared/nested-events.js";
+import { resolveWatchPath } from "../../shared/utils.js";
+const WATCHER_RESTART_DELAY_MS = 3000;
+const POLL_INTERVAL_MS = 3000;
+function sanitizeNestedResultChildren(value, resultPath, label) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value)) {
+        console.error(`Ignoring invalid nested children in subagent result file '${resultPath}' at ${label}: expected an array.`);
+        return undefined;
+    }
+    const children = value.map((child) => sanitizeSummary(child)).filter((child) => Boolean(child));
+    if (children.length !== value.length) {
+        console.error(`Ignoring ${value.length - children.length} invalid nested child record(s) in subagent result file '${resultPath}' at ${label}.`);
+    }
+    return children.length ? children : undefined;
+}
+function getErrorCode(error) {
+    return typeof error === "object" && error !== null && "code" in error
+        ? error.code
+        : undefined;
+}
+function isNotFoundError(error) {
+    return getErrorCode(error) === "ENOENT";
+}
+function shouldFallBackToPolling(error) {
+    const code = getErrorCode(error);
+    return code === "EMFILE" || code === "ENOSPC";
+}
+export function createResultWatcher(pi, state, resultsDir, completionTtlMs, deps = {}) {
+    const fsApi = deps.fs ?? fs;
+    const timers = deps.timers ?? { setTimeout, clearTimeout, setInterval, clearInterval };
+    const handleResult = async (file) => {
+        const resultPath = path.join(resultsDir, file);
+        if (!fsApi.existsSync(resultPath))
+            return;
+        try {
+            const data = JSON.parse(fsApi.readFileSync(resultPath, "utf-8"));
+            if (typeof data.sessionId !== "string" || data.sessionId !== state.currentSessionId)
+                return;
+            const runId = data.runId ?? data.id ?? file.replace(/\.json$/i, "");
+            const hasExplicitNestedChildren = data.nestedChildren !== undefined;
+            let nestedChildren = compactNestedResultChildren(sanitizeNestedResultChildren(data.nestedChildren, resultPath, "nestedChildren"));
+            if (!nestedChildren?.length && !hasExplicitNestedChildren) {
+                try {
+                    nestedChildren = compactNestedResultChildren(projectNestedRegistryForRoot(runId)?.children);
+                }
+                catch (error) {
+                    console.error(`Failed to enrich subagent result file '${resultPath}' with nested registry children; will retry later:`, error);
+                    return;
+                }
+            }
+            const now = Date.now();
+            const completionKey = buildCompletionKey(data, `result:${file}`);
+            if (markSeenWithTtl(state.completionSeen, completionKey, now, completionTtlMs)) {
+                fsApi.unlinkSync(resultPath);
+                return;
+            }
+            const hasResultChildren = Array.isArray(data.results) && data.results.length > 0;
+            const resultChildren = hasResultChildren
+                ? data.results
+                : [{
+                        agent: data.agent,
+                        output: data.summary,
+                        success: data.success,
+                    }];
+            const normalizedChildren = attachNestedChildrenToResultChildren(runId, resultChildren.map((result = {}, index) => {
+                const baseOutput = result.output ?? data.summary;
+                const hasRealOutput = typeof baseOutput === "string" && baseOutput.trim().length > 0;
+                const output = hasRealOutput ? baseOutput : "(no output)";
+                const summary = result.success === false && result.error
+                    ? `${result.error}${hasRealOutput ? `\n\nOutput:\n${baseOutput}` : ""}`
+                    : output;
+                const sessionPath = result.sessionFile ?? (resultChildren.length === 1 ? data.sessionFile : undefined);
+                const childNestedChildren = sanitizeNestedResultChildren(result.children, resultPath, `results[${index}].children`);
+                const childState = result.state === "paused" || result.state === "stopped"
+                    ? result.state
+                    : result.stopped === true
+                        ? "stopped"
+                        : data.state === "paused" || (!hasResultChildren && (data.state === "stopped" || typeof result.success !== "boolean"))
+                            ? data.state
+                            : undefined;
+                return {
+                    agent: result.agent ?? data.agent ?? `step-${index + 1}`,
+                    status: resolveSubagentResultStatus({
+                        success: result.success,
+                        state: childState,
+                    }),
+                    summary,
+                    index,
+                    artifactPath: result.artifactPaths?.outputPath,
+                    ...(typeof sessionPath === "string" && fsApi.existsSync(sessionPath) ? { sessionPath } : {}),
+                    ...(result.intercomTarget ? { intercomTarget: result.intercomTarget } : {}),
+                    ...(childNestedChildren ? { children: childNestedChildren } : {}),
+                };
+            }), nestedChildren);
+            const intercomTarget = data.intercomTarget?.trim();
+            if (intercomTarget) {
+                const mode = data.mode === "single" || data.mode === "parallel" || data.mode === "chain"
+                    ? data.mode
+                    : resultChildren.length > 1 ? "chain" : "single";
+                const payload = buildSubagentResultIntercomPayload({
+                    to: intercomTarget,
+                    runId,
+                    mode,
+                    source: "async",
+                    children: normalizedChildren,
+                    asyncId: data.id,
+                    asyncDir: data.asyncDir,
+                });
+                const delivered = await deliverSubagentResultIntercomEvent(pi.events, payload);
+                if (!delivered) {
+                    console.error(`Subagent async grouped result intercom delivery was not acknowledged for '${resultPath}'.`);
+                }
+            }
+            pi.events.emit(SUBAGENT_ASYNC_COMPLETE_EVENT, {
+                ...data,
+                runId,
+                ...(nestedChildren?.length ? { nestedChildren } : {}),
+                ...(Array.isArray(data.results) ? {
+                    results: hasResultChildren
+                        ? normalizedChildren.map((child, index) => ({
+                            ...data.results[index],
+                            agent: child.agent,
+                            status: child.status,
+                            summary: child.summary,
+                            index: child.index,
+                            artifactPath: child.artifactPath,
+                            sessionPath: child.sessionPath,
+                            children: child.children,
+                        }))
+                        : [],
+                } : {}),
+            });
+            fsApi.unlinkSync(resultPath);
+        }
+        catch (error) {
+            if (isNotFoundError(error))
+                return;
+            console.error(`Failed to process subagent result file '${resultPath}':`, error);
+        }
+    };
+    state.resultFileCoalescer = createFileCoalescer((file) => {
+        void handleResult(file);
+    }, 50);
+    const primeExistingResults = () => {
+        try {
+            fsApi.readdirSync(resultsDir)
+                .filter((f) => f.endsWith(".json"))
+                .forEach((file) => state.resultFileCoalescer.schedule(file, 0));
+        }
+        catch (error) {
+            if (isNotFoundError(error))
+                return;
+            console.error(`Failed to scan subagent result directory '${resultsDir}':`, error);
+        }
+    };
+    const startPollingFallback = (reason) => {
+        state.watcher?.close();
+        state.watcher = null;
+        if (state.watcherRestartTimer)
+            return;
+        console.error(`Subagent result watcher for '${resultsDir}' fell back to polling because native fs.watch is unavailable (${getErrorCode(reason) ?? "unknown error"}).`);
+        primeExistingResults();
+        state.watcherRestartTimer = timers.setInterval(primeExistingResults, POLL_INTERVAL_MS);
+        state.watcherRestartTimer.unref?.();
+    };
+    const scheduleRestart = () => {
+        if (state.watcherRestartTimer)
+            return;
+        state.watcherRestartTimer = timers.setTimeout(() => {
+            state.watcherRestartTimer = null;
+            try {
+                fsApi.mkdirSync(resultsDir, { recursive: true });
+                startResultWatcher();
+            }
+            catch (error) {
+                if (shouldFallBackToPolling(error)) {
+                    startPollingFallback(error);
+                    return;
+                }
+                console.error(`Failed to restart subagent result watcher for '${resultsDir}':`, error);
+                scheduleRestart();
+            }
+        }, WATCHER_RESTART_DELAY_MS);
+        state.watcherRestartTimer.unref?.();
+    };
+    const startResultWatcher = () => {
+        if (state.watcher)
+            return;
+        if (state.watcherRestartTimer) {
+            timers.clearTimeout(state.watcherRestartTimer);
+            timers.clearInterval(state.watcherRestartTimer);
+            state.watcherRestartTimer = null;
+        }
+        try {
+            const watchDir = resolveWatchPath(resultsDir, fsApi.realpathSync.native);
+            state.watcher = fsApi.watch(watchDir, (ev, file) => {
+                if (ev !== "rename" || !file)
+                    return;
+                const fileName = file.toString();
+                if (!fileName.endsWith(".json"))
+                    return;
+                state.resultFileCoalescer.schedule(fileName);
+            });
+            state.watcher.on("error", (error) => {
+                if (shouldFallBackToPolling(error)) {
+                    startPollingFallback(error);
+                    return;
+                }
+                console.error(`Subagent result watcher failed for '${resultsDir}':`, error);
+                state.watcher?.close();
+                state.watcher = null;
+                scheduleRestart();
+            });
+            state.watcher.unref?.();
+        }
+        catch (error) {
+            if (shouldFallBackToPolling(error)) {
+                startPollingFallback(error);
+                return;
+            }
+            console.error(`Failed to start subagent result watcher for '${resultsDir}':`, error);
+            state.watcher = null;
+            scheduleRestart();
+        }
+    };
+    const stopResultWatcher = () => {
+        state.watcher?.close();
+        state.watcher = null;
+        if (state.watcherRestartTimer) {
+            timers.clearTimeout(state.watcherRestartTimer);
+            timers.clearInterval(state.watcherRestartTimer);
+        }
+        state.watcherRestartTimer = null;
+        state.resultFileCoalescer.clear();
+    };
+    return { startResultWatcher, primeExistingResults, stopResultWatcher };
+}
+//# sourceMappingURL=result-watcher.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/result-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-watcher.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/result-watcher.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { buildCompletionKey, markSeenWithTtl } from \"./completion-dedupe.ts\";\nimport { createFileCoalescer } from \"../../shared/file-coalescer.ts\";\nimport {\n\tSUBAGENT_ASYNC_COMPLETE_EVENT,\n\ttype IntercomEventBus,\n\ttype NestedRunSummary,\n\ttype SubagentResultIntercomChild,\n\ttype SubagentState,\n} from \"../../shared/types.ts\";\nimport {\n\tattachNestedChildrenToResultChildren,\n\tbuildSubagentResultIntercomPayload,\n\tcompactNestedResultChildren,\n\tdeliverSubagentResultIntercomEvent,\n\tresolveSubagentResultStatus,\n} from \"../../intercom/result-intercom.ts\";\nimport { projectNestedRegistryForRoot, sanitizeSummary } from \"../shared/nested-events.ts\";\nimport { resolveWatchPath } from \"../../shared/utils.ts\";\n\nconst WATCHER_RESTART_DELAY_MS = 3000;\nconst POLL_INTERVAL_MS = 3000;\n\ntype ResultWatcherFs = Pick<typeof fs, \"existsSync\" | \"readFileSync\" | \"unlinkSync\" | \"readdirSync\" | \"mkdirSync\" | \"realpathSync\" | \"watch\">;\n\ntype ResultWatcherTimers = {\n\tsetTimeout: typeof setTimeout;\n\tclearTimeout: typeof clearTimeout;\n\tsetInterval: typeof setInterval;\n\tclearInterval: typeof clearInterval;\n};\n\ntype ResultWatcherDeps = {\n\tfs?: ResultWatcherFs;\n\ttimers?: ResultWatcherTimers;\n};\n\ntype ResultFileChild = {\n\tagent?: string;\n\toutput?: string;\n\terror?: string;\n\tsuccess?: boolean;\n\tstate?: string;\n\tstopped?: boolean;\n\tsessionFile?: string;\n\tartifactPaths?: { outputPath?: string };\n\tintercomTarget?: string;\n\tchildren?: unknown;\n};\n\ntype ResultFileData = {\n\tid?: string;\n\trunId?: string;\n\tagent?: string;\n\tsuccess?: boolean;\n\tstate?: string;\n\tmode?: string;\n\tsummary?: string;\n\tresults?: ResultFileChild[];\n\tnestedChildren?: unknown;\n\tsessionId?: string;\n\tcwd?: string;\n\tsessionFile?: string;\n\tasyncDir?: string;\n\tintercomTarget?: string;\n};\n\nfunction sanitizeNestedResultChildren(value: unknown, resultPath: string, label: string): NestedRunSummary[] | undefined {\n\tif (value === undefined) return undefined;\n\tif (!Array.isArray(value)) {\n\t\tconsole.error(`Ignoring invalid nested children in subagent result file '${resultPath}' at ${label}: expected an array.`);\n\t\treturn undefined;\n\t}\n\tconst children = value.map((child) => sanitizeSummary(child)).filter((child): child is NestedRunSummary => Boolean(child));\n\tif (children.length !== value.length) {\n\t\tconsole.error(`Ignoring ${value.length - children.length} invalid nested child record(s) in subagent result file '${resultPath}' at ${label}.`);\n\t}\n\treturn children.length ? children : undefined;\n}\n\nfunction getErrorCode(error: unknown): string | undefined {\n\treturn typeof error === \"object\" && error !== null && \"code\" in error\n\t\t? (error as NodeJS.ErrnoException).code\n\t\t: undefined;\n}\n\nfunction isNotFoundError(error: unknown): boolean {\n\treturn getErrorCode(error) === \"ENOENT\";\n}\n\nfunction shouldFallBackToPolling(error: unknown): boolean {\n\tconst code = getErrorCode(error);\n\treturn code === \"EMFILE\" || code === \"ENOSPC\";\n}\n\n\nexport function createResultWatcher(\n\tpi: { events: IntercomEventBus },\n\tstate: SubagentState,\n\tresultsDir: string,\n\tcompletionTtlMs: number,\n\tdeps: ResultWatcherDeps = {},\n): {\n\tstartResultWatcher: () => void;\n\tprimeExistingResults: () => void;\n\tstopResultWatcher: () => void;\n} {\n\tconst fsApi = deps.fs ?? fs;\n\tconst timers = deps.timers ?? { setTimeout, clearTimeout, setInterval, clearInterval };\n\n\tconst handleResult = async (file: string) => {\n\t\tconst resultPath = path.join(resultsDir, file);\n\t\tif (!fsApi.existsSync(resultPath)) return;\n\t\ttry {\n\t\t\tconst data = JSON.parse(fsApi.readFileSync(resultPath, \"utf-8\")) as ResultFileData;\n\t\t\tif (typeof data.sessionId !== \"string\" || data.sessionId !== state.currentSessionId) return;\n\n\t\t\tconst runId = data.runId ?? data.id ?? file.replace(/\\.json$/i, \"\");\n\t\t\tconst hasExplicitNestedChildren = data.nestedChildren !== undefined;\n\t\t\tlet nestedChildren = compactNestedResultChildren(sanitizeNestedResultChildren(data.nestedChildren, resultPath, \"nestedChildren\"));\n\t\t\tif (!nestedChildren?.length && !hasExplicitNestedChildren) {\n\t\t\t\ttry {\n\t\t\t\t\tnestedChildren = compactNestedResultChildren(projectNestedRegistryForRoot(runId)?.children);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tconsole.error(`Failed to enrich subagent result file '${resultPath}' with nested registry children; will retry later:`, error);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst now = Date.now();\n\t\t\tconst completionKey = buildCompletionKey(data, `result:${file}`);\n\t\t\tif (markSeenWithTtl(state.completionSeen, completionKey, now, completionTtlMs)) {\n\t\t\t\tfsApi.unlinkSync(resultPath);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst hasResultChildren = Array.isArray(data.results) && data.results.length > 0;\n\t\t\tconst resultChildren = hasResultChildren\n\t\t\t\t? data.results!\n\t\t\t\t: [{\n\t\t\t\t\tagent: data.agent,\n\t\t\t\t\toutput: data.summary,\n\t\t\t\t\tsuccess: data.success,\n\t\t\t\t}];\n\t\t\tconst normalizedChildren = attachNestedChildrenToResultChildren(runId, resultChildren.map((result = {}, index): SubagentResultIntercomChild => {\n\t\t\t\tconst baseOutput = result.output ?? data.summary;\n\t\t\t\tconst hasRealOutput = typeof baseOutput === \"string\" && baseOutput.trim().length > 0;\n\t\t\t\tconst output = hasRealOutput ? baseOutput : \"(no output)\";\n\t\t\t\tconst summary = result.success === false && result.error\n\t\t\t\t\t? `${result.error}${hasRealOutput ? `\\n\\nOutput:\\n${baseOutput}` : \"\"}`\n\t\t\t\t\t: output;\n\t\t\t\tconst sessionPath = result.sessionFile ?? (resultChildren.length === 1 ? data.sessionFile : undefined);\n\t\t\t\tconst childNestedChildren = sanitizeNestedResultChildren(result.children, resultPath, `results[${index}].children`);\n\t\t\t\tconst childState = result.state === \"paused\" || result.state === \"stopped\"\n\t\t\t\t\t? result.state\n\t\t\t\t\t: result.stopped === true\n\t\t\t\t\t\t? \"stopped\"\n\t\t\t\t\t\t: data.state === \"paused\" || (!hasResultChildren && (data.state === \"stopped\" || typeof result.success !== \"boolean\"))\n\t\t\t\t\t\t\t? data.state\n\t\t\t\t\t\t\t: undefined;\n\t\t\t\treturn {\n\t\t\t\t\tagent: result.agent ?? data.agent ?? `step-${index + 1}`,\n\t\t\t\t\tstatus: resolveSubagentResultStatus({\n\t\t\t\t\t\tsuccess: result.success,\n\t\t\t\t\t\tstate: childState,\n\t\t\t\t\t}),\n\t\t\t\t\tsummary,\n\t\t\t\t\tindex,\n\t\t\t\t\tartifactPath: result.artifactPaths?.outputPath,\n\t\t\t\t\t...(typeof sessionPath === \"string\" && fsApi.existsSync(sessionPath) ? { sessionPath } : {}),\n\t\t\t\t\t...(result.intercomTarget ? { intercomTarget: result.intercomTarget } : {}),\n\t\t\t\t\t...(childNestedChildren ? { children: childNestedChildren } : {}),\n\t\t\t\t};\n\t\t\t}), nestedChildren);\n\n\t\t\tconst intercomTarget = data.intercomTarget?.trim();\n\t\t\tif (intercomTarget) {\n\t\t\t\tconst mode = data.mode === \"single\" || data.mode === \"parallel\" || data.mode === \"chain\"\n\t\t\t\t\t? data.mode\n\t\t\t\t\t: resultChildren.length > 1 ? \"chain\" : \"single\";\n\t\t\t\tconst payload = buildSubagentResultIntercomPayload({\n\t\t\t\t\tto: intercomTarget,\n\t\t\t\t\trunId,\n\t\t\t\t\tmode,\n\t\t\t\t\tsource: \"async\",\n\t\t\t\t\tchildren: normalizedChildren,\n\t\t\t\t\tasyncId: data.id,\n\t\t\t\t\tasyncDir: data.asyncDir,\n\t\t\t\t});\n\t\t\t\tconst delivered = await deliverSubagentResultIntercomEvent(pi.events, payload);\n\t\t\t\tif (!delivered) {\n\t\t\t\t\tconsole.error(`Subagent async grouped result intercom delivery was not acknowledged for '${resultPath}'.`);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tpi.events.emit(SUBAGENT_ASYNC_COMPLETE_EVENT, {\n\t\t\t\t...data,\n\t\t\t\trunId,\n\t\t\t\t...(nestedChildren?.length ? { nestedChildren } : {}),\n\t\t\t\t...(Array.isArray(data.results) ? {\n\t\t\t\t\tresults: hasResultChildren\n\t\t\t\t\t\t? normalizedChildren.map((child, index) => ({\n\t\t\t\t\t\t\t...data.results![index],\n\t\t\t\t\t\t\tagent: child.agent,\n\t\t\t\t\t\t\tstatus: child.status,\n\t\t\t\t\t\t\tsummary: child.summary,\n\t\t\t\t\t\t\tindex: child.index,\n\t\t\t\t\t\t\tartifactPath: child.artifactPath,\n\t\t\t\t\t\t\tsessionPath: child.sessionPath,\n\t\t\t\t\t\t\tchildren: child.children,\n\t\t\t\t\t\t}))\n\t\t\t\t\t\t: [],\n\t\t\t\t} : {}),\n\t\t\t});\n\t\t\tfsApi.unlinkSync(resultPath);\n\t\t} catch (error) {\n\t\t\tif (isNotFoundError(error)) return;\n\t\t\tconsole.error(`Failed to process subagent result file '${resultPath}':`, error);\n\t\t}\n\t};\n\n\tstate.resultFileCoalescer = createFileCoalescer((file) => {\n\t\tvoid handleResult(file);\n\t}, 50);\n\n\tconst primeExistingResults = () => {\n\t\ttry {\n\t\t\tfsApi.readdirSync(resultsDir)\n\t\t\t\t.filter((f) => f.endsWith(\".json\"))\n\t\t\t\t.forEach((file) => state.resultFileCoalescer.schedule(file, 0));\n\t\t} catch (error) {\n\t\t\tif (isNotFoundError(error)) return;\n\t\t\tconsole.error(`Failed to scan subagent result directory '${resultsDir}':`, error);\n\t\t}\n\t};\n\n\tconst startPollingFallback = (reason: unknown) => {\n\t\tstate.watcher?.close();\n\t\tstate.watcher = null;\n\t\tif (state.watcherRestartTimer) return;\n\n\t\tconsole.error(\n\t\t\t`Subagent result watcher for '${resultsDir}' fell back to polling because native fs.watch is unavailable (${getErrorCode(reason) ?? \"unknown error\"}).`,\n\t\t);\n\t\tprimeExistingResults();\n\t\tstate.watcherRestartTimer = timers.setInterval(primeExistingResults, POLL_INTERVAL_MS);\n\t\tstate.watcherRestartTimer.unref?.();\n\t};\n\n\tconst scheduleRestart = () => {\n\t\tif (state.watcherRestartTimer) return;\n\t\tstate.watcherRestartTimer = timers.setTimeout(() => {\n\t\t\tstate.watcherRestartTimer = null;\n\t\t\ttry {\n\t\t\t\tfsApi.mkdirSync(resultsDir, { recursive: true });\n\t\t\t\tstartResultWatcher();\n\t\t\t} catch (error) {\n\t\t\t\tif (shouldFallBackToPolling(error)) {\n\t\t\t\t\tstartPollingFallback(error);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconsole.error(`Failed to restart subagent result watcher for '${resultsDir}':`, error);\n\t\t\t\tscheduleRestart();\n\t\t\t}\n\t\t}, WATCHER_RESTART_DELAY_MS);\n\t\tstate.watcherRestartTimer.unref?.();\n\t};\n\n\tconst startResultWatcher = () => {\n\t\tif (state.watcher) return;\n\t\tif (state.watcherRestartTimer) {\n\t\t\ttimers.clearTimeout(state.watcherRestartTimer);\n\t\t\ttimers.clearInterval(state.watcherRestartTimer);\n\t\t\tstate.watcherRestartTimer = null;\n\t\t}\n\t\ttry {\n\t\t\tconst watchDir = resolveWatchPath(resultsDir, fsApi.realpathSync.native);\n\t\t\tstate.watcher = fsApi.watch(watchDir, (ev, file) => {\n\t\t\t\tif (ev !== \"rename\" || !file) return;\n\t\t\t\tconst fileName = file.toString();\n\t\t\t\tif (!fileName.endsWith(\".json\")) return;\n\t\t\t\tstate.resultFileCoalescer.schedule(fileName);\n\t\t\t});\n\t\t\tstate.watcher.on(\"error\", (error) => {\n\t\t\t\tif (shouldFallBackToPolling(error)) {\n\t\t\t\t\tstartPollingFallback(error);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconsole.error(`Subagent result watcher failed for '${resultsDir}':`, error);\n\t\t\t\tstate.watcher?.close();\n\t\t\t\tstate.watcher = null;\n\t\t\t\tscheduleRestart();\n\t\t\t});\n\t\t\tstate.watcher.unref?.();\n\t\t} catch (error) {\n\t\t\tif (shouldFallBackToPolling(error)) {\n\t\t\t\tstartPollingFallback(error);\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconsole.error(`Failed to start subagent result watcher for '${resultsDir}':`, error);\n\t\t\tstate.watcher = null;\n\t\t\tscheduleRestart();\n\t\t}\n\t};\n\n\tconst stopResultWatcher = () => {\n\t\tstate.watcher?.close();\n\t\tstate.watcher = null;\n\t\tif (state.watcherRestartTimer) {\n\t\t\ttimers.clearTimeout(state.watcherRestartTimer);\n\t\t\ttimers.clearInterval(state.watcherRestartTimer);\n\t\t}\n\t\tstate.watcherRestartTimer = null;\n\t\tstate.resultFileCoalescer.clear();\n\t};\n\n\treturn { startResultWatcher, primeExistingResults, stopResultWatcher };\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/background/run-id-resolver.d.ts

@@ -0,0 +1,23 @@
+import { type SubagentState } from "../../shared/types.ts";
+import { type AsyncRunLocation } from "./async-resume.ts";
+import { type NestedRunMatch, type NestedRunResolutionScope } from "../shared/nested-events.ts";
+export type ResolvedSubagentRunId = {
+    kind: "foreground";
+    id: string;
+} | {
+    kind: "async";
+    id: string;
+    location: AsyncRunLocation;
+} | {
+    kind: "nested";
+    id: string;
+    match: NestedRunMatch;
+};
+export interface ResolveSubagentRunIdDeps {
+    state?: SubagentState;
+    asyncDirRoot?: string;
+    resultsDir?: string;
+    nested?: NestedRunResolutionScope;
+}
+export declare function resolveSubagentRunId(id: string, deps?: ResolveSubagentRunIdDeps): ResolvedSubagentRunId | undefined;
+//# sourceMappingURL=run-id-resolver.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/run-id-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-id-resolver.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/run-id-resolver.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAkE,KAAK,cAAc,EAAE,KAAK,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEhK,MAAM,MAAM,qBAAqB,GAC9B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACxC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,wBAAwB,CAAC;CAClC;AAkDD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,wBAA6B,GAAG,qBAAqB,GAAG,SAAS,CA6BvH","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { ASYNC_DIR, RESULTS_DIR, type SubagentState } from \"../../shared/types.ts\";\nimport { findAsyncRunPrefixMatches, type AsyncRunLocation } from \"./async-resume.ts\";\nimport { assertSafeNestedId, findNestedRunMatchesById, type NestedRoute, type NestedRunMatch, type NestedRunResolutionScope } from \"../shared/nested-events.ts\";\n\nexport type ResolvedSubagentRunId =\n\t| { kind: \"foreground\"; id: string }\n\t| { kind: \"async\"; id: string; location: AsyncRunLocation }\n\t| { kind: \"nested\"; id: string; match: NestedRunMatch };\n\nexport interface ResolveSubagentRunIdDeps {\n\tstate?: SubagentState;\n\tasyncDirRoot?: string;\n\tresultsDir?: string;\n\tnested?: NestedRunResolutionScope;\n}\n\nfunction exactAsyncLocation(id: string, asyncDirRoot: string, resultsDir: string): AsyncRunLocation | undefined {\n\tconst asyncDir = path.join(asyncDirRoot, id);\n\tconst resultPath = path.join(resultsDir, `${id}.json`);\n\tif (!fs.existsSync(asyncDir) && !fs.existsSync(resultPath)) return undefined;\n\treturn {\n\t\tasyncDir: fs.existsSync(asyncDir) ? asyncDir : null,\n\t\tresultPath: fs.existsSync(resultPath) ? resultPath : null,\n\t\tresolvedId: id,\n\t};\n}\n\nfunction foregroundIds(state: SubagentState | undefined): string[] {\n\tif (!state) return [];\n\tconst remembered = state.currentSessionId\n\t\t? [...(state.foregroundRuns?.values() ?? [])]\n\t\t\t.filter((run) => run.sessionId === state.currentSessionId)\n\t\t\t.map((run) => run.runId)\n\t\t: [];\n\treturn [...new Set([...state.foregroundControls.keys(), ...remembered])];\n}\n\nfunction hasExactForegroundId(state: SubagentState | undefined, id: string): boolean {\n\tif (!state) return false;\n\tif (state.foregroundControls.has(id)) return true;\n\tconst remembered = state.foregroundRuns?.get(id);\n\treturn Boolean(remembered && state.currentSessionId && remembered.sessionId === state.currentSessionId);\n}\n\nfunction nestedScopeFromState(state: SubagentState | undefined): NestedRunResolutionScope | undefined {\n\tif (!state) return undefined;\n\tconst routes: NestedRoute[] = [];\n\tconst seen = new Set<string>();\n\tconst add = (route: NestedRoute | undefined) => {\n\t\tif (!route) return;\n\t\tconst key = `${route.rootRunId}:${route.eventSink}:${route.controlInbox}`;\n\t\tif (seen.has(key)) return;\n\t\tseen.add(key);\n\t\troutes.push(route);\n\t};\n\tfor (const control of state.foregroundControls.values()) add(control.nestedRoute as NestedRoute | undefined);\n\tfor (const job of state.asyncJobs.values()) add(job.nestedRoute as NestedRoute | undefined);\n\treturn { routes };\n}\n\nfunction asyncPrefixMatches(prefix: string, asyncDirRoot: string, resultsDir: string): Array<{ id: string; location: AsyncRunLocation }> {\n\treturn findAsyncRunPrefixMatches(prefix, asyncDirRoot, resultsDir);\n}\n\nexport function resolveSubagentRunId(id: string, deps: ResolveSubagentRunIdDeps = {}): ResolvedSubagentRunId | undefined {\n\tassertSafeNestedId(\"id\", id);\n\tconst asyncDirRoot = deps.asyncDirRoot ?? ASYNC_DIR;\n\tconst resultsDir = deps.resultsDir ?? RESULTS_DIR;\n\n\tconst nestedScope = deps.nested ?? nestedScopeFromState(deps.state);\n\tif (hasExactForegroundId(deps.state, id)) return { kind: \"foreground\", id };\n\tconst exactAsync = exactAsyncLocation(id, asyncDirRoot, resultsDir);\n\tif (exactAsync) return { kind: \"async\", id, location: exactAsync };\n\tconst exactNested = findNestedRunMatchesById(id, nestedScope ? { scope: nestedScope } : {});\n\tif (exactNested.length > 1) throw new Error(`Nested run id '${id}' is ambiguous across authorized registries. Provide the full id after stale registries are cleaned up.`);\n\tif (exactNested[0]) return { kind: \"nested\", id, match: exactNested[0] };\n\n\tconst matches: ResolvedSubagentRunId[] = [];\n\tfor (const foregroundId of foregroundIds(deps.state).filter((candidate) => candidate.startsWith(id))) {\n\t\tmatches.push({ kind: \"foreground\", id: foregroundId });\n\t}\n\tfor (const match of asyncPrefixMatches(id, asyncDirRoot, resultsDir)) {\n\t\tmatches.push({ kind: \"async\", id: match.id, location: match.location });\n\t}\n\tfor (const match of findNestedRunMatchesById(id, nestedScope ? { prefix: true, scope: nestedScope } : { prefix: true })) {\n\t\tmatches.push({ kind: \"nested\", id: match.run.id, match });\n\t}\n\tconst unique = new Map(matches.map((match) => [`${match.kind}:${match.id}`, match]));\n\tconst values = [...unique.values()];\n\tif (values.length > 1) {\n\t\tthrow new Error(`Ambiguous subagent run id prefix '${id}' matched: ${values.map((match) => `${match.kind}:${match.id}`).join(\", \")}. Provide a longer id.`);\n\t}\n\treturn values[0];\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/background/run-id-resolver.js

@@ -0,0 +1,91 @@
+// @ts-nocheck
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { ASYNC_DIR, RESULTS_DIR } from "../../shared/types.js";
+import { findAsyncRunPrefixMatches } from "./async-resume.js";
+import { assertSafeNestedId, findNestedRunMatchesById } from "../shared/nested-events.js";
+function exactAsyncLocation(id, asyncDirRoot, resultsDir) {
+    const asyncDir = path.join(asyncDirRoot, id);
+    const resultPath = path.join(resultsDir, `${id}.json`);
+    if (!fs.existsSync(asyncDir) && !fs.existsSync(resultPath))
+        return undefined;
+    return {
+        asyncDir: fs.existsSync(asyncDir) ? asyncDir : null,
+        resultPath: fs.existsSync(resultPath) ? resultPath : null,
+        resolvedId: id,
+    };
+}
+function foregroundIds(state) {
+    if (!state)
+        return [];
+    const remembered = state.currentSessionId
+        ? [...(state.foregroundRuns?.values() ?? [])]
+            .filter((run) => run.sessionId === state.currentSessionId)
+            .map((run) => run.runId)
+        : [];
+    return [...new Set([...state.foregroundControls.keys(), ...remembered])];
+}
+function hasExactForegroundId(state, id) {
+    if (!state)
+        return false;
+    if (state.foregroundControls.has(id))
+        return true;
+    const remembered = state.foregroundRuns?.get(id);
+    return Boolean(remembered && state.currentSessionId && remembered.sessionId === state.currentSessionId);
+}
+function nestedScopeFromState(state) {
+    if (!state)
+        return undefined;
+    const routes = [];
+    const seen = new Set();
+    const add = (route) => {
+        if (!route)
+            return;
+        const key = `${route.rootRunId}:${route.eventSink}:${route.controlInbox}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        routes.push(route);
+    };
+    for (const control of state.foregroundControls.values())
+        add(control.nestedRoute);
+    for (const job of state.asyncJobs.values())
+        add(job.nestedRoute);
+    return { routes };
+}
+function asyncPrefixMatches(prefix, asyncDirRoot, resultsDir) {
+    return findAsyncRunPrefixMatches(prefix, asyncDirRoot, resultsDir);
+}
+export function resolveSubagentRunId(id, deps = {}) {
+    assertSafeNestedId("id", id);
+    const asyncDirRoot = deps.asyncDirRoot ?? ASYNC_DIR;
+    const resultsDir = deps.resultsDir ?? RESULTS_DIR;
+    const nestedScope = deps.nested ?? nestedScopeFromState(deps.state);
+    if (hasExactForegroundId(deps.state, id))
+        return { kind: "foreground", id };
+    const exactAsync = exactAsyncLocation(id, asyncDirRoot, resultsDir);
+    if (exactAsync)
+        return { kind: "async", id, location: exactAsync };
+    const exactNested = findNestedRunMatchesById(id, nestedScope ? { scope: nestedScope } : {});
+    if (exactNested.length > 1)
+        throw new Error(`Nested run id '${id}' is ambiguous across authorized registries. Provide the full id after stale registries are cleaned up.`);
+    if (exactNested[0])
+        return { kind: "nested", id, match: exactNested[0] };
+    const matches = [];
+    for (const foregroundId of foregroundIds(deps.state).filter((candidate) => candidate.startsWith(id))) {
+        matches.push({ kind: "foreground", id: foregroundId });
+    }
+    for (const match of asyncPrefixMatches(id, asyncDirRoot, resultsDir)) {
+        matches.push({ kind: "async", id: match.id, location: match.location });
+    }
+    for (const match of findNestedRunMatchesById(id, nestedScope ? { prefix: true, scope: nestedScope } : { prefix: true })) {
+        matches.push({ kind: "nested", id: match.run.id, match });
+    }
+    const unique = new Map(matches.map((match) => [`${match.kind}:${match.id}`, match]));
+    const values = [...unique.values()];
+    if (values.length > 1) {
+        throw new Error(`Ambiguous subagent run id prefix '${id}' matched: ${values.map((match) => `${match.kind}:${match.id}`).join(", ")}. Provide a longer id.`);
+    }
+    return values[0];
+}
+//# sourceMappingURL=run-id-resolver.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/run-id-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-id-resolver.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/run-id-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { ASYNC_DIR, RESULTS_DIR, type SubagentState } from \"../../shared/types.ts\";\nimport { findAsyncRunPrefixMatches, type AsyncRunLocation } from \"./async-resume.ts\";\nimport { assertSafeNestedId, findNestedRunMatchesById, type NestedRoute, type NestedRunMatch, type NestedRunResolutionScope } from \"../shared/nested-events.ts\";\n\nexport type ResolvedSubagentRunId =\n\t| { kind: \"foreground\"; id: string }\n\t| { kind: \"async\"; id: string; location: AsyncRunLocation }\n\t| { kind: \"nested\"; id: string; match: NestedRunMatch };\n\nexport interface ResolveSubagentRunIdDeps {\n\tstate?: SubagentState;\n\tasyncDirRoot?: string;\n\tresultsDir?: string;\n\tnested?: NestedRunResolutionScope;\n}\n\nfunction exactAsyncLocation(id: string, asyncDirRoot: string, resultsDir: string): AsyncRunLocation | undefined {\n\tconst asyncDir = path.join(asyncDirRoot, id);\n\tconst resultPath = path.join(resultsDir, `${id}.json`);\n\tif (!fs.existsSync(asyncDir) && !fs.existsSync(resultPath)) return undefined;\n\treturn {\n\t\tasyncDir: fs.existsSync(asyncDir) ? asyncDir : null,\n\t\tresultPath: fs.existsSync(resultPath) ? resultPath : null,\n\t\tresolvedId: id,\n\t};\n}\n\nfunction foregroundIds(state: SubagentState | undefined): string[] {\n\tif (!state) return [];\n\tconst remembered = state.currentSessionId\n\t\t? [...(state.foregroundRuns?.values() ?? [])]\n\t\t\t.filter((run) => run.sessionId === state.currentSessionId)\n\t\t\t.map((run) => run.runId)\n\t\t: [];\n\treturn [...new Set([...state.foregroundControls.keys(), ...remembered])];\n}\n\nfunction hasExactForegroundId(state: SubagentState | undefined, id: string): boolean {\n\tif (!state) return false;\n\tif (state.foregroundControls.has(id)) return true;\n\tconst remembered = state.foregroundRuns?.get(id);\n\treturn Boolean(remembered && state.currentSessionId && remembered.sessionId === state.currentSessionId);\n}\n\nfunction nestedScopeFromState(state: SubagentState | undefined): NestedRunResolutionScope | undefined {\n\tif (!state) return undefined;\n\tconst routes: NestedRoute[] = [];\n\tconst seen = new Set<string>();\n\tconst add = (route: NestedRoute | undefined) => {\n\t\tif (!route) return;\n\t\tconst key = `${route.rootRunId}:${route.eventSink}:${route.controlInbox}`;\n\t\tif (seen.has(key)) return;\n\t\tseen.add(key);\n\t\troutes.push(route);\n\t};\n\tfor (const control of state.foregroundControls.values()) add(control.nestedRoute as NestedRoute | undefined);\n\tfor (const job of state.asyncJobs.values()) add(job.nestedRoute as NestedRoute | undefined);\n\treturn { routes };\n}\n\nfunction asyncPrefixMatches(prefix: string, asyncDirRoot: string, resultsDir: string): Array<{ id: string; location: AsyncRunLocation }> {\n\treturn findAsyncRunPrefixMatches(prefix, asyncDirRoot, resultsDir);\n}\n\nexport function resolveSubagentRunId(id: string, deps: ResolveSubagentRunIdDeps = {}): ResolvedSubagentRunId | undefined {\n\tassertSafeNestedId(\"id\", id);\n\tconst asyncDirRoot = deps.asyncDirRoot ?? ASYNC_DIR;\n\tconst resultsDir = deps.resultsDir ?? RESULTS_DIR;\n\n\tconst nestedScope = deps.nested ?? nestedScopeFromState(deps.state);\n\tif (hasExactForegroundId(deps.state, id)) return { kind: \"foreground\", id };\n\tconst exactAsync = exactAsyncLocation(id, asyncDirRoot, resultsDir);\n\tif (exactAsync) return { kind: \"async\", id, location: exactAsync };\n\tconst exactNested = findNestedRunMatchesById(id, nestedScope ? { scope: nestedScope } : {});\n\tif (exactNested.length > 1) throw new Error(`Nested run id '${id}' is ambiguous across authorized registries. Provide the full id after stale registries are cleaned up.`);\n\tif (exactNested[0]) return { kind: \"nested\", id, match: exactNested[0] };\n\n\tconst matches: ResolvedSubagentRunId[] = [];\n\tfor (const foregroundId of foregroundIds(deps.state).filter((candidate) => candidate.startsWith(id))) {\n\t\tmatches.push({ kind: \"foreground\", id: foregroundId });\n\t}\n\tfor (const match of asyncPrefixMatches(id, asyncDirRoot, resultsDir)) {\n\t\tmatches.push({ kind: \"async\", id: match.id, location: match.location });\n\t}\n\tfor (const match of findNestedRunMatchesById(id, nestedScope ? { prefix: true, scope: nestedScope } : { prefix: true })) {\n\t\tmatches.push({ kind: \"nested\", id: match.run.id, match });\n\t}\n\tconst unique = new Map(matches.map((match) => [`${match.kind}:${match.id}`, match]));\n\tconst values = [...unique.values()];\n\tif (values.length > 1) {\n\t\tthrow new Error(`Ambiguous subagent run id prefix '${id}' matched: ${values.map((match) => `${match.kind}:${match.id}`).join(\", \")}. Provide a longer id.`);\n\t}\n\treturn values[0];\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/background/run-status.d.ts

@@ -0,0 +1,24 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import { type Details, type SubagentState } from "../../shared/types.ts";
+import { type NestedRunResolutionScope } from "../shared/nested-events.ts";
+interface RunStatusParams {
+    action?: "status";
+    id?: string;
+    runId?: string;
+    dir?: string;
+    index?: number;
+    view?: "fleet" | "transcript";
+    lines?: number;
+}
+interface RunStatusDeps {
+    asyncDirRoot?: string;
+    resultsDir?: string;
+    kill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;
+    now?: () => number;
+    state?: SubagentState;
+    nested?: NestedRunResolutionScope;
+    sessionRoots?: string[];
+}
+export declare function inspectSubagentStatus(params: RunStatusParams, deps?: RunStatusDeps): AgentToolResult<Details>;
+export {};
+//# sourceMappingURL=run-status.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/run-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-status.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/run-status.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAMrE,OAAO,EAA4C,KAAK,OAAO,EAAwE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAMzL,OAAO,EAAqF,KAAK,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE9J,UAAU,eAAe;IACxB,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,aAAa;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,OAAO,CAAC;IAC7D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAkKD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,GAAE,aAAkB,GAAG,eAAe,CAAC,OAAO,CAAC,CAqPjH","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { AgentToolResult } from \"@earendil-works/pi-agent-core\";\nimport { formatAsyncRunList, formatAsyncRunOutputPath, formatAsyncRunProgressLabel, listAsyncRuns } from \"./async-status.ts\";\nimport { formatAsyncResultTranscript, formatAsyncRunTranscript, formatNestedRunTranscript, inspectSubagentFleet } from \"./fleet-view.ts\";\nimport { formatNestedRunStatusLines } from \"../shared/nested-render.ts\";\nimport { formatModelThinking } from \"../../shared/formatters.ts\";\nimport { formatActivityLabel } from \"../../shared/status-format.ts\";\nimport { ASYNC_DIR, RESULTS_DIR, type AsyncStatus, type Details, type ForegroundResumeRun, type NestedRunSummary, type SteeringStatus, type SubagentState } from \"../../shared/types.ts\";\nimport { resolveSubagentIntercomTarget } from \"../../intercom/intercom-bridge.ts\";\nimport { resolveAsyncRunLocation } from \"./async-resume.ts\";\nimport { resolveSubagentRunId } from \"./run-id-resolver.ts\";\nimport { flatToLogicalStepIndex, normalizeParallelGroups } from \"./parallel-groups.ts\";\nimport { reconcileAsyncRun, reconcileNestedAsyncDescendants } from \"./stale-run-reconciler.ts\";\nimport { attachRootChildrenToSteps, findNestedRouteForRootId, projectNestedRegistryForRoot, type NestedRunResolutionScope } from \"../shared/nested-events.ts\";\n\ninterface RunStatusParams {\n\taction?: \"status\";\n\tid?: string;\n\trunId?: string;\n\tdir?: string;\n\tindex?: number;\n\tview?: \"fleet\" | \"transcript\";\n\tlines?: number;\n}\n\ninterface RunStatusDeps {\n\tasyncDirRoot?: string;\n\tresultsDir?: string;\n\tkill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;\n\tnow?: () => number;\n\tstate?: SubagentState;\n\tnested?: NestedRunResolutionScope;\n\tsessionRoots?: string[];\n}\n\nfunction hasExistingSessionFile(value: unknown): value is string {\n\treturn typeof value === \"string\" && fs.existsSync(value);\n}\n\nfunction formatResumeGuidance(runId: string | undefined, children: Array<{ agent?: unknown; sessionFile?: unknown }>, fallbackSessionFile?: unknown, options: { stopped?: boolean } = {}): string {\n\tif (options.stopped) return \"Resume: unavailable; stopped runs are not resumable. Start a new run instead.\";\n\tconst knownChildren = children\n\t\t.map((child, index) => ({ child, index }))\n\t\t.filter(({ child }) => typeof child.agent === \"string\");\n\tif (!runId || knownChildren.length === 0) return \"Resume: unavailable; no child session file was persisted.\";\n\tconst singleSessionFile = knownChildren[0]?.child.sessionFile ?? fallbackSessionFile;\n\tif (children.length === 1 && knownChildren.length === 1 && hasExistingSessionFile(singleSessionFile)) {\n\t\treturn `Revive: subagent({ action: \"resume\", id: \"${runId}\", message: \"...\" })`;\n\t}\n\tconst childWithSession = knownChildren.find(({ child }) => hasExistingSessionFile(child.sessionFile));\n\tif (childWithSession) {\n\t\treturn `Revive child: subagent({ action: \"resume\", id: \"${runId}\", index: ${childWithSession.index}, message: \"...\" })`;\n\t}\n\treturn \"Resume: unavailable; no child session file was persisted.\";\n}\n\nfunction stepLineLabel(status: AsyncStatus, index: number): string {\n\tconst steps = status.steps ?? [];\n\tif (status.mode === \"parallel\") return `Agent ${index + 1}/${steps.length || 1}`;\n\tif (status.mode === \"chain\") {\n\t\tconst chainStepCount = status.chainStepCount ?? (steps.length || 1);\n\t\tconst groups = normalizeParallelGroups(status.parallelGroups, steps.length, chainStepCount);\n\t\tconst group = groups.find((candidate) => index >= candidate.start && index < candidate.start + candidate.count);\n\t\tif (group) return `Step ${group.stepIndex + 1}/${chainStepCount} Agent ${index - group.start + 1}/${group.count}`;\n\t\treturn `Step ${flatToLogicalStepIndex(index, chainStepCount, groups) + 1}/${chainStepCount}`;\n\t}\n\treturn `Step ${index + 1}`;\n}\n\nfunction nestedRunDisplayName(run: NestedRunSummary): string {\n\tif (run.agent) return run.agent;\n\tif (run.agents?.length) return run.agents.join(\", \");\n\treturn run.id;\n}\n\nfunction formatSteeringSummary(input: { steering?: SteeringStatus }): string | undefined {\n\tconst steering = input.steering;\n\tif (!steering || steering.requested === 0) return undefined;\n\tconst lateAcknowledgments = steering.recent.reduce((count, request) => count + request.targets.filter((target) => target.lateDeliveredAt !== undefined).length, 0);\n\treturn `${steering.requested} requested, ${steering.scheduled} scheduled, ${steering.pending} pending, ${steering.delivered} delivered, ${steering.failed} failed, ${steering.recovered} recovered${lateAcknowledgments ? `, ${lateAcknowledgments} late acknowledged` : \"\"}`;\n}\n\nfunction rememberedForegroundChildOutput(child: ForegroundResumeRun[\"children\"][number]): string {\n\tconst outputPath = child.artifactPaths?.outputPath ?? child.savedOutputPath;\n\tif (outputPath && fs.existsSync(outputPath)) {\n\t\ttry {\n\t\t\tconst artifactOutput = fs.readFileSync(outputPath, \"utf-8\").trim();\n\t\t\tif (artifactOutput) return artifactOutput;\n\t\t} catch {\n\t\t\t// Fall back to the remembered snapshot below.\n\t\t}\n\t}\n\treturn child.finalOutput ?? \"\";\n}\n\nfunction formatRememberedForegroundStatus(run: ForegroundResumeRun): string {\n\tconst lines = [\n\t\t`Run: ${run.runId}`,\n\t\t\"State: remembered foreground\",\n\t\t`Mode: ${run.mode}`,\n\t\t`Updated: ${new Date(run.updatedAt).toISOString()}`,\n\t\t`Cwd: ${run.cwd}`,\n\t];\n\tfor (const child of run.children) {\n\t\tconst output = rememberedForegroundChildOutput(child).trim().split(/\\r?\\n/).find((line) => line.trim());\n\t\tconst parts = [\n\t\t\t`${child.index + 1}. ${child.agent} ${child.status}`,\n\t\t\tchild.exitCode !== undefined ? `exit ${child.exitCode}` : undefined,\n\t\t\tchild.detachedReason ? `detached: ${child.detachedReason}` : undefined,\n\t\t\tchild.acceptance ? `acceptance: ${child.acceptance.status}` : undefined,\n\t\t\tchild.error ? `error: ${child.error}` : undefined,\n\t\t\toutput ? `output: ${output.slice(0, 160)}` : undefined,\n\t\t].filter(Boolean);\n\t\tlines.push(parts.join(\", \"));\n\t\tif (child.sessionFile) lines.push(`  Session: ${child.sessionFile}`);\n\t\tif (child.transcriptPath) lines.push(`  Transcript: ${child.transcriptPath}`);\n\t\tif (child.artifactPaths?.outputPath) lines.push(`  Output: ${child.artifactPaths.outputPath}`);\n\t\tif (child.savedOutputPath && child.savedOutputPath !== child.artifactPaths?.outputPath) lines.push(`  Saved output: ${child.savedOutputPath}`);\n\t\tif (child.outputSaveError) lines.push(`  Output warning: ${child.outputSaveError}`);\n\t\tif (child.transcriptError) lines.push(`  Transcript warning: ${child.transcriptError}`);\n\t}\n\tlines.push(\"\", `Status: subagent({ action: \"status\", id: \"${run.runId}\" })`);\n\tif (run.children.length === 1) lines.push(`Transcript: subagent({ action: \"status\", id: \"${run.runId}\", view: \"transcript\" })`);\n\telse lines.push(`Transcript: subagent({ action: \"status\", id: \"${run.runId}\", index: 0, view: \"transcript\" })`);\n\tconst detached = run.children.some((child) => child.status === \"detached\");\n\tconst resumable = run.children.find((child) => hasExistingSessionFile(child.sessionFile));\n\tif (detached) {\n\t\tlines.push(`Recovery: reply to the supervisor request first, then wait with subagent_wait({ id: \"${run.runId}\" }); do not resume or launch a replacement while any child remains detached.`);\n\t} else if (resumable) {\n\t\tlines.push(run.children.length === 1\n\t\t\t? `Revive: subagent({ action: \"resume\", id: \"${run.runId}\", message: \"...\" })`\n\t\t\t: `Revive child: subagent({ action: \"resume\", id: \"${run.runId}\", index: ${resumable.index}, message: \"...\" })`);\n\t} else {\n\t\tlines.push(\"Resume: unavailable; no child session file was persisted.\");\n\t}\n\treturn lines.join(\"\\n\");\n}\n\nfunction formatRememberedForegroundTranscript(run: ForegroundResumeRun, options: { index?: number; lines?: number }): string {\n\tlet index = options.index;\n\tif (index !== undefined && !Number.isInteger(index)) throw new Error(\"Transcript index must be an integer.\");\n\tif (index === undefined && run.children.length === 1) index = 0;\n\tif (index === undefined) return `Transcript view requires index for foreground run '${run.runId}' with ${run.children.length} children.`;\n\tif (index < 0 || index >= run.children.length) throw new Error(`Transcript index ${index} is out of range for ${run.children.length} foreground children.`);\n\tconst child = run.children[index]!;\n\tconst lineLimit = Math.max(1, Math.min(options.lines ?? 80, 1000));\n\tconst outputLines = rememberedForegroundChildOutput(child).split(/\\r?\\n/).filter((line) => line.trim()).slice(-lineLimit);\n\tconst lines = [\n\t\t`Run: ${run.runId}`,\n\t\t`State: ${child.status}`,\n\t\t`Child: ${index} (${child.agent})`,\n\t\tchild.sessionFile ? `Session: ${child.sessionFile}` : undefined,\n\t\tchild.transcriptPath ? `Transcript: ${child.transcriptPath}` : undefined,\n\t\tchild.artifactPaths?.outputPath ? `Output: ${child.artifactPaths.outputPath}` : undefined,\n\t\tchild.savedOutputPath && child.savedOutputPath !== child.artifactPaths?.outputPath ? `Saved output: ${child.savedOutputPath}` : undefined,\n\t\tchild.outputSaveError ? `Output warning: ${child.outputSaveError}` : undefined,\n\t].filter((line): line is string => Boolean(line));\n\tlines.push(\"Result transcript tail:\");\n\tif (outputLines.length === 0) lines.push(\"  (no recovered final output available yet)\");\n\telse for (const line of outputLines) lines.push(`  ${line}`);\n\treturn lines.join(\"\\n\");\n}\n\nfunction formatNestedExactStatus(rootRunId: string, run: NestedRunSummary): string {\n\tconst lines = [\n\t\t`Nested run: ${run.id}`,\n\t\t`Root: ${rootRunId}`,\n\t\t`Parent: ${run.parentRunId}${run.parentStepIndex !== undefined ? ` step ${run.parentStepIndex + 1}` : \"\"}`,\n\t\t`State: ${run.state}`,\n\t\trun.activityState || run.lastActivityAt ? `Activity: ${formatActivityLabel(run.lastActivityAt, run.activityState)}` : undefined,\n\t\trun.mode ? `Mode: ${run.mode}` : undefined,\n\t\t`Agent: ${nestedRunDisplayName(run)}`,\n\t\trun.currentStep !== undefined ? `Progress: step ${run.currentStep + 1}/${run.chainStepCount ?? run.steps?.length ?? 1}` : undefined,\n\t\trun.turnBudget ? `Turn budget: ${run.turnBudget.turnCount}/${run.turnBudget.maxTurns}+${run.turnBudget.graceTurns} (${run.turnBudget.outcome})` : undefined,\n\t\trun.asyncDir ? `Dir: ${run.asyncDir}` : undefined,\n\t\trun.sessionFile ? `Session: ${run.sessionFile}` : undefined,\n\t\trun.error ? `Error: ${run.error}` : undefined,\n\t].filter((line): line is string => Boolean(line));\n\tif (run.path.length) {\n\t\tlines.push(`Path: ${run.path.map((part) => `${part.runId}${part.stepIndex !== undefined ? `:${part.stepIndex + 1}` : \"\"}${part.agent ? `:${part.agent}` : \"\"}`).join(\" > \")} > ${run.id}`);\n\t}\n\tif (run.steps?.length) {\n\t\tlines.push(\"Steps:\");\n\t\tfor (const [index, step] of run.steps.entries()) {\n\t\t\tconst activity = step.status === \"running\" ? formatActivityLabel(step.lastActivityAt, step.activityState) : undefined;\n\t\t\tconst budget = step.turnBudget ? `, turn budget: ${step.turnBudget.turnCount}/${step.turnBudget.maxTurns}+${step.turnBudget.graceTurns} (${step.turnBudget.outcome})` : \"\";\n\t\t\tlines.push(`  ${index + 1}. ${step.agent} ${step.status}${activity ? `, ${activity}` : \"\"}${budget}${step.error ? `, error: ${step.error}` : \"\"}`);\n\t\t\tlines.push(...formatNestedRunStatusLines(step.children, { indent: \"    \", commandHints: true }));\n\t\t}\n\t}\n\tlines.push(...formatNestedRunStatusLines(run.children, { indent: \"  \", commandHints: true }));\n\tlines.push(\"Commands:\", `  Status: subagent({ action: \"status\", id: \"${run.id}\" })`, `  Interrupt: subagent({ action: \"interrupt\", id: \"${run.id}\" })`, `  Resume: subagent({ action: \"resume\", id: \"${run.id}\", message: \"...\" })`, `  Steer: subagent({ action: \"steer\", id: \"${run.id}\", message: \"...\" })`, `  Root status: subagent({ action: \"status\", id: \"${rootRunId}\" })`);\n\treturn lines.join(\"\\n\");\n}\n\nexport function inspectSubagentStatus(params: RunStatusParams, deps: RunStatusDeps = {}): AgentToolResult<Details> {\n\tconst asyncDirRoot = deps.asyncDirRoot ?? ASYNC_DIR;\n\tconst resultsDir = deps.resultsDir ?? RESULTS_DIR;\n\tconst currentSessionId = deps.state?.currentSessionId ?? undefined;\n\tif (params.view && params.view !== \"fleet\" && params.view !== \"transcript\") {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: `Unknown status view: ${params.view}. Valid: fleet, transcript.` }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t};\n\t}\n\tif (params.view === \"fleet\") {\n\t\treturn inspectSubagentFleet(params, { asyncDirRoot, resultsDir, kill: deps.kill, now: deps.now, state: deps.state, childSafe: Boolean(deps.nested) });\n\t}\n\tif (!params.id && !params.runId && !params.dir) {\n\t\tif (deps.nested) {\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: \"Child-safe subagent status requires an id when no foreground run is active.\" }],\n\t\t\t\tisError: true,\n\t\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t\t};\n\t\t}\n\t\ttry {\n\t\t\tconst runs = listAsyncRuns(asyncDirRoot, { states: [\"queued\", \"running\"], sessionId: currentSessionId, resultsDir, kill: deps.kill, now: deps.now });\n\t\t\tif (params.view === \"transcript\") {\n\t\t\t\tif (runs.length === 1) return inspectSubagentStatus({ ...params, id: runs[0]!.id }, deps);\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: runs.length === 0 ? \"No active async run transcript is available.\" : `Transcript view requires an id when ${runs.length} active async runs exist. Use subagent({ action: \"status\", view: \"fleet\" }) to choose one.` }],\n\t\t\t\t\tisError: true,\n\t\t\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: formatAsyncRunList(runs) }],\n\t\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: message }],\n\t\t\t\tisError: true,\n\t\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t\t};\n\t\t}\n\t}\n\n\tlet location;\n\ttry {\n\t\tconst requestedId = params.id ?? params.runId;\n\t\tif (!params.dir && requestedId) {\n\t\t\tconst resolved = resolveSubagentRunId(requestedId, { asyncDirRoot, resultsDir, state: deps.state, nested: deps.nested });\n\t\t\tif (resolved?.kind === \"foreground\") {\n\t\t\t\tconst run = deps.state?.foregroundRuns?.get(resolved.id);\n\t\t\t\tif (run) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcontent: [{ type: \"text\", text: params.view === \"transcript\" ? formatRememberedForegroundTranscript(run, { index: params.index, lines: params.lines }) : formatRememberedForegroundStatus(run) }],\n\t\t\t\t\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t\t\t\t\t};\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\t\t\treturn { content: [{ type: \"text\", text: message }], isError: true, details: { mode: \"single\", results: [] } };\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (resolved?.kind === \"nested\") {\n\t\t\t\treconcileNestedAsyncDescendants(resolved.match.route, { resultsDir, kill: deps.kill, now: deps.now });\n\t\t\t\tconst refreshed = resolveSubagentRunId(requestedId, { asyncDirRoot, resultsDir, state: deps.state, nested: deps.nested });\n\t\t\t\tconst nested = refreshed?.kind === \"nested\" ? refreshed : resolved;\n\t\t\t\tif (params.view === \"transcript\") {\n\t\t\t\t\ttry {\n\t\t\t\t\t\treturn { content: [{ type: \"text\", text: formatNestedRunTranscript(nested.match.run, { index: params.index, lines: params.lines, sessionRoots: deps.sessionRoots }) }], details: { mode: \"single\", results: [] } };\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\t\t\treturn { content: [{ type: \"text\", text: message }], isError: true, details: { mode: \"single\", results: [] } };\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn { content: [{ type: \"text\", text: formatNestedExactStatus(nested.match.rootRunId, nested.match.run) }], details: { mode: \"single\", results: [] } };\n\t\t\t}\n\t\t\tif (resolved?.kind === \"async\") location = resolved.location;\n\t\t\telse location = { asyncDir: null, resultPath: null, resolvedId: requestedId };\n\t\t} else {\n\t\t\tlocation = resolveAsyncRunLocation(params, asyncDirRoot, resultsDir);\n\t\t}\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: message }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t};\n\t}\n\tconst { asyncDir, resultPath, resolvedId } = location;\n\n\tif (!asyncDir && !resultPath) {\n\t\treturn {\n\t\t\tcontent: [{ type: \"text\", text: \"Async run not found. Provide id or dir.\" }],\n\t\t\tisError: true,\n\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t};\n\t}\n\n\tif (asyncDir) {\n\t\tlet reconciliation;\n\t\ttry {\n\t\t\treconciliation = reconcileAsyncRun(asyncDir, { resultsDir, kill: deps.kill, now: deps.now });\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: message }],\n\t\t\t\tisError: true,\n\t\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t\t};\n\t\t}\n\t\tconst status = reconciliation.status;\n\t\tconst effectiveRunId = status?.runId ?? resolvedId ?? \"unknown\";\n\t\tconst logPath = path.join(asyncDir, `subagent-log-${effectiveRunId}.md`);\n\t\tconst eventsPath = path.join(asyncDir, \"events.jsonl\");\n\t\tif (status) {\n\t\t\tif (params.view === \"transcript\") {\n\t\t\t\tif (currentSessionId && status.sessionId !== currentSessionId) {\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: \"Transcript view is only available for async runs owned by the current session.\" }],\n\t\t\t\t\t\tisError: true,\n\t\t\t\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\treturn { content: [{ type: \"text\", text: formatAsyncRunTranscript(status, asyncDir, { index: params.index, lines: params.lines, sessionRoots: deps.sessionRoots }) }], details: { mode: \"single\", results: [] } };\n\t\t\t\t} catch (error) {\n\t\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\t\treturn { content: [{ type: \"text\", text: message }], isError: true, details: { mode: \"single\", results: [] } };\n\t\t\t\t}\n\t\t\t}\n\t\t\tlet nestedChildren: NestedRunSummary[] = [];\n\t\t\tlet nestedWarning: string | undefined;\n\t\t\ttry {\n\t\t\t\tconst nestedRoute = findNestedRouteForRootId(status.runId);\n\t\t\t\tif (nestedRoute) reconcileNestedAsyncDescendants(nestedRoute, { resultsDir, kill: deps.kill, now: deps.now });\n\t\t\t\tnestedChildren = projectNestedRegistryForRoot(status.runId)?.children ?? [];\n\t\t\t\tattachRootChildrenToSteps(status.runId, status.steps, nestedChildren);\n\t\t\t} catch (error) {\n\t\t\t\tnestedWarning = `Nested status unavailable: ${error instanceof Error ? error.message : String(error)}`;\n\t\t\t}\n\t\t\tconst outputPath = formatAsyncRunOutputPath({ asyncDir, outputFile: status.outputFile });\n\t\t\tconst progressLabel = formatAsyncRunProgressLabel({\n\t\t\t\tmode: status.mode,\n\t\t\t\tstate: status.state,\n\t\t\t\tcurrentStep: status.currentStep,\n\t\t\t\tchainStepCount: status.chainStepCount,\n\t\t\t\tparallelGroups: status.parallelGroups,\n\t\t\t\tsteps: (status.steps ?? []).map((step, index) => ({ index, agent: step.agent, status: step.status })),\n\t\t\t});\n\t\t\tconst started = new Date(status.startedAt).toISOString();\n\t\t\tconst updated = status.lastUpdate ? new Date(status.lastUpdate).toISOString() : \"n/a\";\n\t\t\tconst statusActivityText = status.state === \"running\" ? formatActivityLabel(status.lastActivityAt, status.activityState) : undefined;\n\t\t\tconst steeringText = formatSteeringSummary(status);\n\n\t\t\tconst lines = [\n\t\t\t\t`Run: ${status.runId}`,\n\t\t\t\t`State: ${status.state}`,\n\t\t\t\tstatus.error ? `Error: ${status.error}` : undefined,\n\t\t\t\tstatusActivityText ? `Activity: ${statusActivityText}` : undefined,\n\t\t\t\tsteeringText ? `Steering: ${steeringText}` : undefined,\n\t\t\t\t`Mode: ${status.mode}`,\n\t\t\t\t`Progress: ${progressLabel}`,\n\t\t\t\tstatus.pendingAppends ? `Pending appends: ${status.pendingAppends}` : undefined,\n\t\t\t\t`Started: ${started}`,\n\t\t\t\t`Updated: ${updated}`,\n\t\t\t\tstatus.turnBudget ? `Turn budget: ${status.turnBudget.turnCount}/${status.turnBudget.maxTurns}+${status.turnBudget.graceTurns} (${status.turnBudget.outcome})` : undefined,\n\t\t\t\t`Dir: ${asyncDir}`,\n\t\t\t\toutputPath ? `Output: ${outputPath}` : undefined,\n\t\t\t\treconciliation.message ? `Diagnosis: ${reconciliation.message}` : undefined,\n\t\t\t\treconciliation.resultPath && fs.existsSync(reconciliation.resultPath) ? `Result: ${reconciliation.resultPath}` : undefined,\n\t\t\t].filter((line): line is string => Boolean(line));\n\t\t\tfor (const [index, step] of (status.steps ?? []).entries()) {\n\t\t\t\tconst stepActivityText = step.status === \"running\" ? formatActivityLabel(step.lastActivityAt, step.activityState) : undefined;\n\t\t\t\tconst modelThinking = formatModelThinking(step.model, step.thinking);\n\t\t\t\tconst modelText = modelThinking ? ` (${modelThinking})` : \"\";\n\t\t\t\tconst steeringText = formatSteeringSummary(step);\n\t\t\t\tconst steeringSuffix = steeringText ? `, steering: ${steeringText}` : \"\";\n\t\t\t\tconst errorText = step.error ? `, error: ${step.error}` : \"\";\n\t\t\t\tconst acceptanceText = step.acceptance?.status ? `, acceptance: ${step.acceptance.status}` : \"\";\n\t\t\t\tconst budgetText = step.turnBudget ? `, turn budget: ${step.turnBudget.turnCount}/${step.turnBudget.maxTurns}+${step.turnBudget.graceTurns} (${step.turnBudget.outcome})` : \"\";\n\t\t\t\tconst display = step.label ? `${step.label} (${step.agent})` : step.agent;\n\t\t\t\tconst phase = step.phase ? `[${step.phase}] ` : \"\";\n\t\t\t\tlines.push(`${stepLineLabel(status, index)}: ${phase}${display} ${step.status}${modelText}${stepActivityText ? `, ${stepActivityText}` : \"\"}${steeringSuffix}${acceptanceText}${budgetText}${errorText}`);\n\t\t\t\tlines.push(...formatNestedRunStatusLines(step.children, { indent: \"  \", commandHints: true, maxLines: 20 }));\n\t\t\t\tconst stepOutputPath = path.join(asyncDir, `output-${index}.log`);\n\t\t\t\tif (stepOutputPath !== outputPath && fs.existsSync(stepOutputPath)) lines.push(`  Output: ${stepOutputPath}`);\n\t\t\t\tif (step.status === \"running\") {\n\t\t\t\t\tlines.push(`  Intercom target: ${resolveSubagentIntercomTarget(status.runId, step.agent, index)} (if registered)`);\n\t\t\t\t\tlines.push(`  Steer: subagent({ action: \"steer\", id: \"${status.runId}\", index: ${index}, message: \"...\" })`);\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst attached = new Set((status.steps ?? []).flatMap((step) => step.children?.map((child) => child.id) ?? []));\n\t\t\tconst unattached = nestedChildren.filter((child) => !attached.has(child.id));\n\t\t\tlines.push(...formatNestedRunStatusLines(unattached, { indent: \"\", commandHints: true, maxLines: 20 }));\n\t\t\tif (nestedWarning) lines.push(`Warning: ${nestedWarning}`);\n\t\t\tif (status.sessionFile) lines.push(`Session: ${status.sessionFile}`);\n\t\t\tif (status.state === \"running\") lines.push(`Steer running child: subagent({ action: \"steer\", id: \"${status.runId}\", message: \"...\" })`);\n\t\t\tif (status.state !== \"running\") {\n\t\t\t\tlines.push(formatResumeGuidance(status.runId, status.steps ?? [], status.sessionFile, { stopped: status.state === \"stopped\" || status.stopped === true }));\n\t\t\t}\n\t\t\tif (fs.existsSync(logPath)) lines.push(`Log: ${logPath}`);\n\t\t\tif (fs.existsSync(eventsPath)) lines.push(`Events: ${eventsPath}`);\n\n\t\t\treturn { content: [{ type: \"text\", text: lines.join(\"\\n\") }], details: { mode: \"single\", results: [] } };\n\t\t}\n\t}\n\n\tif (resultPath) {\n\t\ttry {\n\t\t\tconst raw = fs.readFileSync(resultPath, \"utf-8\");\n\t\t\tconst data = JSON.parse(raw) as { id?: string; runId?: string; agent?: string; success?: boolean; summary?: string; output?: string; exitCode?: number; state?: string; sessionFile?: string; results?: Array<{ agent?: string; output?: string; summary?: string; sessionFile?: string; state?: string; success?: boolean; exitCode?: number | null }> };\n\t\t\tif (params.view === \"transcript\") {\n\t\t\t\ttry {\n\t\t\t\t\treturn { content: [{ type: \"text\", text: formatAsyncResultTranscript(data, resultPath, { index: params.index, lines: params.lines }) }], details: { mode: \"single\", results: [] } };\n\t\t\t\t} catch (error) {\n\t\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\t\treturn { content: [{ type: \"text\", text: message }], isError: true, details: { mode: \"single\", results: [] } };\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst status = data.state === \"stopped\" ? \"stopped\" : data.success ? \"complete\" : data.state === \"paused\" || data.exitCode === 0 ? \"paused\" : \"failed\";\n\t\t\tconst runId = data.runId ?? data.id ?? resolvedId;\n\t\t\tconst lines = [`Run: ${runId}`, `State: ${status}`, `Result: ${resultPath}`];\n\t\t\tconst children = Array.isArray(data.results) ? data.results : data.agent ? [{ agent: data.agent, sessionFile: data.sessionFile }] : [];\n\t\t\tlines.push(formatResumeGuidance(runId, children, data.sessionFile, { stopped: status === \"stopped\" }));\n\t\t\tif (data.summary) lines.push(\"\", data.summary);\n\t\t\treturn { content: [{ type: \"text\", text: lines.join(\"\\n\") }], details: { mode: \"single\", results: [] } };\n\t\t} catch (error) {\n\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: `Failed to read async result file: ${message}` }],\n\t\t\t\tisError: true,\n\t\t\t\tdetails: { mode: \"single\", results: [] },\n\t\t\t};\n\t\t}\n\t}\n\n\treturn {\n\t\tcontent: [{ type: \"text\", text: \"Status file not found.\" }],\n\t\tisError: true,\n\t\tdetails: { mode: \"single\", results: [] },\n\t};\n}\n"]}