npm - @ashx-j/lunr - Versions diffs - 0.2.18 → 0.2.20 - Mend

@ashx-j/lunr 0.2.18 → 0.2.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (190) hide show

package/dist/builtin-extensions/pi-subagents/src/runs/background/result-watcher.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"result-watcher.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/result-watcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAI9B,OAAO,EAEN,KAAK,gBAAgB,EAGrB,KAAK,aAAa,EAClB,MAAM,uBAAuB,CAAC;AAc/B,KAAK,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC;AAE9I,KAAK,mBAAmB,GAAG;IAC1B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,aAAa,EAAE,OAAO,aAAa,CAAC;CACpC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACxB,EAAE,CAAC,EAAE,eAAe,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AA6DF,wBAAgB,mBAAmB,CAClC,EAAE,EAAE;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,EAChC,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,IAAI,GAAE,iBAAsB,GAC1B;IACF,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC9B,CAkNA","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"]}
1	+ {"version":3,"file":"result-watcher.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/result-watcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAI9B,OAAO,EAEN,KAAK,gBAAgB,EAGrB,KAAK,aAAa,EAClB,MAAM,uBAAuB,CAAC;AAc/B,KAAK,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC;AAE9I,KAAK,mBAAmB,GAAG;IAC1B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,aAAa,EAAE,OAAO,aAAa,CAAC;CACpC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACxB,EAAE,CAAC,EAAE,eAAe,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AA6DF,wBAAgB,mBAAmB,CAClC,EAAE,EAAE;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,EACrF,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,IAAI,GAAE,iBAAsB,GAC1B;IACF,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,iBAAiB,EAAE,MAAM,IAAI,CAAC;CAC9B,CA4NA","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, report: (message: string) => void): NestedRunSummary[] \| undefined {\n\tif (value === undefined) return undefined;\n\tif (!Array.isArray(value)) {\n\t\treport(`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\treport(`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; appendEntry?: (type: string, data: unknown) => void },\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\tlet generation = 0;\n\tconst inFlight = new Set<string>();\n\tconst attempts = new Map<string, number>();\n\tconst report = (message: string, error?: unknown) => {\n\t\tpi.appendEntry?.(\"subagent_result_delivery\", { message, error: error instanceof Error ? error.message : error });\n\t};\n\n\tconst handleResult = async (file: string) => {\n\t\tif (inFlight.has(file) \|\| (attempts.get(file) ?? 0) >= 3) return;\n\t\tconst currentGeneration = generation;\n\t\tconst sessionId = state.currentSessionId;\n\t\tconst isCurrent = () => generation === currentGeneration && state.currentSessionId === sessionId;\n\t\tconst resultPath = path.join(resultsDir, file);\n\t\tif (!fsApi.existsSync(resultPath)) return;\n\t\tinFlight.add(file);\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\", report));\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\treport(`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\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`, report);\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\tif (!markSeenWithTtl(state.completionSeen, completionKey, now, completionTtlMs)) {\n\t\t\t\tpi.events.emit(SUBAGENT_ASYNC_COMPLETE_EVENT, {\n\t\t\t\t\t...data,\n\t\t\t\t\trunId,\n\t\t\t\t\t...(nestedChildren?.length ? { nestedChildren } : {}),\n\t\t\t\t\t...(Array.isArray(data.results) ? { results: hasResultChildren ? normalizedChildren.map((child, index) => ({\n\t\t\t\t\t\t...data.results![index], agent: child.agent, status: child.status, summary: child.summary,\n\t\t\t\t\t\tindex: child.index, artifactPath: child.artifactPath, sessionPath: child.sessionPath, children: child.children,\n\t\t\t\t\t})) : [] } : {}),\n\t\t\t\t});\n\t\t\t}\n\t\t\tif (!isCurrent()) return;\n\t\t\tconst intercomTarget = data.state === \"stopped\" ? undefined : 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\tpayload.requestId = `async-result:${sessionId}:${completionKey}`;\n\t\t\t\tattempts.set(file, (attempts.get(file) ?? 0) + 1);\n\t\t\t\tconst delivered = await deliverSubagentResultIntercomEvent(pi.events, payload);\n\t\t\t\tif (!isCurrent()) return;\n\t\t\t\tif (!delivered) {\n\t\t\t\t\treport(`Async result delivery pending for '${runId}'; output retained.`, resultPath);\n\t\t\t\t\tif (attempts.get(file)! < 3) state.resultFileCoalescer.schedule(file, 1000);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (isCurrent()) fsApi.unlinkSync(resultPath);\n\t\t} catch (error) {\n\t\t\tif (isNotFoundError(error)) return;\n\t\t\treport(`Failed to process subagent result file '${resultPath}'.`, error);\n\t\t} finally {\n\t\t\tinFlight.delete(file);\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\treport(`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\treport(\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\treport(`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\treport(`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\treport(`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\tgeneration++;\n\t\tattempts.clear();\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/result-watcher.js CHANGED Viewed

@@ -9,16 +9,16 @@ import { projectNestedRegistryForRoot, sanitizeSummary } from "../shared/nested-
 import { resolveWatchPath } from "../../shared/utils.js";
 const WATCHER_RESTART_DELAY_MS = 3000;
 const POLL_INTERVAL_MS = 3000;
-function sanitizeNestedResultChildren(value, resultPath, label) {
+function sanitizeNestedResultChildren(value, resultPath, label, report) {
     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.`);
+        report(`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}.`);
+        report(`Ignoring ${value.length - children.length} invalid nested child record(s) in subagent result file '${resultPath}' at ${label}.`);
     }
     return children.length ? children : undefined;
 }
@@ -37,32 +37,40 @@ function shouldFallBackToPolling(error) {
 export function createResultWatcher(pi, state, resultsDir, completionTtlMs, deps = {}) {
     const fsApi = deps.fs ?? fs;
     const timers = deps.timers ?? { setTimeout, clearTimeout, setInterval, clearInterval };
+    let generation = 0;
+    const inFlight = new Set();
+    const attempts = new Map();
+    const report = (message, error) => {
+        pi.appendEntry?.("subagent_result_delivery", { message, error: error instanceof Error ? error.message : error });
+    };
     const handleResult = async (file) => {
+        if (inFlight.has(file) || (attempts.get(file) ?? 0) >= 3)
+            return;
+        const currentGeneration = generation;
+        const sessionId = state.currentSessionId;
+        const isCurrent = () => generation === currentGeneration && state.currentSessionId === sessionId;
         const resultPath = path.join(resultsDir, file);
         if (!fsApi.existsSync(resultPath))
             return;
+        inFlight.add(file);
         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"));
+            let nestedChildren = compactNestedResultChildren(sanitizeNestedResultChildren(data.nestedChildren, resultPath, "nestedChildren", report));
             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);
+                    report(`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
@@ -79,7 +87,7 @@ export function createResultWatcher(pi, state, resultsDir, completionTtlMs, deps
                     ? `${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 childNestedChildren = sanitizeNestedResultChildren(result.children, resultPath, `results[${index}].children`, report);
                 const childState = result.state === "paused" || result.state === "stopped"
                     ? result.state
                     : result.stopped === true
@@ -101,7 +109,21 @@ export function createResultWatcher(pi, state, resultsDir, completionTtlMs, deps
                     ...(childNestedChildren ? { children: childNestedChildren } : {}),
                 };
             }), nestedChildren);
-            const intercomTarget = data.intercomTarget?.trim();
+            if (!markSeenWithTtl(state.completionSeen, completionKey, now, completionTtlMs)) {
+                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,
+                        })) : [] } : {}),
+                });
+            }
+            if (!isCurrent())
+                return;
+            const intercomTarget = data.state === "stopped" ? undefined : data.intercomTarget?.trim();
             if (intercomTarget) {
                 const mode = data.mode === "single" || data.mode === "parallel" || data.mode === "chain"
                     ? data.mode
@@ -115,36 +137,28 @@ export function createResultWatcher(pi, state, resultsDir, completionTtlMs, deps
                     asyncId: data.id,
                     asyncDir: data.asyncDir,
                 });
+                payload.requestId = `async-result:${sessionId}:${completionKey}`;
+                attempts.set(file, (attempts.get(file) ?? 0) + 1);
                 const delivered = await deliverSubagentResultIntercomEvent(pi.events, payload);
+                if (!isCurrent())
+                    return;
                 if (!delivered) {
-                    console.error(`Subagent async grouped result intercom delivery was not acknowledged for '${resultPath}'.`);
+                    report(`Async result delivery pending for '${runId}'; output retained.`, resultPath);
+                    if (attempts.get(file) < 3)
+                        state.resultFileCoalescer.schedule(file, 1000);
+                    return;
                 }
             }
-            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);
+            if (isCurrent())
+                fsApi.unlinkSync(resultPath);
         }
         catch (error) {
             if (isNotFoundError(error))
                 return;
-            console.error(`Failed to process subagent result file '${resultPath}':`, error);
+            report(`Failed to process subagent result file '${resultPath}'.`, error);
+        }
+        finally {
+            inFlight.delete(file);
         }
     };
     state.resultFileCoalescer = createFileCoalescer((file) => {
@@ -159,7 +173,7 @@ export function createResultWatcher(pi, state, resultsDir, completionTtlMs, deps
         catch (error) {
             if (isNotFoundError(error))
                 return;
-            console.error(`Failed to scan subagent result directory '${resultsDir}':`, error);
+            report(`Failed to scan subagent result directory '${resultsDir}':`, error);
         }
     };
     const startPollingFallback = (reason) => {
@@ -167,7 +181,7 @@ export function createResultWatcher(pi, state, resultsDir, completionTtlMs, deps
         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"}).`);
+        report(`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?.();
@@ -186,7 +200,7 @@ export function createResultWatcher(pi, state, resultsDir, completionTtlMs, deps
                     startPollingFallback(error);
                     return;
                 }
-                console.error(`Failed to restart subagent result watcher for '${resultsDir}':`, error);
+                report(`Failed to restart subagent result watcher for '${resultsDir}':`, error);
                 scheduleRestart();
             }
         }, WATCHER_RESTART_DELAY_MS);
@@ -215,7 +229,7 @@ export function createResultWatcher(pi, state, resultsDir, completionTtlMs, deps
                     startPollingFallback(error);
                     return;
                 }
-                console.error(`Subagent result watcher failed for '${resultsDir}':`, error);
+                report(`Subagent result watcher failed for '${resultsDir}':`, error);
                 state.watcher?.close();
                 state.watcher = null;
                 scheduleRestart();
@@ -227,12 +241,14 @@ export function createResultWatcher(pi, state, resultsDir, completionTtlMs, deps
                 startPollingFallback(error);
                 return;
             }
-            console.error(`Failed to start subagent result watcher for '${resultsDir}':`, error);
+            report(`Failed to start subagent result watcher for '${resultsDir}':`, error);
             state.watcher = null;
             scheduleRestart();
         }
     };
     const stopResultWatcher = () => {
+        generation++;
+        attempts.clear();
         state.watcher?.close();
         state.watcher = null;
         if (state.watcherRestartTimer) {

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

	@@ -1 +1 @@
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"]}
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, report: (message: string) => void): NestedRunSummary[] \| undefined {\n\tif (value === undefined) return undefined;\n\tif (!Array.isArray(value)) {\n\t\treport(`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\treport(`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; appendEntry?: (type: string, data: unknown) => void },\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\tlet generation = 0;\n\tconst inFlight = new Set<string>();\n\tconst attempts = new Map<string, number>();\n\tconst report = (message: string, error?: unknown) => {\n\t\tpi.appendEntry?.(\"subagent_result_delivery\", { message, error: error instanceof Error ? error.message : error });\n\t};\n\n\tconst handleResult = async (file: string) => {\n\t\tif (inFlight.has(file) \|\| (attempts.get(file) ?? 0) >= 3) return;\n\t\tconst currentGeneration = generation;\n\t\tconst sessionId = state.currentSessionId;\n\t\tconst isCurrent = () => generation === currentGeneration && state.currentSessionId === sessionId;\n\t\tconst resultPath = path.join(resultsDir, file);\n\t\tif (!fsApi.existsSync(resultPath)) return;\n\t\tinFlight.add(file);\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\", report));\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\treport(`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\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`, report);\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\tif (!markSeenWithTtl(state.completionSeen, completionKey, now, completionTtlMs)) {\n\t\t\t\tpi.events.emit(SUBAGENT_ASYNC_COMPLETE_EVENT, {\n\t\t\t\t\t...data,\n\t\t\t\t\trunId,\n\t\t\t\t\t...(nestedChildren?.length ? { nestedChildren } : {}),\n\t\t\t\t\t...(Array.isArray(data.results) ? { results: hasResultChildren ? normalizedChildren.map((child, index) => ({\n\t\t\t\t\t\t...data.results![index], agent: child.agent, status: child.status, summary: child.summary,\n\t\t\t\t\t\tindex: child.index, artifactPath: child.artifactPath, sessionPath: child.sessionPath, children: child.children,\n\t\t\t\t\t})) : [] } : {}),\n\t\t\t\t});\n\t\t\t}\n\t\t\tif (!isCurrent()) return;\n\t\t\tconst intercomTarget = data.state === \"stopped\" ? undefined : 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\tpayload.requestId = `async-result:${sessionId}:${completionKey}`;\n\t\t\t\tattempts.set(file, (attempts.get(file) ?? 0) + 1);\n\t\t\t\tconst delivered = await deliverSubagentResultIntercomEvent(pi.events, payload);\n\t\t\t\tif (!isCurrent()) return;\n\t\t\t\tif (!delivered) {\n\t\t\t\t\treport(`Async result delivery pending for '${runId}'; output retained.`, resultPath);\n\t\t\t\t\tif (attempts.get(file)! < 3) state.resultFileCoalescer.schedule(file, 1000);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (isCurrent()) fsApi.unlinkSync(resultPath);\n\t\t} catch (error) {\n\t\t\tif (isNotFoundError(error)) return;\n\t\t\treport(`Failed to process subagent result file '${resultPath}'.`, error);\n\t\t} finally {\n\t\t\tinFlight.delete(file);\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\treport(`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\treport(\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\treport(`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\treport(`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\treport(`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\tgeneration++;\n\t\tattempts.clear();\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/subagent-wait.d.ts CHANGED Viewed

@@ -44,11 +44,13 @@ export { WAIT_TOOL_ENABLED_ENV, resolveWaitToolConfig, type ResolvedWaitToolConf
 export interface SubagentWaitParams {
     /** Optional run id/prefix to wait for. When omitted, waits across every active run in this session. */
     id?: string;
+    /** Optional supervisor question id from subagent_supervisor action='ask'. */
+    questionId?: string;
     /**
      * When true, block until EVERY active run in this session (or matching `id`)
      * is terminal. Default false: return as soon as the first run finishes, so a
      * fleet manager can spawn a replacement and wait again. Ignored when `id`
-     * targets a single run.
+     * or `questionId` targets a single item.
      */
     all?: boolean;
     /** Give up after this many milliseconds. Defaults to 30 minutes. */
@@ -86,10 +88,5 @@ export interface SubagentWaitDeps {
      */
     events?: WaitEventBus;
 }
-/**
- * Block until the targeted async or remembered detached foreground run finishes,
- * the timeout elapses, or the turn is aborted. Resolves with a short
- * human-readable summary either way.
- */
 export declare function waitForSubagents(params: SubagentWaitParams, signal: AbortSignal | undefined, deps: SubagentWaitDeps): Promise<AgentToolResult<Details>>;
 //# sourceMappingURL=subagent-wait.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/background/subagent-wait.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"subagent-wait.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/subagent-wait.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAGN,KAAK,sBAAsB,EAE3B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAQN,KAAK,OAAO,EAEZ,KAAK,aAAa,EAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAS7G,MAAM,WAAW,kBAAkB;IAClC,uGAAuG;IACvG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC5B,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,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,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,cAAc,CAAC,EAAE;QAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAAC;QACnE,YAAY,IAAI,SAAS,MAAM,EAAE,CAAC;KAClC,CAAC;IACF;;;;;OAKG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACtB;AA+MD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAuJnC","sourcesContent":["// @ts-nocheck\n/*\n `subagent_wait` tool: block the current turn until outstanding async runs\n * or a named remembered detached foreground run finishes.\n \n Background subagent runs are detached. In an interactive session the parent\n * can end its turn and Pi will wake it with a completion notification. That\n * does not work when the parent is a skill that must run to completion, and it\n * cannot work at all non-interactively (`pi -p ...`), where the run is a single\n * turn: once the turn ends there is nothing left to receive the notification.\n \n `subagent_wait` closes that gap. It keeps the turn alive until a tracked async\n * run for this session reaches a terminal state (complete / failed / paused),\n * the caller-supplied timeout elapses, or the turn is aborted. Because it awaits\n * inside the turn, the completion the model was told to wait for is actually\n * observed before the tool returns.\n \n By default `subagent_wait` returns as soon as ONE run finishes, so a fleet\n * manager can use it in a rolling-replacement loop: launch N workers, wait for\n * the next one to finish, spawn its replacement, then call `subagent_wait`\n * again — keeping N in flight instead of draining to zero between batches.\n * Pass `all: true` to block until every tracked async run is terminal, or `id`\n * to block on one specific async or remembered detached foreground run.\n \n `subagent_wait` also returns when a run needs attention — not just on\n * completion. A child that goes idle or blocks for a decision surfaces\n * `needs_attention` (the same signal Pi shows as a control notice and,\n * interactively, wakes the parent with). Since `subagent_wait` is used exactly\n * where there is no next turn to receive that notice, it must break on it too,\n * or a stuck child would stall the loop until the timeout. Attention runs are\n * reported so the caller can inspect / nudge / resume / interrupt them.\n \n Wake mechanism: when given Pi's event bus (`deps.events`), `subagent_wait`\n * subscribes to the subagent completion/control channels and wakes the instant\n * any fires, rather than waiting out a fixed poll interval. A poll still runs\n * on the interval as a reconciliation fallback (crashed runners, missed\n * events), and the poll is the source of truth for what actually changed — the\n * event only ends the sleep early. With no bus, `subagent_wait` degrades to pure\n * polling.\n /\n\nimport type { AgentToolResult } from \"@ashx-j/lunr-agent\";\nimport {\n\tlistBackgroundWorkWakeChannels,\n\tsnapshotBackgroundWork,\n\ttype BackgroundWorkSnapshot,\n\ttype RegisteredBackgroundWorkItem,\n} from \"../../api/background-work.ts\";\nimport { listAsyncRuns, type AsyncRunSummary } from \"./async-status.ts\";\nimport {\n\tASYNC_DIR,\n\tRESULTS_DIR,\n\tSUBAGENT_ASYNC_COMPLETE_EVENT,\n\tSUBAGENT_FOREGROUND_COMPLETE_EVENT,\n\tSUBAGENT_CONTROL_EVENT,\n\tSUBAGENT_CONTROL_INTERCOM_EVENT,\n\tSUBAGENT_RESULT_INTERCOM_EVENT,\n\ttype Details,\n\ttype ForegroundResumeRun,\n\ttype SubagentState,\n} from \"../../shared/types.ts\";\nimport { formatDuration } from \"../../shared/formatters.ts\";\nexport { WAIT_TOOL_ENABLED_ENV, resolveWaitToolConfig, type ResolvedWaitToolConfig } from \"./wait-config.ts\";\n\n/* States that mean a run is still in flight (not yet resolved). /\nconst ACTIVE_STATES: ReadonlyArray<AsyncRunSummary[\"state\"]> = [\"queued\", \"running\"];\n\nconst DEFAULT_TIMEOUT_MS = 30 60 * 1000; // 30 minutes\nconst MIN_POLL_INTERVAL_MS = 250;\nconst DEFAULT_POLL_INTERVAL_MS = 1000;\n\nexport interface SubagentWaitParams {\n\t/** Optional run id/prefix to wait for. When omitted, waits across every active run in this session. /\n\tid?: string;\n\t/\n\t When true, block until EVERY active run in this session (or matching `id`)\n\t * is terminal. Default false: return as soon as the first run finishes, so a\n\t * fleet manager can spawn a replacement and wait again. Ignored when `id`\n\t * targets a single run.\n\t /\n\tall?: boolean;\n\t/* Give up after this many milliseconds. Defaults to 30 minutes. /\n\ttimeoutMs?: number;\n}\n\n/* Minimal event-bus surface wait subscribes to (matches pi.events). /\nexport interface WaitEventBus {\n\ton(channel: string, handler: (data: unknown) => void): () => void;\n}\n\nexport interface SubagentWaitDeps {\n\tstate: SubagentState;\n\tasyncDirRoot?: string;\n\tresultsDir?: string;\n\tkill?: (pid: number, signal?: NodeJS.Signals \| 0) => boolean;\n\tnow?: () => number;\n\tpollIntervalMs?: number;\n\t/* False makes the tool return immediately without blocking active async runs. /\n\tenabled?: boolean;\n\t/* Injectable sleep for tests. /\n\tsleep?: (ms: number, signal?: AbortSignal) => Promise<void>;\n\t/* Internal auto-drain mode waits through needs-attention states. /\n\tstopOnAttention?: boolean;\n\t/* Internal auto-drain mode surfaces failed terminal subagent runs as errors. /\n\tfailOnFailedRuns?: boolean;\n\t/* Injectable provider protocol surfaces for deterministic tests. /\n\tbackgroundWork?: {\n\t\tsnapshot(sessionId: string, nowMs: number): BackgroundWorkSnapshot;\n\t\twakeChannels(): readonly string[];\n\t};\n\t/\n\t Optional event bus (pi.events). When provided, wait wakes immediately on a\n\t * subagent completion/control event instead of waiting out the poll interval;\n\t * the poll then remains as a reconciliation fallback (crashed runners, missed\n\t * events). Omit in tests that want pure poll behavior.\n\t /\n\tevents?: WaitEventBus;\n}\n\n/* Bus channels that indicate a run changed state or needs attention. /\nconst WAKE_CHANNELS = [\n\tSUBAGENT_ASYNC_COMPLETE_EVENT,\n\tSUBAGENT_FOREGROUND_COMPLETE_EVENT,\n\tSUBAGENT_CONTROL_EVENT,\n\tSUBAGENT_CONTROL_INTERCOM_EVENT,\n\tSUBAGENT_RESULT_INTERCOM_EVENT,\n];\n\nfunction defaultSleep(ms: number, signal?: AbortSignal): Promise<void> {\n\treturn new Promise((resolve) => {\n\t\tif (signal?.aborted) {\n\t\t\tresolve();\n\t\t\treturn;\n\t\t}\n\t\tconst timer = setTimeout(() => {\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\tresolve();\n\t\t}, ms);\n\t\tconst onAbort = () => {\n\t\t\tclearTimeout(timer);\n\t\t\tresolve();\n\t\t};\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n}\n\n/\n Sleep up to `ms`, but wake early if a subagent event fires on the bus (or the\n * turn aborts). Returns when the first of those happens. With no bus this is a\n * plain sleep, so the poll interval alone drives progress.\n /\nfunction waitForWake(ms: number, signal: AbortSignal \| undefined, deps: SubagentWaitDeps): Promise<void> {\n\tconst sleep = deps.sleep ?? defaultSleep;\n\tconst events = deps.events;\n\tif (!events) return sleep(ms, signal);\n\tconst providerChannels = deps.backgroundWork?.wakeChannels() ?? listBackgroundWorkWakeChannels();\n\treturn new Promise((resolve, reject) => {\n\t\tlet settled = false;\n\t\tconst unsubs: Array<() => void> = [];\n\t\tconst wakeController = new AbortController();\n\t\tconst done = () => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\twakeController.abort();\n\t\t\tsignal?.removeEventListener(\"abort\", done);\n\t\t\tfor (const u of unsubs) {\n\t\t\t\ttry { u(); } catch { / best effort / }\n\t\t\t}\n\t\t\tresolve();\n\t\t};\n\t\tif (signal?.aborted) {\n\t\t\tdone();\n\t\t\treturn;\n\t\t}\n\t\tsignal?.addEventListener(\"abort\", done, { once: true });\n\t\ttry {\n\t\t\tfor (const channel of [...new Set([...WAKE_CHANNELS, ...providerChannels])]) {\n\t\t\t\tunsubs.push(events.on(channel, done));\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tsignal?.removeEventListener(\"abort\", done);\n\t\t\tfor (const unsubscribe of unsubs) {\n\t\t\t\ttry { unsubscribe(); } catch { / best effort cleanup / }\n\t\t\t}\n\t\t\treject(error);\n\t\t\treturn;\n\t\t}\n\t\t// Poll-interval fallback so we still reconcile even if no event arrives.\n\t\t// The local signal cancels that fallback timer when an event wakes us first.\n\t\tvoid sleep(ms, wakeController.signal).then(done);\n\t});\n}\n\nfunction matchesId(run: AsyncRunSummary, id: string): boolean {\n\treturn run.id === id \|\| run.id.startsWith(id);\n}\n\nfunction activeDetachedForegroundRuns(params: SubagentWaitParams, deps: SubagentWaitDeps): ForegroundResumeRun[] {\n\tif (!params.id \|\| !deps.state.foregroundRuns) return [];\n\tconst sessionId = deps.state.currentSessionId;\n\tif (!sessionId) return [];\n\treturn [...deps.state.foregroundRuns.values()].filter((run) =>\n\t\t(run.runId === params.id \|\| run.runId.startsWith(params.id!))\n\t\t&& run.sessionId === sessionId\n\t\t&& run.children.some((child) => child.status === \"detached\")\n\t);\n}\n\nfunction summarizeForegroundChildren(run: ForegroundResumeRun, indices: Set<number>): string {\n\tconst counts = new Map<string, number>();\n\tfor (const child of run.children) {\n\t\tif (!indices.has(child.index) \|\| child.status === \"detached\") continue;\n\t\tcounts.set(child.status, (counts.get(child.status) ?? 0) + 1);\n\t}\n\treturn [...counts.entries()].map(([status, count]) => `${count} ${status}`).join(\", \");\n}\n\n/* A running run that has flagged it needs the parent's attention. /\nfunction needsAttention(run: AsyncRunSummary): boolean {\n\treturn run.activityState === \"needs_attention\";\n}\n\nfunction backgroundWorkIdentity(item: RegisteredBackgroundWorkItem): string {\n\treturn `${item.provider}\\0${item.sessionId}\\0${item.id}`;\n}\n\nfunction backgroundWorkForSession(deps: SubagentWaitDeps, nowMs: number): BackgroundWorkSnapshot {\n\tconst sessionId = deps.state.currentSessionId;\n\tif (!sessionId) throw new Error(\"subagent_wait requires an active session identity to scope background work safely.\");\n\treturn deps.backgroundWork?.snapshot(sessionId, nowMs) ?? snapshotBackgroundWork(sessionId, nowMs);\n}\n\n/* Queued/running runs from this session, including runs that need attention. /\nfunction activeRunsForSession(params: SubagentWaitParams, deps: SubagentWaitDeps): AsyncRunSummary[] {\n\tconst asyncDirRoot = deps.asyncDirRoot ?? ASYNC_DIR;\n\tconst resultsDir = deps.resultsDir ?? RESULTS_DIR;\n\tconst runs = listAsyncRuns(asyncDirRoot, {\n\t\tstates: [...ACTIVE_STATES],\n\t\tsessionId: deps.state.currentSessionId ?? undefined,\n\t\tresultsDir,\n\t\tkill: deps.kill,\n\t\tnow: deps.now,\n\t});\n\treturn params.id ? runs.filter((run) => matchesId(run, params.id!)) : runs;\n}\n\n/* Runs (from the initial set) currently flagged needs_attention, for reporting. /\nfunction attentionRunsForSession(params: SubagentWaitParams, deps: SubagentWaitDeps, initialIds: Set<string>): AsyncRunSummary[] {\n\treturn activeRunsForSession(params, deps).filter((run) => needsAttention(run) && initialIds.has(run.id));\n}\n\n/* All runs (any state) for this session, for the final summary. /\nfunction allRunsForSession(params: SubagentWaitParams, deps: SubagentWaitDeps): AsyncRunSummary[] {\n\tconst asyncDirRoot = deps.asyncDirRoot ?? ASYNC_DIR;\n\tconst resultsDir = deps.resultsDir ?? RESULTS_DIR;\n\tconst runs = listAsyncRuns(asyncDirRoot, {\n\t\tsessionId: deps.state.currentSessionId ?? undefined,\n\t\tresultsDir,\n\t\tkill: deps.kill,\n\t\tnow: deps.now,\n\t});\n\treturn params.id ? runs.filter((run) => matchesId(run, params.id!)) : runs;\n}\n\nfunction summarizeTerminalRuns(runs: AsyncRunSummary[], providerFinishedCount = 0): string {\n\tif (runs.length === 0 && providerFinishedCount === 0) return \"\";\n\tconst counts = { complete: 0, failed: 0, paused: 0 } as Record<string, number>;\n\tfor (const run of runs) {\n\t\tif (run.state in counts) counts[run.state] += 1;\n\t}\n\tconst parts: string[] = [];\n\tif (counts.complete) parts.push(`${counts.complete} complete`);\n\tif (counts.failed) parts.push(`${counts.failed} failed`);\n\tif (counts.paused) parts.push(`${counts.paused} paused`);\n\tif (providerFinishedCount > 0) parts.push(`${providerFinishedCount} provider item(s) finished`);\n\treturn parts.join(\", \");\n}\n\nfunction result(text: string, isError = false): AgentToolResult<Details> {\n\treturn {\n\t\tcontent: [{ type: \"text\", text }],\n\t\t...(isError ? { isError: true } : {}),\n\t\tdetails: { mode: \"management\", results: [] },\n\t};\n}\n\nasync function waitForDetachedForegroundRun(\n\trun: ForegroundResumeRun,\n\tsignal: AbortSignal \| undefined,\n\tdeps: SubagentWaitDeps,\n\tstartedAt: number,\n\tnow: () => number,\n\tpollIntervalMs: number,\n\ttimeoutMs: number,\n): Promise<AgentToolResult<Details>> {\n\tconst initialDetachedIndices = new Set(run.children.filter((child) => child.status === \"detached\").map((child) => child.index));\n\twhile (true) {\n\t\tif (deps.state.currentSessionId !== run.sessionId) {\n\t\t\treturn result(`Wait stopped because the active session changed while remembered foreground run \"${run.runId}\" was still detached. Return to the originating session to inspect or wait for it.`, true);\n\t\t}\n\t\tconst current = deps.state.foregroundRuns?.get(run.runId);\n\t\tif (!current \|\| current.sessionId !== run.sessionId) {\n\t\t\treturn result(`Remembered foreground run \"${run.runId}\" disappeared before a terminal child result was recorded. Completion cannot be confirmed; do not launch a replacement without checking the originating child session.`, true);\n\t\t}\n\t\tconst pending = current.children.filter((child) => initialDetachedIndices.has(child.index) && child.status === \"detached\");\n\t\tif (pending.length === 0) {\n\t\t\tconst outcome = summarizeForegroundChildren(current, initialDetachedIndices);\n\t\t\treturn result(\n\t\t\t\t`Waited ${formatDuration(now() - startedAt)} for remembered detached foreground run \"${run.runId}\"; done. Outcome: ${outcome \|\| \"no recovered child status\"}. Completion event observed; inspect with subagent({ action: \"status\", id: \"${run.runId}\" }) for recovered output.`,\n\t\t\t);\n\t\t}\n\t\tif (signal?.aborted) {\n\t\t\treturn result(`Wait aborted after ${formatDuration(now() - startedAt)}. Remembered foreground run \"${run.runId}\" remains detached.`, true);\n\t\t}\n\t\tif (now() - startedAt >= timeoutMs) {\n\t\t\treturn result(\n\t\t\t\t`Wait timed out after ${formatDuration(timeoutMs)} with remembered foreground run \"${run.runId}\" still detached. Reply to any pending supervisor request, then call subagent_wait({ id: \"${run.runId}\" }) again or inspect status; do not resume or launch a replacement while it remains detached.`,\n\t\t\t\ttrue,\n\t\t\t);\n\t\t}\n\t\tawait waitForWake(pollIntervalMs, signal, deps);\n\t}\n}\n\n/\n Block until the targeted async or remembered detached foreground run finishes,\n * the timeout elapses, or the turn is aborted. Resolves with a short\n * human-readable summary either way.\n */\nexport async function waitForSubagents(\n\tparams: SubagentWaitParams,\n\tsignal: AbortSignal \| undefined,\n\tdeps: SubagentWaitDeps,\n): Promise<AgentToolResult<Details>> {\n\tif (deps.enabled === false) {\n\t\treturn result(\"subagent_wait is disabled by config.waitTool or PI_SUBAGENT_WAIT_TOOL_ENABLED; returning immediately without blocking background work. Active work keeps going, and you can inspect subagents with subagent({ action: \\\"status\\\" }) or rely on completion notifications.\");\n\t}\n\tif (!deps.state.currentSessionId) {\n\t\treturn result(\"subagent_wait requires an active session identity to scope background work safely.\", true);\n\t}\n\n\tconst now = deps.now ?? Date.now;\n\tconst pollIntervalMs = Math.max(MIN_POLL_INTERVAL_MS, deps.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);\n\tconst timeoutMs = params.timeoutMs !== undefined && params.timeoutMs > 0 ? params.timeoutMs : DEFAULT_TIMEOUT_MS;\n\tconst startedAt = now();\n\tconst waitForAll = params.id ? true : params.all === true;\n\n\tlet active: AsyncRunSummary[];\n\tlet foreground: ForegroundResumeRun[];\n\tlet providerSnapshot: BackgroundWorkSnapshot;\n\ttry {\n\t\tactive = activeRunsForSession(params, deps);\n\t\tforeground = activeDetachedForegroundRuns(params, deps);\n\t\tproviderSnapshot = params.id ? { providers: [], items: [] } : backgroundWorkForSession(deps, startedAt);\n\t} catch (error) {\n\t\treturn result(error instanceof Error ? error.message : String(error), true);\n\t}\n\n\tif (params.id) {\n\t\tconst candidates = [\n\t\t\t...active.map((run) => ({ kind: \"async\" as const, id: run.id, run })),\n\t\t\t...foreground.map((run) => ({ kind: \"foreground\" as const, id: run.runId, run })),\n\t\t];\n\t\tconst exact = candidates.filter((candidate) => candidate.id === params.id);\n\t\tconst matches = exact.length > 0 ? exact : candidates;\n\t\tif (matches.length > 1) {\n\t\t\treturn result(`Ambiguous subagent run id prefix \"${params.id}\" matched ${matches.length} active runs: ${matches.map((candidate) => candidate.id).join(\", \")}. Pass a longer id.`, true);\n\t\t}\n\t\tconst selected = matches[0];\n\t\tif (selected?.kind === \"foreground\") {\n\t\t\treturn waitForDetachedForegroundRun(selected.run, signal, deps, startedAt, now, pollIntervalMs, timeoutMs);\n\t\t}\n\t\tactive = selected?.kind === \"async\" ? [selected.run] : [];\n\t}\n\n\tlet providerActive = providerSnapshot.items;\n\tif (active.length === 0 && providerActive.length === 0) {\n\t\treturn result(params.id\n\t\t\t? `No active run matched \"${params.id}\". Nothing to wait for.`\n\t\t\t: \"No active async runs or registered provider work in this session. Nothing to wait for.\");\n\t}\n\tconst waitParams = params.id ? { ...params, id: active[0]!.id } : params;\n\tconst initialAsyncIds = new Set(active.map((run) => run.id));\n\tconst initialProviderIds = new Set(providerActive.map(backgroundWorkIdentity));\n\tconst initialProviderNames = new Set(providerActive.map((item) => item.provider));\n\tconst initialCount = initialAsyncIds.size + initialProviderIds.size;\n\tconst stopOnAttention = deps.stopOnAttention !== false;\n\tlet attention = active.filter((run) => needsAttention(run));\n\n\tconst isDone = (): boolean => {\n\t\tif (stopOnAttention && attention.some((run) => initialAsyncIds.has(run.id))) return true;\n\t\tconst activeAsyncIds = new Set(active.map((run) => run.id));\n\t\tconst activeProviderIds = new Set(providerActive.map(backgroundWorkIdentity));\n\t\tif (waitForAll) {\n\t\t\treturn [...initialAsyncIds].every((id) => !activeAsyncIds.has(id))\n\t\t\t\t&& [...initialProviderIds].every((id) => !activeProviderIds.has(id));\n\t\t}\n\t\treturn [...initialAsyncIds].some((id) => !activeAsyncIds.has(id))\n\t\t\t\|\| [...initialProviderIds].some((id) => !activeProviderIds.has(id));\n\t};\n\n\twhile (!isDone()) {\n\t\tconst activeInitialRuns = active.filter((run) => initialAsyncIds.has(run.id));\n\t\tconst activeInitialProviderItems = providerActive.filter((item) => initialProviderIds.has(backgroundWorkIdentity(item)));\n\t\tconst stillActive = [\n\t\t\t...activeInitialRuns.map((run) => `${run.id} (${run.state})`),\n\t\t\t...activeInitialProviderItems.map((item) => `${item.provider}/${item.id}`),\n\t\t].join(\", \");\n\t\tif (signal?.aborted) {\n\t\t\treturn result(`Wait aborted after ${formatDuration(now() - startedAt)}. Still active: ${stillActive}.`, true);\n\t\t}\n\t\tif (now() - startedAt >= timeoutMs) {\n\t\t\treturn result(\n\t\t\t\t`Wait timed out after ${formatDuration(timeoutMs)} with ${activeInitialRuns.length} async run(s) and ${activeInitialProviderItems.length} provider item(s) still active: ${stillActive}. The work keeps going; call subagent_wait again or inspect subagent status.`,\n\t\t\t\ttrue,\n\t\t\t);\n\t\t}\n\t\ttry {\n\t\t\tawait waitForWake(pollIntervalMs, signal, deps);\n\t\t\tactive = activeRunsForSession(waitParams, deps);\n\t\t\tattention = attentionRunsForSession(waitParams, deps, initialAsyncIds);\n\t\t\tproviderSnapshot = params.id ? providerSnapshot : backgroundWorkForSession(deps, now());\n\t\t\tfor (const provider of initialProviderNames) {\n\t\t\t\tif (!providerSnapshot.providers.includes(provider)) {\n\t\t\t\t\treturn result(`Background-work provider '${provider}' disappeared while subagent_wait was tracking its active work; completion cannot be confirmed.`, true);\n\t\t\t\t}\n\t\t\t}\n\t\t\tproviderActive = providerSnapshot.items;\n\t\t} catch (error) {\n\t\t\treturn result(error instanceof Error ? error.message : String(error), true);\n\t\t}\n\t}\n\n\tlet terminalSummary: string;\n\tlet finishedAsyncCount: number;\n\tlet failedAsyncCount: number;\n\tconst activeProviderIds = new Set(providerActive.map(backgroundWorkIdentity));\n\tconst providerFinishedCount = [...initialProviderIds].filter((id) => !activeProviderIds.has(id)).length;\n\ttry {\n\t\tconst allNow = allRunsForSession(waitParams, deps);\n\t\tconst terminal = allNow.filter((run) => !ACTIVE_STATES.includes(run.state) && initialAsyncIds.has(run.id));\n\t\tfinishedAsyncCount = terminal.length;\n\t\tfailedAsyncCount = terminal.filter((run) => run.state === \"failed\").length;\n\t\tterminalSummary = summarizeTerminalRuns(terminal, providerFinishedCount);\n\t} catch (error) {\n\t\treturn result(error instanceof Error ? error.message : String(error), true);\n\t}\n\n\tconst relevantAttention = attention.filter((run) => initialAsyncIds.has(run.id));\n\tconst attentionNote = relevantAttention.length > 0\n\t\t? ` ${relevantAttention.length} run(s) need attention: ${relevantAttention.map((run) => run.id).join(\", \")} — inspect with subagent({ action: \"status\" }) then nudge/resume/interrupt.`\n\t\t: \"\";\n\tconst stillRunning = active.filter((run) => initialAsyncIds.has(run.id)).length\n\t\t+ providerActive.filter((item) => initialProviderIds.has(backgroundWorkIdentity(item))).length;\n\tconst elapsed = formatDuration(now() - startedAt);\n\tconst outcome = terminalSummary ? ` Outcome: ${terminalSummary}.` : \"\";\n\n\tif (waitForAll) {\n\t\tconst scope = params.id\n\t\t\t? `run \"${params.id}\"`\n\t\t\t: initialProviderIds.size === 0\n\t\t\t\t? `${initialAsyncIds.size} async run(s)`\n\t\t\t\t: `${initialAsyncIds.size} async run(s) and ${initialProviderIds.size} provider item(s)`;\n\t\tconst status = relevantAttention.length > 0 ? \"attention required\" : \"done\";\n\t\treturn result(\n\t\t\t`Waited ${elapsed} for ${scope}; ${status}.${outcome}${attentionNote} Completion/control events have been observed; inspect status if a notification is not visible yet.`,\n\t\t\tdeps.failOnFailedRuns === true && failedAsyncCount > 0,\n\t\t);\n\t}\n\n\tconst finishedCount = finishedAsyncCount + providerFinishedCount;\n\tconst subject = initialProviderIds.size === 0 ? \"run(s)\" : \"item(s)\";\n\tconst remainder = stillRunning > 0\n\t\t? ` ${stillRunning} ${subject} still in flight — call subagent_wait again to catch the next one.`\n\t\t: relevantAttention.length > 0\n\t\t\t? \" No other work is waitable until attention is handled.\"\n\t\t\t: initialProviderIds.size === 0 ? \" No runs remain in flight.\" : \" No work remains in flight.\";\n\tconst progress = relevantAttention.length > 0 && finishedCount === 0\n\t\t? `${relevantAttention.length} of ${initialCount} ${subject} need attention`\n\t\t: `${finishedCount} of ${initialCount} ${subject} finished`;\n\treturn result(\n\t\t`Waited ${elapsed}; ${progress}.${outcome}${attentionNote}${remainder} Relevant completion/control events have been observed; inspect status if a notification is not visible yet.`,\n\t\tdeps.failOnFailedRuns === true && failedAsyncCount > 0,\n\t);\n}\n"]}
1	+ {"version":3,"file":"subagent-wait.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/background/subagent-wait.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAGN,KAAK,sBAAsB,EAE3B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EASN,KAAK,OAAO,EAEZ,KAAK,aAAa,EAClB,MAAM,uBAAuB,CAAC;AAY/B,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAS7G,MAAM,WAAW,kBAAkB;IAClC,uGAAuG;IACvG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC5B,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,aAAa,CAAC;IACrB,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,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qEAAqE;IACrE,cAAc,CAAC,EAAE;QAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAAC;QACnE,YAAY,IAAI,SAAS,MAAM,EAAE,CAAC;KAClC,CAAC;IACF;;;;;OAKG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACtB;AAgRD,wBAAsB,gBAAgB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CA0JnC","sourcesContent":["// @ts-nocheck\n/*\n `subagent_wait` tool: block the current turn until outstanding async runs\n * or a named remembered detached foreground run finishes.\n \n Background subagent runs are detached. In an interactive session the parent\n * can end its turn and Pi will wake it with a completion notification. That\n * does not work when the parent is a skill that must run to completion, and it\n * cannot work at all non-interactively (`pi -p ...`), where the run is a single\n * turn: once the turn ends there is nothing left to receive the notification.\n \n `subagent_wait` closes that gap. It keeps the turn alive until a tracked async\n * run for this session reaches a terminal state (complete / failed / paused),\n * the caller-supplied timeout elapses, or the turn is aborted. Because it awaits\n * inside the turn, the completion the model was told to wait for is actually\n * observed before the tool returns.\n \n By default `subagent_wait` returns as soon as ONE run finishes, so a fleet\n * manager can use it in a rolling-replacement loop: launch N workers, wait for\n * the next one to finish, spawn its replacement, then call `subagent_wait`\n * again — keeping N in flight instead of draining to zero between batches.\n * Pass `all: true` to block until every tracked async run is terminal, or `id`\n * to block on one specific async or remembered detached foreground run.\n \n `subagent_wait` also returns when a run needs attention — not just on\n * completion. A child that goes idle or blocks for a decision surfaces\n * `needs_attention` (the same signal Pi shows as a control notice and,\n * interactively, wakes the parent with). Since `subagent_wait` is used exactly\n * where there is no next turn to receive that notice, it must break on it too,\n * or a stuck child would stall the loop until the timeout. Attention runs are\n * reported so the caller can inspect / nudge / resume / interrupt them.\n \n Wake mechanism: when given Pi's event bus (`deps.events`), `subagent_wait`\n * subscribes to the subagent completion/control channels and wakes the instant\n * any fires, rather than waiting out a fixed poll interval. A poll still runs\n * on the interval as a reconciliation fallback (crashed runners, missed\n * events), and the poll is the source of truth for what actually changed — the\n * event only ends the sleep early. With no bus, `subagent_wait` degrades to pure\n * polling.\n /\n\nimport type { AgentToolResult } from \"@ashx-j/lunr-agent\";\nimport {\n\tlistBackgroundWorkWakeChannels,\n\tsnapshotBackgroundWork,\n\ttype BackgroundWorkSnapshot,\n\ttype RegisteredBackgroundWorkItem,\n} from \"../../api/background-work.ts\";\nimport { listAsyncRuns, type AsyncRunSummary } from \"./async-status.ts\";\nimport { hasPendingBlockingSupervisorRequest } from \"../../intercom/native-supervisor-channel.ts\";\nimport {\n\tASYNC_DIR,\n\tINTERCOM_DETACH_REQUEST_EVENT,\n\tRESULTS_DIR,\n\tSUBAGENT_ASYNC_COMPLETE_EVENT,\n\tSUBAGENT_FOREGROUND_COMPLETE_EVENT,\n\tSUBAGENT_CONTROL_EVENT,\n\tSUBAGENT_CONTROL_INTERCOM_EVENT,\n\tSUBAGENT_RESULT_INTERCOM_EVENT,\n\ttype Details,\n\ttype ForegroundResumeRun,\n\ttype SubagentState,\n} from \"../../shared/types.ts\";\nimport { formatDuration } from \"../../shared/formatters.ts\";\nimport { reconcileAsyncQuestion } from \"../../intercom/supervisor-ask.ts\";\nimport {\n\tclaimQuestionNotification,\n\tfindSupervisorQuestion,\n\tformatSupervisorQuestionAnswer,\n\tregisterQuestionWait,\n\tsupervisorQuestionIsTerminal,\n\tsupervisorQuestionPublicState,\n\tSUBAGENT_QUESTION_EVENT,\n} from \"../../intercom/supervisor-questions.ts\";\nexport { WAIT_TOOL_ENABLED_ENV, resolveWaitToolConfig, type ResolvedWaitToolConfig } from \"./wait-config.ts\";\n\n/* States that mean a run is still in flight (not yet resolved). /\nconst ACTIVE_STATES: ReadonlyArray<AsyncRunSummary[\"state\"]> = [\"queued\", \"running\"];\n\nconst DEFAULT_TIMEOUT_MS = 30 60 * 1000; // 30 minutes\nconst MIN_POLL_INTERVAL_MS = 250;\nconst DEFAULT_POLL_INTERVAL_MS = 1000;\n\nexport interface SubagentWaitParams {\n\t/** Optional run id/prefix to wait for. When omitted, waits across every active run in this session. /\n\tid?: string;\n\t/* Optional supervisor question id from subagent_supervisor action='ask'. /\n\tquestionId?: string;\n\t/\n\t When true, block until EVERY active run in this session (or matching `id`)\n\t * is terminal. Default false: return as soon as the first run finishes, so a\n\t * fleet manager can spawn a replacement and wait again. Ignored when `id`\n\t * or `questionId` targets a single item.\n\t /\n\tall?: boolean;\n\t/* Give up after this many milliseconds. Defaults to 30 minutes. /\n\ttimeoutMs?: number;\n}\n\n/* Minimal event-bus surface wait subscribes to (matches pi.events). /\nexport interface WaitEventBus {\n\ton(channel: string, handler: (data: unknown) => void): () => void;\n}\n\nexport interface SubagentWaitDeps {\n\tstate: SubagentState;\n\tasyncDirRoot?: string;\n\tresultsDir?: string;\n\tkill?: (pid: number, signal?: NodeJS.Signals \| 0) => boolean;\n\tnow?: () => number;\n\tpollIntervalMs?: number;\n\t/* False makes the tool return immediately without blocking active async runs. /\n\tenabled?: boolean;\n\t/* Injectable sleep for tests. /\n\tsleep?: (ms: number, signal?: AbortSignal) => Promise<void>;\n\t/* Internal auto-drain mode waits through needs-attention states. /\n\tstopOnAttention?: boolean;\n\t/* Internal auto-drain mode surfaces failed terminal subagent runs as errors. /\n\tfailOnFailedRuns?: boolean;\n\t/* Injectable provider protocol surfaces for deterministic tests. /\n\tbackgroundWork?: {\n\t\tsnapshot(sessionId: string, nowMs: number): BackgroundWorkSnapshot;\n\t\twakeChannels(): readonly string[];\n\t};\n\t/\n\t Optional event bus (pi.events). When provided, wait wakes immediately on a\n\t * subagent completion/control event instead of waiting out the poll interval;\n\t * the poll then remains as a reconciliation fallback (crashed runners, missed\n\t * events). Omit in tests that want pure poll behavior.\n\t /\n\tevents?: WaitEventBus;\n}\n\n/* Bus channels that indicate a run changed state or needs attention. /\nconst WAKE_CHANNELS = [\n\tSUBAGENT_ASYNC_COMPLETE_EVENT,\n\tSUBAGENT_FOREGROUND_COMPLETE_EVENT,\n\tSUBAGENT_CONTROL_EVENT,\n\tSUBAGENT_CONTROL_INTERCOM_EVENT,\n\tSUBAGENT_RESULT_INTERCOM_EVENT,\n\tINTERCOM_DETACH_REQUEST_EVENT,\n\tSUBAGENT_QUESTION_EVENT,\n];\n\nfunction defaultSleep(ms: number, signal?: AbortSignal): Promise<void> {\n\treturn new Promise((resolve) => {\n\t\tif (signal?.aborted) {\n\t\t\tresolve();\n\t\t\treturn;\n\t\t}\n\t\tconst timer = setTimeout(() => {\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\tresolve();\n\t\t}, ms);\n\t\tconst onAbort = () => {\n\t\t\tclearTimeout(timer);\n\t\t\tresolve();\n\t\t};\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n}\n\n/\n Sleep up to `ms`, but wake early if a subagent event fires on the bus (or the\n * turn aborts). Returns when the first of those happens. With no bus this is a\n * plain sleep, so the poll interval alone drives progress.\n /\nfunction waitForWake(ms: number, signal: AbortSignal \| undefined, deps: SubagentWaitDeps): Promise<void> {\n\tconst sleep = deps.sleep ?? defaultSleep;\n\tconst events = deps.events;\n\tif (!events) return sleep(ms, signal);\n\tconst providerChannels = deps.backgroundWork?.wakeChannels() ?? listBackgroundWorkWakeChannels();\n\treturn new Promise((resolve, reject) => {\n\t\tlet settled = false;\n\t\tconst unsubs: Array<() => void> = [];\n\t\tconst wakeController = new AbortController();\n\t\tconst done = () => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\twakeController.abort();\n\t\t\tsignal?.removeEventListener(\"abort\", done);\n\t\t\tfor (const u of unsubs) {\n\t\t\t\ttry { u(); } catch { / best effort / }\n\t\t\t}\n\t\t\tresolve();\n\t\t};\n\t\tif (signal?.aborted) {\n\t\t\tdone();\n\t\t\treturn;\n\t\t}\n\t\tsignal?.addEventListener(\"abort\", done, { once: true });\n\t\ttry {\n\t\t\tfor (const channel of [...new Set([...WAKE_CHANNELS, ...providerChannels])]) {\n\t\t\t\tunsubs.push(events.on(channel, done));\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tsignal?.removeEventListener(\"abort\", done);\n\t\t\tfor (const unsubscribe of unsubs) {\n\t\t\t\ttry { unsubscribe(); } catch { / best effort cleanup / }\n\t\t\t}\n\t\t\treject(error);\n\t\t\treturn;\n\t\t}\n\t\t// Poll-interval fallback so we still reconcile even if no event arrives.\n\t\t// The local signal cancels that fallback timer when an event wakes us first.\n\t\tvoid sleep(ms, wakeController.signal).then(done);\n\t});\n}\n\nfunction matchesId(run: AsyncRunSummary, id: string): boolean {\n\treturn run.id === id \|\| run.id.startsWith(id);\n}\n\nfunction activeDetachedForegroundRuns(params: SubagentWaitParams, deps: SubagentWaitDeps): ForegroundResumeRun[] {\n\tif (!params.id \|\| !deps.state.foregroundRuns) return [];\n\tconst sessionId = deps.state.currentSessionId;\n\tif (!sessionId) return [];\n\treturn [...deps.state.foregroundRuns.values()].filter((run) =>\n\t\t(run.runId === params.id \|\| run.runId.startsWith(params.id!))\n\t\t&& run.sessionId === sessionId\n\t\t&& run.children.some((child) => child.status === \"detached\")\n\t);\n}\n\nfunction summarizeForegroundChildren(run: ForegroundResumeRun, indices: Set<number>): string {\n\tconst counts = new Map<string, number>();\n\tfor (const child of run.children) {\n\t\tif (!indices.has(child.index) \|\| child.status === \"detached\") continue;\n\t\tcounts.set(child.status, (counts.get(child.status) ?? 0) + 1);\n\t}\n\treturn [...counts.entries()].map(([status, count]) => `${count} ${status}`).join(\", \");\n}\n\n/* A running run that has flagged it needs the parent's attention. /\nfunction needsAttention(run: AsyncRunSummary, sessionId?: string \| null): boolean {\n\treturn run.activityState === \"needs_attention\"\n\t\t\|\| hasPendingBlockingSupervisorRequest(run.id, sessionId);\n}\n\nfunction backgroundWorkIdentity(item: RegisteredBackgroundWorkItem): string {\n\treturn `${item.provider}\\0${item.sessionId}\\0${item.id}`;\n}\n\nfunction backgroundWorkForSession(deps: SubagentWaitDeps, nowMs: number): BackgroundWorkSnapshot {\n\tconst sessionId = deps.state.currentSessionId;\n\tif (!sessionId) throw new Error(\"subagent_wait requires an active session identity to scope background work safely.\");\n\treturn deps.backgroundWork?.snapshot(sessionId, nowMs) ?? snapshotBackgroundWork(sessionId, nowMs);\n}\n\n/* Queued/running runs from this session, including runs that need attention. /\nfunction activeRunsForSession(params: SubagentWaitParams, deps: SubagentWaitDeps): AsyncRunSummary[] {\n\tconst asyncDirRoot = deps.asyncDirRoot ?? ASYNC_DIR;\n\tconst resultsDir = deps.resultsDir ?? RESULTS_DIR;\n\tconst runs = listAsyncRuns(asyncDirRoot, {\n\t\tstates: [...ACTIVE_STATES],\n\t\tsessionId: deps.state.currentSessionId ?? undefined,\n\t\tresultsDir,\n\t\tkill: deps.kill,\n\t\tnow: deps.now,\n\t});\n\treturn params.id ? runs.filter((run) => matchesId(run, params.id!)) : runs;\n}\n\n/* Runs (from the initial set) currently flagged needs_attention, for reporting. /\nfunction attentionRunsForSession(params: SubagentWaitParams, deps: SubagentWaitDeps, initialIds: Set<string>): AsyncRunSummary[] {\n\treturn activeRunsForSession(params, deps).filter((run) => needsAttention(run, deps.state.currentSessionId) && initialIds.has(run.id));\n}\n\n/* All runs (any state) for this session, for the final summary. /\nfunction allRunsForSession(params: SubagentWaitParams, deps: SubagentWaitDeps): AsyncRunSummary[] {\n\tconst asyncDirRoot = deps.asyncDirRoot ?? ASYNC_DIR;\n\tconst resultsDir = deps.resultsDir ?? RESULTS_DIR;\n\tconst runs = listAsyncRuns(asyncDirRoot, {\n\t\tsessionId: deps.state.currentSessionId ?? undefined,\n\t\tresultsDir,\n\t\tkill: deps.kill,\n\t\tnow: deps.now,\n\t});\n\treturn params.id ? runs.filter((run) => matchesId(run, params.id!)) : runs;\n}\n\nfunction summarizeTerminalRuns(runs: AsyncRunSummary[], providerFinishedCount = 0): string {\n\tif (runs.length === 0 && providerFinishedCount === 0) return \"\";\n\tconst counts = { complete: 0, failed: 0, paused: 0 } as Record<string, number>;\n\tfor (const run of runs) {\n\t\tif (run.state in counts) counts[run.state] += 1;\n\t}\n\tconst parts: string[] = [];\n\tif (counts.complete) parts.push(`${counts.complete} complete`);\n\tif (counts.failed) parts.push(`${counts.failed} failed`);\n\tif (counts.paused) parts.push(`${counts.paused} paused`);\n\tif (providerFinishedCount > 0) parts.push(`${providerFinishedCount} provider item(s) finished`);\n\treturn parts.join(\", \");\n}\n\nfunction result(text: string, isError = false): AgentToolResult<Details> {\n\treturn {\n\t\tcontent: [{ type: \"text\", text }],\n\t\t...(isError ? { isError: true } : {}),\n\t\tdetails: { mode: \"management\", results: [] },\n\t};\n}\n\nasync function waitForDetachedForegroundRun(\n\trun: ForegroundResumeRun,\n\tsignal: AbortSignal \| undefined,\n\tdeps: SubagentWaitDeps,\n\tstartedAt: number,\n\tnow: () => number,\n\tpollIntervalMs: number,\n\ttimeoutMs: number,\n): Promise<AgentToolResult<Details>> {\n\tconst initialDetachedIndices = new Set(run.children.filter((child) => child.status === \"detached\").map((child) => child.index));\n\twhile (true) {\n\t\tif (deps.state.currentSessionId !== run.sessionId) {\n\t\t\treturn result(`Wait stopped because the active session changed while remembered foreground run \"${run.runId}\" was still detached. Return to the originating session to inspect or wait for it.`, true);\n\t\t}\n\t\tconst current = deps.state.foregroundRuns?.get(run.runId);\n\t\tif (!current \|\| current.sessionId !== run.sessionId) {\n\t\t\treturn result(`Remembered foreground run \"${run.runId}\" disappeared before a terminal child result was recorded. Completion cannot be confirmed; do not launch a replacement without checking the originating child session.`, true);\n\t\t}\n\t\tconst pending = current.children.filter((child) => initialDetachedIndices.has(child.index) && child.status === \"detached\");\n\t\tif (pending.length === 0) {\n\t\t\tconst outcome = summarizeForegroundChildren(current, initialDetachedIndices);\n\t\t\treturn result(\n\t\t\t\t`Waited ${formatDuration(now() - startedAt)} for remembered detached foreground run \"${run.runId}\"; done. Outcome: ${outcome \|\| \"no recovered child status\"}. Completion event observed; inspect with subagent({ action: \"status\", id: \"${run.runId}\" }) for recovered output.`,\n\t\t\t);\n\t\t}\n\t\tif (signal?.aborted) {\n\t\t\treturn result(`Wait aborted after ${formatDuration(now() - startedAt)}. Remembered foreground run \"${run.runId}\" remains detached.`, true);\n\t\t}\n\t\tif (now() - startedAt >= timeoutMs) {\n\t\t\treturn result(\n\t\t\t\t`Wait timed out after ${formatDuration(timeoutMs)} with remembered foreground run \"${run.runId}\" still detached. Reply to any pending supervisor request, then call subagent_wait({ id: \"${run.runId}\" }) again or inspect status; do not resume or launch a replacement while it remains detached.`,\n\t\t\t\ttrue,\n\t\t\t);\n\t\t}\n\t\tawait waitForWake(pollIntervalMs, signal, deps);\n\t}\n}\n\n/\n Block until the targeted async or remembered detached foreground run finishes,\n * the timeout elapses, or the turn is aborted. Resolves with a short\n * human-readable summary either way.\n */\nasync function waitForSupervisorQuestion(\n\tquestionId: string,\n\tsignal: AbortSignal \| undefined,\n\tdeps: SubagentWaitDeps,\n\tstartedAt: number,\n\tnow: () => number,\n\tpollIntervalMs: number,\n\ttimeoutMs: number,\n): Promise<AgentToolResult<Details>> {\n\tconst sessionId = deps.state.currentSessionId;\n\tif (!sessionId) return result(\"subagent_wait requires an active session identity to scope background work safely.\", true);\n\tconst releaseWait = registerQuestionWait([questionId]);\n\ttry {\n\t\twhile (true) {\n\t\t\tconst found = findSupervisorQuestion(questionId);\n\t\t\tif (!found) {\n\t\t\t\treturn result(`No supervisor question matched \"${questionId}\".`, true);\n\t\t\t}\n\t\t\tconst { channelDir } = found;\n\t\t\tlet { question } = found;\n\t\t\tif (question.parentSessionId !== sessionId \|\| deps.state.currentSessionId !== sessionId) {\n\t\t\t\treturn result(`Supervisor question \"${questionId}\" belongs to another session.`, true);\n\t\t\t}\n\t\t\tif ((deps.state.sessionGeneration ?? 0) !== question.parentGeneration) {\n\t\t\t\treturn result(`Supervisor question \"${questionId}\" was cancelled by a session replacement.`, true);\n\t\t\t}\n\t\t\tquestion = reconcileAsyncQuestion(channelDir, question, deps.state);\n\t\t\tif (supervisorQuestionIsTerminal(question)) {\n\t\t\t\tclaimQuestionNotification(channelDir, question.id);\n\t\t\t\tconst state = supervisorQuestionPublicState(question);\n\t\t\t\treturn {\n\t\t\t\t\tcontent: [{ type: \"text\", text: formatSupervisorQuestionAnswer(question) }],\n\t\t\t\t\t...(state === \"answered\" ? {} : { isError: true }),\n\t\t\t\t\tdetails: {\n\t\t\t\t\t\tmode: \"management\",\n\t\t\t\t\t\tresults: [],\n\t\t\t\t\t\tquestionId: question.id,\n\t\t\t\t\t\tstate,\n\t\t\t\t\t\trunId: question.runId,\n\t\t\t\t\t\tanswered: state === \"answered\",\n\t\t\t\t\t\tdelivered: Boolean(question.deliveredAt),\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t}\n\t\t\tif (signal?.aborted) {\n\t\t\t\treturn result(`Wait aborted after ${formatDuration(now() - startedAt)} for supervisor question \"${questionId}\".`, true);\n\t\t\t}\n\t\t\tif (now() - startedAt >= timeoutMs) {\n\t\t\t\treturn result(`Wait timed out after ${formatDuration(timeoutMs)} for supervisor question \"${questionId}\". The question remains pending until answered, expired, or cancelled.`, true);\n\t\t\t}\n\t\t\tawait waitForWake(pollIntervalMs, signal, deps);\n\t\t}\n\t} finally {\n\t\treleaseWait();\n\t}\n}\n\nexport async function waitForSubagents(\n\tparams: SubagentWaitParams,\n\tsignal: AbortSignal \| undefined,\n\tdeps: SubagentWaitDeps,\n): Promise<AgentToolResult<Details>> {\n\tif (deps.enabled === false) {\n\t\treturn result(\"subagent_wait is disabled by config.waitTool or PI_SUBAGENT_WAIT_TOOL_ENABLED; returning immediately without blocking background work. Active work keeps going, and you can inspect subagents with subagent({ action: \\\"status\\\" }) or rely on completion notifications.\");\n\t}\n\tif (!deps.state.currentSessionId) {\n\t\treturn result(\"subagent_wait requires an active session identity to scope background work safely.\", true);\n\t}\n\n\tconst now = deps.now ?? Date.now;\n\tconst pollIntervalMs = Math.max(MIN_POLL_INTERVAL_MS, deps.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);\n\tconst timeoutMs = params.timeoutMs !== undefined && params.timeoutMs > 0 ? params.timeoutMs : DEFAULT_TIMEOUT_MS;\n\tconst startedAt = now();\n\tif (params.questionId?.trim()) {\n\t\treturn waitForSupervisorQuestion(params.questionId.trim(), signal, deps, startedAt, now, pollIntervalMs, timeoutMs);\n\t}\n\tconst waitForAll = params.id ? true : params.all === true;\n\n\tlet active: AsyncRunSummary[];\n\tlet foreground: ForegroundResumeRun[];\n\tlet providerSnapshot: BackgroundWorkSnapshot;\n\ttry {\n\t\tactive = activeRunsForSession(params, deps);\n\t\tforeground = activeDetachedForegroundRuns(params, deps);\n\t\tproviderSnapshot = params.id ? { providers: [], items: [] } : backgroundWorkForSession(deps, startedAt);\n\t} catch (error) {\n\t\treturn result(error instanceof Error ? error.message : String(error), true);\n\t}\n\n\tif (params.id) {\n\t\tconst candidates = [\n\t\t\t...active.map((run) => ({ kind: \"async\" as const, id: run.id, run })),\n\t\t\t...foreground.map((run) => ({ kind: \"foreground\" as const, id: run.runId, run })),\n\t\t];\n\t\tconst exact = candidates.filter((candidate) => candidate.id === params.id);\n\t\tconst matches = exact.length > 0 ? exact : candidates;\n\t\tif (matches.length > 1) {\n\t\t\treturn result(`Ambiguous subagent run id prefix \"${params.id}\" matched ${matches.length} active runs: ${matches.map((candidate) => candidate.id).join(\", \")}. Pass a longer id.`, true);\n\t\t}\n\t\tconst selected = matches[0];\n\t\tif (selected?.kind === \"foreground\") {\n\t\t\treturn waitForDetachedForegroundRun(selected.run, signal, deps, startedAt, now, pollIntervalMs, timeoutMs);\n\t\t}\n\t\tactive = selected?.kind === \"async\" ? [selected.run] : [];\n\t}\n\n\tlet providerActive = providerSnapshot.items;\n\tif (active.length === 0 && providerActive.length === 0) {\n\t\treturn result(params.id\n\t\t\t? `No active run matched \"${params.id}\". Nothing to wait for.`\n\t\t\t: \"No active async runs or registered provider work in this session. Nothing to wait for.\");\n\t}\n\tconst waitParams = params.id ? { ...params, id: active[0]!.id } : params;\n\tconst initialAsyncIds = new Set(active.map((run) => run.id));\n\tconst initialProviderIds = new Set(providerActive.map(backgroundWorkIdentity));\n\tconst initialProviderNames = new Set(providerActive.map((item) => item.provider));\n\tconst initialCount = initialAsyncIds.size + initialProviderIds.size;\n\tconst stopOnAttention = deps.stopOnAttention !== false;\n\tlet attention = active.filter((run) => needsAttention(run, deps.state.currentSessionId));\n\n\tconst isDone = (): boolean => {\n\t\tif (stopOnAttention && attention.some((run) => initialAsyncIds.has(run.id))) return true;\n\t\tconst activeAsyncIds = new Set(active.map((run) => run.id));\n\t\tconst activeProviderIds = new Set(providerActive.map(backgroundWorkIdentity));\n\t\tif (waitForAll) {\n\t\t\treturn [...initialAsyncIds].every((id) => !activeAsyncIds.has(id))\n\t\t\t\t&& [...initialProviderIds].every((id) => !activeProviderIds.has(id));\n\t\t}\n\t\treturn [...initialAsyncIds].some((id) => !activeAsyncIds.has(id))\n\t\t\t\|\| [...initialProviderIds].some((id) => !activeProviderIds.has(id));\n\t};\n\n\twhile (!isDone()) {\n\t\tconst activeInitialRuns = active.filter((run) => initialAsyncIds.has(run.id));\n\t\tconst activeInitialProviderItems = providerActive.filter((item) => initialProviderIds.has(backgroundWorkIdentity(item)));\n\t\tconst stillActive = [\n\t\t\t...activeInitialRuns.map((run) => `${run.id} (${run.state})`),\n\t\t\t...activeInitialProviderItems.map((item) => `${item.provider}/${item.id}`),\n\t\t].join(\", \");\n\t\tif (signal?.aborted) {\n\t\t\treturn result(`Wait aborted after ${formatDuration(now() - startedAt)}. Still active: ${stillActive}.`, true);\n\t\t}\n\t\tif (now() - startedAt >= timeoutMs) {\n\t\t\treturn result(\n\t\t\t\t`Wait timed out after ${formatDuration(timeoutMs)} with ${activeInitialRuns.length} async run(s) and ${activeInitialProviderItems.length} provider item(s) still active: ${stillActive}. The work keeps going; call subagent_wait again or inspect subagent status.`,\n\t\t\t\ttrue,\n\t\t\t);\n\t\t}\n\t\ttry {\n\t\t\tawait waitForWake(pollIntervalMs, signal, deps);\n\t\t\tactive = activeRunsForSession(waitParams, deps);\n\t\t\tattention = attentionRunsForSession(waitParams, deps, initialAsyncIds);\n\t\t\tproviderSnapshot = params.id ? providerSnapshot : backgroundWorkForSession(deps, now());\n\t\t\tfor (const provider of initialProviderNames) {\n\t\t\t\tif (!providerSnapshot.providers.includes(provider)) {\n\t\t\t\t\treturn result(`Background-work provider '${provider}' disappeared while subagent_wait was tracking its active work; completion cannot be confirmed.`, true);\n\t\t\t\t}\n\t\t\t}\n\t\t\tproviderActive = providerSnapshot.items;\n\t\t} catch (error) {\n\t\t\treturn result(error instanceof Error ? error.message : String(error), true);\n\t\t}\n\t}\n\n\tlet terminalSummary: string;\n\tlet finishedAsyncCount: number;\n\tlet failedAsyncCount: number;\n\tconst activeProviderIds = new Set(providerActive.map(backgroundWorkIdentity));\n\tconst providerFinishedCount = [...initialProviderIds].filter((id) => !activeProviderIds.has(id)).length;\n\ttry {\n\t\tconst allNow = allRunsForSession(waitParams, deps);\n\t\tconst terminal = allNow.filter((run) => !ACTIVE_STATES.includes(run.state) && initialAsyncIds.has(run.id));\n\t\tfinishedAsyncCount = terminal.length;\n\t\tfailedAsyncCount = terminal.filter((run) => run.state === \"failed\").length;\n\t\tterminalSummary = summarizeTerminalRuns(terminal, providerFinishedCount);\n\t} catch (error) {\n\t\treturn result(error instanceof Error ? error.message : String(error), true);\n\t}\n\n\tconst relevantAttention = attention.filter((run) => initialAsyncIds.has(run.id));\n\tconst attentionNote = relevantAttention.length > 0\n\t\t? ` ${relevantAttention.length} run(s) need attention: ${relevantAttention.map((run) => run.id).join(\", \")} — inspect with subagent({ action: \"status\" }) then nudge/resume/interrupt.`\n\t\t: \"\";\n\tconst stillRunning = active.filter((run) => initialAsyncIds.has(run.id)).length\n\t\t+ providerActive.filter((item) => initialProviderIds.has(backgroundWorkIdentity(item))).length;\n\tconst elapsed = formatDuration(now() - startedAt);\n\tconst outcome = terminalSummary ? ` Outcome: ${terminalSummary}.` : \"\";\n\n\tif (waitForAll) {\n\t\tconst scope = params.id\n\t\t\t? `run \"${params.id}\"`\n\t\t\t: initialProviderIds.size === 0\n\t\t\t\t? `${initialAsyncIds.size} async run(s)`\n\t\t\t\t: `${initialAsyncIds.size} async run(s) and ${initialProviderIds.size} provider item(s)`;\n\t\tconst status = relevantAttention.length > 0 ? \"attention required\" : \"done\";\n\t\treturn result(\n\t\t\t`Waited ${elapsed} for ${scope}; ${status}.${outcome}${attentionNote} Completion/control events have been observed; inspect status if a notification is not visible yet.`,\n\t\t\tdeps.failOnFailedRuns === true && failedAsyncCount > 0,\n\t\t);\n\t}\n\n\tconst finishedCount = finishedAsyncCount + providerFinishedCount;\n\tconst subject = initialProviderIds.size === 0 ? \"run(s)\" : \"item(s)\";\n\tconst remainder = stillRunning > 0\n\t\t? ` ${stillRunning} ${subject} still in flight — call subagent_wait again to catch the next one.`\n\t\t: relevantAttention.length > 0\n\t\t\t? \" No other work is waitable until attention is handled.\"\n\t\t\t: initialProviderIds.size === 0 ? \" No runs remain in flight.\" : \" No work remains in flight.\";\n\tconst progress = relevantAttention.length > 0 && finishedCount === 0\n\t\t? `${relevantAttention.length} of ${initialCount} ${subject} need attention`\n\t\t: `${finishedCount} of ${initialCount} ${subject} finished`;\n\treturn result(\n\t\t`Waited ${elapsed}; ${progress}.${outcome}${attentionNote}${remainder} Relevant completion/control events have been observed; inspect status if a notification is not visible yet.`,\n\t\tdeps.failOnFailedRuns === true && failedAsyncCount > 0,\n\t);\n}\n"]}