@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
@@ -0,0 +1,926 @@
1
+ import * as fs from "node:fs";
2
+ import * as path from "node:path";
3
+ import { renderWidget, widgetRenderKey } from "../../tui/render.js";
4
+ import { formatControlNoticeMessage } from "../shared/subagent-control.js";
5
+ import { DIRS, SUBAGENT_CHILD_STATUS_EVENT, SUBAGENT_CONTROL_EVENT, SUBAGENT_CONTROL_INTERCOM_EVENT, SUBAGENT_JOBS_CHANGED_EVENT, SUBAGENT_STEERING_NOTICE_EVENT, WIDGET_ANIMATION_INTERVAL_MS, } from "../../shared/types.js";
6
+ import { readStatus, resolveWatchPath } from "../../shared/utils.js";
7
+ import { normalizeParallelGroups } from "./parallel-groups.js";
8
+ import { reconcileAsyncRun, reconcileNestedAsyncDescendants } from "./stale-run-reconciler.js";
9
+ import { findNestedRouteForRootId, hasLiveNestedDescendants, retainNestedLookupRoute, updateAsyncJobNestedProjection } from "../shared/nested-events.js";
10
+ import { listAsyncRuns } from "./async-status.js";
11
+ import { EXTERNAL_JOB_BRIDGE_REQUEST_DIR, externalJobBridgeEligibility, serviceExternalJobBridgeRequests } from "../shared/external-job-bridge.js";
12
+ import { shouldUseNativeFsWatch } from "../../shared/watch-strategy.js";
13
+ import { parseWorkflowChildSummary } from "../../workflows/workflow-child-summary.js";
14
+ import { withWorkflowChildRunModel } from "./workflow-terminal-proof.js";
15
+ import { validHostStepNodes } from "../shared/host-step-status.js";
16
+ import { readProcessTerminal } from "./process-terminal.js";
17
+ import { withCachedUiContext } from "../../shared/extension-context.js";
18
+ import { OWNING_SESSION_COMPLETION_OWNER } from "../../shared/completion-owner.js";
19
+ const CONTROL_EVENT_READ_CHUNK_BYTES = 64 * 1024;
20
+ const MAX_CONTROL_EVENT_LINE_BYTES = 1024 * 1024;
21
+ const CONTROL_EVENT_SCAN_WINDOW_BYTES = 2 * 1024 * 1024;
22
+ const MAX_RECENT_FLEET_JOBS = 20;
23
+ const DEFAULT_LIVENESS_INTERVAL_MS = 5000;
24
+ const EVENT_REFRESH_DEBOUNCE_MS = 25;
25
+ const WATCH_ATTACHMENT_RETRY_MS = 100;
26
+ /** A native supervisor request is already its own parent turn; its attention notice only escalates an unanswered one. */
27
+ const SUPERVISOR_NOTICE_GRACE_MS = 60_000;
28
+ const isTerminalJobStatus = (status) => status === "complete" || status === "failed" || status === "partial" || status === "paused" || status === "rejected" || status === "stopped";
29
+ function rememberFleetJob(state, job) {
30
+ state.fleetJobs ??= new Map();
31
+ state.fleetJobs.set(job.asyncId, job);
32
+ const terminal = [...state.fleetJobs.values()]
33
+ .filter((candidate) => isTerminalJobStatus(candidate.status))
34
+ .sort((left, right) => (right.updatedAt ?? right.startedAt ?? 0) - (left.updatedAt ?? left.startedAt ?? 0));
35
+ for (const stale of terminal.slice(MAX_RECENT_FLEET_JOBS))
36
+ state.fleetJobs.delete(stale.asyncId);
37
+ }
38
+ export function createAsyncJobTracker(pi, state, asyncDirRoot, options = {}) {
39
+ const completionRetentionMs = options.completionRetentionMs ?? 10000;
40
+ const livenessIntervalMs = options.pollIntervalMs ?? DEFAULT_LIVENESS_INTERVAL_MS;
41
+ const resultsDir = options.resultsDir ?? DIRS.results;
42
+ const steeringNoticeSeen = new Map();
43
+ const jobWatchers = new Map();
44
+ const refreshTimers = new Map();
45
+ let widgetRerenderTimer;
46
+ const runningJobIds = new Set();
47
+ const externalJobBridgeRuns = new Set();
48
+ // Early native failure is visible before its publisher finishes. Retain only
49
+ // that scoped observation, using the existing liveness sweep to renew delivery.
50
+ const terminalPublications = new Map();
51
+ const supervisorNoticeTimers = new Map();
52
+ let rootWatcher;
53
+ let nextLivenessAt = Date.now() + livenessIntervalMs;
54
+ let nextWidgetAnimationAt = Date.now() + WIDGET_ANIMATION_INTERVAL_MS;
55
+ const watch = options.watch ?? fs.watch;
56
+ const useNativeWatcher = () => shouldUseNativeFsWatch("async-job-tracker", options.platform);
57
+ const withLastUiContext = (run) => {
58
+ const cached = state.lastUiContext;
59
+ return withCachedUiContext(cached, () => {
60
+ if (state.lastUiContext === cached)
61
+ state.lastUiContext = null;
62
+ }, run);
63
+ };
64
+ const rerenderWidget = (ctx, jobs = Array.from(state.asyncJobs.values())) => {
65
+ options.onJobsChanged?.();
66
+ pi.events.emit(SUBAGENT_JOBS_CHANGED_EVENT, { version: 1 });
67
+ if (state.widgetsSuspended)
68
+ return;
69
+ renderWidget(ctx, options.widgetEnabled === false ? [] : jobs, options.widgetCollapsed, options.widgetLayout);
70
+ ctx.ui.requestRender?.();
71
+ };
72
+ const rerenderLastWidget = (jobs = Array.from(state.asyncJobs.values())) => {
73
+ withLastUiContext((ctx) => rerenderWidget(ctx, jobs));
74
+ };
75
+ const scheduleLastWidgetRerender = () => {
76
+ if (widgetRerenderTimer)
77
+ return;
78
+ widgetRerenderTimer = setTimeout(() => {
79
+ widgetRerenderTimer = undefined;
80
+ rerenderLastWidget();
81
+ }, EVENT_REFRESH_DEBOUNCE_MS);
82
+ widgetRerenderTimer.unref?.();
83
+ };
84
+ const requestLastWidgetRender = () => {
85
+ if (options.widgetEnabled === false)
86
+ return;
87
+ withLastUiContext((ctx) => {
88
+ if (state.widgetsSuspended)
89
+ return;
90
+ const requestRender = ctx.ui.requestRender;
91
+ if (requestRender)
92
+ requestRender.call(ctx.ui);
93
+ else
94
+ renderWidget(ctx, Array.from(state.asyncJobs.values()), options.widgetCollapsed, options.widgetLayout);
95
+ });
96
+ };
97
+ const refreshWidget = (ctx) => rerenderWidget(ctx);
98
+ const restoredControlEventCursor = (asyncDir) => {
99
+ try {
100
+ return fs.statSync(path.join(asyncDir, "events.jsonl")).size;
101
+ }
102
+ catch (error) {
103
+ if (error.code === "ENOENT")
104
+ return 0;
105
+ throw error;
106
+ }
107
+ };
108
+ const findNestedRouteForJob = (runId) => {
109
+ try {
110
+ return findNestedRouteForRootId(runId);
111
+ }
112
+ catch (error) {
113
+ console.error(`Failed to resolve nested event route for '${runId}':`, error);
114
+ return undefined;
115
+ }
116
+ };
117
+ const summaryToJob = (run) => {
118
+ const groups = normalizeParallelGroups(run.parallelGroups, run.steps.length, run.chainStepCount ?? run.steps.length);
119
+ const activeGroup = run.currentStep !== undefined
120
+ ? groups.find((group) => run.currentStep >= group.start && run.currentStep < group.start + group.count)
121
+ : undefined;
122
+ const visibleSteps = activeGroup
123
+ ? run.steps.slice(activeGroup.start, activeGroup.start + activeGroup.count).map((step, index) => ({ ...step, index: activeGroup.start + index }))
124
+ : run.steps.map((step, index) => ({ ...step, index }));
125
+ return {
126
+ asyncId: run.id,
127
+ asyncDir: run.asyncDir,
128
+ toolCallId: run.toolCallId,
129
+ status: run.state,
130
+ sessionId: run.sessionId,
131
+ completionOwnerId: run.completionOwnerId,
132
+ activityState: run.activityState,
133
+ lastActivityAt: run.lastActivityAt,
134
+ currentTool: run.currentTool,
135
+ currentToolStartedAt: run.currentToolStartedAt,
136
+ currentPath: run.currentPath,
137
+ turnCount: run.turnCount,
138
+ toolCount: run.toolCount,
139
+ steering: run.steering,
140
+ mode: run.mode,
141
+ scheduleOrigin: run.scheduleOrigin,
142
+ context: run.context,
143
+ cwd: run.cwd,
144
+ sessionRoot: run.sessionRoot,
145
+ agents: visibleSteps.map((step) => step.agent),
146
+ currentStep: run.currentStep,
147
+ chainStepCount: run.chainStepCount,
148
+ parallelGroups: groups,
149
+ hostSteps: run.hostSteps,
150
+ ...(run.mode === "workflow" && run.workflowGraph ? { workflowGraph: run.workflowGraph } : {}),
151
+ preflight: run.preflight,
152
+ steps: visibleSteps,
153
+ stepsTotal: visibleSteps.length,
154
+ runningSteps: visibleSteps.filter((step) => step.status === "running").length,
155
+ completedSteps: visibleSteps.filter((step) => step.status === "complete" || step.status === "completed").length,
156
+ hasParallelGroups: groups.length > 0,
157
+ activeParallelGroup: Boolean(activeGroup),
158
+ startedAt: run.startedAt,
159
+ updatedAt: run.lastUpdate ?? run.startedAt,
160
+ timeoutMs: run.timeoutMs,
161
+ deadlineAt: run.deadlineAt,
162
+ timedOut: run.timedOut,
163
+ stopped: run.stopped,
164
+ turnBudget: run.turnBudget,
165
+ turnBudgetExceeded: run.turnBudgetExceeded,
166
+ wrapUpRequested: run.wrapUpRequested,
167
+ sessionDir: run.sessionDir,
168
+ outputFile: run.outputFile,
169
+ totalTokens: run.totalTokens,
170
+ sessionFile: run.sessionFile,
171
+ controlEventCursor: restoredControlEventCursor(run.asyncDir),
172
+ nestedRoute: findNestedRouteForJob(run.id),
173
+ nestedChildren: run.nestedChildren,
174
+ parentWorkflowRunId: run.parentWorkflowRunId,
175
+ workflowKey: run.workflowKey,
176
+ workflow: run.workflow,
177
+ workflowChildren: parseWorkflowChildSummary(run.workflowChildren),
178
+ };
179
+ };
180
+ const cancelCleanup = (asyncId) => {
181
+ const existingTimer = state.cleanupTimers.get(asyncId);
182
+ if (!existingTimer)
183
+ return;
184
+ clearTimeout(existingTimer);
185
+ state.cleanupTimers.delete(asyncId);
186
+ };
187
+ const scheduleCleanup = (asyncId) => {
188
+ cancelCleanup(asyncId);
189
+ const timer = setTimeout(() => {
190
+ state.cleanupTimers.delete(asyncId);
191
+ closeJobWatcher(asyncId);
192
+ const job = state.asyncJobs.get(asyncId);
193
+ retainNestedLookupRoute(state, job?.nestedRoute, job?.sessionId);
194
+ state.asyncJobs.delete(asyncId);
195
+ options.onJobCleanup?.(asyncId);
196
+ rerenderLastWidget();
197
+ }, completionRetentionMs);
198
+ state.cleanupTimers.set(asyncId, timer);
199
+ };
200
+ const deliverControlRecord = (record, payload) => {
201
+ if (record.channels.includes("event")) {
202
+ pi.events.emit(SUBAGENT_CONTROL_EVENT, payload);
203
+ }
204
+ if (record.event.type !== "active_long_running" && record.channels.includes("intercom") && record.intercom?.to && record.intercom.message) {
205
+ pi.events.emit(SUBAGENT_CONTROL_INTERCOM_EVENT, {
206
+ ...payload,
207
+ to: record.intercom.to,
208
+ message: record.intercom.message,
209
+ });
210
+ }
211
+ };
212
+ const readSupervisorRequestState = (event, asyncDir) => {
213
+ try {
214
+ return options.supervisorRequestState?.(event) ?? "unknown";
215
+ }
216
+ catch (error) {
217
+ console.error(`Failed to resolve supervisor request state for async control event in '${asyncDir}':`, error);
218
+ return "unknown";
219
+ }
220
+ };
221
+ const scheduleSupervisorNotice = (asyncId, record, payload) => {
222
+ const key = `${asyncId}:${record.event.index}:${record.event.toolCallId}`;
223
+ if (supervisorNoticeTimers.has(key))
224
+ return;
225
+ const timer = setTimeout(() => {
226
+ supervisorNoticeTimers.delete(key);
227
+ const job = state.asyncJobs.get(asyncId);
228
+ if (job?.status !== "running" && job?.status !== "queued")
229
+ return;
230
+ if (readSupervisorRequestState(record.event, payload.asyncDir) === "resolved")
231
+ return;
232
+ deliverControlRecord(record, payload);
233
+ }, SUPERVISOR_NOTICE_GRACE_MS);
234
+ timer.unref?.();
235
+ supervisorNoticeTimers.set(key, { asyncId, timer });
236
+ };
237
+ const clearSupervisorNotices = (asyncId) => {
238
+ for (const [key, entry] of supervisorNoticeTimers) {
239
+ if (asyncId !== undefined && entry.asyncId !== asyncId)
240
+ continue;
241
+ clearTimeout(entry.timer);
242
+ supervisorNoticeTimers.delete(key);
243
+ }
244
+ };
245
+ const emitNewControlEvents = (job) => {
246
+ const eventsPath = path.join(job.asyncDir, "events.jsonl");
247
+ let fd;
248
+ try {
249
+ fd = fs.openSync(eventsPath, "r");
250
+ }
251
+ catch (error) {
252
+ if (error.code === "ENOENT")
253
+ return;
254
+ console.error(`Failed to open async control events for '${job.asyncDir}':`, error);
255
+ return;
256
+ }
257
+ try {
258
+ const stat = fs.fstatSync(fd);
259
+ const savedCursor = job.controlEventCursor;
260
+ let cursor = stat.size < (savedCursor ?? 0) ? 0 : (savedCursor ?? 0);
261
+ const startedFromTail = savedCursor === undefined && stat.size > CONTROL_EVENT_SCAN_WINDOW_BYTES;
262
+ if (startedFromTail)
263
+ cursor = stat.size - CONTROL_EVENT_SCAN_WINDOW_BYTES;
264
+ if (stat.size <= cursor)
265
+ return;
266
+ const previousByte = Buffer.alloc(1);
267
+ const startsMidLine = cursor > 0
268
+ && fs.readSync(fd, previousByte, 0, 1, cursor - 1) === 1
269
+ && previousByte[0] !== 0x0a;
270
+ const scanEnd = Math.min(stat.size, cursor + CONTROL_EVENT_SCAN_WINDOW_BYTES);
271
+ const handleLine = (line) => {
272
+ if (!line.trim())
273
+ return;
274
+ let parsed;
275
+ try {
276
+ parsed = JSON.parse(line);
277
+ }
278
+ catch (error) {
279
+ console.error(`Ignoring malformed async control event in '${eventsPath}':`, error);
280
+ return;
281
+ }
282
+ if (!parsed || typeof parsed !== "object")
283
+ return;
284
+ if (parsed.type === "subagent.child-status") {
285
+ const event = parsed;
286
+ if (event.version !== 1 || typeof event.runId !== "string" || typeof event.childId !== "string" || (event.status !== "started" && event.status !== "stopping" && event.status !== "stopped") || typeof event.ts !== "number")
287
+ return;
288
+ try {
289
+ pi.events.emit(SUBAGENT_CHILD_STATUS_EVENT, {
290
+ type: "subagent.child-status",
291
+ version: 1,
292
+ runId: event.runId,
293
+ childId: event.childId,
294
+ status: event.status,
295
+ ts: event.ts,
296
+ ...(typeof event.reason === "string" ? { reason: event.reason } : {}),
297
+ source: event.source === "rpc" ? "rpc" : "async",
298
+ asyncDir: job.asyncDir,
299
+ ...(typeof event.stepIndex === "number" ? { stepIndex: event.stepIndex } : {}),
300
+ ...(typeof event.agent === "string" ? { agent: event.agent } : {}),
301
+ ...(typeof event.childRunId === "string" ? { childRunId: event.childRunId } : {}),
302
+ ...(typeof event.workflowKey === "string" ? { workflowKey: event.workflowKey } : {}),
303
+ ...(typeof event.phase === "string" ? { phase: event.phase } : {}),
304
+ ...(typeof event.label === "string" ? { label: event.label } : {}),
305
+ });
306
+ }
307
+ catch (error) {
308
+ console.error("Failed to emit async child status event:", error);
309
+ }
310
+ return;
311
+ }
312
+ if (parsed.type === "subagent.steering.notice") {
313
+ const notice = parsed;
314
+ if (typeof notice.requestId !== "string" || typeof notice.runId !== "string" || (notice.state !== "failed" && notice.state !== "partial" && notice.state !== "recovered") || typeof notice.message !== "string")
315
+ return;
316
+ if (typeof state.currentSessionId === "string" && notice.currentSessionId !== state.currentSessionId)
317
+ return;
318
+ const key = `${notice.runId}:${notice.requestId}:${notice.state}`;
319
+ if (steeringNoticeSeen.has(key))
320
+ return;
321
+ const now = Date.now();
322
+ steeringNoticeSeen.set(key, now);
323
+ if (steeringNoticeSeen.size > 200) {
324
+ for (const [seenKey, seenAt] of steeringNoticeSeen) {
325
+ if (now - seenAt > 10 * 60 * 1000 || steeringNoticeSeen.size > 200)
326
+ steeringNoticeSeen.delete(seenKey);
327
+ }
328
+ }
329
+ pi.events.emit(SUBAGENT_STEERING_NOTICE_EVENT, { ...notice, source: "async", asyncDir: job.asyncDir, noticeText: notice.message });
330
+ return;
331
+ }
332
+ if (parsed.type !== "subagent.control")
333
+ return;
334
+ const candidate = parsed;
335
+ if (!candidate.event || !Array.isArray(candidate.channels))
336
+ return;
337
+ // SAFETY: event is present and channels is an array; every other ControlRecord field is optional.
338
+ const record = candidate;
339
+ const supervisorRequest = record.event.type === "needs_attention" && record.event.reason === "supervisor_request" && options.supervisorRequestState !== undefined;
340
+ if (supervisorRequest && readSupervisorRequestState(record.event, job.asyncDir) === "resolved")
341
+ return;
342
+ const payload = {
343
+ event: record.event,
344
+ source: "async",
345
+ asyncDir: job.asyncDir,
346
+ childIntercomTarget: record.childIntercomTarget,
347
+ noticeText: record.noticeText ?? formatControlNoticeMessage(record.event, record.childIntercomTarget),
348
+ };
349
+ // External intercom asks have no native lifecycle to re-check, so they keep the immediate notice.
350
+ if (supervisorRequest && record.event.currentTool !== "intercom") {
351
+ // Status and waits still react now; the parent notice and intercom copy wait for the grace period.
352
+ if (record.channels.includes("event"))
353
+ pi.events.emit(SUBAGENT_CONTROL_EVENT, { ...payload, noticeDeferred: true });
354
+ scheduleSupervisorNotice(job.asyncId, record, payload);
355
+ return;
356
+ }
357
+ deliverControlRecord(record, payload);
358
+ };
359
+ let readCursor = cursor;
360
+ let lastCompleteCursor = cursor;
361
+ let lineParts = [];
362
+ let lineBytes = 0;
363
+ let skippingOversizedLine = startedFromTail || startsMidLine;
364
+ const appendLineSegment = (segment) => {
365
+ if (segment.length === 0 || skippingOversizedLine)
366
+ return;
367
+ if (lineBytes + segment.length > MAX_CONTROL_EVENT_LINE_BYTES) {
368
+ lineParts = [];
369
+ lineBytes = 0;
370
+ skippingOversizedLine = true;
371
+ return;
372
+ }
373
+ lineParts.push(segment);
374
+ lineBytes += segment.length;
375
+ };
376
+ while (readCursor < scanEnd) {
377
+ const toRead = Math.min(CONTROL_EVENT_READ_CHUNK_BYTES, scanEnd - readCursor);
378
+ const buffer = Buffer.alloc(toRead);
379
+ const bytesRead = fs.readSync(fd, buffer, 0, toRead, readCursor);
380
+ if (bytesRead <= 0)
381
+ break;
382
+ const chunk = bytesRead === buffer.length ? buffer : buffer.subarray(0, bytesRead);
383
+ let lineStart = 0;
384
+ for (let index = 0; index < chunk.length; index++) {
385
+ if (chunk[index] !== 0x0a)
386
+ continue;
387
+ appendLineSegment(chunk.subarray(lineStart, index));
388
+ if (!skippingOversizedLine && lineBytes > 0) {
389
+ handleLine(Buffer.concat(lineParts, lineBytes).toString("utf-8"));
390
+ }
391
+ lineParts = [];
392
+ lineBytes = 0;
393
+ skippingOversizedLine = false;
394
+ lastCompleteCursor = readCursor + index + 1;
395
+ lineStart = index + 1;
396
+ }
397
+ appendLineSegment(chunk.subarray(lineStart));
398
+ readCursor += bytesRead;
399
+ if (skippingOversizedLine)
400
+ job.controlEventCursor = readCursor;
401
+ }
402
+ if (lastCompleteCursor > cursor)
403
+ job.controlEventCursor = lastCompleteCursor;
404
+ else if (scanEnd < stat.size || startedFromTail)
405
+ job.controlEventCursor = scanEnd;
406
+ }
407
+ catch (error) {
408
+ console.error(`Failed to read async control events for '${job.asyncDir}':`, error);
409
+ }
410
+ finally {
411
+ fs.closeSync(fd);
412
+ }
413
+ };
414
+ const closeJobWatcher = (asyncId) => {
415
+ const watched = jobWatchers.get(asyncId);
416
+ if (watched?.retryTimer)
417
+ clearTimeout(watched.retryTimer);
418
+ for (const watcher of watched?.watchers.values() ?? [])
419
+ watcher.close();
420
+ jobWatchers.delete(asyncId);
421
+ const timer = refreshTimers.get(asyncId);
422
+ if (timer)
423
+ clearTimeout(timer);
424
+ refreshTimers.delete(asyncId);
425
+ runningJobIds.delete(asyncId);
426
+ externalJobBridgeRuns.delete(asyncId);
427
+ terminalPublications.delete(asyncId);
428
+ clearSupervisorNotices(asyncId);
429
+ };
430
+ const refreshJob = (job) => {
431
+ const widgetExpanded = withLastUiContext((ctx) => ctx.ui.getToolsExpanded?.() ?? false) ?? false;
432
+ const widgetStateBefore = widgetRenderKey(job, widgetExpanded);
433
+ let nestedRefreshFailed = false;
434
+ const refreshNestedProjection = () => {
435
+ try {
436
+ updateAsyncJobNestedProjection(job);
437
+ }
438
+ catch (error) {
439
+ nestedRefreshFailed = true;
440
+ console.error(`Failed to refresh nested async descendants for '${job.asyncDir}':`, error);
441
+ }
442
+ };
443
+ let bridgeSweepAttempted = false;
444
+ try {
445
+ emitNewControlEvents(job);
446
+ const bridgeAlreadyRequired = externalJobBridgeRuns.has(job.asyncId) || externalJobBridgeEligibility(job.steps) === "required";
447
+ if (bridgeAlreadyRequired) {
448
+ externalJobBridgeRuns.add(job.asyncId);
449
+ bridgeSweepAttempted = true;
450
+ serviceExternalJobBridgeRequests(job.asyncDir);
451
+ }
452
+ try {
453
+ if (job.nestedRoute)
454
+ reconcileNestedAsyncDescendants(job.nestedRoute, { resultsDir, kill: options.kill, now: options.now });
455
+ }
456
+ catch (error) {
457
+ nestedRefreshFailed = true;
458
+ console.error(`Failed to refresh nested async descendants for '${job.asyncDir}':`, error);
459
+ }
460
+ refreshNestedProjection();
461
+ const reconciliation = reconcileAsyncRun(job.asyncDir, {
462
+ resultsDir,
463
+ kill: options.kill,
464
+ now: options.now,
465
+ startedRun: {
466
+ runId: job.asyncId,
467
+ pid: job.pid,
468
+ sessionId: job.sessionId,
469
+ completionOwnerId: job.completionOwnerId,
470
+ mode: job.mode,
471
+ agents: job.agents,
472
+ chainStepCount: job.chainStepCount,
473
+ parallelGroups: job.parallelGroups,
474
+ startedAt: job.startedAt,
475
+ sessionFile: job.sessionFile,
476
+ },
477
+ });
478
+ const status = reconciliation.status ?? readStatus(job.asyncDir);
479
+ if (!bridgeAlreadyRequired) {
480
+ const bridgeEligibility = externalJobBridgeEligibility(status?.steps);
481
+ if (bridgeEligibility === "required")
482
+ externalJobBridgeRuns.add(job.asyncId);
483
+ // Missing or ambiguous status retains the legacy sweep for recovery races.
484
+ if (bridgeEligibility !== "not-required") {
485
+ bridgeSweepAttempted = true;
486
+ serviceExternalJobBridgeRequests(job.asyncDir);
487
+ }
488
+ }
489
+ if (status) {
490
+ const previousStatus = job.status;
491
+ job.status = status.state;
492
+ if (!isTerminalJobStatus(job.status))
493
+ terminalPublications.delete(job.asyncId);
494
+ if (job.status === "running")
495
+ runningJobIds.add(job.asyncId);
496
+ else
497
+ runningJobIds.delete(job.asyncId);
498
+ if (!isTerminalJobStatus(job.status))
499
+ cancelCleanup(job.asyncId);
500
+ job.sessionId = status.sessionId ?? job.sessionId;
501
+ job.completionOwnerId = status.completionOwnerId ?? job.completionOwnerId;
502
+ job.activityState = status.activityState;
503
+ job.lastActivityAt = status.lastActivityAt ?? job.lastActivityAt;
504
+ job.currentTool = status.currentTool;
505
+ job.currentToolStartedAt = status.currentToolStartedAt;
506
+ job.currentPath = status.currentPath;
507
+ job.turnCount = status.turnCount ?? job.turnCount;
508
+ job.toolCount = status.toolCount ?? job.toolCount;
509
+ job.steering = status.steering ?? job.steering;
510
+ job.mode = status.mode;
511
+ job.scheduleOrigin = status.scheduleOrigin ?? job.scheduleOrigin;
512
+ job.parentWorkflowRunId = status.parentWorkflowRunId ?? job.parentWorkflowRunId;
513
+ job.workflowKey = status.workflowKey ?? job.workflowKey;
514
+ job.lane = status.lane ?? job.lane;
515
+ job.workflow = status.workflow ?? job.workflow;
516
+ if (status.mode === "workflow")
517
+ job.workflowGraph = status.workflowGraph ?? job.workflowGraph;
518
+ job.hostSteps = validHostStepNodes(status.workflowGraph);
519
+ const workflowChildren = parseWorkflowChildSummary(status.workflowChildren);
520
+ if (workflowChildren && status.mode === "workflow")
521
+ workflowChildren.children = workflowChildren.children.map((child) => withWorkflowChildRunModel(job.asyncDir, child));
522
+ if (workflowChildren && workflowChildren.workflowRunId !== status.runId)
523
+ throw new Error("workflowChildren.workflowRunId does not match async status runId.");
524
+ job.workflowChildren = workflowChildren ?? job.workflowChildren;
525
+ job.currentStep = status.currentStep ?? job.currentStep;
526
+ job.chainStepCount = status.chainStepCount ?? job.chainStepCount;
527
+ job.startedAt = status.startedAt ?? job.startedAt;
528
+ if (status.lastUpdate !== undefined)
529
+ job.updatedAt = status.lastUpdate;
530
+ if (status.steps?.length) {
531
+ const groups = normalizeParallelGroups(status.parallelGroups, status.steps.length, status.chainStepCount ?? status.steps.length);
532
+ job.parallelGroups = groups.length ? groups : job.parallelGroups;
533
+ job.hasParallelGroups = groups.length > 0 || job.hasParallelGroups;
534
+ const activeGroup = status.currentStep !== undefined
535
+ ? groups.find((group) => status.currentStep >= group.start && status.currentStep < group.start + group.count)
536
+ : undefined;
537
+ const visibleSteps = activeGroup
538
+ ? status.steps.slice(activeGroup.start, activeGroup.start + activeGroup.count).map((step, index) => ({ ...step, index: activeGroup.start + index }))
539
+ : status.steps.map((step, index) => ({ ...step, index }));
540
+ job.activeParallelGroup = Boolean(activeGroup);
541
+ if (status.mode === "workflow") {
542
+ for (const step of visibleSteps)
543
+ if (step.async === true)
544
+ Object.assign(step, withWorkflowChildRunModel(job.asyncDir, step));
545
+ }
546
+ job.agents = visibleSteps.map((step) => step.agent);
547
+ job.steps = visibleSteps;
548
+ refreshNestedProjection();
549
+ job.stepsTotal = visibleSteps.length;
550
+ job.runningSteps = visibleSteps.filter((step) => step.status === "running").length;
551
+ job.completedSteps = visibleSteps.filter((step) => step.status === "complete" || step.status === "completed").length;
552
+ if (status.state === "complete")
553
+ job.completedSteps = visibleSteps.length;
554
+ }
555
+ job.sessionDir = status.sessionDir ?? job.sessionDir;
556
+ job.outputFile = status.outputFile ?? job.outputFile;
557
+ job.totalTokens = status.totalTokens ?? job.totalTokens;
558
+ job.timeoutMs = status.timeoutMs ?? job.timeoutMs;
559
+ job.deadlineAt = status.deadlineAt ?? job.deadlineAt;
560
+ job.timedOut = status.timedOut ?? job.timedOut;
561
+ job.stopped = status.stopped ?? job.stopped;
562
+ job.turnBudget = status.turnBudget ?? job.turnBudget;
563
+ job.turnBudgetExceeded = status.turnBudgetExceeded ?? job.turnBudgetExceeded;
564
+ job.wrapUpRequested = status.wrapUpRequested ?? job.wrapUpRequested;
565
+ job.sessionFile = status.sessionFile ?? job.sessionFile;
566
+ if (isTerminalJobStatus(job.status)) {
567
+ let publication = terminalPublications.get(job.asyncId);
568
+ if (!publication && status.mode !== "workflow" && status.processTerminal?.state === "pending"
569
+ && status.runId === job.asyncId && status.completionOwnerId
570
+ && ((status.sessionId === state.currentSessionId && status.completionOwnerId === state.completionOwnerId)
571
+ // Also covers a session inherited after /new or /resume: deliveryOwnerId checks run ownership.
572
+ || (typeof status.sessionId === "string"
573
+ && options.deliveryOwnerId?.(status.sessionId, status.completionOwnerId, status.completionOwnerProcess, status.parentWorkflowRunId) === OWNING_SESSION_COMPLETION_OWNER))) {
574
+ publication = { instanceId: status.processTerminal.runnerProcessInstanceId, pending: true };
575
+ terminalPublications.set(job.asyncId, publication);
576
+ }
577
+ const wasPending = publication?.pending;
578
+ if (publication?.pending) {
579
+ // Reconciliation resolves pending as well as public payloads. The
580
+ // watcher already discovers exact tracked run IDs without promotion.
581
+ const published = reconciliation.resultPath && fs.existsSync(reconciliation.resultPath);
582
+ const closed = !published && readProcessTerminal(job.asyncDir, {
583
+ runId: job.asyncId, runnerProcessInstanceId: publication.instanceId,
584
+ })?.state === "observed";
585
+ if (published || closed) {
586
+ publication = { pending: false };
587
+ terminalPublications.set(job.asyncId, publication);
588
+ }
589
+ else
590
+ cancelCleanup(job.asyncId);
591
+ }
592
+ // Scan on close too: publication may have raced the payload check.
593
+ if (!isTerminalJobStatus(previousStatus) || (wasPending && !publication?.pending))
594
+ options.onJobTerminal?.(job);
595
+ rememberFleetJob(state, job);
596
+ if (!publication?.pending && !nestedRefreshFailed && !hasLiveNestedDescendants(job.nestedChildren) && (previousStatus !== job.status || !state.cleanupTimers.has(job.asyncId))) {
597
+ scheduleCleanup(job.asyncId);
598
+ }
599
+ }
600
+ return widgetRenderKey(job, widgetExpanded) !== widgetStateBefore;
601
+ }
602
+ if (job.status === "queued") {
603
+ job.status = "running";
604
+ job.updatedAt = Date.now();
605
+ runningJobIds.add(job.asyncId);
606
+ }
607
+ }
608
+ catch (error) {
609
+ if (!bridgeSweepAttempted) {
610
+ try {
611
+ bridgeSweepAttempted = true;
612
+ serviceExternalJobBridgeRequests(job.asyncDir);
613
+ }
614
+ catch (bridgeError) {
615
+ console.error(`Failed to service external job bridge for '${job.asyncDir}':`, bridgeError);
616
+ }
617
+ }
618
+ if (job.status !== "failed") {
619
+ console.error(`Failed to read async status for '${job.asyncDir}':`, error);
620
+ job.status = "failed";
621
+ job.updatedAt = Date.now();
622
+ }
623
+ runningJobIds.delete(job.asyncId);
624
+ rememberFleetJob(state, job);
625
+ if (!terminalPublications.get(job.asyncId)?.pending && !hasLiveNestedDescendants(job.nestedChildren) && !state.cleanupTimers.has(job.asyncId))
626
+ scheduleCleanup(job.asyncId);
627
+ }
628
+ return widgetRenderKey(job, widgetExpanded) !== widgetStateBefore;
629
+ };
630
+ const scheduleJobRefresh = (asyncId, delayMs = EVENT_REFRESH_DEBOUNCE_MS) => {
631
+ if (refreshTimers.has(asyncId))
632
+ return;
633
+ const timer = setTimeout(() => {
634
+ refreshTimers.delete(asyncId);
635
+ const job = state.asyncJobs.get(asyncId);
636
+ if (job && refreshJob(job))
637
+ scheduleLastWidgetRerender();
638
+ }, delayMs);
639
+ timer.unref?.();
640
+ refreshTimers.set(asyncId, timer);
641
+ };
642
+ const watchJob = (job) => {
643
+ if (!useNativeWatcher())
644
+ return;
645
+ const watched = jobWatchers.get(job.asyncId) ?? { watchers: new Map() };
646
+ const active = job.status === "queued" || job.status === "running";
647
+ const watchPath = (watchPath) => {
648
+ if (watched.watchers.has(watchPath))
649
+ return true;
650
+ const nestedEventSink = job.nestedRoute?.eventSink === watchPath;
651
+ let watcher;
652
+ try {
653
+ watcher = watch(resolveWatchPath(watchPath), (_event, file) => {
654
+ const rawFileName = file?.toString();
655
+ const fileName = rawFileName ?? path.basename(watchPath);
656
+ const nestedEventFile = nestedEventSink && (!rawFileName || rawFileName.endsWith(".json") || rawFileName.endsWith(".jsonl"));
657
+ if (fileName === "status.json" || fileName === "events.jsonl" || fileName === EXTERNAL_JOB_BRIDGE_REQUEST_DIR || fileName.endsWith(".json") || nestedEventFile) {
658
+ scheduleJobRefresh(job.asyncId);
659
+ }
660
+ if (watchPath !== job.asyncDir && !nestedEventSink) {
661
+ watcher.close();
662
+ watched.watchers.delete(watchPath);
663
+ watchJob(job);
664
+ }
665
+ });
666
+ }
667
+ catch {
668
+ return false;
669
+ }
670
+ watcher.on("error", () => {
671
+ watcher.close();
672
+ watched.watchers.delete(watchPath);
673
+ if (watchPath.endsWith("status.json") || nestedEventSink)
674
+ watchJob(job);
675
+ });
676
+ watcher.unref?.();
677
+ watched.watchers.set(watchPath, watcher);
678
+ return true;
679
+ };
680
+ watchPath(job.asyncDir);
681
+ const statusPath = path.join(job.asyncDir, "status.json");
682
+ const hadStatusWatcher = watched.watchers.has(statusPath);
683
+ const statusWatched = watchPath(statusPath);
684
+ if (statusWatched && !hadStatusWatcher)
685
+ scheduleJobRefresh(job.asyncId);
686
+ watchPath(path.join(job.asyncDir, "events.jsonl"));
687
+ watchPath(path.join(job.asyncDir, EXTERNAL_JOB_BRIDGE_REQUEST_DIR));
688
+ if (job.nestedRoute)
689
+ watchPath(job.nestedRoute.eventSink);
690
+ if (!statusWatched && active && !watched.retryTimer) {
691
+ watched.retryTimer = setTimeout(() => {
692
+ watched.retryTimer = undefined;
693
+ const current = state.asyncJobs.get(job.asyncId);
694
+ if (current)
695
+ watchJob(current);
696
+ }, WATCH_ATTACHMENT_RETRY_MS);
697
+ watched.retryTimer.unref?.();
698
+ }
699
+ else if (statusWatched && watched.retryTimer) {
700
+ clearTimeout(watched.retryTimer);
701
+ watched.retryTimer = undefined;
702
+ }
703
+ if (watched.watchers.size > 0 || watched.retryTimer)
704
+ jobWatchers.set(job.asyncId, watched);
705
+ else
706
+ jobWatchers.delete(job.asyncId);
707
+ };
708
+ const watchAsyncRoot = () => {
709
+ if (!useNativeWatcher())
710
+ return;
711
+ if (rootWatcher)
712
+ return;
713
+ try {
714
+ rootWatcher = watch(resolveWatchPath(asyncDirRoot), (_event, file) => {
715
+ const runDirName = file?.toString();
716
+ for (const job of state.asyncJobs.values()) {
717
+ if (jobWatchers.has(job.asyncId) || (runDirName && path.basename(job.asyncDir) !== runDirName))
718
+ continue;
719
+ watchJob(job);
720
+ if (jobWatchers.has(job.asyncId))
721
+ scheduleJobRefresh(job.asyncId);
722
+ }
723
+ });
724
+ rootWatcher.on("error", () => {
725
+ rootWatcher?.close();
726
+ rootWatcher = undefined;
727
+ });
728
+ rootWatcher.unref?.();
729
+ }
730
+ catch {
731
+ // The liveness sweep retries if the async root is not available yet.
732
+ }
733
+ };
734
+ const ensurePoller = () => {
735
+ watchAsyncRoot();
736
+ if (state.poller)
737
+ return;
738
+ nextLivenessAt = Date.now() + livenessIntervalMs;
739
+ state.poller = setInterval(() => {
740
+ if (state.asyncJobs.size === 0) {
741
+ rerenderLastWidget([]);
742
+ if (state.poller)
743
+ clearInterval(state.poller);
744
+ state.poller = null;
745
+ rootWatcher?.close();
746
+ rootWatcher = undefined;
747
+ return;
748
+ }
749
+ const now = Date.now();
750
+ if (now >= nextLivenessAt) {
751
+ nextLivenessAt = now + livenessIntervalMs;
752
+ let widgetChanged = false;
753
+ for (const job of state.asyncJobs.values()) {
754
+ watchJob(job);
755
+ if (refreshJob(job))
756
+ widgetChanged = true;
757
+ }
758
+ if (widgetChanged)
759
+ rerenderLastWidget();
760
+ }
761
+ if (runningJobIds.size > 0 && now >= nextWidgetAnimationAt) {
762
+ nextWidgetAnimationAt = now + WIDGET_ANIMATION_INTERVAL_MS;
763
+ requestLastWidgetRender();
764
+ }
765
+ }, Math.min(WIDGET_ANIMATION_INTERVAL_MS, livenessIntervalMs));
766
+ state.poller.unref?.();
767
+ };
768
+ const handleStarted = (data) => {
769
+ const info = data;
770
+ if (!info.id)
771
+ return;
772
+ if (typeof state.currentSessionId === "string" && info.sessionId !== state.currentSessionId)
773
+ return;
774
+ const now = Date.now();
775
+ const asyncDir = info.asyncDir ?? path.join(asyncDirRoot, info.id);
776
+ const rawAgents = info.agents?.length ? info.agents : info.chain && info.chain.length > 0 ? info.chain : info.agent ? [info.agent] : undefined;
777
+ const validParallelGroups = normalizeParallelGroups(info.parallelGroups, Number.MAX_SAFE_INTEGER, info.chainStepCount ?? Number.MAX_SAFE_INTEGER);
778
+ const firstGroup = validParallelGroups.find((group) => group.start === 0);
779
+ const firstGroupCount = firstGroup?.count;
780
+ const agents = firstGroupCount && firstGroupCount > 0
781
+ ? rawAgents?.slice(0, firstGroupCount)
782
+ : rawAgents;
783
+ const existingJob = state.asyncJobs.get(info.id);
784
+ const sessionRoot = state.liveAsyncSessionRoots?.get(info.id) ?? existingJob?.sessionRoot;
785
+ state.liveAsyncSessionRoots?.delete(info.id);
786
+ externalJobBridgeRuns.delete(info.id);
787
+ terminalPublications.delete(info.id);
788
+ state.asyncJobs.set(info.id, {
789
+ asyncId: info.id,
790
+ asyncDir,
791
+ ...(typeof info.cwd === "string" ? { cwd: path.resolve(info.cwd) } : {}),
792
+ ...(sessionRoot ? { sessionRoot } : {}),
793
+ status: "queued",
794
+ pid: typeof info.pid === "number" ? info.pid : undefined,
795
+ ...(typeof info.sessionId === "string" ? { sessionId: info.sessionId } : {}),
796
+ ...(typeof info.completionOwnerId === "string" ? { completionOwnerId: info.completionOwnerId } : {}),
797
+ mode: info.mode ?? (info.chain ? "chain" : "single"),
798
+ scheduleOrigin: info.scheduleOrigin,
799
+ description: info.goal ?? info.task,
800
+ agents,
801
+ chainStepCount: info.chainStepCount,
802
+ parallelGroups: validParallelGroups,
803
+ nestedRoute: info.nestedRoute,
804
+ stepsTotal: firstGroupCount ?? agents?.length,
805
+ hasParallelGroups: validParallelGroups.length > 0,
806
+ activeParallelGroup: Boolean(firstGroupCount && firstGroupCount > 0),
807
+ startedAt: now,
808
+ updatedAt: now,
809
+ timeoutMs: info.timeoutMs,
810
+ deadlineAt: info.deadlineAt,
811
+ turnBudget: info.turnBudget,
812
+ parentWorkflowRunId: info.parentWorkflowRunId,
813
+ workflowKey: info.workflowKey,
814
+ ...(info.mode === "workflow" && info.workflowGraph ? { workflowGraph: info.workflowGraph } : {}),
815
+ controlEventCursor: 0,
816
+ });
817
+ const job = state.asyncJobs.get(info.id);
818
+ rememberFleetJob(state, job);
819
+ watchJob(job);
820
+ scheduleJobRefresh(info.id, 0);
821
+ ensurePoller();
822
+ rerenderLastWidget();
823
+ };
824
+ const handleComplete = (data) => {
825
+ const result = data;
826
+ if (typeof state.currentSessionId === "string" && result.sessionId !== state.currentSessionId)
827
+ return;
828
+ const asyncId = result.id;
829
+ if (!asyncId)
830
+ return;
831
+ const job = state.asyncJobs.get(asyncId);
832
+ let nestedRefreshFailed = false;
833
+ if (job) {
834
+ job.status = result.state ?? (result.success ? "complete" : "failed");
835
+ runningJobIds.delete(asyncId);
836
+ job.stopped = result.stopped ?? job.stopped;
837
+ job.updatedAt = Date.now();
838
+ if (result.asyncDir && result.asyncDir !== job.asyncDir) {
839
+ closeJobWatcher(asyncId);
840
+ job.asyncDir = result.asyncDir;
841
+ watchJob(job);
842
+ }
843
+ // Delivery can precede the first terminal status refresh. Remember its
844
+ // settlement even when no pending publication has been observed yet.
845
+ terminalPublications.set(asyncId, { pending: false });
846
+ try {
847
+ updateAsyncJobNestedProjection(job);
848
+ }
849
+ catch (error) {
850
+ nestedRefreshFailed = true;
851
+ console.error(`Failed to refresh nested async descendants for '${job.asyncDir}':`, error);
852
+ }
853
+ }
854
+ if (job)
855
+ rememberFleetJob(state, job);
856
+ rerenderLastWidget();
857
+ if (!nestedRefreshFailed && !hasLiveNestedDescendants(job?.nestedChildren))
858
+ scheduleCleanup(asyncId);
859
+ };
860
+ const dispose = () => {
861
+ if (state.poller)
862
+ clearInterval(state.poller);
863
+ state.poller = null;
864
+ rootWatcher?.close();
865
+ rootWatcher = undefined;
866
+ for (const asyncId of jobWatchers.keys())
867
+ closeJobWatcher(asyncId);
868
+ for (const timer of refreshTimers.values())
869
+ clearTimeout(timer);
870
+ refreshTimers.clear();
871
+ if (widgetRerenderTimer)
872
+ clearTimeout(widgetRerenderTimer);
873
+ widgetRerenderTimer = undefined;
874
+ runningJobIds.clear();
875
+ externalJobBridgeRuns.clear();
876
+ terminalPublications.clear();
877
+ clearSupervisorNotices();
878
+ };
879
+ const resetJobs = (ctx) => {
880
+ dispose();
881
+ state.statusProjectionSessionId = null;
882
+ for (const timer of state.cleanupTimers.values())
883
+ clearTimeout(timer);
884
+ state.cleanupTimers.clear();
885
+ state.asyncJobs.clear();
886
+ state.fleetJobs?.clear();
887
+ state.foregroundControls?.clear();
888
+ state.liveAsyncSessionRoots?.clear();
889
+ state.lastForegroundControlId = null;
890
+ state.resultFileCoalescer.clear();
891
+ if (ctx?.hasUI) {
892
+ state.lastUiContext = ctx;
893
+ rerenderWidget(ctx, []);
894
+ }
895
+ };
896
+ const restoreActiveJobs = (ctx, observeStatus) => {
897
+ if (ctx?.hasUI)
898
+ state.lastUiContext = ctx;
899
+ state.statusProjectionSessionId = null;
900
+ if (!state.currentSessionId)
901
+ return;
902
+ let runs;
903
+ try {
904
+ // A workflow whose Pi exited is repaired here, in the session that owns it, which then delivers its notice.
905
+ runs = listAsyncRuns(asyncDirRoot, { states: ["queued", "running"], sessionId: state.currentSessionId, resultsDir, kill: options.kill, now: options.now, adoptCompletionOwnerId: state.completionOwnerId }, observeStatus);
906
+ }
907
+ catch (error) {
908
+ console.error(`Failed to restore active async jobs from '${asyncDirRoot}':`, error);
909
+ return;
910
+ }
911
+ for (const run of runs) {
912
+ const job = summaryToJob(run);
913
+ state.asyncJobs.set(run.id, job);
914
+ if (job.status === "running")
915
+ runningJobIds.add(job.asyncId);
916
+ rememberFleetJob(state, job);
917
+ watchJob(job);
918
+ }
919
+ state.statusProjectionSessionId = state.currentSessionId;
920
+ if (runs.length === 0)
921
+ return;
922
+ ensurePoller();
923
+ rerenderLastWidget();
924
+ };
925
+ return { ensurePoller, refreshWidget, handleStarted, handleComplete, resetJobs, restoreActiveJobs, dispose };
926
+ }