@xzzpig/pi-subagents 0.22.0 → 0.24.1

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 (1138) hide show
  1. package/CHANGELOG.md +355 -0
  2. package/README.md +2 -2
  3. package/agents/evidence-auditor.md +1 -0
  4. package/agents/oracle.md +1 -0
  5. package/agents/reviewer.md +1 -0
  6. package/bundle/agent-management.js +16 -0
  7. package/bundle/agents.js +41 -0
  8. package/bundle/background-work.js +16 -0
  9. package/bundle/capability-ceiling.js +22 -0
  10. package/bundle/child-tool-plan.js +11 -0
  11. package/bundle/chunk-355ECEP2.js +1321 -0
  12. package/bundle/chunk-35GII5EF.js +637 -0
  13. package/bundle/chunk-3U633XDZ.js +749 -0
  14. package/bundle/chunk-4QFZZV3O.js +57 -0
  15. package/bundle/chunk-62OCY2S4.js +14 -0
  16. package/bundle/chunk-6BJUEES3.js +276 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-BGIYHF2W.js +138 -0
  19. package/bundle/chunk-CTPAE36Y.js +94 -0
  20. package/bundle/chunk-D4EHT5SJ.js +14 -0
  21. package/bundle/chunk-ED55MIC2.js +1681 -0
  22. package/bundle/chunk-EUPJB4S7.js +5503 -0
  23. package/bundle/chunk-FG6SQJAR.js +940 -0
  24. package/bundle/chunk-FJWI64H7.js +490 -0
  25. package/bundle/chunk-H36HBZB2.js +753 -0
  26. package/bundle/chunk-ICNYIALB.js +7347 -0
  27. package/bundle/chunk-JEA2ZKUA.js +1372 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LMGQAJ3O.js +9872 -0
  30. package/bundle/chunk-LVWU2HOO.js +1234 -0
  31. package/bundle/chunk-NIXWDZZV.js +9 -0
  32. package/bundle/chunk-QXASAHIA.js +173 -0
  33. package/bundle/chunk-RB4GELQA.js +458 -0
  34. package/bundle/chunk-RU522D5W.js +1768 -0
  35. package/bundle/chunk-SLNMBXLL.js +7336 -0
  36. package/bundle/chunk-SW2VMNIU.js +526 -0
  37. package/bundle/chunk-TGLFTQWJ.js +143 -0
  38. package/bundle/chunk-TMHVDPYW.js +4132 -0
  39. package/bundle/chunk-U4ODUYAG.js +235 -0
  40. package/bundle/chunk-UKG4V45O.js +228 -0
  41. package/bundle/chunk-UQDHXMUG.js +264 -0
  42. package/bundle/chunk-V2KFIGFH.js +8774 -0
  43. package/bundle/chunk-VO3G7HI3.js +85 -0
  44. package/bundle/chunk-WPW4V6HM.js +227 -0
  45. package/bundle/chunk-WW76JRIX.js +175 -0
  46. package/bundle/chunk-X6LOM3Z4.js +4175 -0
  47. package/bundle/chunk-XA3DY6UG.js +161 -0
  48. package/bundle/chunk-Y6H2G6KX.js +1310 -0
  49. package/bundle/chunk-YFCK7H2S.js +129 -0
  50. package/bundle/chunk-YYREO77V.js +137 -0
  51. package/bundle/chunk-Z6TFJ6BR.js +400 -0
  52. package/bundle/chunk-ZWXU5SPQ.js +16932 -0
  53. package/bundle/control-channel.js +11 -0
  54. package/bundle/delegation.js +14 -0
  55. package/bundle/external-job-provider.js +20 -0
  56. package/bundle/external-runs.js +21 -0
  57. package/bundle/index.js +30 -0
  58. package/bundle/inspectors.js +8 -0
  59. package/bundle/intercom-bridge.js +11 -0
  60. package/bundle/preflight.js +468 -0
  61. package/bundle/project-panes.js +28 -0
  62. package/bundle/required-child-extensions.js +6 -0
  63. package/bundle/shared-types.js +8 -0
  64. package/bundle/supervisor-routing.js +12 -0
  65. package/bundle/workflow-resources.js +7 -0
  66. package/docs/agents.md +42 -10
  67. package/docs/configuration.md +59 -14
  68. package/docs/extension-api.md +61 -9
  69. package/docs/goal-auto-continuation-gate.md +26 -0
  70. package/docs/missions.md +2 -0
  71. package/docs/observability.md +20 -5
  72. package/docs/standalone-background.md +8 -6
  73. package/docs/tool-reference.md +18 -5
  74. package/docs/workflows.md +25 -7
  75. package/index.d.ts +3 -0
  76. package/index.js +14 -0
  77. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  78. package/package.json +107 -87
  79. package/skills/council-mode/SKILL.md +1 -4
  80. package/skills/pi-subagents/SKILL.md +130 -106
  81. package/skills/pi-subagents/references/orchestration.md +124 -0
  82. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  83. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  84. package/src/agents/advertised-agent-prompt.js +68 -0
  85. package/src/agents/agent-eject.d.ts +39 -0
  86. package/src/agents/agent-eject.js +263 -0
  87. package/src/agents/agent-management.d.ts +33 -0
  88. package/src/agents/agent-management.js +1541 -0
  89. package/src/agents/agent-memory.d.ts +48 -0
  90. package/src/agents/agent-memory.js +350 -0
  91. package/src/agents/agent-refinements.d.ts +99 -0
  92. package/src/agents/agent-refinements.js +568 -0
  93. package/src/agents/agent-scope.d.ts +3 -0
  94. package/src/agents/agent-scope.js +8 -0
  95. package/src/agents/agent-selection.d.ts +2 -0
  96. package/src/agents/agent-selection.js +22 -0
  97. package/src/agents/agent-serializer.d.ts +7 -0
  98. package/src/agents/agent-serializer.js +213 -0
  99. package/src/agents/agents.d.ts +352 -0
  100. package/src/agents/agents.js +2817 -0
  101. package/src/agents/builtin-names.d.ts +1 -0
  102. package/src/agents/builtin-names.js +16 -0
  103. package/src/agents/chain-serializer.d.ts +6 -0
  104. package/src/agents/chain-serializer.js +318 -0
  105. package/src/agents/frontmatter.d.ts +19 -0
  106. package/src/agents/frontmatter.js +166 -0
  107. package/src/agents/global-npm-root.d.ts +6 -0
  108. package/src/agents/global-npm-root.js +57 -0
  109. package/src/agents/identity.d.ts +7 -0
  110. package/src/agents/identity.js +29 -0
  111. package/src/agents/proactive-skills.d.ts +35 -0
  112. package/src/agents/proactive-skills.js +155 -0
  113. package/src/agents/runtime-agent-events.d.ts +26 -0
  114. package/src/agents/runtime-agent-events.js +52 -0
  115. package/src/agents/runtime-agent-registry.d.ts +66 -0
  116. package/src/agents/runtime-agent-registry.js +415 -0
  117. package/src/agents/runtime-discovery.d.ts +13 -0
  118. package/src/agents/runtime-discovery.js +27 -0
  119. package/src/agents/skills.d.ts +34 -0
  120. package/src/agents/skills.js +718 -0
  121. package/src/api/agent-management.d.ts +2 -0
  122. package/src/api/agent-management.js +2 -0
  123. package/src/api/agents.d.ts +6 -0
  124. package/src/api/agents.js +3 -0
  125. package/src/api/background-work.d.ts +41 -0
  126. package/src/api/background-work.js +171 -0
  127. package/src/api/capability-ceiling.d.ts +1 -0
  128. package/src/api/capability-ceiling.js +1 -0
  129. package/src/api/child-tool-plan.d.ts +1 -0
  130. package/src/api/child-tool-plan.js +1 -0
  131. package/src/api/control-channel.d.ts +1 -0
  132. package/src/api/control-channel.js +1 -0
  133. package/src/api/delegation.d.ts +132 -0
  134. package/src/api/delegation.js +8 -0
  135. package/src/api/external-job-provider.d.ts +57 -0
  136. package/src/api/external-job-provider.js +139 -0
  137. package/src/api/external-runs.d.ts +47 -0
  138. package/src/api/external-runs.js +245 -0
  139. package/src/api/inspectors.d.ts +20 -0
  140. package/src/api/inspectors.js +11 -0
  141. package/src/api/intercom-bridge.d.ts +1 -0
  142. package/src/api/intercom-bridge.js +1 -0
  143. package/src/api/preflight.d.ts +183 -0
  144. package/src/api/preflight.js +455 -0
  145. package/src/api/project-panes.d.ts +7 -0
  146. package/src/api/project-panes.js +7 -0
  147. package/src/api/required-child-extensions.d.ts +1 -0
  148. package/src/api/required-child-extensions.js +1 -0
  149. package/src/api/shared-types.d.ts +1 -0
  150. package/src/api/shared-types.js +1 -0
  151. package/src/api/supervisor-routing.d.ts +110 -0
  152. package/src/api/supervisor-routing.js +95 -0
  153. package/src/api/workflow-resources.d.ts +2 -0
  154. package/src/api/workflow-resources.js +1 -0
  155. package/src/extension/active-runs-prompt.d.ts +7 -0
  156. package/src/extension/active-runs-prompt.js +29 -0
  157. package/src/extension/config.d.ts +7 -0
  158. package/src/extension/config.js +290 -0
  159. package/src/extension/context-injection.d.ts +52 -0
  160. package/src/extension/context-injection.js +102 -0
  161. package/src/extension/control-notices.d.ts +18 -0
  162. package/src/extension/control-notices.js +29 -0
  163. package/src/extension/declaration-pinning.d.ts +18 -0
  164. package/src/extension/declaration-pinning.js +167 -0
  165. package/src/extension/doctor.d.ts +34 -0
  166. package/src/extension/doctor.js +236 -0
  167. package/src/extension/fanout-child.d.ts +6 -0
  168. package/src/extension/fanout-child.js +278 -0
  169. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  170. package/src/extension/herdr-pi-bridge.js +261 -0
  171. package/src/extension/index.d.ts +18 -0
  172. package/src/extension/index.js +1300 -0
  173. package/src/extension/public-execution.d.ts +71 -0
  174. package/src/extension/public-execution.js +214 -0
  175. package/src/extension/reply-workflow-script.d.ts +11 -0
  176. package/src/extension/reply-workflow-script.js +71 -0
  177. package/src/extension/rpc.d.ts +84 -0
  178. package/src/extension/rpc.js +729 -0
  179. package/src/extension/schemas.d.ts +276 -0
  180. package/src/extension/schemas.js +311 -0
  181. package/src/extension/steering-notices.d.ts +14 -0
  182. package/src/extension/steering-notices.js +22 -0
  183. package/src/extension/subagent-guide.d.ts +4 -0
  184. package/src/extension/subagent-guide.js +114 -0
  185. package/src/extension/subagent-options.d.ts +7 -0
  186. package/src/extension/subagent-options.js +64 -0
  187. package/src/extension/tool-activation.d.ts +7 -0
  188. package/src/extension/tool-activation.js +185 -0
  189. package/src/extension/tool-description.d.ts +19 -0
  190. package/src/extension/tool-description.js +169 -0
  191. package/src/extension/tool-result.d.ts +9 -0
  192. package/src/extension/tool-result.js +16 -0
  193. package/src/extension/upgrade-notice.d.ts +6 -0
  194. package/src/extension/upgrade-notice.js +42 -0
  195. package/src/goal-auto-continue-gate.d.ts +17 -0
  196. package/src/goal-auto-continue-gate.js +61 -0
  197. package/src/goal-auto-continue-state.d.ts +22 -0
  198. package/src/goal-auto-continue-state.js +20 -0
  199. package/src/inspectors/actions.d.ts +24 -0
  200. package/src/inspectors/actions.js +182 -0
  201. package/src/inspectors/ghostty/actions.d.ts +11 -0
  202. package/src/inspectors/ghostty/actions.js +62 -0
  203. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  204. package/src/inspectors/ghostty/plugin.js +23 -0
  205. package/src/inspectors/herdr/actions.d.ts +25 -0
  206. package/src/inspectors/herdr/actions.js +133 -0
  207. package/src/inspectors/herdr/client.d.ts +41 -0
  208. package/src/inspectors/herdr/client.js +129 -0
  209. package/src/inspectors/herdr/focus.d.ts +24 -0
  210. package/src/inspectors/herdr/focus.js +49 -0
  211. package/src/inspectors/herdr/plugin.d.ts +6 -0
  212. package/src/inspectors/herdr/plugin.js +14 -0
  213. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  214. package/src/inspectors/herdr/project-panes.js +610 -0
  215. package/src/inspectors/inspector-runner.d.ts +23 -0
  216. package/src/inspectors/inspector-runner.js +161 -0
  217. package/src/inspectors/plugins.d.ts +8 -0
  218. package/src/inspectors/plugins.js +82 -0
  219. package/src/inspectors/session-roots-codec.d.ts +15 -0
  220. package/src/inspectors/session-roots-codec.js +32 -0
  221. package/src/inspectors/shell-command.d.ts +1 -0
  222. package/src/inspectors/shell-command.js +16 -0
  223. package/src/inspectors/tmux/actions.d.ts +25 -0
  224. package/src/inspectors/tmux/actions.js +181 -0
  225. package/src/inspectors/tmux/client.d.ts +27 -0
  226. package/src/inspectors/tmux/client.js +64 -0
  227. package/src/inspectors/tmux/plugin.d.ts +7 -0
  228. package/src/inspectors/tmux/plugin.js +14 -0
  229. package/src/inspectors/types.d.ts +48 -0
  230. package/src/inspectors/types.js +1 -0
  231. package/src/integrations/herdr-status.d.ts +47 -0
  232. package/src/integrations/herdr-status.js +350 -0
  233. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  234. package/src/integrations/pi-web-session-liveness.js +53 -0
  235. package/src/integrations/program-status.d.ts +30 -0
  236. package/src/integrations/program-status.js +188 -0
  237. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  238. package/src/intercom/fork-supervisor-routing.js +392 -0
  239. package/src/intercom/intercom-bridge.d.ts +58 -0
  240. package/src/intercom/intercom-bridge.js +193 -0
  241. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  242. package/src/intercom/native-supervisor-channel.js +1184 -0
  243. package/src/intercom/result-intercom.d.ts +35 -0
  244. package/src/intercom/result-intercom.js +376 -0
  245. package/src/intercom/supervisor-ui.d.ts +29 -0
  246. package/src/intercom/supervisor-ui.js +49 -0
  247. package/src/missions/actions.d.ts +54 -0
  248. package/src/missions/actions.js +400 -0
  249. package/src/missions/goal-driver.d.ts +16 -0
  250. package/src/missions/goal-driver.js +171 -0
  251. package/src/missions/lifecycle.d.ts +50 -0
  252. package/src/missions/lifecycle.js +388 -0
  253. package/src/missions/store.d.ts +21 -0
  254. package/src/missions/store.js +605 -0
  255. package/src/missions/types.d.ts +169 -0
  256. package/src/missions/types.js +9 -0
  257. package/src/missions/workflow-state.d.ts +14 -0
  258. package/src/missions/workflow-state.js +273 -0
  259. package/src/policy/authority.d.ts +9 -0
  260. package/src/policy/authority.js +41 -0
  261. package/src/profiles/profiles.d.ts +134 -0
  262. package/src/profiles/profiles.js +526 -0
  263. package/src/runs/background/active-async-capacity.d.ts +115 -0
  264. package/src/runs/background/active-async-capacity.js +517 -0
  265. package/src/runs/background/active-run-index.d.ts +12 -0
  266. package/src/runs/background/active-run-index.js +157 -0
  267. package/src/runs/background/async-execution.d.ts +306 -0
  268. package/src/runs/background/async-execution.js +2210 -0
  269. package/src/runs/background/async-job-tracker.d.ts +37 -0
  270. package/src/runs/background/async-job-tracker.js +926 -0
  271. package/src/runs/background/async-resume.d.ts +60 -0
  272. package/src/runs/background/async-resume.js +707 -0
  273. package/src/runs/background/async-retention.d.ts +45 -0
  274. package/src/runs/background/async-retention.js +932 -0
  275. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  276. package/src/runs/background/async-status-snapshot.js +26 -0
  277. package/src/runs/background/async-status.d.ts +179 -0
  278. package/src/runs/background/async-status.js +712 -0
  279. package/src/runs/background/auto-drain.d.ts +16 -0
  280. package/src/runs/background/auto-drain.js +71 -0
  281. package/src/runs/background/await-async-run.d.ts +26 -0
  282. package/src/runs/background/await-async-run.js +83 -0
  283. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  284. package/src/runs/background/binary-bootstrap.js +69 -0
  285. package/src/runs/background/boot-id.d.ts +12 -0
  286. package/src/runs/background/boot-id.js +47 -0
  287. package/src/runs/background/calendar-schedule.d.ts +26 -0
  288. package/src/runs/background/calendar-schedule.js +93 -0
  289. package/src/runs/background/chain-append.d.ts +34 -0
  290. package/src/runs/background/chain-append.js +299 -0
  291. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  292. package/src/runs/background/chain-root-attachment.js +186 -0
  293. package/src/runs/background/completion-batcher.d.ts +51 -0
  294. package/src/runs/background/completion-batcher.js +119 -0
  295. package/src/runs/background/completion-dedupe.d.ts +13 -0
  296. package/src/runs/background/completion-dedupe.js +48 -0
  297. package/src/runs/background/completion-replay.d.ts +47 -0
  298. package/src/runs/background/completion-replay.js +266 -0
  299. package/src/runs/background/control-channel.d.ts +170 -0
  300. package/src/runs/background/control-channel.js +610 -0
  301. package/src/runs/background/fleet-view.d.ts +63 -0
  302. package/src/runs/background/fleet-view.js +666 -0
  303. package/src/runs/background/index-segment.d.ts +16 -0
  304. package/src/runs/background/index-segment.js +58 -0
  305. package/src/runs/background/inspect-rpc.d.ts +64 -0
  306. package/src/runs/background/inspect-rpc.js +422 -0
  307. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  308. package/src/runs/background/interrupted-elsewhere.js +68 -0
  309. package/src/runs/background/notify.d.ts +216 -0
  310. package/src/runs/background/notify.js +1006 -0
  311. package/src/runs/background/owned-process-tree.d.ts +10 -0
  312. package/src/runs/background/owned-process-tree.js +116 -0
  313. package/src/runs/background/parallel-groups.d.ts +3 -0
  314. package/src/runs/background/parallel-groups.js +46 -0
  315. package/src/runs/background/pid-namespace.d.ts +2 -0
  316. package/src/runs/background/pid-namespace.js +19 -0
  317. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  318. package/src/runs/background/process-terminal-candidate.js +96 -0
  319. package/src/runs/background/process-terminal.d.ts +21 -0
  320. package/src/runs/background/process-terminal.js +227 -0
  321. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  322. package/src/runs/background/result-delivery-ownership.js +38 -0
  323. package/src/runs/background/result-files.d.ts +63 -0
  324. package/src/runs/background/result-files.js +629 -0
  325. package/src/runs/background/result-watcher.d.ts +92 -0
  326. package/src/runs/background/result-watcher.js +819 -0
  327. package/src/runs/background/resume-guidance.d.ts +4 -0
  328. package/src/runs/background/resume-guidance.js +57 -0
  329. package/src/runs/background/retained-children.d.ts +24 -0
  330. package/src/runs/background/retained-children.js +128 -0
  331. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  332. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  333. package/src/runs/background/run-child-session.d.ts +123 -0
  334. package/src/runs/background/run-child-session.js +670 -0
  335. package/src/runs/background/run-id-query.d.ts +3 -0
  336. package/src/runs/background/run-id-query.js +6 -0
  337. package/src/runs/background/run-id-resolver.d.ts +22 -0
  338. package/src/runs/background/run-id-resolver.js +172 -0
  339. package/src/runs/background/run-status.d.ts +25 -0
  340. package/src/runs/background/run-status.js +850 -0
  341. package/src/runs/background/runner-aliases.d.ts +17 -0
  342. package/src/runs/background/runner-aliases.js +191 -0
  343. package/src/runs/background/runner-child-launch.d.ts +24 -0
  344. package/src/runs/background/runner-child-launch.js +72 -0
  345. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  346. package/src/runs/background/runner-child-sessions.js +34 -0
  347. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  348. package/src/runs/background/runner-http-dispatcher.js +115 -0
  349. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  350. package/src/runs/background/runner-startup-failure.js +46 -0
  351. package/src/runs/background/scheduled-runs.d.ts +127 -0
  352. package/src/runs/background/scheduled-runs.js +1265 -0
  353. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  354. package/src/runs/background/stale-run-reconciler.js +509 -0
  355. package/src/runs/background/steering.d.ts +51 -0
  356. package/src/runs/background/steering.js +246 -0
  357. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  358. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  359. package/src/runs/background/subagent-runner.d.ts +210 -0
  360. package/src/runs/background/subagent-runner.js +4963 -0
  361. package/src/runs/background/subagent-wait.d.ts +124 -0
  362. package/src/runs/background/subagent-wait.js +756 -0
  363. package/src/runs/background/terminal-run-index.d.ts +10 -0
  364. package/src/runs/background/terminal-run-index.js +209 -0
  365. package/src/runs/background/top-level-async.d.ts +7 -0
  366. package/src/runs/background/top-level-async.js +5 -0
  367. package/src/runs/background/wait-completions.d.ts +28 -0
  368. package/src/runs/background/wait-completions.js +264 -0
  369. package/src/runs/background/wait-config.d.ts +8 -0
  370. package/src/runs/background/wait-config.js +46 -0
  371. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  372. package/src/runs/background/wait-subscriptions.js +339 -0
  373. package/src/runs/background/wait-tool.d.ts +6 -0
  374. package/src/runs/background/wait-tool.js +48 -0
  375. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  376. package/src/runs/background/workflow-terminal-proof.js +116 -0
  377. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  378. package/src/runs/foreground/async-dismiss-action.js +82 -0
  379. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  380. package/src/runs/foreground/async-steering-action.js +294 -0
  381. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  382. package/src/runs/foreground/async-stop-action.js +213 -0
  383. package/src/runs/foreground/command-action.d.ts +12 -0
  384. package/src/runs/foreground/command-action.js +38 -0
  385. package/src/runs/foreground/execution.d.ts +10 -0
  386. package/src/runs/foreground/execution.js +2322 -0
  387. package/src/runs/foreground/foreground-control.d.ts +24 -0
  388. package/src/runs/foreground/foreground-control.js +138 -0
  389. package/src/runs/foreground/foreground-history.d.ts +25 -0
  390. package/src/runs/foreground/foreground-history.js +267 -0
  391. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  392. package/src/runs/foreground/prompt-audit.js +138 -0
  393. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  394. package/src/runs/foreground/subagent-executor.js +7990 -0
  395. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  396. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  397. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  398. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  399. package/src/runs/shared/abort-recovery.d.ts +26 -0
  400. package/src/runs/shared/abort-recovery.js +108 -0
  401. package/src/runs/shared/acceptance.d.ts +144 -0
  402. package/src/runs/shared/acceptance.js +1616 -0
  403. package/src/runs/shared/agent-contract.d.ts +5 -0
  404. package/src/runs/shared/agent-contract.js +35 -0
  405. package/src/runs/shared/async-status-projection.d.ts +100 -0
  406. package/src/runs/shared/async-status-projection.js +566 -0
  407. package/src/runs/shared/background-process-options.d.ts +4 -0
  408. package/src/runs/shared/background-process-options.js +6 -0
  409. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  410. package/src/runs/shared/capability-ceiling.js +179 -0
  411. package/src/runs/shared/chain-outputs.d.ts +18 -0
  412. package/src/runs/shared/chain-outputs.js +104 -0
  413. package/src/runs/shared/child-commands.d.ts +29 -0
  414. package/src/runs/shared/child-commands.js +254 -0
  415. package/src/runs/shared/child-hooks.d.ts +31 -0
  416. package/src/runs/shared/child-hooks.js +173 -0
  417. package/src/runs/shared/child-identity.d.ts +23 -0
  418. package/src/runs/shared/child-identity.js +40 -0
  419. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  420. package/src/runs/shared/child-launch-plan.js +88 -0
  421. package/src/runs/shared/child-launch.d.ts +128 -0
  422. package/src/runs/shared/child-launch.js +262 -0
  423. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  424. package/src/runs/shared/child-lifecycle.js +22 -0
  425. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  426. package/src/runs/shared/child-runtime-config.js +44 -0
  427. package/src/runs/shared/child-session.d.ts +178 -0
  428. package/src/runs/shared/child-session.js +726 -0
  429. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  430. package/src/runs/shared/child-tool-plan.js +430 -0
  431. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  432. package/src/runs/shared/claude-code-adapter.js +255 -0
  433. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  434. package/src/runs/shared/codex-exec-adapter.js +127 -0
  435. package/src/runs/shared/context-mode.d.ts +12 -0
  436. package/src/runs/shared/context-mode.js +38 -0
  437. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  438. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  439. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  440. package/src/runs/shared/dynamic-fanout.js +273 -0
  441. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  442. package/src/runs/shared/effective-system-prompt.js +23 -0
  443. package/src/runs/shared/extension-bindings.d.ts +25 -0
  444. package/src/runs/shared/extension-bindings.js +96 -0
  445. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  446. package/src/runs/shared/external-cli-contract.js +145 -0
  447. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  448. package/src/runs/shared/external-cli-preflight.js +159 -0
  449. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  450. package/src/runs/shared/external-cli-runner.js +425 -0
  451. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  452. package/src/runs/shared/external-job-bridge.js +486 -0
  453. package/src/runs/shared/external-job-runner.d.ts +44 -0
  454. package/src/runs/shared/external-job-runner.js +352 -0
  455. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  456. package/src/runs/shared/fast-mode-extension.js +8 -0
  457. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  458. package/src/runs/shared/fork-placed-env.js +13 -0
  459. package/src/runs/shared/git-environment.d.ts +2 -0
  460. package/src/runs/shared/git-environment.js +27 -0
  461. package/src/runs/shared/herdr-connection.d.ts +79 -0
  462. package/src/runs/shared/herdr-connection.js +269 -0
  463. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  464. package/src/runs/shared/herdr-external-adapters.js +404 -0
  465. package/src/runs/shared/herdr-machine.d.ts +59 -0
  466. package/src/runs/shared/herdr-machine.js +294 -0
  467. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  468. package/src/runs/shared/herdr-pane-host.js +155 -0
  469. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  470. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  471. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  472. package/src/runs/shared/herdr-placed-run.js +380 -0
  473. package/src/runs/shared/host-step-status.d.ts +33 -0
  474. package/src/runs/shared/host-step-status.js +244 -0
  475. package/src/runs/shared/lane-metadata.d.ts +23 -0
  476. package/src/runs/shared/lane-metadata.js +126 -0
  477. package/src/runs/shared/launch-cwd.d.ts +1 -0
  478. package/src/runs/shared/launch-cwd.js +16 -0
  479. package/src/runs/shared/local-machine-access.d.ts +5 -0
  480. package/src/runs/shared/local-machine-access.js +28 -0
  481. package/src/runs/shared/long-running-guard.d.ts +34 -0
  482. package/src/runs/shared/long-running-guard.js +256 -0
  483. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  484. package/src/runs/shared/mcp-config-sources.js +418 -0
  485. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  486. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  487. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  488. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  489. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  490. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  491. package/src/runs/shared/model-resolution.d.ts +109 -0
  492. package/src/runs/shared/model-resolution.js +411 -0
  493. package/src/runs/shared/model-scope.d.ts +68 -0
  494. package/src/runs/shared/model-scope.js +171 -0
  495. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  496. package/src/runs/shared/mutation-evidence.js +198 -0
  497. package/src/runs/shared/nested-events.d.ts +135 -0
  498. package/src/runs/shared/nested-events.js +1090 -0
  499. package/src/runs/shared/nested-path.d.ts +8 -0
  500. package/src/runs/shared/nested-path.js +34 -0
  501. package/src/runs/shared/nested-render.d.ts +20 -0
  502. package/src/runs/shared/nested-render.js +115 -0
  503. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  504. package/src/runs/shared/orca-progress-tabs.js +503 -0
  505. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  506. package/src/runs/shared/parallel-handoff.js +783 -0
  507. package/src/runs/shared/parallel-utils.d.ts +177 -0
  508. package/src/runs/shared/parallel-utils.js +125 -0
  509. package/src/runs/shared/partial-output.d.ts +24 -0
  510. package/src/runs/shared/partial-output.js +35 -0
  511. package/src/runs/shared/permissions.d.ts +12 -0
  512. package/src/runs/shared/permissions.js +92 -0
  513. package/src/runs/shared/pi-spawn.d.ts +31 -0
  514. package/src/runs/shared/pi-spawn.js +211 -0
  515. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  516. package/src/runs/shared/placed-run-owner.js +93 -0
  517. package/src/runs/shared/placement-host.d.ts +99 -0
  518. package/src/runs/shared/placement-host.js +157 -0
  519. package/src/runs/shared/process-signal.d.ts +15 -0
  520. package/src/runs/shared/process-signal.js +21 -0
  521. package/src/runs/shared/profile-extensions.d.ts +21 -0
  522. package/src/runs/shared/profile-extensions.js +122 -0
  523. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  524. package/src/runs/shared/profile-launch-env.js +90 -0
  525. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  526. package/src/runs/shared/readonly-drain-observation.js +50 -0
  527. package/src/runs/shared/rex-machine.d.ts +25 -0
  528. package/src/runs/shared/rex-machine.js +83 -0
  529. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  530. package/src/runs/shared/rex-pane-host.js +327 -0
  531. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  532. package/src/runs/shared/run-fanout-budget.js +258 -0
  533. package/src/runs/shared/run-ownership.d.ts +3 -0
  534. package/src/runs/shared/run-ownership.js +8 -0
  535. package/src/runs/shared/runner-launcher.d.ts +11 -0
  536. package/src/runs/shared/runner-launcher.js +24 -0
  537. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  538. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  539. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  540. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  541. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  542. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  543. package/src/runs/shared/session-lease.d.ts +69 -0
  544. package/src/runs/shared/session-lease.js +250 -0
  545. package/src/runs/shared/single-output.d.ts +90 -0
  546. package/src/runs/shared/single-output.js +349 -0
  547. package/src/runs/shared/spawn-budget.d.ts +20 -0
  548. package/src/runs/shared/spawn-budget.js +93 -0
  549. package/src/runs/shared/structured-output.d.ts +66 -0
  550. package/src/runs/shared/structured-output.js +483 -0
  551. package/src/runs/shared/subagent-control.d.ts +50 -0
  552. package/src/runs/shared/subagent-control.js +247 -0
  553. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  554. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  555. package/src/runs/shared/tool-availability.d.ts +16 -0
  556. package/src/runs/shared/tool-availability.js +29 -0
  557. package/src/runs/shared/tool-budget.d.ts +21 -0
  558. package/src/runs/shared/tool-budget.js +78 -0
  559. package/src/runs/shared/tool-timeout.d.ts +31 -0
  560. package/src/runs/shared/tool-timeout.js +73 -0
  561. package/src/runs/shared/usage-budget.d.ts +7 -0
  562. package/src/runs/shared/usage-budget.js +74 -0
  563. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  564. package/src/runs/shared/usage-reconciliation.js +71 -0
  565. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  566. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  567. package/src/runs/shared/workflow-graph.d.ts +31 -0
  568. package/src/runs/shared/workflow-graph.js +221 -0
  569. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  570. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  571. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  572. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  573. package/src/runs/shared/worktree-lock.d.ts +5 -0
  574. package/src/runs/shared/worktree-lock.js +40 -0
  575. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  576. package/src/runs/shared/worktree-setup-command.js +200 -0
  577. package/src/runs/shared/worktree.d.ts +181 -0
  578. package/src/runs/shared/worktree.js +1346 -0
  579. package/src/shared/accessible-dir.d.ts +11 -0
  580. package/src/shared/accessible-dir.js +39 -0
  581. package/src/shared/agent-stream-options.d.ts +5 -0
  582. package/src/shared/agent-stream-options.js +3 -0
  583. package/src/shared/artifacts.d.ts +22 -0
  584. package/src/shared/artifacts.js +272 -0
  585. package/src/shared/atomic-json.d.ts +19 -0
  586. package/src/shared/atomic-json.js +61 -0
  587. package/src/shared/capacity-resilient-json.d.ts +26 -0
  588. package/src/shared/capacity-resilient-json.js +86 -0
  589. package/src/shared/child-cache-retention.d.ts +29 -0
  590. package/src/shared/child-cache-retention.js +40 -0
  591. package/src/shared/child-session-name.d.ts +8 -0
  592. package/src/shared/child-session-name.js +40 -0
  593. package/src/shared/child-transcript.d.ts +37 -0
  594. package/src/shared/child-transcript.js +225 -0
  595. package/src/shared/completion-owner.d.ts +7 -0
  596. package/src/shared/completion-owner.js +13 -0
  597. package/src/shared/disabled-features.d.ts +93 -0
  598. package/src/shared/disabled-features.js +120 -0
  599. package/src/shared/display-text.d.ts +5 -0
  600. package/src/shared/display-text.js +154 -0
  601. package/src/shared/edit-distance.d.ts +4 -0
  602. package/src/shared/edit-distance.js +32 -0
  603. package/src/shared/extension-context.d.ts +21 -0
  604. package/src/shared/extension-context.js +39 -0
  605. package/src/shared/file-coalescer.d.ts +11 -0
  606. package/src/shared/file-coalescer.js +34 -0
  607. package/src/shared/file-lease.d.ts +10 -0
  608. package/src/shared/file-lease.js +106 -0
  609. package/src/shared/file-system-retry.d.ts +31 -0
  610. package/src/shared/file-system-retry.js +84 -0
  611. package/src/shared/fork-context.d.ts +64 -0
  612. package/src/shared/fork-context.js +185 -0
  613. package/src/shared/fork-session-cwd.d.ts +2 -0
  614. package/src/shared/fork-session-cwd.js +23 -0
  615. package/src/shared/formatters.d.ts +35 -0
  616. package/src/shared/formatters.js +137 -0
  617. package/src/shared/jsonl-writer.d.ts +20 -0
  618. package/src/shared/jsonl-writer.js +67 -0
  619. package/src/shared/launch-contract.d.ts +65 -0
  620. package/src/shared/launch-contract.js +145 -0
  621. package/src/shared/model-info.d.ts +55 -0
  622. package/src/shared/model-info.js +103 -0
  623. package/src/shared/model-response-aliases.d.ts +1 -0
  624. package/src/shared/model-response-aliases.js +15 -0
  625. package/src/shared/node-executable.d.ts +1 -0
  626. package/src/shared/node-executable.js +20 -0
  627. package/src/shared/opencode-session-headers.d.ts +12 -0
  628. package/src/shared/opencode-session-headers.js +26 -0
  629. package/src/shared/package-version.d.ts +2 -0
  630. package/src/shared/package-version.js +14 -0
  631. package/src/shared/parent-wake.d.ts +26 -0
  632. package/src/shared/parent-wake.js +68 -0
  633. package/src/shared/permission-profile.d.ts +26 -0
  634. package/src/shared/permission-profile.js +49 -0
  635. package/src/shared/prompt-resources.d.ts +5 -0
  636. package/src/shared/prompt-resources.js +10 -0
  637. package/src/shared/provider-diagnostics.d.ts +9 -0
  638. package/src/shared/provider-diagnostics.js +75 -0
  639. package/src/shared/pruned-fork.d.ts +34 -0
  640. package/src/shared/pruned-fork.js +434 -0
  641. package/src/shared/required-child-extensions.d.ts +34 -0
  642. package/src/shared/required-child-extensions.js +105 -0
  643. package/src/shared/runtime-module-path.d.ts +10 -0
  644. package/src/shared/runtime-module-path.js +16 -0
  645. package/src/shared/sandbox-profile.d.ts +12 -0
  646. package/src/shared/sandbox-profile.js +35 -0
  647. package/src/shared/session-file-trust.d.ts +1 -0
  648. package/src/shared/session-file-trust.js +20 -0
  649. package/src/shared/session-identity.d.ts +8 -0
  650. package/src/shared/session-identity.js +32 -0
  651. package/src/shared/session-succession.d.ts +4 -0
  652. package/src/shared/session-succession.js +24 -0
  653. package/src/shared/session-tokens.d.ts +2 -0
  654. package/src/shared/session-tokens.js +58 -0
  655. package/src/shared/settings-file-lease.d.ts +4 -0
  656. package/src/shared/settings-file-lease.js +38 -0
  657. package/src/shared/settings.d.ts +146 -0
  658. package/src/shared/settings.js +247 -0
  659. package/src/shared/shortcuts.d.ts +1 -0
  660. package/src/shared/shortcuts.js +17 -0
  661. package/src/shared/status-format.d.ts +9 -0
  662. package/src/shared/status-format.js +60 -0
  663. package/src/shared/thinking-ceiling.d.ts +13 -0
  664. package/src/shared/thinking-ceiling.js +37 -0
  665. package/src/shared/types.d.ts +2842 -0
  666. package/src/shared/types.js +276 -0
  667. package/src/shared/utf8.d.ts +5 -0
  668. package/src/shared/utf8.js +12 -0
  669. package/src/shared/utils.d.ts +83 -0
  670. package/src/shared/utils.js +612 -0
  671. package/src/shared/watch-strategy.d.ts +2 -0
  672. package/src/shared/watch-strategy.js +5 -0
  673. package/src/shared/workflow-child-permit.d.ts +58 -0
  674. package/src/shared/workflow-child-permit.js +159 -0
  675. package/src/slash/delegation-adapters.d.ts +154 -0
  676. package/src/slash/delegation-adapters.js +316 -0
  677. package/src/slash/delegation-json.d.ts +10 -0
  678. package/src/slash/delegation-json.js +117 -0
  679. package/src/slash/delegation-request.d.ts +12 -0
  680. package/src/slash/delegation-request.js +174 -0
  681. package/src/slash/prompt-template-bridge.d.ts +29 -0
  682. package/src/slash/prompt-template-bridge.js +399 -0
  683. package/src/slash/prompt-workflows.d.ts +21 -0
  684. package/src/slash/prompt-workflows.js +274 -0
  685. package/src/slash/selector.d.ts +47 -0
  686. package/src/slash/selector.js +117 -0
  687. package/src/slash/slash-bridge.d.ts +30 -0
  688. package/src/slash/slash-bridge.js +132 -0
  689. package/src/slash/slash-commands.d.ts +10 -0
  690. package/src/slash/slash-commands.js +1059 -0
  691. package/src/slash/slash-live-state.d.ts +21 -0
  692. package/src/slash/slash-live-state.js +263 -0
  693. package/src/slash/subagent-cost.d.ts +29 -0
  694. package/src/slash/subagent-cost.js +310 -0
  695. package/src/slash/subagents-admin.d.ts +3 -0
  696. package/src/slash/subagents-admin.js +481 -0
  697. package/src/tui/fleet-layout.d.ts +20 -0
  698. package/src/tui/fleet-layout.js +17 -0
  699. package/src/tui/fleet-native-transcript.d.ts +53 -0
  700. package/src/tui/fleet-native-transcript.js +339 -0
  701. package/src/tui/fleet-status.d.ts +92 -0
  702. package/src/tui/fleet-status.js +1132 -0
  703. package/src/tui/fleet-transcript.d.ts +64 -0
  704. package/src/tui/fleet-transcript.js +544 -0
  705. package/src/tui/fleet-viewport.d.ts +12 -0
  706. package/src/tui/fleet-viewport.js +35 -0
  707. package/src/tui/fleet.d.ts +196 -0
  708. package/src/tui/fleet.js +1588 -0
  709. package/src/tui/mouse-events.d.ts +21 -0
  710. package/src/tui/mouse-events.js +26 -0
  711. package/src/tui/render-helpers.d.ts +23 -0
  712. package/src/tui/render-helpers.js +100 -0
  713. package/src/tui/render.d.ts +66 -0
  714. package/src/tui/render.js +3707 -0
  715. package/src/tui/running-tone.d.ts +10 -0
  716. package/src/tui/running-tone.js +22 -0
  717. package/src/tui/subagent-messages.d.ts +22 -0
  718. package/src/tui/subagent-messages.js +270 -0
  719. package/src/ui-silent-marker.d.ts +20 -0
  720. package/src/ui-silent-marker.js +25 -0
  721. package/src/watchdog/change-signature.d.ts +7 -0
  722. package/src/watchdog/change-signature.js +243 -0
  723. package/src/watchdog/child-status.d.ts +53 -0
  724. package/src/watchdog/child-status.js +187 -0
  725. package/src/watchdog/diff-tool.d.ts +25 -0
  726. package/src/watchdog/diff-tool.js +104 -0
  727. package/src/watchdog/emission-guard.d.ts +36 -0
  728. package/src/watchdog/emission-guard.js +97 -0
  729. package/src/watchdog/guidance.d.ts +3 -0
  730. package/src/watchdog/guidance.js +19 -0
  731. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  732. package/src/watchdog/lsp-diagnostics.js +489 -0
  733. package/src/watchdog/model-selection.d.ts +24 -0
  734. package/src/watchdog/model-selection.js +167 -0
  735. package/src/watchdog/permission-arbiter.d.ts +20 -0
  736. package/src/watchdog/permission-arbiter.js +135 -0
  737. package/src/watchdog/register-child.d.ts +13 -0
  738. package/src/watchdog/register-child.js +128 -0
  739. package/src/watchdog/register-main.d.ts +11 -0
  740. package/src/watchdog/register-main.js +400 -0
  741. package/src/watchdog/render.d.ts +3 -0
  742. package/src/watchdog/render.js +33 -0
  743. package/src/watchdog/review.d.ts +36 -0
  744. package/src/watchdog/review.js +319 -0
  745. package/src/watchdog/rules.d.ts +21 -0
  746. package/src/watchdog/rules.js +58 -0
  747. package/src/watchdog/runtime.d.ts +195 -0
  748. package/src/watchdog/runtime.js +864 -0
  749. package/src/watchdog/scope.d.ts +14 -0
  750. package/src/watchdog/scope.js +44 -0
  751. package/src/watchdog/settings.d.ts +29 -0
  752. package/src/watchdog/settings.js +480 -0
  753. package/src/watchdog/tool-actions.d.ts +17 -0
  754. package/src/watchdog/tool-actions.js +150 -0
  755. package/src/watchdog/turn-delta.d.ts +15 -0
  756. package/src/watchdog/turn-delta.js +188 -0
  757. package/src/watchdog/types.d.ts +141 -0
  758. package/src/watchdog/types.js +27 -0
  759. package/src/watchdog/warning-format.d.ts +7 -0
  760. package/src/watchdog/warning-format.js +59 -0
  761. package/src/workflows/chat-progress.d.ts +37 -0
  762. package/src/workflows/chat-progress.js +129 -0
  763. package/src/workflows/host-command.d.ts +30 -0
  764. package/src/workflows/host-command.js +227 -0
  765. package/src/workflows/scripted-workflow.d.ts +204 -0
  766. package/src/workflows/scripted-workflow.js +1673 -0
  767. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  768. package/src/workflows/structured-workflow-scripts.js +179 -0
  769. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  770. package/src/workflows/workflow-auto-resume.js +102 -0
  771. package/src/workflows/workflow-checklist.d.ts +127 -0
  772. package/src/workflows/workflow-checklist.js +314 -0
  773. package/src/workflows/workflow-child-summary.d.ts +24 -0
  774. package/src/workflows/workflow-child-summary.js +195 -0
  775. package/src/workflows/workflow-launch-record.d.ts +27 -0
  776. package/src/workflows/workflow-launch-record.js +48 -0
  777. package/src/workflows/workflow-preflight.d.ts +58 -0
  778. package/src/workflows/workflow-preflight.js +288 -0
  779. package/src/workflows/workflow-receipt.d.ts +34 -0
  780. package/src/workflows/workflow-receipt.js +454 -0
  781. package/src/workflows/workflow-resources.d.ts +55 -0
  782. package/src/workflows/workflow-resources.js +271 -0
  783. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  784. package/src/workflows/workflow-resume-claim.js +210 -0
  785. package/src/workflows/workflow-resume.d.ts +56 -0
  786. package/src/workflows/workflow-resume.js +106 -0
  787. package/src/workflows/workflow-reuse.d.ts +61 -0
  788. package/src/workflows/workflow-reuse.js +186 -0
  789. package/src/workflows/workflow-revival.d.ts +33 -0
  790. package/src/workflows/workflow-revival.js +111 -0
  791. package/src/workflows/workflow-settlement.d.ts +84 -0
  792. package/src/workflows/workflow-settlement.js +203 -0
  793. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  794. package/src/workflows/workflow-stop-cause.js +8 -0
  795. package/workflow-script-worker.cjs +1342 -0
  796. package/index.ts +0 -18
  797. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  798. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  799. package/skills/pi-subagents/references/execution-controls.md +0 -561
  800. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  801. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  802. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  803. package/src/agents/advertised-agent-prompt.ts +0 -82
  804. package/src/agents/agent-eject.ts +0 -339
  805. package/src/agents/agent-management.ts +0 -1442
  806. package/src/agents/agent-memory.ts +0 -341
  807. package/src/agents/agent-refinements.ts +0 -624
  808. package/src/agents/agent-scope.ts +0 -10
  809. package/src/agents/agent-selection.ts +0 -25
  810. package/src/agents/agent-serializer.ts +0 -195
  811. package/src/agents/agents.ts +0 -3169
  812. package/src/agents/builtin-names.ts +0 -16
  813. package/src/agents/chain-serializer.ts +0 -285
  814. package/src/agents/frontmatter.ts +0 -153
  815. package/src/agents/global-npm-root.ts +0 -58
  816. package/src/agents/identity.ts +0 -30
  817. package/src/agents/proactive-skills.ts +0 -197
  818. package/src/agents/runtime-agent-events.ts +0 -70
  819. package/src/agents/runtime-agent-registry.ts +0 -457
  820. package/src/agents/runtime-discovery.ts +0 -39
  821. package/src/agents/skills.ts +0 -787
  822. package/src/api/agent-management.ts +0 -9
  823. package/src/api/agents.ts +0 -19
  824. package/src/api/background-work.ts +0 -206
  825. package/src/api/capability-ceiling.ts +0 -16
  826. package/src/api/child-tool-plan.ts +0 -5
  827. package/src/api/control-channel.ts +0 -4
  828. package/src/api/delegation.ts +0 -131
  829. package/src/api/external-job-provider.ts +0 -195
  830. package/src/api/external-runs.ts +0 -282
  831. package/src/api/inspectors.ts +0 -27
  832. package/src/api/intercom-bridge.ts +0 -3
  833. package/src/api/preflight.ts +0 -641
  834. package/src/api/project-panes.ts +0 -32
  835. package/src/api/required-child-extensions.ts +0 -6
  836. package/src/api/shared-types.ts +0 -29
  837. package/src/api/supervisor-routing.ts +0 -196
  838. package/src/api/workflow-resources.ts +0 -6
  839. package/src/extension/config.ts +0 -262
  840. package/src/extension/context-injection.ts +0 -123
  841. package/src/extension/control-notices.ts +0 -53
  842. package/src/extension/declaration-pinning.ts +0 -164
  843. package/src/extension/doctor.ts +0 -284
  844. package/src/extension/fanout-child.ts +0 -282
  845. package/src/extension/herdr-pi-bridge.ts +0 -166
  846. package/src/extension/index.ts +0 -1212
  847. package/src/extension/public-execution.ts +0 -262
  848. package/src/extension/reply-workflow-script.ts +0 -67
  849. package/src/extension/rpc.ts +0 -881
  850. package/src/extension/schemas.ts +0 -337
  851. package/src/extension/steering-notices.ts +0 -35
  852. package/src/extension/subagent-guide.ts +0 -127
  853. package/src/extension/subagent-options.ts +0 -47
  854. package/src/extension/tool-activation.ts +0 -147
  855. package/src/extension/tool-description.ts +0 -193
  856. package/src/extension/tool-result.ts +0 -19
  857. package/src/extension/upgrade-notice.ts +0 -40
  858. package/src/inspectors/actions.ts +0 -174
  859. package/src/inspectors/ghostty/actions.ts +0 -74
  860. package/src/inspectors/ghostty/plugin.ts +0 -29
  861. package/src/inspectors/herdr/actions.ts +0 -155
  862. package/src/inspectors/herdr/client.ts +0 -130
  863. package/src/inspectors/herdr/focus.ts +0 -55
  864. package/src/inspectors/herdr/plugin.ts +0 -20
  865. package/src/inspectors/herdr/project-panes.ts +0 -733
  866. package/src/inspectors/inspector-runner.ts +0 -153
  867. package/src/inspectors/plugins.ts +0 -76
  868. package/src/inspectors/session-roots-codec.ts +0 -31
  869. package/src/inspectors/shell-command.ts +0 -16
  870. package/src/inspectors/tmux/actions.ts +0 -204
  871. package/src/inspectors/tmux/client.ts +0 -85
  872. package/src/inspectors/tmux/plugin.ts +0 -21
  873. package/src/inspectors/types.ts +0 -51
  874. package/src/integrations/herdr-status.ts +0 -385
  875. package/src/integrations/pi-web-session-liveness.ts +0 -73
  876. package/src/integrations/program-status.ts +0 -215
  877. package/src/intercom/fork-supervisor-routing.ts +0 -533
  878. package/src/intercom/intercom-bridge.ts +0 -235
  879. package/src/intercom/native-supervisor-channel.ts +0 -1066
  880. package/src/intercom/result-intercom.ts +0 -433
  881. package/src/intercom/supervisor-ui.ts +0 -72
  882. package/src/missions/actions.ts +0 -433
  883. package/src/missions/goal-driver.ts +0 -177
  884. package/src/missions/lifecycle.ts +0 -367
  885. package/src/missions/store.ts +0 -613
  886. package/src/missions/types.ts +0 -190
  887. package/src/missions/workflow-state.ts +0 -281
  888. package/src/policy/authority.ts +0 -50
  889. package/src/profiles/profiles.ts +0 -674
  890. package/src/runs/background/active-async-capacity.ts +0 -548
  891. package/src/runs/background/active-run-index.ts +0 -155
  892. package/src/runs/background/async-execution.ts +0 -2479
  893. package/src/runs/background/async-job-tracker.ts +0 -869
  894. package/src/runs/background/async-resume.ts +0 -686
  895. package/src/runs/background/async-retention.ts +0 -953
  896. package/src/runs/background/async-status-snapshot.ts +0 -46
  897. package/src/runs/background/async-status.ts +0 -787
  898. package/src/runs/background/auto-drain.ts +0 -92
  899. package/src/runs/background/await-async-run.ts +0 -83
  900. package/src/runs/background/binary-bootstrap.ts +0 -67
  901. package/src/runs/background/calendar-schedule.ts +0 -90
  902. package/src/runs/background/chain-append.ts +0 -321
  903. package/src/runs/background/chain-root-attachment.ts +0 -263
  904. package/src/runs/background/completion-batcher.ts +0 -168
  905. package/src/runs/background/completion-dedupe.ts +0 -58
  906. package/src/runs/background/completion-replay.ts +0 -287
  907. package/src/runs/background/control-channel.ts +0 -659
  908. package/src/runs/background/fleet-view.ts +0 -692
  909. package/src/runs/background/index-segment.ts +0 -59
  910. package/src/runs/background/inspect-rpc.ts +0 -443
  911. package/src/runs/background/notify.ts +0 -1083
  912. package/src/runs/background/owned-process-tree.ts +0 -131
  913. package/src/runs/background/parallel-groups.ts +0 -45
  914. package/src/runs/background/pid-namespace.ts +0 -18
  915. package/src/runs/background/process-terminal-candidate.ts +0 -98
  916. package/src/runs/background/process-terminal.ts +0 -231
  917. package/src/runs/background/result-delivery-ownership.ts +0 -45
  918. package/src/runs/background/result-files.ts +0 -634
  919. package/src/runs/background/result-watcher.ts +0 -842
  920. package/src/runs/background/resume-guidance.ts +0 -56
  921. package/src/runs/background/retained-children.ts +0 -136
  922. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  923. package/src/runs/background/run-child-session.ts +0 -725
  924. package/src/runs/background/run-id-query.ts +0 -7
  925. package/src/runs/background/run-id-resolver.ts +0 -183
  926. package/src/runs/background/run-status.ts +0 -803
  927. package/src/runs/background/runner-aliases.ts +0 -183
  928. package/src/runs/background/runner-child-launch.ts +0 -96
  929. package/src/runs/background/runner-child-sessions.ts +0 -32
  930. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  931. package/src/runs/background/runner-startup-failure.ts +0 -56
  932. package/src/runs/background/scheduled-runs.ts +0 -1222
  933. package/src/runs/background/stale-run-reconciler.ts +0 -463
  934. package/src/runs/background/steering.ts +0 -260
  935. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  936. package/src/runs/background/subagent-runner.ts +0 -5251
  937. package/src/runs/background/subagent-wait.ts +0 -895
  938. package/src/runs/background/terminal-run-index.ts +0 -183
  939. package/src/runs/background/top-level-async.ts +0 -14
  940. package/src/runs/background/wait-completions.ts +0 -262
  941. package/src/runs/background/wait-config.ts +0 -50
  942. package/src/runs/background/wait-subscriptions.ts +0 -354
  943. package/src/runs/background/wait-tool.ts +0 -57
  944. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  945. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  946. package/src/runs/foreground/async-steering-action.ts +0 -276
  947. package/src/runs/foreground/async-stop-action.ts +0 -216
  948. package/src/runs/foreground/command-action.ts +0 -41
  949. package/src/runs/foreground/execution.ts +0 -2315
  950. package/src/runs/foreground/foreground-control.ts +0 -157
  951. package/src/runs/foreground/foreground-history.ts +0 -164
  952. package/src/runs/foreground/prompt-audit.ts +0 -172
  953. package/src/runs/foreground/subagent-executor.ts +0 -8252
  954. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  955. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  956. package/src/runs/shared/abort-recovery.ts +0 -119
  957. package/src/runs/shared/acceptance.ts +0 -1664
  958. package/src/runs/shared/agent-contract.ts +0 -38
  959. package/src/runs/shared/async-status-projection.ts +0 -664
  960. package/src/runs/shared/background-process-options.ts +0 -9
  961. package/src/runs/shared/capability-ceiling.ts +0 -214
  962. package/src/runs/shared/chain-outputs.ts +0 -116
  963. package/src/runs/shared/child-commands.ts +0 -229
  964. package/src/runs/shared/child-hooks.ts +0 -175
  965. package/src/runs/shared/child-identity.ts +0 -62
  966. package/src/runs/shared/child-launch-plan.ts +0 -163
  967. package/src/runs/shared/child-launch.ts +0 -389
  968. package/src/runs/shared/child-lifecycle.ts +0 -28
  969. package/src/runs/shared/child-runtime-config.ts +0 -136
  970. package/src/runs/shared/child-session.ts +0 -699
  971. package/src/runs/shared/child-tool-plan.ts +0 -599
  972. package/src/runs/shared/claude-code-adapter.ts +0 -288
  973. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  974. package/src/runs/shared/context-mode.ts +0 -44
  975. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  976. package/src/runs/shared/dynamic-fanout.ts +0 -297
  977. package/src/runs/shared/effective-system-prompt.ts +0 -33
  978. package/src/runs/shared/extension-bindings.ts +0 -103
  979. package/src/runs/shared/external-cli-contract.ts +0 -177
  980. package/src/runs/shared/external-cli-preflight.ts +0 -190
  981. package/src/runs/shared/external-cli-runner.ts +0 -437
  982. package/src/runs/shared/external-job-bridge.ts +0 -514
  983. package/src/runs/shared/external-job-runner.ts +0 -389
  984. package/src/runs/shared/fast-mode-extension.ts +0 -10
  985. package/src/runs/shared/fork-command-result.ts +0 -10
  986. package/src/runs/shared/git-environment.ts +0 -29
  987. package/src/runs/shared/herdr-connection.ts +0 -134
  988. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  989. package/src/runs/shared/herdr-machine.ts +0 -279
  990. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  991. package/src/runs/shared/herdr-placed-run.ts +0 -264
  992. package/src/runs/shared/host-step-status.ts +0 -231
  993. package/src/runs/shared/lane-metadata.ts +0 -126
  994. package/src/runs/shared/launch-cwd.ts +0 -16
  995. package/src/runs/shared/long-running-guard.ts +0 -221
  996. package/src/runs/shared/mcp-config-sources.ts +0 -426
  997. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  998. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  999. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  1000. package/src/runs/shared/model-resolution.ts +0 -503
  1001. package/src/runs/shared/model-scope.ts +0 -224
  1002. package/src/runs/shared/mutation-evidence.ts +0 -199
  1003. package/src/runs/shared/nested-events.ts +0 -1125
  1004. package/src/runs/shared/nested-path.ts +0 -38
  1005. package/src/runs/shared/nested-render.ts +0 -127
  1006. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1007. package/src/runs/shared/parallel-handoff.ts +0 -789
  1008. package/src/runs/shared/parallel-utils.ts +0 -292
  1009. package/src/runs/shared/partial-output.ts +0 -48
  1010. package/src/runs/shared/permissions.ts +0 -86
  1011. package/src/runs/shared/pi-spawn.ts +0 -205
  1012. package/src/runs/shared/process-signal.ts +0 -35
  1013. package/src/runs/shared/profile-extensions.ts +0 -134
  1014. package/src/runs/shared/profile-launch-env.ts +0 -121
  1015. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1016. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1017. package/src/runs/shared/run-history.ts +0 -288
  1018. package/src/runs/shared/runner-launcher.ts +0 -25
  1019. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1020. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1021. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1022. package/src/runs/shared/session-lease.ts +0 -293
  1023. package/src/runs/shared/single-output.ts +0 -366
  1024. package/src/runs/shared/spawn-budget.ts +0 -128
  1025. package/src/runs/shared/structured-output.ts +0 -463
  1026. package/src/runs/shared/subagent-control.ts +0 -295
  1027. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1028. package/src/runs/shared/tool-availability.ts +0 -37
  1029. package/src/runs/shared/tool-budget.ts +0 -87
  1030. package/src/runs/shared/tool-timeout.ts +0 -93
  1031. package/src/runs/shared/usage-budget.ts +0 -65
  1032. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1033. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1034. package/src/runs/shared/workflow-graph.ts +0 -225
  1035. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1036. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1037. package/src/runs/shared/worktree-lock.ts +0 -29
  1038. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1039. package/src/runs/shared/worktree.ts +0 -1554
  1040. package/src/shared/accessible-dir.ts +0 -47
  1041. package/src/shared/agent-stream-options.ts +0 -5
  1042. package/src/shared/artifacts.ts +0 -281
  1043. package/src/shared/atomic-json.ts +0 -85
  1044. package/src/shared/capacity-resilient-json.ts +0 -102
  1045. package/src/shared/child-cache-retention.ts +0 -43
  1046. package/src/shared/child-session-name.ts +0 -48
  1047. package/src/shared/child-transcript.ts +0 -264
  1048. package/src/shared/completion-owner.ts +0 -14
  1049. package/src/shared/disabled-features.ts +0 -123
  1050. package/src/shared/display-text.ts +0 -150
  1051. package/src/shared/edit-distance.ts +0 -33
  1052. package/src/shared/extension-context.ts +0 -37
  1053. package/src/shared/file-coalescer.ts +0 -49
  1054. package/src/shared/file-lease.ts +0 -74
  1055. package/src/shared/file-system-retry.ts +0 -95
  1056. package/src/shared/fork-context.ts +0 -243
  1057. package/src/shared/fork-session-cwd.ts +0 -27
  1058. package/src/shared/formatters.ts +0 -142
  1059. package/src/shared/jsonl-writer.ts +0 -92
  1060. package/src/shared/launch-contract.ts +0 -206
  1061. package/src/shared/model-info.ts +0 -132
  1062. package/src/shared/model-response-aliases.ts +0 -13
  1063. package/src/shared/node-executable.ts +0 -21
  1064. package/src/shared/opencode-session-headers.ts +0 -30
  1065. package/src/shared/package-version.ts +0 -17
  1066. package/src/shared/parent-wake.ts +0 -79
  1067. package/src/shared/permission-profile.ts +0 -56
  1068. package/src/shared/prompt-resources.ts +0 -11
  1069. package/src/shared/pruned-fork.ts +0 -469
  1070. package/src/shared/required-child-extensions.ts +0 -115
  1071. package/src/shared/runtime-module-path.ts +0 -19
  1072. package/src/shared/sandbox-profile.ts +0 -37
  1073. package/src/shared/session-file-trust.ts +0 -19
  1074. package/src/shared/session-identity.ts +0 -10
  1075. package/src/shared/session-tokens.ts +0 -55
  1076. package/src/shared/settings-file-lease.ts +0 -36
  1077. package/src/shared/settings.ts +0 -412
  1078. package/src/shared/shortcuts.ts +0 -13
  1079. package/src/shared/status-format.ts +0 -55
  1080. package/src/shared/thinking-ceiling.ts +0 -46
  1081. package/src/shared/types.ts +0 -3105
  1082. package/src/shared/utf8.ts +0 -11
  1083. package/src/shared/utils.ts +0 -610
  1084. package/src/shared/watch-strategy.ts +0 -12
  1085. package/src/shared/workflow-child-permit.ts +0 -212
  1086. package/src/slash/delegation-adapters.ts +0 -452
  1087. package/src/slash/delegation-json.ts +0 -108
  1088. package/src/slash/delegation-request.ts +0 -176
  1089. package/src/slash/prompt-template-bridge.ts +0 -435
  1090. package/src/slash/prompt-workflows.ts +0 -298
  1091. package/src/slash/selector.ts +0 -147
  1092. package/src/slash/slash-bridge.ts +0 -192
  1093. package/src/slash/slash-commands.ts +0 -1096
  1094. package/src/slash/slash-live-state.ts +0 -310
  1095. package/src/slash/subagent-cost.ts +0 -317
  1096. package/src/slash/subagents-admin.ts +0 -489
  1097. package/src/tui/fleet-native-transcript.ts +0 -424
  1098. package/src/tui/fleet-status.ts +0 -1139
  1099. package/src/tui/fleet-transcript.ts +0 -591
  1100. package/src/tui/fleet.ts +0 -1618
  1101. package/src/tui/mouse-events.ts +0 -42
  1102. package/src/tui/render-helpers.ts +0 -111
  1103. package/src/tui/render.ts +0 -3824
  1104. package/src/tui/running-tone.ts +0 -28
  1105. package/src/tui/subagent-messages.ts +0 -305
  1106. package/src/ui-silent-marker.ts +0 -32
  1107. package/src/watchdog/change-signature.ts +0 -260
  1108. package/src/watchdog/child-status.ts +0 -225
  1109. package/src/watchdog/diff-tool.ts +0 -112
  1110. package/src/watchdog/emission-guard.ts +0 -125
  1111. package/src/watchdog/guidance.ts +0 -20
  1112. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1113. package/src/watchdog/model-selection.ts +0 -187
  1114. package/src/watchdog/permission-arbiter.ts +0 -154
  1115. package/src/watchdog/register-child.ts +0 -136
  1116. package/src/watchdog/register-main.ts +0 -425
  1117. package/src/watchdog/render.ts +0 -31
  1118. package/src/watchdog/review.ts +0 -362
  1119. package/src/watchdog/rules.ts +0 -70
  1120. package/src/watchdog/runtime.ts +0 -927
  1121. package/src/watchdog/scope.ts +0 -51
  1122. package/src/watchdog/settings.ts +0 -520
  1123. package/src/watchdog/tool-actions.ts +0 -156
  1124. package/src/watchdog/turn-delta.ts +0 -190
  1125. package/src/watchdog/types.ts +0 -186
  1126. package/src/watchdog/warning-format.ts +0 -72
  1127. package/src/workflows/chat-progress.ts +0 -152
  1128. package/src/workflows/host-command.ts +0 -235
  1129. package/src/workflows/scripted-workflow.ts +0 -2733
  1130. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1131. package/src/workflows/workflow-checklist.ts +0 -442
  1132. package/src/workflows/workflow-child-summary.ts +0 -172
  1133. package/src/workflows/workflow-preflight.ts +0 -297
  1134. package/src/workflows/workflow-receipt.ts +0 -390
  1135. package/src/workflows/workflow-resources.ts +0 -275
  1136. package/src/workflows/workflow-reuse.ts +0 -120
  1137. package/src/workflows/workflow-revival.ts +0 -123
  1138. package/src/workflows/workflow-settlement.ts +0 -252
@@ -1,895 +0,0 @@
1
- /**
2
- * `bg_wait` tool: block the current turn until outstanding async runs
3
- * or a named remembered detached foreground run finishes.
4
- *
5
- * Background subagent runs are detached. In an interactive session the parent
6
- * can end its turn and Pi will wake it with a completion notification. That
7
- * does not work when the parent is a skill that must run to completion, and it
8
- * cannot work at all non-interactively (`pi -p ...`), where the run is a single
9
- * turn: once the turn ends there is nothing left to receive the notification.
10
- *
11
- * `bg_wait` closes that gap. It keeps the turn alive until a tracked async
12
- * run for this session reaches a terminal state (complete / failed / paused),
13
- * the caller-supplied timeout elapses, or the turn is aborted. Because it awaits
14
- * inside the turn, the completion the model was told to wait for is actually
15
- * observed before the tool returns.
16
- *
17
- * By default `bg_wait` returns as soon as ONE run finishes, so a fleet
18
- * manager can use it in a rolling-replacement loop: launch N workers, wait for
19
- * the next one to finish, spawn its replacement, then call `bg_wait`
20
- * again — keeping N in flight instead of draining to zero between batches.
21
- * Pass `all: true` to block until every tracked async run is terminal, or `id`
22
- * to block on one specific async or remembered detached foreground run.
23
- *
24
- * `bg_wait` also returns when a run needs attention — not just on
25
- * completion. A child that goes idle or blocks for a decision surfaces
26
- * `needs_attention` (the same signal Pi shows as a control notice and,
27
- * interactively, wakes the parent with). Since `bg_wait` is used exactly
28
- * where there is no next turn to receive that notice, it must break on it too,
29
- * or a stuck child would stall the loop until the timeout. Attention runs are
30
- * reported so the caller can inspect / nudge / resume / interrupt them.
31
- *
32
- * Wake mechanism: when given Pi's event bus (`deps.events`), `bg_wait`
33
- * subscribes to the subagent completion/control channels and wakes the instant
34
- * any fires, rather than waiting out a fixed poll interval. A poll still runs
35
- * on the interval as a reconciliation fallback (crashed runners, missed
36
- * events), and the poll is the source of truth for what actually changed — the
37
- * event only ends the sleep early. With no bus, `bg_wait` degrades to pure
38
- * polling.
39
- */
40
-
41
- import * as fs from "node:fs";
42
- import * as path from "node:path";
43
- import type { AgentToolResult } from "@earendil-works/pi-agent-core";
44
- import {
45
- listBackgroundWorkWakeChannels,
46
- snapshotBackgroundWork,
47
- type BackgroundWorkSnapshot,
48
- type RegisteredBackgroundWorkItem,
49
- } from "../../api/background-work.ts";
50
- import { formatAsyncRunList, listAsyncRuns, type AsyncRunSummary } from "./async-status.ts";
51
- import {
52
- DIRS,
53
- INTERCOM_DETACH_REQUEST_EVENT,
54
- SUBAGENT_ASYNC_COMPLETE_EVENT,
55
- SUBAGENT_FOREGROUND_COMPLETE_EVENT,
56
- SUBAGENT_CONTROL_EVENT,
57
- SUBAGENT_CONTROL_INTERCOM_EVENT,
58
- SUBAGENT_RESULT_INTERCOM_EVENT,
59
- type Details,
60
- type ForegroundResumeRun,
61
- type SubagentState,
62
- type Usage,
63
- type WaitCompletion,
64
- } from "../../shared/types.ts";
65
- import { nestedRunScope } from "../shared/nested-events.ts";
66
- import { formatDuration, shortenPath } from "../../shared/formatters.ts";
67
- import { toAgentToolUsage } from "../../shared/utils.ts";
68
- import { collectWaitCompletions } from "./wait-completions.ts";
69
- import { formatResumeFirstFailedRunsNote } from "./resume-guidance.ts";
70
- import { formatTimeoutRecoveryLines } from "../shared/mutation-evidence.ts";
71
- export { WAIT_TOOL_DEFAULT_TIMEOUT_MS_ENV, WAIT_TOOL_ENABLED_ENV, resolveWaitToolConfig, type ResolvedWaitToolConfig } from "./wait-config.ts";
72
-
73
- /** States that mean a run is still in flight (not yet resolved). */
74
- const ACTIVE_STATES: ReadonlyArray<AsyncRunSummary["state"]> = ["queued", "running"];
75
-
76
- const DEFAULT_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
77
- const MIN_POLL_INTERVAL_MS = 250;
78
- const DEFAULT_POLL_INTERVAL_MS = 1000;
79
-
80
- export interface SubagentWaitParams {
81
- /** Optional run id/prefix to wait for. When omitted, waits across every active run in this session. */
82
- id?: string;
83
- /** Arm a durable exact-run wake subscription and return immediately. Requires id. */
84
- nonBlocking?: boolean;
85
- /**
86
- * When true, block until EVERY active run in this session (or matching `id`)
87
- * is terminal. Default false: return when the first tracked run or provider
88
- * item finishes or needs attention. Ignored when `id` targets a single run.
89
- */
90
- all?: boolean;
91
- /** Give up after this many milliseconds. Defaults to waitTool.defaultTimeoutMs, then 30 minutes. */
92
- timeoutMs?: number;
93
- /** False keeps a blocking wait open through idle attention; supervisor/contact requests still stop the wait. */
94
- stopOnAttention?: boolean;
95
- }
96
-
97
- /** Minimal event-bus surface wait subscribes to (matches pi.events). */
98
- export interface WaitEventBus {
99
- on(channel: string, handler: (data: unknown) => void): () => void;
100
- }
101
-
102
- export interface SubagentWaitDeps {
103
- state: SubagentState;
104
- /** Stream live wait status into Pi's pending tool row. */
105
- onUpdate?: (result: AgentToolResult<Details>) => void;
106
- asyncDirRoot?: string;
107
- resultsDir?: string;
108
- /** Root from the child's validated inherited route, not a tool argument. */
109
- nestedRootRunId?: string;
110
- kill?: (pid: number, signal?: NodeJS.Signals | 0) => boolean;
111
- now?: () => number;
112
- pollIntervalMs?: number;
113
- /** False makes the tool return immediately without blocking active async runs. */
114
- enabled?: boolean;
115
- /** Configured blocking window used when the call omits timeoutMs. */
116
- defaultTimeoutMs?: number;
117
- /** Injectable sleep for tests. */
118
- sleep?: (ms: number, signal?: AbortSignal) => Promise<void>;
119
- /** Internal auto-drain mode waits through needs-attention states. */
120
- stopOnAttention?: boolean;
121
- /** Internal auto-drain mode surfaces failed terminal subagent runs as errors. */
122
- failOnFailedRuns?: boolean;
123
- /** Internal auto-drain mode surfaces actionable attention as an error. */
124
- failOnAttention?: boolean;
125
- /** Durable owned supervisor-request barrier used by headless auto-drain. */
126
- hasPendingSupervisorRequest?: () => boolean;
127
- /** Aborted when the user sends a message; the wait then yields without an error. */
128
- userInputSignal?: AbortSignal;
129
- /** Arm a durable exact-target wait subscription in a long-lived interactive runtime. */
130
- subscribe?: (input: { targetKind: "async" | "foreground"; runId: string; requestedId: string; timeoutMs: number }) => { token: string; expiresAt: number };
131
- /** Injectable provider protocol surfaces for deterministic tests. */
132
- backgroundWork?: {
133
- snapshot(sessionId: string, nowMs: number): BackgroundWorkSnapshot;
134
- wakeChannels(): readonly string[];
135
- };
136
- /**
137
- * Optional event bus (pi.events). When provided, wait wakes immediately on a
138
- * subagent completion/control event instead of waiting out the poll interval;
139
- * the poll then remains as a reconciliation fallback (crashed runners, missed
140
- * events). Omit in tests that want pure poll behavior.
141
- */
142
- events?: WaitEventBus;
143
- }
144
-
145
- /** Bus channels that indicate a run changed state or needs attention. */
146
- const WAKE_CHANNELS = [
147
- INTERCOM_DETACH_REQUEST_EVENT,
148
- SUBAGENT_ASYNC_COMPLETE_EVENT,
149
- SUBAGENT_FOREGROUND_COMPLETE_EVENT,
150
- SUBAGENT_CONTROL_EVENT,
151
- SUBAGENT_CONTROL_INTERCOM_EVENT,
152
- SUBAGENT_RESULT_INTERCOM_EVENT,
153
- ];
154
-
155
- function defaultSleep(ms: number, signal?: AbortSignal): Promise<void> {
156
- return new Promise((resolve) => {
157
- if (signal?.aborted) {
158
- resolve();
159
- return;
160
- }
161
- const timer = setTimeout(() => {
162
- signal?.removeEventListener("abort", onAbort);
163
- resolve();
164
- }, ms);
165
- const onAbort = () => {
166
- clearTimeout(timer);
167
- resolve();
168
- };
169
- signal?.addEventListener("abort", onAbort, { once: true });
170
- });
171
- }
172
-
173
- /**
174
- * Sleep up to `ms`, but wake early if a subagent event fires on the bus (or the
175
- * turn aborts). Returns when the first of those happens. With no bus this is a
176
- * plain sleep, so the poll interval alone drives progress.
177
- */
178
- function waitForWake(ms: number, signal: AbortSignal | undefined, deps: SubagentWaitDeps): Promise<void> {
179
- const sleep = deps.sleep ?? defaultSleep;
180
- const events = deps.events;
181
- if (!events) return sleep(ms, signal);
182
- const providerChannels = deps.backgroundWork?.wakeChannels() ?? listBackgroundWorkWakeChannels();
183
- return new Promise((resolve, reject) => {
184
- let settled = false;
185
- const unsubs: Array<() => void> = [];
186
- const wakeController = new AbortController();
187
- const done = () => {
188
- if (settled) return;
189
- settled = true;
190
- wakeController.abort();
191
- signal?.removeEventListener("abort", done);
192
- for (const u of unsubs) {
193
- try { u(); } catch { /* best effort */ }
194
- }
195
- resolve();
196
- };
197
- if (signal?.aborted) {
198
- done();
199
- return;
200
- }
201
- signal?.addEventListener("abort", done, { once: true });
202
- try {
203
- for (const channel of [...new Set([...WAKE_CHANNELS, ...providerChannels])]) {
204
- unsubs.push(events.on(channel, done));
205
- }
206
- } catch (error) {
207
- signal?.removeEventListener("abort", done);
208
- for (const unsubscribe of unsubs) {
209
- try { unsubscribe(); } catch { /* best effort cleanup */ }
210
- }
211
- reject(error);
212
- return;
213
- }
214
- // Poll-interval fallback so we still reconcile even if no event arrives.
215
- // The local signal cancels that fallback timer when an event wakes us first.
216
- void sleep(ms, wakeController.signal).then(done);
217
- });
218
- }
219
-
220
- /** Signal that wakes the poll sleep on turn abort or a user message. */
221
- function wakeSignal(signal: AbortSignal | undefined, deps: SubagentWaitDeps): AbortSignal | undefined {
222
- if (!deps.userInputSignal) return signal;
223
- return signal ? AbortSignal.any([signal, deps.userInputSignal]) : deps.userInputSignal;
224
- }
225
-
226
- function matchesId(run: AsyncRunSummary, id: string): boolean {
227
- return run.id === id || run.id.startsWith(id);
228
- }
229
-
230
- function activeDetachedForegroundRuns(params: SubagentWaitParams, deps: SubagentWaitDeps): ForegroundResumeRun[] {
231
- const sessionId = deps.state.currentSessionId;
232
- if (!sessionId || !deps.state.foregroundRuns) return [];
233
- const runs = [...deps.state.foregroundRuns.values()].filter((run) =>
234
- run.sessionId === sessionId && run.children.some((child) => child.status === "detached")
235
- );
236
- if (params.id) return runs.filter((run) => run.runId === params.id || run.runId.startsWith(params.id!));
237
- return params.all === true ? runs : [];
238
- }
239
-
240
- function summarizeForegroundChildren(run: ForegroundResumeRun, indices: Set<number>): string {
241
- const counts = new Map<string, number>();
242
- for (const child of run.children) {
243
- if (!indices.has(child.index) || child.status === "detached") continue;
244
- counts.set(child.status, (counts.get(child.status) ?? 0) + 1);
245
- }
246
- return [...counts.entries()].map(([status, count]) => `${count} ${status}`).join(", ");
247
- }
248
-
249
- function foregroundChildrenNeedingAttention(run: ForegroundResumeRun, indices: Set<number>) {
250
- return run.children.filter((child) => indices.has(child.index) && child.status === "detached" && child.activityState === "needs_attention" && child.currentTool === "contact_supervisor");
251
- }
252
-
253
- function formatForegroundAttention(run: ForegroundResumeRun, children: ReturnType<typeof foregroundChildrenNeedingAttention>, elapsedMs: number): AgentToolResult<Details> {
254
- const childList = children.map((child) => `${child.agent}${child.index !== undefined ? `#${child.index}` : ""}`).join(", ");
255
- return result(
256
- `Waited ${formatDuration(elapsedMs)} for remembered detached foreground run "${run.runId}"; attention required. ${children.length} child run(s) need attention: ${childList}. Reply to any pending supervisor request, then call bg_wait({ id: "${run.runId}" }) again or inspect status; do not resume or launch a replacement while it remains detached.`,
257
- );
258
- }
259
-
260
- /** A running run that has flagged it needs the parent's attention. */
261
- function needsAttention(run: AsyncRunSummary): boolean {
262
- return run.activityState === "needs_attention" || run.steps.some((step) => step.activityState === "needs_attention");
263
- }
264
-
265
- function hasSupervisorTool(run: AsyncRunSummary): boolean {
266
- return run.currentTool === "contact_supervisor"
267
- || run.currentTool === "intercom"
268
- || run.steps.some((step) => step.currentTool === "contact_supervisor" || step.currentTool === "intercom");
269
- }
270
-
271
- function backgroundWorkIdentity(item: RegisteredBackgroundWorkItem): string {
272
- return `${item.provider}\0${item.sessionId}\0${item.id}`;
273
- }
274
-
275
- function backgroundWorkForSession(deps: SubagentWaitDeps, nowMs: number): BackgroundWorkSnapshot {
276
- const sessionId = deps.state.currentSessionId;
277
- if (!sessionId) throw new Error("bg_wait requires an active session identity to scope background work safely.");
278
- return deps.backgroundWork?.snapshot(sessionId, nowMs) ?? snapshotBackgroundWork(sessionId, nowMs);
279
- }
280
-
281
- export function waitRunScopes(deps: Pick<SubagentWaitDeps, "asyncDirRoot" | "resultsDir" | "nestedRootRunId">): Array<{ asyncDirRoot: string; resultsDir: string }> {
282
- return [
283
- { asyncDirRoot: deps.asyncDirRoot ?? DIRS.async, resultsDir: deps.resultsDir ?? DIRS.results },
284
- ...(deps.nestedRootRunId ? [nestedRunScope(deps.nestedRootRunId)] : []),
285
- ];
286
- }
287
-
288
- function collectScopedCompletions(terminal: AsyncRunSummary[], deps: SubagentWaitDeps, references: string[]): WaitCompletion[] | undefined {
289
- const completions = waitRunScopes(deps).flatMap((scope) => collectWaitCompletions(
290
- terminal.filter((run) => path.resolve(path.dirname(run.asyncDir)) === path.resolve(scope.asyncDirRoot)),
291
- deps.state, scope.resultsDir, (reference) => references.push(reference),
292
- ) ?? []);
293
- return completions.length ? completions : undefined;
294
- }
295
-
296
- /** Immediate-session runs only; named lookups can also recover already-terminal results. */
297
- function runsForSession(params: SubagentWaitParams, deps: SubagentWaitDeps, activeOnly = true): AsyncRunSummary[] {
298
- const runs = waitRunScopes(deps).flatMap(({ asyncDirRoot, resultsDir }) => listAsyncRuns(asyncDirRoot, {
299
- states: activeOnly ? [...ACTIVE_STATES] : undefined,
300
- sessionId: deps.state.currentSessionId ?? undefined,
301
- resultsDir,
302
- kill: deps.kill,
303
- now: deps.now,
304
- includeNested: false,
305
- ...(params.id ? { runId: params.id } : {}),
306
- }));
307
- return params.id ? runs.filter((run) => matchesId(run, params.id!)) : runs;
308
- }
309
-
310
- function activeRunsForSession(params: SubagentWaitParams, deps: SubagentWaitDeps): AsyncRunSummary[] {
311
- return runsForSession(params, deps);
312
- }
313
-
314
- /** Runs (from the initial set) currently flagged needs_attention, for reporting. */
315
- function attentionRunsForSession(params: SubagentWaitParams, deps: SubagentWaitDeps, initialIds: Set<string>): AsyncRunSummary[] {
316
- return activeRunsForSession(params, deps).filter((run) => needsAttention(run) && initialIds.has(run.id));
317
- }
318
-
319
- /** Exact initial runs in any state, for the final summary. */
320
- function runsForIds(runIds: Iterable<string>, deps: SubagentWaitDeps): AsyncRunSummary[] {
321
- return waitRunScopes(deps).flatMap(({ asyncDirRoot, resultsDir }) => [...runIds].flatMap((runId) => listAsyncRuns(asyncDirRoot, {
322
- sessionId: deps.state.currentSessionId ?? undefined,
323
- resultsDir,
324
- kill: deps.kill,
325
- now: deps.now,
326
- includeNested: false,
327
- runId,
328
- exactRunId: true,
329
- })));
330
- }
331
-
332
- function summarizeTerminalRuns(runs: AsyncRunSummary[], providerFinishedCount = 0): string {
333
- if (runs.length === 0 && providerFinishedCount === 0) return "";
334
- const counts = { complete: 0, failed: 0, paused: 0 } as Record<string, number>;
335
- for (const run of runs) {
336
- const count = counts[run.state];
337
- if (count !== undefined) counts[run.state] = count + 1;
338
- }
339
- const parts: string[] = [];
340
- if (counts.complete) parts.push(`${counts.complete} complete`);
341
- if (counts.failed) parts.push(`${counts.failed} failed`);
342
- if (counts.paused) parts.push(`${counts.paused} paused`);
343
- if (providerFinishedCount > 0) parts.push(`${providerFinishedCount} provider item(s) finished`);
344
- return parts.join(", ");
345
- }
346
-
347
- function completionUsage(completions: WaitCompletion[] | undefined): Usage | undefined {
348
- if (!completions?.length) return undefined;
349
- const usage: Usage = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: 0 };
350
- let projected = false;
351
- for (const completion of completions) {
352
- for (const child of completion.results ?? []) {
353
- if (!child.usage || (child.usage.input === 0 && child.usage.output === 0 && child.usage.cacheRead === 0 && child.usage.cacheWrite === 0 && child.usage.cost === 0 && child.usage.turns === 0)) continue;
354
- projected = true;
355
- usage.input += child.usage.input;
356
- usage.output += child.usage.output;
357
- usage.cacheRead += child.usage.cacheRead;
358
- usage.cacheWrite += child.usage.cacheWrite;
359
- usage.cost += child.usage.cost;
360
- usage.turns += child.usage.turns;
361
- }
362
- }
363
- return projected ? usage : undefined;
364
- }
365
-
366
- function result(text: string, isError = false, completions?: WaitCompletion[]): AgentToolResult<Details> {
367
- const usage = completionUsage(completions);
368
- for (const completion of completions ?? []) {
369
- if (completion.workflowReceiptPath) text += `\nWorkflow receipt [${completion.runId}]: ${completion.workflowReceiptPath}`;
370
- }
371
- return {
372
- content: [{ type: "text", text }],
373
- ...(isError ? { isError: true } : {}),
374
- ...(usage ? { usage: toAgentToolUsage(usage) } : {}),
375
- details: {
376
- mode: "management",
377
- results: [],
378
- ...(completions && completions.length > 0 ? { completions } : {}),
379
- },
380
- };
381
- }
382
-
383
- function formatCompletionRecovery(completions: WaitCompletion[] | undefined): string {
384
- const lines = (completions ?? []).flatMap((completion) =>
385
- (completion.results ?? []).flatMap((child) => formatTimeoutRecoveryLines(child.timeoutRecovery)));
386
- return lines.length > 0 ? `\n${lines.join("\n")}` : "";
387
- }
388
-
389
- function windowElapsedResult(
390
- text: string,
391
- activeRunIds: string[],
392
- activeProviderItems: readonly RegisteredBackgroundWorkItem[] = [],
393
- ): AgentToolResult<Details> {
394
- return {
395
- content: [{ type: "text", text }],
396
- details: {
397
- mode: "management",
398
- results: [],
399
- wait: {
400
- reason: "window_elapsed",
401
- timedOut: true,
402
- activeRunIds,
403
- activeProviderItems: activeProviderItems.map(({ provider, id }) => ({ provider, id })),
404
- },
405
- },
406
- };
407
- }
408
-
409
- type WaitYieldReason = "supervisor_request" | "user_input";
410
-
411
- const WAIT_YIELD_TEXT: Record<WaitYieldReason, string> = {
412
- supervisor_request: "Wait yielded for a pending supervisor request. Background work remains active and will continue after the supervisor reply.",
413
- user_input: "Wait yielded because the user sent a message. Background work remains active; read the message before waiting again.",
414
- };
415
-
416
- function yieldResult(
417
- reason: WaitYieldReason,
418
- activeRunIds: string[],
419
- activeProviderItems: readonly RegisteredBackgroundWorkItem[] = [],
420
- ): AgentToolResult<Details> {
421
- return {
422
- content: [{ type: "text", text: WAIT_YIELD_TEXT[reason] }],
423
- details: {
424
- mode: "management",
425
- results: [],
426
- wait: {
427
- reason,
428
- timedOut: false,
429
- activeRunIds,
430
- activeProviderItems: activeProviderItems.map(({ provider, id }) => ({ provider, id })),
431
- },
432
- },
433
- };
434
- }
435
-
436
- interface InitialWaitScope {
437
- asyncRunIds: Set<string>;
438
- foregroundRuns: Array<{ runId: string; sessionId?: string; detachedIndices: Set<number> }>;
439
- providerIds: Set<string>;
440
- }
441
-
442
- function yieldForScope(reason: WaitYieldReason, scope: InitialWaitScope, params: SubagentWaitParams, deps: SubagentWaitDeps, nowMs: number): AgentToolResult<Details> {
443
- try {
444
- const activeAsyncIds = new Set(activeRunsForSession(params.id ? { id: params.id } : {}, deps).map((run) => run.id));
445
- const activeRunIds = new Set([...scope.asyncRunIds].filter((id) => activeAsyncIds.has(id)));
446
- for (const initial of scope.foregroundRuns) {
447
- const current = deps.state.foregroundRuns?.get(initial.runId);
448
- if (!current || current.sessionId !== initial.sessionId) continue;
449
- if (current.children.some((child) => initial.detachedIndices.has(child.index) && child.status === "detached")) activeRunIds.add(initial.runId);
450
- }
451
- const activeProviderItems = scope.providerIds.size > 0
452
- ? backgroundWorkForSession(deps, nowMs).items.filter((item) => scope.providerIds.has(backgroundWorkIdentity(item)))
453
- : [];
454
- return yieldResult(reason, [...activeRunIds], activeProviderItems);
455
- } catch (error) {
456
- return result(error instanceof Error ? error.message : String(error), true);
457
- }
458
- }
459
-
460
- /** Build the live status shown while async work keeps bg_wait blocked. */
461
- function asyncWaitUpdate(runs: AsyncRunSummary[], providerCount: number, elapsedMs: number): AgentToolResult<Details> {
462
- const activity = runs.flatMap((run) => {
463
- const activeSteps = run.steps.filter((step) => step.status === "pending" || step.status === "running");
464
- if (activeSteps.length === 0) {
465
- return [`${run.id}: ${run.state}`];
466
- }
467
- return activeSteps.map((step) => {
468
- const current = step.currentTool ?? (step.status === "pending" ? "queued" : "thinking…");
469
- return `${step.agent}: ${current}${step.currentPath ? ` ${shortenPath(step.currentPath)}` : ""}`;
470
- });
471
- });
472
- const headline = [
473
- `Waiting ${formatDuration(elapsedMs)} for ${runs.length} async run(s) and ${providerCount} provider item(s).`,
474
- ...activity,
475
- ].join(" · ");
476
- return result([headline, runs.length > 0 ? formatAsyncRunList(runs) : ""].filter(Boolean).join("\n"));
477
- }
478
-
479
- const TRANSCRIPT_TAIL_BYTES = 128 * 1024;
480
- const TRANSCRIPT_PREVIEW_LINES = 3;
481
- const TRANSCRIPT_PREVIEW_WIDTH = 220;
482
-
483
- interface TranscriptActivity {
484
- currentTool?: string;
485
- currentToolArgs?: string;
486
- latestAt?: number;
487
- recent: string[];
488
- }
489
-
490
- function compactTranscriptText(value: unknown, maxWidth = TRANSCRIPT_PREVIEW_WIDTH): string | undefined {
491
- if (typeof value !== "string") return undefined;
492
- const compact = value.replace(/\s+/g, " ").trim();
493
- if (!compact) return undefined;
494
- return compact.length <= maxWidth ? compact : `${compact.slice(0, Math.max(1, maxWidth - 1))}…`;
495
- }
496
-
497
- function readTranscriptActivity(transcriptPath: string | undefined): TranscriptActivity | undefined {
498
- if (!transcriptPath) return undefined;
499
- let fd: number | undefined;
500
- try {
501
- const stat = fs.statSync(transcriptPath);
502
- if (!stat.isFile() || stat.size <= 0) return undefined;
503
- const start = Math.max(0, stat.size - TRANSCRIPT_TAIL_BYTES);
504
- const length = stat.size - start;
505
- const buffer = Buffer.allocUnsafe(length);
506
- fd = fs.openSync(transcriptPath, "r");
507
- const bytesRead = fs.readSync(fd, buffer, 0, length, start);
508
- let lines = buffer.subarray(0, bytesRead).toString("utf-8").split(/\r?\n/);
509
- if (start > 0) lines = lines.slice(1); // The first tail line may be partial JSON.
510
-
511
- let currentTool: string | undefined;
512
- let currentToolArgs: string | undefined;
513
- let latestAt: number | undefined;
514
- const recent: string[] = [];
515
- for (const line of lines) {
516
- if (!line.trim()) continue;
517
- let record: Record<string, unknown>;
518
- try {
519
- record = JSON.parse(line) as Record<string, unknown>;
520
- } catch {
521
- continue; // Concurrent append can leave the final line temporarily incomplete.
522
- }
523
- if (typeof record.ts === "number" && Number.isFinite(record.ts)) latestAt = record.ts;
524
- if (record.recordType === "tool_start" && typeof record.toolName === "string") {
525
- currentTool = record.toolName;
526
- currentToolArgs = compactTranscriptText(record.argsPreview, 140);
527
- const preview = currentToolArgs ? `${currentTool}: ${currentToolArgs}` : currentTool;
528
- recent.push(`tool: ${preview}`);
529
- continue;
530
- }
531
- if (record.recordType === "tool_end") {
532
- currentTool = undefined;
533
- currentToolArgs = undefined;
534
- continue;
535
- }
536
- if (record.recordType === "message") {
537
- if (record.sourceEventType === "initial_prompt" || record.role === "user") continue;
538
- const text = compactTranscriptText(record.text);
539
- if (text) recent.push(`${typeof record.role === "string" ? record.role : "message"}: ${text}`);
540
- continue;
541
- }
542
- if (record.recordType === "stdout" || record.recordType === "stderr") {
543
- const text = compactTranscriptText(record.text);
544
- if (text) recent.push(`${record.recordType}: ${text}`);
545
- }
546
- }
547
- return { currentTool, currentToolArgs, latestAt, recent: recent.slice(-TRANSCRIPT_PREVIEW_LINES) };
548
- } catch {
549
- return undefined;
550
- } finally {
551
- if (fd !== undefined) {
552
- try { fs.closeSync(fd); } catch { /* best-effort close */ }
553
- }
554
- }
555
- }
556
-
557
- function detachedForegroundWaitUpdate(run: ForegroundResumeRun, pendingIndices: Set<number>, nowMs: number, elapsedMs: number): AgentToolResult<Details> {
558
- const lines = [`Waiting for detached foreground run "${run.runId}" · ${formatDuration(elapsedMs)}`];
559
- for (const child of run.children) {
560
- if (!pendingIndices.has(child.index) || child.status !== "detached") continue;
561
- const activity = readTranscriptActivity(child.transcriptPath);
562
- const age = activity?.latestAt !== undefined ? ` · activity ${formatDuration(Math.max(0, nowMs - activity.latestAt))} ago` : "";
563
- lines.push(`${child.agent} · working after supervisor handoff${age}`);
564
- if (activity?.currentTool) {
565
- lines.push(` current: ${activity.currentTool}${activity.currentToolArgs ? `: ${activity.currentToolArgs}` : ""}`);
566
- }
567
- for (const preview of activity?.recent ?? []) lines.push(` ${preview}`);
568
- if (!activity && child.transcriptPath) lines.push(" live transcript has no new activity yet");
569
- if (!child.transcriptPath) lines.push(" live transcript unavailable; waiting for completion event");
570
- }
571
- return result(lines.join("\n"));
572
- }
573
-
574
- async function waitForDetachedForegroundRun(
575
- run: ForegroundResumeRun,
576
- signal: AbortSignal | undefined,
577
- deps: SubagentWaitDeps,
578
- startedAt: number,
579
- now: () => number,
580
- pollIntervalMs: number,
581
- timeoutMs: number,
582
- yieldWait: (reason: WaitYieldReason) => AgentToolResult<Details>,
583
- ): Promise<AgentToolResult<Details>> {
584
- const wake = wakeSignal(signal, deps);
585
- const initialDetachedIndices = new Set(run.children.filter((child) => child.status === "detached").map((child) => child.index));
586
- while (true) {
587
- if (deps.state.currentSessionId !== run.sessionId) {
588
- return 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. Reply to any pending supervisor request before resuming or launching a replacement.`, true);
589
- }
590
- const current = deps.state.foregroundRuns?.get(run.runId);
591
- if (!current || current.sessionId !== run.sessionId) {
592
- return 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);
593
- }
594
- if (deps.hasPendingSupervisorRequest?.()) return yieldWait("supervisor_request");
595
- if (deps.userInputSignal?.aborted) return yieldWait("user_input");
596
- const pending = current.children.filter((child) => initialDetachedIndices.has(child.index) && child.status === "detached");
597
- const attention = foregroundChildrenNeedingAttention(current, initialDetachedIndices);
598
- if (attention.length > 0) return formatForegroundAttention(current, attention, now() - startedAt);
599
- if (pending.length === 0) {
600
- const outcome = summarizeForegroundChildren(current, initialDetachedIndices);
601
- return result(
602
- `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.`,
603
- );
604
- }
605
- const updateNow = now();
606
- deps.onUpdate?.(detachedForegroundWaitUpdate(current, initialDetachedIndices, updateNow, updateNow - startedAt));
607
- if (signal?.aborted) {
608
- return result(`Wait aborted after ${formatDuration(now() - startedAt)}. Remembered foreground run "${run.runId}" remains detached. Reply to any pending supervisor request before resuming or launching a replacement.`, true);
609
- }
610
- if (now() - startedAt >= timeoutMs) {
611
- return windowElapsedResult(
612
- `Wait window elapsed after ${formatDuration(timeoutMs)} with remembered foreground run "${run.runId}" still detached. Reply to any pending supervisor request, then call bg_wait({ id: "${run.runId}" }) again or inspect status; do not resume or launch a replacement while it remains detached.`,
613
- [run.runId],
614
- );
615
- }
616
- await waitForWake(pollIntervalMs, wake, deps);
617
- }
618
- }
619
-
620
- async function waitForSessionDetachedForegroundRuns(
621
- runs: ForegroundResumeRun[],
622
- signal: AbortSignal | undefined,
623
- deps: SubagentWaitDeps,
624
- startedAt: number,
625
- now: () => number,
626
- pollIntervalMs: number,
627
- timeoutMs: number,
628
- yieldWait: (reason: WaitYieldReason) => AgentToolResult<Details>,
629
- ): Promise<AgentToolResult<Details>> {
630
- const texts: string[] = [];
631
- for (const run of runs) {
632
- const one = await waitForDetachedForegroundRun(run, signal, deps, startedAt, now, pollIntervalMs, timeoutMs, yieldWait);
633
- if (one.isError) return one;
634
- if (one.details.wait && one.details.wait.reason !== "window_elapsed") return one;
635
- if (one.details.wait?.reason === "window_elapsed") {
636
- const activeRunIds = runs.filter((initial) => {
637
- const current = deps.state.foregroundRuns?.get(initial.runId);
638
- if (!current || current.sessionId !== initial.sessionId) return false;
639
- return initial.children.some((child) => child.status === "detached"
640
- && current.children.some((candidate) => candidate.index === child.index && candidate.status === "detached"));
641
- }).map((activeRun) => activeRun.runId);
642
- return windowElapsedResult(
643
- one.content.map((part) => part.type === "text" ? part.text : "").join("\n"),
644
- activeRunIds,
645
- );
646
- }
647
- texts.push(one.content.map((part) => part.type === "text" ? part.text : "").join("\n").trim());
648
- }
649
- return result(texts.filter(Boolean).join("\n") || `Waited ${formatDuration(now() - startedAt)} for remembered detached foreground run(s); done.`);
650
- }
651
-
652
- /**
653
- * Block until the targeted async or remembered detached foreground run finishes,
654
- * the timeout elapses, or the turn is aborted. Resolves with a short
655
- * human-readable summary either way.
656
- */
657
- export async function waitForSubagents(
658
- params: SubagentWaitParams,
659
- signal: AbortSignal | undefined,
660
- deps: SubagentWaitDeps,
661
- ): Promise<AgentToolResult<Details>> {
662
- if (deps.enabled === false) {
663
- return result("bg_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.");
664
- }
665
- if (!deps.state.currentSessionId) {
666
- return result("bg_wait requires an active session identity to scope background work safely.", true);
667
- }
668
-
669
- const now = deps.now ?? Date.now;
670
- const pollIntervalMs = Math.max(MIN_POLL_INTERVAL_MS, deps.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
671
- const timeoutMs = params.timeoutMs !== undefined && params.timeoutMs > 0
672
- ? params.timeoutMs
673
- : deps.defaultTimeoutMs ?? DEFAULT_TIMEOUT_MS;
674
- const startedAt = now();
675
- const sessionId = deps.state.currentSessionId;
676
- const waitForAll = params.id ? true : params.all === true;
677
- if (params.nonBlocking && !params.id) {
678
- return result("Non-blocking wait subscriptions require id so the registration can bind one exact run identity.", true);
679
- }
680
- if (params.nonBlocking && params.all) {
681
- return result("nonBlocking cannot be combined with all; subscribe to one exact run id.", true);
682
- }
683
-
684
- let active: AsyncRunSummary[];
685
- let foreground: ForegroundResumeRun[];
686
- let providerSnapshot: BackgroundWorkSnapshot;
687
- try {
688
- active = runsForSession(params, deps, !params.id);
689
- foreground = activeDetachedForegroundRuns(params, deps).map((run) => ({
690
- ...run,
691
- children: run.children.map((child) => ({ ...child })),
692
- }));
693
- providerSnapshot = params.id ? { providers: [], items: [] } : backgroundWorkForSession(deps, startedAt);
694
- } catch (error) {
695
- return result(error instanceof Error ? error.message : String(error), true);
696
- }
697
-
698
- let selectedForeground: ForegroundResumeRun | undefined;
699
- if (params.id) {
700
- const candidates = [
701
- ...active.map((run) => ({ kind: "async" as const, id: run.id, run })),
702
- ...foreground.map((run) => ({ kind: "foreground" as const, id: run.runId, run })),
703
- ];
704
- const exact = candidates.filter((candidate) => candidate.id === params.id);
705
- const matches = exact.length > 0 ? exact : candidates;
706
- if (matches.length > 1) {
707
- return result(`Ambiguous subagent run id prefix "${params.id}" matched ${matches.length} runs: ${matches.map((candidate) => candidate.id).join(", ")}. Pass a longer id.`, true);
708
- }
709
- const selected = matches[0];
710
- if (selected?.kind === "async" && !ACTIVE_STATES.includes(selected.run.state)) {
711
- try {
712
- const references: string[] = [];
713
- const completions = collectScopedCompletions([selected.run], deps, references);
714
- return result(
715
- `Run "${selected.id}" is terminal. Outcome: ${summarizeTerminalRuns([selected.run])}.${formatCompletionRecovery(completions)}${references.length ? `\n${references.join("\n")}` : ""}`,
716
- deps.failOnFailedRuns === true && (selected.run.state === "failed" || selected.run.state === "partial"), completions,
717
- );
718
- } catch (error) {
719
- return result(error instanceof Error ? error.message : String(error), true);
720
- }
721
- }
722
- if (selected && params.nonBlocking) {
723
- if (!deps.subscribe) {
724
- return result("Non-blocking wait subscriptions require a long-lived interactive subagent runtime; this runtime can only use blocking bg_wait calls.", true);
725
- }
726
- try {
727
- const registration = deps.subscribe({ targetKind: selected.kind, runId: selected.id, requestedId: params.id, timeoutMs });
728
- return result(`Armed wait subscription ${registration.token} for exact ${selected.kind} run ${selected.id}. Returning immediately; this session will be woken on completion, failure, attention, reconciliation failure, or timeout. Inspect armed subscriptions with subagent({ action: "status" }).`);
729
- } catch (error) {
730
- return result(error instanceof Error ? error.message : String(error), true);
731
- }
732
- }
733
- selectedForeground = selected?.kind === "foreground" ? selected.run : undefined;
734
- active = selected?.kind === "async" ? [selected.run] : [];
735
- }
736
-
737
- let providerActive = providerSnapshot.items;
738
- const scopedForeground = selectedForeground ? [selectedForeground] : params.id ? [] : foreground;
739
- const initialAsyncIds = new Set(active.map((run) => run.id));
740
- const initialProviderIds = new Set(providerActive.map(backgroundWorkIdentity));
741
- const initialScope: InitialWaitScope = {
742
- asyncRunIds: initialAsyncIds,
743
- foregroundRuns: scopedForeground.map((run) => ({
744
- runId: run.runId,
745
- sessionId: run.sessionId,
746
- detachedIndices: new Set(run.children.filter((child) => child.status === "detached").map((child) => child.index)),
747
- })),
748
- providerIds: initialProviderIds,
749
- };
750
- const yieldWait = (reason: WaitYieldReason) => yieldForScope(reason, initialScope, params, deps, now());
751
- const wake = wakeSignal(signal, deps);
752
- if (selectedForeground) {
753
- return waitForDetachedForegroundRun(selectedForeground, signal, deps, startedAt, now, pollIntervalMs, timeoutMs, yieldWait);
754
- }
755
- if (active.length === 0 && providerActive.length === 0) {
756
- if (waitForAll && !params.id && foreground.length > 0) {
757
- return waitForSessionDetachedForegroundRuns(foreground, signal, deps, startedAt, now, pollIntervalMs, timeoutMs, yieldWait);
758
- }
759
- return result(params.id
760
- ? `No active run matched "${params.id}". Nothing to wait for.`
761
- : "No active async runs or registered provider work in this session. Nothing to wait for.");
762
- }
763
- const waitParams = params.id ? { ...params, id: active[0]!.id } : params;
764
- const initialProviderNames = new Set(providerActive.map((item) => item.provider));
765
- const initialCount = initialAsyncIds.size + initialProviderIds.size;
766
- const stopOnAttention = params.stopOnAttention ?? deps.stopOnAttention !== false;
767
- let attention = active.filter((run) => needsAttention(run));
768
- let supervisorBarrier = false;
769
-
770
- const isDone = (): boolean => {
771
- if (deps.hasPendingSupervisorRequest?.()) {
772
- supervisorBarrier = true;
773
- return true;
774
- }
775
- if (attention.some((run) => initialAsyncIds.has(run.id) && (stopOnAttention || hasSupervisorTool(run)))) return true;
776
- const activeAsyncIds = new Set(active.map((run) => run.id));
777
- const activeProviderIds = new Set(providerActive.map(backgroundWorkIdentity));
778
- if (waitForAll) {
779
- return [...initialAsyncIds].every((id) => !activeAsyncIds.has(id))
780
- && [...initialProviderIds].every((id) => !activeProviderIds.has(id));
781
- }
782
- return [...initialAsyncIds].some((id) => !activeAsyncIds.has(id))
783
- || [...initialProviderIds].some((id) => !activeProviderIds.has(id));
784
- };
785
-
786
- while (!isDone()) {
787
- const activeInitialRuns = active.filter((run) => initialAsyncIds.has(run.id));
788
- const activeInitialProviderItems = providerActive.filter((item) => initialProviderIds.has(backgroundWorkIdentity(item)));
789
- const stillActive = [
790
- ...activeInitialRuns.map((run) => `${run.id} (${run.state})`),
791
- ...activeInitialProviderItems.map((item) => `${item.provider}/${item.id}`),
792
- ].join(", ");
793
- deps.onUpdate?.(asyncWaitUpdate(activeInitialRuns, activeInitialProviderItems.length, now() - startedAt));
794
- if (deps.userInputSignal?.aborted) return yieldWait("user_input");
795
- if (signal?.aborted) {
796
- return result(`Wait aborted after ${formatDuration(now() - startedAt)}. Still active: ${stillActive}.`, true);
797
- }
798
- if (now() - startedAt >= timeoutMs) {
799
- return windowElapsedResult(
800
- `Wait window elapsed after ${formatDuration(timeoutMs)} with ${activeInitialRuns.length} async run(s) and ${activeInitialProviderItems.length} provider item(s) still active: ${stillActive}. The work keeps going; call bg_wait again or inspect subagent status.`,
801
- activeInitialRuns.map((run) => run.id),
802
- activeInitialProviderItems,
803
- );
804
- }
805
- try {
806
- await waitForWake(pollIntervalMs, wake, deps);
807
- if (deps.state.currentSessionId !== sessionId) return result("Wait stopped because the active session changed.", true);
808
- active = activeRunsForSession(waitParams, deps);
809
- attention = attentionRunsForSession(waitParams, deps, initialAsyncIds);
810
- providerSnapshot = params.id ? providerSnapshot : backgroundWorkForSession(deps, now());
811
- for (const provider of initialProviderNames) {
812
- if (!providerSnapshot.providers.includes(provider)) {
813
- return result(`Background-work provider '${provider}' disappeared while bg_wait was tracking its active work; completion cannot be confirmed.`, true);
814
- }
815
- }
816
- providerActive = providerSnapshot.items;
817
- } catch (error) {
818
- return result(error instanceof Error ? error.message : String(error), true);
819
- }
820
- }
821
- if (supervisorBarrier) {
822
- return yieldWait("supervisor_request");
823
- }
824
-
825
- let terminalSummary: string;
826
- let finishedAsyncCount: number;
827
- let failedAsyncCount: number;
828
- let completions: WaitCompletion[] | undefined;
829
- let resumeGuidance = "";
830
- const references: string[] = [];
831
- const activeProviderIds = new Set(providerActive.map(backgroundWorkIdentity));
832
- const providerFinishedCount = [...initialProviderIds].filter((id) => !activeProviderIds.has(id)).length;
833
- try {
834
- const allNow = runsForIds(initialAsyncIds, deps);
835
- const terminal = allNow.filter((run) => !ACTIVE_STATES.includes(run.state) && initialAsyncIds.has(run.id));
836
- finishedAsyncCount = terminal.length;
837
- failedAsyncCount = terminal.filter((run) => run.state === "failed" || run.state === "partial").length;
838
- terminalSummary = summarizeTerminalRuns(terminal, providerFinishedCount);
839
- resumeGuidance = formatResumeFirstFailedRunsNote(terminal);
840
- completions = collectScopedCompletions(terminal, deps, references);
841
- } catch (error) {
842
- return result(error instanceof Error ? error.message : String(error), true);
843
- }
844
-
845
- const relevantAttention = attention.filter((run) => initialAsyncIds.has(run.id));
846
- const supervisorAttentionHint = relevantAttention.some(hasSupervisorTool)
847
- ? " Reply to any pending supervisor request. If subagent_supervisor({ action: \"pending\" }) is empty, check intercom({ action: \"pending\" }) because an external intercom tool may own the request."
848
- : "";
849
- const attentionNote = relevantAttention.length > 0
850
- ? ` ${relevantAttention.length} run(s) need attention: ${relevantAttention.map((run) => run.id).join(", ")} —${supervisorAttentionHint} inspect with subagent({ action: "status" }) then steer a top-level live async child, resume a paused/completed/failed child, or interrupt explicitly.`
851
- : "";
852
- const stillRunning = active.filter((run) => initialAsyncIds.has(run.id)).length
853
- + providerActive.filter((item) => initialProviderIds.has(backgroundWorkIdentity(item))).length;
854
- const elapsed = formatDuration(now() - startedAt);
855
- const outcome = terminalSummary ? ` Outcome: ${terminalSummary}.` : "";
856
- const recoveryNote = formatCompletionRecovery(completions) + (references.length ? `\n${references.join("\n")}\n` : "");
857
-
858
- if (waitForAll) {
859
- const foregroundResult = !params.id && foreground.length > 0 && relevantAttention.length === 0
860
- ? await waitForSessionDetachedForegroundRuns(foreground, signal, deps, startedAt, now, pollIntervalMs, timeoutMs, yieldWait)
861
- : undefined;
862
- if (foregroundResult?.isError) return foregroundResult;
863
- if (foregroundResult?.details.wait) return foregroundResult;
864
- const foregroundNote = foregroundResult
865
- ? `\n${foregroundResult.content.map((part) => part.type === "text" ? part.text : "").join("\n")}`
866
- : "";
867
- const scope = params.id
868
- ? `run "${params.id}"`
869
- : initialProviderIds.size === 0
870
- ? `${initialAsyncIds.size} async run(s)`
871
- : `${initialAsyncIds.size} async run(s) and ${initialProviderIds.size} provider item(s)`;
872
- const status = relevantAttention.length > 0 ? "attention required" : "done";
873
- return result(
874
- `Waited ${elapsed} for ${scope}; ${status}.${outcome}${recoveryNote}${resumeGuidance}${attentionNote}${foregroundNote} Completion/control events have been observed; inspect status if a notification is not visible yet.`,
875
- (deps.failOnFailedRuns === true && failedAsyncCount > 0) || (deps.failOnAttention === true && relevantAttention.length > 0),
876
- completions,
877
- );
878
- }
879
-
880
- const finishedCount = finishedAsyncCount + providerFinishedCount;
881
- const subject = initialProviderIds.size === 0 ? "run(s)" : "item(s)";
882
- const remainder = stillRunning > 0
883
- ? ` ${stillRunning} ${subject} still in flight — call bg_wait again to catch the next one.`
884
- : relevantAttention.length > 0
885
- ? " No other work is waitable until attention is handled."
886
- : initialProviderIds.size === 0 ? " No runs remain in flight." : " No work remains in flight.";
887
- const progress = relevantAttention.length > 0 && finishedCount === 0
888
- ? `${relevantAttention.length} of ${initialCount} ${subject} need attention`
889
- : `${finishedCount} of ${initialCount} ${subject} finished`;
890
- return result(
891
- `Waited ${elapsed}; ${progress}.${outcome}${recoveryNote}${resumeGuidance}${attentionNote}${remainder} Relevant completion/control events have been observed; inspect status if a notification is not visible yet.`,
892
- (deps.failOnFailedRuns === true && failedAsyncCount > 0) || (deps.failOnAttention === true && relevantAttention.length > 0),
893
- completions,
894
- );
895
- }